Name

pescape − Invokes the specified escape function. 
Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

void pescape (
  Pint                     esc_id,    /∗ (I) Escape function identifier. ∗/
  const Pescape_in_data   ∗in_data,   /∗ (I) Input data for the
                                             function. ∗/
  Pstore                   store,     /∗ (I) Handle to store the object.
                                             store manages the memory
                                             referenced by ∗out_data. ∗/
  Pescape_out_data       ∗∗out_data   /∗ (O) Output data of the function.
                                             If the function detects an
                                             error, this is NULL. ∗/
)

See Constants for the list of escape identifiers.

Data Structures

typedef union {
    Pescape_in_u1   escape_in_u1;
    int             impl_dep;        /∗ implementation-defined ∗/
} Pescape_in_data;
    typedef struct {
        Pint      nints;              /∗ number of integers ∗/
        Pint      nfloats;            /∗ number of floats ∗/
        Pint      nstrings;           /∗ number of strings ∗/
        Pint     ∗int_array;          /∗ pointer to the integer array ∗/
        Pfloat   ∗float_array;        /∗ pointer to the float array ∗/
        Pint     ∗str_len_array;      /∗ pointer to the string length
                                         array ∗/
        char    ∗∗str_ptr_array;      /∗ pointer to the string pointer
                                         array ∗/
        Pint      npointers;          /∗ number of generic pointers ∗/
        char    ∗∗ptr_ptr_array;      /∗ pointer to the generic pointer
                                         array ∗/
        Pint      nlongs;             /∗ number of longs ∗/
        long     ∗long_array;         /∗ pointer to the long array ∗/
        int       impl_dep;           /∗ registration-dependent ∗/
    } Pescape_in_u1;
typedef void ∗Pstore;
typedef union {
    Pescape_out_u1  escape_out_u1;
    int             impl_dep;          /∗ implementation-defined ∗/
} Pescape_out_data;
    typedef struct {
        Pint      nints;              /∗ number of integers ∗/
        Pint      nfloats;            /∗ number of floats ∗/
        Pint      nstrings;           /∗ number of strings ∗/
        Pint     ∗int_array;          /∗ pointer to the integer array ∗/
        Pfloat   ∗float_array;        /∗ pointer to the float array ∗/
        Pint     ∗str_len_array;      /∗ pointer to the string length
                                         array ∗/
        char    ∗∗str_ptr_array;      /∗ pointer to the string pointer
                                         array ∗/
        Pint      npointers;          /∗ number of generic pointers ∗/
        char    ∗∗ptr_ptr_array;      /∗ pointer to the generic pointer
                                         array ∗/
        Pint      nlongs;             /∗ number of longs ∗/
        long     ∗long_array;         /∗ pointer to the long array ∗/
        int       impl_dep;           /∗ registration-dependent ∗/
    } Pescape_out_u1;

Description

pescape invokes the specified escape function.  The form of the escape data record is function-dependent. 

This function provides a method for individual Digital PHIGS implementations to access capabilities of a specific workstation that are not fully utilized by other functions. The form of the escape data record is function-dependent.  Each of the device specific chapters in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS explains the requirements for the data records.  Note that a specific workstation type will support a subset of available escape functions.  Use the phigs_predef sample program to determine which escape functions your workstation supports. 

See Also

pcreate_store
pdel_store