Region

Parihabang lugar sa screen para maghanap ng larawan o kulay, kumuha ng larawan, o gumuhit ng balangkas. Pixel ang mga coordinate sa kasalukuyang pahalang/patayong axis; pagkatapos i-scale at ilipat, ang bahaging nasa loob lang ng screen ang ginagamit. Basahin ang sukat gamit ang x, y, width, height = region.

Syntax

Region(x, y, width, height, /, scale="fixed", anchor="none", scale_param=ScaleParam())

Mga parameter ng constructor

PangalanPaglalarawan
xNumber
Top-left X coordinate
Kailangan · Ayon lang sa posisyon
Walang default
yNumber
Top-left Y coordinate
Kailangan · Ayon lang sa posisyon
Walang default
widthNumber
Region width
Kailangan · Ayon lang sa posisyon
Walang default
heightNumber
Region height
Kailangan · Ayon lang sa posisyon
Walang default
scaleString
Pag-angkop ng coordinate sa buong screen: pinananatili ng fixed ang pixel; inaangkop ng auto ang X ayon sa lapad at Y ayon sa taas; inaangkop ng width o height ang dalawang axis ayon sa sukat na iyon. Ginagamit ang laki ng source screen ng macro nang hindi iniikot ang mga axis o ginagamit ang laki ng app window.
Opsyonal · Ayon sa posisyon o pangalan
Default: fixed
anchorString
Batayang posisyon sa pag-angkop ng coordinate: none (kaliwang itaas), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right. Pinipili ng auto ang pinakamalapit na gilid o gitna.
Opsyonal · Ayon sa posisyon o pangalan
Default: none
scale_paramScaleParam
**Applies to templates**. Template matching scale parameters.
Opsyonal · Ayon sa posisyon o pangalan
Default: ScaleParam()

Ibinabalik na halaga

Halimbawa

region = Region(100, 200, 300, 400)
hit = region.find("img", 3000, threshold=0.8, rate=3.0)

Mga field

PangalanPaglalarawan
xNumber
Top-left horizontal coordinate.
yNumber
Top-left vertical coordinate.
widthNumber
Region width in pixels.
heightNumber
Region height in pixels.
scaleString
Pag-angkop ng coordinate sa buong screen: pinananatili ng fixed ang pixel; inaangkop ng auto ang X ayon sa lapad at Y ayon sa taas; inaangkop ng width o height ang dalawang axis ayon sa sukat na iyon. Ginagamit ang laki ng source screen ng macro nang hindi iniikot ang mga axis o ginagamit ang laki ng app window.
Default: fixed
anchorString
Batayang posisyon sa pag-angkop ng coordinate: none (kaliwang itaas), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right. Pinipili ng auto ang pinakamalapit na gilid o gitna.
Default: none
scale_paramScaleParam
**Applies to templates**. Template matching scale parameters used by find/wait methods on this region.
Default: ScaleParam()
middle_pointPoint
Center point of this region.
Halimbawa ng field
search_area = Region(120, 240, 360, 420)
left = search_area.x
top = search_area.y
w = search_area.width
h = search_area.height
scale = search_area.scale
anchor = search_area.anchor
search_area.x = 300
search_area.scale_param = ScaleParam(auto_scale=True, template_scale="LONG_EDGE")
center = search_area.middle_point

# I-unpack ang Region bilang x, y, width, height
x, y, width, height = search_area
Halimbawa ng constructor
search_region = Region(120, 240, 360, 420)
fixed_center = Region(120, 240, 360, 420, "fixed", "center")
left_lane = Region(120, 240, 360, 420, scale="width", anchor="left", scale_param=ScaleParam(auto_scale=True, template_scale="LONG_EDGE"))

Mga method

30 method

Region.from_center

Gumawa ng fixed na Region na walang anchor mula sa may hangganang coordinate ng gitna at positibong may hangganang sukat. Pinananatili ang mga fractional na coordinate.

Syntax

Region.from_center(cx, cy, width, height)

Mga parameter

PangalanPaglalarawan
cxNumber
X coordinate ng gitna.
Kailangan · Ayon sa posisyon o pangalan
Walang default
cyNumber
Y coordinate ng gitna.
Kailangan · Ayon sa posisyon o pangalan
Walang default
widthNumber
Positibong lapad.
Kailangan · Ayon sa posisyon o pangalan
Walang default
heightNumber
Positibong taas.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Region — Dapat may hangganan ang mga coordinate at nakalkulang gilid; kung hindi, magkakaroon ng error.

Halimbawa

# Gumawa ng region sa paligid ng gitna
area = Region.from_center(100, 200, 50, 30)

Region.highlighted

Ibalik ang mga lugar sa screen na kasalukuyang may balangkas mula sa script, kasama ang mga parisukat mula sa Point.highlight().

Syntax

Region.highlighted()

Ibinabalik na halaga

list[Region] — listahan ng mga aktibong naka-highlight na rehiyon.

Halimbawa

active_regions = Region.highlighted()
for area in active_regions:
    area.highlight("yellow", auto_hide_ms=500)

Region.full_screen

Ibalik ang buong kasalukuyang rehiyon ng screen.

Syntax

Region.full_screen()

Ibinabalik na halaga

Region — Region na sumasaklaw sa kasalukuyang screen mula sa (0, 0).

Halimbawa

scan = Region.full_screen()
hit = scan.find("ok", 2000)

Region.highlight_off

I-off ang lahat ng aktibong highlight ng rehiyon.

Syntax

Region.highlight_off()

Ibinabalik na halaga

None — Walang halaga.

Halimbawa

scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
Region.highlight_off()

Region.macro_width

Return the screen width of the device that created this macro, adapted to current screen orientation, when available.

Syntax

Region.macro_width()

Ibinabalik na halaga

Number? — Lapad ng screen ng macro source, o Wala kapag hindi available.

Halimbawa

macro_w = Region.macro_width()

Region.macro_height

Return the screen height of the device that created this macro, adapted to current screen orientation, when available.

Syntax

Region.macro_height()

Ibinabalik na halaga

Number? — Taas ng screen ng macro source, o Wala kapag hindi available.

Halimbawa

macro_h = Region.macro_height()

Region.intersection

Ibalik bilang bagong Region ang nagsasapawang bahaging may positibong lawak, o None. Hindi nagsasapaw ang mga gilid na nagdidikit lamang. Ginagamit ang nakaimbak na coordinate sa parehong coordinate space nang walang capture, scaling o pagputol; pinananatili ang scale, anchor at scale_param ng Region na ito nang hindi ito binabago.

Syntax

region.intersection(other)

Mga parameter

PangalanPaglalarawan
otherRegion
Ang isa pang region.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Region? — Dapat may hangganan ang mga coordinate at nakalkulang gilid; kung hindi, magkakaroon ng error.

Halimbawa

# Hanapin ang nagsasapawang bahagi
overlap = Region(0, 0, 100, 100).intersection(Region(50, 50, 100, 100))

Region.intersects

Suriin ang pagsasapaw na may positibong lawak gamit ang nakaimbak na coordinate sa parehong coordinate space. Hindi nagsasapaw ang mga gilid na nagdidikit lamang; walang capture, scaling o pagputol.

Syntax

region.intersects(other)

Mga parameter

PangalanPaglalarawan
otherRegion
Ang isa pang region.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean — Dapat may hangganan ang mga coordinate at nakalkulang gilid; kung hindi, magkakaroon ng error.

Halimbawa

# Suriin kung nagsasapaw ang dalawang region
print(Region(0, 0, 100, 100).intersects(Region(50, 50, 20, 20)))

Region.contains

Suriin kung nasa loob gamit ang nakaimbak na coordinate sa parehong coordinate space, nang walang capture, scaling o pagputol. Kasama ang mga puntong nasa kaliwa at itaas na gilid, ngunit hindi ang nasa kanan at ibaba. Maaaring magkapareho ang hangganan ng Region; False ang resulta sa walang laman o negatibong sukat.

Syntax

region.contains(point_or_region)

Mga parameter

PangalanPaglalarawan
point_or_regionPoint | Region
Punto o region na susuriin.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean — Dapat may hangganan ang mga coordinate at nakalkulang gilid; kung hindi, magkakaroon ng error.

Halimbawa

# Suriin kung nasa loob ng region ang punto
print(Region(0, 0, 100, 100).contains(Point(10, 10)))

Region.find_text

Hanapin ang teksto gamit ang OCR sa loob ng rehiyong ito sa screen pixels. Dapat buong salita o parirala ang tugma, nang hindi pinuputol ang titik, digit, o underscore. Dapat handa ang screen capture. Paulit-ulit na maghahanap hanggang makita o maubos ang oras, at sinusuportahan ang pause at stop; katulad ng ibang recognition search ang pag-cache ng capture. Nagbibigay ng error kapag pumalya ang OCR o capture.

Syntax

region.find_text(text, timeout=0, threshold=100, rate=5, language="latin", preserve_case=False)

Mga parameter

PangalanPaglalarawan
textString
Tekstong hahanapin; hindi maaaring blangko.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa milliseconds; isang beses mag-scan kapag zero o negatibo ang value.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdInteger
Integer na OCR match threshold mula 0 hanggang 100; nangangailangan ang 100 ng eksaktong tugma matapos ang normalization.
Opsyonal · Ayon sa posisyon o pangalan
Default: 100
rateNumber
Hinihiling na bilang ng scan bawat segundo habang naghihintay, sa Hz, na nililimitahan mula 1 hanggang 60.
Opsyonal · Ayon sa posisyon o pangalan
Default: 5
languageString
Sistema ng sulat para sa OCR: latin, chinese, devanagari, japanese, o korean. Nagbibigay ng error ang ibang value, kabilang ang mga locale alias.
Opsyonal · Ayon sa posisyon o pangalan
Default: "latin"
preserve_caseBoolean
Itugma ang malaki at maliit na titik kapag True; bilang default ay hindi ito pinapansin.
Opsyonal · Ayon sa posisyon o pangalan
Default: False

Ibinabalik na halaga

Match — Ang nakitang Match ay may bounds at point sa pixels ng buong screen, confidence mula 0 hanggang 1, at name na naglalaman ng tumugmang target na teksto. Kapag walang nakita, found=False. Nagbibigay ng ambiguity error kapag magkapareho ang pinakamataas na score ng magkahiwalay na lokasyon; paliitin ang rehiyong hinahanap. Ang mga resultang magkapatong ay itinuturing na iisang lokasyon.

Halimbawa

# Hanapin at pindutin ang OK sa popup
hit = Region(500, 100, 400, 300).find_text("OK", timeout=3000)
if hit.found:
    click(hit)

Region.find

Maghanap ng isang katugma ng template sa lugar na ito. Ulitin hanggang makita o maubos ang oras; isang scan lang sa timeout=0. Dapat handa ang pagkuha ng screen. Ginagamit muli ng ScreenCapture.cache_on() ang isang larawan hanggang cache_off(); karaniwang hanggang 100 ms ang awtomatikong paggamit muli. Gamitin ang auto_cache_off() para sa pinakabagong larawang makukuha, kapalit ng mas maraming pagkuha.

Syntax

region.find(template, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateString | Template
Pangalan ng template o relative na path ng folder na walang image extension sa kasalukuyang macro, o Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

Match — Match na may found=True kapag nakita; kung hindi, found=False pagkatapos ng scan o pag-expire ng oras. Hindi kailanman None.

Halimbawa

region = Region(80, 220, 420, 520)
hit = region.find("ok", 4000, 0.8, 4.0)
MacroPanel.notify(str(hit))

Region.find_multi

I-scan sa loob ng rehiyong ito at ibalik ang lahat ng mga tugma para sa isang template kapag may nakitang kahit isa. Kung aalisin ang timeout, isang scan pass lang ang gagawin.

Syntax

region.find_multi(template, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateString | Template
Pangalan ng template o relative na path ng folder na walang image extension sa kasalukuyang macro, o Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

MatchList — Lahat ng mga tugma para sa template, o walang laman na listahan sa timeout.

Halimbawa

region = Region(80, 220, 420, 520)
matches = region.find_multi("enemy", 3000)
MacroPanel.notify(str(matches))

Region.find_any

I-scan ang rehiyong ito at bumalik kapag may nakitang template sa listahan. Kung aalisin ang timeout, isang scan pass lang ang gagawin.

Syntax

region.find_any(templates, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateslist[String | Template]
Mga pangalan ng template/relative na path ng folder na walang image extension, o mga Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

MatchList — Isang Match bawat input na template, ayon sa pagkakasunod, kapag may nakita; maaaring found=False ang ilan. Walang-lamang MatchList kung walang nakita bago maubos ang oras.

Halimbawa

region = Region(80, 220, 420, 520)
matches = region.find_any(["enemy_a", "enemy_b"], 2500)
MacroPanel.notify(str(matches))

Region.find_all

I-scan ang rehiyong ito at bumalik lamang kapag nakita ang bawat template sa listahan. Kung aalisin ang timeout, isang scan pass lang ang gagawin.

Syntax

region.find_all(templates, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateslist[String | Template]
Mga pangalan ng template/relative na path ng folder na walang image extension, o mga Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

MatchList — Isang matagumpay na Match bawat input na template ayon sa pagkakasunod, o walang-lamang MatchList kung walang scan na nakakita sa lahat bago maubos ang oras.

Halimbawa

region = Region(80, 220, 420, 520)
matches = region.find_all(["hp", "mp"], 5000)
MacroPanel.notify(str(matches))

Region.find_color

Hanapin ang isang sinuring pixel na pinakamalapit sa target na kulay sa lugar na ito. Hindi dapat lumampas sa tolerance ang diperensya ng bawat red, green at blue channel; pipiliin ang may pinakamaliit na pinakamataas na diperensya ng channel. Ulitin hanggang makita o maubos ang oras; isang scan sa timeout=0. Kailangang handa ang pagkuha ng screen.

Syntax

region.find_color(color, timeout=0, tolerance=0, rate=3, interval=10)

Mga parameter

PangalanPaglalarawan
colorColor | String | Number
Target color.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3
intervalNumber
Hinihiling na agwat sa pixel sa pagitan ng mga sinusuring posisyon; hindi bababa sa 1. Mas maraming pixel ang sinusuri sa mas maliit na halaga at maaaring mas tumagal. Maaaring awtomatikong lumaki ang agwat para sa malalaking lugar.
Opsyonal · Ayon sa posisyon o pangalan
Default: 10

Ibinabalik na halaga

Match — Match na may hanggang isang Point sa point, o found=False at walang-lamang listahan ng point kung walang sinuring pixel na tumugma o hindi makakuha ng screen.

Halimbawa

scan = Region(80, 220, 420, 520)
hit = scan.find_color("#FF4CAF50", tolerance=8, interval=4)
if hit.found:
    click(hit.point[0], random=0)

Region.find_any_color

Hanapin ang alinman sa mga target na kulay sa lugar na ito gamit ang tuntunin ng RGB tolerance ng find_color. Ibalik ang hanggang isang pinakamahusay na sinuring punto bawat nakitang kulay, ayon sa input. Ulitin hanggang may makitang kulay o maubos ang oras; isang scan sa timeout=0. Kailangang handa ang pagkuha ng screen.

Syntax

region.find_any_color(colors, timeout=0, tolerance=0, rate=3, interval=10)

Mga parameter

PangalanPaglalarawan
colorslist[Color | String | Number] | tuple[Color | String | Number]
Target colors.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3
intervalNumber
Hinihiling na agwat sa pixel sa pagitan ng mga sinusuring posisyon; hindi bababa sa 1. Mas maraming pixel ang sinusuri sa mas maliit na halaga at maaaring mas tumagal. Maaaring awtomatikong lumaki ang agwat para sa malalaking lugar.
Opsyonal · Ayon sa posisyon o pangalan
Default: 10

Ibinabalik na halaga

Match — Match na may isang pinakamahusay na Point bawat nakitang kulay sa point, ayon sa input. found=False at walang-lamang listahan ng point kung walang tumugma o hindi makakuha ng screen.

Halimbawa

colors = ["#FF0000", "#00FF00", "#0000FF"]
hit = Region.full_screen().find_any_color(colors, tolerance=6)
if hit.found:
    click(hit, random=0)

Region.find_multi_color

Hanapin ang lahat ng sinuring pixel na tumutugma sa isang target na kulay gamit ang tuntunin ng RGB tolerance ng find_color. Magkaka-error sa listahan o tuple ng mga kulay. Ulitin hanggang may makitang punto o maubos ang oras; isang scan sa timeout=0. Kailangang handa ang pagkuha ng screen.

Syntax

region.find_multi_color(color, timeout=0, tolerance=0, rate=3, interval=10)

Mga parameter

PangalanPaglalarawan
colorColor | String | Number
Single target color.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3
intervalNumber
Hinihiling na agwat sa pixel sa pagitan ng mga sinusuring posisyon; hindi bababa sa 1. Mas maraming pixel ang sinusuri sa mas maliit na halaga at maaaring mas tumagal. Maaaring awtomatikong lumaki ang agwat para sa malalaking lugar.
Opsyonal · Ayon sa posisyon o pangalan
Default: 10

Ibinabalik na halaga

Match — Match na may mga tumugmang sinuring Point sa point, na nauuna ang pinakamalapit na kulay. found=False at walang-lamang listahan ng point kung walang tumugma o hindi makakuha ng screen.

Halimbawa

hit = Region(80, 220, 420, 520).find_multi_color("red", tolerance=4, interval=3)
if hit.found:
    first = hit.point[0]
    hit.highlight(color="yellow", auto_hide_ms=800)

Region.wait

Maghintay hanggang mawala ang template sa rehiyong ito. Kung aalisin ang timeout, isang scan pass lang ang gagawin.

Syntax

region.wait(template, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateString | Template
Pangalan ng template o relative na path ng folder na walang image extension sa kasalukuyang macro, o Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

Match — Pinakahuling Match: ang found=False ay nangangahulugang wala ang larawan; ang found=True ay naroon pa ito nang matapos ang paghihintay. Hindi kailanman None. Kailangang handa ang pagkuha ng screen; maaari ring found=False kapag hindi makakuha ng screen.

Halimbawa

region = Region(0, 0, 1080, 2400)
result = region.wait("loading", 8000)
MacroPanel.notify(str(result))

Region.wait_any

Maghintay hanggang sa mawala ang anumang template sa listahan mula sa rehiyong ito. Kung aalisin ang timeout, isang scan pass lang ang gagawin.

Syntax

region.wait_any(templates, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateslist[String | Template]
Mga pangalan ng template/relative na path ng folder na walang image extension, o mga Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

MatchList — Pinakahuling Match bawat input na template ayon sa pagkakasunod, sa pagkawala o pag-expire ng oras. Suriin ang bawat found; ang False ay nangangahulugang wala ang larawang iyon. Kailangang handa ang pagkuha ng screen; maaari ring found=False kapag hindi makakuha ng screen.

Halimbawa

watch = ["loading", "syncing"]
result = region.wait_any(watch, 10000)
MacroPanel.notify(str(result))

Region.wait_all

Maghintay hanggang mawala ang lahat ng template sa listahan sa rehiyong ito. Kung aalisin ang timeout, isang scan pass lang ang gagawin.

Syntax

region.wait_all(templates, timeout=0, threshold=0.7, rate=3.0)

Mga parameter

PangalanPaglalarawan
templateslist[String | Template]
Mga pangalan ng template/relative na path ng folder na walang image extension, o mga Template object. Magkaka-error sa hindi kilalang pangalan.
Kailangan · Ayon sa posisyon o pangalan
Walang default
timeoutNumber
Pinakamahabang paghihintay sa millisecond. Isang scan kapag hindi ibinigay, zero o negatibo. Maaaring matapos ang kasalukuyang scan pagkalampas ng oras na ito.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.7
rateNumber
Hinihiling na scan bawat segundo habang naghihintay, limitado sa 1-60. Nakadepende ang tunay na bilis sa oras ng pagkilala.
Opsyonal · Ayon sa posisyon o pangalan
Default: 3.0

Ibinabalik na halaga

MatchList — Pinakahuling Match bawat input na template ayon sa pagkakasunod, sa pagkawala o pag-expire ng oras. False lang ang lahat ng found kapag wala na ang bawat larawan. Kailangang handa ang pagkuha ng screen; maaari ring found=False kapag hindi makakuha ng screen.

Halimbawa

watch = ["loading", "syncing"]
result = region.wait_all(watch, 10000)
MacroPanel.notify(str(result))

Region.capture

Kunin ang lugar na ito sa screen bilang Template. Kailangan ang aktibong pagkuha ng screen na may pahintulot ng user. Magkaka-error kung hindi makakuha ng screen o nasa labas ng screen ang buong lugar.

Syntax

region.capture(name=None)

Mga parameter

PangalanPaglalarawan
nameString?
Kapag may pangalan, agad ise-save ang larawan sa kasalukuyang macro; lumilikha ang None ng pansamantalang larawan. Hindi maaaring mag-save ng may-pangalang larawan sa protektadong macro.
Opsyonal · Ayon sa posisyon o pangalan
Default: None

Ibinabalik na halaga

Template — Template na naglalaman ng nakuhang larawan.

Halimbawa

sample = Region(120, 280, 220, 120).capture()
saved = sample.save_as("buttons/top/enemy_slot")

Region.left

Paliitin ang rehiyong ito patungo sa kaliwang bahagi. Ang kanang gilid ay gumagalaw pakaliwa ayon sa hiniling na halaga.

Syntax

region.left(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Lapad na aalisin: ang 0-1 ay bahagi ng kasalukuyang lapad; higit sa 1 ay pixel, hanggang sa buong lapad. Nagdudulot ng error ang negatibong halaga.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Ang isang bagong rehiyon ay makitid mula sa kanang gilid.

Halimbawa

full = Region(100, 200, 1000, 500)
left_focus = full.left(0.4)
left_focus_px = full.left(400)

Region.right

Paliitin ang rehiyong ito patungo sa kanang bahagi. Ang kaliwang gilid ay gumagalaw pakanan sa hiniling na halaga.

Syntax

region.right(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Lapad na aalisin: ang 0-1 ay bahagi ng kasalukuyang lapad; higit sa 1 ay pixel, hanggang sa buong lapad. Nagdudulot ng error ang negatibong halaga.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Isang bagong rehiyon ang pinaliit mula sa kaliwang gilid.

Halimbawa

full = Region(100, 200, 1000, 500)
right_focus = full.right(0.3)
right_focus_px = full.right(240)

Region.top

Paliitin ang rehiyong ito patungo sa itaas na bahagi. Ang ilalim na gilid ay gumagalaw paitaas ayon sa hiniling na halaga.

Syntax

region.top(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Taas na aalisin: ang 0-1 ay bahagi ng kasalukuyang taas; higit sa 1 ay pixel, hanggang sa buong taas. Nagdudulot ng error ang negatibong halaga.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Ang isang bagong rehiyon ay makitid mula sa ilalim na gilid.

Halimbawa

full = Region(100, 200, 1000, 500)
top_focus = full.top(0.25)
top_focus_px = full.top(120)

Region.bottom

Paliitin ang rehiyong ito patungo sa ibabang bahagi. Ang tuktok na gilid ay gumagalaw pababa ayon sa hiniling na halaga.

Syntax

region.bottom(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Taas na aalisin: ang 0-1 ay bahagi ng kasalukuyang taas; higit sa 1 ay pixel, hanggang sa buong taas. Nagdudulot ng error ang negatibong halaga.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Isang bagong rehiyon ang pinaliit mula sa tuktok na gilid.

Halimbawa

full = Region(100, 200, 1000, 500)
bottom_focus = full.bottom(0.25)
bottom_focus_px = full.bottom(120)

Region.horizontal

Paliitin nang pahalang patungo sa gitna sa pamamagitan ng paggalaw sa kaliwa at kanang mga gilid papasok.

Syntax

region.horizontal(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Kabuuang lapad na aalisin, pantay sa dalawang gilid: ang 0-1 ay bahagi, higit sa 1 ay pixel. Hanggang sa buong lapad; nagdudulot ng error ang negatibo.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Isang nakasentro na rehiyon na may pinababang lapad.

Halimbawa

full = Region(100, 200, 1000, 500)
center_lane = full.horizontal(0.5)
center_lane_px = full.horizontal(300)

Region.vertical

Paliitin nang patayo patungo sa gitna sa pamamagitan ng paggalaw sa itaas at ibabang mga gilid papasok.

Syntax

region.vertical(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Kabuuang taas na aalisin, pantay sa dalawang gilid: ang 0-1 ay bahagi, higit sa 1 ay pixel. Hanggang sa buong taas; nagdudulot ng error ang negatibo.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Isang nakasentro na rehiyon na may pinababang taas.

Halimbawa

full = Region(100, 200, 1000, 500)
center_band = full.vertical(0.5)
center_band_px = full.vertical(200)

Region.middle

Paliitin ang parehong lapad at taas patungo sa gitna.

Syntax

region.middle(value=0.5)

Mga parameter

PangalanPaglalarawan
valueNumber
Daming aalisin sa bawat sukat: ang 0-1 ay bahagi ng sukat na iyon; higit sa 1 ay pixel. Pantay na hinahati sa magkatapat na gilid, hanggang sa bawat buong sukat. Nagdudulot ng error ang negatibo.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5

Ibinabalik na halaga

Region — Ang isang nakasentro na rehiyon ay nabawasan sa parehong mga palakol.

Halimbawa

full = Region(100, 200, 1000, 500)
focus = full.middle(0.4)
focus_px = full.middle(160)

Region.highlight

Gumuhit ng parihabang balangkas sa lugar na ito. Kapag tinawag muli sa parehong Region, papalitan ang balangkas nito. Babalik bago matapos ang pagguhit; ang pinakahuling update lang bago ang susunod na refresh ng screen ang ipapakita.

Syntax

region.highlight(color="green", line_width=2, auto_hide_ms=0, movable=False)

Mga parameter

PangalanPaglalarawan
colorColor | String | Number
Highlight color.
Opsyonal · Ayon sa posisyon o pangalan
Default: green
line_widthNumber
Kapal ng balangkas sa dp; ang mas mababa sa 1 ay nagiging 1.
Opsyonal · Ayon sa posisyon o pangalan
Default: 2
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
movableBoolean
Allow dragging the highlighted region and write the moved coordinates back into this Region.
Opsyonal · Ayon sa posisyon o pangalan
Default: False

Ibinabalik na halaga

Region — Ibinabalik ang parehong rehiyon pagkatapos ng pagguhit ng highlight.

Halimbawa

scan = Region(120, 260, 280, 160)
scan.highlight("#FF00BCD4", line_width=3, auto_hide_ms=1500, movable=True)

Region.highlight_off

Alisin ang balangkas na ginawa ng Region na ito.

Syntax

region.highlight_off()

Ibinabalik na halaga

Region — Ibinabalik ang parehong rehiyon pagkatapos i-off ang highlight.

Halimbawa

scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
scan.highlight_off()