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
}

情報