Name

pawait_event − Attempts to remove the oldest report from the input queue. 

 
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void pawait_event (
  Pfloat       timeout,    /∗ (I) Time-out in seconds ∗/
  Pint        ∗wsid,       /∗ (O) Workstation identifier ∗/
  Pin_class   ∗class,      /∗ (O) Device class ∗/
  Pint        ∗dev_num     /∗ (O) Logical input device number
)

Data Structures

typedef enum {
    PIN_NONE,      /∗ no input class ∗/
    PIN_LOC,       /∗ locator input class ∗/
    PIN_STROKE,    /∗ stroke input class ∗/
    PIN_VAL,       /∗ valuator input class ∗/
    PIN_CHOICE,    /∗ choice input class ∗/
    PIN_PICK,      /∗ pick input class ∗/
    PIN_STRING     /∗ string input class ∗/
} Pin_class;

Description

pawait_event searches the time-ordered input queue and attempts to remove the oldest report from the queue.  If the queue contains a report, Digital PHIGS writes the input data to the current event report entry in the PHIGS state list, and returns the workstation identifier, input class, and device number of the logical input device that entered the event report in the queue. 

  If the queue is empty, Digital PHIGS suspends execution of the program until one of the following occurs:

•An event appears in the input queue. 

•The time-out period expires. 

If you specify 0.0 as the time-out, Digital PHIGS checks the queue immediately and does not suspend execution of the program. 

You can use the input class to determine which of the GET input functions to call to remove the input from the current event report entry. 

See Also

pclose_ws
pflush_events
pget_choice
pget_loc
pget_loc3
pget_pick
pget_string
pget_stroke
pget_stroke3
pget_val
pinq_in_overf
pinq_more_simult_events
pset_choice_mode
pset_loc_mode
pset_pick_mode
pset_string_mode
pset_stroke_mode
pset_val_mode