Class ImageBuffer

備考

状況によっては、イメージバッファオブジェクトが、アプリケーション（イメージバッファオブジェクトのハンドルを保持する側）とライブラリとの間で共有されることがあります。例えば、イメージバッファが表示機能やビデオライターと共有される場合です。

共有されているバッファは、安全に書き込み可能な状態ではありません。共有バッファに書き込みを行うと、予期しない動作が発生する可能性があります。例えば、並行して実行されている処理の結果に、変更内容が一部だけ反映されることがあります。

DisplayBuffer(ImageBuffer) や AddFrame(ImageBuffer) のような関数にイメージバッファを渡すと、バッファが共有状態になることがあります。

備考

other と this の画像のピクセルフォーマットが異なる場合、画像は自動的に変換されます。例えば、other のピクセルフォーマットがBayerRG8、this が BGR8の場合、デモザイク処理によってカラー画像が生成されます。

flags にSkipImage が含まれている場合、画像データはコピーされません。この場合、チャンクデータとメタデータのみがコピーされ、画像コピー処理はアプリケーション側で定義したアルゴリズムに委ねられます。

flags に SkipChunkData が含まれている場合、other に含まれるチャンクデータはコピーされません。チャンクデータが大きく、不要な場合に有用です。

other と this の幅または高さが一致しない場合、処理は失敗し、エラーコード ConversionNotSupported が設定された IC4Exceptionが発生します。

要求された変換に対応するアルゴリズムが存在しない場合も、同様にエラーコード ConversionNotSupported が設定された IC4Exception が発生します。

this が書き込み可能でない場合、処理は失敗し InvalidOperationExceptionが発生します。

備考

元のイメージバッファと、この関数が返す値の両方は、バッファが再利用される前に破棄（またはガベージコレクション）される必要があります。
本関数は、渡されたイメージバッファのライフタイムを延長したい場合に有用です。

備考

この関数は、サードパーティ製ライブラリのバッファへ画像データをコピーする場合に有用です。

• サードパーティ製ライブラリ側で画像オブジェクトを作成する
• FromMemory を使用して、サードパーティ製ライブラリの画像データをイメージバッファとしてラップする
• CopyFrom(ImageBuffer, CopyOptions) を使用して、既存のイメージバッファオブジェクトからサードパーティ製バッファへデータをコピーする

プログラムは画像バッファオブジェクトが存在する限り、bufferPtrが指すメモリが確保されたままであることを確認する必要があります。

この関数で作成されたイメージバッファに対して Dispose() を呼び出すと、イメージバッファオブジェクトは破棄されますが、関連付けられたメモリは解放されません。