AnimatedValueBuilder<T>.raw constructor

const AnimatedValueBuilder<T>.raw({
  1. Key? key,
  2. T? initialValue,
  3. required T value,
  4. required Duration duration,
  5. required AnimatedChildValueBuilder<T> builder,
  6. void onEnd(
    1. T value
    )?,
  7. Curve curve = Curves.linear,
  8. Widget? child,
  9. T lerp(
    1. T a,
    2. T b,
    3. double t
    )?,
})

Creates an AnimatedValueBuilder with raw interpolation control.

This constructor provides maximum control over the animation by exposing the old value, new value, and current interpolation progress. This is useful for custom transition effects or when you need to implement complex interpolation logic.

Parameters:

  • initialValue (T?, optional): Starting value for animation.
  • value (T, required): Target value to animate to.
  • duration (Duration, required): Animation duration.
  • builder (AnimatedChildValueBuilder
  • onEnd (Function?, optional): Called when animation completes.
  • curve (Curve, default: Curves.linear): Animation timing curve.
  • child (Widget?, optional): Optional child passed to builder.
  • lerp (Function?, optional): Custom interpolation function.

Example:

AnimatedValueBuilder<Offset>.raw(
  value: Offset(100, 100),
  duration: Duration(milliseconds: 300),
  builder: (context, oldPos, newPos, progress, child) {
    return Transform.translate(
      offset: Offset.lerp(oldPos, newPos, progress)!,
      child: child,
    );
  },
  child: Icon(Icons.star),
);

Implementation

const AnimatedValueBuilder.raw({
  super.key,
  this.initialValue,
  required this.value,
  required this.duration,
  required AnimatedChildValueBuilder<T> builder,
  this.onEnd,
  this.curve = Curves.linear,
  this.child,
  this.lerp,
})  : animationBuilder = null,
      rawBuilder = builder,
      builder = null;