*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> standard/mssize (3)              


mssize(3G)							    mssize(3G)

NAME    [Toc]    [Back]

     mssize - specifies	multisample buffer configuration

C SPECIFICATION    [Toc]    [Back]

     void mssize(long samples, long zsize, long	ssize)

PARAMETERS    [Toc]    [Back]

     samples   is the number of	samples	to be stored at	each framebuffer pixel
	       location. The default is	zero.

     zsize     is the number of	bits per depth component desired in the
	       multisample buffer.

     ssize     is the number of	bits per stencil field desired in the
	       multisample buffer.

DESCRIPTION    [Toc]    [Back]

     By	default	the normal framebuffer is configured to	store one sample at
     each pixel	location.  This	sample can include one,	two, or	four color
     buffers, a	single depth value, and	a stencil value.  mssize allows
     configuration of the normal framebuffer to	store many samples at each
     pixel location.  Because the samples specified by mssize are distinct
     from the single sample that is normally stored, the default mssize	of
     zero corresponds to the default single-sample configuration.

     mssize takes effect when gconfig is called.  The requested	sample count
     and multisample buffer sizes are considered along with the	other gconfig
     requests, such as double buffering	and RGB	mode.  Multisample red,	green,
     blue, and alpha component sizes are made identical	to those in the	normal

     For example, consider the following request:


     If	this request is	honored, the framebuffer will be configured with 2 RGB
     color buffers (front and back) and	4 separate samples each	consisting of
     a single RGB color, a 32-bit depth	value, and a 1-bit stencil value.
     Note that no depth	or stencil bits	are directly associated	with the front
     and back color buffers, because none were requested.

     Likewise, the request:

									Page 1

mssize(3G)							    mssize(3G)


     if	granted, results in the	same multisample configuration,	but includes a
     regular zbuffer and a stencil buffer.

     The samples, zsize	and ssize granted may not be exactly what was
     requested.	 After a call to mssize	and gconfig call getgconfig to
     determine how the framebuffer was actually	configured.

     Just as the default single	sample at each framebuffer pixel is considered
     to	be located at the center of that pixel,	the samples multisamples each
     have a fixed location near	the corresponding pixel	center.	 These
     locations are chosen by the GL to provide good area sampling.

SEE ALSO    [Toc]    [Back]

     gconfig, getgconfig, msalpha, msmask, mspattern, mssize, multisample,
     RGBsize, stensize,	zbsize

NOTES    [Toc]    [Back]

     This routine is available only in immediate mode.

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

     Although separate specifications are allowed for normal and multisample
     z-buffer sizes, and for normal and	multisample stencil buffer sizes,
     implementations need not support differing	non-zero buffer	sizes.

     The IRIS-4D RealityEngine models support at least the following values
     for samples:  0, 4, 8, 16 with a zsize of 0, 24 or	32 and with an ssize
     of	0 through 8.

BUGS    [Toc]    [Back]

     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

     On	the IRIS-4D RealityEngine models the framebuffer cannot	be configured
     to	consist	of more	than 1 stencil plane in	the multisample	buffer,	and 8
     color planes for each of the RGB color buffers simultaneously.

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
multisample IRIX specifies the use of the multisample buffer
msmask IRIX specifies a multisample mask
mspattern IRIX specifies a multisample sample pattern
msalpha IRIX specifies treatment of alpha values during multisample rendering
gltagsamplebuffersgix IRIX mark all samples of a multisample buffer
zfunction IRIX specifies the function used for z-buffer comparison by the current framebuffer
zwritemask IRIX specifies a write mask for the z-buffer of the current framebuffer
zbsize IRIX specifies the number of bit planes desired to comprise the Z buffer
getgconfig IRIX gets the size of a buffer or a state in the current buffer configuration
glxgetfbconfigfromvisualsgix IRIX return frame buffer configuration that is associated with visual
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service