설명

이 오브젝트는 SteamVR 인터페이스에 대한 액세스를 제공합니다.

기타 관련 참조 항목

함수

clear_all_tracker_node_links ( )

SteamVR.link_node_to_tracker를 사용해 만든 추적기 노드 링크를 모두 지웁니다.

매개변수

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

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

clear_layers ( )

모든 레이어를 지웁니다.

매개변수

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

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

controller_held ( controller, button ) : boolean

지정된 버튼이 주어진 제어기의 프레임에서 유지되는지 여부에 따라 true 또는 false를 반환합니다.

매개변수

controller :	integer	제어기 색인
button :	integer	Controller button [SteamVR.BUTTON_SYSTEM, SteamVR.BUTTON_MENU, SteamVR.BUTTON_GRIP, SteamVR.BUTTON_TOUCH and SteamVR.BUTTON_TRIGGER SteamVR.BUTTON_TOUCH_UP, SteamVR.BUTTON_TOUCH_DOWN, SteamVR.BUTTON_TOUCH_LEFT, SteamVR.BUTTON_TOUCH_RIGHT]

반환하는 항목

boolean

지정된 버튼이 제어기에서 유지되면 true를, 그렇지 않은 경우 false를 반환합니다.

controller_local_pose ( index ) : stingray.Matrix4x4

지정된 컨트롤러의 로컬 포즈를 반환합니다.

매개변수

index :

integer

제어기 색인

반환하는 항목

stingray.Matrix4x4

컨트롤러의 로컬 포즈

컨트롤러가 추적되지 않는 경우에는 ID 매트릭스가 반환됩니다.

controller_pressed ( controller, button ) : boolean

지정된 버튼이 주어진 제어기의 프레임에서 눌러진 상태인지 여부에 따라 true 또는 false를 반환합니다.

매개변수

controller :	integer	제어기 색인
button :	integer	Controller button [SteamVR.BUTTON_SYSTEM, SteamVR.BUTTON_MENU, SteamVR.BUTTON_GRIP, SteamVR.BUTTON_TOUCH and SteamVR.BUTTON_TRIGGER SteamVR.BUTTON_TOUCH_UP, SteamVR.BUTTON_TOUCH_DOWN, SteamVR.BUTTON_TOUCH_LEFT, SteamVR.BUTTON_TOUCH_RIGHT]

반환하는 항목

boolean

지정된 버튼이 제어기에서 눌러진 상태이면 true를, 그렇지 않은 경우 false를 반환합니다.

controller_pulse ( index, seconds )

지정된 컨트롤러에서 촉각 펄스를 트리거합니다.

매개변수

index :	integer	제어기 색인
seconds :	number	펄스 지속 시간(초), 최대 펄스 길이는 0.003999초입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

진동을 발생시킬 모든 프레임에서 이 함수를 호출해야 합니다. 이 함수에 제공된 펄스 지속 시간은 사실상 진동 강도입니다.

controller_released ( controller, button ) : boolean

지정된 버튼이 주어진 제어기의 프레임에서 눌렀다 놓은 상태인지 여부에 따라 true 또는 false를 반환합니다.

매개변수

controller :	integer	제어기 색인
button :	integer	Controller button [SteamVR.BUTTON_SYSTEM, SteamVR.BUTTON_MENU, SteamVR.BUTTON_GRIP, SteamVR.BUTTON_TOUCH and SteamVR.BUTTON_TRIGGER SteamVR.BUTTON_TOUCH_UP, SteamVR.BUTTON_TOUCH_DOWN, SteamVR.BUTTON_TOUCH_LEFT, SteamVR.BUTTON_TOUCH_RIGHT]

반환하는 항목

boolean

지정된 버튼이 제어기에서 눌렀다 놓은 상태이면 true를, 그렇지 않은 경우 false를 반환합니다.

controller_setup ( unit, root, material )

형상 버퍼를 채우고 지정된 재질을 적용하여 컨트롤러 메시를 설정하고 생성합니다.

매개변수

unit :	stingray.Unit	제어기 유닛
root :	string	형상 루트의 이름
material :	string	재질의 이름

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

controller_touched ( controller, button ) : boolean

지정된 버튼이 주어진 제어기의 프레임에서 터치된 상태인지 여부에 따라 true 또는 false를 반환합니다.

매개변수

controller :	integer	제어기 색인
button :	integer	Controller button [SteamVR.BUTTON_SYSTEM, SteamVR.BUTTON_MENU, SteamVR.BUTTON_GRIP, SteamVR.BUTTON_TOUCH and SteamVR.BUTTON_TRIGGER SteamVR.BUTTON_TOUCH_UP, SteamVR.BUTTON_TOUCH_DOWN, SteamVR.BUTTON_TOUCH_LEFT, SteamVR.BUTTON_TOUCH_RIGHT]

반환하는 항목

boolean

지정된 버튼이 제어기에서 터치된 상태이면 true를, 그렇지 않은 경우 false를 반환합니다.

현재, SteamVR.BUTTON_TOUCH에만 이러한 이벤트가 있습니다. 다른 버튼이 요청되면 false가 반환됩니다.

controller_untouched ( controller, button ) : boolean

지정된 버튼이 주어진 제어기의 프레임에서 터치되지 않은 상태인지 여부에 따라 true 또는 false를 반환합니다.

매개변수

controller :	integer	제어기 색인
button :	integer	Controller button [SteamVR.BUTTON_SYSTEM, SteamVR.BUTTON_MENU, SteamVR.BUTTON_GRIP, SteamVR.BUTTON_TOUCH and SteamVR.BUTTON_TRIGGER SteamVR.BUTTON_TOUCH_UP, SteamVR.BUTTON_TOUCH_DOWN, SteamVR.BUTTON_TOUCH_LEFT, SteamVR.BUTTON_TOUCH_RIGHT]

반환하는 항목

boolean

지정된 버튼이 제어기에서 터치되지 않은 상태이면 true를, 그렇지 않은 경우 false를 반환합니다.

현재, SteamVR.BUTTON_TOUCH에만 이러한 이벤트가 있습니다. 다른 버튼이 요청되면 false가 반환됩니다.

controller_value ( controller, button ) : number, number

지정된 제어기 버튼의 아날로그 값을 반환합니다.

매개변수

controller :	integer	제어기 색인
button :	integer	Controller button [SteamVR.BUTTON_SYSTEM, SteamVR.BUTTON_MENU, SteamVR.BUTTON_GRIP, SteamVR.BUTTON_TOUCH and SteamVR.BUTTON_TRIGGER SteamVR.BUTTON_TOUCH_UP, SteamVR.BUTTON_TOUCH_DOWN, SteamVR.BUTTON_TOUCH_LEFT, SteamVR.BUTTON_TOUCH_RIGHT]

반환하는 항목

number	지정된 제어기 버튼의 첫 번째 아날로그 값입니다. 사용되지 않는 경우 0.0이 반환됩니다.
number	지정된 제어기 버튼의 두 번째 아날로그 값입니다. 사용되지 않는 경우 0.0이 반환됩니다.

SteamVR.BUTTON_TOUCH가 요청되면 x 및 y 아날로그 위치가 반환됩니다. 그렇지 않은 경우 다른 모든 버튼의 첫 번째 값에는 아날로그 값(0~1 사이에서 변함)이 포함되고 두 번째 값은 항상 0입니다.

controller_world_pose ( index ) : stingray.Matrix4x4

지정된 컨트롤러의 표준 포즈를 반환합니다.

매개변수

index :

integer

제어기 색인

반환하는 항목

stingray.Matrix4x4

컨트롤러의 표준 포즈

컨트롤러가 추적되지 않는 경우에는 ID 매트릭스가 반환됩니다.

create_layer ( name, layer_rt )

가상 세계에서 주어진 포즈 및 크기의 직사각형으로 표시되는 모노스코픽 이미지를 생성합니다.

매개변수

name :	string	레이어 이름입니다.
layer_rt :	string	레이어 렌더 대상 이름입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

헤드업 디스플레이, 텍스트 정보, 오브젝트 레이블 등에 유용합니다.

fade_to_color ( color, seconds )

HMD의 뷰를 지정된 색상으로 페이드합니다.

매개변수

color :	color	페이드 인/아웃 색상
seconds :	number	페이드 인/아웃 시간

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

이 색상은 color 매개변수에 전달하여 색상 오브젝트를 생성할 때 stingray.Color()에 전달하는 알파 매개변수를 기반으로 한 장면 위에서 페이드됩니다. 이 함수에서는 해당 알파 값이 첫 번째 매개변수여야 합니다.

예를 들어, 페이드 색상을 즉시 제거하려면 시간을 0초로 하여 완전히 투명한 색상으로 "페이드" 처리하면 됩니다.

stingray.SteamVR.fade_to_color(stingray.Color(0, 0, 0, 0), 0)

2초 안에 반투명 파란색으로 페이드 처리하는 방법:

stingray.SteamVR.fade_to_color(stingray.Color(127, 0, 0, 255), 2) -- Alpha = 127, Blue = 255

또는, 5초 안에 완전한 불투명 하얀색을 페이드 인 처리하는 방법:

stingray.SteamVR.fade_to_color(stingray.Color(255, 255, 255, 255), 5)

hmd_local_pose ( ) : stingray.Matrix4x4, stingray.Matrix4x4, stingray.Matrix4x4

HMD의 머리, 왼쪽 눈 및 오른쪽 눈 로컬 포즈를 반환합니다.

매개변수

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

반환하는 항목

stingray.Matrix4x4	머리 로컬 포즈입니다.
stingray.Matrix4x4	왼쪽 눈 로컬 포즈입니다.
stingray.Matrix4x4	오른쪽 눈 로컬 포즈입니다.

추적되지 않는 경우 ID 매트릭스가 반환됩니다.

hmd_world_pose ( ) : stingray.Matrix4x4, stingray.Matrix4x4, stingray.Matrix4x4

HMD의 머리, 왼쪽 눈 및 오른쪽 눈 표준 포즈를 반환합니다.

매개변수

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

반환하는 항목

stingray.Matrix4x4	머리 표준 포즈입니다.
stingray.Matrix4x4	왼쪽 눈 표준 포즈입니다.
stingray.Matrix4x4	오른쪽 눈 표준 포즈입니다.

추적되지 않는 경우 ID 매트릭스가 반환됩니다.

initialize ( render_target, camera, world, flags ) : boolean

SteamVR 시스템을 초기화합니다.

매개변수

render_target :	string	스테레오 렌더 대상 이름입니다.
camera :	stingray.Camera	스테레오 렌더링에 사용되는 카메라입니다.
world :	stingray.World	카메라가 포함된 표준입니다.
flags :	integer?	선택 사항입니다. 초기화 플래그입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

boolean

SteamVR이 올바로 초기화되었으면 true를, 그렇지 않으면 false를 반환합니다.

is_hmd_tracked ( index ) : boolean

지정된 컨트롤러의 추적 여부를 반환합니다.

매개변수

index :

integer

제어기 색인

반환하는 항목

boolean

지정된 색인의 컨트롤러를 현재 추적 중이면 true를, 그렇지 않으면 false를 반환합니다.

is_hmd_tracked ( ) : boolean

HMD의 추적 여부를 반환합니다.

매개변수

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

반환하는 항목

boolean

HMD를 현재 추적 중이면 true를, 그렇지 않으면 false를 반환합니다.

link_node_to_tracker ( unit, node, world, type, index )

VR 추적기에 의해 자동으로 업데이트되어야 하는 유닛 노드를 링크합니다.

매개변수

unit :	stingray.Unit	추적기에 링크할 유닛입니다.
node :	integer	유닛 내에 링크된 장면 그래프 노드입니다.
world :	stingray.World	유닛을 포함하고 있는 표준입니다.
type :	integer	추적기 링크의 유형(SteamVR.LINK_HMD 또는 SteamVR.LINK_CONTROLLER)
index :	integer?	SteamVR.LINK_HMD를 사용할 때의 선택적 인덱스(SteamVR.EYE_LEFT 또는 SteamVR.EYE_RIGHT, 인덱스를 생략하면 HMD에 대한 링크가 간소화됨) 또는 컨트롤러 인덱스 ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

remove_layer ( name )

지정된 레이어를 제거합니다.

매개변수

name :

string

레이어 이름입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_camera ( camera, world )

SteamVR에 대해 새 카메라를 설정합니다.

매개변수

camera :	stingray.Camera	스테레오 렌더링에 사용되는 카메라입니다.
world :	stingray.World	카메라가 포함된 표준입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

이 기능은 게임에서 새 표준을 생성하고 VR에서 이 표준으로 전환하려는 경우 유용합니다.

set_high_quality_layer ( name, hq_enabled, curved, min_curve, max_curve )

레이어가 고품질 렌더 경로를 사용해야 하는지 여부와 활성화해야 하는 고품질 옵션을 지정합니다.

매개변수

name :	string	고품질 렌더 경로로 설정할 레이어의 이름입니다.
hq_enabled :	boolean	레이어가 고품질 렌더 경로를 사용해야 할지 여부입니다.
curved :	boolean?	선택 사항입니다. (고품질 렌더링 시에만) 레이어를 구부릴지 여부입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
min_curve :	number?	선택 사항입니다. 레이어가 가장 크게 구부러질 거리입니다(단위: m). ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
max_curve :	number?	선택 사항입니다. 레이어가 가장 적게 구부러질 거리입니다(단위: m). ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

한 번에 하나의 고품질 레이어만 지원됩니다.

set_layer_dimensions ( name, width )

레이어 쿼드의 폭을 m 단위로 설정합니다.

매개변수

name :	string	업데이트할 레이어의 이름입니다.
width :	number	레이어 쿼드의 폭입니다(단위: 미터).

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

기본적으로 레이어는 폭이 1m인 쿼드에서 렌더링됩니다.

set_layer_pose ( name, pose, headlocked )

레이어 포즈를 설정합니다.

매개변수

name :	string	업데이트할 레이어의 이름입니다.
pose :	stingray.Matrix4x4	레이어 중심 포즈입니다.
headlocked :	boolean	레이어 포즈가 HMD(헤드 고정)를 기준으로 하는지 또는 표준 공간에 있는지 여부입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

기본적으로 포즈는 HMD의 0.5m 앞에서 헤드가 고정됩니다.

set_layer_visibility ( name, visible )

레이어가 표시되거나 숨겨져야 하는지 여부를 지정합니다.

매개변수

name :	string	레이어의 이름입니다.
visible :	boolean	이 레이어의 표시 여부입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_tracking_space ( position, rotation, scale )

추적 공간 포즈 설정

매개변수

position :	stingray.Vector3	추적 공간 위치
rotation :	stingray.Quaternion	추적 공간 회전
scale :	stingray.Vector3	추적 공간 배율

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_tracking_space_pose ( pose )

제공된 포즈를 기본 추적 공간 포즈로 설정합니다. 더 이상 사용되지 않습니다. 대신 SteamVR.set_tracking_space(Vector3, Quaternion, Vector3)를 사용하십시오.

매개변수

pose :

stingray.Matrix4x4

추적 공간 포즈입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

shutdown ( )

SteamVR 시스템을 종료합니다.

매개변수

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

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

tracking_space_local_rectangle ( ) : stingray.Vector3, stingray.Vector3, stingray.Vector3, stingray.Vector3

추적 공간의 로컬 공간 직사각형 구석을 반환합니다.

매개변수

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

반환하는 항목

stingray.Vector3	구석 1의 로컬 위치입니다.
stingray.Vector3	구석 2의 로컬 위치입니다.
stingray.Vector3	구석 3의 로컬 위치입니다.
stingray.Vector3	구석 4의 로컬 위치입니다.

구석은 반시계 방향 순서로, 서기 중심(0,0,0)은 추적 공간의 중심입니다. 바닥 위 로컬 공간에서 각 구석의 z 값은 0입니다.

tracking_space_pose ( ) : stingray.Matrix4x4

추적 공간 포즈를 반환합니다.

매개변수

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

반환하는 항목

stingray.Matrix4x4

추적 공간 포즈입니다.

tracking_space_scale ( ) : stingray.Vector3

추적 공간 배율을 반환합니다.

매개변수

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

반환하는 항목

stingray.Vector3

추적 공간 배율

tracking_space_size ( ) : number, number

추적 공간의 크기(폭, 깊이)를 반환합니다.

매개변수

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

반환하는 항목

number	추적 공간의 폭입니다.
number	추적 공간의 깊이입니다.

tracking_space_world_rectangle ( ) : stingray.Vector3, stingray.Vector3, stingray.Vector3, stingray.Vector3

추적 공간의 표준 공간 직사각형 구석을 반환합니다.

매개변수

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

반환하는 항목

stingray.Vector3	구석 1의 표준 위치입니다.
stingray.Vector3	구석 2의 표준 위치입니다.
stingray.Vector3	구석 3의 표준 위치입니다.
stingray.Vector3	구석 4의 표준 위치입니다.

구석은 반시계 방향 순으로, 정의된 추적 공간 포즈를 중심으로 합니다.

unlink_node_from_tracker ( unit, node )

VR 추적기에 의해 자동으로 업데이트되는 유닛 노드를 링크 해제합니다.

매개변수

unit :	stingray.Unit	VR 추적기로부터 링크 해제하는 유닛
node :	integer	링크 해제될 유닛 내 장면 그래프 노드

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

SteamVR - stingray.SteamVR 네임스페이스 참조 - Stingray Lua API 참조

설명

함수

clear_all_tracker_node_links ( )

clear_layers ( )

controller_held ( controller, button ) : boolean

controller_local_pose ( index ) : stingray.Matrix4x4

controller_pressed ( controller, button ) : boolean

controller_pulse ( index, seconds )

controller_released ( controller, button ) : boolean

controller_setup ( unit, root, material )

controller_touched ( controller, button ) : boolean

controller_untouched ( controller, button ) : boolean

controller_value ( controller, button ) : number, number

controller_world_pose ( index ) : stingray.Matrix4x4

create_layer ( name, layer_rt )

fade_to_color ( color, seconds )

hmd_local_pose ( ) : stingray.Matrix4x4, stingray.Matrix4x4, stingray.Matrix4x4

hmd_world_pose ( ) : stingray.Matrix4x4, stingray.Matrix4x4, stingray.Matrix4x4

initialize ( render_target, camera, world, flags ) : boolean

is_hmd_tracked ( index ) : boolean

is_hmd_tracked ( ) : boolean

link_node_to_tracker ( unit, node, world, type, index )

remove_layer ( name )

set_camera ( camera, world )

set_high_quality_layer ( name, hq_enabled, curved, min_curve, max_curve )

set_layer_dimensions ( name, width )

set_layer_pose ( name, pose, headlocked )

set_layer_visibility ( name, visible )

set_tracking_space ( position, rotation, scale )

set_tracking_space_pose ( pose )

shutdown ( )

tracking_space_local_rectangle ( ) : stingray.Vector3, stingray.Vector3, stingray.Vector3, stingray.Vector3

tracking_space_pose ( ) : stingray.Matrix4x4

tracking_space_scale ( ) : stingray.Vector3

tracking_space_size ( ) : number, number

tracking_space_world_rectangle ( ) : stingray.Vector3, stingray.Vector3, stingray.Vector3, stingray.Vector3

unlink_node_from_tracker ( unit, node )