Module #04.03.04.02 : Highlighting and invisibility

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 of the programmer to
set and change a workstation's highlighting and invisibility
filters.  These filters, along with the nameset, control a
primitive's eligibility for highlighting and/or invisibility
upon traversal.

SEMANTIC REQUIREMENTS:

*** *** *** ***   Highlighting   *** *** *** ***


SR1.  <Set highlighting filter> sets the specified workstation's
highlighting filter entry.
#F 70
#D 5.16
#S 4.5.15/64/8
#T P01/2 P01/3 P01/4 P01/5 P01/6 P03/1 P03/2 P03/3 P03/4 P03/5 P03/6
#T P03/7 P03/8 P03/9 
SR2.  <Inquire highlighting filter> returns the workstation's
highlighting filter.
#F 237
#D 5.16
#S
#T P01/1 P01/2 P01/3 P01/4 P01/5 P01/6 P01/7 
SR3.  Immediately after <open workstation>, the inclusion and
exclusion sets of the highlighting filter entry in the
Workstation State List (WSL) are null.
#F 3 237
#D 5.16
#S 6.6/318/1
#T P01/1 P01/7 
SR4.  A primitive is highlighted on a workstation if and only if
its nameset has an element in common with the inclusion set of and
is disjoint from the exclusion set of the highlighting filter of
that workstation and it is not invisible.
#F 60 61 70
#D 3.11 5.16
#S 4.5.15/64/8ff
#T P03/1 P03/2 P03/3 P03/4 P03/5 P03/6 P03/7 P03/8 P03/9 #C See defect report 9592-1/#057
*** *** *** ***   Invisibility   *** *** *** ***


SR5.  <Set invisibility filter> sets the specified workstation's
invisibility filter entry.
#F 71
#D 5.17
#S 4.5.15/64/8
#T P02/2 P02/3 P02/4 P02/5 P02/6 P03/8 P03/9 P04/1 P04/2 P04/3 P04/4
#T P04/5 P04/6 P04/7 P04/8 
SR6.  <Inquire invisibility filter> returns the workstation's
invisibility filter.
#F 238
#D 5.17
#S
#T P02/1 P02/2 P02/3 P02/4 P02/5 P02/6 P02/7 
SR7.  Immediately after <open workstation>, the inclusion and
exclusion sets of the invisibility filter entry in the
Workstation State List (WSL) table are null.
#F 3 238
#D 5.17
#S 6.6/318/1
#T P02/1 P02/7 
SR8.  A primitive is invisible on a workstation if and only if
its nameset has an element in common with the inclusion set of and
is disjoint from the exclusion set of the invisibility filter of
that workstation.
#F 60 61 71
#D 3.11 5.17
#S 4.5.15/64/8ff
#T P03/8 P03/9 P04/1 P04/2 P04/3 P04/4 P04/5 P04/6 P04/7 P04/8 #C See defect report 9592-1/#057
SR9.  Invisible primitives do not obscure visible primitives.
#F 60 61 71
#D 3.11 5.17
#S 4.6.6/76/4
#T P04/8 
*** *** *** ***   Filters   *** *** *** ***


SR10.  The range of accessible names for use by <set highlighting
filter> and <set invisibility filter> is at least 0-63.
#F 70 71
#D 5.16 5.17
#S 4.5.15/65/4
#T P01/2 P02/2 P03/1 P03/5 P04/1 
SR11.  Both the highlighting filter and the invisibility filter
are capable of containing at least 64 names.
#F 70 71
#D 5.16 5.17
#S 4.5.15/65/4
#T P01/4 P02/4 P03/1 P03/5 P04/1 
SR12.  The range of accessible names for use by <set highlighting
filter> and <set invisibility filter> consists of the consecutive
integers from 0 to the implementation dependent `number of available
names for namesets' - 1.
#F 70 71
#D 2.5 5.16 5.17
#S
#T P01/5 P01/6 P02/5 P02/6 P03/3 P03/4 P04/3 P04/4 P04/5 #C See defect 9592-1/0025 and FORTRAN BINDING: section 5, description
of NM data type.
SR13. Invalid names specified by <set highlighting filter> and <set
invisibility filter> are ignored.
#F 70 71
#D 2.5 5.16 5.17
#S
#T P01/6 P02/6 P03/4 P04/5 #C See defect 9592-1/0025.
LOCAL DICTIONARY:

  Functions ---
  003: popwk   <open workstation>
  060: pads    <add names to set>
  061: pres    <remove names from set>
  070: pshlft  <set highlighting filter>
  071: psivft  <set invisibility filter>
  237: pqhlft  <inquire highlighting filter>
  238: pqivft  <inquire invisibility filter>
 
  Data Structures ---
  2  ...  phigs_description_table
  2.5  ...  number_of_available_names_for_name_sets
  3  ...  phigs_traversal_state_list
  3.11 ...  current_name_set
  5  ...  workstation_state_list
  5.16  ...  highlighting_filter
  5.17  ...  invisibility_filter
 





PROGRAM 1:
Highlighting filter - setting and inquiring

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

PROGRAM 2:
Invisibility filter - setting and inquiring

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

PROGRAM 3:
Appearance of highlighted primitives

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

PROGRAM 4:
Appearance of invisible primitives

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

End of documentation for 04.03.04.02