'\" t
.\"     Title: PERMUTE
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "PERMUTE" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD User 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"
permute \- Permutes the vertex labels for the face of an ARB shape that is currently being edited\&.
.SH "SYNOPSIS"
.HP \w'\fBpermute\fR\ 'u
\fBpermute\fR {\fItuple\fR}
.SH "DESCRIPTION"
.PP
Permutes the vertex labels for the face of an ARB shape that is currently being edited\&. The
\fItuple\fR
indicates which face is affected and also indicates the desired result\&. The tuple is formed by concatenating the list of vertex numbers for the face in the order desired such that the first vertex listed will become vertex number one (and therefore the default keypoint)\&. Only a sufficient number of vertices to disambiguate need be included in the tuple\&. Note that this has no effect on the geometry of the ARB, but may affect any texture mapping involving this shape\&.
.SH "EXAMPLES"
.PP
The example shows the use of the
\fBpermute\fR
command to rearrange the vertices of the ARB being edited according to the specified tuple\&.
.PP
\fBExample\ \&1.\ \&Rearrange the vertices of an ARB being edited.\fR
.PP

mged>\fBpermute 321\fR
.PP
Rearranges the vertices of the currently edited ARB such that vertex 3 becomes vertex 1, vertex 2 remains 2, and vertex 1 becomes 3\&.
.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
