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 두 매트릭스가 동일한지 여부를 나타냅니다.

매개변수

m1 :	stingray.Matrix4x4	첫 번째 매트릭스입니다.
m2 :	stingray.Matrix4x4	두 번째 매트릭스입니다.

반환하는 항목

boolean

두 매트릭스가 동일하면 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 변환과 회전이 모두 없는 오브젝트를 나타내는 ID 매트릭스를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Matrix4x4

ID 매트릭스입니다.

관련 샘플 코드

기본 템플릿: /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 지정된 두 매트릭스 간 보간 또는 "선형 보간"을 통해 새 매트릭스를 생성합니다.

매개변수

m1 :	stingray.Matrix4x4	첫 번째 매트릭스입니다.
m2 :	stingray.Matrix4x4	두 번째 매트릭스입니다.
t :	number	두 매트릭스 간 비율 또는 보간 점입니다. 0에서 1 사이(두 값 포함)의 어떠한 값이든 될 수 있습니다. 값이 0에 가까우면 m1에 가까운 매트릭스가 생성되고, 값이 1에 가까우면 m2에 가까운 매트릭스가 생성됩니다.

반환하는 항목

stingray.Matrix4x4

결과 매트릭스입니다.

이는 변환과 회전을 별도로 선형 보간하여 이루어집니다. 배율 등은 선형 보간되지 않습니다.

multiply ( m1, m2 ) : stingray.Matrix4x4 두 매트릭스를 곱합니다.

매개변수

m1 :	stingray.Matrix4x4	곱할 첫 번째 매트릭스입니다.
m2 :	stingray.Matrix4x4	곱할 두 번째 매트릭스입니다.

반환하는 항목

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 ) 지정된 매트릭스의 위쪽(X) 축을 설정합니다.

매개변수

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 벡터 변환(translating) 없이, 지정된 매트릭스를 사용하여 지정된 벡터를 변환(Transform)합니다.

매개변수

m :	stingray.Matrix4x4	변환에 사용할 매트릭스입니다.
v :	stingray.Vector3	변환할 벡터입니다.

반환하는 항목

stingray.Vector3

매트릭스에 의해 변환된 후의 새 위치입니다.

이 함수는 서로 다른 두 좌표계 사이에서 방향(위치 아님)을 변환할 때 유용할 수 있습니다.

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으로 초기화된 0 매트릭스를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Matrix4x4

0 매트릭스입니다.