런타임 게임 표준에 로드된 수준을 나타냅니다.
생성자 및 액세서
![]() | stingray.Application.flow_callback_context_level() stingray.Level.nested_levels() stingray.Unit.level() stingray.World.levels() stingray.World.load_level() stingray.World.load_level_with_object_sets() |
관련 샘플 코드
![]() | Appkit: /app.lua Appkit: /camera_wrapper.lua Appkit: /level_wrapper.lua 기본 템플릿: /player.lua Oculus VR 템플릿: /player.lua Steam VR 템플릿: /player.lua 최소 템플릿: /boot.lua |
기타 관련 참조 항목
관련 도움말 항목
![]() |
entities ( self ) : stingray.Entity[]![]() 수준 내 모든 엔티티가 포함된 테이블을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
수준 내 모든 엔티티가 포함된 테이블입니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다. |
![]() |
flow_variable ( self, name ) : any![]() 수준 흐름에서 지정된 이름을 가진 외부 출력 흐름 변수의 값을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
name : | string | 검색할 외부 흐름 변수의 이름입니다. |
any |
흐름 변수의 값입니다. 이 값의 유형은 지정된 이름과 일치하는 외부 출력 변수의 유형에 따라 달라집니다. |
이 함수는 **External > Output** 범주에서 찾을 수 있는 외부 변수 흐름 노드에서 작동합니다. 이 함수는 흐름 그래프에서만 설정하고 검색할 수 있는 Variables 범주에 있는 노드와는 관련이 없습니다.
참고: 편집기에 "My Unit"으로 표시되는 변수의 실제 이름은 "my_unit"입니다.
![]() |
get_data ( self, indices ) : any![]() 수준의 스크립트 데이터 오브젝트 내 지정된 색인에 설정되어 있는 데이터를 검색합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
indices : | any(integer, string)+ | 정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다. + 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
any |
이전에 지정된 색인 시퀀스에 저장된 데이터입니다. |
Unit.get_data()와 유사합니다.
기타 관련 참조 항목
![]() |
has_data ( self, indices ) : boolean![]() 수준의 스크립트 데이터 오브젝트 내 지정된 색인에 데이터가 저장되어 있는지 여부를 나타냅니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
indices : | any(integer, string)+ | 정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다. + 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
boolean |
데이터 값이 지정된 색인 시퀀스에 저장되어 있는 경우 true를, 그렇지 않으면 false를 반환합니다. |
Unit.has_data()와 유사합니다.
![]() |
has_volume ( self, volume_name ) : boolean![]() 수준에 지정된 이름의 볼륨이 있는지 여부를 나타냅니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
volume_name : | string | 뷸륨의 이름입니다. |
boolean |
수준에 지정된 볼륨이 있으면 true를, 그렇지 않으면 false를 반환합니다. |
![]() |
is_point_inside_volume ( self, volume_name, point ) : boolean![]() 점이 수준의 명명된 볼륨 내에 있는지 여부를 나타냅니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
volume_name : | string | 뷸륨의 이름입니다. |
point : | 테스트되는 점입니다. |
boolean |
점이 명명된 볼륨 내에 있으면 true를, 그렇지 않으면 false를 반환합니다. |
![]() |
navigation_mesh ( self ) : stingray.NavigationMesh![]() 수준에 대한 탐색 메시를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
수준의 탐색 메시입니다. |
기타 관련 참조 항목
![]() |
nested_levels ( self ) : stingray.Level[]![]() 지정된 수준 바로 아래에 중첩된 수준의 목록을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
중첩된 수준입니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다. |
기타 관련 참조 항목
![]() |
next_random_point_inside_volume ( self, volume_name, seed ) : integer, stingray.Vector3![]() 순수 임의 점 함수입니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
volume_name : | string | 뷸륨의 이름입니다. |
seed : | integer | 시드 매개변수입니다. |
integer |
생성된 새 시드입니다. |
명명된 볼륨 내 임의 점입니다. |
random_point_inside_volume()과 비슷하지만 시드 매개변수를 가지고, 임의 점과 함께 새 시드를 반환합니다. 보통, next_random_point_inside_volume()은 볼륨 내에 있는 재생성 가능한 임의 점 시퀀스를 쿼리할 때 사용됩니다.
![]() |
num_nested_levels ( self ) : integer![]() 수준 내에 중첩된 수준 수를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
integer |
중첩된 수준의 총 수입니다. |
![]() |
num_splines ( self ) : integer![]() 수준 내 스플라인 수를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
integer |
스플라인의 총 수입니다. |
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
표준에서 수준을 생성할 때 사용되는 변환입니다. |
![]() |
random_point_inside_volume ( self, volume_name ) : stingray.Vector3![]() 명명된 볼륨 내 임의 점의 표준-공간 위치를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
volume_name : | string | 뷸륨의 이름입니다. |
명명된 볼륨 내 임의 점입니다. |
기타 관련 참조 항목
![]() |
set_data ( self, indices, indices, indices, value ) set_data ( self, indices, indices, value ) set_data ( self, indices, value )![]() 지정된 색인으로 정해진 위치의 전역 스크립트 데이터 오브젝트에 지정된 값을 저장합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
indices : | any(integer, string) | 정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
value : | any | 저장할 값입니다. |
이 함수는 아무 값도 반환하지 않습니다. |
나중에 동일한 색인을 get_data() 호출에 전달하여 데이터를 검색할 수 있습니다. Unit.set_data()와 유사합니다.
![]() |
set_flow_variable ( self, name, value )![]() 수준 흐름에서 지정된 이름을 가진 외부 입력 흐름 변수의 값을 설정합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
name : | string | 설정할 외부 흐름 변수의 이름입니다. |
value : | any | 흐름 변수에 대해 설정할 새로운 값입니다. 이 값의 유형은 지정된 이름과 일치하는 외부 입력 변수의 유형에 따라 달라집니다. |
이 함수는 아무 값도 반환하지 않습니다. |
이 함수는 **External > Input** 범주에서 찾을 수 있는 외부 변수 흐름 노드에서 작동합니다. 이 함수는 흐름 그래프에서만 설정하고 검색할 수 있는 Variables 범주에 있는 노드와는 관련이 없습니다.
![]() |
spawn_background ( self )![]() 수준에 모든 배경 요소를 생성합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
이 함수는 아무 값도 반환하지 않습니다. |
배경 요소들은 보통 중첩 수준 또는 하위 수준을 생성할 때가 아닌 루트 수준을 생성할 때 장면에 추가하는 스카이박스 유닛 또는 기타 요소입니다. 이 함수를 호출하지 않는 경우에는 보통 배경 오브젝트가 수준 편집기에 표시되기 때문에 일부 렌더링 아티팩트가 포함된 검은색 하늘이 나타납니다.
![]() |
spline ( self, name ) : stingray.Vector3[]![]() 지정된 이름으로 된 베지어 스플라인에 대한 제어점을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
name : | string | 스플라인의 이름입니다. |
스플라인에 대한 제어점을 포함하고 있는 테이블, 또는 지정된 이름으로 된 스플라인이 없는 경우에는 빈 테이블을 반환합니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다. |
![]() |
spline_by_index ( self, index ) : stingray.Vector3[]![]() 지정된 색인의 베지어 스플라인에 대한 제어점을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
index : | integer | 수준 내 스플라인의 색인입니다. |
스플라인에 대한 제어점을 포함하고 있는 테이블, 또는 지정된 색인의 스플라인이 없는 경우에는 빈 테이블을 반환합니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다. |
![]() |
trigger_event ( self, event )![]() 수준 흐름 스크립트에서 외부 이벤트를 트리거합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
event : | string | 트리거할 외부 이벤트의 이름입니다. |
이 함수는 아무 값도 반환하지 않습니다. |
![]() |
trigger_level_loaded ( self )![]() 수준의 흐름 그래프에서 "수준 로드" 이벤트를 트리거합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
이 함수는 아무 값도 반환하지 않습니다. |
![]() |
trigger_level_shutdown ( self )![]() 수준의 흐름 그래프에서 "수준 종료" 이벤트를 트리거합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
이 함수는 아무 값도 반환하지 않습니다. |
![]() |
trigger_level_update ( self )![]() 수준의 흐름 그래프에서 "수준 업데이트" 이벤트를 트리거합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
이 함수는 아무 값도 반환하지 않습니다. |
![]() |
units ( self ) : stingray.Unit[]![]() 편집기에서 수준에 배치되었는데 수준을 로드한 이후 아직 생성되지 않은 모든 유닛의 목록을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
수준을 로드했을 때 생성된 나머지 유닛의 목록입니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다. |
이 목록을 가져온 후에 하나 이상의 유닛을 삭제한 경우에는 목록에 유효하지 않은 참조가 포함되므로 이 목록을 여러 프레임에 걸쳐 유지하지 마십시오. 유효한 참조로 이루어진 새로운 목록을 가져오려면 이 메서드를 다시 호출하십시오.
![]() |
unit_by_index ( self, index ) : stingray.Unit![]() 수준에서 지정된 색인의 유닛을 검색합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
index : | integer | 유닛의 색인입니다. |
색인에 해당하는 유닛을 반환하거나, 지정된 색인의 유닛이 없으면 nil을 반환합니다. |
보통 이 색인은 unit_index()를 통해 검색합니다.
기타 관련 참조 항목
![]() |
unit_index ( self, unit ) : integer?![]() 수준 내 유닛의 색인을 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
unit : | 수준 내 유닛입니다. |
integer? |
지정된 유닛의 색인을 반환하거나, 일치하는 유닛이 없으면 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다. |
unit_by_index()를 호출하여 색인을 유닛에게 다시 돌려보낼 수 있습니다. 예를 들어, 네트워크를 통해 다른 플레이어에게 유닛 ID를 전송할 때 이 방법을 사용할 수 있습니다.
참고: 이 함수는 수준에 정적으로 생성한 유닛에만 사용할 수 있으며, 스크립트 또는 흐름 노드를 통해 생성한 유닛에는 사용할 수 없습니다.
기타 관련 참조 항목
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오. |
수준이 생성된 표준입니다. |
관련 샘플 코드