Stroke.Transform Method (Matrix, Boolean)

Article
10/19/2012

Applies a linear transformation to a Stroke object, with the option of applying the transformation to the pen width.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub Transform ( _
    inkTransform As Matrix, _
    applyOnPenWidth As Boolean _
)
'Usage
Dim instance As Stroke 
Dim inkTransform As Matrix 
Dim applyOnPenWidth As Boolean

instance.Transform(inkTransform, applyOnPenWidth)

public void Transform(
    Matrix inkTransform,
    bool applyOnPenWidth
)

public:
void Transform(
    Matrix^ inkTransform, 
    bool applyOnPenWidth
)

public function Transform(
    inkTransform : Matrix, 
    applyOnPenWidth : boolean
)

Parameters

inkTransform
Type: System.Drawing.Drawing2D.Matrix

The System.Drawing.Drawing2D.Matrix transform to use on the Stroke object.

applyOnPenWidth
Type: System.Boolean

The Boolean value that indicates whether to apply the transform to the width of the ink in the DrawingAttributes of the Stroke object.

Value

Meaning

true

The transformation applies to both the points and pen width.

false

The transformation applies only to the points.

Value	Meaning
true	The transformation applies to both the points and pen width.
false	The transformation applies only to the points.

Remarks

The linear transform can represent scaling, rotation, translation, and combinations of transformations.

If the pen width is scaled appropriately for the transform, the drawn pen width is calculated by multiplying the specified pen width (or default of 53, if unspecified) by the square root of the determinant of the transform.

Examples

This C# example scales a Stroke object, theStroke, by a factor of two around the center of the stroke's bounding box. The width of the ink is also scaled by a factor of two.

using System.Drawing.Drawing2D;
//...
Matrix inkTransform = new Matrix();
Rectangle inkBounds = theStroke.GetBoundingBox();
PointF center = new PointF(0.5f * (inkBounds.Left + inkBounds.Right),
                           0.5f * (inkBounds.Top + inkBounds.Bottom));
// Translate to center of bounding box
inkTransform.Translate(center.X, center.Y);
// Scale by factor of 2
inkTransform.Scale(2.0F, 2.0F);
// Translate back
inkTransform.Translate(-center.X, -center.Y);
// Transform stroke
theStroke.Transform(inkTransform, true);

This Microsoft Visual Basic .NET example scales a Stroke object, theStroke, by a factor of two around the center of the stroke's bounding box. The width of the ink is also scaled by a factor of two.

Imports System.Drawing.Drawing2D
'...
Dim inkTransform As New Matrix()
Dim inkBounds As Rectangle = theStroke.GetBoundingBox()
Dim center As New PointF(0.5F * (inkBounds.Left + inkBounds.Right), _
                         0.5F * (inkBounds.Top + inkBounds.Bottom))
'Translate to center of bounding box
inkTransform.Translate(center.X, center.Y)
'Scale by a factor of 2
inkTransform.Scale(2.0F, 2.0F)
'Translate back
inkTransform.Translate(-center.X, -center.Y)
'Transform stroke
theStroke.Transform(inkTransform, True)

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via