Main Content

rsetwrite

イメージ ファイルからの R-Set ファイルの作成

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

構文

rsetfile = rsetwrite(filename)
rsetfile = rsetwrite(filename,rsetfilename)
rsetfile = rsetwrite(adapter,rsetfilename)

説明

例

rsetfile = rsetwrite(filename) は、指定された入力から解像度を下げたデータセット (R-Set) ファイルを作成します。入力ファイルは TIFF または NITF イメージ ファイルでなければなりません。関数は、生成した R-Set ファイルを現在の作業フォルダーに書き込みます。このファイルの名前は入力と同じですが、拡張子は rset になります。

rsetfile = rsetwrite(filename,rsetfilename) は、rsetfilename を使用して R-Set ファイルの名前を指定します。

rsetfile = rsetwrite(adapter,rsetfilename) は、ImageAdapter オブジェクト adapter から rsetfilename という名前の R-Set ファイルを作成します。TIFF でも NITF でもないタイプのイメージ ファイルから R-Set ファイルを作成する場合に、この構文を使用します。

例

すべて折りたたむ

ライブ スクリプトを開く

TIFF イメージ ファイルをワークスペースに読み込みます。 

filename = "mandi.tif";

イメージ ファイルから R-Set ファイルを作成します。関数は現在の作業フォルダーに R-Set を作成します。

rsetfile = rsetwrite(filename);

関数imtoolを使用して、R-Set ファイルを表示します。

imtool(rsetfile)

R-Set ファイルを 65% 拡大して空間的なタイルを表示します。

imtool(rsetfile,"InitialMagnification",65);

入力引数

すべて折りたたむ

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

データ型: char | string

出力 R-Set ファイルの名前。文字ベクトルまたは string スカラーとして指定します。rsetfilename を指定しない場合、filename は R-Set ファイルの名前 rsetfile を設定します。

データ型: char | string

イメージ アダプター オブジェクト。ImageAdapter オブジェクトとして指定します。ImageAdapter は、特定のイメージ ファイル形式を読み取る一般的な API と共に関数 rsetwrite を提供するユーザー定義オブジェクトです。

出力引数

すべて折りたたむ

R-Set ファイルの名前。string スカラーとして返されます。この値は、R-Set が格納されるファイルの名前を指定します。

ヒント

  • rsetwrite は、空間的なタイルにイメージを分割し、異なる解像度レベルのイメージをリサンプリングすることで、R-Set を作成します。R-Set ファイルには完全な解像度のイメージ データの圧縮コピーが含まれます。イメージ ツール (imtool) を使用して R-Set ファイルを開き、ズームインして高い解像度でタイルを表示できます。ズーム アウトすると、関数は低い解像度のタイルを表示します。このように R-Set ファイルでは、イメージの鮮明度とメモリ消費量は、最適なパフォーマンスを得られるようにバランスが取られます。

  • R-Set の作成時、進行状況バーに完了のステータスが表示されます。完了する前に作成プロセスをキャンセルした場合、関数は R-Set を作成せず、空の rsetfile を返します。

  • rsetwrite は、未圧縮の version 2.0 以降の NITF イメージ ファイルをサポートしています。この関数では、3 つを超えるデータ帯域または浮動小数点データを持つ NITF ファイルはサポートされません。1 つを超えるデータ帯域を持つイメージは、符号なし整数データを含む場合には受け入れられます。

  • 単一の R-Set タイルより小さい次元のイメージから R-Set を作成することができます。ただし、結果として得られる R-Set ファイルが元のファイルより大きくなり、読み込みに時間がかかる場合があります。R-Set 内のタイルの現在のサイズは 512 × 512 ピクセルです。

バージョン履歴

R2009a で導入

参考

| | |