BmpPos/en: Porovnání verzí
(Založena nová stránka s textem „BmpPos“) |
|||
| (Není zobrazeno 47 mezilehlých verzí od 2 dalších uživatelů.) | |||
| Řádek 3: | Řádek 3: | ||
[[Category:GuiMaster Library]] | [[Category:GuiMaster Library]] | ||
| − | == | + | == Description == |
'''Alias: BP''' | '''Alias: BP''' | ||
| − | ''' | + | '''Detects the bitmap position.''' |
| − | + | Searches for a bitmap given by the [[#bitmap-| Bitmap]] parameter on the screen and then if the bitmap is found, it stores the occurrence coordinates to [[#left-| Left]], [[#top-| Top]], [[#right-| Right]] and [[#bottom-| Bottom]] parameters. The capture offset is stored in the [[#captureleft-| CaptureLeft]] and [[#capturetop-| CaptureTop]] parameters. It is possible to set the timeout with the [[#wait-| Wait]] parameter, to skip multiple occurrences with the [[#skip-| Skip]] parameter and to specify masking with ([[#maskmode-| MaskMode]], [[#bitmapmaskcolor-| BitmapMaskColor]] and [[#screenmaskcolor-| ScreenMaskColor]] parameters). The search area is determined by the value of the [[#capturemode-| CaptureMode]] parameter. In case no bitmap is found, the command ends with an error. | |
| − | == | + | == Input parameters == |
<span id="bitmap-"></span> | <span id="bitmap-"></span> | ||
=== Bitmap === | === Bitmap === | ||
| − | + | [[Special:MyLanguage/Datové typy#Bitmap | Bitmap]] type | |
| − | + | Detected bitmap. | |
<span id="maskmode-"></span> | <span id="maskmode-"></span> | ||
=== MaskMode === | === MaskMode === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Mask mode used for the bitmap search (0=none, 1=user mask, 2=automatic mask). | |
<span id="bitmapmaskcolor-"></span> | <span id="bitmapmaskcolor-"></span> | ||
=== BitmapMaskColor === | === BitmapMaskColor === | ||
| − | + | [[Special:MyLanguage/Datové typy#Color | Color]] type | |
| − | + | The key color of the user mask in the Bitmap (used only if [[#maskmode-| MaskMode]]=1). | |
<span id="screenmaskcolor-"></span> | <span id="screenmaskcolor-"></span> | ||
=== ScreenMaskColor === | === ScreenMaskColor === | ||
| − | + | [[Special:MyLanguage/Datové typy#Color | Color]] type | |
| − | + | The key color of the user mask on the captured screen corresponding to the [[#bitmapmaskcolor-| BitmapMaskColor]]. You should set this value only if these two colors are different. | |
<span id="skip-"></span> | <span id="skip-"></span> | ||
=== Skip === | === Skip === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Defines number of bitmap occurrences that are skipped when searched. | |
<span id="wait-"></span> | <span id="wait-"></span> | ||
=== Wait === | === Wait === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Timeout in seconds for the occurrence of the searched bitmap. | |
<span id="capturemode-"></span> | <span id="capturemode-"></span> | ||
=== CaptureMode === | === CaptureMode === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Defines the search area (0=desktop, 1=active window, 2=active region, 3=area of active window, 16=active window client area, 257-264=monitor 1-8, 512-520=active region 0-8). | |
=== Enabled === | === Enabled === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Enables or disables the command. If the value is 0, the command will not be executed. | |
=== PreWait === | === PreWait === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Delay in milliseconds before executing the command. It has no effect if Enabled=0. | |
=== PostWait === | === PostWait === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Delay in milliseconds after executing the command. It has no effect if Enabled=0. | |
| − | == | + | == Output parameters == |
<span id="left-"></span> | <span id="left-"></span> | ||
=== Left === | === Left === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Coordinates of the left side of the [[#bitmap-| Bitmap]] occurrence. | |
<span id="top-"></span> | <span id="top-"></span> | ||
=== Top === | === Top === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Coordinate of the top side of the [[#bitmap-| Bitmap]] occurrence. | |
<span id="right-"></span> | <span id="right-"></span> | ||
=== Right === | === Right === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Coordinates of the right side of the [[#bitmap-| Bitmap]] occurrence. | |
=== Bottom === | === Bottom === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Coordinate of the bottom side of the [[#bitmap-| Bitmap]] occurrence. | |
<span id="captureleft-"></span> | <span id="captureleft-"></span> | ||
=== CaptureLeft === | === CaptureLeft === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Horizontal position of the searched area within the desktop. | |
=== CaptureTop === | === CaptureTop === | ||
| − | + | [[Special:MyLanguage/Datové typy#Number | Number]] type | |
| − | + | Vertical position of the searched area within the desktop. | |
| + | |||
| + | == See also == | ||
| + | |||
| + | [[Special:MyLanguage/Používání masky|Using a mask]] | ||
| + | |||
| + | [[Special:MyLanguage/Režimy snímání obrazovky|Capture modes]] | ||
| + | |||
| + | [[Special:MyLanguage/Řešení více výskytů hledané bitmapy|Resolving multiple occurrences of the searched bitmap]] | ||
| + | |||
| + | [[Special:MyLanguage/Časový limit a systémové parametry|Timeout and system parameters]] | ||
Aktuální verze z 3. 2. 2021, 09:17
Obsah
Description
Alias: BP
Detects the bitmap position.
Searches for a bitmap given by the Bitmap parameter on the screen and then if the bitmap is found, it stores the occurrence coordinates to Left, Top, Right and Bottom parameters. The capture offset is stored in the CaptureLeft and CaptureTop parameters. It is possible to set the timeout with the Wait parameter, to skip multiple occurrences with the Skip parameter and to specify masking with ( MaskMode, BitmapMaskColor and ScreenMaskColor parameters). The search area is determined by the value of the CaptureMode parameter. In case no bitmap is found, the command ends with an error.
Input parameters
Bitmap
Bitmap type
Detected bitmap.
MaskMode
Number type
Mask mode used for the bitmap search (0=none, 1=user mask, 2=automatic mask).
BitmapMaskColor
Color type
The key color of the user mask in the Bitmap (used only if MaskMode=1).
ScreenMaskColor
Color type
The key color of the user mask on the captured screen corresponding to the BitmapMaskColor. You should set this value only if these two colors are different.
Skip
Number type
Defines number of bitmap occurrences that are skipped when searched.
Wait
Number type
Timeout in seconds for the occurrence of the searched bitmap.
CaptureMode
Number type
Defines the search area (0=desktop, 1=active window, 2=active region, 3=area of active window, 16=active window client area, 257-264=monitor 1-8, 512-520=active region 0-8).
Enabled
Number type
Enables or disables the command. If the value is 0, the command will not be executed.
PreWait
Number type
Delay in milliseconds before executing the command. It has no effect if Enabled=0.
PostWait
Number type
Delay in milliseconds after executing the command. It has no effect if Enabled=0.
Output parameters
Left
Number type
Coordinates of the left side of the Bitmap occurrence.
Top
Number type
Coordinate of the top side of the Bitmap occurrence.
Right
Number type
Coordinates of the right side of the Bitmap occurrence.
Bottom
Number type
Coordinate of the bottom side of the Bitmap occurrence.
CaptureLeft
Number type
Horizontal position of the searched area within the desktop.
CaptureTop
Number type
Vertical position of the searched area within the desktop.
