stingray.Light 오브젝트 참조

설명

게임 라이트를 설명합니다.

생성자 및 액세서

stingray.Unit.light()

기타 관련 참조 항목

	stingray.Unit.set_light_material()
	Units

관련 도움말 항목

	수준 빌드 > 범주 내 수준 오브젝트 정리
	조명 및 렌더링 > 조명 > 라이트 소스 > 라이트 소스 생성
	조명 및 렌더링 > 조명 > 라이트 소스 > 라이트 소스 특성 변경

함수

baked ( self ) : boolean 라이트에 베이킹 태그가 지정되어 실시간 조명 구현 시 해당 라이트를 제외해야 하는지를 나타냅니다.

매개변수

self :

stingray.Light

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

반환하는 항목

boolean

라이트에 베이킹 태그가 지정된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

casts_shadows ( self ) : boolean 라이트가 그림자를 투사하는지 여부를 나타냅니다.

매개변수

self :

stingray.Light

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

반환하는 항목

boolean

라이트가 그림자를 투사하면 true를, 그렇지 않으면 false를 반환합니다.

color ( self ) : stingray.Vector3 라이트의 색상을 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Vector3

라이트의 색상입니다. X, Y 및 Z축의 값은 각각 빨간색, 초록색 및 파란색 채널을 나타냅니다. 각 값은 0에서 1 사이의 선형 공간에 있는 값입니다.

falloff_end ( self ) : number 라이트 강도가 0에 도달한 거리를 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

number

라이트 강도가 0에 도달한 거리입니다.

falloff_start ( self ) : number 라이트가 폴오프, 즉 강도를 잃기 시작하는 거리를 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

number

라이트의 강도가 손실되기 시작하는 거리입니다.

intensity ( self ) : number 라이트의 강도를 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

number

라이트의 강도입니다.

set_baked ( self, enabled ) 이 라이트가 실시간 렌더링 경로에 영향을 미쳐야 하는지 여부를 결정합니다.

매개변수

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

반환하는 항목

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

set_casts_shadows ( self, enabled ) 라이트가 그림자를 투사하는지 여부를 결정합니다.

매개변수

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

반환하는 항목

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

set_color ( self, color ) 라이트의 색상을 설정합니다.

매개변수

self :	stingray.Light	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
color :	stingray.Vector3	라이트에 대해 설정할 색상입니다. X, Y 및 Z축의 값은 각각 빨간색, 초록색 및 파란색 채널을 나타냅니다. 각 값은 0에서 1 사이의 선형 공간에 있는 값이어야 합니다.

반환하는 항목

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

set_data ( unit, src, dst ) 한 라이트의 데이터를 유닛 내 다른 라이트로 설정합니다.

매개변수

unit :	stingray.Unit	대상 라이트가 속해 있는 게임 유닛입니다.
src :	stingray.Light	데이터를 복사한 소스 라이트입니다.
dst :	stingray.Light	데이터를 수신할 대상 라이트입니다.

반환하는 항목

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

set_enabled ( self, enabled ) 라이트를 설정하거나 끕니다.

매개변수

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

반환하는 항목

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

set_falloff_end ( self, distance ) 라이트 강도가 0에 도달해야 하는 거리를 설정합니다.

매개변수

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

반환하는 항목

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

set_falloff_start ( self, distance ) 라이트가 폴오프, 즉 강도를 잃기 시작하는 거리를 설정합니다.

매개변수

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

반환하는 항목

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

set_intensity ( self, intensity ) 라이트의 강도를 설정합니다.

매개변수

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

반환하는 항목

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

set_shadow_depth_bias ( self, value ) 그림자 맵을 렌더링할 때 사용할 그림자 깊이 바이어스 값(0-1 범위)을 설정합니다.

매개변수

self :	stingray.Light	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
value :	number	그림자 맵을 렌더링할 때 사용할 그림자 깊이 바이어스 값(0-1 범위)입니다.

반환하는 항목

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

값이 너무 낮으면 shadow acne 현상이 발생하고, 값이 너무 높으면 peter panning 현상이 발생합니다.

set_spot_angle_end ( self, spot_angle_end ) 라이트 강도가 0에 도달한 원뿔 각도를 설정합니다.

매개변수

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

반환하는 항목

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

스포트라이트에만 유효합니다.

set_spot_angle_start ( self, spot_angle_start ) 라이트가 폴오프되기 시작하는 원뿔 각도를 설정합니다.

매개변수

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

반환하는 항목

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

스포트라이트에만 유효합니다.

set_type ( self, type ) 라이트 소스의 유형을 설정합니다.

매개변수

self :	stingray.Light	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
type :	string	라이트 소스 유형입니다. 유효한 입력 값은 다음과 같습니다. omni: 라이트를 모든 방향으로 방사합니다. spot: 단일 점 소스로부터 방출되는 라이트의 집중 빔입니다. box: 상자 볼륨의 단일 내측 면에서 라이트를 방사합니다. directional: 평행 라이트 광선입니다.

반환하는 항목

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

shadow_depth_bias ( self ) : number 사용자가 제어하는 그림자 깊이 바이어스 값(0-1 범위)을 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

number

사용자가 지정한 그림자 깊이 바이어스(0-1 범위)를 반환합니다.

값이 너무 낮으면 shadow acne 현상이 발생하고, 값이 너무 높으면 peter panning 현상이 발생합니다.

spot_angle_end ( self ) : number 라이트 강도가 0에 도달한 원뿔 각도를 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

number

라디안 단위의 원뿔 각도입니다.

스포트라이트에만 유효합니다.

spot_angle_start ( self ) : number 라이트가 폴오프되기 시작하는 원뿔 각도를 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

number

라디안 단위의 원뿔 각도입니다.

스포트라이트에만 유효합니다.

type ( self ) : string 라이트 소스의 유형을 검색합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

string

라이트 소스 유형입니다. omni, spot, box 또는 directional 중 하나일 수 있습니다.

장면 배치

이 그룹의 함수는 이 오브젝트 유형의 장면 내 배치를 제어합니다.

local_pose ( self ) : stingray.Matrix4x4 로컬 공간 내 지정된 장면 그래프 오브젝트의 위치 및 방향(장면 그래프 내 상위 항목 기준)을 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Matrix4x4

로컬 공간 내 오브젝트의 위치 및 방향입니다.

local_position ( self ) : stingray.Vector3 로컬 공간 내 지정된 장면 그래프 오브젝트의 위치(장면 그래프 내 상위 항목 기준)를 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Vector3

로컬 공간 내 오브젝트의 위치입니다.

local_rotation ( self ) : stingray.Quaternion 로컬 공간 내 지정된 장면 그래프 오브젝트의 방향(장면 그래프 내 상위 항목 기준)을 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Quaternion

로컬 공간 내 오브젝트의 회전입니다.

node ( self ) : integer 장면 그래프 내 지정된 오브젝트의 ID를 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

integer

장면 그래프 내 지정된 오브젝트의 ID입니다.

set_local_pose ( self, parent, pose ) 로컬 공간 내 지정된 장면 그래프 오브젝트의 위치 및 방향(장면 그래프 내 상위 항목 기준)을 설정합니다.

매개변수

self :	stingray.Light	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
parent :	stingray.Unit	이 오브젝트를 소유하는 상위 Unit입니다.
pose :	stingray.Matrix4x4	로컬 공간 내 오브젝트의 새로운 위치 및 방향입니다.

반환하는 항목

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

set_local_position ( self, parent, position ) 로컬 공간 내 지정된 장면 그래프 오브젝트의 위치(장면 그래프 내 상위 항목 기준)를 설정합니다.

매개변수

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

반환하는 항목

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

set_local_rotation ( self, parent, rotation ) 로컬 공간 내 지정된 장면 그래프 오브젝트의 방향(장면 그래프 내 상위 항목 기준)을 설정합니다.

매개변수

self :	stingray.Light	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 이 함수를 호출할 때에는 항상 이 self 매개변수를 제공해야 합니다. 도트(.) 호출 구문을 사용해야 하며, 오브젝트 지향 콜론(:) 호출 구문을 사용하면 안 됩니다. 자세한 내용은 이 Stingray 도움말 항목, 또는 Lua 설명서의 이 페이지를 참조하십시오.
parent :	stingray.Unit	이 오브젝트를 소유하는 상위 Unit입니다.
rotation :	stingray.Quaternion	로컬 공간 내 오브젝트의 새로운 회전입니다.

반환하는 항목

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

world_pose ( self ) : stingray.Matrix4x4 표준 공간 내 지정된 장면 그래프 오브젝트의 위치 및 방향을 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Matrix4x4

표준 공간 내 오브젝트의 위치 및 방향입니다.

world_position ( self ) : stingray.Vector3 표준 공간 내 지정된 장면 그래프 오브젝트의 위치를 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Vector3

표준 공간 내 오브젝트의 위치입니다.

world_rotation ( self ) : stingray.Quaternion 표준 공간 내 지정된 장면 그래프 오브젝트의 회전을 반환합니다.

매개변수

self :

stingray.Light

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

반환하는 항목

stingray.Quaternion

표준 공간 내 오브젝트의 회전입니다.