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

finish Subroutine

Purpose

Blocks until all buffers and first-in-first-out (FIFOs) queues are empty.

Library

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void finish

FORTRAN Syntax

SUBROUTINE FINISH

Description

The finish subroutine blocks until all buffers and FIFOs that buffer up GL drawing commands are empty. The finish subroutine does not return to the user application until all drawings sent to a window are displayed on the screen.

The amount of time that elapses before the finish subroutine returns can be highly variable. This timeframe depends on the depth of the FIFO, the nature of its contents (for example, lines or polygons), and the performance of the graphics adapter. Excessive use of the finish subroutine may adversely impact overall system performance.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000.

GL implementations are not consistent in the use of buffers and/or FIFOs. The following list illustratrates the variety of ways FIFOs or buffers can be used in a GL implementation:

Certain events, such as switching drawing from one window to another or using some get functions, can cause buffers and FIFOs to be drained.

The POWER Gt4 and POWER Gt4x adapters implement one logical FIFO per window. The finish subroutine forces the draining of only the FIFO associated with the current window.

The following adapters and processors have one graphics command FIFO for the entire system:

This FIFO is automatically drained whenever a switch to a different window is initiated. That is, drawing in one window, and then drawing in another, implicitly drains the FIFO.

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/X11/Xlib.h Contains C language constant and variable type definitions for version X11 of Enhanced X-Windows.

Related Information

Using Enhanced X-Windows Calls with GL Subroutines in GL3.2 Version 4 for AIX: Programming Concepts.

Enhanced X-Windows and GL Interoperability in GL3.2 Version 4 for AIX: Programming Concepts


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