Description

Causes the steps following this action to execute if the specified pixel(s) is(are) in the specified state. If not, execution follows the next Else or End If action, whichever comes first. Commonly used to check if a graphic or area of the screen matches (or stops matching) a "checksum" of pixel colors. Very useful for detecting subtle changes in a window's contents that cannot be measure by any other means. In visual mode, it is easy to create the checksum values, while in the properties of the action, simply move the mouse pointer around the target window while repeatedly pressing the INSERT key.

Declaration

<AMIFPIXELEXISTS ACTION="options" XPOS="list" YPOS="list" COLOR="list" RELATIVE="yes/no">

Example

<AMIFPIXELEXISTS XPOS="152,248" YPOS="313,404" COLOR="16777215,12570320">

     <AMMESSAGEBOX>if matches to this</AMMESSAGEBOX>

<AMELSE>

     <AMMESSAGEBOX>if matches to this</AMMESSAGEBOX>

</AMIF>

General Tab Parameters

If: Specifies whether to wait for the pixel(s) to match the specified color(s), differ from the specified color(s), or change to any other color.

• match: Wait until the pixel color(s) match the pixel(s) specified in the corresponding XPOS, YPOS and COLOR parameter.

• differ: Wait until the pixel color(s) do not match all of the pixel(s) specified in the corresponding XPOS, YPOS and COLOR parameter.

Text, optional default match
MARKUP: ACTION="differ"

X Pos: Specifies the X coordinate of the pixel(s) to watch for. Multiple pixels/color pairs may be specified by separating the entries with commas. All parameters must have the same number of items specified (unless Action is any [ACTION="any"] in which case color is omitted).

Text, Required
MARKUP: XPOS="36"

Y Pos: Specifies the Y coordinate of the pixel(s) to watch for. Multiple pixels/color pairs may be specified by separating the entries by commas. All parameters must have the same number of items specified (unless Action is any [ACTION="any"] in which case color is omitted).

Text, Required
MARKUP: YPOS="36"

Color: Specifies the color(s) that the corresponding pixels specified in XPOS and YPOS should be. Multiple pixels/color pairs may be specified by separating the entries with commas. All parameters must have the same number of items specified (unless Action is any [ACTION="any"] in which case color is omitted).

Text, Required
MARKUP: COLOR="13160660"

See Also

Wait for File, Wait for Process