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

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


zwritemask(3G)							zwritemask(3G)

NAME    [Toc]    [Back]

     zwritemask	- specifies a write mask for the z-buffer of the current

C SPECIFICATION    [Toc]    [Back]

     void zwritemask(mask)
     unsigned long mask;

PARAMETERS    [Toc]    [Back]

     mask   expects a mask indicating which z-buffer bitplanes are read	only
	    and	which can be written to.  Z-buffer bitplanes that correspond
	    to zeros in	the mask are read only.	 Z-buffer bitplanes that
	    correspond to ones in the mask can be written.

DESCRIPTION    [Toc]    [Back]

     zwritemask	specifies a mask used to control which z-buffer	bitplanes are
     written, and which	are read only.	A separate mask	is maintained by each
     of	the framebuffers, normal, popup, overlay, and underlay.	 The mask
     affects both writes to the	z-buffer that are the result of	z-buffer pixel
     operation,	and writes resulting from zclear operation.

     zwritemask	is ignored while drawing directly to the z-buffer, as when
     zdraw is TRUE. In this case the current writemask applies to the z-buffer
     as	well as	to the color bitplanes.

     zwritemask	is initialized when a window is	created, and when gconfig is
     called, to	enable all z-buffer bitplanes.

SEE ALSO    [Toc]    [Back]

     gconfig, wmpack, writemask, zbuffer, zdraw

NOTES    [Toc]    [Back]

     Currently z-buffer	operation is supported only in the normal framebuffer.
     To	insure compatibility with future releases of the GL, make calls	to
     zwritemask	only while draw	mode is	NORMALDRAW.

BUGS    [Toc]    [Back]

     This subroutine does not function on IRIS-4D B or G models.

     IRIS-4D GT	and GTX	models,	RealityEngine models, and the Personal Iris,
     currently support a subset	of z write mask	functionality.	Specifically,
     zwritemask	either enables or disables the writing of all z-buffer
     bitplanes.	The mask passed	to zwritemask will disable z-buffer writes if
     it	is zero; otherwise all z-buffer	bitplanes are written.	To assure
     upward compatibility with the IRIS-4D VGX and other future	models,	call
     zwritemask	with mask equal	to either 0 or 0xFFFFFFFF when all-or-nothing
     update is desired.

     On	Impact and Infinite Reality individual z bitplanes are not maskable.

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
zfunction IRIX specifies the function used for z-buffer comparison by the current framebuffer
zclear IRIX initializes the z-buffer of the current framebuffer
zbuffer IRIX enable or disable z-buffer operation in the current framebuffer
msmask IRIX specifies a multisample mask
multisample IRIX specifies the use of the multisample buffer
mssize IRIX specifies multisample buffer configuration
sigsetmask OpenBSD set current signal mask
sigprocmask Tru64 Set the current signal mask
sigsetmask HP-UX set current signal mask
sigsetmask NetBSD set current signal mask
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service