Herror ::zero_crossing_sub_pix (
    Hobject Image,
    Hobject *ZeroCrossings
)
HXLDContArray HImage::ZeroCrossingSubPix (
    void
) const

Extract zero crossings from an image with subpixel accuracy.

::zero_crossing_sub_pix extracts the zero crossings of the input image Image with subpixel accuracy. The extracted zero crossings are returned as XLD-contours in ZeroCrossings. Thus, ::zero_crossing_sub_pix can be used as a sub-pixel precise edge extractor if the input image is a Laplace-filtered image (see ::laplace, ::laplace_of_gauss, ::derivate_gauss).

For the extraction, the input image is regarded as a surface, in which the gray values are interpolated bilinearly between the centers of the individual pixels. Consistent with the surface thus defined, zero crossing lines are extracted for each pixel and linked into topologically sound contours. This means that the zero crossing contours are correctly split at junction points. If the image contains extended areas of constant gray value 0, only the border of such areas is returned as zero crossings.


Parameters

Image (input_object)
singlechannelimage -> Hobject: HImage ( int1 / int2 / int4 / real )
Input image.

ZeroCrossings (output_object)
xld_cont-array -> Hobject * : HXLDContArray
Extracted zero crossings.


Example
/* Detection zero crossings of the Laplacian-of-Gaussian of aerial image */
HWindow Window(0,0,512,512);
HImage Image("mreut");
HImage Laplace = Image.DerivateGauss(3,"laplace");
HXLDContArray ZeroCrossings = Laplace.ZeroCrossingsSubPix();
ZeroCrossings.Display(Window);

/* Detection of edges, i.e, zero crossings of the Laplacian-of-Gaussian
   that have a large gradient magnitude, in an aerial image */
HWindow Window(0,0,512,512);
HImage Image("mreut");
Sigma = 1.5;
/* Compensate the threshold for the fact that derivate_gauss(...,'gradient')
   calculates a Gaussian-smoothed gradient, in which the edge amplitudes
   are too small because of the Gaussian smoothing, to correspond to a true
   edge amplitude of 20. */
Threshold = 20/(Sigma*sqrt(2*PI));
HImage Gradient = Image.DerivateGauss(Sigma,"gradient");
HRegion Region = Gradient.Threshold(Threshold,255);
HImage ImageReduced = Image.ReduceDomain(Region);
HImage Laplace = ImageReduced.DerivateGauss(Sigma,"laplace");
HXLDContArray Edges = Laplace.ZeroCrossingSubPix();
Edges.Display(Window);

Result

::zero_crossing_sub_pix usually returns the value H_MSG_TRUE. If necessary, an exception is raised.


Possible Predecessors

::laplace, ::laplace_of_gauss, ::diff_of_gauss, ::derivate_gauss


Alternatives

::zero_crossing


Module

Sub-pixel operators



Copyright © 1996-2002 MVTec Software GmbH