HALCON Reference Manual 10.0.2
Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators

crop_contours_xldcrop_contours_xldcrop_contours_xldCropContoursXldCropContoursXld (Operator)

Name

crop_contours_xldcrop_contours_xldcrop_contours_xldCropContoursXldCropContoursXld — 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)

Herror crop_contours_xld(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 HTuple& CloseContours) const

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

void HOperatorSetX.CropContoursXld(
[in] IHUntypedObjectX* Contours, [out] IHUntypedObjectX** CroppedContours, [in] VARIANT Row1, [in] VARIANT Col1, [in] VARIANT Row2, [in] VARIANT Col2, [in] VARIANT CloseContours)

IHXLDContX* HXLDContX.CropContoursXld(
[in] VARIANT Row1, [in] VARIANT Col1, [in] VARIANT Row2, [in] VARIANT Col2, [in] BSTR CloseContours)

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)

Description

crop_contours_xldcrop_contours_xldcrop_contours_xldCropContoursXldCropContoursXld crops all XLD contours given in ContoursContoursContoursContourscontours, i.e., only contour segments contained in the rectangle given by Row1Row1Row1Row1row1, Col1Col1Col1Col1col1, Row2Row2Row2Row2row2 and Col2Col2Col2Col2col2 are returned on output. While in clip_contours_xldclip_contours_xldclip_contours_xldClipContoursXldClipContoursXld 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 CloseContoursCloseContoursCloseContoursCloseContourscloseContours. 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 CroppedContoursCroppedContoursCroppedContoursCroppedContourscroppedContours.

Parallelization

Parameters

ContoursContoursContoursContourscontours (input_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContXHobject

Input contours.

CroppedContoursCroppedContoursCroppedContoursCroppedContourscroppedContours (output_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContXHobject *

Output contours.

Row1Row1Row1Row1row1 (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Upper border of the cropping rectangle.

Default value: 0

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

Col1Col1Col1Col1col1 (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Left border of the cropping rectangle.

Default value: 0

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

Row2Row2Row2Row2row2 (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Lower border of the cropping rectangle.

Default value: 512

Suggested values: 512, 1024, 1536, 2048

Col2Col2Col2Col2col2 (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Right border of the cropping rectangle.

Default value: 512

Suggested values: 512, 1024, 1536, 2048

CloseContoursCloseContoursCloseContoursCloseContourscloseContours (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Should closed contours produce closed output contours?

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

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

Alternatives

clip_contours_xldclip_contours_xldclip_contours_xldClipContoursXldClipContoursXld

See also

clip_regionclip_regionclip_regionClipRegionClipRegion, crop_partcrop_partcrop_partCropPartCropPart, clip_contours_xldclip_contours_xldclip_contours_xldClipContoursXldClipContoursXld

Module

Foundation

Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH