phot_stereoT_phot_stereoPhotStereophot_stereoPhotStereoPhotStereo (Operator)

Name

phot_stereoT_phot_stereoPhotStereophot_stereoPhotStereoPhotStereo — Reconstruct a surface from at least three gray value images.

Warning

phot_stereophot_stereoPhotStereophot_stereoPhotStereoPhotStereo is obsolete and is only provided for reasons of backward compatibility. New applications should use photometric_stereophotometric_stereoPhotometricStereophotometric_stereoPhotometricStereoPhotometricStereo instead.

Signature

phot_stereo(Images : Height : Slants, Tilts : )

phot_stereophot_stereoPhotStereophot_stereoPhotStereoPhotStereo 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 ImagesImagesImagesImagesImagesimages. The light sources corresponding to the individual images are given by the parameters SlantsSlantsSlantsSlantsSlantsslants and TiltsTiltsTiltsTiltsTiltstilts and are assumed to lie infinitely far away. As phot_stereophot_stereoPhotStereophot_stereoPhotStereoPhotStereo internally uses a fast Fourier transform, the run time of the operator can be influenced by a previous call to optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeed.

Attention

phot_stereophot_stereoPhotStereophot_stereoPhotStereoPhotStereo 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_stereophot_stereoPhotStereophot_stereoPhotStereoPhotStereo. 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. SlantsSlantsSlantsSlantsSlantsslants and TiltsTiltsTiltsTiltsTiltstilts must contain exactly as many light sources as the number of channels in ImagesImagesImagesImagesImagesimages. At least three of the light source directions must be linearly independent.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on internal data level.

Parameters

ImagesImagesImagesImagesImagesimages (input_object) (multichannel-)image → object (byte / uint2)

Shaded input image with at least three channels.

HeightHeightHeightHeightHeightheight (output_object) image → object (real)

Reconstructed height field.

SlantsSlantsSlantsSlantsSlantsslants (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 Slants Slants Slants Slants slants ≤ 180.0 (lin)

Minimum increment: 0.01

Recommended increment: 10.0

TiltsTiltsTiltsTiltsTiltstilts (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 Tilts Tilts Tilts Tilts tilts ≤ 360.0 (lin)

Minimum increment: 0.01

Recommended increment: 10.0

Result

If all parameters are correct phot_stereophot_stereoPhotStereophot_stereoPhotStereoPhotStereo returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.

Possible Predecessors

estimate_sl_al_lrestimate_sl_al_lrEstimateSlAlLrestimate_sl_al_lrEstimateSlAlLrEstimateSlAlLr, estimate_sl_al_zcestimate_sl_al_zcEstimateSlAlZcestimate_sl_al_zcEstimateSlAlZcEstimateSlAlZc, estimate_tilt_lrestimate_tilt_lrEstimateTiltLrestimate_tilt_lrEstimateTiltLrEstimateTiltLr, estimate_tilt_zcestimate_tilt_zcEstimateTiltZcestimate_tilt_zcEstimateTiltZcEstimateTiltZc, optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeed

Possible Successors

shade_height_fieldshade_height_fieldShadeHeightFieldshade_height_fieldShadeHeightFieldShadeHeightField

Module

3D Metrology

Operators