Match

Basahin ang resulta ng paghahanap. Suriin ang found bago mag-tap o gumamit ng lokasyon; maaari pa ring may lokasyon ng pinakamalapit na kandidato kahit hindi nahanap ang larawan.

Syntax

Match

Hindi direktang makakagawa ng instance ng class na ito.

Ibinabalik na halaga

—

Halimbawa

m = Region(100, 200, 300, 400).find("btn", 3000)
if m.found:
    click(m)
    conf = m.confidence

# Available lang ang Recognition.result sa Python ng branch na matagumpay ang recognition.
if Recognition.result.found:
    click(Recognition.result, random=0)

Mga field

PangalanPaglalarawan
nameString?
Matched target name. Template matches use the template name without extension, OCR uses the matched target text, and color matches use Color.
foundBoolean
Whether a match was found.
confidenceNumber
Confidence score from 0.0 to 1.0.
confNumber
Alias ng confidence; ibinabalik ang parehong score mula 0.0 hanggang 1.0.
pointPoint? | list[Point]
Lokasyon ng resulta: Point, listahan ng Point, o None. Nagbabalik ang paghahanap ng kulay ng listahang maaaring walang laman. Suriin ang found at anyo ng halaga bago basahin ang mga coordinate o kumuha ng item sa listahan.
boundsRegion?
Parihaba sa paligid ng resulta, o None kung walang available. Maaaring may parihaba pa rin ng pinakamalapit na kandidato kahit bigo ang paghahanap ng larawan; suriin muna ang found.
regionRegion?
Alias ng bounds; ibinabalik ang parehong matched Region o None.
inference_infodict?
Karagdagang detalye ng resulta, o None. Maaaring may class_id, class_name, mga oras na nagtatapos sa _ms (millisecond), at input_width/input_height (pixel) ang resulta ng modelo. Maaaring may target_color, sampled_color, max_channel_delta, match_count, at matches ang resulta ng kulay. Nag-iiba ang mga key ayon sa paghahanap; suriing mayroon ang key bago basahin.
Halimbawa ng field
# Basahin nang ligtas ang mga opsyonal na detalye at color point.
m = Region(100, 200, 300, 400).find("btn", 3000)
target_name = m.name
is_found = m.found
score = m.confidence
short_score = m.conf
center = m.point
box = m.bounds
same_box = m.region
info = m.inference_info
if info is not None:
    info_class_id = info.get("class_id")
    info_class_name = info.get("class_name")

color_hit = Region(0, 0, 1080, 1920).find_color("#FFFFFF", tolerance=4)
color_name = color_hit.name
if color_hit.found and color_hit.point:
    first_color_point = color_hit.point[0]

# Sa branch na matagumpay ang recognition:
current = Recognition.result
if current.found:
    text(current.name)
    current.highlight(color="yellow", auto_hide_ms=800)

Mga method

2 method

Match.highlight

Markahan sa screen ang nahanap na resulta. Iguhit ang bounds kung mayroon, o parisukat sa paligid ng bawat punto; walang iginuguhit kung found=false. Naka-iskedyul ang pagguhit, kaya maaaring matapos ang tawag bago lumitaw ang frame. Ang pinakahuling update na naghihintay para sa parehong object lamang ang iginuguhit sa susunod na frame ng screen.

Syntax

match.highlight(color="green", line_width=2, region_width=36, auto_hide_ms=0)

Mga parameter

PangalanPaglalarawan
colorColor | String | Number
Highlight color.
Opsyonal · Ayon sa posisyon o pangalan
Default: green
line_widthNumber
Kapal ng gilid sa mga pixel, na may minimum na 1.
Opsyonal · Ayon sa posisyon o pangalan
Default: 2
region_widthNumber
Lapad ng parisukat sa mga pixel kung mga punto lamang ang mayroon, na may minimum na 1.
Opsyonal · Ayon sa posisyon o pangalan
Default: 36
auto_hide_msNumber
Oras bago itago, sa millisecond. Pinananatiling nakikita ng 0 o negatibong halaga ang highlight hanggang tawagin ang highlight_off().
Opsyonal · Ayon sa posisyon o pangalan
Default: 0

Ibinabalik na halaga

Match — Ang parehong Match, upang maipagpatuloy ang pagtawag sa mga method nito.

Halimbawa

m = Region(100, 200, 300, 400).find("start", 3000)
m.highlight(color="yellow", line_width=3, auto_hide_ms=1200)

Match.highlight_off

I-off ang aktibong highlight na nabuo mula sa instance ng pagtutugma na ito.

Syntax

match.highlight_off()

Ibinabalik na halaga

Match — Ibinabalik ang parehong tugma pagkatapos i-off ang highlight.

Halimbawa

m = Region(100, 200, 300, 400).find("start", 3000)
m.highlight()
m.highlight_off()