QueryBmp/en

Description

Alias: QB

Detects a bitmap.

Finds the bitmap on the screen. If it is found, it is entered in the output Found=1, otherwise Found=0, while the NotFound output parameter behaves the opposite. For testing the occurrence of the bitmap, the maximum waiting time can be set by the Wait parameter, skipping multiple occurrences using the Skip parameter and doing a masked search with (parameters MaskMode, BitmapMaskColor and ScreenMaskColor). The search area is specified by the value of the CaptureMode parameter.

Input parameters

Bitmap

Type Bitmap

Found bitmap.

MaskMode

Type Number

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

BitmapMaskColor

Type Color

Key color of the user mask in the specified bitmap (used only for MaskMode=1).

ScreenMaskColor

Type Color

Keep color of the user mask for the capture, matching the color of the BitmapMaskColor. You should set this value only if these two colors are different.

Skip

Type Number

Specifies the number of occurrences of the bitmap skipped during the search.

Wait

Type Number

Waiting time in seconds for the bitmap to appear.

CaptureMode

Type Number

Defines the search area (0=desktop, 1=active window, 2=active region, 3=active window area, 16=client part of the active window, 257-264=monitor 1-8, 512-520=active region 0-8).

Enabled

Type Number

Enables or disables the command. If the value is 0, the command will not be executed.

PreWait

Type 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

Found

Typ Number

Příznak nalezení bitmapy.

NotFound

Typ Number

Negovaný příznak nalezení bitmapy.

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