Operator Reference

HALCON Operator Reference / XLD / Transformations
ClassesClasses | | Operators

clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld (Operator)

clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld — Clip an XLD contour.

Signature

clip_contours_xld(Contours : ClippedContours : Row1, Column1, Row2, Column2 : )

Herror clip_contours_xld(const Hobject Contours, Hobject* ClippedContours, const Hlong Row1, const Hlong Column1, const Hlong Row2, const Hlong Column2)

Herror T_clip_contours_xld(const Hobject Contours, Hobject* ClippedContours, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)

void ClipContoursXld(const HObject& Contours, HObject* ClippedContours, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)

HXLDCont HXLDCont::ClipContoursXld(Hlong Row1, Hlong Column1, Hlong Row2, Hlong Column2) const

static void HOperatorSet.ClipContoursXld(HObject contours, out HObject clippedContours, HTuple row1, HTuple column1, HTuple row2, HTuple column2)

HXLDCont HXLDCont.ClipContoursXld(int row1, int column1, int row2, int column2)

def clip_contours_xld(contours: HObject, row_1: int, column_1: int, row_2: int, column_2: int) -> HObject

Description

clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld clips all XLD contours given in ContoursContoursContourscontourscontours, i.e., only contour points contained in the rectangle given by Row1Row1Row1row1row_1, Column1Column1Column1column1column_1, Row2Row2Row2row2row_2, and Column2Column2Column2column2column_2 are returned on output. Note, that the rectangle behaves like a region, i.e., the rectangle encloses the pixels completely. If necessary, contours are split, and several new contours are produced. The resulting contours are returned in ClippedContoursClippedContoursClippedContoursclippedContoursclipped_contours.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

ContoursContoursContourscontourscontours (input_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject

Contours to be clipped.

ClippedContoursClippedContoursClippedContoursclippedContoursclipped_contours (output_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject *

Clipped contours.

Row1Row1Row1row1row_1 (input_control)  rectangle.origin.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinate of the upper left corner of the clip rectangle.

Default: 0

Suggested values: 0, 500, 1000, 1500, 2000

Column1Column1Column1column1column_1 (input_control)  rectangle.origin.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinate of the upper left corner of the clip rectangle.

Default: 0

Suggested values: 0, 500, 1000, 1500, 2000

Row2Row2Row2row2row_2 (input_control)  rectangle.corner.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinate of the lower right corner of the clip rectangle.

Default: 512

Suggested values: 512, 1024, 1536, 2048

Column2Column2Column2column2column_2 (input_control)  rectangle.corner.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinate of the lower right corner of the clip rectangle.

Default: 512

Suggested values: 512, 1024, 1536, 2048

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, lines_gausslines_gaussLinesGaussLinesGausslines_gauss, lines_facetlines_facetLinesFacetLinesFacetlines_facet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix

Possible Successors

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld

Alternatives

crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld

See also

clip_regionclip_regionClipRegionClipRegionclip_region, crop_partcrop_partCropPartCropPartcrop_part, crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld

Module

Foundation

ClassesClasses | | Operators