Histogrammeffekt

Verwenden Sie den Histogrammeffekt, um ein Histogramm für die Eingabe-Bitmap basierend auf der angegebenen Anzahl von Bins zu generieren.

Die CLSID für diesen Effekt ist CLSID_D2D1Histogram.

• Beispiel
• Effekteigenschaften
• Kanalselektoren
• Datenausgabe
• Anmerkungen
• Anforderungen
• Zugehörige Themen

Beispiel

Vorher
Diagramm der Histogrammausgabedaten

ComPtr<ID2D1Effect> histogramEffect;
m_d2dContext->CreateEffect(CLSID_D2D1Histogram, &histogramEffect);

histogramEffect->SetInputEffect(0, m_2DAffineTransformEffectRight.Get());
histogramEffect->SetValue(D2D1_HISTOGRAM_PROP_CHANNEL_SELECT, D2D1_CHANNEL_SELECTOR_G);

m_d2dContext->BeginDraw();
m_d2dContext->DrawImage(histogramEffect.Get());
m_d2dContext->EndDraw();

// The histogram data is only available once the effect has been 'drawn'.
int histogramBinCount;

HRESULT hr = histogramEffect->GetValue(D2D1_HISTOGRAM_PROP_NUM_BINS, &histogramBinCount);

float *histogramData = new float[histogramBinCount];
hr = histogramEffect->GetValue(D2D1_HISTOGRAM_PROP_HISTOGRAM_OUTPUT, 
                               reinterpret_cast<BYTE*>(histogramData), 
                               histogramBinCount * sizeof(float));

Effekteigenschaften

Hier ist die Formel zum Generieren der Ausgabe.

i wird von 0 bis zur Anzahl der Behälter ausgewertet. Der Effekt generiert ein Histogramm für Pixelwerte zwischen 0 und 1. Werte außerhalb dieses Bereichs werden an den Bereich geklemmt. Der Bereich eines bestimmten Buckets hängt von der Anzahl der Buckets ab. Dieser Effekt funktioniert bei geraden Bitmappixeln. Die Farbkanäle der Eingabe-Bitmap werden durch den Alphakanal geteilt, um diesen Effekt zu berechnen.

Anzeigename und Indexaufzählung	Typ und Standardwert	BESCHREIBUNG
NumBins D2D1_HISTOGRAM_PROP_NUM_BINS	UINT32 256	Gibt die Anzahl der für das Histogramm verwendeten Bins an. Der Bereich der Intensitätswerte, die in einen bestimmten Bucket fallen, hängt von der Anzahl der angegebenen Buckets ab.
ChannelSelect D2D1_HISTOGRAM_PROP_CHANNEL_SELECT	D2D1_CHANNEL_SELECTOR D2D1_CHANNEL_SELECTOR_R	Gibt den Kanal an, der zum Generieren des Histogramms verwendet wird. Dieser Effekt hat eine einzelne Datenausgabe, die dem angegebenen Kanal entspricht. Weitere Informationen finden Sie unter Kanalselektoren .
HistogrammOutput D2D1_HISTOGRAM_PROP_HISTOGRAM_OUTPUT	FLOAT[] Nur Ausgabeeigenschaft.	Das Ausgabearray.

Kanalselektoren

Enumeration	Beschreibung
D2D1_CHANNEL_SELECTOR_R	Der Effekt generiert die Histogrammausgabe basierend auf dem roten Kanal.
D2D1_CHANNEL_SELECTOR_G	Der Effekt generiert die Histogrammausgabe basierend auf dem grünen Kanal.
D2D1_CHANNEL_SELECTOR_B	Der Effekt generiert die Histogrammausgabe basierend auf dem blauen Kanal.
D2D1_CHANNEL_SELECTOR_A	Der Effekt generiert die Histogrammausgabe basierend auf dem Alphakanal.

Datenausgabe

Dieser Effekt gibt eine FLOAT[] mit der Anzahl der Elemente aus, die der Anzahl der angegebenen Bins entspricht. Jedes Element im FLOAT[] ist ein Float. Der Wert des Elements entspricht der Anzahl der Elemente in diesem Bin.

Bemerkungen

Hinweis

Die CreateEffect-Methode schlägt fehl, wenn das Gerät DirectCompute nicht unterstützt und HRESULT = D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES zurückgibt. Alle DirectX11-Karten und DirectX10-Karten, die DirectCompute unterstützen, können den Effekt verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | Windows Store-Apps]
Unterstützte Mindestversion (Server)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | Windows Store-Apps]
Header	d2d1effects.h
Bibliothek	d2d1.lib, dxguid.lib

Zugehörige Themen

ID2D1Effect