imread
グラフィックスファ@ @ルから@ @メ@ @ジを読み込む
構文
説明
例
メ,ジの読み取りと表示
サンプル▪▪メ▪▪ジを読み取ります。
A = imread(“ngc6543a.jpg”);
imread
は,650×600×3の配列一个
を返します。
メ,ジを表示します。
图片(一)
インデックス付きイメージをRGBに変換
サンプルの▪▪ンデックス付き▪▪メ▪ジファ▪▪ルcorn.tif
の最初の▪▪メ▪▪ジを読み取ります。
[X,cmap] = imread(“corn.tif”);
@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @X
は,uint8
型の415行312列の配列です。カラ,マップ提出
は双
型の256行3列の行列であるため,▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪メ,ジを表示します。
imshow (X,提出)
@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @。結果は双
型の415×312×3の配列になります。
RGB = ind2rgb(X,cmap);
RGB转换器メ,ジの値が範囲[0,1]内にあることを確認します。
disp ([' RGB图像的范围是'num2str (min (RGB (:))),”、“num2str (max (RGB (:))),“]”。])
RGB图像的范围为[0.0078431,0.97647]。
マルチペジtiffファルの特定のメジの読み取り
PNG格式
サンプル▪▪メ▪▪ジpeppers.png
のアルファチャネルを返します。
[X,map,alpha] = imread(“peppers.png”);谁α
名称大小字节类属性alpha 0x0 0 double
アルファチャネルが存在しないため,α
は空です。
Tiff转换器メ,ジの指定された領域を読み取る
サンプル▪▪メ▪▪ジcorn.tif
の特定のピクセル領域を読み取ります。
読み取る領域の境界を示すベクトルのcell配列で“PixelRegion”
パラメ,タ,を指定します。最初のベクトルでは読み取る行の範囲を指定し,2番目のベクトルでは読み取る列の範囲を指定します。
A = imread(“corn.tif”,“PixelRegion”,{[1,2],[2、5]});
imread
は,corn.tif
から行1 ~ 2,列2 ~ 5のメジデタを読み取り,2行4列の配列一个
を返します。
入力引数
文件名
- - - - - -グラフィックスファ@ @ルの名前
文字ベクトル|字符串スカラ
グラフィックスファ@ @ルの名前。文字ベクトルまたは字符串スカラとして指定します。
ファ电子邮箱ルの場所によって,文件名
は次のいずれかの形式をとります。
場所 |
形式 |
||||||||
---|---|---|---|---|---|---|---|---|---|
現在のフォルダ,またはmatlab®パス上のフォルダ | ファ@ @ル名を 例: |
||||||||
フォルダ内のファル |
ファイルが現在のフォルダーまたはMATLABパス上のフォルダーにない場合は,絶対パス名または相対パス名を指定します。 例: 例: |
||||||||
URL | ファ▪▪ルが▪▪ンタurlにある場合, 例: |
||||||||
リモ,トの場所 |
リモトの場所に保存されたファルの場合,
リモ,トの場所に基づいて,
詳細にいては,リモ,トデ,タの操作を参照してください。 例: |
それぞれのファ化学键ルの種類でサポ,トされるビット深度,圧縮方式および色空間は,アルゴリズムを参照してください。
デ,タ型:字符
|字符串
fmt
- - - - - -メ,ジ形式
文字ベクトル|字符串スカラ
メ,ジ形式。標準のファル拡張子を示す文字ベクトルまたはstringスカラとして指定します。サポトする形式とそのファル拡張子の一覧を表示するには,imformats
を呼び出します。
例:“png”
デ,タ型:字符
|字符串
idx
- - - - - -読み取る▪▪メ▪▪ジ
整数値スカラ|整数のベクトル
読み取る▪▪メ▪▪ジ。整数スカラー、GIF ファイルの場合は整数ベクトルとして指定します。たとえば、idx
が3の場合,関数imread
は,ファルの3番目のメジを返します。GIFファ电子邮箱ルでidx
が1:5
の場合,imread
は最初の5フレ,ムのみを返します。引数idx
は,複数のイメージを含むGIF,坏蛋,ICOおよびHDF4のファイルでのみサポートされています。
1のGIFファ;idx
をフレ,ムのベクトルとして指定するか,名前と値のペアの引数“帧”,“所有”
を使用します。GIFファルの構造的な仕組みにより,これらの構文を使用すると,ルプ内でimread
を呼び出すよりも高速のパフォ,マンスが得られます。
Hdf4ファiphone4ルの場合,idx
は読み取る▪▪メ▪▪ジの参照番号に対応します。参照番号は,必ずしもファ@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @関数imfinfo
を使用すると,。
例:3.
デ,タ型:双
名前と値の引数
引数のオプションのペアをName1 = Value1,…,以=家
として指定します。ここで的名字
は引数名で,价值
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021aより前では,コンマを使用してそれぞれの名前と値を区切り,的名字
を引用符で囲みます。
例:“指数”,5
は,tiffファルの5番目のメジを読み取ります。
帧
- - - - - -読み取るフレ,ム
1(既定値) |正の整数|整数のベクトル|“所有”
読み取るフレ,ム。“帧”
と,正の整数,整数ベクトルまたは“所有”
からなるコンマ区切りのペアとして指定します。たとえば,3を指定した場合,imread
はファ@ @ルの3番目のフレ@ @ムを読み取ります。“所有”
を指定した場合,imread
はすべてのフレムをファル内の順序で読み取って返します。
例:“帧”,5
PixelRegion
- - - - - -読み取るサブ▪▪メ▪▪ジ
{行,关口}
の形式のcell配列
読み取るサブ▪▪メ▪▪ジ。“PixelRegion”
と,{行,关口}
の形式をもcell配列とで構成されるコンマ区切りのペアとして指定します。行
の入力は,読み取る行の範囲を指定します。关口
の入力は,読み取る列の範囲を指定します。行
と关口
は両方とも,1ベスのンデックスを含む2要素ベクトルでなければなりません。たとえば,'PixelRegion',{[1 2],[3 4]}
は,イメージデータ内の第1行と第2行3列第と第4列で囲まれたサブイメージを読み取ります。“ReductionLevel”
の値が0より大きい場合,行
と关口
がサブ▪▪メ▪▪ジの座標です。
例:'PixelRegion',{[1 100],[4 500]}
ReductionLevel
- - - - - -メ,ジ解像度の低減
0(既定値) |非負の整数
メ,ジ解像度の低減。“ReductionLevel”
と非負の整数で構成されるコンマ区切りのペアとして指定します。低減レベルがlの場合,メジの解像度は2^ lの係数で低減されます。低減レベルは,関数imfinfo
の出力の“WaveletDecompositionLevels”
フィ,ルドで指定された分解レベルの総数によって制限されます。
例:“ReductionLevel”,5
デ,タ型:单
|双
V79Compatible
- - - - - -MATLAB 7.9 (R2009b)以前との互換性
假
(既定値) |真正的
MATLAB 7.9 (R2009b)以前との互換性。“V79Compatible”
と,真正的
または假
のいずれかとで構成されるコンマ区切りのペアとして指定します。真正的
を指定した場合,返されるグレスケルまたはRGBのメジは,旧バジョンのimread
(MATLAB 7.9 (R2009b)以前)と互換性をもます。
例:“V79Compatible”,真的
デ,タ型:逻辑
写成BackgroundColor
- - - - - -背景色
“没有”
|整数|整数の3要素ベクトル
背景色。“没有”
,整数,あるいは整数の3要素ベクトルとして指定します。写成BackgroundColor
が“没有”
の場合,imread
は合成を実行しません。それ以外の場合,imread
は透明ピクセルに背景色をブレンドします。
入力メジがンデックス付きの場合,
写成BackgroundColor
の値は,範囲(1, P)
の整数でなければなりません。ここで,P
は,カラ,マップの長さです。入力メジがグレスケルの場合,
写成BackgroundColor
の値は,範囲[0, 1]
の整数でなければなりません入力RGBメ,ジがRGBの場合,
写成BackgroundColor
の値は範囲[0, 1]
の3要素ベクトルでなければなりません。
写成BackgroundColor
の既定値は,出力引数透明度
の有無および▪▪メ▪▪ジの種類によって異なります。
出力引数
透明度
を要求した場合,写成BackgroundColor
の既定値は“没有”
です。透明度
の出力を要求せず,pngファaaplルに背景色チャンクが含まれる場合,この色は写成BackgroundColor
の既定値になります。透明度
の出力を要求せず,ファ写成BackgroundColor
の既定値は,1
,グレスケルメジでは0
,トゥルカラ(rgb)メジでは[0 0 0]
になります。
指数
- - - - - -読み取る▪▪メ▪▪ジ
1(既定値) |正の整数
読み取る▪▪メ▪▪ジ。“指数”
と正の整数で構成されるコンマ区切りのペアとして指定します。たとえば,指数
の値が3の場合,imread
はファ@ @はファ@ @ルの3番目の@ @メ@ @ジを読み取ります。
デ,タ型:单
|双
信息
- - - - - -メ,ジに関する情報
構造体配列
メ,ジに関する情報。“信息”
と,関数imfinfo
から返された構造体配列とで構成されるコンマ区切りのペアとして指定します。名前と値のペアの引数信息
を使用すると,複数の▪▪メ▪▪ジを含むtiffファ▪▪ルからimread
がより高速に▪▪メ▪▪ジを検出できるようになります。
デ,タ型:结构体
PixelRegion
- - - - - -領域の境界
细胞配列
領域の境界。“PixelRegion”
と,{行,关口}
の形式をもcell配列とで構成されるコンマ区切りのペアとして指定します。行
の入力は,読み取る行の範囲を指定します。关口
の入力は,読み取る列の範囲を指定します。行
と关口
は1ベースのインデックスをもつ2要素ベクトルまたは3要素ベクトルのいずれかでなければなりません。読み取りの最初と最後の行または列は,2要素ベクトルで指定します。たとえば,'PixelRegion',{[1 2],[3 4]}
は,イメージデータ内の第1行と第2行3列第と第4列で囲まれた領域を読み取ります。
3要素ベクトルは,[开始增量停止]
の形式でなければなりません。ここで,开始
は読み取る最初の行または列,增量
は増分値,停止
は読み取る最後の行または列です。この構文を使用すると,。たとえば,'PixelRegion',{[1 2 10],[4 3 12]}
は第1行と第十行,第4列と第12列で囲まれた領域を読み取り,垂直方向は2ピクセルごと,水平方向は3ピクセルごとにデータをサンプリングします。
例:'PixelRegion',{[1 100],[4 500]}
デ,タ型:细胞
出力引数
一个
—huawei @ 123 @ huawei @ 123 @ huawei @ 123 @ 123
配列
。配列として返されます。
は
米
行n
列の配列です。ファルにンデックス付きメ
地图
内の色の▪▪ンデックスに対応する▪▪ンデックス値からなる米
行n
列の配列です。ファイルにトゥルーカラーイメージが含まれる場合,は
米
×n
×3の配列です。ファルがtiffファルで,cmykは
米
×n
×4の配列です。
一个
のクラスは,。詳細にいては,アルゴリズムを参照してください。
地图
—カラマップ
米
行3列の行列
一个
内のンデックス付きメジデタに関連付けられたカラマップ。クラス双
の米
行3列の行列として返されます。
透明度
-透明度の情報
行列
透明度の情報。行列として返されます。PNG ファイルの場合、透明度
はアルファチャネルです(存在する場合)。アルファチャネルが存在しない場合や,名前と値のペアの引数“写成BackgroundColor”
を指定した場合,透明度
は空になります。Curおよびicoのファaaplルの場合,透明度
は和マスクです。カソルファルの場合,このマスクには使用可能なデタのみが含まれることがあります。
詳細
アルゴリズム
ほとんどの▪▪メ▪ジファ▪▪ル形式では,関数imread
は,色平面あたり8ビット以下を使用して,メジピクセルを格納します。次の表に,ファ@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @一个
のクラスをリストします。
ファ@ @ルのビット深度 |
|
---|---|
1ビット/ピクセル |
|
2 ~ 8ビット/色平面 |
|
9 ~ 16ビット/ピクセル |
16ビットBMPパック形式(5-6-5)の場合,matlabは |
以下の節では,形式名のアルファベット順に示した,特定の形式のサポ,トに関する情報を提供します。
BMP - Windowsビットマップ | 联合摄影专家组 | PNG -ポ,タブルネットワ,クグラフ |
CUR -游标ファescル | 联合摄影专家组2000年 | PPM -便携式Pixmap |
图形交换格式 | 便携式位图 | RAS - Sunラスタ |
分级数据格式 | PCX - Windows油漆刷 | 标记图像文件格式 |
ICO -图标ファiphoneル | PGM -便携式灰度图 | 窗口转储 |
BMP -窗户ビットマップ
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | 圧縮なし | Rle圧縮 | 出力クラス | メモ |
---|---|---|---|---|
1ビット | ✓ | - - - - - - | 逻辑 |
|
4ビット | ✓ | ✓ | uint8 |
|
8ビット | ✓ | ✓ | uint8 |
|
16ビット | ✓ | - - - - - - | uint8 |
1サンプル/ピクセル |
24ビット | ✓ | - - - - - - | uint8 |
3サンプル/ピクセル |
32ビット | ✓ | - - - - - - | uint8 |
3サンプル/ピクセル (1バaapl .トのパディング) |
CUR -游标ファescル
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | 圧縮なし | 圧縮 | 出力クラス |
---|---|---|---|
1ビット | ✓ | - - - - - - | 逻辑 |
4ビット | ✓ | - - - - - - | uint8 |
8ビット | ✓ | - - - - - - | uint8 |
メモ
既定では,微软®窗户®のカソルは32 × 32ピクセルです。MATLABのポインターは通常、16 x 16 でなければならないので、イメージをスケーリングする必要がある場合があります。この操作を行うために関数imresize
を使用できます。
图形交换格式
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | 圧縮なし | 圧縮 | 出力クラス |
---|---|---|---|
1ビット | ✓ | - - - - - - | 逻辑 |
2 ~ 8ビット | ✓ | - - - - - - | uint8 |
分级数据格式
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | カラマップを含むラスタメジ | カラマップなしのラスタメジ | 出力クラス | メモ |
---|---|---|---|---|
8ビット | ✓ | ✓ | uint8 |
|
24ビット | - - - - - - | ✓ | uint8 |
3サンプル/ピクセル |
ICO -图标ファiphoneル
CUR -游标ファescルを参照してください。
联合摄影专家组
imread
は,任意のベースラインJPEGイメージと,一般的に使用されるいくつかの拡張子をもつJPEGイメージを読み込みます。Jpeg 2000ファいては,”JPEG 2000を参照してください。
1サンプルあたりのサポ,トされているビット数 | 非可逆圧縮 | 可逆圧縮 | 出力クラス | メモ |
---|---|---|---|---|
8ビット | ✓ | ✓ | uint8 |
グレ,スケ,ルまたはRGB |
12ビット | ✓ | ✓ | uint16 |
グレ,スケ,ルまたはRGB |
16ビット | - - - - - - | ✓ | uint16 |
グレ,スケ,ル |
联合摄影专家组2000年
Jpegファルのサポいては,”JPEGを参照してください。
メモ
▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪Jp2 / jpxファルではJp2互換の色空間のみがサポトされます。既定では,すべての@ @ @ジチャネルはファ@ @ @ @ @ @ @
1サンプルあたりのサポ,トされているビット数 |
非可逆圧縮 | 可逆圧縮 | 出力クラス | メモ |
---|---|---|---|---|
1ビット | ✓ | ✓ | 逻辑 |
グレ,スケ,ルのみ |
2 ~ 8ビット | ✓ | ✓ | uint8 またはint8 |
グレ,スケ,ル またはRGB |
9 ~ 16ビット | ✓ | ✓ | uint16 またはint16 |
グレ,スケ,ル またはRGB |
便携式位图
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | Rawバescナリ | ASCII(プレ,ン)エンコ,ド | 出力クラス |
---|---|---|---|
1ビット | ✓ | ✓ | 逻辑 |
图形文件,窗户画笔
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | 出力クラス | メモ |
---|---|---|
1ビット | 逻辑 |
グレ,スケ,ルのみ |
8ビット | uint8 |
グレスケルまたはンデックス付き |
24ビット | uint8 |
RGB 3の8ビットサンプル/ピクセル |
PGM -便携式灰度图
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | Rawバescナリ | ASCII(プレ,ン)エンコ,ド | 出力クラス | メモ |
---|---|---|---|---|
8ビット | ✓ | - - - - - - | uint8 |
|
16ビット | ✓ | - - - - - - | uint16 |
|
任意 | - - - - - - | ✓ | 1ビット~ 8ビットuint8 9ビット~ 16ビット: uint16 |
スケ,リングされる値 |
PNG -ポ,タブルネットワ,クグラフ
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | 出力クラス | メモ |
---|---|---|
1ビット | 逻辑 |
グレ,スケ,ル |
2ビット | uint8 |
グレ,スケ,ル |
4ビット | uint8 |
グレ,スケ,ル |
8ビット | uint8 |
グレスケルまたはンデックス付き |
16ビット | uint16 |
グレスケルまたはンデックス付き |
24ビット | uint8 |
RGB 3の8ビットサンプル/ピクセル |
48ビット | uint16 |
RGB 3の16ビットサンプル/ピクセル |
PPM -便携式Pixmap
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | Rawバescナリ | ASCII(プレ,ン)エンコ,ド | 出力クラス |
---|---|---|---|
16ビットまで | ✓ | - - - - - - | uint8 |
任意 | - - - - - - | ✓ |
RAS -太阳ラスタ
次の表に,出力メジデタ配列がサポトするビット深度およびデタ型をリストします。
サポ,トされているビット深度 | 出力クラス | メモ |
---|---|---|
1ビット | 逻辑 |
ビットマップ |
8ビット | uint8 |
ンデックス付き |
24ビット | uint8 |
RGB 3の8ビットサンプル/ピクセル |
32ビット | uint8 |
アルファを含むRGB 4の8ビットサンプル/ピクセル |
Aperio SVS - AperioScanScopeバチャルスラド
Tiffベスのメジファル形式。imread
は非圧縮イメージと圧縮イメージの読み取りをサポートします(JPEG 2000圧縮を使用したイメージを含む)。詳細にいては,标记图像文件格式を参照してください。
标记图像文件格式
imread
は,TIFF仕様またはLibTIFFでサポトされるメジの多くを読み取ります。関数imread
は,tiffの次の機能をサポ,トしています。
任意のサンプル数/ピクセル
CCITTグループ3および4传真,Packbits, JPEG, LZW,缩小,ThunderScan圧縮,および非圧縮イメージ
論理,グレースケール,インデックス付きカラー,トゥルーカラー,およびハイパースペクトルのイメージ
Rgb, cmyk, cielab, icclabの色空間。カラcmyk色空間を使用している場合,
一个
は米
×n
×4の配列です。使用される色空間を決定するには,imfinfo
を使用してグラフィックスファ电子邮箱ルの情報を取得し,PhotometricInterpretation
フィ,ルドの値を参照してください。ファルにcielabカラデタが含まれる場合,imread
はこのデタをicclabに変換してからmatlabワクスペスに取り込みます。TIFFの8ビットまたは16ビットのCIELAB エンコード値には符号付きと符号なしのデータ型が混在しており、単一の MATLAB 配列として表現できないため、この変換が必要になります。タ@ @ルまたはスキャンラ@ @ンに分類されたデ@ @タ
imread
は,次のようにtiffメジを読み取って変換します。
YCbCrメジはRGB色空間に変換されます。
グレスケルメジはすべて,黒= .
0
,白=最大値として読み取られます。1ビット
逻辑
クラスとして返されます。16ビットの浮動小数点
单
として返されます。CIELabメ,ジはICCLab色空間に変換されます。
窗口转储
次の表に,xwdファ。
サポ,トされているビット深度 | ZPixmaps | XYBitmaps | XYPixmaps | 出力クラス |
---|---|---|---|---|
1ビット | ✓ | - - - - - - | ✓ | 逻辑 |
8ビット | ✓ | - - - - - - | - - - - - - | uint8 |
拡張機能
C/ c++コ,ド生成
MATLAB®Coder™を使用してCおよびc++コドを生成します。
使用上の注意事項および制限事項:
この関数は,8ビットのjpegメジの読み取りのみをサポトします。入力引数
文件名
は有効な絶対パスまたは相対パスでなければなりません。この関数は,プリコンパプラットフォム固有の共有ラブラリ(图像处理工具箱)を使用するコ,ドを生成します。
コード生成時にランタイムエラーのチェックを無効にし,その後でランタイムエラーが発生した場合,以下のいずれかの方法でエラーが報告されます。
文件名
がコンパesc escル時の定数でない場合,空の行列が返されます。文件名
がコンパ电子邮箱ル時の定数である場合,文件名
と同じ次元の黒の▪▪メ▪▪ジが返されます。
Gpuコ,ド生成
GPU编码器™を使用してNVIDIA GPU®のためのCUDA®コードを生成します。
使用上の注意事項および制限事項:
この関数は,8ビットのjpegメジの読み取りのみをサポトします。入力引数
文件名
は有効な絶対パスまたは相対パスでなければなりません。この関数は,プリコンパプラットフォム固有の共有ラブラリ(图像处理工具箱)を使用するコ,ドを生成します。
コード生成時にランタイムエラーのチェックを無効にし,その後でランタイムエラーが発生した場合,以下のいずれかの方法でエラーが報告されます。
文件名
がコンパesc escル時の定数でない場合,空の行列が返されます。文件名
がコンパ电子邮箱ル時の定数である場合,文件名
と同じ次元の黒の▪▪メ▪▪ジが返されます。
スレッドベ,スの環境
MATLAB®のbackgroundPool
を使用してバックグラウンドでコードを実行するか,并行计算工具箱™のThreadPool
を使用してコ,ドを高速化します。
使用上の注意事項および制限事項:
imread
は,backgroundPool
または并行计算工具箱™のThreadpool
を使用してバックグラウンドでimread
を実行する場合,階層データ形式(HDF), sv,またはTIFFファイルの読み取りはサポートしません。
詳細にいては,スレッドベスの環境でのmatlab関数の実行を参照してください。
バ,ジョン履歴
R2006aより前に導入R2021b:Jpeg 2000 e - mailメe - mailジでのピクセルの違い
R2021b以前のバージョンのMATLABでは,JPEG 2000イメージ間でピクセル値が異なる可能性があります。
Matlabコマンド
次のmatlabコマンドに対応するリンクがクリックされました。
コマンドをmatlabコマンドウィンドウに入力して実行してください。Webブラウザ,はMATLABコマンドをサポ,トしていません。
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。