IWICBitmapFrameEncode_WriteSource

ビットマップソースをエンコードする。

IWICBitmapFrameEncode_WriteSource this, pIBitmapSource, prc

this : [comobj] IWICBitmapFrameEncode インターフェースの COM オブジェクト変数
pIBitmapSource : [comobj] 型: IWICBitmapSource* エンコードするビットマップソース。
prc : [var] 型: WICRect* ビットマップソースのサイズ矩形。

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

解説

ビットマップソースをエンコードする。

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

[備考]
WriteSource を呼び出す前に SetSize を呼び出していない場合、prc が NULL でなければ prc
で与えられたサイズが使用される。それ以外の場合は、pIBitmapSource で与えられた IWICBitmapSource
のサイズが使用される。WriteSource を呼び出す前に SetPixelFormat
を呼び出していない場合、pIBitmapSource で与えられた IWICBitmapSource
のピクセルフォーマットが使用される。WriteSource を呼び出す前に SetResolution
を呼び出していない場合、pIBitmapSource のピクセルフォーマットが使用される。WriteSource を呼び出す前に
SetPalette を呼び出しておらず、ターゲットピクセルフォーマットがインデックス付きで、pIBitmapSource
のピクセルフォーマットがエンコーダフレームのピクセルフォーマットと一致する場合、pIBitmapSource
のピクセルフォーマットが使用される。GIF
画像をエンコードする際に、グローバルパレットが設定されており、フレームレベルのパレットがユーザーまたはカスタム独立系ソフトウェアベンダ
(ISV) GIF コーデックによって直接設定されていない場合、pIBitmapSource
がフレームレベルのパレットを持っていても、WriteSource はグローバルパレットを使用してフレームをエンコードする。Windows
Vista 以降、累積されたソース矩形の高さの合計が SetSize で設定された値と同じである限り、WriteSource
を繰り返し呼び出すことができる。Windows 8.1 以降、ソース矩形は SetSize
で設定された寸法以上である必要がある。ソース矩形の幅が SetSize
の幅を超える場合、右側の余分なピクセルは無視される。ソース矩形の高さが残りの未使用の高さを超える場合、底部の余分なスキャンラインは無視される。

情報