共用方式為


IDirect3DDevice9::SetPaletteEntries 方法 (d3d9helper.h)

設定調色盤專案。

語法

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

參數

[in] PaletteNumber

類型: UINT

識別要執行作業的特定調色盤的序數值。

[in] pEntries

類型:const PALETTEENTRY*

PALETTEENTRY結構的指標,代表要設定的調色盤專案。 pEntries 所指向的 PALETTEENTRY 結構數目假設為 256。 請參閱<備註>。

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果方法失敗,則傳回值可以D3DERR_INVALIDCALL。

備註

對於 Direct3D 9 應用程式,傳送至此方法的任何調色盤都必須符合 D3DCAPS9 結構的D3DPTEXTURECAPS_ALPHAPALETTE功能位。 如果未設定D3DPTEXTURECAPS_ALPHAPALETTE,調色盤中的每個專案都必須設定為 1.0,否則此方法將會失敗並D3DERR_INVALIDCALL。 如果已設定D3DPTEXTURECAPS_ALPHAPALETTE,則允許任何一組 Alpha 值。 請注意,如果所有調色盤專案都設定為 0,偵錯執行時間將會列印警告訊息。

單一邏輯調色盤與裝置相關聯,且會由所有紋理階段共用。

需求

   
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9::GetCurrentTexturePalette

IDirect3DDevice9::GetPaletteEntries

IDirect3DDevice9::SetCurrentTexturePalette

紋理選擇區 (Direct3D 9)