Skip to content

estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmestimate_al_amestimate_al_am🔗

Short description🔗

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

Signature🔗

estimate_al_am( image Image, out real Albedo, out real Ambient )estimate_al_am( Image : : : Albedo, Ambient )void EstimateAlAm( const HObject& Image, HTuple* Albedo, HTuple* Ambient )static void HOperatorSet.EstimateAlAm( HObject image, out HTuple albedo, out HTuple ambient )def estimate_al_am( image: HObject ) -> Tuple[Sequence[float], Sequence[float]]

def estimate_al_am_s( image: HObject ) -> Tuple[float, float]Herror estimate_al_am( const Hobject Image, double* Albedo, double* Ambient )

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

HTuple HImage::EstimateAlAm( HTuple* Ambient ) const

double HImage::EstimateAlAm( double* Ambient ) const

HTuple HImage.EstimateAlAm( out HTuple ambient )

double HImage.EstimateAlAm( out double ambient )

Description🔗

estimate_al_amEstimateAlAm estimates the Albedoalbedoalbedo of a surface, i.e. the percentage of light reflected by the surface, and the amount of ambient light Ambientambientambient by using the maximum and minimum gray values of the image.

Attention🔗

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🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on tuple level.

Parameters🔗

Imageimageimage (input_object) singlechannelimage(-array) → object (byte)object (byte)HObject (byte)HImage (byte)HObject (byte)Hobject (byte)

Image for which albedo and ambient are to be estimated.

Albedoalbedoalbedo (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Amount of light reflected by the surface.

Ambientambientambient (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Amount of ambient light.

Result🔗

estimate_al_amEstimateAlAm always returns the value 2 (H_MSG_TRUE).

Combinations with other operators🔗

Combinations

Possible successors

sfs_mod_lrSfsModLr, sfs_orig_lrSfsOrigLr, sfs_pentlandSfsPentland, photometric_stereoPhotometricStereo, shade_height_fieldShadeHeightField

Module🔗

3D Metrology