モデルの位置や姿勢を管理するクラス [詳解]

#include <FK/MatAdmin.h>

FK::fk_MatrixAdmin の継承関係図

FK::fk_MatrixAdmin 連携図

公開メンバ関数
	fk_MatrixAdmin (fk_Type=fk_Type::MATRIXADMIN)
	コンストラクタ

virtual	~fk_MatrixAdmin ()
	デストラクタ

状態参照関数
fk_Vector	getPosition (void) const
	位置ベクトル取得関数

fk_Vector	getVec (void) const
	方向ベクトル取得関数

fk_Vector	getUpvec (void) const
	アップベクトル取得関数

fk_Angle	getAngle (void) const
	オイラー角取得関数

fk_Matrix	getMatrix (void) const
	変換行列取得関数

fk_Matrix	getInvMatrix (void) const
	逆変換行列取得関数

fk_OrthoMatrix	getBaseMatrix (void) const
	移動・回転要素変換行列取得関数

fk_OrthoMatrix	getInvBaseMatrix (void) const
	移動・回転要素逆変換行列取得関数

拡大縮小関連関数
bool	setScale (const double scale)
	全体絶対倍率設定関数

bool	setScale (const double scale, fk_Axis axis)
	軸方向絶対倍率設定関数

bool	setScale (const double x, const double y, const double z)
	軸方向個別絶対倍率設定関数

bool	prdScale (const double scale)
	全体相対倍率設定関数

bool	prdScale (const double scale, fk_Axis axis)
	軸方向相対倍率設定関数

bool	prdScale (const double x, const double y, const double z)
	軸方向個別相対倍率設定関数

double	getScale (void) const
	全体倍率取得関数

double	getScale (fk_Axis axis) const
	軸方向倍率取得関数

bool	getScaleMode (void) const
	拡大縮小状態判定関数

回転制御関数
bool	glRotate_ (fk_Vector &origin, fk_Axis axis, double theta)
	グローバル座標系座標軸回転関数1

bool	glRotate_ (double orgX, double orgY, double orgZ, fk_Axis axis, double theta)
	グローバル座標系座標軸回転関数2

bool	glRotate_ (fk_Vector &A, fk_Vector &B, double theta)
	グローバル座標系任意軸回転関数1

bool	glRotate_ (double Ax, double Ay, double Az, double Bx, double By, double Bz, double theta)
	グローバル座標系任意軸回転関数2

bool	loRotate_ (fk_Vector &origin, fk_Axis axis, double theta)
	ローカル座標系座標軸回転関数1

bool	loRotate_ (double orgX, double orgY, double orgZ, fk_Axis axis, double theta)
	ローカル座標系座標軸回転関数2

bool	loRotate_ (fk_Vector &A, fk_Vector &B, double theta)
	ローカル座標系任意軸回転関数1

bool	loRotate_ (double Ax, double Ay, double Az, double Bx, double By, double Bz, double theta)
	ローカル座標系任意軸回転関数2

bool	glRotateWithVec_ (fk_Vector &origin, fk_Axis axis, double theta)
	グローバル座標系座標軸回転(姿勢付き)関数1

bool	glRotateWithVec_ (double orgX, double orgY, double orgZ, fk_Axis axis, double theta)
	グローバル座標系座標軸回転(姿勢付き)関数2

bool	glRotateWithVec_ (fk_Vector &A, fk_Vector &B, double theta)
	グローバル座標系任意軸回転(姿勢付き)関数1

bool	glRotateWithVec_ (double Ax, double Ay, double Az, double Bx, double By, double Bz, double theta)
	グローバル座標系任意軸回転(姿勢付き)関数2

bool	loRotateWithVec_ (fk_Vector &origin, fk_Axis axis, double theta)
	ローカル座標系座標軸回転(姿勢付き)関数1

bool	loRotateWithVec_ (double orgX, double orgY, double orgZ, fk_Axis axis, double theta)
	ローカル座標系座標軸回転(姿勢付き)関数2

bool	loRotateWithVec_ (fk_Vector &A, fk_Vector &B, double theta)
	ローカル座標系任意軸回転(姿勢付き)関数1

bool	loRotateWithVec_ (double Ax, double Ay, double Az, double Bx, double By, double Bz, double theta)
	ローカル座標系任意軸回転(姿勢付き)関数2

位置制御関数
bool	glTranslate_ (fk_Vector &v)
	グローバル座標系平行移動関数1

bool	glTranslate_ (double x, double y, double z)
	グローバル座標系平行移動関数2

bool	loTranslate_ (fk_Vector &v)
	ローカル座標系平行移動関数1

bool	loTranslate_ (double x, double y, double z)
	ローカル座標系平行移動関数2

bool	glMoveTo_ (fk_Vector &p)
	グローバル座標系位置指定関数1

bool	glMoveTo_ (double x, double y, double z)
	グローバル座標系位置指定関数2

姿勢制御関数
bool	glFocus (fk_Vector p)
	グローバル座標系注視点設定関数1

bool	glFocus (double x, double y, double z)
	グローバル座標系注視点設定関数2

bool	loFocus (fk_Vector p)
	ローカル座標系注視点設定関数1

bool	loFocus (double x, double y, double z)
	ローカル座標系注視点設定関数2

bool	glVec (fk_Vector v)
	グローバル座標系方向ベクトル設定関数1

bool	glVec (double x, double y, double z)
	グローバル座標系方向ベクトル設定関数2

bool	glUpvec (fk_Vector v)
	グローバル座標系アップベクトル設定関数1

bool	glUpvec (double x, double y, double z)
	グローバル座標系アップベクトル設定関数2

bool	loUpvec (fk_Vector v)
	ローカル座標系アップベクトル設定関数1

bool	loUpvec (double x, double y, double z)
	ローカル座標系アップベクトル設定関数2

bool	glAngle (fk_Angle angle)
	グローバル座標系オイラー角設定関数1

bool	glAngle (double h, double p, double b)
	グローバル座標系オイラー角設定関数2

bool	loAngle (fk_Angle angle)
	ローカル座標系オイラー角設定関数1

bool	loAngle (double h, double p, double b)
	ローカル座標系オイラー角設定関数2

基底クラス FK::fk_BaseObject に属する継承公開メンバ関数
	fk_BaseObject (fk_Type type=fk_Type::BASEOBJECT)
	コンストラクタ

fk_Type	getObjectType (void) const
	タイプ取得関数

詳解

モデルの位置や姿勢を管理するクラス

このクラスは fk_Model クラスの基底クラスで、モデルの位置や姿勢の制御する機能を提供します。これは、回転による指定や平行移動、任意位置指定など様々な方法があります。

このクラスの関数群を理解する上で欠かせない概念が「グローバル座標系」と「ローカル座標系」です。「グローバル座標系」とは、シーン中に原点と x,y,z 各軸によって構成されている唯一の座標系です。これに対し「ローカル座標系」とは、各モデルごとに存在する座標系であり、モデルの中心を原点とし、前方向を -z 方向、上方向を +y 方向、右方向を +x 方向とした座標系のことです。

グローバル座標系による指定では、各モデルの位置や向いている方向などに依存しない動作となります。例えば、-z 方向への平行移動を指示した場合は、モデルがどちらを向いていても一律に -z 方向へ移動していきます。感覚的には、モデルの制御を「東西南北」といった絶対的な方角で指定すると考えればわかりやすいでしょう。

一方、ローカル座標系による指定では各モデルの位置や姿勢が重要となります。同じように -z 方向への移動を指示した場合、各モデルは現在モデルが向いている方向へ「前進」していくことになります。 +x 方向を向いているモデルは +x 方向へ、 -y 方向を向いているモデルは -y 方向へ移動していきます。このように、ローカル座標系の指定は「前後左右」による指定と言えます。

このクラスのメンバ関数は、グローバル座標系による制御関数は「gl」というプレフィックスを持ち、ローカル座標系による制御関数は「lo」というプレフィックスを持ちます。ほとんどの制御関数は「gl」版と「lo」版で同一の引数を持った関数が存在しています。 (例外は glMoveTo() と glVec() です。これについてはそれぞれの関数の項で説明します。)

あるモデルのローカル座標系に対し、別のモデルを配置する「親子関係」については、 fk_Model を参照して下さい。

参照: fk_Model

構築子と解体子

◆ fk_MatrixAdmin()

FK::fk_MatrixAdmin::fk_MatrixAdmin ( fk_Type = fk_Type::MATRIXADMIN )

コンストラクタ

◆ ~fk_MatrixAdmin()

virtual FK::fk_MatrixAdmin::~fk_MatrixAdmin ( )

virtual

デストラクタ

関数詳解

◆ getPosition()

fk_Vector FK::fk_MatrixAdmin::getPosition ( void ) const

位置ベクトル取得関数

モデルの位置ベクトルを取得します。親モデルが設定されている場合、親モデルの座標系からの相対的な位置ベクトルとなります。グローバル座標系での正確な位置ベクトルを取得したい場合は、 fk_Model::getInhPosition() を利用して下さい。

戻り値: 親モデル座標系での位置ベクトル

参照: getVec(), getUpvec(), getAngle(), fk_Model::getInhPosition()

◆ getVec()

fk_Vector FK::fk_MatrixAdmin::getVec ( void ) const

方向ベクトル取得関数

モデルの方向ベクトルを取得します。親モデルが設定されている場合、親モデルの座標系からの相対的な方向ベクトルとなります。グローバル座標系での正確な方向ベクトルを取得したい場合は、 fk_Model::getInhVec() を利用して下さい。

戻り値: 親モデル座標系での方向ベクトル

参照: getPosition(), getUpvec(), getAngle(), fk_Model::getInhVec()

◆ getUpvec()

fk_Vector FK::fk_MatrixAdmin::getUpvec ( void ) const

アップベクトル取得関数

モデルのアップベクトルを取得します。親モデルが設定されている場合、親モデルの座標系からの相対的なアップベクトルとなります。グローバル座標系での正確なアップベクトルを取得したい場合は、 fk_Model::getInhUpvec() を利用して下さい。

戻り値: 親モデル座標系でのアップベクトル

参照: getPosition(), getVec(), getAngle(), fk_Model::getInhUpvec()

◆ getAngle()

fk_Angle FK::fk_MatrixAdmin::getAngle ( void ) const

オイラー角取得関数

モデルの姿勢をオイラー角で取得します。親モデルが設定されている場合、親モデルの座標系からの相対的なオイラー角となります。グローバル座標系での正確なオイラー角を取得したい場合は、 fk_Model::getInhAngle() を利用して下さい。オイラー角についての詳細は、 fk_Angle の説明を参照して下さい。

戻り値: モデルの姿勢オイラー角

参照: getPosition(), getVec(), getUpvec(), fk_Model::getInhAngle(), fk_Angle

◆ getMatrix()

fk_Matrix FK::fk_MatrixAdmin::getMatrix ( void ) const

変換行列取得関数

モデルの位置と姿勢を表す変換行列を取得します。ここで取得する変換行列は、親モデルが存在する場合は親モデルに対する変換となります。グローバル座標系での変換行列を取得したい場合は、 fk_Model::getInhMatrix() を利用して下さい。

戻り値: モデルの変換行列

参照: getInvMatrix(), fk_Model::getInhMatrix(), getBaseMatrix()

◆ getInvMatrix()

fk_Matrix FK::fk_MatrixAdmin::getInvMatrix ( void ) const

逆変換行列取得関数

モデルの位置と姿勢を表す変換行列の、逆行列を取得します。これは、 getMatrix() 関数で得られる行列の逆行列となります。ここで取得する逆変換行列は、親モデルが存在する場合は親モデルに対する逆変換となります。グローバル座標系での逆変換行列を取得したい場合は、 fk_Model::getInhInvMatrix() を利用して下さい。

戻り値: モデルの逆変換行列

参照: getMatrix(), fk_Model::getInhInvMatrix()

◆ getBaseMatrix()

fk_OrthoMatrix FK::fk_MatrixAdmin::getBaseMatrix ( void ) const

移動・回転要素変換行列取得関数

モデルの持つ変換要素のうち、位置と姿勢のみを反映した、すなわち拡大縮小の要素を省いた変換行列を取得します。親モデルが存在する場合は親モデルに対する変換となります。グローバル座標系での変換行列を取得したい場合は、 fk_Model::getInhBaseMatrix() を利用して下さい。

戻り値: モデルの移動・回転要素変換行列

参照: getMatrix(), fk_Model::getInhBaseMatrix(), fk_OrthoMatrix

◆ getInvBaseMatrix()

fk_OrthoMatrix FK::fk_MatrixAdmin::getInvBaseMatrix ( void ) const

移動・回転要素逆変換行列取得関数

モデルの持つ変換要素のうち、位置と姿勢のみを反映した、すなわち拡大縮小の要素を省いた変換行列の逆行列を取得します。親モデルが存在する場合は親モデルに対する逆変換となります。グローバル座標系での逆変換行列を取得したい場合は、 fk_Model::getInhInvBaseMatrix() を利用して下さい。

戻り値: モデルの移動・回転要素逆変換行列

参照: getInvMatrix(), fk_Model::getInhInvBaseMatrix(), fk_OrthoMatrix

◆ setScale() [1/3]

bool FK::fk_MatrixAdmin::setScale ( const double scale )

全体絶対倍率設定関数

モデル全体の拡大・縮小倍率を設定します。倍率に 0 を入力した場合、エラーとして倍率の変更を行いません。

覚え書き: 全体の倍率と、軸方向の倍率はそれぞれ別個に管理されています。結果的なモデルの各軸方向への倍率は、全体倍率と軸方向倍率の積となります。

引数

[in] scale 倍率

戻り値: 設定に成功すれば true を、失敗すれば false を返します。

◆ setScale() [2/3]

bool FK::fk_MatrixAdmin::setScale	(	const double	scale,
		fk_Axis	axis
	)

軸方向絶対倍率設定関数

モデルの、特定軸方向の拡大・縮小倍率を設定します。倍率に 0 を入力した場合、エラーとして倍率の変更を行いません。

覚え書き: 全体の倍率と、軸方向の倍率はそれぞれ別個に管理されています。結果的なモデルの各軸方向への倍率は、全体倍率と軸方向倍率の積となります。

引数

[in]	scale	倍率
[in]	axis	軸方向。fk_X, fk_Y, fk_Z のいずれかになります。

戻り値: 設定に成功すれば true を、失敗すれば false を返します。

◆ setScale() [3/3]

bool FK::fk_MatrixAdmin::setScale	(	const double	x,
		const double	y,
		const double	z
	)

軸方向個別絶対倍率設定関数

モデルの、各軸方向の拡大・縮小倍率を設定します。各倍率のいずれかで 0 を入力した場合、エラーとして倍率の変更を行いません。

覚え書き: 全体の倍率と、軸方向の倍率はそれぞれ別個に管理されています。結果的なモデルの各軸方向への倍率は、全体倍率と軸方向倍率の積となります。

引数

[in]	x	x方向の倍率
[in]	y	y方向の倍率
[in]	z	z方向の倍率

戻り値: 設定に成功すれば true を、失敗すれば false を返します。

◆ prdScale() [1/3]

bool FK::fk_MatrixAdmin::prdScale ( const double scale )

全体相対倍率設定関数

モデルの現在の全体拡大・縮小倍率に対し、引数で与えられた倍率を掛けます。倍率に 0 を入力した場合、エラーとして倍率の変更を行いません。

覚え書き: 全体の倍率と、軸方向の倍率はそれぞれ別個に管理されています。結果的なモデルの各軸方向への倍率は、全体倍率と軸方向倍率の積となります。

引数

[in] scale 掛ける倍率

戻り値: 設定に成功すれば true を、失敗すれば false を返します。

◆ prdScale() [2/3]

bool FK::fk_MatrixAdmin::prdScale	(	const double	scale,
		fk_Axis	axis
	)

軸方向相対倍率設定関数

モデルの、特定軸方向の拡大・縮小倍率に対し、引数で与えられた倍率を掛けます。倍率に 0 を入力した場合、エラーとして倍率の変更を行いません。

覚え書き: 全体の倍率と、軸方向の倍率はそれぞれ別個に管理されています。結果的なモデルの各軸方向への倍率は、全体倍率と軸方向倍率の積となります。

引数

[in]	scale	掛ける倍率
[in]	axis	軸方向。fk_X, fk_Y, fk_Z のいずれかになります。

戻り値: 設定に成功すれば true を、失敗すれば false を返します。

◆ prdScale() [3/3]

bool FK::fk_MatrixAdmin::prdScale	(	const double	x,
		const double	y,
		const double	z
	)

軸方向個別相対倍率設定関数

モデルの、各軸方向の拡大・縮小倍率に対し、引数で与えられた倍率を掛けます。各倍率のいずれかで 0 を入力した場合、エラーとして倍率の変更を行いません。

覚え書き: 全体の倍率と、軸方向の倍率はそれぞれ別個に管理されています。結果的なモデルの各軸方向への倍率は、全体倍率と軸方向倍率の積となります。

引数

[in]	x	x方向へ掛ける倍率
[in]	y	y方向へ掛ける倍率
[in]	z	z方向へ掛ける倍率

戻り値: 設定に成功すれば true を、失敗すれば false を返します。

◆ getScale() [1/2]

double FK::fk_MatrixAdmin::getScale ( void ) const

全体倍率取得関数

モデルの全体拡大・縮小倍率を取得します。

戻り値: モデル全体倍率

◆ getScale() [2/2]

double FK::fk_MatrixAdmin::getScale ( fk_Axis axis ) const

軸方向倍率取得関数

モデルの特定軸方向拡大・縮小倍率を取得します。

引数

[in] axis 軸方向。fk_X, fk_Y, fk_Z のいずれかになります。

戻り値: モデル軸方向倍率

◆ getScaleMode()

bool FK::fk_MatrixAdmin::getScaleMode ( void ) const

拡大縮小状態判定関数

モデルの拡大・縮小状態を取得します。

モデルの拡大・縮小倍率が、全体および軸方向のいずれかで 1 以外に設定されている場合、モデルの拡大縮小が行われると解釈します。

覚え書き: ここでの判定は、単純に倍率数値が全て 1 であるかどうかで判断されます。たとえば、全体倍率を 1/2 とし、軸方向倍率を全て 2 に設定した場合、結果としてモデルの拡大縮小は行われないことになりますが、本関数の結果は false となります。

戻り値: 拡大縮小倍率に 1 以外が設定されている場合 true を、されていない場合 false を返します。

◆ glRotate_() [1/4]

bool FK::fk_MatrixAdmin::glRotate_	(	fk_Vector &	origin,
		fk_Axis	axis,
		double	theta
	)

グローバル座標系座標軸回転関数1

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、origin を通り、 axis で指定した座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は glRotateWithVec_() を利用して下さい。ローカル座標系で回転移動を行いたい場合は loRotate_() を利用して下さい。

引数

[in]	origin	グローバル座標系での回転軸上の点
[in]	axis	回転軸に平行な軸。fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: glRotateWithVec_(fk_Vector &, fk_Axis, double), loRotate_(fk_Vector &, fk_Axis, double), fk_Model::glRotate(fk_Vector, fk_Axis, double)

◆ glRotate_() [2/4]

bool FK::fk_MatrixAdmin::glRotate_	(	double	orgX,
		double	orgY,
		double	orgZ,
		fk_Axis	axis,
		double	theta
	)

グローバル座標系座標軸回転関数2

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、(orgX, orgY, orgZ) を通り、 axis で指定した座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は glRotateWithVec_() を利用して下さい。ローカル座標系で回転移動を行いたい場合は loRotate_() を利用して下さい。

引数

[in]	orgX	グローバル座標系での回転軸上の点のx成分
[in]	orgY	グローバル座標系での回転軸上の点のy成分
[in]	orgZ	グローバル座標系での回転軸上の点のz成分
[in]	axis	回転軸に平行な軸。fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: glRotateWithVec_(double, double, double, fk_Axis, double), loRotate_(double, double, double, fk_Axis, double), fk_Model::glRotate(double, double, double, fk_Axis, double)

◆ glRotate_() [3/4]

bool FK::fk_MatrixAdmin::glRotate_	(	fk_Vector &	A,
		fk_Vector &	B,
		double	theta
	)

グローバル座標系任意軸回転関数1

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、A と B を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は glRotateWithVec_() を利用して下さい。ローカル座標系で回転移動を行いたい場合は loRotate_() を利用して下さい。

引数

[in]	A	回転軸上の1点。B と一致してはいけません。
[in]	B	回転軸上の1点。A と一致してはいけません。
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotateWithVec_(fk_Vector &, fk_Vector &, double), loRotate_(fk_Vector &, fk_Vector &, double), fk_Model::glRotate(fk_Vector, fk_Vector, double)

◆ glRotate_() [4/4]

bool FK::fk_MatrixAdmin::glRotate_	(	double	Ax,
		double	Ay,
		double	Az,
		double	Bx,
		double	By,
		double	Bz,
		double	theta
	)

グローバル座標系任意軸回転関数2

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、(Ax, Ay, Az) と (Bx, By, Bz) を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は glRotateWithVec_() を利用して下さい。ローカル座標系で回転移動を行いたい場合は loRotate_() を利用して下さい。

引数

[in]	Ax	回転軸上の1点 A の x 成分
[in]	Ay	回転軸上の1点 A の y 成分
[in]	Az	回転軸上の1点 A の z 成分
[in]	Bx	回転軸上の1点 B の x 成分
[in]	By	回転軸上の1点 B の y 成分
[in]	Bz	回転軸上の1点 B の z 成分
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotateWithVec_(double, double, double, double, double, double, double), loRotate_(double, double, double, double, double, double, double), fk_Model::glRotate(double, double, double, double, double, double, double)

◆ loRotate_() [1/4]

bool FK::fk_MatrixAdmin::loRotate_	(	fk_Vector &	origin,
		fk_Axis	axis,
		double	theta
	)

ローカル座標系座標軸回転関数1

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は(ローカル座標系における) origin を通り、 axis で指定した (ローカル座標系における) 座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は loRotateWithVec_() を利用して下さい。グローバル座標系で回転移動を行いたい場合は glRotate_() を利用して下さい。

引数

[in]	origin	ローカル座標系での回転軸上の点
[in]	axis	回転軸に平行なローカル座標系上の軸。 fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: glRotate_(fk_Vector &, fk_Axis, double), loRotateWithVec_(fk_Vector &, fk_Axis, double), fk_Model::loRotate(fk_Vector, fk_Axis, double)

◆ loRotate_() [2/4]

bool FK::fk_MatrixAdmin::loRotate_	(	double	orgX,
		double	orgY,
		double	orgZ,
		fk_Axis	axis,
		double	theta
	)

ローカル座標系座標軸回転関数2

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は(ローカル座標系における) (orgX, orgY, orgZ) を通り、 axis で指定した (ローカル座標系における) 座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は loRotateWithVec_() を利用して下さい。グローバル座標系で回転移動を行いたい場合は glRotate_() を利用して下さい。

引数

[in]	orgX	ローカル座標系での回転軸上の点のx成分
[in]	orgY	ローカル座標系での回転軸上の点のy成分
[in]	orgZ	ローカル座標系での回転軸上の点のz成分
[in]	axis	回転軸に平行なローカル座標系上の軸。 fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: glRotate_(double, double, double, fk_Axis, double), loRotateWithVec_(double, double, double, fk_Axis, double), fk_Model::loRotate(double, double, double, fk_Axis, double)

◆ loRotate_() [3/4]

bool FK::fk_MatrixAdmin::loRotate_	(	fk_Vector &	A,
		fk_Vector &	B,
		double	theta
	)

ローカル座標系任意軸回転関数1

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は、(ローカル座標系における) A と B を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は loRotateWithVec_() を利用して下さい。グローバル座標系で回転移動を行いたい場合は glRotate_() を利用して下さい。

引数

[in]	A	ローカル座標系における回転軸上の1点。B と一致してはいけません。
[in]	B	ローカル座標系における回転軸上の1点。A と一致してはいけません。
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotateWithVec_(fk_Vector &, fk_Vector &, double), loRotate_(fk_Vector &, fk_Vector &, double), fk_Model::loRotate(fk_Vector, fk_Vector, double),

◆ loRotate_() [4/4]

bool FK::fk_MatrixAdmin::loRotate_	(	double	Ax,
		double	Ay,
		double	Az,
		double	Bx,
		double	By,
		double	Bz,
		double	theta
	)

ローカル座標系任意軸回転関数2

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は、(ローカル座標系における) (Ax, Ay, Az) と (Bx, By, Bz) を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は位置のみを回転させるもので、姿勢は回転しません。姿勢の回転も伴いたい場合は loRotateWithVec_() を利用して下さい。グローバル座標系で回転移動を行いたい場合は glRotate_() を利用して下さい。

引数

[in]	Ax	ローカル座標系における回転軸上の1点 A の x 成分
[in]	Ay	ローカル座標系における回転軸上の1点 A の y 成分
[in]	Az	ローカル座標系における回転軸上の1点 A の z 成分
[in]	Bx	ローカル座標系における回転軸上の1点 B の x 成分
[in]	By	ローカル座標系における回転軸上の1点 B の y 成分
[in]	Bz	ローカル座標系における回転軸上の1点 B の z 成分
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotateWithVec_(double, double, double, double, double, double, double), loRotate_(double, double, double, double, double, double, double), fk_Model::loRotate(double, double, double, double, double, double, double)

◆ glRotateWithVec_() [1/4]

bool FK::fk_MatrixAdmin::glRotateWithVec_	(	fk_Vector &	origin,
		fk_Axis	axis,
		double	theta
	)

グローバル座標系座標軸回転(姿勢付き)関数1

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、origin を通り、 axis で指定した座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は glRotate_() を利用して下さい。ローカル座標系で回転移動(姿勢付き)を行いたい場合は、 loRotateWithVec_() を利用して下さい。

引数

[in]	origin	グローバル座標系での回転軸上の点
[in]	axis	回転軸に平行な軸。fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: glRotate_(fk_Vector &, fk_Axis, double), loRotateWithVec_(fk_Vector &, fk_Axis, double), fk_Model::glRotateWithVec(fk_Vector, fk_Axis, double)

◆ glRotateWithVec_() [2/4]

bool FK::fk_MatrixAdmin::glRotateWithVec_	(	double	orgX,
		double	orgY,
		double	orgZ,
		fk_Axis	axis,
		double	theta
	)

グローバル座標系座標軸回転(姿勢付き)関数2

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、(orgX, orgY, orgZ) を通り、 axis で指定した座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は glRotate_() を利用して下さい。ローカル座標系で回転移動(姿勢付き)を行いたい場合は、 loRotateWithVec_() を利用して下さい。

引数

[in]	orgX	グローバル座標系での回転軸上の点のx成分
[in]	orgY	グローバル座標系での回転軸上の点のy成分
[in]	orgZ	グローバル座標系での回転軸上の点のz成分
[in]	axis	回転軸に平行な軸。fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: glRotate_(double, double, double, fk_Axis, double), loRotateWithVec_(double, double, double, fk_Axis, double), fk_Model::glRotateWithVec(double, double, double, fk_Axis, double)

◆ glRotateWithVec_() [3/4]

bool FK::fk_MatrixAdmin::glRotateWithVec_	(	fk_Vector &	A,
		fk_Vector &	B,
		double	theta
	)

グローバル座標系任意軸回転(姿勢付き)関数1

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、A と B を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は glRotate_() を利用して下さい。ローカル座標系で回転移動(姿勢付き)を行いたい場合は、 loRotateWithVec_() を利用して下さい。

引数

[in]	A	回転軸上の1点。B と一致してはいけません。
[in]	B	回転軸上の1点。A と一致してはいけません。
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotate_(fk_Vector &, fk_Vector &, double), loRotateWithVec_(fk_Vector &, fk_Vector &, double), fk_Model::glRotateWithVec(fk_Vector, fk_Vector, double)

◆ glRotateWithVec_() [4/4]

bool FK::fk_MatrixAdmin::glRotateWithVec_	(	double	Ax,
		double	Ay,
		double	Az,
		double	Bx,
		double	By,
		double	Bz,
		double	theta
	)

グローバル座標系任意軸回転(姿勢付き)関数2

モデルの位置を、グローバル座標系によって回転した場所に移動します。回転軸は、(Ax, Ay, Az) と (Bx, By, Bz) を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は glRotate_() を利用して下さい。ローカル座標系で回転移動(姿勢付き)を行いたい場合は、 loRotateWithVec_() を利用して下さい。

引数

[in]	Ax	回転軸上の1点 A の x 成分
[in]	Ay	回転軸上の1点 A の y 成分
[in]	Az	回転軸上の1点 A の z 成分
[in]	Bx	回転軸上の1点 B の x 成分
[in]	By	回転軸上の1点 B の y 成分
[in]	Bz	回転軸上の1点 B の z 成分
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotate_(double, double, double, double, double, double, double), loRotateWithVec_(double, double, double, double, double, double, double), fk_Model::glRotateWithVec(double, double, double, double, double, double, double)

◆ loRotateWithVec_() [1/4]

bool FK::fk_MatrixAdmin::loRotateWithVec_	(	fk_Vector &	origin,
		fk_Axis	axis,
		double	theta
	)

ローカル座標系座標軸回転(姿勢付き)関数1

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は(ローカル座標系における) origin を通り、 axis で指定した (ローカル座標系における) 座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は loRotate_() を利用して下さい。グローバル座標系で回転移動(姿勢付き)を行いたい場合は、 glRotateWithVec_() を利用して下さい。

引数

[in]	origin	ローカル座標系での回転軸上の点
[in]	axis	回転軸に平行なローカル座標系上の軸。 fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: loRotate_(fk_Vector &, fk_Axis, double), glRotateWithVec_(fk_Vector &, fk_Axis, double), fk_Model::loRotateWithVec(fk_Vector, fk_Axis, double)

◆ loRotateWithVec_() [2/4]

bool FK::fk_MatrixAdmin::loRotateWithVec_	(	double	orgX,
		double	orgY,
		double	orgZ,
		fk_Axis	axis,
		double	theta
	)

ローカル座標系座標軸回転(姿勢付き)関数2

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は(ローカル座標系における) (orgX, orgY, orgZ) を通り、 axis で指定した (ローカル座標系における) 座標軸に平行な直線となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は loRotate_() を利用して下さい。グローバル座標系で回転移動(姿勢付き)を行いたい場合は、 glRotateWithVec_() を利用して下さい。

引数

[in]	orgX	ローカル座標系での回転軸上の点のx成分
[in]	orgY	ローカル座標系での回転軸上の点のy成分
[in]	orgZ	ローカル座標系での回転軸上の点のz成分
[in]	axis	回転軸に平行なローカル座標系上の軸。 fk_X, fk_Y, fk_Z のいずれかになります。
[in]	theta	回転角度(ラジアン)

戻り値: この関数は常に true を返します。

参照: loRotate_(double, double, double, fk_Axis, double), glRotateWithVec_(double, double, double, fk_Axis, double), fk_Model::loRotateWithVec(double, double, double, fk_Axis, double)

◆ loRotateWithVec_() [3/4]

bool FK::fk_MatrixAdmin::loRotateWithVec_	(	fk_Vector &	A,
		fk_Vector &	B,
		double	theta
	)

ローカル座標系任意軸回転(姿勢付き)関数1

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は、(ローカル座標系における) A と B を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は loRotate_() を利用して下さい。グローバル座標系で回転移動(姿勢付き)を行いたい場合は、 glRotateWithVec_() を利用して下さい。

引数

[in]	A	ローカル座標系における回転軸上の1点。B と一致してはいけません。
[in]	B	ローカル座標系における回転軸上の1点。A と一致してはいけません。
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotateWithVec_(fk_Vector &, fk_Vector &, double) loRotate_(fk_Vector &, fk_Vector &, double), fk_Model::loRotateWithVec(fk_Vector, fk_Vector, double)

◆ loRotateWithVec_() [4/4]

bool FK::fk_MatrixAdmin::loRotateWithVec_	(	double	Ax,
		double	Ay,
		double	Az,
		double	Bx,
		double	By,
		double	Bz,
		double	theta
	)

ローカル座標系任意軸回転(姿勢付き)関数2

モデルの位置を、ローカル座標系によって回転した場所に移動します。回転軸は、(ローカル座標系における) (Ax, Ay, Az) と (Bx, By, Bz) を通る軸となります。回転角度は theta となります。単位は弧度法(ラジアン)です。

この関数は、回転の際に姿勢も回転していきます。位置のみの回転を行いたい場合は loRotate_() を利用して下さい。グローバル座標系で回転移動(姿勢付き)を行いたい場合は、 glRotateWithVec_() を利用して下さい。

引数

[in]	Ax	ローカル座標系における回転軸上の1点 A の x 成分
[in]	Ay	ローカル座標系における回転軸上の1点 A の y 成分
[in]	Az	ローカル座標系における回転軸上の1点 A の z 成分
[in]	Bx	ローカル座標系における回転軸上の1点 B の x 成分
[in]	By	ローカル座標系における回転軸上の1点 B の y 成分
[in]	Bz	ローカル座標系における回転軸上の1点 B の z 成分
[in]	theta	回転角度(ラジアン)

戻り値: 回転が成功した場合 true を返します。 A と B が同一位置ベクトルであった場合、回転せずに false を返します。

参照: glRotateWithVec_(double, double, double, double, double, double, double), loRotate_(double, double, double, double, double, double, double), fk_Model::loRotateWithVec(double, double, double, double, double, double, double)

◆ glTranslate_() [1/2]

bool FK::fk_MatrixAdmin::glTranslate_ ( fk_Vector & v )

グローバル座標系平行移動関数1

モデルを、クローバル座標系によって平行移動した位置に移動します。平行移動量はベクトルで指定します。

ローカル座標系による平行移動量の指定を行いたい場合は、 loTranslate_() を利用して下さい。

引数

[in] v 平行移動量ベクトル

戻り値: この関数は常に true を返します。

参照: loTranslate_(fk_Vector &), fk_Model::glTranslate(fk_Vector)

◆ glTranslate_() [2/2]

bool FK::fk_MatrixAdmin::glTranslate_	(	double	x,
		double	y,
		double	z
	)

グローバル座標系平行移動関数2

モデルを、クローバル座標系によって平行移動した位置に移動します。平行移動量はベクトルの成分を意味する3個の実数で指定します。

ローカル座標系による平行移動量の指定を行いたい場合は、 loTranslate_() を利用して下さい。

引数

[in]	x	平行移動量ベクトルのx成分
[in]	y	平行移動量ベクトルのy成分
[in]	z	平行移動量ベクトルのz成分

戻り値: この関数は常に true を返します。

参照: loTranslate_(double, double, double), fk_Model::glTranslate(double, double, double)

◆ loTranslate_() [1/2]

bool FK::fk_MatrixAdmin::loTranslate_ ( fk_Vector & v )

ローカル座標系平行移動関数1

モデルを、ローカル座標系によって平行移動した位置に移動します。平行移動量はベクトルで指定します。

グローバル座標系による平行移動量の指定を行いたい場合は、 glTranslate_() を利用して下さい。

引数

[in] v 平行移動量ベクトル

戻り値: この関数は常に true を返します。

参照: glTranslate_(fk_Vector &), glMoveTo_(fk_Vector &), fk_Model::loTranslate(fk_Vector)

◆ loTranslate_() [2/2]

bool FK::fk_MatrixAdmin::loTranslate_	(	double	x,
		double	y,
		double	z
	)

ローカル座標系平行移動関数2

モデルを、ローカル座標系によって平行移動した位置に移動します。平行移動量はベクトルの成分を意味する3個の実数で指定します。

グローバル座標系による平行移動量の指定を行いたい場合は、 glTranslate_() を利用して下さい。

引数

[in]	x	平行移動量ベクトルのx成分
[in]	y	平行移動量ベクトルのy成分
[in]	z	平行移動量ベクトルのz成分

戻り値: この関数は常に true を返します。

参照: glTranslate_(double, double, double), glMoveTo_(double, double, double), fk_Model::loTranslate(double, double, double)

◆ glMoveTo_() [1/2]

bool FK::fk_MatrixAdmin::glMoveTo_ ( fk_Vector & p )

グローバル座標系位置指定関数1

モデルの位置を、指定した位置ベクトルに移動します。位置はベクトルで指定します。

覚え書き: glMoveTo_() 関数に対応するローカル座標系関数「loMoveTo_()」関数は存在しません。これは、loMoveTo_() 関数はその意味的に loTranslate_() とまったく同一の挙動となるためです。

引数

[in] p 移動先位置ベクトル

戻り値: この関数は常に true を返します。

参照: glTranslate_(fk_Vector &), loTranslate_(fk_Vector &), fk_Model::glMoveTo(fk_Vector)

◆ glMoveTo_() [2/2]

bool FK::fk_MatrixAdmin::glMoveTo_	(	double	x,
		double	y,
		double	z
	)

グローバル座標系位置指定関数2

モデルの位置を、指定した位置ベクトルに移動します。位置はベクトルの成分を意味する3個の実数で指定します。

覚え書き: glMoveTo_() 関数に対応するローカル座標系関数「loMoveTo_()」関数は存在しません。これは、loMoveTo_() 関数はその意味的に loTranslate_() とまったく同一の挙動となるためです。

引数

[in]	x	移動先位置ベクトルのx成分
[in]	y	移動先位置ベクトルのy成分
[in]	z	移動先位置ベクトルのz成分

戻り値: この関数は常に true を返します。

参照: glTranslate_(double, double, double), loTranslate_(double, double, double), fk_Model::glMoveTo(double, double, double)

◆ glFocus() [1/2]

bool FK::fk_MatrixAdmin::glFocus ( fk_Vector p )

グローバル座標系注視点設定関数1

モデルの方向ベクトルを、グローバル座標系による位置 p に向くように方向ベクトルを設定します。モデルをカメラとして解釈すると、 p を注視点としてカメラを向けることになります。

なお、この関数を呼んだ時点でのアップベクトルの状態は規定されていません。アップベクトルを含めた姿勢制御を行うため、 glUpvec() などと併用しなければなりません。

引数

[in] p 注視点位置ベクトル

戻り値: 与えられた注視点位置ベクトルが、現在のモデルの位置ベクトルと等しい場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: loFocus(), glVec(), glUpvec(), glAngle()

◆ glFocus() [2/2]

bool FK::fk_MatrixAdmin::glFocus	(	double	x,
		double	y,
		double	z
	)

グローバル座標系注視点設定関数2

モデルの方向ベクトルを、グローバル座標系による位置 (x, y, z) に向くように方向ベクトルを設定します。モデルをカメラとして解釈すると、 (x, y, z) を注視点としてカメラを向けることになります。

なお、この関数を呼んだ時点でのアップベクトルの状態は規定されていません。アップベクトルを含めた姿勢制御を行うため、 glUpvec() などと併用しなければなりません。

引数

[in]	x	注視点位置ベクトルのx成分
[in]	y	注視点位置ベクトルのy成分
[in]	z	注視点位置ベクトルのz成分

戻り値: 与えられた注視点位置ベクトルが、現在のモデルの位置ベクトルと等しい場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: loFocus(), glVec(), glUpvec(), glAngle()

◆ loFocus() [1/2]

bool FK::fk_MatrixAdmin::loFocus ( fk_Vector p )

ローカル座標系注視点設定関数1

モデルの方向ベクトルを、ローカル座標系による位置 p に向くように方向ベクトルを設定します。モデルをカメラとして解釈すると、 p を注視点としてカメラを向けることになります。

なお、この関数を呼んだ時点でのアップベクトルの状態は規定されていません。アップベクトルを含めた姿勢制御を行うため、 glUpvec() などと併用しなければなりません。

引数

[in] p 注視点位置ベクトル

戻り値: 与えられた注視点位置ベクトルが、零ベクトルであった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: glFocus(), glUpvec(), loUpvec(), loAngle()

◆ loFocus() [2/2]

bool FK::fk_MatrixAdmin::loFocus	(	double	x,
		double	y,
		double	z
	)

ローカル座標系注視点設定関数2

モデルの方向ベクトルを、ローカル座標系による位置 (x, y, z) に向くように方向ベクトルを設定します。モデルをカメラとして解釈すると、 (x, y, z) を注視点としてカメラを向けることになります。

なお、この関数を呼んだ時点でのアップベクトルの状態は規定されていません。アップベクトルを含めた姿勢制御を行うため、 glUpvec() などと併用しなければなりません。

引数

[in]	x	注視点位置ベクトルのx成分
[in]	y	注視点位置ベクトルのy成分
[in]	z	注視点位置ベクトルのz成分

戻り値: 与えられた注視点位置ベクトルが、零ベクトルであった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: glFocus(), glUpvec(), loUpvec(), loAngle()

◆ glVec() [1/2]

bool FK::fk_MatrixAdmin::glVec ( fk_Vector v )

グローバル座標系方向ベクトル設定関数1

モデルの方向ベクトルを、グローバル座標系において与えられたベクトルに設定します。ベクトルは正規化されている必要はありませんが、零ベクトルであってはなりません。

この関数を呼んだ時点でのアップベクトルの状態は規定されていません。アップベクトルを含めた姿勢制御を行うため、 glUpvec() などと併用しなければなりません。

覚え書き: glVec() 関数に対応するローカル座標系関数「loVec()」関数は存在しません。これは、loVec() 関数はその意味的に loFocus() とまったく同一の挙動となるためです。

引数

[in] v 方向ベクトル

戻り値: 与えられた方向ベクトルが零ベクトルであった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: glFocus(), glUpvec(), glAngle(), loFocus()

◆ glVec() [2/2]

bool FK::fk_MatrixAdmin::glVec	(	double	x,
		double	y,
		double	z
	)

グローバル座標系方向ベクトル設定関数2

モデルの方向ベクトルを、グローバル座標系において与えられたベクトルに設定します。ベクトルは正規化されている必要はありませんが、零ベクトルであってはなりません。

この関数を呼んだ時点でのアップベクトルの状態は規定されていません。アップベクトルを含めた姿勢制御を行うため、 glUpvec() などと併用しなければなりません。

覚え書き: glVec() 関数に対応するローカル座標系関数「loVec()」関数は存在しません。これは、loVec() 関数はその意味的に loFocus() とまったく同一の挙動となるためです。

引数

[in]	x	方向ベクトルのx成分
[in]	y	方向ベクトルのx成分
[in]	z	方向ベクトルのx成分

戻り値: 与えられた方向ベクトルが零ベクトルであった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: glFocus(), glUpvec(), glAngle(), loFocus()

◆ glUpvec() [1/2]

bool FK::fk_MatrixAdmin::glUpvec ( fk_Vector v )

グローバル座標系アップベクトル設定関数1

モデルのアップベクトルを、グローバル座標系において与えられたベクトルに設定します。ベクトルは正規化されている必要はありませんが、零ベクトルであってはなりません。また、方向ベクトルと平行であった場合もエラーとなります。

引数

[in] v アップベクトル

戻り値: 与えられたアップベクトルが零ベクトルであるか、方向ベクトルと平行であった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: glFocus(), glVec(), glAngle(), loUpvec()

◆ glUpvec() [2/2]

bool FK::fk_MatrixAdmin::glUpvec	(	double	x,
		double	y,
		double	z
	)

グローバル座標系アップベクトル設定関数2

モデルのアップベクトルを、グローバル座標系において与えられたベクトルに設定します。ベクトルは正規化されている必要はありませんが、零ベクトルであってはなりません。また、方向ベクトルと平行であった場合もエラーとなります。

引数

[in]	x	アップベクトルのx成分
[in]	y	アップベクトルのy成分
[in]	z	アップベクトルのz成分

戻り値: 与えられたアップベクトルが零ベクトルであるか、方向ベクトルと平行であった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: glFocus(), glVec(), glAngle(), loUpvec()

◆ loUpvec() [1/2]

bool FK::fk_MatrixAdmin::loUpvec ( fk_Vector v )

ローカル座標系アップベクトル設定関数1

モデルのアップベクトルを、ローカル座標系において与えられたベクトルに設定します。本関数においては、z成分の値は意味をなしませんが、実際には 0 以外の値であっても問題なく動作します。

ベクトルは正規化されている必要はありませんが、零ベクトルであってはなりません。また、z軸方向のベクトルと平行であった場合もエラーとなります。

引数

[in] v アップベクトル

戻り値: 与えられたアップベクトルが零ベクトルであるか、 z軸ベクトルと平行であった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: loFocus(), loAngle(), glUpvec()

◆ loUpvec() [2/2]

bool FK::fk_MatrixAdmin::loUpvec	(	double	x,
		double	y,
		double	z
	)

ローカル座標系アップベクトル設定関数2

モデルのアップベクトルを、ローカル座標系において与えられたベクトルに設定します。本関数においては、z成分の値は意味をなしませんが、実際には 0 以外の値であっても問題なく動作します。

ベクトルは正規化されている必要はありませんが、零ベクトルであってはなりません。また、z軸方向のベクトルと平行であった場合もエラーとなります。

引数

[in]	x	アップベクトルのx成分
[in]	y	アップベクトルのy成分
[in]	z	アップベクトルのz成分

戻り値: 与えられたアップベクトルが零ベクトルであるか、 z軸ベクトルと平行であった場合、姿勢を変更せずに false を返します。それ以外の場合、姿勢を変更し true を返します。

参照: loFocus(), loAngle(), glUpvec()

◆ glAngle() [1/2]

bool FK::fk_MatrixAdmin::glAngle ( fk_Angle angle )

グローバル座標系オイラー角設定関数1

モデルの姿勢を、グローバル座標系におけるオイラー角で設定します。オイラー角はモデルの姿勢を一意に決定できるため、姿勢を厳密に保存、再現する方法として利用できます。オイラー角についての詳しい解説は fk_Angle を参照して下さい。

引数

[in] angle 姿勢を表すオイラー角

戻り値: この関数は常に true を返します。

参照: loAngle(), glVec(), glUpvec(), fk_Angle

◆ glAngle() [2/2]

bool FK::fk_MatrixAdmin::glAngle	(	double	h,
		double	p,
		double	b
	)

グローバル座標系オイラー角設定関数2

モデルの姿勢を、グローバル座標系におけるオイラー角で設定します。オイラー角はモデルの姿勢を一意に決定できるため、姿勢を厳密に保存、再現する方法として利用できます。オイラー角についての詳しい解説は fk_Angle を参照して下さい。

引数

[in]	h	姿勢を表すオイラー角のヘディング角
[in]	p	姿勢を表すオイラー角のピッチ角
[in]	b	姿勢を表すオイラー角のバンク角

戻り値: この関数は常に true を返します。

参照: loAngle(), glVec(), glUpvec(), fk_Angle

◆ loAngle() [1/2]

bool FK::fk_MatrixAdmin::loAngle ( fk_Angle angle )

ローカル座標系オイラー角設定関数1

モデルの姿勢を、ローカル座標系におけるオイラー角で設定します。オイラー角についての詳しい解説は fk_Angle を参照して下さい。

引数

[in] angle 姿勢を表すオイラー角

戻り値: この関数は常に true を返します。

参照: glAngle(), loFocus(), loUpvec(), fk_Angle

◆ loAngle() [2/2]

bool FK::fk_MatrixAdmin::loAngle	(	double	h,
		double	p,
		double	b
	)

ローカル座標系オイラー角設定関数2

モデルの姿勢を、ローカル座標系におけるオイラー角で設定します。オイラー角についての詳しい解説は fk_Angle を参照して下さい。

引数

[in]	h	姿勢を表すオイラー角のヘディング角
[in]	p	姿勢を表すオイラー角のピッチ角
[in]	b	姿勢を表すオイラー角のバンク角

戻り値: この関数は常に true を返します。

参照: glAngle(), loFocus(), loUpvec(), fk_Angle

公開メンバ関数

詳解

構築子と解体子

◆ fk_MatrixAdmin()

◆ ~fk_MatrixAdmin()

関数詳解

◆ getPosition()

◆ getVec()

◆ getUpvec()

◆ getAngle()

◆ getMatrix()

◆ getInvMatrix()

◆ getBaseMatrix()

◆ getInvBaseMatrix()

◆ setScale() [1/3]

◆ setScale() [2/3]

◆ setScale() [3/3]

◆ prdScale() [1/3]

◆ prdScale() [2/3]

◆ prdScale() [3/3]

◆ getScale() [1/2]

◆ getScale() [2/2]

◆ getScaleMode()

◆ glRotate_() [1/4]

◆ glRotate_() [2/4]

◆ glRotate_() [3/4]

◆ glRotate_() [4/4]

◆ loRotate_() [1/4]

◆ loRotate_() [2/4]

◆ loRotate_() [3/4]

◆ loRotate_() [4/4]

◆ glRotateWithVec_() [1/4]

◆ glRotateWithVec_() [2/4]

◆ glRotateWithVec_() [3/4]

◆ glRotateWithVec_() [4/4]

◆ loRotateWithVec_() [1/4]

◆ loRotateWithVec_() [2/4]

◆ loRotateWithVec_() [3/4]

◆ loRotateWithVec_() [4/4]

◆ glTranslate_() [1/2]

◆ glTranslate_() [2/2]

◆ loTranslate_() [1/2]

◆ loTranslate_() [2/2]

◆ glMoveTo_() [1/2]

◆ glMoveTo_() [2/2]

◆ glFocus() [1/2]

◆ glFocus() [2/2]

◆ loFocus() [1/2]

◆ loFocus() [2/2]

◆ glVec() [1/2]

◆ glVec() [2/2]

◆ glUpvec() [1/2]

◆ glUpvec() [2/2]

◆ loUpvec() [1/2]

◆ loUpvec() [2/2]

◆ glAngle() [1/2]

◆ glAngle() [2/2]

◆ loAngle() [1/2]

◆ loAngle() [2/2]