IWICPalette_InitializePredefined

WICBitmapPaletteType で指定された事前定義パレットの 1 つにパレットを初期化し、オプションで透明な色を追加する。

IWICPalette_InitializePredefined this, ePaletteType, fAddTransparentColor

this : [comobj] IWICPalette インターフェースの COM オブジェクト変数
ePaletteType : [int] 型: WICBitmapPaletteType 望ましい事前定義パレット型。
fAddTransparentColor : [int] 型: BOOL パレットに追加するオプションの透明な色。透明な色が不要な場合は 0 を使用する。グレースケールまたは白黒パレットに初期化する場合は、このパラメータを FALSE に設定する。

(プラグイン / モジュール : com_misc.dll)

解説

WICBitmapPaletteType で指定された事前定義パレットの 1 つにパレットを初期化し、オプションで透明な色を追加する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]
透明な色がパレットに追加されると、パレットはもはや事前定義ではなくなり、WICBitmapPaletteTypeCustom
として返される。256 エントリ未満のパレットの場合、透明エントリはパレットの末尾に追加される (つまり、16 色パレットは 17
色パレットになる)。256 色のパレットの場合、透明パレットエントリは事前定義パレットの最後のエントリを置き換える。

情報

プラグイン / モジュールcom_misc.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の com_misc.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_com_misc_gen2.hs