Difference between revisions of "AGIWiki/center.posn"

Latest revision as of 15:11, 25 October 2018

Test commands

The center.posn command returns TRUE if the screen coordinates of the screen object's bottom center pixel is within a specified region.

Syntax

center.posn(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 (center.posn(o1, 0, 120, 60, 130)) {
   print("the object's lower center pixel is in the box");
 }

Technical Information

Required interpreter version	Available in all AGI versions
Bytecode value	17 (0x11 hex)

Sources

WinAGI help file

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{AGIWiki}}
+{{AGIWiki/Test commands}}
 The '''center.posn''' command returns TRUE if the screen coordinates of the screen object's bottom center pixel is within a specified region.
@@ Line 16: / Line 16: @@
 The region to be tested is bounded by (X1, Y1) - (X2, Y2).
-The position test commands ('''[[AGIWiki/posn|posn]]''', ''''''center.posn'''''', '''[[AGIWiki/right.posn|right.posn]]''', and '''[[AGIWiki/obj.in.box|obj.in.box]]''' are used to determine if a screen object's position is within a certain area.
+The position test commands ('''[[AGIWiki/posn|posn]]''', '''center.posn''', '''[[AGIWiki/right.posn|right.posn]]''', and '''[[AGIWiki/obj.in.box|obj.in.box]]''') are used to determine if a screen object's position is within a certain area.
 == Example ==
-<syntax type= "C++">
+<syntaxhighlight lang="cpp">
   if (center.posn(o1, 0, 120, 60, 130)) {
     print("the object's lower center pixel is in the box");
   }
-</syntax>
+</syntaxhighlight>
 == Technical Information ==