paint method
- @override
- Canvas canvas,
- Size size
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. It may sometimes be difficult to guarantee that a certain
operation is inside the bounds (e.g., drawing a rectangle whose size is
determined by user inputs). In that case, consider calling
Canvas.clipRect
at the beginning of paint so everything that follows
will be guaranteed to only draw within the clipped area.
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 callingImageProvider.resolve
on anAssetImage
orNetworkImage
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
,Canvas.drawImageRect
, orCanvas.drawImageNine
methods to paint theImageInfo.image
object, applying theImageInfo.scale
value to obtain the correct rendering size.
Implementation
@override
void paint(Canvas canvas, Size size) {
canvas.drawImageRect(
image,
Rect.fromLTRB(0, 0, image.width.toDouble(), image.height.toDouble()),
Rect.fromLTRB(0, 0, size.width, size.height),
new Paint(),
);
}