pulp::canvas::ChromaticAberrationEffect Struct Reference

Chromatic aberration — real per-channel RGB offset for a glitch/lens effect. More...

#include <view_effect.hpp>

Public Member Functions
void	configure_layer (Canvas &canvas, float x, float y, float w, float h) override
	Push the compositing layer(s) this effect needs, configured with its opacity, image filters, blend mode, etc.
virtual int	layer_count () const
	How many layers configure_layer() pushes.
virtual bool	needs_layer () const
	Whether this effect requires a compositing layer (most do).
virtual void	paint_overlay (Canvas &canvas, float x, float y, float w, float h)
	Paint an overlay on TOP of the already-painted subtree, but still INSIDE the effect's compositing layer(s) (called by View::paint_all just before the layers are popped).

Public Attributes
float	offset = 2.0f
	Pixel offset between channels.

Detailed Description

Chromatic aberration — real per-channel RGB offset for a glitch/lens effect.

Post-processes the painted subtree via the SkSL child-shader compositor: the red channel samples offset px to one side and blue offset px to the other, so edges fringe red on one side and blue on the other. On non-Skia backends the compositor falls back to a plain (unfiltered) layer.

Member Function Documentation

configure_layer()

void pulp::canvas::ChromaticAberrationEffect::configure_layer ( Canvas & canvas, float x, float y, float w, float h )

inlineoverridevirtual

Push the compositing layer(s) this effect needs, configured with its opacity, image filters, blend mode, etc.

The subtree paints into the layer(s); the caller pops them once the subtree is done.

An implementation MUST push exactly layer_count() layers. The caller (View::paint_all) pops that many, so an effect that saves a different number than it reports unbalances the canvas save stack for the rest of the frame.

Implements pulp::canvas::ViewEffect.

layer_count()

virtual int pulp::canvas::ViewEffect::layer_count ( ) const

inlinevirtualinherited

How many layers configure_layer() pushes.

One for a simple effect; EffectChain reports the sum across its children.

Reimplemented in pulp::canvas::EffectChain.

needs_layer()

virtual bool pulp::canvas::ViewEffect::needs_layer ( ) const

inlinevirtualinherited

Whether this effect requires a compositing layer (most do).

Reimplemented in pulp::canvas::EffectChain.

paint_overlay()

virtual void pulp::canvas::ViewEffect::paint_overlay ( Canvas & canvas, float x, float y, float w, float h )

inlinevirtualinherited

Paint an overlay on TOP of the already-painted subtree, but still INSIDE the effect's compositing layer(s) (called by View::paint_all just before the layers are popped).

This is how an effect that darkens or tints the finished content — a vignette drawing a radial gradient — is implemented, instead of the wrong "reduce the whole layer's opacity" approximation. Default: nothing.

Limitation: the overlay draws into the innermost still-open layer. That is correct for a single effect (the only non-chain path today), but in a multi-effect EffectChain (e.g. [vignette, blur]) an earlier effect's overlay lands in a later effect's layer and is filtered by it. See the View::paint_all call site — revisit if overlays-in-chains are needed.

Reimplemented in pulp::canvas::EffectChain, and pulp::canvas::VignetteEffect.

Member Data Documentation

offset

float pulp::canvas::ChromaticAberrationEffect::offset = 2.0f

Pixel offset between channels.

---

The documentation for this struct was generated from the following file:

• /home/runner/work/pulp/pulp/core/canvas/include/pulp/canvas/view_effect.hpp