pgdp3(3g) — Subroutines

Name

pgdp3 − Generates a generalized drawing primitive (GDP) 3 of the specified type.

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

ISO C Syntax

void pgdp (
const Ppoint_list     ∗point_list, /∗ (I) List of points ∗/
Pint                   gdp_id,      /∗ (I) GDP identifier ∗/
const Pgdp_data       ∗gdp_data     /∗ (I) GDP data record ∗/
)

Data Structures

typedef struct {
    Pint      num_points; /∗ number of Ppoints in the list ∗/
    Ppoint   ∗points;      /∗ list of points ∗/
} Ppoint_list;
    typedef struct {
        Pfloat   x;   /∗ x coordinate ∗/
        Pfloat   y;   /∗ y coordinate ∗/
    } Ppoint;
typedef union {
    struct Pgdp_r1 {
        int    impl_dep;    /∗ registration-dependent ∗/
    } gdp_r1;
    Pdata      unsupp;      /∗ unsupported GDP data record ∗/
    int        impl_dep;    /∗ implementation-defined ∗/
} Pgdp_data;
    typedef struct {
        size_t   size;   /∗ size of data ∗/
        void    ∗data;   /∗ pointer to data ∗/
    } Pdata;

ISO Fortran Syntax

PGDP (N, PXA, PYA, PRIMID, LDR, DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
N            Integer        Input     Number of points (greater than or
                                      equal to 0)
PXA(∗),      Real           Input     Coordinates of the points, in
PYA(∗)                                modeling coordinates
PRIMID       Integer        Input     GDP identifier
LDR          Integer        Input     Dimension of the data record array
DATREC(LDR) Character ∗80 Read      Data record
---------------------------------------------------------------------------

Description

pgdp3 generates a generalized drawing primitive (GDP) of the type you specify, using specified points and any additional information contained in a data record. A GDP is a device-specific primitive that is not supported as a primitive by PHIGS.

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new generalized drawing primitive 3 element.

The definition of the particular GDP primitive specifies which sets of attributes the workstation uses to generate the primitive.

Depending on the workstation-dependent requirements of the GDP, Digital PHIGS may or may not generate the primitive if certain points fall outside the current workstation window. If a workstation cannot generate a GDP because points fall outside of the current workstation window, Digital PHIGS generates an error message.

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element.

Digital PHIGS Version 4.1 does not support this function.