《zw版·Halcon-delphi系列原创教程》 Halcon分类函数010,obj，对象管理

《zw版·Halcon-delphi系列原创教程》 Halcon分类函数010,obj，对象管理

为方便阅读，在不影响说明的前提下，笔者对函数进行了简化：

• :: 用符号“**”，替换：“procedure”
• :: 用大写字母“X”，替换：“IHUntypedObjectX”
• :: 省略了字符：“const”、“OleVariant”

【示例】 说明

函数：

procedure AddNoiseWhiteContourXld( const Contours: IHUntypedObjectX; out NoisyContours: IHUntypedObjectX; NumRegrPoints: OleVariant; Amp: OleVariant);

简化后为：

** AddNoiseWhiteContourXld( Contours: X; out NoisyContours: X; NumRegrPoints, Amp);

  1 ** AddMetrologyObjectCircleMeasure( MetrologyHandle, Row, Column, Radius, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
  2 说明,  add_metrology_object_circle_measure (  :  :  MetrologyHandle, Row,Column, Radius, MeasureLength1, MeasureLength2, MeasureSigma,MeasureThreshold, GenParamName, GenParamValue :  Index )
  3
  4 ** AddMetrologyObjectEllipseMeasure( MetrologyHandle, Row, Column, Phi, Radius1, Radius2, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
  5 说明,  增加一个椭圆或弧形物体，到测量模型当中
  6
  7 ** AddMetrologyObjectLineMeasure( MetrologyHandle, RowBegin, ColumnBegin, RowEnd, ColumnEnd, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
  8 说明,  增加一个线型物体，到测量模型当中
  9
 10 ** AddMetrologyObjectRectangle2Measure( MetrologyHandle, Row, Column, Phi, Length1, Length2, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
 11 说明,  增加一个矩形物体，到测量模型当中
 12
 13 ** AddSampleIdentifierPreparationData( SampleImage: X; SampleIdentifier, ObjectIdx, GenParamName, GenParamValue, out ObjectSampleIdx);
 14 说明,  增加预设标定数据
 15
 16 ** AddSampleIdentifierTrainingData( SampleImage: X; SampleIdentifier, ObjectIdx, GenParamName, GenParamValue, out ObjectSampleIdx);
 17 说明,  增加标定训练数据
 18
 19 ** AffineTransObjectModel3D( ObjectModel3D, HomMat3d, out ObjectModel3DAffineTrans);
 20 说明,  affine_trans_object_model_3d,把一个任意有限3D变换用于一个3D目标模型。
 21
 22 ** ApplySampleIdentifier( Image: X; SampleIdentifier, NumResults, RatingThreshold, GenParamName, GenParamValue, out ObjectIdx, out Rating);
 23 说明,  应用样本标识
 24
 25 ** AreaObjectModel3D( ObjectModel3D, out Area);
 26 说明,  测量3d物体表面面积
 27
 28 ** ClearAllObjectModel3D;
 29 说明,  clear_all_object_model_3d,释放所有3D目标模型的内存。
 30
 31 ** ClearMetrologyObject( MetrologyHandle, Indices);
 32 说明,  清除计量对象
 33
 34 ** ClearObj( Objects: X);
 35 说明,  clear_obj,将一个对象的图标从HALCON数据库中删除。
 36
 37 ** ClearObjectModel3D( ObjectModel3D);
 38 说明,  clear_object_model_3d,释放一个3D目标模型的内存。
 39
 40 ** ConcatObj( Objects1: X; Objects2: X; out ObjectsConcat: X);
 41 说明,  concat_obj,连接两个目标元组的图标。
 42
 43 ** ConnectionObjectModel3D( ObjectModel3D, Feature, Value, out ObjectModel3DConnected);
 44
 45 ** ConvexHullObjectModel3D( ObjectModel3D, out ObjectModel3DConvexHull);
 46 说明,  ConvexHullObjectModel3D,影响区域凸性的3D模型系数。
 47
 48 ** CopyMetrologyObject( MetrologyHandle, Indices, out CopiedIndices);
 49 说明,  复制计量对象
 50
 51 ** CopyObj( Objects: X; out ObjectsSelected: X; Index, NumObj);
 52 说明,  copy_obj,复制一个HALCON数据库中对象的图标 。
 53
 54 ** CopyObjectModel3D( ObjectModel3D, Attributes, out CopiedObjectModel3D);
 55 说明,  复制3d模型对象
 56
 57 ** CountObj( Objects: X; out Number);
 58 说明,  count_obj,统计一个元组中的对象。
 59
 60 ** CreateCalibData( CalibSetup, NumCameras, NumCalibObjects, out CalibDataID);
 61 说明,  建立校准数据
 62
 63 ** CreateShapeModel3D( ObjectModel3D, CamParam, RefRotX, RefRotY, RefRotZ, OrderOfRotation, LongitudeMin, LongitudeMax, LatitudeMin, LatitudeMax, CamRollMin, CamRollMax, DistMin, DistMax, MinContrast, GenParamNames, GenParamValues, out ShapeModel3DID);
 64 说明,  create_shape_model_3d,为匹配准备一个3D目标模型。
 65
 66 ** CreateSurfaceModel( ObjectModel3D, RelSamplingDistance, GenParamName, GenParamValue, out SurfaceModelID);
 67 说明,  建立表面模型
 68
 69 ** DeserializeObject( out Object_: X; SerializedItemHandle);
 70 说明,  对象数据转换
 71
 72 ** DeserializeObjectModel3D( SerializedItemHandle, out ObjectModel3D);
 73 说明,  3d模型对象数据转换
 74
 75 ** DispObj( Object_: X; WindowHandle);
 76 说明,  disp_obj,显示图像目标（图像，区域，XLD）。
 77
 78 ** DispObjectModel3D( WindowHandle, ObjectModel3D, CamParam, Pose, GenParamName, GenParamValue);
 79
 80 ** DispXld( XLDObject: X; WindowHandle);
 81 说明,  disp_xld,显示一个XLD物体。
 82
 83 ** DistanceObjectModel3D( ObjectModel3DFrom, ObjectModel3DTo, Pose, MaxDistance, GenParamNames, GenParamValues);
 84
 85 ** FindCalibObject( Image: X; CalibDataID, CameraIdx, CalibObjIdx, CalibObjPoseIdx, GenParamName, GenParamValue);
 86 说明,  检测校准对象
 87
 88 ** FindSurfaceModel( SurfaceModelID, ObjectModel3D, RelSamplingDistance, KeyPointFraction, MinScore, ReturnResultHandle, GenParamName, GenParamValue, out Pose, out Score, out SurfaceMatchingResultID);
 89 说明,  找出表面模型
 90
 91 ** FitPrimitivesObjectModel3D( ObjectModel3D, ParamName, ParamValue, out ObjectModel3DOut);
 92 说明,  根据3D模型获取对象
 93
 94 ** GenBoxObjectModel3D( Pose, LengthX, LengthY, LengthZ, out ObjectModel3D);
 95 说明,  生成3d对象框架
 96
 97 ** GenCylinderObjectModel3D( Pose, Radius, MinExtent, MaxExtent, out ObjectModel3D);
 98 说明,  创建3d柱状模型
 99
100 ** GenEmptyObj( out EmptyObject: X);
101 说明,  gen_empty_obj,创建一个空的目标元组。
102
103 ** GenEmptyObjectModel3D( out EmptyObjectModel3D);
104 说明,  创建一个空的3D模型对象。
105
106 ** GenObjectModel3DFromPoints( X, Y, Z, out ObjectModel3D);
107 说明,  从节点生成3d模型对象
108
109 ** GenPlaneObjectModel3D( Pose, XExtent, YExtent, out ObjectModel3D);
110 说明,  生成3d模型平面
111
112 ** GenSphereObjectModel3D( Pose, Radius, out ObjectModel3D);
113 说明,  创建球形3d模型对象
114
115 ** GenSphereObjectModel3DCenter( X, Y, Z, Radius, out ObjectModel3D);
116 说明,  创建中心球形3d模型对象
117
118 ** GetBarCodeObject( out BarCodeObjects: X; BarCodeHandle, CandidateHandle, ObjectName);
119 说明,  get_bar_code_object,访问创建在搜寻或条形码符号解码过程中的对象图标。
120
121 ** GetCalibDataObservContours( out Contours: X; CalibDataID, ContourName, CameraIdx, CalibObjIdx, CalibObjPoseIdx);
122 说明,  获取校准数据轮廓
123
124 ** GetCalibDataObservPoints( CalibDataID, CameraIdx, CalibObjIdx, CalibObjPoseIdx, out Row, out Column, out Index, out Pose);
125 说明,  获取校准数据节点
126
127 ** GetCalibDataObservPose( CalibDataID, CameraIdx, CalibObjIdx, CalibObjPoseIdx, out ObjInCameraPose);
128 说明,  获取校准数据姿势
129
130 ** GetChannelInfo( Object_: X; Request, Channel, out Information);
131 说明,  get_channel_info,一幅目标图像组成部分的信息。
132
133 ** GetDataCode2DObjects( out DataCodeObjects: X; DataCodeHandle, CandidateHandle, ObjectName);
134 说明,  get_data_code_2d_objects,查询搜索二维数据编码符号过程中创建的对象的图标。
135
136 ** GetDescriptorModelResults( ModelID, ObjectID, ResultNames, out Results);
137 说明,  获取描述模型结果
138
139 ** GetDispObjectModel3DInfo( WindowHandle, Row, Column, Information, out Value);
140 说明,  获取显示3d模型对角信息
141
142 ** GetMetrologyObjectFuzzyParam( MetrologyHandle, Indices, GenParamName, out GenParamValue);
143 说明,  获取计量对象模糊参数
144
145 ** GetMetrologyObjectIndices( MetrologyHandle, out Indices);
146 说明,  获取计量对象指数参数
147
148 ** GetMetrologyObjectMeasures( out Contour: X; MetrologyHandle, Indices, Transition, out Row, out Column);
149 说明,  获取计量对象均值参数
150
151 ** GetMetrologyObjectNumInstances( MetrologyHandle, Indices, out NumInstances);
152 说明,  获取计量对象均值参数
153
154 ** GetMetrologyObjectParam( MetrologyHandle, Indices, GenParamName, out GenParamValue);
155 说明,  获取计量对象参数
156
157 ** GetMetrologyObjectResult( MetrologyHandle, Indices, Instance, GenParamName, GenParamValue, out Parameter);
158 说明,  获取计量对象结果参数
159
160 ** GetObjClass( Object_: X; out Class_);
161 说明,  get_obj_class,一副目标图像类的名称。
162
163 ** GetObjectModel3DParams( ObjectModel3D, ParamName, out ParamValue);
164 说明,  get_object_model_3d_params,返回一个3D目标模型的参数。
165
166 ** GetParamNames( ProcName, out InpObjPar, out OutpObjPar, out InpCtrlPar, out OutpCtrlPar);
167 说明,  get_param_names,获取一个HALCON程序参数的名字。
168
169 ** GetParamNum( ProcName, out CName, out InpObjPar, out OutpObjPar, out InpCtrlPar, out OutpCtrlPar, out Type_);
170 说明,  get_param_num,获取一个HALCON程序不同参数类的数目。
171
172 ** GetSampleIdentifierObjectInfo( SampleIdentifier, ObjectIdx, InfoName, out InfoValue);
173 说明,  获取标识样本信息
174
175 ** GetSheetOfLightResultObjectModel3D( SheetOfLightModelID, out ObjectModel3D);
176 说明,  获取光线表结果，3d模型
177
178 ** GetStereoModelObject( out Object_: X; StereoModelID, PairIndex, ObjectName);
179 说明,  获取立体模型对象
180
181 ** GetTextObject( out Characters: X; TextResultID, ResultName);
182 说明,  获取文本对象
183
184 ** IntegerToObj( out Objects: X; SurrogateTuple);
185 说明,  integer_to_obj,将一个整型数转换为一个图标。
186
187 ** IntersectPlaneObjectModel3D( ObjectModel3D, Plane, out ObjectModel3DIntersection);
188 说明,  计算3d模型平面交集。
189
190 ** MaxDiameterObjectModel3D( ObjectModel3D, out Diameter);
191 说明,  3d模型最大直径
192
193 ** MomentsObjectModel3D( ObjectModel3D, MomentsToCalculate, out Moments);
194 说明,  3d xld对象被看做点云的轮廓,的几何时刻（moments）
195
196 ** ObjDiff( Objects: X; ObjectsSub: X; out ObjectsDiff: X);
197 说明,  对象差值
198
199 ** ObjectModel3DToXyz( out X: X; out Y: X; out Z: X; ObjectModel3D, Type_, CamParam, Pose);
200 说明,  3d对象xyz坐标
201
202 ** ObjToInteger( Objects: X; Index, Number, out SurrogateTuple);
203 说明,  obj_to_integer,将一个图标转换为一个整型数。
204
205 ** PrepareObjectModel3D( ObjectModel3D, Purpose, OverwriteData, GenParamName, GenParamValue);
206 说明,  为图像准备一个变化模型。
207
208 ** ProjectiveTransObjectModel3D( ObjectModel3D, HomMat3d, out ObjectModel3DProjectiveTrans);
209
210 ** ProjectObjectModel3D( out ModelContours: X; ObjectModel3D, CamParam, Pose, GenParamName, GenParamValue);
211 说明,  project_object_model_3d,把一个3D目标模型的边缘投影到图像坐标中。
212
213 ** ReadObjectModel3D( FileName, Scale, GenParamName, GenParamValue, out ObjectModel3D, out Status);
214 说明,  读取3d模型测量
215
216 ** ReadObjectModel3DDxf( FileName, Scale, GenParamNames, GenParamValues, out ObjectModel3D, out DxfStatus);
217 说明,  read_object_model_3d_dxf,从一个DXF文件中读取一个3D目标模型。
218
219 ** ReduceObjectModel3DByView( Region: X; ObjectModel3D, CamParam, Pose, out ObjectModel3DReduced);
220 说明,  通过视口，减少图像区域
221
222 ** RefineSurfaceModelPose( SurfaceModelID, ObjectModel3D, InitialPose, MinScore, ReturnResultHandle, GenParamName, GenParamValue, out Pose, out Score, out SurfaceMatchingResultID);
223 说明,  细化表面模型
224
225 ** RegisterObjectModel3DGlobal( ObjectModels3D, HomMats3D, From, To_, GenParamName, GenParamValue, out HomMats3DOut, out Scores);
226 说明,  注册为全局3d模型对象
227
228 ** RegisterObjectModel3DPair( ObjectModel3D1, ObjectModel3D2, Method, GenParamName, GenParamValue, out Pose, out Score);
229 说明,  注册为全局双目3d模型对象
230
231 ** RemoveSampleIdentifierPreparationData( SampleIdentifier, ObjectIdx, ObjectSampleIdx);
232 说明,  删除样本标识
233
234 ** RemoveSampleIdentifierTrainingData( SampleIdentifier, ObjectIdx, ObjectSampleIdx);
235 说明,  删除样本标识训练数据
236
237 ** RenderObjectModel3D( out Image: X; ObjectModel3D, CamParam, Pose, GenParamName, GenParamValue);
238 说明,  渲染3d模型对象
239
240 ** ResetMetrologyObjectFuzzyParam( MetrologyHandle, Indices);
241 说明,  复位计量对象数据
242
243 ** ResetMetrologyObjectParam( MetrologyHandle, Indices);
244 说明,  复位计量对象数据参数
245
246 ** ResetObjDb( DefaultImageWidth, DefaultImageHeight, DefaultChannels);
247 说明,  reset_obj_db,HALCON系统的初始化。
248
249 ** RigidTransObjectModel3D( ObjectModel3D, Pose, out ObjectModel3DRigidTrans);
250 说明,  刚性3d模型变换
251
252 ** ructSurfaceStereo( Images: X; StereoModelID, out ObjectModel3D);
253 说明,  从立体表面获取高度
254
255 ** SampleObjectModel3D( ObjectModel3D, Method, SampleDistance, GenParamName, GenParamValue, out SampledObjectModel3D);
256 说明,  3d模型样本
257
258 ** SegmentObjectModel3D( ObjectModel3D, ParamName, ParamValue, out ObjectModel3DOut);
259
260 ** SelectObj( Objects: X; out ObjectSelected: X; Index);
261 说明,  select_obj,从一个目标元组中选择目标。
262
263 ** SelectObjectModel3D( ObjectModel3D, Feature, Operation, MinValue, MaxValue, out ObjectModel3DSelected);
264 说明,  选择3d模型目标。
265
266 ** SelectPointsObjectModel3D( ObjectModel3D, Attrib, MinValue, MaxValue, out ObjectModel3DThresholded);
267 说明,  选择3d模型节点。
268
269 ** SerializeObject( Object_: X; out SerializedItemHandle);
270 说明,  对象数据序列化
271
272 ** SerializeObjectModel3D( ObjectModel3D, out SerializedItemHandle);
273 说明,  3d模型数据序列化
274
275 ** SetCalibDataCalibObject( CalibDataID, CalibObjIdx, CalibObjDescr);
276 说明,  设置校准数据对象
277
278 ** SetCalibDataObservPoints( CalibDataID, CameraIdx, CalibObjIdx, CalibObjPoseIdx, Row, Column, Index, Pose);
279 说明,  设置校准数据节点
280
281 ** SetCalibDataObservPose( CalibDataID, CameraIdx, CalibObjIdx, CalibObjPoseIdx, ObjInCameraPose);
282 说明,  设置校准数据姿态
283
284 ** SetMetrologyObjectFuzzyParam( MetrologyHandle, Indices, GenParamName, GenParamValue);
285 说明,  设置计量对象参数
286
287 ** SetMetrologyObjectParam( MetrologyHandle, Indices, GenParamName, GenParamValue);
288 说明,  设置计量对象参数
289
290 ** SetObjectModel3DAttrib( ObjectModel3D, Name, Type_, Data, out ObjectModel3DOut);
291 说明,  设置3d模型属性
292
293 ** SetObjectModel3DAttribMod( ObjectModel3D, Name, Type_, Data);
294 说明,  设置3d模型属性
295
296 ** SetSampleIdentifierObjectInfo( SampleIdentifier, ObjectIdx, InfoName, InfoValue);
297 说明,  设置样本对象数据
298
299 ** SmallestBoundingBoxObjectModel3D( ObjectModel3D, Type_, out Pose, out Length1, out Length2, out Length3);
300
301 ** SmallestSphereObjectModel3D( ObjectModel3D, out CenterPoint, out Radius);
302 说明,  3d模型最小外接球形对象
303
304 ** SmoothObjectModel3D( ObjectModel3D, Method, GenParamName, GenParamValue, out SmoothObjectModel3D);
305 说明,  平滑3d模型
306
307 ** SurfaceNormalsObjectModel3D( ObjectModel3D, Method, GenParamName, GenParamValue, out ObjectModel3DNormals);
308 说明,  3d模型表面
309
310 ** TestAccess( Object_: X; out Dummy: X; NumReadChord, NumCopyObj, Write_chord);
311 说明,  测试Access
312
313 ** TestEqualObj( Objects1: X; Objects2: X; out IsEqual);
314 说明,  test_equal_obj,比较目标图像的平等性。
315
316 ** TestObjDef( Object_: X; out IsDefined);
317 说明,  test_obj_def,测试目标是否被删除。
318
319 ** TransformMetrologyObject( MetrologyHandle, Indices, Row, Column, Phi, Mode);
320 说明,  对象变换
321
322 ** TriangulateObjectModel3D( ObjectModel3D, Method, GenParamName, GenParamValue, out TriangulatedObjectModel3D, out Information);
323 说明,  3角曲面3d模型
324
325 ** UnionObjectModel3D( ObjectModels3D, Method, out UnionObjectModel3D);
326 说明,  合并3d模型
327
328 ** VolumeObjectModel3DRelativeToPlane( ObjectModel3D, Plane, Mode, UseFaceOrientation, out Volume);
329 说明,  3d模型相对体积平面
330
331 ** WriteObjectModel3D( ObjectModel3D, FileType, FileName, GenParamName, GenParamValue);
332 说明,  保存3d模型数据
333
334 ** XyzToObjectModel3D( X: X; Y: X; Z: X; out ObjectModel3D);
335 说明,  xyz坐标到3d模型在；换