stingray.GwNavQueries 네임스페이스 참조

설명

NavMesh에 대해 수행할 수 있는 다양한 작업(예: 광선 투사)에 대한 액세스를 제공합니다.

기타 관련 참조 항목

Gameware Navigation

관련 도움말 항목

게임플레이 생성 > AI 및 경로 찾기 > Navigation 쿼리

함수

destroy_query_dynamic_output ( query_output ) 쿼리를 통해 생성된 GwNavQueryDynamicOutput을 삭제합니다.

매개변수

query_output :

stingray.GwNavQueryDynamicOutput

삭제하려는 GwNavQueryDynamicOutput 오브젝트입니다.

반환하는 항목

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

destroy_query_dynamic_output을 호출하면 NavQueryDynamicOutput을 통해 액세스하는 모든 오브젝트가 삭제됩니다.

기타 관련 참조 항목

stingray.GwNavQueries.tag_volumes_from_position()

diskcango ( database_or_world, A, B, radius, logic ) : boolean A에서 B로 NavMesh 표면을 따라 디스크를 투사합니다. 디스크가 B에 성공적으로 도달하면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
A :	stingray.Vector3	시작하려는 중심 위치입니다.
B :	stingray.Vector3	투사가 도달하는 중심 위치입니다.
radius :	number	디스크 반지름입니다.
logic :	stingray.GwNavTraverseLogicData?	이 쿼리에 사용할 GwNavTraverseLogicData입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

boolean

디스크가 성공적으로 도달하면 true입니다.

diskcast ( database_or_world, A, radius, normalized_move_2d, distance, logic ) : boolean, stingray.Vector3, stingray.Vector3 NavMesh 표면에서 normalized_move_2d 방향 및 지정된 거리를 따라 A에서 디스크를 투사합니다. 디스크가 전체 거리를 성공적으로 이동하면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
A :	stingray.Vector3	시작하려는 중심 위치입니다.
radius :	number	디스크 반지름입니다.
normalized_move_2d :	stingray.Vector2	디스크를 투사하는 방향입니다.
distance :	number	투사 거리입니다.
logic :	stingray.GwNavTraverseLogicData?	이 쿼리에 사용할 GwNavTraverseLogicData입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

boolean	디스크가 지정된 거리로 성공적으로 이동한 경우 true입니다.
stingray.Vector3	투사가 도달할 때 디스크의 중심 위치입니다.
stingray.Vector3	디스크가 충돌한 경우 디스크의 충돌 위치입니다.

또한 마지막 유효 중심 위치와 충돌 위치도 반환합니다(있는 경우).

inside_position_from_outside_position ( database_or_world, position, above_dist, below_dist, horizontal_dist, distance_from_obstacle, logic ) : stingray.Vector3? NavMesh 외부 위치에서 NavMesh 내부 위치를 찾습니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
position :	stingray.Vector3	NavMesh 외부의 위치입니다.
above_dist :	number?	검색하려는 위치 위의 거리(미터)입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
below_dist :	number?	검색하려는 위치 아래의 거리(미터)입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
horizontal_dist :	number?	검색하려는 위치로부터의 수평 거리(미터)입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
distance_from_obstacle :	number?	Navmesh의 경계로부터 점을 이동할 거리입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
logic :	stingray.GwNavTraverseLogicData?	이 쿼리에 사용할 GwNavTraverseLogicData입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

stingray.Vector3?

NavMesh 내에서 아무 위치도 발견되지 않으면 nil입니다. 그렇지 않으면 해당 위치 자체입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

move_on_navmesh ( database_or_world, position, velocity, delta_time, logic ) : stingray.Vector3 NavMesh에 안전하게 배치된 유효한 위치를 출력합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
position :	stingray.Vector3	시작하려는 위치입니다.
velocity :	stingray.Vector3	이동하려는 속도입니다.
delta_time :	number	마지막 프레임 이후의 델타 시간(초)입니다.
logic :	stingray.GwNavTraverseLogicData?	이 쿼리에 사용할 GwNavTraverseLogicData입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

stingray.Vector3

NavMesh에서의 위치입니다.

아무 위치도 찾을 수 없는 경우에는 입력 위치가 반환됩니다. 일반적으로 물리적 요소 없는 무언가를 이동하는 데 유용합니다.

nav_tag_volume ( query_output, index ) : stingray.GwNavTagVolume 지정된 색인이 있는 GwNavTagVolume을 검색합니다.

매개변수

query_output :	stingray.GwNavQueryDynamicOutput	해당 TagVolume을 검색하려는 GwNavQueryDynamicOutput 오브젝트입니다.
index :	integer	검색하려는 TagVolume의 색인입니다.

반환하는 항목

stingray.GwNavTagVolume

지정된 색인이 있는 TagVolume입니다.

NavQueryDynamicOutput.destroy()를 호출하면 이 GwNavTagVolume이 삭제될 수 있습니다.

nav_tag_volume_count ( query_output ) : integer 쿼리에 의해 반환되는 TagVolume 수를 제공합니다.

매개변수

query_output :

stingray.GwNavQueryDynamicOutput

해당 TagVolume을 테스트하려는 GwNavQueryDynamicOutput 오브젝트입니다.

반환하는 항목

integer

쿼리를 통해 발견된 TagVolume 수입니다.

raycango ( database_or_world, A, B, logic ) : boolean A에서 B로 NavMesh 표면을 따라 광선을 투사합니다. 광선이 B에 성공적으로 도달하면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
A :	stingray.Vector3	시작하려는 위치입니다.
B :	stingray.Vector3	투사가 도달하는 위치입니다.
logic :	stingray.GwNavTraverseLogicData?	이 쿼리에 사용할 GwNavTraverseLogicData입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

boolean

광선이 성공적으로 도달하면 true입니다.

raycast ( database_or_world, A, move_2d, logic ) : boolean, stingray.Vector3 NavMesh 표면에서 move_2d 방향 및 거리를 따라 A에서 광선을 투사합니다. 광선이 move_2d의 전체 길이를 성공적으로 이동하면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
A :	stingray.Vector3	광선이 시작되는 위치입니다.
move_2d :	stingray.Vector2	투사할 2D 상대 이동입니다.
logic :	stingray.GwNavTraverseLogicData?	이 쿼리에 사용할 GwNavTraverseLogicData입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

boolean	광선이 지정된 거리로 성공적으로 이동한 경우 true입니다.
stingray.Vector3	광선의 경로에 놓여, 광선이 닿는 위치(닿는 곳이 없으면 끝점)입니다.

광선의 경로에 놓인 마지막 유효한 위치도 반환합니다.

raycast_full_3d ( database_or_world, A, B ) : boolean, stingray.Vector3 NavMesh 표면이 아닌 3d에서 A에서 B로 광선을 투사합니다. 광선이 B에 성공적으로 도달하면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
A :	stingray.Vector3	광선이 시작되는 위치입니다.
B :	stingray.Vector3	광선이 끝나는 위치입니다.

반환하는 항목

boolean	광선이 성공적으로 b에 도달하면 true입니다.
stingray.Vector3	광선의 경로에 놓여, 광선이 닿는 위치(닿는 곳이 없으면 끝점)입니다.

광선의 경로에 놓인 마지막 유효한 위치도 반환합니다.

tag_volumes_from_position ( database_or_world, position, above, below ) : stingray.GwNavQueryDynamicOutput? NavMesh 내 한 위치에서 TagVolume을 검색합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
position :	stingray.Vector3	NavMesh 외부의 위치입니다.
above :	number?	검색하려는 위치의 상한(미터)입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
below :	number?	검색하려는 위치의 하한(미터)입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

stingray.GwNavQueryDynamicOutput?

nil이거나, 사용자가 stingray.GwNavQueries.destroy_query_dynamic_output을 사용하여 삭제해야 하는 tagvolume이 하나 이상 있는 경우에는 새로 생성된 GwNavQueryDynamicOutput입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

triangle_from_position ( database_or_world, position, above, below ) : number?, stingray.Vector3?, stingray.Vector3?, stingray.Vector3? 지정된 위치에서 NavMesh 내부의 삼각형을 검색합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	쿼리를 실행할 GwNavDatabase입니다. GwNavWorld이면 기본 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
position :	stingray.Vector3	검색하려는 위치입니다.
above :	number	검색하려는 위치의 상한(미터)입니다.
below :	number	검색하려는 위치의 하한(미터)입니다.

반환하는 항목

number?	삼각형이 발견되는 경우, 입력 위치에서 삼각형 평면으로의 투영 고도를 표시합니다. 그렇지 않으면, nil입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector3?	삼각형이 발견되지 않는 경우, 삼각형의 첫 번째 정점을 표시합니다. 그렇지 않으면, nil입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector3?	삼각형이 발견되는 경우, 삼각형의 두 번째 정점을 표시합니다. 그렇지 않으면, nil입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector3?	삼각형이 발견되는 경우, 삼각형의 세 번째 정점을 표시합니다. 그렇지 않으면, nil입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.