Herror ::phot_stereo (
    Hobject Images,
    Hobject *Height,
    const HTuple &Slants,
    const HTuple &Tilts
)
HImage HImage::PhotStereo (
    const HTuple &Slants,
    const HTuple &Tilts
) const

Reconstruct a surface from at least three gray value images.

::phot_stereo reconstructs a surface (i.e., the relative height of each image point) using the algorithm of Woodham from at least three gray value images given by the multi-channel image Images. The light sources corresponding to the individual images are given by the parameters Slants and Tilts and are assumed to lie infinitely far away.


Attention

::phot_stereo assumes that the heights are to be extracted on a lattice with step width 1. If this is not the case, the calculated heights must be multiplied by the step width after the call to ::phot_stereo. A Cartesian coordinate system with the origin in the lower left corner of the image is used internally. Since the operator is based on the Fast Fourier Transform, only square images with an edge length being a power of 2 are accepted. All given images must be byte-images. At least three images must be given in a multi-channel image. Slants and Tilts must contain exactly as many light sources as the number of channels in Images. At least three of the light source directions must be linearly independent.


Parameters

Images (input_object)
(multichannel-)image -> Hobject: HImage
Shaded input image with at least three channels.

Height (output_object)
image -> Hobject * : HImage
Reconstructed height field.

Slants (input_control)
angle.deg-array -> HTuple.double / long
Angle between the light sources and the positive z-axis (in degrees).
Default value: 45.0
Suggested values: 1.0, 5.0, 10.0, 20.0, 40.0, 60.0, 90.0
Typical range of values: 0.0 <= Slants <= 180.0 (lin)
Minimum increment: 0.01
Recommended increment: 10.0

Tilts (input_control)
angle.deg-array -> HTuple.double / long
Angle between the light source and the x-axis after projection into the xy-plane (in degrees).
Default value: 45.0
Suggested values: 1.0, 5.0, 10.0, 20.0, 40.0, 60.0, 90.0
Typical range of values: 0.0 <= Tilts <= 360.0 (lin)
Minimum increment: 0.01
Recommended increment: 10.0


Result

If all parameters are correct ::phot_stereo returns the value H_MSG_TRUE. Otherwise, an exception is raised.


Possible Predecessors

::estimate_sl_al_lr, ::estimate_sl_al_zc, ::estimate_tilt_lr, ::estimate_tilt_zc


Possible Successors

::shade_height_field


Module

Tools



Copyright © 1996-2002 MVTec Software GmbH