gRGBmask Subroutine

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

gRGBmask Subroutine

Purpose

Returns the current RGB writemask.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void gRGBmask
(Int16 *redmask, Int16 *greenmask, Int16 *bluemask)

FORTRAN Syntax

SUBROUTINE GRGBMA(redmask, greenmask, bluemask)
INTEGER*2 redmask, greenmask, bluemask

Description

The gRGBmask subroutine gets the current RGB writemask as three 8-bit masks and copies them into the parameters. The subroutine places masks in the low order 8-bits of the locations redmask, greenmask, and bluemask. The system must be in RGB mode when this routine executes.

This subroutine is intended for use in RGB mode only. To get the writemask when in color map mode, use the getwritemask subroutine.

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

Parameters

redmask	Specifies the pointer to the location into which the system is to copy the current red writemask value.
greenmask	Specifies the pointer to the location into which the system is to copy the current green writemask value.
bluemask	Specifies the pointer to the location into which the system is to copy the current blue writemask value.

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

Returning the current writemask with the getwritemask subroutine.

Granting write access to a subset of available bitplanes with the RGBwritemask subroutine.

Specifying the RGBA writemask with a single packed integer with the wmpack subroutine.

Granting write permission to available bitplanes with the writemask subroutine.

Configuring the Frame Buffer, Querying the System, and Working in Color Map and RGB Modes.

Writemasks and Logical Operations and Working in Color Map and RGB Modes.