RGBsize(3G)							   RGBsize(3G)

NAME    [Toc]    [Back]

     RGBsize - specifies the number of bit planes desired to comprise each
     single-color component buffer.

C SPECIFICATION    [Toc]    [Back]

     void RGBsize(long planes)

PARAMETERS    [Toc]    [Back]

     planes   is the number of bit planes requested to be configured as	color
	      planes for each single-color component.  Only positive values
	      are accepted.  The default is machine dependent, usually 8 or
	      12.

DESCRIPTION    [Toc]    [Back]

     RGBsize specifies how may bit planes are requested	to be configured as
     planes for	each one of the	red, green, blue, and alpha color component.
     The constraints on	planes are machine dependent.  Call getgdesc() with
     the appropriate parameter to determine the	maximum	number of bit planes
     available for color buffers operation.

     RGBsize takes effect only after gconfig has been called.  The number of
     bit planes	granted	for the	color buffers may not be exactly what was
     requested.	 Call getgconfig with the appropriate parameter	to determine
     how many bit planes were configured as color planes.

     Since RGBA	color bit planes are available only in the normal framebuffer,
     RGBsize should be called only while draw mode is NORMALDRAW.

SEE ALSO    [Toc]    [Back]

     gconfig, getgconfig, getgdesc

NOTES    [Toc]    [Back]

     This routine is available only in immediate mode.

     Since most	machines support only a	finite set of RGBA color buffer	sizes,
     planes is rounded to the nearest supported	size.

     IRIS-4D G,	GT, GTX, VGX, and VGXT models, the Personal Iris, Indy,	Indigo
     Entry, XL,	XS, XS24, XZ, Elan and Extreme systems do not support RGBsize.

     The IRIS-4D RealityEngine models support only values of 8 or 12 planes.

BUGS    [Toc]    [Back]

     On	the IRIS-4D RealityEngine models when the number of planes configured
     for each single-color component is	8, the framebuffer consist of no alpha
     bit planes.

     On	the IRIS-4D RealityEngine models the framebuffer cannot	be configured
     to	consist	of 32 Z	buffer planes (or 32 depth planes in the multisample
     buffer) and 8 color planes	for each of the	RGB color buffers
     simultaneously.




									Page 1






RGBsize(3G)							   RGBsize(3G)



     On	Impact and Infinite reality RGBsize chooses the	deepest	visual whose
     alpha depth is as deep as Red, Green, and Blue.  In order to get more
     depth of RGB, while possibly sacrificing Alpha depth set glcompat
     GLC_NODESTALPHA to	TRUE.


									PPPPaaaaggggeeee 2222