NAME

SET COLOUR MODEL − select colour model for workstation colour table

SYNOPSIS

C Syntax

void
pset_colr_model ( ws, model )
Pintws;workstation identifier
Pintmodel;colour model

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET COLOUR MODEL selects the colour model used to represent colours in the workstation’s table of defined colour representations, which is used to specify a primitive’s colour attribute. 

C Input Parameters

wsSet the colour model for the workstation with identifier ws. 

modelUse this colour model to interpret the colour values in the workstation colour table.  Values defined in phigs.h are:

0PINDIRECT
1PMODEL_RGBRed, Green, Blue
2PMODEL_CIELUV CIE universal colour definition system
3PMODEL_HSVHue, saturation, value
4PMODEL_HLSHue, lightness, saturation

Execution

When SET COLOUR MODEL is called, the current colour model entry in the workstation state list is set to colour model, which selects a method of interpreting the colour bundles in the workstation table of defined colour representations.  Each entry on the colour table contains three colour values.  When the current colour model is set to Red, Green, Blue, these values are interpreted as the red, green and blue components, respectively, of the colour in RGB colour space. 

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (in other words, the workstation category is neither OUTPUT, OUTIN, nor MO)

110Ignoring function, the specified colour model is not available on the workstation. 

SEE ALSO

INQUIRE COLOUR MODEL FACILITIES (3P)
INQUIRE COLOUR MODEL (3P)

September 02, 1992