《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);

 ** AddMetrologyObjectCircleMeasure( MetrologyHandle, Row, Column, Radius, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
 说明,  add_metrology_object_circle_measure (  :  :  MetrologyHandle, Row,Column, Radius, MeasureLength1, MeasureLength2, MeasureSigma,MeasureThreshold, GenParamName, GenParamValue :  Index )
 
 ** AddMetrologyObjectEllipseMeasure( MetrologyHandle, Row, Column, Phi, Radius1, Radius2, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
 说明,  增加一个椭圆或弧形物体，到测量模型当中
 
 ** AddMetrologyObjectLineMeasure( MetrologyHandle, RowBegin, ColumnBegin, RowEnd, ColumnEnd, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue, out Index);
 说明,  增加一个线型物体，到测量模型当中
 
 ** 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);
 说明,  approx_chain,通过弧和线近似一个轮廓。
 
 ** ApproxChainSimple( Row, Column, out ArcCenterRow, out ArcCenterCol, out ArcAngle, out ArcBeginRow, out ArcBeginCol, out LineBeginRow, out LineBeginCol, out LineEndRow, out LineEndCol, out Order);
 说明,  approx_chain_simple,通过弧和线近似一个轮廓。
 
 ** ClosingCircle( Region: X; out RegionClosing: X; Radius);
 说明,  closing_circle,关闭一个圆形结构基础的一个区域。
 
 ** CombineRoadsXld( EdgePolygons: X; ModParallels: X; ExtParallels: X; CenterLines: X; out RoadSides: X; MaxAngleParallel, MaxAngleColinear, MaxDistanceParallel, MaxDistanceColinear);
 说明,  combine_roads_xld,合并两个等级分辨率中的路（road）。
 
 ** ConnectGridPoints( Image: X; out ConnectingLines: X; Row, Column, Sigma, MaxDist);
 说明,  connect_grid_points,建立矫正网格的矫正点间的连接。
 
 ** DilationCircle( Region: X; out RegionDilation: X; Radius);
 
 ** DispCircle( WindowHandle, Row, Column, Radius);
 说明,  disp_circle,在窗口中显示圆。
 
 ** DispEllipse( WindowHandle, CenterRow, CenterCol, Phi, Radius1, Radius2);
 说明,  disp_ellipse,显示椭圆。
 
 ** DispLine( WindowHandle, Row1, Column1, Row2, Column2);
 说明,  disp_line,在窗口中画一条线。
 
 ** DistEllipseContourPointsXld( Contour: X; DistanceMode, ClippingEndPoints, Row, Column, Phi, Radius1, Radius2, out Distances);
 说明,  dist_ellipse_contour_points_xld,计算所有轮廓,内的点到一个椭圆的距离。
 
 ** DistEllipseContourXld( Contours: X; Mode, MaxNumPoints, ClippingEndPoints, Row, Column, Phi, Radius1, Radius2, out MinDist, out MaxDist, out AvgDist, out SigmaDist);
 说明,  dist_ellipse_contour_xld,轮廓到一个椭圆的距离。
 
 ** DrawCircle( WindowHandle, out Row, out Column, out Radius);
 说明,  draw_circle,一个圆的交互绘图。
 
 ** DrawCircleMod( WindowHandle, RowIn, ColumnIn, RadiusIn, out Row, out Column, out Radius);
 说明,  draw_circle_mod,一个圆的交互绘图。
 
 ** DrawEllipse( WindowHandle, out Row, out Column, out Phi, out Radius1, out Radius2);
 说明,  draw_ellipse,一个椭圆的交互绘图。
 
 ** DrawEllipseMod( WindowHandle, RowIn, ColumnIn, PhiIn, Radius1In, Radius2In, out Row, out Column, out Phi, out Radius1, out Radius2);
 说明,  draw_ellipse_mod,一个椭圆的交互绘图。
 
 ** DrawLine( WindowHandle, out Row1, out Column1, out Row2, out Column2);
 说明,  draw_line,画一根线。
 
 ** DrawLineMod( WindowHandle, Row1In, Column1In, Row2In, Column2In, out Row1, out Column1, out Row2, out Column2);
 说明,  draw_line_mod,画一根线。
 
 ** EllipticAxis( Regions: X; out Ra, out Rb, out Phi);
 说明,  elliptic_axis,相似椭圆的参数。
 
 ** EllipticAxisGray( Regions: X; Image: X; out Ra, out Rb, out Phi);
 说明,  elliptic_axis_gray,在一个灰度值图像中计算一个区域的方位和主轴。
 
 ** EllipticAxisPointsXld( XLD: X; out Ra, out Rb, out Phi);
 说明,  elliptic_axis_points_xld,被看做点云的轮廓,或多边形（polygon）的等价椭圆参数。
 
 ** EllipticAxisXld( XLD: X; out Ra, out Rb, out Phi);
 说明,  elliptic_axis_xld,轮廓,或多变形（polygon）的等价椭圆参数。
 
 ** ErosionCircle( Region: X; out RegionErosion: X; Radius);
 说明,  erosion_circle,腐蚀一个圆形结构基础的一个区域。
 
 ** ExpandLine( Image: X; out RegionExpand: X; Coordinate, ExpandType, RowColumn, Threshold);
 说明,  expand_line,从给定线开始扩充区域。
 
 ** Find1DBarCodeScanline( Image: X; out CodeRegion: X; BarCodeDescr, GenericName, GenericValue, StopIfFound, out BarcodeFound, out BarCodeElements, out Orientation, out ScanlineNumPoints, out ScanlineDecoded, out ScanlinePointsRow, out ScanlinePointsColumn);
 说明,  find_1d_bar_code_scanline,搜索一幅图像中的一个条形码。
 
 ** FitCircleContourXld( Contours: X; Algorithm, MaxNumPoints, MaxClosureDist,
 
 ** FitEllipseContourXld( Contours: X; Algorithm, MaxNumPoints, MaxClosureDist,
 
 ** FitLineContourXld( Contours: X; Algorithm, MaxNumPoints, ClippingEndPoints, Iterations, ClippingFactor, out RowBegin, out ColBegin, out RowEnd, out ColEnd, out Nr, out Nc, out Dist);
 
 ** FnewLine( FileHandle);
 说明,  fnew_line,创建一个换行符。
 
 ** FreadLine( FileHandle, out OutLine, out IsEOF);
 说明,  fread_line,从一个文本文件中读取一行。
 
 ** GenCircle( out Circle: X; Row, Column, Radius);
 说明,  gen_circle,创建一个圆周。
 
 ** GenCircleContourXld( out ContCircle: X; Row, Column, Radius, StartPhi, EndPhi, PointOrder, Resolution);
 
 ** GenEllipse( out Ellipse: X; Row, Column, Phi, Radius1, Radius2);
 说明,  gen_ellipse,创建一个椭圆。
 
 ** GenEllipseContourXld( out ContEllipse: X; Row, Column, Phi, Radius1, Radius2,
 
 ** GenGridRectificationMap( Image: X; ConnectingLines: X; out Map: X; out Meshes: X; GridSpacing, Rotation, Row, Column, MapType);
 说明,  gen_grid_rectification_map,计算扭曲图像与基于规律的网格的正确的图像的映射。
 
 ** GenRegionHline( out Regions: X; Orientation, Distance);
 说明,  gen_region_hline,将Hesse正规形状中描述的输入线存储为区域。
 
 ** GenRegionLine( out RegionLines: X; BeginRow, BeginCol, EndRow, EndCol);
 说明,  gen_region_line,将输入线以区域形式存储。
 
 ** Get1DBarCodeScanline( BarCodeRegion: X; BarCodeDescr, GenericName, GenericValue, Orientation, StopIfFound, out BarCodeElements, out ScanlineNumPoints, out ScanlineDecoded, out ScanlinePointsRow, out ScanlinePointsColumn);
 说明,  get_1d_bar_code_scanline,提取一个条形码区域中元素的宽度。
 
 ** GetCirclePose( Contour: X; CameraParam, Radius, out putType, out Pose1, out Pose2);
 说明,  get_circle_pose,从一个圆周相应的二维投射中决定它的三维模式。
 
 ** GetLineApprox( WindowHandle, out Approximation);
 说明,  get_line_approx,获取轮廓显示的现在近似误差。
 
 ** GetLineOfSight( Row, Column, CameraParam, out Px, out Py, out Pz, out Qx, out Qy, out Qz);
 说明,  get_line_of_sight,计算相应于图像中一个点的视线。
 
 ** GetLineStyle( WindowHandle, out Style);
 说明,  get_line_style,获取轮廓的现在图解模式。
 
 ** GetLinesXld( Polygon: X; out BeginRow, out BeginCol, out EndRow, out EndCol, out Length, out Phi);
 说明,  get_lines_xld,返回一个XLD多边形（polygon）数据。
 
 ** GetLineWidth( WindowHandle, out Width);
 说明,  get_line_width,获取轮廓显示的现在线宽。
 
 ** GetPointsEllipse( Angle, Row, Column, Phi, Radius1, Radius2, out RowPoint, out ColPoint);
 
 ** HoughCircles( RegionIn: X; out RegionOut: X; Radius, Percent, Mode);
 说明,  hough_circles,特定半径的圆周的中心。
 
 ** HoughCircleTrans( Region: X; out HoughImage: X; Radius);
 说明,  hough_circle_trans,返回指定半径的圆周的Hough变换。
 
 ** HoughLines( RegionIn: X; AngleResolution, Threshold, AngleGap, DistGap, out Angle, out Dist);
 说明,  hough_lines,借助Hough变化查询图像中的线，并将其返回到HNF中。
 
 ** HoughLinesDir( ImageDir: X; out HoughImage: X; out Lines: X; DirectionUncertainty, AngleResolution, Smoothing, FilterSize, Threshold, AngleGap, DistGap, GenLines, out Angle, out Dist);
 说明,  hough_lines_dir,借助采用局部方向梯度的Hough变换查询图像中的线，并将它们以正常形式返回。
 
 ** HoughLineTrans( Region: X; out HoughImage: X; AngleResolution);
 说明,  hough_line_trans,对区域中的线进行Hough变换。
 
 ** HoughLineTransDir( ImageDir: X; out HoughImage: X; DirectionUncertainty, AngleResolution);
 说明,  hough_line_trans_dir,利用局部方向梯度对线进行Hough变换。
 
 ** InnerCircle( Regions: X; out Row, out Column, out Radius);
 说明,  inner_circle,一个区域内部最大的圆周。
 
 ** IntersectionCircleContourXld( Contour: X; CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder, out Row, out Column);
 说明,  计算xld圆形对象交集。
 
 ** IntersectionCircles( Circle1Row, Circle1Column, Circle1Radius, Circle1StartPhi, Circle1EndPhi, Circle1PointOrder, Circle2Row, Circle2Column, Circle2Radius, Circle2StartPhi, Circle2EndPhi, Circle2PointOrder, out Row, out Column, out IsOverlapping);
 说明,  计算圆形对象交集。
 
 ** IntersectionLineCircle( LineRow1, LineColumn1, LineRow2, LineColumn2, CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder, out Row, out Column);
 说明,  计算直线-圆形对象交集。
 
 ** IntersectionLineContourXld( Contour: X; LineRow1, LineColumn1, LineRow2, LineColumn2, out Row, out Column, out IsOverlapping);
 说明,  计算直线-轮廓对象交集。
 
 ** IntersectionLines( Line1Row1, Line1Column1, Line1Row2, Line1Column2, Line2Row1, Line2Column1, Line2Row2, Line2Column2, out Row, out Column, out IsOverlapping);
 说明,  计算直线-直线对象交集。
 
 ** IntersectionSegmentCircle( SegmentRow1, SegmentColumn1, SegmentRow2, SegmentColumn2, CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder, out Row, out Column);
 说明,  计算圆形分段对象交集。
 
 ** IntersectionSegmentLine( SegmentRow1, SegmentColumn1, SegmentRow2, SegmentColumn2, LineRow1, LineColumn1, LineRow2, LineColumn2, out Row, out Column, out IsOverlapping);
 说明,  计算直线分段对象交集。
 
 ** IntersectLinesOfSight( CamParam1, CamParam2, RelPose, Row1, Col1, Row2, Col2, out X, out Y, out Z, out Dist);
 说明,  计算直线的交集。
 
 ** LinearTransColor( Image: X; out ImageTrans: X; TransMat);
 说明,  linear_trans_color,计算多通道图像的颜色值的一个仿射转换。
 
 ** LineOrientation( RowBegin, ColBegin, RowEnd, ColEnd, out Phi);
 说明,  line_orientation,计算线的方位。
 
 ** LinePosition( RowBegin, ColBegin, RowEnd, ColEnd, out RowCenter, out ColCenter, out Length, out Phi);
 说明,  line_position,计算一条线的重心、长度和方位。
 
 ** LinesColor( Image: X; out Lines: X; Sigma, Low, High, ExtractWidth, CompleteJunctions);
 说明,  lines_color,检测色线和它们的宽度。
 
 ** LinesFacet( Image: X; out Lines: X; MaskSize, Low, High, LightDark);
 说明,  lines_facet,使用面模型检测线。
 
 ** LinesGauss( Image: X; out Lines: X; Sigma, Low, High, LightDark, ExtractWidth, LineModel, CompleteJunctions);
 
 ** MergeContLineScanXld( CurrConts: X; PrevConts: X; out CurrMergedConts: X; out PrevMergedConts: X; ImageHeight, Margin, MergeBorder, MaxImagesCont);
 说明,  merge_cont_line_scan_xld,合并连续线扫描图像中的XLD轮廓,。
 
 ** MergeRegionsLineScan( CurrRegions: X; PrevRegions: X; out CurrMergedRegions: X; out PrevMergedRegions: X; ImageHeight, MergeBorder, MaxImagesRegion);
 说明,  merge_regions_line_scan,从行扫描图像合并区域。
 
 ** NewLine( WindowHandle);
 说明,  new_line,设置下一行的开始文本光标的位置。
 
 ** OpenFramegrabber( Name, HorizontalResolution, VerticalResolution, ImageWidth, ImageHeight, StartRow, StartColumn, Field, BitsPerChannel, ColorSpace, Generic, ExternalTrigger, CameraType, Device, Port, LineIn, out AcqHandle);
 说明,  open_framegrabber,打开并配置一个图像获取设备。
 
 ** OpeningCircle( Region: X; out RegionOpening: X; Radius);
 说明,  opening_circle,打开一个圆形结构基础的一个区域。
 
 ** 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);
 说明,  partition_lines,通过各种标准区分线。
 
 ** QueryLineWidth( out Min, out Max);
 说明,  query_line_width,查询可能的线宽。
 
 ** SegmentCharacters( Region: X; Image: X; out ImageForeground: X; out RegionForeground: X; Method, EliminateLines, DotPrint, StrokeWidth, CharWidth, CharHeight, ThresholdOffset, Contrast, out UsedThreshold);
 说明,  segment_characters,将图像给定区域的字符分割。
 
 ** SelectCharacters( Region: X; out RegionCharacters: X; DotPrint, StrokeWidth, CharWidth, CharHeight, Punctuation, DiacriticMarks, PartitionMethod, PartitionLines, FragmentDistance, ConnectFragments, ClutterSizeMax, StopAfter);
 说明,  select_characters,从一个给定区域中选择字符。
 
 ** SelectLines( RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Feature, Operation, Min, Max, out RowBeginOut, out ColBeginOut, out RowEndOut, out ColEndOut);
 说明,  select_lines,通过各种标准选择线。
 
 ** SelectLinesLongest( RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Num, out RowBeginOut, out ColBeginOut, out RowEndOut, out ColEndOut);
 说明,  select_lines_longest,选择最长输入线。
 
 ** SelectMatchingLines( RegionIn: X; out RegionLines: X; AngleIn, DistIn, LineWidth, Thresh, out AngleOut, out DistOut);
 说明,  select_matching_lines,选取HNF中线的集合中匹配区域最好的线。
 
 ** SetLineApprox( WindowHandle, Approximation);
 说明,  set_line_approx,定义输出显示的近似误差。
 
 ** SetLineStyle( WindowHandle, Style);
 说明,  set_line_style,定义一个轮廓输出模式。
 
 ** SetLineWidth( WindowHandle, Width);
 说明,  set_line_width,定义区域轮廓输出的线宽。
 
 ** SmallestCircle( Regions: X; out Row, out Column, out Radius);
 说明,  smallest_circle,一个区域的最小周长。
 
 ** SmallestCircleXld( XLD: X; out Row, out Column, out Radius);
 说明,  smallest_circle_xld,轮廓,或多边形（polygon）的最小封闭圆。
 
 ** SplitSkeletonLines( SkeletonRegion: X; MaxDistance, out BeginRow, out BeginCol, out EndRow, out EndCol);
 
 ** SplitSkeletonRegion( SkeletonRegion: X; out RegionLines: X; MaxDistance);
 
 ** TextLineOrientation( Region: X; Image: X; CharHeight, OrientationFrom, OrientationTo, out OrientationAngle);
 说明,  text_line_orientation,决定一个文本行或段落的定向（定位）。
 
 ** TextLineSlant( Region: X; Image: X; CharHeight, SlantFrom, SlantTo, out SlantAngle);
 说明,  text_line_slant,决定一个文本行或段落的字符的倾斜。
 
 ** UnionCollinearContoursExtXld( Contours: X; out UnionContours: X; MaxDistAbs, MaxDistRel, MaxShift, MaxAngle, MaxOverlap, MaxRegrError, MaxCosts, WeightDist, WeightShift, WeightAngle, WeightLink, WeightRegr, Mode);
 
 ** UnionCollinearContoursXld( Contours: X; out UnionContours: X; MaxDistAbs, MaxDistRel, MaxShift, MaxAngle, Mode);
 
 ** UnionStraightContoursHistoXld( Contours: X; out UnionContours: X; out SelectedContours: X; RefLineStartRow, RefLineStartColumn, RefLineEndRow, RefLineEndColumn, Width, MaxWidth, FilterSize, out HistoValues);
 说明,  union_straight_contours_histo_xld,合并到给定线有相似距离的相邻直线轮廓,。