1.17.0

Note: This release has breaking changes.

• REFACTOR: Change the ClipComponent factory Constructor to redirect Constructor (#3089). (cc035fb4)
• FIX: Call render properly from nested FlameGames (#3106). (cb1e3701)
• FIX: CircleHitbox should properly detect when ray is outside (#3100). (8cd9e123)
• FIX: Clamp opacity set by the ColorEffect to 1.0 (#3069). (9282cc38)
• FIX: FutureOr return type of ComponentViewportMargin.onLoad (#3059). (72678c67)
• FIX: Size for SpriteComponent.fromImage should be nullable (#3054). (2ed71a3c)
• FIX: Check for removing state while adding a child (#3050). (3a24a51d)
• FEAT: Add onFinished callback to ScrollTextBoxComponent (#3105). (233cc94c)
• FEAT: Add copyWith method on the TextBoxConfig (#3099). (b946ba70)
• FEAT: Component tree for the devtools extension tab (#3094). (bf5d68e9)
• FEAT: Add PositionComponent.toString (#3095). (b1f01986)
• FEAT: Add SpriteBatch.replace to allow the replacement of the batch information (#3079). (bf3c282d)
• FEAT: Initial functionality of flame_devtools (#3061). (c92910c6)
• FEAT: Add HasPerformanceTracker mixin on Game (#3043). (6270353a)
• BREAKING REFACTOR: Use HasTimeScale for Route (#3064). (30fde805)
• BREAKING FIX: Removed unused parameters from SpriteWidget (#3074). (f49d24c0)

1.16.0

Note: This release has breaking changes.

• REFACTOR: Fix unrelated types reported by DCM (#3023). (1d020a52)
• FIX: Vertices in PolygonComponent should subtract vertices positioning (#3040). (4f053ed7)
• BREAKING FIX: Migrate from RawKeyEvent to KeyEvent (#3002). (330862c9)

1.15.0

• REFACTOR: Minimize Vector2 creation in IsometricTileMapComponent (#3018). (5d3be313)
• FIX: Set margins of JoystickComponent properly (#3019). (e27818d8)
• FIX: Properly update sprites in SpriteButtonComponent (#3013). (23cf8b9d)
• FIX: Lifecycle completers to be called for FlameGame (#3007). (3804f524)
• FIX: CameraComponent no longer throws Concurrent modification on stop (#2997). (6a1059b0)
• FIX: Updated PolygonComponent.containsPoint to account for concave polygons (#2979). (a6fe62a2)
• FIX: Add missing generic to ComponentViewportMargin (#2983). (1d9fe613)
• FEAT: Add support for base64 encoded images to be manually added to Images cache. (#3008). (1e56293c)
• FEAT: Make Component.key public (#2988). (7fbd5af9)
• FEAT: Add a hitboxFilter argument to raycast() (#2968). (d7c53e23)

1.14.0

Note: This release has breaking changes.

• FIX: Set hitbox debugColor to yellow (#2958). (6858eae0)
• FIX: Consider displaced hitboxes in GestureHitboxes mixin (#2957). (1085518f)
• FIX: PolygonComponent.containsLocalPoint to use anchor (#2953). (7969321e)
• FEAT: Notifier for changing current sprite/animation in group components (#2956). (75cf2390)
• BREAKING REFACTOR: Remove the Projector interface that is no longer used for coordinate transformations (#2955). (0979dc97)

1.13.1

• FIX: The visibleGameSize should be based on viewport.virtualSize (#2945). ( bd130b71)
• FEAT: Adding ability for a SpawnComponent to not auto start (#2947). ([37c7a075] (https://github.com/flame-engine/flame/commit/37c7a075a37cfc7c298f02542715b18e87f4cf99))

1.13.0

• FIX: Logic error in MemoryCache.setValue() (#2931). (8cee80c3)
• FIX: Export ScalingParticle (#2928). (3730cb1d)
• FIX: Misalignment of the hittest area of PolygonHitbox (#2930). (db db1379)
• FIX: Allow setting bounds while BoundedPositionBehavior's target is null (#2926). (bab9be6e)
• FEAT: Ability to use selfPositioning in SpawnComponent (#2927). (b526aa14)
• FEAT: Add margin and spacing properties to SpriteSheet (#2925) . (67f7c126)
• FEAT: Add children to SpriteAnimationComponent.fromFrameData ([#2914](https://github.com/flame-engine/flame/issues/29 14)). (caf2b909)
• DOCS: Remove references to Tappable and Draggable (#2912). (d12e454 4)

1.12.0

• FIX: SpriteAnimationWidget was resetting the ticker even when the playing didn't changed (#2891). (9aed8b4d)
• FEAT: Scrollable TextBoxComponent (#2901). (8c3cb725)
• FEAT: Add collision completed listener (#2896). (957db3c1)
• FEAT: Adding autoResetTicker option to SpriteAnimationGroupComponent (#2899). (001c870d)
• FEAT: Add clearSnapshot function (#2897). (d4decd21)

1.11.0

Note: This release has breaking changes.

• FIX: Minor issues due Flutter 3.16 (#2856). (d51cd584)
• FIX: Properly resize ScreenHitbox when needed (#2826). (24fed757)
• FIX: Setting world on FlameGame camera setter (#2831). (3a8e2464)
• FIX: Allow null passthrough parent (#2821). (c4d2f86e)
• FIX: Do not scale debug texts with zoom (#2818). (c2f3f040)
• FIX(flame): Export FixedResolutionViewport and make withFixedResolution a redirect constructor (#2817). (3420d0e6)
• FEAT: Using viewport scale on debug mode text paint (#2883). (07ef46ca)
• FEAT: Make Viewfinder and Viewport comply with CoordinateTransform interface (#2872). (685e1d95)
• FEAT: Allow sequence effect to be extended (#2864). (ee11aae9)
• FEAT: Adding children argument to all constructors in the shape components (#2862). (082743d3)
• FEAT: Optimization in sprite batch (#2861). (208d7897)
• FEAT: Add TimeTrackComponent and ChildCounterComponent (#2846). (6269551a)
• FEAT: MoveAlongPathEffect should maintain initial angle of the component (#2835). (e6e78c0d)
• FEAT: Add a method to adapt the camera bounds to the world (#2769). (87b69df6)
• FEAT: Scaling particle feature (#2830). (9faae8a2)
• BREAKING REFACTOR: Replace Offset with opacityFrom and opacityTo in ColorEffect (#2876). (0fd2662d)
• BREAKING FIX: Add DisplacementEvent to fix delta coordinate transformations for drag events (#2871). (63994ebc)

Migration instructions

To specify start and end opacities for ColorEffect use the optional named parameters opacityFrom and opacityTo. So offset.dx should be set as opacityFrom and offset.dy should be set as opacityTo.

• If you are using DragUpdateEvent events, the devicePosition, canvasPosition, localPosition, and delta are deprecated as they are unclear.
• Use xStartPosition to get the position at the start of the drag event ("from").
• Use xEndPosition to get the position at the end of the drag event ("to").
• If you want the delta, use localDelta. it now already considers the camera zoom. No need to manually account for that.
• Now you keep receiving drag events for the same component even if the drag event leaves the component (breaking)

1.10.0

• REFACTOR: Remove unnecessary 'async' keyword across the codebase [DCM] (#2803). (2dfe0e5a)
• REFACTOR: Avoid nested conditional expressions whenever possible [DCM] (#2784). (7b6a5712)
• REFACTOR: Mark semantically final variables as final (or const) proper [DCM] (#2783). (71f7b475)
• FIX: Remove deprecations for 1.10.0 (#2809). (5b67b8f1)
• FIX: Un-register component keys down the component tree (#2792). (0f679b3f)
• FIX: AlignComponent set child (remove compare) (#2774). (20aaf656)
• FIX: Hardcode initCurrentGame lifecycle state as resumed (#2775). (0cd5037c)
• FIX: Fix TextBoxComponent alignment bug (#2781). (0fb53efb)
• FIX(flame): The component.removeFromParent method should use parent.remove internally (#2779). (bdb1c79a)
• FIX: Take unmounted adds into consideration (#2770). (be28a440)
• FEAT: Add IgnoreEvents mixin to ignore events for the whole subtree (#2811). (313411c3)
• FEAT: Add advanced button component (#2742). (97fff0ed)
• FEAT: Introduce the FixedResolutionViewport (#2796). (4c762f94)
• FEAT: AssetsBundle can be customized in Images and AssetsCache. (#2807). (a23f80e9)
• FEAT: Backdrop (static backgrounds) component for CameraComponent (#2787). (ab329f71)
• FEAT: Align component refactoring (#2767). (bde34efe)
• DOCS: Remove last broad cSpell bypass regex and fix all violations (#2802). (9b16b178)

1.9.1

• FIX: Add necessary generics on mixins on FlameGame (https://github.com/flame-engine/flame/issues/2763). (b1f5ff26)
• FIX: Correctly refreshes the widget after new mouse detector (https://github.com/flame-engine/flame/issues/2765). (64330022)
• FIX: Allow moving to a new parent in the same tick (https://github.com/flame-engine/flame/issues/2762). (313650ea)