graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPGWIN - Get Window

GPGWIN (ilen, olen, data)

Purpose

Use GPGWIN to retrieve the workstation event data from the current event report. The event is not removed from the current event report until the next invocation of the Await Event (GPAWEV) subroutine.

The data returned in the data parameter is defined by the event class of the current event. The event class is returned as an output parameter on GPAWEV, or can be obtained using the Inquire Current Event (GPQCEV) subroutine.

Parameters

ilen -- specified by user, fullword integer

The length of the data area in bytes provided by the application to return the window event data (>=0)

olen -- returned by the graPHIGS API, fullword integer

The length, in bytes, of the window event data actually returned.

data -- returned by the graPHIGS API, variable-length data

Window event data. The format and contents of the returned data depends on the class of the window event. The supported data are:

Event Class 105 - Window Resize Notification Event

               -------------------
    WORDS 1-3  |  display size   |  3 floating-point numbers
               |-----------------|
    WORDS 4-6  |   addr units    |  3 fullword integers
               -------------------

display size - 3 floating-point numbers

Window size in device coordinates.

addr units - 3 fullword integers

Window size in address units. This event is enabled by using the Escape (GPES) subroutine with function 1009 (Window Resize Notification Control).

Event Class 106 - Window Expose Event

               -------------------
       WORD 1  |      vflags     |  0 - 31 bits
               |-----------------|
       WORD 2  |      vflags     | 32 - 63 bits
               -------------------

vflags - Variable length byte string

View expose flags. There is one flag bit in the byte string for each view on the workstation. The view index can be used to directly access the corresponding flag bit. The maximum number of views supported on workstations is currently 64. Therefore, the maximum number of bytes returned is currently 8 bytes.

Each flag bit can have one of the following values:

0 - the view is not effected by the expose event.

1 - the view is effected by the expose event.

This event is enabled by using the Escape (GPES) subroutine with function 1011 (Window Exposure Notification Control).

Error Codes

150: GET FUNCTION DOES NOT MATCH CURRENT EVENT CLASS
505: LENGTH OF RETURN ARRAY < ZERO
519: NO CURRENT EVENT REPORT AVAILABLE

Related Subroutines

GPES: Escape

RCP code

201336073 (X'0C002509')