MultiFrameImageStreamCompleter class
Manages the decoding and scheduling of image frames.
New frames will only be emitted while there are registered listeners to the stream (registered with addListener).
This class deals with 2 types of frames:
- image frames - image frames of an animated image.
- app frames - frames that the flutter engine is drawing to the screen to show the app GUI.
For single frame images the stream will only complete once.
For animated images, this class eagerly decodes the next image frame, and notifies the listeners that a new frame is ready on the first app frame that is scheduled after the image frame duration has passed.
Scheduling new timers only from scheduled app frames, makes sure we pause the animation when the app is not visible (as new app frames will not be scheduled).
See the following timeline example:
| Time | Event | Comment |
|------|--------------------------------------------|---------------------------|
| t1 | App frame scheduled (image frame A posted) | |
| t2 | App frame scheduled | |
| t3 | App frame scheduled | |
| t4 | Image frame B decoded | |
| t5 | App frame scheduled | t5 - t1 < frameB_duration |
| t6 | App frame scheduled (image frame B posted) | t6 - t1 > frameB_duration |
- Inheritance
- Object
- Diagnosticable
- ImageStreamCompleter
- MultiFrameImageStreamCompleter
Constructors
-
MultiFrameImageStreamCompleter({@required Future<
Codec> codec, @required double scale, InformationCollector informationCollector }) - Creates a image stream completer. [...]
Properties
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
Methods
-
addListener(
ImageListener listener, { ImageErrorListener onError }) → void -
Adds a listener callback that is called whenever a new concrete ImageInfo
object is available or an error is reported. If a concrete image is
already available, or if an error has been already reported, this object
will call the listener or error listener synchronously. [...]
override
-
removeListener(
ImageListener listener) → void -
Stop listening for new concrete ImageInfo objects and errors from
its associated ImageErrorListener.
override
-
debugFillProperties(
DiagnosticPropertiesBuilder description) → void -
Accumulates a list of strings describing the object's state. Subclasses
should override this to have their information included in toString.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
reportError(
{String context, dynamic exception, StackTrace stack, InformationCollector informationCollector, bool silent: false }) → void -
Calls all the registered error listeners to notify them of an error that
occurred while resolving the image. [...]
@protected, inherited
-
setImage(
ImageInfo image) → void -
Calls all the registered listeners to notify them of a new image.
@protected, inherited
-
toDiagnosticsNode(
{String name, DiagnosticsTreeStyle style }) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by
toStringDeep
. [...]inherited -
toString(
{DiagnosticLevel minLevel: DiagnosticLevel.debug }) → String -
Returns a string representation of this object.
inherited
-
toStringShort(
) → String -
A brief description of this object, usually just the runtimeType and the
hashCode. [...]
inherited
Operators
-
operator ==(
dynamic other) → bool -
The equality operator. [...]
inherited