TextureBrush.MultiplyTransform Method (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.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public void MultiplyTransform(
	Matrix matrix,
	MatrixOrder order
)

Parameters

matrix
Type: System.Drawing.Drawing2D.Matrix

The Matrix object by which to multiply the geometric transformation.

order
Type: System.Drawing.Drawing2D.MatrixOrder

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

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.

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.

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);
}

.NET Framework
Available since 1.1
Return to top
Show: