CODESYS Depictor 編集者（ライセンス）

3Dビューで作業している場合、次のコマンドのボタンがのツールバーで使用できます。 CODESYS メインウィンドウ：

	ポーズを追加：ツリーで選択したエントリの下にポーズが追加されます。 定義：A ポーズ は、親ノードに対する子ノードの変換を示しています。たとえば、すべての子ノードは、親ノードに対して7単位移動する必要があります。
	要素を追加：ツリーで選択したエントリの下に要素が追加されます。 定義： エレメント の中に CODESYS Depictor の実際の3Dジオメトリが含まれています Depictor 物体。 3Dジオメトリはファイルから作成することも、既存のジオメトリを参照することもできます Depictor 物体。
	レンダリングビューからカメラの位置を取得し、それをDepictorのカメラの位置に追加します。コマンドに対応します カメラの位置を取得する。
	Depictorで選択したカメラ位置を3Dビューのカメラ位置に設定します：コマンドに対応 カメラの位置を設定する。 3Dビューでの表現はそれに応じて変化します。
	スクリーンショットを作成する： デフォルト 名前を付けて保存 ダイアログが開きます。現在の3Dビューをに保存できます JPG ファイル。
	ポーズのつながりを表示する：すべての要素は、3Dビューでワイヤモデルとして描画されます。ポーズ間の接続は緑色の円柱で表示されます。シリンダーの厚さは、 Depictor オプション。

コマンド ポーズを追加 と 要素を追加 内のオブジェクトのコンテキストメニューで利用可能です 木 見る。

この図は、 プロパティ （1）サンプル値のあるポーズの。

例 1. 構造と組み合わせた変換の例 DepictorFrame

TYPE DepictorFrame :
STRUCT
        X : LREAL;
        Y : LREAL;
        Z : LREAL;
        Yaw : LREAL;
        Pitch : LREAL;
        Roll : LREAL;
END_STRUCT
END_TYPE

PROGRAM PLC_PRG
VAR
        rCount : LREAL;
        depFram : DepictorBase.DepictorFrame;
END_VAR

rCount := rCount + 0.01;
depFram.X := COS(rCount)*4;
depFram.Y := SIN(rCount)*4;
depFram.Z := COS(rCount) * SIN(rCount) * 4;
depFram.Yaw := rCount*4;
depFram.Pitch := rCount*8;
depFram.Roll := rCount*12;

エディターのエントリー：構成テーブル 変換 ポーズの、タイプ 組み合わせる、 桁 変数/値： PLC_PRG.depFram

構造の上の複合変換の構成（左）と、平行移動と回転の個々のパラメーターの上の同等の構成（右）については、次の画像を参照してください。

例 2. タイプ「接続」の変換を表示する例

The CODESYS Depictor 伸縮シリンダーの動きを表示する必要があります。空間内の動きと円柱の長さの変化は、空間内の2点の現在の位置に自動的に適応する必要があります。この目的のために、円柱のポーズに変換タイプ「接続」を使用し、空間ポイントと方向ベクトルの両方を指定します。次に、シリンダーに常に必要な平行移動が次のように自動的に計算されます。 CODESYS Depictor。

あなたは「Cylinder"のポーズの下の要素 木 の Depictor オブジェクト（1）。

その場合、要素は Depictor ライブラリからの参照。

を構成します シリンダー の要素 プロパティ 次のように（2）を表示します。

の中に 基本 タブ（2）、変換（3）を設定します。

の中に 外観 タブ（4）、色（5）を設定します。

次に、ポーズを設定します シリンダー の中に プロパティ/変換 次のように（3）を表示します。

の動きを制御する Depictor アプリケーションプログラムによるオブジェクト

アプリケーション、PLC_PRG

PROGRAM PLC_PRG
VAR
        lrRun : LREAL;

        lrX1 : LREAL := 0;
        lrY1 : LREAL;
        lrZ1 : LREAL;

        lrX2 : LREAL := 2;
        lrY2 : LREAL;
        lrZ2 : LREAL;

END_VAR

lrRun := lrRun + 0.01;

lrX1 := COS(lrRun)*2;
lrX2 := SIN(lrRun)*2 + 2;

lrY1 := SIN(lrRun*2)*3;
lrY2 := COS(lrRun*2)*3;

lrZ1 := COS(lrRun/2);
lrZ2 := SIN(lrRun/2);

The プロパティ エディター（1） Depictor 要素はタブで構成されます 基本 と 外観。そうでない要素の場合 Depictor 参考文献、 素材 タブ。

基本 タブ（2）：

ジオメトリソースを定義し、要素に追加のX / Y / Z変換を設定します。要素が Depictor インターフェイスを定義した参照、次にの割り当てを実行できます インターフェイス変数 （9）テーブルで。詳細については、の説明を参照してください。 CODESYS Depictor 視聴者。

外観 タブ（1）：

可視性 （2）： 可視/発現 （3）：指定されたブール変数または 表現 アプリケーションまたは Depictor オブジェクトはTRUEです。

色 （4）： 表現の色を変える （5）：要素はここで指定された色で完全に色が変更されます。テクスチャも使用されておらず、参照されている既知の色も使用されていません CODESYS Depictor オブジェクト。色を指定するには、タイプのアプリケーション変数を指定できます STRING （例： Application.PLC_PRG.strCol）または正確な色の値（例： 16#FFFF8040）。色を選択するためのデフォルトのダイアログを開くには、入力フィールドの後ろにあるボタンをクリックします。注：色の変更は、公開されたポーズの下の要素には影響しません。

素材 タブ（1）：

このタブは、として挿入されていない要素でのみ使用できます。 Depictor 参照。

材料番号 （2）：モデル内のマテリアルを指定します

ここで、次の材料特性を変更できます。

のインターフェースを作成できます Depictor プロジェクトのPOUプールにあるオブジェクト。この種のオブジェクトをで開くと CODESYS Depictor 編集者、別の インターフェース ビューを使用できます。デフォルトでは、エディターの左端にあるタブとして非表示になっています。それは含まれています Depictor 宣言エディター。

の入力変数を宣言します Depictor オブジェクト、通常の機能ブロックの場合 CODESYS。インターフェイスで宣言されたすべての変数は、 Depictor オブジェクト、たとえばポーズの変換にリンクされます。あなたが参照するとき Depictor ツリー内の要素内のオブジェクト（描写者Ref。）、変数はにリストされています インターフェイス変数 プロパティエディタのセクション。ユースケースの値または式をそこに入力できます。

例 3. 例

A Depictor 「Belt」という名前のオブジェクトがプロジェクトのPOUプールに作成され、インターフェイスは次のように定義されます。

VAR_INPUT
        Belt: Conveyor;
        lrSize: LREAL;
END_VAR

で「ベルト」オブジェクトを参照する場合 Depictor 要素の場合、セクションのプロパティエディタ（1）で変数に値またはアプリケーション変数を入力できます インターフェイス変数 （2）：

The カメラ ビューには2つのセクションがあります。 カメラの位置 と カメラのプロパティ：

セクション「カメラの位置」

の3Dビューで使用されるカメラの位置 CODESYS Depictor オブジェクトは、オブジェクトに従ってリストされて保存されます。位置は、3Dビューからダイアログに適用することも、ダイアログからビューに適用することもできます。暗黙の変数を使用して、IECコードのカメラ位置にアクセスできます。

カメラの位置は次のように定義されます。

選択したカメラ位置のコンテキストメニューには、標準コマンド（削除、切り取り、貼り付け、コピー）に加えて、次のコマンドが含まれています。

IECコードからのカメラ位置へのアクセス：

ライブラリのバージョン1.0.1.0以降の場合 DepictorBase プロジェクトにリンクされている場合は、 CODESYS Depictor オブジェクトは自動的にGVLを生成します <name of Depictor object> とともに Camera 変数。

The Camera 変数にはサブコンポーネントが含まれます Position タイプの DepictorBase.DepictorCameraPosition と xUsePosition タイプの BOOL。の個々の構成に応じて Depictor 物体、 Camera 配列を含めることもできます pCameraPositions タイプの ARRAY ... OF DepictorBase.DepictorCameraPosition。この配列は、オブジェクトの定義されたカメラ位置を記述します。配列内のカメラ位置の数は、変数によって定義されます uiNumberOfCameraPosition タイプの UINT。

これらの暗黙の変数を使用して、IECコードでカメラを制御できます。コードを作成するときは、関数「リストコンポーネント」を使用して、のサブコンポーネントにアクセスします。 <Depictor object>.Camera。 IECコードからの位置情報は、設定した場合にのみ使用されます xUsePosition に TRUE、その後、3Dビューで直接対話することはできなくなります。ビューの周りに赤い枠で示されます。

ライブラリは両方を受け取ります InterpolateCameraPosition 機能ブロックと DepictorCameraPosition カメラの位置を定義するための構造。このブロックは、新しいブロックへの補間に使用されます DepictorCameraPosition 定義された時間内に。これにより、新しい位置が設定されるとすぐにアニメーション化されたカメラの動きが可能になります。

セクション「シーンの背景」

セクション カメラのプロパティ

ライティングビューでは、3Dビューでシーンをライティングするための複数の光源を設定できます。各光源は、テーブル内のノードとして表示され、その下にプロパティがあります。

これについては、以下も参照してください。 3Dビュー、鳥瞰図、および照明構成の例。

のコンテキストメニュー 光源ノードには、標準コマンド（削除、切り取り、貼り付け、コピー）に加えて、次のコマンドが含まれています。

The 鳥の目 ビューは、3Dビューの現在のシーンの概要を提供します。カメラは灰色の円筒形のオブジェクトとして表示され、光源は黄色の円錐形のオブジェクトとして表示されます。

これについては、以下も参照してください。 3Dビュー、鳥瞰図、および照明構成の例。

3Dビューと同様に、マウスを動かしてシーン全体の表示角度を変更できます。ただし、カメラの位置は常にシーンのZ軸上にあります。ズームは、カメラから中心までの距離のみを変更します。

を選択すると バーズアイビューで光の半径を表示する のオプション 点灯 光源のビューでは、点灯している領域が黄色の円で表示されます。

バーズアイビュー（1）と3Dビュー（2）のポーズについては、次の画像の例を参照してください。照明ビュー（3）を構成することにより、シーンは3つの光源（5）も取得します。これらの光源は、鳥の目で黄色のオブジェクトとして表示されます。光源の半径（4）は、バーズアイビューでオブジェクトの周りに黄色の重なり合う円として表示されます。鳥瞰図では、カメラは灰色の円錐形のオブジェクトとして表示されます。 3Dビューの矢印軸の影付きの円形領域も鳥瞰図にあり、オブジェクトもフレームモデルとして描画されます。これは、両方のビューでオブジェクト上のカメラの現在の視線方向を検出するのに役立ちます。