imgcodecs_imread_NotWindows

[32/64bit] ファイルから画像を読み込みます。

imgcodecs_imread_NotWindows p1,p2,p3

p1 = str : [MarshalAs(StringUnmanagedTypeNotWindows)] string fileName
p2 = int : int flags
p3 = var : out IntPtr returnValue

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

解説

関数 imread は，指定されたファイルから画像を読み込み，それを返します．画像が読み込めない場合（ファイルが存在しない，不適切なパーミッション，サポートされていない，あるいは無効なフォーマットのため），この関数は空の行列（ Mat::data==NULL ）を返します．


JPEGファイル - *.jpeg, *.jpg, *.jpe (Noteセクションを参照)


JPEG 2000ファイル - *.jp2 (注意事項を参照)


ポータブルネットワークグラフィックス - *.png (注釈欄参照)


WebP - *.webp（注釈欄参照）


ポータブルイメージフォーマット - *.pbm, *.pgm, *.ppm *.pxm, *.pnm (常時サポート)


PFMファイル - *.pfm (Noteセクションを参照)


太陽ラスタ - *.sr, *.ras (常にサポートされています)


TIFFファイル - *.tiff, *.tif (Noteセクションを参照)


OpenEXR画像ファイル - *.exr (注釈欄参照)


Radiance HDR - *.hdr, *.pic (常時サポート)


GDALでサポートされているラスターおよびベクターの地理空間データ（注釈セクションを参照）注釈


本機能では、拡張子ではなく、画像の内容で画像の種類を判断します。


カラー画像の場合、デコードされた画像はB G Rの順にチャンネルが格納されます。


IMREAD_GRAYSCALE を使用した場合，コーデック内部のグレースケール変換が可能であれば，それが使用されます。結果は cvtColor() の出力と異なる場合があります。


Microsoft Windows* OSやMacOSX*では，OpenCVの画像に同梱されているコーデック（libjpeg, libpng, libtiff, libjasper）がデフォルトで利用されます．そのため，OpenCV は常に JPEG, PNG, TIFF を読み込むことができます．MacOSXでは，MacOSXのネイティブな画像リーダを利用するオプションもあります．しかし，現在のところ，MacOSXに組み込まれたカラーマネージメントのために，これらのネイティブ画像ローダは，異なるピクセル値の画像を与えることに注意してください．


Linux*，BSDフレーバー，その他のUnix系オープンソースOSでは，OpenCVはOSイメージに含まれるコーデックを探します．コーデックをサポートするために，関連するパッケージ（Debian* や Ubuntu* では，"libjpeg-dev" のような開発ファイルも忘れないでください）をインストールするか，CMake で OPENCV_BUILD_3RDPARTY_LIBS フラグをオンにしてください．


CMakeでWITH_GDALフラグをtrueに設定し、IMREAD_LOAD_GDALで画像をロードした場合、画像をデコードするためにGDALドライバが使用され、以下のフォーマットをサポートします。ラスター、ベクター。


画像ファイルにEXIF情報が埋め込まれている場合、EXIFの向きが考慮され、フラグIMREAD_IGNORE_ORIENTATIONまたはIMREAD_UNCHANGEDが渡される場合を除き、それに応じて画像が回転します。


PFM画像から浮動小数点値を保持するためには、IMREAD_UNCHANGEDフラグを使用する。


デフォルトでは、ピクセル数は2^30以下でなければなりません。システム変数OPENCV_IO_MAX_IMAGE_PIXELSEで設定できます。サンプル：fld_lines.cpp, modules/shape/samples/shape_example.cpp, samples/cpp/connected_components.cpp, samples/cpp/create_mask.cpp, samples/cpp/demhist.cpp, samples/cpp/distrans.cpp, samples/cpp/edge.cpp, samples/cpp/facedetect.cpp, samples/cpp/falecolor.cpp, samples/cpp/ffilldemo.cpp, samples/cpp/fitellipse.cpp, samples/cpp/grabcut.cpp, samples/cpp/image_alignment.cpp, samples/cpp/pca.cpp, samples/cpp/squares.cpp, samples/cpp/stitching.cpp, samples/cpp/stitching_detailed.cpp, samples/cpp/train_HOG.cpp, samples/cpp/tutorial_code/features2D/Homography/decompose_homography.cpp, samples/cpp/tutorial_code/features2D/Homography/decompose_homography.cpp, samples/cpp/tutorial_code/features2D/Homography/homography_from_camera_displacement.cpp, samples/cpp/tutorial_code/features2D/Homography/pose_from_homography.cpp, samples/cpp/tutorial_code/HighGUI/AddingImagesTrackbar.cpp, samples/cpp/tutorial_code/Histograms_Matching/MatchTemplate_Demo.cpp, samples/cpp/tutorial_code/ImgProc/Morphology_1.cpp, samples/cpp/tutorial_code/ImgProc/Morphology_2.cpp, samples/cpp/tutorial_code/ImgProc/Pyramids/Pyramids.cpp, samples/cpp/tutorial_code/ImgProc/Smoothing/Smoothing.cpp, samples/cpp/tutorial_code/ImgTrans/copyMakeBorder_demo.cpp, samples/cpp/tutorial_code/ImgTrans/houghcircles.cpp, samples/cpp/tutorial_code/ImgTrans/houghlines.cpp, samples/cpp/tutorial_code/ImgTrans/Sobel_Demo.cpp, samples/cpp/tutorial_code/ml/introduction_to_pca/introduction_to_pca.cpp, samples/cpp/tutorial_code/photo/non_photorealistic_rendering/npr_demo.cpp、samples/cpp/tutorial_code/photo/seamless_cloning/cloning_demo.cpp、samples/cpp/warpPerspective_demo.cpp、samples/cpp/watershed.cpp、samples/dnn/colorization.cpp、samples/dnn/openpose.cpp、samples/tapi/hog.cpp、samples/tapi/squares.cppです。

元関数名(C#): imgcodecs_imread_NotWindows
元DLLエクスポート名: imgcodecs_imread
参照元CSファイル: Internal\PInvoke\NativeMethods\NativeMethods_imgcodecs.cs
▼ C言語側関数定義

CVAPI(ExceptionStatus) imgcodecs_imread(const char *filename, int flags, cv::Mat **returnValue)
{
    BEGIN_WRAP
    const auto ret = cv::imread(filename, flags);
    *returnValue = new cv::Mat(ret);
    END_WRAP
}

情報