HistogrammFormat-Enumeration (gdipluscolormatrix.h)

Die HistogramFormat-Enumeration gibt die Anzahl und den Typ der Histogramme an, die die Farbkanäle einer Bitmap darstellen. Diese Enumeration wird mit der Bitmap::GetHistogram-Methode verwendet.

Syntax

typedef enum HistogramFormat {
  HistogramFormatARGB,
  HistogramFormatPARGB,
  HistogramFormatRGB,
  HistogramFormatGray,
  HistogramFormatB,
  HistogramFormatG,
  HistogramFormatR,
  HistogramFormatA
} ;

Konstanten

HistogramFormatARGB Gibt an, dass die Bitmap::GetHistogram-Methode vier Histogramme zurückgibt: jeweils eines für die Alpha-, Rot-, Grün- und Blaukanäle. Das Alphakanal-Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Das Rotkanalhistogramm wird in den Puffer geschrieben, auf den der channel1-Parameter verweist. Das Green-Channel-Histogramm wird in den Puffer geschrieben, auf den der channel2-Parameter verweist. Das blaukanalige Histogramm wird in den Puffer geschrieben, auf den der channel3-Parameter verweist.
HistogramFormatPARGB Gibt an, dass die Bitmap::GetHistogram-Methode vier Histogramme zurückgibt: jeweils eines für die Alpha-, Rot-, Grün- und Blaukanäle. Die roten, grünen und blauen Kanäle werden jeweils mit dem Alphakanal multipliziert, bevor die Histogramme erstellt werden. Die Bitmap wird nicht dauerhaft geändert, wenn die Farbkanäle mit dem Alphakanal multipliziert werden. Diese Multiplikation dient nur zum Erstellen der Histogramme. Das Alphakanal-Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Das Rotkanalhistogramm wird in den Puffer geschrieben, auf den der channel1-Parameter verweist. Das Green-Channel-Histogramm wird in den Puffer geschrieben, auf den der channel2-Parameter verweist. Das blaukanalige Histogramm wird in den Puffer geschrieben, auf den der channel3-Parameter verweist.
HistogramFormatRGB Gibt an, dass die Bitmap::GetHistogram-Methode drei Histogramme zurückgibt: jeweils eins für die roten, grünen und blauen Kanäle. Das rotkanalige Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Das Green-Channel-Histogramm wird in den Puffer geschrieben, auf den der Channel1-Parameter verweist. Das blaukanalige Histogramm wird in den Puffer geschrieben, auf den der channel2-Parameter verweist. Der channel3-Parameter muss auf NULL festgelegt werden.
HistogramFormatGray Gibt an, dass jedes Pixel in einen Graustufenwert im Bereich von 0 bis 255 konvertiert wird und dann ein Histogramm basierend auf diesem Graustufenwert zurückgegeben wird. Die Bitmap wird durch die Konvertierung in Graustufenwerte nicht dauerhaft geändert. Diese Werte werden nur zum Erstellen des Histogramms berechnet. Das Graustufenhisttogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Die Parameter channel1, channel2 und channel3 müssen auf NULL festgelegt werden.
HistogramFormatB Gibt an, dass die Bitmap::GetHistogram-Methode ein Histogramm für den blauen Kanal zurückgibt. Das Blaue-Kanal-Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Die Parameter channel1, channel2 und channel3 müssen auf NULL festgelegt werden.
HistogramFormatG Gibt an, dass die Bitmap::GetHistogram-Methode ein Histogramm für den grünen Kanal zurückgibt. Das Green-Channel-Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Die Parameter channel1, channel2 und channel3 müssen auf NULL festgelegt werden.
HistogramFormatR Gibt an, dass die Bitmap::GetHistogram-Methode ein Histogramm für den roten Kanal zurückgibt. Das rotkanalige Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Die Parameter channel1, channel2 und channel3 müssen auf NULL festgelegt werden.
HistogramFormatA Gibt an, dass die Bitmap::GetHistogram-Methode ein Histogramm für den Alphakanal zurückgibt. Das Alphakanal-Histogramm wird in den Puffer geschrieben, auf den der channel0-Parameter der Bitmap::GetHistogram-Methode verweist. Die Parameter channel1, channel2 und channel3 müssen auf NULL festgelegt werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	gdipluscolormatrix.h (include Gdiplus.h)