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())
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.
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.
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.
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.
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
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
Pangalan
Paglalarawan
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
Static Method
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
Static Method
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)
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
Static Method
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
Method
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.
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
Method
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.
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
Method
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.
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
Method
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.
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
Method
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.
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.
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
Method
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.
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.
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.
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.
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.
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.
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.
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
Method
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.
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
Method
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.
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
Method
Maghintay hanggang mawala ang template sa rehiyong ito. Kung aalisin ang timeout, isang scan pass lang ang gagawin.
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.
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
Method
Maghintay hanggang sa mawala ang anumang template sa listahan mula sa rehiyong ito. Kung aalisin ang timeout, isang scan pass lang ang gagawin.
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.
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
Method
Maghintay hanggang mawala ang lahat ng template sa listahan sa rehiyong ito. Kung aalisin ang timeout, isang scan pass lang ang gagawin.
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.
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
Method
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.
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.
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
Pangalan
Paglalarawan
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.
Paliitin ang parehong lapad at taas patungo sa gitna.
Syntax
region.middle(value=0.5)
Mga parameter
Pangalan
Paglalarawan
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.
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.