estimate_al_amestimate_al_amEstimateAlAmEstimateAlAm (Operator)


estimate_al_amestimate_al_amEstimateAlAmEstimateAlAm — Estimate the albedo of a surface and the amount of ambient light.


estimate_al_am(Image : : : Albedo, Ambient)

Herror estimate_al_am(const Hobject Image, double* Albedo, double* Ambient)

Herror T_estimate_al_am(const Hobject Image, Htuple* Albedo, Htuple* Ambient)

void EstimateAlAm(const HObject& Image, HTuple* Albedo, HTuple* Ambient)

HTuple HImage::EstimateAlAm(HTuple* Ambient) const

double HImage::EstimateAlAm(double* Ambient) const

static void HOperatorSet.EstimateAlAm(HObject image, out HTuple albedo, out HTuple ambient)

HTuple HImage.EstimateAlAm(out HTuple ambient)

double HImage.EstimateAlAm(out double ambient)


estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmEstimateAlAm estimates the AlbedoAlbedoAlbedoAlbedoalbedo of a surface, i.e. the percentage of light reflected by the surface, and the amount of ambient light AmbientAmbientAmbientAmbientambient by using the maximum and minimum gray values of the image.


It is assumed that the image contains at least one point for which the reflection function assumes its minimum, e.g., points in shadows. Furthermore, it is assumed that the image contains at least one point for which the reflection function assumes its maximum. If this is not the case, wrong values will be estimated.

Execution Information


ImageImageImageImageimage (input_object)  singlechannelimage(-array) objectHImageHImageHobject (byte)

Image for which albedo and ambient are to be estimated.

AlbedoAlbedoAlbedoAlbedoalbedo (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Amount of light reflected by the surface.

AmbientAmbientAmbientAmbientambient (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Amount of ambient light.


estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmEstimateAlAm always returns the value 2 (H_MSG_TRUE).

Possible Successors

sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrSfsModLr, sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrSfsOrigLr, sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandSfsPentland, photometric_stereophotometric_stereoPhotometricStereoPhotometricStereoPhotometricStereo, shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightFieldShadeHeightField


3D Metrology