'\" t
.\"     Title: 3PTARB
.\"    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 "3PTARB" "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"
3ptarb \- Build an ARB8 shape by extruding a quadrilateral through a given thickness\&.
.SH "SYNOPSIS"
.HP \w'\fB3ptarb\fR\ 'u
\fB3ptarb\fR [arb_name] [x1] [y1] [z1] [x2] [y2] [z2] [x3] [y3] [z3] [x/y/z] [coord1] [coord2] [thickness]
.SH "DESCRIPTION"
.PP
Build an ARB8 shape by extruding a quadrilateral through a given thickness\&. The arguments may be provided on the command line; if they are not, they will be prompted for\&. The x1, y1, and z1 are the coordinates of one corner of the quadrilateral\&. x2, y2, z2, and x3, y3, z3 are the coordinates of two other corners\&. Only two coordinates of the fourth point are specified, and the code calculates the third coordinate to ensure all four points are coplanar\&. The x|y|z parameter indicates which coordinate of the fourth point will be calculated by the code\&. The coord1 and coord2 parameters supply the other two coordinates\&. The direction of extrusion for the quadrilateral is determined from the order of the four resulting points by the right\-hand rule; the quadrilateral is extruded toward a viewer for whom the points appear in counter\-clockwise order\&.
.SH "EXAMPLES"
.PP
The following are run from the MGED command prompt:
.PP
\fBExample\ \&1.\ \&3ptarb example with BRL-CAD prompting for information\fR
.PP
mged> \fB3ptarb\fR
.RS 4
Start the
\fB3ptarb\fR
command\&.
.RE
.PP
Enter name for this arb: \fBthing\fR
.RS 4
The new ARB8 will be named
\fIthing\fR\&.
.RE
.PP
Enter X, Y, Z for point 1: \fB0 0 0\fR
.RS 4
Point one is at the origin\&.
.RE
.PP
Enter X, Y, Z for point 2: \fB1 0 0\fR
.RS 4
Point two is at (1, 0, 0)\&.
.RE
.PP
Enter X, Y, Z for point 3: \fB1 1 0\fR
.RS 4
Point three is at (1, 1, 0)\&.
.RE
.PP
Enter coordinate to solve for (x, y, or z): \fBz\fR
.RS 4
The code will calculate the z coordinate of the fourth point\&.
.RE
.PP
Enter the X, Y coordinate values: \fB0 1\fR
.RS 4
The x and y coordinates of the fourth point are 0 and 1\&.
.RE
.PP
Enter thickness for this arb: \fB3\fR
.RS 4
The new ARB8 will be 3 units thick\&.
.RE
.PP
\fBExample\ \&2.\ \&3ptarb command as single line input\fR
.PP

mged>\fB3ptarb thing 0 0 0 1 0 0 1 1 0 z 0 1 3\fR
.PP
Same as above example, but with all arguments supplied on the command line\&.
.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
