HALCON Website / HALCON Operator Reference / 3D Reconstruction / Photometric Stereo
ClassesClassesClassesClasses | | | | Operators

estimate_al_amestimate_al_amEstimateAlAmestimate_al_amEstimateAlAmEstimateAlAm (Operator)

Name

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

Signature

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)

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

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

HTuple HImage::EstimateAlAm(HTuple* Ambient) const

double HImage::EstimateAlAm(double* Ambient) const

void HOperatorSetX.EstimateAlAm(
[in] IHUntypedObjectX* Image, [out] VARIANT* Albedo, [out] VARIANT* Ambient)

VARIANT HImageX.EstimateAlAm([out] VARIANT* Ambient)

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

HTuple HImage.EstimateAlAm(out HTuple ambient)

double HImage.EstimateAlAm(out double ambient)

Description

estimate_al_amestimate_al_amEstimateAlAmestimate_al_amEstimateAlAmEstimateAlAm estimates the AlbedoAlbedoAlbedoAlbedoAlbedoalbedo of a surface, i.e. the percentage of light reflected by the surface, and the amount of ambient light AmbientAmbientAmbientAmbientAmbientambient 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.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  singlechannelimage(-array) → objectHImageHImageHImageHImageXHobject (byte)

Image for which albedo and ambient are to be estimated.

AlbedoAlbedoAlbedoAlbedoAlbedoalbedo (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Amount of light reflected by the surface.

AmbientAmbientAmbientAmbientAmbientambient (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Amount of ambient light.

Result

estimate_al_amestimate_al_amEstimateAlAmestimate_al_amEstimateAlAmEstimateAlAm always returns the value 2 (H_MSG_TRUE).

Possible Successors

sfs_mod_lrsfs_mod_lrSfsModLrsfs_mod_lrSfsModLrSfsModLr, sfs_orig_lrsfs_orig_lrSfsOrigLrsfs_orig_lrSfsOrigLrSfsOrigLr, sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland, photometric_stereophotometric_stereoPhotometricStereophotometric_stereoPhotometricStereoPhotometricStereo, shade_height_fieldshade_height_fieldShadeHeightFieldshade_height_fieldShadeHeightFieldShadeHeightField

Module

3D Metrology

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH