Operator Reference

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

estimate_sl_al_zcestimate_sl_al_zcEstimateSlAlZcEstimateSlAlZcestimate_sl_al_zc (Operator)

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

Signature

estimate_sl_al_zc(Image : : : Slant, Albedo)

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

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

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

HTuple HImage::EstimateSlAlZc(HTuple* Albedo) const

double HImage::EstimateSlAlZc(double* Albedo) const

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

HTuple HImage.EstimateSlAlZc(out HTuple albedo)

double HImage.EstimateSlAlZc(out double albedo)

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

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

Description

estimate_sl_al_zcestimate_sl_al_zcEstimateSlAlZcEstimateSlAlZcestimate_sl_al_zc 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 Zheng and Chellappa.

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 of 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_zcestimate_sl_al_zcEstimateSlAlZcEstimateSlAlZcestimate_sl_al_zc 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