85-OpenCVSharp —-Cv2.DrawMarker ()函数功能（用于在图像上绘制标记）详解

X-Vision

于 2025-01-27 10:52:30 发布

阅读量914

点赞数 19

CC 4.0 BY-SA版权

分类专栏：《OpenCV算子学习》文章标签：计算机视觉算法人工智能 c# opencv

本文链接：https://blog.youkuaiyun.com/weixin_45590420/article/details/145378142

《OpenCV算子学习》专栏收录该内容

114 篇文章

订阅专栏

专栏地址：

《 OpenCV功能使用详解200篇》

《 OpenCV算子使用详解300篇》

《 Halcon算子使用详解300篇》

内容持续更新，欢迎点击订阅

OpenCVSharp — `drawMarker` 函数分析

drawMarker 函数用于在图像上绘制标记（marker），常用于图像分析、调试以及在特定位置标记关键点。在计算机视觉中，标记可以帮助可视化定位信息，或者在特定的处理过程中标记出关键特征。

1. 核心原理加核心公式（深入剖析）

drawMarker 函数的核心原理是通过计算标记的几何形状，使用 OpenCV 中的绘图工具在图像上进行标记。这些标记可以是交叉、圆形、方形、十字形等几种几何形状。不同类型的标记是通过对几何形状的不同像素点进行赋值来实现的。绘制过程没有特定的数学公式，主要依赖于绘制不同形状的几何算法。

例如：

对于 MARKER_CROSS，它绘制的是一个交叉标记（由两条直线交叉组成）。
对于 MARKER_TILTED_CROSS，它绘制的是旋转的交叉形状（两条交叉线旋转一定角度）。

基本的绘制原理是：

选择一个给定的位置（position），然后通过计算标记的大小（markerSize）和形状（markerType），在该位置生成相应的几何图形。

2. 功能详解

drawMarker 函数的功能是将一个标记绘制在指定的图像位置。这个标记可以是不同类型的几何形状，用于图像的可视化处理，通常用于标记关键点、定位或调试。标记的类型、大小、颜色以及线条粗细等都可以由用户指定。

具体功能：

绘制多种形状：支持交叉、圆形、方形、十字等多种标记类型。
自定义属性：允许用户调整标记的大小、颜色、粗细等参数。
可视化：常用于图像处理中的调试阶段，可帮助观察图像处理的结果，比如特征点位置、检测到的目标等。

3. 参数详解（深入剖析）

img (InputOutputArray)：输入和输出图像，表示需要在其上绘制标记的图像。该参数是图像的矩阵类型（Mat），可以是任意尺寸的图像。函数将直接在此图像上绘制标记。
position (Point)：表示标记的中心位置。position 是一个二维坐标点，指定标记要绘制在图像中的哪个位置。该位置是标记的几何中心。
color (Scalar)：标记的颜色，使用 OpenCV 中的 Scalar 类型，通常是一个包含 RGB 颜色值的结构。可以传入任意有效颜色，如 Scalar(0, 0, 255) 表示红色。
markerType (int)：标记的类型，指定绘制标记的几何形状。常见的标记类型有：
- MARKER_CROSS: 交叉标记，由两条交叉的直线组成。
- MARKER_TILTED_CROSS: 旋转的交叉标记。
- MARKER_STAR: 星形标记。
- MARKER_DIAMOND: 菱形标记。
- MARKER_SQUARE: 方形标记。
- MARKER_CIRCLE: 圆形标记。
markerSize (int)：标记的大小，表示标记的尺寸。markerSize 决定了标记的几何尺寸，它影响到标记绘制时的宽度或半径。具体效果依赖于 markerType。
thickness (int)：标记的线条厚度，表示绘制标记时所用的线条的粗细。thickness 越大，标记的边缘会越粗。
line_type (int)：线条的类型，表示标记的边缘线条类型。常用的类型有：
- 8：8邻域连接，表示标准的线条连接。
- 4：4邻域连接，表示线条更细。
- CV_AA：抗锯齿线条，适用于需要平滑线条的情况。

4. 使用场景分析

图像处理与分析：在图像处理过程中，常常需要标记一些重要的区域或特征点，如在目标检测中标记检测到的目标、在图像分析中标记出感兴趣的区域。
视觉调试：开发计算机视觉系统时，经常需要在图像中绘制标记以调试检测和处理算法。通过标记可以快速验证算法的效果，如验证特征点提取的准确性，验证矩形框等。
标记测量点：在测量和测绘相关的应用中，可以使用该函数在图像中标记出测量的关键点。
AR应用：增强现实中的虚拟物体定位和对齐，常用标记来表示虚拟与现实的对齐点。

5. 使用注意事项分析

标记大小：需要根据图像的分辨率和标记的使用场景调整 markerSize，如果大小设置不合理，标记可能会变得不可见或过于突出。
标记类型的选择：根据实际需要选择合适的标记类型。例如，MARKER_CROSS 适合表示两个交叉的特征点，而 MARKER_CIRCLE 更适合表示圆形区域。
图像大小与标记显示：图像分辨率较低时，过大的标记可能会显得模糊不清，反之，分辨率较高时，标记过小可能不明显。
性能：该函数的绘制过程较为简单，不会带来太多性能开销，但在绘制大量标记时，可能会影响性能，特别是在实时视频流处理场景中。

6. 运行时间优化方法

减少重复绘制：在需要标记多个位置时，避免每次都调用 drawMarker，而是先计算所有的标记位置和大小，然后一次性绘制。
图像尺寸优化：在处理较大图像时，可以考虑对图像进行缩放（如果不影响最终效果），减少标记绘制时的计算负担。
缓存与绘制优化：如果标记位置和图像内容不会频繁变化，可以先将标记缓存下来，避免多次重复绘制。

7. 优缺点

优点：

易于使用：简单易用，只需传入位置、颜色等参数即可在图像上绘制标记。
多种标记类型：支持多种标记类型，能够满足不同场景的需求。
灵活的自定义：用户可以自定义标记的大小、颜色、厚度等属性，满足各种需求。

缺点：

图像处理开销：尽管绘制标记的操作非常简单，但在大量标记绘制时，可能会对性能产生一定影响。
有限的标记类型：虽然支持多种常见的标记类型，但并不支持复杂或自定义的标记形状。

8. 实际案例

假设我们有一幅图像，并需要在该图像的特定位置绘制标记：

Mat img = new Mat(500, 500, MatType.CV_8UC3, Scalar.All(255)); // 创建一个白色背景的图像
Point markerPosition = new Point(250, 250); // 标记位置
Scalar markerColor = new Scalar(0, 0, 255); // 红色标记

// 使用 drawMarker 绘制交叉标记
Cv2.DrawMarker(img, markerPosition, markerColor, MarkerTypes.Cross, markerSize: 30, thickness: 2);

// 显示图像
Cv2.ImShow("Marker Example", img);
Cv2.WaitKey(0);