Imgproc_draw

クラス
class	cv::LineIterator
	Line iterator [詳解]

マクロ定義
#define	CV_RGB(r, g, b)   cv::Scalar((b), (g), (r), 0)

列挙型
enum	cv::LineTypes { FILLED = -1 , cv::LINE_4 = 4 , cv::LINE_8 = 8 , cv::LINE_AA = 16 }
enum	cv::HersheyFonts {   cv::FONT_HERSHEY_SIMPLEX = 0 , cv::FONT_HERSHEY_PLAIN = 1 , cv::FONT_HERSHEY_DUPLEX = 2 , cv::FONT_HERSHEY_COMPLEX = 3 ,   cv::FONT_HERSHEY_TRIPLEX = 4 , cv::FONT_HERSHEY_COMPLEX_SMALL = 5 , cv::FONT_HERSHEY_SCRIPT_SIMPLEX = 6 , cv::FONT_HERSHEY_SCRIPT_COMPLEX = 7 ,   cv::FONT_ITALIC = 16 }
enum	cv::MarkerTypes {   cv::MARKER_CROSS = 0 , cv::MARKER_TILTED_CROSS = 1 , cv::MARKER_STAR = 2 , cv::MARKER_DIAMOND = 3 ,   cv::MARKER_SQUARE = 4 , cv::MARKER_TRIANGLE_UP = 5 , cv::MARKER_TRIANGLE_DOWN = 6 }

関数
CV_EXPORTS_W void	cv::line (InputOutputArray img, Point pt1, Point pt2, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
	Draws a line segment connecting two points. [詳解]
CV_EXPORTS_W void	cv::arrowedLine (InputOutputArray img, Point pt1, Point pt2, const Scalar &color, int thickness=1, int line_type=8, int shift=0, double tipLength=0.1)
	Draws a arrow segment pointing from the first point to the second one. [詳解]
CV_EXPORTS_W void	cv::rectangle (InputOutputArray img, Point pt1, Point pt2, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
	Draws a simple, thick, or filled up-right rectangle. [詳解]
CV_EXPORTS_W void	cv::rectangle (InputOutputArray img, Rect rec, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
CV_EXPORTS_W void	cv::circle (InputOutputArray img, Point center, int radius, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
	Draws a circle. [詳解]
CV_EXPORTS_W void	cv::ellipse (InputOutputArray img, Point center, Size axes, double angle, double startAngle, double endAngle, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
	Draws a simple or thick elliptic arc or fills an ellipse sector. [詳解]
CV_EXPORTS_W void	cv::ellipse (InputOutputArray img, const RotatedRect &box, const Scalar &color, int thickness=1, int lineType=LINE_8)
CV_EXPORTS_W void	cv::drawMarker (InputOutputArray img, Point position, const Scalar &color, int markerType=MARKER_CROSS, int markerSize=20, int thickness=1, int line_type=8)
	Draws a marker on a predefined position in an image. [詳解]
CV_EXPORTS void	cv::fillConvexPoly (InputOutputArray img, const Point *pts, int npts, const Scalar &color, int lineType=LINE_8, int shift=0)
CV_EXPORTS_W void	cv::fillConvexPoly (InputOutputArray img, InputArray points, const Scalar &color, int lineType=LINE_8, int shift=0)
	Fills a convex polygon. [詳解]
CV_EXPORTS void	cv::fillPoly (InputOutputArray img, const Point **pts, const int *npts, int ncontours, const Scalar &color, int lineType=LINE_8, int shift=0, Point offset=Point())
CV_EXPORTS_W void	cv::fillPoly (InputOutputArray img, InputArrayOfArrays pts, const Scalar &color, int lineType=LINE_8, int shift=0, Point offset=Point())
	Fills the area bounded by one or more polygons. [詳解]
CV_EXPORTS void	cv::polylines (InputOutputArray img, const Point *const *pts, const int *npts, int ncontours, bool isClosed, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
CV_EXPORTS_W void	cv::polylines (InputOutputArray img, InputArrayOfArrays pts, bool isClosed, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0)
	Draws several polygonal curves. [詳解]
CV_EXPORTS_W void	cv::drawContours (InputOutputArray image, InputArrayOfArrays contours, int contourIdx, const Scalar &color, int thickness=1, int lineType=LINE_8, InputArray hierarchy=noArray(), int maxLevel=INT_MAX, Point offset=Point())
	Draws contours outlines or filled contours. [詳解]
CV_EXPORTS bool	cv::clipLine (Size imgSize, CV_IN_OUT Point &pt1, CV_IN_OUT Point &pt2)
	Clips the line against the image rectangle. [詳解]
CV_EXPORTS bool	cv::clipLine (Size2l imgSize, CV_IN_OUT Point2l &pt1, CV_IN_OUT Point2l &pt2)
CV_EXPORTS_W bool	cv::clipLine (Rect imgRect, CV_OUT CV_IN_OUT Point &pt1, CV_OUT CV_IN_OUT Point &pt2)
CV_EXPORTS_W void	cv::ellipse2Poly (Point center, Size axes, int angle, int arcStart, int arcEnd, int delta, CV_OUT std::vector< Point > &pts)
	Approximates an elliptic arc with a polyline. [詳解]
CV_EXPORTS void	cv::ellipse2Poly (Point2d center, Size2d axes, int angle, int arcStart, int arcEnd, int delta, CV_OUT std::vector< Point2d > &pts)
CV_EXPORTS_W void	cv::putText (InputOutputArray img, const String &text, Point org, int fontFace, double fontScale, Scalar color, int thickness=1, int lineType=LINE_8, bool bottomLeftOrigin=false)
	Draws a text string. [詳解]
CV_EXPORTS_W Size	cv::getTextSize (const String &text, int fontFace, double fontScale, int thickness, CV_OUT int *baseLine)
	Calculates the width and height of a text string. [詳解]
CV_EXPORTS_W double	cv::getFontScaleFromHeight (const int fontFace, const int pixelHeight, const int thickness=1)
	Calculates the font-specific size to use to achieve a given height in pixels. [詳解]

詳解

マクロ定義詳解

CV_RGB

#define CV_RGB	(		r,
			g,
			b
	)		cv::Scalar((b), (g), (r), 0)

OpenCV color channel order is BGR[A]

列挙型詳解

HersheyFonts

enum cv::HersheyFonts

Only a subset of Hershey fonts https://en.wikipedia.org/wiki/Hershey_fonts are supported

列挙値
FONT_HERSHEY_SIMPLEX	normal size sans-serif font
FONT_HERSHEY_PLAIN	small size sans-serif font
FONT_HERSHEY_DUPLEX	normal size sans-serif font (more complex than FONT_HERSHEY_SIMPLEX)
FONT_HERSHEY_COMPLEX	normal size serif font
FONT_HERSHEY_TRIPLEX	normal size serif font (more complex than FONT_HERSHEY_COMPLEX)
FONT_HERSHEY_COMPLEX_SMALL	smaller version of FONT_HERSHEY_COMPLEX
FONT_HERSHEY_SCRIPT_SIMPLEX	hand-writing style font
FONT_HERSHEY_SCRIPT_COMPLEX	more complex variant of FONT_HERSHEY_SCRIPT_SIMPLEX
FONT_ITALIC	flag for italic font

LineTypes

enum cv::LineTypes

types of line

列挙値
LINE_4	4-connected line
LINE_8	8-connected line
LINE_AA	antialiased line

MarkerTypes

enum cv::MarkerTypes

Possible set of marker types used for the cv::drawMarker function

列挙値
MARKER_CROSS	A crosshair marker shape
MARKER_TILTED_CROSS	A 45 degree tilted crosshair marker shape
MARKER_STAR	A star marker shape, combination of cross and tilted cross
MARKER_DIAMOND	A diamond marker shape
MARKER_SQUARE	A square marker shape
MARKER_TRIANGLE_UP	An upwards pointing triangle marker shape
MARKER_TRIANGLE_DOWN	A downwards pointing triangle marker shape

関数詳解

arrowedLine()

CV_EXPORTS_W void cv::arrowedLine	(	InputOutputArray	img,
		Point	pt1,
		Point	pt2,
		const Scalar &	color,
		int	thickness = 1,
		int	line_type = 8,
		int	shift = 0,
		double	tipLength = 0.1
	)

Draws a arrow segment pointing from the first point to the second one.

The function cv::arrowedLine draws an arrow between pt1 and pt2 points in the image. See also line.

引数

img	Image.
pt1	The point the arrow starts from.
pt2	The point the arrow points to.
color	Line color.
thickness	Line thickness.
line_type	Type of the line. See LineTypes
shift	Number of fractional bits in the point coordinates.
tipLength	The length of the arrow tip in relation to the arrow length

circle()

CV_EXPORTS_W void cv::circle	(	InputOutputArray	img,
		Point	center,
		int	radius,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

Draws a circle.

The function cv::circle draws a simple or filled circle with a given center and radius.

引数

img	Image where the circle is drawn.
center	Center of the circle.
radius	Radius of the circle.
color	Circle color.
thickness	Thickness of the circle outline, if positive. Negative values, like #FILLED, mean that a filled circle is to be drawn.
lineType	Type of the circle boundary. See LineTypes
shift	Number of fractional bits in the coordinates of the center and in the radius value.

clipLine() [1/3]

CV_EXPORTS_W bool cv::clipLine	(	Rect	imgRect,
		CV_OUT CV_IN_OUT Point &	pt1,
		CV_OUT CV_IN_OUT Point &	pt2
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

引数

imgRect	Image rectangle.
pt1	First line point.
pt2	Second line point.

clipLine() [2/3]

CV_EXPORTS bool cv::clipLine	(	Size	imgSize,
		CV_IN_OUT Point &	pt1,
		CV_IN_OUT Point &	pt2
	)

Clips the line against the image rectangle.

The function cv::clipLine calculates a part of the line segment that is entirely within the specified rectangle. it returns false if the line segment is completely outside the rectangle. Otherwise, it returns true .

引数

imgSize	Image size. The image rectangle is Rect(0, 0, imgSize.width, imgSize.height) .
pt1	First line point.
pt2	Second line point.

clipLine() [3/3]

CV_EXPORTS bool cv::clipLine	(	Size2l	imgSize,
		CV_IN_OUT Point2l &	pt1,
		CV_IN_OUT Point2l &	pt2
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

引数

imgSize	Image size. The image rectangle is Rect(0, 0, imgSize.width, imgSize.height) .
pt1	First line point.
pt2	Second line point.

drawContours()

CV_EXPORTS_W void cv::drawContours	(	InputOutputArray	image,
		InputArrayOfArrays	contours,
		int	contourIdx,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		InputArray	hierarchy = noArray(),
		int	maxLevel = INT_MAX,
		Point	offset = Point()
	)

Draws contours outlines or filled contours.

The function draws contour outlines in the image if or fills the area bounded by the contours if . The example below shows how to retrieve connected components from the binary image and label them: :

引数

image	Destination image.
contours	All the input contours. Each contour is stored as a point vector.
contourIdx	Parameter indicating a contour to draw. If it is negative, all the contours are drawn.
color	Color of the contours.
thickness	Thickness of lines the contours are drawn with. If it is negative (for example, thickness=#FILLED ), the contour interiors are drawn.
lineType	Line connectivity. See LineTypes
hierarchy	Optional information about hierarchy. It is only needed if you want to draw only some of the contours (see maxLevel ).
maxLevel	Maximal level for drawn contours. If it is 0, only the specified contour is drawn. If it is 1, the function draws the contour(s) and all the nested contours. If it is 2, the function draws the contours, all the nested contours, all the nested-to-nested contours, and so on. This parameter is only taken into account when there is hierarchy available.
offset	Optional contour shift parameter. Shift all the drawn contours by the specified .

覚え書き

When thickness=#FILLED, the function is designed to handle connected components with holes correctly even when no hierarchy date is provided. This is done by analyzing all the outlines together using even-odd rule. This may give incorrect results if you have a joint collection of separately retrieved contours. In order to solve this problem, you need to call drawContours separately for each sub-group of contours, or iterate over the collection using contourIdx parameter.

drawMarker()

CV_EXPORTS_W void cv::drawMarker	(	InputOutputArray	img,
		Point	position,
		const Scalar &	color,
		int	markerType = MARKER_CROSS,
		int	markerSize = 20,
		int	thickness = 1,
		int	line_type = 8
	)

Draws a marker on a predefined position in an image.

The function cv::drawMarker draws a marker on a given position in the image. For the moment several marker types are supported, see MarkerTypes for more information.

引数

img	Image.
position	The point where the crosshair is positioned.
color	Line color.
markerType	The specific type of marker you want to use, see MarkerTypes
thickness	Line thickness.
line_type	Type of the line, See LineTypes
markerSize	The length of the marker axis [default = 20 pixels]

ellipse() [1/2]

CV_EXPORTS_W void cv::ellipse	(	InputOutputArray	img,
		const RotatedRect &	box,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

引数

img	Image.
box	Alternative ellipse representation via RotatedRect. This means that the function draws an ellipse inscribed in the rotated rectangle.
color	Ellipse color.
thickness	Thickness of the ellipse arc outline, if positive. Otherwise, this indicates that a filled ellipse sector is to be drawn.
lineType	Type of the ellipse boundary. See LineTypes

ellipse() [2/2]

CV_EXPORTS_W void cv::ellipse	(	InputOutputArray	img,
		Point	center,
		Size	axes,
		double	angle,
		double	startAngle,
		double	endAngle,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

Draws a simple or thick elliptic arc or fills an ellipse sector.

The function cv::ellipse with more parameters draws an ellipse outline, a filled ellipse, an elliptic arc, or a filled ellipse sector. The drawing code uses general parametric form. A piecewise-linear curve is used to approximate the elliptic arc boundary. If you need more control of the ellipse rendering, you can retrieve the curve using ellipse2Poly and then render it with polylines or fill it with fillPoly. If you use the first variant of the function and want to draw the whole ellipse, not an arc, pass startAngle=0 and endAngle=360. If startAngle is greater than endAngle, they are swapped. The figure below explains the meaning of the parameters to draw the blue arc.

引数

img	Image.
center	Center of the ellipse.
axes	Half of the size of the ellipse main axes.
angle	Ellipse rotation angle in degrees.
startAngle	Starting angle of the elliptic arc in degrees.
endAngle	Ending angle of the elliptic arc in degrees.
color	Ellipse color.
thickness	Thickness of the ellipse arc outline, if positive. Otherwise, this indicates that a filled ellipse sector is to be drawn.
lineType	Type of the ellipse boundary. See LineTypes
shift	Number of fractional bits in the coordinates of the center and values of axes.

ellipse2Poly() [1/2]

CV_EXPORTS_W void cv::ellipse2Poly	(	Point	center,
		Size	axes,
		int	angle,
		int	arcStart,
		int	arcEnd,
		int	delta,
		CV_OUT std::vector< Point > &	pts
	)

Approximates an elliptic arc with a polyline.

The function ellipse2Poly computes the vertices of a polyline that approximates the specified elliptic arc. It is used by ellipse. If arcStart is greater than arcEnd, they are swapped.

引数

center	Center of the arc.
axes	Half of the size of the ellipse main axes. See ellipse for details.
angle	Rotation angle of the ellipse in degrees. See ellipse for details.
arcStart	Starting angle of the elliptic arc in degrees.
arcEnd	Ending angle of the elliptic arc in degrees.
delta	Angle between the subsequent polyline vertices. It defines the approximation accuracy.
pts	Output vector of polyline vertices.

ellipse2Poly() [2/2]

CV_EXPORTS void cv::ellipse2Poly	(	Point2d	center,
		Size2d	axes,
		int	angle,
		int	arcStart,
		int	arcEnd,
		int	delta,
		CV_OUT std::vector< Point2d > &	pts
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

引数

center	Center of the arc.
axes	Half of the size of the ellipse main axes. See ellipse for details.
angle	Rotation angle of the ellipse in degrees. See ellipse for details.
arcStart	Starting angle of the elliptic arc in degrees.
arcEnd	Ending angle of the elliptic arc in degrees.
delta	Angle between the subsequent polyline vertices. It defines the approximation accuracy.
pts	Output vector of polyline vertices.

fillConvexPoly() [1/2]

CV_EXPORTS void cv::fillConvexPoly	(	InputOutputArray	img,
		const Point *	pts,
		int	npts,
		const Scalar &	color,
		int	lineType = LINE_8,
		int	shift = 0
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

fillConvexPoly() [2/2]

CV_EXPORTS_W void cv::fillConvexPoly	(	InputOutputArray	img,
		InputArray	points,
		const Scalar &	color,
		int	lineType = LINE_8,
		int	shift = 0
	)

Fills a convex polygon.

The function cv::fillConvexPoly draws a filled convex polygon. This function is much faster than the function fillPoly . It can fill not only convex polygons but any monotonic polygon without self-intersections, that is, a polygon whose contour intersects every horizontal line (scan line) twice at the most (though, its top-most and/or the bottom edge could be horizontal).

引数

img	Image.
points	Polygon vertices.
color	Polygon color.
lineType	Type of the polygon boundaries. See LineTypes
shift	Number of fractional bits in the vertex coordinates.

fillPoly() [1/2]

CV_EXPORTS void cv::fillPoly	(	InputOutputArray	img,
		const Point **	pts,
		const int *	npts,
		int	ncontours,
		const Scalar &	color,
		int	lineType = LINE_8,
		int	shift = 0,
		Point	offset = Point()
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

fillPoly() [2/2]

CV_EXPORTS_W void cv::fillPoly	(	InputOutputArray	img,
		InputArrayOfArrays	pts,
		const Scalar &	color,
		int	lineType = LINE_8,
		int	shift = 0,
		Point	offset = Point()
	)

Fills the area bounded by one or more polygons.

The function cv::fillPoly fills an area bounded by several polygonal contours. The function can fill complex areas, for example, areas with holes, contours with self-intersections (some of their parts), and so forth.

引数

img	Image.
pts	Array of polygons where each polygon is represented as an array of points.
color	Polygon color.
lineType	Type of the polygon boundaries. See LineTypes
shift	Number of fractional bits in the vertex coordinates.
offset	Optional offset of all points of the contours.

getFontScaleFromHeight()

CV_EXPORTS_W double cv::getFontScaleFromHeight	(	const int	fontFace,
		const int	pixelHeight,
		const int	thickness = 1
	)

Calculates the font-specific size to use to achieve a given height in pixels.

引数

fontFace	Font to use, see cv::HersheyFonts.
pixelHeight	Pixel height to compute the fontScale for
thickness	Thickness of lines used to render the text.See putText for details.

戻り値

The fontSize to use for cv::putText

参照

cv::putText

getTextSize()

CV_EXPORTS_W Size cv::getTextSize	(	const String &	text,
		int	fontFace,
		double	fontScale,
		int	thickness,
		CV_OUT int *	baseLine
	)

Calculates the width and height of a text string.

The function cv::getTextSize calculates and returns the size of a box that contains the specified text. That is, the following code renders some text, the tight box surrounding it, and the baseline: :

String text = "Funny text inside the box";
int fontFace = FONT_HERSHEY_SCRIPT_SIMPLEX;
double fontScale = 2;
int thickness = 3;
 
Mat img(600, 800, CV_8UC3, Scalar::all(0));
 
int baseline=0;
Size textSize = getTextSize(text, fontFace,
                            fontScale, thickness, &baseline);
baseline += thickness;
 
// center the text
Point textOrg((img.cols - textSize.width)/2,
              (img.rows + textSize.height)/2);
 
// draw the box
rectangle(img, textOrg + Point(0, baseline),
          textOrg + Point(textSize.width, -textSize.height),
          Scalar(0,0,255));
// ... and the baseline first
line(img, textOrg + Point(0, thickness),
     textOrg + Point(textSize.width, thickness),
     Scalar(0, 0, 255));
 
// then put the text itself
putText(img, text, textOrg, fontFace, fontScale,
        Scalar::all(255), thickness, 8);

引数

	text	Input text string.
	fontFace	Font to use, see HersheyFonts.
	fontScale	Font scale factor that is multiplied by the font-specific base size.
	thickness	Thickness of lines used to render the text. See putText for details.
[out]	baseLine	y-coordinate of the baseline relative to the bottom-most text point.

戻り値

The size of a box that contains the specified text.

参照

putText

line()

CV_EXPORTS_W void cv::line	(	InputOutputArray	img,
		Point	pt1,
		Point	pt2,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

Draws a line segment connecting two points.

The function line draws the line segment between pt1 and pt2 points in the image. The line is clipped by the image boundaries. For non-antialiased lines with integer coordinates, the 8-connected or 4-connected Bresenham algorithm is used. Thick lines are drawn with rounding endings. Antialiased lines are drawn using Gaussian filtering.

引数

img	Image.
pt1	First point of the line segment.
pt2	Second point of the line segment.
color	Line color.
thickness	Line thickness.
lineType	Type of the line. See LineTypes.
shift	Number of fractional bits in the point coordinates.

polylines() [1/2]

CV_EXPORTS void cv::polylines	(	InputOutputArray	img,
		const Point *const *	pts,
		const int *	npts,
		int	ncontours,
		bool	isClosed,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

polylines() [2/2]

CV_EXPORTS_W void cv::polylines	(	InputOutputArray	img,
		InputArrayOfArrays	pts,
		bool	isClosed,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

Draws several polygonal curves.

引数

img	Image.
pts	Array of polygonal curves.
isClosed	Flag indicating whether the drawn polylines are closed or not. If they are closed, the function draws a line from the last vertex of each curve to its first vertex.
color	Polyline color.
thickness	Thickness of the polyline edges.
lineType	Type of the line segments. See LineTypes
shift	Number of fractional bits in the vertex coordinates.

The function cv::polylines draws one or more polygonal curves.

putText()

CV_EXPORTS_W void cv::putText	(	InputOutputArray	img,
		const String &	text,
		Point	org,
		int	fontFace,
		double	fontScale,
		Scalar	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		bool	bottomLeftOrigin = false
	)

Draws a text string.

The function cv::putText renders the specified text string in the image. Symbols that cannot be rendered using the specified font are replaced by question marks. See getTextSize for a text rendering code example.

引数

img	Image.
text	Text string to be drawn.
org	Bottom-left corner of the text string in the image.
fontFace	Font type, see HersheyFonts.
fontScale	Font scale factor that is multiplied by the font-specific base size.
color	Text color.
thickness	Thickness of the lines used to draw a text.
lineType	Line type. See LineTypes
bottomLeftOrigin	When true, the image data origin is at the bottom-left corner. Otherwise, it is at the top-left corner.

rectangle() [1/2]

CV_EXPORTS_W void cv::rectangle	(	InputOutputArray	img,
		Point	pt1,
		Point	pt2,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

Draws a simple, thick, or filled up-right rectangle.

The function cv::rectangle draws a rectangle outline or a filled rectangle whose two opposite corners are pt1 and pt2.

引数

img	Image.
pt1	Vertex of the rectangle.
pt2	Vertex of the rectangle opposite to pt1 .
color	Rectangle color or brightness (grayscale image).
thickness	Thickness of lines that make up the rectangle. Negative values, like #FILLED, mean that the function has to draw a filled rectangle.
lineType	Type of the line. See LineTypes
shift	Number of fractional bits in the point coordinates.

rectangle() [2/2]

CV_EXPORTS_W void cv::rectangle	(	InputOutputArray	img,
		Rect	rec,
		const Scalar &	color,
		int	thickness = 1,
		int	lineType = LINE_8,
		int	shift = 0
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

use rec parameter as alternative specification of the drawn rectangle: r.tl() and r.br()-Point(1,1) are opposite corners