【四】3D Object Model之创建Creation——write_object_model_3d()算子

---

欢迎来到本博客

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

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

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

---

学习目标

• write_object_model_3d()

---

学习内容

算子简介

函数名	解释
write_object_model_3d()	保存一个3D对象模型。

---

1、write_object_model_3d()

  write_object_model_3d( : : ObjectModel3D, FileType, FileName, GenParamName, GenParamValue : )

  函数说明：操作符write_object_model_3d将3d对象模型ObjectModel3D写入文件FileName。对象模型可以用read_object_model_3d再次读取，也可以导入到适当的CAD程序中。请注意，基元只能以HALCON格式“om3”存储。如果需要以另一种格式存储基元，则必须事先调用操作符sample_object_model_3d。然而，这导致了基元到3D点的转换，并且因此仅对应于基元的近似。
  所有坐标都以米为单位。如果以后使用read_object_model_3d读取文件，则必须将参数Scale设置为’m’以避免缩放数据。

  函数参数：
    ObjectModel3D：输入 3D对象模型句柄；
    FileType：输入写入的文件的类型；默认:'om3' ；参考: 'dxf', 'obj', 'off', 'om3', 'ply', 'ply_binary', 'stl', 'stl_ascii', 'stl_binary'；具体如下:

参数名	解释
'om3'	使用此格式可以通过write_object_model_3d函数将文件写入。此格式的默认文件扩展名为'om3'。
'dxf'	AUTOCAD格式。此格式的默认文件扩展名为'dxf'。
'off'	Object File Format（.off）。这是一种基于ASCII的简单格式，可以存储3D点和多边形。不支持二进制OFF格式。此格式的默认文件扩展名为'off'。
'ply'	多边形文件格式（也称为斯坦福三角形格式）。这是一种简单的格式，可以存储3D点、点法线和多边形。HALCON支持该格式的ASCII和二进制版本。此格式的默认文件扩展名为'ply'。
'obj'	OBJ文件格式，也称为’Wavefront OBJ格式’。这是一种基于ASCII的格式，可以存储3D点、多边形、法线、纹理坐标、材质和其他信息。HALCON支持点（'v’行）和多边形面（‘f’行）。其他实体将被忽略。此格式的默认文件扩展名为'obj'。
'stl'，'stl_binary'，'stl_ascii'	STL文件格式，也称为’立体光刻格式’、‘表面三角化语言’、‘标准三角化语言’和’标准三角剖分语言’。该格式存储三角形和三角形法线。然而，由于HALCON 3D对象模型不支持三角形法线，只读取三角形，而忽略三角形法线。如果需要，法线会从三角形重新计算。HALCON同时支持该格式的ASCII和二进制版本。如果设置为’stl’，HALCON将自动检测格式类型。将类型设置为’stl_binary’或’stl_ascii’将强制使用相应的格式。此格式的默认文件扩展名为'stl'。

    FileName：输入写入的文件的名称；参考：.off, .ply, .dxf, .om3, .obj, .stl；
    GenParamName：输入通用参数的名称；
    GenParamValue：输入通用参数的值；

  可以设置一组附加的可选参数。参数的名称和值分别在GenParamName和GenParamValue中传递。某些可选参数只能针对特定的文件类型进行设置。GenParamName具有以下值：

参数名	解释
'invert_normals'	在保存三维对象模型之前反转法线和面方向。如果此值设置为“true”，则对于'off'、 'ply'、'obj'和 'stl'格式，面（三角形和多边形）的方向将反转。对于支持点法线（ 'ply'、'obj'）的格式，在将所有法线写入光盘之前，将反转所有法线。请注意，对于类型'om3'和'dxf'，该参数没有任何作用。

Halcon例程

无

---

【3D Object Model之创建Creation】 待更新算子

• clear_object_model_3d()
• copy_object_model_3d()
• deserialize_object_model_3d()
• gen_box_object_model_3d()
• gen_cylinder_object_model_3d()
• gen_empty_object_model_3d()
• gen_object_model_3d_from_points()
• gen_plane_object_model_3d()
• gen_sphere_object_model_3d()
• gen_sphere_object_model_3d_center()
• read_object_model_3d()
• serialize_object_model_3d()
• set_object_model_3d_attrib()
• set_object_model_3d_attrib_mod()
• union_object_model_3d()
• write_object_model_3d()

---

汇总

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

---

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