Articles

AGI Command Reference

This is a tutorial for AGI Programming if you have any questions post them at http://www.agigames.com/site.php

Thanks to the Sarien team and to Nick Sonneveld for some info on the unknown commands.

Page: 1 2 3 4 5 6 7 [ 8 ] 9 10 11 12 13 14 15 16

VIII PICTURE RESOURCE MANAGEMENT COMMANDS

The following commands operate on PICTURE resources (3D props), prepared using PM editor and loaded in the interpreter memory using load_pic:

draw.pic(n);

A PICTURE resource number i, where i is the value of Var(n) is executed. As the result, the background picture is created in the internal buffer of the interpreter. Before execution, the buffer is cleared, i.e. all pixels are set to colour 15 and priority 4.

overlay.pic(n);

Just like the above, only the internal buffer is not cleared before drawing. Picture(Var(n)) is drawn over the existing picture.

add.to.pic(a, b, c, d, e, f, g); add.to.pic.v(a, b, c, d, e, f, g);

A picture of a VIEW resource is added to the background as its component. Typically, this is used to add small complicated details which would require too many PICTURE resource commands to draw.
Parameters are:
a ( Var(a) ) - number of the VIEW resource;
b ( Var(b) ) - loop number;
c ( Var(c) ) - cel number;
d ( Var(d) ) - x coordinate;
e ( Var(e) ) - y coordinate;
f ( Var(f) ) - priority;
g ( Var(g) ) - margin.
If margin is 0, 1, 2, or 3, the base of the cel is surrounded with a rectangle of the corresponding priority. If margin > 4, this extra margin is not shown.

show.pic();

Shows internal buffer on the screen.
ATTENTION!
Please use the following sequence of commands when loading PICTURE resources in the interpreter memory:
load.pic(n);
draw.pic(n);
discard.pic(n);
.............
show.pic;
Any other order may crash the interpreter without any diagnostic messages.

Page: 1 2 3 4 5 6 7 [ 8 ] 9 10 11 12 13 14 15 16