TextureBrush.MultiplyTransform Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Multiplies the Matrix object that represents the local geometric transformation of this TextureBrush object by the specified Matrix object in the specified order.

Overloads

MultiplyTransform(Matrix, MatrixOrder)	Multiplies the Matrix object that represents the local geometric transformation of this TextureBrush object by the specified Matrix object in the specified order.
MultiplyTransform(Matrix)	Multiplies the Matrix object that represents the local geometric transformation of this TextureBrush object by the specified Matrix object by prepending the specified Matrix object.

MultiplyTransform(Matrix, MatrixOrder)

Source:

TextureBrush.cs

Multiplies the Matrix object that represents the local geometric transformation of this TextureBrush object by the specified Matrix object in the specified order.

C#

public void MultiplyTransform(System.Drawing.Drawing2D.Matrix matrix, System.Drawing.Drawing2D.MatrixOrder order);

Parameters

matrix

Matrix

The Matrix object by which to multiply the geometric transformation.

order

MatrixOrder

A MatrixOrder enumeration that specifies the order in which to multiply the two matrices.

Examples

The following example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Creates a TextureBrush object.

• Creates a new matrix that specifies a translation of 50 units in the x-direction.

• Multiplies the matrix with the transformation matrix of the texture brush.

• Fills a rectangle, using the texture brush.

C#

public void MultiplyTransform_Example2(PaintEventArgs e)
{
             
    // Create a TextureBrush object.
    TextureBrush tBrush = new TextureBrush(new Bitmap("texture.jpg"));
             
    // Create a transformation matrix.
    Matrix translateMatrix = new Matrix();
    translateMatrix.Translate(50, 0);
             
    // Multiply the transformation matrix of tBrush by translateMatrix.
    tBrush.MultiplyTransform(translateMatrix);
             
    // Fill a rectangle with tBrush.
    e.Graphics.FillRectangle(tBrush, 0, 110, 100, 100);
}

Remarks

The transformation matrix of a TextureBrush object specifies how the image that defines the texture is transformed. For example, if the transformation matrix specifies a rotation of 90 degrees clockwise, the texture image is rotated by 90 degrees clockwise.

MultiplyTransform(Matrix)

Source:

TextureBrush.cs

Multiplies the Matrix object that represents the local geometric transformation of this TextureBrush object by the specified Matrix object by prepending the specified Matrix object.

C#

public void MultiplyTransform(System.Drawing.Drawing2D.Matrix matrix);

Parameters

matrix

Matrix

The Matrix object by which to multiply the geometric transformation.

Examples

The following example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Creates a TextureBrush object.

• Creates a new matrix that specifies a translation of 50 units in the x-direction.

• Multiplies the matrix with the transformation matrix of the texture brush.

• Fills a rectangle, using the texture brush.

C#

public void MultiplyTransform_Example1(PaintEventArgs e)
{
             
    // Create a TextureBrush object.
    TextureBrush tBrush = new TextureBrush(new Bitmap("texture.jpg"));
             
    // Create a transformation matrix.
    Matrix translateMatrix = new Matrix();
    translateMatrix.Translate(50, 0);
             
    // Multiply the transformation matrix of tBrush by translateMatrix.
    tBrush.MultiplyTransform(translateMatrix, MatrixOrder.Prepend);
             
    // Fill a rectangle with tBrush.
    e.Graphics.FillRectangle(tBrush, 0, 110, 100, 100);
}

Remarks

The transformation matrix of a TextureBrush object specifies how the image that defines the texture is transformed. For example, if the transformation matrix specifies a rotation of 90 degrees clockwise, the texture image is rotated by 90 degrees clockwise.