crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXld (Operator)
Name
crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXld — Crop an XLD contour.
Signature
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)
Description
crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldCropContoursXld 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_xldClipContoursXldClipContoursXldClipContoursXld 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.
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) → objectHXLDContHXLDContHobject
Input contours.
CroppedContoursCroppedContoursCroppedContoursCroppedContourscroppedContours (output_object) xld_cont(-array) → objectHXLDContHXLDContHobject *
Output contours.
Row1Row1Row1Row1row1 (input_control) number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Upper border of the cropping
rectangle.
Default value: 0
Suggested values: 0, 500, 1000, 1500, 2000
Col1Col1Col1Col1col1 (input_control) number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Left border of the cropping rectangle.
Default value: 0
Suggested values: 0, 500, 1000, 1500, 2000
Row2Row2Row2Row2row2 (input_control) number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Lower border of the cropping rectangle.
Default value: 512
Suggested values: 512, 1024, 1536, 2048
Col2Col2Col2Col2col2 (input_control) number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Right border of the cropping rectangle.
Default value: 512
Suggested values: 512, 1024, 1536, 2048
CloseContoursCloseContoursCloseContoursCloseContourscloseContours (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Should closed contours produce closed output
contours?
Default value:
'true'
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"
Alternatives
clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldClipContoursXld
See also
clip_regionclip_regionClipRegionClipRegionClipRegion,
crop_partcrop_partCropPartCropPartCropPart,
clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldClipContoursXld
Module
Foundation