3PTARB(nged)

NAME

3ptarb - Build an ARB8 shape by extruding a quadrilateral through a given thickness.

SYNOPSIS

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

DESCRIPTION

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.

EXAMPLES

The following are run from the MGED command prompt:

Example 1. 3ptarb example with BRL-CAD prompting for information
mged> 3ptarb    (1)
Enter name for this arb: thing    (2)
Enter X, Y, Z for point 1: 0 0 0  (3)
Enter X, Y, Z for point 2: 1 0 0  (4)
Enter X, Y, Z for point 3: 1 1 0  (5)
Enter coordinate to solve for (x, y, or z): z  (6)
Enter the X, Y coordinate values: 0 1          (7)
Enter thickness for this arb: 3                (8)
1 Start the 3ptarb command.
2 The new ARB8 will be named thing.
3 Point one is at the origin.
4 Point two is at (1, 0, 0).
5 Point three is at (1, 1, 0).
6 The code will calculate the z coordinate of the fourth point.
7 The x and y coordinates of the fourth point are 0 and 1.
8 The new ARB8 will be 3 units thick.
Example 2. 3ptarb command as single line input
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.

AUTHOR

BRL-CAD Team

COPYRIGHT

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