 SpotLight

ISaGRAFのSpotLightツールはデバッグ中にモニタしたい情報をグラフィックやリストのスタイルで定義してモニタリングできます｡ グラフィック項目はISaGRAFプロジェクトの変数にリンクされなければなりません｡ 項目はオンライン中（デバッグ中）に新規に定義したり、アニメーションすることができます。

グラフィックレイアウトの構築

リストレイアウト表示

項目スタイル定義

「ファイル」メニューコマンド

バージョン3.2ユーザへの注意事項

選択された項目の変数を書き込みする際には、グラフィックやレイアウト上の項目をダブルクリックするか、選択されているときにＥｎｔｅｒキーの選択を行います｡


Building graphic layout
グラフィックレイアウトの構築

グラフィックレイアウト（画面）はバッググラウンド（背景）のグラフィックス、メタファイル上にグラフィックな変数項目を配置させることで作られます｡ この変数項目はデバッグ中にアニメーションされます。画面を構成する際には、まず、グラフィックスファイルを挿入、グラフィック変数項目を挿入、変数項目とプロジェクト内の変数とのリンクを行います｡

グラフィックス挿入

グラフィック変数項目の挿入：

テキスト

 	棒グラフ、バイポーラ棒グラフ

トレンドグラフ

ブール型アイコン

ビット展開

グラフィック変数項目を定義、変更：

選択、移動、サイズ変更

 	グループ化／グループ解除

項目スタイルの変更


The background picture
グラフィックスファイル

ビットマップ（ＢＭＰ）やメタファイル（ＷＭＦ）をレイアウト上に配置できます。配置されたグラフィックスは移動、サイズ変更が可能です｡ これらのファイルはリストレイアウトに切り替えたときには表示されません｡ SpotLightはペイントツールではないので、これらのファイルの修正は行えません｡

「オプション」－「背景色」コマンドでレイアウトの背景を指定された単一色にすることができます。

注意： ビットマップファイルは大きなメモリを占有するために、最適化されたファイルサイズにしておくことをお勧めします｡


Single text display
テキスト

テキストは長方形の中にかかれるテキスト項目です。このテキストは割り付けられた変数の値を表示します｡この項目にはブール型、整数／実数型、可変長文字列型、タイマ型すべての変数を割り付けることができます｡

長方形内の色やテキストの色の変更が行えます。 更に、長方形サイズにあわせた文字のフォント指定を行うことができます｡


Unipolar and bipolar bar graphs
 	棒グラフ、バイポーラ棒グラフ

棒グラフでは割り付けられた整数／実数型変数の値が指定された色の長方形の形状で表示されます｡ 垂直、水平の方向を設定できます｡ また、通常の棒グラフは上下左右のいずれの方向でも設定可能であるのに対して、バイポーラ型棒グラフでは２方向（正方向、負方向）を持ちます｡ バイポーラ棒グラフではスケールの最大値は２方向共に同じ値となります｡


Curves
トレンドグラフ

レイアウト上にトレンドグラフを挿入することが可能です。トレンドグラフは割り付けられた変数値の履歴を示します｡ 正確な測定ツールではありませんが、複数の変数を配置することで変数間のタイミングも見ることができます｡

トレンドグラフは最新の２００点の値を蓄積、表示します｡ トレンドグラフのサイズを変更してもこの点数の変更はできません｡


Boolean icons
ブール型アイコン

レイアウト上にブール型アイコンが挿入できます｡ブール型アイコンはブール型変数の状態をアイコンファイルの形状によって表現します｡ FALSE時のアイコンファイル（ＩＣＯ）とTRUE時のアイコンファイルを割り付けることになります｡ SpotLightはアイコンエディタではありませんので、アイコンファイルの修正は行えません｡ これらのアイコンファイルは別のツールで準備しておく必要があります｡


Bit fields
ビット展開

ビット展開は整数型変数をビット列（３２ビットバイナリ）のグラフィック表示であらわすことができます｡ ＬＳＢは常に右側となります。整数型以外の変数を表示することも可能ですが、直接意味のある表示にはなりません。ビット列が正しく表示されるためには項目表示サイズの左右に十分な大きさが必要です｡


Select, move or resize items
選択、移動、サイズの変更

レイアウト上の項目を選択するためにはマウスで直接シンボルをクリックします。複数のシンボルをまとめて選択する場合はマウスで選択する領域を選びます｡ 項目が選択されたときは、境界領域が小さな■によって囲まれます。

選択された項目を非選択とするためには、項目以外のバックグラウンドをマウスクリックします｡

項目を移動する場合は、選択された領域の境界付近にマウスを近づけることにより、マウスカーソルの形状が移動用に変わります。ここで、マウスドラッグすることにより項目を移動させることができます｡

シンボルのサイズの変更を行う際には、マウスを選択領域の■上に移動させ、マウスカーソルの形状が変化したところで、マウスドラッグします｡

シンボルにはビットマップファイル、メタファイルが含まれます｡


Group items / dissociate groups
 	グループ化／グループ解除

レイアウト上の複数の項目をグループ化して一つの項目にすることができます｡ 「編集」－「グループ化」コマンドによりグループ化することができます。グループ化により、項目をまとめて移動することができますがサイズの変更はできません。

グループ化された項目を元に戻すためにはグループ解除します。「編集」－「グループ解除」コマンドにより選択されたグループを解除することができます｡

グループ内に別のグループやグラフィックスを含めることも可能です｡

グループ化された項目に関するスタイルの変更はできません｡

グループ化された項目はリストレイアウトに切り替えると１つの項目にまとめられて表示されます｡


Defining item style
項目のスタイル設定

レイアウト上の項目のスタイルの変更、定義が行えます｡ シンボルを選択して、「編集」－「項目のスタイル設定」コマンドを選択することで項目のスタイルの設定が行えます｡ シンボルの選択はグラフィックレイアウト、リストレイアウトのいずれの場合も可能です｡

新規に項目を挿入することにより、項目スタイルの設定ダイアログボックスが開きます。

設定ダイアログボックスでは以下のことが行えます｡

スタイル設定：

項目の表示スタイル（単一テキスト、棒グラフ、トレンドグラフ…）をダイナミックに変更できます｡ブール型アイコンが選択された場合は、指定するアイコンファイルはパス名付きで指定する必要があります｡「．．．」ボタンを選択することでアイコンファイルを一覧して選択が可能です。

スケール：

棒グラフやトレンドグラフでの最大値を示します｡バイポーラ棒グラフでは２方向共、同じ最大値となります｡

変数名：

変数名フィールドが選択されているときに「．．．」ボタンの選択により、プロジェクト内で宣言されている変数の選択が行えます｡

キャプション：

キャプションはグラフィックレイアウト上でグラフィック項目の近くに表示される名称です。キャプションの場所（左右上下）や表示形式を選択できます｡ キャプションのカスタマイズはリストレイアウトモードに切り替えた場合には影響を受けません。

変数書き込み：

「変数書き込み」オプションがチェックすると、デバッグ中にグラフィックオブジェクトをダブルクリックすると、そのオブジェクトに関連した変数の値を変更可能になります。


Commands of the "File" menu
「ファイル」メニューコマンド

「ファイル」メニューコマンドにはレイアウトドキュメントの管理用に以下のコマンドが含まれます｡

「ファイル」－「新規」メニューコマンドにより新規のレイアウトを作成できます。一つのプロジェクト内で作成できるレイアウトの数の制限はありません。SportLightでは同時に２つ以上のレイアウトを開くことはできません｡ ただし、複数のプロジェクトをデバッグ中は各プロジェクトに対してレイアウトを開くことができます｡

「ファイル」－「開く」メニューコマンドにより現在開かれているレイアウトを閉じて、選択されたレイアウトを開くことができます｡ また、レイアウトを選択するダイアログボックスでは「削除」ボタンにより登録されているレイアウトを削除することができます｡ ただし、この操作によって関連付けられているアイコン、ビットマップファイルなどは削除されることはありません。

「ファイル」－「上書き保存」メニューコマンドにより開かれているレイアウトをディスクに保存することができます｡ もし、レイアウトに名前（タイトル）が与えられていない場合は、これを入力する必要があります｡ レイアウト名は以下のルールに従う必要があります｡

•	 名前は最大８文字

•	 最初の文字はレター

•	 以降はレター、数字、アンダースコア

•	 大文字、小文字の区別なし

「ファイル」－「ロック」メニューコマンドにより開かれているレイアウトへの新規項目の追加、背景色の変更、項目のスタイル設定などをできなくすることができます｡ メニューコマンドの多くが選択不可となります。ただし、この状態でも既にレイアウト上にある項目への変数書き込みは可能です｡

間違ってレイアウトを変更させなくするためには有効な手段です｡


The list layout
リストレイアウト

「オプション」－「リスト／グラフ レイアウト」メニューコマンドにより、グラフィックレイアウトとリストレイアウトモードの切り替えを行うことができます｡

リストレイアウトモードでは、すべての項目がリスト上にならべられます。ひとつの項目の高さはスタイルによってあらかじめ決められています｡ ビットマップやメタファイルなどはこのモードでは表示されません｡ このモードでも項目の選択、項目のスタイル設定は可能です。ただし、複数の項目の選択、グループ化などは行うことができません｡

 	「編集」－「リストの上／下へ移動」メニューコマンドにより選択された項目をリスト内で上下方向に移動させることができます｡


Note for ISaGRAF V3.2 users
バージョン3.2ユーザへの注意事項

SpotLightは、バージョン3.0あるいは3.2で作成されたグラフィックデータやトレンドグラフのデータを読み込むことが可能です。これらのファイルは、「ファイル－オープン」のダイアログに作成されたバージョンのコメント付でリストアップされます。読み込んだファイルは、SpotLightで自由に編集することが可能です。

バージョン3.2で作成されたグラフィックデータは、自動的にロック状態になってオープンされます。編集する為には、一旦「ファイル－ロック」コマンドでロックを解除しなければなりません。

バージョン3.2で作成されたグラフィックデータやトレンドグラフのデータは、一旦オープンすると、終了時にSpotLightのデータフォーマットで保存することを促す為のメッセージボックスが自動的にオープンします。