《zw版·Halcon-delphi系列原创教程》 Halcon分类函数005·graphics-obj，基本绘图单元，包括线段、矩形、椭圆、圆形

《zw版·Halcon-delphi系列原创教程》 Halcon分类函数005·graphics-obj，基本绘图单元，包括线段、矩形、椭圆、圆形

graphics-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 ** ApproxChain( Row, Column, MinWidthCoord, MaxWidthCoord, ThreshStart, ThreshEnd, ThreshStep, MinWidthSmooth, MaxWidthSmooth, MinWidthCurve, MaxWidthCurve, Weight1, Weight2, Weight3, out ArcCenterRow, out ArcCenterCol, out ArcAngle, out ArcBeginRow, out ArcBeginCol, out LineBeginRow, out LineBeginCol, out LineEndRow, out LineEndCol, out Order);
 11 说明,  approx_chain,通过弧和线近似一个轮廓。
 12
 13 ** ApproxChainSimple( Row, Column, out ArcCenterRow, out ArcCenterCol, out ArcAngle, out ArcBeginRow, out ArcBeginCol, out LineBeginRow, out LineBeginCol, out LineEndRow, out LineEndCol, out Order);
 14 说明,  approx_chain_simple,通过弧和线近似一个轮廓。
 15
 16 ** ClosingCircle( Region: X; out RegionClosing: X; Radius);
 17 说明,  closing_circle,关闭一个圆形结构基础的一个区域。
 18
 19 ** CombineRoadsXld( EdgePolygons: X; ModParallels: X; ExtParallels: X; CenterLines: X; out RoadSides: X; MaxAngleParallel, MaxAngleColinear, MaxDistanceParallel, MaxDistanceColinear);
 20 说明,  combine_roads_xld,合并两个等级分辨率中的路（road）。
 21
 22 ** ConnectGridPoints( Image: X; out ConnectingLines: X; Row, Column, Sigma, MaxDist);
 23 说明,  connect_grid_points,建立矫正网格的矫正点间的连接。
 24
 25 ** DilationCircle( Region: X; out RegionDilation: X; Radius);
 26
 27 ** DispCircle( WindowHandle, Row, Column, Radius);
 28 说明,  disp_circle,在窗口中显示圆。
 29
 30 ** DispEllipse( WindowHandle, CenterRow, CenterCol, Phi, Radius1, Radius2);
 31 说明,  disp_ellipse,显示椭圆。
 32
 33 ** DispLine( WindowHandle, Row1, Column1, Row2, Column2);
 34 说明,  disp_line,在窗口中画一条线。
 35
 36 ** DistEllipseContourPointsXld( Contour: X; DistanceMode, ClippingEndPoints, Row, Column, Phi, Radius1, Radius2, out Distances);
 37 说明,  dist_ellipse_contour_points_xld,计算所有轮廓,内的点到一个椭圆的距离。
 38
 39 ** DistEllipseContourXld( Contours: X; Mode, MaxNumPoints, ClippingEndPoints, Row, Column, Phi, Radius1, Radius2, out MinDist, out MaxDist, out AvgDist, out SigmaDist);
 40 说明,  dist_ellipse_contour_xld,轮廓到一个椭圆的距离。
 41
 42 ** DrawCircle( WindowHandle, out Row, out Column, out Radius);
 43 说明,  draw_circle,一个圆的交互绘图。
 44
 45 ** DrawCircleMod( WindowHandle, RowIn, ColumnIn, RadiusIn, out Row, out Column, out Radius);
 46 说明,  draw_circle_mod,一个圆的交互绘图。
 47
 48 ** DrawEllipse( WindowHandle, out Row, out Column, out Phi, out Radius1, out Radius2);
 49 说明,  draw_ellipse,一个椭圆的交互绘图。
 50
 51 ** DrawEllipseMod( WindowHandle, RowIn, ColumnIn, PhiIn, Radius1In, Radius2In, out Row, out Column, out Phi, out Radius1, out Radius2);
 52 说明,  draw_ellipse_mod,一个椭圆的交互绘图。
 53
 54 ** DrawLine( WindowHandle, out Row1, out Column1, out Row2, out Column2);
 55 说明,  draw_line,画一根线。
 56
 57 ** DrawLineMod( WindowHandle, Row1In, Column1In, Row2In, Column2In, out Row1, out Column1, out Row2, out Column2);
 58 说明,  draw_line_mod,画一根线。
 59
 60 ** EllipticAxis( Regions: X; out Ra, out Rb, out Phi);
 61 说明,  elliptic_axis,相似椭圆的参数。
 62
 63 ** EllipticAxisGray( Regions: X; Image: X; out Ra, out Rb, out Phi);
 64 说明,  elliptic_axis_gray,在一个灰度值图像中计算一个区域的方位和主轴。
 65
 66 ** EllipticAxisPointsXld( XLD: X; out Ra, out Rb, out Phi);
 67 说明,  elliptic_axis_points_xld,被看做点云的轮廓,或多边形（polygon）的等价椭圆参数。
 68
 69 ** EllipticAxisXld( XLD: X; out Ra, out Rb, out Phi);
 70 说明,  elliptic_axis_xld,轮廓,或多变形（polygon）的等价椭圆参数。
 71
 72 ** ErosionCircle( Region: X; out RegionErosion: X; Radius);
 73 说明,  erosion_circle,腐蚀一个圆形结构基础的一个区域。
 74
 75 ** ExpandLine( Image: X; out RegionExpand: X; Coordinate, ExpandType, RowColumn, Threshold);
 76 说明,  expand_line,从给定线开始扩充区域。
 77
 78 ** Find1DBarCodeScanline( Image: X; out CodeRegion: X; BarCodeDescr, GenericName, GenericValue, StopIfFound, out BarcodeFound, out BarCodeElements, out Orientation, out ScanlineNumPoints, out ScanlineDecoded, out ScanlinePointsRow, out ScanlinePointsColumn);
 79 说明,  find_1d_bar_code_scanline,搜索一幅图像中的一个条形码。
 80
 81 ** FitCircleContourXld( Contours: X; Algorithm, MaxNumPoints, MaxClosureDist,
 82
 83 ** FitEllipseContourXld( Contours: X; Algorithm, MaxNumPoints, MaxClosureDist,
 84
 85 ** FitLineContourXld( Contours: X; Algorithm, MaxNumPoints, ClippingEndPoints, Iterations, ClippingFactor, out RowBegin, out ColBegin, out RowEnd, out ColEnd, out Nr, out Nc, out Dist);
 86
 87 ** FnewLine( FileHandle);
 88 说明,  fnew_line,创建一个换行符。
 89
 90 ** FreadLine( FileHandle, out OutLine, out IsEOF);
 91 说明,  fread_line,从一个文本文件中读取一行。
 92
 93 ** GenCircle( out Circle: X; Row, Column, Radius);
 94 说明,  gen_circle,创建一个圆周。
 95
 96 ** GenCircleContourXld( out ContCircle: X; Row, Column, Radius, StartPhi, EndPhi, PointOrder, Resolution);
 97
 98 ** GenEllipse( out Ellipse: X; Row, Column, Phi, Radius1, Radius2);
 99 说明,  gen_ellipse,创建一个椭圆。
100
101 ** GenEllipseContourXld( out ContEllipse: X; Row, Column, Phi, Radius1, Radius2,
102
103 ** GenGridRectificationMap( Image: X; ConnectingLines: X; out Map: X; out Meshes: X; GridSpacing, Rotation, Row, Column, MapType);
104 说明,  gen_grid_rectification_map,计算扭曲图像与基于规律的网格的正确的图像的映射。
105
106 ** GenRegionHline( out Regions: X; Orientation, Distance);
107 说明,  gen_region_hline,将Hesse正规形状中描述的输入线存储为区域。
108
109 ** GenRegionLine( out RegionLines: X; BeginRow, BeginCol, EndRow, EndCol);
110 说明,  gen_region_line,将输入线以区域形式存储。
111
112 ** Get1DBarCodeScanline( BarCodeRegion: X; BarCodeDescr, GenericName, GenericValue, Orientation, StopIfFound, out BarCodeElements, out ScanlineNumPoints, out ScanlineDecoded, out ScanlinePointsRow, out ScanlinePointsColumn);
113 说明,  get_1d_bar_code_scanline,提取一个条形码区域中元素的宽度。
114
115 ** GetCirclePose( Contour: X; CameraParam, Radius, out putType, out Pose1, out Pose2);
116 说明,  get_circle_pose,从一个圆周相应的二维投射中决定它的三维模式。
117
118 ** GetLineApprox( WindowHandle, out Approximation);
119 说明,  get_line_approx,获取轮廓显示的现在近似误差。
120
121 ** GetLineOfSight( Row, Column, CameraParam, out Px, out Py, out Pz, out Qx, out Qy, out Qz);
122 说明,  get_line_of_sight,计算相应于图像中一个点的视线。
123
124 ** GetLineStyle( WindowHandle, out Style);
125 说明,  get_line_style,获取轮廓的现在图解模式。
126
127 ** GetLinesXld( Polygon: X; out BeginRow, out BeginCol, out EndRow, out EndCol, out Length, out Phi);
128 说明,  get_lines_xld,返回一个XLD多边形（polygon）数据。
129
130 ** GetLineWidth( WindowHandle, out Width);
131 说明,  get_line_width,获取轮廓显示的现在线宽。
132
133 ** GetPointsEllipse( Angle, Row, Column, Phi, Radius1, Radius2, out RowPoint, out ColPoint);
134
135 ** HoughCircles( RegionIn: X; out RegionOut: X; Radius, Percent, Mode);
136 说明,  hough_circles,特定半径的圆周的中心。
137
138 ** HoughCircleTrans( Region: X; out HoughImage: X; Radius);
139 说明,  hough_circle_trans,返回指定半径的圆周的Hough变换。
140
141 ** HoughLines( RegionIn: X; AngleResolution, Threshold, AngleGap, DistGap, out Angle, out Dist);
142 说明,  hough_lines,借助Hough变化查询图像中的线，并将其返回到HNF中。
143
144 ** HoughLinesDir( ImageDir: X; out HoughImage: X; out Lines: X; DirectionUncertainty, AngleResolution, Smoothing, FilterSize, Threshold, AngleGap, DistGap, GenLines, out Angle, out Dist);
145 说明,  hough_lines_dir,借助采用局部方向梯度的Hough变换查询图像中的线，并将它们以正常形式返回。
146
147 ** HoughLineTrans( Region: X; out HoughImage: X; AngleResolution);
148 说明,  hough_line_trans,对区域中的线进行Hough变换。
149
150 ** HoughLineTransDir( ImageDir: X; out HoughImage: X; DirectionUncertainty, AngleResolution);
151 说明,  hough_line_trans_dir,利用局部方向梯度对线进行Hough变换。
152
153 ** InnerCircle( Regions: X; out Row, out Column, out Radius);
154 说明,  inner_circle,一个区域内部最大的圆周。
155
156 ** IntersectionCircleContourXld( Contour: X; CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder, out Row, out Column);
157 说明,  计算xld圆形对象交集。
158
159 ** IntersectionCircles( Circle1Row, Circle1Column, Circle1Radius, Circle1StartPhi, Circle1EndPhi, Circle1PointOrder, Circle2Row, Circle2Column, Circle2Radius, Circle2StartPhi, Circle2EndPhi, Circle2PointOrder, out Row, out Column, out IsOverlapping);
160 说明,  计算圆形对象交集。
161
162 ** IntersectionLineCircle( LineRow1, LineColumn1, LineRow2, LineColumn2, CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder, out Row, out Column);
163 说明,  计算直线-圆形对象交集。
164
165 ** IntersectionLineContourXld( Contour: X; LineRow1, LineColumn1, LineRow2, LineColumn2, out Row, out Column, out IsOverlapping);
166 说明,  计算直线-轮廓对象交集。
167
168 ** IntersectionLines( Line1Row1, Line1Column1, Line1Row2, Line1Column2, Line2Row1, Line2Column1, Line2Row2, Line2Column2, out Row, out Column, out IsOverlapping);
169 说明,  计算直线-直线对象交集。
170
171 ** IntersectionSegmentCircle( SegmentRow1, SegmentColumn1, SegmentRow2, SegmentColumn2, CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder, out Row, out Column);
172 说明,  计算圆形分段对象交集。
173
174 ** IntersectionSegmentLine( SegmentRow1, SegmentColumn1, SegmentRow2, SegmentColumn2, LineRow1, LineColumn1, LineRow2, LineColumn2, out Row, out Column, out IsOverlapping);
175 说明,  计算直线分段对象交集。
176
177 ** IntersectLinesOfSight( CamParam1, CamParam2, RelPose, Row1, Col1, Row2, Col2, out X, out Y, out Z, out Dist);
178 说明,  计算直线的交集。
179
180 ** LinearTransColor( Image: X; out ImageTrans: X; TransMat);
181 说明,  linear_trans_color,计算多通道图像的颜色值的一个仿射转换。
182
183 ** LineOrientation( RowBegin, ColBegin, RowEnd, ColEnd, out Phi);
184 说明,  line_orientation,计算线的方位。
185
186 ** LinePosition( RowBegin, ColBegin, RowEnd, ColEnd, out RowCenter, out ColCenter, out Length, out Phi);
187 说明,  line_position,计算一条线的重心、长度和方位。
188
189 ** LinesColor( Image: X; out Lines: X; Sigma, Low, High, ExtractWidth, CompleteJunctions);
190 说明,  lines_color,检测色线和它们的宽度。
191
192 ** LinesFacet( Image: X; out Lines: X; MaskSize, Low, High, LightDark);
193 说明,  lines_facet,使用面模型检测线。
194
195 ** LinesGauss( Image: X; out Lines: X; Sigma, Low, High, LightDark, ExtractWidth, LineModel, CompleteJunctions);
196
197 ** MergeContLineScanXld( CurrConts: X; PrevConts: X; out CurrMergedConts: X; out PrevMergedConts: X; ImageHeight, Margin, MergeBorder, MaxImagesCont);
198 说明,  merge_cont_line_scan_xld,合并连续线扫描图像中的XLD轮廓,。
199
200 ** MergeRegionsLineScan( CurrRegions: X; PrevRegions: X; out CurrMergedRegions: X; out PrevMergedRegions: X; ImageHeight, MergeBorder, MaxImagesRegion);
201 说明,  merge_regions_line_scan,从行扫描图像合并区域。
202
203 ** NewLine( WindowHandle);
204 说明,  new_line,设置下一行的开始文本光标的位置。
205
206 ** OpenFramegrabber( Name, HorizontalResolution, VerticalResolution, ImageWidth, ImageHeight, StartRow, StartColumn, Field, BitsPerChannel, ColorSpace, Generic, ExternalTrigger, CameraType, Device, Port, LineIn, out AcqHandle);
207 说明,  open_framegrabber,打开并配置一个图像获取设备。
208
209 ** OpeningCircle( Region: X; out RegionOpening: X; Radius);
210 说明,  opening_circle,打开一个圆形结构基础的一个区域。
211
212 ** PartitionLines( RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Feature, Operation, Min, Max, out RowBeginOut, out ColBeginOut, out RowEndOut, out ColEndOut, out FailRowBOut, out FailColBOut, out FailRowEOut, out FailColEOut);
213 说明,  partition_lines,通过各种标准区分线。
214
215 ** QueryLineWidth( out Min, out Max);
216 说明,  query_line_width,查询可能的线宽。
217
218 ** SegmentCharacters( Region: X; Image: X; out ImageForeground: X; out RegionForeground: X; Method, EliminateLines, DotPrint, StrokeWidth, CharWidth, CharHeight, ThresholdOffset, Contrast, out UsedThreshold);
219 说明,  segment_characters,将图像给定区域的字符分割。
220
221 ** SelectCharacters( Region: X; out RegionCharacters: X; DotPrint, StrokeWidth, CharWidth, CharHeight, Punctuation, DiacriticMarks, PartitionMethod, PartitionLines, FragmentDistance, ConnectFragments, ClutterSizeMax, StopAfter);
222 说明,  select_characters,从一个给定区域中选择字符。
223
224 ** SelectLines( RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Feature, Operation, Min, Max, out RowBeginOut, out ColBeginOut, out RowEndOut, out ColEndOut);
225 说明,  select_lines,通过各种标准选择线。
226
227 ** SelectLinesLongest( RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Num, out RowBeginOut, out ColBeginOut, out RowEndOut, out ColEndOut);
228 说明,  select_lines_longest,选择最长输入线。
229
230 ** SelectMatchingLines( RegionIn: X; out RegionLines: X; AngleIn, DistIn, LineWidth, Thresh, out AngleOut, out DistOut);
231 说明,  select_matching_lines,选取HNF中线的集合中匹配区域最好的线。
232
233 ** SetLineApprox( WindowHandle, Approximation);
234 说明,  set_line_approx,定义输出显示的近似误差。
235
236 ** SetLineStyle( WindowHandle, Style);
237 说明,  set_line_style,定义一个轮廓输出模式。
238
239 ** SetLineWidth( WindowHandle, Width);
240 说明,  set_line_width,定义区域轮廓输出的线宽。
241
242 ** SmallestCircle( Regions: X; out Row, out Column, out Radius);
243 说明,  smallest_circle,一个区域的最小周长。
244
245 ** SmallestCircleXld( XLD: X; out Row, out Column, out Radius);
246 说明,  smallest_circle_xld,轮廓,或多边形（polygon）的最小封闭圆。
247
248 ** SplitSkeletonLines( SkeletonRegion: X; MaxDistance, out BeginRow, out BeginCol, out EndRow, out EndCol);
249
250 ** SplitSkeletonRegion( SkeletonRegion: X; out RegionLines: X; MaxDistance);
251
252 ** TextLineOrientation( Region: X; Image: X; CharHeight, OrientationFrom, OrientationTo, out OrientationAngle);
253 说明,  text_line_orientation,决定一个文本行或段落的定向（定位）。
254
255 ** TextLineSlant( Region: X; Image: X; CharHeight, SlantFrom, SlantTo, out SlantAngle);
256 说明,  text_line_slant,决定一个文本行或段落的字符的倾斜。
257
258 ** UnionCollinearContoursExtXld( Contours: X; out UnionContours: X; MaxDistAbs, MaxDistRel, MaxShift, MaxAngle, MaxOverlap, MaxRegrError, MaxCosts, WeightDist, WeightShift, WeightAngle, WeightLink, WeightRegr, Mode);
259
260 ** UnionCollinearContoursXld( Contours: X; out UnionContours: X; MaxDistAbs, MaxDistRel, MaxShift, MaxAngle, Mode);
261
262 ** UnionStraightContoursHistoXld( Contours: X; out UnionContours: X; out SelectedContours: X; RefLineStartRow, RefLineStartColumn, RefLineEndRow, RefLineEndColumn, Width, MaxWidth, FilterSize, out HistoValues);
263 说明,  union_straight_contours_histo_xld,合并到给定线有相似距离的相邻直线轮廓,。