Image class final

A still image — Fluvie's own widget under Flutter's familiar Image name (the barrel hides Flutter's).

A renderer must pre-resolve every source before capture so frames are deterministic (no "pops in when it loads"): Fluvie pre-fetches, decodes, and caches each source by content hash in the pre-resolve pass, then paints it synchronously from the enclosing ImageResolverScope. A capture with no pre-resolution throws a FluvieRenderException naming the source; a live preview falls back to Flutter's async image path, where determinism does not bind.

Image.network('https://…/photo.jpg', fit: BoxFit.cover)
Image.asset('me.png', frame: Frame.polaroid(caption: 'Summer'))
Image.network('…').animate([Animation.slideFade(), Animation.kenBurns(zoom: 1.2)]);

source exposes the declared MediaSource for the collect pass (collectMediaSources). An optional frame wraps the image in a decorative Frame; an optional shared anchor wraps the result in a SharedElement for a hero morph across a scene boundary. Transforms and effects come through .animate() only, like every element.

Inheritance
Available extensions

Constructors

Image.asset(String name, {BoxFit? fit, Frame? frame, Anchor? shared, Key? key})
A bundled image addressed by its asset key name (for example fixtures/swatch.png).
Image.file(String path, {BoxFit? fit, Frame? frame, Anchor? shared, Key? key})
An image file on disk at path.
Image.memory(Uint8List bytes, {String? debugLabel, BoxFit? fit, Frame? frame, Anchor? shared, Key? key})
An image already in memory as raw encoded bytes, optionally named by debugLabel for errors.
Image.network(Object url, {BoxFit? fit, Frame? frame, Anchor? shared, Key? key})
A remote image at url (a Uri or a String); only allowlisted hosts and schemes are fetched in capture.

Properties

fit → BoxFit?
How the image scales into its box, or null for Flutter's default.
final
frame → Frame?
An optional decorative wrapper (Frame.card, Frame.polaroid, …), or null for a bare image.
final
hashCode → int
The hash code for this object.
no setterinherited
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
mediaSource → MediaSource?
This image's source, exposed through the MediaCarrier contract so the collect pass reads it without importing the elements layer.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
shared → Anchor?
An optional hero anchor: when non-null the image morphs across the boundary it shares with the same anchor in the adjacent scene. null mounts no SharedElement.
final
snapshotSource → SnapshotSource?
An Image declares no snapshot — it is a loaded media, not a computed one.
no setter
source → MediaSource
The declared media this image paints — the key the collect pass gathers and the resolver pre-resolves.
final

Methods

animate(List<Animation> animations, {Anchor? anchor, TimeRange? window, Defaults? defaults}) → Widget

Available on Widget, provided by the Animate extension

Binds animations to this widget by wrapping it in a MotionTarget.
build(BuildContext context) → Widget
Describes the part of the user interface represented by this widget.
override
createElement() → StatelessElement
Creates a StatelessElement to manage this widget's location in the tree.
inherited
debugDescribeChildren() → List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
show({Time? from, Time? to}) → Widget

Available on Widget, provided by the Animate extension

Visibility-window sugar: animate([], window: from.to(to)) with from defaulting to the window start and to to its end.
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String
Returns a one-line detailed description of the object.
inherited
toStringShort() → String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited