PVT: Set edit mode and control of element pointer

Module #02.02.03 : Set edit mode and control of element pointer

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 the `edit mode' of structures and control the element pointer
position.

SEMANTIC REQUIREMENTS:

SR1.   <Set edit mode> sets the `edit mode.'

#F 117
#D 4.4
#S 4.4.4/29/1
#T P01/5 P02/1


SR2.   When `edit mode' is INSERT, new elements are inserted
after the element pointed to by the `element pointer.'

#F 117
#D 4.3 4.4 7.3
#S 4.4.4/29/1
#T P01/6


SR3.   When `edit mode' is REPLACE, new elements replace the
element pointed to by the `element pointer.'

#F 117
#D 4.3 4.4 7.3
#S 4.4.4/29/1
#T P02/2


SR4.   Whether the `edit mode' is REPLACE or INSERT, the `element
pointer' is always updated to point to the new element.

#F 117
#D 4.3 4.4
#S 4.4.4/29/1
#T P01/7 P02/3


SR5.   After <open PHIGS>, the default for `edit mode' is INSERT.

#F 1 117
#D 4.4
#S 6.5/314/1
#T P01/1 P02/11


SR6.   If the `element pointer' is 0, then, regardless of the `edit
mode', the new element is inserted immediately before element 1;
the `element pointer' becomes 1 and points at the new element.

#F 117
#D 4.3 4.4 7.3
#S
#T P01/12 P01/13 P02/8 P02/9


SR7.   <Set element pointer> sets the `element pointer' to an
absolute position.

#F 119
#D 4.3
#S 4.4.4/28/7
#T P01/2 P01/8 P01/10 P02/4 P02/6


SR8.   <Offset element pointer> offsets the `element pointer' to
a position whose value is the sum of the `element pointer' and
the offset.

#F 120
#D 4.3
#S 4.4.4/28/7
#T P01/4 P01/9 P01/11 P02/5 P02/7


SR9.   <Set element pointer at label> positions the `element
pointer' at the next occurrence beyond the current position of a
specified label element.

#F 121
#D 4.3 7.3.5
#S 4.4.4/28/7
#T P01/3 P01/14 P02/10


SR10.  If <set element pointer> or <offset element pointer> is
used to position the `element pointer' beyond the structure's
bounds (either zero, or the last element position), the `element
pointer' then points at the bound it would have exceeded.

#F 119 120
#D 4.3
#S 4.4.4/28/7
#T P01/8 P01/9 P01/10 P01/11 P02/4 P02/5 P02/6 P02/7


SR11.   <Inquire edit mode> returns the current `edit mode.'

#F 208
#D 4.4
#S
#T P01/1 P01/5 P02/1 P02/11

LOCAL DICTIONARY:


  Functions ---
  001: popph   <open phigs>
  117: psedm   <set edit mode>
  119: psep    <set element pointer>
  120: posep   <offset element pointer>
  121: pseplb  <set element pointer at label>
  208: pqedm   <inquire edit mode>
 
  Data Structures ---
  4  ...  phigs_state_list
  4.3  ...  element_pointer
  4.4  ...  edit_mode
  7  ...  structure_state_list
  7.3  ...  list_of_structure_elements
  7.3.5  ...  label
 
SEMANTIC CROSS-REFERENCES:
  02.01.02.01/SR06 02.01.02.01/SR07 02.01.02.02/SR11
  02.01.02.02/SR12

Module #02.02.03 : Set edit mode and control of element pointer

PROGRAM 1: Set edit mode to INSERT and manipulate element pointer

PROGRAM 2: Set edit mode to REPLACE and manipulate element pointer

End of documentation for 02.02.03