Class SpotLight

스포트라이트(SpotLight)를 정의하는 클래스입니다.

이 광원은 특정 위치에서 지정된 방향으로 빛을 방사하며, 내부/외부 컷오프 각도를 통해 빛의 퍼짐 범위를 제어할 수 있습니다.

Example

const light = new RedGPU.Light.SpotLight('#ffffff', 2.0);
light.setPosition(0, 5, 10);
light.lookAt(0, 0, 0);
scene.lightManager.addSpotLight(light);

아래는 SpotLight 구조와 동작을 이해하는 데 도움이 되는 추가 샘플 예제 목록입니다.

See

SpotLight Cluster Performance example

Hierarchy (View Summary)

ABaseLight
- SpotLight

Index

Constructors

constructor

new SpotLight(color?: string, intensity?: number): SpotLight
새로운 SpotLight 인스턴스를 생성합니다.
Parameters
- color: string = '#fff'
  광원의 색상 (hex 문자열, 예: '#ffffff')
- intensity: number = 1
  광원의 세기 (기본값: 1)
Returns SpotLight
Overrides ABaseLight.constructor
- Defined in src/light/lights/SpotLight.ts:50

Properties

drawDebugger

drawDebugger: ADrawDebuggerLight

광원의 디버깅 시각화를 위한 도우미 객체입니다. sdfsdf 외부에서 설정되며, 광원의 위치나 방향을 시각적으로 표시할 수 있습니다.

Accessors

color

get color(): ColorRGB
광원의 색상을 반환합니다.

Returns ColorRGB
Inherited from ABaseLight.color
- Defined in src/light/core/ABaseLight.ts:53
set color(value: ColorRGB): void
광원의 색상을 설정합니다.
Parameters
- value: ColorRGB
  ColorRGB 객체
Returns void
Inherited from ABaseLight.color
- Defined in src/light/core/ABaseLight.ts:62

direction

get direction(): [number, number, number]
광원의 방향 벡터를 [x, y, z] 형태로 반환합니다.

Returns [number, number, number]
- Defined in src/light/lights/SpotLight.ts:134
set direction(value: [number, number, number]): void
광원의 방향 벡터를 설정합니다.
Parameters
- value: [number, number, number]
  [x, y, z] 형태의 방향 벡터
Returns void
- Defined in src/light/lights/SpotLight.ts:143

directionX

get directionX(): number
방향 벡터의 X 성분을 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:102
set directionX(value: number): void
방향 벡터의 X 성분을 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:107

directionY

get directionY(): number
방향 벡터의 Y 성분을 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:112
set directionY(value: number): void
방향 벡터의 Y 성분을 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:117

directionZ

get directionZ(): number
방향 벡터의 Z 성분을 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:122
set directionZ(value: number): void
방향 벡터의 Z 성분을 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:127

enableDebugger

get enableDebugger(): boolean
디버깅 시각화 기능의 활성화 여부를 반환합니다.

Returns boolean
Inherited from ABaseLight.enableDebugger
- Defined in src/light/core/ABaseLight.ts:37
set enableDebugger(value: boolean): void
디버깅 시각화 기능을 활성화하거나 비활성화합니다.
Parameters
- value: boolean
  true면 디버깅 기능 활성화
Returns void
Inherited from ABaseLight.enableDebugger
- Defined in src/light/core/ABaseLight.ts:46

innerCutoff

get innerCutoff(): number
내부 컷오프 각도를 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:150
set innerCutoff(degrees: number): void
내부 컷오프 각도를 설정합니다.
Parameters
- degrees: number
Returns void
- Defined in src/light/lights/SpotLight.ts:155

innerCutoffCos

get innerCutoffCos(): number
내부 컷오프 각도의 코사인 값을 반환합니다. 셰이더 계산 등에 사용됩니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:173

intensity

get intensity(): number
광원의 세기를 반환합니다.

Returns number
Inherited from ABaseLight.intensity
- Defined in src/light/core/ABaseLight.ts:69
set intensity(value: number): void
광원의 세기를 설정합니다.
Parameters
- value: number
  숫자 값 (예: 1.0)
Returns void
Inherited from ABaseLight.intensity
- Defined in src/light/core/ABaseLight.ts:78

outerCutoff

get outerCutoff(): number
외부 컷오프 각도를 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:160
set outerCutoff(degrees: number): void
외부 컷오프 각도를 설정합니다.
Parameters
- degrees: number
Returns void
- Defined in src/light/lights/SpotLight.ts:165

outerCutoffCos

get outerCutoffCos(): number
외부 컷오프 각도의 코사인 값을 반환합니다. 셰이더 계산 등에 사용됩니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:181

position

get position(): [number, number, number]
광원의 위치를 [x, y, z] 형태로 반환합니다.

Returns [number, number, number]
- Defined in src/light/lights/SpotLight.ts:87

radius

get radius(): number
광원의 반경을 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:92
set radius(value: number): void
광원의 반경을 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:97

x

get x(): number
X 좌표를 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:55
set x(value: number): void
X 좌표를 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:60

y

get y(): number
Y 좌표를 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:65
set y(value: number): void
Y 좌표를 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:70

z

get z(): number
Z 좌표를 반환합니다.

Returns number
- Defined in src/light/lights/SpotLight.ts:75
set z(value: number): void
Z 좌표를 설정합니다.
Parameters
- value: number
Returns void
- Defined in src/light/lights/SpotLight.ts:80

Methods

lookAt

lookAt(
    targetX: number | [number, number, number],
    targetY?: number,
    targetZ?: number,
): void
특정 타겟 위치를 바라보도록 방향 벡터를 설정합니다.
Parameters
- targetX: number | [number, number, number]
  타겟 X 좌표 또는 [x, y, z] 배열
- OptionaltargetY: number
  타겟 Y 좌표 (targetX가 숫자일 경우)
- OptionaltargetZ: number
  타겟 Z 좌표 (targetX가 숫자일 경우)
Returns void
- Defined in src/light/lights/SpotLight.ts:209

setPosition

setPosition(x: number | [number, number, number], y?: number, z?: number): void
광원의 위치를 설정합니다.
Parameters
- x: number | [number, number, number]
  X 좌표 또는 [x, y, z] 배열
- Optionaly: number
  Y 좌표 (x가 숫자일 경우)
- Optionalz: number
  Z 좌표 (x가 숫자일 경우)
Returns void
- Defined in src/light/lights/SpotLight.ts:192

Class SpotLight

Example

See

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns SpotLight

Properties

drawDebugger

Accessors

color

Returns ColorRGB

Parameters

Returns void

direction

Returns [number, number, number]

Parameters

Returns void

directionX

Returns number

Parameters

Returns void

directionY

Returns number

Parameters

Returns void

directionZ

Returns number

Parameters

Returns void

enableDebugger

Returns boolean

Parameters

Returns void

innerCutoff

Returns number

Parameters

Returns void

innerCutoffCos

Returns number

intensity

Returns number

Parameters

Returns void

outerCutoff

Returns number

Parameters

Returns void

outerCutoffCos

Returns number

position

Returns [number, number, number]

radius

Returns number

Parameters

Returns void

x

Returns number

Parameters

Returns void

y

Returns number

Parameters

Returns void

z

Returns number

Parameters

Returns void

Methods

lookAt

Parameters

Returns void

setPosition

Parameters