Snowfall or Anythings

A Flutter package to create beautiful snowfall or other particle effects in your applications with high performance and extensive customization options.

Features

🎨 Multiple particle types (circular, snowflake, star, heart, leaf, raindrop)
⚡ High performance with optimized rendering
🎮 Full control over animation parameters
🔧 Highly customizable (colors, sizes, speeds, shapes)
📱 Responsive design with proper screen adaptation
🎯 Custom painter support for advanced effects
🧩 Widget-based particles for maximum flexibility
⏱️ Configurable frame rate for performance tuning

Particle Types

Type	Description	Best For
⚪ `circular`	Simple filled circles	Rain, bubbles, generic effects
❄️ `snowflake`	6-branched snowflake with details	Winter/snow themes
⭐ `star`	5-pointed stars with rotation	Night sky, magical effects
❤️ `heart`	Heart shapes using Bézier curves	Valentine's, love themes
🍂 `leaf`	Realistic leaves with veins	Autumn, nature themes
💧 `raindrop`	Teardrop shapes	Rain, water effects

Installation

Add the following to your pubspec.yaml file:

dependencies:
    snowfall_or_anythings: ^0.0.7

Then run:

flutter pub get

Usage

Basic Snowfall Example

The simplest way to add a snowfall effect to your app:

import 'package:snowfall_or_anythings/snowfall_or_anythings.dart';

class SnowPage extends StatelessWidget {
  const SnowPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Snowfall Demo'),
      ),
      body: const SnowfallOrAnythings(
        numberOfParticles: 200,
        particleSize: 4.0,
        particleSpeed: 0.8,
        particleType: ParticleType.snowflake,
      ),
    );
  }
}

Circular Particles

Use circular particles instead of snowflakes:

SnowfallOrAnythings(
  numberOfParticles: 150,
  particleSize: 6.0,
  particleSpeed: 1.2,
  particleColor: Colors.blue,
  particleType: ParticleType.circular,
)

Star Particles

Create a starry night effect:

SnowfallOrAnythings(
  numberOfParticles: 100,
  particleSize: 10.0,
  particleSpeed: 0.8,
  particleColor: Colors.yellow,
  particleType: ParticleType.star,
)

Heart Particles

Perfect for Valentine's Day or love-themed apps:

SnowfallOrAnythings(
  numberOfParticles: 80,
  particleSize: 12.0,
  particleSpeed: 1.0,
  particleColor: Colors.pink,
  particleType: ParticleType.heart,
)

Leaf Particles

Create an autumn falling leaves effect:

SnowfallOrAnythings(
  numberOfParticles: 60,
  particleSize: 15.0,
  particleSpeed: 1.2,
  particleColor: Colors.orange,
  particleType: ParticleType.leaf,
)

Raindrop Particles

Simulate rain with teardrop-shaped particles:

SnowfallOrAnythings(
  numberOfParticles: 200,
  particleSize: 8.0,
  particleSpeed: 3.0,
  particleColor: Colors.lightBlue,
  particleType: ParticleType.raindrop,
)

Performance Tuning

Control the frame rate for performance optimization:

SnowfallOrAnythings(
  numberOfParticles: 300,
  particleSize: 4.0,
  particleSpeed: 1.0,
  particleType: ParticleType.snowflake,
  frameRateMs: 33, // ~30 FPS for better battery life
)

Frame rate guide:

8ms = ~120 FPS (very smooth, higher CPU usage)
16ms = ~60 FPS (default, balanced)
33ms = ~30 FPS (good for battery saving)

Custom Painter Example

Create your own particle shapes with custom painters:

class CustomPaintPage extends StatelessWidget {
  const CustomPaintPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('CustomPainter Demo'),
      ),
      body: SnowfallOrAnythings(
        particleColor: Colors.green,
        numberOfParticles: 150,
        particleSize: 10.0,
        particleSpeed: 2.0,
        customPainter: ({required particles}) =>
            CustomParticlePainter(particles),
      ),
    );
  }
}

class CustomParticlePainter extends CustomPainter {
  final List<Particle> particles;

  CustomParticlePainter(this.particles);

  @override
  void paint(Canvas canvas, Size size) {
    final paint = Paint();

    for (final particle in particles) {
      paint.color = particle.color;
      // Draw squares instead of circles
      canvas.drawRect(
        Rect.fromCenter(
          center: Offset(particle.x, particle.y),
          width: particle.size,
          height: particle.size,
        ),
        paint,
      );
    }
  }

  @override
  bool shouldRepaint(covariant CustomPainter oldDelegate) => true;
}

Use any Flutter widget as particles:

SnowfallOrAnythings(
  numberOfParticles: 50,
  particleSize: 20.0,
  particleSpeed: 1.5,
  particleWidget: const Icon(
    Icons.favorite,
    color: Colors.red,
  ),
)

Or use images:

SnowfallOrAnythings(
  numberOfParticles: 100,
  particleSize: 30.0,
  particleSpeed: 1.0,
  particleWidget: Image.asset('assets/snowflake.png'),
)

Result

Gravando 2024-11-24 010503

Parameters