Metode IDirect3DDevice9Ex::SetConvolutionMonoKernel (d3d9.h)

Siapkan sampler tekstur untuk pemfilteran konvolusi monokrom pada tekstur satu warna.

Sintaks

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

Parameter

[in] width

Jenis: UINT

Lebar kernel filter; mulai dari 1 - D3DCONVOLUTIONMONO_MAXWIDTH. Nilai default adalah 1.

[in] height

Jenis: UINT

Tinggi kernel filter; mulai dari 1 - D3DCONVOLUTIONMONO_MAXHEIGHT. Nilai default adalah 1.

[in] rows

Jenis: float*

Array bobot, satu berat untuk setiap sub-elemen kernel dalam lebar. Parameter ini harus NULL, yang akan mengatur bobot yang sama dengan nilai default.

[in] columns

Jenis: float*

Array bobot, satu berat untuk setiap sub-elemen kernel dalam tinggi. Parameter ini harus NULL, yang akan mengatur bobot yang sama dengan nilai default.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK.

Keterangan

Metode ini dirancang untuk memfilter tekstur warna tunggal. Filter konvolusi monokrom adalah filter kotak 2D dengan semua bobot diatur ke 1,0; resolusi kernel filter berkisar antara 1 x 1 hingga 7 x 7. Saat pemfilteran tekstur monokrom diatur ke sampler tekstur dan pengambilan sampel tekstur dilakukan di lokasi, maka Direct3D melakukan konvolusi.

Pembatasan meliputi:

• Filter yang ditentukan oleh metode ini dicatat dalam blok status sebagai bagian dari D3DSBT_PIXELSTATE.
• Satu-satunya mode alamat tekstur yang didukung adalah: D3DPTADDRESSCAPS_BORDER; warna batas selalu 0.
• Metode ini tidak didukung untuk mipmaps.
• Menggunakan tekstur non-monokrom dengan pemfilteran konvolusi akan menghasilkan kesalahan driver.

Persyaratan

Target Platform	Windows
Header	d3d9.h
Pustaka	D3D9.lib

Lihat juga

IDirect3DDevice9Ex