WaitForColor/en

Description

Alias: WFC

Waits for the pixel color at Reference1 or anywhere in the area defined by two references.

Repeatedly searches the screen for Bitmap1, or Bitmap2 if specified. Once found, and depending on the value of the WaitMode, it waits for the desired Color to appear or disappear at the location of Reference1 or (in the case of two bitmaps) in a rectangular area delimited by both references. To search for reference bitmaps, the maximum waiting time can be set using Wait, to skip multiple occurrences using Skip1 or Skip2, and to mask the search by using MaskMode1, BitmapMaskColor1 and ScreenMaskColor1 or MaskMode2, BitmapMaskColor2 and ScreenMaskColor2. The search area is specified by the value of the CaptureMode. If none of the bitmaps is found, the command ends in error.

Input parameters

Bitmap1

Type Bitmap

Reference bitmap for the location where the desired color or first corner of the area appears.

Reference1

Type Reference

Reference for the location where the desired color or first corner of the area appears.

Bitmap2

Type Bitmap

Reference bitmap for the second corner of the area. If not specified, the color will be detected in the pixel specified by Reference1.

Reference2

Type Reference

Reference for the second corner of the area.

Color

Type Color

Desired color.

WaitMode

Type Number

Color wait mode (0=wait to display, 1=wait to disappear).

MaskMode1

Type Number

Mask mode used for detecting Bitmap1 (0=none, 1=user mask, 2=automatic mask).

BitmapMaskColor1

Type Color

Key color of the user mask in Bitmap1 (used only for MaskMode1=1).

ScreenMaskColor1

Type Color

Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor1. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.

MaskMode2

Type Number

Mask mode used for detecting Bitmap2 (0=none, 1=user mask, 2=automatic mask).

BitmapMaskColor2

Type Color

Key color of the user mask in Bitmap2 (used only for MaskMode2=1).

ScreenMaskColor2

Type Color

Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor2. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.

Skip1

Type Number

Určuje počet výskytů bitmapy Bitmap1, které se při vyhledávání přeskočí.

Skip2

Type Number

Určuje počet výskytů bitmapy Bitmap2, které se při vyhledávání přeskočí.

Wait

Type Number

Doba čekání v sekundách na výskyt hledaných bitmap.

CaptureMode

Type Number

Definuje oblast vyhledávání bitmap Bitmap1 a Bitmap2 (0=desktop, 1=aktivní okno, 2=aktivní region, 3=oblast aktivního okna, 16=klientská část aktivního okna, 257-264=monitor 1-8, 512-520=aktivní region 0-8).

Enabled

Type Number

Povoluje nebo zakazuje příkaz. Při hodnotě 0 nebude příkaz proveden.

PreWait

Type Number

Prodleva v milisekundách před provedením příkazu. Nemá žádný vliv je-li Enabled=0.

PostWait

Type Number

Prodleva v milisekundách po provedení příkazu. Nemá žádný vliv je-li Enabled=0.

Viz také

Příklady použití

Používání masky

Režimy snímání obrazovky

Řešení více výskytů hledané bitmapy

Časový limit a systémové parametry