newton_particles 0.3.0

newton_particles: ^0.3.0 copied to clipboard

Breaking Changes #

• [Breaking] Renamed RelativisticEffect to PhysicsEffect and RelativisticEffectConfiguration to PhysicsEffectConfiguration for better clarity and understanding. The old names are deprecated and will be removed in a future version.
• [Breaking] Revamped configuration API with grouped properties for better organization and type safety:
  • Introduced PhysicsProperties, VisualProperties, EmissionProperties, DeterministicProperties, and LayerProperties classes
  • Configuration is now more organized and easier to understand
  • See Migration Guide for details on upgrading

Features #

• [Feature] Widget Collisions: Introduced NewtonCollider widget allowing particles to collide with Flutter widgets. Supports rounded corners, friction, and restitution with accurate physics using Signed Distance Fields (SDF).
• [Feature] Effect Presets: Added preset configurations for common effects:
  • ConfettiPreset - Celebratory confetti effect
  • RainPreset - Realistic rain effect
  • SnowPreset - Snowfall effect
  • ExplosionPreset - Explosion effect
  • FountainPreset - Fountain effect
• [Feature] Particle Pool: Introduced ParticlePool for reusing particle instances, reducing memory allocations and improving performance.
• [Feature] Debug Data Stream: Added debugDataStream to NewtonState for real-time monitoring of particle effects, active particle counts, and performance metrics.
• [Feature] Code Generator: Enhanced configurator with ability to copy generated code for easy integration.

Performance #

• [Performance] Introduced viewport culling to skip rendering particles outside the visible area, significantly improving performance for large particle counts.
• [Performance] Improved particle sorting strategy for more efficient rendering.
• [Performance] Introduced fixture cache in physics engine to avoid unnecessary fixture recreation.
• [Performance] Optimized collider reporting by removing redundant postFrameCallback in NewtonCollider.build() method, reducing unnecessary work on every rebuild.

Fixes #

• [Fix] Added missing setState() call to clearEffects() method to ensure proper widget rebuild.
• [Fix] Fixed colliders stopping to work when configuration properties (delay, particles per emit, etc.) were changed. Colliders now properly re-report their positions after configuration changes.
• [Fix] Colliders are now preserved during temporary coordinate conversion failures that can occur during widget rebuilds.
• [Fix] Improved collider syncing to physics effects, ensuring colliders are properly synchronized when effects are updated or recreated.

Documentation #

• [Docs] Added comprehensive migration guide for upgrading from 0.2.x to 0.3.x.
• [Docs] Added widget collisions documentation with examples and best practices.
• [Docs] Updated presets documentation with new preset system.
• [Docs] Improved overall documentation structure and clarity.

• [Chore] Fix lints and upgrade dependencies
• [Fix] Fix foreground property not behaving as expected. Thanks @redredninjacat.
• [Feat] Implemented ShapeBuilder and ZIndexBuilder. Thanks @redninjacat.

• [Fix] Remove code generation that is not available for now.
• [Fix] Use gif instead of a video.

• [Fix] Pub.dev doc site

• [Breaking] Support physics based animation. Revamp the way effects are configured and added to the Newton widget.
• [Breaking] Replace duration based properties as int by Duration.
• [Breaking] Origin is now relative to the widget size.
• [Performance] No more unnecessary repaints. thanks @VonZen
• [Performance] Images are now properly garbage collected when animations end.

Fix #

• [Fix] Fix #24 Fix name collision in NewtonState.removeEffect by @KriseevM

• [Fix] Add missing setState to clearEffects by @jannikhst

Fix #

• [Fix] Fix #20 use right size for image shape

Feature #

• [Feature] Add support for background and foreground effects
• [Feature] Add/remove effects at runtime

Feature #

• [Feature] Add links to repo and issue tracker + version badge.

Feature #

• [Feature] Allow to listen to effect state changes.

Fix #

• [Fixed] Properly dispose animation ticker.

Fix #

• [Fixed] Use raw.github for logo display.

Fix #

• [Fixed] Fix logo display on pub.dev.

Fix #

• [Fixed] Improve performance drastically by using drawAtlas as much as possible.

Feature #

• [Feature] Support trailing to achieve a shooting star effect.

Fixed #

• [Fix] Fix concurrent modification when post effect is triggered.

Feature #

• [Feature] Allow to add a post effect to a particle.
• [Feature] Allow a finite number of particles.
• [Feature] Add firework example.

Feature #

• [Feature] Allow color configuration for particles.

Fixed #

• [Fix] Ensure repaint won't happen outside of Newton widget.
• [Fix] Improve performance by disabling compositor cache.

Fixed #

• [Fix] Center title for effects.

Fixed #

• [Fix] Fix display of the logo on pub.dev.

Fixed #

• [Fix] Fix display of doc on pub site.

Feature #

• [Feature] Doc update with logo and sample gifs.

Feature #

• [Feature] Introduce the notion of PathTransformation for particles.
• [Feature] Add a fountain like effect.

Feature #

• [Feature] Add dart docs.
• [Feature] Allow to stop/start/kill an effect.

Fixed #

• [Fix] Fix some imports.

Feature #

• [Feature] Rework how effects are configured for better configurability.
• [Feature] Allow to configure angle in smoke effect from configurator.
• [Feature] Add pulse effect.

Fixed #

• [Fix] Fix documentation.

Added #

• [Feature] Initial release of Newton package.
• [Feature] Implemented a highly configurable particle emitter with default effects.