Herror ::estimate_al_am (
    Hobject Image,
    double *Albedo,
    double *Ambient
)
Herror ::estimate_al_am (
    Hobject Image,
    HTuple *Albedo,
    HTuple *Ambient
)
double HImage::EstimateAlAm (
    double *Ambient
) const
HTuple HImageArray::EstimateAlAm (
    HTuple *Ambient
) const

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

::estimate_al_am estimates the Albedo of a surface, i.e. the percentage of light reflected by the surface, and the amount of ambient light Ambient 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.


Parameters

Image (input_object)
image(-array) -> Hobject: HImage(Array)
Image for which albedo and ambient are to be estimated.

Albedo (output_control)
real(-array) -> (HTuple.) double *
Amount of light reflected by the surface.

Ambient (output_control)
real(-array) -> (HTuple.) double *
Amount of ambient light.


Result

::estimate_al_am always returns the value H_MSG_TRUE.


Possible Successors

::sfs_mod_lr, ::sfs_orig_lr, ::sfs_pentland, ::phot_stereo, ::shade_height_field


Module

Tools



Copyright © 1996-2002 MVTec Software GmbH