Class: NoiseFilter

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:77

A filter that adds configurable random noise to rendered content.

This filter generates pixel noise based on a noise intensity value and an optional seed. It can be used to create various effects like film grain, static, or texture variation.

Based on: https://github.com/evanw/glfx.js/blob/master/src/filters/adjust/noise.js

Example

import { NoiseFilter } from 'pixi.js';

// Create with options
const filter = new NoiseFilter({
    noise: 0.5,    // 50% noise intensity
    seed: 12345    // Fixed seed for consistent noise
});

// Apply to a display object
sprite.filters = [filter];

// Adjust noise dynamically
filter.noise = 0.8;    // Increase noise
filter.seed = Math.random(); // New random pattern

Author

Vico: vicocotea

Standard

No Inherit Doc

Extends

• Filter

Constructors

Constructor

> new NoiseFilter(options?): NoiseFilter

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:93

Parameters

options?

NoiseFilterOptions

The options of the noise filter.

Returns

NoiseFilter

Overrides

Filter.constructor

Properties

_destroyed

> _destroyed: boolean

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:194

Internal

Inherited from

Filter._destroyed

_state

> _state: State

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:143

Internal

The gpu state the filter requires to render.

Inherited from

Filter._state

_uniformBindMap

> _uniformBindMap: Record<number, Record<number, string>>

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:191

Internal

A record of the uniform groups and resources used by the shader. This is used by WebGL renderer to sync uniform data.

Inherited from

Filter._uniformBindMap

antialias

> antialias: FilterAntialias

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:136

should the filter use antialiasing?

Default

inherit

Inherited from

Filter.antialias

blendRequired

> blendRequired: boolean

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:154

Whether or not this filter requires the previous render texture for blending.

Default

false

Inherited from

Filter.blendRequired

clipToViewport

> clipToViewport: boolean

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:159

Clip texture into viewport or not

Default

true

Inherited from

Filter.clipToViewport

compatibleRenderers

> readonly compatibleRenderers: number

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:181

A number that uses two bits on whether the shader is compatible with the WebGL renderer and/or the WebGPU renderer. 0b00 - not compatible with either 0b01 - compatible with WebGL 0b10 - compatible with WebGPU This is automatically set based on if a GlProgram or GpuProgram is provided.

Inherited from

Filter.compatibleRenderers

enabled

> enabled: boolean

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:138

If enabled is true the filter is applied, if false it will not.

Inherited from

Filter.enabled

glProgram

> glProgram: GlProgram

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:173

An instance of the GL program used by the WebGL renderer

Inherited from

Filter.glProgram

gpuProgram

> gpuProgram: GpuProgram

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:171

An instance of the GPU program used by the WebGPU renderer

Inherited from

Filter.gpuProgram

groups

> groups: Record<number, BindGroup>

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:183

Inherited from

Filter.groups

padding

> padding: number

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:131

The padding of the filter. Some filters require extra space to breath such as a blur. Increasing this will add extra width and height to the bounds of the object that the filter is applied to.

Default

0

Inherited from

Filter.padding

resolution

> resolution: number | "inherit"

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:149

The resolution of the filter. Setting this to be lower will lower the quality but increase the performance of the filter.

Default

1

Inherited from

Filter.resolution

resources

> resources: Record<string, any>

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:185

A record of the resources used by the shader.

Inherited from

Filter.resources

uid

> readonly uid: number

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:169

A unique identifier for the shader

Inherited from

Filter.uid

defaultOptions

> static defaultOptions: NoiseFilterOptions

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:89

The default configuration options for the NoiseFilter.

These values will be used when no specific options are provided to the constructor. You can override any of these values by passing your own options object.

Example

NoiseFilter.defaultOptions.noise = 0.7; // Change default noise to 0.7
const filter = new NoiseFilter(); // Will use noise 0.7 by default

Overrides

Filter.defaultOptions

prefixed

> static prefixed: string | boolean

Defined in: node_modules/eventemitter3/index.d.ts:9

Inherited from

Filter.prefixed

Accessors

blendMode

Get Signature

> get blendMode(): BLEND_MODES

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:176

Get the blend mode of the filter.

Default

"normal"

Returns

BLEND_MODES

Set Signature

> set blendMode(value): void

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:178

Sets the blend mode of the filter.

Parameters

value

BLEND_MODES

Returns

void

Inherited from

Filter.blendMode

noise

Get Signature

> get noise(): number

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:113

The amount of noise to apply to the filtered content.

This value controls the intensity of the random noise effect:

• Values close to 0 produce subtle noise
• Values around 0.5 produce moderate noise
• Values close to 1 produce strong noise

Default

0.5

Example

const noiseFilter = new NoiseFilter();

// Set to subtle noise
noiseFilter.noise = 0.2;

// Set to maximum noise
noiseFilter.noise = 1.0;

Returns

number

Set Signature

> set noise(value): void

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:114

Parameters

value

number

Returns

void

seed

Get Signature

> get seed(): number

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:134

The seed value used for random noise generation.

This value determines the noise pattern:

• Using the same seed will generate identical noise patterns
• Different seeds produce different but consistent patterns
• Math.random() can be used for random patterns

Default

Math.random()

Example

const noiseFilter = new NoiseFilter();

// Use a fixed seed for consistent noise
noiseFilter.seed = 12345;

// Generate new random pattern
noiseFilter.seed = Math.random();

Returns

number

Set Signature

> set seed(value): void

Defined in: node_modules/pixi.js/lib/filters/defaults/noise/NoiseFilter.d.ts:135

Parameters

value

number

Returns

void

Methods

addListener()

> addListener<T>(event, fn, context?): this

Defined in: node_modules/eventemitter3/index.d.ts:45

Type Parameters

T

T extends "destroy"

Parameters

event

T

fn

(...args) => void

context?

any

Returns

this

Inherited from

Filter.addListener

addResource()

> addResource(name, groupIndex, bindIndex): void

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:218

Sometimes a resource group will be provided later (for example global uniforms) In such cases, this method can be used to let the shader know about the group.

Parameters

name

string

the name of the resource group

groupIndex

number

the index of the group (should match the webGPU shader group location)

bindIndex

number

the index of the bind point (should match the webGPU shader bind point)

Returns

void

Inherited from

Filter.addResource

apply()

> apply(filterManager, input, output, clearMode): void

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:171

Applies the filter

Parameters

filterManager

FilterSystem

The renderer to retrieve the filter from

input

Texture

The input render target.

output

RenderSurface

The target to output to.

clearMode

boolean

Should the output be cleared before rendering to it

Returns

void

Inherited from

Filter.apply

destroy()

> destroy(destroyPrograms?): void

Defined in: node_modules/pixi.js/lib/rendering/renderers/shared/shader/Shader.d.ts:226

Use to destroy the shader when its not longer needed. It will destroy the resources and remove listeners.

Parameters

destroyPrograms?

boolean

if the programs should be destroyed as well. Make sure its not being used by other shaders!

Returns

void

Inherited from

Filter.destroy

emit()

> emit<T>(event, ...args): boolean

Defined in: node_modules/eventemitter3/index.d.ts:32

Calls each of the listeners registered for a given event.

Type Parameters

T

T extends "destroy"

Parameters

event

T

args

...ArgumentMap<{ destroy: Shader; }>[Extract<T, "destroy">]

Returns

boolean

Inherited from

Filter.emit

eventNames()

> eventNames(): "destroy"[]

Defined in: node_modules/eventemitter3/index.d.ts:15

Return an array listing the events for which the emitter has registered listeners.

Returns

"destroy"[]

Inherited from

Filter.eventNames

listenerCount()

> listenerCount(event): number

Defined in: node_modules/eventemitter3/index.d.ts:27

Return the number of listeners listening to a given event.

Parameters

event

"destroy"

Returns

number

Inherited from

Filter.listenerCount

listeners()

> listeners<T>(event): (...args) => void[]

Defined in: node_modules/eventemitter3/index.d.ts:20

Return the listeners registered for a given event.

Type Parameters

T

T extends "destroy"

Parameters

event

T

Returns

(...args) => void[]

Inherited from

Filter.listeners

off()

> off<T>(event, fn?, context?, once?): this

Defined in: node_modules/eventemitter3/index.d.ts:69

Type Parameters

T

T extends "destroy"

Parameters

event

T

fn?

(...args) => void

context?

any

once?

boolean

Returns

this

Inherited from

Filter.off

on()

> on<T>(event, fn, context?): this

Defined in: node_modules/eventemitter3/index.d.ts:40

Add a listener for a given event.

Type Parameters

T

T extends "destroy"

Parameters

event

T

fn

(...args) => void

context?

any

Returns

this

Inherited from

Filter.on

once()

> once<T>(event, fn, context?): this

Defined in: node_modules/eventemitter3/index.d.ts:54

Add a one-time listener for a given event.

Type Parameters

T

T extends "destroy"

Parameters

event

T

fn

(...args) => void

context?

any

Returns

this

Inherited from

Filter.once

removeAllListeners()

> removeAllListeners(event?): this

Defined in: node_modules/eventemitter3/index.d.ts:79

Remove all listeners, or those of the specified event.

Parameters

event?

"destroy"

Returns

this

Inherited from

Filter.removeAllListeners

removeListener()

> removeListener<T>(event, fn?, context?, once?): this

Defined in: node_modules/eventemitter3/index.d.ts:63

Remove the listeners of a given event.

Type Parameters

T

T extends "destroy"

Parameters

event

T

fn?

(...args) => void

context?

any

once?

boolean

Returns

this

Inherited from

Filter.removeListener

from()

> static from(options): Filter

Defined in: node_modules/pixi.js/lib/filters/Filter.d.ts:184

A short hand function to create a filter based of a vertex and fragment shader src.

Parameters

options

FilterOptions & ShaderFromResources

Returns

Filter

A shiny new PixiJS filter!

Inherited from

Filter.from