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

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

public:
void MultiplyTransform(
	Matrix^ matrix
)

Parameters

matrix
Type: System.Drawing.Drawing2D::Matrix^

The Matrix object by which to multiply the geometric transformation.

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_Example1( PaintEventArgs^ e )
   {
      // Create a TextureBrush object.
      TextureBrush^ tBrush = gcnew TextureBrush( gcnew Bitmap( "texture.jpg" ) );

      // Create a transformation matrix.
      Matrix^ translateMatrix = gcnew 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 );
   }

.NET Framework
Available since 1.1
Return to top
Show: