Class ImageBufferExtensions

さまざまなファイル形式のファイルとしてイメージバッファの内容を保存できる、ImageBuffer 用の拡張メソッドを含みます。

継承

object
ImageBufferExtensions

継承されたメンバ

Namespace: ic4
Assembly: ic4dotnet.dll

構文

public static class ImageBufferExtensions

例

メンバーは拡張メソッドとして定義されているため、明示的にも、またメンバー関数であるかのようにイメージバッファに対して直接呼び出すこともできます。
メンバー関数として呼び出すには、ic4 名前空間に対する using ディレクティブが必要です。

using ic4;

// (...)
// Get image buffer from somewhere
ImageBuffer imageBuffer = GetImageBuffer();
// Save image buffer as bitmap file
imageBuffer.SaveAsbitmap("test.bmp");

推奨されませんが、関数を明示的に呼び出すことも可能です。

// Get image buffer from somewhere
ImageBuffer imageBuffer = GetImageBuffer();
// Save image buffer as bitmap file
ImageBufferExtensions.SaveAsbitmap(imageBuffer, "test.bmp");

メソッド

SaveAsBitmap(ImageBuffer, string, bool)

イメージバッファを Bitmap ファイルとして保存します。

宣言

public static void SaveAsBitmap(this ImageBuffer buffer, string filename, bool storeBayerRawDataAsMonochrome = false)

パラメータ

型 名前 説明
ImageBuffer buffer イメージバッファ
string filename 画像ファイルのパス
bool storeBayerRawDataAsMonochrome true の場合、かつイメージバッファのピクセル形式が Bayer 形式のとき、ピクセルデータをモノクロとして解釈し、生データをモノクロ画像として保存します。
備考

イメージバッファのピクセル形式に応じて、保存前に以下の変換が適用されます:

  • モノクロのピクセル形式は Mono8 に変換され、8 ビットのモノクロ Bitmap ファイルとして保存されます。
  • Bayer、RGB、YUV の各ピクセル形式は BGR8 に変換され、24 ビットのカラ― Bitmap ファイルとして保存されます。

例外

型 条件
ArgumentNullException buffer が null、または filename が null の場合
IC4Exception 詳細については ErrorCode および ToString() を確認してください。

SaveAsJpeg(ImageBuffer, string, int)

イメージバッファを Jpeg ファイルとして保存します。

宣言

public static void SaveAsJpeg(this ImageBuffer buffer, string filename, int qualityPercent = 75)

パラメータ

型 名前 説明
ImageBuffer buffer イメージバッファ
string filename 画像ファイルのパス
int qualityPercent Jpeg 画像の品質をパーセンテージで指定します。高品質な画像はディスク使用量が増え、低品質な画像はファイルサイズが小さくなります。
備考

イメージバッファのピクセルフォーマットに応じて、保存前に変換が行われます。

  • モノクロのピクセルフォーマットは Mono8 に変換され、モノクロの Jpeg ファイルとして保存されます。
  • Bayer、RGB、YUV の各ピクセルフォーマットは BGR8 に変換され、カラー Jpeg ファイルとして保存されます。

例外

型 条件
ArgumentNullException buffer が null、または filename が null の場合
IC4Exception 詳細については ErrorCode および ToString() を確認してください。

SaveAsPng(ImageBuffer, string, bool, PngCompressionLevel)

イメージバッファを PNG ファイルとして保存します。

宣言

public static void SaveAsPng(this ImageBuffer buffer, string filename, bool storeBayerRawDataAsMonochrome = false, PngCompressionLevel compressionLevel = PngCompressionLevel.Auto)

パラメータ

型 名前 説明
ImageBuffer buffer イメージバッファ
string filename 画像ファイルのパス
bool storeBayerRawDataAsMonochrome true の場合、かつイメージバッファのピクセルフォーマットが Bayer フォーマットである場合に、ピクセルデータをモノクロとして解釈し、RAW データをモノクロ画像として保存します。
PngCompressionLevel compressionLevel PNG の圧縮レベルを指定します。
備考

イメージバッファのピクセルフォーマットに応じて、保存前に以下の変換が行われます。

  • 8bpp を超えるビット深度を持つモノクロピクセルフォーマットは Mono16 に変換され、１チャンネルあたり 16ビットのモノクロ PNG ファイルとして保存されます。
  • Mono8 のイメージバッファは、１チャンネルあたり 8ビットのモノクロ PNG ファイルとして保存されます。
  • 8bpp を超えるビット深度の Bayer フォーマットは BGRa16 に変換され、１チャンネルあたり 16ビットの ４チャンネル PNG ファイルとして保存されます。
  • 8ビットの Bayer、RGB、YUV ピクセルフォーマットは BGR8 に変換され、１チャンネルあたり 8ビットの ３チャンネル PNG ファイルとして保存されます。

例外

型 条件
ArgumentNullException buffer が null、または filename が null の場合
IC4Exception 詳細については ErrorCode および ToString() を確認してください。

SaveAsTiff(ImageBuffer, string, bool)

イメージバッファを TIFF ファイルとして保存します。

宣言

public static void SaveAsTiff(this ImageBuffer buffer, string filename, bool storeBayerRawDataAsMonochrome = false)

パラメータ

型 名前 説明
ImageBuffer buffer イメージバッファ
string filename 画像ファイルのパス
bool storeBayerRawDataAsMonochrome true の場合、かつイメージバッファのピクセルフォーマットが Bayer フォーマットである場合に、ピクセルデータをモノクロとして解釈し、RAW データをモノクロ画像として保存します。
備考

イメージバッファのピクセルフォーマットに応じて、保存前に以下の変換が行われます。

  • 8bpp を超えるビット深度を持つモノクロピクセルフォーマットは Mono16 に変換され、１チャンネルあたり 16ビットのモノクロ TIFF ファイルとして保存されます。
  • Mono8 のイメージバッファは、１チャンネルあたり 8ビットのモノクロ TIFF ファイルとして保存されます。
  • 8bpp を超えるビット深度の Bayer フォーマットは BGRa16 に変換され、１チャンネルあたり 16ビットの ４チャンネル TIFF ファイルとして保存されます。
  • 8ビットの Bayer、RGB、YUV ピクセルフォーマットは BGR8 に変換され、１チャンネルあたり 8ビットの ３チャンネル TIFF ファイルとして保存されます。

例外

型 条件
ArgumentNullException buffer が null、または filename が null の場合
IC4Exception 詳細については ErrorCode および ToString() を確認してください。