Operator Reference
split_contours_xld (Operator)
split_contours_xld — Split XLD contours at dominant points.
Signature
Description
split_contours_xld splits the contours which were used
to generate the polygons Polygons at prominent points.
If the mode 'polygon' is selected, the contours are split
at the polygons' control points. In mode 'dominant', they
are split at dominant points, i.e., at points for which the
calculated change of direction is larger than the (empirically
determined) threshold , and for which
in the (empirically determined) neighborhood of
points
no larger change of direction occurs. The contour direction is
determined from the direction of the regression line (i.e., the
least-squares approximating line) through all points in a
neighborhood of Smooth points around a contour point.
The directions thus determined are smoothed with a Gaussian of width
Smooth. Weight is a weighting factor for the
sensitiveness of the operator. The larger Weight is
selected, the less dominant points are found.
Each polygon needs a reference to a contour. If the reference is missing,
because the polygon is e.g., read from a DXF-File, split_contours_xld
returns an error.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
Polygons (input_object) xld_poly(-array) → object
Polygons for which the corresponding contours are to be split.
Contours (output_object) xld_cont(-array) → object
Split contours.
Mode (input_control) string → (string)
Mode for the splitting of the contours.
Default: 'polygon'
List of values: 'dominant', 'polygon'
Weight (input_control) integer → (integer)
Weight for the sensitiveness.
Default: 1
Smooth (input_control) integer → (integer)
Width of the smoothing mask.
Default: 5
Possible Predecessors
Possible Successors
See also
gen_contours_skeleton_xld,
lines_gauss,
lines_facet,
edges_sub_pix
Module
Foundation