ダイアログ: XY チャートの設定

シンボル：

関数: ダイアログには、直交座標系 XY チャート配列からのデータを表示します。

電話: の直交座標系 XY チャートプロパティ、クリック XYチャート。

要件: アクティブな視覚化エディタでXYチャートが選択され、それぞれのプロパティビューが開きます。

ダイアログの左側のツリービューにはXYチャートの設定が表示され、ナビゲータとして機能します。最上位のエントリ（1）を選択した場合、または何も選択していない場合は、要素設定右側にグループが表示されます。これには、チャートの更新頻度の設定が含まれます。さらに、チャートの外観と機能に影響する設定も利用できます。

以下のエントリを選択した場合は、曲線ノード（2）の場合、カーブ設定右側にグループが表示されます。この構成には、選択した曲線に割り当てられた Y 座標軸と、曲線に表示される配列データが含まれます。さらに、選択した曲線の外観と機能に影響を与える設定も利用できます。エントリには、割り当てられた座標軸が括弧内に表示される曲線の名前が表示されます。たとえば、 Curve1 [AxisY1] 縦軸は AxisY1 曲線に割り当てられる Curve1。

以下のエントリを選択した場合は、斧ノード（3）の場合、軸設定右側にグループが表示されます。この設定には、グラフ内の Y 座標軸の位置が含まれます。さらに、選択した座標軸の外観と機能に影響を与える設定も利用できます。エントリには、軸の名前とその機能が括弧内に表示されます。軸は、X 軸または Y 軸として機能します。たとえば、 AxisX(X) つまり軸 AxisX 水平横軸として機能する X。

追加	ビューに新しいエントリを追加します結果: 新しい曲線または軸の横に空の構成が表示されます。そこで設定を編集します。
消去	選択したエントリを削除します
上へ移動	選択したエントリを1つ上に移動します
下に移動	選択したエントリを1つ下に移動します

わかりました

設定を保存し、ダイアログを閉じ、設定に従って要素を表示します。

グループ: 要素設定

表 132. アップデート

タイプ

自動: チャートのレンダリングに影響する配列データまたは配列要素が変更されると、チャートは自動的に更新されます。
ヒント: 設定自動更新を有効にするは、拡張変数自動更新をプログラムで制御します。
変数: 変数値が変更されると、チャートが更新されます。

変数

変数（整数データ型）

タイプが変数が選択されます。

例を参照: 変数

例 50. 例: 変数

宣言

PROGRAM Sine
VAR_INPUT
   uiUpdate : UINT;
END_VAR

割り当て

Sine.uiUpdate

表 133. 背景

タイプ	背景なし無地: 入力フィールドで設定された背景色色そして透明性。勾配: グラデーションのある背景。グラデーションエディターを開きます。画像: 画像付き背景。入力フィールドで設定します画像ID。スタイルから: スタイルで定義された背景。
色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。利用可能無地タイプが選択されました
透明性	選択した色の透明度を定義する値（0～255）例 `255`: 色は不透明です。 `0`: 色は完全に透明です。利用可能画像タイプが選択されます。
画像ID	`<image pool name> . <ID>` 例： `Images.Logo` 利用可能画像タイプが選択されます。
透明色	: 背景は透明色で表示されます。リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。利用可能画像タイプが選択されます。
スケーリングタイプ	等方性: 要素フレーム内に画像全体が大きくまたは小さく表示されます。その結果、高さと幅の比率が保持されます。異方性: 画像は要素フレームのサイズに合わせて自動的にサイズ変更され、要素フレーム全体を埋めます。その結果、比率は保持されません。修理済み: 要素フレームのサイズが変更されても、画像は元のサイズを維持します。クリッピングオプションが選択されていることにも注意してください。利用可能画像タイプが選択されます。

表 134. メインカーソル

タイプ	未使用垂直大きな十字架小さな十字架交差点
線のスタイル	例：ドット以下の場合にはご利用いただけませんタイプが選択されます。
色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。
X位置変数	カーソルの X 位置が書き込まれる変数 (整数データ型)。例： `PLC_PRG.iPosition` 以下の場合にはご利用いただけませんタイプが選択されます。

表 135. 拡張変数

要素変数

データ型を持つ変数 VisuStructXYChart から VisuElemXYChart 図書館

ここで設定された変数は静的設定で初期化されます。実行時には、直交座標系 XY チャート要素はこの構造の変更に応答します。その結果、要素は実行時にプログラムで制御できます。

注: この構造をプログラムで制御する場合、割り当ての順序に問題が生じる可能性があります。したがって、アプリケーションは、視覚化要素が初期化され、構造変数が初期化された直後にのみ初期値を割り当てる必要があります。 iInitialized 1に切り替わりました。

の iInitialized 変数は、現在のみ利用可能です CODESYS バージョン SP16。古いバージョンでは、順序の問題がうまく解決できません。

例を参照: 要素変数

自動更新を有効にする

変数（データ型 BOOL) を使用して、グラフの自動更新をプログラムで制御します。

TRUE: 変更後、チャートの表示は自動的に更新されます。

例： PLC_PRG.bIsUpdating

注: タイプが自動選択されているアップデート。

例 51. 例: 要素変数

宣言

PROGRAM PLC_PRG
VAR
   XYChart : VisuStructXYChart;
END_VAR

割り当て

IF XYChart.iInitialized > 0 THEN
   XYChart.eBackgroundType := VisuEnumXYChartBGType.PLAIN;     // plain color
   XYChart.diColorBg := 16#00000080;                           // blue
   XYChart.eGrid := VisuEnumXYChartGridType.NO;                // no grid
END_IF

表 136. セカンダリカーソル

追加カーソルのカーソルタイプはメインカーソルに対応します。
線のスタイル	例：ドット
色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。

表 137. グリッド

タイプ	グリッドの表示未使用大きなグリッド狭いグリッド大きなマークの点線グリッド小さなマークの点線グリッド
線のスタイル	例：ドットタイプがまたはが選択されます。
色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。
曲線の背後にあるグリッド	: グリッドは曲線の後ろのレイヤーに表示されます。たとえば、曲線が面グラフとして表示されている場合、色で塗りつぶされた領域にはグリッドは表示されません。ただし、塗りつぶしの色に透明度の値がある場合（例： `128`) であり、半透明の場合でも、グリッドは表示されます。 : グリッドは曲線上にあります。たとえば、曲線が面グラフとして表示される場合、色で塗りつぶされた領域は常にグリッドとともに表示されます。

表 138. ゼロライン

位置	ゼロラインの表示未使用 Y軸の表示 X軸の表示両方を表示
線のスタイル	例：ドット
線幅	例： `2`
色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。

グループ: 曲線設定

設定はツリービューで選択した曲線に関連しています。

Y軸に取り付け

選択した曲線に割り当てられた Y 軸。Y 軸には複数の曲線を割り当てることができます。リストボックスには、要素で作成されたすべての軸が含まれます。

例：はい

表 139. データ X / データ Y

変数

基本データ型、カスタムデータ型、または関数ブロックの配列変数。変数には、X または Y データの曲線データが含まれます。

基本データ型の 1 次元配列変数:
ARRAY [ <インデックスの下限> .. <インデックスの上限> ] OF <基本データ型>
基本データ型の 2 次元配列変数:
ARRAY [ <下限インデックス 1> .. <上限インデックス 1> 、 <下限インデックス 2> .. <上限インデックス 2> ] OF <基本データ型>
<下限インデックス 1> .. <上限インデックス 1> : 1 次元目
<下限インデックス 2> .. <上限インデックス 1> : 2 次元目
ユーザー定義データ型の 1 次元配列変数
ARRAY [ <下限インデックス> .. <上限インデックス> ] OF <DUT 名>
列挙型の1次元配列変数
ARRAY [ <インデックスの下限> .. <インデックスの上限> ] OF <列挙名>
関数ブロックの1次元配列変数
ARRAY [ <インデックスの下限> .. <インデックスの上限> ] OF <ファンクションブロックの名前>

基本データ型:

注意: 値の範囲がわかっている場合にのみ、軸に固定スケーリングを設定してください。それ以外の場合は、自動スケーリングを設定することをお勧めします。

参照: 例

使用する要素

使用される複合データ型の配列要素。

. データ型が変数複合データ型の配列（複数の要素で構成）です。

多次元配列
カスタムデータタイプ
ファンクションブロック

: すべての配列要素を含むリストボックスを開きます。

例 52. 例: 基本型の2次元配列 REAL

宣言

PROGRAM Curve
VAR
   aDataXY : ARRAY [1..2, 1..50] OF REAL;
END_VAR

データX

変数: Curve.aDataXY

使用する要素: [1]

データY

変数: Curve.aDataXY

使用する要素: [2]

その結果、この曲線には 100 個の配列値が表示されます。

例 53. 例：ユーザー定義のデータ型の1次元配列

宣言

TYPE STRUCT_A :
STRUCT
        iX: INT;
        rY: REAL;
        bResult: BOOL;
END_STRUCT
END_TYPE

PLC_PRG
VAR
        aDataXY : ARRAY [1..50] OF STRUCT_A;
END_VAR

データX

変数: aDataXY.iX

使用する要素: iX

データY

変数: aDataXY.rY

使用する要素: rY

例 54. 例: 構造体の1次元配列 POINT

PLC_PRG
VAR
        aPoints_1: ARRAY[0..99] OF POINT; // POINT ist eine Struktur mit iX und iY
END_VAR

データX

変数: PLC_PRG.aPoints_1

使用する要素: iX

データY

変数: PLC_PRG.aPoints_1

使用する要素: iY

その結果、200 個の X 値と Y 値が使用可能になり、チャートでは 100 個の曲線ポイントで表示されます。

例 55. 例: 関数ブロックの1次元配列

宣言

FUNCTION_BLOCK FB_A
VAR_INPUT
        iIn: INT;
END_VAR
VAR_OUTPUT
        iOut: INT;
END_VAR
PROGRAM PLC_PRG
VAR
        aDataXY : ARRAY [1..50] OF FB_A;
END_VAR

データX

変数: PLC_PRG.aDataXY

使用する要素: iIn

データY

変数: PLC_PRG.aDataXY

使用する要素: iOut

表 140. プロパティ: 配列インデックス

配列インデックスは、曲線の表示を部分的な領域に制限します。XYチャートにすべてのポイントが表示されるのではなく、最小に最大が表示されます。最小そして最大インデックス制限に違反してはならないインデックスです。コンパイラもこれを監視します。配列宣言のインデックス制限を選択します。

例： <variable name> : ARRAY [ <lower index bound> .. <upper index bound> ] OF <data type>;

さらに、プログラム的に表示を制限することもできます。 VisuStructXYChartCurve構造要素 diIndexMin そして diIndexMax この目的のために用意されています。これらは、最小そして最大実行時に、値はここでこれらの構造要素にコピーされます。

さらに、表示領域を片側のみに制限し、1つだけを指定することもできます。最小または1つだけ最大ここでも構造内でも制限を指定しない場合は、曲線が完全に表示されます。

変数（数値データ型）を配列インデックスとして指定すると、表示を動的にすることができます。

最小

リテラル、変数（数値データ型）、または定数変数（数値データ型）としての最小インデックス

曲線を表示するインデックスを指定します。インデックスはインデックス制限以上です。 <lower index bound>。

例： 10、 PLC_PRG.uiLowerIndex、 GVL.c_diMIN

最大

リテラル、変数（数値データ型）、または定数変数（数値データ型）としての最大インデックス

例： 20、 PLC_PRG.uiUpperIndex、 GVL.c_diMAX

曲線が表示されるインデックスが含まれます。インデックスはインデックス制限以下です。 <upper index bound>。

表 141. チャート

タイプ

折れ線グラフ: データは連続線として表示されます。また、データを点として表示することもできます。この目的のために入力フィールドが用意されています。
注記：
折れ線グラフでは、曲線ごとに 32,767 個を超えるポイントを描画することはできません。この数を超えると警告が発行され、曲線の最初の 32,767 個のポイントのみが描画されます。
棒グラフ: データは縦棒として表示されます。色と透明度を入力するフィールドが用意されています。
面グラフ: データは、色で塗りつぶされた領域を持つ連続線として表示されます。また、データをドットとして表示することもできます。この目的のために入力フィールドが用意されています。

以下の設定は、折れ線グラフタイプが選択されます。
線の色	: 軸の色内の線リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。
線種	ライン低く踏み出す高いステップなしドットのみ
線幅	例： `2`
線のスタイル	例：ドット
ドットスタイル	なしドットクロス小さな円大きな円

以下の設定は、棒グラフタイプが選択されます。
バー形状	固定幅: バーは固定幅で表示されます。可変幅: バーの幅は値間の距離によって異なります。
メインカラー	リストボックスからのスタイルの色。例: 要素-XYチャート-軸-背景カラーダイアログで選択された固定値。例: `0; 0; 0`
代替色
フレームカラー

以下の設定は、面グラフタイプが選択されます。
線の色	例：青 : 色の設定が無効になっているため、軸の色が適用されます。
充填タイプ	曲線間の領域を塗りつぶす色。充填なし無地: 単色エリア勾配: 色のグラデーションで塗りつぶされた領域
塗りつぶし色	例：グレー : 開く色ダイアログ要件：無地選択されている充填タイプ。 : 色の設定が無効になっているため、線の色が適用されます。
透明性	純色の透明度値 (0～255)。例： `128` 要件：無地選択されている充填タイプ。
勾配	色のグラデーションで塗りつぶされた領域。 : 開くグラデーションエディターダイアログ要件：勾配選択されている充填タイプ。
線幅	例： `2`
線のスタイル	例：ドット
ドットスタイル	データはポイントスタイルのドットとしてグラフ内に表示されます。なしドットクロス小さな円大きな円

カーソルでキャプチャされた曲線の値

カーソルの Y 位置が曲線に書き込まれる変数 (整数データ型)。

例： Sine.Cursor_Pos_Y

表 142. 拡張変数

曲線変数

変数（データ型 VisuStructXYChartCurve から VisuElemXYChart 図書館）

の iInitialized 変数は、現在のみ利用可能です CODESYS バージョン SP16。古いバージョンでは、順序の問題がうまく解決できません。

例を参照: 曲線変数

例 56. 例: 曲線変数

宣言

PROGRAM PLC_PRG
VAR
   XYCurve : VisuStructXYChartCurve;
END_VAR

割り当て

IF XYCurve.iInitialized > 0 THEN
   XYCurve.diColor    := 16#00FF0000;           // red
   XYCurve.iLineWidth := iLineWidth;            // line width
END_IF

表 143. 基準曲線

曲線	参照される曲線。曲線間の領域は色で塗りつぶされます。
色	曲線間の領域を塗りつぶす色。リストボックスからのスタイルの色。例: `Light gray` カラーダイアログで選択された固定値。例: `0; 0; 0`

グループ: 軸設定

設定はツリービューで選択した軸に関連します。

表 144. 表示設定

位置

X軸: X 軸が選択されています。XY チャートには X 軸が 1 つだけあります。
左側: Y 軸が選択され、グラフの左側に表示されます。
右側: Y 軸が選択され、グラフの右側に表示されます。

最小

最大

曲線が表示される軸値の最小値と最大値

. 指定された制限

変数（数値データ型）
例： PLC_PRG.iMinX、 PLC_PRG.iMaxX
定数変数（数値データ型）
GVL での宣言: VAR_GLOBAL CONSTANT c_iMINX : INT; c_iMAXX : INT; END_VAR
例： GVL.c_iMINX、 GVL.c_iMAXX
固定値（数値リテラル）
例： -1000、 1000

注記

次の場合にのみ表示されます自動スケール無効になっています。

自動スケール

standard icon : 軸は自動的に拡大縮小されます。最小そして最大設定は表示されません。

軸の色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択される固定値。

表 145. 背景

タイプ	背景なし無地: 入力フィールドで設定された背景色色そして透明性勾配: グラデーションのある背景。グラデーションエディターを開きます。画像: 画像付き背景。入力フィールドで設定します画像ID
色	リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択された固定値利用可能無地タイプが選択されました
透明性	選択した色の透明度を定義する値（0～255）例 `255`: 色は不透明です。 `0`: 色は完全に透明です。利用可能無地タイプが選択されました
画像ID	`<image pool name> . <ID>` 例： `Images.Logo` 利用可能画像タイプが選択されました
透明色	: 背景は透明色で表示されますリストボックスからのスタイルの色例：ライトグリーンカラーダイアログで選択された固定値利用可能画像タイプが選択されました
スケーリングタイプ	等方性: 画像全体が要素フレーム内に表示されますが、拡大または縮小されます。その結果、高さと幅の比率が維持されます。異方性: 画像は要素フレームのサイズに合わせて自動的にサイズ変更され、要素フレーム全体を埋め尽くします。その結果、比率は保持されません。修理済み: 要素フレームのサイズが変更されても、画像は元のサイズを維持します。クリッピングオプションが選択されていることにも注意してください。利用可能画像タイプが選択されました

表 146. 拡張変数

軸変数

変数（データ型 VisuStructXYChartAxis から VisuElemXYChart 図書館）

の iInitialized 変数は、現在のみ利用可能です CODESYS バージョン SP16。古いバージョンでは、順序の問題がうまく解決できません。

例を参照: 軸変数

例 57. 例: 軸変数

宣言

PROGRAM PLC_PRG
VAR
   XYAxis : VisuStructXYChartAxis;
END_VAR

割り当て

IF XYCurve.iInitialized > 0 THEN
   XYAxis.rMin := 12.0;           // minimum axis value
   XYAxis.rMax := 36.0;           // maximum axis value
END_IF

表 147. 拡張表示パラメータ

ルーラーを表示軸は原点で重なり合っている数字を表示最大数の表示最小数の表示中央に数字を表示数字を上書きする	: 軸はそれに応じて表示されます。
数字の回転角度	軸ラベルの数字が何度回転するかを指定する角度（度）例： `45` 回転は時計回りで、0 度の位置が通常の表示位置になります。度数は負の値になることもあります。注記回転が設定されている場合、その設定は考慮されません数字を上書きするその結果、表示される数字が重なる可能性があります。
回転はマークに合わせて調整されます	: 数字が表示される仮想ボックスの側面が参照マークに揃えられます。 : 数字が表示される仮想ボックスの中心が基準マークに揃えられます。
数字を置き換えるテキスト	その際、テキストリストのインデックスは、置換される数値と等しくなければなりません。インデックスは負の値や小数点付き（小数点を含む）になる場合があります。テキストの回転機能もご利用いただけます。ヒント短いテキストリストを準備することを強くお勧めします。要素は、軸ごとに最大 100 個のテキストを処理できます。
フォーマット文字列	軸の出力テキストをフォーマットします。書式文字列の直接指定例： `dd:MM:yyyy HH:mm:ss:ms` ローカライズされた書式文字列を参照するテキストリストエントリ例： `TextList.ID` テキストリストでは、言語ごとに異なる書式文字列を指定できます。これにより、言語に応じてテキストが表示されます。この軸のデータが DATE/TIME/TOD/DT 型の場合、日付/時刻の書式文字列が使用されます。日付と時刻は 2 行で表示されます。日付と時刻の形式の間には改行が入ります。

表 148. ラベル

テキストID	`<text list name> . <ID>` 例： `Texts.mm` （テキストリスト `Texts` プロジェクトではすでに利用可能です。
色	: 軸の色のラベルリストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択された固定値利用可能テストID 初期化される
回転	0°: 軸に平行 90°: 軸を中心に回転 270°: 軸を中心に回転利用可能テストID 初期化されます。
フォント	リストボックスからのフォントスタイル。例: 注釈デフォルトで選択される固定値フォントダイアログ利用可能テストID 初期化される

表 149. レベルライン

軸に沿った線

線は、Y 軸の場合は水平、X 軸の場合は垂直です。最大 10 本の線が可能です。

行番号

行をアドレス指定すると、その行に対応するパラメータ設定が下のウィンドウ領域に表示されます。行 <n> のパラメータ。

例： 3

行 <n> のパラメータ
価値	例： `3`
	最大10行まで可能です。
線のスタイル	例：ドット
線幅	例： `2`
色	: 軸の色におけるレベルライン値の線リストボックスからのスタイルの色。例: ライトグリーンカラーダイアログで選択された固定値
ラベルテキストID	`<text list name> . <ID>` 例： `Texts.mm` （テキストリスト `Texts` プロジェクトではすでに利用可能です。
ラベルの位置	列をなしてその上下に左右
ラベルの回転	0°: 軸に平行 90°: 軸を中心に回転 270°: 軸を中心に回転利用可能ラベルのテストID 初期化される
フォント	リストボックスからのフォントスタイル。例: 注釈デフォルトで選択される固定値フォントダイアログ利用可能ラベルのテストID 初期化される

このセクションの内容:

参照:

ダイアログ: XY チャートの設定

グループ: 要素設定

グループ: 曲線設定

グループ: 軸設定

注記

注記

ヒント

検索結果