SetActiveRegion/en: Porovnání verzí
(Založena nová stránka s textem „Key color of the user mask for the capture, matching the color of the BitmapMaskColor2. You should set this value only if these two…“) |
|||
| (Není zobrazeno 28 mezilehlých verzí od 2 dalších uživatelů.) | |||
| Řádek 9: | Řádek 9: | ||
'''Sets the active region of the screen.''' | '''Sets the active region of the screen.''' | ||
| − | Sets the active region of the screen with the [[#regionid-| RegionId]] number for use in the [[#capturemode-| CaptureMode]]=2 (or 512-520) viewport in subsequent commands. The area is specified by two points [[#reference1-| Reference1]] and [[#reference2-| Reference2]] relative to [[#bitmap1-| Bitmap1]] and [[#bitmap2-| Bitmap2]]. To search for reference bitmaps, | + | Sets the active region of the screen with the [[#regionid-| RegionId]] number for use in the [[#capturemode-| CaptureMode]]=2 (or 512-520) viewport in subsequent commands. The area is specified by two points [[#reference1-| Reference1]] and [[#reference2-| Reference2]] relative to [[#bitmap1-| Bitmap1]] and [[#bitmap2-| Bitmap2]]. To search for reference bitmaps, timeout can be set using [[#wait-|Wait]], to skip multiple occurrences using [[#skip1-|Skip1]] or [[#skip2-|Skip2]], and to mask the search by using [[#maskmode1-|MaskMode1]], [[#bitmapmaskcolor1-|BitmapMaskColor1]] and [[#screenmaskcolor1-|ScreenMaskColor1]] or [[#maskmode2-|MaskMode2]], [[#bitmapmaskcolor2-|BitmapMaskColor2]] and [[#screenmaskcolor2-|ScreenMaskColor2]]. Search areas are specified by the values of [[#capturemode1-|CaptureMode1]] and [[#capturemode2-|CaptureMode2]]. If any of the bitmaps is not found, the command ends in error. |
== Input parameters == | == Input parameters == | ||
| Řádek 35: | Řádek 35: | ||
<span id="reference2-"></span> | <span id="reference2-"></span> | ||
| + | |||
=== Reference2 === | === Reference2 === | ||
| Řádek 72: | Řádek 73: | ||
=== MaskMode2 === | === MaskMode2 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
Mask mode used for searching for [[#bitmap2-| Bitmap2]] (0=none, 1=user mask, 2=automatic mask). | Mask mode used for searching for [[#bitmap2-| Bitmap2]] (0=none, 1=user mask, 2=automatic mask). | ||
| Řádek 79: | Řádek 80: | ||
=== BitmapMaskColor2 === | === BitmapMaskColor2 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Color | Color]] | |
Key color of the user mask in [[#bitmap2-| Bitmap2]] (used only for [[#maskmode2-| MaskMode2]]=1). | Key color of the user mask in [[#bitmap2-| Bitmap2]] (used only for [[#maskmode2-| MaskMode2]]=1). | ||
| Řádek 86: | Řádek 87: | ||
=== ScreenMaskColor2 === | === ScreenMaskColor2 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Color | Color]] | |
Key color of the user mask for the capture, matching the color of the [[#bitmapmaskcolor2-| BitmapMaskColor2]]. You should set this value only if these two colors are different. | Key color of the user mask for the capture, matching the color of the [[#bitmapmaskcolor2-| BitmapMaskColor2]]. You should set this value only if these two colors are different. | ||
| Řádek 93: | Řádek 94: | ||
=== Skip1 === | === Skip1 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Specifies the number of times [[#bitmap1-| Bitmap1]] was skipped during the search. | |
<span id="skip2-"></span> | <span id="skip2-"></span> | ||
=== Skip2 === | === Skip2 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Specifies the number of times [[#bitmap2-| Bitmap2]] was skipped during the search. | |
<span id="wait-"></span> | <span id="wait-"></span> | ||
=== Wait === | === Wait === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Waiting time in seconds for searched bitmaps to appear. | |
<span id="capturemode1-"></span> | <span id="capturemode1-"></span> | ||
=== CaptureMode1 === | === CaptureMode1 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Defines the search area of [[# bitmap1-|Bitmap1]] (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). | |
<span id="capturemode2-"></span> | <span id="capturemode2-"></span> | ||
=== CaptureMode2 === | === CaptureMode2 === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Defines the search area of [[# bitmap2-|Bitmap2]] (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 === | === Enabled === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Enables or disables the command. If the value is 0, the command will not execute. | |
=== PreWait === | === PreWait === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Delay in milliseconds before executing the command. It has no effect if Enabled=0. | |
=== PostWait === | === PostWait === | ||
| − | + | Type [[Special:MyLanguage/Data types#Number | Number]] | |
| − | + | Delay in milliseconds before executing the command. It has no effect if Enabled=0. | |
| − | == | + | == Output parameters == |
| − | == | + | == See also == |
| − | [[Special:MyLanguage/ | + | [[Special:MyLanguage/Examples of use#SetActiveRegion | Examples of use]] |
| − | [[Special:MyLanguage/ | + | [[Special:MyLanguage/Using masks|Using masks]] |
| − | [[Special:MyLanguage/ | + | [[Special:MyLanguage/Capture modes|Capture modes]] |
| − | [[Special:MyLanguage/ | + | [[Special:MyLanguage/Resolving multiple occurrences of the searched bitmap|Resolving multiple occurrences of the searched bitmap]] |
| − | [[Special:MyLanguage/ | + | [[Special:MyLanguage/Timeout and system parameters|Timeout and system parameters]] |
Aktuální verze z 3. 2. 2021, 13:58
Description
Alias: SAR
Sets the active region of the screen.
Sets the active region of the screen with the RegionId number for use in the CaptureMode=2 (or 512-520) viewport in subsequent commands. The area is specified by two points Reference1 and Reference2 relative to Bitmap1 and Bitmap2. To search for reference bitmaps, timeout can be set using Wait, to skip multiple occurrences using Skip1 or Skip2, and to mask the search by using MaskMode1, BitmapMaskColor1 and ScreenMaskColor1 or MaskMode2, BitmapMaskColor2 and ScreenMaskColor2. Search areas are specified by the values of CaptureMode1 and CaptureMode2. If any of the bitmaps is not found, the command ends in error.
Input parameters
Bitmap1
Type Bitmap
Bitmap reference of the first corner of the viewport.
Reference1
Type Reference
Reference relative to Bitmap1 specifying the first corner of the viewport.
Bitmap2
Type Bitmap
Bitmap reference of the second corner of the viewport.
Reference2
Type Reference
Reference relative to Bitmap2 specifying the second corner of the viewport.
RegionId
Type Number
Number of region. Admissable values are from 0 to 8.
MaskMode1
Type Number
Mask mode used for searching for Bitmap1 (0=none, 1=user mask, 2=automatic mask).
BitmapMaskColor1
Type Color
Key color of the user mask in Bitmap1 (used only for MaskMode1=1).
ScreenMaskColor1
Type Color
Key color of the user mask for the capture, matching the color of BitmapMaskColor1. You should set this value only if these two colors are different.
MaskMode2
Type Number
Mask mode used for searching for Bitmap2 (0=none, 1=user mask, 2=automatic mask).
BitmapMaskColor2
Type Color
Key color of the user mask in Bitmap2 (used only for MaskMode2=1).
ScreenMaskColor2
Type Color
Key color of the user mask for the capture, matching the color of the BitmapMaskColor2. You should set this value only if these two colors are different.
Skip1
Type Number
Specifies the number of times Bitmap1 was skipped during the search.
Skip2
Type Number
Specifies the number of times Bitmap2 was skipped during the search.
Wait
Type Number
Waiting time in seconds for searched bitmaps to appear.
CaptureMode1
Type Number
Defines the search area of Bitmap1 (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).
CaptureMode2
Type Number
Defines the search area of Bitmap2 (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 execute.
PreWait
Type Number
Delay in milliseconds before executing the command. It has no effect if Enabled=0.
PostWait
Type Number
Delay in milliseconds before executing the command. It has no effect if Enabled=0.
