[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPEL3 - Ellipse 3

GPEL3 (center, refv1, refv2)

Purpose

Use GPEL3 to insert an Ellipse 3 structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with an Ellipse 3 structure element depending on the current edit mode.

This is the fully specified, three-dimensional form of the ellipse primitive.

The major and minor axis (refv1 and refv2 respectively) parameters define a parallelogram that circumscribes the ellipse and is anchored at the center of the ellipse (center) Two sides are parallel to the major axis. The other two sides are parallel to the minor axis. The major and minor axes extend from the center of the ellipse to midpoints of sides of the parallelogram. The ellipse is tangent to the sides of the parallelogram at their midpoints.

Polyline attributes are applied to this primitive.

GPEL3 is identified as GDP 1008.

Note:

Not all GDPs are supported on all workstations. Use the Inquire List of Generalized Drawing Primitives (GPQGD) subroutine to determine the GDPs supported by an opened workstation. See also the workstation description in The graPHIGS Programming Interface: Technical Reference

Parameters

center -- specified by user, 3 short floating-point numbers (MC)

Center of ellipse.

refv1 -- specified by user, 3 short floating-point numbers (MC)

Major axis of ellipse. This direction vector is anchored at the center of the ellipse.

refv2 -- specified by user, 3 short floating-point numbers (MC)

Minor axis of ellipse. This direction vector is anchored at the center of the ellipse.

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
107
REFERENCE VECTORS ARE COLINEAR

Related Subroutines

GPLT
Set Linetype
GPLWSC
Set Linewidth Scale Factor
GPPLCD
Set Polyline Color Direct
GPPLCI
Set Polyline Color Index
GPPLET
Set Polyline End Type
GPPLI
Set Polyline Index

RCP code

201328149 (X'0C000615')


[ Previous | Next | Contents | Glossary | Home | Search ]