Category:Game Characters by Dylan Skirvin and AGI Command Reference - Picture Resource Management Commands: Difference between pages

AGI Command Reference Index

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 color 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.

References

Also See

AGI Command Reference Index

< Previous: Inventory Item Management CommandsNext: Sound Resource Management Commands >