stingray.Matrix4x4 オブジェクト リファレンス

説明

オブジェクトの位置と方向の両方を格納する 4x4 行列を表します。

注: Matrix4x4 オブジェクトは一時的です。このオブジェクトは、生成されたフレーム内でのみ使用することができます。複数のフレームにわたって Matrix4x4 を保存する必要がある場合は、Matrix4x4Box を代わりに使用します。詳細については、「オブジェクトのライフタイムとユーザデータのバインド」を参照してください。

コンストラクタとアクセサ

stingray.Actor.pose() stingray.AnimationBlenderComponent.delta_transform() stingray.AnimationStateMachineComponent.get_constraint_target() stingray.Camera.local_pose() stingray.Camera.projection() stingray.Camera.world_pose() stingray.GearVR.hmd_local_pose() stingray.GearVR.hmd_world_pose() stingray.GoogleVR.hmd_local_pose() stingray.GoogleVR.hmd_world_pose() stingray.Hololens.head_pose() stingray.Level.pose() stingray.Light.local_pose() stingray.Light.world_pose() stingray.LODObject.local_pose() stingray.LODObject.world_pose() stingray.Math.merge_boxes() stingray.Matrix4x4() stingray.Matrix4x4.copy() stingray.Matrix4x4.from_axes() stingray.Matrix4x4.from_elements() stingray.Matrix4x4.from_quaternion() stingray.Matrix4x4.from_quaternion_position() stingray.Matrix4x4.from_translation() stingray.Matrix4x4.identity() stingray.Matrix4x4.inverse() stingray.Matrix4x4.lerp() stingray.Matrix4x4.multiply() stingray.Matrix4x4.zero() stingray.Matrix4x4Box.unbox() stingray.Mesh.box() stingray.Mesh.local_pose() stingray.Mesh.world_pose() stingray.MeshComponent.oobb() stingray.Oculus.controller_local_pose() stingray.Oculus.controller_world_pose() stingray.Oculus.hmd_local_pose() stingray.Oculus.hmd_world_pose() stingray.Oculus.tracking_space_pose() stingray.Quaternion.matrix4x4() stingray.SceneGraphComponent.local_pose() stingray.SceneGraphComponent.world_pose() stingray.SceneGraphNode.local_pose() stingray.SceneGraphNode.world_pose() stingray.Script.deserialize() stingray.SteamVR.controller_local_pose() stingray.SteamVR.controller_world_pose() stingray.SteamVR.hmd_local_pose() stingray.SteamVR.hmd_world_pose() stingray.SteamVR.tracking_space_pose() stingray.TransformComponent.local_pose() stingray.TransformComponent.world_pose() stingray.Unit.animation_get_constraint_target() stingray.Unit.animation_wanted_root_pose() stingray.Unit.box() stingray.Unit.delta_pose() stingray.Unit.local_pose() stingray.Unit.world_pose() stingray.World.debug_camera_pose()

関連サンプル コード

Appkit: /camera_wrapper.lua Appkit: /unit_controller.lua 基本テンプレート: /player.lua キャラクタ テンプレート: /player.lua 車両テンプレート: /player.lua Oculus VR テンプレート: /flow_callbacks.lua Oculus VR テンプレート: /player.lua Steam VR テンプレート: /flow_callbacks.lua Steam VR テンプレート: /player.lua

その他の関連リファレンス項目

	stingray.Cloud stingray.SaveSystem
	stingray.Matrix4x4Box
	rotation2D
	stingray.Actor.debug_draw() stingray.Actor.pose() stingray.Actor.teleport_pose() stingray.ActorComponent.create_capsule() stingray.ActorComponent.create_plane() stingray.ActorComponent.create_sphere() stingray.ActorComponent.create_sphere() stingray.AnimationStateMachineComponent.set_constraint_target() stingray.Camera.set_local() stingray.Camera.set_local_pose() stingray.EntityManager.spawn() stingray.GearVR.set_layer_pose() stingray.GearVR.set_tracking_space_pose() stingray.GoogleVR.set_tracking_space_pose() stingray.Gui.bitmap_3d() stingray.Gui.bitmap_3d_uv() stingray.Gui.move() stingray.Gui.rect_3d() stingray.Gui.text_3d() stingray.Gui.update_bitmap_3d() stingray.Gui.update_bitmap_3d_uv() stingray.Gui.update_rect_3d() stingray.Gui.update_text_3d() stingray.Gui.update_video_3d() stingray.Gui.video_3d() stingray.GwNavBoxObstacle.set_transform() stingray.GwNavWorld.create() stingray.Level.pose() stingray.Light.set_local_pose() stingray.LineObject.add_axes() stingray.LineObject.add_box() stingray.LODObject.set_local_pose() stingray.Material.set_matrix4x4() stingray.Math.box_intersects_frustum() stingray.Math.box_in_frustum() stingray.Math.merge_boxes() stingray.Math.point_in_box() stingray.Math.ray_box_intersection() stingray.Matrix4x4Box.store() stingray.Mesh.set_local_pose() stingray.Oculus.set_layer_pose() stingray.Oculus.set_tracking_space_pose() stingray.PhysicsWorld.create_joint() stingray.PhysicsWorld.overlap() stingray.PhysicsWorld.set_observer() stingray.Quaternion.from_matrix4x4() stingray.Quaternion.matrix4x4() stingray.SceneGraphComponent.set_local_pose() stingray.SceneGraphNode.set_local_pose() stingray.Script.serialize() stingray.SteamVR.set_layer_pose() stingray.SteamVR.set_tracking_space_pose() stingray.TransformComponent.link() stingray.TransformComponent.link_to_scene_graph() stingray.TransformComponent.set_local_pose() stingray.Unit.animation_set_constraint_target() stingray.Unit.set_local_pose() stingray.Unit.teleport_local_pose() stingray.World.create_world_gui() stingray.World.link_particles() stingray.World.spawn_unit() stingray.WwiseWorld.make_auto_source() stingray.WwiseWorld.make_manual_source() stingray.WwiseWorld.set_listener() stingray.WwiseWorld.set_source_pose() stingray.WwiseWorld.trigger_event()
	Math

関数

axis ( m, i ) : stingray.Vector3 行列のローカル X 軸、Y 軸、または Z 軸を取得します。

パラメータ

m :	stingray.Matrix4x4	軸を返す行列です。
i :	integer	取得する軸のインデックスです。X 軸を取得するには 1、Y 軸は 2、Z 軸は 3 を使用します。

戻り値

stingray.Vector3

指定したインデックスにある軸です。

copy ( m ) : stingray.Matrix4x4 同じ回転値と移動値を持つ指定した行列の新しいコピーを返します。

パラメータ

m :

stingray.Matrix4x4

コピーする行列です。

戻り値

stingray.Matrix4x4

新しく作成されたマトリックス。

element ( m, i, j ) : number 行列内のインデックス (i, j) の要素を返します。

パラメータ

m :	stingray.Matrix4x4	要素が返される行列です。
i :	integer	行のインデックス。ローカル X 軸の回転にアクセスするには 1、 ローカル Y 軸の回転には 2、ローカル Z 軸の回転には 3、移動には 4 を使用します。
j :	integer	列のインデックス。グローバル X コンポーネントにアクセスするには 1、グローバル Y コンポーネントには 2、グローバル Z コンポーネントには 3、移動には 4 を使用します。

戻り値

number

指定したインデックスを持つ要素の値です。

インデックスは 1 ベースであるため、たとえば、element(1,2) は行列に格納されている X 軸(1)の Y コンポーネント(2)を返します。

equal ( m1, m2 ) : boolean 2 つの行列が等しいかどうかを示します。

パラメータ

m1 :	stingray.Matrix4x4	最初の行列です。
m2 :	stingray.Matrix4x4	2 番目の行列です。

戻り値

boolean

2 つの行列が同じである場合は true を返し、それ以外の場合は false を返します。

forward ( m ) : stingray.Vector3 指定された行列の前方(Y)軸を返します。

パラメータ

m :

stingray.Matrix4x4

軸の値が返される行列です。

戻り値

stingray.Vector3

行列の前方軸です。

from_axes ( x, y, z, t ) : stingray.Matrix4x4 指定した回転と移動を表す行列を返します。

パラメータ

x :	stingray.Vector3	ローカル X 軸の方向です。
y :	stingray.Vector3	ローカル Y 軸の方向です。
z :	stingray.Vector3	ローカル Z 軸の方向です。
t :	stingray.Vector3	新しい行列に格納される移動です。

戻り値

stingray.Matrix4x4

新しく作成されたマトリックス。

関連サンプル コード

車両テンプレート: /vehicle_follow_cam.lua

from_elements ( xx, xy, xz, yx, yy, yz, zx, zy, zz, tx, ty, tz ) : stingray.Matrix4x4 X 軸 (xx, xy, xz)、Y 軸 (yx, yy, yz)、Z 軸 (zx, zy, zz)、移動 (tx, ty, tz) を使用したマトリックスを作成します。

パラメータ

xx :	number	グローバル X 軸に沿ったローカル X 軸の大きさ。
xy :	number	グローバル Y 軸に沿ったローカル X 軸の大きさ。
xz :	number	グローバル Z 軸に沿ったローカル X 軸の大きさ。
yx :	number	グローバル X 軸に沿ったローカル Y 軸の大きさ。
yy :	number	グローバル Y 軸に沿ったローカル Y 軸の大きさ。
yz :	number	グローバル Z 軸に沿ったローカル Y 軸の大きさ。
zx :	number	グローバル X 軸に沿ったローカル Z 軸の大きさ。
zy :	number	グローバル Y 軸に沿ったローカル Z 軸の大きさ。
zz :	number	グローバル Z 軸に沿ったローカル Z 軸の大きさ。
tx :	number	グローバル X 軸に沿った移動。
ty :	number	グローバル Y 軸に沿った移動。
tz :	number	グローバル Z 軸に沿った移動。

戻り値

stingray.Matrix4x4

新しく作成されたマトリックス。

Matrix4x4() に相当します。

from_quaternion ( q ) : stingray.Matrix4x4 指定した回転を移動なしで表す行列を返します。

パラメータ

q :

stingray.Quaternion

新しい行列に格納される回転です。

戻り値

stingray.Matrix4x4

新しく作成されたマトリックス。

from_quaternion_position ( q, t ) : stingray.Matrix4x4 指定した回転と移動を表す行列を返します。

パラメータ

q :	stingray.Quaternion	新しい行列に格納される回転です。
t :	stingray.Vector3	新しい行列に格納される移動です。

戻り値

stingray.Matrix4x4

新しく作成されたマトリックス。

関連サンプル コード

Oculus VR テンプレート: /project.lua

from_translation ( t ) : stingray.Matrix4x4 指定した移動を回転なしで表す行列を返します。

パラメータ

t :

stingray.Vector3

新しい行列に格納される移動です。

戻り値

stingray.Matrix4x4

新しく作成されたマトリックス。

identity ( ) : stingray.Matrix4x4 移動と回転なしのオブジェクトを表す単位行列を返します。

パラメータ

この関数はパラメータを受け入れません。

戻り値

stingray.Matrix4x4

単位行列です。

関連サンプル コード

基本テンプレート: /main_menu.lua キャラクタ テンプレート: /main_menu.lua 車両テンプレート: /main_menu.lua Oculus VR テンプレート: /main_menu.lua Oculus VR テンプレート: /project.lua Steam VR テンプレート: /project.lua

その他の関連リファレンス項目

stingray.Gui

inverse ( m ) : stingray.Matrix4x4 指定した行列の逆を返します。

パラメータ

m :

stingray.Matrix4x4

反転する行列です。

戻り値

stingray.Matrix4x4

反転された行列です。

is_valid ( m ) : boolean 行列が有効な値だけで構成されているかどうかを示します。

パラメータ

m :

stingray.Matrix4x4

検証する行列です。

戻り値

boolean

行列のすべてのコンポーネントが有効な数値の場合は true を返し、いずれかのコンポーネントが #NaN または #INF·の場合は false を返します。

is_valid_for_physics ( m ) : boolean 行列を物理オブジェクトに適用できるかどうかを示します。

パラメータ

m :

stingray.Matrix4x4

検証する行列です。

戻り値

boolean

この行列が物理オブジェクトに適用できる場合は true を返し、それ以外の場合は false を返します。

たとえば、行列にシア(非直交軸)または他の予期しないジオメトリが含まれている場合、行列が物理オブジェクトでの使用に適合しない場合があります。

lerp ( m1, m2, t ) : stingray.Matrix4x4 2 つの指定した行列間で補間、すなわち「線形補間」を行うことで新しい行列を生成します。

パラメータ

m1 :	stingray.Matrix4x4	最初の行列です。
m2 :	stingray.Matrix4x4	2 番目の行列です。
t :	number	2 つの行列の間の比率、または補間ポイントです。0 から 1 までの任意の値にすることができます。値が 0 に近いほど、m1 に近い行列が生成され、1 に近いほど m2 に近い行列が生成されます。

戻り値

stingray.Matrix4x4

結果の行列です。

これは移動と回転を別々に線形補間することで行われます。スケールなどは線形補間されません。

multiply ( m1, m2 ) : stingray.Matrix4x4 2 つの行列を乗算します。

パラメータ

m1 :	stingray.Matrix4x4	乗算する最初の行列です。
m2 :	stingray.Matrix4x4	乗算する 2 番目の行列です。

戻り値

stingray.Matrix4x4

乗算の結果です。

これは個別のトランスフォーム行列のコンポジット トランスフォームを作成します。

right ( m ) : stingray.Vector3 指定した行列の右(X)軸を返します。

パラメータ

m :

stingray.Matrix4x4

軸の値が返される行列です。

戻り値

stingray.Vector3

行列の右軸です。

rotation ( m ) : stingray.Quaternion 行列の回転を取得します。

パラメータ

m :

stingray.Matrix4x4

回転が返される行列です。

戻り値

stingray.Quaternion

行列の回転です。

関連サンプル コード

Oculus VR テンプレート: /project.lua Steam VR テンプレート: /project.lua

scale ( m ) : stingray.Vector3 行列のスケールを取得します。

パラメータ

m :

stingray.Matrix4x4

スケールが返される行列です。

戻り値

stingray.Vector3

行列のスケールです。

関連サンプル コード

Oculus VR テンプレート: /project.lua Steam VR テンプレート: /project.lua

set_axis ( m, i, v ) 行列のローカル X 軸、Y 軸、または Z 軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸が設定される行列です。
i :	integer	設定する軸のインデックスです。X 軸を取得するには 1、Y 軸は 2、Z 軸は 3 を使用します。
v :	stingray.Vector3	設定する軸の値

戻り値

この関数は値を返しません。

set_element ( m, i, j, value ) 行列内のインデックス (i, j) の要素に新しい値を設定します。

パラメータ

m :	stingray.Matrix4x4	要素が設定される行列です。
i :	integer	行のインデックス。ローカル X 軸の回転を設定するには 1、ローカル Y 軸の回転は 2、ローカル Z 軸の回転は 3、移動は 4 を使用します。
j :	integer	列のインデックス。グローバル X コンポーネントを設定するには 1、グローバル Y コンポーネントは 2、グローバル Z コンポーネントは 3、移動は 4 を使用します。
value :	number	指定されたインデックスを持つ要素に設定する値です。

戻り値

この関数は値を返しません。

インデックスは 1 ベースであるため、たとえば、set_element(1,2) は行列に格納されている X 軸(1)の Y コンポーネント(2)を設定します。

set_forward ( m, forward ) 指定された行列の前方(Y)軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸の値が設定される行列です。
forward :	stingray.Vector3	行列の新しい前方軸です。

戻り値

この関数は値を返しません。

set_right ( m, right ) 指定した行列の右(X)軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸の値が設定される行列です。
right :	stingray.Vector3	行列の新しい右軸です。

戻り値

この関数は値を返しません。

set_rotation ( m, r ) 行列の回転を設定します。

パラメータ

m :	stingray.Matrix4x4	回転が設定される行列です。
r :	stingray.Quaternion	行列の新しい回転です。

戻り値

この関数は値を返しません。

set_scale ( m, s ) 行列のスケールを設定します。

パラメータ

m :	stingray.Matrix4x4	スケールが設定される行列です。
s :	stingray.Vector3	行列の新しいスケールです。

戻り値

この関数は値を返しません。

関連サンプル コード

Oculus VR テンプレート: /project.lua Steam VR テンプレート: /project.lua

set_translation ( m, t ) 行列の移動を設定します。

パラメータ

m :	stingray.Matrix4x4	移動が設定される行列です。
t :	stingray.Vector3	行列の新しい移動です。

戻り値

この関数は値を返しません。

関連サンプル コード

Oculus VR テンプレート: /project.lua

set_up ( m, up ) 指定した行列の上(Z)軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸の値が設定される行列です。
up :	stingray.Vector3	行列の新しい上軸です。

戻り値

この関数は値を返しません。

set_x ( m, x ) 指定した行列の X 軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸の値が設定される行列です。
x :	stingray.Vector3	行列の新しい X 軸です。

戻り値

この関数は値を返しません。

set_y ( m, y ) 指定した行列の Y 軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸の値が設定される行列です。
y :	stingray.Vector3	行列の新しい Y 軸です。

戻り値

この関数は値を返しません。

set_z ( m, z ) 指定した行列の Z 軸を設定します。

パラメータ

m :	stingray.Matrix4x4	軸の値が設定される行列です。
z :	stingray.Vector3	行列の新しい Z 軸です。

戻り値

この関数は値を返しません。

to_elements ( m ) : number, number, number, number, number, number, number, number, number, number, number, number Matrix4x4 をその X、Y、Z 軸の方向とその移動に分解します。

パラメータ

m :

stingray.Matrix4x4

要素に分解する行列です。

戻り値

number	グローバル X 軸に沿ったローカル X 軸の大きさ。
number	グローバル Y 軸に沿ったローカル X 軸の大きさ。
number	グローバル Z 軸に沿ったローカル X 軸の大きさ。
number	グローバル X 軸に沿ったローカル Y 軸の大きさ。
number	グローバル Y 軸に沿ったローカル Y 軸の大きさ。
number	グローバル Z 軸に沿ったローカル Y 軸の大きさ。
number	グローバル X 軸に沿ったローカル Z 軸の大きさ。
number	グローバル Y 軸に沿ったローカル Z 軸の大きさ。
number	グローバル Z 軸に沿ったローカル Z 軸の大きさ。
number	グローバル X 軸に沿った移動。
number	グローバル Y 軸に沿った移動。
number	グローバル Z 軸に沿った移動。

to_string ( m ) : string 指定した行列の文字列表現を返します。

パラメータ

m :

stingray.Matrix4x4

文字列として返す行列です。

戻り値

string

文字列表現です。

この関数は、デバッグ目的にのみ使用します。

transform ( m, p ) : stingray.Vector3 指定した行列を使用して指定したポイントをトランスフォームします。

パラメータ

m :	stingray.Matrix4x4	トランスフォームに使用する行列です。
p :	stingray.Vector3	トランスフォームされる位置です。

戻り値

stingray.Vector3

行列によってトランスフォームされた後の新しい位置です。

関連サンプル コード

Appkit: /unit_controller.lua Oculus VR テンプレート: /project.lua

transform_without_translation ( m, v ) : stingray.Vector3 指定した行列を使用して、ベクトルを移動せずに指定したベクトルをトランスフォームします。

パラメータ

m :	stingray.Matrix4x4	トランスフォームに使用する行列です。
v :	stingray.Vector3	トランスフォームされるベクトルです。

戻り値

stingray.Vector3

行列によってトランスフォームされた後の新しい位置です。

この関数は、2 つの異なる座標系間で方向(位置ではなく)を移動する場合に便利です。

translation ( m ) : stingray.Vector3 行列の移動を取得します。

パラメータ

m :

stingray.Matrix4x4

移動が返される行列です。

戻り値

stingray.Vector3

行列の移動です。

関連サンプル コード

Oculus VR テンプレート: /project.lua Steam VR テンプレート: /project.lua

up ( m ) : stingray.Vector3 指定した行列の上(Z)軸を返します。

パラメータ

m :

stingray.Matrix4x4

軸の値が返される行列です。

戻り値

stingray.Vector3

行列の上軸です。

x ( m ) : stingray.Vector3 指定した行列の X 軸を返します。

パラメータ

m :

stingray.Matrix4x4

軸の値が返される行列です。

戻り値

stingray.Vector3

行列の X 軸です。

y ( m ) : stingray.Vector3 指定した行列の Y 軸を返します。

パラメータ

m :

stingray.Matrix4x4

軸の値が返される行列です。

戻り値

stingray.Vector3

行列の Y 軸です。

z ( m ) : stingray.Vector3 指定した行列の Z 軸を返します。

パラメータ

m :

stingray.Matrix4x4

軸の値が返される行列です。

戻り値

stingray.Vector3

行列の Z 軸です。

zero ( ) : stingray.Matrix4x4 すべてのフィールドが 0 (ゼロ)に初期化されたゼロ行列を返します。

パラメータ

この関数はパラメータを受け入れません。

戻り値

stingray.Matrix4x4

ゼロ行列です。