INQUIRE MORE SIMULTANEOUS EVENTS(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE MORE SIMULTANEOUS EVENTS − see if there are more simultaneous events on the input queue

SYNOPSIS

C Syntax

void
pinq_more_simult_events ( error_ind, events )
Pint∗error_ind;OUT error indicator
Pmore_simult_events∗events; OUT simultaneous events

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Use INQUIRE MORE SIMULTANEOUS EVENTS to determine if there are more simultaneous events on the input queue. Simultaneous events are generated when two or more input devices in EVENT mode share a trigger and that trigger is fired. One event for each device sharing the trigger is generated in such a case, and the events are marked as simultaneous.

C Input Parameters

error_ind
A pointer to the error indicator. If an error is detected, the number of the error is stored in this variable and the contents of events is undefined.

eventsA pointer to a Pmore_simult_events type defined in phigs.h as:

typedef enum {
PSIMULT_NO_MORE,
PSIMULT_MORE
} Pmore_simult_events;

Execution

INQUIRE MORE SIMULTANEOUS EVENTS examines the more simultaneous events field in the PHIGS state list to see if the next event is the next in a group of simultaneous events. When the first event in a group of simultaneous events reaches the front of the input event queue and is removed by AWAIT EVENT, the more simultaneous events field is set to MORE. When the last event in the group is removed from the event queue the value is set to NO MORE.

Simultaneous events are generated by input devices that share the same trigger. If these input devices are in EVENT mode and the trigger is fired, then an input event will be enqueued for each of the devices and each will be marked as one in a group of simultaneous events. The order in which they are enqueued is undefined. If there is not enough space on the input queue to hold this entire group of events, then none of them will be enqueued and one of them will be placed in the identification of one of the logical input devices that caused an overflow field in the PHIGS error state list.

PEX-SI has many devices that can potentially share triggers. See the corresponding INITIALIZE input class functions for a description of the triggers each device uses.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum