Name

pset_colr_model − Assigns a value to the current color model entry in the workstation state list. 

 
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void pset_colr_model (
  Pint    wsid,       /∗ (I) Workstation identifier ∗/
  Pint    clr_model   /∗ (I) Color model ∗/
)

Constants

Defined Argument    Constant           Description
---------------------------------------------------------------------------
clr_model           PMODEL_INDEXED     Indirect (indexed) color
                    PMODEL_RGB         Direct specification of red, green,
                                       and blue
                    PMODEL_CIELUV      Direct specification in the format
                                       of the Commission Internationale
                                       de l’Eclairage
                    PMODEL_HSV         Direct specification of hue,
                                       saturation, and value
                    PMODEL_HLS         Direct specification of hue,
                                       lightness, and saturation
---------------------------------------------------------------------------

Description

pset_colr_model sets the current color model entry in the workstation state list of the specified workstation to the specified value.  The RGB color model is a cube that has as its axes the primary additive colors: red, green, and blue. Each point within the cube has a red intensity value (x-coordinate), a green intensity value (y-coordinate), and a blue intensity value (z-coordinate). Thus, the color triplet values are for the red, green, and blue intensities that form the final color.  Each axis or intensity ranges from 0 to 1, and each point defines a unique color. 

The exact shade of the final color depends on the capabilities of the workstation.  For example, the intensities 0.0000, 0.0000, 0.0000 will produce a black color representation on some devices, 1.0000, 1.0000, 1.0000 will produce white, and 0.0000, 0.0000, 0.8400 a shade of blue, and so on.  The number of colors a device can support is also dependent on the device.  For more information about color capabilities, see the color tables associated with devices in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS. 

The HSV color model is a cone.  The color triplet values are for hue, saturation, and value.  Hue is the angle about the axis of the color cone, in fractions of a circle; saturation is the radius; and value is the height, which specifies the intensity or brightness per unit area.  Angle, radius, and height all range from 0 to 1, and each point within the cone defines a unique color with a hue value, a saturation value, and a height value. 

The HLS color model is a double-ended color cone.  The color triplet values are for hue, lightness, and saturation.  Hue is the angle about the axis of the color cone, in fractions of a circle;  the radius is saturation; and lightness is the height, which specifies the intensity or brightness per unit area.  Angle, radius, and height all range from 0 to 1, and each point within the cone defines a unique color with a hue value, a saturation value, and a lightness value. 

See Also

pinq_colr_model
pinq_colr_model_facs