# MGED CMD 3ptarb

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

# 3ptarb

## Syntax

3ptarb [arb_name x1 y1 z1 x2 y2 z2 x3 y3 z3 x|y|z coord1 coord2 thickness

## Argument(s)

x1 y1 z1
Coordinates for first corner of the quadrilateral
x2 y2 z2
Coordinates for second corner of the quadrilateral
x3 y3 z3
Coordinates for third corner of the quadrilateral
x|y|z coord1 coord2
Coordinates for fourth corner of the quadrilateral. Only two of three coordinates are entered, third is calculated. x|y|z indicates which coordinate is calculated.

## Return Value(s)

No Return Values for this command.

## Description

Build an ARB 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.

## Example(s)

mged> 3ptarb
Start the 3ptarb command.
Enter the name for this arb: thing
The new ARB will be named thing.
Enter X, Y, Z for point 1: 0 0 0
Point 1 is at origin.
Enter X, Y, Z for point 2: 1 0 0
Point 2 is at 1, 0, 0
Enter X, Y, Z for point 3: 1 1 0
Point 3 is at 1, 1, 0
Enter Coordinate to solve for (x, y, or z): z
The code will calculate the z coordinate of the fourth point.
Enter the X, Y coordinate values: 0 1
The x and y coordinates of the fourth point are 0 and 1.
Enter thickness for this arb: 3
The new ARB will be 3 units thick.
mged> 3ptarb thing 0 0 0 1 0 0 1 1 0 z 0 1 3
Same as above example, but with all arguments supplied on the command line.