clone - The clone command performs a deep copy of an object,
optionally duplicating in a geometric pattern.
clone [options...] {object_to_clone}
-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
Visit the GSP FreeBSD Man Page Interface.