【三】3D匹配Matching之外形匹配Shape—Based——get_shape_model_3d_contours()/get_shape_model_3d_params()算子

---

😊😊😊欢迎来到本博客😊😊😊

🌟🌟🌟 Halcon算子太多，学习查找都没有系统的学习查找路径，本专栏主要分享Halcon各类算子含义及用法，有时间会更新具体案例。

😊😊😊 具体食用方式：可以点击本专栏【Halcon算子快速查找】–>搜索你要查询的算子名称；或者点击Halcon算子汇总博客，即可食用。

🎁🎁🎁支持：如果觉得博主的文章还不错或者您用得到的话，可以悄悄关注一下博主哈，如果三连收藏支持就更好啦！这就是给予我最大的支持！😙😙😙

---

学习目标

• get_shape_model_3d_contours()
• get_shape_model_3d_params()

---

学习内容

算子简介

函数名	解释
get_shape_model_3d_contours()	提取3D轮廓模型目标。
get_shape_model_3d_params()	提取一个3D轮廓模型参数。

---

1、get_shape_model_3d_contours()

  get_shape_model_3d_contours( : ModelContours : ShapeModel3DID, Level, View : ViewPose)

  函数说明： 提取3D轮廓模型目标；

  函数参数：
    ModelContours：输出 3D轮廓；
    ShapeModel3DID： 输入 3D轮廓匹配模型；
    Level： 输入 金字塔对应的层数；默认：1 ；参考：1, 2, 3, 4, 5, 6, 7, 8, ，9，10，Level >= 1;
    View： 输入 轮廓对应视野；默认：1 ；参考： 1, 2, 3, 4, 5, 6, 7, 8, ，9，10，View >= 1;
    ViewPose： 输出 现在的3D轮廓姿势；

Halcon例程

无

2、get_shape_model_3d_params()

  get_shape_model_3d_params( : : ShapeModel3DID, GenParamNames : GenParamValues)

  函数说明： 提取一个3D轮廓模型参数；

  函数参数：
    ShapeModel3DID： 输入 3D轮廓匹配模型；
    GenParamNames： 输入 对象的参数名；默认： ‘num_levels_max’ ；参考：‘bounding_box1’, ‘cam_param’, ‘cam_roll_max’, ‘cam_roll_min’, ‘dist_max’, ‘dist_min’, ‘fast_pose_refinement’, ‘latitude_max’, ‘latitude_min’, ‘longitude_max’, ‘longitude_min’, ‘lowest_model_level’, ‘metric’, ‘min_contrast’, ‘min_face_angle’, ‘min_size’, ‘model_tolerance’, ‘num_levels’, ‘num_levels_max’, ‘num_views_per_level’, ‘optimization’, ‘order_of_rotation’, ‘part_size’, ‘ref_rot_x’, ‘ref_rot_y’, ‘ref_rot_z’, ‘reference_point’, ‘reference_pose’, ‘union_adjacent_contours’;

参数名	解释
num_levels_max	所有模型视图中使用的最大金字塔级别数
bounding_box1	基础3D对象模型的最小包围轴平行长方体，顺序如下：[min_x, min_y, min_z, max_x, max_y, max_z]
cam_param	用于匹配的相机的内部参数
cam_roll_max	模型视图的最大摄影机滚动角度
cam_roll_min	模型视图的最小摄影机滚动角度
dist_max	分布最大值
dist_min	分布最小值
fast_pose_refinement	描述搜索期间的姿势优化是在加速模式（“真”）还是在常规模式（“假”）下执行的
latitude_max	模型视图的最大纬度
latitude_min	型视图的最小纬度
longitude_max	模型视图的最大经度
longitude_min	模型视图的最小经度
lowest_model_level	视图存储在模型中的最低金字塔级别
metric	匹配度量值
min_contrast	搜索图像中对象的最小对比度
min_face_angle	三维形状模型中包含三维对象模型边缘的最小三维面角
min_size	投影的3D对象模型边缘的最小尺寸（以像素数为单位），以将投影的边缘包括在3D形状模型中
model_tolerance	投影三维对象模型边缘的最大可接受公差（以像素为单位）
num_levels	用户指定的金字塔级别数
num_levels_max	所有模型视图中使用的最大金字塔级别数
num_views_per_level	每个级别的视图数
optimization	通过减少模型点的数量进行优化
order_of_rotation	参考方向旋转值的含义
part_size	当“metric”设置为“ignore_part_polarity”时使用的模型零件的大小
ref_rot_x	参考方向：围绕罗德里格斯矢量的x轴或x分量旋转（以弧度或无单位）
ref_rot_y	参考方向：围绕罗德里格斯矢量的y轴或y分量旋转（以弧度或无单位）
ref_rot_z	参考方向：围绕罗德里格斯矢量的z轴或z分量旋转（以弧度或无单位）
reference_point	基础3D对象模型的参考点的3D坐标
reference_pose	三维形状模型的参考位置和方向。返回的姿势描述3D形状模型的内部使用的参考坐标系相对于基础3D对象模型中使用的坐标系的姿势。使用此姿势，可以将对象坐标系中给定的点转换为参考坐标系
union_adjacent_contours	描述在project_shape_model_3d中是否应连接相邻轮廓

    GenParamValues： 输出 对应的参数值；

Halcon例程

locate_cylinder_3d.hdev								通过结合立体和3D匹配，找到堆中最高的圆柱体
create_shape_model_3d_lowest_model_level.hdev		减少3D形状模型所需的内存
3d_matching_clamps.hdev								使用三维DXF模型识别图像中的三维对象

---

【3D匹配Matching之外形匹配Shape—Based】 待更新算子

• clear_shape_model_3d()
• clear_all_shape_model_3d()
• create_cam_pose_look_at_point()
• create_shape_model_3d()
• deserialize_shape_model_3d()
• find_shape_model_3d()
• get_shape_model_3d_contours()
• get_shape_model_3d_params()
• project_shape_model_3d()
• read_shape_model_3d()
• serialize_shape_model_3d()
• trans_pose_shape_model_3d()
• write_shape_model_3d()

---

汇总

  本专栏博客汇总：Halcon算子汇总

---

🚶🚶🚶今天的文章就到这里啦~
喜欢的话，点赞👍、收藏⭐️、关注💟哦 ~