The class represents rotated (i.e. not up-right) rectangles on a plane. More...

#include <opencv2/core/types.hpp>

Public Member Functions
	RotatedRect ()
	default constructor

	RotatedRect (const Point2f &center, const Size2f &size, float angle)

	RotatedRect (const Point2f &point1, const Point2f &point2, const Point2f &point3)

Rect	boundingRect () const
	returns the minimal up-right integer rectangle containing the rotated rectangle

Rect_< float >	boundingRect2f () const
	returns the minimal (exact) floating point rectangle containing the rotated rectangle, not intended for use with images

void	points (Point2f pts[]) const

void	points (std::vector< Point2f > &pts) const

Public Attributes
float	angle
	returns the rotation angle. When the angle is 0, 90, 180, 270 etc., the rectangle becomes an up-right rectangle.

Point2f	center
	returns the rectangle mass center

Size2f	size
	returns width and height of the rectangle

Detailed Description

The class represents rotated (i.e. not up-right) rectangles on a plane.

Each rectangle is specified by the center point (mass center), length of each side (represented by Size2f structure) and the rotation angle in degrees.

The sample below demonstrates how to use RotatedRect:

    Mat test_image(200, 200, CV_8UC3, Scalar(0));
    RotatedRect rRect = RotatedRect(Point2f(100,100), Size2f(100,50), 30);
 
    Point2f vertices[4];
    rRect.points(vertices);
    for (int i = 0; i < 4; i++)
    {
        line(test_image, vertices[i], vertices[(i+1)%4], Scalar(0,255,0), 2);
        putText(test_image, vertex_names[i], vertices[i], FONT_HERSHEY_SIMPLEX, 1, Scalar(255,255,255));
    }
 
    Rect brect = rRect.boundingRect();
    rectangle(test_image, brect, Scalar(255,0,0), 2);
 
    imshow("rectangles", test_image);
    waitKey(0);

See also: CamShift, fitEllipse, minAreaRect, CvBox2D

Examples: samples/cpp/camshiftdemo.cpp, samples/cpp/fitellipse.cpp, and samples/cpp/minarea.cpp.

Constructor & Destructor Documentation

◆ RotatedRect() [1/3]

cv::RotatedRect::RotatedRect ( )

default constructor

◆ RotatedRect() [2/3]

cv::RotatedRect::RotatedRect	(	const Point2f &	center,
		const Size2f &	size,
		float	angle
	)

full constructor

Parameters

center	The rectangle mass center.
size	Width and height of the rectangle.
angle	The rotation angle in a clockwise direction. When the angle is 0, 90, 180, 270 etc., the rectangle becomes an up-right rectangle.

◆ RotatedRect() [3/3]

cv::RotatedRect::RotatedRect	(	const Point2f &	point1,
		const Point2f &	point2,
		const Point2f &	point3
	)

Any 3 end points of the RotatedRect. They must be given in order (either clockwise or anticlockwise).

Member Function Documentation

◆ boundingRect()

Rect cv::RotatedRect::boundingRect ( ) const

returns the minimal up-right integer rectangle containing the rotated rectangle

◆ boundingRect2f()

Rect_< float > cv::RotatedRect::boundingRect2f ( ) const

returns the minimal (exact) floating point rectangle containing the rotated rectangle, not intended for use with images

◆ points() [1/2]

void cv::RotatedRect::points ( Point2f pts[] ) const

returns 4 vertices of the rotated rectangle

Parameters

pts	The points array for storing rectangle vertices. The order is bottomLeft, topLeft, topRight, bottomRight.

Note: Bottom, Top, Left and Right sides refer to the original rectangle (angle is 0), so after 180 degree rotation bottomLeft point will be located at the top right corner of the rectangle.

Examples: samples/cpp/fitellipse.cpp, and samples/cpp/minarea.cpp.

◆ points() [2/2]

void cv::RotatedRect::points ( std::vector< Point2f > & pts ) const

Member Data Documentation

◆ angle

float cv::RotatedRect::angle

returns the rotation angle. When the angle is 0, 90, 180, 270 etc., the rectangle becomes an up-right rectangle.

◆ center

Point2f cv::RotatedRect::center

returns the rectangle mass center

Examples: samples/cpp/fitellipse.cpp.

◆ size

Size2f cv::RotatedRect::size

returns width and height of the rectangle

Examples: samples/cpp/fitellipse.cpp.

The documentation for this class was generated from the following file:

opencv2/core/types.hpp

Public Member Functions

Public Attributes