feat: tonemapping effect

[damienmontastier]

This component introduces the ToneMapping effect, which provides an abstraction for various tone mapping algorithms from the pmndrs/postprocessing package. The <ToneMapping> effect is specifically designed to improve the visual rendering of HDR content by mapping high-range brightness values to a displayable range, thus enhancing luminance and color balance in the scene.

• Fixes potential issues with incorrect colors when EffectComposer is added by applying tone mapping manually as an effect.
• Easy to set up — simply include it in your <EffectComposer> pipeline.
• Multiple tone mapping modes and options for fine-tuning luminance are available.
• Fully supports different blend functions for enhanced visual styles.

For more details, see ToneMapping on pmndrs/postprocessing.

---

Local Playground — pnpm run playground

Local Documentation — pnpm run docs:dev

---

@alvarosabu @Tinoooo

[Tinoooo]

Thank you @damienmontastier for your PR. Very helpful!

[Tinoooo]

suggestion: While I like to have a full example on the page, I think it is better to stay uniform with the other effects and only show the usage.

[damienmontastier]

I think it's a shame that we don't produce slightly advanced demos to present concrete use cases.

What do you think @alvarosabu ?

[Tinoooo]

I agree. The downside would be, that there can be increased maintenance effort in case the parameters of the effects change upstream.

I'm fine as long as the docs are uniform.

[Tinoooo]

Let's leave it the way it is for now and decide later. The advantage of having the effect outweighs the non-uniform docs.

[alvarosabu]

Hi guys, I agree with Tino here, from a documentation perspective, it's always better to stay simple and focus on the usage of the effect. For advance demos we can always use the Cookbook https://docs.tresjs.org/cookbook/

[alvarosabu]

Hi @damienmontastier, we will need to update this PR (and probably all the others) to adapt to the breaking change introduced in v2 https://github.com/Tresjs/post-processing/releases/tag/2.0.0

Mostly adding the correct Suffix to the effects if they are from the pmndrs/postprocessing package. Let me know if you have any questions or we can help you out.

Sorry about this

[damienmontastier]

@alvarosabu I've just adapted the ToneMapping component for V2 of the package ✌️