Fungsi D3DXLoadSurfaceFromResource

Memuat permukaan dari sumber daya.

Sintaks

HRESULT D3DXLoadSurfaceFromResource(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          HMODULE            hSrcModule,
  _In_          LPCTSTR            pSrcResource,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

Parameter

pDestSurface [in]

Jenis: LPDIRECT3DSURFACE9

Arahkan ke antarmuka IDirect3DSurface9 . Menentukan permukaan tujuan, yang menerima gambar.

pDestPalette [in]

Jenis: const PALETTEENTRY*

Pointer ke struktur PALETTEENTRY , palet tujuan 256 warna atau NULL.

pDestRect [in]

Jenis: const RECT*

Penunjuk ke struktur RECT . Menentukan persegi tujuan. Atur parameter ini ke NULL untuk menentukan seluruh permukaan.

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.

pSrcRect [in]

Jenis: const RECT*

Penunjuk ke struktur RECT . Menentukan persegi sumber. Atur parameter ini ke NULL untuk menentukan seluruh gambar.

Filter [in]

Jenis: DWORD

Kombinasi satu atau beberapa D3DX_FILTER mengontrol bagaimana gambar difilter. Menentukan D3DX_DEFAULT untuk parameter ini setara dengan menentukan D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Jenis: D3DCOLOR

Nilai D3DCOLOR untuk diganti dengan hitam transparan, atau 0 untuk menonaktifkan colorkey. Ini selalu merupakan warna ARGB 32-bit, terlepas dari format gambar sumber. Alpha signifikan dan biasanya harus diatur ke FF untuk kunci warna buram Dengan demikian, untuk hitam buram, nilainya akan sama dengan 0xFF000000.

pSrcInfo [masuk, keluar]

Jenis: D3DXIMAGE_INFO*

Arahkan ke struktur D3DXIMAGE_INFO untuk diisi dengan deskripsi data dalam file gambar sumber, atau NULL.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu nilai berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Keterangan

Pengaturan kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXLoadSurfaceFromResourceW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXLoadSurfaceFromResourceA karena string ANSI sedang digunakan.

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 menangani konversi ke dan dari format tekstur terkompresi.

Menulis ke permukaan nol non-level tidak akan menyebabkan persegi panjang kotor diperbarui. Jika D3DXLoadSurfaceFromFile dipanggil dan permukaannya belum kotor (ini tidak mungkin dalam skenario penggunaan normal), aplikasi perlu secara eksplisit memanggil AddDirtyRect di permukaan.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9