@mszstudio/vortex-effects 🌊

High-Performance Visual Effects Suite for VORTEX.

This package contains the official suite of GPU visual effects for the VORTEX engine.

🎨 Included Effects

1. Liquid Distortion (LiquidEffect): Flagship fluid simulation with multi-octave domain warping, viscous flow, interactive mouse wake, and chromatic RGB dispersion.
2. GPU Particle Engine (ParticleEffect): Instanced point sprites powered by 3D curl turbulence and interactive gravitational attraction/repulsion fields.
3. 3D Tilt Cards (Card3DEffect): Zero-overhead hardware-accelerated 3D perspective tilting with physics spring damping and holographic sheen.
4. Refractive Glass (GlassEffect): Real-time frosted glass shader with procedural noise blur and chromatic aberration.
5. Image Distortion (DistortionEffect): Interactive displacement mapping using noise or custom grayscale textures.
6. Bloom & Glow (GlowEffect): Multi-pass separable Gaussian blur bloom using ping-pong framebuffers.

📦 Installation

# pnpm
pnpm add @mszstudio/vortex @mszstudio/vortex-effects

# npm
npm install @mszstudio/vortex @mszstudio/vortex-effects

🚀 Usage

import { Vortex } from '@mszstudio/vortex';
import '@mszstudio/vortex-effects';

const vortex = new Vortex();

// Liquid Distortion
vortex.liquid('#hero', {
  intensity: 0.8,
  speed: 0.5,
  scale: 1.8,
  chromaticAberration: 0.05,
});

// GPU Particles
vortex.particles('#particles', {
  count: 5000,
  size: 3.5,
  turbulence: 0.8,
  attraction: 1.0,
});

📄 License

MIT © MSZ Studio