Stroke.Transform Method
Stroke.Transform Method |
Applies a linear transformation to a Stroke object.
Definition
Visual Basic .NET Public Sub Transform( _
ByVal inkTransform As Matrix, _
ByVal applyOnPenWidth As Boolean _
)C# public void Transform(
Matrix inkTransform,
bool applyOnPenWidth
);Managed C++ public: void Transform(
Matrix *inkTransform,
bool *applyOnPenWidth
);
Parameters
> > >
inkTransform System.Drawing.Drawing2D.Matrix. The System.Drawing.Drawing2D.Matrix transform to use on the Stroke object. applyOnPenWidth 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.
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
[C#]
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 ia 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);
[VB.NET]
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 ia 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)
See Also