Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pixijs/filters

Collection of community-authored custom display filters for PixiJS
https://github.com/pixijs/filters

filters-pixijs glsl-shaders pixijs webgl

Last synced: 7 days ago
JSON representation

Collection of community-authored custom display filters for PixiJS

Awesome Lists containing this project

README

        

# PixiJS Filters

[![Node.js CI](https://github.com/pixijs/filters/workflows/Node.js%20CI/badge.svg)](https://github.com/pixijs/filters/actions/workflows/nodejs.yml?query=branch%3Amain) [![npm version](https://badge.fury.io/js/pixi-filters.svg)](https://www.npmjs.com/package/pixi-filters)

## Compatibility

Depending on your version of PixiJS, you'll need to figure out which major version of PixiJS Filters to use.

| PixiJS | PixiJS Filters |
|--------|----------------|
| v5.x | v3.x |
| v6.x | v4.x |
| v7.x | v5.x |
| v8.x | v6.x |

## Installation

Installation is available using NPM:

```bash
npm install pixi-filters
```

Alternatively, you can use a CDN such as JSDelivr:

```html

```

If all else failes, you can manually download the bundled file from the [releases](https://github.com/pixijs/filters/releases) section and include it in your project.

## Demo

[View the PixiJS Filters Demo](https://pixijs.io/filters/examples/) to interactively play with filters to see how they work.

## Filters

| Filter | Preview |
|----------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|
| **AdjustmentFilter**
_pixi-filters/adjustment_
[View demo][Adjustment_demo] | ![adjustment](https://filters.pixijs.download/main/screenshots/adjustment.png?v=3) |
| **AdvancedBloomFilter**
_pixi-filters/advanced-bloom_
[View demo][AdvancedBloom_demo] | ![advanced-bloom](https://filters.pixijs.download/main/screenshots/advanced-bloom.png?v=3) |
| **AsciiFilter**
_pixi-filters/ascii_
[View demo][Ascii_demo] | ![ascii](https://filters.pixijs.download/main/screenshots/ascii.png?v=3) |
| **BackdropBlurFilter**
_pixi-filters/backdrop-blur_
[View demo][BackdropBlur_demo] | ![backdrop-blur](https://filters.pixijs.download/main/screenshots/backdrop-blur.png?v=3) |
| **BevelFilter**
_pixi-filters/bevel_
[View demo][Bevel_demo] | ![bevel](https://filters.pixijs.download/main/screenshots/bevel.png?v=3) |
| **BloomFilter**
_pixi-filters/bloom_
[View demo][Bloom_demo] | ![bloom](https://filters.pixijs.download/main/screenshots/bloom.png?v=3) |
| **BulgePinchFilter**
_pixi-filters/bulge-pinch_
[View demo][BulgePinch_demo] | ![bulge-pinch](https://filters.pixijs.download/main/screenshots/bulge-pinch.gif?v=3) |
| **ColorGradientFilter**
_pixi-filters/color-gradient_
[View demo][ColorGradient_demo] | ![color-gradient](https://filters.pixijs.download/main/screenshots/color-gradient.png?v=3) |
| **ColorMapFilter**
_pixi-filters/color-map_
[View demo][ColorMap_demo] | ![color-map](https://filters.pixijs.download/main/screenshots/color-map.png?v=3) |
| **ColorOverlayFilter**
_pixi-filters/color-overlay_
[View demo][ColorOverlay_demo] | ![color-overlay](https://filters.pixijs.download/main/screenshots/color-overlay.png?v=3) |
| **ColorReplaceFilter**
_pixi-filters/color-replace_
[View demo][ColorReplace_demo] | ![color-replace](https://filters.pixijs.download/main/screenshots/color-replace.png?v=3) |
| **ConvolutionFilter**
_pixi-filters/convolution_
[View demo][Convolution_demo] | ![convolution](https://filters.pixijs.download/main/screenshots/convolution.png?v=3) |
| **CrossHatchFilter**
_pixi-filters/cross-hatch_
[View demo][CrossHatch_demo] | ![cross-hatch](https://filters.pixijs.download/main/screenshots/cross-hatch.png?v=3) |
| **CRTFilter**
_pixi-filters/crt_
[View demo][CRT_demo] | ![crt](https://filters.pixijs.download/main/screenshots/crt.png?v=3) |
| **DotFilter**
_pixi-filters/dot_
[View demo][Dot_demo] | ![dot](https://filters.pixijs.download/main/screenshots/dot.png?v=3) |
| **DropShadowFilter**
_pixi-filters/drop-shadow_
[View demo][DropShadow_demo] | ![drop-shadow](https://filters.pixijs.download/main/screenshots/drop-shadow.png?v=3) |
| **EmbossFilter**
_pixi-filters/emboss_
[View demo][Emboss_demo] | ![emboss](https://filters.pixijs.download/main/screenshots/emboss.png?v=3) |
| **GlitchFilter**
_pixi-filters/glitch_
[View demo][Glitch_demo] | ![glitch](https://filters.pixijs.download/main/screenshots/glitch.png?v=1) |
| **GlowFilter**
_pixi-filters/glow_
[View demo][Glow_demo] | ![glow](https://filters.pixijs.download/main/screenshots/glow.png?v=3) |
| **GodrayFilter**
_pixi-filters/godray_
[View demo][Godray_demo] | ![godray](https://filters.pixijs.download/main/screenshots/godray.gif?v=3) |
| **GrayscaleFilter**
_pixi-filters/grayscale_
[View demo][Grayscale_demo] | ![grayscale](https://filters.pixijs.download/main/screenshots/grayscale.png?v=1) |
| **HslAdjustmentFilter**
_pixi-filters/hsl-adjustment_
[View demo][HslAdjustment_demo] | ![hsl-adjustment](https://filters.pixijs.download/main/screenshots/hsl-adjustment.png?v=1) |
| **KawaseBlurFilter**
_pixi-filters/kawase-blur_
[View demo][KawaseBlur_demo] | ![kawase-blur](https://filters.pixijs.download/main/screenshots/kawase-blur.png?v=1) |
| **MotionBlurFilter**
_pixi-filters/motion-blur_
[View demo][MotionBlur_demo] | ![motion-blur](https://filters.pixijs.download/main/screenshots/motion-blur.png?v=1) |
| **MultiColorReplaceFilter**
_pixi-filters/multi-color-replace_
[View demo][MultiColorReplace_demo] | ![multi-color-replace](https://filters.pixijs.download/main/screenshots/multi-color-replace.png?v=1) |
| **OldFilmFilter**
_pixi-filters/old-film_
[View demo][OldFilm_demo] | ![old-film](https://filters.pixijs.download/main/screenshots/old-film.gif?v=3) |
| **OutlineFilter**
_pixi-filters/outline_
[View demo][Outline_demo] | ![outline](https://filters.pixijs.download/main/screenshots/outline.png?v=3) |
| **PixelateFilter**
_pixi-filters/pixelate_
[View demo][Pixelate_demo] | ![pixelate](https://filters.pixijs.download/main/screenshots/pixelate.png?v=3) |
| **RadialBlurFilter**
_pixi-filters/radial-blur_
[View demo][RadialBlur_demo] | ![radial-blur](https://filters.pixijs.download/main/screenshots/radial-blur.png?v=3) |
| **ReflectionFilter**
_pixi-filters/reflection_
[View demo][Reflection_demo] | ![reflection](https://filters.pixijs.download/main/screenshots/reflection.png?v=3) |
| **RGBSplitFilter**
_pixi-filters/rgb-split_
[View demo][RGBSplit_demo] | ![rgb split](https://filters.pixijs.download/main/screenshots/rgb.png?v=3) | |
| **ShockwaveFilter**
_pixi-filters/shockwave_
[View demo][Shockwave_demo] | ![shockwave](https://filters.pixijs.download/main/screenshots/shockwave.gif?v=3) |
| **SimpleLightmapFilter**
_pixi-filters/simple-lightmap_
[View demo][SimpleLightmap_demo] | ![simple-lightmap](https://filters.pixijs.download/main/screenshots/simple-lightmap.png?v=3) |
| **TiltShiftFilter**
_pixi-filters/tilt-shift_
[View demo][TiltShift_demo] | ![tilt-shift](https://filters.pixijs.download/main/screenshots/tilt-shift.png?v=3) |
| **TwistFilter**
_pixi-filters/twist_
[View demo][Twist_demo] | ![twist](https://filters.pixijs.download/main/screenshots/twist.png?v=3) |
| **ZoomBlurFilter**
_pixi-filters/zoom-blur_
[View demo][ZoomBlur_demo] | ![zoom-blur](https://filters.pixijs.download/main/screenshots/zoom-blur.png?v=4) |

## Built-In Filters

PixiJS has a handful of core filters that are built-in to the PixiJS library.

| Filter | Preview |
|-----------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
| **AlphaFilter**
[View demo][Alpha_demo] | ![alpha](https://filters.pixijs.download/main/screenshots/alpha.png?v=3) |
| **BlurFilter**
[View demo][Blur_demo] | ![blur](https://filters.pixijs.download/main/screenshots/blur.png?v=3) |
| **ColorMatrixFilter** (contrast)
[View demo][ColorMatrix_demo] | ![color-matrix-contrast](https://filters.pixijs.download/main/screenshots/color-matrix-contrast.png?v=3) |
| **ColorMatrixFilter** (desaturate)
[View demo][ColorMatrix_demo] | ![color-matrix-desaturate](https://filters.pixijs.download/main/screenshots/color-matrix-desaturate.png?v=3) |
| **ColorMatrixFilter** (kodachrome)
[View demo][ColorMatrix_demo] | ![color-matrix-kodachrome](https://filters.pixijs.download/main/screenshots/color-matrix-kodachrome.png?v=3) |
| **ColorMatrixFilter** (lsd)
[View demo][ColorMatrix_demo] | ![color-matrix-lsd](https://filters.pixijs.download/main/screenshots/color-matrix-lsd.png?v=3) |
| **ColorMatrixFilter** (negative)
[View demo][ColorMatrix_demo] | ![color-matrix-negative](https://filters.pixijs.download/main/screenshots/color-matrix-negative.png?v=3) |
| **ColorMatrixFilter** (polaroid)
[View demo][ColorMatrix_demo] | ![color-matrix-polaroid](https://filters.pixijs.download/main/screenshots/color-matrix-polaroid.png?v=3) |
| **ColorMatrixFilter** (predator)
[View demo][ColorMatrix_demo] | ![color-matrix-predator](https://filters.pixijs.download/main/screenshots/color-matrix-predator.png?v=3) |
| **ColorMatrixFilter** (saturate)
[View demo][ColorMatrix_demo] | ![color-matrix-saturate](https://filters.pixijs.download/main/screenshots/color-matrix-saturate.png?v=3) |
| **ColorMatrixFilter** (sepia)
[View demo][ColorMatrix_demo] | ![color-matrix-sepia](https://filters.pixijs.download/main/screenshots/color-matrix-sepia.png?v=3) |
| **DisplacementFilter**
[View demo][Displacement_demo] | ![displacement](https://filters.pixijs.download/main/screenshots/displacement.png?v=3) |
| **NoiseFilter**
[View demo][Noise_demo] | ![noise](https://filters.pixijs.download/main/screenshots/noise.png?v=3) |

## Building

Install all dependencies by simply running the following.

```bash
npm install
```

Build all filters, demo and screenshots by running the following:

```bash
npm run build
```

Watch all filters and demo (auto-rebuild upon src changes):

```bash
npm run watch
```

## Documentation

API documention can be found [here](http://pixijs.io/filters/docs/).

[Adjustment_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=AdjustmentFilter
[AdvancedBloom_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=AdvancedBloomFilter
[Ascii_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=AsciiFilter
[BackdropBlur_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=BackdropBlurFilter
[Bevel_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=BevelFilter
[Bloom_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=BloomFilter
[BulgePinch_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=BulgePinchFilter
[ColorGradient_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ColorGradientFilter
[ColorMap_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ColorMapFilter
[ColorOverlay_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ColorOverlayFilter
[ColorReplace_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ColorReplaceFilter
[Convolution_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ConvolutionFilter
[CrossHatch_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=CrossHatchFilter
[CRT_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=CRTFilter
[Dot_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=DotFilter
[DropShadow_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=DropShadowFilter
[Emboss_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=EmbossFilter
[Glitch_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=GlitchFilter
[Glow_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=GlowFilter
[Godray_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=GodrayFilter
[Grayscale_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=GrayscaleFilter
[HslAdjustment_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=HslAdjustmentFilter
[KawaseBlur_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=KawaseBlurFilter
[MotionBlur_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=MotionBlurFilter
[MultiColorReplace_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=MultiColorReplaceFilter
[OldFilm_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=OldFilmFilter
[Outline_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=OutlineFilter
[Pixelate_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=PixelateFilter
[RadialBlur_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=RadialBlurFilter
[Reflection_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ReflectionFilter
[RGBSplit_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=RGBSplitFilter
[Shockwave_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ShockwaveFilter
[SimpleLightmap_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=SimpleLightmapFilter
[TiltShift_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=TiltShiftFilter
[Twist_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=TwistFilter
[ZoomBlur_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ZoomBlurFilter
[Alpha_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=AlphaFilter
[Blur_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=BlurFilter
[ColorMatrix_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=ColorMatrixFilter
[Displacement_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=DisplacementFilter
[Noise_demo]: https://filters.pixijs.download/main/examples/index.html?enabled=NoiseFilter