KlassenKlassenKlassenKlassen | | | | Operatoren

sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland (Operator)

Name

sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland — Rekonstruieren der relativen Höhe aus den Grauwerten.

Signatur

sfs_pentland(Image : Height : Slant, Tilt, Albedo, Ambient : )

Herror sfs_pentland(const Hobject Image, Hobject* Height, double Slant, double Tilt, double Albedo, double Ambient)

Herror T_sfs_pentland(const Hobject Image, Hobject* Height, const Htuple Slant, const Htuple Tilt, const Htuple Albedo, const Htuple Ambient)

Herror sfs_pentland(Hobject Image, Hobject* Height, const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient)

HImage HImage::SfsPentland(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient) const

HImageArray HImageArray::SfsPentland(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient) const

void SfsPentland(const HObject& Image, HObject* Height, const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient)

HImage HImage::SfsPentland(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient) const

HImage HImage::SfsPentland(double Slant, double Tilt, double Albedo, double Ambient) const

void HOperatorSetX.SfsPentland(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*Height, [in] VARIANT Slant, [in] VARIANT Tilt, [in] VARIANT Albedo, [in] VARIANT Ambient)

IHImageX* HImageX.SfsPentland(
[in] VARIANT Slant, [in] VARIANT Tilt, [in] VARIANT Albedo, [in] VARIANT Ambient)

static void HOperatorSet.SfsPentland(HObject image, out HObject height, HTuple slant, HTuple tilt, HTuple albedo, HTuple ambient)

HImage HImage.SfsPentland(HTuple slant, HTuple tilt, HTuple albedo, HTuple ambient)

HImage HImage.SfsPentland(double slant, double tilt, double albedo, double ambient)

Beschreibung

Der Operator sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland berechnet nach dem Algorithmus von Pentland aus dem Bild ImageImageImageImageImageimage und einer Lichtquelle, die durch die Parameter SlantSlantSlantSlantSlantslant, TiltTiltTiltTiltTilttilt, AlbedoAlbedoAlbedoAlbedoAlbedoalbedo und AmbientAmbientAmbientAmbientAmbientambient bestimmt wird, die entsprechenden Höhen, die bei der Bilderzeugung vorgelegen haben. Die Lichtquelle liegt dabei im Unendlichen in der Richtung, die durch SlantSlantSlantSlantSlantslant und TiltTiltTiltTiltTilttilt bestimmt werden. Der Parameter AlbedoAlbedoAlbedoAlbedoAlbedoalbedo gibt den Reflexionskoeffizienten der Oberfläche an. AmbientAmbientAmbientAmbientAmbientambient ist ein Maß für die Stärke der Hintergrundbeleuchtung. Dieser Parameter kann auf einen Wert größer als 0 gesetzt werden, falls z.B. der Weißabgleich der Kamera nicht genau vorgenommen worden ist.

Achtung

sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland nimmt an, dass die Höhen auf einem Gitter der Schrittweite 1 vorliegen sollen. Ist das nicht der Fall, so müssen die berechneten Höhen nach Ausführung der Funktion noch mit der Gitterschrittweite multipliziert werden. Es wird ein rechtshändiges kartesisches Koordinatensystem mit Nullpunkt in der linken unteren Ecke des Bildes verwendet. sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland ist nur für Byte-Bilder implementiert.

Parallelisierung

Parameter

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

Das schattierte Bild.

HeightHeightHeightHeightHeightheight (output_object)  image(-array) objectHImageHImageHImageHImageXHobject * (real)

Das rekonstruierte Höhenmodell.

SlantSlantSlantSlantSlantslant (input_control)  angle.deg HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Winkel zwischen der Richtung der Lichtquelle und der positiven z-Achse (im Gradmaß).

Defaultwert: 45.0

Wertevorschläge: 1.0, 5.0, 10.0, 20.0, 40.0, 60.0, 90.0

Typischer Wertebereich: 0.0 ≤ Slant Slant Slant Slant Slant slant ≤ 180.0 (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

TiltTiltTiltTiltTilttilt (input_control)  angle.deg HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Winkel zwischen der Richtung der Lichtquelle nach Projektion in die xy-Ebene und der x-Achse (im Gradmaß).

Defaultwert: 45.0

Wertevorschläge: 1.0, 5.0, 10.0, 20.0, 40.0, 60.0, 90.0

Typischer Wertebereich: 0.0 ≤ Tilt Tilt Tilt Tilt Tilt tilt ≤ 360.0 (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

AlbedoAlbedoAlbedoAlbedoAlbedoalbedo (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Anteil der Strahlung, der von der Oberfläche reflektiert wird.

Defaultwert: 1.0

Wertevorschläge: 0.1, 0.5, 1.0, 5.0

Typischer Wertebereich: 0.0 ≤ Albedo Albedo Albedo Albedo Albedo albedo ≤ 5.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.1

Restriktion: Albedo >= 0.0

AmbientAmbientAmbientAmbientAmbientambient (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Stärke der indirekten Beleuchtung.

Defaultwert: 0.0

Wertevorschläge: 0.1, 0.5, 1.0

Typischer Wertebereich: 0.0 ≤ Ambient Ambient Ambient Ambient Ambient ambient ≤ 1.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.1

Restriktion: Ambient >= 0.0

Ergebnis

Sind die Parameterwerte korrekt, dann liefert sfs_pentlandsfs_pentlandSfsPentlandsfs_pentlandSfsPentlandSfsPentland den Wert 2 (H_MSG_TRUE), sonst eine Fehlermeldung.

Vorgänger

estimate_al_amestimate_al_amEstimateAlAmestimate_al_amEstimateAlAmEstimateAlAm, estimate_sl_al_lrestimate_sl_al_lrEstimateSlAlLrestimate_sl_al_lrEstimateSlAlLrEstimateSlAlLr, estimate_sl_al_zcestimate_sl_al_zcEstimateSlAlZcestimate_sl_al_zcEstimateSlAlZcEstimateSlAlZc, estimate_tilt_lrestimate_tilt_lrEstimateTiltLrestimate_tilt_lrEstimateTiltLrEstimateTiltLr, estimate_tilt_zcestimate_tilt_zcEstimateTiltZcestimate_tilt_zcEstimateTiltZcEstimateTiltZc, optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeed

Nachfolger

shade_height_fieldshade_height_fieldShadeHeightFieldshade_height_fieldShadeHeightFieldShadeHeightField

Modul

3D Metrology


KlassenKlassenKlassenKlassen | | | | Operatoren