Windows Toolkit Invalid Class

1. Windows Toolkit Invalid Classic
2. Windows Toolkit Invalid Classes
3. Windows Toolkit Invalid Class Action

I am using Windows Server 2012 running on VMWare 5.0 U2 ESXi host. I've fixed this on numerous servers by running through the following steps to recreate the wmi wbem repository: net stop winmgmt. If the Windows logo appears, you will need to try again. From Start - Help and Support Startup Repair. If your computer has a single operating system installed, repeatedly press the F8 key as your computer restarts. You need to press F8 before the Windows logo appears. If the Windows logo appears, you will need to try again.

The Win2D Path Mini Language is a powerful and sophisticated language based on the SVG Path language specification. It facilitates specifying complex geometries, color, brushes, strokes and stroke styles in a more compact manner.

Using the Win2D Path Mini Language, the geometry from the initial CanvasPathGeometry example can be created in the following way:

Requirements

Table of Contents

• Introduction
• Path Mini Language
• CanvasBrush Mini Language
  • ICanvasBrush Attribute Commands
• CanvasStrokeStyle Mini Language
  • CanvasStrokeStyle Attributes
• CanvasStroke Mini Language

Win2D Path Mini Language Overview

Win2D Path Mini Language syntax derives from the SVG path syntax. It is a prefix notation (i.e., commands followed by parameters). In order to ensure that the data, specified in Win2D Path Mini Language, is concise the following rules must be followed

• The commands are can be expressed as one , two or three characters (e.g., a Move command is expressed as an M , a LinearGradientBrush command is expressed as LG ).
• Superfluous white space and separators such as commas can be eliminated (e.g., M 100 100 L 200200 contains unnecessary spaces and could be expressed more compactly as M100 100L200 200 ).
• The command letter can be eliminated on subsequent commands if the same command is used multiple times in a row (e.g., you can drop the second 'L' in 'M 100 200 L 200 100 L - 100 -200' and use 'M 100 200 L 200 100 -100 -200' instead).
• Relative versions of all commands are available (uppercase means absolute coordinates, lowercase means relative coordinates).
• Most of the parameters are either integer or floating-point values. The only allowable decimal point is a Unicode U+0046 FULL STOP ('.') character (also referred to in Unicode as PERIOD, dot, and decimal point) and no other delimiter characters are allowed [UNICODE]. (For example, the following is an invalid numeric value in a path data stream: '13,000.56'. Instead, say: '13000.56'.)
• For the relative versions of the commands, all coordinate values are relative to the current point at the start of the command.

In the following sections, the following notation is used:

• () indicates the grouping of parameters.
• + indicates one or more of the given parameter(s) is required.
• [] indicates any one of the values specified within the square brackets. For e.g. [01] means either 0 or 1.
• ? denotes an optional parameter

Path Mini Language

Paths represent the outline of a shape, which can be filled, stroked, used as a clipping path, or any combination of the three.

A path is described using the concept of a current point. In an analogy with drawing on paper, the currentpoint can be thought of as the location of the pen. The position of the pen can be changed, and the outlineof a shape (open or closed) can be traced by dragging the pen in either straight lines or curves.

A path can be defined using the following commands

Fill Behavior

Fill Behavior specifies how the intersecting areas of geometries or figures are combined to form the area of the composite geometry. It represents the CanvasFilledRegionDetermination enumeration which is based on D2D1_FILL_MODE enumeration. The Fill Behavior parameter can be either 0 or 1.

The parameter value 0 indicates CanvasFilledRegionDetermination.Alternate which determines whether a point is in the fill region by drawing a ray from that point to infinity in any direction, and then counting the number of path segments within the given shape that the ray crosses. If this number is odd, the point is in the fill region; if even, the point is outside the fill region.

The parameter value 1 indicates CanvasFilledRegionDetermination.Winding which determines whether a point is in the fill region of the path by drawing a ray from that point to infinity in any direction, and then examining the places where a segment of the shape crosses the ray. Starting with a count of zero, add one each time a segment crosses the ray from left to right and subtract one each time a path segment crosses the ray from right to left, as long as left and right are seen from the perspective of the ray. After counting the crossings, if the result is zero, then the point is outside the path. Otherwise, it is inside the path.

Each Path data should have only one Fill Behavior specified. Otherwise, an exception will be raised.

CanvasPathGeometry invokes the CanvasPathBuilder.SetFilledRegionDetermination() API for this command.

MoveTo

The MoveTo command establishes a new current point. The effect is as if the 'pen' were lifted and moved to a new location. A path data segment must begin with a Move command. Subsequent 'moveto' commands (i.e., when the Move is not the first command) represent the start of a new subpath.

M (uppercase) indicates that absolute coordinates will follow whereas m (lowercase) indicates that relative coordinates will follow.

If a MoveTo command is followed by multiple pairs of coordinates, the subsequent pairs aretreated as implicit LineTo commands. Hence, implicit LineTo commands will be relative if the MoveTo command is relative and absolute if the MoveTo command is absolute.

If a relative MoveTo (m) command appears as the first element of the path, then its parameters are treated as a pair of absolute coordinates.

In this case, subsequent pairs of coordinates are treated as relative even though the initial MoveTo is interpreted as an absolute MoveTo.

CanvasPathGeometry invokes the CanvasPathBuilder.BeginFigure() API for this command.

LineTo

Draws a line from the current point to the specified (x,y) coordinate. (x,y) becomes the new current point.

L (uppercase) indicates that absolute coordinates will follow whereas l (lowercase) indicates that relative coordinates will follow.

A number of coordinates pairs may be specified to draw a polyline. At the end of the command, the new current point is set to the final set of coordinates provided.

CanvasPathGeometry invokes the CanvasPathBuilder.AddLine() API for this command.

Horizontal LineTo

Draws a horizontal line from the current point (cpx, cpy) to (x, cpy).

H (uppercase) indicates that absolute coordinates will follow whereas h (lowercase) indicates that relative coordinates will follow.

Multiple x values can be provided (although usually this doesn't make sense). At the end of the command, the new current point becomes ( x, cpy ) for the final value of x.

CanvasPathGeometry invokes the CanvasPathBuilder.AddLine() API for this command.

Vertical LineTo

Draws a vertical line from the current point (cpx, cpy) to (cpx, y).

V (uppercase) indicates that absolute coordinates will follow whereas v (lowercase) indicates that relative coordinates will follow.

Multiple y values can be provided (although usually this doesn't make sense). At the end of the command, the new current point becomes (cpx, y) for the final value of y.

CanvasPathGeometry invokes the CanvasPathBuilder.AddLine() API for this command.

Cubic Bézier

Draws a cubic Bézier curve from the current point to (x,y) using (x1,y1) as the control point at the beginning of the curve and (x2,y2) as the control point at the end of the curve.

C (uppercase) indicates that absolute coordinates will follow whereas c (lowercase) indicates that relative coordinates will follow.

Multiple sets of coordinates may be specified to draw a polybézier. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybézier.

CanvasPathGeometry invokes the CanvasPathBuilder.AddCubicBezier() API for this command.

Smooth Cubic Bézier

Draws a cubic Bézier curve from the current point to (x,y). The first control point is assumed to be the reflection of the second control point on the previous command relative to the current point. (If there is no previous command or if the previous command was not a C, c, S or s , assume the first control point is coincident with the current point.)

(x2,y2) is the second control point (i.e., the control point at the end of the curve).

S (uppercase) indicates that absolute coordinates will whereas s (lowercase) indicates that relative coordinates will follow.

Multiple sets of coordinates may be specified to draw a polybézier. At the end of the command,the new current point becomes the final (x,y) coordinate pair used in the polybézier.

CanvasPathGeometry invokes the CanvasPathBuilder.AddCubicBezier() API for this command.

Quadratic Bézier

Draws a quadratic Bézier curve from the current point to (x,y) using (x1,y1) as the control point.

Q (uppercase) indicates that absolute coordinates will whereas q (lowercase) indicates that relative coordinates will follow.

Multiple sets of coordinates may be specified to draw a polybézier. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybézier.

CanvasPathGeometry invokes the CanvasPathBuilder.AddQuadraticBezier() API for this command.

Smooth Quadratic Bézier

Draws a quadratic Bézier curve from the current point to (x,y). The control point is assumed to be the reflection of the control point on the previous command relative to the current point. (If there is no previous command or if the previous command was not a Q, q, T or t , assume the control point is coincident with the currentpoint.)

T (uppercase) indicates that absolute coordinates will whereas t (lowercase) indicates that relative coordinates will follow.

Multiple sets of coordinates may be specified to draw a polybézier. At the end of the command the new current point becomes the final (x,y) coordinate pair used in the polybézier.

CanvasPathGeometry invokes the CanvasPathBuilder.AddQuadraticBezier() API for this command.

Arc

Draws an elliptical arc from the current point to ( x , y ). The size and orientation of the ellipse are defined by two radii ( rx , ry ) and an x-axis-rotation , which indicates how the ellipse as a whole is rotated relative to the current coordinate system. The center ( cx , cy ) of the ellipse is calculated automatically to satisfy the constraintsimposed by the other parameters.

IsLargeFlag specifies whether an arc should take the longer or shorter way, around the ellipse to join its start and end points (0 denotes the arc's sweep should be π or less whereas 1 denotes the arc's sweep should be π or more).

SweepDirection specifies the direction that an elliptical arc is drawn (0 meansCounterClockwise and 1 means Clockwise).

CanvasPathGeometry invokes the CanvasPathBuilder.AddArc() API for this command.

Close Path

Closes the current subpath by drawing a straight line from the current point to current subpath's initial point. Since the Z and z commands take no parameters, they have an identical effect.

CanvasPathGeometry invokes the CanvasPathBuilder.EndFigure() API for this command.

Ellipse Figure

Adds an Ellipse Figure to the path. The radiusX and radiusY parameters denote the elliptical radii on the x-axis and y-axis respectively. ( x y ) denotes the center of the Ellipse. The current point remains unchanged.

CanvasPathGeometry internally invokes the CanvasPathBuilder.AddEllipseFigure() extension method for this command.

Polygon Figure

Adds an n-sided Polygon to the path. The radius parameter denotes the radius of the circle circumscribing the polygon vertices. ( x y ) denotes the center of the polygon. The current point remains unchanged.

This command internally invokes the CanvasPathBuilder.AddPolygonFigure() extension method.

Rectangle Figure

Adds a Rectangle to the path. ( x y ) denotes the top left corner of the Rectangle. The current point remains unchanged.

CanvasPathGeometry internally invokes the CanvasPathBuilder.AddRectangleFigure() extension method for this command.

RoundedRectangle Figure

Adds a RoundedRectangle to the path. ( x y ) denotes the top left corner of the RoundedRectangle. radiusX and radiusY denote the radii of the corner curves on the x-axis and y-axis respectively. The current point remains unchanged.

CanvasPathGeometry internally invokes the CanvasPathBuilder.AddRoundedRectangleFigure() extension method for this command.

CanvasBrush Mini Language

This section describes in detail how a Win2D brush can be defined as a string and an instance created from it. Using the CanvasBrush Mini Language the following Win2D brushes can be created (they all implement the ICanvasBrush interface)

• SolidColorBrush
• CanvasLinearGradientBrush
• CanvasRadialGradientBrush

The Win2D Path Mini Language uses the following syntax to define a brush and its attributes

Some of the attributes are optional while the others are mandatory. The order in which the attributes are specified should be maintained.

ICanvasBrush Attribute Commands

This section describes the various brush attributes that will be used to define and construct an ICanvasBrush.

Start Point

Denotes the point on the canvas where the gradient starts.

End Point

Denotes the point on the canvas where the gradient ends.

Opacity

Denotes the opacity of the brush. The opacity parameter should have a value in the range [0, 1].

Alpha Mode

Specifies the way in which an alpha channel affects color channels. This attribute corresponds to the CanvasAlphaMode enumeration. Default is 0 ( Premultiplied ).

Buffer Precision

Specifies the bit depth used for graphical computations. This attribute corresponds to theCanvasBufferPrecision | enumeration |. Default is 0 ( |Precision8UIntNormalized ).

Edge Behavior

Specifies the behavior for pixels which fall outside of the gradient's typical rendering area. This attribute corresponds to the CanvasEdgeBehavior enumeration. Default is 0 ( Clamp ).

Pre Interpolation Color Space

Specifies the color space to be used before interpolation. This attribute corresponds to the CanvasColorSpaceenumeration. Default value is 1 ( Srgb ).

Post Interpolation Color Space

Windows Toolkit Invalid Classic

Specifies the color space to be used after interpolation. This attribute corresponds to the CanvasColorSpaceenumeration. Default value is 1 ( Srgb ).

Origin Offset

Specifies a displacement from Center, used to form the brush's radial gradient.

GradientStop

Specifies one or more gradient stops (using Hexadecimal Color) in a gradient brush.

The parameter offset refers to the position of the gradient stop and should be a floating-point number between 0 and 1, inclusive.

The parameter hexColor denotes the color specified in #RRGGBB or #AARRGGBB format.

Example:

GradientStopHdr

Specifies one or more high dynamic range gradient stops in a gradient brush.

The parameter offset refers to the position of the gradient stop and it should be a floating-point number between 0 and 1, inclusive.

The parameters x, y, z and w denote the components of the high dynamic range color.

Example:

SolidColorBrush

The SolidColorBrush is defined by the SC command. It has two attributes - Color and Opacity.

The Color attribute is specified as either a Hexadecimal Color or a High Dynamic Range Color.

The Opacity attribute is optional and can be specified with the O attribute command and an opacity value in the range [0, 1].

Example:

LinearGradientBrush

The LinearGradientBrush is defined by the LG command. It has the following mandatory attributes

• StartPoint ( M )
• EndPoint ( Z )
• GradientStops ( S )

Windows Toolkit Invalid Classes

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

LinearGradientBrush with GradientStopHdr

The LinearGradientBrush with GradientStopHdr is defined by the LH command. It has the following mandatory attributes

• StartPoint ( M )
• EndPoint ( Z )
• GradientStopHdrs ( S )

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

RadialGradientBrush

The RadialGradientBrush is defined by the RG command. It has the following mandatory attributes

• RadiusX
• RadiusY
• CenterX ( x )
• CenterY ( y )
• GradientStops ( S )

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Origin Offset ( F )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

RadialGradientBrush with GradientStopHdr

Command Parameter

The RadialGradientBrush is defined by the RG command. It has the following mandatory attributes

• RadiusX
• RadiusY
• CenterX ( x )
• CenterY ( y )
• GradientStopHdrs ( S )

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Origin Offset ( F )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

CanvasStrokeStyle Mini Language

The Microsoft.Graphics.Canvas.Geometry.CanvasStrokeStyle class defines a stroke style for drawing lines.The stroke style describes whether the line comprises of dashes, dots, or solid line, how to join line segments, how to cap the ends, etc.

This section describes in detail how a CanvasStrokeStyle can be defined as a string and a CanvasStrokeStyle instance created from it.

The Win2D Path Mini Language uses the following format to define a CanvasStrokeStyle and its attributes

Some of the attributes are optional while the others are mandatory. The order in which the attributes arespecified should be maintained.

CanvasStrokeStyle Attributes

This section describes the various stroke attributes that are used to define and construct a CanvasStrokeStyle object.

Dash Style

Describes the sequence of dashes, dots, and gaps in a stroke style. This attribute is ignored if theCustomDashStyle attribute is set. This attribute corresponds to the CanvasDashStyle enumeration. Defaultvalue is 0 ( Solid ).

Line Join

Describes the shape that joins two lines or segments. This attribute corresponds to the CanvasLineJoinenumeration. Default value is 0 (Miter).

Miter Limit

Describes the limit on the ratio of the miter length to half the stroke's thickness.

Dash Offset

Describes how far into the dash sequence the stroke will start.

Start Cap

T (uppercase) indicates that absolute coordinates will whereas t (lowercase) indicates that relative coordinates will follow.

Multiple sets of coordinates may be specified to draw a polybézier. At the end of the command the new current point becomes the final (x,y) coordinate pair used in the polybézier.

CanvasPathGeometry invokes the CanvasPathBuilder.AddQuadraticBezier() API for this command.

Arc

Draws an elliptical arc from the current point to ( x , y ). The size and orientation of the ellipse are defined by two radii ( rx , ry ) and an x-axis-rotation , which indicates how the ellipse as a whole is rotated relative to the current coordinate system. The center ( cx , cy ) of the ellipse is calculated automatically to satisfy the constraintsimposed by the other parameters.

IsLargeFlag specifies whether an arc should take the longer or shorter way, around the ellipse to join its start and end points (0 denotes the arc's sweep should be π or less whereas 1 denotes the arc's sweep should be π or more).

SweepDirection specifies the direction that an elliptical arc is drawn (0 meansCounterClockwise and 1 means Clockwise).

CanvasPathGeometry invokes the CanvasPathBuilder.AddArc() API for this command.

Close Path

Closes the current subpath by drawing a straight line from the current point to current subpath's initial point. Since the Z and z commands take no parameters, they have an identical effect.

CanvasPathGeometry invokes the CanvasPathBuilder.EndFigure() API for this command.

Ellipse Figure

Adds an Ellipse Figure to the path. The radiusX and radiusY parameters denote the elliptical radii on the x-axis and y-axis respectively. ( x y ) denotes the center of the Ellipse. The current point remains unchanged.

CanvasPathGeometry internally invokes the CanvasPathBuilder.AddEllipseFigure() extension method for this command.

Polygon Figure

Adds an n-sided Polygon to the path. The radius parameter denotes the radius of the circle circumscribing the polygon vertices. ( x y ) denotes the center of the polygon. The current point remains unchanged.

This command internally invokes the CanvasPathBuilder.AddPolygonFigure() extension method.

Rectangle Figure

Adds a Rectangle to the path. ( x y ) denotes the top left corner of the Rectangle. The current point remains unchanged.

CanvasPathGeometry internally invokes the CanvasPathBuilder.AddRectangleFigure() extension method for this command.

RoundedRectangle Figure

Adds a RoundedRectangle to the path. ( x y ) denotes the top left corner of the RoundedRectangle. radiusX and radiusY denote the radii of the corner curves on the x-axis and y-axis respectively. The current point remains unchanged.

CanvasPathGeometry internally invokes the CanvasPathBuilder.AddRoundedRectangleFigure() extension method for this command.

CanvasBrush Mini Language

This section describes in detail how a Win2D brush can be defined as a string and an instance created from it. Using the CanvasBrush Mini Language the following Win2D brushes can be created (they all implement the ICanvasBrush interface)

• SolidColorBrush
• CanvasLinearGradientBrush
• CanvasRadialGradientBrush

The Win2D Path Mini Language uses the following syntax to define a brush and its attributes

Some of the attributes are optional while the others are mandatory. The order in which the attributes are specified should be maintained.

ICanvasBrush Attribute Commands

This section describes the various brush attributes that will be used to define and construct an ICanvasBrush.

Start Point

Denotes the point on the canvas where the gradient starts.

End Point

Denotes the point on the canvas where the gradient ends.

Opacity

Denotes the opacity of the brush. The opacity parameter should have a value in the range [0, 1].

Alpha Mode

Specifies the way in which an alpha channel affects color channels. This attribute corresponds to the CanvasAlphaMode enumeration. Default is 0 ( Premultiplied ).

Buffer Precision

Specifies the bit depth used for graphical computations. This attribute corresponds to theCanvasBufferPrecision | enumeration |. Default is 0 ( |Precision8UIntNormalized ).

Edge Behavior

Specifies the behavior for pixels which fall outside of the gradient's typical rendering area. This attribute corresponds to the CanvasEdgeBehavior enumeration. Default is 0 ( Clamp ).

Pre Interpolation Color Space

Specifies the color space to be used before interpolation. This attribute corresponds to the CanvasColorSpaceenumeration. Default value is 1 ( Srgb ).

Post Interpolation Color Space

Windows Toolkit Invalid Classic

Specifies the color space to be used after interpolation. This attribute corresponds to the CanvasColorSpaceenumeration. Default value is 1 ( Srgb ).

Origin Offset

Specifies a displacement from Center, used to form the brush's radial gradient.

GradientStop

Specifies one or more gradient stops (using Hexadecimal Color) in a gradient brush.

The parameter offset refers to the position of the gradient stop and should be a floating-point number between 0 and 1, inclusive.

The parameter hexColor denotes the color specified in #RRGGBB or #AARRGGBB format.

Example:

GradientStopHdr

Specifies one or more high dynamic range gradient stops in a gradient brush.

The parameter offset refers to the position of the gradient stop and it should be a floating-point number between 0 and 1, inclusive.

The parameters x, y, z and w denote the components of the high dynamic range color.

Example:

SolidColorBrush

The SolidColorBrush is defined by the SC command. It has two attributes - Color and Opacity.

The Color attribute is specified as either a Hexadecimal Color or a High Dynamic Range Color.

The Opacity attribute is optional and can be specified with the O attribute command and an opacity value in the range [0, 1].

Example:

LinearGradientBrush

The LinearGradientBrush is defined by the LG command. It has the following mandatory attributes

• StartPoint ( M )
• EndPoint ( Z )
• GradientStops ( S )

Windows Toolkit Invalid Classes

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

LinearGradientBrush with GradientStopHdr

The LinearGradientBrush with GradientStopHdr is defined by the LH command. It has the following mandatory attributes

• StartPoint ( M )
• EndPoint ( Z )
• GradientStopHdrs ( S )

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

RadialGradientBrush

The RadialGradientBrush is defined by the RG command. It has the following mandatory attributes

• RadiusX
• RadiusY
• CenterX ( x )
• CenterY ( y )
• GradientStops ( S )

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Origin Offset ( F )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

RadialGradientBrush with GradientStopHdr

Command Parameter

The RadialGradientBrush is defined by the RG command. It has the following mandatory attributes

• RadiusX
• RadiusY
• CenterX ( x )
• CenterY ( y )
• GradientStopHdrs ( S )

It also has the following optional attributes

• Opacity ( O )
• Alpha Mode ( A )
• Buffer Precision ( B )
• Edge Behavior ( E )
• Origin Offset ( F )
• Pre Interpolation Color Space ( P )
• Post Interpolation Color Space ( R )

Example:

CanvasStrokeStyle Mini Language

The Microsoft.Graphics.Canvas.Geometry.CanvasStrokeStyle class defines a stroke style for drawing lines.The stroke style describes whether the line comprises of dashes, dots, or solid line, how to join line segments, how to cap the ends, etc.

This section describes in detail how a CanvasStrokeStyle can be defined as a string and a CanvasStrokeStyle instance created from it.

The Win2D Path Mini Language uses the following format to define a CanvasStrokeStyle and its attributes

Some of the attributes are optional while the others are mandatory. The order in which the attributes arespecified should be maintained.

CanvasStrokeStyle Attributes

This section describes the various stroke attributes that are used to define and construct a CanvasStrokeStyle object.

Dash Style

Describes the sequence of dashes, dots, and gaps in a stroke style. This attribute is ignored if theCustomDashStyle attribute is set. This attribute corresponds to the CanvasDashStyle enumeration. Defaultvalue is 0 ( Solid ).

Line Join

Describes the shape that joins two lines or segments. This attribute corresponds to the CanvasLineJoinenumeration. Default value is 0 (Miter).

Miter Limit

Describes the limit on the ratio of the miter length to half the stroke's thickness.

Dash Offset

Describes how far into the dash sequence the stroke will start.

Start Cap

Describes the type of shape used at the beginning of a stroke. This attribute corresponds to theCanvasCapStyle enumeration. Default value is 0 (Flat).

End Cap

Describes the type of shape used at the beginning of a stroke. This attribute corresponds to theCanvasCapStyle enumeration. Default value is 0 (Flat).

Dash Cap

Describes the type of shape used at the beginning of a stroke. This attribute corresponds to theCanvasCapStyle enumeration. Default value is 0 ( Flat ).

Transform Behavior

Describes how the world transforms, dots per inch (DPI), and stroke width affect the shape of the pen. This attribute corresponds to the CanvasStrokeTransformBehavior enumeration. Default value is 0 (Normal).

Custom Dash Style

Describes an array describing a custom dash pattern. The array elements specify the length of each dash and space in the pattern. The first element sets the length of a dash, the second element sets the length of a space, and the third element sets the length of a dash, and so on. The length of each dash and space in the dash pattern is the product of the element value in the array and the stroke width.

Note

This overrides the DashStyle property, which is only used when CustomDashStyle is set to null.

This array must contain an even number of elements.

Windows Toolkit Invalid Class Action

Example:

Defining the CanvasStrokeStyle

Using the attributes defined in the previous section the CanvasStrokeStyle can be defined in the following way

All the attributes of CanvasStrokeStyle are optional. If none of the attributes is specified in the CanvasStrokeStyle definition string, then the default CanvasStrokeStyle object is created.

Note

While specifying the attributes, the order of the attributes must be maintained.

Example:

CanvasStroke Mini Language

ICanvasStroke interface and CanvasStroke class

In Win2D, the stroke, that is used to render an outline to a CanvasGeometry, is comprised of three components

• Stroke Width – defines the width of the stroke.
• Stroke Brush – defines the ICanvasBrush that will be used to render the stroke.
• Stroke Style – defines the CanvasStrokeStyle for the stroke.
• Transform - defines the Transform property of the stroke brush.

ICanvasStroke interface, defined in the Microsoft.Toolkit.Uwp.UI.Media.Geometry namespace, encapsulates these three components and the CanvasStroke class implements this interface.

In order to define a CanvasStroke using the Mini Language, the ST command is used in the following way

In this command string, strokeWidth is a positive floating point number, CanvasBrushML denotes the CanvasBrush Mini Language and the CanvasStrokeStyleML denotes the CanvasStrokeStyle Mini Language.

Example:

Creating Geometries, Brushes, Strokes and StrokeStyles

To create instances of CanvasGeomety, Brushes, CanvasStrokes, and CanvasStrokeStyles you can use the CanvasPathGeometry class in the Microsoft.Toolkit.Uwp.UI.Media.Geometry namespace.

Related Topics