NAME

GENERALIZED DRAWING PRIMITIVE − create 2D GDP elements

SYNOPSIS

C Syntax

void
pgdp ( point_list, gdp_id, gdp_data )
Ppoint_list∗point_list;array of points
Pintgdp_id;gdp function identifier
Pgdp_data∗gdp_data;data record pointer

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

GENERALIZED DRAWING PRIMITIVE 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_list is defined in phigs.h as:

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

Ppoint is defined in phigs.h as follows:

typedef struct {
Pfloatx;/∗ x coordinate ∗/
Pfloaty;/∗ y coordinate ∗/
} Ppoint;

gdp_id
The identifier of the GENERALIZED DRAWING PRIMITIVE to insert.  There are no predefined GDPs. 

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

typdef union {
struct {
Pintunused;
}gdp_r1;
Pdataunsupp;/∗ unsupported GDP data record ∗/
} Pgdp_data;/∗ 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, the structure element created by the GENERALIZED DRAWING PRIMITIVE 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 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. 

ERRORS

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

September 02, 1992