Polygon

Polygon(array: _Polygon, normalized: bool = False)

• 説明：

  Polygon は、多角形を表すクラスです。このクラスは、多角形の座標を操作するための多くのメソッドを提供します。例えば、座標の正規化、非正規化、多角形のクリッピング、移動、スケーリング、凸多角形への変換、最小外接矩形への変換、境界ボックスへの変換などです。

• パラメータ

  • array (_Polygon)：多角形の座標。
  • normalized (bool)：多角形の座標が正規化されているかどうかを示すフラグ。デフォルトは False。

• 属性

  • normalized：多角形の正規化状態を取得。
  • moments：多角形のモーメントを取得。
  • area：多角形の面積を取得。
  • arclength：多角形の周囲長を取得。
  • centroid：多角形の質量中心を取得。
  • boundingbox：多角形の境界ボックスを取得。
  • min_circle：多角形の最小外接円を取得。
  • min_box：多角形の最小外接矩形を取得。
  • orientation：多角形の向きを取得。
  • min_box_wh：多角形の最小外接矩形の幅と高さを取得。
  • extent：多角形の占有率を取得。
  • solidity：多角形の充実度（solidity）を取得。

• メソッド

  • copy()：多角形オブジェクトをコピー。
  • numpy()：多角形オブジェクトを numpy 配列に変換。
  • normalize(w: float, h: float)：多角形の座標を正規化。
  • denormalize(w: float, h: float)：多角形の座標を非正規化。
  • clip(xmin: int, ymin: int, xmax: int, ymax: int)：多角形をクリッピング。
  • shift(shift_x: float, shift_y: float)：多角形を移動。
  • scale(distance: int, join_style: JOIN_STYLE = JOIN_STYLE.mitre)：多角形をスケーリング。
  • to_convexhull()：多角形を凸多角形に変換。
  • to_min_boxpoints()：多角形を最小外接矩形の座標に変換。
  • to_box(box_mode: str = 'xyxy')：多角形を境界ボックスに変換。
  • to_list(flatten: bool = False)：多角形をリストに変換。
  • is_empty(threshold: int = 3)：多角形が空かどうかを判定。

• 例

  import capybara as cb
  
  polygon = cb.Polygon([[10., 20.], [50, 20.], [50, 80.], [10., 80.]])
  print(polygon)
  # >>> Polygon([[10. 20.], [50. 20.], [50. 80.], [10. 80.]])
  
  polygon1 = polygon.normalize(100, 100)
  print(polygon1)
  # >>> Polygon([[0.1 0.2], [0.5 0.2], [0.5 0.8], [0.1 0.8]])
  
  polygon2 = polygon.denormalize(100, 100)
  print(polygon2)
  # >>> Polygon([[1000. 2000.], [5000. 2000.], [5000. 8000.], [1000. 8000.]])
  
  polygon3 = polygon.clip(20, 20, 60, 60)
  print(polygon3)
  # >>> Polygon([[20. 20.], [50. 20.], [50. 60.], [20. 60.]])
  
  polygon4 = polygon.shift(10, 10)
  print(polygon4)
  # >>> Polygon([[20. 30.], [60. 30.], [60. 90.], [20. 90.]])
  
  polygon5 = polygon.scale(10)
  print(polygon5)
  # >>> Polygon([[0. 10.], [60. 10.], [60. 90.], [0. 90.]])
  
  polygon6 = polygon.to_convexhull()
  print(polygon6)
  # >>> Polygon([[50. 80.], [10. 80.], [10. 20.], [50. 20.]])
  
  polygon7 = polygon.to_min_boxpoints()
  print(polygon7)
  # >>> Polygon([[10. 20.], [50. 20.], [50. 80.], [10. 80.]])
  
  polygon8 = polygon.to_box('xywh')
  print(polygon8)
  # >>> Box([10. 20. 40. 60.]), BoxMode.XYWH
  
  polygon9 = polygon.to_list()
  print(polygon9)
  # >>> [[10.0, 20.0], [50.0, 20.0], [50.0, 80.0], [10.0, 80.0]]
  
  polygon10 = polygon.is_empty()
  print(polygon10)
  # >>> False