stingray.LineObject 오브젝트 참조

설명

게임 표준에 디버그 선을 그리는 데 사용합니다.

LineObject는 World.create_line_object()를 통해 생성됩니다.

add_* 함수를 호출하여 선 오브젝트에 선을 추가할 수 있고, dispatch()를 호출하여 렌더링 큐에 대기시킬 수 있습니다. 선 오브젝트 내 선은 프레임 간에 자동으로 지워지지 않기 때문에 선 오브젝트를 계속 디스패치하는 한 추가하는 모든 선이 화면에 유지됩니다. 선 오브젝트의 선을 지우려면 reset()을 호출합니다.

움직이는 오브젝트를 따라 선을 그리려면 모든 프레임에서 reset()을 호출하여 오래된 선을 지운 다음, dispatch()를 호출하기 전에 오브젝트의 새 위치에 새 선을 추가합니다.

생성자 및 액세서

stingray.World.create_line_object()

기타 관련 참조 항목

	stingray.Actor.debug_draw() stingray.NavigationMesh.visualize_last_search() stingray.World.destroy_line_object()
	디버깅

관련 도움말 항목

	릴리스 정보 > Stingray 1.1 릴리스 정보
	게임플레이 생성 > AI 및 경로 찾기 > Gameware Navigation을 게임 런타임으로 통합

함수

add_axes ( self, pose, length ) 각 축에 대한 선을 지정된 길이로 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
pose :	stingray.Matrix4x4	축의 위치 및 방향을 지정합니다.
length :	stingray.Vector3?	축 선의 길이입니다. 기본값은 1입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

색상은 고정값으로, X는 빨간색, Y는 초록색, Z는 파란색입니다.

add_box ( self, color, pose, extents ) 방향이 지정된 상자를 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	상자의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
pose :	stingray.Matrix4x4	상자의 위치 및 방향을 지정합니다.
extents :	stingray.Vector3	로컬 오른쪽, 앞쪽 및 위쪽 축을 따르는 상자의 크기입니다.

반환하는 항목

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

add_capsule ( self, color, from, to, radius, segments, circles, bars ) from과 to 사이의 선이 지정된 반지름까지 채워지도록 캡슐을 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	캡슐의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
from :	stingray.Vector3	시작점입니다.
to :	stingray.Vector3	끝점입니다.
radius :	number	캡슐의 반지름입니다.
segments :	integer?	선택 사항입니다. 각 원 안의 선 세그먼트 수입니다. 생략하면 기본값 20이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
circles :	integer?	선택 사항입니다. 캡슐 길이를 따라 존재하는 원의 수입니다. 생략하면 기본값 4가 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
bars :	integer?	선택 사항입니다. 캡슐 내 막대 수입니다. 생략하면 기본값 10이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

segments, circles 및 bars 매개변수는 캡슐을 얼마나 세밀하게 만들지를 지정합니다.

add_circle ( self, color, center, radius, normal, segments ) center 위치에 지정된 반지름 및 법선 벡터의 2D 원을 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	원의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
center :	stingray.Vector3	원의 중심점입니다.
radius :	number	원의 반지름입니다.
normal :	stingray.Vector3	법선 벡터입니다.
segments :	integer?	선택 사항입니다. 원을 그리는 데 사용되는 선 세그먼트 수입니다. 생략하면 기본값 20이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

add_cone ( self, color, from, to, radius, segments, bars ) from의 끝과 to에 있는 베이스의 중심에 원뿔을 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	원뿔의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
from :	stingray.Vector3	시작점입니다.
to :	stingray.Vector3	끝점입니다.
radius :	number	원뿔 베이스의 반지름입니다.
segments :	integer?	선택 사항입니다. 원뿔 안의 선 세그먼트 수입니다. 생략하면 기본값 20이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
bars :	integer?	선택 사항입니다. 원뿔 내 막대 수입니다. 생략하면 기본값 10이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

add_half_sphere ( self, color, center, radius, normal, segments, parts ) center 위치에 지정된 원형 평면 기준 법선의 반구를 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	구의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
center :	stingray.Vector3	구의 중심점입니다.
radius :	number	구의 반지름입니다.
normal :	stingray.Vector3	법선 벡터입니다.
segments :	integer?	선택 사항입니다. 각 원을 그리는 데 사용되는 선 세그먼트 수입니다. 생략하면 기본값 20이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
parts :	integer?	선택 사항입니다. 반구 내 원의 수입니다. 생략하면 기본값 2가 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

add_line ( self, color, from, to ) from과 to 사이에 지정된 색상으로 새로운 선을 선 오브젝트에 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	선의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
from :	stingray.Vector3	선의 시작점입니다.
to :	stingray.Vector3	선의 끝점입니다.

반환하는 항목

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

add_sphere ( self, color, center, radius, segments, parts ) center 위치에 지정된 반지름으로 3D 구를 추가합니다.

매개변수

self :	stingray.LineObject	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 객체 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector4	구의 색상입니다. 색상은 Vector4에 저장된 ARGB 값으로, 각 구성요소의 범위는 0-255입니다. Color()를 호출하고, RGB 값에 대해서는 세 개 인수, ARGB 값에 대해서는 네 개 인수를 전달하여 해당 값을 생성할 수 있습니다. 예를 들어, 밝은 노란색 선을 그리려면 Color(255, 255, 0)을 사용하면 됩니다.
center :	stingray.Vector3	구의 중심점입니다.
radius :	number	구의 반지름입니다.
segments :	integer?	선택 사항입니다. 각 원을 그리는 데 사용되는 선 세그먼트 수입니다. 생략하면 기본값 20이 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
parts :	integer?	선택 사항입니다. 구에 있는 원의 수입니다. 생략하면 기본값 2가 사용됩니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

dispatch ( world, line_object ) 지정된 표준에서 렌더링하기 위해 선 오브젝트를 큐에 대기시킵니다.

매개변수

world :	stingray.World	선 오브젝트를 렌더링할 표준입니다.
line_object :	stingray.LineObject	렌더링을 위해 디스패치할 선 오브젝트입니다.

반환하는 항목

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

표준은 선 오브젝트를 생성한 표준과 같아야 합니다.

reset ( self ) 선 오브젝트의 선을 지웁니다.

매개변수

self :

stingray.LineObject

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

반환하는 항목

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