clone — The clone command performs a deep copy of an object, optionally duplicating in a geometric pattern.
-hDisplay help.
-n <copies>Specifies the number of copies to make. Default is 1.
-t <x> <y> <z>
Specifies an x, y, and z translation distance between each copy. Default is 0.0, no translation. This option conflicts with -a which specifies total translation distance.
-r <x> <y> <z>
Specifies x, y, and z angles to rotate around the x, y, and z axes between each copy. Default is 0.0, no rotation. This option conflicts with -b which specifies total rotation angles.
-p <x> <y> <z>
Specifies an x, y, and z point to rotate around for -b and -r. Default is 0 0 0.
-a <n> <x> <y> <z>
Specifies a total x, y, and z translation distance split across n copies. This option conflicts with -t which specifies incremental distances.
-b <n> <x> <y> <z>
Specifies a total rotation in degrees about the x, y, and z axes, split across n copies. This option conflicts with -r which specifies incremental rotation angles.
-m <axis> <distance>
Specifies an axis and distance along that axis about which to create a mirrored copy. The axis must be 'x', 'y', or 'z'. The distance may be a positive or negative distance along that axis.
-i <increment>
This option pertains to the copy naming convention. It specifies the increment to use when naming copies. If a number is not found in the name, the increment number is appended to the end of the name (e.g., clone box creates a 'box100' object). Default increment is 100.
-c
This option pertains to the copy naming convention. Increment the next number encountered in object names. You can specify -c multiple times to increment the Nth number. For example, clone -c -c -c will increment the 4th number in object namess. Default is to increment the first number encountered.
Clone performs a deep copy, traversing the entire hierarchy of the object specified and creating a new independent hierarchy. The clone command uses an automatic naming convention as it creates copies, incrementing and/or appending to numbers encountered in the object specified. The number convention may be configured with the -i and -c options.
If you specify different numbers of copies with the -a, -b, and/or -n options, the last value of n specified will be used for the number of copies.
Reports of bugs or problems should be submitted via electronic
mail to <devs@brlcad.org>