CODESYS Depictor 编辑（授权）

在 3D 视图中工作时，以下命令的按钮在 CODESYS 主窗口：

	添加姿势：在树中所选条目的下方添加一个姿势。 定义：A 摆姿势 显示其子节点相对于其父节点的平移。例如，所有子节点都应相对于父节点移动七个单位。
	添加元素：在树中选定条目的下方添加一个元素。 定义：一个 元素 在里面 CODESYS Depictor 包含 a 的实际 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. 显示“连接”类型转换的示例

这 CODESYS Depictor 应显示伸缩气缸的运动。空间中的运动和圆柱体长度的变化应自动适应空间中两点的当前位置。为此，您对圆柱体位姿使用变换类型“连接”，并指定空间点和方向矢量。然后，圆柱体所需的不断平移由下式自动计算 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);

这 特性 编辑 (1) Depictor 元素由选项卡组成 基本的 和 外貌.对于不属于 Depictor 参考资料，还有 材料 标签。

基本的 选项卡 (2)：

定义几何源并为元素设置额外的 X/Y/Z 变换。如果元素来自 Depictor 定义接口的引用，然后您可以执行 接口变量 (9) 在表中。有关详细信息，请参阅 CODESYS Depictor 观众。

外貌 选项卡 (1)：

能见度 (2): 可见/表达 (3)：当指定布尔变量或 表达 申请或 Depictor 对象为真。

颜色 (4): 重新着色表达式 (5)：元素完全使用此处指定的颜色重新着色。既不使用纹理，也不使用参考的已知颜色 CODESYS Depictor 对象。要指定颜色，您可以提供类型的应用程序变量 STRING （例子： Application.PLC_PRG.strCol）或确切的颜色值（例如： 16#FFFF8040）。要打开颜色选择的默认对话框，请单击输入字段后的按钮。注意：重新着色不会影响已发布姿势以下的元素。

材料 选项卡 (1)：

此选项卡仅适用于未插入的元素 Depictor 参考。

料号 (2)：指定模型中的材料

可以在此处修改以下材料属性：

您可以创建一个接口 Depictor 位于项目的 POU 池中的对象。当您在 CODESYS Depictor 编辑，另一个 界面 视图可用，默认情况下隐藏为编辑器左边缘的选项卡。它包含 Depictor 声明编辑器。

声明输入变量 Depictor 对象，就像通常的功能块一样 CODESYS.接口中声明的每个变量在 Depictor 对象，例如与姿势变换相关联。当你参考 Depictor 树中元素中的对象 (描述器参考。)，变量列在 接口变量 属性编辑器的部分。您可以在其中使用用例的值或表达式填充它们。

例 3. 例子

一种 Depictor 在项目的POU池中创建名为“Belt”的对象，接口定义如下：

VAR_INPUT
        Belt: Conveyor;
        lrSize: LREAL;
END_VAR

在引用“Belt”对象时 Depictor 元素，您可以在该部分的属性编辑器 (1) 中使用值或应用程序变量填充变量 接口变量 (2):

这 相机 视图有两个部分： 相机位置 和 相机属性：

“相机位置”部分

在 3D 视图中使用的相机位置 CODESYS Depictor 对象按对象列出保存。位置可以从 3D 视图应用到对话框中，也可以从对话框应用到视图中。使用隐式变量，您可以访问 IEC 代码中的相机位置。

摄像机位置定义为：

除标准命令（删除、剪切、粘贴和复制）外，选定摄像机位置的上下文菜单还包含以下命令。

从 IEC 代码访问摄像机位置：

如果库的版本为 1.0.1.0 或更高版本 DepictorBase 链接在您的项目中，然后每个 CODESYS Depictor 对象自动生成 GVL <name of Depictor object> 与 Camera 多变的。

这 Camera 变量包含子组件 Position 类型 DepictorBase.DepictorCameraPosition 和 xUsePosition 类型 BOOL.视个人配置而定 Depictor 目的， Camera 也可能包含一个数组 pCameraPositions 类型 ARRAY ... OF DepictorBase.DepictorCameraPosition.该数组描述了对象的定义相机位置。数组中摄像机位置的数量由变量定义 uiNumberOfCameraPosition 类型 UINT.

使用这些隐式变量，您可以使用 IEC 代码控制相机。创建代码时，使用“List Components”函数来访问子组件 <Depictor object>.Camera.来自 IEC 代码的位置信息仅在您设置时使用 xUsePosition 到 TRUE, 然后在 3D 视图中不再可能进行直接交互。由视图周围的红框表示。

图书馆同时收到 InterpolateCameraPosition 功能块和 DepictorCameraPosition 用于定义相机位置的结构，。该块用于插值到一个新的 DepictorCameraPosition 在规定的时间内。这允许在设置新位置后立即进行动画相机运动。

“场景背景”部分

部分 相机属性

在照明视图中，您可以配置多个光源来照明 3D 视图中的场景。每个光源在表中显示为一个节点，其属性位于其下方。

为此，另见下文： 3D 视图、鸟瞰图和照明配置示例.

a 的上下文菜单 除了标准命令（删除、剪切、粘贴和复制）之外，光源节点还包含以下命令。

这 鸟的眼睛 视图在 3D 视图中提供当前场景的概览。相机显示为灰色圆柱形物体，光源显示为黄色圆锥形物体。

为此，另见下文： 3D 视图、鸟瞰图和照明配置示例.

与在 3D 视图中一样，您可以移动鼠标来更改整个场景的视角。但是，摄像机位置始终保持在场景的 Z 轴上。缩放只会改变相机到中心的距离。

当您选择 在鸟瞰图中显示光半径 中的选项 灯光 对于光源视图，点亮区域显示为黄色圆圈。

有关鸟瞰图 (1) 和 3D 视图 (2) 中的姿势，请参见下图中的示例。通过配置照明视图（3），场景还获得了三个光源（5），在鸟瞰图中可以看作是黄色物体。在鸟瞰图中，光源的半径 (4) 显示为围绕对象的黄色重叠圆圈。相机在鸟瞰图中显示为灰色锥形物体。 3D视图中带有箭头轴的阴影圆形区域也在鸟瞰图中，并且对象也被绘制为框架模型。这有助于在两个视图中检测相机在对象上的当前观察方向。