Name
sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland — Reconstruct a surface from a gray value image.
Herror sfs_pentland(const Hobject Image, Hobject* Height, double Slant, double Tilt, double Albedo, double Ambient)
Herror T_sfs_pentland(const Hobject Image, Hobject* Height, const Htuple Slant, const Htuple Tilt, const Htuple Albedo, const Htuple Ambient)
Herror sfs_pentland(Hobject Image, Hobject* Height, const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient)
HImage HImage::SfsPentland(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient) const
HImageArray HImageArray::SfsPentland(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient) const
void SfsPentland(const HObject& Image, HObject* Height, const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient)
HImage HImage::SfsPentland(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient) const
HImage HImage::SfsPentland(double Slant, double Tilt, double Albedo, double Ambient) const
static void HOperatorSet.SfsPentland(HObject image, out HObject height, HTuple slant, HTuple tilt, HTuple albedo, HTuple ambient)
HImage HImage.SfsPentland(HTuple slant, HTuple tilt, HTuple albedo, HTuple ambient)
HImage HImage.SfsPentland(double slant, double tilt, double albedo, double ambient)
sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland reconstructs a surface (i.e. the relative
height of each image point) using the algorithm of Pentland. The
surface is reconstructed from the input image ImageImageImageImageImageimage.
The light source must be given by the parameters SlantSlantSlantSlantSlantslant,
TiltTiltTiltTiltTilttilt, AlbedoAlbedoAlbedoAlbedoAlbedoalbedo and AmbientAmbientAmbientAmbientAmbientambient, and is
assumed to lie infinitely far away in the direction given by
SlantSlantSlantSlantSlantslant and TiltTiltTiltTiltTilttilt. The parameter
AlbedoAlbedoAlbedoAlbedoAlbedoalbedo determines the albedo of the surface, i.e. the
percentage of light reflected in all directions. AmbientAmbientAmbientAmbientAmbientambient
determines the amount of ambient light falling onto the surface. It
can be set to values greater than zero if, for example, the white
balance of the camera was badly adjusted at the moment the image was
taken.
sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland 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 with the step width after the
call to sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland. A Cartesian coordinate system with
the origin in the lower left corner of the image is used internally.
sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland can only handle byte-images.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Reconstructed height field.
Angle between the light source 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
≤
Slant
Slant
Slant
Slant
Slant
slant
≤
180.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0
TiltTiltTiltTiltTilttilt (input_control) angle.deg → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
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
≤
Tilt
Tilt
Tilt
Tilt
Tilt
tilt
≤
360.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0
Amount of light reflected by the surface.
Default value: 1.0
Suggested values: 0.1, 0.5, 1.0, 5.0
Typical range of values: 0.0
≤
Albedo
Albedo
Albedo
Albedo
Albedo
albedo
≤
5.0 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Albedo >= 0.0
Amount of ambient light.
Default value: 0.0
Suggested values: 0.1, 0.5, 1.0
Typical range of values: 0.0
≤
Ambient
Ambient
Ambient
Ambient
Ambient
ambient
≤
1.0 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Ambient >= 0.0
If all parameters are correct sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland returns the
value 2 (H_MSG_TRUE). Otherwise, an exception is raised.
estimate_al_amestimate_al_amEstimateAlAmestimate_al_amEstimateAlAmEstimateAlAm,
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
shade_height_fieldshade_height_fieldShadeHeightFieldshade_height_fieldShadeHeightFieldShadeHeightField
3D Metrology