Skip to main content

可视化元素：Path3D

注意

该元素不适用于CODESYS HMI显示变体。

象征：

visu_img_path3d.png

类别：特殊控制

这路径3D可视化元素将两个独立记录的曲线以图形方式显示为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。

注意

Kann auch veraltet sein示例项目：“3D 路径生成器”

Kann auch veraltet sein项目CNC_File_3DPath（包括在CODESYS安装目录）

元素属性

所有元素属性都可用吗？

只有在您选择 “” 后，所有属性才可用 高级 选项或 所有类别 过滤 特性。

元素名称

例子： GenElemInst_1

提示

为元素指定单独的名称，以便更快地在元素列表中找到它们。

元素类型

路径3D

位置

该位置定义可视化窗口中元素的位置和大小。这是基于笛卡尔坐标系的。原点位于窗口的左上角。正水平 X 轴向右延伸。正垂直 Y 轴向下延伸。

X

元素左上角的 X 坐标（以像素为单位）

例子： 10

Y

元素左上角的 Y 坐标（以像素为单位）

例子： 10

宽度

以像素为单位指定

例子： 150

高度

以像素为单位指定

例子： 30

提示

您还可以通过拖动框来更改值 _visu_icon_position_element.png 符号到编辑器中的其他位置。

路径描述

路径数据 (VisuStruct3DTrack)

类型变量 VisuStruct3DTrack 在 IEC 代码中声明

例子： PLC_PRG.pc.vs3dt.

可以在库管理器中找到该结构的描述 VisuElem3DPath.library 图书馆。

数据结构通过特定数量的点描述路径或轨迹。这些点由应用程序确定和缓冲。轨道通常显示最后 n 个位置，以便一次只显示其中的特定部分。

VisuStruct3DTrack.pProjection 是一个由可视化元素设置的变量，包含有关路径/轨迹投影的信息。它可以（仅）由应用程序读取。此外， Projection.Apply 要么 .ApplyV 方法可用于查看转换后的位置是在可视化显示区域的内部还是外部，如定义 Projection.ElementRect.

路径颜色

绘制路径的颜色

路径线宽

路径线宽（以像素为单位）

例子： 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

这些值可以通过应用程序本身或通过 控制面板 可视化元素。这 VisuElem3DPath 库包含现成的可视化框架，为该数据提供可能的用户界面。

可以在库管理器中找到该结构的描述 VisuElem3DPath 图书馆。

输入配置

属性包含使用鼠标或键盘时用户输入的配置。用户输入定义了一个事件和一个或多个在事件发生时执行的动作。

提示

这 配置 按钮打开 输入配置 对话。您可以在那里创建或编辑用户输入。

配置的用户输入列在事件下方。它们每个都包括触发的动作和简短形式的设置。

例子： 执行 ST 代码： _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

输入事件：用户关闭对话框。

鼠标点击

输入事件：用户在元素区域完全点击鼠标按钮。单击并释放鼠标按钮。

鼠标按下

输入事件：用户点击鼠标按钮。

OnMouseEnter

输入事件：用户将鼠标指针拖到元素上。

鼠标离开

输入事件：用户将鼠标指针拖离元素。

鼠标移动

输入事件：用户将鼠标指针移动到元素区域上。

OnMouseUp

. 输入事件：

  • 用户在元素区域内释放鼠标按钮。用户之前是否在元素区域内部或外部按下鼠标按钮是无关紧要的。

  • 用户在元素区域内按下鼠标按钮，离开元素区域，然后释放鼠标按钮。

注意

这 CODESYS- 特定的触发行为保证关键元素的动作完成。一个关键元素开始一个动作 鼠标按下 并结束动作 OnMouseUp.

示例：可视化用户在关键元素的元素区域内按下鼠标按钮，然后移动光标位置，使其位于元素区域之外。无论如何，该操作都结束了，因为 OnMouseUp 被触发。

OnValueChanged

由于值更改而触发后续操作的事件。

在对话框中指定触发哪些后续动作 输入配置 配置。

定义的后续操作和相关配置显示在元素属性下方。

事件 OnValueChanged 可以由编译器定义 VISU_NO_VALUECHANGED 在应用程序的属性对话框中停用。

轻敲

当鼠标点击事件发生时，定义在 多变的 在应用程序中进行了描述。编码取决于 点击错误 和 如果捕获，请点击输入 选项。

多变的

要求： 点击错误 选项未激活。

多变的 （BOOL) 用于鼠标点击事件

TRUE: 存在鼠标点击事件。只要用户在元素上按下鼠标按钮，它就会持续。它在按钮被释放时结束。

FALSE: 鼠标点击事件不存在。

例子： PLC_PRG.bIsTapped

点击错误

standard icon: 鼠标点击事件导致一个互补值 多变的.

TRUE: 鼠标点击事件不存在。

FALSE: 当鼠标点击事件存在时。

如果捕获，请点击输入

standard icon：在用户输入过程中，还考虑在按下鼠标按钮时是否在元素区域内拖动鼠标指针。

TRUE: 当鼠标点击事件存在并且鼠标指针移动到元素区域时。

FALSE: 鼠标点击事件不存在。或者用户在按下鼠标按钮时将鼠标指针移到元素区域之外。

值为 TRUE 一旦用户将指针移回元素区域，就会再次出现。然后捕获鼠标。

切换

随着鼠标点击事件的发生，变量被设置；当鼠标点击事件完成时，变量被重置。

多变的

多变的 （BOOL) 用于在鼠标单击事件结束时进行切换

这是当鼠标指针位于元素区域上时用户释放鼠标按钮。如果用户在鼠标指针位于元素区域之外时释放鼠标按钮，则鼠标单击事件不会结束，值不会切换。

提示

用户可以通过将鼠标指针拖出元素区域来取消已启动的切换输入。

如果捕获则打开

standard icon：无论释放鼠标按钮时鼠标指针在哪里，该值都会切换。然后捕获鼠标。

热键

用于触发特定输入操作的元素上的快捷方式

当热键事件发生时，在 活动 属性被触发。这样，导致这个输入动作的不是输入动作本身，而是鼠标输入动作。

钥匙

按键输入动作。

例子： 吨

选择键时会出现以下属性。

活动

  • 没有

  • 鼠标向下: 按键触发输入动作 鼠标按下 财产。

  • 鼠标向上：松开按键会触发在 OnMouseUp 财产。

  • 鼠标向下/向上：按下和释放键触发在配置的输入动作 鼠标按下 财产和 OnMouseUp 财产。

切换

standard icon：与“Shift”键组合

例子： 转移+吨.

控制

standard icon: 与“Ctrl”键组合

例子： Ctrl+吨.

Alt

standard icon：与“Alt”键组合

例子： Alt+吨.

提示

可视化中配置的所有键盘快捷键及其操作都列在 键盘配置 标签。

其他方面

坐标系

standard icon：显示坐标系。

网格

standard icon：显示网格线

网格颜色

网格线的颜色

强调

路径的各个部分可以在视觉上突出显示。通常，这用于用不同的颜色标记轨道的已完成部分。路径上的每个点都有一个唯一的 ID，在 CNC 编辑器的情况下，该 ID 链接到该点所在的对象 ID。此 ID（“突出显示 ID”）可以通过应用程序指定，以便可以动态突出显示路径的元素/部分。

高光类型

. 选择以下突出显示类型之一：

  • 只有 ID 与变量值匹配的元素才会突出显示。

  • 其 ID（在 CNC 编辑器链接到对象 ID 的情况下）小于或等于 多变的 被突出显示。

多变的

指定元素 ID 的项目变量

例子： PLC_PRG.iVarElementID

这个“highlight ID”被考虑到设置 高光类型.这些变量可以在应用程序中使用。

高亮颜色

例子： 红色的

外貌

边框线宽

元素周围边框的厚度（以像素为单位）

例子： 1

边框线样式

. 为框架线选择以下样式类型之一：

  • 坚硬的

  • 短跑

  • 点

  • 破折号

  • 点划线点

  • 无形的

背景透明

standard icon：元素的背景透明显示。

_cds_icon_option_deactivated.png：元素的背景以定义的背景颜色显示。

背景颜色

款式颜色或颜色

中心

属性包含旋转点坐标的固定值。旋转点在编辑器中显示为 _visu_icon_center_point.png 符号并用作旋转和缩放的中心。

提示

您也可以通过拖动 _visu_icon_center_point.png 符号到编辑器中的另一个位置。

X

旋转点的 X 坐标

Y

旋转点的 Y 坐标

绝对运动

这些属性包含用于动态控制元素位置的 IEC 变量。参考点是元素的左上角。在运行时，整个元素被移动。

移动

X

  • X 位置的变量（数字数据类型）（以像素为单位）

    例子： PLC_PRG.iPos_X.

  • 容器变量： Container.Width

    有关详细信息，请参阅： 优化调整位置和大小

在运行时增加此值会使元素向右移动。

Y

  • Y 位置的变量（数字数据类型）（以像素为单位）

    例子： PLC_PRG.iPos_Y.

  • 容器变量： Container.Height

    有关详细信息，请参阅： 优化调整位置和大小

在运行时增加此值会使元素向下移动。

回转

旋转角度的变量（数字数据类型）（以度为单位）

例子： PLC_PRG.iAngle1.

元素的中点在 中心 观点。该旋转点显示为 _visu_icon_center_point.png 象征。

在运行时，元素的对齐相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。

_visu_img_prp_rotation.png

缩放

用于触发中心拉伸的变量（整数数据类型）

例子： PLC_PRG.iScaling

参考点是 中心 财产。

价值 1 将元素缩小一个因子 0.001.价值 1000 将元素返回到其原始大小。

内部旋转

旋转角度的变量（数字数据类型）（以度为单位）

例子： PLC_PRG.iAngle2.

在运行时，元素围绕指定的旋转点旋转 中心 根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。

旋转点如图所示 _visu_icon_center_point.png 象征。

注意

如果在 位置→角度 属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。

_visu_img_prp_inner_rotation.png

提示

您可以将变量组合到 单位换算.

提示

这 X, 是, 回转， 和 内部旋转 “客户端动画”功能支持属性。

状态变量

变量动态控制元素行为。

无形的

多变的 （BOOL) 用于切换元素的可见性

TRUE：该元素在运行时不可见。

提示

这 无形的 “客户端动画”功能支持属性。

动画

提示

这些属性仅在您选择了 支持客户端动画和原生元素叠加 中的选项 可视化管理器.

动画时长

元素运行动画的持续时间（以毫秒为单位）的变量

  • 变量（整数值）

    例子： Menu.tContent 和 VAR tContent : INT := 500; END_VAR

  • 整数字面量

    例子： 500

. 动画属性

  • 绝对运动, 移动, X, 是

  • 绝对运动, 回转

  • 绝对运动, 内部旋转

  • 绝对运动, 外旋

当可动画属性的至少一个值发生变化时，将执行动画移动。然后执行的运动不是生涩的，而是在指定的动画持续时间内是平滑的。可视化元素在动态旋转的同时移动到指定位置。过渡很平滑。

移至前台

多变的 （BOOL) 用于在前景中设置元素

TRUE：在运行时，可视化元素显示在前台。

FALSE：在运行时，可视化元素显示在可视化编辑器中插入它的层中。

例子： bIsInForeground 和 VAR bIsInForeground : BOOL := FALSE; END_VAR

访问权

注意

仅当为可视化设置用户管理时可用。

访问权 按钮

打开 访问权 对话。您可以在此处编辑元素的访问权限。

. 状态消息：

  • 没有设置。完全权利。：所有用户组的访问权限： 可操作

  • 权利已设定：有限权利: 至少有一组限制访问。

本节内容如下: