IDirect3DDevice9Ex::SetConvolutionMonoKernel-Methode (d3d9.h)

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

Weitere Informationen

IDirect3DDevice9Ex