SET COLOUR MODEL(3P) — SUNPHIGS LIBRARY

NAME

SET COLOUR MODEL − select colour model for workstation colour table

SYNOPSIS

C Syntax

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

FORTRAN Syntax

SUBROUTINE pscmd ( WKID, CMODEL )
INTEGERWKIDworkstation identifier
INTEGERCMODELcolour model

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

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

Note: SunPHIGS presently supports only the RGB colour model.

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. Valid values are:

PRGBRed, Green, Blue
PCIECIE universal colour definition system
PHSVHue, saturation, value
PHLSHue, lightness, saturation

FORTRAN Input Parameters

WKIDSet the colour model for the workstation with identifier WKID.

CMODEL
Use this colour model to interpret the colour values in the workstation colour table. Valid values are the same as in C:

PRGBRed, Green, Blue
PCIECIE universal colour definition system
PHSVHue, saturation, value
PHLSHue, 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 (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

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

Museum