Called whenever the object needs to paint. The given Canvas has its
coordinate space configured such that the origin is at the top left of the
box. The area of the box is the size of the size
argument.
Paint operations should remain inside the given area. Graphical operations outside the bounds may be silently ignored, clipped, or not clipped.
Implementations should be wary of correctly pairing any calls to Canvas.save/Canvas.saveLayer and Canvas.restore, otherwise all subsequent painting on this canvas may be affected, with potentially hilarious but confusing results.
To paint text on a Canvas, use a TextPainter.
To paint an image on a Canvas:
-
Obtain an
ImageStream
, for example by calling resolve on an AssetImage or NetworkImage object. -
Whenever the
ImageStream
's underlyingImageInfo
object changes (seeImageStream.addListener
), create a new instance of your custom paint delegate, giving it the newImageInfo
object. -
In your delegate's paint method, call the Canvas.drawImage, drawImageRect, or drawImageNine methods to paint the
ImageInfo.image
object, applying theImageInfo.scale
value to obtain the correct rendering size.
Source
void paint(Canvas canvas, Size size);