.\"##
.\" $XConsortium: p308,v 5.2 94/04/17 20:58:01 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.
.TH "SET EDGE FLAG" 3P "29 February 1991"
.SH NAME
SET EDGE FLAG \- create a structure element to set the current edge flag
attribute
.IX "Aspect Source Flags" "SET EDGE FLAG"
.IX "Attributes, Edge Attributes" "SET EDGE FLAG"
.IX "Edge Attributes" "SET EDGE FLAG"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_edge_flag ( edge_flag )
Pedge_flag	edge_flag;	\fIedge flag\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET EDGE FLAG\s+2 creates a structure element
containing a value for the current edge flag attribute.  
When the current edge flag Aspect Source Flag (\s-2ASF\s+2)
is set to \s-2INDIVIDUAL\s+2,
this attribute defines whether or not edges are drawn on
the following output primitives:
.RS
.LP
\(bu
.SM "FILL AREA SET"
.LP
\(bu
.SM "FILL AREA SET 3"
.LP
\(bu
.SM "FILL AREA SET 3 WITH DATA"
.LP
\(bu
.SM "GENERALIZED DRAWING PRIMITIVE (\fIFill Area Set Primitives\fP)"
.LP
\(bu
.SM "GENERALIZED DRAWING PRIMITIVE 3 (\fIFill Area Set Primitives\fP)"
.LP
\(bu
.SM "SET OF FILL AREA SET 3 WITH DATA"
.LP
\(bu
.SM "NON-UNIFORM B-SPLINE SURFACE"
.LP
\(bu
.SM "QUADRILATERAL MESH 3 WITH DATA"
.LP
\(bu
.SM "TRIANGLE STRIP 3 WITH DATA"
.RE
.LP
.SS C Input Parameter
.IP \fIedge_flag\fP
The edge flag is an enumerated type defined in phigs.h to have
the following values:
.nf
.ta .5i +.8i +1.5i +1i
.sp
PEDGE_OFF	\fIOff\fP
PEDGE_ON	\fIOn\fP
.sp
.fi
.SS Execution
If the current edit mode is \s-2INSERT\s+2 when \s-2SET EDGE FLAG\s+2 is
called, a \s-2SET EDGE FLAG\s+2 element is inserted into the currently open
structure after the element pointed to by the current \fIelement pointer\fP.  If
the edit mode is \s-2REPLACE\s+2, the new \s-2SET EDGE FLAG\s+2 element
replaces the element pointed to by the element pointer.  In either case, the
element pointer is updated to point to the new element.  
.LP
When the \s-2SET EDGE FLAG\s+2 element is traversed, the current edge flag
entry in the \s-2PHIGS\s+2 traversal state list is set to edge flag.
When the edge flag \s-2ASF\s+2 is set to
\s-2INDIVIDUAL\s+2 the edges of the fill area set output primitives
that follow in the structure network
are drawn when edge flag is On, and
are not drawn (the default) when edge flag is Off.
.LP
When the current edge flag \s-2ASF\s+2 is set to \s-2BUNDLED\s+2,
the edge flag setting is taken from the
workstation's representation indicated by the current edge index.  
In this case, the edge flag set with \s-2SET EDGE FLAG\s+2 has no effect.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "SET INDIVIDUAL ASF (3P)"
.SM "SET EDGE REPRESENTATION (3P)"
.SM "FILL AREA SET (3P)"
.SM "FILL AREA SET 3 (3P)"
.SM "FILL AREA SET 3 WITH DATA (3P+)"
.SM "SET OF FILL AREA SET 3 WITH DATA (3P+)"
.SM "NON-UNIFORM B-SPLINE SURFACE (3P+)"
.SM "QUADRILATERAL MESH 3 WITH DATA (3P+)"
.SM "TRIANGLE STRIP 3 WITH DATA (3P+)"
.fi
