InteractiveViewer.builder constructor

InteractiveViewer.builder(
  1. {Key? key,
  2. Clip clipBehavior = Clip.hardEdge,
  3. @Deprecated('Use panAxis instead. ' 'This feature was deprecated after v3.3.0-0.5.pre.') bool alignPanAxis = false,
  4. PanAxis panAxis = PanAxis.free,
  5. EdgeInsets boundaryMargin = EdgeInsets.zero,
  6. double maxScale = 2.5,
  7. double minScale = 0.8,
  8. double interactionEndFrictionCoefficient = _kDrag,
  9. GestureScaleEndCallback? onInteractionEnd,
  10. GestureScaleStartCallback? onInteractionStart,
  11. GestureScaleUpdateCallback? onInteractionUpdate,
  12. bool panEnabled = true,
  13. bool scaleEnabled = true,
  14. double scaleFactor = 200.0,
  15. TransformationController? transformationController,
  16. Alignment? alignment,
  17. bool trackpadScrollCausesScale = false,
  18. required InteractiveViewerWidgetBuilder builder}
)

Creates an InteractiveViewer for a child that is created on demand.

Can be used to render a child that changes in response to the current transformation.

See the builder attribute docs for an example of using it to optimize a large child.

Implementation

InteractiveViewer.builder({
  super.key,
  this.clipBehavior = Clip.hardEdge,
  @Deprecated(
    'Use panAxis instead. '
    'This feature was deprecated after v3.3.0-0.5.pre.',
  )
  this.alignPanAxis = false,
  this.panAxis = PanAxis.free,
  this.boundaryMargin = EdgeInsets.zero,
  // These default scale values were eyeballed as reasonable limits for common
  // use cases.
  this.maxScale = 2.5,
  this.minScale = 0.8,
  this.interactionEndFrictionCoefficient = _kDrag,
  this.onInteractionEnd,
  this.onInteractionStart,
  this.onInteractionUpdate,
  this.panEnabled = true,
  this.scaleEnabled = true,
  this.scaleFactor = 200.0,
  this.transformationController,
  this.alignment,
  this.trackpadScrollCausesScale = false,
  required InteractiveViewerWidgetBuilder this.builder,
}) : assert(minScale > 0),
     assert(interactionEndFrictionCoefficient > 0),
     assert(minScale.isFinite),
     assert(maxScale > 0),
     assert(!maxScale.isNaN),
     assert(maxScale >= minScale),
     // boundaryMargin must be either fully infinite or fully finite, but not
     // a mix of both.
     assert(
       (boundaryMargin.horizontal.isInfinite && boundaryMargin.vertical.isInfinite) ||
           (boundaryMargin.top.isFinite &&
               boundaryMargin.right.isFinite &&
               boundaryMargin.bottom.isFinite &&
               boundaryMargin.left.isFinite),
     ),
     constrained = false,
     child = null;