'\" t
.\"     Title: CLONE
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD MGED Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "CLONE" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD MGED Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
clone \- The clone command performs a deep copy of an object, optionally duplicating in a geometric pattern\&.
.SH "SYNOPSIS"
.HP \w'\fBclone\fR\ 'u
\fBclone\fR [\fIoptions\fR...] {object_to_clone}
.SH "OPTIONS"
.PP
\fB\-h\fR
.RS 4
Display help\&.
.RE
.PP
\fB\-n <copies>\fR
.RS 4
Specifies the number of copies to make\&. Default is 1\&.
.RE
.PP
\fB\-t <x> <y> <z>\fR
.RS 4
Specifies an
\fBx\fR,
\fBy\fR, and
\fBz\fR
translation distance between each copy\&. Default is 0\&.0, no translation\&. This option conflicts with
\fB\-a\fR
which specifies total translation distance\&.
.RE
.PP
\fB\-r <x> <y> <z>\fR
.RS 4
Specifies
\fBx\fR,
\fBy\fR, and
\fBz\fR
angles to rotate around the x, y, and z axes between each copy\&. Default is 0\&.0, no rotation\&. This option conflicts with
\fB\-b\fR
which specifies total rotation angles\&.
.RE
.PP
\fB\-p <x> <y> <z>\fR
.RS 4
Specifies an
\fBx\fR,
\fBy\fR, and
\fBz\fR
point to rotate around for
\fB\-b\fR
and
\fB\-r\fR\&. Default is 0 0 0\&.
.RE
.PP
\fB\-a <n> <x> <y> <z>\fR
.RS 4
Specifies a total
\fBx\fR,
\fBy\fR, and
\fBz\fR
translation distance split across
\fBn\fR
copies\&. This option conflicts with
\fB\-t\fR
which specifies incremental distances\&.
.RE
.PP
\fB\-b <n> <x> <y> <z>\fR
.RS 4
Specifies a total rotation in degrees about the
\fBx\fR,
\fBy\fR, and
\fBz\fR
axes, split across
\fBn\fR
copies\&. This option conflicts with
\fB\-r\fR
which specifies incremental rotation angles\&.
.RE
.PP
\fB\-m <axis> <distance>\fR
.RS 4
Specifies an axis and distance along that axis about which to create a mirrored copy\&. The
\fBaxis\fR
must be \*(Aqx\*(Aq, \*(Aqy\*(Aq, or \*(Aqz\*(Aq\&. The distance may be a positive or negative distance along that axis\&.
.RE
.PP
\fB\-i <increment>\fR
.RS 4
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\&.,
\fBclone box\fR
creates a \*(Aqbox100\*(Aq object)\&. Default
\fBincrement\fR
is 100\&.
.RE
.PP
\fB\-c\fR
.RS 4
This option pertains to the copy naming convention\&. Increment the
\fInext\fR
number encountered in object names\&. You can specify
\fB\-c\fR
multiple times to increment the Nth number\&. For example,
\fBclone \-c \-c \-c\fR
will increment the 4th number in object namess\&. Default is to increment the first number encountered\&.
.RE
.SH "DESCRIPTION"
.PP
Clone performs a deep copy, traversing the entire hierarchy of the object specified and creating a new independent hierarchy\&. The
\fBclone\fR
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
\fB\-i\fR
and
\fB\-c\fR
options\&.
.PP
If you specify different numbers of copies with the
\fB\-a\fR,
\fB\-b\fR, and/or
\fB\-n\fR
options, the last value of
\fBn\fR
specified will be used for the number of copies\&.
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
