HALCON Website / HALCON Operator-Referenz / Bild / Zugriff
KlassenKlassenKlassenKlassen | | | | Operatoren

get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval (Operator)

Name

get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval — Zugriff auf Grauwerte eines Bildobjektes.

Signatur

get_grayval(Image : : Row, Column : Grayval)

Herror get_grayval(const Hobject Image, const Hlong Row, const Hlong Column, double* Grayval)

Herror T_get_grayval(const Hobject Image, const Htuple Row, const Htuple Column, Htuple* Grayval)

Herror get_grayval(Hobject Image, const HTuple& Row, const HTuple& Column, double* Grayval)

Herror get_grayval(Hobject Image, const HTuple& Row, const HTuple& Column, HTuple* Grayval)

HTuple HImage::GetGrayval(const HTuple& Row, const HTuple& Column) const

void GetGrayval(const HObject& Image, const HTuple& Row, const HTuple& Column, HTuple* Grayval)

HTuple HImage::GetGrayval(const HTuple& Row, const HTuple& Column) const

double HImage::GetGrayval(Hlong Row, Hlong Column) const

void HOperatorSetX.GetGrayval(
[in] IHUntypedObjectX* Image, [in] VARIANT Row, [in] VARIANT Column, [out] VARIANT* Grayval)

VARIANT HImageX.GetGrayval(
[in] VARIANT Row, [in] VARIANT Column)

static void HOperatorSet.GetGrayval(HObject image, HTuple row, HTuple column, out HTuple grayval)

HTuple HImage.GetGrayval(HTuple row, HTuple column)

double HImage.GetGrayval(int row, int column)

Beschreibung

GrayvalGrayvalGrayvalGrayvalGrayvalgrayval ist ein Tupel von Gleitkomma- bzw. ganzen Zahlen, das die Grauwerte ausgewählter Bildpunkte von ImageImageImageImageImageimage liefert. Bei einem mehrkanaligen Bild wird pro Bildpunkt eine Gruppe von Elementen, d.h. ein Grauwert pro Kanal (oder zwei Grauwerte für komplexe oder Vektorfeld-Bilder), zurückgegeben. Die Zeilenkoordinaten der Bildpunkte stehen im Tupel RowRowRowRowRowrow, die Spaltenkoordinaten in ColumnColumnColumnColumnColumncolumn.

Es ist zu beachten, dass get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval den Definitionsbereich des Bildes nicht berücksichtigt. D.h. wenn der Definitionsbereich z.B. mit reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain eingeschränkt wurde, werden auch für Punkte die außerhalb des Definitionsbereichs liegen Grauwerte zurück gegeben.

Achtung

Der Typ der Werte von GrayvalGrayvalGrayvalGrayvalGrayvalgrayval hängt von dem Typ der Grauwerte ab. Der Aufwand von get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval ist relativ hoch. Normalerweise wird der Operator verwendet, um einzelne Grauwerte eines Bildes zu erhalten (z.B. durch get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition gefolgt von get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval). Für die Programmierung von Bildverarbeitungsoperationen wie Filter ist er nicht geeignet. Hier ist es sinnvoller, den Operator get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1 und direkt die C- oder C++-Schnittstelle zum Einbinden von eigenen Prozeduren zu verwenden.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  (multichannel-)image → objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Bild, auf dessen Grauwerte zugegriffen werden soll.

RowRowRowRowRowrow (input_control)  point.y(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Zeilennummern der zu betrachtenden Bildpunkte.

Defaultwert: 0

Wertevorschläge: 0, 64, 128, 256, 512, 1024

Typischer Wertebereich: 0 ≤ Row Row Row Row Row row ≤ 32768 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: 0 <= Row && Row < height(Image)

ColumnColumnColumnColumnColumncolumn (input_control)  point.x(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Spaltennummern der zu betrachtenden Bildpunkte.

Parameteranzahl: Column == Row

Defaultwert: 0

Wertevorschläge: 0, 64, 128, 256, 512, 1024

Typischer Wertebereich: 0 ≤ Column Column Column Column Column column ≤ 32768 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: 0 <= Column && Column < width(Image)

GrayvalGrayvalGrayvalGrayvalGrayvalgrayval (output_control)  grayval(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Grauwerte an den angegebenen Bildpunkten.

Ergebnis

Bei korrekter Besetzung der Parameter liefert get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageread_imageReadImageReadImage

Alternativen

get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1, get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated, get_grayval_contour_xldget_grayval_contour_xldGetGrayvalContourXldget_grayval_contour_xldGetGrayvalContourXldGetGrayvalContourXld

Siehe auch

set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH