helicalXY()

描述

使用顺时针弧或逆时针划螺旋线。方向是从发生圆周运动的 Z 轴的正方向看的。
此方法使用圆心模式来控制螺旋线路径,并利用旋转角度的正负值来选择顺时针或逆时针。
如欲了解各种运动方法请详见运动方法解说页面。

语法

machine.helicalXY(cX, cY, dstZ, theta); machine.helicalXY(cX, cY, dstZ, theta, feedrate);

参数

machine:为 Machine物件。

cX:圆心模式下的圆心 X 座标。

cY:圆心模式下的圆心 Y 座标。

dstZ:目标 Z 座标,即做弧线运动时一并移动该轴至目标座标。

theta:欲旋转的角度,顺时针时使用正值,逆时针时使用负值。

feedrate:进给速度,不传参数时将使用最后一次记录的进给速度。

回传

bool:

true: 机器存在且创建成功。
false: 机器不存在或创建失败。

范例

设定机器的基本参数,并将机器在 XY 平面上螺旋线。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

#include "Motion86.h"

 

// 产生机器物件,最多可使用 machine 0~2 三台机器,每台机器三轴。

Machine machine(0);

 

// 步进马达 enable pin。

int EnablePin = 4;

 

void setup() {

  while (!Serial);

  pinMode(EnablePin, OUTPUT);

 

  // 若有需要,可以反转运动轴的运动方向。

  // 在此范例中,需要反转 x 轴和 y 轴的方向。

  machine.config_ReverseDirection(AXIS_X);

  machine.config_ReverseDirection(AXIS_Y);

 

  // PPU (pulse per unit) 是一虚拟长度单位,依照不同需求而定。

  // 此例 x 轴的单位长度设定为 80 pulses,对应到实际应用为 1 mm。

  machine.config_PPU(AXIS_X, 80.0);

  machine.config_PPU(AXIS_Y, 80.0);

  machine.config_PPU(AXIS_Z, 1600.0);

 

  // 控制之前,必须启动机器。

  machine.machineOn();

  machine.setDefaultFeedrate(400);

 

  // 启动步进马达。

  digitalWrite(EnablePin, LOW);

}

 

void loop() {

  // 以圆心 (0, 10, 0) 顺时针移动两个圆到 (0, 0, 10)。

  machine.helicalXY(0, 10, 10, TWO_PI * 2, true);

 

  // 以圆心 (0, 10, 10) 逆时针移动两个圆到 (0, 0, 0)。

  machine.helicalXY(0, 10, 0, TWO_PI * 2, false);

   

  // 等待直到已规划之运动完成。

  while (machine.isMoving());

}

See also

helicalYZ()
helicalXZ()


函式库参考

86Duino 参考资料的文字遵循知识共享署名-Creative Commons Attribution-ShareAlike 3.0 License。参考资料中的程式码范例已发布到公共领域。