OpenCV  4.1.0
Open Source Computer Vision
Public Types | Public Member Functions | Public Attributes | List of all members
cv::Rect_< _Tp > Class Template Reference

Template class for 2D rectangles. More...

#include <opencv2/core/types.hpp>

Public Types

typedef _Tp value_type
 

Public Member Functions

 Rect_ ()
 default constructor
 
 Rect_ (_Tp _x, _Tp _y, _Tp _width, _Tp _height)
 
 Rect_ (const Rect_ &r)
 
 Rect_ (Rect_ &&r) CV_NOEXCEPT
 
 Rect_ (const Point_< _Tp > &org, const Size_< _Tp > &sz)
 
 Rect_ (const Point_< _Tp > &pt1, const Point_< _Tp > &pt2)
 
_Tp area () const
 area (width*height) of the rectangle
 
Point_< _Tp > br () const
 the bottom-right corner
 
bool contains (const Point_< _Tp > &pt) const
 checks whether the rectangle contains the point
 
bool empty () const
 true if empty
 
template<typename _Tp2 >
 operator Rect_< _Tp2 > () const
 conversion to another data type
 
Rect_operator= (const Rect_ &r)
 
Rect_operator= (Rect_ &&r) CV_NOEXCEPT
 
Size_< _Tp > size () const
 size (width, height) of the rectangle
 
Point_< _Tp > tl () const
 the top-left corner
 

Public Attributes

_Tp height
 height of the rectangle
 
_Tp width
 width of the rectangle
 
_Tp x
 x coordinate of the top-left corner
 
_Tp y
 y coordinate of the top-left corner
 

Detailed Description

template<typename _Tp>
class cv::Rect_< _Tp >

Template class for 2D rectangles.

described by the following parameters:

OpenCV typically assumes that the top and left boundary of the rectangle are inclusive, while the right and bottom boundaries are not. For example, the method Rect_::contains returns true if

\[x \leq pt.x < x+width, y \leq pt.y < y+height\]

Virtually every loop over an image ROI in OpenCV (where ROI is specified by Rect_<int> ) is implemented as:

for(int y = roi.y; y < roi.y + roi.height; y++)
for(int x = roi.x; x < roi.x + roi.width; x++)
{
// ...
}

In addition to the class members, the following operations on rectangles are implemented:

This is an example how the partial ordering on rectangles can be established (rect1 \(\subseteq\) rect2):

template<typename _Tp> inline bool
operator <= (const Rect_<_Tp>& r1, const Rect_<_Tp>& r2)
{
return (r1 & r2) == r1;
}

For your convenience, the Rect_<> alias is available: cv::Rect

Examples:
samples/cpp/camshiftdemo.cpp, samples/cpp/facedetect.cpp, samples/cpp/falsecolor.cpp, samples/cpp/ffilldemo.cpp, samples/cpp/grabcut.cpp, samples/cpp/peopledetect.cpp, samples/cpp/stitching.cpp, samples/cpp/stitching_detailed.cpp, samples/cpp/train_HOG.cpp, and samples/dnn/object_detection.cpp.

Member Typedef Documentation

template<typename _Tp>
typedef _Tp cv::Rect_< _Tp >::value_type

Constructor & Destructor Documentation

template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( )

default constructor

template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( _Tp  _x,
_Tp  _y,
_Tp  _width,
_Tp  _height 
)
template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( const Rect_< _Tp > &  r)
template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( Rect_< _Tp > &&  r)
template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( const Point_< _Tp > &  org,
const Size_< _Tp > &  sz 
)
template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( const Point_< _Tp > &  pt1,
const Point_< _Tp > &  pt2 
)

Member Function Documentation

template<typename _Tp>
_Tp cv::Rect_< _Tp >::area ( ) const

area (width*height) of the rectangle

Examples:
samples/cpp/camshiftdemo.cpp.
template<typename _Tp>
Point_<_Tp> cv::Rect_< _Tp >::br ( ) const

the bottom-right corner

Examples:
samples/cpp/peopledetect.cpp.
template<typename _Tp>
bool cv::Rect_< _Tp >::contains ( const Point_< _Tp > &  pt) const

checks whether the rectangle contains the point

template<typename _Tp>
bool cv::Rect_< _Tp >::empty ( ) const

true if empty

template<typename _Tp>
template<typename _Tp2 >
cv::Rect_< _Tp >::operator Rect_< _Tp2 > ( ) const

conversion to another data type

template<typename _Tp>
Rect_& cv::Rect_< _Tp >::operator= ( const Rect_< _Tp > &  r)
template<typename _Tp>
Rect_& cv::Rect_< _Tp >::operator= ( Rect_< _Tp > &&  r)
template<typename _Tp>
Size_<_Tp> cv::Rect_< _Tp >::size ( ) const

size (width, height) of the rectangle

Examples:
samples/cpp/stitching_detailed.cpp.
template<typename _Tp>
Point_<_Tp> cv::Rect_< _Tp >::tl ( ) const

Member Data Documentation

template<typename _Tp>
_Tp cv::Rect_< _Tp >::height
template<typename _Tp>
_Tp cv::Rect_< _Tp >::width
template<typename _Tp>
_Tp cv::Rect_< _Tp >::x
template<typename _Tp>
_Tp cv::Rect_< _Tp >::y

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