PEXGetWorkstationViewRep(3) — Subroutines

Name

PEXGetWorkstationViewRep - Get Workstation View Representation

Synopsis

Status PEXGetWorkstationViewRep(Display ∗display, PEXWorkstation workstation, unsigned int index, int ∗update_return, PEXViewRep ∗req_view_return, PEXViewRep ∗cur_view_return)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call.

workstationThe resource identifier of the workstation.

indexThe view table index.

update_return
Returns the update status of the view table index.

req_view_return
Returns the requested value of the view table index.

cur_view_return
Returns the current value of the view table index.

Returns

Zero if unsuccessful, non-zero otherwise.

Description

The function returns the update state, and the requested and current values for the specified view index of the specified workstation. The update will be PEXPending if a view change has been requested but not established; otherwise it will be PEXNotPending. If the specified view index is not defined, an error will be generated and the contents of the reply parameters will be undefined.

Data Structures

typedef XID             PEXWorkstation;
typedef struct {
    PEXTableIndex       index;
    unsigned short      reserved;
    PEXViewEntry        view;
} PEXViewRep;
typedef unsigned short PEXTableIndex;
typedef struct {
    unsigned short      clip_flags;
    unsigned short      reserved;
    PEXNPCSubVolume     clip_limits;
    PEXMatrix           orientation;
    PEXMatrix           mapping;
} PEXViewEntry;
typedef struct {
    PEXCoord            min;
    PEXCoord            max;
} PEXNPCSubVolume;
typedef struct {
    float               x;
    float               y;
    float               z;
} PEXCoord;
typedef float           PEXMatrix[4][4];

Errors

BadPEXWorkstation
The specified workstation resource identifier is invalid.

BadValueThe specified view table entry is not defined.

Museum