.\"##
.\" $XConsortium: p319,v 5.2 94/04/17 20:58:08 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.\" 1. Substitute PHIGS Extension function name (in CAPS) for "PNAME" in line be.\"low:
.ds pN SET FACE CULLING MODE
.TH "\*(pN" 3P+ "29 February 1991"
.SH NAME
\*(pN \-
create a structure element to set the face culling mode
.IX "PHIGS Extension Functions" "\*(pN"
.IX "Filled Area Interior Attributes" "SET FACE CULLING MODE"
.IX "Attributes, Filled Area Interior Attributes" "SET FACE CULLING MODE"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
.\" 6. Insert C syntax below
.nf
void
pset_face_cull_mode ( mode )
Pcull_mode	mode;	\fIculling mode\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET FACE CULLING MODE\s+2 creates a structure element
to set the face culling mode. The attribute face culling mode defines 
control over the visibility of front and back facing portions of area 
defining primitives. See \s-2SET FACE DISTINGUISHING MODE (3P+)\s+2 for details 
on front and back face determination.
.SS C Input Parameters
.IP \fImode\fP
A pointer to a Pcull_mode structure. A Pcull_mode structure is
defined as:
.sp .4
.nf
.ta .5i
typedef enum {
.sp .2
	PCULL_NONE,
	PCULL_BACKFACE,
	PCULL_FRONTFACE
.sp .2
} Pcull_mode;
.fi
.SS Execution
Depending on the edit mode, a \s-2SET FACE CULLING MODE\s+2
element is inserted into the open structure after the element pointer
or replaces the element pointed at by the element pointer. The element
pointer is then updated to point to this \s-2SET FACE CULLING MODE\s+2
element.
.LP
When face culling mode is \fINone\fP, both front and back facing
portions are visible. When face culling mode is \fIBackface\fP,
back facing portions are invisible. When it is \fIFrontface\fP,
front facing portions are invisible.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "SET FACE DISTINGUISHING MODE (3P+)"
.fi
