Search results

The '''set.string''' command assigns the text of a message to a string. set.string([[string|str]] sA, [[message|msg]] mB);<br />

set.cursor.char([[message|msg]] mCURSORCHAR);<br /> set.cursor.char("message text");

...so identifies [[logic]] '''LOGNUM''' as the source for trace commands as [[message]]s. Keep in mind that due to a [[bug in AGI]], using any value for '''TOP''' except 1 will result in the trace window b

The '''print''' command displays a message in a window. print([[message|msg]] mMSG);<br />

The '''version''' command displays a window showing version information for AGI. ...ter Versions|version]]). The user can press ENTER or ESCAPE to dismiss the message and return to the game.

A message box is displayed that says "Game paused. Press Enter to continue." Pressing ...other message box. This means if you set f15 and then use '''pause''', the message box will be displayed, but the game won't actually pause.

The '''close.window''' command will close an open print message window. ...s executed when [[reserved flag]] [[f15 (no pause windows)]] is set (TRUE) AGI does not pause, and the window remains on screen until dismissed. Use the '

The '''print.at''' command displays a message in a window at a specified location. print.at([[message|msg]] mMSG, [[number|byt]] ROW, [[number|byt]] COL, [[number|byt]] MAXWIDTH

display([[number|byt]] ROW, [[number|byt]]COL, [[message|msg]] mMSG);<br /> display([[number|byt]] ROW, [[number|byt]] COL, "message text");

log([[message|msg]] mLOGMSG);<br /> log("log message");

The '''print.at.v''' command indirectly displays a message in a window at a specified location. The text of the [[message]] referred to by [[variable]] '''vMSG''' is displayed in a bordered window.

...urrent [[priority]] value (pri); and current [[step size]] (stepsize). The message is formatted as follows: ...te this command on a screen object that has not been properly initialized, AGI will display random data from an undefined location in memory.

...d implicitly or explicitly. An explicit message definition uses the <code>#message</code> command: <syntaxhighlight lang="agi">

...commands, the '''display.v''' command does not include a border around the message text. ...a column equal to the '''vCOL''' value MOD 40, and the rest of the display message will be left aligned, one row below the desired '''vROW''' value.

=== Welcome to the AGI Programmers Wiki. === ...itional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

The '''show.obj''' command displays a [[View Resource (AGI)|view]] representing an [[inventory item]] and its description. ...View Resource (AGI)#Description|view description]] is displayed above in a message box. Pressing any key erases the object and its definition, and play resume

The '''show.obj.v''' command indirectly displays a [[View Resource (AGI)|view]] representing an [[inventory item]] and its description. ...View Resource (AGI)#Description|view description]] is displayed above in a message box. Pressing any key erases the object and its definition, and play resume

The [[Joystick Input|joystick]] is disabled by default when AGI starts. If you want to allow the player to use a joystick, it must be enabl The '''init.joy''' command displays a message asking user to center joystick. The user then presses ENTER to enable and c

[[AGI|AGI]] is a game engine which imposes significant memory and resource constraint ...gic]], [[AGI Picture Resource|picture]], [[AGI View Resource|view]], and [[AGI Sound Resource|sound]] resources in a game.

...tax described in the [[AGI Specs|AGI Specs]] and supported by [[AGI Studio|AGI Studio]] and [[WinAGI|WinAGI]]. ...the C-based syntax described in this article is the most widely-supported AGI logic syntax.

...have a color other than black or white, a workaround, using a single space message and the '''[[display.v]]''' command, is demonstrated in the example below. AGI does not validate the argument values, so if either row argument is > 24, o

Use the following links for helpful information about the AGI logic scripting language. ** [[Message|Messages]]

get.num([[message|msg]] mPROMPT, [[variable|var]] vB);<br /> ...on, the '''get.num''' function uses the [[input line]], substituting the [[message]] '''mPROMPT''' as the [[input prompt]] and using the existing [[cursor]] c

...ter to load it using the '''[[load.logics]]''' command. This avoids having AGI continually load and unload the same logic over and over. If the logic does not exist, AGI will display a 'resource not found' message, and immediately quit.

get.string([[string|str]] sA, [[message|msg]] mPROMPT, [[number|byt]] ROW, [[number|byt]] COL, [[number|byt]] LEN); ...using the existing [[input line]] like the '''[[get.num]]''' command does. Message '''mPROMPT''' is used as the prompt, which is displayed at text column '''C

...ng to help manage [[memory]] usage. When called, '''show.mem''' displays a message box that shows the following memory usage statistics: <syntaxhighlight lang="agi">

...r to load it using the '''[[load.logics.v]]''' command. This avoids having AGI continually load and unload the same logic over and over. If the logic does not exist, AGI will display a 'resource not found' message, and immediately quit.

set.game.id([[message|msg]] mGAMEID);<br /> ...is embedded within the main interpreter file. If the values do not match, AGI quits without any warning. This was done presumably to make sure the games

...it. If [[reserved flags|reserved flag]] [[f16 (auto restart)]] is FALSE, a message box is displayed asking the player to confirm the restart. If f16 is TRUE, ...heap]] is cleared (which unloads all [[resources]]) and the [[OBJECT File (AGI)|OBJECT]] file is reloaded. The [[screen object]] table is reset, all [[var

...econd word, etc.) However, when using the [[message special format code]], AGI treats '%w1' as the first word. ...he player only entered two words, and you use 'w3' as the argument value), AGI will read invalid data, resulting in meaningless output.

This command sets the foreground and background [[colors]] used by AGI to display text with the '''[[display]]''' or '''[[display.v]]''' commands ...und and foreground. If the background color is any value other than black, AGI uses white as the background, and draws text with black foreground (ignorin

...error messages, but you could use it to define your own special-case error message code (to help with debugging). ...is bigger than 0 (which it will be if there's an error) it calls the error message logic.<br />

When the '''set.scan.start''' command is executed, AGI stores the current script position of the running [[logic]] in a [[scan sta ...end of that section, the '''set.scan.start''' command can be used to make AGI skip over the initialization section on subsequent iterations.

When the '''reset.scan.start''' command is executed, AGI resets the [[scan start table]] so subsequent calls to this logic will agai In the following example, you will only see the first message one time. After that, the logic begins execution at the second print statem

...(invalid word number)]] is assigned the sequence number of the word in the message that failed to match and the processing ends. ...ignored and the '''parse''' command exits without doing anything. Also, in AGI [[versions]] that allocate space for 24 strings, only the first 12 strings

...m DOS, you can use SavePic. <!-- All of the files can be obtained from the AGI Utilities Page. --> AGI256 is a patch for AGI created by dark minister to modify AGI so that it can use 256 colors. To use this, you will need to create the pic

set.menu.item([[message|msg]] mA, [[controllers|ctl]] cB);<br /> In AGI menus are the displayed along the top of the [[menu bar]], and each menu ma

set.menu([[message|msg]] mA);<br /> In AGI menus are the displayed along the top of the [[menu bar]], and each menu ma

...preter was unable to allocate a reasonably sized heap for your game. This message probably doesn't mean much to people these days, but if you get it, you mig ...It also mentions how to patch the interpreter to increase the stack. See "AGI Stack Overflow Information".<br />

[[AGI Sound Tutorial|AGI Sound Tutorial Index]] [[AGI Sound Tutorial - Introduction|1]] |

This section lists conventions that will be adopted in the AGI script * Message (prefix "m")

<div align="center" style="font-size: 22pt">CG- The AGI Game Compiler</div> CG was Sierra's in-house AGI Game Compiler.

...] that is used by the first [[AGI Room|room]] in the game, and a default [[AGI Inventory Object|inventory object]]. ...such as setting up the game's menus, saving and restoring, and a set of [[AGI Debugging|debugging]] commands. Without the template game, game programmers

[[Official AGDS/AGI Documentation]]<br /> <blockquote><div class="CodeBlockHeader">AGI Code:</div>

...'''G'''ame '''I'''nterpreter is [[Brian Provinciano|Brian Provinciano's]] AGI replacement interpreter for the Game Boy Advance Adventure Game Interpreter ...y Advance. With the use of a flash cart on your GBA, you can play all your AGI games on the portable. Not only can you play Sierra's adventure games, but

== <div id="agi"></div><div id="s3"></div><br />3. AGI internals == The AGI interpreter contains:

| Website = [[scipf:15.0|AGI Forum]] ...tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

<!--{{IIgs/Mac/Tandy sound samples & AGI resources: -->{{PaulLungaC}} <!--{{AGI internals consultant: -->{{NickSonneveldC}}

<syntaxhighlight lang="agi"> <syntaxhighlight lang="agi">

<div align="center"><span style="font-size: 22pt">Creating an AGI Game</span><br /> ...Studio]] by [[Peter Kelly|Peter Kelly]]. This tutorial or introduction to AGI game editing will show those who have little or no programming knowledge ho

...for), a procedural language. Previously, he also was the head of Sierra’s AGI and SCI system programmers and responsible for much of the code of both of ...used in AGI resources is borrowed from his wife's name, Avis Durgan<ref>[[AGI Specifications: Chapter 11 - Other Game Data#The file encryption]]</ref>.

...documented, and a suite of programs which would allow you create and edit AGI games was created. This was called '''AGDS'''(Adventure Game Design System) ...tin Mironovich]] for putting me in touch with Alex after seeing one of the AGI websites.

...final one being noise. The IBM PC can only play one note at a time so all AGI games for the PC play the melody by itself. The Apple IIgs version has much ...s sound generators. This format appears to have remained right through the AGI games up until 1989--90 when SCI took over even though the PCjr had long si

[[Official AGDS/AGI Documentation]]<br /> '''[[AGI Picture Resource|PICTURE]]''' -- Usually, each ROOM has an associated pictu

<syntaxhighlight lang="agi"> ...ogic script is not stored like this in the game files though. Instead each AGI command is stored as a bytecode and the resulting data doesn't look much li