stingray.GwNavWorld 오브젝트 참조

설명

Navigation 표준을 나타냅니다.

생성자 및 액세서

stingray.GwNavWorld.create()

관련 샘플 코드

Appkit: /app.lua

기타 관련 참조 항목

stingray.GwNavAStar.create() stingray.GwNavBot.create() stingray.GwNavBoxObstacle.create() stingray.GwNavBoxObstacle.create_exclusive() stingray.GwNavCylinderObstacle.create() stingray.GwNavCylinderObstacle.create_exclusive() stingray.GwNavGeneration.add_generated_navdata_to_world() stingray.GwNavGeneration.add_navdata_file_to_world() stingray.GwNavGraph.create() stingray.GwNavQueries.diskcango() stingray.GwNavQueries.diskcast() stingray.GwNavQueries.inside_position_from_outside_position() stingray.GwNavQueries.move_on_navmesh() stingray.GwNavQueries.raycango() stingray.GwNavQueries.raycast() stingray.GwNavQueries.raycast_full_3d() stingray.GwNavQueries.tag_volumes_from_position() stingray.GwNavQueries.triangle_from_position() stingray.GwNavSmartObjectInterval.can_traverse_smartobject() stingray.GwNavSmartObjectInterval.create() stingray.GwNavTagVolume.create() stingray.GwNavTraversal.get_seed_triangle() stingray.GwNavTraverseLogicData.create()

Gameware Navigation

관련 도움말 항목

	릴리스 정보 > Stingray 1.4 릴리스 정보
	게임플레이 생성 > AI 및 경로 찾기 > Gameware Navigation을 사용하도록 수준 설정
	게임플레이 생성 > AI 및 경로 찾기 > Navigation 옵션

함수

add_navdata ( database_or_world, navdata ) : stingray.GwNavData 지정된 GwNavWorld에 NavData를 추가합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	navdata가 추가되는 GwNavDatabase입니다. GwNavWorld인 경우 기본값 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
navdata :	string	데이터베이스 접미사 없이 추가할 NavData의 리소스 이름입니다.

반환하는 항목

stingray.GwNavData

성공적으로 로드될 경우 로드된 navData이며 그렇지 않은 경우 nil입니다.

allow_smartobject ( self, smartobject_id ) smartobject를 횡단할 수 있도록 허용합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
smartobject_id :	number	횡단할 수 있도록 허용할 smartobject ID입니다.

반환하는 항목

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

create ( transform, database_count ) : stingray.GwNavWorld 새로운 GwNavWorld를 생성하고 반환합니다.

매개변수

transform :	stingray.Matrix4x4?	3D 공간에서 새 GwNavWorld에 대한 변환을 지정합니다. 선택 사항입니다. 생략된 경우 GwNavWorld는 ID 매트릭스를 사용합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
database_count :	integer?	선택 사항입니다. 사용할 데이터베이스의 수입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

stingray.GwNavWorld

새로운 GwNavWorld입니다.

database ( self, database_id ) : stingray.GwNavDatabase 지정된 ID의 GwNavDatabase(있는 경우)를 반환하고, 그렇지 않은 경우 nil을 반환합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
database_id :	integer	데이터베이스의 ID입니다.

반환하는 항목

stingray.GwNavDatabase

Kaim::Database(있는 경우)의 포인터입니다.

database_count ( self ) : number GwNavWorld를 구성하는 데이터베이스의 수를 제공합니다.

매개변수

self :

stingray.GwNavWorld

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.

반환하는 항목

number

GwNavWorld를 구성하는 데이터베이스의 수입니다.

destroy ( self ) 지정된 GwNavWorld를 삭제합니다.

매개변수

self :

stingray.GwNavWorld

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.

반환하는 항목

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

enable_crowd_dispersion ( self ) GwNavWorld에 대한 군중 분산을 활성화합니다.

매개변수

self :

stingray.GwNavWorld

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.

반환하는 항목

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

forbid_smartobject ( self, smartobject_id ) smartobject를 횡단할 수 없도록 금지합니다. 비용이 set_smartobject_cost_multiplier()를 통해 설정된 경우 이후에 allow_smartobject()를 호출해도 그대로 유지됩니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
smartobject_id :	number	횡단할 수 없도록 금지할 smartobject ID입니다.

반환하는 항목

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

init_async_update ( self ) 표준이 작업자 스레드를 생성하도록 합니다.

매개변수

self :

stingray.GwNavWorld

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.

반환하는 항목

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

중요 - kick_async_update()/join_async_update()를 호출하려는 경우에는 반드시 이 함수를 호출해야 합니다.

is_crowd_dispersion_enabled ( self ) : boolean GwNavWorld에 대한 군중 분산을 활성화합니다.

매개변수

self :

stingray.GwNavWorld

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.

반환하는 항목

boolean

stingray.GwNavWorld.enable_crowd_dispersion이 호출된 경우 true를 반환합니다.

join_async_update ( self ) kick_update()를 통해 시작된 비동기 업데이트가 완료될 때까지 차단합니다.

매개변수

self :

stingray.GwNavWorld

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.

반환하는 항목

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

중요 - 이 함수의 호출은 kick_async_update()의 호출과 일대일로 매핑되어야 합니다.

kick_async_update ( self, delta_time ) 작업자 스레드에서 표준이 업데이트되도록 합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
delta_time :	number	업데이트 시 GwNavWorld가 사용해야 하는 시간 단계(초)입니다.

반환하는 항목

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

중요 - join_update()를 호출하기 전에는 어떠한 Navigation 관련 함수도 호출해서는 안 됩니다(아래 참조). 그렇지 않으면 충돌 또는 기타 정의되지 않은 동작이 발생합니다.

register_all_navgraphedges_for_crowd_dispersion ( self, nav_graph ) 군중 분산에 대한 GwNavGraph를 등록합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
nav_graph :	stingray.GwNavGraph	군중 분산에 대해 등록할 GwNavGraph입니다.

반환하는 항목

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

register_tagvolume_for_crowd_dispersion ( self, tag_volume ) 군중 분산에 대한 GwNavTagVolume을 등록합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
tag_volume :	stingray.GwNavTagVolume	군중 분산에 대해 등록할 GwNavTagVolume입니다.

반환하는 항목

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

remove_navdata ( navdata ) 지정된 GwNavWorld에서 NavData를 제거합니다.

매개변수

navdata :

stingray.GwNavData

추가할 NavData 리소스의 파일 이름입니다.

반환하는 항목

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

set_dynamicnavmesh_budget ( self, budget ) 이 표준에 대한 프레임당 예산(초)을 설정합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
budget :	number	동적 NavMesh에 대한 예산(초)입니다.

반환하는 항목

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

동적 NavMesh를 처리할 때 표준은 지정된 예산을 초과하지 않습니다.

set_pathfinder_budget ( self, budget ) 이 표준에 대한 프레임당 예산(초)을 설정합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
budget :	number	경로 찾기에 대한 예산(초)입니다.

반환하는 항목

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

경로 찾기 요청을 처리할 때 표준은 지정된 예산을 초과하지 않습니다.

set_smartobject_cost_multiplier ( self, smartobject_id, cost_multiplier ) 지정된 smartobject를 횡단할 때 사용해야 하는 비용 승수를 지정할 수 있습니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
smartobject_id :	number	설정할 smartobject ID입니다.
cost_multiplier :	number	이 smartobject의 연관 비용 승수입니다.

반환하는 항목

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

unset_smartobject ( self, smartobject_id ) 표준의 smartobject 테이블에서 smartobject를 제거할 수 있습니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
smartobject_id :	number	설정 해제할 smartobject ID입니다.

반환하는 항목

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

smartobject_id가 발견되었지만 설정된 비용이 없는 경우 횡단됩니다.

update ( self, delta_time ) 지정된 GwNavWorld를 업데이트합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
delta_time :	number	업데이트 시 GwNavWorld가 사용해야 하는 시간 단계(초)입니다.

반환하는 항목

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

개발 전용

이 그룹의 요소는 개발 빌드에서만 사용할 수 있습니다.

최종 빌드에서는 사용하지 마십시오.

build_database_visual_geometry ( database_or_world ) 지정된 GwNavWorld에 대한 데이터베이스의 디버그 렌더링 표현을 다시 빌드합니다.

매개변수

database_or_world :

any(stingray.GwNavWorld, stingray.GwNavDatabase)

사용할 GwNavDatabase입니다. GwNavWorld인 경우 기본값 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.

반환하는 항목

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

database_tile_count ( database_or_world ) : integer 지정된 GwNavWorld의 데이터베이스 시각적 표현에 포함된 타일 수를 반환합니다.

매개변수

database_or_world :

any(stingray.GwNavWorld, stingray.GwNavDatabase)

사용할 GwNavDatabase입니다. GwNavWorld인 경우 기본값 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.

반환하는 항목

integer

데이터베이스에 포함된 타일 수입니다.

database_tile_triangle_count ( database_or_world, tile_index ) : integer 지정된 GwNavWorld의 데이터베이스 시각적 표현에 포함된 지정된 타일 내 삼각형 수를 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	사용할 GwNavDatabase입니다. GwNavWorld인 경우 기본값 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
tile_index :	integer	삼각형 개수를 가져올 타일의 색인입니다.

반환하는 항목

integer

타일 내 삼각형 수입니다.

database_triangle ( database_or_world, tile_index, triangle_index ) : stingray.Vector3?, stingray.Vector3?, stingray.Vector3?, stingray.Quaternion? 지정된 GwNavWorld의 데이터베이스 시각적 표현에 포함된 지정된 타일 내 지정된 삼각형을 반환하거나, nil을 반환합니다.

매개변수

database_or_world :	any(stingray.GwNavWorld, stingray.GwNavDatabase)	사용할 GwNavDatabase입니다. GwNavWorld인 경우 기본값 GwNavDatabase가 사용됩니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
tile_index :	integer	데이터베이스 내 타일의 색인입니다.
triangle_index :	integer	타일 내 삼각형의 색인입니다.

반환하는 항목

stingray.Vector3?	발견되는 경우, 삼각형의 정점을 반환하거나, 그렇지 않으면 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector3?	발견되는 경우, 삼각형의 정점을 반환하거나, 그렇지 않으면 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector3?	발견되는 경우, 삼각형의 정점을 반환하거나, 그렇지 않으면 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Quaternion?	발견되는 경우, 삼각형의 색상을 반환하거나, 그렇지 않으면 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

init_visual_debug_server ( self, server_port ) 지정된 포트를 사용하여 지정된 GwNavWorld에 대해 시각적 디버그 서버를 시작합니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
server_port :	number	시각적 디버그 서버를 생성할 때 GwNavWorld가 사용해야 하는 포트입니다.

반환하는 항목

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

set_visual_debug_camera_transform ( self, position, look_at, up ) 이 함수를 통해 시각적 디버거에서 카메라를 제어할 수 있습니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
position :	stingray.Vector3	원하는 카메라의 위치입니다.
look_at :	stingray.Vector3	카메라가 가리켜야 하는 위치입니다.
up :	stingray.Vector3	카메라의 "위쪽" 축입니다.

반환하는 항목

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

이 방식으로 봇의 POV 또는 기타 관심 가는 POV를 살펴볼 수 있습니다.

visual_debug_draw_line ( self, display_list_name, group_name, start, end, color ) NavigationLab에 선을 그립니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
display_list_name :	string	표시 목록의 이름입니다.
group_name :	string	표시 목록이 속하는 그룹입니다.
start :	stingray.Vector3	선의 시작 위치입니다.
end :	stingray.Vector3	선의 끝 위치입니다.
color :	stingray.Quaternion	선 색상입니다.

반환하는 항목

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

visual_debug_draw_text ( self, display_list_name, group_name, text, position, color ) NavigationLab에 3D 텍스트를 그립니다.

매개변수

self :	stingray.GwNavWorld	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
display_list_name :	string	표시 목록의 이름입니다.
group_name :	string	표시 목록이 속하는 그룹입니다.
text :	string	그릴 텍스트입니다.
position :	stingray.Vector3	텍스트 위치입니다.
color :	stingray.Quaternion	텍스트 색상입니다.

반환하는 항목

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