wiasDownSampleBuffer 関数 (wiamdef.h)
wiasDownSampleBuffer 関数は、DWORD で整列されたピクセル データのバッファーを取り込み、指定したサイズと解像度にダウンサンプリング (低解像度の画像データを生成) します。
構文
HRESULT wiasDownSampleBuffer(
LONG lFlags,
[in, out] WIAS_DOWN_SAMPLE_INFO *pInfo
);
パラメーター
lFlags
この関数の動作を決定するフラグのセットを指定します。 現時点では、次のフラグのみが定義されています。
旗 | 意味 |
---|---|
WIAS_GET_DOWNSAMPLED_SIZE_ONLY | ダウンサンプリングされたデータをコピー先バッファーにコピーしないでください。 代わりに、 |
[in, out] pInfo
ダウンサンプリング操作に必要なすべての情報を含む WIAS_DOWN_SAMPLE_INFO 構造体へのポインター。
戻り値
成功すると、関数はS_OKを返します。
関数が失敗した場合は、標準の COM エラーまたは WIA エラー コードのいずれかが返されます。
備考
wiasDownSampleBuffer 関数は、次の 2 つの方法のいずれかで使用できます。
呼び出し元は、
ulDownSampledWidth を設定し、WIA_DOWN_SAMPLE_INFO 構造体の ulDownSampledHeight メンバーして、ダウンサンプリング (つまり出力) の幅と高さを指定します。 呼び出し元は、ulDownSampledWidth と ulDownSampledHeightWIA_DOWN_SAMPLE_INFO 構造体のメンバーを 0 に設定し、関数が出力の幅と高さを選択する必要があることを示します。
関数が選択する出力の幅と高さの値を確認するには、lFlags パラメーターを WIAS_GET_DOWNSAMPLED_SIZE_ONLYに設定してこの関数を呼び出します。 戻り値として、ulDownSampledWidth と ulDownSampledHeight メンバー
この関数の呼び出し元は、WIA_DOWN_SAMPLE_INFO 構造体の次のメンバーを入力する必要があります。
ulOriginalWidth を
する ulOriginal Height
ulBitsPerPixel の
ulXRes を
する ulYRes を
する pSrcBuffer を
する
ダウンサンプリングされたデータを受け取るバッファーが既に割り当てられている場合、呼び出し元は次の WIA_DOWN_SAMPLE_INFO 構造体メンバーを入力する必要があります。
ulDestBufSize を
する ulSrcBufSize を
する pDestBuffer を
する
呼び出し元が pDestBuffer
この関数は部分的な出力行を生成できないため、入力バッファー内のスキャン行の数は、スケーリング 係数の整数倍数である必要があります。 たとえば、入力バッファーに 600 dpi でサンプリングされたイメージが含まれているとします。これは、同等の 50 dpi の画像にダウンサンプリングする予定です。 この場合は、元のイメージを 12 の係数でスケールダウンします (600 / 50 = 12 であるため)。 これは、関数が生成する出力行ごとに 12 行の入力行を受け取る必要があることを意味します。
元のイメージの解像度が R
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の |
デスクトップ |
ヘッダー | wiamdef.h (Wiamdef.h を含む) |
ライブラリ | Wiaservc.lib |
DLL | Wiaservc.dll |