Class DOF

피사계 심도(DOF, Depth of Field) 후처리 이펙트입니다. CoC(혼란 원) 계산과 블러를 결합해 사실적인 심도 효과를 제공합니다. 다양한 사진/영상 스타일 프리셋 메서드를 지원합니다.

Example

const effect = new RedGPU.PostEffect.DOF(redGPUContext);
effect.focusDistance = 10;
effect.aperture = 2.0;
effect.maxCoC = 30;
effect.setCinematic(); // 시네마틱 프리셋 적용
view.postEffectManager.addEffect(effect);

Hierarchy (View Summary)

AMultiPassPostEffect
- DOF

Constructors

constructor

new DOF(redGPUContext: RedGPUContext): DOF
Parameters
- redGPUContext: RedGPUContext
Returns DOF
Overrides AMultiPassPostEffect.constructor
- Defined in src/postEffect/effects/lens/dof/DOF.ts:53

Accessors

aperture

get aperture(): number
조리개 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:87
set aperture(value: number): void
조리개 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:90

farBlurSize

get farBlurSize(): number
원거리 블러 크기 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:133
set farBlurSize(value: number): void
원거리 블러 크기 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:136

farPlane

get farPlane(): number
원평면 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:114
set farPlane(value: number): void
원평면 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:117

farStrength

get farStrength(): number
원거리 블러 강도 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:151
set farStrength(value: number): void
원거리 블러 강도 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:154

focusDistance

get focusDistance(): number
초점 거리 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:78
set focusDistance(value: number): void
초점 거리 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:81

maxCoC

get maxCoC(): number
최대 CoC 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:96
set maxCoC(value: number): void
최대 CoC 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:99

nearBlurSize

get nearBlurSize(): number
근거리 블러 크기 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:124
set nearBlurSize(value: number): void
근거리 블러 크기 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:127

nearPlane

get nearPlane(): number
근평면 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:105
set nearPlane(value: number): void
근평면 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:108

nearStrength

get nearStrength(): number
근거리 블러 강도 반환

Returns number
- Defined in src/postEffect/effects/lens/dof/DOF.ts:142
set nearStrength(value: number): void
근거리 블러 강도 설정
Parameters
- value: number
Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:145

outputTextureView

get outputTextureView(): GPUTextureView
Returns GPUTextureView
Inherited from AMultiPassPostEffect.outputTextureView
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:120

passList

get passList(): ASinglePassPostEffect[]
내부 패스 리스트 반환

Returns ASinglePassPostEffect[]
Inherited from AMultiPassPostEffect.passList
- Defined in src/postEffect/core/AMultiPassPostEffect.ts:36

redGPUContext

get redGPUContext(): RedGPUContext
Returns RedGPUContext
Inherited from AMultiPassPostEffect.redGPUContext
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:70

shaderInfo

get shaderInfo(): any
Returns any
Inherited from AMultiPassPostEffect.shaderInfo
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:78

storageInfo

get storageInfo(): any
Returns any
Inherited from AMultiPassPostEffect.storageInfo
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:74

systemUuniformsInfo

get systemUuniformsInfo(): any
Returns any
Inherited from AMultiPassPostEffect.systemUuniformsInfo
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:92

uniformBuffer

get uniformBuffer(): UniformBuffer
Returns UniformBuffer
Inherited from AMultiPassPostEffect.uniformBuffer
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:84

uniformsInfo

get uniformsInfo(): any
Returns any
Inherited from AMultiPassPostEffect.uniformsInfo
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:88

useDepthTexture

get useDepthTexture(): boolean
Returns boolean
Inherited from AMultiPassPostEffect.useDepthTexture
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:62
set useDepthTexture(value: boolean): void
Parameters
- value: boolean
Returns void
Inherited from AMultiPassPostEffect.useDepthTexture
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:66

videoMemorySize

get videoMemorySize(): number
비디오 메모리 사용량 반환

Returns number
Inherited from AMultiPassPostEffect.videoMemorySize
- Defined in src/postEffect/core/AMultiPassPostEffect.ts:30

WORK_SIZE_X

get WORK_SIZE_X(): number
Returns number
Inherited from AMultiPassPostEffect.WORK_SIZE_X
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:96
set WORK_SIZE_X(value: number): void
Parameters
- value: number
Returns void
Inherited from AMultiPassPostEffect.WORK_SIZE_X
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:100

WORK_SIZE_Y

get WORK_SIZE_Y(): number
Returns number
Inherited from AMultiPassPostEffect.WORK_SIZE_Y
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:104
set WORK_SIZE_Y(value: number): void
Parameters
- value: number
Returns void
Inherited from AMultiPassPostEffect.WORK_SIZE_Y
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:108

WORK_SIZE_Z

get WORK_SIZE_Z(): number
Returns number
Inherited from AMultiPassPostEffect.WORK_SIZE_Z
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:112
set WORK_SIZE_Z(value: number): void
Parameters
- value: number
Returns void
Inherited from AMultiPassPostEffect.WORK_SIZE_Z
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:116

Methods

clear

clear(): void
모든 패스 clear

Returns void
Inherited from AMultiPassPostEffect.clear
- Defined in src/postEffect/core/AMultiPassPostEffect.ts:41

execute

execute(gpuDevice: GPUDevice, width: number, height: number): void
Parameters
- gpuDevice: GPUDevice
- width: number
- height: number
Returns void
Inherited from AMultiPassPostEffect.execute
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:168

init

init(
    redGPUContext: RedGPUContext,
    name: string,
    computeCodes: { msaa: string; nonMsaa: string },
    bindGroupLayout?: GPUBindGroupLayout,
): void
Parameters
- redGPUContext: RedGPUContext
- name: string
- computeCodes: { msaa: string; nonMsaa: string }
- OptionalbindGroupLayout: GPUBindGroupLayout
Returns void
Inherited from AMultiPassPostEffect.init
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:132

render

render(
    view: View3D,
    width: number,
    height: number,
    sourceTextureInfo: ASinglePassPostEffectResult,
): ASinglePassPostEffectResult
DOF 효과를 렌더링합니다.
Parameters
- view: View3D
- width: number
- height: number
- sourceTextureInfo: ASinglePassPostEffectResult
Returns ASinglePassPostEffectResult
최종 DOF 처리 결과
Overrides AMultiPassPostEffect.render
- Defined in src/postEffect/effects/lens/dof/DOF.ts:254

setCinematic

setCinematic(): void
🎬 시네마틱 프리셋 (강한 DOF, 영화같은 느낌)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:175

setGameDefault

setGameDefault(): void
🎮 게임 기본 프리셋 (균형잡힌 품질/성능)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:162

setLandscape

setLandscape(): void
🌄 풍경 사진 프리셋 (전체적으로 선명, 약간의 원거리 흐림)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:201

setMacro

setMacro(): void
🔍 매크로 촬영 프리셋 (극도로 얕은 심도)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:214

setNightMode

setNightMode(): void
🌙 야간 촬영 프리셋 (저조도 환경)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:240

setPortrait

setPortrait(): void
📷 인물 사진 프리셋 (배경 흐림, 인물 포커스)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:188

setSports

setSports(): void
🏃 액션/스포츠 프리셋 (빠른 움직임에 적합)

Returns void
- Defined in src/postEffect/effects/lens/dof/DOF.ts:227

update

update(deltaTime: number): void
Parameters
- deltaTime: number
Returns void
Inherited from AMultiPassPostEffect.update
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:201

updateUniform

updateUniform(key: string, value: number | boolean | number[]): void
Parameters
- key: string
- value: number | boolean | number[]
Returns void
Inherited from AMultiPassPostEffect.updateUniform
- Defined in src/postEffect/core/ASinglePassPostEffect.ts:204

Class DOF

Example

Hierarchy (View Summary)

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns DOF

Accessors

aperture

Returns number

Parameters

Returns void

farBlurSize

Returns number

Parameters

Returns void

farPlane

Returns number

Parameters

Returns void

farStrength

Returns number

Parameters

Returns void

focusDistance

Returns number

Parameters

Returns void

maxCoC

Returns number

Parameters

Returns void

nearBlurSize

Returns number

Parameters

Returns void

nearPlane

Returns number

Parameters

Returns void

nearStrength

Returns number

Parameters

Returns void

outputTextureView

Returns GPUTextureView

passList

Returns ASinglePassPostEffect[]

redGPUContext

Returns RedGPUContext

shaderInfo

Returns any

storageInfo

Returns any

systemUuniformsInfo

Returns any

uniformBuffer

Returns UniformBuffer

uniformsInfo

Returns any

useDepthTexture

Returns boolean

Parameters

Returns void

videoMemorySize

Returns number

WORK_SIZE_X

Returns number

Parameters

Returns void

WORK_SIZE_Y

Returns number

Parameters

Returns void

WORK_SIZE_Z

Returns number