get_contour_angle_xld — Calculate the direction of an XLD contour for each contour point.
get_contour_angle_xld(Contour : : AngleMode, CalcMode, Lookaround : Angles)
get_contour_angle_xld calculates for each point of the XLD
contour Contour the direction of its tangent. Two modes
for the output values can be chosen: By passing 'abs' for
AngleMode, the resulting angles are returned relative to
the horizontal axis as angles between 0 and
(counter-clockwise). By passing 'rel', the
angle difference to the previous contour point is
returned. In this case the range of values is between
and , where negative values indicate a right turn and
positive values indicate a left turn.
There are three different ways of calculating the tangent direction
(CalcMode) of the contour point i using the
contour points in the interval from
to
. By using 'range',
the angle of the line segment between the first and last point of
the interval is used. For 'mean', the average of all
angles between consecutive points of the contour is used. Finally,
for 'regress', the direction of the regression line (the
least squares fit of a line to the contour points in the interval)
is used. Lookaround is a measure of how strongly the
contour is smoothed. The angles are returned in Angles
in radians.
Due to the interval given by Lookaround, the input contour
must have at least
points.
This minimum number of points is required so that the operator
always delivers reasonable output values for the different
parameter settings.
Contour (input_object) xld_cont → object
Input contour.
AngleMode (input_control) string → (string)
Return type of the angles.
Default: 'abs'
List of values: 'abs', 'rel'
CalcMode (input_control) string → (string)
Method for computing the angles.
Default: 'range'
List of values: 'mean', 'range', 'regress'
Lookaround (input_control) integer → (integer)
Number of points to take into account.
Default: 3
Restriction:
Lookaround > 0
Angles (output_control) real-array → (real)
Direction of the tangent to the contour points.
gen_contours_skeleton_xld,
lines_gauss,
lines_facet,
edges_sub_pix
get_contour_xld,
get_contour_attrib_xld
Foundation