@whatisjery/react-fluid-distortion
TypeScript icon, indicating that this package has built-in type declarations

1.3.6 • Public • Published

Version

Fluid Distortion for React Three Fiber

screen capture

Implementing post-processing fluid distortion effects in response to cursor interactions for React-Three-Fiber. Based on the shaders developed by Pavel Dobryakov

Try it :

codesandbox

Installation :

npm install @whatisjery/react-fluid-distortion @react-three/drei @react-three/postprocessing postprocessing leva

Example of use :

import { Fluid } from '@/whatisjery/react-fluid-distortion';
import { EffectComposer } from '@react-three/postprocessing';
import { Canvas } from '@react-three/fiber';

<Canvas
    style={{
        position: 'fixed',
        top: 0,
        left: 0,
        height: '100vh',
        width: '100vw',
        background: '#000000',
    }}>
    <EffectComposer>
        <Fluid />
        {... other effets}
    </EffectComposer>
</Canvas>;

Display configuration panel :

Show a debug panel to test options more easily.

const config = useConfig();

...

<Fluid {...config} />

Options :

Name Type Default Value Description
fluidColor hexadecimal #005eff Sets the fluid color. Effective only when rainbow is set to false.
backgroundColor string #070410 Sets the background color. Effective only when showBackground is true.
showBackground boolean false Toggles the background color's visibility. If false it becomes transprent.
blend number 5 Blends fluid into the scene when showBackground is true. Valid range: 0.00 to 10.0.
intensity number 10 Sets the fluid intensity. Valid range: 0 to 10.
force number 2 Multiplies the mouse velocity to increase fluid splatter. Valid range: 0.0 to 20.
distortion number 2 Sets the distortion amount. Valid range: 0.00 to 2.00.
radius number 0.3 Sets the fluid radius. Valid range: 0.01 to 1.00.
curl number 10 Sets the amount of the curl effect. Valid range: 0.0 to 50.
swirl number 20 Sets the amount of the swirling effect. Valid range: 0 to 20.
velocityDissipation number 0.99 Reduces the fluid velocity over time. Valid range: 0.00 to 1.00.
densitionDissipation number 0.95 Reduces the fluid density over time. Valid range: 0.00 to 1.00.
pressure number 0.80 Controls the reduction of pressure. Valid range: 0.00 to 1.00.
rainbow boolean true Activates color mode based on mouse direction. No range applicable as this is a boolean value.

Usage with nextjs

If you're working with an older version of Next.js, you may get this type of error:

TypeError: Cannot read properties of undefined (reading '__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED')

To fix it, you can enable package transpilation in your next.config file. Here’s how:

const nextConfig = {
    transpilePackages: ['@whatisjery/react-fluid-distortion'],
};

module.exports = nextConfig;

Package Sidebar

Install

npm i @whatisjery/react-fluid-distortion

Weekly Downloads

101

Version

1.3.6

License

MIT

Unpacked Size

296 kB

Total Files

32

Last publish

Collaborators

  • whatisjery