SkCanvas Reference

Canvas

Class SkCanvas

Canvas provides an interface for drawing, and how the drawing is clipped and transformed. Canvas contains a stack of Matrix and Clip values.

Canvas and Paint together provide the state to draw into Surface or Device. Each Canvas draw call transforms the geometry of the object by the concatenation of all Matrix values in the stack. The transformed geometry is clipped by the intersection of all of Clip values in the stack. The Canvas draw calls use Paint to supply drawing state such as Color, Typeface, text size, stroke width, Shader and so on.

To draw to a pixel-based destination, create Raster Surface or GPU Surface. Request Canvas from Surface to obtain the interface to draw. Canvas generated by Raster Surface draws to memory visible to the CPU. Canvas generated by GPU Surface uses Vulkan or OpenGL to draw to the GPU.

To draw to a document, obtain Canvas from SVG Canvas, Document PDF, or Picture Recorder. Document based Canvas and other Canvas Subclasses reference Device describing the destination.

Canvas can be constructed to draw to Bitmap without first creating Raster Surface. This approach may be deprecated in the future.

Overview

Related Function

SkCanvas global, struct, and class related member functions share a topic.

Constant

SkCanvas related constants are defined by enum, enum class, #define, const, and constexpr.

Struct

SkCanvas uses C++ structs to declare the public data structures and interfaces.

Typedef

SkCanvas typedef define a data type.

Constructor

Create the desired type of Surface to obtain its Canvas when possible. Useful when no Surface is required, and some helpers implicitly create Raster Surface.

SkCanvas can be constructed or initialized by these functions, including C++ class constructors.

Member Function

SkCanvas member functions read and modify the structure properties.

MakeRasterDirect

Allocates raster Canvas that will draw directly into pixels.

Canvas is returned if all parameters are valid. Valid parameters include: info dimensions are zero or positive; info contains Color Type and Alpha Type supported by Raster Surface; pixels is not nullptr; rowBytes is zero or large enough to contain info width pixels of Color Type.

Pass zero for rowBytes to compute rowBytes from info width and size of pixel. If rowBytes is greater than zero, it must be equal to or greater than info width times bytes required for Color Type.

Pixel buffer size should be info height times computed rowBytes. Pixels are not initialized. To access pixels after drawing, call flush or peekPixels.

Parameters

Return Value

Canvas if all parameters are valid; otherwise, nullptr

Example

Example Output

---
-x-
---

See Also

MakeRasterDirectN32 SkSurface::MakeRasterDirect


MakeRasterDirectN32

Allocates raster Canvas specified by inline image specification. Subsequent Canvas calls draw into pixels. Color Type is set to kN32_SkColorType. Alpha Type is set to kPremul_SkAlphaType. To access pixels after drawing, call flush or peekPixels.

Canvas is returned if all parameters are valid. Valid parameters include: width and height are zero or positive; pixels is not nullptr; rowBytes is zero or large enough to contain width pixels of kN32_SkColorType.

Pass zero for rowBytes to compute rowBytes from width and size of pixel. If rowBytes is greater than zero, it must be equal to or greater than width times bytes required for Color Type.

Pixel buffer size should be height times rowBytes.

Parameters

Return Value

Canvas if all parameters are valid; otherwise, nullptr

Example

Example Output

---
-x-
---

See Also

MakeRasterDirect SkSurface::MakeRasterDirect SkImageInfo::MakeN32Premul[2]


SkCanvas

Creates an empty Canvas with no backing device or pixels, with a width and height of zero.

Return Value

empty Canvas

Example

Example Output

paint draws text left to right
paint draws text top to bottom
paint draws text top to bottom

See Also

MakeRasterDirect SkRasterHandleAllocator::MakeCanvas SkSurface::getCanvas SkCreateColorSpaceXformCanvas


SkCanvas

Creates Canvas of the specified dimensions without a Surface. Used by Subclasses with custom implementations for draw member functions.

If props equals nullptr, Surface Properties are created with Surface Properties Legacy Font Host settings, which choose the pixel striping direction and order. Since a platform may dynamically change its direction when the device is rotated, and since a platform may have multiple monitors with different characteristics, it is best not to rely on this legacy behavior.

Parameters

Return Value

Canvas placeholder with dimensions

Example

Example Output

canvas is empty

See Also

MakeRasterDirect SkSurfaceProps SkPixelGeometry SkCreateColorSpaceXformCanvas


SkCanvas

Deprecated.

soon


SkCanvas

Constructs a canvas that draws into bitmap. Sets SkSurfaceProps::kLegacyFontHost InitType in constructed Surface.

Bitmap is copied so that subsequently editing bitmap will not affect constructed Canvas.

May be deprecated in the future.

Parameters

Return Value

Canvas that can be used to draw into bitmap

Example

Example Output

-----
---x-
---x-
---x-
---x-
---x-
---x-
-----
---x-
---x-
-----

See Also

MakeRasterDirect SkRasterHandleAllocator::MakeCanvas SkSurface::getCanvas SkCreateColorSpaceXformCanvas


Enum SkCanvas::ColorBehavior

Constants

SkCanvas

For use by Android framework only.

Parameters

Return Value

Canvas that can be used to draw into bitmap


SkCanvas

Constructs a canvas that draws into bitmap. Use props to match the device characteristics, like LCD striping.

bitmap is copied so that subsequently editing bitmap will not affect constructed Canvas.

Parameters

Return Value

Canvas that can be used to draw into bitmap

Example

Example Output

-----
---x-
---x-
---x-
---x-
---x-
---x-
-----
---x-
---x-
-----

See Also

MakeRasterDirect SkRasterHandleAllocator::MakeCanvas SkSurface::getCanvas SkCreateColorSpaceXformCanvas


~SkCanvas

Draws saved Layers, if any. Frees up resources used by Canvas.

Example

See Also

State Stack


Property

getMetaData

Returns storage to associate additional data with the canvas. The storage is freed when Canvas is deleted.

Return Value

storage that can be read from and written to

Example

Example Output

before: (null)
during: Hello!
after: (null)

See Also

SkMetaData


imageInfo

Returns Image Info for Canvas. If Canvas is not associated with Raster Surface or GPU Surface, returned Color Type is set to kUnknown_SkColorType.

Return Value

dimensions and Color Type of Canvas

Example

Example Output

emptyInfo == canvasInfo

See Also

SkImageInfo MakeRasterDirect makeSurface


getProps

Copies Surface Properties, if Canvas is associated with Raster Surface or GPU Surface, and returns true. Otherwise, returns false and leave props unchanged.

Parameters

Return Value

true if Surface Properties was copied

Example

Example Output

isRGB:0
isRGB:1

See Also

SkSurfaceProps makeSurface


Utility

flush

Triggers the immediate execution of all pending draw operations. If Canvas is associated with GPU Surface, resolves all pending GPU operations. If Canvas is associated with Raster Surface, has no effect; raster draw operations are never deferred.

See Also

peekPixels SkSurface::flush() GrContext::flush() SkSurface::prepareForExternalIO GrContext::abandonContext()


getBaseLayerSize

Gets the size of the base or root Layer in global canvas coordinates. The origin of the base Layer is always (0,0). The area available for drawing may be smaller (due to clipping or saveLayer).

Return Value

integral width and height of base Layer

Example

Example Output

clip=10,30
size=20,30

See Also

getDeviceClipBounds[2]


makeSurface

Creates Surface matching info and props, and associates it with Canvas. Returns nullptr if no match found.

If props is nullptr, matches Surface Properties in Canvas. If props is nullptr and Canvas does not have Surface Properties, creates Surface with default Surface Properties.

Parameters

Return Value

Surface matching info and props, or nullptr if no match is available

Example

Example Output

compatible != nullptr
size = 3, 4

See Also

SkSurface SkSurface::makeSurface SkImageInfo SkSurfaceProps


getGrContext

Returns GPU Context of the GPU Surface associated with Canvas.

Return Value

GPU Context, if available; nullptr otherwise

Example

See Also

GrContext


accessTopLayerPixels

Returns the pixel base address, Image Info, rowBytes, and origin if the pixels can be read directly. The returned address is only valid while Canvas is in scope and unchanged. Any Canvas call or Surface call may invalidate the returned address and other returned values.

If pixels are inaccessible, info, rowBytes, and origin are unchanged.

Parameters

Return Value

address of pixels, or nullptr if inaccessible

Example

Example

The Layer and blended result appear on the CPU and GPU but the large dotted "" appear only on the CPU.

See Also

SkImageInfo SkPixmap


accessTopRasterHandle

Returns custom context that tracks the Matrix and Clip.

Use Raster Handle Allocator to blend Skia drawing with custom drawing, typically performed by the host platform user interface. The custom context returned is generated by SkRasterHandleAllocator::MakeCanvas, which creates a custom canvas with raster storage for the drawing destination.

Return Value

context of custom allocation

Example

Example Output

context = skia

See Also

SkRasterHandleAllocator


Pixels

peekPixels

Returns true if Canvas has direct access to its pixels.

Pixels are readable when Device is raster. Pixels are not readable when Canvas is returned from GPU Surface, returned by SkDocument::beginPage, returned by SkPictureRecorder::beginRecording, or Canvas is the base of a utility class like SkDebugCanvas.

pixmap is valid only while Canvas is in scope and unchanged. Any Canvas or Surface call may invalidate the pixmap values.

Parameters

Return Value

true if Canvas has direct access to pixels

Example

Example Output

width=256 height=256

See Also

readPixels[2][3] SkBitmap::peekPixels SkImage::peekPixels SkSurface::peekPixels


readPixels

Copies Rect of pixels from Canvas into dstPixels. Matrix and Clip are ignored.

Source Rect corners are (srcX, srcY) and (imageInfo.width(), imageInfo.height()). Destination Rect corners are (0, 0) and (dstInfo.width(), dstInfo.height()). Copies each readable pixel intersecting both rectangles, without scaling, converting to dstInfo.colorType() and dstInfo.alphaType() if required.

Pixels are readable when Device is raster, or backed by a GPU. Pixels are not readable when SkCanvas is returned by SkDocument::beginPage, returned by SkPictureRecorder::beginRecording, or Canvas is the base of a utility class like SkDebugCanvas.

The destination pixel storage must be allocated by the caller.

Pixel values are converted only if Color Type and Alpha Type do not match. Only pixels within both source and destination rectangles are copied. dstPixels contents outside Rect intersection are unchanged.

Pass negative values for srcX or srcY to offset pixels across or down destination.

Does not copy, and returns false if:

Parameters

Return Value

true if pixels were copied

Example

Example

Example Output

pixel = 802b5580
pixel = 8056a9ff

See Also

peekPixels writePixels[2] drawBitmap drawImage[2] SkBitmap::readPixels[2][3][4] SkPixmap::readPixels[2][3][4][5] SkImage::readPixels[2] SkSurface::readPixels[2][3]


Copies Rect of pixels from Canvas into pixmap. Matrix and Clip are ignored.

Source Rect corners are (srcX, srcY) and (imageInfo.width(), imageInfo.height()). Destination Rect corners are (0, 0) and (pixmap.width(), pixmap.height()). Copies each readable pixel intersecting both rectangles, without scaling, converting to pixmap.colorType() and pixmap.alphaType() if required.

Pixels are readable when Device is raster, or backed by a GPU. Pixels are not readable when SkCanvas is returned by SkDocument::beginPage, returned by SkPictureRecorder::beginRecording, or Canvas is the base of a utility class like SkDebugCanvas.

Caller must allocate pixel storage in pixmap if needed.

Pixel values are converted only if Color Type and Alpha Type do not match. Only pixels within both source and destination Rects are copied. pixmap pixels contents outside Rect intersection are unchanged.

Pass negative values for srcX or srcY to offset pixels across or down pixmap.

Does not copy, and returns false if:

Parameters

Return Value

true if pixels were copied

Example

Example Output

pixel = 802b5580

See Also

peekPixels writePixels[2] drawBitmap drawImage[2] SkBitmap::readPixels[2][3][4] SkPixmap::readPixels[2][3][4][5] SkImage::readPixels[2] SkSurface::readPixels[2][3]


Copies Rect of pixels from Canvas into bitmap. Matrix and Clip are ignored.

Source Rect corners are (srcX, srcY) and (imageInfo.width(), imageInfo.height()). Destination Rect corners are (0, 0) and (bitmap.width(), bitmap.height()). Copies each readable pixel intersecting both rectangles, without scaling, converting to bitmap.colorType() and bitmap.alphaType() if required.

Pixels are readable when Device is raster, or backed by a GPU. Pixels are not readable when SkCanvas is returned by SkDocument::beginPage, returned by SkPictureRecorder::beginRecording, or Canvas is the base of a utility class like SkDebugCanvas.

Caller must allocate pixel storage in bitmap if needed.

Bitmap values are converted only if Color Type and Alpha Type do not match. Only pixels within both source and destination rectangles are copied. Bitmap pixels outside Rect intersection are unchanged.

Pass negative values for srcX or srcY to offset pixels across or down bitmap.

Does not copy, and returns false if:

Parameters

Return Value

true if pixels were copied

Example

Example Output

pixel = 802b5580

See Also

peekPixels writePixels[2] drawBitmap drawImage[2] SkBitmap::readPixels[2][3][4] SkPixmap::readPixels[2][3][4][5] SkImage::readPixels[2] SkSurface::readPixels[2][3]


writePixels

Copies Rect from pixels to Canvas. Matrix and Clip are ignored. Source Rect corners are (0, 0) and (info.width(), info.height()). Destination Rect corners are (x, y) and (imageInfo.width(), imageInfo.height()).

Copies each readable pixel intersecting both rectangles, without scaling, converting to imageInfo.colorType() and imageInfo.alphaType() if required.

Pixels are writable when Device is raster, or backed by a GPU. Pixels are not writable when SkCanvas is returned by SkDocument::beginPage, returned by SkPictureRecorder::beginRecording, or Canvas is the base of a utility class like SkDebugCanvas.

Pixel values are converted only if Color Type and Alpha Type do not match. Only pixels within both source and destination rectangles are copied. Canvas pixels outside Rect intersection are unchanged.

Pass negative values for x or y to offset pixels to the left or above Canvas pixels.

Does not copy, and returns false if:

Parameters

Return Value

true if pixels were written to Canvas

Example

See Also

readPixels[2][3] drawBitmap drawImage[2] SkBitmap::writePixels[2][3]


Copies Rect from pixels to Canvas. Matrix and Clip are ignored. Source Rect corners are (0, 0) and (bitmap.width(), bitmap.height()).

Destination Rect corners are (x, y) and (imageInfo.width(), imageInfo.height()).

Copies each readable pixel intersecting both rectangles, without scaling, converting to imageInfo.colorType() and imageInfo.alphaType() if required.

Pixels are writable when Device is raster, or backed by a GPU. Pixels are not writable when SkCanvas is returned by SkDocument::beginPage, returned by SkPictureRecorder::beginRecording, or Canvas is the base of a utility class like SkDebugCanvas.

Pixel values are converted only if Color Type and Alpha Type do not match. Only pixels within both source and destination rectangles are copied. Canvas pixels outside Rect intersection are unchanged.

Pass negative values for x or y to offset pixels to the left or above Canvas pixels.

Does not copy, and returns false if:

Parameters

Return Value

true if pixels were written to Canvas

Example

See Also

readPixels[2][3] drawBitmap drawImage[2] SkBitmap::writePixels[2][3]


State Stack

Canvas maintains a stack of state that allows hierarchical drawing, commonly used to implement windows and views. The initial state has an identity matrix and and an infinite clip. Even with a wide-open clip, drawing is constrained by the bounds of the Canvas Surface or Device.

Canvas savable state consists of Clip and Matrix. Clip describes the area that may be drawn to. Matrix transforms the geometry.

save, saveLayer, saveLayerPreserveLCDTextRequests, and saveLayerAlpha save state and return the depth of the stack.

restore, restoreToCount, and ~SkCanvas() revert state to its value when saved.

Each state on the stack intersects Clip with the previous Clip, and concatenates Matrix with the previous Matrix. The intersected Clip makes the drawing area the same or smaller; the concatenated Matrix may move the origin and potentially scale or rotate the coordinate space.

Canvas does not require balancing the state stack but it is a good idea to do so. Calling save without restore will eventually cause Skia to fail; mismatched save and restore create hard to find bugs.

It is not possible to use state to draw outside of the clip defined by the previous state.

Example

Each Clip uses the current Matrix for its coordinates.

Example

See Also

save saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha restore restoreToCount

save

Saves Matrix and Clip. Calling restore discards changes to Matrix and Clip, restoring the Matrix and Clip to their state when save was called.

Matrix may be changed by translate, scale, rotate, skew, concat, setMatrix, and resetMatrix. Clip may be changed by clipRect, clipRRect, clipPath, clipRegion.

Saved Canvas state is put on a stack; multiple calls to save should be balance by an equal number of calls to restore.

Call restoreToCount with result to restore this and subsequent saves.

Return Value

depth of saved stack

Example

See Also

saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha restore restoreToCount


restore

Removes changes to Matrix and Clip since Canvas state was last saved. The state is removed from the stack.

Does nothing if the stack is empty.

Example

See Also

save saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha restoreToCount


getSaveCount

Returns the number of saved states, each containing: Matrix and Clip. Equals the number of save calls less the number of restore calls plus one. The save count of a new canvas is one.

Return Value

depth of save state stack

Example

Example Output

depth = 1
depth = 2
depth = 1

See Also

save restore restoreToCount


restoreToCount

Restores state to Matrix and Clip values when save, saveLayer, saveLayerPreserveLCDTextRequests, or saveLayerAlpha returned saveCount.

Does nothing if saveCount is greater than state stack count. Restores state to initial values if saveCount is less than or equal to one.

Parameters

Example

Example Output

depth = 1
depth = 3
depth = 1

See Also

restore getSaveCount save


Layer

Layer allocates a temporary Bitmap to draw into. When the drawing is complete, the Bitmap is drawn into the Canvas.

Layer is saved in a stack along with other saved state. When state with a Layer is restored, the Bitmap is drawn into the previous Layer.

Layer may be initialized with the contents of the previous Layer. When Layer is restored, its Bitmap can be modified by Paint passed to Layer to apply Color Alpha, Color Filter, Image Filter, and Blend Mode.

saveLayer

Saves Matrix and Clip, and allocates a Bitmap for subsequent drawing. Calling restore discards changes to Matrix and Clip, and draws the Bitmap.

Matrix may be changed by translate, scale, rotate, skew, concat, setMatrix, and resetMatrix. Clip may be changed by clipRect, clipRRect, clipPath, clipRegion.

Rect bounds suggests but does not define the Bitmap size. To clip drawing to a specific rectangle, use clipRect.

Optional Paint paint applies Color Alpha, Color Filter, Image Filter, and Blend Mode when restore is called.

Call restoreToCount with returned value to restore this and subsequent saves.

Parameters

Return Value

depth of saved stack

Example

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha SaveLayerRec


Saves Matrix and Clip, and allocates a Bitmap for subsequent drawing. Calling restore discards changes to Matrix and Clip, and draws the Bitmap.

Matrix may be changed by translate, scale, rotate, skew, concat, setMatrix, and resetMatrix. Clip may be changed by clipRect, clipRRect, clipPath, clipRegion.

Rect bounds suggests but does not define the Layer size. To clip drawing to a specific rectangle, use clipRect.

Optional Paint paint applies Color Alpha, Color Filter, Image Filter, and Blend Mode when restore is called.

Call restoreToCount with returned value to restore this and subsequent saves.

Parameters

Return Value

depth of saved stack

Example

See Also

save restore saveLayerPreserveLCDTextRequests saveLayerAlpha SaveLayerRec


saveLayerPreserveLCDTextRequests

Saves Matrix and Clip, and allocates a Bitmap for subsequent drawing. LCD Text is preserved when the Layer is drawn to the prior Layer.

Calling restore discards changes to Matrix and Clip, and draws Layer.

Matrix may be changed by translate, scale, rotate, skew, concat, setMatrix, and resetMatrix. Clip may be changed by clipRect, clipRRect, clipPath, clipRegion.

Rect bounds suggests but does not define the Layer size. To clip drawing to a specific rectangle, use clipRect.

Optional Paint paint applies Color Alpha, Color Filter, Image Filter, and Blend Mode when restore is called.

Call restoreToCount with returned value to restore this and subsequent saves.

Draw text on an opaque background so that LCD Text blends correctly with the prior Layer. LCD Text drawn on a background with transparency may result in incorrect blending.

Parameters

Return Value

depth of saved stack

Example

See Also

save restore saveLayer[2][3] saveLayerAlpha SaveLayerRec


saveLayerAlpha

Saves Matrix and Clip, and allocates Bitmap for subsequent drawing.

Calling restore discards changes to Matrix and Clip, and blends Layer with alpha opacity onto prior Layer.

Matrix may be changed by translate, scale, rotate, skew, concat, setMatrix, and resetMatrix. Clip may be changed by clipRect, clipRRect, clipPath, clipRegion.

Rect bounds suggests but does not define Layer size. To clip drawing to a specific rectangle, use clipRect.

alpha of zero is fully transparent, 255 is fully opaque.

Call restoreToCount with returned value to restore this and subsequent saves.

Parameters

Return Value

depth of saved stack

Example

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests SaveLayerRec


Enum SkCanvas::SaveLayerFlagsSet

Typedef SkCanvas::SaveLayerFlags

SaveLayerFlags provides options that may be used in any combination in SaveLayerRec, defining how Layer allocated by saveLayer operates. It may be set to zero, kPreserveLCDText SaveLayerFlag, kInitWithPrevious SaveLayerFlag, or both flags.

Constants

do not use

soon

Example

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha SaveLayerRec

Layer SaveLayerRec

Struct SkCanvas::SaveLayerRec

SaveLayerRec contains the state used to create the Layer.

Layer SaveLayerRec Overview

Layer SaveLayerRec Member

Members

Example

Layer SaveLayerRec Constructor

SaveLayerRec

Sets fBounds, fPaint, and fBackdrop to nullptr. Clears fSaveLayerFlags.

Return Value

empty SaveLayerRec

Example

Example Output

rec1 == rec2

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha


SaveLayerRec

Sets fBounds, fPaint, and fSaveLayerFlags; sets fBackdrop to nullptr.

Parameters

Return Value

SaveLayerRec with empty backdrop

Example

Example Output

rec1 == rec2

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha


SaveLayerRec

Sets fBounds, fPaint, fBackdrop, and fSaveLayerFlags.

Parameters

Return Value

SaveLayerRec fully specified

Example

Example Output

rec1 == rec2

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha


SaveLayerRec

Experimental.

not readySets fBounds, fPaint, fBackdrop, fClipMask, fClipMatrix, and fSaveLayerFlags. clipMatrix uses Color Alpha channel of image, transformed by clipMatrix, to clip Layer when drawn to Canvas.

Implementation is not complete; has no effect if Device is GPU-backed.

Parameters

Return Value

SaveLayerRec fully specified

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha


Saves Matrix and Clip, and allocates Bitmap for subsequent drawing.

Calling restore discards changes to Matrix and Clip, and blends Bitmap with Color Alpha opacity onto the prior Layer.

Matrix may be changed by translate, scale, rotate, skew, concat, setMatrix, and resetMatrix. Clip may be changed by clipRect, clipRRect, clipPath, clipRegion.

SaveLayerRec contains the state used to create the Layer.

Call restoreToCount with returned value to restore this and subsequent saves.

Parameters

Return Value

depth of save state stack

Example

See Also

save restore saveLayer[2][3] saveLayerPreserveLCDTextRequests saveLayerAlpha


Matrix

translate

Translates Matrix by dx along the x-axis and dy along the y-axis.

Mathematically, replaces Matrix with a translation matrix Premultiplied with Matrix.

This has the effect of moving the drawing by (dx, dy) before transforming the result with Matrix.

Parameters

Example

The blue stroke follows translate of (50, 50); a black fill follows scale of (2, 1/2.f). After restoring the clip, which resets Matrix, a red frame follows the same scale of (2, 1/2.f); a gray fill follows translate of (50, 50).

See Also

concat scale skew rotate[2] setMatrix


scale

Scales Matrix by sx on the x-axis and sy on the y-axis.

Mathematically, replaces Matrix with a scale matrix Premultiplied with Matrix.

This has the effect of scaling the drawing by (sx, sy) before transforming the result with Matrix.

Parameters

Example

See Also

concat translate skew rotate[2] setMatrix


rotate

Rotates Matrix by degrees. Positive degrees rotates clockwise.

Mathematically, replaces Matrix with a rotation matrix Premultiplied with Matrix.

This has the effect of rotating the drawing by degrees before transforming the result with Matrix.

Parameters

Example

See Also

concat translate skew scale setMatrix


Rotates Matrix by degrees about a point at (px, py). Positive degrees rotates clockwise.

Mathematically, constructs a rotation matrix; Premultiplies the rotation matrix by a translation matrix; then replaces Matrix with the resulting matrix Premultiplied with Matrix.

This has the effect of rotating the drawing about a given point before transforming the result with Matrix.

Parameters

Example

See Also

concat translate skew scale setMatrix


skew

Skews Matrix by sx on the x-axis and sy on the y-axis. A positive value of sx skews the drawing right as y-axis values increase; a positive value of sy skews the drawing down as x-axis values increase.

Mathematically, replaces Matrix with a skew matrix Premultiplied with Matrix.

This has the effect of skewing the drawing by (sx, sy) before transforming the result with Matrix.

Parameters

Example

See Also

concat translate rotate[2] scale setMatrix


concat

Replaces Matrix with matrix Premultiplied with existing Matrix.

This has the effect of transforming the drawn geometry by matrix, before transforming the result with existing Matrix.

Parameters

Example

See Also

translate rotate[2] scale skew setMatrix


setMatrix

Replaces Matrix with matrix. Unlike concat, any prior matrix state is overwritten.

Parameters

Example

See Also

resetMatrix concat translate rotate[2] scale skew


resetMatrix

Sets Matrix to the identity matrix. Any prior matrix state is overwritten.

Example

See Also

setMatrix concat translate rotate[2] scale skew


getTotalMatrix

Returns Matrix. This does not account for translation by Device or Surface.

Return Value

Matrix in Canvas

Example

Example Output

isIdentity true

See Also

setMatrix resetMatrix concat


Clip

Clip is built from a stack of clipping paths. Each Path in the stack can be constructed from one or more Path Contour elements. The Path Contour may be composed of any number of Path Verb segments. Each Path Contour forms a closed area; Path Fill Type defines the area enclosed by Path Contour.

Clip stack of Path elements successfully restrict the Path area. Each Path is transformed by Matrix, then intersected with or subtracted from the prior Clip to form the replacement Clip. Use SkClipOp::kDifference to subtract Path from Clip; use SkClipOp::kIntersect to intersect Path with Clip.

A clipping Path may be Anti Aliased; if Path, after transformation, is composed of horizontal and vertical lines, clearing Anti Alias allows whole pixels to either be inside or outside the clip. The fastest drawing has a Aliased, rectangular clip.

If clipping Path has Anti Alias set, clip may partially clip a pixel, requiring that drawing blend partially with the destination along the edge. A rotated rectangular Anti Aliased clip looks smoother but draws slower.

Clip can combine with Rect and Round Rect primitives; like Path, these are transformed by Matrix before they are combined with Clip.

Clip can combine with Region. Region is assumed to be in Device coordinates and is unaffected by Matrix.

Example

clipRect

Replaces Clip with the intersection or difference of Clip and rect, with an Aliased or Anti Aliased clip edge. rect is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRRect[2][3] clipPath[2][3] clipRegion


Replaces Clip with the intersection or difference of Clip and rect. Resulting Clip is Aliased; pixels are fully contained by the clip. rect is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRRect[2][3] clipPath[2][3] clipRegion


Replaces Clip with the intersection of Clip and rect. Resulting Clip is Aliased; pixels are fully contained by the clip. rect is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRRect[2][3] clipPath[2][3] clipRegion


androidFramework_setDeviceClipRestriction

Sets the maximum clip rectangle, which can be set by clipRect, clipRRect and clipPath and intersect the current clip with the specified rect. The maximum clip affects only future clipping operations; it is not retroactive. The clip restriction is not recorded in pictures.

Pass an empty rect to disable maximum clip.

Parameters


clipRRect

Replaces Clip with the intersection or difference of Clip and rrect, with an Aliased or Anti Aliased clip edge. rrect is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRect[2][3] clipPath[2][3] clipRegion


Replaces Clip with the intersection or difference of Clip and rrect. Resulting Clip is Aliased; pixels are fully contained by the clip. rrect is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRect[2][3] clipPath[2][3] clipRegion


Replaces Clip with the intersection of Clip and rrect, with an Aliased or Anti Aliased clip edge. rrect is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRect[2][3] clipPath[2][3] clipRegion


clipPath

Replaces Clip with the intersection or difference of Clip and path, with an Aliased or Anti Aliased clip edge. Path Fill Type determines if path describes the area inside or outside its contours; and if Path Contour overlaps itself or another Path Contour, whether the overlaps form part of the area. path is transformed by Matrix before it is combined with Clip.

Parameters

Example

Bottom figure uses SkPath::kWinding FillType and SkClipOp::kIntersect; area inside clip is intersected with circle.

See Also

clipRect[2][3] clipRRect[2][3] clipRegion


Replaces Clip with the intersection or difference of Clip and path. Resulting Clip is Aliased; pixels are fully contained by the clip. Path Fill Type determines if path describes the area inside or outside its contours; and if Path Contour overlaps itself or another Path Contour, whether the overlaps form part of the area. path is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRect[2][3] clipRRect[2][3] clipRegion


Replaces Clip with the intersection of Clip and path. Resulting Clip is Aliased; pixels are fully contained by the clip. Path Fill Type determines if path describes the area inside or outside its contours; and if Path Contour overlaps itself or another Path Contour, whether the overlaps form part of the area. path is transformed by Matrix before it is combined with Clip.

Parameters

Example

See Also

clipRect[2][3] clipRRect[2][3] clipRegion


setAllowSimplifyClip

Experimental.

testingSet to simplify clip stack using PathOps.


clipRegion

Replaces Clip with the intersection or difference of Clip and Region deviceRgn. Resulting Clip is Aliased; pixels are fully contained by the clip. deviceRgn is unaffected by Matrix.

Parameters

Example

See Also

clipRect[2][3] clipRRect[2][3] clipPath[2][3]


quickReject

Returns true if Rect rect, transformed by Matrix, can be quickly determined to be outside of Clip. May return false even though rect is outside of Clip.

Use to check if an area to be drawn is clipped out, to skip subsequent draw calls.

Parameters

Return Value

true if rect, transformed by Matrix, does not intersect Clip

Example

Example Output

quickReject true
quickReject false

See Also

getLocalClipBounds[2] getTotalMatrix SkBitmap::drawsNothing


Returns true if path, transformed by Matrix, can be quickly determined to be outside of Clip. May return false even though path is outside of Clip.

Use to check if an area to be drawn is clipped out, to skip subsequent draw calls.

Parameters

Return Value

true if path, transformed by Matrix, does not intersect Clip

Example

Example Output

quickReject true
quickReject false

See Also

getLocalClipBounds[2] getTotalMatrix SkBitmap::drawsNothing


getLocalClipBounds

Returns bounds of Clip, transformed by inverse of Matrix. If Clip is empty, return SkRect::MakeEmpty, where all Rect sides equal zero.

Rect returned is outset by one to account for partial pixel coverage if Clip is Anti Aliased.

Return Value

bounds of Clip in local coordinates

Example

Example Output

left:-1  top:-1  right:257  bottom:257
left:29  top:129  right:121  bottom:231
left:14.5  top:64.5  right:60.5  bottom:115.5

See Also

getDeviceClipBounds[2] getBaseLayerSize quickReject[2]


Returns bounds of Clip, transformed by inverse of Matrix. If Clip is empty, return false, and set bounds to SkRect::MakeEmpty, where all Rect sides equal zero.

bounds is outset by one to account for partial pixel coverage if Clip is Anti Aliased.

Parameters

Return Value

true if Clip bounds is not empty

Example

Example Output

local bounds empty = false
local bounds empty = true

See Also

getDeviceClipBounds[2] getBaseLayerSize quickReject[2]


getDeviceClipBounds

Returns IRect bounds of Clip, unaffected by Matrix. If Clip is empty, return SkRect::MakeEmpty, where all Rect sides equal zero.

Unlike getLocalClipBounds, returned IRect is not outset.

Return Value

bounds of Clip in Device coordinates

Example

Example Output

left:0  top:0  right:256  bottom:256
left:30  top:130  right:120  bottom:230
left:15  top:65  right:60  bottom:115

See Also

getLocalClipBounds[2] getBaseLayerSize quickReject[2]


Returns IRect bounds of Clip, unaffected by Matrix. If Clip is empty, return false, and set bounds to SkRect::MakeEmpty, where all Rect sides equal zero.

Unlike getLocalClipBounds, bounds is not outset.

Parameters

Return Value

true if Clip bounds is not empty

Example

Example Output

device bounds empty = false
device bounds empty = true

See Also

getLocalClipBounds[2] getBaseLayerSize quickReject[2]


Draw

drawColor

Fills Clip with Color color. mode determines how ARGB is combined with destination.

Parameters

Example

See Also

clear SkBitmap::erase drawPaint


clear

Fills Clip with Color color using SkBlendMode::kSrc. This has the effect of replacing all pixels contained by Clip with color.

Parameters

Example

See Also

drawColor SkBitmap::erase drawPaint


discard

Makes Canvas contents undefined. Subsequent calls that read Canvas pixels, such as drawing with SkBlendMode, return undefined results. discard does not change Clip or Matrix.

discard may do nothing, depending on the implementation of Surface or Device that created Canvas.

discard allows optimized performance on subsequent draws by removing cached data associated with Surface or Device. It is not necessary to call discard once done with Canvas; any cached data is deleted when owning Surface or Device is deleted.

See Also

flush SkSurface::prepareForExternalIO GrContext::abandonContext


drawPaint

Fills Clip with Paint paint. Paint components Mask Filter, Shader, Color Filter, Image Filter, and Blend Mode affect drawing; Path Effect in paint is ignored.

Parameters

Example

See Also

clear drawColor SkBitmap::erase


Enum SkCanvas::PointMode

Selects if an array of points are drawn as discrete points, as lines, or as an open polygon.

Constants

Example

See Also

drawLine[2] drawPoint[2] drawPath

drawPoints

Draws pts using Clip, Matrix and Paint paint. count is the number of points; if count is less than one, has no effect. mode may be one of: kPoints PointMode, kLines PointMode, or kPolygon PointMode.

If mode is kPoints PointMode, the shape of point drawn depends on paint Paint Stroke Cap. If paint is set to SkPaint::kRound Cap, each point draws a circle of diameter Paint Stroke Width. If paint is set to SkPaint::kSquare Cap or SkPaint::kButt Cap, each point draws a square of width and height Paint Stroke Width.

If mode is kLines PointMode, each pair of points draws a line segment. One line is drawn for every two points; each point is used once. If count is odd, the final point is ignored.

If mode is kPolygon PointMode, each adjacent pair of points draws a line segment. count minus one lines are drawn; the first and last point are used once.

Each line segment respects paint Paint Stroke Cap and Paint Stroke Width. Paint Style is ignored, as if were set to SkPaint::kStroke Style.

Always draws each element one at a time; is not affected by Paint Stroke Join, and unlike drawPath, does not create a mask from all points and lines before drawing.

Parameters

Example

The transparent color makes multiple line draws visible; the path is drawn all at once.

See Also

drawLine[2] drawPoint[2] drawPath


drawPoint

Draws point at (x, y) using Clip, Matrix and Paint paint.

The shape of point drawn depends on paint Paint Stroke Cap. If paint is set to SkPaint::kRound Cap, draw a circle of diameter Paint Stroke Width. If paint is set to SkPaint::kSquare Cap or SkPaint::kButt Cap, draw a square of width and height Paint Stroke Width. Paint Style is ignored, as if were set to SkPaint::kStroke Style.

Parameters

Example

See Also

drawPoints drawCircle[2] drawRect drawLine[2] drawPath


Draws point p using Clip, Matrix and Paint paint.

The shape of point drawn depends on paint Paint Stroke Cap. If paint is set to SkPaint::kRound Cap, draw a circle of diameter Paint Stroke Width. If paint is set to SkPaint::kSquare Cap or SkPaint::kButt Cap, draw a square of width and height Paint Stroke Width. Paint Style is ignored, as if were set to SkPaint::kStroke Style.

Parameters

Example

See Also

drawPoints drawCircle[2] drawRect drawLine[2] drawPath


drawLine

Draws line segment from (x0, y0) to (x1, y1) using Clip, Matrix, and Paint paint. In paint: Paint Stroke Width describes the line thickness; Paint Stroke Cap draws the end rounded or square; Paint Style is ignored, as if were set to SkPaint::kStroke Style.

Parameters

Example

See Also

drawPoint[2] drawCircle[2] drawRect drawPath


Draws line segment from p0 to p1 using Clip, Matrix, and Paint paint. In paint: Paint Stroke Width describes the line thickness; Paint Stroke Cap draws the end rounded or square; Paint Style is ignored, as if were set to SkPaint::kStroke Style.

Parameters

Example

See Also

drawPoint[2] drawCircle[2] drawRect drawPath


drawRect

Draws Rect rect using Clip, Matrix, and Paint paint. In paint: Paint Style determines if rectangle is stroked or filled; if stroked, Paint Stroke Width describes the line thickness, and Paint Stroke Join draws the corners rounded or square.

Parameters

Example

See Also

drawIRect drawRRect drawRoundRect drawRegion drawPath drawLine[2]


drawIRect

Draws IRect rect using Clip, Matrix, and Paint paint. In paint: Paint Style determines if rectangle is stroked or filled; if stroked, Paint Stroke Width describes the line thickness, and Paint Stroke Join draws the corners rounded or square.

Parameters

Example

See Also

drawRect drawRRect drawRoundRect drawRegion drawPath drawLine[2]


drawRegion

Draws Region region using Clip, Matrix, and Paint paint. In paint: Paint Style determines if rectangle is stroked or filled; if stroked, Paint Stroke Width describes the line thickness, and Paint Stroke Join draws the corners rounded or square.

Parameters

Example

See Also

drawRect drawIRect drawPath


drawOval

Draws Oval oval using Clip, Matrix, and Paint. In paint: Paint Style determines if Oval is stroked or filled; if stroked, Paint Stroke Width describes the line thickness.

Parameters

Example

See Also

drawCircle[2] drawPoint[2] drawPath drawRRect drawRoundRect


drawRRect

Draws Round Rect rrect using Clip, Matrix, and Paint paint. In paint: Paint Style determines if rrect is stroked or filled; if stroked, Paint Stroke Width describes the line thickness.

rrect may represent a rectangle, circle, oval, uniformly rounded rectangle, or may have any combination of positive non-square radii for the four corners.

Parameters

Example

See Also

drawRect drawRoundRect drawDRRect drawCircle[2] drawOval drawPath


drawDRRect

Draws Round Rect outer and inner using Clip, Matrix, and Paint paint. outer must contain inner or the drawing is undefined. In paint: Paint Style determines if Round Rect is stroked or filled; if stroked, Paint Stroke Width describes the line thickness. If stroked and Round Rect corner has zero length radii, Paint Stroke Join can draw corners rounded or square.

GPU-backed platforms optimize drawing when both outer and inner are concave and outer contains inner. These platforms may not be able to draw Path built with identical data as fast.

Parameters

Example

Example

See Also

drawRect drawRoundRect drawRRect drawCircle[2] drawOval drawPath


drawCircle

Draws Circle at (cx, cy) with radius using Clip, Matrix, and Paint paint. If radius is zero or less, nothing is drawn. In paint: Paint Style determines if Circle is stroked or filled; if stroked, Paint Stroke Width describes the line thickness.

Parameters

Example

See Also

drawOval drawRRect drawRoundRect drawPath drawArc drawPoint[2] drawLine[2]


Draws Circle at center with radius using Clip, Matrix, and Paint paint. If radius is zero or less, nothing is drawn. In paint: Paint Style determines if Circle is stroked or filled; if stroked, Paint Stroke Width describes the line thickness.

Parameters

Example

See Also

drawOval drawRRect drawRoundRect drawPath drawArc drawPoint[2] drawLine[2]


drawArc

Draws Arc using Clip, Matrix, and Paint paint.

Arc is part of Oval bounded by oval, sweeping from startAngle to startAngle plus sweepAngle. startAngle and sweepAngle are in degrees.

startAngle of zero places start point at the right middle edge of oval. A positive sweepAngle places Arc end point clockwise from start point; a negative sweepAngle places Arc end point counterclockwise from start point. sweepAngle may exceed 360 degrees, a full circle. If useCenter is true, draw a wedge that includes lines from oval center to Arc end points. If useCenter is false, draw Arc between end points.

If Rect oval is empty or sweepAngle is zero, nothing is drawn.

Parameters

Example

Example

See Also

SkPath::arcTo[2][3][4][5] drawCircle[2] drawOval drawPath


drawRoundRect

Draws Round Rect bounded by Rect rect, with corner radii (rx, ry) using Clip, Matrix, and Paint paint.

In paint: Paint Style determines if Round Rect is stroked or filled; if stroked, Paint Stroke Width describes the line thickness. If rx or ry are less than zero, they are treated as if they are zero. If rx plus ry exceeds rect width or rect height, radii are scaled down to fit. If rx and ry are zero, Round Rect is drawn as Rect and if stroked is affected by Paint Stroke Join.

Parameters

Example

See Also

DrawRRect drawRect drawDRRect drawPath drawCircle[2] drawOval drawPoint[2]


drawPath

Draws Path path using Clip, Matrix, and Paint paint. Path contains an array of Path Contour, each of which may be open or closed.

In paint: Paint Style determines if Round Rect is stroked or filled: if filled, Path Fill Type determines whether Path Contour describes inside or outside of fill; if stroked, Paint Stroke Width describes the line thickness, Paint Stroke Cap describes line ends, and Paint Stroke Join describes how corners are drawn.

Parameters

Example

See Also

SkPath drawLine[2] drawArc drawRect drawPoints


Draw Image

drawImage, drawImageRect, and drawImageNine can be called with a bare pointer or a smart pointer as a convenience. The pairs of calls are otherwise identical.

drawImage

Draws Image image, with its top-left corner at (left, top), using Clip, Matrix, and optional Paint paint.

If paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds. If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawBitmap drawImageLattice drawImageNine[2] drawImageRect[2][3][4][5][6] SkPaint::setImageFilter


Draws Image image, with its top-left corner at (left, top), using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds. If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawBitmap drawImageLattice drawImageNine[2] drawImageRect[2][3][4][5][6] SkPaint::setImageFilter


Enum SkCanvas::SrcRectConstraint

SrcRectConstraint controls the behavior at the edge of source Rect, provided to drawImageRect, trading off speed for precision.

Image Filter in Paint may sample multiple pixels in the image. Source Rect restricts the bounds of pixels that may be read. Image Filter may slow down if it cannot read outside the bounds, when sampling near the edge of source Rect. SrcRectConstraint specifies whether an Image Filter is allowed to read pixels outside source Rect.

Constants

Example

See Also

drawImageRect[2][3][4][5][6] drawImage[2] SkPaint::setImageFilter

drawImageRect

Draws Rect src of Image image, scaled and translated to fill Rect dst. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds.

If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within src; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

SrcRectConstraint drawImage[2] drawImageLattice drawImageNine[2]


Draws IRect isrc of Image image, scaled and translated to fill Rect dst. Note that isrc is on integer pixel boundaries; dst may include fractional boundaries. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds.

If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within isrc; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

SrcRectConstraint drawImage[2] drawImageLattice drawImageNine[2]


Draws Image image, scaled and translated to fill Rect dst, using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds.

If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within image; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

SrcRectConstraint drawImage[2] drawImageLattice drawImageNine[2]


Draws Rect src of Image image, scaled and translated to fill Rect dst. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds.

If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within src; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

SrcRectConstraint drawImage[2] drawImageLattice drawImageNine[2]


Draws IRect isrc of Image image, scaled and translated to fill Rect dst. isrc is on integer pixel boundaries; dst may include fractional boundaries. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds.

If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within image; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

SrcRectConstraint drawImage[2] drawImageLattice drawImageNine[2]


Draws Image image, scaled and translated to fill Rect dst, using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds.

If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within image; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

SrcRectConstraint drawImage[2] drawImageLattice drawImageNine[2]


drawImageNine

Draws Image image stretched proportionally to fit into Rect dst. IRect center divides the image into nine sections: four sides, four corners, and the center. Corners are unmodified or scaled down proportionately if their sides are larger than dst; center and four sides are scaled to fit remaining space, if any.

Additionally transform draw using Clip, Matrix, and optional Paint paint. If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds. If paint Filter Quality set to kNone_SkFilterQuality, disable pixel filtering. For all other values of paint Filter Quality, use kLow_SkFilterQuality to filter pixels. Any SkMaskFilter on paint is ignored as is paint Anti Aliasing state. If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawImage[2] drawBitmapNine drawImageLattice drawImageRect[2][3][4][5][6]


Draws Image image stretched proportionally to fit into Rect dst. IRect center divides the image into nine sections: four sides, four corners, and the center. Corners are not scaled, or scaled down proportionately if their sides are larger than dst; center and four sides are scaled to fit remaining space, if any.

Additionally transform draw using Clip, Matrix, and optional Paint paint. If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds. If paint Filter Quality set to kNone_SkFilterQuality, disable pixel filtering. For all other values of paint Filter Quality, use kLow_SkFilterQuality to filter pixels. Any SkMaskFilter on paint is ignored as is paint Anti Aliasing state. If generated mask extends beyond image bounds, replicate image edge colors, just as Shader made from SkImage::makeShader with SkShader::kClamp TileMode set replicates the image edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawImage[2] drawBitmapNine drawImageLattice drawImageRect[2][3][4][5][6]


drawBitmap

Draws Bitmap bitmap, with its top-left corner at (left, top), using Clip, Matrix, and optional Paint paint.

If Paint paint is not nullptr, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If bitmap is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from bitmap bounds.

If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawImage[2] drawBitmapLattice drawBitmapNine drawBitmapRect[2][3] SkBitmap::readPixels[2][3][4] SkBitmap::writePixels[2][3]


drawBitmapRect

Draws Rect src of Bitmap bitmap, scaled and translated to fill Rect dst. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If bitmap is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from bitmap bounds.

If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within src; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

drawImageRect[2][3][4][5][6] drawBitmap drawBitmapLattice drawBitmapNine


Draws IRect isrc of Bitmap bitmap, scaled and translated to fill Rect dst. isrc is on integer pixel boundaries; dst may include fractional boundaries. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If bitmap is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from bitmap bounds.

If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within isrc; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

drawImageRect[2][3][4][5][6] drawBitmap drawBitmapLattice drawBitmapNine


Draws Bitmap bitmap, scaled and translated to fill Rect dst. bitmap bounds is on integer pixel boundaries; dst may include fractional boundaries. Additionally transform draw using Clip, Matrix, and optional Paint paint.

If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If bitmap is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from bitmap bounds.

If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

constraint set to kStrict SrcRectConstraint limits Paint Filter Quality to sample within bitmap; set to kFast SrcRectConstraint allows sampling outside to improve performance.

Parameters

Example

See Also

drawImageRect[2][3][4][5][6] drawBitmap drawBitmapLattice drawBitmapNine


drawBitmapNine

Draws Bitmap bitmap stretched proportionally to fit into Rect dst. IRect center divides the bitmap into nine sections: four sides, four corners, and the center. Corners are not scaled, or scaled down proportionately if their sides are larger than dst; center and four sides are scaled to fit remaining space, if any.

Additionally transform draw using Clip, Matrix, and optional Paint paint. If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If bitmap is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from bitmap bounds. If paint Filter Quality set to kNone_SkFilterQuality, disable pixel filtering. For all other values of paint Filter Quality, use kLow_SkFilterQuality to filter pixels. Any SkMaskFilter on paint is ignored as is paint Anti Aliasing state. If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawImageNine[2] drawBitmap drawBitmapLattice drawBitmapRect[2][3]


Draw Image Lattice

Struct SkCanvas::Lattice

Lattice divides Bitmap or Image into a rectangular grid. Grid entries on even columns and even rows are fixed; these entries are always drawn at their original size if the destination is large enough. If the destination side is too small to hold the fixed entries, all fixed entries are proportionately scaled down to fit. The grid entries not on even columns and rows are scaled to fit the remaining space, if any.

Draw Image Lattice Overview

Draw Image Lattice Constant

Enum SkCanvas::Lattice::RectType

Optional setting per rectangular grid entry to make it transparent, or to fill the grid entry with a color.

Constants

Draw Image Lattice Member

Members

Each RectType is one of: kDefault, kTransparent, kFixedColor.

Array entries correspond to the rectangular grid entries, ascending left to right and then top to bottom.

Array entries correspond to the rectangular grid entries, ascending left to right, then top to bottom.

drawBitmapLattice

Draws Bitmap bitmap stretched proportionally to fit into Rect dst.

Lattice lattice divides bitmap into a rectangular grid. Each intersection of an even-numbered row and column is fixed; like the corners of drawBitmapNine, fixed lattice elements never scale larger than their initial size and shrink proportionately when all fixed elements exceed the bitmap dimension. All other grid elements scale to fill the available space, if any.

Additionally transform draw using Clip, Matrix, and optional Paint paint. If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If bitmap is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from bitmap bounds. If paint Filter Quality set to kNone_SkFilterQuality, disable pixel filtering. For all other values of paint Filter Quality, use kLow_SkFilterQuality to filter pixels. Any SkMaskFilter on paint is ignored as is paint Anti Aliasing state. If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawImageLattice drawBitmap drawBitmapNine Lattice


drawImageLattice

Draws Image image stretched proportionally to fit into Rect dst.

Lattice lattice divides image into a rectangular grid. Each intersection of an even-numbered row and column is fixed; like the corners of drawBitmapNine, fixed lattice elements never scale larger than their initial size and shrink proportionately when all fixed elements exceed the bitmap dimension. All other grid elements scale to fill the available space, if any.

Additionally transform draw using Clip, Matrix, and optional Paint paint. If Paint paint is supplied, apply Color Filter, Color Alpha, Image Filter, Blend Mode, and Draw Looper. If image is kAlpha_8_SkColorType, apply Shader. If paint contains Mask Filter, generate mask from image bounds. If paint Filter Quality set to kNone_SkFilterQuality, disable pixel filtering. For all other values of paint Filter Quality, use kLow_SkFilterQuality to filter pixels. Any SkMaskFilter on paint is ignored as is paint Anti Aliasing state. If generated mask extends beyond bitmap bounds, replicate bitmap edge colors, just as Shader made from SkShader::MakeBitmapShader with SkShader::kClamp TileMode set replicates the bitmap edge color when it samples outside of its bounds.

Parameters

Example

See Also

drawBitmapLattice drawImage[2] drawImageNine[2] Lattice


Draw Text

drawText

Draws text, with origin at (x, y), using Clip, Matrix, and Paint paint.

text meaning depends on Paint Text Encoding; by default, text is encoded as UTF-8.

x and y meaning depends on Paint Text Align and Paint Vertical Text; by default text draws left to right, positioning the first glyph left side bearing at x and its baseline at y. Text size is affected by Matrix and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Parameters

Example

See Also

drawString[2] drawPosText drawPosTextH drawTextBlob[2] drawTextOnPath drawTextRSXform


drawString

Draws null terminated string, with origin at (x, y), using Clip, Matrix, and Paint paint.

string meaning depends on Paint Text Encoding; by default, strings are encoded as UTF-8. Other values of Paint Text Encoding are unlikely to produce the desired results, since zero bytes may be embedded in the string.

x and y meaning depends on Paint Text Align and Paint Vertical Text; by default string draws left to right, positioning the first glyph left side bearing at x and its baseline at y. Text size is affected by Matrix and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Parameters

Example

See Also

drawText drawPosText drawPosTextH drawTextBlob[2] drawTextOnPath drawTextRSXform


Draws null terminated string, with origin at (x, y), using Clip, Matrix, and Paint paint.

string meaning depends on Paint Text Encoding; by default, strings are encoded as UTF-8. Other values of Paint Text Encoding are unlikely to produce the desired results, since zero bytes may be embedded in the string.

x and y meaning depends on Paint Text Align and Paint Vertical Text; by default string draws left to right, positioning the first glyph left side bearing at x and its baseline at y. Text size is affected by Matrix and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Parameters

Example

See Also

drawText drawPosText drawPosTextH drawTextBlob[2] drawTextOnPath drawTextRSXform


drawPosText

Draws each glyph in text with the origin in pos array, using Clip, Matrix, and Paint paint. The number of entries in pos array must match the number of Glyphs described by byteLength of text.

text meaning depends on Paint Text Encoding; by default, text is encoded as UTF-8. pos elements meaning depends on Paint Vertical Text; by default glyph left side bearing and baseline are relative to Point in pos array. Text size is affected by Matrix and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Layout engines such as Harfbuzz typically position each glyph rather than using the font advance widths.

Parameters

Example

See Also

drawText drawPosTextH drawTextBlob[2] drawTextOnPath drawTextRSXform


drawPosTextH

Draws each glyph in text with its (x, y) origin composed from xpos array and constY, using Clip, Matrix, and Paint paint. The number of entries in xpos array must match the number of Glyphs described by byteLength of text.

text meaning depends on Paint Text Encoding; by default, text is encoded as UTF-8. xpos elements meaning depends on Paint Vertical Text; by default each glyph left side bearing is positioned at an xpos element and its baseline is positioned at constY. Text size is affected by Matrix and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Layout engines such as Harfbuzz typically position each glyph rather than using the font advance widths if all Glyphs share the same baseline.

Parameters

Example

See Also

drawText drawPosText drawTextBlob[2] drawTextOnPath drawTextRSXform


drawTextOnPathHV

Draws text on Path path, using Clip, Matrix, and Paint paint.

Origin of text is at distance hOffset along the path, offset by a perpendicular vector of length vOffset. If the path section corresponding the glyph advance is curved, the glyph is drawn curved to match; control points in the glyph are mapped to projected points parallel to the path. If the text advance is larger than the path length, the excess text is clipped.

text meaning depends on Paint Text Encoding; by default, text is encoded as UTF-8. Origin meaning depends on Paint Text Align and Paint Vertical Text; by default text positions the first glyph left side bearing and baseline relative to origin. Text size is affected by Matrix and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Parameters

Example

See Also

drawTextOnPath drawText drawPosTextH drawTextBlob[2] drawTextRSXform


drawTextOnPath

Draws text on Path path, using Clip, Matrix, and Paint paint.

Origin of text is at beginning of path offset by matrix, if not nullptr. matrix transforms text before text is mapped to path. If the path section corresponding the glyph advance is curved, the glyph is drawn curved to match; control points in the glyph are mapped to projected points parallel to the path. If the text advance is larger than the path length, the excess text is clipped.

matrix does not effect paint Shader.

text meaning depends on Paint Text Encoding; by default, text is encoded as UTF-8. Origin meaning depends on Paint Text Align and Paint Vertical Text; by default text positions the first glyph left side bearing and baseline relative to origin. Text size is affected by matrix parameter, Canvas Matrix, and Paint Text Size.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Parameters

Example

See Also

drawTextOnPathHV drawText drawPosTextH drawTextBlob[2] drawTextRSXform


drawTextRSXform

Draws text, transforming each glyph by the corresponding SkRSXform, using Clip, Matrix, and Paint paint.

RSXform xform array specifies a separate square scale, rotation, and translation for each glyph. xform does not affect paint Shader.

Optional Rect cullRect is a conservative bounds of text, taking into account RSXform and paint. If cullRect is outside of Clip, canvas can skip drawing.

All elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to text. By default, draws filled 12 point black Glyphs.

Parameters

Example

See Also

drawTextOnPath drawTextOnPathHV drawText drawPosText drawTextBlob[2]


drawTextBlob

Draws Text Blob blob at (x, y), using Clip, Matrix, and Paint paint.

blob contains Glyphs, their positions, and paint attributes specific to text: Typeface, Paint Text Size, Paint Text Scale X, Paint Text Skew X, Paint Text Align, Paint Hinting, Anti Alias, Paint Fake Bold, Font Embedded Bitmaps, Full Hinting Spacing, LCD Text, Linear Text, Subpixel Text, and Paint Vertical Text.

Paint Text Encoding must be set to SkPaint::kGlyphID TextEncoding.

Elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to blob.

Parameters

Example

See Also

drawText drawPosText drawPosTextH


Draws Text Blob blob at (x, y), using Clip, Matrix, and Paint paint.

blob contains Glyphs, their positions, and paint attributes specific to text: Typeface, Paint Text Size, Paint Text Scale X, Paint Text Skew X, Paint Text Align, Paint Hinting, Anti Alias, Paint Fake Bold, Font Embedded Bitmaps, Full Hinting Spacing, LCD Text, Linear Text, Subpixel Text, and Paint Vertical Text.

Paint Text Encoding must be set to SkPaint::kGlyphID TextEncoding.

Elements of paint: Path Effect, Mask Filter, Shader, Color Filter, Image Filter, and Draw Looper; apply to blob.

Parameters

Example

See Also

drawText drawPosText drawPosTextH


drawPicture

Draws Picture picture, using Clip and Matrix. Clip and Matrix are unchanged by picture contents, as if save was called before and restore was called after drawPicture.

Picture records a series of draw commands for later playback.

Parameters

Example

See Also

drawDrawable[2] SkPicture SkPicture::playback


Draws Picture picture, using Clip and Matrix. Clip and Matrix are unchanged by picture contents, as if save was called before and restore was called after drawPicture.

Picture records a series of draw commands for later playback.

Parameters

Example

See Also

drawDrawable[2] SkPicture SkPicture::playback


Draws Picture picture, using Clip and Matrix; transforming picture with Matrix matrix, if provided; and use Paint paint Color Alpha, Color Filter, Image Filter, and Blend Mode, if provided.

matrix transformation is equivalent to: save, concat, drawPicture, restore. paint use is equivalent to: saveLayer, drawPicture, restore.

Parameters

Example

See Also

drawDrawable[2] SkPicture SkPicture::playback


Draws Picture picture, using Clip and Matrix; transforming picture with Matrix matrix, if provided; and use Paint paint Color Alpha, Color Filter, Image Filter, and Blend Mode, if provided.

matrix transformation is equivalent to: save, concat, drawPicture, restore. paint use is equivalent to: saveLayer, drawPicture, restore.

Parameters

Example

See Also

drawDrawable[2] SkPicture SkPicture::playback


drawVertices

Draws Vertices vertices, a triangle mesh, using Clip and Matrix. If Vertices Texs and Vertices Colors are defined in vertices, and Paint paint contains Shader, Blend Mode mode combines Vertices Colors with Shader.

Parameters

Example

See Also

drawPatch[2] drawPicture[2][3][4]


Draws Vertices vertices, a triangle mesh, using Clip and Matrix. If Vertices Texs and Vertices Colors are defined in vertices, and Paint paint contains Shader, Blend Mode mode combines Vertices Colors with Shader.

Parameters

Example

See Also

drawPatch[2] drawPicture[2][3][4]


Draws Vertices vertices, a triangle mesh, using Clip and Matrix. Bone data is used to deform vertices with bone weights. If Vertices Texs and Vertices Colors are defined in vertices, and Paint paint contains Shader, Blend Mode mode combines Vertices Colors with Shader. The first element of bones should be an object to world space transformation matrix that will be applied before performing mesh deformations. If no such transformation is needed, it should be the identity matrix. boneCount must be at most 100, and thus the size of bones should be at most 100.

Parameters

Example

See Also

drawPatch[2] drawPicture[2][3][4]


Draws Vertices vertices, a triangle mesh, using Clip and Matrix. Bone data is used to deform vertices with bone weights. If Vertices Texs and Vertices Colors are defined in vertices, and Paint paint contains Shader, Blend Mode mode combines Vertices Colors with Shader. The first element of bones should be an object to world space transformation matrix that will be applied before performing mesh deformations. If no such transformation is needed, it should be the identity matrix. boneCount must be at most 100, and thus the size of bones should be at most 100.

Parameters

Example

See Also

drawPatch[2] drawPicture[2][3][4]


drawPatch

Draws a Coons Patch: the interpolation of four cubics with shared corners, associating a color, and optionally a texture Point, with each corner.

Coons Patch uses Clip and Matrix, paint Shader, Color Filter, Color Alpha, Image Filter, and Blend Mode. If Shader is provided it is treated as Coons Patch texture; Blend Mode mode combines Color colors and Shader if both are provided.

Point array cubics specifies four Cubics starting at the top-left corner, in clockwise order, sharing every fourth point. The last Cubic ends at the first point.

Color array color associates colors with corners in top-left, top-right, bottom-right, bottom-left order.

If paint contains Shader, Point array texCoords maps Shader as texture to corners in top-left, top-right, bottom-right, bottom-left order.

Parameters

Example

See Also

SeeAlso drawVertices[2][3][4] drawPicture[2][3][4]


Draws Cubic Coons Patch: the interpolation of four cubics with shared corners, associating a color, and optionally a texture Point, with each corner.

Coons Patch uses Clip and Matrix, paint Shader, Color Filter, Color Alpha, Image Filter, and Blend Mode. If Shader is provided it is treated as Coons Patch texture; Blend Mode mode combines Color colors and Shader if both are provided.

Point array cubics specifies four Cubics starting at the top-left corner, in clockwise order, sharing every fourth point. The last Cubic ends at the first point.

Color array color associates colors with corners in top-left, top-right, bottom-right, bottom-left order.

If paint contains Shader, Point array texCoords maps Shader as texture to corners in top-left, top-right, bottom-right, bottom-left order.

Parameters

Example

Example

See Also

SeeAlso drawVertices[2][3][4] drawPicture[2][3][4]


drawAtlas

Draws a set of sprites from atlas, using Clip, Matrix, and optional Paint paint. paint uses Anti Alias, Color Alpha, Color Filter, Image Filter, and Blend Mode to draw, if present. For each entry in the array, Rect tex locates sprite in atlas, and RSXform xform transforms it into destination space.

xform, text, and colors if present, must contain count entries. Optional colors are applied for each sprite using Blend Mode mode, treating sprite as source and colors as destination. Optional cullRect is a conservative bounds of all transformed sprites. If cullRect is outside of Clip, canvas can skip drawing.

Parameters

Example

See Also

drawBitmap drawImage[2]


Draws a set of sprites from atlas, using Clip, Matrix, and optional Paint paint. paint uses Anti Alias, Color Alpha, Color Filter, Image Filter, and Blend Mode to draw, if present. For each entry in the array, Rect tex locates sprite in atlas, and RSXform xform transforms it into destination space.

xform, text, and colors if present, must contain count entries. Optional colors is applied for each sprite using Blend Mode. Optional cullRect is a conservative bounds of all transformed sprites. If cullRect is outside of Clip, canvas can skip drawing.

Parameters

Example

See Also

drawBitmap drawImage[2]


Draws a set of sprites from atlas, using Clip, Matrix, and optional Paint paint. paint uses Anti Alias, Color Alpha, Color Filter, Image Filter, and Blend Mode to draw, if present. For each entry in the array, Rect tex locates sprite in atlas, and RSXform xform transforms it into destination space.

xform and text must contain count entries. Optional cullRect is a conservative bounds of all transformed sprites. If cullRect is outside of Clip, canvas can skip drawing.

Parameters

Example

See Also

drawBitmap drawImage[2]


Draws a set of sprites from atlas, using Clip, Matrix, and optional Paint paint. paint uses Anti Alias, Color Alpha, Color Filter, Image Filter, and Blend Mode to draw, if present. For each entry in the array, Rect tex locates sprite in atlas, and RSXform xform transforms it into destination space.

xform and text must contain count entries. Optional cullRect is a conservative bounds of all transformed sprites. If cullRect is outside of Clip, canvas can skip drawing.

Parameters

Example

See Also

drawBitmap drawImage[2]


drawDrawable

Draws Drawable drawable using Clip and Matrix, concatenated with optional matrix.

If Canvas has an asynchronous implementation, as is the case when it is recording into Picture, then drawable will be referenced, so that SkDrawable::draw() can be called when the operation is finalized. To force immediate drawing, call SkDrawable::draw() instead.

Parameters

Example

See Also

SkDrawable drawPicture[2][3][4]


Draws Drawable drawable using Clip and Matrix, offset by (x, y).

If Canvas has an asynchronous implementation, as is the case when it is recording into Picture, then drawable will be referenced, so that SkDrawable::draw() can be called when the operation is finalized. To force immediate drawing, call SkDrawable::draw() instead.

Parameters

Example

See Also

SkDrawable drawPicture[2][3][4]


drawAnnotation

Associates Rect on Canvas with an annotation; a key-value pair, where the key is a null-terminated utf8 string, and optional value is stored as Data.

Only some canvas implementations, such as recording to Picture, or drawing to Document PDF, use annotations.

Parameters

Example

See Also

SkPicture SkDocument


Associates Rect on Canvas when an annotation; a key-value pair, where the key is a null-terminated utf8 string, and optional value is stored as Data.

Only some canvas implementations, such as recording to Picture, or drawing to Document PDF, use annotations.

Parameters

Example

See Also

SkPicture SkDocument


isClipEmpty

Returns true if Clip is empty; that is, nothing will draw.

May do work when called; it should not be called more often than needed. However, once called, subsequent calls perform no work until Clip changes.

Return Value

true if Clip is empty

Example

Example Output

clip is not empty
clip is empty

See Also

isClipRect getLocalClipBounds[2] getDeviceClipBounds[2]


isClipRect

Returns true if Clip is Rect and not empty. Returns false if the clip is empty, or if it is not Rect.

Return Value

true if Clip is Rect and not empty

Example

Example Output

clip is rect
clip is not rect

See Also

isClipEmpty getLocalClipBounds[2] getDeviceClipBounds[2]