Fungsi D3DXCreateTextureFromResource

Artikel
06/13/2023

Membuat tekstur dari sumber daya.

Sintaks

HRESULT D3DXCreateTextureFromResource(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  HMODULE            hSrcModule,
  _In_  LPCTSTR            pSrcResource,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

Penunjuk ke antarmuka IDirect3DDevice9 , mewakili perangkat yang akan dikaitkan dengan tekstur.

hSrcModule [in]

Jenis: HMODULE

Tangani ke modul tempat sumber daya berada, atau NULL untuk modul yang terkait dengan gambar yang digunakan sistem operasi untuk membuat proses saat ini.

pSrcResource [in]

Jenis: LPCTSTR

Penunjuk ke string yang menentukan nama sumber daya. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data string diselesaikan ke LPCSTR. Lihat Keterangan.

ppTexture [out]

Jenis: LPDIRECT3DTEXTURE9*

Alamat penunjuk ke antarmuka IDirect3DTexture9 , mewakili objek tekstur yang dibuat.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

Pengaturan pengkompilasi juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi menyelesaikan ke D3DXCreateTextureFromResourceW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateTextureFromResourceA karena string ANSI sedang digunakan.

Fungsi ini setara dengan D3DXCreateTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture).

Sumber daya yang dimuat harus berjenis RT_BITMAP atau RT_RCDATA. Jenis sumber daya RT_RCDATA digunakan untuk memuat format selain bitmap (seperti .tga, .jpg, dan .dds).

Fungsi ini mendukung format file berikut: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, dan .tga. Lihat D3DXIMAGE_FILEFORMAT.

Perhatikan bahwa sumber daya yang dibuat dengan fungsi ini ketika dipanggil dari objek IDirect3DDevice9 akan ditempatkan di kelas memori yang ditandai dengan D3DPOOL_MANAGED. Ketika metode ini dipanggil dari objek IDirect3DDevice9Ex, sumber daya akan ditempatkan di kelas memori yang ditandai dengan D3DPOOL_DEFAULT.

Pemfilteran secara otomatis diterapkan ke tekstur yang dibuat menggunakan metode ini. Pemfilteran setara dengan D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER di D3DX_FILTER.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

D3DXCreateTextureFromResourceEx
Fungsi Tekstur di D3DX 9

Share via