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.
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. 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.
|
Images (input_object) |
(multichannel-)image -> object : byte |
| Shaded input image with at least three channels. | |
|
Height (output_object) |
image -> object : real |
| Reconstructed height field. | |
|
Slants (input_control) |
angle.deg-array -> real / integer |
| 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 -> real / integer |
| 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 | |
If all parameters are correct phot_stereo returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.
phot_stereo is reentrant and processed without parallelization.
estimate_sl_al_lr, estimate_sl_al_zc, estimate_tilt_lr, estimate_tilt_zc
3D Metrology
