Module #04.03.02.01 : Setting and inquiring workstation colour

All PVT documentation can be found under PHIGS Validation Tests - Overview. You may also return to the hierarchical table of topics covered by the PVT. For an explanation of the format of the individual module documentation, please see section 2.5 of the User's Guide.


DESCRIPTION: This module tests the ability to set and inquire
the entries in the workstation state list (WSL) pertaining to
colour.

SEMANTIC REQUIREMENTS:

*** *** ***   set/inquire colour representation   *** *** ***


SR1.  <Set colour representation> causes an entry in the colour
table of the specified workstation to be defined.
#F 69
#D 5.15.2 5.15.3.1
#S 4.5.12/63/7
#T P01/2 P01/3 P01/6 P01/7 P01/9 P01/10 P04/1 
SR2.  <Set colour representation> associates an entry in the
colour table with the colour described by the specified colour
coordinates interpreted according to the current colour model of
the specified workstation.
#F 69
#D 5.15.1 5.15.3.1 5.15.3.2
#S 4.5.2/42/3 4.5.2/43/2 4.5.12/63/7 4.5.12/63/8
#T P01/4 P01/8 P01/11 P04/1 #C Note that the entry is associated with a colour per se,
not simply with a set of colour coordinates.
SR3.  <Inquire list of colour indices> returns the list of
defined colour indices in the colour table.
#F 235
#D 5.15.2 5.15.3.1
#S
#T P01/1 P01/2 P01/3 P01/5 P01/6 P01/7 P01/9 P01/10 P01/12 
SR4.  <Inquire colour representation> can access all defined
entries in the colour table.
#F 235 236
#D 5.15.2 5.15.3.1 5.15.3.2
#S 4.5.12/63/7
#T P01/12 
SR5.  <Inquire colour representation> returns the colour
associated with an entry in the colour table as closely as
possible to the colour as originally set, when type of returned
values is specified as SET.  The returned colour is described by
a set of colour coordinates, to be interpreted according to the
current colour model of the specified workstation.
#F 72 236
#D 5.15.1 5.15.3.1 5.15.3.2
#S 4.5.12/63/7 4.5.12/63/8 4.11/108/1
#T P01/4 P01/8 P01/11 
SR6.  <Inquire colour representation> returns the representation
for colour index number 1, if type of returned values is
REALIZED, and colour index is undefined.
#F 235 236
#D 5.15.2 5.15.3.1 5.15.3.2
#S
#T P01/5 
SR7.  <Inquire workstation state table lengths> returns the
maximum size of colour table.
#F 285
#D 6.21.7
#S
#T P02/1 P02/2 P04/1 
SR8.  There must be at least two settable entries available in
the colour table.
#F 69 285
#D 5.15.2 6.21.7
#S 4.5.12/63/5 6.7/324/1
#T P02/1 
*** *** *** ***   set/inquire colour model   *** *** *** ***


SR9.  <Set colour model> sets the current colour model of the
specified workstation.
#F 72
#D 5.15.1
#S 4.5.12/63/8
#T P03/2 P03/3 
SR10.  <Inquire colour model> returns the current colour model of
the specified workstation.
#F 234
#D 5.15.1
#S 4.5.12/63/8
#T P03/1 P03/2 P03/3 
LOCAL DICTIONARY:

  Functions ---
  069: pscr    <set colour representation>
  072: pscmd   <set colour model>
  234: pqcmd   <inquire colour model>
  235: pqeci   <inquire list of colour indices>
  236: pqcr    <inquire colour representation>
  285: pqwksl  <inquire workstation state table lengths>
 
  Data Structures ---
  5  ...  workstation_state_list
  5.15  ...  colour_entry
  5.15.1  ...  current_colour_model
  5.15.2  ...  number_of_colour_table_entries
  5.15.3  ...  colour_table
  5.15.3.1  ...  colour_index
  5.15.3.2  ...  colour_specification
  6  ...  workstation_description_table
  6.21  ...  maximum_table_lengths
  6.21.7  ...  maximum_number_of_colour_indices
 





PROGRAM 1:
Setting and inquiring colour table

You may inspect either the
design or
code for this program.

PROGRAM 2:
Colour table length

You may inspect either the
design or
code for this program.

PROGRAM 3:
Setting and inquiring colour model

You may inspect either the
design or
code for this program.

PROGRAM 4:
Simultaneous use of all color table entries

You may inspect either the
design or
code for this program.

End of documentation for 04.03.02.01