CLONE(nged)

NAME

clone - The clone command performs a deep copy of an object, optionally duplicating in a geometric pattern.

SYNOPSIS

clone [options]…​ {object_to_clone}

OPTIONS

-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.

DESCRIPTION

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.

AUTHOR

BRL-CAD Team

This software is Copyright (c) 1989-2021 by the United States Government as represented by U.S. Army Research Laboratory.

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org