Metode IDirect3DDevice9Ex::SetConvolutionMonoKernel (d3d9.h)

  • Artikel

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