Name

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

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

Syntax

PSCMD (WKID, CMODEL)

Argument       Data Type      Access    Description
---------------------------------------------------------------------------
WKID           Integer        Read      Workstation identifier
CMODEL         Integer        Read      Color model
---------------------------------------------------------------------------

Constants

Defined Argument     Constant    Description
---------------------------------------------------------------------------
CMODEL               PRGB        Direct specification of red, green, and
                                 blue
                     PCIE        Direct specification in the format of the
                                 Commission Internationale de l’Eclairage
                     PHSV        Direct specification of hue, saturation,
                                 and value
                     PHLS        Direct specification of hue, lightness,
                                 and saturation
---------------------------------------------------------------------------

Description

PSCMD 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

PQCMD
PQCMDF