Viz Artist

Version 3.9.0 | Published December 13, 2017 ©

Cloner

images/download/attachments/27789571/viz_icons_cloner.png
Creates a number of clones of a given container (target).

Note: This plug-in is located in: Built Ins -> Container plug-ins -> Tools

This section contains information on the following topics:

Cloner Properties

images/download/attachments/27789571/plugins_container_cloner_editor.png

  • Clones Count: Specifies the maximum number of clones to be created.

  • Clones Rows: Defines, together with Clones Cols, how clones are being laid out. Layout depends on the Shape parameter which can be Matrix (grid), Ellipse and Sphere.

  • Clones Cols: See Clones Rows description above.

  • Shape: Sets the different shapes. Available options are Matrix, Ellipse and Sphere.

  • Rename Subtrees: Clones will be labeled "group_x_y" per default. If this flag is set, clones will be labeled "<name of target>_x_y". Only takes effect upon future changes in the subtree.

  • Rename Excess Containers: Suppose a matrix of 10x10 clones. If you now change the matrix to be made of 5x5 clones you will be left with 75 orphans, which will be removed if this flag is set. Only takes effect upon future changes in the subtree.

  • Remove All (button): Remove all clones right now.

  • Remove Only Excess (button): Remove excess clones right now.

Matrix and Ellipse shape specific settings:

  • Plane: Specifies along which axes, newly generated clones are going to be laid out. Default is XY, alternatives are XZ and YZ.

  • Delta X, Y and Z: Specifies an relative offset in X,Y and Z axis between each clone. Actually defines how closely clones are being packed into the matrix or ellipse.

  • Delta represents:Step directly affects the translation matrix of the clones 1:1. For example a value of 200 for Delta X means that clone A (located at position 0) will be followed by clone B translated 200 units in X. The container’s transformation matrix is being modified accordingly. Bounding Box does not affect the clones transformation matrix 1:1, but instead applies the transformation relative to the bottom-left edge of the target’s bounding box in matrix mode. Suppose a rectangle of 100x100 is used as target. Delta X of 100 in Step mode will cause all clones to be positioned with an offset of 100 units in X. In Bounding Box mode a value of 100 will produce an effective offset of only 50.

  • R1 and R2: Specifies values of radius 1 and radius 2, defining the ellipse. Used in ellipse mode.

  • Min and Max Angle: Specifies an open ellipse from for example 45° to 175° instead of 0° to 360°. Used in ellipse mode.

  • Offset Angle: Rotates the individual clones along the axis. This is not affected by setting of Plane. If the ellipse is laid out in XY this parameter will affect the Z-axis. Used in ellipse mode.

Sphere shape specific settings:

  • Radius: Specifies the radius of the sphere composed by the given number clones.

  • Min and Max Azimuth: Same as Min and Max angle for the ellipse.

  • Min and Max Pitch: Specifies the position of the poles of the sphere. The poles can only be shifted towards the center of the sphere. This will actually result in a sphere with its poles being cropped.

To clone container

  1. Add a new group to the scene tree, and add the Cloner plug-in to it.

  2. Add the object (target) to be cloned as the first child of this group.

    • By modifying parameters Clones Count, Rows and Cols a corresponding number of clones will be created.

    • Operating in shape mode Matrix you can alter Delta X, Y and Z parameters to create a layout for the newly generated clones.