VisualApplets
ユーザーマニュアル

Simulation Source Viewerでは、Test Imagesまたはテスト画像シーケンスを読み込んで、シミュレーションで使用できるようにすることができます。

まず、Simulation Source Viewerを簡単に見てみましょう。

Simulation Source Viewerが開きます：

図 87. Simulation Source Viewer

メニューのすぐ下にはツールバーがあります。ツールバーのアイコンからは、 以下のオプションを利用できます（左から右へ）：

左側には、2つのタブを持つ設定パネルがあります：

シミュレーションビューアの下部には、もう1つのパネルがあります：これがSequence viewerです。ソース内で複数の画像を使用している場合、ここで画像シーケンスのすべての画像を確認したり、シーケンスの画像順序を変更したり、表示パネルや拡大鏡に表示する画像を選択したりできます。

実際、MagnifierはSource Viewerの2つ目のウィンドウであり、ドラッグ＆ドロップによってメインのSource Viewerウィンドウから簡単に切り離すことができます。Magnifierには常に、メインのSource Viewerの表示パネルに表示されているものと同じ画像が表示されます。そのポインタは常にMagnifierウィンドウの中央にあり、表示パネルで指し示しているピクセルの正確な位置に配置されます。Magnifierウィンドウの大きな利点は、まったく異なるズームファクターで画像の一部を表示できることです：

図 90. 拡大鏡でのズーム

Magnifierのズームファクターを変更したい場合：

非常に高いズームファクターを選択すると、位置合わせをしやすくするためにピクセルグリッドが表示されます。

ソースにテストイメージまたはテストイメージシーケンスを読み込むには、

	注意
	便利なテストイメージが、VisualAppletsのインストールフォルダ内の以下の場所にあります。 \Testimages.

	ヒント
	または、Windows Explorerからビューアーへ、あるいはWindows Explorerからダイアグラム内のソースへイメージファイルをドラッグ＆ドロップするだけでも可能です。

入力イメージがSimulation Source Viewerに表示されます。

Simulation Source Viewerを閉じると、対応するソースのプレビューフレームにイメージのサムネイルが表示されます。

図 91: ソースでのサムネイル表示

ソースをリンクに接続するとすぐに、ソースはそのリンクのパラメータ設定（最大イメージ寸法、Bit Width、Color Formatなど）を引き継ぎます。リンクの最大イメージ寸法よりも大きいイメージを読み込むと、シミュレーションで使用されるイメージの部分を囲む緑色の長方形がイメージ上に表示されます。

図 92: シミュレーションで使用されるハイライトされたイメージセクション

	イメージの変換
	カラー画像を1チャンネルのグレーリンクに読み込むことはできません（逆も同様です）。テストイメージがソースの接続先であるリンクのプロパティに適合しない場合は、イメージを変換する必要があります。テストイメージの変換に必要な機能を提供する画像処理プログラムを使用してください。VisualAppletsがサポートする画像フォーマットを使用してください。サポートされている画像フォーマットについては、'Supported Image Formats'を参照してください。

新しいイメージをソースに読み込むとすぐに、そのイメージがSimulation Source Viewerのディスプレイパネルに表示され、ソースのイメージシーケンスに追加されます。イメージシーケンス内のすべてのイメージは、Simulation Source Viewerの下部にあるSequence Viewerで確認できます。

ディスプレイチャンネルに表示されている選択されたイメージのみがコンピュータのRAMに保存されます。シーケンス内の他のイメージは、必要なときにRAMに読み込まれます。したがって、長いイメージシーケンスをソースに読み込んでも、RAMの使用量にはほとんど影響しません。

イメージシーケンスを読み込んだ後、読み込み順序を変更することができます。Sequence Viewerで、ドラッグ＆ドロップを使用してシーケンス内の希望の位置にイメージを配置します。

シーケンスから1つまたは複数のイメージを簡単に削除できます。

Sequence Viewerでは、sim[x]は次のシミュレーションステップ中にシミュレーションされるイメージを示します。SimulationダイアログでResetボタンをクリックすると、sim[x]をシーケンスの最初のイメージにリセットできます。シミュレーションステップとリセットの詳細については、'Setting the Number of Processing Cycles and Starting the Simulation'を参照してください。シミュレーションの順序は、現在ディスプレイパネルに表示されているイメージの影響を受けません。

図93. sim[x]：シーケンス内でシミュレーションされている画像を示します

マッピングによって画像プロパティを変更した場合（'Image File Mapping 'を参照）、サムネイルは自動的に更新されません。 デフォルトでは、Sequence Viewerにオリジナル画像のサムネイルが表示されます。

サムネイルの表示を調整するには、次の2つの方法があります。メニューから次を選択します。

表示パネル上の各ピクセルには、実際には2つの十字カーソルが表示されます。 2つの十字カーソルが見えない場合は、表示パネルの画像を拡大してください：

図94. 表示ウィンドウと拡大鏡の十字カーソル

白/黒の十字カーソルは、マウスカーソルの位置を示します。

色のついたカーソルは、マウスカーソルが指しているピクセルの中心に配置されます。この十字カーソルは、Magnifierのまったく同じピクセルにも表示されます。

設定パネルのタブDisplay Propertiesに対応するピクセル値が表示されます：

図95. ピクセル値

ピクセル値を符号なし10進数、符号付き10進数、または16進数のいずれで表示するかを選択できます。

Displayには、画面に表示されている値が表示されます。 ソースに16 bitまたは48 bitの画像が読み込まれている場合、この値は実際のカラー値（またはグレイ値）とは異なる場合があります。画面上では、カラーチャンネルごとに8 bitしか表示できないためです。

Simulation Source ViewerのタブImage File – Mappingには、左側に現在の画像（ファイルから読み込まれた状態）の画像寸法、右側にリンクの画像寸法を示す表があります：

図96. 画像寸法

列Merged Pixelsについては、'Pixel Spitting and Merging'で説明しています。

画像ファイルの寸法がリンクの寸法よりも小さい場合、画像は1:1のスケールでリンクに転送されます。

画像ファイルの寸法がリンクの寸法を超える場合、画像のの一部のみがシミュレーションに使用されます。シミュレーションに使用される画像部分は、表示パネルの緑色の長方形で確認できます。また、対応する値が黄色でハイライト表示されます：

図97. 超過した画像寸法

	ヒント
	表示画面に緑色の長方形が表示されない場合は、表示オプションをView → Fit to Windowに設定してください。

Simulation Source ViewerのタブImage File – Mappingには、テスト画像（ファイル）の Bit Width およびソースが接続されているリンクの Bit Width に関する情報も記載されています。

図 98. Image and Link の Bit Width

列Merged Pixelsについては、'Pixel Spitting and Merging'で説明しています。

リンクの Bit Width よりも大きい Bit Width を持つ画像を読み込む場合は、シミュレーションに使用する画像のビットをスライダーで選択できます。

図 99. 使用する画像ビットのオフセットの定義

選択スライダーの Bit Width は、リンクの Bit Width と同じです。スライダーを使用して、オフセットの新しい位置を定義できます。オフセットは、画像の Bit Width に対するビット選択の開始点です。これらの設定に基づいて、Simulation Source Viewer は変更された画像を即座に計算し、表示パネルにそれを表示します。上記のスクリーンショットでは、8ビット画像の8ビットのうち上位4ビットが選択されています。そのため、シミュレーションに使用されるテスト画像は、256階調ではなく16階調のみを持ちます。

	Simulation Source Viewer での変更されたテスト画像の視覚化
	PC モニター上の表示はピクセルあたり8ビットの情報に基づいているため、16階調のみを持つ画像を適切に表示することはできません。そのため、画面上で視覚化するために、テスト画像の16階調は8ビットモニター表示の256階調にマッピングされます。このマッピングによって表示されるグレーの階調数（16）が変わることはありませんが、それらの間のコントラストが向上します（0 = 黒、15 = 白）。

図 100. 4ビット画像の Display Properties

逆に、読み込み先のリンク（つまりソースモジュールが接続されているリンク）よりも小さい Bit Width を持つ画像を読み込む場合は、Image File – Mapping タブの同じスライダーを使用して、リンクの Bit Width に対する画像のビットのオフセットを定義できます。リンクの残りのビットは NULL に設定されます。

下の図は、12ビットの Bit Width を持つリンクに8ビットのグレースケール画像が読み込まれた例を示しています。

図 101. 使用するリンクビットのオフセットの定義

表示の配置を介して、変更されたテスト画像を Simulation Source Viewer で視覚化するためのいくつかの設定を定義できます。

リンクの Bit Width が8ビットより大きい場合は、リンクの Bit Width のうちどの8ビットを表示パネルに表示するかを定義する必要があります。PC モニターでの表示はカラーチャンネルあたり8ビットに制限されているため、より高い Bit Width は表示できません。

Simulation Source Viewer の Display properties タブでは、リンクのビットのうちどの8ビットを表示パネルに表示するかを定義できます。スライダーを使用して、表示可能な8ビットのオフセットを選択します。この表示配置の設定は、シミュレーションには影響しません。

以下の例では、リンクの Bit Width は12ビットです。スライダーを使用して、12ビットのうちどのビットを表示するかを決定できます。

図 102. Display Alignment

イメージ BMP ファイル形式では、ピクセルのカラーチャンネルあたり最大8ビットが許可されます。 TIFF フォーマットでは、カラーチャンネルあたり最大16ビットが許可されます。これより高い Bit Width は、標準の画像ファイル形式で単純に保存することはできません。

VisualApplets では、これらの制限を回避するためにピクセル分割機能を提供しています。

ピクセル Bit Width が高い画像を標準の画像ファイル形式で保存するために、各ピクセルが複数の画像ファイルピクセルに分割されます。これにより、たとえば 8 x 8ビットピクセルなど、 BMP または TIFF ファイル形式ではカラーチャンネルあたり最大64ビットを保存できます。これらの画像は、通常の画像ファイルビューアや画像処理プログラムで表示できます。もちろん、VisualApplets によって生成されたピクセル分割画像は、水平方向に拡大されて表示されます。したがって、VisualApplets において、ピクセル分割は Bit Width（色深度）の高い画像のための単なる保存オプションです。

高 Bit Width の画像を読み込むには、次のように保存されています BMP または TIFF ファイルを取り込むには、1つの元のピクセルのカラー情報を共有する隣接ピクセルを1つのピクセルに統合し直す必要があります。これにより、シミュレーションソースビューアでpixel-split-imagesを統合して正しいマッピングを行うことができます。分割は次の場所で行うことができます： Simulation Probe Viewer （ 'Evaluating the Simulation Results')。ピクセル統合の設定は次の場所で定義できます： Simulation Source Viewer タブ Image File – Mapping:

図103. Pixel Merge

次の例では、2048x1024の BMP ファイル（Bit Width（色深度）8 bit）がソースに読み込まれています。これは16 bitの1024x1024画像として解釈されます。

Merge N pixel into 1 pixelフィールドに2と入力すると、ソース内の画像のBit Widthがカラーチャンネルあたり8 bitから16 bitに変更される一方で、ソース内の画像の行の長さは半分になり、2048から1024ピクセルに変更されます。

統合前：

図104. Merging Factor = 1, Image Properties Do Not Fit Link Properties

統合後：

図105. Merging Factor = 2, Properties of Merged Image Fit Link Properties

Simulation Source Viewerと同様に、表示パネルの各ピクセルには2つの十字カーソルが表示されます。2つの十字カーソルが表示されない場合は、表示パネルの画像を拡大してください。白黒の十字カーソルはマウスカーソルの現在の位置を示し、色付きのカーソルはマウスポインターが指すピクセルの中心に配置されます。 この十字カーソルは、Magnifier上の全く同じピクセルにも表示されます。

設定パネルには、対応するピクセル値が表示されます。

図 113. Pixel Values Probe

選択したピクセルのカラー値の解釈を調整するには、さまざまなオプションがあります。

Displayには、画面に表示される値が表示されます。プローブ内に16ビットまたは48ビットの画像がある場合、画面上ではカラーチャンネルあたり8ビットしか表示されないため、この値は実際のカラー値（または濃淡値）とは異なる場合があります。

Displayの値と画像ウィンドウ内の表示色の間でトーンマッピングを実行するカラーマップを選択できます。これは、符号付き画像データを扱う場合や、含まれる画像の特性がグレースケール表現では見えにくい場合に特に便利です。

シミュレーションプローブがカーネルを転送するリンクに接続されている場合は、KernelパネルのカーネルRowおよびカーネルColumnスピンボックスで個別のカーネル画像を選択できます。

画像がシミュレートされると、すぐにSimulation Probe Viewerに表示され、Sequence Viewerに追加されます。

Simulation Probe Viewer内の画像の順序を変更することはできません。

ただし、シーケンスから1枚以上の画像を削除することはできます。

マッピングによって画像プロパティを変更した場合（例：16ビット画像を BMP ファイルに保存する場合など）、サムネイルは自動的に更新されません。デフォルトでは、 Sequence Viewer には元のシミュレーション結果のサムネイルが表示されます。

VisualAppletsでは、行の長さが一様ではない長方形以外の画像の処理と表示も可能です。行の長さが異なる画像を表示することもできます。

このような画像の画像サイズは、VisualAppletsによって次のように計算されます。

	行の長さが不均一な画像のサイズ計算
	画像サイズ = 最も長い行のピクセル数 × 行数

行の長さが NULL の行もカウントされます。画像の未定義領域は、表示画面上で青からシアンへのカラーグラデーションで表されます。

図 114: 未定義の画像領域の表示

空の画像は Empty Image というシンボルで表示され、保存することはできません。

図 115: 空の画像のシンボル

Simulation Probe Viewer の表示パネルでは、同じ画像を表示する方法として次の2つを提供しています。

モニターは常にカラーチャネルあたり8 bitを使用するため、これより高いまたは低い Bit Width を持つ画像をそのまま表示することはできません。

シミュレーション結果の Bit Width が8 bitより高い場合、オフセットスライダーを使用して、表示パネルに表示する8 bitを選択できます。

図 116: Link View

この例では、16ビットグレースケールの上位8ビットが表示対象として選択されています。

画像の Bit Width が8 bit未満の場合、テスト画像のグレースケール値は、8 bitモニターディスプレイの256階調のグレースケール値に自動的にマッピングされます。このマッピングによって表示される階調の数自体は変わりませんが、階調間のコントラストが向上します。このマッピングを行わないと、人間の目には画像がまったく認識できない場合があります。例えば1 bit画像の場合、マッピングを行わずに値0および1をモニター表示に使用すると、人間の目にはどちらも黒として認識されてしまいます。この場合、VisualAppletsの自動 Bit Width マッピングにより、0が0（黒）に、1が255（白）に解釈されます。

Line Histogram ビューには、選択されたラインに対して計算された次の統計値も表示されます。

Image Histogram ビューには、選択された画像に対して計算された次の統計値も表示されます。

画像のBit Width（＝リンクのBit Width）が、保存用に選択したファイルフォーマットのBit Widthと同じである場合は、画像を1:1で保存できます。

画像のBit WidthがファイルフォーマットのBit Widthよりも小さい場合は、スライダーを使用してピクセル配置オフセットを変更できます。これにより、シミュレーション結果のビットを、ファイルフォーマットの（より大きな）ピクセル内の特定の位置に保存できます。たとえば、12ビットリンクのビットを16ビットの最下位12ビットまたは最上位12ビットに保存します TIFF 画像。

画像のBit WidthがファイルフォーマットのBit Widthよりも大きい場合は、スライダーを使用して、画像ピクセルのどのビットをファイルに保存し、どのビットを破棄するかを選択できます。

ファイルに保存される状態の（ストリップされた）画像のプレビューを表示するには：Simulation Probe Viewerのメインウインドウで、設定パネルの上部にあるラジオボタンをFile Viewに設定します。