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

AScreenPassExtensionPlugin<"">
- FilmicGrainPlugin

Constructors

constructor

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

Properties

`Optional` __setDirty

__setDirty?: (() => void)

Type declaration

- (): void
- Returns void

`Protected` _dirty

_dirty: boolean = false

`Protected` _shaderPatch

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

`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

enabled

enabled: boolean

`Readonly` extraUniforms

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

Type declaration

Readonly grainIntensity: {
value: 1;
}
- Readonly value: 1
Readonly grainMultiply: {
value: false;
}
- Readonly 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<any, string, any> = undefined

`Static` `Readonly` PluginType

PluginType: "FilmicGrain" = 'FilmicGrain'

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

grainIntensity

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

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

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/FilmicGrainPlugin.ts:43

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

Class FilmicGrainPlugin

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

enabled: boolean = true

Returns FilmicGrainPlugin

Properties

Optional __setDirty

Type declaration

Returns void

Protected _dirty

Protected _shaderPatch

Protected Optional _viewer

Protected _viewerListeners

Type declaration

Parameters

e: IViewerEvent

Returns void

constructor

enabled

Readonly extraUniforms

Type declaration

Readonly grainIntensity: { value: 1; }

Readonly value: 1

Readonly grainMultiply: { value: false; }

Readonly value: false

intensity

multiply

priority

Optional uiConfig

Static Readonly PluginType

Accessors

dirty

Returns boolean

Parameters

value: boolean

Returns void

grainIntensity

Returns number

Parameters

v: number

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

`Protected` _shaderPatch

`Protected` `Optional` _viewer

`Protected` _viewerListeners

`Readonly` extraUniforms

`Readonly` grainIntensity: {
value: 1;
}

`Readonly` value: 1

`Readonly` grainMultiply: {
value: false;
}

`Readonly` value: false

`Optional` uiConfig

`Static` `Readonly` PluginType

`Protected` _onViewerEvent

`Protected` _storeKey

`Optional` prefix: string

`Optional` meta: any

`Optional` meta: SerializationMetaType