jp.nyatla.nyartoolkit.core.param

クラス NyARParam

java.lang.Object

jp.nyatla.nyartoolkit.core.param.NyARParam

public class NyARParam
extends java.lang.Object

このクラスは、NyARToolkitの環境パラメータを格納します。 環境パラメータは、ARToolKitのパラメータと同一です。 パラメータの要素には、以下のものがあります。

• 樽型歪みパラメータ - 入力画像の樽型歪みパラメータです。
• スクリーンサイズ - 入力画像の解像度です。
• 透視変換パラメータ - 4x4行列です。

コンストラクタの概要

コンストラクタ

コンストラクタと説明
NyARParam(NyARIntSize i_screen_size, NyARPerspectiveProjectionMatrix i_projection_mat, INyARCameraDistortionFactor i_dist_factor)

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
void	changeScreenSize(int i_xsize, int i_ysize) この関数は、現在のスクリーンサイズを変更します。
void	changeScreenSize(NyARIntSize i_s) この関数は、現在のスクリーンサイズを変更します。
static NyARParam	createDefaultParameter() テストパラメータを格納したインスタンスを生成します。
static NyARParam	createFromARParamFile(java.io.InputStream i_stream) i_streamからARToolkitのカメラパラメータを読み出して、格納したインスタンスを生成します。
static NyARParam	createFromCvCalibrateCamera2Result(int i_w, int i_h, double[] i_intrinsic_matrix, double[] i_distortion_coeffs) intrinsic matrixとdistortion coeffsパラメータでインスタンスを初期化します。
INyARCameraDistortionFactor	getDistortionFactor() この関数は、ARToolKit形式の歪み補正パラメータを返します。
NyARPerspectiveProjectionMatrix	getPerspectiveProjectionMatrix() この関数は、ARToolKit形式の透視変換行列を返します。
NyARIntSize	getScreenSize()
void	makeCameraFrustumRH(double i_dist_min, double i_dist_max, NyARDoubleMatrix44 o_frustum) この関数は、カメラパラメータから右手系の視錐台を作ります。
void	saveARParam(java.io.OutputStream i_stream) この関数は機能しません。
void	setValue(double[] i_factor, double[] i_projection) この関数は、配列から値を設定します。

クラスから継承されたメソッド java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

NyARParam

public NyARParam(NyARIntSize i_screen_size,
         NyARPerspectiveProjectionMatrix i_projection_mat,
         INyARCameraDistortionFactor i_dist_factor)

メソッドの詳細

createDefaultParameter

public static NyARParam createDefaultParameter()
                                        throws NyARException

テストパラメータを格納したインスタンスを生成します。 テストパラメータは、ARToolKit2形式のcamera_para.datです。

戻り値:

例外:

NyARException

createFromARParamFile

public static NyARParam createFromARParamFile(java.io.InputStream i_stream)
                                       throws NyARException

i_streamからARToolkitのカメラパラメータを読み出して、格納したインスタンスを生成します。

パラメータ:

i_stream -

戻り値:

例外:

NyARException

createFromCvCalibrateCamera2Result

public static NyARParam createFromCvCalibrateCamera2Result(int i_w,
                                           int i_h,
                                           double[] i_intrinsic_matrix,
                                           double[] i_distortion_coeffs)

intrinsic matrixとdistortion coeffsパラメータでインスタンスを初期化します。

パラメータ:

i_size - カメラパラメータのサイズ値

i_intrinsic_matrix - 3x3 matrix このパラメータは、OpenCVのcvCalibrateCamera2関数が出力するintrinsic_matrixの値と合致します。

i_distortion_coeffs - 4x1 matrix このパラメータは、OpenCVのcvCalibrateCamera2関数が出力するdistortion_coeffsの値と合致します。

getScreenSize

public NyARIntSize getScreenSize()

getPerspectiveProjectionMatrix

public NyARPerspectiveProjectionMatrix getPerspectiveProjectionMatrix()

この関数は、ARToolKit形式の透視変換行列を返します。

戻り値:

[read only]透視変換行列を返します。

getDistortionFactor

public INyARCameraDistortionFactor getDistortionFactor()

この関数は、ARToolKit形式の歪み補正パラメータを返します。

戻り値:

[read only]歪み補正パラメータオブジェクト

setValue

public void setValue(double[] i_factor,
            double[] i_projection)

この関数は、配列から値を設定します。

パラメータ:

i_factor - NyARCameraDistortionFactorにセットする配列を指定する。要素数は4であること。

i_projection - NyARPerspectiveProjectionMatrixセットする配列を指定する。要素数は12であること。

changeScreenSize

public void changeScreenSize(int i_xsize,
                    int i_ysize)

この関数は、現在のスクリーンサイズを変更します。 ARToolKitのarParamChangeSize関数に相当します。

パラメータ:

i_xsize - 新しいサイズ

i_ysize - 新しいサイズ

changeScreenSize

public void changeScreenSize(NyARIntSize i_s)

この関数は、現在のスクリーンサイズを変更します。 {@link #changeScreenSize(int, int)のラッパーです。

パラメータ:

i_s -

makeCameraFrustumRH

public void makeCameraFrustumRH(double i_dist_min,
                       double i_dist_max,
                       NyARDoubleMatrix44 o_frustum)

この関数は、カメラパラメータから右手系の視錐台を作ります。

注意 - この処理は低速です。繰り返しの使用はできるだけ避けてください。

パラメータ:

i_dist_min - 視錐台のnear point(mm指定)

i_dist_max - 視錐台のfar point(mm指定)

o_frustum - 視錐台を受け取る配列。

関連項目:

NyARPerspectiveProjectionMatrix.makeCameraFrustumRH(double, double, double, double, jp.nyatla.nyartoolkit.core.types.matrix.NyARDoubleMatrix44)

saveARParam

public void saveARParam(java.io.OutputStream i_stream)
                 throws java.lang.Exception

この関数は機能しません。

パラメータ:

i_stream - 未定義

例外:

java.lang.Exception