D3DXCreateCubeTextureFromFileInMemory (Fungsi D3DXCreateCubeTextureFromFileInMemory)

Artikel
06/13/2023

Membuat tekstur kubus dari file dalam memori.

Sintaks

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

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

pSrcData [in]

Jenis: LPCVOID

Arahkan ke file dalam memori untuk membuat peta kubus. Lihat Keterangan.

SrcDataSize [in]

Jenis: UINT

Ukuran file dalam memori, dalam byte.

ppCubeTexture [out]

Jenis: LPDIRECT3DCUBETEXTURE9*

Alamat penunjuk ke antarmuka IDirect3DCubeTexture9 , mewakili objek tekstur kubus 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_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

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

Fungsi ini setara dengan D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).

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.

Metode ini dirancang untuk digunakan untuk memuat file gambar yang disimpan sebagai RT_RCDATA, yang merupakan sumber daya yang ditentukan aplikasi (data mentah). Jika tidak, metode ini akan gagal.

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

D3DXCreateCubeTextureFromFileInMemory menggunakan format file permukaan DirectDraw (DDS). Editor Tekstur DirectX (Dxtex.exe) memungkinkan Anda membuat peta kubus dari format file lain dan menyimpannya dalam format file DDS. Anda bisa mendapatkan Dxtex.exe dan mempelajarinya dari DirectX SDK. Untuk informasi tentang DirectX SDK, lihat Di mana DirectX SDK?.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9

Share via