CaptureBitmap
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
Number type
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.