AGIWiki/obj.in.box

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Test commands

The obj.in.box command returns TRUE if the entire bottom row of pixels of the screen object is within a specified region.

Syntax

obj.in.box(obj oA, byt X1, byt Y1, byt X2, byt Y2)

Remarks

Test commands are only valid in an if statement.

The region to be tested is bounded by (X1, Y1) - (X2, Y2).

The position test commands (posn, center.posn, right.posn, and obj.in.box) are used to determine if a screen object's position is within a certain area.

Example

 if (obj.in.box(o1, 0, 120, 60, 130)) {
   print("the object's entire bottom row is in the box");
 }

Technical Information

Required interpreter version	Available in all AGI versions
Bytecode value	16 (0x10 hex)

Sources

WinAGI help file