Difference between revisions of "AGI Command Reference"

From AGI Wiki
Jump to navigationJump to search
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
AGI Command Reference
+
<div align="center"><span style="font-size: 22pt">AGI Logic Command Reference</span><br /></div>
 +
The AGI commands provide the "brains" of AGI games. [[Logic]] scripts contain the commands that AGI uses to perform game functions, control game play and manipulate other resources such as [[picture|pictures]] and [[view|views]]. Logic source code is written in a scripting language that can be compiled into pseudo-code, which is what AGI reads during game play.
  
Thanks to the Sarien team and to Nick Sonneveld for some info on the unknown commands.
+
Although it may seem that AGI is not an overly complex language, it does take a full understanding of its inner workings to be able to successfully create a full featured AGI game. Understanding how the main [[interpreter cycle]] works, as well as how the different resources are loaded and accessed is critical in being able to create workable AGI games.
  
 +
Detailed information is provided in this section on each command available in AGI, as well as a description of syntax rules. There are also some introductory topics dealing with common AGI programming tasks, such as working with objects, the text mode, debugging, etc.<br/>
  
'''Table of Contents'''
+
==[[:Category:Commands|Commands by Name]]==
 +
A list of all AGI commands alphabetically by name.
  
# [[AGI Command Reference 1 - ARITHMETIC COMMANDS|ARITHMETIC COMMANDS]]
+
==Commands by Category:==
# [[AGI Command Reference 2 - COMMANDS TO LOAD AND UNLOAD RESOURCES|COMMANDS TO LOAD AND UNLOAD RESOURCES]]
 
# [[AGI Command Reference 3 - PROGRAM CONTROL COMMANDS|PROGRAM CONTROL COMMANDS]]
 
# [[AGI Command Reference 4 - OBJECT CONTROL COMMANDS|OBJECT CONTROL COMMANDS]]
 
# [[AGI Command Reference 5 - OBJECT DESCRIPTION COMMANDS|OBJECT DESCRIPTION COMMANDS]]
 
# [[AGI Command Reference 6 - OBJECT MOTION CONTROL COMMANDS|OBJECT MOTION CONTROL COMMANDS]]
 
# [[AGI Command Reference 7 - INVENTORY ITEM MANAGEMENT COMMANDS|INVENTORY ITEM MANAGEMENT COMMANDS]]
 
# [[AGI Command Reference 8 - PICTURE RESOURCE MANAGEMENT COMMANDS|PICTURE RESOURCE MANAGEMENT COMMANDS]]
 
# [[AGI Command Reference 9 - SOUND RESOURCE MANAGEMENT COMMANDS|SOUND RESOURCE MANAGEMENT COMMANDS]]
 
# [[AGI Command Reference 10 - TEXT MANAGEMENT COMMANDS|TEXT MANAGEMENT COMMANDS]]
 
# [[AGI Command Reference 11 - STRING MANAGEMENT COMMANDS|STRING MANAGEMENT COMMANDS]]
 
# [[AGI Command Reference 12 - INITIALIZATION COMMANDS|INITIALIZATION COMMANDS]]
 
# [[AGI Command Reference 13 - MENU MANAGEMENT COMMANDS|MENU MANAGEMENT COMMANDS]]
 
# [[AGI Command Reference 14 - TEST COMMANDS|TEST COMMANDS]]
 
# [[AGI Command Reference 15 - OTHER COMMANDS|OTHER COMMANDS]]
 
# [[AGI Command Reference 16 - UNKNOWN COMMANDS|UNKNOWN COMMANDS]]<br />
 
&nbsp;
 
  
 
+
*'''[[:Category:Test Commands|Test Commands]]'''
 
+
:Test commands return a boolean result and are used in [[if]] statements.
Page:  
+
*'''[[:Category:Mathematical Commands|Mathematical Commands]]
[[AGI Command Reference 1 - ARITHMETIC COMMANDS|1]] |  
+
:Mathematical commands are used for working with [[variables]] and [[number|numbers]] in AGI.
[[AGI Command Reference 2 - COMMANDS TO LOAD AND UNLOAD RESOURCES|2]] |  
+
*'''[[:Category:Flag Commands|Flag Commands]]'''
[[AGI Command Reference 3 - PROGRAM CONTROL COMMANDS|3]] |
+
:These commands are used to test the status of [[flags]], and to set, reset, and toggle flag values.
[[AGI Command Reference 4 - OBJECT CONTROL COMMANDS|4]] |
+
*'''[[:Category:Flow Control Commands|Flow Control Commands]]'''
[[AGI Command Reference 5 - OBJECT DESCRIPTION COMMANDS|5]] |
+
:This group of commands deals with control of [[logic]] scripts and [[room]] changes.
[[AGI Command Reference 6 - OBJECT MOTION CONTROL COMMANDS|6]] |
+
*'''[[:Category:Picture Commands|Picture Commands]]'''
[[AGI Command Reference 7 - INVENTORY ITEM MANAGEMENT COMMANDS|7]] |
+
:Commands for manipulating [[picture]] resources.
[[AGI Command Reference 8 - PICTURE RESOURCE MANAGEMENT COMMANDS|8]] |
+
*'''[[:Category:Screen Object Control Commands|Screen Object Control Commands]]'''
[[AGI Command Reference 9 - SOUND RESOURCE MANAGEMENT COMMANDS|9]] |
+
:These commands are used to set up and manipulate [[screen objects]].
[[AGI Command Reference 10 - TEXT MANAGEMENT COMMANDS|10]] |
+
*'''[[:Category:Screen Object Motion Control Commands|Screen Object Motion Control Commands]]'''
[[AGI Command Reference 11 - STRING MANAGEMENT COMMANDS|11]] |
+
:Commands to control the motion of [[screen objects]].
[[AGI Command Reference 12 - INITIALIZATION COMMANDS|12]] |
+
*'''[[:Category:Inventory Item Commands|Inventory Item Commands]]'''
[[AGI Command Reference 13 - MENU MANAGEMENT COMMANDS|13]] |
+
:This group has the commands used to control and manage the [[inventory items]] listed in the [[OBJECT]] file.
[[AGI Command Reference 14 - TEST COMMANDS|14]] |
+
*'''[[:Category:Sound Commands|Sound Commands]]'''
[[AGI Command Reference 15 - OTHER COMMANDS|15]] |
+
:Commands for manipulating [[sound]] resources.
[[AGI Command Reference 16 - UNKNOWN COMMANDS|16]]
+
*'''[[:Category:String Commands|String Commands]]'''
 +
:The few commands that can be used to manipulate [[strings]] are listed in this topic.
 +
*'''[[:Category:Display Commands|Display Commands]]'''
 +
:The display commands control printing and displaying text in AGI.
 +
*'''[[:Category:Player Input Commands|Player Input Commands]]'''
 +
:These commands deal with collecting [[player input]] via the [[keyboard]], [[joystick]], and [[mouse]]. It also includes commands for managing [[menus]].
 +
*'''[[:Category:System Commands|System Commands]]'''
 +
:Commands for dealing with system activities such as [[saving/restoring/restarting]] and controlling input related activities.
 +
*'''[[:Category:Debugging Commands|Debugging Commands]]'''
 +
:Commands that allow AGI programmers to do limited [[debugging]] of games during development.

Latest revision as of 19:48, 22 March 2019

AGI Logic Command Reference

The AGI commands provide the "brains" of AGI games. Logic scripts contain the commands that AGI uses to perform game functions, control game play and manipulate other resources such as pictures and views. Logic source code is written in a scripting language that can be compiled into pseudo-code, which is what AGI reads during game play.

Although it may seem that AGI is not an overly complex language, it does take a full understanding of its inner workings to be able to successfully create a full featured AGI game. Understanding how the main interpreter cycle works, as well as how the different resources are loaded and accessed is critical in being able to create workable AGI games.

Detailed information is provided in this section on each command available in AGI, as well as a description of syntax rules. There are also some introductory topics dealing with common AGI programming tasks, such as working with objects, the text mode, debugging, etc.

Commands by Name

A list of all AGI commands alphabetically by name.

Commands by Category:

Test commands return a boolean result and are used in if statements.
Mathematical commands are used for working with variables and numbers in AGI.
These commands are used to test the status of flags, and to set, reset, and toggle flag values.
This group of commands deals with control of logic scripts and room changes.
Commands for manipulating picture resources.
These commands are used to set up and manipulate screen objects.
Commands to control the motion of screen objects.
This group has the commands used to control and manage the inventory items listed in the OBJECT file.
Commands for manipulating sound resources.
The few commands that can be used to manipulate strings are listed in this topic.
The display commands control printing and displaying text in AGI.
These commands deal with collecting player input via the keyboard, joystick, and mouse. It also includes commands for managing menus.
Commands for dealing with system activities such as saving/restoring/restarting and controlling input related activities.
Commands that allow AGI programmers to do limited debugging of games during development.