Class PhongMaterial

PhongMaterial

Phong 라이팅 기반의 다양한 텍스처/파라미터를 지원하는 머티리얼 클래스입니다. 디퓨즈, 스펙큘러, 노멀, AO, 알파, 발광 등 다양한 텍스처와 샘플러, 파라미터를 통해 사실적인 라이팅 효과를 구현할 수 있습니다.

Example

const sourceTexture = new RedGPU.Resource.BitmapTexture(
   redGPUContext,
   '/RedGPU/examples/assets/github.png'
);
const material = new RedGPU.Material.PhongMaterial(redGPUContext);
material.diffuseTexture = sourceTexture;

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

See

PhongMaterial Texture Combination example

Hierarchy (View Summary)

ABitmapBaseMaterial
- PhongMaterial

Index

Constructors

constructor

new PhongMaterial(
    redGPUContext: RedGPUContext,
    color?: string,
    name?: string,
): PhongMaterial
PhongMaterial 생성자
Parameters
- redGPUContext: RedGPUContext
  RedGPUContext 인스턴스
- color: string = '#fff'
  기본 색상(HEX 문자열, 기본값: '#fff')
- Optionalname: string
  머티리얼 이름(옵션)
Returns PhongMaterial
Inherited from ABitmapBaseMaterial.constructor
- Defined in src/material/phongMaterial/PhongMaterial.ts:99

Properties

__packingList

__packingList: any[]

파이프라인 갱신 시 호출되는 콜백 리스트

alphaTexture

alphaTexture: BitmapTexture

알파(투명도) 텍스처

alphaTextureSampler

alphaTextureSampler: Sampler

알파 텍스처 샘플러

aoTexture

aoTexture: BitmapTexture

AO(ambient occlusion) 텍스처

aoTextureSampler

aoTextureSampler: Sampler

AO 텍스처 샘플러

color

color: ColorRGB

머티리얼의 기본 색상(RGB)

diffuseTexture

diffuseTexture: BitmapTexture

디퓨즈 텍스처

diffuseTextureSampler

diffuseTextureSampler: Sampler

디퓨즈 텍스처 샘플러

dirtyPipeline

dirtyPipeline: boolean = false

파이프라인 dirty 상태 플래그

emissiveColor

emissiveColor: ColorRGB

발광 색상(RGB)

emissiveStrength

emissiveStrength: number

발광 강도

emissiveTexture

emissiveTexture: BitmapTexture

발광 텍스처

emissiveTextureSampler

emissiveTextureSampler: Sampler

발광 텍스처 샘플러

gpuRenderInfo

gpuRenderInfo: FragmentGPURenderInfo

프래그먼트 GPU 렌더 정보 객체

metallic

metallic: number

금속도

normalScale

normalScale: number

노멀 맵 스케일

normalTexture

normalTexture: BitmapTexture

노멀 맵 텍스처

normalTextureSampler

normalTextureSampler: Sampler

노멀 맵 텍스처 샘플러

opacity

opacity: number

머티리얼의 불투명도(0~1)

roughness

roughness: number

거칠기

specularColor

specularColor: ColorRGB

스펙큘러 색상(RGB)

specularStrength

specularStrength: number

스펙큘러 강도

specularTexture

specularTexture: BitmapTexture

스펙큘러 텍스처

specularTextureSampler

specularTextureSampler: Sampler

스펙큘러 텍스처 샘플러

tint

tint: ColorRGBA

머티리얼의 틴트 컬러(RGBA)

transparent

transparent: boolean = false

머티리얼 투명도 여부

use2PathRender

use2PathRender: boolean

2패스 렌더링 사용 여부

useSSR

useSSR: number

SSR(스크린 스페이스 리플렉션) 사용 여부

useTint

useTint: boolean

틴트 컬러 사용 여부

Accessors

blendAlphaState

get blendAlphaState(): BlendState
머티리얼의 알파 블렌드 상태 객체 반환

Returns BlendState
- Defined in src/material/core/ABaseMaterial.ts:226

blendColorState

get blendColorState(): BlendState
머티리얼의 컬러 블렌드 상태 객체 반환

Returns BlendState
- Defined in src/material/core/ABaseMaterial.ts:218

cacheKey

get cacheKey(): string
Returns string
- Defined in src/resources/core/ResourceBase.ts:39
set cacheKey(value: string): void
Parameters
- value: string
Returns void
- Defined in src/resources/core/ResourceBase.ts:43

displacementScale

get displacementScale(): number
디스플레이스먼트(변위) 스케일 반환

Returns number
- Defined in src/material/phongMaterial/PhongMaterial.ts:114
set displacementScale(value: number): void
디스플레이스먼트(변위) 스케일 설정
Parameters
- value: number
Returns void
- Defined in src/material/phongMaterial/PhongMaterial.ts:119

displacementTexture

get displacementTexture(): BitmapTexture
디스플레이스먼트(변위) 텍스처 반환

Returns BitmapTexture
- Defined in src/material/phongMaterial/PhongMaterial.ts:124
set displacementTexture(value: BitmapTexture): void
디스플레이스먼트(변위) 텍스처 설정 및 파이프라인 갱신
Parameters
- value: BitmapTexture
Returns void
- Defined in src/material/phongMaterial/PhongMaterial.ts:129

FRAGMENT_BIND_GROUP_DESCRIPTOR_NAME

get FRAGMENT_BIND_GROUP_DESCRIPTOR_NAME(): string
Returns string
- Defined in src/material/core/ABaseMaterial.ts:202

FRAGMENT_SHADER_MODULE_NAME

get FRAGMENT_SHADER_MODULE_NAME(): string
Returns string
- Defined in src/material/core/ABaseMaterial.ts:198

gpuDevice

get gpuDevice(): GPUDevice
Retrieves the GPU device associated with the current instance.

Returns GPUDevice
The GPU device.
- Defined in src/resources/core/ResourceBase.ts:73

MODULE_NAME

get MODULE_NAME(): string
Returns string
- Defined in src/material/core/ABaseMaterial.ts:194

name

get name(): string
Returns string
- Defined in src/resources/core/ResourceBase.ts:51
set name(value: string): void
Parameters
- value: string
Returns void
- Defined in src/resources/core/ResourceBase.ts:56

redGPUContext

get redGPUContext(): RedGPUContext
Retrieves the RedGPUContext instance.

Returns RedGPUContext
The RedGPUContext instance.
- Defined in src/resources/core/ResourceBase.ts:82

resourceManagerKey

get resourceManagerKey(): string
Returns string
- Defined in src/resources/core/ResourceBase.ts:47

STORAGE_STRUCT

get STORAGE_STRUCT(): any
Returns any
- Defined in src/material/core/ABaseMaterial.ts:206

tintBlendMode

get tintBlendMode(): string
Returns string
- Defined in src/material/core/ABaseMaterial.ts:169
set tintBlendMode(
    value:
        | "SUBTRACT"
        | "NORMAL"
        | "MULTIPLY"
        | "LIGHTEN"
        | "SCREEN"
        | "LINEAR_DODGE"
        | "DARKEN"
        | "OVERLAY"
        | "COLOR_DODGE"
        | "COLOR_BURN"
        | "HARD_LIGHT"
        | "SOFT_LIGHT"
        | "DIFFERENCE"
        | "EXCLUSION"
        | "DIVIDE"
        | "VIVID_LIGHT"
        | "LINEAR_BURN"
        | "PIN_LIGHT"
        | "SATURATION"
        | "HUE"
        | "LUMINOSITY"
        | "COLOR"
        | "NEGATION"
        | Material.TINT_BLEND_MODE,
): void
Parameters
- value:
      | "SUBTRACT"
      | "NORMAL"
      | "MULTIPLY"
      | "LIGHTEN"
      | "SCREEN"
      | "LINEAR_DODGE"
      | "DARKEN"
      | "OVERLAY"
      | "COLOR_DODGE"
      | "COLOR_BURN"
      | "HARD_LIGHT"
      | "SOFT_LIGHT"
      | "DIFFERENCE"
      | "EXCLUSION"
      | "DIVIDE"
      | "VIVID_LIGHT"
      | "LINEAR_BURN"
      | "PIN_LIGHT"
      | "SATURATION"
      | "HUE"
      | "LUMINOSITY"
      | "COLOR"
      | "NEGATION"
      | Material.TINT_BLEND_MODE
Returns void
- Defined in src/material/core/ABaseMaterial.ts:177

UNIFORM_STRUCT

get UNIFORM_STRUCT(): any
Returns any
- Defined in src/material/core/ABaseMaterial.ts:210

uuid

get uuid(): string
Retrieves the UUID of the object.

Returns string
The UUID of the object.
- Defined in src/resources/core/ResourceBase.ts:65

writeMaskState

get writeMaskState(): number
머티리얼의 writeMask 상태 반환

Returns number
- Defined in src/material/core/ABaseMaterial.ts:234
set writeMaskState(value: number): void
머티리얼의 writeMask 상태 설정
Parameters
- value: number
  GPUFlagsConstant 값
Returns void
- Defined in src/material/core/ABaseMaterial.ts:243

Methods

__addDirtyPipelineListener

__addDirtyPipelineListener(listener: () => void): void
Adds a listener function to the dirty pipeline listeners array. This function will be called when the pipeline becomes dirty.
Parameters
- listener: () => void
  The listener function to be added.
Returns void
Inherited from ABitmapBaseMaterial.__addDirtyPipelineListener
- Defined in src/resources/core/ResourceBase.ts:92

__fireListenerList

__fireListenerList(resetList?: boolean): void
Fires the dirty listeners list.
Parameters
- OptionalresetList: boolean = false
  Indicates whether to reset the dirty listeners list after firing.
Returns void
Inherited from ABitmapBaseMaterial.__fireListenerList
- Defined in src/resources/core/ResourceBase.ts:115

__removeDirtyPipelineListener

__removeDirtyPipelineListener(listener: () => void): void
Removes a dirty pipeline listener from the list of listeners.
Parameters
- listener: () => void
  The listener function to be removed.
Returns void
Inherited from ABitmapBaseMaterial.__removeDirtyPipelineListener
- Defined in src/resources/core/ResourceBase.ts:102

_updateBaseProperty

_updateBaseProperty(): void
머티리얼의 유니폼/컬러/틴트 등 기본 속성값을 유니폼 버퍼에 반영

Returns void
Inherited from ABitmapBaseMaterial._updateBaseProperty
- Defined in src/material/core/ABaseMaterial.ts:391

_updateFragmentState

_updateFragmentState(): void
프래그먼트 셰이더 바인드 그룹/유니폼/텍스처/샘플러 등 상태 갱신

Returns void
Inherited from ABitmapBaseMaterial._updateFragmentState
- Defined in src/material/core/ABaseMaterial.ts:285

getFragmentRenderState

getFragmentRenderState(entryPoint?: string): GPUFragmentState
GPU 프래그먼트 렌더 상태 객체 반환
Parameters
- entryPoint: string = 'main'
  셰이더 엔트리포인트(기본값: 'main')
Returns GPUFragmentState
Inherited from ABitmapBaseMaterial.getFragmentRenderState
- Defined in src/material/core/ABaseMaterial.ts:360

getGPUResourceSampler

getGPUResourceSampler(sampler: Sampler): GPUSampler
샘플러 객체에서 GPU 샘플러 반환
Parameters
- sampler: Sampler
  Sampler 객체
Returns GPUSampler
Inherited from ABitmapBaseMaterial.getGPUResourceSampler
- Defined in src/material/core/ABaseMaterial.ts:411

initGPURenderInfos

initGPURenderInfos(): void
GPU 렌더 파이프라인 정보 및 유니폼 버퍼 초기화

Returns void
Inherited from ABitmapBaseMaterial.initGPURenderInfos
- Defined in src/material/core/ABaseMaterial.ts:251

updateSampler

updateSampler(prevSampler: Sampler, newSampler: Sampler): void
샘플러 객체 변경 및 DirtyPipeline 리스너 관리
Parameters
- prevSampler: Sampler
  이전 샘플러
- newSampler: Sampler
  새 샘플러
Returns void
Inherited from ABitmapBaseMaterial.updateSampler
- Defined in src/material/core/ABitmapBaseMaterial.ts:52

updateTexture

updateTexture(
prevTexture: ANoiseTexture | BitmapTexture | CubeTexture,
texture: ANoiseTexture | BitmapTexture | CubeTexture,
): void
텍스처 객체 변경 및 DirtyPipeline 리스너 관리
Parameters
- prevTexture: ANoiseTexture | BitmapTexture | CubeTexture
  이전 텍스처(BitmapTexture|CubeTexture|ANoiseTexture)
- texture: ANoiseTexture | BitmapTexture | CubeTexture
  새 텍스처(BitmapTexture|CubeTexture|ANoiseTexture)
Returns void
Inherited from ABitmapBaseMaterial.updateTexture
- Defined in src/material/core/ABitmapBaseMaterial.ts:41

Class PhongMaterial

Example

See

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns PhongMaterial

Properties

__packingList

alphaTexture

alphaTextureSampler

aoTexture

aoTextureSampler

color

diffuseTexture

diffuseTextureSampler

dirtyPipeline

emissiveColor

emissiveStrength

emissiveTexture

emissiveTextureSampler

gpuRenderInfo

metallic

normalScale

normalTexture

normalTextureSampler

opacity

roughness

specularColor

specularStrength

specularTexture

specularTextureSampler

tint

transparent

use2PathRender

useSSR

useTint

Accessors

blendAlphaState

Returns BlendState

blendColorState

Returns BlendState

cacheKey

Returns string

Parameters

Returns void

displacementScale

Returns number

Parameters

Returns void

displacementTexture

Returns BitmapTexture

Parameters

Returns void

FRAGMENT_BIND_GROUP_DESCRIPTOR_NAME

Returns string

FRAGMENT_SHADER_MODULE_NAME

Returns string

gpuDevice

Returns GPUDevice

MODULE_NAME

Returns string

name

Returns string

Parameters

Returns void

redGPUContext

Returns RedGPUContext

resourceManagerKey

Returns string

STORAGE_STRUCT

Returns any

tintBlendMode

Returns string