IDirect3DDevice9Ex::SetConvolutionMonoKernel-Methode (d3d9.h)

  • Artikel

Bereiten Sie den Textur-Sampler für die Monochromkonvolutionsfilterung für eine einfarbige Textur vor.

Syntax

HRESULT SetConvolutionMonoKernel(
  [in] UINT  width,
  [in] UINT  height,
  [in] float *rows,
  [in] float *columns
);

Parameter

[in] width

Typ: UINT

Die Breite des Filterkernels; von 1 bis D3DCONVOLUTIONMONO_MAXWIDTH. Der Standardwert ist 1.

[in] height

Typ: UINT

Die Höhe des Filterkernels; von 1 bis D3DCONVOLUTIONMONO_MAXHEIGHT. Der Standardwert ist 1.

[in] rows

Typ: float*

Ein Array von Gewichtungen, eine Gewichtung für jedes Kernelunterelement in der Breite. Dieser Parameter muss NULL sein, wodurch die Gewichtungen dem Standardwert entsprechen.

[in] columns

Typ: float*

Ein Array von Gewichtungen, eine Gewichtung für jedes Kernelunterelement in der Höhe. Dieser Parameter muss NULL sein, wodurch die Gewichtungen dem Standardwert entsprechen.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK.

Hinweise

Diese Methode wurde entwickelt, um eine einzelne Farbtextur zu filtern. Ein monochromer Faltungsfilter ist ein 2D-Boxfilter, bei dem alle Gewichte auf 1,0 festgelegt sind; die Auflösung des Filterkerns reicht von 1 x 1 bis 7 x 7. Wenn die Monochromtexturfilterung auf einen Textur-Sampler festgelegt ist und die Texturstichprobenahme an der Position ausgeführt wird, führt Direct3D Eine Verschachtelung durch.

Es gelten folgende Beschränkungen:

  • Der von dieser Methode angegebene Filter wird als Teil von D3DSBT_PIXELSTATE in Zustandsblöcken aufgezeichnet.
  • Der einzige unterstützte Texturadressmodus ist : D3DPTADDRESSCAPS_BORDER; die Rahmenfarbe ist immer 0.
  • Diese Methode wird für mipmaps nicht unterstützt.
  • Die Verwendung einer nicht monochromen Textur mit Faltungsfilterung führt zu einem Treiberfehler.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9.h
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9Ex