Class TonemapPlugin

Tonemap Plugin

Adds an extension to ScreenPass material for applying tonemapping on the final buffer before rendering to screen.

Also adds support for Uncharted2 tone-mapping.

Hierarchy (View Summary)

AScreenPassExtensionPlugin
- TonemapPlugin

Constructors

constructor

new TonemapPlugin(shaderPatch?: string): TonemapPlugin
Parameters
- shaderPatch: string = ''
Returns TonemapPlugin
Inherited from AScreenPassExtensionPlugin.constructor
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:27

Properties

`Optional`__setDirty

__setDirty?: () => void

`Protected`_dirty

_dirty: boolean = false

`Protected`_shaderPatch

_shaderPatch: string = TonemapShaderPatch

`Protected` `Optional`_viewer

_viewer?: ThreeViewer

`Protected`_viewerListeners

_viewerListeners: PartialRecord<
    | "dispose"
    | "*"
    | "update"
    | "preRender"
    | "postRender"
    | "preFrame"
    | "postFrame"
    | "addPlugin"
    | "removePlugin"
    | "renderEnabled"
    | "renderDisabled",
    (e: IViewerEvent) => void,
> = {}

constructor

constructor: typeof AScreenPassExtensionPlugin & typeof AViewerPluginSync & typeof AViewerPlugin

contrast

contrast: number

enabled

enabled: boolean = true

exposure

exposure: number = 1

`Readonly`extraDefines

extraDefines: { TONEMAP_BACKGROUND: "1" } = ...

`Readonly`extraUniforms

extraUniforms: {
toneMappingContrast: { value: 1 };
toneMappingSaturation: { value: 1 };
} = ...

priority

priority: number = -100

The priority of the material extension when applied to the material in ScreenPass set to very low priority, so applied at the end

saturation

saturation: number

tonemapBackground

tonemapBackground: boolean = true

toneMapping

toneMapping: ToneMapping = ACESFilmicToneMapping

`Optional`uiConfig

uiConfig?: UiObjectConfig = undefined

`Static` `Optional` `Readonly`OldPluginType

OldPluginType?: string

`Static` `Readonly`PluginType

PluginType: "Tonemap" = 'Tonemap'

Accessors

dirty

get dirty(): boolean
Returns boolean
Inherited from AScreenPassExtensionPlugin.dirty
- Defined in src/viewer/AViewerPlugin.ts:112
set dirty(value: boolean): void
Parameters
- value: boolean
Returns void
Inherited from AScreenPassExtensionPlugin.dirty
- Defined in src/viewer/AViewerPlugin.ts:116

uniformsNeedUpdate

set uniformsNeedUpdate(v: boolean): void
Parameters
- v: boolean
Returns void
Inherited from AScreenPassExtensionPlugin.uniformsNeedUpdate
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:23

Methods

`Protected`_onViewerEvent

_onViewerEvent(e: IViewerEvent): IViewerEvent
Parameters
- e: IViewerEvent
Returns IViewerEvent
Inherited from AScreenPassExtensionPlugin._onViewerEvent
- Defined in src/viewer/AViewerPlugin.ts:68

`Protected`_storeKey

_storeKey(prefix?: string): string
Parameters
- Optionalprefix: string
Returns string
Inherited from AScreenPassExtensionPlugin._storeKey
- Defined in src/viewer/AViewerPlugin.ts:54

computeCacheKey

computeCacheKey(_: IMaterial): "0" | "1"
Parameters
- _: IMaterial
Returns "0" | "1"
Inherited from AScreenPassExtensionPlugin.computeCacheKey
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:55

disable

disable(key: any): void
Parameters
- key: any
Returns void
Inherited from AScreenPassExtensionPlugin.disable
- Defined in src/viewer/AViewerPlugin.ts:75

dispose

dispose(): void
Returns void
Inherited from AScreenPassExtensionPlugin.dispose
- Defined in src/viewer/AViewerPlugin.ts:34

enable

enable(key: any): void
Parameters
- key: any
Returns void
Inherited from AScreenPassExtensionPlugin.enable
- Defined in src/viewer/AViewerPlugin.ts:80

exportState

exportState(): ISerializedConfig | Record<string, never>
Returns ISerializedConfig | Record<string, never>
Inherited from AScreenPassExtensionPlugin.exportState
- Defined in src/viewer/AViewerPlugin.ts:59

fromJSON

fromJSON(
data: any,
meta?: any,
): null | TonemapPlugin | Promise<null | TonemapPlugin>
Parameters
- data: any
- Optionalmeta: any
Returns null | TonemapPlugin | Promise<null | TonemapPlugin>
Overrides AScreenPassExtensionPlugin.fromJSON
- Defined in src/plugins/postprocessing/TonemapPlugin.ts:127

getUiConfig

getUiConfig(): any
Function to return the UI config for this material extension. This is called once when the material extension is registered.

Returns any
Inherited from AScreenPassExtensionPlugin.getUiConfig
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:51

importState

importState(state: any): Promise<void>
Parameters
- state: any
Returns Promise<void>
Inherited from AScreenPassExtensionPlugin.importState
- Defined in src/viewer/AViewerPlugin.ts:62

isCompatible

isCompatible(_: IMaterial): boolean
Function to check if this material extension is compatible with the given material. If not compatible, the material extension will not be applied. This is only checked when the extension is registered.

The extension is assumed to be compatible if this function is not defined
Parameters
- _: IMaterial
Returns boolean
Inherited from AScreenPassExtensionPlugin.isCompatible
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:57

onObjectRender

onObjectRender(_: Object3D, material: IMaterial, renderer: WebGLRenderer): void
Parameters
- _: Object3D
- material: IMaterial
- renderer: WebGLRenderer
Returns void
- Defined in src/plugins/postprocessing/TonemapPlugin.ts:110

onRemove

onRemove(viewer: ThreeViewer): void
Parameters
- viewer: ThreeViewer
Returns void
Inherited from AScreenPassExtensionPlugin.onRemove
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:92

parsFragmentSnippet

parsFragmentSnippet(): string
Returns string
- Defined in src/plugins/postprocessing/TonemapPlugin.ts:96

setDirty

setDirty(): void
Returns void
Inherited from AScreenPassExtensionPlugin.setDirty
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:61

shaderExtender

shaderExtender(shader: Shader, _: IMaterial, _1: WebGLRenderer): void
Custom callback to extend/modify/replace shader code and other shader properties
Parameters
- shader: Shader
- _: IMaterial
- _1: WebGLRenderer
Returns void
Inherited from AScreenPassExtensionPlugin.shaderExtender
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:41

toJSON

toJSON(meta?: SerializationMetaType): ISerializedConfig
Parameters
- Optionalmeta: SerializationMetaType
Returns ISerializedConfig
Inherited from AScreenPassExtensionPlugin.toJSON
- Defined in src/viewer/AViewerPlugin.ts:38

updateGBufferFlags

updateGBufferFlags(data: Vector4, c: GBufferUpdaterContext): void
Parameters
- data: Vector4
- c: GBufferUpdaterContext
Returns void
Overrides AScreenPassExtensionPlugin.updateGBufferFlags
- Defined in src/plugins/postprocessing/TonemapPlugin.ts:140

Class TonemapPlugin

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns TonemapPlugin

Properties

Optional__setDirty

Protected_dirty

Protected_shaderPatch

Protected Optional_viewer

Protected_viewerListeners

constructor

contrast

enabled

exposure

ReadonlyextraDefines

ReadonlyextraUniforms

priority

saturation

tonemapBackground

toneMapping

OptionaluiConfig

Static Optional ReadonlyOldPluginType

Static ReadonlyPluginType

Accessors

dirty

Returns boolean

Parameters

Returns void

uniformsNeedUpdate

Parameters

Returns void

Methods

Protected_onViewerEvent

Parameters

Returns IViewerEvent

Protected_storeKey

Parameters

Returns string

computeCacheKey

Parameters

Returns "0" | "1"

disable

Parameters

Returns void

dispose

Returns void

enable

Parameters

Returns void

exportState

Returns ISerializedConfig | Record<string, never>

fromJSON

Parameters

Returns null | TonemapPlugin | Promise<null | TonemapPlugin>

getUiConfig

Returns any

importState

Parameters

Returns Promise<void>

isCompatible

Parameters

Returns boolean

isDisabled

Returns boolean

onAdded

Parameters

Returns void

onAfterRender

Parameters

Returns void

onObjectRender

Parameters

Returns void

`Optional`__setDirty

`Protected`_dirty

`Protected`_shaderPatch

`Protected` `Optional`_viewer

`Protected`_viewerListeners

`Readonly`extraDefines

`Readonly`extraUniforms

`Optional`uiConfig

`Static` `Optional` `Readonly`OldPluginType

`Static` `Readonly`PluginType

`Protected`_onViewerEvent

`Protected`_storeKey