Runtime v2.81 · Na-update noong Set 30, 2026

Match

Read-only recognition match result na ibinalik ng region.find* helpers.

Syntax

Match

Hindi direktang makakagawa ng instance ng class na ito.

Mga parameter

Wala

Ibinabalik na halaga

—

Pagkilos / epekto

Read-only recognition match result na ibinalik ng region.find* helpers. Sa isang sangay ng Tagumpay sa pagkilala, itinuturo ng Recognition.result ang aktibong Match o MatchList.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

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 error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

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]
Point ng match. Karaniwang nagbabalik ng Point ang image/OCR/object recognition; ang image match na mas mababa sa threshold ay maaari pa ring magbalik ng pinakamahusay na candidate point kapag may bounds. Maaaring magbalik ng list[Point] ang color at multi-target recognition para magamit ang match.point[0].x/y sa pinakamahusay na point.
boundsRegion?
Bounds box ng matched area. Ang image match na mas mababa sa threshold ay maaari pa ring magpakita ng pinakamahusay na candidate bounds.
regionRegion?
Alias ng bounds; ibinabalik ang parehong matched Region o None.
inference_infodict?
Metadata ng model o kulay kapag available. Kasama sa TFLite metadata ang backend, class_id, class_name, preprocess_ms, inference_ms, postprocess_ms, total_ms, input_width, input_height, opsyonal na sukat ng debug image, at capture telemetry. Sa inference debug dialog lang ipinapakita ang detalyadong mga row ng debug_result. Kasama sa metadata ng kulay ang backend=color, target_color, sampled_color, point, max_channel_delta, confidence, interval, match_count, at matches.
Halimbawa ng field
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
info_class_id = info.class_id
info_class_name = info.class_name

color_hit = Region(0, 0, 1080, 1920).find_color("#FFFFFF", tolerance=4)
color_name = color_hit.name
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

Gumuhit ng highlight na frame para sa tugmang ito kapag found=true.

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
Outline width in pixels.
Opsyonal · Ayon sa posisyon o pangalan
Default: 2
region_widthNumber
Fallback square width when the match only has point.
Opsyonal · Ayon sa posisyon o pangalan
Default: 36
auto_hide_msNumber
Auto-hide timeout in milliseconds. 0 keeps highlight visible.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0

Ibinabalik na halaga

Match — Ibinabalik ang parehong tugma pagkatapos ng pagguhit ng highlight.

Pagkilos / epekto

Gumuhit ng highlight na frame para sa tugmang ito kapag found=true. Gumagamit muna ng mga hangganan; kapag ang mga hangganan ay nawawala, gumuhit ng isang parisukat para sa bawat punto sa punto/listahan.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Match.highlight_off

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

Syntax

match.highlight_off()

Mga parameter

Wala

Ibinabalik na halaga

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

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API