stingray.Quaternion 오브젝트 참조

설명

쿼터니언 공식(x, y, z, w)으로 회전을 나타냅니다.

이 오브젝트를 사용하려면 반드시 쿼터니언에 대해 잘 알아야 하는 것은 아닙니다. 그냥 회전의 불투명 표현 정도로 이해해도 다룰 수 있습니다.

참고: Quaternion 오브젝트는 임시 오브젝트로, 이 오브젝트가 생성된 프레임에서만 사용할 수 있습니다. Quaternion을 여러 프레임에 저장해야 한다면 대신 QuaternionBox를 사용하십시오. 자세한 내용은 오브젝트 수명 및 사용자 데이터 바인딩을 참조하십시오.

생성자 및 액세서

stingray.Actor.rotation() stingray.Camera.local_rotation() stingray.Camera.world_rotation() stingray.GoogleVR.controller_orientation() stingray.GwNavTagVolume.navtag() stingray.GwNavTraversal.get_triangle_navtag() stingray.GwNavWorld.database_triangle() stingray.HumanIK.character_get_effector_transform() stingray.HumanIK.character_get_node_transform() stingray.HumanIK.character_node_get_limits() stingray.HumanIK.creature_get_chain_effector_transform() stingray.HumanIK.creature_get_line_color() stingray.HumanIK.creature_get_marker_color() stingray.HumanIK.creature_get_section_effector_transform() stingray.Joint.d6_drive_position() stingray.LevelResource.unit_rotation() stingray.Light.local_rotation() stingray.Light.world_rotation() stingray.LODObject.local_rotation() stingray.LODObject.world_rotation() stingray.Matrix4x4.rotation() stingray.Mesh.local_rotation() stingray.Mesh.world_rotation() stingray.Quaternion() stingray.Quaternion.axis_angle() stingray.Quaternion.conjugate() stingray.Quaternion.from_elements() stingray.Quaternion.from_euler_angles_xyz() stingray.Quaternion.from_matrix4x4() stingray.Quaternion.identity() stingray.Quaternion.inverse() stingray.Quaternion.lerp() stingray.Quaternion.look() stingray.Quaternion.multiply() stingray.Quaternion.normalize() stingray.Quaternion.set_xyzw() stingray.QuaternionBox.unbox() stingray.SceneGraphComponent.local_rotation() stingray.SceneGraphComponent.world_rotation() stingray.SceneGraphNode.local_rotation() stingray.SceneGraphNode.world_rotation() stingray.Sensor.orientation_sensor_rotation() stingray.TransformComponent.local_rotation() stingray.TransformComponent.world_rotation() stingray.Unit.delta_rotation() stingray.Unit.local_rotation() stingray.Unit.world_rotation()

관련 샘플 코드

Appkit: /simple_project.lua Appkit: /unit_controller.lua 기본 템플릿: /player.lua 캐릭터 템플릿: /player.lua 차량 템플릿: /player.lua Oculus VR 템플릿: /flow_callbacks.lua Oculus VR 템플릿: /player.lua Oculus VR 템플릿: /project.lua Steam VR 템플릿: /flow_callbacks.lua Steam VR 템플릿: /player.lua

기타 관련 참조 항목

	stingray.QuaternionBox
	ps4_keyboard_options
	stingray.Actor.debug_draw() stingray.Actor.teleport_rotation() stingray.AnimationStateMachineComponent.set_constraint_target() stingray.Camera.set_local_rotation() stingray.EntityManager.spawn() stingray.GwNavBoxObstacle.create() stingray.GwNavCylinderObstacle.create() stingray.GwNavGeneration.set_current_navtag() stingray.GwNavGraph.create() stingray.GwNavTagVolume.create() stingray.GwNavWorld.visual_debug_draw_line() stingray.GwNavWorld.visual_debug_draw_text() stingray.Hololens.attach_entity() stingray.Hololens.create_anchor() stingray.Joint.set_d6_drive_position() stingray.Light.set_local_rotation() stingray.LODObject.set_local_rotation() stingray.Material.set_color() stingray.Material.set_vector4() stingray.Matrix4x4.from_quaternion() stingray.Matrix4x4.from_quaternion_position() stingray.Matrix4x4.set_rotation() stingray.Mesh.set_local_rotation() stingray.Oculus.set_tracking_space() stingray.PhysicsWorld.linear_capsule_sweep() stingray.PhysicsWorld.linear_obb_sweep() stingray.PhysicsWorld.overlap() stingray.Quaternion() stingray.QuaternionBox() stingray.QuaternionBox.store() stingray.ScatterSystem.make_observer() stingray.ScatterSystem.move_observer() stingray.ScatterSystem.spawn() stingray.SceneGraphComponent.set_local_rotation() stingray.SceneGraphNode.set_local_rotation() stingray.SteamVR.set_tracking_space() stingray.TransformComponent.link() stingray.TransformComponent.link_to_scene_graph() stingray.TransformComponent.set_local_rotation() stingray.Unit.animation_set_constraint_target() stingray.Unit.set_local_rotation() stingray.Unit.teleport_local_rotation() stingray.UnitSynchronizer.spawn_unit() stingray.VectorField.add() stingray.VectorField.change() stingray.World.create_particles() stingray.World.load_level() stingray.World.load_level_with_object_sets() stingray.World.move_particles() stingray.World.spawn_unit() stingray.WwiseWorld.make_auto_source() stingray.WwiseWorld.make_manual_source() stingray.WwiseWorld.trigger_event()
	Math

관련 도움말 항목

	릴리스 정보 > Stingray 1.3 릴리스 정보
	릴리스 정보 > Stingray 1.1 릴리스 정보
	게임 플레이 테스트 > 메모리 사용 최적화

함수

angle ( quat ) : number 이 쿼터니언으로 표현되는 회전 각도를 반환합니다.

매개변수

quat :

stingray.Quaternion

회전 각도를 반환할 쿼터니언입니다.

반환하는 항목

number

직면 방향을 기준으로 하는 쿼터니언 위쪽 벡터의 회전 각도(라디안)입니다.

axis_angle ( axis, angle ) : stingray.Quaternion 지정된 축을 기준으로 지정된 각도로 이루어지는 회전을 나타내는 새로운 쿼터니언을 생성합니다.

매개변수

axis :	stingray.Vector3	쿼터니언의 기본 축.
angle :	number	라디안으로 표현하는, 기본 축을 기준으로 한 각도.

반환하는 항목

stingray.Quaternion

새롭게 생성된 쿼터니언.

stingray.Quaternion()과 동일합니다.

관련 샘플 코드

절차적으로 메시 생성

conjugate ( quat ) : stingray.Quaternion 지정된 쿼터니언의 켤레를 반환합니다. 켤레는 X, Y 및 Z 값이 부정값이지만 W 구성요소가 변화 없이 유지되는 쿼터니언입니다.

매개변수

quat :

stingray.Quaternion

켤레를 반환할 쿼터니언입니다.

반환하는 항목

stingray.Quaternion

quat의 켤레입니다.

decompose ( quat ) : stingray.Vector3, number 지정된 쿼터니언을 직면 방향 및 회전 각도로 분해합니다.

매개변수

quat :

stingray.Quaternion

분해할 쿼터니언입니다.

반환하는 항목

stingray.Vector3	쿼터니언의 직면 방향을 정의하는 X, Y 및 Z 값입니다.
number	직면 방향을 기준으로 하는 쿼터니언 위쪽 벡터의 회전(라디안)입니다.

dot ( quat_a, quat_b ) : number 지정된 두 쿼터니언의 내적을 반환합니다.

매개변수

quat_a :	stingray.Quaternion	첫 번째 쿼터니언입니다.
quat_b :	stingray.Quaternion	두 번째 쿼터니언입니다.

반환하는 항목

number

내적입니다.

equal ( quat_a, quat_b ) : boolean 두 쿼터니언이 동일한지 여부를 나타냅니다.

매개변수

quat_a :	stingray.Quaternion	첫 번째 쿼터니언입니다.
quat_b :	stingray.Quaternion	두 번째 쿼터니언입니다.

반환하는 항목

boolean

두 쿼터니언의 모든 구성원이 동일하면 true를, 그렇지 않으면 false를 반환합니다.

forward ( quat ) : stingray.Vector3 지정된 쿼터니언으로 표현되는 회전의 앞쪽 축을 반환합니다.

매개변수

quat :

stingray.Quaternion

축을 검색할 쿼터니언입니다.

반환하는 항목

stingray.Vector3

쿼터니언 회전의 앞쪽 축입니다.

관련 샘플 코드

차량 템플릿: /vehicle_follow_cam.lua

from_elements ( x, y, z, w ) : stingray.Quaternion 지정된 요소들을 바탕으로 새로운 Quaternion을 생성합니다.

매개변수

x :	number	X 요소입니다.
y :	number	Y 요소입니다.
z :	number	Z 요소입니다.
w :	number	W 요소입니다.

반환하는 항목

stingray.Quaternion

새롭게 생성된 쿼터니언.

관련 샘플 코드

차량 템플릿: /vehicle_follow_cam.lua

from_euler_angles_xyz ( x, y, z ) : stingray.Quaternion 오일러 각도를 바탕으로 새로운 Quaternion을 생성합니다.

매개변수

x :	number	오일러 X축 회전(도)입니다.
y :	number	오일러 Y축 회전(도)입니다.
z :	number	오일러 Z축 회전(도)입니다.

반환하는 항목

stingray.Quaternion

새롭게 생성된 쿼터니언.

from_matrix4x4 ( matrix ) : stingray.Quaternion 지정된 매트릭스로 표현되는 회전으로부터 새로운 쿼터니언을 생성합니다.

매개변수

matrix :

stingray.Matrix4x4

추출하려는 회전을 포함하고 있는 매트릭스입니다.

반환하는 항목

stingray.Quaternion

새롭게 생성된 쿼터니언.

관련 샘플 코드

차량 템플릿: /vehicle_follow_cam.lua

identity ( ) : stingray.Quaternion 회전에서 변화가 없음을 나타내는 ID 쿼터니언을 반환합니다.

매개변수

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

반환하는 항목

stingray.Quaternion

ID 쿼터니언입니다.

관련 샘플 코드

기본 템플릿: /project.lua 캐릭터 템플릿: /project.lua 차량 템플릿: /project.lua Oculus VR 템플릿: /project.lua Steam VR 템플릿: /project.lua

inverse ( quat ) : stingray.Quaternion 지정된 쿼터니언을 반전하고, 결과를 반환합니다.

매개변수

quat :

stingray.Quaternion

반전할 쿼터니언입니다.

반환하는 항목

stingray.Quaternion

반전된 회전입니다.

관련 샘플 코드

차량 템플릿: /vehicle_follow_cam.lua

is_valid ( quat ) : boolean 쿼터니언이 전체적으로 유효한 값으로 구성되어 있는지 여부를 나타냅니다.

매개변수

quat :

stingray.Quaternion

테스트할 쿼터니언입니다.

반환하는 항목

boolean

쿼터니언의 모든 구성요소가 유효한 숫자이면 true를 반환하고, 어느 구성요소가 #NaN 또는 #INF인 경우 false를 반환합니다.

lerp ( quat_a, quat_b, t ) : stingray.Quaternion 지정된 두 쿼터니언 간 보간 또는 "선형 보간"을 통해 새 회전을 생성합니다.

매개변수

quat_a :	stingray.Quaternion	첫 번째 쿼터니언입니다.
quat_b :	stingray.Quaternion	두 번째 쿼터니언입니다.
t :	number	두 쿼터니언 간 비율 또는 보간 점입니다. 0에서 1 사이(두 값 포함)의 어떠한 값이든 될 수 있습니다. 값이 0에 가까우면 quat_a에 가까운 회전이 생성되고, 값이 1에 가까우면 quat_b에 가까운 회전이 생성됩니다.

반환하는 항목

stingray.Quaternion

결과로 생성된 쿼터니언입니다.

이 함수에 의해 수행되는 선형 보간은 표준화된 선형 보간, 또는 보통 최적의 결과를 내는 nlerp입니다.

관련 샘플 코드

차량 템플릿: /vehicle_follow_cam.lua

look ( dir, up ) : stingray.Quaternion 지정된 방향을 향하고, 지정된 위쪽 벡터를 포함하도록 하는 데 필요한 회전을 통해 새로운 쿼터니언을 생성합니다.

매개변수

dir :	stingray.Vector3	쿼터니언의 앞쪽 방향입니다.
up :	stingray.Vector3?	선택 사항입니다. 새로운 쿼터니언의 위쪽 벡터를 지정합니다. 생략하면 Z축의 양의 방향(0,0,1)이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

stingray.Quaternion

새롭게 생성된 쿼터니언.

matrix4x4 ( quat ) : stingray.Matrix4x4 지정된 쿼터니언으로 표현된 회전을 Matrix4x4로 변환합니다.

매개변수

quat :

stingray.Quaternion

변환할 쿼터니언입니다.

반환하는 항목

stingray.Matrix4x4

쿼터니언과 동일한 회전을 표현하는 Matrix4x4입니다.

multiply ( quat_a, quat_b ) : stingray.Quaternion 두 개의 지정된 쿼터니언을 곱해서, 그 결과를 반환합니다.

매개변수

quat_a :	stingray.Quaternion	첫 번째 쿼터니언입니다.
quat_b :	stingray.Quaternion	두 번째 쿼터니언입니다.

반환하는 항목

stingray.Quaternion

곱하기의 결과입니다.

이렇게 하면 먼저 quat_b로 오브젝트를 회전시키고, 그 다음 quat_a로 오브젝트를 회전시켜서 얻어지는 회전이 생성됩니다.

관련 샘플 코드

차량 템플릿: /vehicle_follow_cam.lua

norm ( quat ) : number 지정된 쿼터니언의 법선 또는 길이를 반환합니다.

매개변수

quat :

stingray.Quaternion

길이를 반환할 쿼터니언입니다.

반환하는 항목

number

쿼터니언의 길이입니다.

normalize ( quat ) : stingray.Quaternion 지정된 쿼터니언을 표준화하고, 결과를 반환합니다.

매개변수

quat :

stingray.Quaternion

표준화할 쿼터니언입니다.

반환하는 항목

stingray.Quaternion

표준화된 회전입니다.

right ( quat ) : stingray.Vector3 지정된 쿼터니언으로 표현되는 회전의 오른쪽 축을 반환합니다.

매개변수

quat :

stingray.Quaternion

축을 검색할 쿼터니언입니다.

반환하는 항목

stingray.Vector3

쿼터니언 회전의 오른쪽 축입니다.

rotate ( quat, vector ) : stingray.Vector3 지정된 벡터를 지정된 쿼터니언을 통해 회전하고, 그 결과를 반환합니다.

매개변수

quat :	stingray.Quaternion	벡터를 회전하는 데 사용할 쿼터니언입니다.
vector :	stingray.Vector3	회전할 벡터입니다.

반환하는 항목

stingray.Vector3

회전 후의 벡터입니다.

set_xyzw ( quat, x, y, z, w ) : stingray.Quaternion 지정된 쿼터니언의 모든 개별 구성요소 값을 개별 부동 소수점 값을 통해 설정합니다.

매개변수

quat :	stingray.Quaternion	설정할 쿼터니언입니다.
x :	number	쿼터니언 주 축에 대한 새로운 X 구성요소 값입니다.
y :	number	쿼터니언 주 축에 대한 새로운 Y 구성요소 값입니다.
z :	number	쿼터니언 주 축에 대한 새로운 Z 구성요소 값입니다.
w :	number	쿼터니언 주 축을 기준으로 하는 위쪽 벡터의 방향을 정의하는 새로운 W 구성요소 값입니다.

반환하는 항목

stingray.Quaternion

결과로 생성된 쿼터니언입니다.

to_elements ( quat ) : number, number, number, number 지정된 쿼터니언을 네 가지 구성요소 값으로 분해합니다.

매개변수

quat :

stingray.Quaternion

요소들로 분해할 쿼터니언입니다.

반환하는 항목

number	쿼터니언 축의 X 구성요소 값입니다.
number	쿼터니언 축의 Y 구성요소 값입니다.
number	쿼터니언 축의 Z 구성요소 값입니다.
number	쿼터니언 주 축을 기준으로 하는 로컬 위쪽 벡터의 회전을 나타내는 W 구성요소 값입니다.

to_euler_angles_xyz ( quat ) : number, number, number 쿼터니언 오일러 각도를 반환합니다.

매개변수

quat :

stingray.Quaternion

변환할 쿼터니언입니다.

반환하는 항목

number	오일러 X축 회전(도)입니다.
number	오일러 Y축 회전(도)입니다.
number	오일러 Z축 회전(도)입니다.

관련 샘플 코드

Oculus VR 템플릿: /project.lua

to_string ( quat ) : string 지정된 쿼터니언의 문자열 표현을 반환합니다.

매개변수

quat :

stingray.Quaternion

문자열로 반환할 쿼터니언입니다.

반환하는 항목

string

문자열 표현입니다.

이 함수는 디버깅 용도로만 사용하십시오.

up ( quat ) : stingray.Vector3 지정된 쿼터니언으로 표현되는 회전의 위쪽 축을 반환합니다.

매개변수

quat :

stingray.Quaternion

축을 검색할 쿼터니언입니다.

반환하는 항목

stingray.Vector3

쿼터니언 회전의 위쪽 축입니다.