CanvasDrawingSession Class |
Namespace: Microsoft.Graphics.Canvas
public sealed class CanvasDrawingSession : IDisposable, ICanvasResourceCreatorWithDpi, ICanvasResourceCreator
The CanvasDrawingSession type exposes the following members.
Name | Description | |
---|---|---|
Antialiasing | Enables or disables primitive edge antialiasing for this drawing session. | |
Blend | Sets the blend mode for this drawing session. | |
Device | Gets the underlying device used by this drawing session. | |
Dpi | Gets the dots-per-inch (DPI) of this drawing session. | |
EffectBufferPrecision | Specifies the default precision used for intermediate buffers when drawing image effects. | |
EffectTileSize | Specifies the tile size used when drawing image effects. | |
TextAntialiasing | Sets the text antialiasing mode for this drawing session. | |
TextRenderingParameters | Describes advanced options which are applied when text is being drawn. | |
Transform | Sets the transform matrix that will be applied to subsequent drawing calls on this drawing session. | |
Units | Sets what units are used to specifiy coordinates for this drawing session. |
Name | Description | |
---|---|---|
Clear(Color) | Clears to the specified color. | |
Clear(Vector4) | Clears to the specified high-dynamic-range color. | |
ConvertDipsToPixels | Converts units from device independent pixels (DIPs) to physical pixels based on the DPI of this drawing session. | |
ConvertPixelsToDips | Converts units from physical pixels to device independent pixels (DIPs) based on the DPI of this drawing session. | |
CreateLayer(Single) | Creates a layer that will blend its contents using the specified opacity. | |
CreateLayer(ICanvasBrush) | Creates a layer that will blend its contents using the specified opacity mask brush (which could contain a bitmap or gradient). | |
CreateLayer(Single, CanvasGeometry) | Creates a layer that will clip its contents to an arbitrarily complex region defined by a geometry, and blend using the specified opacity. | |
CreateLayer(Single, Rect) | Creates a layer that will clip its contents to a rectangle, and blend using the specified opacity. | |
CreateLayer(ICanvasBrush, CanvasGeometry) | Creates a layer that will clip its contents to an arbitrarily complex region defined by a geometry, and blend using the specified opacity mask brush. | |
CreateLayer(ICanvasBrush, Rect) | Creates a layer that will clip its contents to a rectangle, and blend using the specified opacity mask brush. | |
CreateLayer(Single, CanvasGeometry, Matrix3x2) | Creates a layer that will clip its contents to an arbitrarily complex region defined by a geometry, and blend using the specified opacity. | |
CreateLayer(ICanvasBrush, CanvasGeometry, Matrix3x2) | Creates a layer that will clip its contents to an arbitrarily complex region defined by a geometry, and blend the specified opacity mask brush. | |
CreateLayer(Single, ICanvasBrush, Rect, CanvasGeometry, Matrix3x2, CanvasLayerOptions) | Creates a layer that will clip its contents to a rectangle and/or geometry region, and blend using the specified opacity and/or opacity mask brush. | |
CreateSpriteBatch | [Win10_10586] Creates a new sprite batch for efficiently drawing many CanvasBitmaps. | |
CreateSpriteBatch(CanvasSpriteSortMode) | [Win10_10586] Creates a new sprite batch for efficiently drawing many CanvasBitmaps with a specific sort mode. | |
CreateSpriteBatch(CanvasSpriteSortMode, CanvasImageInterpolation) | [Win10_10586] Creates a new sprite batch for efficiently drawing many CanvasBitmaps with a specific sort mode and interpolation. | |
CreateSpriteBatch(CanvasSpriteSortMode, CanvasImageInterpolation, CanvasSpriteOptions) | [Win10_10586] Creates a new sprite batch for efficiently drawing many CanvasBitmaps with a specific sort mode, interpolation and options. | |
Dispose | Releases all resources used by the CanvasDrawingSession. | |
DrawCachedGeometry(CanvasCachedGeometry, ICanvasBrush) | Draws a cached geometry relative to the origin, using a brush to define the color. | |
DrawCachedGeometry(CanvasCachedGeometry, Color) | Draws a cached geometry relative to the origin and with the specified color. | |
DrawCachedGeometry(CanvasCachedGeometry, Vector2, ICanvasBrush) | Draws a cached geometry relative to the specified position, using a brush to define the color. | |
DrawCachedGeometry(CanvasCachedGeometry, Vector2, Color) | Draws a cached geometry relative to the specified position and with the specified color. | |
DrawCachedGeometry(CanvasCachedGeometry, Single, Single, ICanvasBrush) | Draws a cached geometry relative to the specified position, using a brush to define the color. | |
DrawCachedGeometry(CanvasCachedGeometry, Single, Single, Color) | Draws a cached geometry relative to the specified position and with the specified color. | |
DrawCircle(Vector2, Single, ICanvasBrush) | Draws a circle of single unit stroke width, using a brush to define the color. | |
DrawCircle(Vector2, Single, Color) | Draws a circle of single unit stroke width and the specified color. | |
DrawCircle(Single, Single, Single, ICanvasBrush) | Draws a circle of single unit stroke width, using a brush to define the color. | |
DrawCircle(Single, Single, Single, Color) | Draws a circle of single unit stroke width and the specified color. | |
DrawCircle(Vector2, Single, ICanvasBrush, Single) | Draws a circle of the specified stroke width, using a brush to define the color. | |
DrawCircle(Vector2, Single, Color, Single) | Draws a circle of the specified stroke width and color. | |
DrawCircle(Single, Single, Single, ICanvasBrush, Single) | Draws a circle of the specified stroke width, using a brush to define the color. | |
DrawCircle(Single, Single, Single, Color, Single) | Draws a circle of the specified stroke width and color. | |
DrawCircle(Vector2, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a circle of the specified stroke width, using a brush to define the color and with a custom stroke style. | |
DrawCircle(Vector2, Single, Color, Single, CanvasStrokeStyle) | Draws a circle of the specified stroke width and color, with a custom stroke style. | |
DrawCircle(Single, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a circle of the specified stroke width, using a brush to define the color and with a custom stroke style. | |
DrawCircle(Single, Single, Single, Color, Single, CanvasStrokeStyle) | Draws a circle of the specified stroke width and color, with a custom stroke style. | |
DrawEllipse(Vector2, Single, Single, ICanvasBrush) | It's like a circle, but squashed. Using a brush to define the color. | |
DrawEllipse(Vector2, Single, Single, Color) | It's like a circle, but squashed. | |
DrawEllipse(Single, Single, Single, Single, ICanvasBrush) | It's like a circle, but squashed. Using a brush to define the color. | |
DrawEllipse(Single, Single, Single, Single, Color) | It's like a circle, but squashed. | |
DrawEllipse(Vector2, Single, Single, ICanvasBrush, Single) | It's like a circle, but squashed. Using a brush to define the color. | |
DrawEllipse(Vector2, Single, Single, Color, Single) | It's like a circle, but squashed. | |
DrawEllipse(Single, Single, Single, Single, ICanvasBrush, Single) | It's like a circle, but squashed. Using a brush to define the color. | |
DrawEllipse(Single, Single, Single, Single, Color, Single) | It's like a circle, but squashed. | |
DrawEllipse(Vector2, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | It's like a circle, but squashed. Using a brush to define the color and with a custom stroke style. | |
DrawEllipse(Vector2, Single, Single, Color, Single, CanvasStrokeStyle) | It's like a circle, but squashed. | |
DrawEllipse(Single, Single, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | It's like a circle, but squashed. Using a brush to define the color and with a custom stroke style. | |
DrawEllipse(Single, Single, Single, Single, Color, Single, CanvasStrokeStyle) | It's like a circle, but squashed. | |
DrawGeometry(CanvasGeometry, ICanvasBrush) | Draws a geometry relative to the origin, with a single unit stroke width, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Color) | Draws a geometry relative to the origin, with a single unit stroke width and the specified color. | |
DrawGeometry(CanvasGeometry, ICanvasBrush, Single) | Draws a geometry relative to the origin, with the specified stroke width, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Vector2, ICanvasBrush) | Draws a geometry relative to the specified position, with a single unit stroke width, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Vector2, Color) | Draws a geometry relative to the specified position, with a single unit stroke width and the specified color. | |
DrawGeometry(CanvasGeometry, Color, Single) | Draws a geometry relative to the origin, with the specified stroke width and color. | |
DrawGeometry(CanvasGeometry, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a geometry relative to the origin, with the specified stroke width and stroke style, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Vector2, ICanvasBrush, Single) | Draws a geometry relative to the specified position, with the specified stroke width, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Vector2, Color, Single) | Draws a geometry relative to the specified position, with the specified stroke width and color. | |
DrawGeometry(CanvasGeometry, Single, Single, ICanvasBrush) | Draws a geometry relative to the specified position, with a single unit stroke width, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Single, Single, Color) | Draws a geometry relative to the specified position, with a single unit stroke width and the specified color. | |
DrawGeometry(CanvasGeometry, Color, Single, CanvasStrokeStyle) | Draws a geometry relative to the origin, with the specified stroke width, stroke style, and color. | |
DrawGeometry(CanvasGeometry, Vector2, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a geometry relative to the specified position, with the specified stroke width and stroke style, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Vector2, Color, Single, CanvasStrokeStyle) | Draws a geometry relative to the specified position, with the specified stroke width, stroke style, and color. | |
DrawGeometry(CanvasGeometry, Single, Single, ICanvasBrush, Single) | Draws a geometry relative to the specified position, with the specified stroke width, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Single, Single, Color, Single) | Draws a geometry relative to the specified position, with the specified stroke width and color. | |
DrawGeometry(CanvasGeometry, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a geometry relative to the specified position, with the specified stroke width and stroke style, and using a brush to define the color. | |
DrawGeometry(CanvasGeometry, Single, Single, Color, Single, CanvasStrokeStyle) | Draws a geometry relative to the specified position, with the specified stroke width, stroke style, and color. | |
DrawGlyphRun(Vector2, CanvasFontFace, Single, CanvasGlyph, Boolean, UInt32, ICanvasBrush) | Draws a sequence of text characters which share the same formatting. | |
DrawGlyphRun(Vector2, CanvasFontFace, Single, CanvasGlyph, Boolean, UInt32, ICanvasBrush, CanvasTextMeasuringMode) | Draws a sequence of text characters which share the same formatting. | |
DrawGlyphRun(Vector2, CanvasFontFace, Single, CanvasGlyph, Boolean, UInt32, ICanvasBrush, CanvasTextMeasuringMode, String, String, Int32, UInt32) | Draws a sequence of text characters which share the same formatting. | |
DrawGradientMesh(CanvasGradientMesh) | Draws a gradient mesh, relative to the origin. | |
DrawGradientMesh(CanvasGradientMesh, Vector2) | Draws a gradient mesh, relative to the specified position. | |
DrawGradientMesh(CanvasGradientMesh, Single, Single) | Draws a gradient mesh, relative to the specified position. | |
DrawImage(ICanvasImage) | Draws an image. | |
DrawImage(CanvasBitmap, Rect) | Draws a bitmap. | |
DrawImage(ICanvasImage, Vector2) | Draws an image. | |
DrawImage(ICanvasImage, Vector2, Rect) | Draws an image. | |
DrawImage(ICanvasImage, Single, Single) | Draws an image. | |
DrawImage(ICanvasImage, Rect, Rect) | Draws an image. | |
DrawImage(ICanvasImage, Vector2, Rect, Single) | Draws an image. | |
DrawImage(ICanvasImage, Single, Single, Rect) | Draws an image. | |
DrawImage(ICanvasImage, Rect, Rect, Single) | Draws an image. | |
DrawImage(ICanvasImage, Vector2, Rect, Single, CanvasImageInterpolation) | Draws an image. | |
DrawImage(ICanvasImage, Single, Single, Rect, Single) | Draws an image. | |
DrawImage(ICanvasImage, Rect, Rect, Single, CanvasImageInterpolation) | Draws an image. | |
DrawImage(CanvasBitmap, Vector2, Rect, Single, CanvasImageInterpolation, Matrix4x4) | Draws a bitmap. | |
DrawImage(CanvasBitmap, Rect, Rect, Single, CanvasImageInterpolation, Matrix4x4) | Draws a bitmap. | |
DrawImage(ICanvasImage, Vector2, Rect, Single, CanvasImageInterpolation, CanvasComposite) | Draws an image. | |
DrawImage(ICanvasImage, Single, Single, Rect, Single, CanvasImageInterpolation) | Draws an image. | |
DrawImage(ICanvasImage, Rect, Rect, Single, CanvasImageInterpolation, CanvasComposite) | Draws an image. | |
DrawImage(CanvasBitmap, Single, Single, Rect, Single, CanvasImageInterpolation, Matrix4x4) | Draws a bitmap. | |
DrawImage(ICanvasImage, Single, Single, Rect, Single, CanvasImageInterpolation, CanvasComposite) | Draws an image. | |
DrawInk(IEnumerableInkStroke) |
Draws a collection of ink strokes.
| |
DrawInk(IEnumerableInkStroke, Boolean) |
Draws a collection of ink strokes.
| |
DrawLine(Vector2, Vector2, ICanvasBrush) | Draws a line of single unit width, using a brush to define the color. | |
DrawLine(Vector2, Vector2, Color) | Draws a line of single unit width and the specified color. | |
DrawLine(Vector2, Vector2, ICanvasBrush, Single) | Draws a line of the specified width, using a brush to define the color. | |
DrawLine(Vector2, Vector2, Color, Single) | Draws a line of the specified width and color. | |
DrawLine(Single, Single, Single, Single, ICanvasBrush) | Draws a line of single unit width, using a brush to define the color. | |
DrawLine(Single, Single, Single, Single, Color) | Draws a line of single unit width and the specified color. | |
DrawLine(Vector2, Vector2, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a line of the specified width, using a brush to define the color and with a custom stroke style. | |
DrawLine(Vector2, Vector2, Color, Single, CanvasStrokeStyle) | Draws a line of the specified width and color, with a custom stroke style. | |
DrawLine(Single, Single, Single, Single, ICanvasBrush, Single) | Draws a line of the specified width, using a brush to define the color. | |
DrawLine(Single, Single, Single, Single, Color, Single) | Draws a line of the specified width and color. | |
DrawLine(Single, Single, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a line of the specified width, using a brush to define the color and with a custom stroke style. | |
DrawLine(Single, Single, Single, Single, Color, Single, CanvasStrokeStyle) | Draws a line of the specified width and color, with a custom stroke style. | |
DrawRectangle(Rect, ICanvasBrush) | Draws a rectangle of single unit stroke width, using a brush to define the color. | |
DrawRectangle(Rect, Color) | Draws a rectangle of single unit stroke width and the specified color. | |
DrawRectangle(Rect, ICanvasBrush, Single) | Draws a rectangle of the specified stroke width, using a brush to define the color. | |
DrawRectangle(Rect, Color, Single) | Draws a rectangle of the specified stroke width and color. | |
DrawRectangle(Rect, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a rectangle of the specified stroke width, using a brush to define the color and with a custom stroke style. | |
DrawRectangle(Rect, Color, Single, CanvasStrokeStyle) | Draws a rectangle of the specified stroke width and color, with a custom stroke style. | |
DrawRectangle(Single, Single, Single, Single, ICanvasBrush) | Draws a rectangle of single unit stroke width, using a brush to define the color. | |
DrawRectangle(Single, Single, Single, Single, Color) | Draws a rectangle of single unit stroke width and the specified color. | |
DrawRectangle(Single, Single, Single, Single, ICanvasBrush, Single) | Draws a rectangle of the specified stroke width, using a brush to define the color. | |
DrawRectangle(Single, Single, Single, Single, Color, Single) | Draws a rectangle of the specified stroke width and color. | |
DrawRectangle(Single, Single, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a rectangle of the specified stroke width, using a brush to define the color and with a custom stroke style. | |
DrawRectangle(Single, Single, Single, Single, Color, Single, CanvasStrokeStyle) | Draws a rectangle of the specified stroke width and color, with a custom stroke style. | |
DrawRoundedRectangle(Rect, Single, Single, ICanvasBrush) | Draws a rounded rectangle of single unit stroke width, using a brush to define the color. | |
DrawRoundedRectangle(Rect, Single, Single, Color) | Draws a rounded rectangle of single unit stroke width and the specified color. | |
DrawRoundedRectangle(Rect, Single, Single, ICanvasBrush, Single) | Draws a rounded rectangle of the specified stroke width, using a brush to define the color. | |
DrawRoundedRectangle(Rect, Single, Single, Color, Single) | Draws a rounded rectangle of the specified stroke width and color. | |
DrawRoundedRectangle(Rect, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a rounded rectangle of the specified stroke width, using a brush to define the color and with a custom stroke style. | |
DrawRoundedRectangle(Rect, Single, Single, Color, Single, CanvasStrokeStyle) | Draws a rounded rectangle of the specified stroke width and color, with a custom stroke style. | |
DrawRoundedRectangle(Single, Single, Single, Single, Single, Single, ICanvasBrush) | Draws a rounded rectangle of single unit stroke width, using a brush to define the color. | |
DrawRoundedRectangle(Single, Single, Single, Single, Single, Single, Color) | Draws a rounded rectangle of single unit stroke width and the specified color. | |
DrawRoundedRectangle(Single, Single, Single, Single, Single, Single, ICanvasBrush, Single) | Draws a rounded rectangle of the specified stroke width, using a brush to define the color. | |
DrawRoundedRectangle(Single, Single, Single, Single, Single, Single, Color, Single) | Draws a rounded rectangle of the specified stroke width and color. | |
DrawRoundedRectangle(Single, Single, Single, Single, Single, Single, ICanvasBrush, Single, CanvasStrokeStyle) | Draws a rounded rectangle of the specified stroke width, using a brush to define the color and with a custom stroke style. | |
DrawRoundedRectangle(Single, Single, Single, Single, Single, Single, Color, Single, CanvasStrokeStyle) | Draws a rounded rectangle of the specified stroke width and color, with a custom stroke style. | |
DrawSvg(CanvasSvgDocument, Size) | [Win10_15063] Draws an SVG document with the specified viewport size at the origin. | |
DrawSvg(CanvasSvgDocument, Size, Vector2) | [Win10_15063] Draws an SVG document with the specified viewport size, at the specified coordinate location. | |
DrawSvg(CanvasSvgDocument, Size, Single, Single) | [Win10_15063] Draws an SVG document with the specified viewport size, at the specified coordinates. | |
DrawText(String, Vector2, Color) | Draws text using a default font. | |
DrawText(String, Vector2, ICanvasBrush, CanvasTextFormat) | Draws text at the specified position, using a brush to define the color. | |
DrawText(String, Vector2, Color, CanvasTextFormat) | Draws text at the specified position. | |
DrawText(String, Single, Single, Color) | Draws text using a default font. | |
DrawText(String, Rect, ICanvasBrush, CanvasTextFormat) | Draws text inside the specified rectangle, using a brush to define the color. | |
DrawText(String, Rect, Color, CanvasTextFormat) | Draws text inside the specified rectangle. | |
DrawText(String, Single, Single, ICanvasBrush, CanvasTextFormat) | Draws text at the specified position, using a brush to define the color. | |
DrawText(String, Single, Single, Color, CanvasTextFormat) | Draws text at the specified position. | |
DrawText(String, Single, Single, Single, Single, ICanvasBrush, CanvasTextFormat) | Draws text inside the specified rectangle, using a brush to define the color. | |
DrawText(String, Single, Single, Single, Single, Color, CanvasTextFormat) | Draws text inside the specified rectangle. | |
DrawTextLayout(CanvasTextLayout, Vector2, ICanvasBrush) | Draws a text layout, using a brush to define the color. | |
DrawTextLayout(CanvasTextLayout, Vector2, Color) | Draws a text layout with the specified color. | |
DrawTextLayout(CanvasTextLayout, Single, Single, ICanvasBrush) | Draws a text layout, using a brush to define the color. | |
DrawTextLayout(CanvasTextLayout, Single, Single, Color) | Draws a text layout with the specified color. | |
FillCircle(Vector2, Single, ICanvasBrush) | Fills the interior of a circle, using a brush to define the color. | |
FillCircle(Vector2, Single, Color) | Fills the interior of a circle with the specified color. | |
FillCircle(Single, Single, Single, ICanvasBrush) | Fills the interior of a circle, using a brush to define the color. | |
FillCircle(Single, Single, Single, Color) | Fills the interior of a circle with the specified color. | |
FillEllipse(Vector2, Single, Single, ICanvasBrush) | Fills the interior of an ellipse, using a brush to define the color. | |
FillEllipse(Vector2, Single, Single, Color) | Fills the interior of a ellipse with the specified color. | |
FillEllipse(Single, Single, Single, Single, ICanvasBrush) | Fills the interior of an ellipse, using a brush to define the color. | |
FillEllipse(Single, Single, Single, Single, Color) | Fills the interior of a ellipse with the specified color. | |
FillGeometry(CanvasGeometry, ICanvasBrush) | Fills a geometry relative to the origin, using a brush to define the color. | |
FillGeometry(CanvasGeometry, Color) | Fills a geometry relative to the origin with the specified color. | |
FillGeometry(CanvasGeometry, ICanvasBrush, ICanvasBrush) | Fills a geometry relative to the origin, using a brush to define the color and a second brush to specify an opacity mask. | |
FillGeometry(CanvasGeometry, Vector2, ICanvasBrush) | Fills a geometry relative to the specified position, using a brush to define the color. | |
FillGeometry(CanvasGeometry, Vector2, Color) | Fills a geometry relative to the specified position with the specified color. | |
FillGeometry(CanvasGeometry, Vector2, ICanvasBrush, ICanvasBrush) | Fills a geometry relative to the specified position, using a brush to define the color and a second brush to specify an opacity mask. | |
FillGeometry(CanvasGeometry, Single, Single, ICanvasBrush) | Fills a geometry relative to the specified position, using a brush to define the color. | |
FillGeometry(CanvasGeometry, Single, Single, Color) | Fills a geometry relative to the specified position with the specified color. | |
FillGeometry(CanvasGeometry, Single, Single, ICanvasBrush, ICanvasBrush) | Fills a geometry relative to the specified position, using a brush to define the color and a second brush to specify an opacity mask. | |
FillRectangle(Rect, ICanvasBrush) | Fills the interior of a rectangle, using a brush to define the color. | |
FillRectangle(Rect, Color) | Fills the interior of a rectangle with the specified color. | |
FillRectangle(Rect, ICanvasBrush, ICanvasBrush) | Fills the interior of a rectangle, using a brush to define the color and a second brush to specify an opacity mask. | |
FillRectangle(Single, Single, Single, Single, ICanvasBrush) | Fills the interior of a rectangle, using a brush to define the color. | |
FillRectangle(Single, Single, Single, Single, Color) | Fills the interior of a rectangle with the specified color. | |
FillRectangle(Single, Single, Single, Single, ICanvasBrush, ICanvasBrush) | Fills the interior of a rectangle, using a brush to define the color and a second brush to specify an opacity mask. | |
FillRoundedRectangle(Rect, Single, Single, ICanvasBrush) | Fills the interior of a rounded rectangle, using a brush to define the color. | |
FillRoundedRectangle(Rect, Single, Single, Color) | Fills the interior of a rounded rectangle with the specified color. | |
FillRoundedRectangle(Single, Single, Single, Single, Single, Single, ICanvasBrush) | Fills the interior of a rounded rectangle, using a brush to define the color. | |
FillRoundedRectangle(Single, Single, Single, Single, Single, Single, Color) | Fills the interior of a rounded rectangle with the specified color. | |
Flush | Sends any pending drawing commands to the graphics device. |
For best performance, graphics drawing commands need to be batched into groups so the GPU hardware can process as many operations as possible in parallel. Win2D achieves this through the CanvasDrawingSession API. A drawing session represents an active batch of commands that are in the process of being generated. Use CanvasDrawingSession's various methods to indicate what you want to draw, then when you are done close the CanvasDrawingSession. This will finalize the command batch, optimize it and submit it to the GPU hardware to be carried out. No actual rendering work is performed on the GPU until the CanvasDrawingSession is closed.
CanvasDrawingSession implements the IClosable interface; therefore, you close it by explicitly calling the Close method (which is projected into .NET as Dispose). If you are using C#, you can also use the 'using' statement. If you are using C++/CX, Close is accessed via the 'delete' keyword.
Drawing sessions can be obtained in various different ways. Most often, you should use the one that is passed in to the CanvasControl.Draw or CanvasAnimatedControl.Draw event handler. A drawing session obtained in this way is automatically closed after the event handler returns, so there is no need for you to do anything else. However, if you explicitly created a drawing session you must close it yourself when you are done drawing to it.
When using Direct2D interop, this Win2D class corresponds to the Direct2D interface ID2D1DeviceContext1.