Added SequenceEffect, which performs a series of other effects.
The biggest challenge in implementing this feature came from the need to run the sequence in reverse, due to the alternate flag. This required that every effect and every controller supported running "back in time", which is not as simple as it sounds.
The following breaking changes were introduced:
The Effect class no longer supports .reverse() method and .isReversed flag.
This flag was added only 2 weeks ago (
Effect controllers restructuring #1134), with the idea that it will be necessary for the SequenceEffect. However, as it turned out, this flag is not as helpful as I thought it would be. In fact, given the user's ability to change it any point, it makes the implementation very error-prone.
To be clear, the ability for each effect to run in reverse remains -- only now it can no longer be triggered by the user manually. Instead, SequenceEffect triggers that ability itself at the alternation point. If there is demand in the future to manually force any effect to run backwards, we could restore this flag, but this would require thorough testing to make it work correctly.
Infinite effects now return duration = double.infinity instead of null, which seems more appropriate.
Simple alternating effect controller. Over the course of one period, this controller will proceed
linearly from 0 to 1, then to -1, and then back to 0. Use this for oscillating effects where the
starting position should be the center of the oscillations, rather than the extreme (as provided
by the standard alternating EffectController).
This:
Add new rule use_if_null_to_convert_nulls_to_bools to flame_lint (no violations)
Add new rule use_key_in_widget_constructors (several violations)
Fix violations
Exclude generated files from flame_lint (we don't have any on this repo but when using on games often there are)
I believe this is not a breaking change because it just adds optional arguments to constructors, but if it is, we can reconsider this PR.
* Added Component.childrenFactory
* fix some of the lint warnings
* more lint warnings
* remove changelog entry
* more analyzer warnings
* one more warning
* one more warning
* remove more unused imports
* fix more warnings
* another warning
* one more warning
* a lot more warnings
* some more warnings
* fix warnings in flame_svg
* fix warnings in flame_bloc
* Remove OrderedSet override feature
* Remove testRandom change
* Remove unnecessary type checks
* Re-remove deprecated argument in random_test
Co-authored-by: Pasha Stetsenko <stpasha@google.com>
* Implementing ColorEffect on the new effects system
* docs and test
* docs
* Apply suggestions from code review
Co-authored-by: Lukas Klingsbo <lukas.klingsbo@gmail.com>
* PR suggestions
Co-authored-by: Lukas Klingsbo <lukas.klingsbo@gmail.com>
* MoveAlongPathEffect separated from MoveEffect
* rename _lastPosition -> _lastOffset
* Added absolute= flag in MoveAlongPathEffect
* added test for absolute path
* add oriented= flag
* added test
* changelog
Co-authored-by: Lukas Klingsbo <lukas.klingsbo@gmail.com>
* Camera as an internal component
* Correct respectCamera
* Added changelog entry
* Add super call that will later be removed
* Rename callRender -> callOwnRender
* Don't call render when root
* Remove callOwnRender
* Skip CameraWrapper in own renderTree
* Too complex to have camera as component
* Revert test
* Update docs for respectCamera
* Move down field
* Fix changelog
* OpacityEffect example
* Add OpacityEffect example
* Added test for OpacityEffect
* Added changelog entry
* Fix dartdocs
* Reset rounding errors between runs
* Fix test and rounding error
* Update rounding error calculation
* Rounding error should be private
* Bump test epsilon
* Added the `SizeEffect` and a general `ComponentEffect`
* Added changelog entry
* Format throw
* Fix analyze issue
* Fix Transform2DEffect test
* Apply suggestions from code review
Co-authored-by: Luan Nico <luanpotter27@gmail.com>
* Fix missing example parenthesis
* Fix according to comments
Co-authored-by: Luan Nico <luanpotter27@gmail.com>
* Animations, CameraAndViewport, CollisionDetection and Components unified
* Added descriptions to effects
* Rename input games
* Unify input stories
* Add info to parallax section
* Added descriptions to the rendering examples
* Add descriptions to the sprites directory
* Fix utils and rendering section
* Add descriptions to the widgets section
* Delete directory that rebase brought back
* Unify game names
* Added some styleguide docs for examples
* Fix analyze issues
* All files should have _example as suffix
* Made the FollowComponentExample a bit easier to understand
* Change priority of ember
* `ShapeComponent` changes size, position and angle of underlying Shape
* Added description to ShapeComponent
* Fix test
* Update packages/flame/lib/src/components/shape_component.dart
Co-authored-by: Erick <erickzanardoo@gmail.com>
* Add absoluteScale and absoluteAngle to PositionComponent
* Refactor ShapeComponent
* Should be scaled by total scale, not scaled size
* Premature optimization for creation for objects in Polygon
* Use path for default Polygon constructor
* Do not sync component and hitbox shape
* Fix analyze issue
* Add example for flipping with collision detection
* Don't use absoluteScale
* Fix examples
* Fix examples
* Doesn't need super.render
* Fix Circle dartdoc
* Update changelog
* Update names of vertices caches in Polygon
* Update text docs
* Revert "Update text docs"
This reverts commit 73a68a465d76eb0eb50bb3753e57b2f4e3b5a7f4.
* Fix examples
* ShapeComponents docs
* Move example games to the top
* Fix dartdoc comment about polygon vertex relation
* Fix order of polygon vertices in dartdoc
* Fix anchor for PolygonComponent.fromPoints
* Add test with ancestors
* Update doc/components.md
Co-authored-by: Pasha Stetsenko <stpasha@google.com>
* Update doc/components.md
Co-authored-by: Erick <erickzanardoo@gmail.com>
* Rename example classes
* Fix linting issues in examples
* Don't use px
* Use isTrue and isFalse
* Update doc/components.md
Co-authored-by: Erick <erickzanardoo@gmail.com>
* Fixed comments on PR
Co-authored-by: Erick <erickzanardoo@gmail.com>
Co-authored-by: Pasha Stetsenko <stpasha@google.com>
* Add `randomColor` to the `Color` extension
* Add flame rive package to monorepo (#1048)
Add flame rive package to monorepo
* Add random to PaintExtension
* Update examples/pubspec.yaml
Co-authored-by: Erick <erickzanardoo@gmail.com>
Co-authored-by: Renan <6718144+renancaraujo@users.noreply.github.com>
Co-authored-by: Erick <erickzanardoo@gmail.com>
* Simplified the usage of ShapeComponent
* Default constructor for _RandomCircle
* Use default constructor
* Forced Anchor.center on ShapeComponent
* Fix examples using SquareComponent
* Removed unnecesary import
* Renamed edgeLength to size
* Added FlameAnimationController class
* Added MainAnimationController class
* Update doc comments
* formatting
* rename MainAnimationController
* Added tests for StandardAnimationController
* Added more tests
* comment
* Added changelog note
* Export StandardAnimationController
* formatting
* Use a default for 'curve' parameter
* rename onsetDelay -> startDelay
* Added Transofm2DEffect
* Added EffectComponent
* Added .transform getter
* formatting
* Rename EffectComponent -> Effect
* Add documentation for the Effect class
* minor
* Added a test for Effect class
* Adding tests for removeOnFinish
* Adding tests for onStart and onFinish
* Also check the effect after reset
* Fix-up merge
* formatting
* added doc-comments
* changelog note
* Added test for transform2DEffect
* Adjusted comments
* Make PositionComponent._transform public
* change changelog
* Adding RotateEffect
* wip on rotate2 example
* Rename -> RotateEffect2
* export rotation effect
* Finish example for RotateEffect2
* formatting
* rename RotateEffect2 -> RotateEffect
* Changelog note
* Added test file
* flutter format
* Remove a print() call
* _lastProgress moved to Transform2DEffect class
* remove avoid_print for now
* Moved description
* Initialize paints during construction
* Added a random test
* flutter format
Co-authored-by: Lukas Klingsbo <lukas.klingsbo@gmail.com>
* Added FlameAnimationController class
* Added MainAnimationController class
* Update doc comments
* formatting
* rename MainAnimationController
* Added tests for StandardAnimationController
* Added more tests
* comment
* Added changelog note
* Export StandardAnimationController
* formatting
* Use a default for 'curve' parameter
* rename onsetDelay -> startDelay
* Added Transofm2DEffect
* Added EffectComponent
* Added .transform getter
* formatting
* Rename EffectComponent -> Effect
* Add documentation for the Effect class
* minor
* Added a test for Effect class
* Adding tests for removeOnFinish
* Adding tests for onStart and onFinish
* Also check the effect after reset
* Fix-up merge
* formatting
* added doc-comments
* changelog note
* Added test for transform2DEffect
* Adjusted comments
* Make PositionComponent._transform public
* change changelog
* Added SimpleEffectController
* Added DestroyEffect
* Changelog note
* Rename DestroyEffect -> RemoveEffect
* Added example for RemoveEffect
* flutter format
* Move description of the RemoveEffectExample game
* move the description again
* minor
* Game as a component
* Fix component stories
* Effects are now components
* Update effects docs
* Handle swap of parent
* Fix reAddChildren
* Wait for children to be added
* BaseComponent and PositionComponent to be non-abstract
* Simplify HasGameRef
* Revert so that onLoad can be null
* Fix example description
* Effects as components
* Remove gameRef from addChildren
* Fix hasGameRef
* Start migrating effects
* Updated comments of effect fields
* Fix comments
* Continue to fix sequence and combined effects
* Upgrade ordered_set
* Fix position_component_test
* BaseComponent -> Component
* Fix combined and sequence effects
* Await components to be added in tests
* Remove unnecessary game.update in tests
* Fix some tests related to composition
* BaseGame should be used in examples
* Fix CombinedEffect test
* Keyboard code to be based on Component
* Fix keyboard tests
* Fix analyze problems
* Fix sequence_effect
* Fix combined_effect_test
* Store peak state instead of end state
* Fix sequence_effect tests
* Update tutorial
* Fix tutorial 1
* Remove SimplePositionComponentEffect
* Remove unused test variable
* Update docs
* Removed onMount
* Remove onMount
* Add missing dartdoc
* Fix dart docs
* Add super.update where needed
* Move reAddChildren to component
* Reorganize method order in game widget
* preOffset -> initialDelay, postOffset -> peakDelay
* Introduce component.onParentChange
* Remove tests in wrong file
* Fix composed component test
* Add game lifecycle test
* Use BaseGame for mouse cursor test
* Oxygen should (?) not call super.update
* Use BaseGame in keyboard_test
* Fix onLoad to be properly cached
* Re-add unintentionally removed override
* Fix info for collision detection tests
* Add test for correct lifecycle on parent change
* Fix particles example
* Add component lifecycle diagram to the docs
* Add docs for the game lifecycle
* onRemove should be called when a game is removed from the widget
* Fix analyze errors
* prepare should be called from the component itself, not its parent
* Fix dartdoc
* onParentChange -> onMount
* onMount should have void as return type
* Simplify the loaderFuture in GameWidget
* Fix mock_canvas
* Fix rebase problem
* Remove asComponent
* Less complex _loaderFuture
* Add super.update to no_fcs parallax example
* Fix async tests
* Revert _loaderFuture
* Fix analyze issues
* await gameWithCollidables
* Keep epsilon small where it can be
* tappable methods should return bool
* Game lifecycle is now the same as for Component
* Remove mustCallSuper from component.update
* Make onLoadCache protected
* @internal on onLoadCache
* Cache/Memoize debugPaint and debugTextPaint
* Fix imports
* Fix comments
* Always call super.onLoad so that mixins can override it
* Add forgotten super.onLoad
* Bump coverage percentage
* HasCollidables should override update
* Fix Game comments
* Fix some dartdoc
* Apply suggestions from code review
Co-authored-by: Erick <erickzanardoo@gmail.com>
* Game + Loadable as mixins
* Update packages/flame/lib/src/game/game_widget/game_widget.dart
Co-authored-by: Luan Nico <luanpotter27@gmail.com>
* Update loadable docs
* Fix comments
* Move fps_counter
* Fix keyboard example
* Fix dartdoc
* Remove tutorials temporarily
* Fix game lowlevel graph
* Fix resize issue
Co-authored-by: Erick <erickzanardoo@gmail.com>
Co-authored-by: Luan Nico <luanpotter27@gmail.com>
* Viewport and combinedProjector now belong to Camera
* cleanup
* format
* fix analysis issues
* Property viewport removed from BaseGame
* Move camera & viewport into a separate directory
* added CameraComponent
* format
* .camera as computed property
* changelog note
* format
* format
* comment
* CameraComponent is no longer a Component
* Rename CameraComponent -> CameraCo
* format
* Rename CameraC -> CameraWrapper
* minor
* rename BaseGame._cameraComponent -> ._cameraWrapper
* minor fixes in response to reviewer suggestions
* Fix rendering of a ParallaxComponent
Co-authored-by: Lukas Klingsbo <lukas.klingsbo@gmail.com>
