points_add()

Adds a new point to the points list.

Can add:

Syntax

points_add(axis, value)
points_add(x, y, z)
points_add(x, y, z, a, b, c, u, v, w)

Parameters

Parameter Type Description Comment
axis Number Axis index (0-8) Required for 2-arg
value Number Position value for the axis Required for 2-arg
x Number X coordinate Required for 3-arg
y Number Y coordinate Required for 3-arg
z Number Z coordinate Required for 3-arg
a Number A coordinate (rotation) Required for 9-arg
b Number B coordinate (rotation) Required for 9-arg
c Number C coordinate (rotation) Required for 9-arg
u Number U coordinate Required for 9-arg
v Number V coordinate Required for 9-arg
w Number W coordinate Required for 9-arg

Return Value

Examples

Add a single-axis position

points_add(0, 50); // Adds 50 to axis 0

Add an XYZ position

points_add(100, 200, 300);

Add a full 9-axis position

points_add(100, 200, 300, 10, 20, 30, 1, 2, 3);

See also

points_count
points_clear
points_add
points_get
points_set
points_delete
points_load
points_save