.\"##
.\" $XConsortium: p371,v 5.2 94/04/17 20:58:46 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 RENDERING COLOUR MODEL" 3P "29 February 1991"
.SH NAME
SET RENDERING COLOUR MODEL \-
create a structure element to set current rendering colour model
.IX "Colour Model" "SET RENDERING COLOUR MODEL"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.4i 3i
.nf
void
pset_rendering_colr_model( colour_model )
Pint	colour_model;	\fIcolour model\fP
.fi
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET RENDERING COLOUR MODEL\s+2 specifies the colour model in which
lighting calculation and colour interpolation are performed.
.\" .LP
.\" This is a \s-2PHIGS\s0 Extension function based on
.\" \s-2PHIGS PLUS\s+2 and is not part of the
.\" \s-2PHIGS\s+2 standard.
.SS C Input Parameters
.IP \fIcolour_model\fP
The defined rendering colour models are:
.sp
.nf
.ta .5i +\w'PRCM_WS_DEP    'u
0	PRCM_WS_DEP	
1	PRCM_RGB	\fIRed, Green, Blue Colour Model\fP
2	PRCM_CIE	\fICommission Internationale de l'Eclairage Colour Model\fP
3	PRCM_HSV	\fIHue, Saturation, Value Colour Model\fP
4	PRCM_HLS	\fIHue, Lightness, Saturation Colour Model\fP
.\" .SS C Output Parameters
.SS Execution
Depending on the edit mode, a \s-2SET RENDERING COLOUR MODEL\s+2 element
is inserted into the open structure after the element pointer, or
replaces the element pointed to by the element pointer.
When an element of this type is interpreted, the 
'current rendering model' entry in the traversal state list is set to
the value associated with the element. If the specific colour model is
not available, colour model 0, PRCM_WS_DEP, is used.
.SH ERRORS
.IP 005
Ignoring function, function requires state
(\s-2PHOP\s+2, \s-2*\s+2, \s-2STOP\s+2, \s-2*\s+2)
.IP
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "INQUIRE RENDERING COLOUR MODEL FACILITIES (3P+)"
.fi
