gray_histo_absT_gray_histo_absGrayHistoAbsGrayHistoAbs (Operator)

Name

gray_histo_absT_gray_histo_absGrayHistoAbsGrayHistoAbs — Verteilung der Grauwerte.

Signatur

gray_histo_abs(Regions, Image : : Quantization : AbsoluteHisto)

Herror T_gray_histo_abs(const Hobject Regions, const Hobject Image, const Htuple Quantization, Htuple* AbsoluteHisto)

void GrayHistoAbs(const HObject& Regions, const HObject& Image, const HTuple& Quantization, HTuple* AbsoluteHisto)

HTuple HImage::GrayHistoAbs(const HRegion& Regions, const HTuple& Quantization) const

HTuple HImage::GrayHistoAbs(const HRegion& Regions, double Quantization) const

HTuple HRegion::GrayHistoAbs(const HImage& Image, const HTuple& Quantization) const

HTuple HRegion::GrayHistoAbs(const HImage& Image, double Quantization) const

static void HOperatorSet.GrayHistoAbs(HObject regions, HObject image, HTuple quantization, out HTuple absoluteHisto)

HTuple HImage.GrayHistoAbs(HRegion regions, HTuple quantization)

HTuple HImage.GrayHistoAbs(HRegion regions, double quantization)

HTuple HRegion.GrayHistoAbs(HImage image, HTuple quantization)

HTuple HRegion.GrayHistoAbs(HImage image, double quantization)

Beschreibung

gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbs berechnet für das übergebene Bild (ImageImageImageImageimage) innerhalb von RegionsRegionsRegionsRegionsregions das absolute (AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHisto)) Histogramm der Grauwerte.

Der Parameter QuantizationQuantizationQuantizationQuantizationquantization bestimmt die Granularität des Histogramms und gibt an, wieviele Häufigkeitswerte von benachbarte Grauwerten zu einem Häufigkeitswert zusammengefasst werden. Das resultierende Histogramm AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHisto ist ein Tupel, dessen Indizes sich auf die Grauwerte des Eingabebildes ImageImageImageImageimage abbilden und dessen Elemente die Grauwerthäufigkeiten enthalten. Die Indizes i der Häufigkeitswerte berechnen sich aus den Grauwerten g und der Quantisierung q daher durch: wobei MIN den minimalen Grauwert bezeichnet, beispielsweise -128 für den int1 Bildtyp. Die Größe des Tupels ergibt sich folglich aus dem Verhältnis vom Gauwertebereich und der Quantelung, für int2 Bilder und der Quantelung 3.0 beispielsweise zu . Der Null-Grauwert wird bei den vorzeichenbehafteten Bildtypen int1 b.z.w. int2 auf den Index 128 b.z.w. 32768 abgebildet, negative b.z.w. positive Grauwerte haben entsprechend kleinere b.z.w. größere Indizes.

Mit set_paint(::WindowHandle,'histogram':)set_paint(WindowHandle,"histogram")SetPaint(WindowHandle,"histogram")SetPaint(WindowHandle,"histogram")SetPaint(WindowHandle,"histogram") und disp_imagedisp_imageDispImageDispImageDispImage kann das Histogramm auch direkt als Graphik ausgegeben werden.

Achtung

Der Operator gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbs berücksichtigt nur die mittels RegionsRegionsRegionsRegionsregions übergebenen Regionen und ignoriert jede Domäne, die zuvor für das Eingabebild ImageImageImageImageimage festgelegt wurde.

Ausführungsinformationen

Parameter

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHobject

Region, in der das Histogramm berechnet werden soll.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / cyclic / direction / int1 / int2 / uint2)

Bild, dessen Grauwertverteilung berechnet werden soll.

QuantizationQuantizationQuantizationQuantizationquantization (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Quantelung der Grauwerte.

Defaultwert: 1.0

Wertevorschläge: 1.0, 2.0, 3.0, 5.0, 10.0

Restriktion: Quantization >= 1.0

AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHisto (output_control)  histogram-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Absolute Häufigkeiten der Grauwerte.

Ergebnis

gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbs liefert den Wert 2 (H_MSG_TRUE), falls das Bild definierte Grauwerte hat und die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabebilder) wird mit set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>), das bei leerer Region mit set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) festgelegt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

histo_to_threshhisto_to_threshHistoToThreshHistoToThreshHistoToThresh, gen_region_histogen_region_histoGenRegionHistoGenRegionHistoGenRegionHisto

Alternativen

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, intensityintensityIntensityIntensityIntensity, gray_histogray_histoGrayHistoGrayHistoGrayHisto, gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRange

Siehe auch

set_paintset_paintSetPaintSetPaintSetPaint, disp_imagedisp_imageDispImageDispImageDispImage, histo_2dimhisto_2dimHisto2dimHisto2dimHisto2dim, scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxScaleImageMax, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray

Modul

Foundation