Metode IDirect3DDevice9::SetTexture (d3d9helper.h)

Artikel
08/23/2023

Menetapkan tekstur ke tahap untuk perangkat.

Sintaks

HRESULT SetTexture(
  [in] DWORD                 Stage,
  [in] IDirect3DBaseTexture9 *pTexture
);

Parameter

[in] Stage

Jenis: DWORD

Nomor sampler berbasis nol. Tekstur terikat dengan sampler; sampler menentukan status pengambilan sampel seperti mode pemfilteran dan mode pembungkusan alamat. Tekstur direferensikan secara berbeda oleh alur fungsi yang dapat diprogram dan tetap:

Tekstur referensi shader yang dapat diprogram menggunakan nomor sampler. Jumlah sampel yang tersedia untuk shader yang dapat diprogram tergantung pada versi shader. Untuk shader vertex, lihat Sampler (Direct3D 9 asm-vs). Untuk pemecah piksel lihat Sampler (Direct3D 9 asm-ps).
Alur fungsi tetap di sisi lain, mereferensikan tekstur berdasarkan nomor tahap tekstur. Jumlah maksimum sampler ditentukan dari dua huruf besar: MaxSimultaneousTextures dan MaxTextureBlendStages dari struktur D3DCAPS9 .

Ada dua kasus khusus lainnya untuk nomor tahap/sampel.

Nomor khusus yang disebut D3DDMAPSAMPLER digunakan untuk Pemetaan Perpindahan (Direct3D 9).
Shader vertex yang dapat diprogram menggunakan nomor khusus yang ditentukan oleh D3DVERTEXTEXTURESAMPLER saat mengakses Tekstur Vertex di vs_3_0 (DirectX HLSL).

[in] pTexture

Jenis: IDirect3DBaseTexture9*

Penunjuk ke antarmuka IDirect3DBaseTexture9 , mewakili tekstur yang diatur.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

SetTexture tidak diperbolehkan jika tekstur dibuat dengan jenis kumpulan D3DPOOL_SCRATCH. SetTexture tidak diizinkan dengan jenis kumpulan tekstur D3DPOOL_SYSTEMMEM kecuali DevCaps diatur dengan D3DDEVCAPS_TEXTURESYSTEMMEMORY.