OpenCV  3.4.18
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 More...
 
 Rect_ (_Tp _x, _Tp _y, _Tp _width, _Tp _height)
 
 Rect_ (const Rect_ &r)
 
 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 More...
 
Point_< _Tp > br () const
 the bottom-right corner More...
 
bool contains (const Point_< _Tp > &pt) const
 checks whether the rectangle contains the point More...
 
bool empty () const
 true if empty More...
 
template<typename _Tp2 >
 operator Rect_< _Tp2 > () const
 conversion to another data type More...
 
Rect_operator= (const Rect_ &r)
 
Size_< _Tp > size () const
 size (width, height) of the rectangle More...
 
Point_< _Tp > tl () const
 the top-left corner More...
 

Public Attributes

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

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, samples/dnn/object_detection.cpp, and samples/tapi/hog.cpp.

Member Typedef Documentation

◆ value_type

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

Constructor & Destructor Documentation

◆ Rect_() [1/5]

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

default constructor

◆ Rect_() [2/5]

template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( _Tp  _x,
_Tp  _y,
_Tp  _width,
_Tp  _height 
)

◆ Rect_() [3/5]

template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( const Rect_< _Tp > &  r)

◆ Rect_() [4/5]

template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( const Point_< _Tp > &  org,
const Size_< _Tp > &  sz 
)

◆ Rect_() [5/5]

template<typename _Tp>
cv::Rect_< _Tp >::Rect_ ( const Point_< _Tp > &  pt1,
const Point_< _Tp > &  pt2 
)

Member Function Documentation

◆ area()

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

area (width*height) of the rectangle

Examples:
samples/cpp/camshiftdemo.cpp.

◆ br()

template<typename _Tp>
Point_<_Tp> cv::Rect_< _Tp >::br ( ) const

the bottom-right corner

Examples:
samples/cpp/peopledetect.cpp, and samples/tapi/hog.cpp.

◆ contains()

template<typename _Tp>
bool cv::Rect_< _Tp >::contains ( const Point_< _Tp > &  pt) const

checks whether the rectangle contains the point

◆ empty()

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

true if empty

◆ operator Rect_< _Tp2 >()

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

conversion to another data type

◆ operator=()

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

◆ size()

template<typename _Tp>
Size_<_Tp> cv::Rect_< _Tp >::size ( ) const

size (width, height) of the rectangle

Examples:
samples/cpp/stitching_detailed.cpp.

◆ tl()

template<typename _Tp>
Point_<_Tp> cv::Rect_< _Tp >::tl ( ) const

Member Data Documentation

◆ height

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

◆ width

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

◆ x

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

◆ y

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

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