Class SkyBox

constructor

• new SkyBox(
      redGPUContext: RedGPUContext,
      cubeTexture: CubeTexture | HDRTexture,
  ): SkyBox

  새로운 SkyBox 인스턴스를 생성합니다.

  Parameters

  • redGPUContext: RedGPUContext

    RedGPU 렌더링 컨텍스트

  • cubeTexture: CubeTexture | HDRTexture

    스카이박스에 사용할 큐브 텍스처 또는 HDR 텍스처

  Returns SkyBox

  Throws

  redGPUContext가 유효하지 않은 경우

gpuRenderInfo

modelMatrix

blur

• get blur(): number

  스카이박스 블러 정도를 반환합니다.

  Returns number

  0.0에서 1.0 사이의 블러 값

• set blur(value: number): void

  스카이박스 블러 정도를 설정합니다.

  Parameters

  • value: number

    0.0에서 1.0 사이의 블러 값

  Returns void

  Throws

  값이 0.0-1.0 범위를 벗어나는 경우

exposure

• get exposure(): number

  HDR 텍스처의 노출값을 반환합니다. 일반 큐브 텍스처의 경우 항상 1을 반환합니다.

  Returns number

  노출값 (HDR 텍스처) 또는 1 (일반 텍스처)

• set exposure(value: number): void

  HDR 텍스처의 노출값을 설정합니다. 일반 큐브 텍스처에는 영향을 주지 않습니다.

  Parameters

  • value: number

    양수 노출값

  Returns void

  Throws

  값이 양수가 아닌 경우

opacity

• get opacity(): number

  스카이박스의 불투명도를 반환합니다.

  Returns number

  0.0에서 1.0 사이의 불투명도 값

• set opacity(value: number): void

  스카이박스의 불투명도를 설정합니다.

  Parameters

  • value: number

    0.0에서 1.0 사이의 불투명도 값

  Returns void

  Throws

  값이 0.0-1.0 범위를 벗어나는 경우

skyboxTexture

• get skyboxTexture(): CubeTexture | HDRTexture

  현재 스카이박스 텍스처를 반환합니다.

  Returns CubeTexture | HDRTexture

  현재 스카이박스 텍스처

• set skyboxTexture(texture: CubeTexture | HDRTexture): void

  스카이박스 텍스처를 설정합니다.

  Parameters

  • texture: CubeTexture | HDRTexture

    새로운 스카이박스 텍스처

  Returns void

  Throws

  텍스처가 null이거나 유효하지 않은 경우

transitionDuration

• get transitionDuration(): number

  전환 지속 시간을 반환합니다.

  Returns number

  전환 지속 시간 (밀리초)

transitionElapsed

• get transitionElapsed(): number

  전환 경과 시간을 반환합니다.

  Returns number

  전환 경과 시간 (밀리초)

transitionProgress

• get transitionProgress(): number

  전환 진행률을 반환합니다.

  Returns number

  0.0에서 1.0 사이의 전환 진행률

transitionTexture

• get transitionTexture(): CubeTexture | HDRTexture

  전환 대상 텍스처를 반환합니다.

  Returns CubeTexture | HDRTexture

  전환 대상 텍스처 (전환 중이 아니면 undefined)

render

• render(renderViewStateData: RenderViewStateData): void

  스카이박스를 렌더링합니다.

  이 메서드는 매 프레임마다 호출되어야 하며, 다음 작업을 수행합니다:

  • MSAA 상태 업데이트
  • GPU 렌더 정보 초기화 (첫 렌더링 시)
  • 파이프라인 업데이트 (필요 시)
  • 텍스처 전환 진행 상황 업데이트
  • 실제 렌더링 명령 실행

  Parameters

  • renderViewStateData: RenderViewStateData

    렌더링 상태 및 디버그 정보

  Returns void

  Example

  // 렌더링 루프에서
  skybox.render(renderViewState);
  Copy

transition

• transition(
      transitionTexture: CubeTexture | HDRTexture,
      duration?: number,
      transitionAlphaTexture: ANoiseTexture,
  ): void

  다른 텍스처로의 부드러운 전환을 시작합니다.

  Parameters

  • transitionTexture: CubeTexture | HDRTexture

    전환할 대상 텍스처

  • duration: number = 300

    전환 지속 시간 (밀리초, 기본값: 300)

  • transitionAlphaTexture: ANoiseTexture

    전환 효과에 사용할 알파 노이즈 텍스처

  Returns void

  Example

  // 1초 동안 새 텍스처로 전환
  skybox.transition(newTexture, 1000, noiseTexture);
  Copy