Installation
Choose your framework. The registry installs one component file and its PixiJS dependency.
Installation unavailable
The preview is public, but its installable release is still being prepared.
The registry command writes the component to src/lib/components/ui/FluidWatercolorReveal.svelte and installs its dependencies.
The registry command writes the component to src/components/ui/FluidWatercolorReveal.tsx and installs its dependencies.
The registry command writes the component to src/components/ui/FluidWatercolorReveal.vue and installs its dependencies.
Overview
Fluid Watercolor Reveal derives a Sobel structure tensor from the fitted source, then uses its dominant orientation to guide an eight-sector anisotropic Kuwahara filter.
The cached watercolor result becomes a monochrome paper print. Pointer-driven fluid dye reveals its full-color watercolor rendering without recalculating the filter passes every frame.
Basic usage
The shader fills its parent. Your layout decides whether that parent is a card, hero, or viewport.
- Move the pointer across the image to reveal the full-color watercolor rendering.
- Watercolor radius reruns the cached filter; fluid and color controls update independently.
- Higher filter radius, target resolution, and device pixel ratio increase the one-time preprocessing cost.
Component API
Types below match the selected Svelte component.
Additional classes for the parent-sized root element.
- Type
string
URL or data URL processed by the watercolor and fluid passes.
- Type
string- Range / values
Image URL or data URL
Controls how the source image is placed inside the canvas.
- Type
"cover" | "fit" | "stretch"- Default
"cover"- Range / values
cover, fit, stretch
Radius of the structure-tensor-guided anisotropic Kuwahara filter.
- Type
number- Default
6- Range / values
1–12
Light tone used by the monochrome paper rendering.
- Type
string- Default
"#F4F1E8"
Dark tone used by the monochrome watercolor rendering.
- Type
string- Default
"#181715"
Strength of the procedural paper grain shared with Pencil Logo.
- Type
number- Default
1- Range / values
0–2
Saturation of the watercolor color revealed by the fluid mask.
- Type
number- Default
2- Range / values
0–2
Resolution of the short side of the velocity and pressure grid.
- Type
number- Default
256- Range / values
32–256
Resolution of the short side of the transported dye field.
- Type
number- Default
1024- Range / values
128–1024
Dye decay rate used by result / (1 + rate × dt).
- Type
number- Default
1- Range / values
0–4
Velocity decay rate used by result / (1 + rate × dt).
- Type
number- Default
0.05- Range / values
0–4
Pressure retained before the Jacobi solve each physics step.
- Type
number- Default
0.8- Range / values
0–1
Jacobi iterations used to solve pressure each physics step.
- Type
number- Default
1- Range / values
1–40
Strength of vorticity confinement that restores small eddies.
- Type
number- Default
0- Range / values
0–50
Pointer splat radius in the reference's 0.01–1.00 scale.
- Type
number- Default
0.87- Range / values
0.01–1
Multiplier applied to normalized, aspect-corrected pointer deltas.
- Type
number- Default
6000- Range / values
0–10000
Softness of the fluid color boundary.
- Type
number- Default
0.22- Range / values
0.01–0.49
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Enables pointer-driven effects when the shader supports them.
- Type
boolean- Default
true
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
Component public instance- Range / values
pause, resume, reset, resize, destroy
Types below match the selected React component.
Additional classes for the parent-sized root element.
- Type
string
URL or data URL processed by the watercolor and fluid passes.
- Type
string- Range / values
Image URL or data URL
Controls how the source image is placed inside the canvas.
- Type
"cover" | "fit" | "stretch"- Default
"cover"- Range / values
cover, fit, stretch
Radius of the structure-tensor-guided anisotropic Kuwahara filter.
- Type
number- Default
6- Range / values
1–12
Light tone used by the monochrome paper rendering.
- Type
string- Default
"#F4F1E8"
Dark tone used by the monochrome watercolor rendering.
- Type
string- Default
"#181715"
Strength of the procedural paper grain shared with Pencil Logo.
- Type
number- Default
1- Range / values
0–2
Saturation of the watercolor color revealed by the fluid mask.
- Type
number- Default
2- Range / values
0–2
Resolution of the short side of the velocity and pressure grid.
- Type
number- Default
256- Range / values
32–256
Resolution of the short side of the transported dye field.
- Type
number- Default
1024- Range / values
128–1024
Dye decay rate used by result / (1 + rate × dt).
- Type
number- Default
1- Range / values
0–4
Velocity decay rate used by result / (1 + rate × dt).
- Type
number- Default
0.05- Range / values
0–4
Pressure retained before the Jacobi solve each physics step.
- Type
number- Default
0.8- Range / values
0–1
Jacobi iterations used to solve pressure each physics step.
- Type
number- Default
1- Range / values
1–40
Strength of vorticity confinement that restores small eddies.
- Type
number- Default
0- Range / values
0–50
Pointer splat radius in the reference's 0.01–1.00 scale.
- Type
number- Default
0.87- Range / values
0.01–1
Multiplier applied to normalized, aspect-corrected pointer deltas.
- Type
number- Default
6000- Range / values
0–10000
Softness of the fluid color boundary.
- Type
number- Default
0.22- Range / values
0.01–0.49
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Enables pointer-driven effects when the shader supports them.
- Type
boolean- Default
true
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
FluidWatercolorRevealHandle- Range / values
pause, resume, reset, resize, destroy
Types below match the selected Vue component.
Additional classes for the parent-sized root element.
- Type
string
URL or data URL processed by the watercolor and fluid passes.
- Type
string- Range / values
Image URL or data URL
Controls how the source image is placed inside the canvas.
- Type
"cover" | "fit" | "stretch"- Default
"cover"- Range / values
cover, fit, stretch
Radius of the structure-tensor-guided anisotropic Kuwahara filter.
- Type
number- Default
6- Range / values
1–12
Light tone used by the monochrome paper rendering.
- Type
string- Default
"#F4F1E8"
Dark tone used by the monochrome watercolor rendering.
- Type
string- Default
"#181715"
Strength of the procedural paper grain shared with Pencil Logo.
- Type
number- Default
1- Range / values
0–2
Saturation of the watercolor color revealed by the fluid mask.
- Type
number- Default
2- Range / values
0–2
Resolution of the short side of the velocity and pressure grid.
- Type
number- Default
256- Range / values
32–256
Resolution of the short side of the transported dye field.
- Type
number- Default
1024- Range / values
128–1024
Dye decay rate used by result / (1 + rate × dt).
- Type
number- Default
1- Range / values
0–4
Velocity decay rate used by result / (1 + rate × dt).
- Type
number- Default
0.05- Range / values
0–4
Pressure retained before the Jacobi solve each physics step.
- Type
number- Default
0.8- Range / values
0–1
Jacobi iterations used to solve pressure each physics step.
- Type
number- Default
1- Range / values
1–40
Strength of vorticity confinement that restores small eddies.
- Type
number- Default
0- Range / values
0–50
Pointer splat radius in the reference's 0.01–1.00 scale.
- Type
number- Default
0.87- Range / values
0.01–1
Multiplier applied to normalized, aspect-corrected pointer deltas.
- Type
number- Default
6000- Range / values
0–10000
Softness of the fluid color boundary.
- Type
number- Default
0.22- Range / values
0.01–0.49
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Enables pointer-driven effects when the shader supports them.
- Type
boolean- Default
true
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
Component public instance- Range / values
pause, resume, reset, resize, destroy