Operator Reference

HALCON Operator Reference / 3D Reconstruction / Photometric Stereo
ClassesClasses | | Operators

estimate_sl_al_lrestimate_sl_al_lrEstimateSlAlLrEstimateSlAlLrestimate_sl_al_lr (Operator)

estimate_sl_al_lrestimate_sl_al_lrEstimateSlAlLrEstimateSlAlLrestimate_sl_al_lr — Estimate the slant of a light source and the albedo of a surface.

Signature

estimate_sl_al_lr(Image : : : Slant, Albedo)

Herror estimate_sl_al_lr(const Hobject Image, double* Slant, double* Albedo)

Herror T_estimate_sl_al_lr(const Hobject Image, Htuple* Slant, Htuple* Albedo)

void EstimateSlAlLr(const HObject& Image, HTuple* Slant, HTuple* Albedo)

HTuple HImage::EstimateSlAlLr(HTuple* Albedo) const

double HImage::EstimateSlAlLr(double* Albedo) const

static void HOperatorSet.EstimateSlAlLr(HObject image, out HTuple slant, out HTuple albedo)

HTuple HImage.EstimateSlAlLr(out HTuple albedo)

double HImage.EstimateSlAlLr(out double albedo)

def estimate_sl_al_lr(image: HObject) -> Tuple[Sequence[float], Sequence[float]]

def estimate_sl_al_lr_s(image: HObject) -> Tuple[float, float]

Description

estimate_sl_al_lrestimate_sl_al_lrEstimateSlAlLrEstimateSlAlLrestimate_sl_al_lr estimates the SlantSlantSlantslantslant of a light source, i.e., the angle between the light source and the positive z-axis, and the albedo of the surface in the input image ImageImageImageimageimage, i.e. the percentage of light reflected by the surface, using the algorithm of Lee and Rosenfeld.

Attention

The AlbedoAlbedoAlbedoalbedoalbedo is assumed constant for the entire surface depicted in the image.

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

ImageImageImageimageimage (input_object)  singlechannelimage(-array) → objectHImageHObjectHObjectHobject (byte)

Image for which slant and albedo are to be estimated.

SlantSlantSlantslantslant (output_control)  angle.deg(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Angle between the light sources and the positive z-axis (in degrees).

AlbedoAlbedoAlbedoalbedoalbedo (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Amount of light reflected by the surface.

Result

estimate_sl_al_lrestimate_sl_al_lrEstimateSlAlLrEstimateSlAlLrestimate_sl_al_lr always returns the value 2 ( H_MSG_TRUE) .

Possible Successors

sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrsfs_mod_lr, sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrsfs_orig_lr, sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandsfs_pentland, photometric_stereophotometric_stereoPhotometricStereoPhotometricStereophotometric_stereo, shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightFieldshade_height_field

Module

3D Metrology

ClassesClasses | | Operators