HALCON Website / HALCON Operator-Referenz / 3D-Rekonstruktion / Photometrisches Stereo
KlassenKlassen | | Operatoren

shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightField (Operator)

Name

shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightField — Schattieren eines Höhenmodells.

Signatur

shade_height_field(ImageHeight : ImageShade : Slant, Tilt, Albedo, Ambient, Shadows : )

Herror shade_height_field(const Hobject ImageHeight, Hobject* ImageShade, double Slant, double Tilt, double Albedo, double Ambient, const char* Shadows)

Herror T_shade_height_field(const Hobject ImageHeight, Hobject* ImageShade, const Htuple Slant, const Htuple Tilt, const Htuple Albedo, const Htuple Ambient, const Htuple Shadows)

void ShadeHeightField(const HObject& ImageHeight, HObject* ImageShade, const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient, const HTuple& Shadows)

HImage HImage::ShadeHeightField(const HTuple& Slant, const HTuple& Tilt, const HTuple& Albedo, const HTuple& Ambient, const HString& Shadows) const

HImage HImage::ShadeHeightField(double Slant, double Tilt, double Albedo, double Ambient, const HString& Shadows) const

HImage HImage::ShadeHeightField(double Slant, double Tilt, double Albedo, double Ambient, const char* Shadows) const

static void HOperatorSet.ShadeHeightField(HObject imageHeight, out HObject imageShade, HTuple slant, HTuple tilt, HTuple albedo, HTuple ambient, HTuple shadows)

HImage HImage.ShadeHeightField(HTuple slant, HTuple tilt, HTuple albedo, HTuple ambient, string shadows)

HImage HImage.ShadeHeightField(double slant, double tilt, double albedo, double ambient, string shadows)

Beschreibung

shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightFieldShadeHeightField berechnet aus einem Höhenmodell (einer Matrix, deren Einträge Höhen auf einem Gitter angeben) ein Bild, das das betreffende Höhenmodell bei Beleuchtung durch eine unendlich weit entfernte Punktlichtquelle darstellt. Dabei wird angenommen, dass die durch das Höhenmodell beschriebene Oberfläche Lambertsche Reflexionseigenschaften besitzt. Es kann zusätzlich bestimmt werden, ob Schatten berechnet werden sollen oder nicht.

Achtung

shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightFieldShadeHeightField nimmt an, dass die Höhen auf einem Gitter der x- und y-Schrittweite 1 vorliegen. Ist dies nicht der Fall, so sollten die Höhen vorher entsprechend skaliert werden (z.B. durch Division durch die Gitter-Schrittweite), da die Ableitungen sonst als „zu flach“ oder „zu steil“ geschätzt werden. Beispiel: Das Höhenmodell ist an 100*100 Werten auf dem Quadrat [0,1]*[0,1] gegeben. Dann sollten die Höhen zunächst durch 1/100 geteilt werden. Es wird ein rechtshändiges kartesisches Koordinatensystem mit Nullpunkt in der linken unteren Ecke des Bildes verwendet.

Ausführungsinformationen

Parameter

ImageHeightImageHeightImageHeightImageHeightimageHeight (input_object)  singlechannelimage(-array) → objectHImageHImageHobject (byte / int4 / real)

Zu schattierendes Höhenmodell.

ImageShadeImageShadeImageShadeImageShadeimageShade (output_object)  image(-array) → objectHImageHImageHobject * (byte)

Schattiertes Bild.

SlantSlantSlantSlantslant (input_control)  angle.deg → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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

Defaultwert: 0.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 ≤ 180.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 10.0

TiltTiltTiltTilttilt (input_control)  angle.deg → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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

Defaultwert: 0.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 ≤ 360.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 10.0

AlbedoAlbedoAlbedoAlbedoalbedo (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (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 ≤ 5.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.1

Restriktion: Albedo >= 0.0

AmbientAmbientAmbientAmbientambient (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (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 ≤ 1.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.1

Restriktion: Ambient >= 0.0

ShadowsShadowsShadowsShadowsshadows (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Berechnung von Schatten ein- bzw. ausschalten.

Defaultwert: 'false' "false" "false" "false" "false"

Wertevorschläge: 'true'"true""true""true""true", 'false'"false""false""false""false"

Ergebnis

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

Vorgänger

sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrSfsModLr, sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrSfsOrigLr, sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandSfsPentland, photometric_stereophotometric_stereoPhotometricStereoPhotometricStereoPhotometricStereo

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH