.\"##
.\" $XConsortium: p363,v 5.2 94/04/17 20:58:40 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.
.ds f \s-2SET POLYLINE SHADING METHOD\s+2
.TH "SET POLYLINE SHADING METHOD" 3P+ "29 February 1991"
.SH NAME
SET POLYLINE SHADING METHOD \-  create a structure element that sets the current polyline shading method   
.IX "Aspect Source Flags" "SET POLYLINE SHADING METHOD"
.IX "PHIGS Extension Functions" "SET POLYLINE SHADING METHOD"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_line_shad_meth ( method )
Pint	method;	\fIshading method\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET POLYLINE SHADING METHOD\s+2
places a polyline structure element with the value polyline 
shading method into the open structure. When the current polyline
shading method Aspect Source Flag (\s-2ASF\s+2) is set to
\s-2INDIVIDUAL\s+2,
the current value of this attribute
applies to the following output primitives:
.RS
.ta 0.2i +0.2i +0.2i +0.2i +0.2i +0.2i +0.2i +0.2i
.LP
\(bu
.SM "POLYLINE"
.LP
\(bu
.SM "POLYLINE 3"
.LP
\(bu
.SM "POLYLINE SET 3 WITH DATA"
.LP
\(bu
.SM "GENERALIZED DRAWING PRIMITIVE \fI(Polyline Primitives)\fP"
.LP
\(bu
.SM "GENERALIZED DRAWING PRIMITIVE 3 \fI(Polyline Primitives)\fP"
.LP
\(bu
.SM "NON-UNIFORM B-SPLINE CURVE"
.ta
.RE
.SS C Input Parameters
.IP \fImethod\fR
The shading method.  The predefined values are:
.sp
.nf
.ta .5i +\w'0     'u +\w'PSD_COLOUR     'u
1	PSD_NONE	\fINo Shading\fP
2	PSD_COLOUR	\fIColour Interpolation Shading\fP
.fi
.sp
.SS Execution
Depending on the edit mode, a
\s-2SET POLYLINE SHADING METHOD\s+2
element is inserted into the open structure after the element
pointer, or replaces the element pointed to by the element pointer.
In either case, the element pointer is updated to point to the newly 
created
\s-2SET POLYLINE SHADING METHOD\s+2
element.
.LP
When the structure is traversed, the current polyline shading method 
entry in the traversal state list is set to the specified value.
This value is used with subsequent line
output primitives when the current polyline shading method \s-2ASF\s+2 entry
in the traversal state list is 
\s-2INDIVIDUAL\s+2.
During traversal, if the specified shading method is not available
on a workstation, method 1 will be used on that workstation.
.LP
When the current polyline shading method \s-2ASF\s+2 is set to \s-2BUNDLED\s+2,
the polyline shading method is taken from the
workstation extended representation indicated by the current polyline index.
In this case, the polyline shading method
set with \s-2SET POLYLINE SHADING METHOD\s+2 has no effect.
.LP
When the shading method is \s-2NONE\s+2, each segment of the polyline or curve
is drawn in a single colour.  If the primitive specifies per-vertex
colour, each segment is drawn using the colour associated with
the first vertex of the segment.
.\" begin new page
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP,*,STOP,*\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "POLYLINE SET 3 WITH DATA (3P+)"
.SM "PHIGS WORKSTATION DESCRIPTION TABLE (7P)"
.SM "NON-UNIFORM B-SPLINE CURVE (3P+)"
.fi
