HALCON Reference Manual 10.0.2

Name

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

Signature

phot_stereo(Images : Height : Slants, Tilts : )

phot_stereophot_stereophot_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 ImagesImagesImagesImagesimages. The light sources corresponding to the individual images are given by the parameters SlantsSlantsSlantsSlantsslants and TiltsTiltsTiltsTiltstilts and are assumed to lie infinitely far away. As phot_stereophot_stereophot_stereoPhotStereoPhotStereo internally uses a fast Fourier transform, the runtime of the operator can be influenced by a previous call to optimize_fft_speedoptimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeed.

Attention

phot_stereophot_stereophot_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_stereophot_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. SlantsSlantsSlantsSlantsslants and TiltsTiltsTiltsTiltstilts must contain exactly as many light sources as the number of channels in ImagesImagesImagesImagesimages. 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

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

Shaded input image with at least three channels.

HeightHeightHeightHeightheight (output_object) image → object (real)

Reconstructed height field.

SlantsSlantsSlantsSlantsslants (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 ≤ 180.0 (lin)

Minimum increment: 0.01

Recommended increment: 10.0

TiltsTiltsTiltsTiltstilts (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 ≤ 360.0 (lin)

Minimum increment: 0.01

Recommended increment: 10.0

Result

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