Copy using vectors

Copies primitives based on lists of input vectors.

Inputs

  • geometry

    • Accepts a single geometry connection (unless the SHIFT key is held).

  • positions

    • The position(s) to copy input primitives to.

  • normals

    • The direction(s) that copied input primitives will orientate themselves towards.

  • up vectors

    • The rotation(s) that copied input primitives will orientate themselves to (based on the direction set by the normals input). See the Note(s) section below for more information.

  • combine meshes

    • Sets whether to combine all copied meshes into a singular mesh primitive. Only meshes are combined. Curves, NURBS surfaces, and other primitive types are ignored with this function.

  • mode

    • Sets the mode in which the normals and up vectors inputs are applied to input primitives.

    • For example, when set to 4 X axis = tangent, Y axis = up vectors input, and the Z axis = normals input (in regards to the original orientation of the input primitives).

Outputs

  • geometry

    • Output primitives.

  • points

    • The list of points of the output primitives.

  • points.x

    • The list of x values of the points of the output primitives.

  • points.y

    • The list of y values of the points of the output primitives.

  • points.z

    • The list of z values of the points of the output primitives.

Note(s)

  • The positions, normals, and up vectors inputs can be visualized like so (when using a polyline and the mode input is set to 4):

  • Notes specific to the mode input:

    • Using mode 4 is recommended, as it represents the intended function of the node. Modes 0 through 3 are considered deprecated but will still function.

    • The tangent of the modes as described above in the mode input section above is the resultant of the normals and up vectors inputs.

    • Often vector rotations are described in handedness or chirality (See here for more information). In regards to the different modes: modes 0 and 1 are left-handed whereas modes 2, 3, and 4 are right-handed.

  • The combine meshes input has the same function as the combine meshes node with the group behavior input set to exclude meshes from groups.

  • Other names for this node include: Copy2, Duplicate, Instance, and Matrix.

Example(s)