crop_contours_xldCropContoursXldCropContoursXldcrop_contours_xldcrop_contours_xld

HALCON ScriptCpp++.NETPythonC

Short description

crop_contours_xldCropContoursXldCropContoursXldcrop_contours_xldcrop_contours_xld — Crop an XLD contour.

Signature

crop_contours_xld( xld_cont Contours, out xld_cont CroppedContours, number Row1, number Col1, number Row2, number Col2, string CloseContours )void CropContoursXld( const HObject& Contours, HObject* CroppedContours, const HTuple& Row1, const HTuple& Col1, const HTuple& Row2, const HTuple& Col2, const HTuple& CloseContours )static void HOperatorSet.CropContoursXld( HObject contours, out HObject croppedContours, HTuple row1, HTuple col1, HTuple row2, HTuple col2, HTuple 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

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 )

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)

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 )

Description

crop_contours_xldCropContoursXld crops all XLD contours given in Contourscontourscontours, i.e., only contour segments contained in the rectangle given by Row1row1row_1, Col1col1col_1, Row2row2row_2 and Col2col2col_2 are returned on output. While in clip_contours_xldClipContoursXld 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 CloseContourscloseContoursclose_contours. If it is set to '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", all contours end at the points where they leave the cropping rectangle. The resulting contours are returned in CroppedContourscroppedContourscropped_contours.

Execution information

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

Contourscontourscontours (input_object) xld_cont(-array) → objectHObjectHXLDContHObjectHobject

Input contours.

CroppedContourscroppedContourscropped_contours (output_object) xld_cont(-array) → objectHObjectHXLDContHObjectHobject *

Output contours.

Row1row1row_1 (input_control) number → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Upper border of the cropping rectangle.

Default: 00
Suggested values: 0, 500, 1000, 1500, 20000, 500, 1000, 1500, 2000

Col1col1col_1 (input_control) number → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Left border of the cropping rectangle.

Default: 00
Suggested values: 0, 500, 1000, 1500, 20000, 500, 1000, 1500, 2000

Row2row2row_2 (input_control) number → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Lower border of the cropping rectangle.

Default: 512512
Suggested values: 512, 1024, 1536, 2048512, 1024, 1536, 2048

Col2col2col_2 (input_control) number → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Right border of the cropping rectangle.

Default: 512512
Suggested values: 512, 1024, 1536, 2048512, 1024, 1536, 2048

CloseContourscloseContoursclose_contours (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Should closed contours produce closed output contours?

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

Combinations with other operators

Combinations

Alternatives

clip_contours_xldClipContoursXld

See also

clip_regionClipRegion, crop_partCropPart, clip_contours_xldClipContoursXld

Module

Foundation