Classes | |
class | cv::LineIterator |
Class for iterating over all pixels on a raster line segment. More... | |
Macros | |
#define | CV_RGB(r, g, b) cv::Scalar((b), (g), (r), 0) |
Enumerations | |
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::LineTypes { cv::FILLED = -1 , cv::LINE_4 = 4 , cv::LINE_8 = 8 , cv::LINE_AA = 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 } |
Functions | |
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 an arrow segment pointing from the first point to the second one. | |
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. | |
bool | cv::clipLine (Rect imgRect, Point &pt1, Point &pt2) |
bool | cv::clipLine (Size imgSize, Point &pt1, Point &pt2) |
Clips the line against the image rectangle. | |
bool | cv::clipLine (Size2l imgSize, Point2l &pt1, Point2l &pt2) |
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. | |
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. | |
void | cv::ellipse (InputOutputArray img, const RotatedRect &box, const Scalar &color, int thickness=1, int lineType=LINE_8) |
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. | |
void | cv::ellipse2Poly (Point center, Size axes, int angle, int arcStart, int arcEnd, int delta, std::vector< Point > &pts) |
Approximates an elliptic arc with a polyline. | |
void | cv::ellipse2Poly (Point2d center, Size2d axes, int angle, int arcStart, int arcEnd, int delta, std::vector< Point2d > &pts) |
void | cv::fillConvexPoly (InputOutputArray img, const Point *pts, int npts, const Scalar &color, int lineType=LINE_8, int shift=0) |
void | cv::fillConvexPoly (InputOutputArray img, InputArray points, const Scalar &color, int lineType=LINE_8, int shift=0) |
Fills a convex polygon. | |
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()) |
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. | |
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. | |
Size | cv::getTextSize (const String &text, int fontFace, double fontScale, int thickness, int *baseLine) |
Calculates the width and height of a text string. | |
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. | |
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) |
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. | |
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. | |
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. | |
void | cv::rectangle (InputOutputArray img, Rect rec, const Scalar &color, int thickness=1, int lineType=LINE_8, int shift=0) |
Detailed Description
Macro Definition Documentation
◆ CV_RGB
#define CV_RGB | ( | r, | |
g, | |||
b | |||
) | cv::Scalar((b), (g), (r), 0) |
#include <opencv2/imgproc.hpp>
OpenCV color channel order is BGR[A]
Enumeration Type Documentation
◆ HersheyFonts
enum cv::HersheyFonts |
#include <opencv2/imgproc.hpp>
Only a subset of Hershey fonts https://en.wikipedia.org/wiki/Hershey_fonts are supported
◆ LineTypes
enum cv::LineTypes |
#include <opencv2/imgproc.hpp>
types of line
Enumerator | |
---|---|
FILLED | |
LINE_4 | 4-connected line |
LINE_8 | 8-connected line |
LINE_AA | antialiased line |
◆ MarkerTypes
enum cv::MarkerTypes |
#include <opencv2/imgproc.hpp>
Possible set of marker types used for the cv::drawMarker function
Function Documentation
◆ arrowedLine()
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 |
||
) |
#include <opencv2/imgproc.hpp>
Draws an 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.
- Parameters
-
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()
void cv::circle | ( | InputOutputArray | img, |
Point | center, | ||
int | radius, | ||
const Scalar & | color, | ||
int | thickness = 1 , |
||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
Draws a circle.
The function cv::circle draws a simple or filled circle with a given center and radius.
- Parameters
-
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]
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
- Parameters
-
imgRect Image rectangle. pt1 First line point. pt2 Second line point.
◆ clipLine() [2/3]
#include <opencv2/imgproc.hpp>
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 .
- Parameters
-
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]
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
- Parameters
-
imgSize Image size. The image rectangle is Rect(0, 0, imgSize.width, imgSize.height) . pt1 First line point. pt2 Second line point.
◆ drawContours()
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() |
||
) |
#include <opencv2/imgproc.hpp>
Draws contours outlines or filled contours.
The function draws contour outlines in the image if \(\texttt{thickness} \ge 0\) or fills the area bounded by the contours if \(\texttt{thickness}<0\) . The example below shows how to retrieve connected components from the binary image and label them: :
- Parameters
-
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 \(\texttt{offset}=(dx,dy)\) .
- Note
- When thickness=FILLED, the function is designed to handle connected components with holes correctly even when no hierarchy data 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()
void cv::drawMarker | ( | InputOutputArray | img, |
Point | position, | ||
const Scalar & | color, | ||
int | markerType = MARKER_CROSS , |
||
int | markerSize = 20 , |
||
int | thickness = 1 , |
||
int | line_type = 8 |
||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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]
void cv::ellipse | ( | InputOutputArray | img, |
const RotatedRect & | box, | ||
const Scalar & | color, | ||
int | thickness = 1 , |
||
int | lineType = LINE_8 |
||
) |
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
- Parameters
-
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]
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 |
||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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]
void cv::ellipse2Poly | ( | Point | center, |
Size | axes, | ||
int | angle, | ||
int | arcStart, | ||
int | arcEnd, | ||
int | delta, | ||
std::vector< Point > & | pts | ||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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]
void cv::ellipse2Poly | ( | Point2d | center, |
Size2d | axes, | ||
int | angle, | ||
int | arcStart, | ||
int | arcEnd, | ||
int | delta, | ||
std::vector< Point2d > & | pts | ||
) |
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
- Parameters
-
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]
void cv::fillConvexPoly | ( | InputOutputArray | img, |
const Point * | pts, | ||
int | npts, | ||
const Scalar & | color, | ||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
◆ fillConvexPoly() [2/2]
void cv::fillConvexPoly | ( | InputOutputArray | img, |
InputArray | points, | ||
const Scalar & | color, | ||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
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).
- Parameters
-
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]
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() |
||
) |
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
◆ fillPoly() [2/2]
void cv::fillPoly | ( | InputOutputArray | img, |
InputArrayOfArrays | pts, | ||
const Scalar & | color, | ||
int | lineType = LINE_8 , |
||
int | shift = 0 , |
||
Point | offset = Point() |
||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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()
double cv::getFontScaleFromHeight | ( | const int | fontFace, |
const int | pixelHeight, | ||
const int | thickness = 1 |
||
) |
#include <opencv2/imgproc.hpp>
Calculates the font-specific size to use to achieve a given height in pixels.
- Parameters
-
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.
- Returns
- The fontSize to use for cv::putText
- See also
- cv::putText
◆ getTextSize()
Size cv::getTextSize | ( | const String & | text, |
int | fontFace, | ||
double | fontScale, | ||
int | thickness, | ||
int * | baseLine | ||
) |
#include <opencv2/imgproc.hpp>
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: :
- Parameters
-
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.
- Returns
- The size of a box that contains the specified text.
- See also
- putText
◆ line()
void cv::line | ( | InputOutputArray | img, |
Point | pt1, | ||
Point | pt2, | ||
const Scalar & | color, | ||
int | thickness = 1 , |
||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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]
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 |
||
) |
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
◆ polylines() [2/2]
void cv::polylines | ( | InputOutputArray | img, |
InputArrayOfArrays | pts, | ||
bool | isClosed, | ||
const Scalar & | color, | ||
int | thickness = 1 , |
||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
Draws several polygonal curves.
- Parameters
-
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()
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 |
||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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.
- Examples
- samples/cpp/fitellipse.cpp.
◆ rectangle() [1/2]
void cv::rectangle | ( | InputOutputArray | img, |
Point | pt1, | ||
Point | pt2, | ||
const Scalar & | color, | ||
int | thickness = 1 , |
||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
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.
- Parameters
-
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]
void cv::rectangle | ( | InputOutputArray | img, |
Rect | rec, | ||
const Scalar & | color, | ||
int | thickness = 1 , |
||
int | lineType = LINE_8 , |
||
int | shift = 0 |
||
) |
#include <opencv2/imgproc.hpp>
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
use rec
parameter as alternative specification of the drawn rectangle: r.tl() and r.br()-Point(1,1)
are opposite corners