crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld (Operator)
Name
crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld — 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_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