Fungsi D3DXLoadVolumeFromMemory

Artikel
06/13/2023

Memuat volume dari memori.

Sintaks

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

Parameter

pDestVolume [in]

Jenis: LPDIRECT3DVOLUME9

Arahkan ke antarmuka IDirect3DVolume9 . Menentukan volume tujuan, yang menerima gambar.

pDestPalette [in]

Jenis: const PALETTEENTRY*

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

pDestBox [in]

Jenis: const D3DBOX*

Penunjuk ke struktur D3DBOX . Menentukan kotak tujuan. Atur parameter ini ke NULL untuk menentukan seluruh volume.

pSrcMemory [in]

Jenis: LPCVOID

Penunjuk ke sudut kiri atas volume sumber dalam memori.

SrcFormat [in]

Jenis: D3DFORMAT

Anggota jenis enumerasi D3DFORMAT , format piksel volume sumber.

SrcRowPitch [in]

Jenis: UINT

Pitch gambar sumber, dalam byte. Untuk format DXT (format tekstur terkompresi), angka ini harus mewakili ukuran satu baris sel, dalam byte.

SrcSlicePitch [in]

Jenis: UINT

Pitch gambar sumber, dalam byte. Untuk format DXT (format tekstur terkompresi), angka ini harus mewakili ukuran satu ikatan sel, dalam byte.

pSrcPalette [in]

Jenis: const PALETTEENTRY*

Penunjuk ke struktur PALETTEENTRY , palet sumber 256 warna atau NULL.

pSrcBox [in]

Jenis: const D3DBOX*

Penunjuk ke struktur D3DBOX . Menentukan kotak sumber. NULL bukan nilai yang valid untuk parameter ini.

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.

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

Menulis ke permukaan non-level-zero tekstur volume tidak akan menyebabkan persegi panjang kotor diperbarui. Jika D3DXLoadVolumeFromMemory dipanggil dan teksturnya belum kotor (ini tidak mungkin dalam skenario penggunaan normal), aplikasi perlu secara eksplisit memanggil IDirect3DVolumeTexture9::AddDirtyBox pada tekstur volume.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

D3DXLoadVolumeFromFile
D3DXLoadVolumeFromResource
D3DXLoadVolumeFromVolume
Fungsi Tekstur di D3DX 9

Share via