MatchResult:getRegion()

تُعيد المنطقة المطابقة ككائن Region.

الوصف

تُعيد الدالة getRegion() كائن Region يمثل المساحة المستطيلة حيث تم العثور على المطابقة. تتضمن هذه المنطقة موضع (X، Y) للزاوية العلوية اليسرى وأبعاد (العرض، الارتفاع) للمنطقة المطابقة.

يمكن استخدام كائن Region المُعاد من أجل:

إجراء عمليات بحث إضافية داخل المنطقة المطابقة
التقاط لقطة شاشة للمنطقة المطابقة فقط
تحديد منطقة فرعية لعمليات أخرى
بناء منطقة بحث محصورة لمطابقة متكررة أسرع

التوقيع

getRegion(): Region

القيمة المعادة

Region - كائن Region يمثل الحدود المستطيلة للمنطقة المطابقة.

مثال

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

تقنية ضبط المنطقة (Fit Region)

دالة getRegion() هي الدالة الأساسية وراء نمط تحسين مهم يُعرف غالبًا بـ fit region (ضبط المنطقة).

النمط هو:

ابحث عن كائن ثابت على Screen
استدعِ getRegion() على MatchResult
أعد استخدام تلك المنطقة لعمليات البحث المتكررة داخل نفس الكائن

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

تعمل هذه التقنية بشكل أفضل عندما يكون للكائن المطابق دائمًا نفس الحجم تقريبًا. يمكنها تقليل تكلفة المعالجة بشكل كبير لأنك تتجنب تكرار عمليات البحث في كامل الشاشة لكل خطوة داخل نفس الحاوية.

الوصف​

التوقيع​

مثال​

تقنية ضبط المنطقة (Fit Region)​

الوصف

التوقيع

مثال

تقنية ضبط المنطقة (Fit Region)