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

stingray.GearVR 네임스페이스 참조

설명

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

함수

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

name :

string

레이어 이름입니다.

layer_rt :

string

레이어 렌더 대상 이름입니다.

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

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

매개변수

enabled :

boolean

활성화됨 상태 플래그입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

eye :

integer

쿼리할 눈(stingray.GearVR.EYE_LEFT 또는 stingray.GearVR.EYE_RIGHT)입니다.

반환하는 항목

table

눈 정보로 채워진 테이블입니다.

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

table

GearVR HMD 정보로 채워진 테이블입니다.

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

stingray.Matrix4x4

머리 로컬 포즈입니다.

stingray.Matrix4x4

왼쪽 눈 로컬 포즈입니다.

stingray.Matrix4x4

오른쪽 눈 로컬 포즈입니다.

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

stingray.Matrix4x4

머리 표준 포즈입니다.

stingray.Matrix4x4

왼쪽 눈 표준 포즈입니다.

stingray.Matrix4x4

오른쪽 눈 표준 포즈입니다.

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

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

boolean

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

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

gearvr_mobile_options

모바일 옵션의 현재 값이 포함된 테이블. 이 테이블의 필드 및 유형에 대한 자세한 내용은 gearvr_mobile_options를 참조하십시오.

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

table

GearVR Configuration Utility를 사용하여 설정된 현재 프로필 데이터로 채워진 테이블입니다.

보다 구체적으로는 플레이어 키, 눈 높이, 동공 간 거리, 목-눈 간 거리(미터)를 반환합니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

name :

string

레이어 이름입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

left_eye_rt :

string

왼쪽 눈 렌더 대상 이름입니다.

right_eye_rt :

string

오른쪽 눈 렌더 대상 이름입니다.

left_eye_fov_left :

number

왼쪽 눈 왼쪽 절두체 각도입니다.

left_eye_fov_right :

number

왼쪽 눈 오른쪽 절두체 각도입니다.

left_eye_fov_down :

number

왼쪽 눈 아래쪽 절두체 각도입니다.

left_eye_fov_up :

number

왼쪽 눈 위쪽 절두체 각도입니다.

right_eye_fov_left :

number

오른쪽 눈 왼쪽 절두체 각도입니다.

right_eye_fov_right :

number

오른쪽 눈 오른쪽 절두체 각도입니다.

right_eye_fov_down :

number

오른쪽 눈 아래쪽 절두체 각도입니다.

right_eye_fov_up :

number

오른쪽 눈 위쪽 절두체 각도입니다.

flags :

integer?

플래그를 설정합니다(선택 사항).

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

name :

string

고품질 렌더 경로로 설정할 레이어의 이름입니다.

hq_enabled :

boolean

레이어가 고품질 렌더 경로를 사용해야 할지 여부입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

name :

string

업데이트할 레이어의 이름입니다.

width :

number

레이어 쿼드의 폭입니다(단위: 미터).

height :

number

레이어 쿼드의 높이입니다(단위: 미터).

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

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

매개변수

name :

string

업데이트할 레이어의 이름입니다.

pose :

stingray.Matrix4x4

레이어 중심 포즈입니다.

headlocked :

boolean

레이어 포즈가 HMD(헤드 고정) 또는 추적 원점을 기준으로 하는지 여부입니다.

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

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

매개변수

name :

string

레이어의 이름입니다.

visible :

boolean

이 레이어의 표시 여부입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

options :

gearvr_mobile_options?

설정하려는 옵션과 값이 포함된 테이블입니다. 이 테이블의 필드 및 유형에 대한 자세한 내용은 gearvr_mobile_options를 참조하십시오.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

[stingray.GearVR.setup()] 전에 이 함수를 호출합니다.

매개변수

pose :

stingray.Matrix4x4

추적 공간 포즈입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

boolean

장치 세션이 유효한 경우 true입니다. 데스크탑에서는 GearVR.initialize 이후에, 모바일에서는 GearVR.enable 이후에 수행됩니다.

추가 대기 모드

이러한 모드는 GearVR Mobile SDK의 프레임 매개변수로 사용됩니다.

set_mobile_options()에 전달하는 테이블의 extra_latency_mode 필드에서 이러한 모드를 설정할 수 있습니다. 예:

local settings = { extra_latency_mode = stingray.GearVR.EXTRA_LATENCY_OFF }
stingray.GearVR.set_mobile_options(settings)
VRAPI_EXTRA_LATENCY_MODE_DYNAMIC
VRAPI_EXTRA_LATENCY_MODE_ON