ARTICLE

# Transformation with Brushes in GDI+

Posted by | February 09, 2010

The TextureBrush, LinearGradientBrush, and PathGradientBrush classes also provide transformation methods. Brush transformation is not used very often, but it may be useful in some cases, as the following example will show.

A transformation on a TextureBrush object is a transformation of the image used as the texture. TextureBrush provides the methods MultiplyTransform, ResetTransform, RotateTransform, ScaleTransform, and TranslateTransform (see Table 4.15).

The TextureBrush class also provides a Transform property, which can be used to apply a transformation on a texture brush.

TABLE 4.15: TextureBrush methods

Method

###### Description

MultiplyTransform

Multiplies the Matrix object that represents the local geometric transformation of a texture brush by the specified Matrix object in the specified order.

ResetTransform

Resets the Transform property of a texture of identity.

RotateTransform

Rotates the local geometric transformation of a texture brush by the specified amount.

ScaleTransform

Scales the local geometric transformation of a texture brush by the specified amount.

TranslateTransform

Translates the local geometric transformation of a texture brush by the specified dimensions in the specified order.

Listing 4.23 uses the Translate, MultiplyTransform, ScaleTransform, and RotateTransform methods of the Pen class to apply rotation on pens, and draws a line and rectangles.

LISTING 4.23: Transformation is texture brushes

using System;
using
System.Collections.Generic;
using
System.ComponentModel;
using
System.Data;
using
System.Drawing;
using
System.Drawing.Drawing2D;
using
System.Linq;
using
System.Text;
using
System.Windows.Forms;

namespace
TransformationWithBrushes
{

public partial class Form1 : Form
{

public Form1()
{
InitializeComponent();
}

private void Form1_Paint(object sender, PaintEventArgs e)
{

Graphics g = this.CreateGraphics();
g.Clear(
this.BackColor);

//Create a TextureBrush object
TextureBrush txtrBrush = new TextureBrush(new Bitmap("D:/VB.NET Basic Practice Projects/WindowsApplication8/Images/Image.GIF"));

//Create a transformation matrix
Matrix M = new Matrix();

//Rotate the texture image by 90 degrees
txtrBrush.RotateTransform(90, MatrixOrder.Prepend);

//Translate
M.Translate(50, 0);

//Multiply the Transformation matrix
//of txtrBrush by translateMatrix
txtrBrush.MultiplyTransform(M);

//Scale Operation
txtrBrush.ScaleTransform(2, 1, MatrixOrder.Prepend);

//Fill a rectangle with texture brush
g.FillRectangle(txtrBrush, 240, 0, 200, 200);

//Reset transformation
txtrBrush.ResetTransform();

//Fill Rectangle after resetting transformation
g.FillRectangle(txtrBrush, 0, 0, 200, 200);

//Dispose of objects
txtrBrush.Dispose();
g.Dispose();
}
}
}

Figure 4.28 shows the output from Listing 4.23, with the original image on left and the transformed image on the right.

A transformation on a linear gradient brush is a transformation of the colors of the brush. The LinearGradientBrush class provides all common transformation methods and Transform properties. Listing 4.24 shows how to use transformation in linear gradient brushes.

FIGURE 4.28: Transformation in TextureBrush

LISTING 4.24: Transformation in linear gradient brushes

using
System;
using
System.Collections.Generic;
using
System.ComponentModel;
using
System.Data;
using
System.Drawing;
using
System.Drawing.Drawing2D;
using
System.Linq;
using
System.Text;
using
System.Windows.Forms;

namespace
TransformationWithBrushes
{

public partial class Form1 : Form
{

public Form1()
{
InitializeComponent();
}

private void Form1_Paint(object sender, PaintEventArgs e)
{

Graphics g = this.CreateGraphics();
g.Clear(
this.BackColor);

Rectangle rect = new Rectangle(20, 20, 200, 100);

Point[] ptsArray = { new Point(20, 50), new Point(200, 50), new Point(20, 100) };

Matrix M = new Matrix(rect, ptsArray);

//Multiply transformation
lgBrush.MultiplyTransform(M, MatrixOrder.Prepend);

//Rotate transformation
lgBrush.RotateTransform(45.0f, MatrixOrder.Prepend);

//Scale transformation
lgBrush.ScaleTransform(2, 1, MatrixOrder.Prepend);

//Draw a rectangle after transformation
g.FillRectangle(lgBrush, 0, 0, 200, 100);

//Reset transformation
lgBrush.ResetTransform();

//Draw a Rectangle after reset transformation
g.FillRectangle(lgBrush, 220, 0, 200, 100);
lgBrush.Dispose();
g.Dispose();
}
}
}

Figure 4.29 shows the output from Listing 4.24. The second rectangle results from various transformation operations, and the first rectangle is a result of a call to ResetTransform.

PathGradientBrush provides similar mechanism to transform path gradient brushes. As listing 4.25 shows, we create a PathGradientBrush object and set its CenterColor and SurroundColors properties. Then we create a Matrix object and call its methods to apply various transformation operations, such as translation, rotation, scaling and shearing, and we apply the Matrix object to the PathGraidentBrush object by calling its MutiplyTransform method.

Figure 4.29: Transformation in linear gradient brushes

LISTING 4.25: Transformation in path gradient brushes

using
System;
using
System.Collections.Generic;
using
System.ComponentModel;
using
System.Data;
using
System.Drawing;
using
System.Drawing.Drawing2D;
using
System.Linq;
using
System.Text;
using
System.Windows.Forms;

namespace TransformationWithBrushes
{

public partial class Form1 : Form
{

public Form1()
{
InitializeComponent();
}

private void Form1_Paint(object sender, PaintEventArgs e)
{

Graphics g = this.CreateGraphics();
g.Clear(
this.BackColor);

//Create a GraphicsPath object
GraphicsPath path = new GraphicsPath();

//Create a rectangle and add it to path
Rectangle rect = new Rectangle(20, 20, 200, 200);

//Set its center and surrounding colors
pgBrush.CenterColor = Color.Green;
pgBrush.SurroundColors =
new Color[] { Color.Blue };

//Create Matrix
Matrix M = new Matrix();

//Translate
M.Translate(20.0f, 10.0f, MatrixOrder.Prepend);

//Rotate
M.Rotate(10.0f, MatrixOrder.Prepend);

//Scale
M.Scale(2, 1, MatrixOrder.Prepend);

//Shear
M.Shear(.05f, 0.03f, MatrixOrder.Prepend);

//Apply matrix to the brush
pgBrush.MultiplyTransform(M);

//Use brush after transformation
//To fill a rectangle
g.FillRectangle(pgBrush, 20, 100, 400, 400);

//Dispose of objects
pgBrush.Dispose();
g.Dispose();
}
}
}

Figure 4.30 shows the output from listing 4.25. The original rectangle started at point (10,10) with height and width 200 each, but after various transformation methods have been applied, the output rectangle is totally different.

FIGURE: 4.30: Transformation in path gradient brushes

Conclusion

Hope the article would have helped you in understanding Transformation with Brushes in GDI+. Read other articles on GDI+ on the website.

 This book teaches .NET developers how to work with GDI+ as they develop applications that include graphics, or that interact with monitors or printers. It begins by explaining the difference between GDI and GDI+, and covering the basic concepts of graphics programming in Windows.