getscrmask Subroutine

GL3.2 for AIX: Graphics Library (GL) Technical Reference

getscrmask Subroutine

Purpose

Returns the current screenmask.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void getscrmask
(Screencoord *left, Screencoord *right,
Screencoord *bottom, Screencoord *top)

FORTRAN Syntax

SUBROUTINE GETSCR(left, right, bottom, top)
INTEGER*2 left, right, bottom, top

Description

The getscrmask subroutine returns the dimensions of the current screenmask (the top of the screenmask stack) and copies these dimensions to the location variables specified as parameters. The left, right, bottom, top parameters are the addresses of four memory locations assigned the left, right bottom, and top coordinates of the screenmask.

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

Parameters

left	Specifies the memory location into which the system copies the x coordinate (in pixels) of the left side of the screenmask.
right	Specifies the memory location into which the system copies the x coordinate (in pixels) of the right side of the screenmask.
bottom	Specifies the memory location into which the system copies the y coordinate (in pixels) of the bottom side of the screenmask.
top	Specifies the memory location into which the system copies the y coordinate (in pixels) of the top side of the screenmask.

Example

The example C language program prompt.c uses the getscrmask subroutine to get the current screenmask so that it can be restored later.

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.

Related Information

Pushing the viewport onto the viewport stack with the pushviewport subroutine.

Popping the viewport stack with the popviewport subroutine.

Defining a rectangular 2-D clipping mask with the scrmask subroutine.

AIX Graphics Library Overview, Querying the System, and Using Viewports and Screenmasks.