一、函数原型:
CV_EXPORTS_W void 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);
二、函数作用:
ellipse
函数可以绘制椭圆的轮廓、填充整个椭圆、绘制椭圆弧或填充椭圆扇区。
三、参数:
InputOutputArray img
:要在其上绘制椭圆的图像,可以是cv::Mat
类型,支持输入输出。Point center
:椭圆的中心点坐标。Size axes
:椭圆主轴的一半长度,即椭圆的半径尺寸。double angle
:椭圆的旋转角度,以度为单位。double startAngle
:椭圆弧的起始角度,以度为单位。double endAngle
:椭圆弧的结束角度,以度为单位。const Scalar& color
:椭圆的颜色,使用 OpenCV 的Scalar
类型定义。int thickness
:椭圆弧线的粗细。如果为正数,表示绘制椭圆轮廓的厚度;如果为负数或cv::FILLED
,则表示绘制填充的椭圆扇区。int lineType
:椭圆边界的类型,定义了线条的绘制方式,如LINE_4
、LINE_8
或LINE_AA
(抗锯齿线),默认值为LINE_8
。int shift
:中心坐标和轴尺寸中小数位数的数量,用于指定坐标点的小数位数,通常用于子像素精度的绘制。
四、功能说明:
- 使用参数化的一般形式绘制椭圆,采用分段线性曲线近似椭圆弧的边界。
- 如果需要更精细地控制椭圆的渲染,可以使用
ellipse2Poly
函数检索椭圆的曲线,然后使用polylines
或fillPoly
进行渲染或填充。 - 如果使用函数的第一个变体并希望绘制整个椭圆而非椭圆弧,可以传递
startAngle=0
和endAngle=360
。 - 如果
startAngle
大于endAngle
,它们将被交换。
五、应用场景:
ellipse
函数常用于图像处理和计算机视觉中的基本绘图操作,如在图像上标记特定区域、创建图形界面元素或进行视觉分析。
六、代码示例:
#include <opencv2/core/utils/logger.hpp>
#include <opencv2/opencv.hpp>
#include <opencv2/videoio.hpp>
#include <opencv2/objdetect.hpp>
#include <opencv2/highgui/highgui_c.h>
#include <iostream>
using namespace cv;
using namespace std;
//8-绘制圆形图片
int main()
{
utils::logging::setLogLevel(utils::logging::LOG_LEVEL_SILENT);
// 创建白色背景的图像
Mat image(500, 500, CV_8UC3, cv::Scalar(255, 255, 255));
Point center(250, 250); // 定义椭圆的中心点
Size axes(100,80); // 定义椭圆的半径尺寸
// 绘制蓝色填充的椭圆扇区
ellipse(image, center, axes, 0, 0, 360, cv::Scalar(255, 0,0 ), LINE_AA);
namedWindow("image", CV_WINDOW_AUTOSIZE | CV_WINDOW_FREERATIO);
imshow("image", image);
waitKey(5000);//显示5秒后关闭图片
destroyAllWindows();//关闭所有窗口
return 0;
}