RectangleShape Class

Summary: Represents a rectangular shape.

Module: aspose.imaging.shapes

Full Name: aspose.imaging.shapes.RectangleShape

Inheritance: RectangleProjectedShape

Aspose.Imaging Version: 24.5.0

Constructors

Name	Description
RectangleShape()	Initializes a new instance of the RectangleShape class.
RectangleShape(rectangle)	Initializes a new instance of the RectangleShape class.

Properties

Name	Type	Access	Description
bounds	RectangleF	r	Gets the object’s bounds.
center	PointF	r	Gets the shape’s center.
has_segments	bool	r	Gets a value indicating whether shape has segments.
left_bottom	PointF	r	Gets the left bottom rectangle point.
left_top	PointF	r	Gets the left top rectangle point.
rectangle_height	double	r	Gets the rectangle height.
rectangle_width	double	r	Gets the rectangle width.
right_bottom	PointF	r	Gets the right bottom rectangle point.
right_top	PointF	r	Gets the right top rectangle point.
segments	ShapeSegment[]	r	Gets the shape segments.

Methods

Name	Description
get_bounds(matrix)	Gets the object’s bounds.
get_bounds(matrix, pen)	Gets the object’s bounds.
transform(transform)	Applies the specified transformation to the shape.

Constructor: RectangleShape()

 RectangleShape() 

Initializes a new instance of the RectangleShape class.

Constructor: RectangleShape(rectangle)

 RectangleShape(rectangle) 

Initializes a new instance of the RectangleShape class.

Parameters:

Parameter	Type	Description
rectangle	RectangleF	The rectangle.

See also:

Example # 1: This examples make use of GraphicsPath and Graphics classes to create and man…

Example # 2: This example creates a new Image and draws a variety of shapes using figures …

Method: get_bounds(matrix)

 get_bounds(matrix) 

Gets the object’s bounds.

Parameters:

Parameter	Type	Description
matrix	Matrix	The matrix to apply before bounds will be calculated.

Returns

Type	Description
RectangleF	The estimated object’s bounds.

Method: get_bounds(matrix, pen)

 get_bounds(matrix, pen) 

Gets the object’s bounds.

Parameters:

Parameter	Type	Description
matrix	Matrix	The matrix to apply before bounds will be calculated.
pen	Pen	The pen to use for object. This can influence the object’s bounds size.

Returns

Type	Description
RectangleF	The estimated object’s bounds.

Method: transform(transform)

 transform(transform) 

Applies the specified transformation to the shape.

Parameters:

Parameter	Type	Description
transform	Matrix	The transformation to apply.

Examples

This examples make use of GraphicsPath and Graphics classes to create and manipulate figures on an Image surface. Example creates a new Image (of type Tiff), clears the surface and draws paths with the help of GraphicsPath class. At the end draw_path method exposed by Graphics class is called to render the paths on surface.

from aspose.imaging import Image, Graphics, Color, GraphicsPath, Figure, RectangleF, PointF, SizeF
from aspose.imaging import Pen
from aspose.imaging.sources import StreamSource
from aspose.imaging.imageoptions import TiffOptions
from aspose.imaging.fileformats.tiff.enums import TiffExpectedFormat
from aspose.imaging.shapes import RectangleShape, EllipseShape, PieShape


# Create an instance of a file stream
with open(r"C:\temp\output.tiff", "w+b") as stream:
	# Create an instance of TiffOptions and set its various properties
	tiffOptions = TiffOptions(TiffExpectedFormat.DEFAULT)
	# Set the source for the instance of ImageOptions
	tiffOptions.source = StreamSource(stream)
	# Create an instance of Image
	with Image.create(tiffOptions, 500, 500) as image:
		# Create and initialize an instance of Graphics class
		graphics = Graphics(image)
		# Clear Graphics surface
		graphics.clear(Color.wheat);
		# Create an instance of GraphicsPath class
		graphics_path = GraphicsPath()
		# Create an instance of Figure class
		figure = Figure()
		# Add Shapes to Figure object
		figure.add_shape(RectangleShape(RectangleF(10.0, 10.0, 300.0, 300.0)))
		figure.add_shape(EllipseShape(RectangleF(50.0, 50.0, 300.0, 300.0)))
		figure.add_shape(PieShape(RectangleF(PointF(250.0, 250.0), SizeF(200.0, 200.0)), 0.0, 45.0))
		# Add Figure object to GraphicsPath
		graphics_path.add_figure(figure)
		# Draw path with Pen object of color Black
		graphics.draw_path(Pen(Color.black, 2.0), graphics_path)
		# save all changes.
		image.save()

This example creates a new Image and draws a variety of shapes using figures and GraphicsPath on the Image surface

from aspose.imaging import Image, Graphics, Color, GraphicsPath, Figure, RectangleF, Rectangle, Size
from aspose.imaging import Point, PointF, Pen
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.sources import FileCreateSource
from aspose.imaging.shapes import EllipseShape, PieShape, ArcShape, PolygonShape, RectangleShape
from os.path import join as path_join

#Creates an instance of BmpOptions and set its various properties            
with BmpOptions() as bmpOptions:
	bmpOptions.bits_per_pixel = 24
	#Create an instance of FileCreateSource and assign it as Source for the instance of BmpOptions
	#Second Boolean parameter determines if the file to be created IsTemporal or not
	bmpOptions.source = FileCreateSource(r"c:\temp\output.bmp", False)
	#Create an instance of Image 
	with Image.create(bmpOptions, 500, 500) as image:
		# Create and initialize an instance of Graphics class
		graphics = Graphics(image)
		# Clear Graphics surface
		graphics.clear(Color.wheat)
		# Create an instance of GraphicsPath class
		graphicspath = GraphicsPath()
		#Create an instance of Figure class
		figure1 = Figure()
		# Add Shape to Figure object
		figure1.add_shape(EllipseShape(RectangleF(50, 50, 300, 300)))
		figure1.add_shape(PieShape(Rectangle(Point(110, 110), Size(200, 200)), 0, 90))
		# Create an instance of Figure class
		figure2 = Figure()
		# Add Shape to Figure object
		figure2.add_shape(ArcShape(RectangleF(10, 10, 300, 300), 0, 45))
		figure2.add_shape(
			PolygonShape([PointF(150, 10), PointF(150, 200), PointF(250, 300), PointF(350, 400)], True))
		figure2.add_shape(RectangleShape(RectangleF(Point(250, 250), Size(200, 200))))
		# Add Figure object to GraphicsPath
		graphicspath.add_figures([figure1, figure2])
		# Draw path with Pen object of color Black
		graphics.draw_path(Pen(Color.black, 2.0), graphicspath)
		# save all changes.
		image.save()