DESCRIPTION: This module tests the individual polyline attributes. These values control the appearance of polylines when they are under individual (as opposed to bundled) control. SEMANTIC REQUIREMENTS: *** *** *** Polyline attribute inquiry *** *** ***#F 303
SR1. If current element is linetype, linewidth scale factor, or polyline colour index, then <inquire current element type and size> returns the appropriate element type and size.
#F 304
SR2. If current element is linetype, linewidth scale factor, or polyline colour index, then <inquire current element content> returns the associated value for that element.
*** *** *** Polyline attribute traversal binding *** *** ***#F 30 31 32
SR3. Upon traversal of a "polyline" or "polyline 3" element, the current linetype, linewidth scale factor, and polyline colour index in the PTSL are bound to the resulting primitive.
*** *** Linetype: element creation *** ***#F 30
SR4. <Set linetype> creates a "set linetype" element (in the open structure), whose associated value is taken from the function's parameter.
*** *** Linetype: effect during traversal *** ***#F 30
SR5. Upon traversal of a "set linetype" element, the current linetype entry in the PHIGS traversal state list (PTSL) is set to the element's associated value.
#F 30 262
SR6. When a polyline is displayed, if its bound linetype is available on the workstation and its bound linetype ASF is INDIVIDUAL, then the appearance of the linetype agrees with the documented specifications.
#F 30 262
SR7. When a polyline is displayed, if its bound linetype is not available on the workstation and its bound linetype ASF is INDIVIDUAL, then linetype 1 (solid) is used to display the polyline.
#F
SR8. When available on the workstation to which posted, linetypes 1 through 4 appear as solid, dashed, dotted, and dashed-dotted lines, respectively.
#F
SR9. When available on the workstation to which posted, linetypes greater than 4 appear as specified in the ISO register.
#F
SR10. When available on the workstation to which posted, linetypes less than 1 appear as specified in the implementor documentation.
*** *** Linetype: network traversal *** ***#F
SR11. At the start of the top-level traversal of a structure network (not a sub-traversal caused by execute structure), the current linetype of the PTSL is set to 1.
#F 113
SR12. As part of the PTSL, the current linetype is saved (but not changed) by execute structure and then, upon completion of the sub-traversal of the invoked network, restored to the saved value.
*** Linewidth scale factor: element creation ***#F 31
SR13. <Set linewidth scale factor> creates a "set linewidth scale factor" element (in the open structure), whose associated value is taken from the function's parameter.
*** *** Linewidth scale factor: effect during traversal *** ***#F 31
SR14. Upon traversal of a "set linewidth scale factor" element, the current linewidth scale factor entry in the PHIGS traversal state list (PTSL) is set to the element's associated value.
#F 31 262
SR15. When a polyline is displayed, if its logical linewidth (= its bound linewidth scale factor times the workstation's nominal linewidth) is available on the workstation and its bound linewidth scale factor ASF is INDIVIDUAL, then the actual linewidth agrees with the logical linewidth.
#F 31 262
SR16. When a polyline is displayed, if its logical linewidth is not available on the workstation and its bound linewidth scale factor ASF is INDIVIDUAL, then the actual linewidth is the nearest available to the logical linewidth.
*** *** Linewidth scale factor: network traversal *** ***#F
SR17. At the start of the top-level traversal of a structure network (not a sub-traversal caused by execute structure), the current linewidth scale factor of the PTSL is set to 1.0.
#F 113
SR18. As part of the PTSL, the current linewidth scale factor is saved (but not changed) by execute structure and then, upon completion of the sub-traversal of the invoked network, restored to the saved value.
*** Polyline colour index: element creation ***#F 32
SR19. <Set polyline colour index> creates a "set polyline colour index" element (in the open structure), whose associated value is taken from the function's parameter.
*** *** Polyline colour index: effect during traversal *** ***#F 32
SR20. Upon traversal of a "set polyline colour index" element, the current polyline colour index entry in the PHIGS traversal state list (PTSL) is set to the element's associated value.
#F 32
SR21. When a polyline is displayed, if its bound polyline colour index is defined on the workstation and its bound polyline colour index ASF is INDIVIDUAL, then the polyline colour index is realized as itself.
#F 32
SR22. When a polyline is displayed, if its bound polyline colour index is not defined on the workstation and its bound polyline colour index ASF is INDIVIDUAL, then the polyline colour index is realized as number 1.
*** *** Polyline colour index: network traversal *** ***#F
SR23. At the start of the top-level traversal of a structure network (not a sub-traversal caused by execute structure), the current polyline colour index of the PTSL is set to 1.
#F 113
SR24. As part of the PTSL, the current polyline colour index is saved (but not changed) by execute structure and then, upon completion of the sub-traversal of the invoked network, restored to the saved value.
LOCAL DICTIONARY:
Functions --- 030: psln <set linetype> 031: pslwsc <set linewidth scale factor> 032: psplci <set polyline colour index> 113: pexst <execute structure> 262: pqplf <inquire polyline facilities> 303: pqcets <inquire current element type and size> 304: pqceco <inquire current element content> Data Structures --- 2 ... phigs_description_table 2.10 ... default_polyline_attributes 2.10.2 ... default_linetype 2.10.3 ... default_linewidth_scale_factor 2.10.4 ... default_polyline_colour_index 3 ... phigs_traversal_state_list 3.1 ... current_polyline_attributes 3.1.2 ... current_linetype 3.1.3 ... current_linewidth_scale_factor 3.1.4 ... current_polyline_colour_index 3.1.5 ... current_linetype_asf 3.1.6 ... current_linewidth_scale_factor_asf 3.1.7 ... current_polyline_colour_index_asf 5 ... workstation_state_list 5.15 ... colour_entry 5.15.3 ... colour_table 5.15.3.1 ... colour_index 5.15.3.2 ... colour_specification 6 ... workstation_description_table 6.10 ... polyline_entry 6.10.1 ... polyline_facilities 6.10.1.1 ... number_of_available_linetypes 6.10.1.2 ... list_of_available_linetypes 6.10.1.3 ... number_of_available_linewidths 6.10.1.4 ... nominal_linewidth 6.10.1.5 ... minimum_linewidth 6.10.1.6 ... maximum_linewidth 7 ... structure_state_list 7.3 ... list_of_structure_elements 7.3.1 ... graphical_primitives 7.3.1.1 ... polyline_3 7.3.1.2 ... polyline 7.3.2 ... primitive_attributes 7.3.2.2 ... polyline_attributes 7.3.2.2.1 ... linetype 7.3.2.2.2 ... linewidth_scale_factor 7.3.2.2.3 ... polyline_colour_index SEMANTIC CROSS-REFERENCES: 04.02.05.01/SR44 04.02.05.01/SR45 04.02.05.01/SR46 LOCAL SUBROUTINES: PLATTR tests polyline attributes, either individually, using the default values for the other attributes, or in combination, using non-default values for the others. It forms the body of P02 and P03, since these are very similar except for varying the attributes individually or in combination. NDLW attempts to set linewidth to a requested value, but not near the default. SHOWLW tests the rendering of a given linewidth, and returns the pass/fail result. The actual line is drawn using the indicated linetype and color. The expected linewidth is simulated with polylines of the thinnest available linewidth. RANLST chooses a linetype at random from the three lists of available linetypes. EXPPPL draws a polyline with the expected linestyle and linewidth. PLYXF returns the appropriate y-coordinate in WC for the ordered polylines.
You may inspect either the design or code for this program.
You may inspect either the design or code for this program.
You may inspect either the design or code for this program.
You may inspect either the design or code for this program.