Drawing Images using Graphics

Drawing Images using Graphics

With the Aspose.PSD library you can draw simple shapes like lines, rectangles and circles, as well as complex shapes like polygons, curves, arcs and Bezier shapes. Aspose.PSD library creates such shapes using Graphics class that resides in the Aspose.PSD namespace. Graphics objects are responsible for performing different drawing operations on an image, thus changing the image’s surface. The Graphics class uses a variety of helper objects to enhance the shapes:

·         Pens, to draw lines, outline shapes, or render other geometric representations.

·         Brushes, to define how areas are filled in.

·         Fonts, to define the shape of characters of text.

Drawing with the Graphics Class

Below is a code example demonstrating the use of the Graphics class. The example source code has been split into several parts to keep it simple and easy to follow. Step by step, the examples show how to:

1. Create an image.
2. Create and initialize a Graphics object.
3. Clear the surface.
4. Draw an ellipse.
5. Draw a filled polygon and save the image.

Programming Samples

Creating an Image

Start by creating an image using any of the methods described in Creating Files.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

string loadpath = dataDir + "sample.psd";
string outpath = dataDir + "CoreDrawingFeatures.bmp";
// Create an instance of Image
using (PsdImage image = new PsdImage(loadpath))
{
    // load pixels
    var pixels = image.LoadArgb32Pixels(new Rectangle(0, 0, 100, 10));

    for (int i = 0; i < pixels.Length; i++)
    {
        // specify pixel color value (gradient in this case).
        pixels[i] = i;
    }

    // save modified pixels.
    image.SaveArgb32Pixels(new Rectangle(0, 0, 100, 10), pixels);

    // export image to bmp file format.
    image.Save(outpath, new BmpOptions());
}

Create and Initialize a Graphics Object

Then create and initialize a Graphics object by passing the Image object to its constructor.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

string outpath = dataDir + "Arc.bmp";
// Create an instance of BmpOptions and set its various properties
BmpOptions saveOptions = new BmpOptions();
saveOptions.BitsPerPixel = 32;

// Create an instance of Image
using (Image image = new PsdImage(100, 100))
{
    // Create and initialize an instance of Graphics class and clear Graphics surface
    Graphics graphic = new Graphics(image);
    graphic.Clear(Color.Yellow);

    // Draw an arc shape by specifying the Pen object having red black color and coordinates, height, width, start & end angles                 
    int width = 100;
    int height = 200;
    int startAngle = 45;
    int sweepAngle = 270;

    // Draw arc to screen and save all changes.
    graphic.DrawArc(new Pen(Color.Black), 0, 0, width, height, startAngle, sweepAngle);

    // export image to bmp file format.
    image.Save(outpath, saveOptions);
}

Clear the Surface

Clear the Graphics surface by calling the Graphics class Clear method and pass color as a parameter. This method fills the Graphics surface with the color passed in as an argument.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

// Create an instance of Image
using (PsdImage image = new PsdImage(500, 500))
{
    var graphics = new Graphics(image);

    // Clear the image surface with white color and Create and initialize a Pen object with blue color
    graphics.Clear(Color.White);
    var pen = new Pen(Color.Blue);

    // Draw Ellipse by defining the bounding rectangle of width 150 and height 100 also Draw a polygon using the LinearGradientBrush
    graphics.DrawEllipse(pen, new Rectangle(10, 10, 150, 100));
    using (var linearGradientBrush = new LinearGradientBrush(image.Bounds, Color.Red, Color.White, 45f))
    {
        graphics.FillPolygon(linearGradientBrush, new[] { new Point(200, 200), new Point(400, 200), new Point(250, 350) });
    }

    // export modified image.
    image.Save(dataDir + "DrawingUsingGraphics_output.bmp", new BmpOptions());
}

Draw an Ellipse

You may notice that the Graphics class has exposed plenty of methods to draw and fill shapes. You’ll find get the complete list of methods in the Aspose.PSD for .NET API Reference. There are several overloaded versions of the DrawEllipse method exposed by the Graphics class. All these methods accept a Pen object as its first argument. The later parameters are passed to define the bounding rectangle around the ellipse. For the sake of this example, use the version accepting a Rectangle object as the second parameter to draw an ellipse using the Pen object in your desired color.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

string loadpath = dataDir + "sample.psd";
string outpath = dataDir + "CoreDrawingFeatures.bmp";
// Create an instance of Image
using (PsdImage image = new PsdImage(loadpath))
{
    // load pixels
    var pixels = image.LoadArgb32Pixels(new Rectangle(0, 0, 100, 10));

    for (int i = 0; i < pixels.Length; i++)
    {
        // specify pixel color value (gradient in this case).
        pixels[i] = i;
    }

    // save modified pixels.
    image.SaveArgb32Pixels(new Rectangle(0, 0, 100, 10), pixels);

    // export image to bmp file format.
    image.Save(outpath, new BmpOptions());
}

Draw a Filled Polygon

Next, draw a polygon using the LinearGradientBrush and an array of points. The Graphics class has exposed several overloaded versions of the FillPolygon() method. All of these accept a Brush object as its first argument, defining the characteristics of the fill. The second parameter is an array of points. Please note that every two consecutive points in the array specify a side of the polygon.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

// Create an instance of Image
using (PsdImage image = new PsdImage(500, 500))
{
    var graphics = new Graphics(image);

    // Clear the image surface with white color and Create and initialize a Pen object with blue color
    graphics.Clear(Color.White);
    var pen = new Pen(Color.Blue);

    // Draw Ellipse by defining the bounding rectangle of width 150 and height 100 also Draw a polygon using the LinearGradientBrush
    graphics.DrawEllipse(pen, new Rectangle(10, 10, 150, 100));
    using (var linearGradientBrush = new LinearGradientBrush(image.Bounds, Color.Red, Color.White, 45f))
    {
        graphics.FillPolygon(linearGradientBrush, new[] { new Point(200, 200), new Point(400, 200), new Point(250, 350) });
    }

    // export modified image.
    image.Save(dataDir + "DrawingUsingGraphics_output.bmp", new BmpOptions());
}

Drawing Images using Graphics : Complete Source

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

// Create an instance of Image
using (PsdImage image = new PsdImage(500, 500))
{
    var graphics = new Graphics(image);

    // Clear the image surface with white color and Create and initialize a Pen object with blue color
    graphics.Clear(Color.White);
    var pen = new Pen(Color.Blue);

    // Draw Ellipse by defining the bounding rectangle of width 150 and height 100 also Draw a polygon using the LinearGradientBrush
    graphics.DrawEllipse(pen, new Rectangle(10, 10, 150, 100));
    using (var linearGradientBrush = new LinearGradientBrush(image.Bounds, Color.Red, Color.White, 45f))
    {
        graphics.FillPolygon(linearGradientBrush, new[] { new Point(200, 200), new Point(400, 200), new Point(250, 350) });
    }

    // export modified image.
    image.Save(dataDir + "DrawingUsingGraphics_output.bmp", new BmpOptions());
}

All classes that implements IDisposable and access unmanaged resources are instantiated in a Using statement to ensure that they are disposed of correctly.