MatchResult:getRegion()

Renvoie la région correspondante sous forme d'objet Region.

Description

La méthode getRegion() renvoie un objet Region qui représente la zone rectangulaire où la correspondance a été trouvée. Cette région inclut la position (X, Y) du coin supérieur gauche et les dimensions (largeur, hauteur) de la zone correspondante.

La région renvoyée peut être utilisée pour :

• Effectuer d'autres recherches dans la zone correspondante
• Capturer une capture d'écran de la seule région correspondante
• Définir une sous-région pour d'autres opérations
• Construire une zone de recherche ajustée pour une correspondance répétée plus rapide

Signature

getRegion(): Region

Renvoie

Region - Un objet Region représentant les limites rectangulaires de la zone correspondante.

Exemple

local result = Screen:find("container.png")
if result then
    local region = result:getRegion()
    toast("Region: X=" .. region:getX() .. ", Y=" .. region:getY())
    toast("Size: " .. region:getWidth() .. "x" .. region:getHeight())
    -- Search within the matched region for faster matching
    local innerResult = region:find("container.png")
    if innerResult then
        toast("Found container.png inside region!")
    end
end

Technique de région ajustée (fit region)

getRegion() est la méthode clé derrière un modèle d'optimisation important souvent appelé région ajustée (fit region).

Le modèle est :

1. Trouver un objet stable sur Screen
2. Appeler getRegion() sur le MatchResult
3. Réutiliser cette région pour des recherches répétées à l'intérieur du même objet

local panel = Screen:find("reward-panel.jpg")
if panel then
    local fitRegion = panel:getRegion()

    -- Search only inside the fitted panel instead of the full screen
    local claim = fitRegion:find("claim-button.jpg")
    if claim then
        fitRegion:click("claim-button.jpg")
    end
end

Cette technique fonctionne mieux lorsque l'objet correspondant a toujours à peu près la même taille. Elle peut réduire considérablement le coût de traitement car vous évitez de répéter des recherches sur tout l'écran à chaque étape à l'intérieur du même conteneur.