Drawing Images using GraphicsPath

Drawing Images using GraphicsPath

The GraphicsPath class is responsible for creating and maintaining a graphics path. The GraphicsPath has no reference to an image and does not change the image itself, instead, it can be considered as an object that contains metadata that describes the paths that Graphics class can draw. The GraphicsPath class uses figures; each figure is either composed of a sequence of connected lines and curves or a geometric shape primitive. Each shape may be split into shape segments. You can add, remove and change different figures or shapes in a GraphicsPath object. When the GraphicsPath has been fully described, use the corresponding Graphics class methods (draw_path and fill_path to draw over or fill the paths. The Graphics class takes each shape segment and draws it to produce the final image.

Drawing using GraphicsPath Class

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

1. Create an image.
2. Initialize a Graphics object.
3. Clear the surface.
4. Create an instance of GraphicsPath.
5. Create a figure.
6. Add shapes to the figure.
7. Create a Figures array.
8. Draw paths.
9. Fill paths.

Drawing Images using GraphicsPath: Programming Samples

GraphicsPath : Create an Image

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

GraphicsPath : Initialize a Graphics Objects

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

GraphicsPath : Clear the Surface

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

GraphicsPath : Create an Instance of the GraphicsPath

Create an instance of GraphicsPath with GraphicsPath set to Alternate by default. This mode determines how to fill the interior of a closed figure. The other possible GraphicsPath value is Winding.

GraphicsPath : Create a Figure

Create an instance of the Figure class. As discussed earlier, Figure can contain Shapes and shapes reside in the aspose.imaging.shapes namespace.

GraphicsPath : Add Shapes to the Figure

The Add Shapes method exposed by the Figure class lets you add shapes to the figure. In the code examples below, several shapes are added to a Figure object.

GraphicsPath : Add Figures to an Array

Multiple figures can be added to a GraphicsPath object using the add_figures method exposed by the GraphicsPath class. This method accepts an array of figures as a parameter.

GraphicsPath : Draw the Paths

Draw the GraphicsPath using the DrawPath method exposed by Graphics class. The method accepts two parameters. The first parameter is an object of the Pen class, which determines the color, width and style of the path. The second parameter is the object of the GraphicsPath class, representing the path itself.

GraphicsPath : Fill Paths

You can fill a path by passing a GraphicsPath object to the fill_path method exposed by the Graphics class. The fill_path method fills the path according to the fill mode (alternate or winding) currently set for the path. If the path has any open figures, the path is filled as if those figures were closed.

The fill_path method accepts two parameters. The first parameter is an object of any brush class from the aspose.imaging.brushes namespace. The second parameter is the path itself. For the sake of this example, use the HatchBrush which is a rectangular brush with a hatch style, a foreground color, and a background color. Before passing the HatchBrush object to the fill_path method, set its properties.

GraphicsPath : Complete Source

All classes that implements enter and exit methods are instantiated in a with statement to ensure that they are disposed of correctly.