imgcodecs_imwrite_Windows

[32/64bit] 画像を指定されたファイルに保存します.

imgcodecs_imwrite_Windows p1,p2,p3,p4,p5

p1 = str : [MarshalAs(StringUnmanagedTypeWindows)] string fileName
p2 = sptr : IntPtr img
p3 = var : [In] int[] @params
p4 = int : int paramsLength
p5 = var : out int returnValue

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

解説

関数 imwrite は,画像を指定されたファイルに保存します.画像フォーマットは,ファイル名の拡張子に基づいて選択されます(拡張子のリストについては cv::imread を参照してください).一般に,この関数を用いて保存できるのは,8ビットのシングルチャンネルまたは3チャンネル(チャンネル順序は 'BGR' )の画像のみですが,以下のような例外があります: 16ビット符号なし(CV_16U)の画像は,PNG, JPEG 2000, TIFF フォーマットの場合に保存できます.


32ビット浮動小数点(CV_32F)画像は,PFM, TIFF, OpenEXR, Radiance HDR 形式で保存できます.3チャンネル(CV_32FC3)TIFF 画像は,LogLuv ハイダイナミックレンジエンコーディング(1ピクセルあたり4バイト)で保存されます.


アルファチャンネル付きのPNG画像もこの機能を使って保存できます。これを行うには,8ビット(あるいは16ビット)の4チャンネル画像BGRAを作成し,アルファチャンネルを最後に置きます。完全に透明なピクセルは,アルファを 0 に,完全に不透明なピクセルは,アルファを 255/65535 に設定する必要があります(以下のコードサンプルを参照してください).


複数の画像(Mat のベクトル)は,TIFF 形式で保存することができます(以下のコードサンプルを参照してください).画像フォーマットがサポートされていない場合,画像は 8 ビット符号なし(CV_8U)に変換され,そのように保存されます.フォーマット,ビット深度,チャンネル順序が異なる場合は, Mat::convertTo や cv::cvtColor を用いて,保存前に変換してください.あるいは,汎用の FileStorage I/O 関数を利用して,画像を XML や YAML 形式で保存します.以下のサンプルでは,BGRA 画像の作成方法,カスタム圧縮パラメータの設定方法,PNG ファイルへの保存方法を示しています.以下のサンプルは,BGRA 画像を作成し,カスタム圧縮パラメータを設定して PNG ファイルに保存する方法と,複数の画像を 1 つの TIFF ファイルに保存する方法を示しています: #include <opencv2/imgcodecs.hpp>using namespace cv;using namespace std;static void paintAlphaMat(Mat &mat){ CV_Assert(mat.channels() == 4); for (int i = 0; i < mat.rows; ++i) { for (int j = 0; j < mat.cols; ++j) { Vec4b& bgra = mat.at<Vec4b>(i, j); bgra[0] = UCHAR_MAX; // 青 bgra[1] = saturate_cast<uchar>((float (mat.cols - j)) / ((float)mat.cols./ ((float)mat.cols) * UCHAR_MAX); // 緑 bgra[2] = saturate_cast<uchar>((float (mat.rows - i))/ ((float)mat.rows) * UCHAR_MAX); // 赤 bgra[3] = saturate_cast<uchar>(0.5 * (bgra[1] + bgra[2])); // α }。    }}int main(){ Mat mat(480, 640, CV_8UC4); // アルファチャンネルを持つ行列を作成 paintAlphaMat(mat); vector<int> compression_params; compression_params.push_back(IMWRITE_PNG_COMPRESSION); compression_params.push_back(9); bool result = false; try { result = imwrite("alpha.png", mat, compression_params); } catch (const cv::Exception& ex) { fprintf(stderr, "Exception converting image to PNG format: %s\n", ex.what()); } if (result) printf("Saved PNG file with alpha data.\\"); else printf("ERROR: Can't save PNG file.\\"); vector<Mat> imgs; imgs.push_back(mat); imgs.push_back(~mat); imgs.push_back(mat(Rect(0, 0, mat.cols / 2, mat.rows / 2))); imwrite("test.tiff", imgs); printf("Multiple files saved in test.tiff\n"); return result ?0 : 1;}fragmentExamples: samples/cpp/image_alignment.cpp, samples/cpp/stitching.cpp, samples/cpp/stitching_detailed.cpp, samples/cpp/tutorial_code/photo/seamless_cloning/cloning_demo.cpp, samples/tapi/hog.cpp, samples/tapi/squares.cpp.

元関数名(C#): imgcodecs_imwrite_Windows
元DLLエクスポート名: imgcodecs_imwrite
参照元CSファイル: Internal\PInvoke\NativeMethods\NativeMethods_imgcodecs.cs
▼ C言語側関数定義
CVAPI(ExceptionStatus) imgcodecs_imwrite(const char *filename, cv::Mat *img, int *params, int paramsLength, int *returnValue)
{
    BEGIN_WRAP
    std::vector<int> paramsVec;
    paramsVec.assign(params, params + paramsLength);
    *returnValue = cv::imwrite(filename, *img, paramsVec) ? 1 : 0;
    END_WRAP
}

情報

プラグイン / モジュールOpenCvSharpExtern.dll
バージョン1.00
作成日2021/11/30
著作者inovia
URLhttps://hsp.moe/
備考#include "OpenCvSharpExtern32.as"
#include "OpenCvSharpExtern64.as"
使用するHSPランタイムのビット数に合わせたインクルードファイルを使用すること
タイプOpenCVSharpラッパーDLL
グループNativeMethods_imgcodecs
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\OpenCvSharpExtern.hs