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

ScaleParam

Mga parameter ng pagtutugma ng template para sa Region.

Syntax

ScaleParam(grayscale=True, auto_scale=False, cache_scale=True, template_scale="SHORT_EDGE", fast_matching=False)

Mga parameter ng constructor

PangalanPaglalarawan
grayscaleBoolean
**Applies to templates**. Convert template matching to grayscale.
Opsyonal · Ayon sa posisyon o pangalan
Default: True
auto_scaleBoolean
Sumubok ng mga laki ng template sa adaptive na 0.70x-1.30x na saklaw ng gilid pagkatapos ilapat ang itinakdang template scale.
Opsyonal · Ayon sa posisyon o pangalan
Default: False
cache_scaleBoolean
I-cache ang mga matagumpay na auto-scale value.
Opsyonal · Ayon sa posisyon o pangalan
Default: True
template_scaleString
Mga value: SHORT_EDGE, LONG_EDGE, DPI, SMALLEST_WIDTH_DP, NONE.
Opsyonal · Ayon sa posisyon o pangalan
Default: SHORT_EDGE
fast_matchingBoolean
Paliitin sa dalawang-katlo ang larawan ng Region at ang template bago itugma. Mas mabilis ito, ngunit maaaring bahagyang bumaba ang accuracy, lalo na para sa maliliit na icon.
Opsyonal · Ayon sa posisyon o pangalan
Default: False

Ibinabalik na halaga

ScaleParam

Pagkilos / epekto

Mga parameter ng pagtutugma ng template para sa Region. Pinaliliit ng fast_matching ang larawan ng Region at ang template.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

# I-configure ang preprocessing ng pagtutugma sa Region na ito
settings = ScaleParam(grayscale=True, fast_matching=True)
region = Region(100, 200, 300, 400, scale_param=settings)
print(region.find("start", timeout=0).found)

Mga error / limitasyon

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

Mga kaugnay na API

Wala

Mga field

PangalanPaglalarawan
grayscaleBoolean
**Applies to templates**. Convert screenshot/template to grayscale before template matching.
Default: True
auto_scaleBoolean
Sumubok ng mga laki ng template sa paligid ng itinakdang scale gamit ang adaptive na saklaw: sa mataas na DPI/resolution, sinusuri ang mas maliliit na candidate hanggang 0.70x; sa mababang DPI/resolution, sinusuri ang mas malalaking candidate hanggang 1.30x.
Default: False
cache_scaleBoolean
I-cache ang unang matagumpay na auto-scale value para sa mga susunod na run. Nalalapat lamang kapag True ang auto_scale.
Default: True
template_scaleString
Base mode ng scale ng template. Mga value: SHORT_EDGE, LONG_EDGE, DPI, SMALLEST_WIDTH_DP, NONE.
Default: SHORT_EDGE
fast_matchingBoolean
Paliitin sa dalawang-katlo ang larawan ng Region at ang template bago itugma. Mas mabilis ito, ngunit maaaring bahagyang bumaba ang accuracy, lalo na para sa maliliit na icon.
Default: False
Halimbawa ng field
param = ScaleParam(auto_scale=True, template_scale="LONG_EDGE", fast_matching=True)
param.cache_scale = False
template_mode = param.template_scale
Halimbawa ng constructor
param = ScaleParam(grayscale=True, auto_scale=True, cache_scale=True, template_scale="LONG_EDGE", fast_matching=True)
quick = ScaleParam(False, True, True, "LONG_EDGE", True)