Class ProgressivePlugin

Progressive Plugin

Adds a post-render pass to blend the last frame with the current frame. This can be used to create a progressive rendering effect which is useful for progressive shadows, gi, denoising, baking, anti-aliasing, and many other effects.

Hierarchy (View Summary)

PipelinePassPlugin<
    ProgressiveBlendPass,
    "progressive",
    ProgressivePluginEventTypes,
>
- ProgressivePlugin

Implements

IShaderPropertiesUpdater

Constructors

constructor

new ProgressivePlugin(
    maxFrameCount?: number,
    bufferType?: TextureDataType,
    enabled?: boolean,
): ProgressivePlugin
Parameters
- maxFrameCount: number = 32
- bufferType: TextureDataType = UnsignedByteType
- enabled: boolean = true
Returns ProgressivePlugin
Overrides PipelinePassPlugin.constructor
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:70

Properties

`Protected`_dirty

_dirty: boolean = false

`Protected` `Optional`_pass

_pass?: ProgressiveBlendPass

`Protected`_targets

_targets: Map<string, WebGLRenderTarget> = ...

Different targets for different render cameras. Need to save them all here since we need them in the next frame.

`Protected` `Optional`_viewer

_viewer?: ThreeViewer

`Protected`_viewerListeners

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

`Readonly`bufferType

bufferType: TextureDataType

Note - this is not used right now

constructor

constructor: typeof AViewerPluginSync & typeof AViewerPlugin

enabled

enabled: boolean = true

maxFrameCount

maxFrameCount: number

`Readonly`passId

passId: "progressive" = 'progressive'

`Optional`uiConfig

uiConfig?: UiObjectConfig = undefined

`Static` `Readonly`OldPluginType

OldPluginType: "Progressive" = 'Progressive'

`Static` `Readonly`PluginType

PluginType: "ProgressivePlugin" = 'ProgressivePlugin'

Accessors

convergedPromise

get convergedPromise(): Promise<void>
Returns Promise<void>
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:147

dirty

get dirty(): boolean
Returns boolean
Inherited from PipelinePassPlugin.dirty
- Defined in src/viewer/AViewerPlugin.ts:107
set dirty(value: boolean): void
Parameters
- value: boolean
Returns void
Inherited from PipelinePassPlugin.dirty
- Defined in src/viewer/AViewerPlugin.ts:111

mainTexture

get mainTexture(): undefined | Texture
Returns undefined | Texture
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:59

pass

get pass(): undefined | T
Returns undefined | T
Inherited from PipelinePassPlugin.pass
- Defined in src/plugins/base/PipelinePassPlugin.ts:62

target

get target(): undefined | WebGLRenderTarget
Returns undefined | WebGLRenderTarget
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:46

texture

get texture(): undefined | Texture
Returns undefined | Texture
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:42

textures

get textures(): Texture[]
Returns Texture[]
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:54

Methods

`Protected`_beforeRender

_beforeRender(_?: IScene, _1?: ICamera, _2?: IRenderManager): boolean
This function is called every frame before composer render, if this pass is being used in the pipeline
Parameters
- Optional_: IScene
- Optional_1: ICamera
- Optional_2: IRenderManager
Returns boolean
Inherited from PipelinePassPlugin._beforeRender
- Defined in src/plugins/base/PipelinePassPlugin.ts:34

`Protected`_createPass

_createPass(): ProgressiveBlendPass
Returns ProgressiveBlendPass
Overrides PipelinePassPlugin._createPass
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:108

`Protected`_createTarget

_createTarget(
camera?: ICamera,
recreate?: boolean,
): undefined | WebGLRenderTarget
Parameters
- Optionalcamera: ICamera
- recreate: boolean = false
Returns undefined | WebGLRenderTarget
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:81

`Protected`_disposeTarget

_disposeTarget(camera?: ICamera): void
Parameters
- Optionalcamera: ICamera
Returns void
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:94

`Protected`_onViewerEvent

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

`Protected`_storeKey

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

disable

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

dispose

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

enable

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

exportState

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

fromJSON

fromJSON(
data: ISerializedConfig & { pass?: any },
meta?: SerializationMetaType,
): null | ProgressivePlugin | Promise<null | ProgressivePlugin>
Parameters
- data: ISerializedConfig & { pass?: any }
- Optionalmeta: SerializationMetaType
Returns null | ProgressivePlugin | Promise<null | ProgressivePlugin>
Overrides PipelinePassPlugin.fromJSON
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:162

getTarget

getTarget(camera?: ICamera): undefined | WebGLRenderTarget
Parameters
- Optionalcamera: ICamera
Returns undefined | WebGLRenderTarget
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:50

importState

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

isConverged

isConverged(postRender?: boolean): boolean
Parameters
- postRender: boolean = false
  if called after rendering frame.
Returns boolean
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:127

isDisabled

isDisabled(): boolean
Returns boolean
Inherited from PipelinePassPlugin.isDisabled
- Defined in src/viewer/AViewerPlugin.ts:80

onAdded

onAdded(viewer: ThreeViewer): void
Parameters
- viewer: ThreeViewer
Returns void
Overrides PipelinePassPlugin.onAdded
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:115

onRemove

onRemove(viewer: ThreeViewer): void
Parameters
- viewer: ThreeViewer
Returns void
Overrides PipelinePassPlugin.onRemove
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:119

postFrameConvergedRecordingDelta

postFrameConvergedRecordingDelta(_?: string): number
Get recording delta post render, For use with animations to sync with converge mode in canvas recorder. See PopmotionPlugin for usage.
Parameters
- _: string = 'CanvasRecorder'
Returns number
- delta time in milliseconds, or 0 when converging, or -1 in case of not recording in converge mode
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:140

setDirty

setDirty(): void
Returns void
Inherited from PipelinePassPlugin.setDirty
- Defined in src/plugins/base/PipelinePassPlugin.ts:74

toJSON

toJSON(meta?: SerializationMetaType): ISerializedConfig & { pass?: any }
Parameters
- Optionalmeta: SerializationMetaType
Returns ISerializedConfig & { pass?: any }
Inherited from PipelinePassPlugin.toJSON
- Defined in src/plugins/base/PipelinePassPlugin.ts:66

updateShaderProperties

updateShaderProperties(
    material: {
        defines: Record<string, undefined | string | number>;
        uniforms: { [p: string]: IUniform };
    },
): this
Parameters
- material: {
  defines: Record<string, undefined | string | number>;
  uniforms: { [p: string]: IUniform };
  }
Returns this
Implementation of IShaderPropertiesUpdater.updateShaderProperties
- Defined in src/plugins/pipeline/ProgressivePlugin.ts:131

Class ProgressivePlugin

Hierarchy (View Summary)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns ProgressivePlugin

Properties

Protected_dirty

Protected Optional_pass

Protected_targets

Protected Optional_viewer

Protected_viewerListeners

ReadonlybufferType

constructor

enabled

maxFrameCount

ReadonlypassId

OptionaluiConfig

Static ReadonlyOldPluginType

Static ReadonlyPluginType

Accessors

convergedPromise

Returns Promise<void>

dirty

Returns boolean

Parameters

Returns void

mainTexture

Returns undefined | Texture

pass

Returns undefined | T

target

Returns undefined | WebGLRenderTarget

texture

Returns undefined | Texture

textures

Returns Texture[]

Methods

Protected_beforeRender

Parameters

Returns boolean

Protected_createPass

Returns ProgressiveBlendPass

Protected_createTarget

Parameters

Returns undefined | WebGLRenderTarget

Protected_disposeTarget

Parameters

Returns void

Protected_onViewerEvent

Parameters

Returns IViewerEvent

Protected_storeKey

Parameters

Returns string

disable

Parameters

Returns void

dispose

Returns void

enable

Parameters

Returns void

exportState

Returns ISerializedConfig | Record<string, never>

fromJSON

Parameters

Returns null | ProgressivePlugin | Promise<null | ProgressivePlugin>

getTarget

Parameters

Returns undefined | WebGLRenderTarget

importState

Parameters

Returns Promise<void>

`Protected`_dirty

`Protected` `Optional`_pass

`Protected`_targets

`Protected` `Optional`_viewer

`Protected`_viewerListeners

`Readonly`bufferType

`Readonly`passId

`Optional`uiConfig

`Static` `Readonly`OldPluginType

`Static` `Readonly`PluginType

`Protected`_beforeRender

`Protected`_createPass

`Protected`_createTarget

`Protected`_disposeTarget

`Protected`_onViewerEvent

`Protected`_storeKey