D3DXCreateTextureFromFile (Fungsi D3DXCreateTextureFromFile)

Membuat tekstur dari file.

Sintaks

HRESULT D3DXCreateTextureFromFile(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCTSTR            pSrcFile,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

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

pSrcFile [in]

Jenis: LPCTSTR

Penunjuk ke string yang menentukan nama file. 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 kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXCreateTextureFromFileW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateTextureFromFileA karena string ANSI sedang digunakan.

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

Fungsi ini setara dengan D3DXCreateTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture).

Tekstur mipmapped secara otomatis memiliki setiap tingkat yang diisi dengan tekstur yang dimuat.

Saat memuat gambar ke dalam tekstur mipmapped, beberapa perangkat tidak dapat masuk ke gambar 1x1 dan fungsi ini akan gagal. Jika ini terjadi, gambar perlu dimuat secara manual.

Perhatikan bahwa sumber daya yang dibuat dengan fungsi ini akan ditempatkan di kelas memori yang ditandai dengan D3DPOOL_MANAGED.

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

Untuk performa terbaik saat menggunakan D3DXCreateTextureFromFile:

1. Melakukan penskalakan gambar dan konversi format pada waktu pemuatan bisa menjadi lambat. Simpan gambar dalam format dan resolusi yang akan digunakan. Jika perangkat keras target memerlukan daya dua dimensi, buat dan simpan gambar menggunakan kekuatan dua dimensi.
2. Pertimbangkan untuk menggunakan file permukaan DirectDraw (DDS). Karena file DDS dapat digunakan untuk mewakili format tekstur Direct3D 9, file D3DX sangat mudah dibaca. Selain itu, mereka dapat menyimpan mipmap, sehingga algoritma generasi mipmap apa pun dapat digunakan untuk menulis gambar.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

D3DXCreateTextureFromFileEx

Fungsi Tekstur di D3DX 9