[ Previous | Next | Contents | Glossary | Home | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

blkqread Subroutine

Purpose

Reads multiple entries from the event queue.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

Int32 blkqread(Int16 *data, Int16 number)

FORTRAN Syntax

INTEGER*4 FUNCTION BLKQRE(data, number)
INTEGER*2 data(number)
INTEGER*4 number
Note: For FORTRAN users, this function accepts long integer parameters (INTEGER*4) when invoked from a FORTRAN program, although it accepts short integers when invoked from a C program. The C and FORTRAN syntax shown here reflect this difference.

Description

The blkqread subroutine reads multiple entries from the event queue and stores them in the buffer designated by the data parameter.

The returned value of the function is the number of queue entries actually read into the data buffer. This function fills the data buffer alternatively with device numbers and device values. Thus, the number of entries read is never more than the value or the number parameter divided by two.

Note: This subroutine cannot be used to add to a display list.

Parameters

data Specifies a pointer to the buffer that is to receive the queue information.
number Specifies the length of the buffer.

Return Value

The number of 16-bit words of data actually read into the buffer pointed to by the data parameter. This number is twice the number of complete queue entries read because each queue entry consists of two 16-bit words.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h Contains FORTRAN constant and variable type definitions for GL.
/usr/include/gl/device.h Contains C language constant and variable type definitions for GL.
/usr/include/gl/fdevice.h Contains FORTRAN constant and variable type definitions for GL.

Related Information

Enabling an input device for event queuing with the qdevice subroutine.

Reading the first entry in the event queue with the qread subroutine.

AIX Graphics Library Overview, Controlling Queues and Devices.


[ Previous | Next | Contents | Glossary | Home | Search ]