Distribute Matrices

Description

This node creates a list of matrices that represent the locations of object distributed someway in space. They can be distributed in a line, grid, circle, spiral, or based on a custom distribution.

Linear

This option distribute matrices along the x-axis centered at the world.

Size

This option lets you define the size of the line explicitly.

Inputs

  • Amount - Number of matrices.
  • Size - Size of the line.

Step

This option lets you define the distance between each two consecutive matrices.

  • Amount - Number of matrices.
  • Distance - Distance between each two consecutive matrices.

Grid

This option distribute matrices on a 3D lattice.

Options

  • Center X - Center grid along the X axis.
  • Center Y - Center grid along the Y axis.
  • Center Z - Center grid along the Z axis.

Size

This option lets you define the dimensions of the lattice.

Inputs

  • X Division - Number of matrices in x-axis.
  • Y Division - Number of matrices in y-axis.
  • Z Division - Number of matrices in z-axis.
  • Width - The width of the lattice.
  • Length - The length of the lattice.
  • Height - The height of the lattice.

Step

This option lets you define the distance between each two matrices in all axis.

Inputs

  • X Division - Number of matrices in x-axis.
  • Y Division - Number of matrices in y-axis.
  • Z Division - Number of matrices in z-axis.
  • X Distance - Distance between each two consecutive matrices along x-axis.
  • Y Distance - Distance between each two consecutive matrices along y-axis.
  • Z Distance - Distance between each two consecutive matrices along z-axis.

Circle

This option lets you distribute matrices around a circle centered at the world.

Inputs

  • Amount - The number of matrices around the circle.
  • Radius - Radius of the circle.
  • Segment - A ratio that describe the completeness of the circle, where 1 means a complete circle and 0 means no circle.

Mesh

This option lets you distribute matrices along the vertices or polygons of a mesh. The orientation of the matrices align with the normals of the vertices and polygons.

Inputs

  • Mesh - The input mesh.

Spiral

This option lets you distribute matrices along an Archimedean spiral.

Inputs

  • Amount - The amount of matrices to compute.
  • Start Radius - The distance from the center where the spiral will start.
  • End Radius - The distance from the center where the spiral will end.
  • Start Size - The scale of the matrix at the start of the spiral.
  • End Size - The scale of the matrix at the end of the spiral.
  • Start Angle - The angle from the positive X axis where the spiral will start. Angles can’t be equivalent.
  • End Angle - The angle from the positive X axis where the spiral will end. Angles can’t be equivalent.

Outputs

  • Matrices - The output matrices.
  • Vectors - The locations of the output matrices.