.\"##
.\" $XConsortium: p313,v 5.2 94/04/17 20:58:04 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 EDGEWIDTH SCALE FACTOR" 3P "29 February 1991"
.SH NAME
SET EDGEWIDTH SCALE FACTOR \- create structure element to set the current edgewidth scale factor attribute
.IX "Aspect Source Flags" "SET EDGEWIDTH SCALE FACTOR"
.IX "Attributes, Edge Attributes" "SET EDGEWIDTH SCALE FACTOR"
.IX "Edge Attributes" "SET EDGEWIDTH SCALE FACTOR"
.IX "Wide Lines" "SET EDGEWIDTH SCALE FACTOR"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_edgewidth ( scale )
Pfloat	scale;	\fIedgewidth scale factor\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET EDGEWIDTH SCALE FACTOR\s+2 creates a structure element
containing a value for the current edgewidth scale factor attribute.
When the current edgewidth scale factor Aspect Source Flag (\s-2ASF\s+2)
is set to
\s-2INDIVIDUAL\s+2,
this attribute defines the current edgewidth applied
to the output primitives:
.RS
.ta 0.2i +0.2i +0.2i +0.2i +0.2i +0.2i +0.2i +0.2i
.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 \fI(Fill Area Primitives)\fP"
.LP
\(bu
.SM "GENERALIZED DRAWING PRIMITIVE 3 \fI(Fill Area Primitives)\fP"
.LP
\(bu
.SM "NON-UNIFORM B-SPLINE SURFACE"
.LP
\(bu
.SM "SET OF FILL AREA SET 3 WITH DATA"
.LP
\(bu
.SM "QUADRILATERAL MESH 3 WITH DATA"
.LP
\(bu
.SM "TRIANGLE STRIP 3 WITH DATA"
.ta
.RE
.LP
.SS C Input Parameter
.IP \fIscale\fP
A real value specifying the edgewidth scale factor.
.SS Execution
If the current edit mode is \s-2INSERT\s+2 when \s-2SET EDGEWIDTH SCALE
FACTOR\s+2 is
called, a \s-2SET EDGEWIDTH SCALE FACTOR\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, the new 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 EDGEWIDTH SCALE FACTOR\s+2 element is traversed, the
current edgewidth scale factor entry in the 
traversal state list is set to edgewidth scale factor.  
.LP
When the edge flag is set to \s-2ON\s+2
and the current edgewidth scale factor \s-2ASF\s+2 is set to
\s-2INDIVIDUAL\s+2, the edges of the fill area output primitives that 
follow in the structure network are drawn with the edgewidth specified.
.LP
If the edge flag is \s-2OFF\s+2, these primitives are drawn without edges
and only the interior fill is displayed.  When the edge flag is
\s-2ON\s+2 and the
edgewidth scale factor \s-2ASF\s+2 is set to \s-2BUNDLED\s+2, 
the edgewidth scale factor is taken from the
workstation's representation indicated by the current edge index.  
In this case, the edgewidth value set with \s-2SET EDGEWIDTH SCALE FACTOR\s+2
has no effect.  
.LP
The width of the edge drawn is determined by applying the current edgewidth
scale factor to the nominal edgewidth,
and this result is then mapped to the nearest edgewidth
supported on the workstation.  
.\"The GX4000
.\"nominal edge width is 1 pixel in Device Coordinate (DC) units and the
.\"supported edgewidths vary by 1 pixel (DC) units.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "SET EDGE FLAG (3P)"
.SM "SET INDIVIDUAL ASF (3P)"
.SM "SET EDGE REPRESENTATION (3P)"
.fi
