PWAIT(3g) — Subroutines
Name
PWAIT − Attempts to remove the oldest report from the input queue.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PWAIT (TOUT, WKID, ICL, IDNR)
Argument Data Type Access Description
---------------------------------------------------------------------------
TOUT Real Read Time out in seconds
WKID Integer Write Workstation identifier
ICL Integer Write Input class
IDNR Integer Write Logical input device number
---------------------------------------------------------------------------
Constants
Defined Argument Constant Description
---------------------------------------------------------------------------
ICL PNCLAS No input class
PLOCAT Locator input class
PSTROK Stroke input class
PVALUA Valuator input class
PCHOIC Choice input class
PPICK Pick input class
PSTRIN String input class
---------------------------------------------------------------------------
Description
PWAIT 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
PCLWK
PFLUSH
PGTCH
PGTLC
PGTLC3
PGTPK
PGTST
PGTSK
PGTSK3
PGTVL
PQIQOV
PQSIM
PSCHM
PSLCM
PSPKM
PSSTM
PSSKM
PSVLM