区块#

VEX CTE 模块 API 参考文档解释了每个 VEXcode 模块的功能、其输入如何改变 6 轴机械臂的行为,以及如何在项目中使用该模块。

当您想在将模块添加到项目之前了解该模块、查看模块报告的内容或比较类别中的类似模块时,请使用此参考资料。

VEXcode Blocks 项目使用模块。Python 项目则使用基于文本的 API 部分。

如何解读块条目#

大多数区块条目包含以下部分:

  • 代码块描述 - 解释代码块的功能以及何时使用。

  • 模块图像 - 显示模块在 VEXcode 中的外观。

  • 参数 - 列出模块上的输入,并解释每个输入如何影响 6 轴机械臂或项目。

  • 返回值 - 说明布尔值或报告器块报告的内容。

  • 示例 - 展示了在项目中使用该模块的一种方法。

常用块类型#

不同形状的模块在项目中发挥着不同的作用。

块类型

它的含义

执行特定操作的模块。堆叠模块通过与其他模块的上下连接形成堆叠。

帽子

当发生某些事情时(例如项目启动或事件发生时),该代码块会启动一个代码块堆栈。

布尔值

返回TrueFalse的语句块。布尔语句块通常用于条件语句中,例如if thenwait until语句块。

记者

用于报告值(例如数字或文本)的代码块。报告代码块通常用于其他代码块内部。

C区

一个包裹其他代码块并控制它们何时或如何运行的代码块,例如重复代码块或if then代码块。

块条目示例#

将手臂移动到指定位置#

移动机械臂到位置 模块将 6 轴机械臂移动到指定的 x、y 和 z 坐标。

移动 [手臂 v] 到位置x:[120] y:[0] z:[100] [毫米 v] ▶

范围

描述

x

目标位置的 x 坐标。

目标位置的y坐标。

z

目标位置的z坐标。

单元

选择坐标单位:

  • 毫米 — 毫米;
  • 英寸;
英寸

展开箭头

默认情况下,这是一个等待块,因此六轴机械臂会在运行下一个块之前完成移动。要使六轴机械臂立即开始移动并立即运行下一个块,请展开该块,添加“不要等待”字样。

例子

当开始
[Move the 6-Axis Arm to standard position at start of project.]
移动 [手臂 v] 到位置x:(120) y:(120) z:(75) [毫米 v] ▶