clone — The clone command performs a deep copy of an object, optionally duplicating in a geometric pattern.
-h
Display 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>