Editing MGED CMD 3ptarb

[[Category:MGED]]

=3ptarb=
__TOC__

==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 [[MGED_Primitive_Types#ARB | ARB]] shape by extruding a quadrilateral through a given <I>thickness</I>. The arguments may be provided on the command line; if they are not, they will be prompted for. The <I>x1, y1,</I> and <I>z1</I> are the coordinates of one corner of the quadrilateral. <I>x2, y2, z2,</I> and <I>x3, y3, z3</I> 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 <I>x|y|z</I> parameter indicates which coordinate of the fourth point will be calculated by the code. The <I>coord1</I> and <I>coord2</I> 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&gt;''' 3ptarb
:: Start the <I>3ptarb</I> command.

: '''Enter the name for this arb:''' thing
:: The new [[MGED_Primitive_Types#ARB | ARB]] will be named <I>thing</I>.

: '''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 [[MGED_Primitive_Types#ARB | ARB]] will be 3 [[MGED_CMD_units|units]] thick.

: '''mged&gt;''' 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.

==See Also==
: [[MGED_CMD_db|db]]
: [[MGED_CMD_make|make]]
: [[MGED_CMD_facedef|facedef]]

----

Page Generated by David Loman on: 10/11/2007 at: 9:40:54 AM