Herror ::get_regress_params_xld (
    Hobject Contours,
    HTuple *Length,
    HTuple *Nx,
    HTuple *Ny,
    HTuple *Dist,
    HTuple *Fpx,
    HTuple *Fpy,
    HTuple *Lpx,
    HTuple *Lpy,
    HTuple *Mean,
    HTuple *Deviation
)
HTuple HXLDContArray::GetRegressParamsXld (
    HTuple *Nx,
    HTuple *Ny,
    HTuple *Dist,
    HTuple *Fpx,
    HTuple *Fpy,
    HTuple *Lpx,
    HTuple *Lpy,
    HTuple *Mean,
    HTuple *Deviation
) const

Return XLD contour parameters.

::get_regress_params_xld returns the following parameters for all XLD contours given in Contours: 

- the number of contour points Length,
- the coordinates Nx and Ny of the normal vector of the regression
  line (i.e., least-squares approximating line),
- the distance Dist of the regression line to the origin
- the sub-pixel precise coordinates Fpx and Fpy of the perpendicular
  projection of the start point of the contour onto the regression
  line,
- the sub-pixel precise coordinates Lpx and Lpy of the perpendicular
  projection of the end point of the contour onto the regression
  line,
- the mean of the Euclidian distance of the contour points from the
  regression line,
- the standard deviation of these distances.

Attention

Before the contour parameters can be returned by ::get_regress_params_xld, the parameters of the regression line to the contour must be calculated by calling ::regress_contours_xld.

Parameters

Contours (input_object)
 xld_cont-array -> Hobject: HXLDContArray
Input XLD contours.

Length (output_control)
 integer-array -> HTuple.long *
Number of contour points.

Nx (output_control)
 point.x-array -> HTuple.double *
X-coordinate of the normal vector of the regression line.

Ny (output_control)
 point.y-array -> HTuple.double *
Y-coordinate of the normal vector of the regression line.

Dist (output_control)
 number-array -> HTuple.double *
Distance of the regression line from the origin.

Fpx (output_control)
 point.x-array -> HTuple.double *
X-coordinate of the projection of the start point of the contour onto the regression line.

Fpy (output_control)
 point.y-array -> HTuple.double *
Y-coordinate of the projection of the start point of the contour onto the regression line.

Lpx (output_control)
 point.x-array -> HTuple.double *
X-coordinate of the projection of the end point of the contour onto the regression line.

Lpy (output_control)
 point.y-array -> HTuple.double *
Y-coordinate of the projection of the end point of the contour onto the regression line.

Mean (output_control)
 real-array -> HTuple.double *
Mean distance of the contour points from the regression line.

Deviation (output_control)
 real-array -> HTuple.double *
Standard deviation of the distances from the regression line.

Possible Predecessors

::regress_contours_xld

Possible Successors

::disp_line, ::select_lines, ::line_orientation

See also

::fit_line_contour_xld, ::get_contour_global_attrib_xld, ::query_contour_global_attribs_xld, ::get_contour_xld, ::get_contour_attrib_xld, ::gen_contours_skeleton_xld, ::lines_gauss, ::lines_facet, ::edges_sub_pix

Module

Sub-pixel operators

Copyright © 1996-2002 MVTec Software GmbH