jp.nyatla.nyar4psg.utils

クラス NyARPsgBaseClass

java.lang.Object

jp.nyatla.nyar4psg.utils.NyARPsgBaseClass

直系の既知のサブクラス:

MultiMarker, MultiNft

public abstract class NyARPsgBaseClass
extends java.lang.Object

このクラスは、NyARToolkit for Processingのベースクラスです。 環境定数などの共通値を定義します。

フィールドの概要

フィールド

修飾子とタイプ	フィールドと説明
SingleCameraView	cameraview 関連付けられているビューです。
float	FRUSTUM_DEFAULT_FAR_CLIP farクリップ面のデフォルト値です。
float	FRUSTUM_DEFAULT_NEAR_CLIP nearクリップ面のデフォルト値です。
static java.lang.String	VERSION バージョン文字列です。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
void	drawBackground(processing.core.PImage i_img) この関数は、PImageをバックグラウンドへ描画します。
processing.core.PMatrix3D	getProjectionMatrix() [readonly]この関数は、Processing形式のProjectionMatrixの参照値を返します。
void	setARClipping(float i_near, float i_far) この関数は、視錐台のクリップ面を設定します。
void	setARPerspective() この関数は、ARToolKit準拠のProjectionMatrixをProcessingにセットします。
void	setBackgroundOrtho(int i_width, int i_height) この関数は、正射影行列をProcessingへセットします。
void	setPerspective(processing.core.PMatrix3D i_projection) この関数は、ProjectionMatrixをProcessingにセットします。

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

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

フィールドの詳細

FRUSTUM_DEFAULT_NEAR_CLIP

public final float FRUSTUM_DEFAULT_NEAR_CLIP

nearクリップ面のデフォルト値です。

関連項目:

定数フィールド値

FRUSTUM_DEFAULT_FAR_CLIP

public final float FRUSTUM_DEFAULT_FAR_CLIP

farクリップ面のデフォルト値です。

関連項目:

定数フィールド値

VERSION

public static final java.lang.String VERSION

バージョン文字列です。 NyAR4psgのバージョン情報を示します。

関連項目:

定数フィールド値

cameraview

public final SingleCameraView cameraview

関連付けられているビューです。他のインスタンスと共有するときに使います。

メソッドの詳細

drawBackground

public void drawBackground(processing.core.PImage i_img)

この関数は、PImageをバックグラウンドへ描画します。PImageはfarclip面+1の部分に描画します。

この関数は、次のコードと等価です。

:
PMatrix3D om=new PMatrix3D(((PGrapPGraphicsOpenGLhics3D)g).projection);
setBackgroundOrtho(img.width,img.height)
pushMatrix();
resetMatrix();
translate(0,0,-(far*0.99f));
image(img,-width/2,-height/2);
popMatrix();
setPerspective(om);
:
この関数は、PrjectionMatrixとModelViewMatrixを復帰するため、若干のオーバヘッドがあります。 高速な処理が必要な場合には、展開してください。

パラメータ:

i_img - 背景画像を指定します。

setBackgroundOrtho

public void setBackgroundOrtho(int i_width,
                      int i_height)

この関数は、正射影行列をProcessingへセットします。 画面の中心が0,0にセットされます。 nearクリップには、setARClipping(float, float)でセットしたクリップ面を指定します。 　farクリップには、setARClipping(float, float)でセットしたクリップ面+1を指定します。

この関数は、次のコードと等価です。

:
//for 1.x
ortho(-i_width/2, i_width/2,-i_height/2,i_height/2,near,far+1);
//for 2.x
ortho(0,i_width,0,i_height,near,far+1);
:

パラメータ:

i_width - 幅を指定します。

i_height - 高さを指定します。

setARPerspective

public void setARPerspective()

この関数は、ARToolKit準拠のProjectionMatrixをProcessingにセットします。 関数を実行すると、ProcessingのProjectionMatrixがARToolKitのカメラパラメータのものに変わり、映像にマッチした描画ができるようになります。 ProcessingのデフォルトFrustumに戻すときは、PGraphicsOpenGL.perspective()を使います。 Frustumの有効期間は、次にPGraphicsOpenGL.perspective()かPGraphicsOpenGL.perspective()をコールするまでです。

Version 1.1.0より、古いprojection matrixを返さなくなりました。古いprojection matrixが必要な時は、PGraphicsOpenGL.projectionを複製して保存して下さい。

setPerspective

public final void setPerspective(processing.core.PMatrix3D i_projection)

この関数は、ProjectionMatrixをProcessingにセットします。

パラメータ:

i_projection - 設定するProjectionMatrixを指定します。

Processing/1.3になったら、PApplet#matrixMode使ってきちんと使えるようになると思う。 今は無理なので、frustum経由

Version 1.1.0より、古いprojection matrixを返さなくなりました。古いprojection matrixが必要な時は、PGraphicsOpenGL.projectionを複製して保存して下さい。

getProjectionMatrix

public final processing.core.PMatrix3D getProjectionMatrix()

[readonly]この関数は、Processing形式のProjectionMatrixの参照値を返します。

戻り値:

setARClipping

public final void setARClipping(float i_near,
                 float i_far)

この関数は、視錐台のクリップ面を設定します。この値のデフォルト値は、FRUSTUM_DEFAULT_NEAR_CLIPとFRUSTUM_DEFAULT_FAR_CLIPです。 設定値は、次回のsetARPerspective()から影響を及ぼします。現在の設定値にただちに影響を及ぼすものではありません。

パラメータ:

i_near - NearPlaneの値を設定します。単位は[mm]です。

i_far - FarPlaneの値を設定します。単位は[mm]です。