HALCON Website / HALCON Operator-Referenz / Filter / Texturinspektion
KlassenKlassenKlassenKlassen | | | | Operatoren

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage (Operator)

Name

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage — Standardabweichnung der Grauwerte in Rechteckfenstern.

Signatur

deviation_image(Image : ImageDeviation : Width, Height : )

Herror deviation_image(const Hobject Image, Hobject* ImageDeviation, const Hlong Width, const Hlong Height)

Herror T_deviation_image(const Hobject Image, Hobject* ImageDeviation, const Htuple Width, const Htuple Height)

Herror deviation_image(Hobject Image, Hobject* ImageDeviation, const HTuple& Width, const HTuple& Height)

HImage HImage::DeviationImage(const HTuple& Width, const HTuple& Height) const

HImageArray HImageArray::DeviationImage(const HTuple& Width, const HTuple& Height) const

void DeviationImage(const HObject& Image, HObject* ImageDeviation, const HTuple& Width, const HTuple& Height)

HImage HImage::DeviationImage(Hlong Width, Hlong Height) const

void HOperatorSetX.DeviationImage(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** ImageDeviation, [in] VARIANT Width, [in] VARIANT Height)

IHImageX* HImageX.DeviationImage(
[in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.DeviationImage(HObject image, out HObject imageDeviation, HTuple width, HTuple height)

HImage HImage.DeviationImage(int width, int height)

Beschreibung

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage transformiert die Grauwerte der Eingabebilder aus ImageImageImageImageImageimage mit Hilfe einer Filtermaske (HeightHeightHeightHeightHeightheight, WidthWidthWidthWidthWidthwidth), in der die Standardabweichung der Grauwerte berechnet wird. Um den Grauwertwerteberich des Ergebnisbildes besser auszunutzen, wird das Ergebnis mit 2 multipliziert. Das Ergebnis wird in ImageDeviationImageDeviationImageDeviationImageDeviationImageDeviationimageDeviation übergeben. Die Steuerparameter HeightHeightHeightHeightHeightheight, WidthWidthWidthWidthWidthwidth werden, falls sie jeweils einen geraden Wert haben, zu dem nächstgrößeren ungeraden Wert gewandelt. An den Bildrändern wird eine Spiegelung der Randpunkte durchgeführt.

Achtung

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage kann auf OpenCL Geräten ausgeführt werden. Da der gleiche OpenCL Code verwendet wird, gelten die selben Einschränkungen wie für mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage. Das Ergebnis kann geringfühgig von dem der CPU abweichen, da intern mit einfach genauer Fließkommaarithmetik gerechnet wird.

Beachten Sie, dass Filteroperatoren eventuell unerwartete Resultate ausgeben, wenn ein Bild mit einer reduzierten Domäne als Input übergeben wird. Weitere Informationen können im Kapitel Filter gefunden werden.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) → objectHImageHImageHImageHImageXHobject (byte* / int4* / real* / int2* / uint2*) *erlaubt für Compute Devices

Bilder, für deren Grauwerte die Standardabweichung berechnet werden sollen.

ImageDeviationImageDeviationImageDeviationImageDeviationImageDeviationimageDeviation (output_object)  image(-array) → objectHImageHImageHImageHImageXHobject * (byte / int4 / real / int2 / uint2)

Bilder, die die Standardabweichung enthalten.

WidthWidthWidthWidthWidthwidth (input_control)  extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Breite der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriktion: 3 <= Width && odd(Width)

HeightHeightHeightHeightHeightheight (input_control)  extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Höhe der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriktion: 3 <= Height && odd(Height)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
deviation_image(Image,&Deviation,9,9);
disp_image(Deviation,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage 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.

Nachfolger

disp_imagedisp_imageDispImagedisp_imageDispImageDispImage

Alternativen

entropy_imageentropy_imageEntropyImageentropy_imageEntropyImageEntropyImage, entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray

Siehe auch

convol_imageconvol_imageConvolImageconvol_imageConvolImageConvolImage, texture_lawstexture_lawsTextureLawstexture_lawsTextureLawsTextureLaws, intensityintensityIntensityintensityIntensityIntensity

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH