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
}\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
return;\r
}\r
/**\r
- * 既にあるbufferedImageをラップしてラスタをつくります。BufferedImageの内容により、ラスタタイプは自動的に決定します。\r
+ * この関数は、既にあるBufferedImageをラップしてラスタをつくります。BufferedImageの内容により、ラスタタイプは自動的に決定します。\r
* @param i_bfi\r
* ラップするbufferedImageを設定します。インスタンスが参照するのは、このインスタンスのデフォルトバンクのイメージです。\r
* NyARToolKitと互換性が低いBufferedImageを指定すると、パフォーマンスが劣化することがあります。注意してください。\r
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
}\r
\r
/**\r
- * BufferedImageを分析して、WriterbleRasterと互換性のあるNyARBufferTypeを調べます。\r
+ * この関数は、BufferedImageを分析して、WriterbleRasterと互換性のあるNyARBufferTypeを調べます。\r
* @param im\r
* @return\r
*/\r
\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
/**\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