CaptureBitmap/en

Description

Alias: CB

Gets the rectangular area of the screen specified by the two references.

Searches the reference bitmaps Bitmap1 and Bitmap2 on the screen, and then saves a rectangular viewport determined by the points Reference1 and Reference2 as a bitmap in the Bitmap output parameter. It is possible to set the timeout with the Wait parameter, skip multiple occurrences with the Skip1 and Skip2 parameters and specify masking ( MaskMode1, BitmapMaskColor1 and ScreenMaskColor1 eventually MaskMode2, BitmapMaskColor2 and ScreenMaskColor2 parameters). The search area is determined by the value of the CaptureMode parameter. If any of the bitmaps is not found, the command ends with an error.

Input parameters

Bitmap1

Bitmap type

Bitmap for reference of the first corner of the viewport.

Reference1

Reference type

A reference relative to the Bitmap1 specifying the first corner of the viewport.

Bitmap2

Bitmap type

Bitmap for reference of the second corner of the viewport.

Reference2

Reference type

A reference relative to the Bitmap2 specifying the first corner of the viewport.

MaskMode1

Number type

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

BitmapMaskColor1

Color type

The key color of the user mask in the Bitmap1 (used only if MaskMode1=1).

ScreenMaskColor1

Color type

The key color of the user mask on the captured screen corresponding to the color BitmapMaskColor1. It is only need to set this value if the two colors are different.

MaskMode2

Number type

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

BitmapMaskColor2

Color type

The key color of the user mask in the Bitmap2 (used only if MaskMode2=1).

ScreenMaskColor2

Color type

The key color of the user mask on the captured screen corresponding to the color BitmapMaskColor2. It is only need to set this value if the two colors are different.

Skip1

Number type

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

Skip2

Number type

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

Wait

Number type

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

CaptureMode

Number type

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

Enabled

Number type

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