CaptureBitmap

Popis

Alias: CB

Získá výřez obrazovky určený dvěma referencemi.

Vyhledá na obrazovce referenční bitmapy Bitmap1 a Bitmap2 a poté uloží obdélníkový výřez jehož rohy určují body Reference1 a Reference2 jako bitmapu do výstupního parametru Bitmap. Pro vyhledávání referenčních bitmap je možné nastavit maximální čekací dobu parametrem Wait, přeskočení vícenásobných výskytů parametry Skip1 příp. Skip2 a vyhledávání s maskou (parametry MaskMode1, BitmapMaskColor1 a ScreenMaskColor1 resp. MaskMode2, BitmapMaskColor2 a ScreenMaskColor2). Oblast vyhledávání určuje hodnota parametru CaptureMode. Pokud není některá z bitmap naleznena, příkaz končí chybou.

Vstupní parametry

Bitmap1

Typ Bitmap

Bitmapa reference prvního rohu výřezu.

Reference1

Typ Reference

Reference vztažená k Bitmap1 určující první roh výřezu.

Bitmap2

Typ Bitmap

Bitmapa reference druhého rohu výřezu.

Reference2

Typ Reference

Reference vztažená k Bitmap2 určující druhý roh výřezu.

MaskMode1

Typ 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

Typ 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

Typ Number

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

Skip2

Typ Number

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

Wait

Typ Number

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

CaptureMode

Typ Number

Definuje oblast vyhledávání bitmap Bitmap1 a Bitmap2.

Enabled

Typ Number

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

PreWait

Typ Number

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

PostWait

Typ Number

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

Výstupní parametry

Bitmap

Typ Bitmap

Vygenerovaná bitmapa.

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