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 full)

AScreenPassExtensionPlugin<"">
- TonemapPlugin

Constructors

constructor

new TonemapPlugin(): TonemapPlugin
Returns TonemapPlugin
Inherited from AScreenPassExtensionPlugin.constructor
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:27

Properties

`Optional` __setDirty

__setDirty?: (() => void)

Type declaration

- (): void
- Returns void

`Protected` _dirty

_dirty: boolean = false

`Private` _rendererState

_rendererState: any = {}

`Protected` _shaderPatch

_shaderPatch: string = TonemapShaderPatch

`Protected` `Optional` _viewer

_viewer?: ThreeViewer

`Protected` _viewerListeners

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

Type declaration

- (e): void
- Parameters
  - e: IViewerEvent
  Returns 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";
} = ...

Type declaration

Readonly TONEMAP_BACKGROUND: "1"

`Readonly` extraUniforms

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

Type declaration

Readonly toneMappingContrast: {
value: 1;
}
- Readonly value: 1
Readonly toneMappingSaturation: {
value: 1;
}
- Readonly 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

toneMapping

toneMapping: ToneMapping = ACESFilmicToneMapping

tonemapBackground

tonemapBackground: boolean = true

`Optional` uiConfig

uiConfig?: UiObjectConfig<any, string, any> = undefined

`Static` `Readonly` PluginType

PluginType: "Tonemap" = 'Tonemap'

Accessors

dirty

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

uniformsNeedUpdate

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

Methods

`Protected` _onViewerEvent

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

`Protected` _storeKey

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

computeCacheKey

computeCacheKey(_): "0" | "1"
Parameters
- _: IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>
Returns "0" | "1"
Inherited from AScreenPassExtensionPlugin.computeCacheKey
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:54

disable

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

dispose

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

enable

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

exportState

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

fromJSON

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

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:50

importState

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

isCompatible

isCompatible(_): 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.
Parameters
- _: IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>
Returns boolean
Inherited from AScreenPassExtensionPlugin.isCompatible
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:56

parsFragmentSnippet

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

setDirty

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

shaderExtender

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

toJSON

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

updateGBufferFlags

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

Class TonemapPlugin

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns TonemapPlugin

Properties

Optional __setDirty

Type declaration

Returns void

Protected _dirty

Private _rendererState

Protected _shaderPatch

Protected Optional _viewer

Protected _viewerListeners

Type declaration

Parameters

e: IViewerEvent

Returns void

constructor

contrast

enabled

exposure

Readonly extraDefines

Type declaration

Readonly TONEMAP_BACKGROUND: "1"

Readonly extraUniforms

Type declaration

Readonly toneMappingContrast: { value: 1; }

Readonly value: 1

Readonly toneMappingSaturation: { value: 1; }

Readonly value: 1

priority

saturation

toneMapping

tonemapBackground

Optional uiConfig

Static Readonly PluginType

Accessors

dirty

Returns boolean

Parameters

value: boolean

Returns void

uniformsNeedUpdate

Parameters

v: boolean

Returns void

Methods

Protected _onViewerEvent

Parameters

e: IViewerEvent

Returns IViewerEvent

Protected _storeKey

Parameters

Optional prefix: string

Returns string

computeCacheKey

Parameters

_: IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>

Returns "0" | "1"

disable

Parameters

key: any

Returns void

dispose

Returns void

enable

Parameters

key: any

Returns void

exportState

Returns ISerializedConfig | Record<string, never>

fromJSON

Parameters

data: any

`Optional` __setDirty

`Protected` _dirty

`Private` _rendererState

`Protected` _shaderPatch

`Protected` `Optional` _viewer

`Protected` _viewerListeners

`Readonly` extraDefines

`Readonly` TONEMAP_BACKGROUND: "1"

`Readonly` extraUniforms

`Readonly` toneMappingContrast: {
value: 1;
}

`Readonly` value: 1

`Readonly` toneMappingSaturation: {
value: 1;
}

`Readonly` value: 1

`Optional` uiConfig

`Static` `Readonly` PluginType

`Protected` _onViewerEvent

`Protected` _storeKey

`Optional` prefix: string

`Optional` meta: any

`Optional` meta: SerializationMetaType