OSDN Git Service

git-svn-id: http://svn.sourceforge.jp/svnroot/nyartoolkit/NyARToolkit/trunk@811 7cac0... master
authornyatla <nyatla@7cac0a50-4618-4814-88d0-24b83990f816>
Fri, 11 Mar 2011 15:20:26 +0000 (15:20 +0000)
committerAtsuo Igarashi <atsuoigarashi@ubuntu.(none)>
Tue, 5 Apr 2011 09:46:01 +0000 (18:46 +0900)
utils/j2se/src/jp/nyatla/nyartoolkit/utils/j2se/LabelingBufferdImage.java
utils/j2se/src/jp/nyatla/nyartoolkit/utils/j2se/NyARBufferedImageRaster.java
utils/jogl/src.rpf/jp/nyatla/nyartoolkit/rpf/reality/nyartk/gl/NyARRealityGl.java
utils/jogl/src/jp/nyatla/nyartoolkit/jogl/utils/NyARGLDrawUtil.java

index b17ed11..8970741 100644 (file)
@@ -44,9 +44,10 @@ import jp.nyatla.nyartoolkit.core.labeling.artoolkit.NyARLabelingImage;
 import jp.nyatla.nyartoolkit.core.labeling.artoolkit.NyARLabelingLabel;\r
 \r
 /**\r
- * bitmapとして利用可能なラベリングイメージです。\r
- * \r
- * \r
+ * このクラスは、デバック用途のクラスです。\r
+ * NyARToolkit形式の画像を、BufferedImage形式へ変換してコピーします。\r
+ * NyARBufferedImageRasterをか、NyARRasterImageIOを使用してください。\r
+ * @deprecated\r
  */\r
 public class LabelingBufferdImage extends BufferedImage\r
 {\r
index dbef375..2873a86 100644 (file)
@@ -12,14 +12,17 @@ import jp.nyatla.nyartoolkit.core.types.NyARBufferType;
 import jp.nyatla.nyartoolkit.core.types.NyARIntSize;\r
 \r
 /**\r
- * ã\83\90ã\83\83ã\83\95ã\82¡ã\81«BufferedImageã\82\92使ç\94¨ã\81\99ã\82\8bNyARRgbRasterです。\r
- * ラップするbufferedImageの種類によっては、パフォーマンスが低下する事があるので注意してください\r
- * @author nyatla\r
- *\r
+ * ã\81\93ã\81®ã\82¯ã\83©ã\82¹ã\81¯ã\80\81BufferedImageã\82\92ã\83\94ã\82¯ã\82»ã\83«ã\83\90ã\83\83ã\83\95ã\82¡ã\81«æ\8c\81ã\81¤NyARToolKitäº\92æ\8f\9bã\81®ã\83©ã\82¹ã\82¿ã\82¯ã\83©ã\82¹です。\r
+ * BufferedImageインスタンスをラップしています\r
+ * 通常のJavaプログラムと相互運用する場合に便利です。\r
+ * BufferedImageの形式はコンストラクタで指定できます。\r
  */\r
 public class NyARBufferedImageRaster extends NyARRgbRaster\r
 {\r
        private BufferedImage _buffered_image;\r
+       /**\r
+        * この関数は、NyARRgbRasterに、NyARBufferedImageRasterの機能を追加します。\r
+        */\r
        protected boolean initInstance(NyARIntSize i_size,int i_raster_type,boolean i_is_alloc)\r
        {\r
                if(super.initInstance(i_size, i_raster_type, i_is_alloc)){\r
@@ -39,15 +42,24 @@ public class NyARBufferedImageRaster extends NyARRgbRaster
        }\r
 \r
        /**\r
-        * NyARBufferTypeと互換性のある形式のBufferedImageを作成します。\r
+        * コンストラクタです。\r
+        * BufferedImage形式のバッファを持つラスタオブジェクトを作成します。\r
+        * BufferedImageのピクセル形式には特色があります。i_raster_typeの説明を参考にして下さい。\r
         * @param i_width\r
+        * ラスタの幅を指定します。\r
         * @param i_height\r
+        * ラスタの高さを指定します。\r
         * @param i_raster_type\r
-        * バッファタイプを指定します。使用できるラスタタイプは、次の種類です。\r
-        * NyARBufferType.BYTE1D_R8G8B8_24,NyARBufferType.BYTE1D_B8G8R8_24,NyARBufferType.INT1D_X8R8G8B8_32,NyARBufferType.OBJECT_Java_BufferedImage\r
-        * NyARBufferType.OBJECT_Java_BufferedImageは低速低速です。パフォーマンスが必要なシステムでは他のバッファタイプを指定してください。\r
+        * BufferedImageのバッファタイプを指定します。使用できるラスタタイプは次の種類です。\r
+        * <ul>\r
+        * <li>NyARBufferType.BYTE1D_R8G8B8_24(推奨)</li>\r
+        * <li>NyARBufferType.BYTE1D_B8G8R8_24(推奨)</li>\r
+        * <li>NyARBufferType.INT1D_X8R8G8B8_32</li>\r
+        * <li>NyARBufferType.OBJECT_Java_BufferedImage</li>\r
+        * </ul>\r
+        * NyARBufferType.OBJECT_Java_BufferedImageは低速です。パフォーマンスが必要なシステムでは他のバッファタイプを指定してください。\r
         * NyARToolKitの入力・出力に使用する場合は、関数に最適なバッファタイプを使用するとパフォーマンスが向上します。詳細は関数のドキュメントを参照してください。\r
-        * (NyARBufferType.OBJECT_Java_BufferedImageは全ての関数で低速であり、他の直値タイプは概ね高速に動作します。)\r
+        * (NyARBufferType.OBJECT_Java_BufferedImageは全ての関数で低速であり、他のタイプは概ね高速に動作します。)\r
         * @throws NyARException\r
         */\r
        public NyARBufferedImageRaster(int i_width,int i_height,int i_raster_type) throws NyARException\r
@@ -120,7 +132,7 @@ public class NyARBufferedImageRaster extends NyARRgbRaster
                return;\r
        }\r
        /**\r
-        * 既にあるbufferedImageをラップしてラスタをつくります。BufferedImageの内容により、ラスタタイプは自動的に決定します。\r
+        * この関数は、既にあるBufferedImageをラップしてラスタをつくります。BufferedImageの内容により、ラスタタイプは自動的に決定します。\r
         * @param i_bfi\r
         * ラップするbufferedImageを設定します。インスタンスが参照するのは、このインスタンスのデフォルトバンクのイメージです。\r
         * NyARToolKitと互換性が低いBufferedImageを指定すると、パフォーマンスが劣化することがあります。注意してください。\r
@@ -155,16 +167,18 @@ public class NyARBufferedImageRaster extends NyARRgbRaster
                return;\r
        }\r
        /**\r
-        * BufferedImageを返します。\r
+        * この関数は、ラップしているBufferedImageを返します。\r
         * @return\r
+        * ラップしているBufferedImageの実体\r
         */\r
        public final BufferedImage getBufferedImage()\r
        {\r
                return this._buffered_image;\r
        }\r
        /**\r
-        * BufferedImageのGraphicsを返します。\r
+        * この関数は、BufferedImageのGraphicsを返します。\r
         * @return\r
+        * ラップしているBufferedImageのGraphicsオブジェクト\r
         */\r
        public final Graphics getGraphics()\r
        {\r
@@ -172,7 +186,7 @@ public class NyARBufferedImageRaster extends NyARRgbRaster
        }\r
 \r
        /**\r
-        * BufferedImageを分析して、WriterbleRasterと互換性のあるNyARBufferTypeを調べます。\r
+        * この関数は、BufferedImageを分析して、WriterbleRasterと互換性のあるNyARBufferTypeを調べます。\r
         * @param im\r
         * @return\r
         */\r
@@ -229,9 +243,8 @@ public class NyARBufferedImageRaster extends NyARRgbRaster
 \r
 \r
 /**\r
- * BufferedImage用の低速PixelReader\r
- * @author nyatla\r
- *\r
+ * このクラスは、BufferedImage用の低速なPixelReaderです。\r
+ * BufferedImageの形式に依存しない代わりに、ピクセルへのアクセス速度が極端に低速です。\r
  */\r
 final class NyARRgbPixelReader_OBJECT_Java_BufferedImage implements INyARRgbPixelReader\r
 {\r
index 9a1881f..ace4f15 100644 (file)
@@ -55,21 +55,19 @@ public class NyARRealityGl extends NyARReality
        /**\r
         * この関数は、透視投影行列と視錐体パラメータを元に、インスタンスを作成します。\r
         * 初期状態のインスタンスを生成します。\r
-        * この関数は、i_prjmatにnullを指定することで、樽型歪み矯正を行わないインスタンスを生成できます。\r
+        * この関数は、樽型歪み矯正を行わないインスタンスを生成できます。\r
         * @param i_prjmat\r
         * ARToolKit形式の射影変換パラメータを指定します。\r
-        * @param i_screen\r
+        * @param i_screen_size\r
         * スクリーン(入力画像)のサイズを指定します。\r
         * @param i_near\r
-        * {@link #NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
+        * {@link NyARReality#NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
         * @param i_far\r
-        * {@link #NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
-        * @param i_dist_factor\r
-        * 樽型歪み矯正オブジェクトを指定します。歪み矯正が不要な時は、nullを指定します。\r
+        * {@link NyARReality#NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
         * @param i_max_known_target\r
-        * {@link #NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
+        * {@link NyARReality#NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
         * @param i_max_unknown_target\r
-        * {@link #NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
+        * {@link NyARReality#NyARReality(NyARParam i_param,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target)}を参照\r
         * @throws NyARException\r
         */\r
        public NyARRealityGl(NyARPerspectiveProjectionMatrix i_prjmat,NyARIntSize i_screen_size,double i_near,double i_far,int i_max_known_target,int i_max_unknown_target) throws NyARException\r
index 9cf55d5..7e2a2b5 100644 (file)
@@ -203,7 +203,7 @@ public class NyARGLDrawUtil
         * この関数は、スクリーン座標系をOpenGLにロードします。\r
         * スクリーンに二次元系の情報をそのまま書きこむときに使います。\r
         * この関数は、PROJECTIONとMODELVIEWスタックをそれぞれ1づつpushします。\r
-        * スクリーン座標系を使用し終わったら、{@link endScreenCoordinateSystem}を必ず呼び出してください。\r
+        * スクリーン座標系を使用し終わったら、{@link #endScreenCoordinateSystem}を必ず呼び出してください。\r
         * @param i_gl\r
         * OpenGLのインスタンス\r
         * @param i_width\r