From ff9ebf7efe05f8cd3167983fabd4fefc28f7d62b Mon Sep 17 00:00:00 2001
From: nyatla <nyatla@7cac0a50-4618-4814-88d0-24b83990f816>
Date: Thu, 27 Jan 2011 01:46:06 +0000
Subject: [PATCH] git-svn-id:
 http://svn.sourceforge.jp/svnroot/nyartoolkit/NyARToolkit/trunk@807
 7cac0a50-4618-4814-88d0-24b83990f816

---
 .../rpf/tracker/nyartk/NyARTargetList.java         |  8 +++++++-
 .../rpf/tracker/nyartk/NyARTargetPool.java         | 24 +++++++++++++++-------
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetList.java b/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetList.java
index 69db98f..108fa80 100644
--- a/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetList.java
+++ b/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetList.java
@@ -4,6 +4,10 @@ import jp.nyatla.nyartoolkit.NyARException;
 import jp.nyatla.nyartoolkit.core.types.stack.*;
 import jp.nyatla.nyartoolkit.rpf.sampler.lrlabel.*;
 
+/**
+ * このクラスは、{@link NyARTarget}参照値をリストするクラスです。
+ * リストの基本関数と、検索関数を提供します。
+ */
 public class NyARTargetList extends NyARPointerStack<NyARTarget>
 {
 	public NyARTargetList(int i_max_target) throws NyARException
@@ -11,8 +15,10 @@ public class NyARTargetList extends NyARPointerStack<NyARTarget>
 		super.initInstance(i_max_target,NyARTarget.class);
 	}
 	/**
-	 * Sampleの位置キーに一致する可能性の高い要素のインデクスを１つ返します。
+	 * この関数は、Sampleの位置キーに一致する可能性の高い要素のインデクスを１つ返します。
+	 * 検索基準は、矩形同士の重なりです。
 	 * @param i_item
+	 * キーにするオブジェクト。
 	 * @return
 	 * 一致する可能性が高い要素のインデクス番号。見つからないときは-1
 	 */
diff --git a/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetPool.java b/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetPool.java
index 7d040c0..f73069e 100644
--- a/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetPool.java
+++ b/lib/src.rpf/jp/nyatla/nyartoolkit/rpf/tracker/nyartk/NyARTargetPool.java
@@ -2,26 +2,36 @@ package jp.nyatla.nyartoolkit.rpf.tracker.nyartk;
 
 import jp.nyatla.nyartoolkit.NyARException;
 import jp.nyatla.nyartoolkit.core.utils.NyARManagedObjectPool;
-import jp.nyatla.nyartoolkit.rpf.sampler.lrlabel.LowResolutionLabelingSamplerOut;
-import jp.nyatla.nyartoolkit.rpf.tracker.nyartk.status.NyARNewTargetStatus;
-import jp.nyatla.nyartoolkit.rpf.tracker.nyartk.status.NyARNewTargetStatusPool;
-import jp.nyatla.nyartoolkit.rpf.tracker.nyartk.status.NyARTargetStatus;
 
+/**
+ * このクラスは、{@link NyARTarget}型のプールクラスです。
+ * 通常、ユーザが使うことはありません。
+ */
 final public class NyARTargetPool extends NyARManagedObjectPool<NyARTarget>
 {
+	/**
+	 * コンストラクタです。
+	 * プールの最大サイズを利用して、インスタンスを生成します。
+	 * @param i_size
+	 * プールの最大サイズです。
+	 * @throws NyARException
+	 */
 	public NyARTargetPool(int i_size) throws NyARException
 	{
 		this.initInstance(i_size,NyARTarget.class);
 	}
+	/**
+	 * この関数は、リスト要素を生成して返します。
+	 */
 	protected NyARTarget createElement() throws NyARException
 	{
 		return new NyARTarget(this._op_interface);
 	}
 	/**
-	 * 新しいターゲットを生成します。ターゲットのserial,tagのみ初期化します。
-	 * @param i_clock
-	 * @param i_sample
+	 * この関数は、新しいオブジェクトを１個割り当てて返します。
+	 * 基礎クラスとの違いは、割り当てたオブジェクトの初期化をおこなう点です。
 	 * @return
+	 * 初期化済のオブジェクト
 	 * @throws NyARException
 	 */
 	public NyARTarget newNewTarget() throws NyARException
-- 
2.11.0