.\"##
.\" $XConsortium: p312,v 5.2 94/04/17 20:58:03 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 EDGETYPE" 3P "29 February 1991"
.SH NAME
SET EDGETYPE \- create a structure element to set the current edgetype attribute
.IX "Aspect Source Flags" "SET EDGETYPE"
.IX "Attributes, Edge Attributes" "SET EDGETYPE"
.IX "Edge Attributes" "SET EDGETYPE"
.IX "Patterned Lines" "SET EDGETYPE"
.IX "Textured Lines" "SET EDGETYPE"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_edgetype ( edgetype )
Pint	edgetype;	\fIedgetype\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET EDGETYPE\s+2 creates a structure element
structure containing a value for the current edgetype attribute.
.LP
When the current edgetype Aspect Source Flag (\s-2ASF\s+2)
is set to \s-2INDIVIDUAL\s+2,
this attribute defines the edgetype to be applied
to 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 "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
.SS C Input Parameter
.IP \fIedgetype\fP
An integer value specifying one of the following edge types:
.sp
.nf
.\".ta .5i +.5i +1.5i +1i
.ta .5i +\w'-3     'u +\w'PLINE_DOT_DASHDOT     'u
1	PLINE_SOLID	\fISolid\fP
2	PLINE_DASH	\fIDashed\fP
3	PLINE_DOT	\fIDotted\fP
4	PLINE_DOT_DASH	\fIDot-dashed\fP
.fi
.sp
Support for edgetypes is workstation dependent.
.SS Execution
.LP
If the current edit mode is \s-2INSERT\s+2,
a \s-2SET EDGETYPE\s+2 element is inserted into the currently open
structure after the element pointed to by the current element pointer.  If
the edit mode is \s-2REPLACE\s+2, then the new \s-2SET EDGETYPE\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 EDGETYPE\s+2 element is traversed, the current edgetype
entry in the \s-2PHIGS\s+2 traversal state list is set to edgetype.  
When the edge flag attribute is set to \s-2ON\s+2 and
the current edgetype \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 with the edgetype specified.
.LP
If the edge flag is set to \s-2OFF\s+2, then these primitives are drawn
without edges, and only the interior fill is displayed.  
If the edge flag is \s-2OFF\s+2 and the interior style is \fIEmpty\fP, then the
primitive is invisible.  
.LP
When the edge flag is
\s-2ON\s+2 and the current edgetype \s-2ASF\s+2 is set to \s-2BUNDLED\s+2, 
the edgetype is taken from the 
workstation's representation indicated by the current edge index.
In this case, the edgetype set with \s-2SET EDGETYPE\s+2 has no effect.
.LP
If the edgetype specified is not available on the workstation to which the
structure is posted, then edgetype 1 \fI(Solid)\fP is used.
.SH ERRORS
.IP 005
Ignoring function, function requires state (PHOP, *, STOP, *)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "SET EDGE FLAG (3P)"
.SM "SET INDIVIDUAL ASF (3P)"
.SM "SET EDGE REPRESENTATION (3P)"
.SM "INQUIRE EDGE REPRESENTATION (3P)"
.SM "INQUIRE EDGE FACILITIES (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
