AGI Command Reference

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

Test commands return a boolean result and are used in if statements.

• Mathematical Commands

Mathematical commands are used for working with variables and numbers in AGI.

• Flag Commands

These commands are used to test the status of flags, and to set, reset, and toggle flag values.

• Flow Control Commands

This group of commands deals with control of logic scripts and room changes.

• Picture Commands

Commands for manipulating picture resources.

• Screen Object Control Commands

These commands are used to set up and manipulate screen objects.

• Screen Object Motion Control Commands

Commands to control the motion of screen objects.

• Inventory Item Commands

This group has the commands used to control and manage the inventory items listed in the OBJECT file.

• Sound Commands

Commands for manipulating sound resources.

• String Commands

The few commands that can be used to manipulate strings are listed in this topic.

• Display Commands

The display commands control printing and displaying text in AGI.

• Player Input Commands

These commands deal with collecting player input via the keyboard, joystick, and mouse. It also includes commands for managing menus.

• System Commands

Commands for dealing with system activities such as saving/restoring/restarting and controlling input related activities.

• Debugging Commands

Commands that allow AGI programmers to do limited debugging of games during development.