Reference add()

add()

Adds to a vector's x, y, and z components.

add() can use separate numbers, as in v.add(1, 2, 3), another p5.Vector object, as in v.add(v2), or an array of numbers, as in v.add([1, 2, 3]).

If a value isn't provided for a component, it won't change. For example, v.add(4, 5) adds 4 to v.x, 5 to v.y, and 0 to v.z. Calling add() with no arguments, as in v.add(), has no effect.

The static version of add(), as in p5.Vector.add(v2, v1), returns a new p5.Vector object and doesn't change the originals.

Examples

Syntax

add(x, [y], [z])
add(value)
add(v1, v2, [target])

Parameters

x
Number: x component of the vector to be added.
y
Number: y component of the vector to be added.
z
Number: z component of the vector to be added.
value
p5.Vector|Number[]: The vector to add
v1
p5.Vector: A p5.Vector to add
v2
p5.Vector: A p5.Vector to add
target
p5.Vector: vector to receive the result.

Returns

p5.Vector: resulting p5.Vector.
Notice any errors or typos? Please let us know. Please feel free to edit src/math/p5.Vector.js and open a pull request!

Related References