Skip to content

Composed

A container class that knows how to apply a sequence of filters to an input image.

Extends

  • BaseFilter<"Composed", ComposedOwnProps, ComposedSerializedProps>

Constructors

new Composed()

new Composed(options): Composed

Parameters

options: object & Record<string, any> = {}

Returns

Composed

Overrides

BaseFilter.constructor

Defined in

src/filters/Composed.ts:29

Properties

subFilters

subFilters: BaseFilter<string, object, object>[]

A non sparse array of filters to apply

Defined in

src/filters/Composed.ts:25


defaults

static defaults: Record<string, unknown>

Inherited from

BaseFilter.defaults

Defined in

src/filters/BaseFilter.ts:51


type

static type: string = 'Composed'

The class type. Used to identify which class this is. This is used for serialization purposes and internally it can be used to identify classes. As a developer you could use instance of Class but to avoid importing all the code and blocking tree shaking we try to avoid doing that.

Overrides

BaseFilter.type

Defined in

src/filters/Composed.ts:27


uniformLocations

static uniformLocations: string[] = []

Contains the uniform locations for the fragment shader. uStepW and uStepH are handled by the BaseFilter, each filter class needs to specify all the one that are needed

Inherited from

BaseFilter.uniformLocations

Defined in

src/filters/BaseFilter.ts:49

Accessors

type

get type(): Name

Filter type

Default

Returns

Name

Inherited from

BaseFilter.type

Defined in

src/filters/BaseFilter.ts:31

Methods

_setupFrameBuffer()

_setupFrameBuffer(options): void

Parameters

options: TWebGLPipelineState

Returns

void

Inherited from

BaseFilter._setupFrameBuffer

Defined in

src/filters/BaseFilter.ts:205


_swapTextures()

_swapTextures(options): void

Parameters

options: TWebGLPipelineState

Returns

void

Inherited from

BaseFilter._swapTextures

Defined in

src/filters/BaseFilter.ts:232


applyTo()

applyTo(options): void

Apply this container’s filters to the input image provided.

Parameters

options: TWebGLPipelineState | T2DPipelineState

Returns

void

Overrides

BaseFilter.applyTo

Defined in

src/filters/Composed.ts:45


applyTo2d()

applyTo2d(_options): void

Parameters

_options: T2DPipelineState

Returns

void

Inherited from

BaseFilter.applyTo2d

Defined in

src/filters/BaseFilter.ts:275


applyToWebGL()

applyToWebGL(options): void

Apply this filter using webgl.

Parameters

options: TWebGLPipelineState

Returns

void

Inherited from

BaseFilter.applyToWebGL

Defined in

src/filters/BaseFilter.ts:315


bindAdditionalTexture()

bindAdditionalTexture(gl, texture, textureUnit): void

Parameters

gl: WebGLRenderingContext

texture: WebGLTexture

textureUnit: number

Returns

void

Inherited from

BaseFilter.bindAdditionalTexture

Defined in

src/filters/BaseFilter.ts:334


createHelpLayer()

createHelpLayer(options): void

If needed by a 2d filter, this functions can create an helper canvas to be used remember that options.targetCanvas is available for use till end of chain.

Parameters

options: T2DPipelineState

Returns

void

Inherited from

BaseFilter.createHelpLayer

Defined in

src/filters/BaseFilter.ts:370


createProgram()

createProgram(gl, fragmentSource, vertexSource): object

Compile this filter’s shader program.

Parameters

gl: WebGLRenderingContext

The GL canvas context to use for shader compilation.

fragmentSource: string = ...

fragmentShader source for compilation

vertexSource: string = ...

vertexShader source for compilation

Returns

object

attributeLocations

attributeLocations: TWebGLAttributeLocationMap

program

program: WebGLProgram

uniformLocations

uniformLocations: TWebGLUniformLocationMap

Inherited from

BaseFilter.createProgram

Defined in

src/filters/BaseFilter.ts:83


getAttributeLocations()

getAttributeLocations(gl, program): TWebGLAttributeLocationMap

Return a map of attribute names to WebGLAttributeLocation objects.

Parameters

gl: WebGLRenderingContext

The canvas context used to compile the shader program.

program: WebGLProgram

The shader program from which to take attribute locations.

Returns

TWebGLAttributeLocationMap

A map of attribute names to attribute locations.

Inherited from

BaseFilter.getAttributeLocations

Defined in

src/filters/BaseFilter.ts:153


getCacheKey()

getCacheKey(): string

Returns a string that represent the current selected shader code for the filter. Used to force recompilation when parameters change or to retrieve the shader from cache

Returns

string

Inherited from

BaseFilter.getCacheKey

Defined in

src/filters/BaseFilter.ts:284


getUniformLocations()

getUniformLocations(gl, program): TWebGLUniformLocationMap

Return a map of uniform names to WebGLUniformLocation objects.

Parameters

gl: WebGLRenderingContext

The canvas context used to compile the shader program.

program: WebGLProgram

The shader program from which to take uniform locations.

Returns

TWebGLUniformLocationMap

A map of uniform names to uniform locations.

Inherited from

BaseFilter.getUniformLocations

Defined in

src/filters/BaseFilter.ts:169


getVertexSource()

getVertexSource(): string

Returns

string

Inherited from

BaseFilter.getVertexSource

Defined in

src/filters/BaseFilter.ts:72


isNeutralState()

isNeutralState(): boolean

Generic isNeutral implementation for one parameter based filters. Used only in image applyFilters to discard filters that will not have an effect on the image Other filters may need their own version ( ColorMatrix, HueRotation, gamma, ComposedFilter )

Returns

boolean

Overrides

BaseFilter.isNeutralState

Defined in

src/filters/Composed.ts:65


retrieveShader()

retrieveShader(options): TWebGLProgramCacheItem

Retrieves the cached shader.

Parameters

options: TWebGLPipelineState

Returns

TWebGLProgramCacheItem

the compiled program shader

Inherited from

BaseFilter.retrieveShader

Defined in

src/filters/BaseFilter.ts:295


sendAttributeData()

sendAttributeData(gl, attributeLocations, aPositionData): void

Send attribute data from this filter to its shader program on the GPU.

Parameters

gl: WebGLRenderingContext

The canvas context used to compile the shader program.

attributeLocations: Record<string, number>

A map of shader attribute names to their locations.

aPositionData: Float32Array

Returns

void

Inherited from

BaseFilter.sendAttributeData

Defined in

src/filters/BaseFilter.ts:192


sendUniformData()

sendUniformData(_gl, _uniformLocations): void

Send uniform data from this filter to its shader program on the GPU.

Intended to be overridden by subclasses.

Parameters

_gl: WebGLRenderingContext

The canvas context used to compile the shader program.

_uniformLocations: TWebGLUniformLocationMap

A map of shader uniform names to their locations.

Returns

void

Inherited from

BaseFilter.sendUniformData

Defined in

src/filters/BaseFilter.ts:359


toJSON()

toJSON(): object & ComposedSerializedProps

Returns a JSON representation of an instance

Returns

object & ComposedSerializedProps

JSON

Inherited from

BaseFilter.toJSON

Defined in

src/filters/BaseFilter.ts:407


toObject()

toObject(): object

Serialize this filter into JSON.

Returns

object

A JSON representation of this filter.

subFilters

subFilters: object & object[]

type

type: "Composed"

Overrides

BaseFilter.toObject

Defined in

src/filters/Composed.ts:58


unbindAdditionalTexture()

unbindAdditionalTexture(gl, textureUnit): void

Parameters

gl: WebGLRenderingContext

textureUnit: number

Returns

void

Inherited from

BaseFilter.unbindAdditionalTexture

Defined in

src/filters/BaseFilter.ts:345


fromObject()

static fromObject(object, options?): Promise<Composed>

Deserialize a JSON definition of a ComposedFilter into a concrete instance.

Parameters

object: Record<string, any>

Object to create an instance from

options?

options.signal?: AbortSignal

handle aborting BlendImage filter loading, see https://developer.mozilla.org/en-US/docs/Web/API/AbortController/signal

Returns

Promise<Composed>

Static

Overrides

BaseFilter.fromObject

Defined in

src/filters/Composed.ts:77