繪圖(line、rectangle、circle、ellipse、polylines、putText)

OpenCV有函式方便我們繪圖，這邊依序介紹如何繪製線、矩形、圓、橢圓、多角形、文字在影像上，其他圖形請參考OpenCV文件。

內文索引 [隱藏]
1 連通類型
2 OpenCV 畫線
3 OpenCV 畫矩形
4 OpenCV 畫圓
5 OpenCV 畫橢圓
6 OpenCV 畫多角形
7 OpenCV 畫文字字串
8 程式碼

連通類型

連通類型有兩種，不同的連通型態會影響圖案的邊界部分：
4-連通(4-connectivity)：座標(x,y)處的像素 P，其上下左右各有一個鄰近點，其座標分別為：(x+1, y)､(x-1,y)､(x, y+1)､(x, y-1)，這樣一組像素稱為P的4近鄰，用 N4(P)表示。
8-連通(8-connectivity)：如果除了上式N4(P)的點，加上四個對角鄰近點，(x+1,y+1)､(x+1,y-1)､(x-1,y+1)､(x-1,y-1))加在一起，則稱這八個點為P的8近鄰，用N8(P)表示。

OpenCV 畫線

void line(Mat& img, Point pt1, Point pt2, const Scalar& color, int thickness=1, int lineType=8, int shift=0)
img：輸入圖，線會畫在上面。
pt1：線的起點。
pt2：線的終點。
color：線的顏色。
thickness：線的厚度。
lineType：通道型態，可輸入8、4、CV_AA： 8->8通道連結。 4->4通道連結。 CV_AA->消除鋸齒(antialiased line)，消除顯示器畫面線邊緣的凹凸鋸齒。

OpenCV 畫矩形

void rectangle(Mat& img, Point pt1, Point pt2, const Scalar& color, int thickness=1, int lineType=8, int shift=0)
img：輸入圖，矩形會畫在上面。
pt1：矩形頂點。
pt2：矩形頂點，pt1的對角邊
color：矩形的顏色。
thickness：矩形的邊線寬度，輸入負值或CV_FILLED代表填滿矩形。
lineType：通道型態，可輸入8、4、CV_AA： 8->8通道連結。 4->4通道連結。 CV_AA->消除鋸齒(antialiased line)，消除顯示器畫面線邊緣的凹凸鋸齒。

OpenCV 畫圓

void circle(Mat& img, Point center, int radius, const Scalar& color, int thickness=1, int lineType=8, int shift=0)
img：輸入圖，圓會畫在上面。
center：圓心。
radius：圓半徑。
color：圓形的顏色。
thickness：圓形的邊線寬度，輸入負值或CV_FILLED代表填滿圓形。
lineType：通道型態，可輸入8、4、CV_AA： 8->8通道連結。 4->4通道連結。 CV_AA->消除鋸齒(antialiased line)，消除顯示器畫面線邊緣的凹凸鋸齒。

OpenCV 畫橢圓

void ellipse(Mat& img, Point center, Size axes, double angle, double startAngle, double endAngle, const Scalar& color, int thickness=1, int lineType=8, int shift=0)
img：輸入圖，橢圓會畫在上面。
center：圓心。
axes：橢圓軸的尺寸。
angle：旋轉角度，單位角度。
startAngle：橢圓弧度起始角度，單位角度。
endAngle：橢圓弧度結束角度，單位角度。
color：橢圓的顏色。
thickness：橢圓的邊線寬度，輸入負值或CV_FILLED代表填滿橢圓形 。
lineType：通道型態，可輸入8、4、CV_AA： 8->8通道連結。 4->4通道連結。 CV_AA->消除鋸齒(antialiased line)，消除顯示器畫面線邊緣的凹凸鋸齒。

OpenCV 畫多角形

void polylines(Mat& img, const Point** pts, const int* npts, int ncontours, bool isClosed, const Scalar& color, int thickness=1, intlineType=8, int shift=0)
img：輸入圖，多角形會畫在上面。
pts：包含多角形各個曲線點的陣列。
npts：包含多角形各曲線頂點數目的陣列。
ncontours：曲線數。
isClosed：是否為封閉的多角形。
color：多角形的顏色。
thickness：多角形的邊線寬度，輸入負值或CV_FILLED代表填滿多角形。
lineType：通道型態，可輸入8、4、CV_AA： 8->8通道連結。 4->4通道連結。 CV_AA->消除鋸齒(antialiased line)，消除顯示器畫面線邊緣的凹凸鋸齒。

OpenCV 畫文字字串

void putText(Mat& img, const string& text, Point org, int fontFace, double fontScale, Scalar color, int thickness=1, int lineType=8, bool bottomLeftOrigin=false)
img：輸入圖，字串會畫在上面。
text：輸出字串，OpenCV目前沒有支援中文文字顯現。
org：文字左下角位置。
fontFace：字體樣式。
fontScale：字體大小。
color：字串顏色。
thickness：構成字串的線寬度。
lineType：通道型態，有以下三種可選： 8：8通道連結。 4：4通道連結。 CV_AA：消除鋸齒(antialiased line)，消除顯示器畫面橢圓邊緣的凹凸鋸齒。

程式碼

以下程式碼實際繪製線、矩形、圓、橢圓、多角形、文字在影像上：

#include <cstdio>
#include <opencv2/opencv.hpp>
using namespace cv;

int main(){
Mat img(400, 400, CV_8UC3, Scalar(255,255,255));
line(img, Point(20,40), Point(120,140), Scalar(255,0,0), 3);
rectangle(img, Point(150,40), Point(250,140), Scalar(0,0,255), -1);
circle(img, Point(330,90), 50, Scalar(0,255,0), -1);
ellipse(img, Point(80,280), Size(60,40), 45, 0, 360, Scalar(255,255,0), 2);

Point points[1][5];
points[0][0] = Point(150, 270);
points[0][1] = Point(190, 220);
points[0][2] = Point(260, 255);
points[0][3] = Point(224, 296);
points[0][4] = Point(178, 316);
const Point* ppt[1] = {points[0]};
int npt[] = {5};
polylines(img, ppt, npt, 1, 1, Scalar(0,255,255),5);

putText(img, string("OpenCV"), Point(280,280), 0, 1, Scalar(0,0,0),3);

imshow("window", img);
waitKey(0);

return 0;
}