GENERALIZED DRAWING PRIMITIVE 3(3P) — SUNPHIGS LIBRARY

NAME

GENERALIZED DRAWING PRIMITIVE 3 − Create a 3D GDP elements such as polyline set 3, circle 3, or ellipse 3

SYNOPSIS

C Syntax

void
pgdp3 ( num_points, points, gdp3_id, gdp_data )
Pintnum_points; number of points
Ppoint3∗points; array of points
Pintgdp3_id; gdp function identifier
Pgdprec3∗gdp_data; data record pointer

FORTRAN Syntax

SUBROUTINE pgdp3 ( N, PXA, PYA, PZA, PRIMID, LDR, DATREC )
INTEGERNnumber of points (>= 0)
REALPXA(∗), PYA(∗), PZA(∗) coordinates of points (MC)
INTEGERPRIMIDGDP 3 identifier
INTEGERLDRdimension of data record array
CHARACTER∗80DATREC(LDR) data record

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

GENERALIZED DRAWING PRIMITIVE 3 creates the following GDP 3 structure elements:

• polyline set 3
• circle 3
• circular arc 3
• circular arc close 3
• annotation circle 3
• annotation circular arc 3
• annotation circular arc close 3
• ellipse 3
• elliptical arc 3
• elliptical arc close 3
• annotation ellipse 3
• annotation elliptical arc 3
• annotation elliptical arc close 3

If the current edit mode is INSERT, the structure element created by the GENERALIZED DRAWING PRIMITIVE 3 function is inserted into the open structure after the element pointed to by the element pointer. If the current edit mode is REPLACE, the GENERALIZED DRAWING PRIMITIVE 3 element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new structure element.

Support for GDPs is implementation and workstation dependent. All current SunPHIGS GDPs are implemented on all supported workstations.

Each generalized drawing primitive has its own page in the reference manual. The name of the page is generalized drawing primitive 3 -xx, where xx is replaced by the GDP identifiers; for example, GENERALIZED DRAWING PRIMITIVE 3 -1.

C Input Parameters

num_points
Number of points passed in the points parameter.

pointsA pointer to a list num_points long of Ppoint3 structures containing x, y, and z values in Modelling Coordinates (MC). Ppoint3 is defined in phigs.h as:

typedef struct {
Pfloatx;/∗ x coordinate ∗/
Pfloaty;/∗ y coordinate ∗/
Pfloatz;/∗ z coordinate ∗/
} Ppoint3;

gdp3_id
An integer specifying the GENERALIZED DRAWING PRIMITIVE 3 to be performed. Predefined values as defined in phigs.h are:

-1PUGDP_POLYLINE_SET3Polyline Set 3
-2PUGDP_CIRCLE3Circle 3
-3PUGDP_CIRC_ARC3Circular Arc 3
-4PUGDP_CIRC_ARC_CLOSE3Circular Arc Close 3
-5PUGDP_ANNOT_CIRCLE3Annotation Circle 3
-6PUGDP_ANNOT_CIRC_ARC3Annotation Circular Arc 3
-7PUGDP_ANNOT_CIRC_ARC_CLOSE3Annotation Circular Arc Close 3
-8PUGDP_ELLIPSE3Ellipse 3
-9PUGDP_ELLP_ARC3Elliptical Arc 3
-10PUGDP_ELLP_ARC_CLOSE3Elliptical Arc Close 3
-11PUGDP_ANNOT_ELLIPSE3Annotation Ellipse 3
-12PUGDP_ANNOT_ELLP_ARC3Annotation Elliptical Arc 3
-13PUGDP_ANNOT_ELLP_ARC_CLOSE3Annotation Elliptical Arc Close 3

gdp_data
A pointer to a Pgdprec3 union containing the information needed to perform the function specified by gdp3_id. Pgdprec3 is defined in phigs.h as:

typedef union {
Pgdp0001rec3gdp1_datarec;/∗ GDP1 data record ∗/
Pdataunsupported;/∗ unsupported GDP data record ∗/
/∗ implementation defined GDPs ∗/
Pugdp0001rec3ugdp1_datarec;/∗ Polyline Set 3 ∗/
Pugdp0002rec3ugdp2_datarec;/∗ Circle 3 ∗/
Pugdp0003rec3ugdp3_datarec;/∗ Circular Arc 3 ∗/
Pugdp0004rec3ugdp4_datarec;/∗ Circular Arc Close 3 ∗/
Pugdp0005rec3ugdp5_datarec;/∗ Annotation Circle 3 ∗/
Pugdp0006rec3ugdp6_datarec;/∗ Annotation Circular Arc 3 ∗/
Pugdp0007rec3ugdp7_datarec;/∗ Annotation Circular Arc Close 3 ∗/
Pugdp0008rec3ugdp8_datarec;/∗ Ellipse 3 ∗/
Pugdp0009rec3ugdp9_datarec;/∗ Elliptical Arc 3 ∗/
Pugdp0010rec3ugdp10_datarec;/∗ Elliptical Arc Close 3 ∗/
Pugdp0011rec3ugdp11_datarec;/∗ Annotation Ellipse 3 ∗/
Pugdp0012rec3ugdp12_datarec;/∗ Annotation Elliptical Arc 3 ∗/
Pugdp0013rec3ugdp13_datarec;/∗ Annotation Elliptical Arc Close 3 ∗/
} Pgdprec3;

FORTRAN Input Parameters

NNumber of points passed in the PXA, PYA, and PZA arrays.

PXAAn array of N real values containing x coordinates in MC.

PYAAn array of N real values containing y coordinates in MC.

PZAAn array of N real values containing z coordinates in MC.

PRIMID
An integer specifying the GENERALIZED DRAWING PRIMITIVE 3 to be performed. Predefined values defined in phigs77.h are:

-1PUGDPPLS3Polyline Set 3
-2PUGDPCIRC3Circle 3
-3PUGDPCIRCARC3Circular Arc 3
-4PUGDPCIRCARCCL3Circular Arc Close 3
-5PUGDPACIRC3Annotation Circle 3
-6PUGDPACIRCARC3Annotation Circular Arc 3
-7PUGDPACIRCARCCL3Annotation Circular Arc Close 3
-8PUGDPELLP3Ellipse 3
-9PUGDPELLPARC3Elliptical Arc 3
-10PUGDPELLPARCCL3Elliptical Arc Close 3
-11PUGDPAELLP3Annotation Ellipse 3
-12PUGDPAELLPARC3Annotation Elliptical Arc 3
-13PUGDPAELLPARCCL3Annotation Elliptical Arc Close 3

LDRThe dimension of DATREC (returned by the PACK DATA RECORD subroutine).

DATREC
A GDP 3 data record packed by the PACK DATA RECORD subroutine containing the information needed to perform the function specified by PRIMID.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum