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

Referenční bitmapa pro místo výskytu požadované barvy nebo první roh oblasti.

Reference1

Type Reference

Reference pro místo výskytu požadované barvy nebo první roh oblasti.

Bitmap2

Type Bitmap

Referenční bitmapa pro druhý roh oblasti. Pokud není zadána, bude barva zjišťována v pixelu určeném referencí Reference1.

Reference2

Typ Reference

Reference pro druhý roh oblasti.

Color

Typ Color

Požadovaná barva.

WaitMode

Type Number

Režim čekání na barvu (0=čekání na zobrazení, 1=čekání na zmizení).

MaskMode1

Type Number

Režim masky použité při vyhledávání bitmapy Bitmap1 (0=žádná, 1=uživatelská maska, 2=automatická maska).

BitmapMaskColor1

Typ Color

Klíčová barva uživatelské masky v bitmapě Bitmap1 (používá se pouze při MaskMode1=1).

ScreenMaskColor1

Typ 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

Režim masky použité při vyhledávání bitmapy Bitmap2 (0=žádná, 1=uživatelská maska, 2=automatická maska).

BitmapMaskColor2

Typ Color

Klíčová barva uživatelské masky v bitmapě Bitmap2 (používá se pouze při MaskMode2=1).

ScreenMaskColor2

Typ 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