Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

imwrite

イメージをグラフィックス ファイルに書き込む

ページ内をすべて折りたたむ

構文

imwrite(A,filename)
imwrite(A,map,filename)
imwrite(___,fmt)
imwrite(___,Name,Value)

説明

例

imwrite(A,filename) は、filename で指定されたファイルの拡張子からファイル形式を推測して、イメージ データ A をそのファイルに書き込みます。imwrite は、新しいファイルを現在のフォルダーに作成します。出力イメージのビット深度は、A のデータ型とファイル形式によって決まります。ほとんどの形式では、次のようになります。

  • A が uint8 データ型の場合、imwrite は 8 ビット値を出力します。

  • A が uint16 データ型で、出力ファイル形式が 16 ビット データ (JPEG、PNG および TIFF) をサポートしている場合、imwrite は 16 ビット値を出力します。出力ファイル形式が 16 ビット データをサポートしていない場合、imwrite はエラーを返します。

  • A が double または single データ型のグレースケールまたは RGB カラー イメージの場合、imwrite は、ダイナミック レンジを [0,1] と仮定してデータを自動的に 255 でスケールしてから、8 ビット値としてファイルに書き込みます。A のデータが single の場合は、GIF または TIFF ファイルに書き込む前に、A を double に変換します。

  • A が logical データ型の場合、imwrite はデータをバイナリ イメージと仮定し、その形式で許可されている場合は、ビット深度 1 でファイルに書き込みます。BMP、PNG、または TIFF 形式は、入力配列としてバイナリ イメージを受け入れます。

A にインデックス付きイメージ データが含まれている場合は、map 入力引数を指定する必要があります。

例

imwrite(A,map,filename) は、A のインデックス付きイメージおよびその関連カラーマップ map を filename で指定されたファイルに書き込みます。

  • A が double または single データ型のインデックス付きイメージの場合、imwrite は、各要素から 1 を減算して、インデックスを 0 ベース インデックスに変換し、データを uint8 として書き込みます。A のデータが single の場合は、GIF または TIFF ファイルに書き込む前に、A を double に変換します。

imwrite(___,fmt) は、filename のファイル拡張子に関係なく、イメージを fmt で指定された形式で書き込みます。前述のいずれの構文でも、入力引数の後に fmt を指定できます。

例

imwrite(___,Name,Value) は、名前と値のペアの引数を 1 つ以上使用して、GIF、HDF、JPEG、PBM、PGM、PNG、PPM および TIFF の出力ファイル用の追加パラメーターを指定します。前述のいずれの構文でも、入力引数の後に Name,Value を指定できます。

例

すべて折りたたむ

ライブ スクリプトを開く

グレースケール値の 50 行 50 列の配列を現在のフォルダーの PNG ファイルに書き込みます。 

A = rand(50);
imwrite(A,'myGray.png')

インデックス付きイメージ配列およびその関連カラーマップを PNG ファイルに書き込みます。

clown.mat ファイルからサンプル イメージ データを読み込みます。

load clown.mat

イメージ配列 X とその関連カラーマップ map は MATLAB® ワークスペースに読み込まれます。

新しい PNG ファイルにデータを書き込みます。

imwrite(X,map,'myclown.png')

imwrite によって、現在のフォルダーに myclown.png ファイルが作成されます。

新しいファイルを MATLAB の外部で開いて確認します。

myclown.png contains an image of a clown.

組み込みの MATLAB カラーマップ copper を使用して新しい PNG ファイルにイメージ データを書き込みます。

clown.mat ファイルからサンプル イメージ データを読み込みます。

load clown.mat

イメージ配列 X とその関連カラーマップ map は MATLAB ワークスペースに読み込まれます。map は 81 RGB ベクトルの行列です。

81 RGB ベクトルで赤銅色トーン カラーマップを定義します。次に、新しいカラーマップを使用して PNG ファイルにイメージ データを書き込みます。

newmap = copper(81);
imwrite(X,newmap,'copperclown.png');

imwrite によって、現在のフォルダーに copperclown.png ファイルが作成されます。

新しいファイルを MATLAB の外部で開いて確認します。

copperclown.png contains a copper-tone image of a clown.

トゥルーカラー イメージ データを作成して JPEG ファイルに書き込みます。

ランダムな RGB 値の 49 x 49 x 3 の配列を作成します。

A = rand(49,49);
A(:,:,2) = rand(49,49);
A(:,:,3) = rand(49,49);

'jpg' を使用して出力形式を指定し、イメージ データを JPEG ファイルに書き込みます。名前と値のペアの引数 'Comment' を使用してファイルにコメントを付加します。

imwrite(A,'newImage.jpg','jpg','Comment','My JPEG file')

新しいファイルの情報を表示します。

imfinfo('newImage.jpg')
ans = 

           Filename: 'S:\newImage.jpg'
        FileModDate: '25-Jan-2013 16:18:41'
           FileSize: 2339
             Format: 'jpg'
      FormatVersion: ''
              Width: 49
             Height: 49
           BitDepth: 24
          ColorType: 'truecolor'
    FormatSignature: ''
    NumberOfSamples: 3
       CodingMethod: 'Huffman'
      CodingProcess: 'Sequential'
            Comment: {'My JPEG file'}
ライブ スクリプトを開く

複数のイメージを単一のマルチページ TIFF ファイルに書き込みます。

2 つのランダム イメージ データセット im1 および im2 を作成します。 

im1 = rand(50,40,3);
im2 = rand(50,50,3);

最初のイメージを新しい TIFF ファイルに書き込みます。次に、2 番目のイメージを同じファイルに追加します。 

imwrite(im1,'myMultipageFile.tif')
imwrite(im2,'myMultipageFile.tif','WriteMode','append')
スクリプトを開く

一連のプロットを描画し、それらをイメージとして取得して 1 つのアニメーション GIF ファイルに書き込みます。

$n = 3$ の場合の $y = x^{n}$ をプロットします。

x = 0:0.01:1;
n = 3;
y = x.^n;
plot(x,y,'LineWidth',3)
title(['y = x^n,  n = ' num2str(n) ])

$n$ の増加する値の一連のプロットを取得します。

n = 1:0.5:5;
nImages = length(n);

fig = figure;
for idx = 1:nImages
    y = x.^n(idx);
    plot(x,y,'LineWidth',3)
    title(['y = x^n,  n = ' num2str( n(idx)) ])
    drawnow
    frame = getframe(fig);
    im{idx} = frame2im(frame);
end
close;

一連のイメージを 1 つの Figure に表示します。

figure;
for idx = 1:nImages
    subplot(3,3,idx)
    imshow(im{idx});
end

9 つのイメージを GIF ファイルに保存します。3 次元データは GIF ファイルではサポートされていないため、rgb2ind を呼び出し、カラーマップ map を使用してイメージの RGB データをインデックス付きイメージ A に変換します。複数のイメージを最初のイメージに追加するために、名前と値のペアの引数 'WriteMode','append' を指定して imwrite を呼び出します。

filename = 'testAnimated.gif'; % Specify the output file name
for idx = 1:nImages
    [A,map] = rgb2ind(im{idx},256);
    if idx == 1
        imwrite(A,map,filename,'gif','LoopCount',Inf,'DelayTime',1);
    else
        imwrite(A,map,filename,'gif','WriteMode','append','DelayTime',1);
    end
end

imwrite は、GIF ファイルを現在のフォルダーに書き込みます。名前と値のペア 'LoopCount',Inf により、アニメーションが連続的にループします。'DelayTime',1 は、アニメーションの各イメージの表示間隔を 1 秒に指定します。

入力引数

すべて折りたたむ

イメージ データ。フル (非スパース) 行列として指定します。

  • グレースケール イメージの場合、A は m 行 n 列です。

  • インデックス付きイメージの場合、A は m 行 n 列です。関連カラーマップを map 入力引数で指定します。

  • トゥルーカラー イメージの場合、A は m x n x 3 でなければなりません。imwrite では RGB イメージの GIF ファイルへの書き込みはサポートされていません。

TIFF ファイルの場合、A は、CMYK 色空間を使用する色データを含む m x n x 4 の配列にすることができます。

マルチフレーム GIF ファイルの場合、A は、グレースケールまたはインデックス付きイメージを含む m x n x 1 x p の配列にすることができます。ここで p は書き込むフレームの数です。この場合、RGB イメージはサポートされません。

データ型: double | single | uint8 | uint16 | logical

出力ファイルの名前。文字ベクトルまたは string スカラーとして指定します。

書き込み先の場所によって、filename は次のいずれかの形式にできます。

場所

形式

現在のフォルダー

現在のフォルダーに書き込むには、ファイルの名前を filename に指定します。

filename にはファイル拡張子を含めなければなりません。imwrite が書き込むことができるイメージ タイプの一覧については、入力引数 fmt の説明を参照してください。

例: 'myImage.jpg'

その他のフォルダー

現在のフォルダーとは異なるフォルダーに書き込むには、絶対パス名または相対パス名を filename に指定します。

例: 'C:\myFolder\myImage.ext'

例: '\imgDir\myImage.ext'

リモートの場所

リモートの場所に書き込むには、filename に次の形式の Uniform Resource Locator (URL) として指定されたファイルの絶対パスを含めなければなりません。

scheme_name://path_to_file/my_file.ext

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

リモートの場所scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs
HDFS™hdfs

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

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

データ型: char | string

A のインデックス付きイメージ データと関連するカラーマップ。m 行 3 列の配列で指定します。map は有効な MATLAB カラーマップでなければなりません。組み込みの MATLAB カラーマップの一覧については、colormap を参照してください。イメージ ファイルの形式の多くは、256 要素を超えるカラーマップをサポートしていません。

例: [0,0,0;0.5,0.5,0.5;1,1,1]

例: jet(60)

データ型: double

出力ファイルの形式。次の表のいずれかの形式として指定します。

以下の表は、imwrite が書き込むことができるイメージのタイプも示しています。MATLAB ファイル形式レジストリは、どのファイル形式をサポートしているかを決定します。このレジストリの詳細については、imformats を参照してください。

特定の形式については、imwrite は追加の名前と値のペアの引数を受け入れることができます。これらの引数を表示するには、以下のリンク付き形式名をクリックしてください。

fmt の値

出力ファイルの形式

説明

'bmp'

Windows® ビットマップ (BMP)

1 ビット、8 ビット、および 24 ビットの非圧縮イメージ

'gif'

GIF — Graphics Interchange Format

8 ビット イメージ

'hdf'

HDF4 — Hierarchical Data Format

8 ビットのラスター イメージ データセット、関連カラーマップ付きまたは関連カラーマップなし、24 ビットのラスター イメージ データセット

'jpg' または 'jpeg'

JPEG — Joint Photographic Experts Group

8 ビット、12 ビットおよび 16 ビット Baseline JPEG イメージ

メモ

JPEG 形式はインデックス付きイメージをサポートしていないため、関数 imwrite はデータを JPEG ファイルに書き込む前にインデックス付きイメージを RGB に変換します。

'jp2' または 'jpx'

JPEG 2000 — Joint Photographic Experts Group 2000

1 ビット、8 ビット、および 16 ビット JPEG 2000 イメージ

'pbm'

Portable Bitmap (PBM)

任意の 1 ビット PBM イメージ。エンコードされた ASCII (プレーン) または raw (バイナリ)

'pcx'

Windows Paintbrush (PCX)

8 ビット イメージ

'pgm'

Portable Graymap (PGM)

任意の標準的な PGM イメージ: 任意のカラー階調度をもつエンコードされた ASCII (プレーン): グレー値に対して、16 ビットまでの階調度をもつエンコードされた raw (バイナリ)

'png'

PNG — ポータブル ネットワーク グラフ

1 ビット、2 ビット、4 ビット、8 ビット、および 16 ビットのグレースケール イメージ: アルファ チャネルをもつ 8 ビットと 16 ビットのグレースケール イメージ: 1 ビット、2 ビット、4 ビット、8 ビットのインデックス付きイメージ: 24 ビットまたは 48 ビットのトゥルーカラー イメージ: アルファ チャネルをもつ 24 ビットまたは 48 ビットのトゥルーカラー イメージ

メモ

関数 imwrite は、カラーマップ エントリが不足しているインデックス付き PNG ファイルの書き込みをサポートしていません。

'pnm'

Portable Anymap (PNM)

PPM/PGM/PBM 形式のいずれかで、自動的に選択

'ppm'

Portable Pixmap (PPM)

標準の PPM イメージ。任意のカラー階調度をもつエンコードされた ASCII (プレーン) またはグレー値に対して、16 ビットまでの階調度をもつエンコードされた raw (バイナリ)

'ras'

Sun™ ラスター (RAS)

アルファをもつ 1 ビットのビットマップ、8 ビットのインデックス付き、24 ビットのトゥルーカラーおよび 32 ビットのトゥルーカラーを含む任意の RAS イメージ

'tif' または 'tiff'

Tagged Image File Format (TIFF)

以下のイメージを含むベースライン TIFF イメージ

  • 1 ビット、8 ビット、16 ビット、24 ビットおよび 48 ビットの非圧縮イメージと packbits、LZW または Deflate 圧縮を使用したイメージ

  • CCITT 1D、グループ 3 およびグループ 4 圧縮を使用した 1 ビット イメージ

  • CIELAB、ICCLAB および CMYK イメージ

'xwd'

X Windows Dump (XWD)

8 ビット ZPixmaps

名前と値の引数

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

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

例: imwrite(A,'myFile.png','BitDepth',8) は、各ピクセルを表す 8 ビットを使用して A のデータを書き込みます。

GIF — Graphics Interchange Format

すべて折りたたむ

インデックス付きイメージの背景色として使用する色。'BackgroundColor' と、カラーマップ インデックスに対応するスカラー整数で構成されるコンマ区切りのペアとして指定します。

背景色は、アニメーション GIF の一部の破棄方法で使用されます。

  • イメージ データ A が uint8 または logical の場合、カラーマップ インデックスは 0 ベースです。

  • イメージ データ A が double の場合、カラーマップ インデックスは 1 ベースです。

既定の背景色はカラーマップの最初の色に対応します。

例: 'BackgroundColor',15

イメージに付加するコメント。'Comment' と、文字ベクトル、string スカラー、1 行 n 列の文字ベクトルの cell 配列、または string 配列で構成されるコンマ区切りのペアとして指定します。文字ベクトルの cell 配列では、imwrite は各文字ベクトルの後にキャリッジ リターンを追加します。

例: 'Comment',{'Sample #314','January 5, 2013'}

データ型: char | cell | string

次のイメージを表示するまでの遅延 (秒単位)。'DelayTime' と、[0,655] の範囲内のスカラー値で構成されるコンマ区切りのペアとして指定します。値 0 を指定すると、お使いのハードウェアで可能な限り速くイメージが表示されます。

例: 'DelayTime',60

アニメーション GIF の破棄方法。'DisposalMethod' と、次の表のメソッドのいずれかで構成されるコンマ区切りのペアとして指定します。

DisposalMethod の値 結果
'doNotSpecify' (既定)フルサイズの不透明なフレームを別のフレームに置換します。
'leaveInPlace'次のフレームによってカバーされないピクセルはすべて引き続き表示されます。
'restoreBG'背景色または背景タイルは透明なピクセルを介して表示されます。
'restorePrevious'前の状態の未処理フレームに戻します。

例: 'DisposalMethod','restoreBG'

イメージを基準とする画面のオフセット。それぞれの左上隅から測定され、'Location' と 2 要素ベクトルで構成されるコンマ区切りのペアとして指定します。最初のベクトル要素は上からのオフセットを、2 番目の要素は左からのオフセットをピクセル単位で指定します。

例: 'Location',[10,15]

データ型: double

アニメーションを繰り返す回数。'LoopCount' および [0,65535] の範囲内の整数または値 Inf で構成される、コンマ区切りのペアとして指定します。0 を指定すると、アニメーションは 1 回再生されます。値 1 を指定すると、アニメーションは 2 回再生されます。それ以降も同様です。Inf の LoopCount 値を指定すると、アニメーションは連続的にループします。

Microsoft® PowerPoint® 内でアニメーションを有効にするには、範囲 [1,65535] 内の 'LoopCount' 値を指定します。Microsoft のアプリケーションによっては、値 0 をループなしと解釈する場合があります。

例: 'LoopCount',3

フレームの高さと幅。'ScreenSize' および 2 要素のベクトルで構成されるコンマ区切りのペアとして指定します。ScreenSize 引数を 'Location' と一緒に使用すると、フレーム全体より小さいイメージにフレームを書き込むことができます。'DisposalMethod' はフレームの外側のピクセルの塗りつぶしの値を決定します。

例: 'ScreenSize',[1000 1060]

データ型: double

イメージの透明色として使用する色。'TransparentColor' と、カラーマップ インデックスに対応するスカラー整数で構成されるコンマ区切りのペアとして指定します。

  • イメージ データ A が uint8 または logical の場合、インデックスは 0 から始まります。

  • イメージ データ A が double の場合、インデックスは 1 から始まります。

例: 'TransparentColor',20

書き込みモード。'WriteMode' と 'overwrite' または 'append' で構成されるコンマ区切りのペアとして指定します。overwrite モードでは、imwrite は既存ファイル filename を上書きします。append モードでは、imwrite は既存ファイルにフレームを 1 つ追加します。

例: 'WriteMode','append'

HDF4 — Hierarchical Data Format

すべて折りたたむ

圧縮方式。'Compression' と次の表のいずれかのオプションで構成されるコンマ区切りのペアとして指定します。

Compression の値 結果
'none' (既定)圧縮なし
'jpeg'JPEG 圧縮。グレースケールおよび RGB イメージの場合にのみ有効です。
'rle'連長圧縮。グレースケールおよびインデックス付きイメージの場合にのみ有効です。

例: 'Compression','jpeg'

JPEG 圧縮ファイルの品質。'Quality' と [0,100] の範囲内のスカラーで構成されるコンマ区切りのペアとして指定します。0 は低品質で高圧縮、100 は高品質で低圧縮です。このパラメーターは、'Compression' が 'jpeg' の場合にのみ適用されます。

例: 'Quality',25

書き込みモード。'WriteMode' と 'overwrite' または 'append' で構成されるコンマ区切りのペアとして指定します。overwrite モードでは、imwrite は既存ファイル filename を上書きします。append モードでは、imwrite は既存ファイルにフレームを 1 つ追加します。

例: 'WriteMode','append'

JPEG — Joint Photographic Experts Group

すべて折りたたむ

ピクセルあたりのビット数。'BitDepth' とスカラーのコンマ区切りのペアとして指定します。

  • グレースケール イメージの場合、BitDepth 値は 8、12 または 16 にすることができます。既定値は 8 です。16 ビット イメージの場合、名前と値のペアの引数 'Mode' は 'lossless' でなければなりません。

  • カラー イメージの場合、BitDepth 値は平面あたりのビット数で、8 または 12 にすることができます。既定値は平面あたり 8 ビットです。

例: 'BitDepth',12

イメージに付加するコメント。'Comment' と、文字ベクトル、string スカラー、文字配列、n 行 1 列の文字ベクトルの cell 配列、または string 配列で構成されるコンマ区切りのペアとして指定します。imwrite は、入力の各行をコメントとして JPEG ファイルに書き込みます。

例: 'Comment',{'First line';'second line';'third line'}

データ型: char | string | cell

圧縮のタイプ。'Mode' と次のいずれかのオプションで構成されるコンマ区切りのペアとして指定します。

  • 'lossy'

  • 'lossless'

例: 'Mode','lossless'

出力ファイルの品質。'Quality' と [0,100] の範囲内のスカラーで構成されるコンマ区切りのペアとして指定します。0 は低品質で高圧縮、100 は高品質で低圧縮です。Quality 値を 100 にすると、可逆 JPEG イメージは書き込まれません。代わりに、名前と値のペアの引数 'Mode','lossless' を使用してください。

例: 'Quality',100

JPEG 2000 — Joint Photographic Experts Group 2000

すべて折りたたむ

イメージに付加するコメント。'Comment' と、文字ベクトル、文字配列、string スカラー、文字ベクトルの cell 配列、または string 配列で構成されるコンマ区切りのペアとして指定します。imwrite は、入力の各行をコメントとして JPEG 2000 ファイルに書き込みます。

例: 'Comment',{'First line';'second line';'third line'}

例: 'Comment',{'First line','second line','third line'}

データ型: cell | char | string

ターゲットの圧縮率。'CompressionRatio' と 1 以上の実数スカラーで構成されるコンマ区切りのペアとして指定します。圧縮率は、入力イメージのサイズと出力の圧縮サイズの比率です。たとえば、2.0 という値は、出力イメージのサイズが入力イメージのサイズの半分以下になることを意味します。大きな値を指定すると、ファイル サイズは小さくなりますが、イメージの品質が低下します。圧縮率では、ヘッダー サイズは考慮されません。

CompressionRatio は、'Mode' が 'lossy' の場合にのみ指定できます。

例: 'CompressionRatio',3

圧縮のタイプ。'Mode' と次のいずれかのオプションで構成されるコンマ区切りのペアとして指定します。

  • 'lossy'

  • 'lossless'

例: 'Mode','lossless'

コード ストリーム内のパケットの順序。'ProgressionOrder' と次のオプションのいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'LRCP'

  • 'RLCP'

  • 'RPCL'

  • 'PCRL'

  • 'CPRL'

これらの文字は、L=layer、R=resolution、C=component、および P=position を表しています。

例: 'ProgressionOrder','RLCP'

品質層の数。'QualityLayers' と [1,20] の範囲の整数で構成されるコンマ区切りのペアとして指定します。

例: 'QualityLayers',8

低減レベルまたはウェーブレット分解レベルの数。'ReductionLevels' と [1,8] の範囲の整数で構成されるコンマ区切りのペアとして指定します。

例: 'ReductionLevels',6

タイルの高さと幅。'TileSize' および 2 要素のベクトルで構成されるコンマ区切りのペアとして指定します。指定できる最小サイズは [128 128] です。

例: 'TileSize',[130 130]

PBM、PGM および PPM — Portable Bitmap、Graymap、Pixmap

すべて折りたたむ

エンコード。'Encoding' と 'rawbits' (バイナリ エンコードの場合) または 'ASCII' (プレーン エンコードの場合) で構成されるコンマ区切りのペアとして指定します。

例: 'Encoding','ASCII'

最大グレーまたはカラー値。'MaxValue' とスカラーで構成されるコンマ区切りのペアとして指定します。

PGM および PPM ファイルだけで利用可能です。PBM ファイルでは、この値は常に 1 です。

イメージ配列が uint16 の場合、MaxValue の既定値は 65535 です。そうでない場合は、既定値は 255 です。

例: 'MaxValue',510

PNG — ポータブル ネットワーク グラフ

すべて折りたたむ

各ピクセルの透明度。'Alpha' と、範囲 [0,1] の値の行列で構成されるコンマ区切りのペアとして指定します。Alpha 行列の行と列の次元は、イメージ データ配列の行と列の次元と同じでなければなりません。Alpha は、グレースケール (m 行 n列) およびトゥルーカラー (m x n x 3) イメージ データに対してのみ指定できます。

メモ

'Alpha' と 'Transparency' の両方を同時に指定することはできません。

データ型: double | uint8 | uint16

作成者情報。'Author' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

例: "Author','Ann Smith'

データ型: char

透明ピクセルを合成するときの背景色。'Background' と以下のイメージ データ依存の値で構成されるコンマ区切りのペアとして指定します。

イメージ タイプBackground 値の形式
グレースケール イメージ範囲 [0,1] のスカラー。
インデックス付きイメージ範囲 [1,P] の整数で、P はカラーマップの長さです。たとえば、'Background',50 と指定すると、背景色はカラーマップの 50 番目のインデックスで指定された色に設定されます。
トゥルーカラー イメージ範囲 [0,1] の RGB 強度の 3 要素ベクトルです。たとえば、'Background',[0 1 1] と指定すると、背景色はシアンに設定されます。

データ型: double

ピクセルあたりのビット数。'BitDepth' とスカラーのコンマ区切りのペアとして指定します。出力イメージに応じて、スカラーは以下のいずれかの値にすることができます。

イメージ タイプBitDepth に指定できる値
グレースケール イメージ1、2、4、8 または 16
アルファ チャネルをもつグレースケール イメージ8 または 16
インデックス付きイメージ1、2、4、または 8
トゥルーカラー イメージ8 または 16

  • イメージが double または uint8 クラスの場合、既定のビット深度はピクセルあたり 8 ビットです。

  • イメージが uint16 の場合、既定値はピクセルあたり 16 ビットです。

  • イメージが logical の場合、既定値はピクセルあたり 1 ビットです。

例: 'BitDepth',4

基準白色点と原色の色度。'Chromaticities' および 8 要素のベクトル [wx wy rx ry gx gy bx by] で構成されるコンマ区切りのペアとして指定します。要素 wx および wy は白色点の色度座標で、要素 rx、ry、gx、gy、bx および by は 3 原色の色度座標です。

Chromaticities を指定する場合は、名前と値のペアの引数 Gamma も指定する必要があります。

例: 'Chromaticities',[0.312,0.329,0.002,0.002,0.001,0.001,0.115,0.312]

データ型: double

イメージに付加するコメント。'Comment' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

著作権情報。'Copyright' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

元のイメージの作成時間。文字ベクトルまたは string スカラーとして指定します。

イメージの説明。'Description' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

法的放棄声明。'Disclaimer' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

ファイル ガンマ。'Gamma' とスカラーで構成されるコンマ区切りのペアとして指定します。

例: 'Gamma',2.2

イメージの最終変更時間。'ImageModTime' と、MATLAB シリアル日付値、または関数 datevec を使用して日付ベクトルに変換できる文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。値は、Coordinated Universal Time (UTC) でなければなりません。

既定の ImageModTime 値は、imwrite を呼び出した時間です。

例: 'ImageModTime','17-Jan-2013 11:23:10'

データ型: double | char | string

インターレース スキーム。'InterlaceType' と 'none' (インターレースなしの場合) または 'adam7' (Adam7 アルゴリズムを使用する場合) で構成されるコンマ区切りのペアとして指定します。

例: 'InterlaceType','adam7'

イメージ解像度の単位。'ResolutionUnit' と、'unknown' または 'meter' で構成される、コンマ区切りのペアとして指定します。ResolutionUnit を指定する場合は、名前と値のペアの引数 XResolution と YResolution のうちの少なくとも 1 つを含めなければなりません。ResolutionUnit の値が 'meter' の場合、XResolution と YResolution の値はメートルあたりのピクセルで解釈されます。

例: 'ResolutionUnit','meter','XResolution',1000

データ配列の有効ビットの数。'SignificantBits' と範囲 [1,BitDepth] のスカラーまたはベクトルで構成されるコンマ区切りのペアで指定します。出力イメージ タイプに応じて、値は以下のいずれかの形式で指定する必要があります。

イメージ タイプSignificantBits 値の形式
アルファ チャネルをもたないグレースケール イメージスカラー
アルファ チャネルをもつグレースケール イメージ2 要素ベクトル
インデックス付きイメージ3 要素ベクトル
アルファ チャネルをもたないトゥルーカラー イメージ3 要素ベクトル
アルファ チャネルをもつトゥルーカラー イメージ4 要素ベクトル

例: 'SignificantBits',[2,3]

イメージの作成に使用されるソフトウェア。'Software' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

イメージの作成に使用されるデバイス。'Source' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

アルファ チャネルが使用されない場合に透明と見なすピクセル。'Transparency' とスカラーまたはベクトルで構成されるコンマ区切りのペアとして指定します。出力イメージに応じて、値は以下のいずれかの形式で指定する必要があります。

イメージ タイプTransparency 値の形式
グレースケール イメージ透明と見なされるグレースケール カラーを示す範囲 [0,1] のスカラー。
インデックス付きイメージ範囲 [0,1] の値の Q- 要素ベクトル。ここで、Q は、カラーマップ長より短く、各値が、対応するカラーマップ要素に関連した透明度を示すものでなければなりません。多くの場合は、Q = 1 です。
トゥルーカラー イメージ透明と見なされるトゥルーカラーを示す範囲 [0,1] の RGB 強度の 3 要素ベクトル。

メモ

'Transparency' と 'Alpha' の両方を同時に指定することはできません。

例: 'Transparency',[1 1 1]

データ型: double

コンテンツの性質に関する警告。'Warning' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

水平方向のイメージ解像度 (ピクセル/単位)。'XResolution' とスカラーで構成されるコンマ区切りのペアとして指定します。名前と値のペアの引数 ResolutionUnit を指定して単位を定義します。

YResolution を合わせて指定しない場合、XResolution 値は水平方向と垂直方向の両方に適用されます。

例: 'XResolution',900

垂直方向のイメージ解像度 (ピクセル/単位)。'XResolution' とスカラーで構成されるコンマ区切りのペアとして指定します。名前と値のペアの引数 ResolutionUnit を指定して単位を定義します。

XResolution を合わせて指定しない場合、YResolution 値は水平方向と垂直方向の両方に適用されます。

例: 'YResolution',900

PNG 用にリストされた名前と値のペアの引数に加えて、キーワードに PNG 仕様を満たす任意のパラメーター名を使用できます。つまり、前後にスペースを含まない 80 文字以内の表示可能な文字を名前に使用できます。これらのユーザー設定の名前に対応する値は、改行以外の制御文字を含まない文字ベクトルまたは string スカラーでなければなりません。

RAS — Sun ラスター グラフィックス

すべて折りたたむ

各ピクセルの透明度。'Alpha' と、イメージ データ配列と同じ行と列の次元をもつ行列で構成されるコンマ区切りのペアとして指定します。

トゥルーカラー (m x n x 3) イメージ データの場合にのみ有効です。

データ型: double | single | uint8 | uint16

イメージ タイプ。'Type' と次の表のいずれかのオプションで構成されるコンマ区切りのペアとして指定します。

Type の値説明
'standard' (既定)非圧縮、トゥルーカラー イメージの場合 B-G-R
'rgb'非圧縮、トゥルーカラー イメージの場合 R-G-B
'rle1 ビットおよび 8 ビット イメージの連長圧縮

例: 'Type','rgb'

TIFF — Tagged Image File Format

すべて折りたたむ

色データを表す色空間。'ColorSpace' と次のオプションのいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'rgb'

  • 'cielab'

  • 'icclab'

イメージ データ配列 A がトゥルーカラー (m x n x 3) の場合にのみ有効です。TIFF ファイルで CMYK 色空間を使用する場合は、名前と値のペアの引数 'ColorSpace' を使用しないでください。代わりに、m x n x 4 のイメージ データ配列を指定します。

imwrite は、L*a*b* 色空間を使用するカラー イメージ データを TIFF ファイルに書き込むことができます。1976 CIE L*a*b* 仕様は、輝度 (L*) および色調 (a* および b*) 情報を表す数値を定義します。L*a*b* カラー データを TIFF ファイルに保存するには、8 ビットまたは 16 ビット ストレージに収まるように値をエンコードしなければなりません。imwrite は、以下のエンコードを使用して L*a*b* カラー データを TIFF ファイルに保存できます。

  • CIELAB エンコード — TIFF 仕様で定義された 8 ビットまたは 16 ビットのエンコード

  • ICCLAB エンコード — International Color Consortium (ICC) で定義された 8 ビットまたは 16 ビットのエンコード

imwrite で使用される出力クラスとエンコードは、以下の表に示すように、入力イメージ データ配列のクラスと ColorSpace 値によって異なります。(8 ビットおよび 16 ビットの CIELAB エンコードは符号付きと符号なしの値を混ぜて使用し、1 つの MATLAB 配列として表すことができないため、入力配列にはできません)。

入力クラスおよびエンコード

ColorSpace の値

出力クラスおよびエンコード

8 ビット ICCLAB


値は範囲 [0 255] の整数です。L* の値に 255/100 を掛けます。
128 を a* と b* の両方の値に足します。

'icclab'

8 ビット ICCLAB

'cielab'

8 ビット CIELAB

16 ビット ICCLAB


値は範囲 [0, 65280] の整数です。L* の値に 65280/100 を掛けます。
32768 を a* と b* の両方の値に足します。これらは [0,65535] の範囲の整数値で表されます。

'icclab'

16 ビット ICCLAB

'cielab'

16 ビット CIELAB

倍精度 1976 CIE L*a*b* の値


L* は動的範囲 [0, 100] です。a* と b* には、任意の値を使用できます。a* と b* を 0 (ゼロ) に設定すると、中間色 (グレー) になります。

'icclab'

8 ビット ICCLAB

'cielab'

8 ビット CIELAB

例: 'ColorSpace','cielab'

圧縮方式。'Compression' と次のオプションのいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'packbits' (非バイナリ イメージの既定の設定)

  • 'none'

  • 'lzw'

  • 'deflate'

  • 'jpeg'

  • 'ccitt' (バイナリ イメージ専用でバイナリ イメージの既定の設定)

  • 'fax3' (バイナリ イメージ専用)

  • 'fax4' (バイナリ イメージ専用)

'jpeg' は非可逆圧縮のスキームで、他の圧縮モードは可逆です。また、'jpeg' を指定した場合は、'RowsPerStrip' パラメーターも指定しなければならず、値は 8 の倍数です。

例: 'Compression','none'

イメージの説明。'Description' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。これは imfinfo が出力イメージの ImageDescription フィールドで返すテキストです。

例: 'Description','Sample 2A301'

X および Y 解像度。'Resolution' と、両方の解像度を示すスカラーまたは X 解像度と Y 解像度を含む 2 要素ベクトルで構成されるコンマ区切りのペアとして指定します。

例: 'Resolution',80

例: 'Resolution',[320,72]

データ型: double

各ストリップに含める行の数。'RowsPerStrip' とスカラーで構成されるコンマ区切りのペアとして指定します。既定値は、各ストリップがおよそ 8 キロバイトになる値です。

'jpeg' 圧縮を指定する場合は、RowsPerStrip を指定しなければなりません。値は 8 の倍数でなければなりません。

例: 'RowsPerStrip',16

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

書き込みモード。'WriteMode' と 'overwrite' または 'append' で構成されるコンマ区切りのペアとして指定します。overwrite モードでは、imwrite は既存ファイルを上書きします。append モードでは、imwrite は既存ファイルにページを 1 つ追加します。

例: 'WriteMode','append'

ヒント

  • 著作権に関する情報は、libtiffcopyright.txt ファイルを参照してください。

拡張機能

バージョン履歴

R2006a より前に導入

参考

| | | | |