Main Content

readRGBATile

RGBA インターフェイスを使ったタイル データの読み取り

説明

[RGB,alpha] = readRGBATile(t,row,col) は、RGBA インターフェイスを使用して、Tiff オブジェクト t に関連付けられている TIFF ファイルからタイルを読み取ります。タイルは rowcol で指定します。これらは、要求されたファイルの、任意のピクセルの 1 ベースの行番号と列番号です。

関数 readRGBATile は、タイルの領域のうち、ImageLength および ImageWidth 境界の外側にある領域をトリミングします。そのため、イメージの下端または右端のタイルから取得したイメージ データは次元が異なる場合があります。

すべて折りたたむ

RGBA インターフェイスを使用して、TIFF イメージ ファイルからデータのタイルを読み取ります。

イメージ ファイルの Tiff オブジェクトを作成します。

t = Tiff('peppers_RGB_tiled.tif','r');

タイルの番号とタイルのサイズを取得します。

numTiles = numberOfTiles(t)
numTiles = 36
tileSize = [getTag(t,'TileLength') getTag(t,'TileWidth')]
tileSize = 1×2

    32    48

イメージから 100 番目の行と 100 番目の列を含むタイルを読み取ります。関数 readRGBATile は、タイルの領域のうち、ImageLength および ImageWidth の境界の外側にある領域をトリミングします。そのため、イメージの右端または下端のタイルから取得したイメージ データの次元が異なる場合があります。

row = 100;
col = 100;
[RGB,A] = readRGBATile(t,row,col);

イメージを表示します。

imshow(RGB,'InitialMagnification','fit') % magnify for display

Figure contains an axes object. The axes object contains an object of type image.

Tiff オブジェクトを閉じます。

close(t);

入力引数

すべて折りたたむ

TIFF ファイルを表す Tiff オブジェクト。このオブジェクトを作成するには、関数 Tiff を使用します。

行番号。正の整数として指定します。row は、タイル内の任意のピクセルの、1 ベースの行インデックスとして指定します。

例: 100

データ型: double

列番号。正の整数として指定します。col は、タイル内における任意のピクセルの、1 ベースの列インデックスとして指定します。

例: 57

データ型: double

出力引数

すべて折りたたむ

イメージ タイル データ。m×n×3 の数値配列として返されます。ここで、mn はそれぞれタイルの高さと幅です。

TileLength タグの値はタイル データの行数を定義し、TileWidth タグは列数を定義します。

関数 readRGBATile は、次のタグの仕様に基づいてピクセル値を変換することができます。

PhotometricInterpretation
BitsPerSample
SamplesPerPixel
Orientation
ExtraSamples
ColorMap

イメージ タイルに関連付けられたアルファ マッティング。数値配列として返されます。アルファ マッティング データの行数と列数は、タイル データと同じです。

イメージにアルファ マッティングが関連付けられていない場合、alpha はすべての値が 255 (透明) に設定された行列になります。

アルゴリズム

すべて折りたたむ

参照

この関数は、LibTIFF C API の関数 TIFFReadRGBATile に相当します。この関数を使用するには、TIFF の仕様とテクニカル ノートに精通していなければなりません。このドキュメンテーションは LibTIFF - TIFF Library and Utilities で参照してください。

バージョン履歴

R2009b で導入