主要内容

imread

グラフィックスファ@ @ルから@ @メ@ @ジを読み込む

説明

一个= imread (文件名は,文件名で指定されたファルの形式をコンテンから推定して,そのファルからメジを読み取ります。文件名が複数のメジを含むファルである場合,imreadはファ@ @ルの最初の@ @メ@ @ジを読み取ります。

一个= imread (文件名fmtではさらに,fmtで示す標準のファ▪▪ル拡張子でファ▪▪ルの形式を指定します。文件名で指定された名前のファ化学键ルを見化学键けることができない場合,imreadは名前がfilename.fmtのファ@ @ルを検索します。

一个= imread (___idx。この構文は,GIF, PGM PBM, PPM,坏蛋,ICO, TIF, svおよびHDF4のファイルにのみ適用されます。文件名の入力は必須であり,オプションでfmtを指定できます。

一个= imread (___名称,值は,前述の構文の入力引数のいずれかに加え,1つ以上の名前と値のペアの引数を使用して,形式に固有のオプションを指定します。

一个地图= imread(___文件名の@ @ンデックス付き@ @メ@ @ジを一个,その関連カラ,マップを地图に読み取ります。イメージファイルのカラーマップ値は、自動的に、範囲[0, 1]に再スケ,リングされます。

一个地图透明度= imread(___はさらに,。この構文は,png, curおよびicoのファescルにのみ適用されます。PNGファ电子邮箱ルの場合,透明度はアルファチャネルです(存在する場合)。Curおよびicoのファaaplルの場合,これは AND (不透明性) マスクです。

すべて折りたたむ

サンプル▪▪メ▪▪ジを読み取ります。

A = imread(“ngc6543a.jpg”);

imreadは,650×600×3の配列一个を返します。

メ,ジを表示します。

图片(一)

图中包含一个轴对象。axis对象包含一个image类型的对象。

サンプルの▪▪ンデックス付き▪▪メ▪ジファ▪▪ルcorn.tifの最初の▪▪メ▪▪ジを読み取ります。

[X,cmap] = imread(“corn.tif”);

@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @Xは,uint8型の415行312列の配列です。カラ,マップ提出型の256行3列の行列であるため,▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪メ,ジを表示します。

imshow (X,提出)

图中包含一个轴对象。axis对象包含一个image类型的对象。

@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @。結果は型の415×312×3の配列になります。

RGB = ind2rgb(X,cmap);

RGB转换器メ,ジの値が範囲[0,1]内にあることを確認します。

disp ([' RGB图像的范围是'num2str (min (RGB (:))),”、“num2str (max (RGB (:))),“]”。])
RGB图像的范围为[0.0078431,0.97647]。

サンプルファ@ @ルcorn.tifの3番目の。

[X,map] = imread(“corn.tif”3);

サンプル▪▪メ▪▪ジpeppers.pngのアルファチャネルを返します。

[X,map,alpha] = imread(“peppers.png”);谁α
名称大小字节类属性alpha 0x0 0 double

アルファチャネルが存在しないため,αは空です。

サンプル▪▪メ▪▪ジcorn.tifの特定のピクセル領域を読み取ります。

読み取る領域の境界を示すベクトルのcell配列で“PixelRegion”パラメ,タ,を指定します。最初のベクトルでは読み取る行の範囲を指定し,2番目のベクトルでは読み取る列の範囲を指定します。

A = imread(“corn.tif”“PixelRegion”,{[1,2],[2、5]});

imreadは,corn.tifから行1 ~ 2,列2 ~ 5のメジデタを読み取り,2行4列の配列一个を返します。

入力引数

すべて折りたたむ

グラフィックスファ@ @ルの名前。文字ベクトルまたは字符串スカラとして指定します。

ファ电子邮箱ルの場所によって,文件名は次のいずれかの形式をとります。

場所

形式

現在のフォルダ,またはmatlab®パス上のフォルダ

ファ@ @ル名を文件名で指定します。

例:“myImage.jpg”

フォルダ内のファル

ファイルが現在のフォルダーまたはMATLABパス上のフォルダーにない場合は,絶対パス名または相対パス名を指定します。

例:“C: \ myFolder \ myImage.ext”

例:“\ imgDir \ myImage.ext”

URL

ファ▪▪ルが▪▪ンタurlにある場合,文件名にはhttp://などのプロトコルタ@ @プが含まれていなければなりません。

例:“http://hostname/path_to_file/my_image.jpg”

リモ,トの場所

リモトの場所に保存されたファルの場合,文件名は次の形式の统一资源定位符(URL)として指定されたファイルの絶対パスを含まなければなりません。

scheme_name://path_to_file/my_file.ext

リモ,トの場所に基づいて,scheme_nameには次の表の値のいずれかを指定できます。

リモ,トの場所 scheme_name
Amazon S3™ s3
Windows Azure®Blob存储 wasbwasbs
HDFS™ hdfs

詳細にいては,リモ,トデ,タの操作を参照してください。

例:s3: / / bucketname / path_to_file / my_image.jpg '

それぞれのファ化学键ルの種類でサポ,トされるビット深度,圧縮方式および色空間は,アルゴリズムを参照してください。

デ,タ型:字符|字符串

メ,ジ形式。標準のファル拡張子を示す文字ベクトルまたはstringスカラとして指定します。サポトする形式とそのファル拡張子の一覧を表示するには,imformatsを呼び出します。

例:“png”

デ,タ型:字符|字符串

読み取る▪▪メ▪▪ジ。整数スカラー、GIF ファイルの場合は整数ベクトルとして指定します。たとえば、idxが3の場合,関数imreadは,ファルの3番目のメジを返します。GIFファ电子邮箱ルでidx1:5の場合,imreadは最初の5フレ,ムのみを返します。引数idxは,複数のイメージを含むGIF,坏蛋,ICOおよびHDF4のファイルでのみサポートされています。

1のGIFファ;idxをフレ,ムのベクトルとして指定するか,名前と値のペアの引数“帧”,“所有”を使用します。GIFファルの構造的な仕組みにより,これらの構文を使用すると,ルプ内でimreadを呼び出すよりも高速のパフォ,マンスが得られます。

Hdf4ファiphone4ルの場合,idxは読み取る▪▪メ▪▪ジの参照番号に対応します。参照番号は,必ずしもファ@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @関数imfinfoを使用すると,。

例:3.

デ,タ型:

名前と値の引数

引数のオプションのペアをName1 = Value1,…,以=家として指定します。ここで的名字は引数名で,价值は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021aより前では,コンマを使用してそれぞれの名前と値を区切り,的名字を引用符で囲みます。

例:“指数”,5は,tiffファルの5番目のメジを読み取ります。

GIFファ电子邮箱ル

すべて折りたたむ

読み取るフレ,ム。“帧”と,正の整数,整数ベクトルまたは“所有”からなるコンマ区切りのペアとして指定します。たとえば,3を指定した場合,imreadはファ@ @ルの3番目のフレ@ @ムを読み取ります。“所有”を指定した場合,imreadはすべてのフレムをファル内の順序で読み取って返します。

例:“帧”,5

Jpeg 2000ファexcelル

すべて折りたたむ

読み取るサブ▪▪メ▪▪ジ。“PixelRegion”と,{行,关口}の形式をもcell配列とで構成されるコンマ区切りのペアとして指定します。の入力は,読み取る行の範囲を指定します。关口の入力は,読み取る列の範囲を指定します。关口は両方とも,1ベスのンデックスを含む2要素ベクトルでなければなりません。たとえば,'PixelRegion',{[1 2],[3 4]}は,イメージデータ内の第1行と第2行3列第と第4列で囲まれたサブイメージを読み取ります。“ReductionLevel”の値が0より大きい場合,关口がサブ▪▪メ▪▪ジの座標です。

例:'PixelRegion',{[1 100],[4 500]}

メ,ジ解像度の低減。“ReductionLevel”と非負の整数で構成されるコンマ区切りのペアとして指定します。低減レベルがlの場合,メジの解像度は2^ lの係数で低減されます。低減レベルは,関数imfinfoの出力の“WaveletDecompositionLevels”フィ,ルドで指定された分解レベルの総数によって制限されます。

例:“ReductionLevel”,5

デ,タ型:|

MATLAB 7.9 (R2009b)以前との互換性。“V79Compatible”と,真正的またはのいずれかとで構成されるコンマ区切りのペアとして指定します。真正的を指定した場合,返されるグレスケルまたはRGBのメジは,旧バジョンのimread(MATLAB 7.9 (R2009b)以前)と互換性をもます。

例:“V79Compatible”,真的

デ,タ型:逻辑

PNGファescル

すべて折りたたむ

背景色。“没有”,整数,あるいは整数の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]になります。

Tiffファaapl . exeル

すべて折りたたむ

読み取る▪▪メ▪▪ジ。“指数”と正の整数で構成されるコンマ区切りのペアとして指定します。たとえば,指数の値が3の場合,imreadはファ@ @はファ@ @ルの3番目の@ @メ@ @ジを読み取ります。

デ,タ型:|

メ,ジに関する情報。“信息”と,関数imfinfoから返された構造体配列とで構成されるコンマ区切りのペアとして指定します。名前と値のペアの引数信息を使用すると,複数の▪▪メ▪▪ジを含むtiffファ▪▪ルからimreadがより高速に▪▪メ▪▪ジを検出できるようになります。

デ,タ型:结构体

領域の境界。“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]}

デ,タ型:细胞

出力引数

すべて折りたたむ

。配列として返されます。

  • n列の配列です。

  • ファルにンデックス付きメ地图内の色の▪▪ンデックスに対応する▪▪ンデックス値からなるn列の配列です。

  • ファイルにトゥルーカラーイメージが含まれる場合,は×n×3の配列です。

  • ファルがtiffファルで,cmykは×n×4の配列です。

一个のクラスは,。詳細にいては,アルゴリズムを参照してください。

一个内のンデックス付きメジデタに関連付けられたカラマップ。クラス行3列の行列として返されます。

透明度の情報。行列として返されます。PNG ファイルの場合、透明度はアルファチャネルです(存在する場合)。アルファチャネルが存在しない場合や,名前と値のペアの引数“写成BackgroundColor”を指定した場合,透明度は空になります。Curおよびicoのファaaplルの場合,透明度は和マスクです。カソルファルの場合,このマスクには使用可能なデタのみが含まれることがあります。

詳細

すべて折りたたむ

ビット深度

ビット深度は,各。

ビット深度は,サンプル単位のビットとピクセル単位のサンプルを乗算することで計算されます。そのため,各色要素(またはサンプル)に8ビットおよびピクセルあたり3サンプルを使用する形式のビット深度は24になります。場合によっては,ビット深度に関連するサンプルサ。たとえば,48ビットのビット深度は,6 つの 8 ビット サンプル、4 つの 12 ビット サンプル、 3 つの 16 ビット サンプルのすべてに該当します。このあいまいさを避けるためのサンプル サイズの情報は、アルゴリズムを参照してください。

アルゴリズム

すべて折りたたむ

ほとんどの▪▪メ▪ジファ▪▪ル形式では,関数imreadは,色平面あたり8ビット以下を使用して,メジピクセルを格納します。次の表に,ファ@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @一个のクラスをリストします。

ファ@ @ルのビット深度

imreadが返す配列のクラス

1ビット/ピクセル

逻辑

2 ~ 8ビット/色平面

uint8

9 ~ 16ビット/ピクセル

uint16骨形态发生蛋白JPEGPNG,およびTIFF

16ビットBMPパック形式(5-6-5)の場合,matlabはuint8を返します。

以下の節では,形式名のアルファベット順に示した,特定の形式のサポ,トに関する情報を提供します。

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

拡張機能

バ,ジョン履歴

R2006aより前に導入

すべて展開する