AGI Command Reference - String Management Commands

AGI Indirect Command

An indirect command is a logic command that requires the number of a resource to be specified but uses a variable to specify the resource number. For example compare the direct command load.view to the indirect command load.view.v:

load.view(20);

v200 = 20; load.view.v(v200);

In the above code, both commands load VIEW.020, but load.view is direct because it accepts the actual number of the view resource that should be loaded. The load.view.v command is indirect because it does not accept the actual number of the resource that should be loaded. You have to put the number into a variable and give that to the load.view.v command.

This probably seems like more work than is necessary, and in many cases it is. But indirect commands do have an advantage over direct commands, namely that they are more flexible. For example, the following code, from the AGI Studio Template Game, allows the player to teleport to any room in the game by entering the room number:

Code:

if (said("tp")) {
  get.num("new room: ", v255);
  new.room.v(v255);
}

This function is not possible without indirect commands, because there is no way to know ahead of time which room the player will want to teleport to. The alternate approach of having up to 254 different commands for teleporting to each of the possible rooms in the game is obviously no good.

Indirect command listing

The following is a list of all the indirect commands in AGI logic. Most indirect commands end in .v, but there are exceptions to this rule. Also, not all commands that end in .v are indirect commands.

• add.to.pic.v
• call.v
• cycle.time
• discard.view.v
• display.v
• draw.pic
• get.room.v
• get.v
• load.logics.v
• load.pic
• load.view.v
• move.obj.v
• new.room.v
• obj.status.v
• overlay.pic
• position.v
• print.at.v
• print.v
• put.v
• reposition
• reposition.to.v
• reset.v
• set.cel.v
• set.dir
• set.loop.v
• set.priority.v
• set.view.v
• set.v
• show.obj.v
• step.size
• step.time
• toggle.v