Post-Processing

Collection of useful helpers and fully functional, ready-made post-processing effects for Tres

• 💡 Build your effects with Vue components only.
• ⚡️ Powered by Vite
• 🦾 Fully Typed

Installation

pnpm i @tresjs/post-processing

Docs

Checkout the docs

Demos

• Stackblitz Collection

Contributing

We are open to contributions, please read the contributing guide to get started.

Build

To build the package run:

pnpm run build

Playground

To run the playground run, its a great way to test the components and helpers locally:

First install dependencies

pnpm i

And then to run the development server on http://localhost:5173

pnpm run playground

Docs

To run de docs in dev mode

pnpm run docs:dev

To build them

pnpm run docs:build

License

MIT

Sponsors

Be the first to support this project here ☺️

Changelog

2.3.1 (2025-03-29)

Bug Fixes

• god rays async light source (#194) (7c5bfe0)

2.3.0 (2025-03-26)

Features

• postprocessing: re-instance effect on prop changes without set (#193) (2104f16)

2.2.0 (2025-03-10)

Features

• brightness contrast (#184) (0df3394)
• color depth (#186) (c09851c)
• fish-eye (#182) (826d832)
• god rays (#187) (eafe305)
• grid (#185) (212312e)

Bug Fixes

• add exported member depth picking pass pmndrs (#179) (6f3d459)
• delete multisampling used in TresCanvas props (#188) (507b517), closes #189
• sorted navigation entries (#190) (cf4aad2)

2.1.0 (2025-01-29)

Features

• add barrel blur effect (#159) (84cc46a)
• add chromatic aberration effect (#149) (8fc0321)
• add hue & saturation (#151) (f5a699f)
• add scanline (#150) (f3da309)
• add sepia effect (#161) (2137673)
• add shock wave (#164) (6fa0e3c)
• add tonemapping effect (#148) (db77fc6)
• color average (#166) (03f4986)
• dot screen effect (#167) (a0e957c)
• kuwahara (#172) (29927aa)
• lens distortion effect (#162) (0ee8267)
• linotcut (#170) (bfb64ef)
• tilt shift effect (#160) (ab9c8a0)

Bug Fixes

• fix effect name (#165) (5df6957)
• modify config doc and emojis (#174) (64ef99e)
• typescript-build-issues related to DepthPicking and Linocut (#175) (a2d90b0)

2.0.0 (2025-01-03)

⚠ BREAKING CHANGES

• Consolidated post-processing effects under a unified namespace (@tresjs/post-processing). Pmndrs EffectComposer is now EffectComposerPmndrs, same for all the effects and composables under src/core/pmndrs to avoid name collisions

• chore: remove nuxt playground

• docs: updated docs to breaking changes

• chore: update deps and tsconfig for docs

• fix: adjusted aliases in vite config

Bug Fixes

• unified-exports-suffix-pmndrs-effects (#154) (3a2ec97)

1.0.0 (2024-11-26)

Features

• native threejs effects (#121) (cd24a57)
• prop types exposure (#136) (bd6ff06)
• sub modules for pmndrs and native components (#123) (c8df59f)

Bug Fixes

• 67 depth of field and outline effect (#138) (3112305)

1.0.0-next.1 (2024-07-26)

Features

• export useEffect composable (#105) (b7810ba)
• update core to v4 (#109) (f79cb28)

1.0.0-next.0 (2024-05-21)

Features

• export useEffect composable (#105) (b7810ba)
• render emit and advance playgroudn for render modes (5d256fc)
• update to v4, useLoop and remove disable render (544fb39)

0.7.1 (2024-03-18)

Bug Fixes

• expose effectComposer (#83) (4878a95)
• multisampling prop value (#102) (dce70cc)

0.7.0 (2023-11-14)

Features

• vignette effect (#75) (70c92da)

Bug Fixes

• avoid recursive updates when resizing the window (#81) (83f88c1)

0.6.0 (2023-11-14)

Features

• 66 noise (#71) (cdb9497)

0.6.0-next.0 (2023-10-30)

Features

• noise effect (9f65ebf)

0.5.0 (2023-10-28)

Features

• 50 similar linting rules throughout the tresjs packages (#51) (1ea91b8)
• post-processing: depth of field effect (#56) (9264231)
• post-processing: pixelation effect (#68) (8e3e583)
• post-processing: refactor of existing effects (#64) (a2afd3f)

Bug Fixes

• 58 postprocessing breaks on nuxt (#69) (013b4a1)
• deps: update dependency @tresjs/core to v3.2.0 (#53) (4ec3156)

0.4.0 (2023-09-06)

Features

• refactor usecore to new state context provider (#44) (9f920f1)

Bug Fixes

• deps: update dependency @tresjs/core to v2.4.0 (#20) (5725498)
• deps: update dependency @tresjs/core to v3.1.1 (#48) (09fc4f8)
• made effect composer live only when canvas has an area (#46) (7238cb3)

0.3.0 (2023-06-26)

Features

• 23 refactor effects to vue files (#28) (a84149b)

Bug Fixes

• compute localCamera (#31) (bff26d7)

0.2.1 (2023-06-19)

Bug Fixes

• updated @tresjs/core to v2.2.0 (#27) (ae6f464)

0.2.0 (2023-06-11)

Features

• better disposal of effects (5ceef70)
• bloom effect done right (95fd5a6)
• effect composer sfc (5fa7671)
• export types esm first (594948f)
• glitch looking good (455fe56)
• outline sfc component (b4fb2ca)

Bug Fixes

• deps: update dependency @tresjs/cientos to v2.1.0 (ca9cc61)
• deps: update dependency @tresjs/cientos to v2.1.2 (f1ced0e)
• post-processing: made playground runnable (03af258)
• type assetion on Bloom effect (78af757)