class kptmatch -- 關鍵點比對物件

kptmatch 物件是在比對兩個 ORB 關鍵點描述子時，由 image.match_descriptor() 回傳的 attrtuple。它描述兩個描述子之間相互比對成功的關鍵點叢集：其邊界框、形心、比對成功的關鍵點數量、估計的影像平面內旋轉量，以及每個比對關鍵點的 (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) 4 元組。適合直接傳入繪製/裁切方法，例如 Image.draw_rectangle() 或 Image.crop()。索引 [9]。

比對細節

count

兩個描述子之間比對成功的關鍵點數量。可將此值作為信賴分數使用，「真正」比對成功的典型閾值為 10 個以上的關鍵點。整數。索引 [6]。

theta

兩個描述子之間估計的影像平面內旋轉量，以度為單位。整數。索引 [7]。

match

由 (x, y) 整數元組組成的清單，給出每個比對關鍵點在搜尋影像中的像素位置。len(match) == count。索引 [8]。