NAME

GENERALIZED DRAWING PRIMITIVE 3 − create 3D GDP elements

SYNOPSIS

C Syntax

void
pgdp3 ( point_list, gdp3_id, gdp_data )
Ppoint_list3∗point_list;array of points
Pintgdp3_id;gdp function identifier
Pgdp_data3∗gdp_data;gdp data record

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

GENERALIZED DRAWING PRIMITIVE 3 creates an implementation dependent drawing primitive.  There are no GDPs implemented in the PEX-SI graphics library. 

C Input Parameters

point_list
A pointer to a structure containing a list of x and y values in Modelling Coordinates (MC).  Ppoint_list3 is defined in phigs.h as:

typedef struct {
Pintnum_points;/∗ number of Ppoints in the list ∗/
Ppoint3∗points;/∗ list of points ∗/
} Ppoint_list3;

Ppoint3 is defined in phigs.h as follows:

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

gdp3_id
The identifier of the generalized drawing primitive to insert. There are no predefined GDPs. 

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

typdef union {
struct {
Pintunused;
}gdp3_r1;
Pdataunsupp;/∗ unsupported GDP data record ∗/
} Pgdp_data3;/∗ implementation dependent ∗/

Pdata is defined in phigs.h as:

typdef struct {
size_tsize;/∗ size of data ∗/
char∗data;/∗ pointer to data ∗/
} Pdata;

Execution

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

ERRORS

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

September 02, 1992