Win32 API 日本語リファレンス
ホーム › Graphics.Imaging › IWICColorContext

IWICColorContext

COM
📘 Microsoft Learn (日本語) · English
IID3c613a02-34b2-44ea-9a7c-45aea9c6fd6d継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

カラーマネジメントのためのメソッドを公開します。

解説(Remarks)

カラーコンテキストは、カラープロファイルを抽象化したものです。プロファイルは、ファイル(「sRGB Color Space Profile.icm」など)から読み込むか、メモリバッファから読み取るか、または EXIF カラースペースによって定義できます。システムのカラープロファイルディレクトリは、GetColorDirectoryW を呼び出すことで取得できます。

カラーコンテキストは、いったん初期化されると再初期化することはできません。

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT InitializeFromFilename(LPWSTR wzFilename)

指定されたファイルからカラーコンテキストを初期化します。

wzFilenameLPWSTRinファイルの名前。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

カラーコンテキストは、いったん初期化されると再初期化することはできません。

vtbl 4 HRESULT InitializeFromMemory(BYTE* pbBuffer, DWORD cbBufferSize)

メモリブロックからカラーコンテキストを初期化します。

pbBufferBYTE*inIWICColorContext の初期化に使用するバッファ。
cbBufferSizeDWORDinpbBuffer バッファのサイズ。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

カラーコンテキストは、いったん初期化されると再初期化することはできません。

vtbl 5 HRESULT InitializeFromExifColorSpace(DWORD value)

Exchangeable Image File (EXIF) カラースペースを使用してカラーコンテキストを初期化します。

valueDWORDin

EXIF カラースペースの値。

値 意味
1
 sRGB カラースペース。
2
 Adobe RGB カラースペース。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

カラーコンテキストは、いったん初期化されると再初期化することはできません。

vtbl 6 HRESULT GetType(WICColorContextType* pType)

カラーコンテキストの種類を取得します。(IWICColorContext.GetType)

pTypeWICColorContextType*outカラーコンテキストの WICColorContextType を受け取るポインター。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 7 HRESULT GetProfileBytes(DWORD cbBuffer, BYTE* pbBuffer, DWORD* pcbActual)

カラーコンテキストのプロファイルを取得します。

cbBufferDWORDinpbBuffer バッファのサイズ。
pbBufferBYTE*inoutカラーコンテキストのプロファイルを受け取るポインター。
pcbActualDWORD*outカラーコンテキストのプロファイル全体を取得するために必要な実際のバッファサイズを受け取るポインター。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、コンテキストの種類が WICColorContextProfile の場合にのみ使用してください。

pbBuffer を NULL に設定してこのメソッドを呼び出すと、必要なバッファサイズが pcbActual に返されます。

vtbl 8 HRESULT GetExifColorSpace(DWORD* pValue)

Exchangeable Image File (EXIF) カラースペースのカラーコンテキストを取得します。

pValueDWORD*out

EXIF カラースペースのカラーコンテキストを受け取るポインター。

値 意味
1
 sRGB カラースペース。
2
 Adobe RGB カラースペース。
3 から 65534
 未使用。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、IWICColorContext::GetType が WICColorContextExifColorSpace を示す場合にのみ使用してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IWICColorContext "{3C613A02-34B2-44EA-9A7C-45AEA9C6FD6D}"
#usecom global IWICColorContext IID_IWICColorContext "{}"
#comfunc global IWICColorContext_InitializeFromFilename        3 wstr
#comfunc global IWICColorContext_InitializeFromMemory          4 var,int
#comfunc global IWICColorContext_InitializeFromExifColorSpace  5 int
#comfunc global IWICColorContext_GetType                       6 var
#comfunc global IWICColorContext_GetProfileBytes               7 int,var,var
#comfunc global IWICColorContext_GetExifColorSpace             8 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。