git-svn-id: http://svn.sourceforge.jp/svnroot/nyartoolkit/NyARToolkit/trunk@786 7cac0...

[nyartoolkit-and/nyartoolkit-and.git] / lib / src.rpf / jp / nyatla / nyartoolkit / rpf / utils / LineBaseVertexDetector.java

diff --git a/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/utils/LineBaseVertexDetector.java b/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/utils/LineBaseVertexDetector.java
index 0decca2..a7134e4 100644 (file)
--- a/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/utils/LineBaseVertexDetector.java
+++ b/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/utils/LineBaseVertexDetector.java
@@ -4,32 +4,27 @@ import jp.nyatla.nyartoolkit.NyARException;
 import jp.nyatla.nyartoolkit.core.types.*;\r
 \r
 /**\r
- * このクラスは、直線式の集合から頂点集合を計算する関数を提供します。\r
+ * このクラスは、4本の直線式から、凸包の頂点を計算する機能を提供します。\r
  */\r
 public class LineBaseVertexDetector\r
 {\r
-       /**\r
-        * 頂点パターンテーブル\r
-        * 頂点用の、存在しないIDに対応した、調査テーブル。4頂点の時も使う。\r
-        */\r
+       /** 頂点の組合せテーブル(4,5頂点用)*/\r
        private final static int[][] _45vertextable={\r
                        {1,2,4,3},{0,2,5,3},{0,1,5,4},{0,1,5,4},{0,2,5,3},{1,2,4,3}};\r
-       /**\r
-        * 頂点パターンテーブル(6用)\r
-        */\r
+       /** 頂点組合せテーブル。(6頂点用)*/\r
        private final static int[][] _order_table={{0,1,5,4},{0,2,5,3},{1,2,4,3}};\r
+       /** ワーク変数*/\r
        private NyARDoublePoint2d[] __wk_v=NyARDoublePoint2d.createArray(6);\r
        /**\r
-        * 適当に与えられた4線分から、四角形の頂点を計算する。\r
+        * ４直線の交点から、凸包の頂点座標を計算します。\r
         * @param i_line\r
-        * 4線分を格納した配列\r
+        * 直線式の配列です。要素数は4である必要があります。\r
         * @param o_point\r
-        * 検出した4頂点\r
+        * 検出した頂点の座標です。要素数は4である必要があります。\r
         * @return\r
-        * å\9b\9bè§\92å½¢ã\82\92æ¤\9cå\87ºã\81\97ã\81\9fã\82\89true\r
+        * å\87¸å\8c\85ã\82\92è¨\88ç®\97ã\81§ã\81\8dã\82\8bã\81¨ã\80\81trueã\82\92è¿\94ã\81\97ã\81¾ã\81\99ã\80\82\r
         * @throws NyARException\r
         */\r
-\r
        public boolean line2SquareVertex(VecLinearCoordinates.VecLinearCoordinatePoint[] i_line,NyARDoublePoint2d[] o_point) throws NyARException\r
        {\r
                \r
@@ -98,10 +93,13 @@ public class LineBaseVertexDetector
        }\r
 \r
        /**\r
-        * 4頂点を巡回して、正の外積の個数を数える。\r
+        * 4頂点を巡回して、正の外積数を数えます。\r
         * @param p\r
+        * 頂点配列。4要素である事。\r
         * @param order\r
+        * 頂点のインデクス配列。4要素である事。\r
         * @return\r
+        * 正の外積数\r
         */\r
        private final static int countPlusExteriorProduct(NyARDoublePoint2d[] p,int[] order)\r
        {\r