ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,D2D1_ALPHA_MODE,ID2D1ImageSourceFromWic**) メソッド (d2d1_3.h)
イメージ ソース内のすべてのピクセル メモリを設定しながら、WIC ビットマップ ソースからイメージ ソース オブジェクトを作成します。
最小限のメモリを使用しながら、イメージが読み込まれ、格納されます。
構文
HRESULT CreateImageSourceFromWic(
[in] IWICBitmapSource *wicBitmapSource,
D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
D2D1_ALPHA_MODE alphaMode,
[out] ID2D1ImageSourceFromWic **imageSource
);
パラメーター
[in] wicBitmapSource
種類: IWICBitmapSource*
イメージ ソースを作成する WIC ビットマップ ソース。
loadingOptions
種類: D2D1_IMAGE_SOURCE_LOADING_OPTIONS
イメージ ソースを作成するためのオプション。 NULL の場合、既定のオプションが使用されます。
alphaMode
種類: D2D1_ALPHA_MODE
画像のアルファ モード。これは、D2D1_ALPHA_MODE_UNKNOWNが渡された場合、ソースのピクセル形式から自動的に決定されます。
[out] imageSource
種類: ID2D1ImageSourceFromWic**
新しいイメージ ソース インスタンスを受け取ります。
戻り値
種類: HRESULT
成功した場合はS_OK。それ以外の場合は失敗 HRESULT。
注釈
このメソッドは、イメージの描画に使用できるイメージ ソースを作成します。
このメソッドは、最大テクスチャ サイズを超えるイメージをサポートします。 大きなイメージは、スパース タイル キャッシュ内に内部的に格納されます。
この API では、 CreateBitmapFromWicBitmap でサポートされているのと同じピクセル形式とアルファ モードのセットがサポートされています。
GPU で特定のピクセル形式がサポートされていない場合、このメソッドはD2DERR_UNSUPPORTED_PIXEL_FORMATを返します。 この方法では、画像の外観に影響を与えるガンマやアルファ事前乗算などの調整は適用されません。
alphaMode パラメーターをD2D1_ALPHA_MODE_STRAIGHTに設定することはできません。 alphaMode パラメーターを D2D1_ALPHA_MODE_PREMULTIPLIED または D2D1_ALPHA_MODE_IGNORE に設定してアルファ モードをオーバーライドしない限り、WIC ソースで直線アルファのピクセル形式が使用されている場合、このメソッドは失敗します。
ソースの形式にアルファ チャネルがある場合は、D2D1_ALPHA_MODE_IGNOREを渡す必要があります。
D2D1_ALPHA_MODE_IGNOREが渡され、ソースの形式にアルファ チャネルがある場合、アルファ チャネルは無視されます。
この方法では、JPEG 画像に個別の輝度テクスチャとクロミナンス テクスチャを使用するなど、GPU メモリの使用量を最小限に抑えるために、適切なストレージ形式が自動的に選択されます。
loadingOptions 引数が NULL の場合、D2D は D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONEを使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | d2d1_3.h |
[DLL] | D2d1.dll |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示