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
| Zielplattform | Windows |
| Kopfzeile | d3d9.h |
| Bibliothek | D3D9.lib |