Class FilmicGrainPlugin

Filmic Grain Plugin Adds an extension to ScreenPass material for applying filmic grain effect on the final buffer before rendering to screen. The intensity of the grain can be controlled with the intensity property and the multiply property can be used to multiply the grain effect on the image instead of adding.

Hierarchy (View Summary)

AScreenPassExtensionPlugin
- FilmicGrainPlugin

Constructors

constructor

new FilmicGrainPlugin(enabled?: boolean): FilmicGrainPlugin
Parameters
- enabled: boolean = true
Returns FilmicGrainPlugin
Overrides AScreenPassExtensionPlugin.constructor
- Defined in src/plugins/postprocessing/FilmicGrainPlugin.ts:64

Properties

`Optional`__setDirty

__setDirty?: () => void

`Protected`_dirty

_dirty: boolean = false

`Protected`_shaderPatch

_shaderPatch: string = 'diffuseColor = FilmicGrain(diffuseColor);'

`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

enabled

enabled: boolean

`Readonly`extraUniforms

extraUniforms: { grainIntensity: { value: 1 }; grainMultiply: { value: false } } = ...

intensity

intensity: number = 10

multiply

multiply: boolean = false

priority

priority: number = -50

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

`Optional`uiConfig

uiConfig?: UiObjectConfig = undefined

`Static` `Optional` `Readonly`OldPluginType

OldPluginType?: string

`Static` `Readonly`PluginType

PluginType: "FilmicGrain" = 'FilmicGrain'

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

grainIntensity

get grainIntensity(): number
Returns number
- Defined in src/plugins/postprocessing/FilmicGrainPlugin.ts:55
set grainIntensity(v: number): void
Parameters
- v: number
Returns void
- Defined in src/plugins/postprocessing/FilmicGrainPlugin.ts:59

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 | FilmicGrainPlugin | Promise<null | FilmicGrainPlugin>
Parameters
- data: any
- Optionalmeta: any
Returns null | FilmicGrainPlugin | Promise<null | FilmicGrainPlugin>
Inherited from AScreenPassExtensionPlugin.fromJSON
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:66

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

parsFragmentSnippet

parsFragmentSnippet(): string
Returns string
- Defined in src/plugins/postprocessing/FilmicGrainPlugin.ts:43

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(_: Vector4, _1: GBufferUpdaterContext): void
Parameters
- _: Vector4
- _1: GBufferUpdaterContext
Returns void
Inherited from AScreenPassExtensionPlugin.updateGBufferFlags
- Defined in src/plugins/postprocessing/AScreenPassExtensionPlugin.ts:102

Class FilmicGrainPlugin

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns FilmicGrainPlugin

Properties

Optional__setDirty

Protected_dirty

Protected_shaderPatch

Protected Optional_viewer

Protected_viewerListeners

constructor

enabled

ReadonlyextraUniforms

intensity

multiply

priority

OptionaluiConfig

Static Optional ReadonlyOldPluginType

Static ReadonlyPluginType

Accessors

dirty

Returns boolean

Parameters

Returns void

grainIntensity

Returns number

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 | FilmicGrainPlugin | Promise<null | FilmicGrainPlugin>

getUiConfig

Returns any

importState

Parameters

Returns Promise<void>

isCompatible

Parameters

Returns boolean

isDisabled

Returns boolean

onAdded

Parameters

Returns void

onRemove

Parameters

Returns void

parsFragmentSnippet

Returns string

setDirty

`Optional`__setDirty

`Protected`_dirty

`Protected`_shaderPatch

`Protected` `Optional`_viewer

`Protected`_viewerListeners

`Readonly`extraUniforms

`Optional`uiConfig

`Static` `Optional` `Readonly`OldPluginType

`Static` `Readonly`PluginType

`Protected`_onViewerEvent

`Protected`_storeKey