class kptmatch -- كائن مطابقة النقاط المفتاحية

كائن kptmatch هو attrtuple يُعيده image.match_descriptor() عند مطابقة واصفَي نقاط مفتاحية ORB. وهو يصف عنقود النقاط المفتاحية المتطابقة بين الواصفَين: مربع إحاطته، ومركز ثقله، وعدد النقاط المفتاحية المتطابقة، ودوران تقديري في مستوى الصورة، وقائمة المطابقات (x, y) لكل نقطة مفتاحية.

يمكن الوصول إلى الحقول باسم السمة (match.count) أو بالفهرس (match[0]). ليس للكائن مُنشئ عام.

class image.kptmatch

يُرجى استدعاء image.match_descriptor() لإنشاء هذا الكائن.

مربع الإحاطة ومركز الثقل

x

إحداثي x للركن العلوي الأيسر لمربع الإحاطة الخاص بالنقاط المفتاحية المتطابقة، بالبكسل. عدد صحيح. الفهرس [0].

y

إحداثي y للركن العلوي الأيسر لمربع الإحاطة الخاص بالنقاط المفتاحية المتطابقة، بالبكسل. عدد صحيح. الفهرس [1].

w

عرض مربع الإحاطة الخاص بالنقاط المفتاحية المتطابقة، بالبكسل. عدد صحيح. الفهرس [2].

h

ارتفاع مربع الإحاطة الخاص بالنقاط المفتاحية المتطابقة، بالبكسل. عدد صحيح. الفهرس [3].

cx

إحداثي x لمركز ثقل النقاط المفتاحية المتطابقة. عدد صحيح. الفهرس [4].

cy

إحداثي y لمركز ثقل النقاط المفتاحية المتطابقة. عدد صحيح. الفهرس [5].

rect

صف رباعي (x, y, w, h) لمربع الإحاطة. مناسب لتمريره مباشرةً إلى طرق الرسم/الاقتصاص مثل Image.draw_rectangle() أو Image.crop(). الفهرس [9].

تفاصيل المطابقة

count

عدد النقاط المفتاحية التي تطابقت بين الواصفَين. استخدم هذا كدرجة ثقة -- العتبات النموذجية لمطابقة "حقيقية" هي 10 نقاط مفتاحية أو أكثر. عدد صحيح. الفهرس [6].

theta

الدوران التقديري في مستوى الصورة بين الواصفَين، بالدرجات. عدد صحيح. الفهرس [7].

match

قائمة من الصفوف الثنائية الصحيحة (x, y) التي تعطي موقع البكسل لكل نقطة مفتاحية متطابقة في صورة البحث. len(match) == count. الفهرس [8].