視覚化要素: Path3D

注記

この要素は、CODESYS HMIディスプレイバリアント。

シンボル：

カテゴリ：特別なコントロール

そのパス3D可視化要素は、2つの独立したレコードの曲線を3Dパスとしてグラフィカルに表示します。CNCで工作機械やロボットの軌跡を表示するために特別に設計されています。プログラムされたパス（パス）と実際に移動したパス（トラック）が表示されます。

視覚化要素は、CODESYS SoftMotion CNCでは、他のレコードの表示にも使用できます。この場合、アプリケーションはパスデータを提供する必要があります。

この要素をCODESYS SoftMotion CNC、次にライブラリから機能ブロックSM3_CNC_Visuパスとトラックからデータを生成するのに役立ちます。これらの機能ブロックはサンプルプロジェクトで使用されます。CNC_File_3DPathのインストールディレクトリに保存されているCODESYS。

SMC_PathCopier
SMC_PathCopierCompleteQueue
SMC_PathCopierFile
SMC_PositionTracker

機能ブロックの説明は、ライブラリのライブラリマネージャーで確認できます。SM3_CNC_Visu。

注記

0_Sample_Project サンプルプロジェクト：「3D パスジェネレーター」

0_Sample_Project プロジェクトCNC_File_3DPath（に含まれるCODESYSインストールディレクトリ）

要素のプロパティ

すべての要素プロパティが利用可能ですか?

すべてのプロパティは、高度なオプションまたはすべてのカテゴリーフィルターインプロパティ。

要素名	例： `GenElemInst_1` ヒント要素リスト内で要素がより早く見つかるよう、要素に個別の名前を割り当てます。
要素タイプ	Path3D

位置

位置は、視覚化ウィンドウにおける要素の位置とサイズを定義します。これは直交座標系に基づいています。原点はウィンドウの左上隅にあります。水平X軸の正方向は右方向、垂直Y軸の正方向は下方向です。

X	要素の左上隅のX座標（ピクセル単位）例：`10`
Y	要素の左上隅のY座標（ピクセル単位）例：`10`
幅	ピクセル単位で指定例：`150`
身長	ピクセル単位で指定例：`30`

ヒント

ボックスをドラッグして値を変更できますシンボルをエディター内の他の位置に移動します。

パスの説明

パスデータ（VisuStruct3DTrack）	タイプの変数 `VisuStruct3DTrack` これはIECコードで宣言されています例： `PLC_PRG.pc.vs3dt`。構造の説明は、ライブラリマネージャーの `VisuElem3DPath.library` 図書館。データ構造は、特定のポイント数でパスまたはトラックを記述します。ポイントは、アプリケーションによって決定およびバッファリングされます。トラックは通常、最後のn位置を表示するため、一度に表示されるのはそれらの特定の部分だけです。 `VisuStruct3DTrack.pProjection` は、視覚化要素によって設定され、パス/トラックの投影に関する情報を含む変数です。アプリケーションで（のみ）読み取ることができます。また、 `Projection.Apply` また `.ApplyV` メソッドを使用して、変換された位置が、によって定義された視覚化表示領域の内側または外側にあるかどうかを確認できます。 `Projection.ElementRect`。
パスの色	描かれたパスの色
パスライン幅	パスライン幅（ピクセル単位）例： `2`
エッジポイントマーキング	. パス内の2つの連続するオブジェクト間のポイントの表示エンドポイントはマークされていません終点は円でマークされています終点は十字でマークされていますエンドポイントはプラス記号でマークされています

トラックの説明

トラックデータは、パスデータと同じように構造化されています：VisuStruct3DTrack

トラックデータ（VisuStruct3DTrack）

タイプの変数 VisuStruct3DTrack これはIECコードで宣言されています

例： PLC_PRG.pc.vs3dt

構造の説明は、ライブラリマネージャーの VisuElem3DPath.library 図書館。

トラックの色

描かれたトラックの色

トラックラインの太さ

トラックラインの太さ（ピクセル単位）

例：2

カメラ制御

3Dモードのカメラ位置は、外部データ構造を参照して制御されます。

この構造により、次の操作が可能になります。

左/右/上/下に移動
X / Y / Z軸を中心に回転します
ビューをX / Y、Y / Z、またはZ / X平面にリセットして、ウェブとパスが完全に表示されるようにします。

制御データ構造（VisuStruct3DControl）

タイプの変数 VisuStruct3DControl これはIECコードで宣言されています

例： PLC_PRG.pc.vs3dc

値は、アプリケーション自体またはコントロールパネル視覚化要素。 The VisuElem3DPath ライブラリには、このデータの可能なユーザーインターフェイスを提供するすぐに使用できる視覚化フレームが含まれています。

構造の説明は、ライブラリマネージャーの VisuElem3DPath 図書館。

入力構成

プロパティには、マウスまたはキーボードを使用するときのユーザー入力の構成が含まれています。ユーザー入力は、イベントと、イベントが発生したときに実行される1つ以上のアクションを定義します。

ヒント The 構成、設定ボタンを開くと入力構成ダイアログ。そこで、ユーザー入力を作成または編集できます。構成されたユーザー入力は、イベントの下に一覧表示されます。それぞれに、トリガーされるアクションと短い形式の設定が含まれています。例： STコードを実行する： `PLC_PRG.i_x := 0;`
OnDialogClosed	入力イベント：ユーザーはダイアログを閉じます。
OnMouseClick	入力イベント：ユーザーが要素領域でマウスボタンを完全にクリックします。マウスボタンをクリックして離します。
OnMouseDown	入力イベント：ユーザーがマウスボタンをクリックします。
OnMouseEnter	入力イベント：ユーザーはマウスポインタを要素にドラッグします。
OnMouseLeave	入力イベント：ユーザーがマウスポインタを要素からドラッグします。
OnMouseMove	入力イベント：ユーザーはマウスポインタを要素領域上に移動します。
OnMouseUp	. 入力イベント：ユーザーは、要素領域内でマウスボタンを離します。ユーザーが以前に要素領域の内側または外側でマウスボタンを押したことがあるかどうかは関係ありません。ユーザーは、要素領域内でマウスボタンを押し、要素領域を離れてから、マウスボタンを離します。注記これ CODESYS-特定のトリガー動作により、主要な要素のアクションが確実に完了します。キー要素は、のアクションを開始します OnMouseDown のアクションを終了します OnMouseUp。例：ビジュアライゼーションユーザーは、キー要素の要素領域内でマウスボタンを押してから、要素領域の外側にカーソル位置を移動します。とにかくアクションは終了します OnMouseUp トリガーされます。
OnValueChanged	値の変化によりフォローアップアクションをトリガーするイベントどのフォローアップアクションがトリガーされるかは、入力構成ダイアログ。定義されたフォローアップアクションと対応する構成は、要素プロパティの下に表示されます。 The OnValueChanged イベントはによって無効にすることができます VISU_NO_VALUECHANGED コンパイラは、アプリケーションのプロパティダイアログで定義します。

タップ	マウスクリックイベントが発生すると、で定義された変数変数アプリケーションに記載されています。コーディングは FALSEをタップしますとキャプチャされた場合はEnterをタップしますオプション。
変数	要件： FALSEをタップしますオプションはアクティブ化されていません。変数（`BOOL`）マウスクリックイベントの場合 `TRUE`：マウスクリックイベントが存在します。ユーザーが要素の上でマウスボタンを押す限り、それは続きます。ボタンを離すと終了します。 `FALSE`：マウスクリックイベントは存在しません。例： `PLC_PRG.bIsTapped`
FALSEをタップします	：マウスクリックイベントは、の補完的な値につながります変数。 `TRUE`：マウスクリックイベントは存在しません。 `FALSE`：マウスクリックイベントが存在する間。
キャプチャされた場合はEnterをタップします	：ユーザー入力時に、マウスボタンが押されている間にマウスポインタが要素領域内でドラッグされているかどうかも考慮されます。 `TRUE`：マウスクリックイベントが存在し、マウスポインタが要素領域上に移動している間。 `FALSE`：マウスクリックイベントは存在しません。または、マウスボタンが押されている間に、ユーザーがマウスポインタを要素領域の外に移動します。値は `TRUE` ユーザーがポインターを要素領域に戻すとすぐに再び。次に、マウスがキャプチャされます。

切り替える

マウスクリックイベントが開始されると、変数が設定されます。マウスクリックイベントが完了すると、変数がリセットされます。

変数

変数（BOOL）マウスクリックイベントの終了時に切り替える場合

これは、マウスポインタが要素領域上にあるときにユーザーがマウスボタンを離したときです。マウスポインタが要素領域の外にあるときにユーザーがマウスボタンを離した場合、マウスクリックイベントは終了せず、値は切り替えられません。

ヒント

ユーザーは、マウスポインターを要素領域の外にドラッグすることにより、開始されたトグル入力をキャンセルできます。

キャプチャされた場合は上に切り替えます

standard icon ：マウスボタンを離したときにマウスポインタがどこにあるかに関係なく、値が切り替わります。次に、マウスがキャプチャされます。

ホットキー	特定の入力アクションをトリガーするための要素のショートカットホットキーイベントが発生すると、イベントプロパティがトリガーされます。このように、この入力アクションにつながるのは入力アクション自体ではなく、マウス入力アクションです。
鍵	入力アクションのために押されたキー。例： T キーを選択すると、次のプロパティが表示されます。
イベント	なしマウスダウン：キーを押すと、で設定されている入力アクションがトリガーされます。 OnMouseDown 財産。マウスアップ：キーを離すと、で設定されている入力アクションがトリガーされます OnMouseUp 財産。マウスダウン/アップ：キーを押して放すと、で設定されている入力アクションがトリガーされます。 OnMouseDown プロパティと OnMouseUp 財産。
切り替える	：「Shift」キーとの組み合わせ例：シフト+T。
コントロール	：「Ctrl」キーとの組み合わせ例： Ctrl+T。
Alt	：「Alt」キーとの組み合わせ例： Alt+T。

ヒント

ビジュアライゼーションで構成されているすべてのキーボードショートカットとそのアクションは、キーボード構成タブ。

追加の側面

座標系	：座標系を表示します。
グリッド	：グリッド線が表示されます
グリッドカラー	グリッド線の色

ハイライト

パスの個々の部分を視覚的に強調表示できます。通常、これは、トラックのすでに完成した部分を別の色でマークするために使用されます。パス上の各ポイントには一意のIDが与えられ、CNCエディターの場合は、ポイントが配置されているオブジェクトIDにリンクされます。このID（「ハイライトID」）は、パスの要素/部分を動的にハイライトできるように、アプリケーションを介して指定できます。

ハイライトタイプ

. 次の強調表示タイプのいずれかを選択します。

変数の値と一致するIDを持つ要素のみが強調表示されます。
ID（オブジェクトIDにリンクされたCNCエディターの場合）がの値以下であるすべての要素変数強調表示されます。

変数

要素のIDを指定するプロジェクト変数

例： PLC_PRG.iVarElementID

この「ハイライトID」は、ハイライトタイプ。変数はアプリケーションで使用できます。

ハイライトカラー

例：赤

外観

境界線幅	要素の周囲のフレームの厚さ（ピクセル単位）例： `1`
ボーダーラインスタイル	. フレームラインに次のスタイルタイプのいずれかを選択します。個体ダッシュドットダッシュドットダッシュドットドット見えない
背景透明	：要素の背景が透明に表示されます。：要素の背景は、定義された背景色で表示されます。
背景色	スタイルの色または色

中心

	プロパティには回転点の座標の固定値が含まれています。回転点はエディタ上で次のように表示されます。シンボルであり、回転と拡大縮小の中心として使用されます。ヒントドラッグして値を変更することもできますシンボルをエディター内の別の位置に移動します。
X	回転点のX座標
Y	回転点のY座標

絶対的な動き

プロパティには、要素の位置を動的に制御するためのIEC変数が含まれています。基準点は要素の左上隅です。実行時に、要素全体が移動されます。

動き
X	X位置の変数（数値データ型）（ピクセル単位）例： `PLC_PRG.iPos_X`。コンテナ変数: `Container.Width` 詳細については、次を参照してください。位置とサイズを最適に調整する実行時にこの値を増やすと、要素が右に移動します。
Y	Y位置の変数（数値データ型）（ピクセル単位）例： `PLC_PRG.iPos_Y`。コンテナ変数: `Container.Height` 詳細については、次を参照してください。位置とサイズを最適に調整する実行時にこの値を増やすと、要素が下に移動します。
回転	回転角（度単位）の変数（数値データ型）例： `PLC_PRG.iAngle1`。要素の中点はで回転します中心点。この回転点は、シンボル。実行時、要素の配置は、ビジュアライゼーションの座標系に関して同じままです。値を大きくすると、要素が右に回転します。
スケーリング	中心ストレッチをトリガーする変数（整数データ型）例： `PLC_PRG.iScaling` 基準点は中心財産。値 `1` 要素を係数で縮小します `0.001`。値 `1000` 要素を元のサイズに戻します。
内部回転	回転角（度単位）の変数（数値データ型）例： `PLC_PRG.iAngle2`。実行時に、要素はで指定された回転点を中心に回転します中心変数の値に応じて。さらに、要素の配置は、視覚化の座標系に従って回転します。コードの値を大きくすると、時計回りに回転します。回転点は次のように表示されますシンボル。注記静的回転角がで指定されている場合位置→角度プロパティの場合、視覚化の実行時に静的回転角が可変回転角（オフセット）に追加されます。

ヒント

変数を組み合わせて単位変換。

ヒント

The バツ、 Y、回転、と内部回転プロパティは、「クライアントアニメーション」機能によってサポートされています。

状態変数

変数は要素の動作を動的に制御します。

見えない	変数（`BOOL`）要素の表示/非表示を切り替える `TRUE` : 要素は実行時には表示されません。

ヒント

その見えないこのプロパティは、「クライアントアニメーション」機能によってサポートされています。

アニメーション

ヒント

これらのプロパティは、クライアントアニメーションとネイティブ要素のオーバーレイをサポートオプションのVisualization Manager。

アニメーションの長さ

要素がアニメーションを実行する期間（ミリ秒単位）の変数

変数（整数値）
例：Menu.tContentとVAR tContent : INT := 500; END_VAR
整数リテラル
例：500

. アニメーション可能なプロパティ

絶対的な動き、動き、 X、はい
絶対的な動き、回転
絶対的な動き、内部回転
絶対的な動き、外側回転

アニメーション化された動きは、アニメーション可能なプロパティの値が少なくとも1つ変更されたときに実行されます。その後、指定されたアニメーション時間内では、動きはぎこちなく滑らかに実行されます。視覚化要素は動的に回転しながら指定された位置に移動します。遷移は滑らかです。

フォアグラウンドに移動

変数（BOOL）要素をフォアグラウンドに設定する

TRUE : 実行時に、視覚化要素がフォアグラウンドに表示されます。

FALSE : 実行時に、視覚化要素は視覚化エディターで挿入されたレイヤーに表示されます。

例：bIsInForegroundとVAR bIsInForeground : BOOL := FALSE; END_VAR

権限

注記

視覚化のためにユーザー管理が設定されている場合にのみ使用できます。

アクセス権ボタン

開くアクセス権ダイアログが表示されます。ここで、要素のアクセス権限を編集できます。

. ステータスメッセージ:

設定されていません。完全な権限があります。 : すべてのユーザーグループのアクセス権: 操作可能
権利が設定されています: 制限付き権利 : 少なくとも 1 つのグループへのアクセスが制限されています。

このセクションの内容:

X	要素の左上隅のX座標（ピクセル単位）例：`10`
Y	要素の左上隅のY座標（ピクセル単位）例：`10`
幅	ピクセル単位で指定例：`150`
身長	ピクセル単位で指定例：`30`

動き
X	X位置の変数（数値データ型）（ピクセル単位）例： `PLC_PRG.iPos_X`。コンテナ変数: `Container.Width` 詳細については、次を参照してください。位置とサイズを最適に調整する実行時にこの値を増やすと、要素が右に移動します。
Y	Y位置の変数（数値データ型）（ピクセル単位）例： `PLC_PRG.iPos_Y`。コンテナ変数: `Container.Height` 詳細については、次を参照してください。位置とサイズを最適に調整する実行時にこの値を増やすと、要素が下に移動します。
回転	回転角（度単位）の変数（数値データ型）例： `PLC_PRG.iAngle1`。要素の中点はで回転します中心点。この回転点は、シンボル。実行時、要素の配置は、ビジュアライゼーションの座標系に関して同じままです。値を大きくすると、要素が右に回転します。
スケーリング	中心ストレッチをトリガーする変数（整数データ型）例： `PLC_PRG.iScaling` 基準点は中心財産。値 `1` 要素を係数で縮小します `0.001`。値 `1000` 要素を元のサイズに戻します。
内部回転	回転角（度単位）の変数（数値データ型）例： `PLC_PRG.iAngle2`。実行時に、要素はで指定された回転点を中心に回転します中心変数の値に応じて。さらに、要素の配置は、視覚化の座標系に従って回転します。コードの値を大きくすると、時計回りに回転します。回転点は次のように表示されますシンボル。注記静的回転角がで指定されている場合位置→角度プロパティの場合、視覚化の実行時に静的回転角が可変回転角（オフセット）に追加されます。