flutter_tilt

New features

• TiltConfig.perspectiveIntensity: Custom perspective intensity (near-large, far-small). Defaults to a size-adaptive value when null. (#63)
• TiltConfig.zOffset: Offsets the rotation pivot along the Z-axis, creating a subtle tilting and swinging effect. Defaults to 0 (no offset). (#63)

Fixes

• Fix copyWith not being able to explicitly set nullable fields to null, e.g. TiltConfig.direction, LightConfig.enableReverse, ShadowConfig.direction / enableReverse.

Fixes

• Fix shadow blur and spread appearing at full strength when centered or at small tilt angles.

Fixes

• Fix light/shadow not reaching maxIntensity for the LightDirection.around and LightDirection.all directions. (#42)
  Now that it is fixed, if the effect looks too strong, set maxIntensity to the square of its previous value (e.g. 0.5 → 0.25, 0.6 → 0.36).

Improvements

• Isolate tilt repaints with a RepaintBoundary to avoid repainting the parent subtree during animation. (#41)
• Avoid redundant calculations and optimize performance. (#41)

Migration Guide: English | 中文

Breaking changes

• Tilt widget now only manages gesture, sensor, and animation state (no UI rendering).
  To reproduce the previous default style, you need to compose TiltBaseContainer with Tilt, or use the built-in Tilt.base.
• Replace Tilt.TiltStreamController with Tilt.TiltController to unify input stream management.
• The previous Tilt.lightShadowMode parameter has been split into the independent widgets TiltBaseContainer and TiltProjectorContainer.
  To reproduce the previous style, you need to compose them inside the Tilt widget,
  or use Tilt.base and Tilt.projector directly.
• ShadowConfig has been split into ShadowBaseConfig and ShadowProjectorConfig.
• Rename TiltParallax parameter size to offset.

Deprecations

• The lightConfig of TiltProjectorContainer is now deprecated.
  Because the current simulated light effect is not suitable for Projector,
  it is now disabled by default and will be removed in a future release.

New features

• Add TiltAnimatedBuilder to help implement custom tilt logic.

PR #34

Improvements

• Updated README.md

Improvements

• Simulated light reflection is more natural.
• Avoid redundant calculations and optimize performance.

Fixes

• Return moveDuration when enterToMove animation progress >= 1

Improvements

• Remove stream_transform package.

Improvements

• Bump sensors_plus package to '>=6.1.0 <8.0.0'.

Improvements

• Reduce unnecessary animation controllers (multiple TiltParallax widgets share the same controller). (#30)

New features

• By default, add a smooth transition effect when gestures (hover and touch) enter. (#29)

  • Configurable via:
    • TiltConfig.enterDuration
    • TiltConfig.moveDuration
    • TiltConfig.enterToMoveDuration
    • TiltConfig.enterToMoveCurve

  If you prefer to disable this effect:

  Tilt(
    tiltConfig: TiltConfig(
      enterToMoveDuration: Duration.zero,
      ...
    )
    ...
  )
  

Improvements

• Improve performance (e.g. avoid unnecessary variable assignments, ...). (#27)
• Refactor code structures. (#27)
• The Tilt.fps default value has been changed from 60 to 120. (#27)

Improvements

• Update example and docs.

Improvements

• Bump example to Flutter 3.29 (#24)
• Refactor code structures. (#23)

New features

• Add Tilt.lightShadowMode and configuration. (#12)

Improvements

• Migrate from withOpacity to withAlpha.

Improvements

• Bump sensors_plus package from 6.0.0 to 6.1.0. (#20)
• Migrate the example to Android Studio Ladybug (JDK 21). (#19)

Improvements

• Replace Platform (dart:io) with TargetPlatform (flutter/foundation.dart). (#18)
• Handling when the platform has no available sensors. (#18)

Fixes

• Fix Tilt.disable: true still prevents scrolling. (#16)

Fixes

• Fix tiltConfig.enableGestureTouch still prevents scrolling when disabled. (#15)

Improvements

• Improve example (Flutter v3.24.0)

Improvements

• Bump sensors_plus package from 5.0.1 to 6.0.0.

Improvements

• Improve linter.

Improvements

• Upgrade sensors_plus package to 5.0.1.
• Update Doc.

Breaking changes

• Bumping Flutter SDK minimum version to 3.19.0.

Improvements

• Upgrade sensors_plus package to 5.0.0.

Improvements

• dart doc.

New features

• Add Tilt.tiltStreamController to provide custom control of the tilt.
• Add TiltConfig.controllerMoveDuration, TiltConfig.controllerLeaveDuration.

Improvements

• Improve gesture priority logic.
• dart doc.

Fixes

• Fix assignment usage logic in Tilt.tiltStreamController.
• Fix Tilt.tiltStreamController closes prematurely.
• Fix sensor listening not closed.

Breaking changes

• Bumping Flutter SDK minimum version to 3.10.0.

Improvements

• Update Versions Compatibility. (Sensors are not supported on the web platform until Flutter version 3.10)

Improvements

• Upgrade sensors_plus to version 4.0.2.
• Improve code structure.

Fixes

• Fix onGesturesRevert being called repeatedly after a move has ended.

Breaking changes

• Migrate to Flutter 3.7 and drop support for previous Flutter versions.
• Upgrade sensors_plus to v4.x.x. (#6)

Improvements

• Improve example (Flutter v3.16.0)

Improvements

• Improve high energy impact.

Improvements

• Update the example to Flutter 3.16.0 and use Material3.

New features

• Add spreadFactor to LightConfig.

Fixes

• Fix undetermined mounted.

Fixes

• Fix device orientation does not match sensor orientation.

Improvements

• Improve README docs

Improvements

• Upgrade sensors_plus to version 3.1.0

Improvements

• Improve light above childLayout.inner.

Fixes

• Fix incorrect initialization sizes in some cases (e.g. image with unspecified sizes).

Improvements

• Improve code structure.

Fixes

• Fix tapping on content causes tilt when enableRevert or enableSensorRevert is false.

Fixes

• Fix device landscape mode not match sensor orientation.

Improvements

• Config copyWith().

Fixes

• Fix initial has no effect.

Breaking changes

• Bumping Flutter SDK minimum version to 3.3.0.
• Changed enableMouseHover in TiltConfig to enableGestureHover.
• To keep the tilt, you need to configure TiltConfig(enableRevert: false, enableSensorRevert: false,).

New features

• Add sensor gesture (configuration: enableGestureSensors, sensorFactor, enableSensorRevert, sensorRevertFactor, sensorMoveDuration), default configuration is TiltConfig(enableGestureSensors = true).
• Add touch gesture configuration, default is TiltConfig(enableGestureTouch = true).

Improvements

• Gesture optimization.

Fixes

• Fix TiltConfig(enableReverse: true) is not used in TiltParallax.
• Fix fps timer not canceled.

Improvements

• Update FilterQuality parameter of Tilt and TiltParallax widgets is null by default.
• Upgrade Example of Flutter to 3.13.0

• Doc

• Doc

Improvements

• Test coverage 100%.

Fixes

• Fix constraintsPosition min value is wrong.
• Fix TiltParallax widget not following Tilt widget.