Operator Reference

HALCON Operator Reference / XLD / Transformations
ClassesClasses | | Operators

crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld (Operator)

crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld — Crop an XLD contour.

Signature

crop_contours_xld(Contours : CroppedContours : Row1, Col1, Row2, Col2, CloseContours : )

Herror crop_contours_xld(const Hobject Contours, Hobject* CroppedContours, double Row1, double Col1, double Row2, double Col2, const char* CloseContours)

Herror T_crop_contours_xld(const Hobject Contours, Hobject* CroppedContours, const Htuple Row1, const Htuple Col1, const Htuple Row2, const Htuple Col2, const Htuple CloseContours)

void CropContoursXld(const HObject& Contours, HObject* CroppedContours, const HTuple& Row1, const HTuple& Col1, const HTuple& Row2, const HTuple& Col2, const HTuple& CloseContours)

HXLDCont HXLDCont::CropContoursXld(const HTuple& Row1, const HTuple& Col1, const HTuple& Row2, const HTuple& Col2, const HString& CloseContours) const

HXLDCont HXLDCont::CropContoursXld(double Row1, double Col1, double Row2, double Col2, const HString& CloseContours) const

HXLDCont HXLDCont::CropContoursXld(double Row1, double Col1, double Row2, double Col2, const char* CloseContours) const

HXLDCont HXLDCont::CropContoursXld(double Row1, double Col1, double Row2, double Col2, const wchar_t* CloseContours) const   ( Windows only)

static void HOperatorSet.CropContoursXld(HObject contours, out HObject croppedContours, HTuple row1, HTuple col1, HTuple row2, HTuple col2, HTuple closeContours)

HXLDCont HXLDCont.CropContoursXld(HTuple row1, HTuple col1, HTuple row2, HTuple col2, string closeContours)

HXLDCont HXLDCont.CropContoursXld(double row1, double col1, double row2, double col2, string closeContours)

def crop_contours_xld(contours: HObject, row_1: Union[float, int], col_1: Union[float, int], row_2: Union[float, int], col_2: Union[float, int], close_contours: str) -> HObject

Description

crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld crops all XLD contours given in ContoursContoursContourscontourscontours, i.e., only contour segments contained in the rectangle given by Row1Row1Row1row1row_1, Col1Col1Col1col1col_1, Row2Row2Row2row2row_2 and Col2Col2Col2col2col_2 are returned on output. While in clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld all contour segments that intersect a boundary line are omitted, here they are cropped at the exact intersection point with the cropping rectangle. If necessary, contours are split and several new contours are produced. Closed contours can, however, be closed again using the parameter CloseContoursCloseContoursCloseContourscloseContoursclose_contours. If it is set to 'true'"true""true""true""true", a closed contour is transformed into one or several contours that are closed via segments on the cropping rectangle. If it is 'false'"false""false""false""false", all contours end at the points where they leave the cropping rectangle. The resulting contours are returned in CroppedContoursCroppedContoursCroppedContourscroppedContourscropped_contours.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.

Parameters

ContoursContoursContourscontourscontours (input_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject

Input contours.

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

Output contours.

Row1Row1Row1row1row_1 (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Upper border of the cropping rectangle.

Default: 0

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

Col1Col1Col1col1col_1 (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Left border of the cropping rectangle.

Default: 0

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

Row2Row2Row2row2row_2 (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Lower border of the cropping rectangle.

Default: 512

Suggested values: 512, 1024, 1536, 2048

Col2Col2Col2col2col_2 (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Right border of the cropping rectangle.

Default: 512

Suggested values: 512, 1024, 1536, 2048

CloseContoursCloseContoursCloseContourscloseContoursclose_contours (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Should closed contours produce closed output contours?

Default: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

Alternatives

clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld

See also

clip_regionclip_regionClipRegionClipRegionclip_region, crop_partcrop_partCropPartCropPartcrop_part, clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld

Module

Foundation

ClassesClasses | | Operators