home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / gks / gksuser.doc < prev   
Encoding:
Text File  |  1988-05-03  |  246.8 KB  |  9,240 lines
  1.      
  2.                         Preliminary GKS User Manual
  3.      
  4.     Section 1. General
  5.      
  6.          1.1 Purpose of the Users Manual.
  7.      
  8.               This user's manual provides an overview of the Graphical
  9.               Kernel System (GKS) implemented in Ada.  It provides
  10.               general background information about GKS and references
  11.               to textbooks that can be used by application programmers
  12.               unfamiliar with graphics.  More importantly, this manual
  13.               provides the specifics for installing GKS at a computer
  14.               site and configuring the level functionality of GKS
  15.               desired.
  16.      
  17.          1.2 Background
  18.      
  19.               The GKS is an international standard describing
  20.               high-level graphics functions.  These functions enable a
  21.               programmer to write sophisticated graphics programs
  22.               without learning the scheme for describing graphics on a
  23.               particular device.  The GKS/Ada implementation described
  24.               by this user manual is the American National Standard
  25.               (ANS) version of GKS.
  26.      
  27.               The International Standards Organization GKS (ISO/DIS
  28.               7942) is the basis for the ANS GKS.  All functional
  29.               capabilities of ISO GKS are found in the ANS GKS.
  30.               Interested readers should refer to the dpANS GKS
  31.               Specification X3H3/83-25R3, 5 January 1984, for a more
  32.               complete discussion of GKS.
  33.      
  34.               This user manual should be used in conjunction with
  35.               Draft GKS Binding to ANSI Ada X3H3/83-95r1, 20 July
  36.               1984.  GKS/Ada was developed in accordance with this
  37.               binding and should be the application programmer's guide
  38.               for Ada language specifics when using this user's
  39.               manual.  This manual does not attempt to duplicate the
  40.               GKS procedure and parameter listings that are entailed
  41.               in the binding; however, function descriptions are
  42.               offered in this manual for each GKS function.
  43.      
  44.               You may want to refer to the following books to gain a
  45.               familiarity of graphics.  These books treat GKS
  46.               specifically,aas well as, computer graphics in general.
  47.      
  48.      
  49.                    Enderle, G., Kansy, K. and Pfaff, G. Computer
  50.                    Graphics Programming: GKS - The Graphics Standard.
  51.                    Springer-Verlag, 1984.
  52.      
  53.                    This 542 page textbook is a thorough introduction
  54.                    to computer graphics programming using GKS.  This
  55.                    textbook was referred to most by the implementors
  56.                    of GKS/Ada and should satisfy the needs of GKS/Ada
  57.                    graphics users.
  58.      
  59.                    Hopgood, F.R.A., Duce, D. A., Gallop, J. R.,
  60.                    Sutcliffe, D. C., Introduction to the Graphical
  61.                    Kernal System (GKS). Academic Press, 1983.
  62.      
  63.                    This textbook is an introduction to GKS.  It is
  64.                    written by the people (among others) who wrote and
  65.                    reviewed the ISO GKS document.
  66.      
  67.     Section 2. Understanding GKS
  68.      
  69.          2.1 GKS Application
  70.      
  71.               Using GKS Level ma a programmer can write programs to do
  72.               the following:
  73.      
  74.                    Draw pictures on a display using lines, markers,
  75.                    text, patterned areas, and pixel-filled areas.
  76.      
  77.               All of these functions and more are available to the
  78.               application programmer when using GKS.  Because these
  79.               functions are device independent the programmer need not
  80.               specify the particular device that makes up the GKS
  81.               workstation (physical device(s) in the GKS system).
  82.      
  83.          2.2 GKS Architecture
  84.      
  85.               The basic architecture of GKS/Ada is based on 5 major
  86.               components and 3 interfaces.  The components are the
  87.               GKS, the Workstation Manager, the Workstation
  88.               Communication Link, the Workstation Driver, and the
  89.               Device Driver.  The interfaces are the Ada language
  90.               binding to GKS, the Common Graphics Interface (CGI) and
  91.               Device Driver Interfaces.
  92.      
  93.               The GKS component is the highest level component in the
  94.               GKS system architecture.  It interfaces to graphic
  95.               application programs via the Ada language binding.  This
  96.               component is responsible for most of the error checking
  97.               in the system, transforming World Coordinates into
  98.               Normalized Device Coordinates, and some other
  99.               housekeeping functions.  All other GKS operations are
  100.               performed by the Workstation Manager and Workstation
  101.               Drivers.
  102.      
  103.               The Workstation Manager is the supervisor of the graphic
  104.               workstations.  It is responsible for transmitting output
  105.               primitives to appropriate graphic workstations,
  106.               supporting attribute manipulation, segment manipulation,
  107.               etc.  The GKS component interfaces with the Workstation
  108.               Manager through the CGI, and in turn the Workstation
  109.               Manager communicates with workstations via the
  110.               Workstation Communication Links using the CGI.
  111.      
  112.               A Workstation Driver exists for each workstation type.
  113.               The Workstation Driver is responsible for accepting CGI
  114.               operations and translating them into appropriate device
  115.               specific commands.  The Device Driver supports each of
  116.               the device specific commands expressed as the Device
  117.               Driver Interface.  The Device Driver encodes the Device
  118.               Driver Interface operations and transmits them to the
  119.               device.
  120.      
  121.          2.3 GKS Configuration
  122.      
  123.               This is a production quality device independent software
  124.               package written in the Ada Programming Language,
  125.               ANSI/MIL-STD-1815A, January, 1983.  As such, it can be
  126.               configured to run on a computer with a compiler
  127.               supporting Ada validated to this military specification.
  128.      
  129.               This software package is structured so that GKS/Ada
  130.               versions may be configured which contain only specified
  131.               GKS levels to allow efficient use of the package on
  132.               systems where storage is a concern.  GKS/Ada is also
  133.               structured to allow configuration of multiple graphic
  134.               device drivers.
  135.      
  136.               The graphics device supported by this implementation of
  137.               GKS is the Lexidata 3700 (color raster device).  Raster
  138.               graphics make possible the display of solid color areas
  139.               offering an especially rich means for communicating
  140.               information.
  141.      
  142.               GKS/Ada was developed on a Data General MV8000 using the
  143.               Ada Development Environment (ADE).  The ADE includes
  144.               tools to support software development built on top of
  145.               the AOS/VS operating system.  The release of GKS
  146.               contained on this tape is configured to run on such an
  147.               installation.  The DG user executing a GKS application
  148.               must have the account's user profile set allowing the
  149.               privilege to change the priority type.  Further, the
  150.               Lexidata I/O card uses DG data channel 48 for input and
  151.               data channel 49 for output. The Lexidata device driver
  152.               must be configured using these ports for this release of
  153.               GKS.
  154.      
  155.          2.4 GKS Functions
  156.      
  157.               GKS provides a set of strictly defined graphical
  158.               procedures which serve as an interface between the
  159.               application program and the physical graphics devices.
  160.               As stated above, the mapping of GKS functionality to Ada
  161.               procedures can be found in the GKS/Ada binding.
  162.      
  163.               The GKS standard defines twelve levels of graphic
  164.               functionality.  A user of GKS/Ada need implement only
  165.               the level that provides the functionality required for
  166.               the application.  If additional or less functionality is
  167.               desired as the application evolves, this software
  168.               package can be reconfigured to provide the proper level
  169.               of functionality.  Section 3.1.4 of the GKS Binding
  170.               provides an alphabetical list of GKS functions by
  171.               level.  Appendix A of this user manual provides detailed
  172.               descriptions of the GKS functions.
  173.               Since this is a preliminary version of the user's
  174.               manual, the detailed descriptions in Appendix A include
  175.               all the GKS Level A functions; whereas the functionality
  176.               of the GKS code contained on the magnetic tape are upto
  177.               GKS Level ma.
  178.      
  179.     Section 3. Installing GKS
  180.      
  181.          3.1 Where to Begin
  182.      
  183.               There are 188 Ada source files and 5 object files on the
  184.               tape containing the initial release of GKS Level ma.
  185.               Appendix B lists the Ada source files necessary to
  186.               configure Level ma of GKS.  The five object (".OB")
  187.               files contain proprietary software to interface the DG
  188.               and Lexidata device driver.  These five relocatable
  189.               binary files must be introduced into the Ada library
  190.               containing the compiled GKS Ada source files.  This is
  191.               achieved on the MV8000 by using the IMPORT command while
  192.               in the Ada Development Environment.  The file
  193.               NAME_IMPORT.CLI provides a set of DG macroinstructions
  194.               to achieve this.
  195.      
  196.               These files are listed in the order of compilation.  It
  197.               is imperative that these source files be compiled in the
  198.               order listed.  The specific directions contained in
  199.               Appendix B apply for DG MV8000 users.
  200.      
  201.          3.2 GKS Level Functionality Configuration
  202.      
  203.               GKS can be configured for any of the twelve levels
  204.               desired.  Since this user manual has been written for
  205.               Level ma (the lowest level of GKS), additional
  206.               discussion to do this will be included in later releases
  207.               of the user manual.
  208.      
  209.      
  210.      
  211.                          APPENDIX A
  212.      
  213.      
  214.      
  215.      
  216.     FUNCTION NAME: OPEN_GKS
  217.      
  218.     CATEGORY: CONTROL
  219.      
  220.      
  221.     BRIEF DESCRIPTION: This function initializes GKS
  222.      
  223.      
  224.      
  225.     INPUTS:
  226.          ERROR_FILE:     User-defined file for reporting errors
  227.                          detected by GKS.
  228.      
  229.          AMOUNT_OF_MEMORY:  Required by GKS but currently ignored.
  230.      
  231.      
  232.      
  233.      
  234.     OUTPUTS:
  235.      
  236.      
  237.      
  238.      
  239.      
  240.      
  241.      
  242.      
  243.     ERRORS/EXCEPTIONS:
  244.          1: STATE_ERROR. GKS is not in the proper state; GKS shall be in
  245.             the state GKCL.
  246.          2: MISC_ERROR. Specified error file is invalid.
  247.      
  248.      
  249.      
  250.      
  251.     LEVEL: Ma
  252.      
  253.      
  254.     DETAILED DESCRIPTION:   OPEN_GKS must be invoked before any other GKS
  255.     function. After OPEN_GKS has been invoked the GKS state list is
  256.     allocated and initialized, the GKS description table and the
  257.     workstation description tables are made available, and the operating
  258.     state list is set to GKOP = "GKS open" in the GKS state list.
  259.          The procedure checks if the operating state is set to GKCL in the
  260.     GKS_OPERATING_STATE_LIST. If it is not set to GKCL, error 1 occurs and
  261.     the exception STATE_ERROR is raised.
  262.      
  263.      
  264.      
  265.      
  266.      
  267.      
  268.      
  269.      
  270.     FUNCTION NAME: CLOSE_GKS
  271.      
  272.     CATEGORY: CONTROL
  273.      
  274.      
  275.     BRIEF DESCRIPTION: This function closes GKS.
  276.      
  277.      
  278.      
  279.      
  280.      
  281.      
  282.      
  283.      
  284.     INPUTS:
  285.      
  286.      
  287.      
  288.      
  289.      
  290.      
  291.      
  292.      
  293.     OUTPUTS:
  294.      
  295.      
  296.      
  297.      
  298.      
  299.      
  300.      
  301.      
  302.     ERRORS/EXCEPTIONS:
  303.          2: STATE_ERROR. GKS is not in the proper state; GKS shall be in
  304.             the state GKOP.
  305.      
  306.      
  307.      
  308.      
  309.      
  310.      
  311.     LEVEL: Ma
  312.      
  313.      
  314.     DETAILED DESCRIPTION:   When CLOSE_GKS is invoked all of the GKS data
  315.     structures are made unavailable and no further GKS functions may be
  316.     invoked. The operating state list is set to GKCL = "GKS closed."
  317.          The procedure inquires the GKS_OPERATING_STATE_LIST initially. If
  318.     the operating state is not GKOP, error 2 occurs and the exception
  319.     STATE_ERROR is raised.
  320.      
  321.      
  322.      
  323.      
  324.     FUNCTION NAME: OPEN_WS
  325.      
  326.     CATEGORY: CONTROL
  327.      
  328.      
  329.     BRIEF DESCRIPTION: This procedure calls the workstation manager to
  330.     open a workstation and thus add it to the set of open workstations
  331.     in the GKS_STATE_LIST.
  332.      
  333.      
  334.     INPUTS:
  335.          WS:          The workstation to be opened.
  336.          CONNECTION:  The physical identifier associated with the logical
  337.                       WS identifier.
  338.          TYPE_OF_WS:  Indicates the type of workstation being opened.
  339.      
  340.      
  341.     OUTPUTS:
  342.      
  343.      
  344.      
  345.     ERRORS/EXCEPTIONS:
  346.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  347.              one of the states GKOP, WSOP, WSAC, or SGOP.
  348.          21: WS_ERROR. Specified connection identifier is invalid.
  349.          22: WS_ERROR. Specified workstation type is invalid.
  350.          23: WS_ERROR. Specified workstation type does not exist.
  351.          24: WS_ERROR. Specified workstation is open.
  352.          26: WS_ERROR. Specified workstation cannot be opened.
  353.          28: WS_ERROR. Workstation independent segment storage is already
  354.              open.
  355.          42: WS_ERROR. Maximum number of simultaneously open workstations
  356.              would be exceeded.
  357.      
  358.      
  359.     LEVEL: Ma
  360.      
  361.      
  362.     DETAILED DESCRIPTION:
  363.          This procedure opens a specified workstation by initializing
  364.     the device to the current environmental values and inquiring the
  365.     device capabilities. The display surface is cleared if not already
  366.     empty.
  367.          OPEN_WS starts by inquiring the GKS operating state list
  368.     for the GKS operating state. If GKS is not in the proper state, error
  369.     8 occurs and the procedure raises the exception STATE_ERROR. If GKS is
  370.     in the proper state, this procedure inquires the GKS_STATE_LIST to
  371.     check if the WS is already open. If it is, error 24 occurs and the
  372.     procedure raises the exception WS_ERROR. Then the call to the
  373.     WS_MANAGER is made. If no errors occur, this procedure sets the
  374.     operating state to WSOP = "at least one workstation open." If errors
  375.     21, 22, 26, or 28 are returned by the workstation manager, this
  376.     procedure will raise the exception WS_ERROR.
  377.      
  378.      
  379.      
  380.      
  381.      
  382.      
  383.      
  384.      
  385.      
  386.      
  387.      
  388.      
  389.      
  390.      
  391.     FUNCTION NAME: CLOSE_WS
  392.      
  393.     CATEGORY: CONTROL
  394.      
  395.      
  396.     BRIEF DESCRIPTION: This procedure calls the workstation manager to
  397.     release the connection between the workstation and GKS.
  398.      
  399.      
  400.      
  401.      
  402.      
  403.     INPUTS:
  404.          WS:      Workstation to be closed.
  405.      
  406.      
  407.      
  408.      
  409.      
  410.      
  411.      
  412.     OUTPUTS:
  413.      
  414.      
  415.      
  416.      
  417.     ERRORS/EXCEPTIONS:
  418.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  419.               one of the states WSOP, WSAC, or SGOP.
  420.          25:  WS_ERROR. Specified workstation is not open.
  421.          29:  WS_ERROR. Specified workstation is active.
  422.          147: INPUT_ERROR. Input queue has overflowed.
  423.      
  424.      
  425.      
  426.      
  427.     LEVEL: Ma
  428.      
  429.      
  430.     DETAILED DESCRIPTION:
  431.          This procedure terminates the specified workstation. When it is
  432.     called, an implicit UPDATE WORKSTATION is performed for the specified
  433.     workstation.
  434.          CLOSE_WS starts by inquiring the GKS operating state list
  435.     to see if GKS is in state WSOP, WSAC, or SGOP. If it is not, then
  436.     error 7 occurs and the exception STATE_ERROR is raised. CLOSE_WS then
  437.     inquires the GKS_STATE_LIST to determine whether the WS is in the set
  438.     of open workstations. If it is not, error 25 occurs and the exception
  439.     WS_ERROR is raised. The procedure also check the GKS_STATE_LIST to
  440.     determine whether the WS is in the set of active workstations. If it
  441.     is, error 29 occurs and the exception WS_ERROR is raised.
  442.      
  443.      
  444.      
  445.     FUNCTION NAME: ACTIVATE_WS
  446.      
  447.     CATEGORY: CONTROL
  448.      
  449.      
  450.     BRIEF DESCRIPTION: This procedure calls the workstation manager
  451.     to activate a workstation.
  452.      
  453.      
  454.      
  455.     INPUTS:
  456.          WS:      Identifier of the workstation to be activated.
  457.      
  458.      
  459.      
  460.     OUTPUTS:
  461.      
  462.      
  463.      
  464.     ERRORS/EXCEPTIONS:
  465.          6:  STATE_ERROR. GKS is not in the proper state; GKS shall be
  466.              either in the state WSOP or in the state WSAC.
  467.          25: WS_ERROR. Specified workstation is not open.
  468.          29: WS_ERROR. Specified workstation is active.
  469.          33: WS_ERROR. Specified workstation is of category MI.
  470.          35: WS_ERROR. Specified workstation is of category INPUT.
  471.          43: WS_ERROR. Maximum number of active workstation would be
  472.              exceeded.
  473.      
  474.     LEVEL: Ma
  475.      
  476.      
  477.     DETAILED DESCRIPTION:
  478.          This procedure activates a specified workstation and causes
  479.     subsequent output or stored segments to go to the specified device.
  480.          ACTIVATE_WS first checks the GKS operating state list to
  481.     determine whether or not GKS is in either of the states WSOP or WASC.
  482.     If it is not, error 6 occurs and the exception STATE_ERROR is raised.
  483.     Then the procedure inquires the GKS_STATE_LIST to check if the WS is
  484.     in the set of open workstations. If it is not, error 25 occurs and the
  485.     exception WS_ERROR is raised. The procedure also checks the
  486.     GKS_STATE_LIST to determine whether the WS is in the set of active
  487.     workstations. If it is, error 29 occurs and the exception WS_ERROR is
  488.     raised. Then, if the addition of another active workstation would
  489.     exceed the MAX_ACTIVE_WS number in the  GKS_DESCRIPTION_TABLE, error
  490.     43 occurs and the exception WS_ERROR is raised.
  491.          Otherwise, this procedure calls the workstation manager to
  492.     activate the workstation. If the workstation manager returns errors 33
  493.     or 35, this procedure raises the exception WS_ERROR.
  494.      
  495.      
  496.      
  497.      
  498.      
  499.     FUNCTION NAME: DEACTIVATE_WS
  500.      
  501.     CATEGORY: CONTROL
  502.      
  503.      
  504.     BRIEF DESCRIPTION: This procedure calls the workstation manager
  505.     to deactivate a workstation.
  506.      
  507.      
  508.      
  509.     INPUTS:
  510.          WS:     The identifier of the workstation to be deactivated.
  511.      
  512.      
  513.      
  514.     OUTPUTS:
  515.      
  516.      
  517.      
  518.     ERRORS/EXCEPTIONS:
  519.          3:  STATE_ERROR. GKS is not in the proper state; GKS shall be
  520.              in the state WSAC.
  521.          30: WS_ERROR. Specified workstation is not active.
  522.          33: WS_ERROR. Specified workstation is of category MI.
  523.          35: WS_ERROR. Specified workstation is of category INPUT.
  524.      
  525.      
  526.      
  527.      
  528.     LEVEL: Ma
  529.      
  530.      
  531.     DETAILED DESCRIPTION:
  532.          This procedure terminates graphics output to a specified
  533.     workstation. Primitives will no longer be sent to this workstation and
  534.     new segments will not be stored. Segments already stored on this
  535.     workstation are retained.
  536.          DEACTIVATE_WS first inquires the GKS_OPERATING_STATE_LIST to
  537.     determine whether GKS is in the state WSAC. If it is not, error 3
  538.     occurs and this procedure raises the exception STATE_ERROR. The
  539.     procedure then inquires the GKS_STATE_LIST to determine whether the WS
  540.     is in the set of active workstations. If it is not, error 30 occurs
  541.     and the exception WS_ERROR is raised. Otherwise, this procedure calls
  542.     the workstation manager to deactivate the workstation. If the
  543.     workstation manager returns errors 33 or 35, the procedure raises the
  544.     exception WS_ERROR.
  545.          This procedure sets the operating state to WSOP = "At least one
  546.     workstation open" in the GKS_OPERATING_STATE_LIST if no workstations
  547.     remain active. This is determined by inquiring the GKS_STATE_LIST.
  548.      
  549.      
  550.      
  551.      
  552.      
  553.     FUNCTION NAME: CLEAR_WS
  554.      
  555.     CATEGORY: CONTROL
  556.      
  557.      
  558.     BRIEF DESCRIPTION: This procedure calls the workstation manager to
  559.     clear a workstation.
  560.      
  561.      
  562.      
  563.     INPUTS:
  564.          WS:     The identifier of the workstation on which the display
  565.                  surface is to be cleared.
  566.          FLAG:   Indicates the conditions under which the display surface
  567.                  is to be cleared. It may be set to either CONDITIONALLY
  568.                  or ALWAYS.
  569.      
  570.      
  571.     OUTPUTS:
  572.      
  573.      
  574.      
  575.     ERRORS/EXCEPTIONS:
  576.          6:  STATE_ERROR. GKS is not in the proper state; GKS shall be
  577.              either in the state WSOP or in the state WSAC.
  578.          25: WS_ERROR. Specified workstation is not open.
  579.          33: WS_ERROR. Specified workstation is of category MI.
  580.          35: WS_ERROR. Specified workstation is of category INPUT.
  581.      
  582.      
  583.      
  584.     LEVEL: Ma
  585.      
  586.      
  587.     DETAILED DESCRIPTION:
  588.          This procedure clears the display surface of the workstation
  589.     according to the control flag. If the control flag is set to 0, the
  590.     display surface is cleared only if an object appears on it. If the
  591.     flag is set to 1, the display surface is always cleared. All segments
  592.     for the workstation are also released. If no other workstations are
  593.     associated with a segment, it is deleted.
  594.          CLEAR_WS inquires the GKS_OPERATING_STATE_LIST
  595.     determine whether GKS is in either of the states WSOP or WSAC. If it
  596.     is not, error 6 occurs and the exception STATE_ERROR is raised. Then
  597.     this procedure inquires the GKS_STATE_LIST to determine whether the WS
  598.     is in the set of open workstations. If it is not, error 25 occurs and
  599.     the exception WS_ERROR is raised.
  600.          Otherwise, this procedure calls the workstation manager to clear
  601.     the workstation. If the workstation manager returns errors 33 or 35,
  602.     this procedure raises the exception WS_ERROR.
  603.      
  604.      
  605.      
  606.      
  607.     FUNCTION NAME: UPDATE_WS
  608.      
  609.     CATEGORY: CONTROL
  610.      
  611.      
  612.     BRIEF DESCRIPTION: This procedure calls the workstation manager to
  613.     update a workstation.
  614.      
  615.      
  616.      
  617.      
  618.      
  619.     INPUTS:
  620.          WS:            The identifier of the workstation that is to be
  621.                         updated.
  622.          REGENERATION:  This flag may have one of two values, PERFORM or
  623.                         POSTPONE to indicate the regeneration action on
  624.                         the display.
  625.      
  626.      
  627.      
  628.     OUTPUTS:
  629.      
  630.      
  631.      
  632.      
  633.     ERRORS/EXCEPTIONS:
  634.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be
  635.              in one of the states WSOP, WSAC, or SGOP.
  636.          25: WS_ERROR. Specified workstation is not open.
  637.          33: WS_ERROR. Specified workstation is of category MI.
  638.          35: WS_ERROR. Specified workstation is of category INPUT.
  639.          36: WS_ERROR. Specified workstation is Workstation Independent
  640.              Segment Storage.
  641.      
  642.      
  643.     LEVEL: Ma
  644.      
  645.      
  646.     DETAILED DESCRIPTION:
  647.          The UPDATE_WS procedure is used to get a true representation of
  648.     the graphics picture when the dynamic modification capability is IRG
  649.     (implicit regeneration necessary). If the regeneration flag is set to
  650.     POSTPONE, then blocked data is transmitted, causing all pending
  651.     graphics actions to be executed. If the regeneration flag is set to
  652.     PERFORM and a new frame at update is necessary, (i.e. the workstation
  653.     transformation has changed or some segment attributes have changed
  654.     which require an implicit regeneration) then the display surface is
  655.     cleared and all visible segments stored on this workstation are
  656.     redisplayed.
  657.      
  658.      
  659.      
  660.      
  661.     FUNCTION NAME: REDRAW_ALL_SEGMENTS_ON_WS
  662.      
  663.     CATEGORY: CONTROL
  664.      
  665.      
  666.     BRIEF DESCRIPTION:  This procedure redraws all the segments on the
  667.     specified workstation.
  668.      
  669.      
  670.      
  671.      
  672.      
  673.      
  674.      
  675.     INPUTS:
  676.          WS: An integer value representing the workstation identifier.
  677.      
  678.      
  679.      
  680.      
  681.      
  682.      
  683.      
  684.     OUTPUTS:
  685.      
  686.      
  687.      
  688.      
  689.      
  690.      
  691.      
  692.      
  693.     ERRORS/EXCEPTIONS:
  694.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be
  695.              in one of the states WSOP, WSAC, or SGOP.
  696.          25: Specified workstation is not open.
  697.          33: Specified workstation is of category MI.
  698.          35: Specified workstation is of category INPUT.
  699.          36: Specified workstation is Workstation Independent Segment
  700.              Storage.
  701.      
  702.      
  703.      
  704.     LEVEL: 1A
  705.      
  706.      
  707.     DETAILED DESCRIPTION:
  708.          This procedure causes all pending output to be executed. The
  709.     display surface is then cleared if not empty, and all visible
  710.     segments stored for the workstation are redisplayed using the last
  711.     requested workstation window and viewport.
  712.      
  713.      
  714.      
  715.     FUNCTION NAME: SET_DEFERRAL_STATE
  716.      
  717.     CATEGORY: CONTROL
  718.      
  719.      
  720.     BRIEF DESCRIPTION:  This procedure sets the deferral state for a
  721.     specified workstation.
  722.      
  723.      
  724.      
  725.      
  726.      
  727.      
  728.     INPUTS:
  729.          WS:           An integer value representing the workstation
  730.                        identifier.
  731.          DEFERRAL:     This is the deferral state in which the
  732.                        workstation is to be set.
  733.          REGENERATION: This is the regeneration mode in which the
  734.                        workstation is to be set.
  735.      
  736.      
  737.     OUTPUTS:
  738.      
  739.      
  740.      
  741.      
  742.      
  743.      
  744.     ERRORS/EXCEPTIONS:
  745.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  746.              one of the states WSOP, WSAC, or SGOP.
  747.          25: WS_ERROR. Specified workstation is not open.
  748.          33: WS_ERROR. Specified workstation is of category MI.
  749.          35: WS_ERROR. Specified workstation is of category INPUT.
  750.          36: WS_ERROR. Specified workstation is Workstation Independent
  751.              Segment Storage.
  752.      
  753.      
  754.      
  755.     LEVEL: 1A
  756.      
  757.      
  758.     DETAILED DESCRIPTION:
  759.          This procedure sets the 'deferral mode' and 'implicit
  760.     regeneration mode' entries in the workstation state list. Depending
  761.     on the new value of 'deferral mode,' deferred output may be unblocked.
  762.     If in the workstation state list, the new value of 'implicit
  763.     regeneration mode' is allowed and 'new frame action necessary at
  764.     update' is yes, then an action equivalent to 'redraw all segments' is
  765.     performed.
  766.      
  767.      
  768.      
  769.     FUNCTION NAME: MESSAGE
  770.      
  771.     CATEGORY: CONTROL
  772.      
  773.      
  774.     BRIEF DESCRIPTION:  This procedure sends a message to a specified
  775.     workstation.
  776.      
  777.      
  778.      
  779.      
  780.      
  781.      
  782.      
  783.     INPUTS:
  784.          WS:      An integer value representing the workstation
  785.                   identifier.
  786.          MESSAGE: This is the text string that is to be sent to the
  787.                   workstation.
  788.      
  789.      
  790.      
  791.      
  792.     OUTPUTS:
  793.      
  794.      
  795.      
  796.      
  797.      
  798.      
  799.      
  800.      
  801.     ERRORS/EXCEPTIONS:
  802.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  803.              one of the states WSOP, WSAC, or SGOP.
  804.          25: WS_ERROR. Specified workstation is not open.
  805.          36: WS_ERROR. Specified workstation is Workstation Independent
  806.              Segment Storage.
  807.      
  808.      
  809.      
  810.      
  811.      
  812.     LEVEL: 1A
  813.      
  814.      
  815.     DETAILED DESCRIPTION:
  816.          This procedure may display a message at an implementation
  817.     dependent location on the workstation viewport or on some separate
  818.     device associated with the workstation. It does not alter the GKS
  819.     state list.
  820.      
  821.      
  822.      
  823.     FUNCTION NAME: ERROR_LOGGING
  824.      
  825.     CATEGORY: ERROR HANDLING
  826.      
  827.      
  828.     BRIEF DESCRIPTION: This procedure writes the error number and the
  829.     GKS function name detecting the error to the error file.
  830.      
  831.      
  832.      
  833.      
  834.      
  835.      
  836.      
  837.     INPUTS:
  838.          ERROR_INDICATOR:  A numeric value representing the type of
  839.                            error being logged.
  840.      
  841.          NAME:             A string type. Its value is the name of the
  842.                            procedure in which the error being logged
  843.                            occured.
  844.      
  845.      
  846.     OUTPUTS:
  847.      
  848.      
  849.      
  850.      
  851.      
  852.      
  853.      
  854.      
  855.     ERRORS/EXCEPTIONS:
  856.      
  857.      
  858.      
  859.      
  860.      
  861.      
  862.      
  863.     LEVEL: 0a
  864.      
  865.      
  866.     DETAILED DESCRIPTION:
  867.          ERROR_LOGGING writes the error number and the applicable GKS
  868.     function name to the specified error file. It then returns to the
  869.     calling procedure. Error messages are inserted into the error file
  870.     as strings in the order incurred and are delimited by a single
  871.     carriage return.
  872.      
  873.      
  874.      
  875.      
  876.      
  877.     FUNCTION NAME: EMERGENCY_CLOSE_GKS
  878.      
  879.     CATEGORY: ERROR HANDLING
  880.      
  881.      
  882.     BRIEF DESCRIPTION:  This procedure closes GKS in emergency conditions.
  883.      
  884.      
  885.      
  886.      
  887.      
  888.      
  889.      
  890.      
  891.     INPUTS:
  892.      
  893.      
  894.      
  895.      
  896.      
  897.      
  898.      
  899.      
  900.     OUTPUTS:
  901.      
  902.      
  903.      
  904.      
  905.      
  906.      
  907.      
  908.      
  909.     ERRORS/EXCEPTIONS:
  910.      
  911.      
  912.      
  913.      
  914.      
  915.      
  916.      
  917.      
  918.      
  919.      
  920.     LEVEL: 0A
  921.      
  922.      
  923.     DETAILED DESCRIPTION:
  924.          This procedure closes GKS in case of a non-recoverable error
  925.     and still saves as much information as possible. All workstations
  926.     are updated, all active workstations are deactivated, all
  927.     workstations are closed, and GKS is closed.
  928.      
  929.      
  930.      
  931.     FUNCTION NAME: GET_ERROR
  932.      
  933.     CATEGORY: ERROR HANDLING
  934.      
  935.      
  936.     BRIEF DESCRIPTION:  This procedure allows the applications program
  937.     to access the latest error indicator and subprogram name.
  938.      
  939.      
  940.      
  941.      
  942.      
  943.      
  944.      
  945.     INPUTS:
  946.      
  947.      
  948.      
  949.      
  950.      
  951.      
  952.      
  953.      
  954.     OUTPUTS:
  955.          ERROR_INDICATOR: This is the most recent error indicator.
  956.          NAME:            This is the name of the subprogram in which
  957.                           the error occured.
  958.      
  959.      
  960.      
  961.      
  962.      
  963.     ERRORS/EXCEPTIONS:
  964.      
  965.      
  966.      
  967.      
  968.      
  969.      
  970.      
  971.      
  972.      
  973.      
  974.     LEVEL: 0A
  975.      
  976.      
  977.     DETAILED DESCRIPTION:
  978.          This procedure is an additional feature which allows the
  979.     application program to access the most recent error indicator and
  980.     the name of the subprogram in which the error occured.
  981.      
  982.      
  983.      
  984.      
  985.     FUNCTION NAME: INQ_DYNAMIC_MODIFICATION_OF_WS_ATTRIBUTES
  986.     CATEGORY: INQUIRY
  987.      
  988.      
  989.     BRIEF DESCRIPTION:  This procedure returns the dynamic modification
  990.     of workstation attributes.
  991.      
  992.      
  993.      
  994.      
  995.      
  996.     INPUTS:
  997.          WS_TYPE:        The type of workstation.
  998.      
  999.      
  1000.      
  1001.      
  1002.      
  1003.     OUTPUTS:
  1004.          ERROR_INDICATOR:  0  Requested value is available and is being
  1005.                               reported.
  1006.                            8  GKS is not in one of the states GKOP, WSOP,
  1007.                               WSAC, or SGOP.
  1008.                            22 -
  1009.                            39 Specified workstation is neither of
  1010.                               category OUTPUT nor of category OUTIN.
  1011.      
  1012.          POLYLINE_REPRESENTATION:
  1013.          POLYMARKER_REPRESENTATION:
  1014.          TEXT_REPRESENTATION:
  1015.          FILL_AREA_REPRESENTATION:
  1016.          PATTERN_REPRESENTATION:
  1017.          COLOUR_REPRESENTATION:
  1018.          TRANSFORMATION:
  1019.      
  1020.      
  1021.     ERRORS/EXCEPTIONS:
  1022.      
  1023.      
  1024.      
  1025.      
  1026.      
  1027.     LEVEL: 1a
  1028.      
  1029.      
  1030.     DETAILED DESCRIPTION:
  1031.          If the requested information is available, this procedure returns
  1032.     error indicator 0 and the requested information. If the requested
  1033.     information is not available, this procedure returns the appropriate
  1034.     error indicator to explain the reason for non-availability.
  1035.      
  1036.      
  1037.      
  1038.      
  1039.     FUNCTION NAME: INQ_LINE_TYPE            CATEGORY: INQUIRY
  1040.      
  1041.      
  1042.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1043.     obtain the value of the current line type.
  1044.      
  1045.      
  1046.      
  1047.      
  1048.      
  1049.      
  1050.      
  1051.     INPUTS:
  1052.      
  1053.      
  1054.      
  1055.      
  1056.      
  1057.      
  1058.      
  1059.      
  1060.     OUTPUTS:
  1061.          ERROR_INDICATOR:  0  Requested value is available and is being
  1062.                               reported.
  1063.                            8  GKS is not in one of the states GKOP, WSOP,
  1064.                               WSAC, or SGOP.
  1065.      
  1066.          LINE_TYPE:        The currently defined line type.
  1067.      
  1068.      
  1069.     ERRORS/EXCEPTIONS:
  1070.      
  1071.      
  1072.      
  1073.      
  1074.      
  1075.      
  1076.      
  1077.      
  1078.      
  1079.      
  1080.     LEVEL: ma
  1081.      
  1082.      
  1083.     DETAILED DESCRIPTION:
  1084.          If the requested information is available, this procedure returns
  1085.     error indicator 0 and the requested information. If the requested
  1086.     information is not available, this procedure returns the appropriate
  1087.     error indicator to explain the reason for non-availability.
  1088.      
  1089.      
  1090.      
  1091.      
  1092.      
  1093.     FUNCTION NAME: INQ_LINEWIDTH_SCALE_FACTOR
  1094.      
  1095.     CATEGORY: INQUIRY
  1096.      
  1097.      
  1098.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1099.     obtain the value of the current linewidth scale factor.
  1100.      
  1101.      
  1102.      
  1103.      
  1104.      
  1105.      
  1106.      
  1107.     INPUTS:
  1108.      
  1109.      
  1110.      
  1111.      
  1112.      
  1113.      
  1114.      
  1115.      
  1116.     OUTPUTS:
  1117.          ERROR_INDICATOR:  0  Requested value is available and is being
  1118.                               returned.
  1119.                            8  GKS is not in one of the states GKOP, WSOP,
  1120.                               WSAC, or SGOP.
  1121.      
  1122.          LINE_WIDTH:       The currently defined line width scale factor.
  1123.      
  1124.      
  1125.     ERRORS/EXCEPTIONS:
  1126.      
  1127.      
  1128.      
  1129.      
  1130.      
  1131.      
  1132.      
  1133.      
  1134.      
  1135.      
  1136.     LEVEL: ma
  1137.      
  1138.      
  1139.     DETAILED DESCRIPTION:
  1140.          If the requested information is available, this procedure returns
  1141.     error indicator 0 and the requested information. If the requested
  1142.     information is not available, this procedure returns the appropriate
  1143.     error indicator to explain the reason for non-availability.
  1144.      
  1145.      
  1146.      
  1147.     FUNCTION NAME: INQ_POLYLINE_COLOUR_INDEX
  1148.      
  1149.     CATEGORY: INQUIRY
  1150.      
  1151.      
  1152.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1153.     obtain the value of the current polyline colour index.
  1154.      
  1155.      
  1156.      
  1157.      
  1158.      
  1159.      
  1160.      
  1161.     INPUTS:
  1162.      
  1163.      
  1164.      
  1165.      
  1166.      
  1167.      
  1168.      
  1169.      
  1170.     OUTPUTS:
  1171.          ERROR_INDICATOR:  0  Requested value is available and is being
  1172.                               reported.
  1173.                            8  GKS is not in one of the states GKOP, WSOP,
  1174.                               WSAC, or SGOP.
  1175.      
  1176.          COLOUR_INDEX:     The currently defined polyline colour index.
  1177.      
  1178.      
  1179.     ERRORS/EXCEPTIONS:
  1180.      
  1181.      
  1182.      
  1183.      
  1184.      
  1185.      
  1186.      
  1187.      
  1188.      
  1189.      
  1190.     LEVEL: ma
  1191.      
  1192.      
  1193.     DETAILED DESCRIPTION:
  1194.          If the requested information is available, this procedure returns
  1195.     error indicator 0 and the requested information. If the requested
  1196.     information is not available, this procedure returns the appropriate
  1197.     error indicator to explain the reason for non-availability.
  1198.      
  1199.      
  1200.      
  1201.     FUNCTION NAME: INQ_POLYMARKER_TYPE
  1202.      
  1203.     CATEGORY: INQUIRY
  1204.      
  1205.      
  1206.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1207.     obtain the value of the current polymarker type.
  1208.      
  1209.      
  1210.      
  1211.      
  1212.      
  1213.      
  1214.      
  1215.     INPUTS:
  1216.      
  1217.      
  1218.      
  1219.      
  1220.      
  1221.      
  1222.      
  1223.      
  1224.     OUTPUTS:
  1225.          ERROR_INDICATOR:  0  Requested value is available and is being
  1226.                               reported.
  1227.                            8  GKS is not in one of the states GKOP, WSOP,
  1228.                               WSAC, or SGOP.
  1229.      
  1230.          MARKER:           An integer value representing the type of
  1231.                            polymarker that is currently selected.
  1232.      
  1233.     ERRORS/EXCEPTIONS:
  1234.      
  1235.      
  1236.      
  1237.      
  1238.      
  1239.      
  1240.      
  1241.      
  1242.      
  1243.      
  1244.     LEVEL: ma
  1245.      
  1246.      
  1247.     DETAILED DESCRIPTION:
  1248.          If the requested information is available, this procedure returns
  1249.     error indicator 0 and the requested information. If the requested
  1250.     information is not available, this procedure returns the appropriate
  1251.     error indicator to explain the reason for non-availability.
  1252.      
  1253.      
  1254.      
  1255.     FUNCTION NAME: INQ_POLYMARKER_SIZE_SCALE_FACTOR
  1256.      
  1257.     CATEGORY: INQUIRY
  1258.      
  1259.      
  1260.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1261.     obtain the value of the current polymarker size scale factor.
  1262.      
  1263.      
  1264.      
  1265.      
  1266.      
  1267.      
  1268.      
  1269.     INPUTS:
  1270.      
  1271.      
  1272.      
  1273.      
  1274.      
  1275.      
  1276.      
  1277.      
  1278.     OUTPUTS:
  1279.          ERROR_INDICATOR:  0  Requested value is available and is being
  1280.                               reported.
  1281.                            8  GKS is not in one of the states GKOP, WSOP,
  1282.                               WSAC, or SGOP.
  1283.      
  1284.          SIZE:             This is a positive scale factor value
  1285.                            indicating the relative size of the polymarker.
  1286.      
  1287.     ERRORS/EXCEPTIONS:
  1288.      
  1289.      
  1290.      
  1291.      
  1292.      
  1293.      
  1294.      
  1295.      
  1296.      
  1297.      
  1298.     LEVEL: ma
  1299.      
  1300.      
  1301.     DETAILED DESCRIPTION:
  1302.          If the requested information is available, this procedure returns
  1303.     error indicator 0 and the requested information. If the requested
  1304.     information is not available, this procedure returns the appropriate
  1305.     error indicator to explain the reason for non-availability.
  1306.      
  1307.      
  1308.      
  1309.     FUNCTION NAME: INQ_POLYMARKER_COLOUR_INDEX
  1310.      
  1311.     CATEGORY: INQUIRY
  1312.      
  1313.      
  1314.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1315.     obtain the value of the current polymarker colour index.
  1316.      
  1317.      
  1318.      
  1319.      
  1320.      
  1321.      
  1322.      
  1323.     INPUTS:
  1324.      
  1325.      
  1326.      
  1327.      
  1328.      
  1329.      
  1330.      
  1331.      
  1332.     OUTPUTS:
  1333.          ERROR_INDICATOR:  0  Requested value is available and is being
  1334.                               reported.
  1335.                            8  GKS is not in one of the states GKOP, WSOP,
  1336.                               WSAC, or SGOP.
  1337.      
  1338.          COLOUR:           An integer value indicating the colour that is
  1339.                            currently selected for polymarker primitives.
  1340.      
  1341.     ERRORS/EXCEPTIONS:
  1342.      
  1343.      
  1344.      
  1345.      
  1346.      
  1347.      
  1348.      
  1349.      
  1350.      
  1351.      
  1352.     LEVEL: Ma
  1353.      
  1354.      
  1355.     DETAILED DESCRIPTION:
  1356.          If the requested information is available, this procedure returns
  1357.     error indicator 0 and the requested information. If the requested
  1358.     information is not available, this procedure returns the appropriate
  1359.     error indicator to explain the reason for non-availability.
  1360.      
  1361.      
  1362.      
  1363.     FUNCTION NAME: INQ_TEXT_FONT_AND_PRECISION
  1364.      
  1365.     CATEGORY: INQUIRY
  1366.      
  1367.      
  1368.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1369.     obtain the value of the current text font and precision.
  1370.      
  1371.      
  1372.      
  1373.      
  1374.      
  1375.      
  1376.     INPUTS:
  1377.      
  1378.      
  1379.      
  1380.      
  1381.      
  1382.      
  1383.      
  1384.     OUTPUTS:
  1385.          ERROR_INDICATOR:  0  Requested value is available and is being
  1386.                               reported.
  1387.                            8  GKS is not in one of the states GKOP, WSOP,
  1388.                               WSAC, or SGOP.
  1389.      
  1390.          FONT_PRECISION:   A record describing the text font and
  1391.                            precision. The FONT component is an integer
  1392.                            value representing the font selected. The
  1393.                            PRECISION component may be of the vale
  1394.                            STRING_PRECISION, CHAR_PRECISION, or
  1395.                            STROKE_PRECISION.
  1396.      
  1397.     ERRORS/EXCEPTIONS:
  1398.      
  1399.      
  1400.      
  1401.      
  1402.      
  1403.      
  1404.      
  1405.     LEVEL: ma
  1406.      
  1407.      
  1408.     DETAILED DESCRIPTION:
  1409.          If the requested information is available, this procedure returns
  1410.     error indicator 0 and the requested information. If the requested
  1411.      
  1412.      
  1413.      
  1414.      
  1415.      
  1416.      
  1417.      
  1418.      
  1419.      
  1420.      
  1421.      
  1422.      
  1423.      
  1424.      
  1425.      
  1426.      
  1427.     information is not available, this procedure returns the appropriate
  1428.     error indicator to explain the reason for non-availability.
  1429.      
  1430.      
  1431.      
  1432.      
  1433.     FUNCTION NAME: INQ_CHAR_EXPANSION_FACTOR
  1434.      
  1435.     CATEGORY: INQUIRY
  1436.      
  1437.      
  1438.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1439.     obtain the value of the current character expansion factor.
  1440.      
  1441.      
  1442.      
  1443.      
  1444.      
  1445.      
  1446.      
  1447.     INPUTS:
  1448.      
  1449.      
  1450.      
  1451.      
  1452.      
  1453.      
  1454.      
  1455.      
  1456.     OUTPUTS:
  1457.          ERROR_INDICATOR:  0  Requested value is available and is being
  1458.                               returned.
  1459.                            8  GKS is not in one of the states GKOP, WSOP,
  1460.                               WSAC, or SGOP.
  1461.      
  1462.          EXPANSION:        A positive scale factor value that indicates
  1463.                            the character expansion.
  1464.      
  1465.     ERRORS/EXCEPTIONS:
  1466.      
  1467.      
  1468.      
  1469.      
  1470.      
  1471.      
  1472.      
  1473.      
  1474.      
  1475.      
  1476.     LEVEL: ma
  1477.      
  1478.      
  1479.     DETAILED DESCRIPTION:
  1480.          If the requested information is available, this procedure returns
  1481.     error indicator 0 and the requested information. If the requested
  1482.     information is not available, this procedure returns the appropriate
  1483.     error indicator to explain the reason for non-availability.
  1484.      
  1485.      
  1486.      
  1487.     FUNCTION NAME: INQ_CHAR_SPACING
  1488.      
  1489.     CATEGORY: INQUIRY
  1490.      
  1491.      
  1492.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1493.     obtain value of the current character spacing.
  1494.      
  1495.      
  1496.      
  1497.      
  1498.      
  1499.      
  1500.      
  1501.     INPUTS:
  1502.      
  1503.      
  1504.      
  1505.      
  1506.      
  1507.      
  1508.      
  1509.     OUTPUTS:
  1510.          ERROR_INDICATOR:  0  Requested value is available and is being
  1511.                               returned.
  1512.                            8  GKS is not in one of the states GKOP, WSOP,
  1513.                               WSAC, or SGOP.
  1514.      
  1515.          SPACING:          A scale factor value representing the
  1516.                            character spacing. A positive value indicates
  1517.                            the amount of space between characters. A
  1518.                            negative value indicates the amount of overlap
  1519.                            between characters.
  1520.      
  1521.     ERRORS/EXCEPTIONS:
  1522.      
  1523.      
  1524.      
  1525.      
  1526.      
  1527.      
  1528.      
  1529.      
  1530.     LEVEL: Ma
  1531.      
  1532.      
  1533.     DETAILED DESCRIPTION:
  1534.          If the requested information is available, this procedure returns
  1535.     error indicator 0 and the requested information. If the requested
  1536.     information is not available, this procedure returns the appropriate
  1537.     error indicator to explain the reason for non-availability.
  1538.      
  1539.      
  1540.      
  1541.     FUNCTION NAME: INQ_TEXT_COLOUR_INDEX
  1542.      
  1543.     CATEGORY: INQUIRY
  1544.      
  1545.      
  1546.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1547.     obtain the value of the current text colour index.
  1548.      
  1549.      
  1550.      
  1551.      
  1552.      
  1553.      
  1554.      
  1555.     INPUTS:
  1556.      
  1557.      
  1558.      
  1559.      
  1560.      
  1561.      
  1562.      
  1563.      
  1564.     OUTPUTS:
  1565.          ERROR_INDICATOR:  0  Requested value is available and is being
  1566.                               returned.
  1567.                            8  GKS is not in one of the state GKOP, WSOP,
  1568.                               WSAC, or SGOP.
  1569.      
  1570.          COLOUR:           An integer value indicating the colour that is
  1571.                            currently selected for text primitives.
  1572.      
  1573.     ERRORS/EXCEPTIONS:
  1574.      
  1575.      
  1576.      
  1577.      
  1578.      
  1579.      
  1580.      
  1581.      
  1582.      
  1583.      
  1584.     LEVEL: ma
  1585.      
  1586.      
  1587.     DETAILED DESCRIPTION:
  1588.          If the requested information is available, this procedure returns
  1589.     error indicator 0 and the requested information. If the requested
  1590.     information is not available, this procedure returns the appropriate
  1591.     error indicator to explain the reason for non-availability.
  1592.      
  1593.      
  1594.      
  1595.     FUNCTION NAME: INQ_FILL_AREA_INTERIOR_STYLE
  1596.      
  1597.     CATEGORY: INQUIRY
  1598.      
  1599.      
  1600.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1601.     obtain the value of the current fill area interior style.
  1602.      
  1603.      
  1604.      
  1605.      
  1606.      
  1607.      
  1608.      
  1609.     INPUTS:
  1610.      
  1611.      
  1612.      
  1613.      
  1614.      
  1615.      
  1616.      
  1617.      
  1618.     OUTPUTS:
  1619.          ERROR_INDICATOR:  0  Requested value is available and is being
  1620.                               returned.
  1621.                            8  GKS is not in one of the states GKOP, WSOP,
  1622.                               WSAC, or SGOP.
  1623.      
  1624.          STYLE:            This enumerated type indicates whether the
  1625.                            current fill area interior style is HOLLOW,
  1626.                            SOLID, PATTERN, or HATCH.
  1627.      
  1628.     ERRORS/EXCEPTIONS:
  1629.      
  1630.      
  1631.      
  1632.      
  1633.      
  1634.      
  1635.      
  1636.      
  1637.     LEVEL: Ma
  1638.      
  1639.      
  1640.     DETAILED DESCRIPTION:
  1641.          If the requested information is available, this procedure returns
  1642.     error indicator 0 and the requested information. If the requested
  1643.     information is not available, this procedure returns the appropriate
  1644.     error indicator to explain the reason for non-availability.
  1645.      
  1646.      
  1647.      
  1648.      
  1649.     FUNCTION NAME: INQ_FILL_AREA_STYLE_INDEX
  1650.      
  1651.     CATEGORY: INQUIRY
  1652.      
  1653.      
  1654.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1655.     obtain the value of the current fill area style index.
  1656.      
  1657.      
  1658.      
  1659.      
  1660.      
  1661.      
  1662.     INPUTS:
  1663.      
  1664.      
  1665.      
  1666.      
  1667.      
  1668.      
  1669.      
  1670.     OUTPUTS:
  1671.          ERROR_INDICATOR:  0  Requested value is available and is being
  1672.                               returned.
  1673.                            8  GKS is not in one of the states GKOP, WSOP,
  1674.                               WSAC, or SGOP.
  1675.      
  1676.          INDEX:            A variant record is defining the fill area
  1677.                            style index. If the discriminant is HOLLOW or
  1678.                            SOLID, the record has a null component. If it
  1679.                            is PATTERN, the component is a PATTERN_INDEX.
  1680.                            If it is HATCH, the record component is a
  1681.                            HATCH_STYLE_TYPE.
  1682.      
  1683.      
  1684.     ERRORS/EXCEPTIONS:
  1685.      
  1686.      
  1687.      
  1688.      
  1689.      
  1690.      
  1691.      
  1692.     LEVEL: Ma
  1693.      
  1694.      
  1695.     DETAILED DESCRIPTION:
  1696.          If the requested information is available, this procedure returns
  1697.     error indicator 0 and the requested information. If the requested
  1698.     information is not available, this procedure returns the appropriate
  1699.     error indicator to explain the reason for non-availability.
  1700.      
  1701.      
  1702.      
  1703.     FUNCTION NAME: INQ_FILL_AREA_COLOUR_INDEX
  1704.      
  1705.     CATEGORY: INQUIRY
  1706.      
  1707.      
  1708.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1709.     obtain the value of the current fill area colour index.
  1710.      
  1711.      
  1712.      
  1713.      
  1714.      
  1715.      
  1716.      
  1717.     INPUTS:
  1718.      
  1719.      
  1720.      
  1721.      
  1722.      
  1723.      
  1724.      
  1725.      
  1726.     OUTPUTS:
  1727.          ERROR_INDICATOR:  0  Requested value is available and is being
  1728.                               returned.
  1729.                            8  GKS is not in one of the states GKOP, WSOP,
  1730.                               WSAC, or SGOP.
  1731.      
  1732.          COLOUR:           An integer value indicating the colour that is
  1733.                            currently selected for fill area primitives.
  1734.      
  1735.     ERRORS/EXCEPTIONS:
  1736.      
  1737.      
  1738.      
  1739.      
  1740.      
  1741.      
  1742.      
  1743.      
  1744.      
  1745.      
  1746.     LEVEL: ma
  1747.      
  1748.      
  1749.     DETAILED DESCRIPTION:
  1750.          If the requested information is available, this procedure returns
  1751.     error indicator 0 and the requested information. If the requested
  1752.     information is not available, this procedure returns the appropriate
  1753.     error indicator to explain the reason for non-availability.
  1754.      
  1755.      
  1756.      
  1757.     FUNCTION NAME: INQ_LIST_OF_ASF
  1758.      
  1759.     CATEGORY: INQUIRY
  1760.      
  1761.      
  1762.     BRIEF DESCRIPTION: This procedure inquires the GKS_STATE_LIST to
  1763.     obtain the value of the current list of aspect source flags.
  1764.      
  1765.      
  1766.      
  1767.      
  1768.      
  1769.      
  1770.      
  1771.     INPUTS:
  1772.      
  1773.      
  1774.      
  1775.      
  1776.      
  1777.      
  1778.      
  1779.      
  1780.     OUTPUTS:
  1781.          ERROR_INDICATOR:  0  Requested value is available and is being
  1782.                               returned.
  1783.                            8  GKS is not in one of the states GKOP, WSOP,
  1784.                               WSAC, or SGOP.
  1785.      
  1786.          LIST:             A record listing all of the aspect source
  1787.                            flags. Each component may have a value of
  1788.                            INDIVIDUAL or BUNDLED.
  1789.      
  1790.     ERRORS/EXCEPTIONS:
  1791.      
  1792.      
  1793.      
  1794.      
  1795.      
  1796.      
  1797.      
  1798.      
  1799.     LEVEL: ma
  1800.      
  1801.      
  1802.     DETAILED DESCRIPTION:
  1803.          If the requested information is available, this procedure returns
  1804.     error indicator 0 and the requested information. If the requested
  1805.     information is not available, this procedure returns the appropriate
  1806.     error indicator to explain the reason for non-availability.
  1807.      
  1808.      
  1809.      
  1810.      
  1811.     FUNCTION NAME: INQ_DEFAULT_DEFERRAL_STATE_VALUES
  1812.      
  1813.     CATEGORY: INQUIRY
  1814.      
  1815.      
  1816.     BRIEF DESCRIPTION: This procedure returns default values of deferral
  1817.     states and implicit regeneration mode.
  1818.      
  1819.      
  1820.      
  1821.      
  1822.      
  1823.      
  1824.     INPUTS:
  1825.          WS_TYPE:         The type of workstation.
  1826.      
  1827.      
  1828.      
  1829.      
  1830.      
  1831.      
  1832.      
  1833.     OUTPUTS:
  1834.          ERROR_INDICATOR:  0  Requested value is available and is being
  1835.                               returned.
  1836.                            8  GKS is not in one of the state GKOP, WSOP,
  1837.                               WSAC, or SGOP.
  1838.                            22 Specified workstation type is invalid.
  1839.                            23 Specified workstation type does not exist.
  1840.                            39 Specified workstation is neither of
  1841.                               category OUTPUT nor of category OUTIN.
  1842.      
  1843.          DEFERRAL:         One of the values ASAP, BNIG, BNIL, or ASTI.
  1844.          REGENERATION:     Value of the implicit regeneration mode,
  1845.                            either SUPPRESSED or ALLOWED.
  1846.      
  1847.     ERRORS/EXCEPTIONS:
  1848.      
  1849.      
  1850.      
  1851.      
  1852.      
  1853.      
  1854.      
  1855.     LEVEL: 1a
  1856.      
  1857.     DETAILED DESCRIPTION:
  1858.          If the requested information is available, this procedure returns
  1859.     error indicator 0 and the requested information. If the requested
  1860.     information is not available, this procedure returns the appropriate
  1861.     error indicator to explain the reason for non-availability.
  1862.      
  1863.      
  1864.      
  1865.     FUNCTION NAME: INQ_NUMBER_OF_SEGMENT_PRIORITIES_SUPPORTED
  1866.      
  1867.     CATEGORY: INQUIRY
  1868.      
  1869.      
  1870.     BRIEF DESCRIPTION: This procedure returns the number of segment
  1871.     priorities supported.
  1872.      
  1873.      
  1874.      
  1875.      
  1876.      
  1877.      
  1878.     INPUTS:
  1879.          WS_TYPE:        The type of workstation.
  1880.      
  1881.      
  1882.      
  1883.      
  1884.      
  1885.      
  1886.     OUTPUTS:
  1887.          ERROR_INDICATOR:  0  Requested value is available and is being
  1888.                               returned.
  1889.                            8  GKS is not in one of the states GKOP, WSOP,
  1890.                               WSAC, or SGOP.
  1891.                            22 Specified workstation type is invalid.
  1892.                            23 Specified workstation type does not exist.
  1893.                            39 Specified workstation is neither of
  1894.                               category OUTPUT nor of category OUTIN.
  1895.      
  1896.          NUMBER_OF_PRIORITIES:  Indicates the number of segment
  1897.                            priorities supported by this type of
  1898.                            workstation. A value of 0 indicates that a
  1899.                            continuous range of priorities is supported.
  1900.      
  1901.      
  1902.     ERRORS/EXCEPTIONS:
  1903.      
  1904.      
  1905.      
  1906.      
  1907.      
  1908.     LEVEL: 1a
  1909.      
  1910.      
  1911.     DETAILED DESCRIPTION:
  1912.          If the requested information is available, this procedure returns
  1913.     error indicator 0 and the requested information. If the requested
  1914.     information is not available, this procedure returns the appropriate
  1915.     error indicator to explain the reason for non-availability.
  1916.      
  1917.      
  1918.      
  1919.     FUNCTION NAME: INQ_DYNAMIC_MODIFICATION_OF_SEGMENT_ATTRIBUTES
  1920.      
  1921.     CATEGORY: INQUIRY
  1922.      
  1923.      
  1924.     BRIEF DESCRIPTION: This procedure returns the values of dynamic
  1925.     modification of segment attributes.
  1926.      
  1927.      
  1928.      
  1929.      
  1930.      
  1931.     INPUTS:
  1932.          WS_TYPE:       The type of workstation.
  1933.      
  1934.      
  1935.      
  1936.      
  1937.     OUTPUTS:
  1938.          ERROR_INDICATOR:  0  Requested value is available and is being
  1939.                               returned.
  1940.                            8  GKS is not in one of the states GKOP, WSOP,
  1941.                               WSAC, or SGOP.
  1942.                            22 Specified workstation type is invalid.
  1943.                            23 Specified workstation type does not exist.
  1944.                            39 Specified workstation is neither of
  1945.                               category OUTPUT nor of category OUTIN.
  1946.      
  1947.          TRANSFORMATION:   Segment transformation changeable.
  1948.          VISIBLE_TO_INVISIBLE:  Visibility changeable from visible to
  1949.                            invisible.
  1950.          INVISIBLE_TO_VISIBLE:  Visibility changeable from invisible to
  1951.                            visible.
  1952.          HIGHLIGHTING:     Highlighting changeable.
  1953.          PRIORITY:         Segment priority changeable.
  1954.          ADDING_PRIMITIVES:  Adding primitives to the open segment.
  1955.          DELETION_VISIBLE:  Segment deletion immediately visible.
  1956.      
  1957.     ERRORS/EXCEPTIONS:
  1958.      
  1959.      
  1960.      
  1961.      
  1962.     LEVEL: 1a
  1963.      
  1964.      
  1965.     DETAILED DESCRIPTION:
  1966.          If the requested information is available, this procedure returns
  1967.     error indicator 0 and the requested information. If the requested
  1968.     information is not available, this procedure returns the appropriate
  1969.     error indicator to explain the reason for non-availability.
  1970.      
  1971.      
  1972.      
  1973.     FUNCTION NAME: INQ_CHAR_HEIGHT
  1974.      
  1975.     CATEGORY: INQUIRY
  1976.      
  1977.      
  1978.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  1979.     obtain the value of the current character height.
  1980.      
  1981.      
  1982.      
  1983.      
  1984.      
  1985.      
  1986.      
  1987.     INPUTS:
  1988.      
  1989.      
  1990.      
  1991.      
  1992.      
  1993.      
  1994.      
  1995.      
  1996.     OUTPUTS:
  1997.          ERROR_INDICATOR:  0  Requested value is available and is being
  1998.                               returned.
  1999.                            8  GKS is not in one of the states GKOP, WSOP,
  2000.                               WSAC, or SGOP.
  2001.          HEIGHT:           This is the nominal height of the capital
  2002.                            letter character.
  2003.      
  2004.      
  2005.     ERRORS/EXCEPTIONS:
  2006.      
  2007.      
  2008.      
  2009.      
  2010.      
  2011.      
  2012.      
  2013.      
  2014.      
  2015.      
  2016.     LEVEL: Ma
  2017.      
  2018.      
  2019.     DETAILED DESCRIPTION:
  2020.          If the requested information is available, this procedure returns
  2021.     error indicator 0 and the requested information. If the requested
  2022.     information is not available, this procedure returns the appropriate
  2023.     error indicator to explain the reason for non-availability.
  2024.      
  2025.      
  2026.      
  2027.     FUNCTION NAME: INQ_TEXT_PATH
  2028.      
  2029.     CATEGORY: INQUIRY
  2030.      
  2031.      
  2032.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2033.     obtain the value of the current text path.
  2034.      
  2035.      
  2036.      
  2037.      
  2038.      
  2039.      
  2040.      
  2041.     INPUTS:
  2042.      
  2043.      
  2044.      
  2045.      
  2046.      
  2047.      
  2048.      
  2049.      
  2050.     OUTPUTS:
  2051.          ERROR_INDICATOR:  0  Requested value is available and is being
  2052.                               returned.
  2053.                            8  GKS is not in one of the states GKOP, WSOP,
  2054.                               WSAC, or SGOP.
  2055.          PATH:             Indicated the direction taken by the text
  2056.                            string. It may be Right, Left, Up, or Down.
  2057.      
  2058.      
  2059.     ERRORS/EXCEPTIONS:
  2060.      
  2061.      
  2062.      
  2063.      
  2064.      
  2065.      
  2066.      
  2067.      
  2068.      
  2069.      
  2070.     LEVEL: Ma
  2071.      
  2072.      
  2073.     DETAILED DESCRIPTION:
  2074.          If the requested information is available, this procedure returns
  2075.     error indicator 0 and the requested information. If the requested
  2076.     information is not available, this procedure returns the appropriate
  2077.     error indicator to explain the reason for non-availability.
  2078.      
  2079.      
  2080.      
  2081.     FUNCTION NAME: INQ_TEXT_ALIGNMENT
  2082.      
  2083.     CATEGORY: INQUIRY
  2084.      
  2085.      
  2086.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2087.     obtain the value of the current text alignment.
  2088.      
  2089.      
  2090.      
  2091.      
  2092.      
  2093.      
  2094.      
  2095.     INPUTS:
  2096.      
  2097.      
  2098.      
  2099.      
  2100.      
  2101.      
  2102.      
  2103.     OUTPUTS:
  2104.          ERROR_INDICATOR:  0  Requested value is available and is being
  2105.                               returned.
  2106.                            8  GKS is not in one of the states GKOP, WSOP,
  2107.                               WSAC, or SGOP.
  2108.          ALIGNMENT:        Indicated the positioning of the text extent
  2109.                            rectangle in relation to the text position. It
  2110.                            is a record with a Horizontal component and a
  2111.                            Vertical component.
  2112.      
  2113.      
  2114.     ERRORS/EXCEPTIONS:
  2115.      
  2116.      
  2117.      
  2118.      
  2119.      
  2120.      
  2121.      
  2122.      
  2123.      
  2124.     LEVEL: Ma
  2125.      
  2126.      
  2127.     DETAILED DESCRIPTION:
  2128.          If the requested information is available, this procedure returns
  2129.     error indicator 0 and the requested information. If the requested
  2130.     information is not available, this procedure returns the appropriate
  2131.     error indicator to explain the reason for non-availability.
  2132.      
  2133.      
  2134.      
  2135.     FUNCTION NAME: INQ_PATTERN_REFERENCE_POINT
  2136.      
  2137.     CATEGORY: INQUIRY
  2138.      
  2139.      
  2140.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2141.     obtain the value of the current pattern reference point.
  2142.      
  2143.      
  2144.      
  2145.      
  2146.      
  2147.      
  2148.      
  2149.     INPUTS:
  2150.      
  2151.      
  2152.      
  2153.      
  2154.      
  2155.      
  2156.      
  2157.      
  2158.     OUTPUTS:
  2159.          ERROR_INDICATOR:  0  Requested value is available and is being
  2160.                               reported.
  2161.                            8  GKS is not in one of the states GKOP, WSOP,
  2162.                               WSAC, or SGOP.
  2163.          REFERENCE_POINT:  The world coordinate point giving the position
  2164.                            for the start of the pattern. It is a record
  2165.                            type with X and Y components.
  2166.      
  2167.     ERRORS/EXCEPTIONS:
  2168.      
  2169.      
  2170.      
  2171.      
  2172.      
  2173.      
  2174.      
  2175.      
  2176.      
  2177.      
  2178.     LEVEL: Ma
  2179.      
  2180.      
  2181.     DETAILED DESCRIPTION:
  2182.          If the requested information is available, this procedure returns
  2183.     error indicator 0 and the requested information. If the requested
  2184.     information is not available, this procedure returns the appropriate
  2185.     error indicator to explain the reason for non-availability.
  2186.      
  2187.      
  2188.      
  2189.     FUNCTION NAME: INQ_PATTERN_HEIGHT_VECTOR
  2190.      
  2191.     CATEGORY: INQUIRY
  2192.      
  2193.      
  2194.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2195.     obtain the value of the current pattern height vector.
  2196.      
  2197.      
  2198.      
  2199.      
  2200.      
  2201.      
  2202.      
  2203.     INPUTS:
  2204.      
  2205.      
  2206.      
  2207.      
  2208.      
  2209.      
  2210.      
  2211.      
  2212.     OUTPUTS:
  2213.          ERROR_INDICATOR:  0  Requested value is available and is being
  2214.                               reported.
  2215.                            8  GKS is not in one of the states GKOP, WSOP,
  2216.                               WSAC, or SGOP.
  2217.          VECTOR:           Indicates the pattern height vector.
  2218.      
  2219.      
  2220.      
  2221.     ERRORS/EXCEPTIONS:
  2222.      
  2223.      
  2224.      
  2225.      
  2226.      
  2227.      
  2228.      
  2229.      
  2230.      
  2231.      
  2232.     LEVEL: Ma
  2233.      
  2234.      
  2235.     DETAILED DESCRIPTION:
  2236.          If the requested information is available, this procedure returns
  2237.     error indicator 0 and the requested information. If the requested
  2238.     information is not available, this procedure returns the appropriate
  2239.     error indicator to explain the reason for non-availability.
  2240.      
  2241.      
  2242.      
  2243.     FUNCTION NAME: INQ_PATTERN_WIDTH_VECTOR
  2244.      
  2245.     CATEGORY: INQUIRY
  2246.      
  2247.      
  2248.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2249.     obtain the value of the current pattern width vector.
  2250.      
  2251.      
  2252.      
  2253.      
  2254.      
  2255.      
  2256.      
  2257.     INPUTS:
  2258.      
  2259.      
  2260.      
  2261.      
  2262.      
  2263.      
  2264.      
  2265.      
  2266.     OUTPUTS:
  2267.          ERROR_INDICATOR:  0  Requested value is available and is being
  2268.                               reported.
  2269.                            8  GKS is not in one of the states GKOP, WSOP,
  2270.                               WSAC, or SGOP.
  2271.          WIDTH:            A vector in world coordinates describing the
  2272.                            pattern width.
  2273.      
  2274.      
  2275.     ERRORS/EXCEPTIONS:
  2276.      
  2277.      
  2278.      
  2279.      
  2280.      
  2281.      
  2282.      
  2283.      
  2284.      
  2285.      
  2286.     LEVEL: Ma
  2287.      
  2288.      
  2289.     DETAILED DESCRIPTION:
  2290.          If the requested information is available, this procedure returns
  2291.     error indicator 0 and the requested information. If the requested
  2292.     information is not available, this procedure returns the appropriate
  2293.     error indicator to explain the reason for non-availability.
  2294.      
  2295.      
  2296.      
  2297.     FUNCTION NAME: INQ_CHAR_WIDTH
  2298.      
  2299.     CATEGORY: INQUIRY
  2300.      
  2301.      
  2302.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2303.     obtain the value of the current character nominal width.
  2304.      
  2305.      
  2306.      
  2307.      
  2308.      
  2309.      
  2310.      
  2311.     INPUTS:
  2312.      
  2313.      
  2314.      
  2315.      
  2316.      
  2317.      
  2318.      
  2319.      
  2320.     OUTPUTS:
  2321.          ERROR_INDICATOR:  0  Requested value is available and is being
  2322.                               reported.
  2323.                            8  GKS is not in one of the states GKOP, WSOP,
  2324.                               WSAC, or SGOP.
  2325.          WIDTH:            Indicates the nominal width of characters.
  2326.      
  2327.      
  2328.      
  2329.     ERRORS/EXCEPTIONS:
  2330.      
  2331.      
  2332.      
  2333.      
  2334.      
  2335.      
  2336.      
  2337.      
  2338.      
  2339.      
  2340.     LEVEL: Ma
  2341.      
  2342.      
  2343.     DETAILED DESCRIPTION:
  2344.          If the requested information is available, this procedure returns
  2345.     error indicator 0 and the requested information. If the requested
  2346.     information is not available, this procedure returns the appropriate
  2347.     error indicator to explain the reason for non-availability.
  2348.      
  2349.      
  2350.      
  2351.     FUNCTION NAME: INQ_CHAR_BASE_VECTOR
  2352.      
  2353.     CATEGORY: INQUIRY
  2354.      
  2355.      
  2356.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2357.     obtain the value of the current character base vector.
  2358.      
  2359.      
  2360.      
  2361.      
  2362.      
  2363.      
  2364.      
  2365.     INPUTS:
  2366.      
  2367.      
  2368.      
  2369.      
  2370.      
  2371.      
  2372.      
  2373.      
  2374.     OUTPUTS:
  2375.          ERROR_INDICATOR:  0  Requested value is available and is being
  2376.                               reported.
  2377.                            8  GKS is not in one of the states GKOP, WSOP,
  2378.                               WSAC, or SGOP.
  2379.          VECTOR:           Indicates the character base vector in world
  2380.                            coordinates.
  2381.      
  2382.      
  2383.     ERRORS/EXCEPTIONS:
  2384.      
  2385.      
  2386.      
  2387.      
  2388.      
  2389.      
  2390.      
  2391.      
  2392.      
  2393.      
  2394.     LEVEL: Ma
  2395.      
  2396.      
  2397.     DETAILED DESCRIPTION:
  2398.          If the requested information is available, this procedure returns
  2399.     error indicator 0 and the requested information. If the requested
  2400.     information is not available, this procedure returns the appropriate
  2401.     error indicator to explain the reason for non-availability.
  2402.      
  2403.      
  2404.      
  2405.     FUNCTION NAME: INQ_POLYLINE_INDEX
  2406.      
  2407.     CATEGORY: INQUIRY
  2408.      
  2409.      
  2410.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2411.     obtain the value of the current polyline index.
  2412.      
  2413.      
  2414.      
  2415.      
  2416.      
  2417.      
  2418.      
  2419.     INPUTS:
  2420.      
  2421.      
  2422.      
  2423.      
  2424.      
  2425.      
  2426.      
  2427.      
  2428.     OUTPUTS:
  2429.          ERROR_INDICATOR:  0  Requested value is available and is being
  2430.                               reported.
  2431.                            8  GKS is not in one of the states GKOP, WSOP,
  2432.                               WSAC, or SGOP.
  2433.          INDEX:            An integer index into a polyline bundle table,
  2434.                            each entry of which contains all non-geometric
  2435.                            aspects of the polyline.
  2436.      
  2437.     ERRORS/EXCEPTIONS:
  2438.      
  2439.      
  2440.      
  2441.      
  2442.      
  2443.      
  2444.      
  2445.      
  2446.      
  2447.      
  2448.     LEVEL: Ma
  2449.      
  2450.      
  2451.      
  2452.      
  2453.      
  2454.      
  2455.      
  2456.      
  2457.      
  2458.      
  2459.      
  2460.      
  2461.      
  2462.      
  2463.      
  2464.      
  2465.      
  2466.      
  2467.     DETAILED DESCRIPTION:
  2468.          If the requested information is available, this procedure returns
  2469.     error indicator 0 and the requested information. If the requested
  2470.     information is not available, this procedure returns the appropriate
  2471.     error indicator to explain the reason for non-availability.
  2472.      
  2473.      
  2474.      
  2475.     FUNCTION NAME: INQ_POLYMARKER_INDEX
  2476.      
  2477.     CATEGORY: INQUIRY
  2478.      
  2479.      
  2480.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2481.     obtain the value of the current polymarker index.
  2482.      
  2483.      
  2484.      
  2485.      
  2486.      
  2487.      
  2488.      
  2489.     INPUTS:
  2490.      
  2491.      
  2492.      
  2493.      
  2494.      
  2495.      
  2496.      
  2497.      
  2498.     OUTPUTS:
  2499.          ERROR_INDICATOR:  0  Requested value is available and is being
  2500.                               reported.
  2501.                            8  GKS is not in one of the states GKOP, WSOP,
  2502.                               WSAC, or SGOP.
  2503.          INDEX:            An integer index into a polymarker bundle
  2504.                            table, each entry of which contains all the
  2505.                            non-geometric aspects of the polymarker.
  2506.      
  2507.     ERRORS/EXCEPTIONS:
  2508.      
  2509.      
  2510.      
  2511.      
  2512.      
  2513.      
  2514.      
  2515.      
  2516.      
  2517.      
  2518.     LEVEL: Ma
  2519.      
  2520.      
  2521.     DETAILED DESCRIPTION:
  2522.          If the requested information is available, this procedure returns
  2523.     error indicator 0 and the requested information. If the requested
  2524.     information is not available, this procedure returns the appropriate
  2525.     error indicator to explain the reason for non-availability.
  2526.      
  2527.      
  2528.      
  2529.     FUNCTION NAME: INQ_FILL_AREA_INDEX
  2530.      
  2531.     CATEGORY: INQUIRY
  2532.      
  2533.      
  2534.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2535.     obtain the value of the current fill area index.
  2536.      
  2537.      
  2538.      
  2539.      
  2540.      
  2541.      
  2542.      
  2543.     INPUTS:
  2544.      
  2545.      
  2546.      
  2547.      
  2548.      
  2549.      
  2550.      
  2551.      
  2552.     OUTPUTS:
  2553.          ERROR_INDICATOR:  0  Requested value is available and is being
  2554.                               reported.
  2555.                            8  GKS is not in one of the states GKOP, WSOP,
  2556.                               WSAC, or SGOP.
  2557.          INDEX:            An integer index into a fill area bundle table,
  2558.                            each entry of which contains all the
  2559.                            non-geometric aspects of the fill area
  2560.                            primitive.
  2561.      
  2562.     ERRORS/EXCEPTIONS:
  2563.      
  2564.      
  2565.      
  2566.      
  2567.      
  2568.      
  2569.      
  2570.      
  2571.      
  2572.     LEVEL: Ma
  2573.      
  2574.      
  2575.     DETAILED DESCRIPTION:
  2576.          If the requested information is available, this procedure returns
  2577.     error indicator 0 and the requested information. If the requested
  2578.     information is not available, this procedure returns the appropriate
  2579.     error indicator to explain the reason for non-availability.
  2580.      
  2581.      
  2582.      
  2583.     FUNCTION NAME: INQ_TEXT_INDEX
  2584.      
  2585.     CATEGORY: INQUIRY
  2586.      
  2587.      
  2588.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2589.     obtain the value of the current text index.
  2590.      
  2591.      
  2592.      
  2593.      
  2594.      
  2595.      
  2596.      
  2597.     INPUTS:
  2598.      
  2599.      
  2600.      
  2601.      
  2602.      
  2603.      
  2604.      
  2605.      
  2606.     OUTPUTS:
  2607.          ERROR_INDICATOR:  0  Requested value is available and is being
  2608.                               returned.
  2609.                            8  GKS is not in one of the states GKOP, WSOP,
  2610.                               WSAC, or SGOP.
  2611.          INDEX:            An integer index into a text bundle table, each
  2612.                            entry of which contains all the non-geometric
  2613.                            aspects of the text primitive.
  2614.      
  2615.     ERRORS/EXCEPTIONS:
  2616.      
  2617.      
  2618.      
  2619.      
  2620.      
  2621.      
  2622.      
  2623.      
  2624.      
  2625.      
  2626.     LEVEL: Ma
  2627.      
  2628.      
  2629.     DETAILED DESCRIPTION:
  2630.          If the requested information is available, this procedure returns
  2631.     error indicator 0 and the requested information. If the requested
  2632.     information is not available, this procedure returns the appropriate
  2633.     error indicator to explain the reason for non-availability.
  2634.      
  2635.      
  2636.      
  2637.     FUNCTION NAME: INQ_CURRENT_NORMALIZATION_TRANSFORMATION_NUMBER
  2638.      
  2639.     CATEGORY: INQUIRY
  2640.      
  2641.      
  2642.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2643.     obtain the current normalization transformation number.
  2644.      
  2645.      
  2646.      
  2647.      
  2648.      
  2649.      
  2650.      
  2651.     INPUTS:
  2652.      
  2653.      
  2654.      
  2655.      
  2656.      
  2657.      
  2658.      
  2659.      
  2660.     OUTPUTS:
  2661.          ERR0R_INDICATOR:  0  Requested value is available and is being
  2662.                               returned.
  2663.                            8  GKS is not in one of the states GKOP, WSOP,
  2664.                               WSAC, or SGOP.
  2665.          TRANSFORMATION:   An integer value representing the current
  2666.                            normalization transformation.
  2667.      
  2668.      
  2669.     ERRORS/EXCEPTIONS:
  2670.      
  2671.      
  2672.      
  2673.      
  2674.      
  2675.      
  2676.      
  2677.      
  2678.      
  2679.      
  2680.     LEVEL: Ma
  2681.      
  2682.      
  2683.     DETAILED DESCRIPTION:
  2684.          If the requested information is available, this procedure returns
  2685.     error indicator 0 and the requested information. If the requested
  2686.     information is not available, this procedure returns the appropriate
  2687.     error indicator to explain the reason for non-availability.
  2688.      
  2689.      
  2690.      
  2691.     FUNCTION NAME: INQ_NORMALIZATION_TRANSFORMATION
  2692.      
  2693.     CATEGORY: INQUIRY
  2694.      
  2695.      
  2696.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2697.     obtain the value of the current normalization transformation.
  2698.      
  2699.      
  2700.      
  2701.      
  2702.      
  2703.      
  2704.     INPUTS:
  2705.          TRANSFORMATION:  An integer value representing a normalization
  2706.                           transformation.
  2707.      
  2708.      
  2709.      
  2710.      
  2711.      
  2712.      
  2713.     OUTPUTS:
  2714.          ERROR_INDICATOR:  0  Requested value is available and is being
  2715.                               returned.
  2716.                            8  GKS is not in one of the states GKOP, WSOP,
  2717.                               WSAC, or SGOP.
  2718.          WINDOW_LIMITS:    This record defines the extent of the window
  2719.                            rectangle in world coordinates. Its X and Y
  2720.                            components give the limits in relation to the
  2721.                            x and y axes.
  2722.          VIEWPORT_LIMITS:  This record defines the extent of the viewport
  2723.                            rectangle in normalized device coordinates. Its
  2724.                            X and Y components give the limits in relation
  2725.                            to the x and y axes.
  2726.      
  2727.     ERRORS/EXCEPTIONS:
  2728.      
  2729.      
  2730.      
  2731.      
  2732.      
  2733.      
  2734.     LEVEL: Ma
  2735.      
  2736.      
  2737.     DETAILED DESCRIPTION:
  2738.          If the requested information is available, this procedure returns
  2739.     error indicator 0 and the requested information. If the requested
  2740.     information is not available, this procedure returns the appropriate
  2741.     error indicator to explain the reason for non-availability.
  2742.      
  2743.      
  2744.      
  2745.     FUNCTION NAME: INQ_CLIPPING
  2746.      
  2747.     CATEGORY: INQUIRY
  2748.      
  2749.      
  2750.     BRIEF DESCRIPTION:  This procedure inquires the GKS state list to
  2751.     obtain the current clipping indicator.
  2752.      
  2753.      
  2754.      
  2755.      
  2756.      
  2757.      
  2758.      
  2759.     INPUTS:
  2760.      
  2761.      
  2762.      
  2763.      
  2764.      
  2765.      
  2766.      
  2767.     OUTPUTS:
  2768.          ERROR_INDICATOR:  0  Requested value is available and is being
  2769.                               returned.
  2770.                            8  GKS is not in one of the states GKOP, WSOP,
  2771.                               WSAC, or SGOP.
  2772.          CLIPPING:         The value of this enumerated parameter may be
  2773.                            CLIP or NOCLIP. Its value determines whether
  2774.                            or not clipping is being performed on the
  2775.                            current output.
  2776.          CLIPPING_RECTANGLE:  This record defines the extent of the
  2777.                            clipping area in normalized device coordinates.
  2778.                            The X and Y components define the limits of
  2779.                            rectangle along the x and y axes.
  2780.      
  2781.     ERRORS/EXCEPTIONS:
  2782.      
  2783.      
  2784.      
  2785.      
  2786.      
  2787.      
  2788.     LEVEL: Ma
  2789.      
  2790.      
  2791.     DETAILED DESCRIPTION:
  2792.          If the requested information is available, this procedure returns
  2793.     error indicator 0 and the requested information. If the requested
  2794.     information is not available, this procedure returns the appropriate
  2795.     error indicator to explain the reason for non-availability.
  2796.      
  2797.      
  2798.      
  2799.     FUNCTION NAME: INQ_LEVEL_OF_GKS
  2800.      
  2801.     CATEGORY: INQUIRY
  2802.      
  2803.      
  2804.     BRIEF DESCRIPTION:  This procedure returns the level of GKS.
  2805.      
  2806.      
  2807.      
  2808.      
  2809.      
  2810.      
  2811.      
  2812.      
  2813.     INPUTS:
  2814.      
  2815.      
  2816.      
  2817.      
  2818.      
  2819.      
  2820.      
  2821.      
  2822.     OUTPUTS:
  2823.          ERROR_INDICATOR:  0  Requested value is available and is being
  2824.                               returned.
  2825.                            8  GKS is not in one of the states GKOP, WSOP,
  2826.                               WSAC, or SGOP.
  2827.          LEVEL:            This enumerated type gives the level of GKS.
  2828.                            Its value may be Lma, Lmb, Lmc, L0a, L0b, L0c,
  2829.                            L1a, L1b, L1c, L2a, L2b, or L2c.
  2830.      
  2831.     ERRORS/EXCEPTIONS:
  2832.      
  2833.      
  2834.      
  2835.      
  2836.      
  2837.      
  2838.      
  2839.      
  2840.      
  2841.      
  2842.     LEVEL: Ma
  2843.      
  2844.      
  2845.     DETAILED DESCRIPTION:
  2846.          If the requested information is available, this procedure returns
  2847.     error indicator 0 and the requested information. If the requested
  2848.     information is not available, this procedure returns the appropriate
  2849.     error indicator to explain the reason for non-availability.
  2850.      
  2851.      
  2852.      
  2853.     FUNCTION NAME: INQ_WS_CONNECTION_AND_TYPE
  2854.      
  2855.     CATEGORY: INQUIRY
  2856.      
  2857.      
  2858.     BRIEF DESCRIPTION:  This procedure returns the connection identifier
  2859.     and the workstation type.
  2860.      
  2861.      
  2862.      
  2863.      
  2864.      
  2865.      
  2866.     INPUTS:
  2867.          WS:  An integer value indicating the workstation identification.
  2868.      
  2869.      
  2870.      
  2871.      
  2872.      
  2873.      
  2874.      
  2875.     OUTPUTS:
  2876.          ERROR_INDICATOR:  0  Requested value is available and is being
  2877.                               returned.
  2878.                            7  GKS is not in one of the states WSOP, WSAC,
  2879.                               or SGOP.
  2880.                            20 Specified workstation identifier is invalid.
  2881.                            25 Specified workstation is not open.
  2882.          CONNECTION:       The physical identifier associated with the
  2883.                            logical WS identifier.
  2884.          TYPE_OF_WS:       An integer value representing the type of
  2885.                            workstation.
  2886.      
  2887.     ERRORS/EXCEPTIONS:
  2888.      
  2889.      
  2890.      
  2891.      
  2892.      
  2893.      
  2894.      
  2895.      
  2896.     LEVEL: Ma
  2897.      
  2898.      
  2899.     DETAILED DESCRIPTION:
  2900.          If the requested information is available, this procedure returns
  2901.     error indicator 0 and the requested information. If the requested
  2902.     information is not available, this procedure returns the appropriate
  2903.     error indicator to explain the reason for non-availability.
  2904.      
  2905.      
  2906.     FUNCTION NAME: INQ_TEXT_EXTENT
  2907.      
  2908.     CATEGORY: INQUIRY
  2909.      
  2910.      
  2911.     BRIEF DESCRIPTION:  This procedure returns the value of the text
  2912.     extent rectangle and the concatenation point.
  2913.      
  2914.      
  2915.     INPUTS:
  2916.          WS:           An integer value indicating the workstation
  2917.                        identification.
  2918.          POSITION:     This is a record with X and Y components indicating
  2919.                        the point in world coordinates where the text
  2920.                        starts.
  2921.          CHAR_STRING:  The string of text.
  2922.      
  2923.      
  2924.     OUTPUTS:
  2925.          ERROR_INDICATOR:  0  Requested value is available and is being
  2926.                               returned.
  2927.                            7  GKS is not in one of the states WSOP, WSAC,
  2928.                               or SGOP.
  2929.                            20 Specified workstation identifier is invalid.
  2930.                            25 Specified workstation is not open.
  2931.                            39 Specified workstation is neither of category
  2932.                               OUTPUT nor of category OUTIN.
  2933.                            101  Invalid Code string.
  2934.          CONCATENATION_POINT:  This is a record with X and Y components
  2935.                            indicating the point in world coordinates that
  2936.                            can be used as the origin of a subsequent text
  2937.                            output primitive (as in the concatenation of
  2938.                            strings).
  2939.          TEXT_EXTENT:      This is a record with four components
  2940.                            indicating the LOWER_LEFT, LOWER_RIGHT, UPPER_
  2941.                            LEFT, and UPPER_RIGHT corner points of the
  2942.                            text extent rectangle with respect to the
  2943.                            vertical positioning of the text. Each
  2944.                            component is a record with X and Y components
  2945.                            to indicate the point in world coordinates.
  2946.      
  2947.     ERRORS/EXCEPTIONS:
  2948.      
  2949.      
  2950.     LEVEL: Ma
  2951.      
  2952.      
  2953.     DETAILED DESCRIPTION:
  2954.          If the requested information is available, this procedure returns
  2955.     error indicator 0 and the requested information. If the requested
  2956.     information is not available, this procedure returns the appropriate
  2957.     error indicator to explain the reason for non-availability.
  2958.      
  2959.      
  2960.      
  2961.     FUNCTION NAME: INQ_LIST_OF_COLOUR_INDICES
  2962.      
  2963.     CATEGORY: INQUIRY
  2964.      
  2965.      
  2966.     BRIEF DESCRIPTION:  This procedure returns the list of defined
  2967.     fill area indices for a particular workstation.
  2968.      
  2969.      
  2970.      
  2971.      
  2972.      
  2973.      
  2974.     INPUTS:
  2975.          WS:  An integer value indicating the workstation identification.
  2976.      
  2977.      
  2978.      
  2979.      
  2980.      
  2981.      
  2982.     OUTPUTS:
  2983.          ERROR_INDICATOR:  0  Requested value is available and is being
  2984.                               returned.
  2985.                            7  GKS is not in one of the states WSOP, WSAC,
  2986.                               or SGOP.
  2987.                            20 Specified workstation identifier is invalid.
  2988.                            25 Specified workstation is not open.
  2989.                            33 Specified workstation is of category MI.
  2990.                            35 Specified workstation is of category INPUT.
  2991.                            36 Specified workstation is Workstation
  2992.                               Independent Segment Storage.
  2993.          INDICES:          This is a set type of colour indices.
  2994.      
  2995.      
  2996.      
  2997.     ERRORS/EXCEPTIONS:
  2998.      
  2999.      
  3000.      
  3001.      
  3002.      
  3003.     LEVEL: Ma
  3004.      
  3005.      
  3006.     DETAILED DESCRIPTION:
  3007.          If the requested information is available, this procedure returns
  3008.     error indicator 0 and the requested information. If the requested
  3009.     information is not available, this procedure returns the appropriate
  3010.     error indicator to explain the reason for non-availability.
  3011.      
  3012.      
  3013.      
  3014.      
  3015.     FUNCTION NAME: INQ_COLOUR_REPRESENTATION
  3016.      
  3017.     CATEGORY: INQUIRY
  3018.      
  3019.      
  3020.     BRIEF DESCRIPTION:  This procedure returns a value for the colour
  3021.     intensities for a colour index on a workstation.
  3022.      
  3023.      
  3024.     INPUTS:
  3025.          WS:              An integer value indicating the workstation
  3026.                           identification.
  3027.          INDEX:           An integer value indicating the colour index
  3028.                           into the colour table.
  3029.          RETURNED_VALUES: This is and enumerated parameter which may be a
  3030.                           value of SET or REALIZED to indicate whether the
  3031.                           returned values should be as they were set by
  3032.                           the program or as they were actually realized.
  3033.      
  3034.     OUTPUTS:
  3035.          ERROR_INDICATOR:  0  Requested value is available and is being
  3036.                               returned.
  3037.                            7  GKS is not in one of the states WSOP, WSAC,
  3038.                               or SGOP.
  3039.                            20 Specified workstation identifier is invalid.
  3040.                            25 Specified workstation is not open.
  3041.                            33 Specified workstation is of category MI.
  3042.                            35 Specified workstation is of category INPUT.
  3043.                            36 Specified workstation is Workstation
  3044.                               Independent Segment Storage.
  3045.                            93 Colour index is invalid.
  3046.                            94 A representation for the specified colour
  3047.                               index has not been defined on this
  3048.                               workstation.
  3049.          COLOUR:           This is a record with components RED, GREEN,
  3050.                            and BLUE that represent the colour as a
  3051.                            combination of intensities.
  3052.      
  3053.     ERRORS/EXCEPTIONS:
  3054.      
  3055.      
  3056.      
  3057.     LEVEL: Ma
  3058.      
  3059.      
  3060.     DETAILED DESCRIPTION:
  3061.          If the requested information is available, this procedure returns
  3062.     error indicator 0 and the requested information. If the requested
  3063.     information is not available, this procedure returns the appropriate
  3064.     error indicator to explain the reason for non-availability.
  3065.      
  3066.      
  3067.      
  3068.      
  3069.     FUNCTION NAME: INQ_WS_TRANSFORMATION
  3070.      
  3071.     CATEGORY: INQUIRY
  3072.      
  3073.      
  3074.     BRIEF DESCRIPTION:  This procedure returns information on the
  3075.     workstation transformation.
  3076.      
  3077.      
  3078.     INPUTS:
  3079.          WS: An integer value representing the workstation identification.
  3080.      
  3081.      
  3082.     OUTPUTS:
  3083.          ERROR_INDICATOR:  0  Requested value is available and is being
  3084.                               reported.
  3085.                            7  GKS is not in one of the states WSOP, WSAC,
  3086.                               or SGOP.
  3087.                            20 Specified workstation identifier is invalid.
  3088.                            25 Specified workstation is not open.
  3089.                            33 Specified workstation is of category MI.
  3090.                            36 Specified workstation is Workstation
  3091.                               Independent Segment Storage.
  3092.          UPDATE:           This enumerated parameter may have the value
  3093.                            NOTPENDING or PENDING to indicate whether or
  3094.                            not a workstation transformation change has
  3095.                            been requested and not yet provided.
  3096.          REQUESTED_WINDOW: This record defines the extent of the requested
  3097.                            window (the window set by SET_WS_WINDOW) in
  3098.                            normalized device coordinates. Its X and Y
  3099.                            components give the limits in relation to the
  3100.                            x and y axes.
  3101.          CURRENT_WINDOW:   This record defines the extent of the current
  3102.                            window in normalized device coordinates. Its X
  3103.                            and Y components give the limits in relation to
  3104.                            the x and y axes.
  3105.          REQUESTED_VIEWPORT:  This record defines the extent of the
  3106.                            requested viewport (the viewport set by SET_
  3107.                            WS_VIEWPORT) in device coordinates. Its X and Y
  3108.                            components give the limits in relation to the
  3109.                            x and y axes.
  3110.          CURRENT_VIEWPORT: This record defines the extent of the current
  3111.                            viewport in device coordinates. Its X and Y
  3112.                            components give the limits in relation to the
  3113.                            x and y axes.
  3114.      
  3115.     ERRORS/EXCEPTIONS:
  3116.      
  3117.      
  3118.     LEVEL: Ma
  3119.      
  3120.      
  3121.     DETAILED DESCRIPTION:
  3122.          This procedure calls the workstation manager to obtain the
  3123.     following workstation transformation information:
  3124.          1) the workstation transformation update state
  3125.          2) the requested workstation window
  3126.          3) the current workstation window
  3127.          4) the requested workstation viewport
  3128.          5) the current workstation viewport.
  3129.          If the requested information is available, this procedure returns
  3130.     error indicator 0 and the requested information. If the requested
  3131.     information is not available, this procedure returns the appropriate
  3132.     error indicator to explain the reason for non-availability.
  3133.      
  3134.      
  3135.      
  3136.      
  3137.      
  3138.      
  3139.      
  3140.      
  3141.      
  3142.      
  3143.      
  3144.      
  3145.      
  3146.     FUNCTION NAME: INQ_DISPLAY_SPACE_SIZE
  3147.      
  3148.     CATEGORY: INQUIRY
  3149.      
  3150.      
  3151.     BRIEF DESCRIPTION:  This procedure returns the size of the display
  3152.     space.
  3153.      
  3154.      
  3155.      
  3156.      
  3157.     INPUTS:
  3158.          WS:  An integer value indicating the workstation identification.
  3159.      
  3160.      
  3161.      
  3162.      
  3163.     OUTPUTS:
  3164.          ERROR_INDICATOR:  0  Requested value is available and is being
  3165.                               reported.
  3166.                            8  GKS is not in one of the states GKOP, WSOP,
  3167.                               WSAC, or SGOP.
  3168.                            22 Specified workstation type is invalid.
  3169.                            23 Specified workstation type does not exist.
  3170.                            31 Specified workstation is of category MO.
  3171.                            33 Specified workstation is of category MI.
  3172.                            36 Specified workstation is Workstation
  3173.                               Independent Segment Storage.
  3174.          UNITS:            This is an enumerated parameter which indicates
  3175.                            if the device coordinate units for the WS are
  3176.                            in METRES or OTHER.
  3177.          MAX_DC_SIZE:      This record gives the maximum device coordinate
  3178.                            magnitude as length along the X and Y axes
  3179.                            (which are the components of the record).
  3180.          MAX_RASTER_UNIT_SIZE:  This record provides the raster unit size
  3181.                            in terms of the raster units along the X and Y
  3182.                            axes. X and Y are the components of the record.
  3183.      
  3184.     ERRORS/EXCEPTIONS:
  3185.      
  3186.      
  3187.      
  3188.      
  3189.     LEVEL: Ma
  3190.      
  3191.      
  3192.     DETAILED DESCRIPTION:
  3193.          If the requested information is available, this procedure returns
  3194.     error indicator 0 and the requested information. If the requested
  3195.     information is not available, this procedure returns the appropriate
  3196.     error indicator to explain the reason for non-availability.
  3197.      
  3198.      
  3199.      
  3200.     FUNCTION NAME: INQ_POLYLINE_FACILITIES
  3201.      
  3202.     CATEGORY: INQUIRY
  3203.      
  3204.      
  3205.     BRIEF DESCRIPTION:  This procedure returns the values of the
  3206.     facilities for polyline.
  3207.      
  3208.      
  3209.      
  3210.     INPUTS:
  3211.          WS:  An integer value indicating the workstation identification.
  3212.      
  3213.      
  3214.      
  3215.     OUTPUTS:
  3216.          ERROR_INDICATOR:  0  Requested value is available and is being
  3217.                               reported.
  3218.                            8  GKS is not in one of the states GKOP, WSOP,
  3219.                               WSAC, or SGOP.
  3220.                            22 Specified workstation type is invalid.
  3221.                            23 Specified workstation type does not exist.
  3222.                            39 Specified workstation is neither of category
  3223.                               OUTPUT nor of category OUTIN.
  3224.          LIST_OF_TYPES:    This is a set type of LINE_TYPES.
  3225.          NUMBER_OF_WIDTHS: This is a natural number representing the
  3226.                            number of line widths.
  3227.          NOMINAL_WIDTH:    Indicates the nominal magnitude of the line in
  3228.                            device coordinates.
  3229.          RANGE_OF_WIDTHS:  This record gives the MIN and MAX width limits
  3230.                            for polylines.
  3231.          NUMBER_OF_INDICES:  This is a natural number representing the
  3232.                            number of indices.
  3233.      
  3234.     ERRORS/EXCEPTIONS:
  3235.      
  3236.      
  3237.      
  3238.     LEVEL: Ma
  3239.      
  3240.      
  3241.     DETAILED DESCRIPTION:
  3242.          This procedure call the workstation manager to obtain the values
  3243.     of the facilities for polyline. These include:
  3244.          1) the number of available linetypes
  3245.          2) the list of available linetypes
  3246.          3) the number of available linewidths
  3247.          4) the nominal linewidth
  3248.          5) the range of linewidths (minimum, maximum)
  3249.          6) the number of predefined polyline indices.
  3250.          If the requested information is available, this procedure returns
  3251.     error indicator 0 and the requested information. If the requested
  3252.     information is not available, this procedure returns the appropriate
  3253.     error indicator to explain the reason for non-availability.
  3254.      
  3255.      
  3256.      
  3257.      
  3258.      
  3259.      
  3260.      
  3261.      
  3262.      
  3263.      
  3264.      
  3265.      
  3266.      
  3267.     FUNCTION NAME: INQ_POLYMARKER_FACILITIES
  3268.      
  3269.     CATEGORY: INQUIRY
  3270.      
  3271.      
  3272.     BRIEF DESCRIPTION:  This procedure returns the values of the
  3273.     facilities for polymarker.
  3274.      
  3275.      
  3276.      
  3277.     INPUTS:
  3278.          WS:  An integer value indicating the workstation identification.
  3279.      
  3280.      
  3281.      
  3282.     OUTPUTS:
  3283.          ERROR_INDICATOR:  0  Requested value is available and is being
  3284.                               returned.
  3285.                            8  GKS is not in one of the states GKOP, WSOP,
  3286.                               WSAC, or SGOP.
  3287.                            22 Specified workstation type is invalid.
  3288.                            23 Specified workstation type does not exist.
  3289.                            39 Specified workstation is neither of category
  3290.                               OUTPUT nor of category OUTIN.
  3291.          LIST_OF_TYPES:    This is a set type of MARKER_TYPES.
  3292.          NUMBER_OF_SIZES:  This is a natural number representing the
  3293.                            number of marker sizes.
  3294.          NOMINAL_SIZE:     Indicates the nominal magnitude of the marker
  3295.                            in device coordinates.
  3296.          RANGE_OF_SIZES:   This record gives the MIN and MAX size limits
  3297.                            for polymarkers.
  3298.          NUMBER_OF_INDICES:  This is a natural number representing the
  3299.                            number of indices.
  3300.      
  3301.     ERRORS/EXCEPTIONS:
  3302.      
  3303.      
  3304.      
  3305.     LEVEL: Ma
  3306.      
  3307.      
  3308.     DETAILED DESCRIPTION:
  3309.          This procedure calls the workstation manager to obtain the values
  3310.     of the facilities for polymarker. These include:
  3311.          1) the number of available marker types
  3312.          2) the list of available marker types
  3313.          3) the number of available marker sizes
  3314.          4) the nominal marker size
  3315.          5) the range of marker sizes (minimum, maximum)
  3316.          6) the number of predefined polymarker indices.
  3317.          If the requested information is available, this procedure returns
  3318.     error indicator 0 and the requested information. If the requested
  3319.     information is not available, this procedure returns the appropriate
  3320.     error indicator to explain the reason for non-availability.
  3321.      
  3322.      
  3323.      
  3324.      
  3325.      
  3326.      
  3327.      
  3328.      
  3329.      
  3330.      
  3331.      
  3332.      
  3333.      
  3334.     FUNCTION NAME: INQ_TEXT_FACILITIES
  3335.      
  3336.     CATEGORY: INQUIRY
  3337.      
  3338.      
  3339.     BRIEF DESCRIPTION:  This procedure returns the values of the
  3340.     facilities for text.
  3341.      
  3342.      
  3343.      
  3344.     INPUTS:
  3345.          WS:  An integer value indicating the workstation identification.
  3346.      
  3347.      
  3348.      
  3349.     OUTPUTS:
  3350.          ERROR_INDICATOR:  0  Requested value is available and is being
  3351.                               returned.
  3352.                            8  GKS is not in one of the states GKOP, WSOP,
  3353.                               WSAC, or SGOP.
  3354.                            22 Specified workstation type is invalid.
  3355.                            23 Specified workstation type does not exist.
  3356.                            39 Specified workstation is neither of category
  3357.                               OUTPUT nor of category OUTIN.
  3358.          LIST_OF_FONT_PRECISION_PAIRS:  This is a record containing a list
  3359.                            of records which provide the text FONT and
  3360.                            PRECISION.
  3361.          NUMBER_OF_HEIGHTS:  A natural number representing the number of
  3362.                            text character heights.
  3363.          NUMBER_OF_EXPANSIONS:  A natural number representing the number
  3364.                            of expansion factors available.
  3365.          EXPANSION_RANGE:  This record gives the MIN and MAX values for
  3366.                            the character expansion factors in device
  3367.                            coordinates.
  3368.          NUMBER_OF_INDICES:  A natural number representing the number of
  3369.                            indices.
  3370.      
  3371.     ERRORS/EXCEPTIONS:
  3372.      
  3373.      
  3374.      
  3375.     LEVEL: Ma
  3376.      
  3377.      
  3378.     DETAILED DESCRIPTION:
  3379.          This procedure calls the workstation manager to obtain the
  3380.     values of the facilities for text. These include:
  3381.          1) the number of text font and precision pairs
  3382.          2) the list of text font and precision pairs
  3383.          3) the number of available character heights
  3384.          4) the minimum character height
  3385.          5) the maximum character height
  3386.          6) the number of available character expansion factors
  3387.          7) the minimum character expansion factor
  3388.          8) the maximum character expansion factor
  3389.          9) the number of predefined text indices.
  3390.          If the requested information is available, this procedure returns
  3391.     error indicator 0 and the requested information. If the requested
  3392.     information is not available, this procedure returns the appropriate
  3393.     error indicator to explain the reason for non-availability.
  3394.      
  3395.      
  3396.      
  3397.      
  3398.      
  3399.      
  3400.      
  3401.      
  3402.      
  3403.      
  3404.      
  3405.      
  3406.      
  3407.     FUNCTION NAME: INQ_FILL_AREA_FACILITIES
  3408.      
  3409.     CATEGORY: INQUIRY
  3410.      
  3411.      
  3412.     BRIEF DESCRIPTION:  This procedure returns the values for the
  3413.     facilities for the fill area construct.
  3414.      
  3415.      
  3416.      
  3417.      
  3418.     INPUTS:
  3419.          WS:  An integer value indicating the workstation identification.
  3420.      
  3421.      
  3422.      
  3423.     OUTPUTS:
  3424.          ERROR_INDICATOR:  0  Requested value is available and is being
  3425.                               returned.
  3426.                            8  GKS is not in one of the states GKOP, WSOP,
  3427.                               WSAC, or SGOP.
  3428.                            22 Specified workstation type is invalid.
  3429.                            23 Specified workstation type does not exist.
  3430.                            39 Specified workstation is neither of category
  3431.                               OUTPUT nor of category OUTIN.
  3432.          LIST_OF_INTERIOR_STYLES:  This is a set of the interior styles
  3433.                            available. The values of the components are set
  3434.                            to 1 if the corresponding style is available.
  3435.          LIST_OF_HATCH_STYLES:  This is a set of the hatch styles
  3436.                            available. The values of the components are set
  3437.                            to 1 if the corresponding hatch style is
  3438.                            available.
  3439.          NUMBER_OF_INDICES:  A natural number representing the number of
  3440.                            indices.
  3441.      
  3442.     ERRORS/EXCEPTIONS:
  3443.      
  3444.      
  3445.      
  3446.     LEVEL: Ma
  3447.      
  3448.      
  3449.     DETAILED DESCRIPTION:
  3450.          This procedure calls the workstation manager to obtain the
  3451.     values of the facilities for the fill area construct. These include:
  3452.          1) the number of available fill area interior styles
  3453.          2) the list of available fill area interior styles
  3454.          3) the number of available hatch styles
  3455.          4) the list of available hatch styles
  3456.          5) the number of predefined fill area indices.
  3457.          If the requested information is available, this procedure returns
  3458.     error indicator 0 and the requested information. If the requested
  3459.     information is not available, this procedure returns the appropriate
  3460.     error indicator to explain the reason for non-availability.
  3461.      
  3462.      
  3463.      
  3464.      
  3465.      
  3466.      
  3467.      
  3468.      
  3469.      
  3470.      
  3471.      
  3472.      
  3473.      
  3474.     FUNCTION NAME: INQ_COLOUR_FACILITIES
  3475.      
  3476.     CATEGORY: INQUIRY
  3477.      
  3478.      
  3479.     BRIEF DESCRIPTION:  This procedure returns the values of the
  3480.     facilities for colour.
  3481.      
  3482.      
  3483.      
  3484.     INPUTS:
  3485.          WS:  An integer value indicating the workstation identification.
  3486.      
  3487.      
  3488.      
  3489.     OUTPUTS:
  3490.          ERROR_INDICATOR:  0  Requested value is available and is being
  3491.                               returned.
  3492.                            8  GKS is not in one of the states GKOP, WSOP,
  3493.                               WSAC, or SGOP.
  3494.                            22 Specified workstation type is invalid.
  3495.                            23 Specified workstation type does not exist.
  3496.                            39 Specified workstation is neither of category
  3497.                               OUTPUT nor of category OUTIN.
  3498.          NUMBER_OF_COLOURS:  A positive number indicating the number of
  3499.                            colours available.
  3500.          AVAILABLE_COLOUR: The value of this enumerated parameter can be
  3501.                            COLOUR or MONOCHROME to indicate whether
  3502.                            colour output is available on WS.
  3503.          NUMBER_OF_COLOUR_INDICES:  An integer value representing the
  3504.                            number of colour indices.
  3505.      
  3506.     ERRORS/EXCEPTIONS:
  3507.      
  3508.      
  3509.      
  3510.      
  3511.     LEVEL: Ma
  3512.      
  3513.      
  3514.     DETAILED DESCRIPTION:
  3515.          This procedure calls the workstation manager to obtain the
  3516.     values of the facilities for colour. These include:
  3517.          1) the number of available colours or intensities
  3518.          2) whether or not colour is available
  3519.          3) the number of predefined colour indices.
  3520.          If the requested information is available, this procedure returns
  3521.     error indicator 0 and the requested information. If the requested
  3522.     information is not available, this procedure returns the appropriate
  3523.     error indicator to explain the reason for non-availability.
  3524.      
  3525.      
  3526.      
  3527.      
  3528.     FUNCTION NAME: INQ_MAX_LENGTH_OF_WS_STATE_TABLES
  3529.      
  3530.     CATEGORY: INQUIRY
  3531.      
  3532.      
  3533.     BRIEF DESCRIPTION:  This procedure returns the values of the maximum
  3534.     number of entries in the workstation state tables.
  3535.      
  3536.      
  3537.      
  3538.     INPUTS:
  3539.          WS:  An integer value indicating the workstation identification.
  3540.      
  3541.      
  3542.      
  3543.     OUTPUTS:
  3544.          ERROR_INDICATOR:  0  Requested value is available and is being
  3545.                               returned.
  3546.                            8  GKS is not in one of the states GKOP, WSOP,
  3547.                               WSAC, or SGOP.
  3548.                            22 Specified workstation type is invalid.
  3549.                            23 Specified workstation type does not exist.
  3550.                            39 Specified workstation is neither of category
  3551.                               OUTPUT nor of category OUTIN.
  3552.          MAX_POLYLINE_ENTRIES:  A natural number representing the maximum
  3553.                            number of polyline entries in the workstation
  3554.                            state tables.
  3555.          MAX_POLYMARKER_TABLES:  A natural number representing the
  3556.                            maximum number of polymarker entries in the
  3557.                            workstation state tables.
  3558.          MAX_TEXT_ENTRIES: A natural number representing the maximum
  3559.                            number of text entries in the workstation state
  3560.                            tables.
  3561.          MAX_FILL_AREA_ENTRIES:  A natural number representing the maximum
  3562.                            number of fill area entries in the workstation
  3563.                            state tables.
  3564.          MAX_PATTERN_INDICES:  A natural number representing the maximum
  3565.                            number of pattern indices in the workstation
  3566.                            state tables.
  3567.          MAX_COLOUR_INDICES:  A natural number representing the maximum
  3568.                            number of colour indices in the workstation
  3569.                            state tables.
  3570.      
  3571.     ERRORS/EXCEPTIONS:
  3572.      
  3573.      
  3574.      
  3575.      
  3576.     LEVEL: Ma
  3577.      
  3578.      
  3579.     DETAILED DESCRIPTION:
  3580.          This procedure calls the workstation manager to obtain the
  3581.     values of the maximum number of entries in the following bundle
  3582.     tables:
  3583.          1) polyline
  3584.          2) polymarker
  3585.          3) text
  3586.          4) fill area.
  3587.          It also obtains the maximum number of pattern indices and the
  3588.     maximum number of colour indices.
  3589.          If the requested information is available, this procedure returns
  3590.     error indicator 0 and the requested information. If the requested
  3591.     information is not available, this procedure returns the appropriate
  3592.     error indicator to explain the reason for non-availability.
  3593.      
  3594.      
  3595.      
  3596.      
  3597.      
  3598.      
  3599.      
  3600.      
  3601.      
  3602.      
  3603.      
  3604.      
  3605.      
  3606.     FUNCTION NAME: INQ_LIST_OF_AVAILABLE_WS_TYPES
  3607.      
  3608.     CATEGORY: INQUIRY
  3609.      
  3610.      
  3611.     BRIEF DESCRIPTION:  This procedure returns the list of available
  3612.     workstation types.
  3613.      
  3614.      
  3615.      
  3616.      
  3617.      
  3618.      
  3619.      
  3620.     INPUTS:
  3621.      
  3622.      
  3623.      
  3624.      
  3625.      
  3626.      
  3627.      
  3628.     OUTPUTS:
  3629.          ERROR_INDICATOR:  0  Requested value is available and is being
  3630.                               returned.
  3631.                            8  GKS is not in one of the states GKOP, WSOP,
  3632.                               WSAC, or SGOP.
  3633.          TYPES:            This is a list of workstation types.
  3634.      
  3635.      
  3636.      
  3637.     ERRORS/EXCEPTIONS:
  3638.      
  3639.      
  3640.      
  3641.      
  3642.      
  3643.      
  3644.      
  3645.      
  3646.      
  3647.      
  3648.     LEVEL: 0A
  3649.      
  3650.      
  3651.     DETAILED DESCRIPTION:
  3652.          If the requested information is available, this procedure returns
  3653.     error indicator 0 and the requested information. If the requested
  3654.     information is not available, this procedure returns the appropriate
  3655.     error indicator to explain the reason for non-availability.
  3656.      
  3657.      
  3658.      
  3659.     FUNCTION NAME: INQ_MAX_NORMALIZATION_TRANSFORMATION_NUMBER
  3660.      
  3661.     CATEGORY: INQUIRY
  3662.      
  3663.      
  3664.     BRIEF DESCRIPTION:  This procedure returns the maximum normalization
  3665.     transformation number.
  3666.      
  3667.      
  3668.      
  3669.      
  3670.      
  3671.      
  3672.      
  3673.     INPUTS:
  3674.      
  3675.      
  3676.      
  3677.      
  3678.      
  3679.      
  3680.      
  3681.      
  3682.     OUTPUTS:
  3683.          ERROR_INDICATOR:  0  Requested value is available and is being
  3684.                               returned.
  3685.                            8  GKS is not in one of the states GKOP, WSOP,
  3686.                               WSAC, or SGOP.
  3687.          TRANSFORMATION:   An integer value representing the maximum
  3688.                            transformation number available.
  3689.      
  3690.      
  3691.     ERRORS/EXCEPTIONS:
  3692.      
  3693.      
  3694.      
  3695.      
  3696.      
  3697.      
  3698.      
  3699.      
  3700.      
  3701.      
  3702.     LEVEL: 0A
  3703.      
  3704.      
  3705.     DETAILED DESCRIPTION:
  3706.          If the requested information is available, this procedure returns
  3707.     error indicator 0 and the requested information. If the requested
  3708.     information is not available, this procedure returns the appropriate
  3709.     error indicator to explain the reason for non-availability.
  3710.      
  3711.      
  3712.      
  3713.     FUNCTION NAME: INQ_OPERATING_STATE_VALUE
  3714.      
  3715.     CATEGORY: INQUIRY
  3716.      
  3717.      
  3718.     BRIEF DESCRIPTION:  This procedure returns the operating state.
  3719.      
  3720.      
  3721.      
  3722.      
  3723.      
  3724.      
  3725.      
  3726.      
  3727.     INPUTS:
  3728.      
  3729.      
  3730.      
  3731.      
  3732.      
  3733.      
  3734.      
  3735.      
  3736.     OUTPUTS:
  3737.          VALUE:  The value of this enumerated parameter may be GKCL, GKOP,
  3738.                  WSOP, WSAC, or SGOP to indicate the current operating
  3739.                  state of GKS.
  3740.      
  3741.      
  3742.      
  3743.      
  3744.      
  3745.     ERRORS/EXCEPTIONS:
  3746.      
  3747.      
  3748.      
  3749.      
  3750.      
  3751.      
  3752.      
  3753.      
  3754.      
  3755.      
  3756.     LEVEL: 0A
  3757.      
  3758.      
  3759.     DETAILED DESCRIPTION:
  3760.          This procedure returns the current operating state of GKS. No
  3761.     error indicator is returned.
  3762.      
  3763.      
  3764.      
  3765.      
  3766.      
  3767.     FUNCTION NAME: INQ_SET_OF_OPEN_WS
  3768.      
  3769.     CATEGORY: INQUIRY
  3770.      
  3771.      
  3772.     BRIEF DESCRIPTION:  This procedure returns the set of open
  3773.     workstations.
  3774.      
  3775.      
  3776.      
  3777.      
  3778.      
  3779.      
  3780.      
  3781.     INPUTS:
  3782.      
  3783.      
  3784.      
  3785.      
  3786.      
  3787.      
  3788.      
  3789.      
  3790.     OUTPUTS:
  3791.          ERROR_INDICATOR:  0  Requested value is available and is being
  3792.                               returned.
  3793.                            8  GKS is not in one of the states GKOP, WSOP,
  3794.                               WSAC, or SGOP.
  3795.          WS:               This is the set of workstation identifiers.
  3796.      
  3797.      
  3798.      
  3799.     ERRORS/EXCEPTIONS:
  3800.      
  3801.      
  3802.      
  3803.      
  3804.      
  3805.      
  3806.      
  3807.      
  3808.     LEVEL: 0A
  3809.      
  3810.      
  3811.     DETAILED DESCRIPTION:
  3812.          This procedure returns the set of open workstations. At levels
  3813.     ma and 0a there need only be one workstation in the set.
  3814.          If the requested information is available, this procedure returns
  3815.     error indicator 0 and the requested information. If the requested
  3816.     information is not available, this procedure returns the appropriate
  3817.     error indicator to explain the reason for non-availability.
  3818.      
  3819.      
  3820.      
  3821.     FUNCTION NAME: INQ_LIST_OF_NORMALIZATION_TRANSFORMATION_NUMBERS
  3822.      
  3823.     CATEGORY: INQUIRY
  3824.      
  3825.      
  3826.     BRIEF DESCRIPTION:  This procedure returns the list of normalization
  3827.     transformation numbers.
  3828.      
  3829.      
  3830.      
  3831.      
  3832.      
  3833.      
  3834.     INPUTS:
  3835.      
  3836.      
  3837.      
  3838.      
  3839.      
  3840.      
  3841.      
  3842.     OUTPUTS:
  3843.          ERROR_INDICATOR:  0  Requested value is available and is being
  3844.                               returned.
  3845.                            8  GKS is not in one of the states GKOP, WSOP,
  3846.                               WSAC, or SGOP.
  3847.          LIST:             This is a list of the normalization
  3848.                            transformation numbers.
  3849.      
  3850.      
  3851.     ERRORS/EXCEPTIONS:
  3852.      
  3853.      
  3854.      
  3855.      
  3856.      
  3857.      
  3858.      
  3859.      
  3860.     LEVEL: 0A
  3861.      
  3862.      
  3863.     DETAILED DESCRIPTION:
  3864.          This procedure returns the list of normalization transformation
  3865.     numbers. The list is ordered by viewport input priority, starting with
  3866.     the highest priority transformation number.
  3867.          If the requested information is available, this procedure returns
  3868.     error indicator 0 and the requested information. If the requested
  3869.     information is not available, this procedure returns the appropriate
  3870.     error indicator to explain the reason for non-availability.
  3871.      
  3872.      
  3873.      
  3874.      
  3875.     FUNCTION NAME: INQ_WS_CATEGORY
  3876.      
  3877.     CATEGORY: INQUIRY
  3878.      
  3879.      
  3880.     BRIEF DESCRIPTION:  This procedure returns the workstation category.
  3881.      
  3882.      
  3883.      
  3884.      
  3885.      
  3886.      
  3887.      
  3888.      
  3889.     INPUTS:
  3890.          WS: An integer value representing the type of workstation.
  3891.      
  3892.      
  3893.      
  3894.      
  3895.      
  3896.      
  3897.     OUTPUTS:
  3898.          ERROR_INDICATOR:  0  Requested value is available and is being
  3899.                               returned.
  3900.                            8  GKS is not in one of the states GKOP, WSOP,
  3901.                               WSAC, or SGOP.
  3902.                            22 Specified workstation type is invalid.
  3903.                            23 Specified workstation type does not exist.
  3904.          CATEGORY:         The value of this enumerated parameter may be
  3905.                            OUTPUT, INPUT, OUTIN, WISS, MO, or MI to
  3906.                            indicate the category of the workstation.
  3907.      
  3908.     ERRORS/EXCEPTIONS:
  3909.      
  3910.      
  3911.      
  3912.      
  3913.      
  3914.      
  3915.      
  3916.      
  3917.      
  3918.     LEVEL: 0A
  3919.      
  3920.      
  3921.     DETAILED DESCRIPTION:
  3922.          If the requested information is available, this procedure returns
  3923.     error indicator 0 and the requested information. If the requested
  3924.     information is not available, this procedure returns the appropriate
  3925.     error indicator to explain the reason for non-availability.
  3926.      
  3927.      
  3928.      
  3929.     FUNCTION NAME: INQ_WS_CLASS
  3930.      
  3931.     CATEGORY: INQUIRY
  3932.      
  3933.      
  3934.     BRIEF DESCRIPTION:  This procedure returns the workstation class.
  3935.      
  3936.      
  3937.      
  3938.      
  3939.      
  3940.      
  3941.      
  3942.     INPUTS:
  3943.          WS: An integer value representing the type of workstation.
  3944.      
  3945.      
  3946.      
  3947.      
  3948.      
  3949.      
  3950.     OUTPUTS:
  3951.          ERROR_INDICATOR:  0  Requested value is available and is being
  3952.                               returned.
  3953.                            8  GKS is not in one of the states GKOP, WSOP,
  3954.                               WSAC, or SGOP.
  3955.                            22 Specified workstation type is invalid.
  3956.                            23 Specified workstation type does not exist.
  3957.                            39 Specified workstation is neither of category
  3958.                               OUTPUT nor of category OUTIN.
  3959.          CLASS:            The value of this parameter may be VECTOR_
  3960.                            DISPLAY, RASTER_DISPLAY, or OTHER_DISPLAY to
  3961.                            indicate the classification of a workstation of
  3962.                            category OUTPUT or OUTIN.
  3963.      
  3964.     ERRORS/EXCEPTIONS:
  3965.      
  3966.      
  3967.      
  3968.      
  3969.      
  3970.      
  3971.      
  3972.     LEVEL: 0A
  3973.      
  3974.      
  3975.     DETAILED DESCRIPTION:
  3976.          If the requested information is available, this procedure returns
  3977.     error indicator 0 and the requested information. If the requested
  3978.     information is not available, this procedure returns the appropriate
  3979.     error indicator to explain the reason for non-availability.
  3980.      
  3981.      
  3982.      
  3983.     FUNCTION NAME: INQ_PREDEFINED_POLYLINE_REPRESENTATION
  3984.      
  3985.     CATEGORY: INQUIRY
  3986.      
  3987.      
  3988.     BRIEF DESCRIPTION:  This procedure returns the workstation predefined
  3989.     polyline information.
  3990.      
  3991.      
  3992.      
  3993.     INPUTS:
  3994.          WS:    An integer value representing the type of workstation.
  3995.          INDEX: An integer value representing the index into the polyline
  3996.                 tables.
  3997.      
  3998.      
  3999.      
  4000.     OUTPUTS:
  4001.          ERROR_INDICATOR:  0  Requested value is available and is being
  4002.                               returned.
  4003.                            8  GKS is not in one of the states GKOP, WSOP,
  4004.                               WSAC, or SGOP.
  4005.                            22 Specified workstation type is invalid.
  4006.                            23 Specified workstation type does not exist.
  4007.                            39 Specified workstation is neither of category
  4008.                               OUTPUT nor of category OUTIN.
  4009.                            60 Polyline index is invalid.
  4010.                            62 A representation for the specified polyline
  4011.                               has not been predefined on this workstation.
  4012.          LINE:             An integer value representing the line type.
  4013.          WIDTH:            A positive floating point value representing
  4014.                            the nominal line width.
  4015.          COLOUR:           An integer value representing an index into the
  4016.                            colour tables.
  4017.      
  4018.     ERRORS/EXCEPTIONS:
  4019.      
  4020.      
  4021.      
  4022.      
  4023.      
  4024.      
  4025.     LEVEL: 0A
  4026.      
  4027.      
  4028.     DETAILED DESCRIPTION:
  4029.          If the requested information is available, this procedure returns
  4030.     error indicator 0 and the requested information. If the requested
  4031.     information is not available, this procedure returns the appropriate
  4032.     error indicator to explain the reason for non-availability.
  4033.      
  4034.      
  4035.      
  4036.      
  4037.     FUNCTION NAME: INQ_PREDEFINED_POLYMARKER_REPRESENTATION
  4038.      
  4039.     CATEGORY: INQUIRY
  4040.      
  4041.      
  4042.     BRIEF DESCRIPTION:  This procedure returns the workstation predefined
  4043.     polymarker information.
  4044.      
  4045.      
  4046.      
  4047.      
  4048.     INPUTS:
  4049.          WS:    An integer value representing the type of workstation.
  4050.          INDEX: An integer value representing the index into the
  4051.                 polymarker tables.
  4052.      
  4053.      
  4054.      
  4055.      
  4056.     OUTPUTS:
  4057.          ERROR_INDICATOR:  0  Requested value is available and is being
  4058.                               returned.
  4059.                            8  GKS is not in one of the states GKOP, WSOP,
  4060.                               WSAC, or SGOP.
  4061.                            22 Specified workstation type is invalid.
  4062.                            23 Specified workstation type does not exist.
  4063.                            39 Specified workstation is neither of category
  4064.                               OUTPUT nor of category OUTIN.
  4065.                            66 Polymarker index is invalid.
  4066.                            68 A representation for the specified
  4067.                               polymarker index has not been predefined on
  4068.                               this workstation.
  4069.          MARKER:           An integer value representing the marker type.
  4070.          SIZE:             A positive floating point value representing
  4071.                            the nominal marker size.
  4072.          COLOUR:           An integer value representing an index into the
  4073.                            colour tables.
  4074.      
  4075.     ERRORS/EXCEPTIONS:
  4076.      
  4077.      
  4078.      
  4079.      
  4080.     LEVEL: 0A
  4081.      
  4082.      
  4083.     DETAILED DESCRIPTION:
  4084.          If the requested information is available, this procedure returns
  4085.     error indicator 0 and the requested information. If the requested
  4086.     information is not available, this procedure returns the appropriate
  4087.     error indicator to explain the reason for non-availability.
  4088.      
  4089.      
  4090.      
  4091.     FUNCTION NAME: INQ_PREDEFINED_TEXT_REPRESENTATION
  4092.      
  4093.     CATEGORY: INQUIRY
  4094.      
  4095.      
  4096.     BRIEF DESCRIPTION:  This procedure returns the workstation predefined
  4097.     text information.
  4098.      
  4099.      
  4100.      
  4101.     INPUTS:
  4102.          WS:    An integer value representing the type of workstation.
  4103.          INDEX: An integer value representing the index into the text
  4104.                 tables.
  4105.      
  4106.      
  4107.      
  4108.     OUTPUTS:
  4109.          ERROR_INDICATOR:  0  Requested value is available and is being
  4110.                               returned.
  4111.                            8  GKS is not in one of the states GKOP, WSOP,
  4112.                               WSAC, or SGOP.
  4113.                            22 Specified workstation type is invalid.
  4114.                            23 Specified workstation type does not exist.
  4115.                            39 Specified workstation is neither of category
  4116.                               OUTPUT nor of category OUTIN.
  4117.                            72 Text index is invalid.
  4118.                            74 A representation for the specified text
  4119.                               index has not been predefined on this
  4120.                               workstation.
  4121.          FONT_PRECISION:   The two components of this record describe the
  4122.                            text font and precision aspect. The component
  4123.                            FONT is an integer value representing the
  4124.                            character font. The component PRECISION may
  4125.                            have the value STRING_PRECISION,
  4126.                            CHAR_PRECISION, or STROKE_PRECISION to
  4127.                            indicate the text precision.
  4128.          EXPANSION:        A positive floating point value representing
  4129.                            the nominal character expansion amount.
  4130.          SPACING:          A floating point value representing the
  4131.                            character spacing factor. A positive value
  4132.                            indicates the amount of space between
  4133.                            characters in a text string, and a negative
  4134.                            value indicates the amount of overlap between
  4135.                            characters.
  4136.          COLOUR:           An integer value representing an index into the
  4137.                            colour tables.
  4138.      
  4139.     ERRORS/EXCEPTIONS:
  4140.      
  4141.      
  4142.      
  4143.     LEVEL: 0A
  4144.      
  4145.      
  4146.     DETAILED DESCRIPTION:
  4147.          If the requested information is available, this procedure returns
  4148.     error indicator 0 and the requested information. If the requested
  4149.     information is not available, this procedure returns the appropriate
  4150.     error indicator to explain the reason for non-availability.
  4151.      
  4152.      
  4153.      
  4154.      
  4155.      
  4156.      
  4157.      
  4158.      
  4159.      
  4160.      
  4161.      
  4162.      
  4163.      
  4164.     FUNCTION NAME: INQ_PREDEFINED_FILL_AREA_REPRESENTATION
  4165.      
  4166.     CATEGORY: INQUIRY
  4167.      
  4168.      
  4169.     BRIEF DESCRIPTION:  This procedure returns the workstation predefined
  4170.     fill area information
  4171.      
  4172.      
  4173.     INPUTS:
  4174.          WS:    An integer value representing the type of workstation.
  4175.          INDEX: An integer value representing the index into the fill area
  4176.                 tables.
  4177.      
  4178.      
  4179.     OUTPUTS:
  4180.          ERROR_INDICATOR:  0  Requested value is available and is being
  4181.                               returned.
  4182.                            8  GKS is not in one of the states GKOP, WSOP,
  4183.                               WSAC, or SGOP.
  4184.                            22 Specified workstation type is invalid.
  4185.                            23 Specified workstation type does not exist.
  4186.                            39 Specified workstation is neither of category
  4187.                               OUTPUT nor of category OUTIN.
  4188.                            80 Fill area index is invalid.
  4189.                            82 A representation for the specified fill area
  4190.                               index has not been predefined on this
  4191.                               workstation.
  4192.          INTERIOR:         This is the interior style.
  4193.          STYLE:            This is a variant record defining the fill area
  4194.                            style. When the discriminant is HOLLOW or
  4195.                            SOLID, the index is null. When the discriminant
  4196.                            is PATTERN, the style index is an index into
  4197.                            the pattern tables. When the discriminant is
  4198.                            HATCH, the style index indicates which hatch
  4199.                            style is to be used.
  4200.          COLOUR:           An integer value representing an index into the
  4201.                            colour tables.
  4202.      
  4203.     ERRORS/EXCEPTIONS:
  4204.      
  4205.      
  4206.      
  4207.     LEVEL: 0A
  4208.      
  4209.      
  4210.     DETAILED DESCRIPTION:
  4211.          If the requested information is available, this procedure returns
  4212.     error indicator 0 and the requested information. If the requested
  4213.     information is not available, this procedure returns the appropriate
  4214.     error indicator to explain the reason for non-availability.
  4215.      
  4216.      
  4217.      
  4218.     FUNCTION NAME: INQ_PATTERN_FACILITIES
  4219.      
  4220.     CATEGORY: INQUIRY
  4221.      
  4222.      
  4223.     BRIEF DESCRIPTION:  This procedure returns the number of predefined
  4224.     pattern indices.
  4225.      
  4226.      
  4227.      
  4228.      
  4229.      
  4230.      
  4231.     INPUTS:
  4232.          WS: An integer value representing the type of workstation.
  4233.      
  4234.      
  4235.      
  4236.      
  4237.      
  4238.      
  4239.      
  4240.     OUTPUTS:
  4241.          ERROR_INDICATOR:  0  Requested value is available and is being
  4242.                               returned.
  4243.                            8  GKS is not in one of the states GKOP, WSOP,
  4244.                               WSAC, or SGOP.
  4245.                            22 Specified workstation type is invalid.
  4246.                            23 Specified workstation type does not exist.
  4247.                            39 Specified workstation is neither of category
  4248.                               OUTPUT nor of category OUTIN.
  4249.          NUMBER_OF_INDICES:  A natural number indicating the number of
  4250.                            pattern indices.
  4251.      
  4252.      
  4253.      
  4254.     ERRORS/EXCEPTIONS:
  4255.      
  4256.      
  4257.      
  4258.      
  4259.      
  4260.      
  4261.     LEVEL: 0A
  4262.      
  4263.      
  4264.     DETAILED DESCRIPTION:
  4265.          If the requested information is available, this procedure returns
  4266.     error indicator 0 and the requested information. If the requested
  4267.     information is not available, this procedure returns the appropriate
  4268.     error indicator to explain the reason for non-availability.
  4269.      
  4270.      
  4271.      
  4272.     FUNCTION NAME: INQ_PREDEFINED_PATTERN_REPRESENTATION
  4273.      
  4274.     CATEGORY: INQUIRY
  4275.      
  4276.      
  4277.     BRIEF DESCRIPTION:  This procedure returns the workstation predefined
  4278.     pattern information.
  4279.      
  4280.      
  4281.      
  4282.      
  4283.     INPUTS:
  4284.          WS:    An integer value representing the type of workstation.
  4285.          INDEX: An integer value representing the index into the pattern
  4286.                 tables.
  4287.      
  4288.      
  4289.      
  4290.      
  4291.     OUTPUTS:
  4292.          ERROR_INDICATOR:  0  Requested value is available and is being
  4293.                               returned.
  4294.                            8  GKS is not in one of the states GKOP, WSOP,
  4295.                               WSAC, or SGOP.
  4296.                            22 Specified workstation type is invalid.
  4297.                            23 Specified workstation type does not exist.
  4298.                            39 Specified workstation is neither of category
  4299.                               OUTPUT nor of category OUTIN.
  4300.                            85 Specified pattern index is invalid.
  4301.                            89 A representation for the specified pattern
  4302.                               index has not been predefined on this
  4303.                               workstation.
  4304.                            90 Interior style PATTERN is not supported on
  4305.                               this workstation.
  4306.          PATTERN:          This is a record that defines a matrix whose
  4307.                            dimensions may vary dynamically. It contains
  4308.                            colour indices as elements.
  4309.      
  4310.     ERRORS/EXCEPTIONS:
  4311.      
  4312.      
  4313.      
  4314.      
  4315.     LEVEL: 0A
  4316.      
  4317.      
  4318.     DETAILED DESCRIPTION:
  4319.          If the requested information is available, this procedure returns
  4320.     error indicator 0 and the requested information. If the requested
  4321.     information is not available, this procedure returns the appropriate
  4322.     error indicator to explain the reason for non-availability.
  4323.      
  4324.      
  4325.      
  4326.     FUNCTION NAME: INQ_PREDEFINED_COLOUR_REPRESENTATION
  4327.      
  4328.     CATEGORY: INQUIRY
  4329.      
  4330.      
  4331.     BRIEF DESCRIPTION:  This procedure returns the workstation predefined
  4332.     colour information.
  4333.      
  4334.      
  4335.      
  4336.      
  4337.      
  4338.     INPUTS:
  4339.          WS:    An integer value representing the type of workstation.
  4340.          INDEX: An integer value representing the index into the pattern
  4341.                 tables.
  4342.      
  4343.      
  4344.      
  4345.      
  4346.     OUTPUTS:
  4347.          ERROR_INDICATOR:  0  Requested value is available and is being
  4348.                               returned.
  4349.                            8  GKS is not in one of the states GKOP, WSOP,
  4350.                               WSAC, or SGOP.
  4351.                            22 Specified workstation type is invalid.
  4352.                            23 Specified workstation type does not exist.
  4353.                            39 Specified workstation is neither of category
  4354.                               OUTPUT nor of category OUTIN.
  4355.                            93 Colour index is invalid.
  4356.                            95 A representation for the specified colour
  4357.                               index has not been predefined on this
  4358.                               workstation.
  4359.          COLOUR:           This is a record with three components, RED,
  4360.                            GREEN, and BLUE which define the representation
  4361.                            of a colour as a combination of intensities.
  4362.      
  4363.     ERRORS/EXCEPTIONS:
  4364.      
  4365.      
  4366.      
  4367.      
  4368.      
  4369.     LEVEL: 0A
  4370.      
  4371.      
  4372.     DETAILED DESCRIPTION:
  4373.          If the requested information is available, this procedure returns
  4374.     error indicator 0 and the requested information. If the requested
  4375.     information is not available, this procedure returns the appropriate
  4376.     error indicator to explain the reason for non-availability.
  4377.      
  4378.      
  4379.      
  4380.     FUNCTION NAME: INQ_LIST_OF_AVAILABLE_GDP
  4381.      
  4382.     CATEGORY: INQUIRY
  4383.      
  4384.      
  4385.     BRIEF DESCRIPTION:  This procedure returns the list of generalized
  4386.     drawing primitive identifiers.
  4387.      
  4388.      
  4389.      
  4390.      
  4391.      
  4392.      
  4393.     INPUTS:
  4394.          WS: An integer value representing the type of workstation.
  4395.      
  4396.      
  4397.      
  4398.      
  4399.      
  4400.      
  4401.     OUTPUTS:
  4402.          ERROR_INDICATOR:  0  Requested value is available and is being
  4403.                               returned.
  4404.                            8  GKS is not in one of the states GKOP, WSOP,
  4405.                               WSAC, or SGOP.
  4406.                            22 Specified workstation type is invalid.
  4407.                            23 Specified workstation type does not exist.
  4408.                            39 Specified workstation is neither of category
  4409.                               OUTPUT nor of category OUTIN.
  4410.          LIST_OF_GDP:      This is the set of GDP identifiers.
  4411.      
  4412.      
  4413.      
  4414.      
  4415.      
  4416.      
  4417.     ERRORS/EXCEPTIONS:
  4418.      
  4419.      
  4420.      
  4421.      
  4422.      
  4423.     LEVEL: 0A
  4424.      
  4425.      
  4426.     DETAILED DESCRIPTION:
  4427.          If the requested information is available, this procedure returns
  4428.     error indicator 0 and the requested information. If the requested
  4429.     information is not available, this procedure returns the appropriate
  4430.     error indicator to explain the reason for non-availability.
  4431.      
  4432.      
  4433.      
  4434.     FUNCTION NAME: INQ_GDP
  4435.      
  4436.     CATEGORY: INQUIRY
  4437.      
  4438.      
  4439.     BRIEF DESCRIPTION:  This procedure returns a list of sets of
  4440.     attributes used for a specific generalized drawing primitive.
  4441.      
  4442.      
  4443.      
  4444.      
  4445.      
  4446.     INPUTS:
  4447.          WS:  An integer value representing the type of workstation.
  4448.          GDP: An integer value representing a generalized drawing
  4449.               primitive.
  4450.      
  4451.      
  4452.      
  4453.      
  4454.     OUTPUTS:
  4455.          ERROR_INDICATOR:  0  Requested value is available and is being
  4456.                               returned.
  4457.                            8  GKS is not in one of the states GKOP, WSOP,
  4458.                               WSAC, or SGOP.
  4459.                            22 Specified workstation type is invalid.
  4460.                            23 Specified workstation type does not exist.
  4461.                            39 Specified workstation is neither of category
  4462.                               OUTPUT nor of category OUTIN.
  4463.                            41 Specified workstation is not able to
  4464.                               generate the specified generalized drawing
  4465.                               primitive.
  4466.          LIST_OF_ATTRIBUTES_USED:  The components of this record may be
  4467.                            set to 1 or 0 to indicate whether the following
  4468.                            attributes are used: POLYLINE_ATTRIBUTES,
  4469.                            POLYMARKER_ATTRIBUTES, TEXT_ATTRIBUTES, or
  4470.                            FILL_AREA_ATTRIBUTES.
  4471.      
  4472.     ERRORS/EXCEPTIONS:
  4473.      
  4474.      
  4475.      
  4476.      
  4477.     LEVEL: 0A
  4478.      
  4479.      
  4480.     DETAILED DESCRIPTION:
  4481.          If the requested information is available, this procedure returns
  4482.     error indicator 0 and the requested information. If the requested
  4483.     information is not available, this procedure returns the appropriate
  4484.     error indicator to explain the reason for non-availability.
  4485.      
  4486.      
  4487.      
  4488.     FUNCTION NAME: INQ_WS_STATE
  4489.      
  4490.     CATEGORY: INQUIRY
  4491.      
  4492.      
  4493.     BRIEF DESCRIPTION:  This procedure returns the workstation state.
  4494.      
  4495.      
  4496.      
  4497.      
  4498.      
  4499.      
  4500.      
  4501.      
  4502.     INPUTS:
  4503.          WS:  An integer value representing the workstation identifier.
  4504.      
  4505.      
  4506.      
  4507.      
  4508.      
  4509.      
  4510.      
  4511.     OUTPUTS:
  4512.          ERROR_INDICATOR:  0  Requested value is available and is being
  4513.                               returned.
  4514.                            7  GKS is not in one of the states WSOP, WSAC,
  4515.                               or SGOP.
  4516.                            20 Specified Workstation identifier is invalid.
  4517.                            25 Specified workstation is not open.
  4518.                            33 Specified workstation is of category MI.
  4519.                            35 Specified workstation is of category INPUT.
  4520.          STATE:            Returns either ACTIVE or INACTIVE.
  4521.      
  4522.     ERRORS/EXCEPTIONS:
  4523.      
  4524.      
  4525.      
  4526.      
  4527.      
  4528.      
  4529.      
  4530.      
  4531.     LEVEL: 0A
  4532.      
  4533.      
  4534.     DETAILED DESCRIPTION:
  4535.          If the requested information is available, this procedure returns
  4536.     error indicator 0 and the requested information. If the requested
  4537.     information is not available, this procedure returns the appropriate
  4538.     error indicator to explain the reason for non-availability.
  4539.      
  4540.      
  4541.      
  4542.     FUNCTION NAME: INQ_WS_DEFERRAL_AND_UPDATE_STATES
  4543.      
  4544.     CATEGORY: INQUIRY
  4545.      
  4546.      
  4547.     BRIEF DESCRIPTION:  This procedure returns the workstation deferral
  4548.     and update states.
  4549.      
  4550.      
  4551.      
  4552.      
  4553.     INPUTS:
  4554.          WS:  An integer value representing the workstation identifier.
  4555.      
  4556.      
  4557.      
  4558.     OUTPUTS:
  4559.          ERROR_INDICATOR:  0  Requested value is available and is being
  4560.                               returned.
  4561.                            7  GKS is not in one of the states WSOP, WSAC,
  4562.                               or SGOP.
  4563.                            20 Specified Workstation identifier is invalid.
  4564.                            25 Specified workstation is not open.
  4565.                            33 Specified workstation is of category MI.
  4566.                            35 Specified workstation is of category INPUT.
  4567.                            36 Specified workstation is Workstation
  4568.                               Independent Segment Storage.
  4569.          DEFERRAL:         Returns the deferral mode of the specified
  4570.                            workstation.
  4571.          REGENERATION:     Returns the implicit regeneration mode of the
  4572.                            specified workstation.
  4573.          DISPLAY:          Returns whether the display surface is empty.
  4574.          FRAME_ACTION:     Returns whether a frame action is necessary at
  4575.                            update time.
  4576.      
  4577.     ERRORS/EXCEPTIONS:
  4578.      
  4579.      
  4580.      
  4581.     LEVEL: 0A
  4582.      
  4583.      
  4584.     DETAILED DESCRIPTION:
  4585.          This procedure returns the workstation deferral mode and the
  4586.     implicit regeneration mode. It also determines whether the display
  4587.     surface is empty, and whether frame action is necessary at update
  4588.     time.
  4589.          If the requested information is available, this procedure returns
  4590.     error indicator 0 and the requested information. If the requested
  4591.     information is not available, this procedure returns the appropriate
  4592.     error indicator to explain the reason for non-availability.
  4593.      
  4594.      
  4595.      
  4596.     FUNCTION NAME: INQ_PIXEL_ARRAY_DIMENSIONS
  4597.      
  4598.     CATEGORY: INQUIRY
  4599.      
  4600.      
  4601.     BRIEF DESCRIPTION:  This procedure returns the pixel array dimensions.
  4602.      
  4603.      
  4604.      
  4605.      
  4606.      
  4607.      
  4608.     INPUTS:
  4609.          WS:           Determines the specified workstation whose device
  4610.                        coordinate resolution is used to calculate the
  4611.                        dimensions of the pixel array.
  4612.          CORNER_1_1:   Specifies the lower left point of the inquired
  4613.                        pixel array area.
  4614.          CORNER_DX_DY: Specifies the upper right point of the inquired
  4615.                        pixel array area.
  4616.      
  4617.     OUTPUTS:
  4618.          ERROR_INDICATOR:  0  Requested value is available and is being
  4619.                               returned.
  4620.                            7  GKS is not in one of the states WSOP, WSAC,
  4621.                               or SGOP.
  4622.                            20 Specified Workstation identifier is invalid.
  4623.                            25 Specified workstation is not open.
  4624.                            39 Specified workstation is neither of category
  4625.                               OUTPUT nor of category OUTIN.
  4626.          DIMENSIONS:       Returns the dimensions, in raster units, of the
  4627.                            inquired pixel area.
  4628.      
  4629.      
  4630.      
  4631.      
  4632.     ERRORS/EXCEPTIONS:
  4633.      
  4634.      
  4635.      
  4636.      
  4637.      
  4638.      
  4639.     LEVEL: 0A
  4640.      
  4641.      
  4642.     DETAILED DESCRIPTION:
  4643.          If the requested information is available, this procedure returns
  4644.     error indicator 0 and the requested information. If the requested
  4645.     information is not available, this procedure returns the appropriate
  4646.     error indicator to explain the reason for non-availability.
  4647.      
  4648.      
  4649.      
  4650.     FUNCTION NAME: INQ_PIXEL_ARRAY
  4651.      
  4652.     CATEGORY: INQUIRY
  4653.      
  4654.      
  4655.     BRIEF DESCRIPTION:  This procedure returns the presence of invalid
  4656.     values and the colour index array.
  4657.      
  4658.      
  4659.      
  4660.     INPUTS:
  4661.          WS:     Determines the specified workstation whose pixels are
  4662.                  inquired for colour values.
  4663.          CORNER: The point in WC that will be transformed to NDC and
  4664.                  sent to CGI as the initial point where the pixels will be
  4665.                  inquired for colour values.
  4666.          DX:     The WC x-axis offset of the block of pixels to be
  4667.                  inquired for colour.
  4668.          DY:     The WC y-axis offset of the block of pixels to be
  4669.                  inquired for colour.
  4670.      
  4671.     OUTPUTS:
  4672.          ERROR_INDICATOR:  0  Requested value is available and is being
  4673.                               returned.
  4674.                            7  GKS is not in one of the states WSOP, WSAC,
  4675.                               or SGOP.
  4676.                            20 Specified Workstation identifier is invalid.
  4677.                            25 Specified workstation is not open.
  4678.                            39 Specified workstation is neither of category
  4679.                               OUTPUT nor of category OUTIN.
  4680.                            40 Specified workstation has no pixel store
  4681.                               readback capacity.
  4682.                            91 Dimensions of colour array are invalid.
  4683.          INVALID_VALUES:   A flag to indicate the presence of pixels which
  4684.                            had been transformed outside the workstation's
  4685.                            viewport.
  4686.          PIXEL_ARRAY:      The array of colour values of the pixel area
  4687.                            inquired on the workstation.
  4688.      
  4689.     ERRORS/EXCEPTIONS:
  4690.      
  4691.      
  4692.      
  4693.     LEVEL: 0A
  4694.      
  4695.      
  4696.     DETAILED DESCRIPTION:
  4697.          If the requested information is available, this procedure returns
  4698.     error indicator 0 and the requested information. If the requested
  4699.     information is not available, this procedure returns the appropriate
  4700.     error indicator to explain the reason for non-availability.
  4701.      
  4702.      
  4703.      
  4704.     FUNCTION NAME: INQ_PIXEL
  4705.      
  4706.     CATEGORY: INQUIRY
  4707.      
  4708.      
  4709.     BRIEF DESCRIPTION:  This procedure returns the colour index of the
  4710.     pixel.
  4711.      
  4712.      
  4713.      
  4714.      
  4715.      
  4716.     INPUTS:
  4717.          WS:    An integer value which specifies the workstation.
  4718.          POINT: The WC point which, when transformed to NDC, will be
  4719.                 passed to WS_MANAGER for inquiring the DC pixel colour.
  4720.      
  4721.      
  4722.      
  4723.      
  4724.      
  4725.     OUTPUTS:
  4726.          ERROR_INDICATOR:  0  Requested value is available and is being
  4727.                               returned.
  4728.                            7  GKS is not in one of the states WSOP, WSAC,
  4729.                               or SGOP.
  4730.                            20 Specified Workstation identifier is invalid.
  4731.                            25 Specified workstation is not open.
  4732.                            39 Specified workstation is neither of category
  4733.                               OUTPUT nor of category OUTIN.
  4734.                            40 Specified workstation has no pixel store
  4735.                               readback capacity.
  4736.          COLOUR:           Returns the colour of the pixel of a valid
  4737.                            point on the workstation viewport.
  4738.      
  4739.      
  4740.      
  4741.      
  4742.     ERRORS/EXCEPTIONS:
  4743.      
  4744.      
  4745.      
  4746.      
  4747.     LEVEL: 0A
  4748.      
  4749.      
  4750.     DETAILED DESCRIPTION:
  4751.          If the requested information is available, this procedure returns
  4752.     error indicator 0 and the requested information. If the requested
  4753.     information is not available, this procedure returns the appropriate
  4754.     error indicator to explain the reason for non-availability.
  4755.      
  4756.      
  4757.      
  4758.     FUNCTION NAME: INQ_WS_MAX_NUMBERS
  4759.      
  4760.     CATEGORY: INQUIRY
  4761.      
  4762.      
  4763.     BRIEF DESCRIPTION:  This procedure returns the maximum limits for
  4764.     certain workstation values.
  4765.      
  4766.      
  4767.      
  4768.      
  4769.      
  4770.      
  4771.     INPUTS:
  4772.      
  4773.      
  4774.      
  4775.      
  4776.      
  4777.      
  4778.     OUTPUTS:
  4779.          ERROR_INDICATOR:  0  Requested value is available and is being
  4780.                               returned.
  4781.                            8  GKS is not in one of the state GKOP, WSOP,
  4782.                               WSAC, or SGOP.
  4783.          MAX_OPEN_WS:      This specifies the maximum number of
  4784.                            simultaneously open workstations.
  4785.          MAX_ACTIVE_WS:    This specifies the maximum number of
  4786.                            simultaneously active workstations.
  4787.          MAX_SEGMENT_WS:   This specifies the maximum number of
  4788.                            workstations associated with a segment.
  4789.      
  4790.     ERRORS/EXCEPTIONS:
  4791.      
  4792.      
  4793.      
  4794.      
  4795.      
  4796.     LEVEL: 1A
  4797.      
  4798.      
  4799.     DETAILED DESCRIPTION:
  4800.          This procedure returns three values from the GKS description
  4801.     table:
  4802.          1) Maximum number of simultaneously open workstations.
  4803.          2) Maximum number of simultaneously active workstations.
  4804.          3) Maximum number of workstations associated with a segment.
  4805.          If the requested information is available, this procedure returns
  4806.     error indicator 0 and the requested information. If the requested
  4807.     information is not available, this procedure returns the appropriate
  4808.     error indicator to explain the reason for non-availability.
  4809.      
  4810.      
  4811.      
  4812.     FUNCTION NAME: INQ_SET_OF_ACTIVE_WS
  4813.      
  4814.     CATEGORY: INQUIRY
  4815.      
  4816.      
  4817.     BRIEF DESCRIPTION:  This procedure returns the set of active
  4818.     workstations.
  4819.      
  4820.      
  4821.      
  4822.      
  4823.      
  4824.      
  4825.      
  4826.     INPUTS:
  4827.      
  4828.      
  4829.      
  4830.      
  4831.      
  4832.      
  4833.      
  4834.      
  4835.     OUTPUTS:
  4836.          ERROR_INDICATOR:  0  Requested value is available and is being
  4837.                               returned.
  4838.                            8  GKS is not in one of the states GKOP, WSOP,
  4839.                               WSAC, or SGOP.
  4840.          WS:               This is the set of active workstations.
  4841.      
  4842.      
  4843.      
  4844.     ERRORS/EXCEPTIONS:
  4845.      
  4846.      
  4847.      
  4848.      
  4849.      
  4850.      
  4851.      
  4852.      
  4853.      
  4854.      
  4855.     LEVEL: 1A
  4856.      
  4857.      
  4858.     DETAILED DESCRIPTION:
  4859.          If the requested information is available, this procedure returns
  4860.     error indicator 0 and the requested information. If the requested
  4861.     information is not available, this procedure returns the appropriate
  4862.     error indicator to explain the reason for non-availability.
  4863.      
  4864.      
  4865.      
  4866.     FUNCTION NAME: INQ_NAME_OF_OPEN_SEGMENT
  4867.      
  4868.     CATEGORY: INQUIRY
  4869.      
  4870.      
  4871.     BRIEF DESCRIPTION:  This procedure returns the name of the currently
  4872.     open segment.
  4873.      
  4874.      
  4875.      
  4876.      
  4877.      
  4878.      
  4879.      
  4880.     INPUTS:
  4881.      
  4882.      
  4883.      
  4884.      
  4885.      
  4886.      
  4887.      
  4888.      
  4889.     OUTPUTS:
  4890.          ERROR_INDICATOR:  0  Requested value is available and is being
  4891.                               returned.
  4892.                            4  GKS is not in the state SGOP.
  4893.          SEGMENT:          This is the identifier of the open segment.
  4894.      
  4895.      
  4896.      
  4897.      
  4898.     ERRORS/EXCEPTIONS:
  4899.      
  4900.      
  4901.      
  4902.      
  4903.      
  4904.      
  4905.      
  4906.      
  4907.      
  4908.      
  4909.     LEVEL: 1A
  4910.      
  4911.      
  4912.     DETAILED DESCRIPTION:
  4913.          If the requested information is available, this procedure returns
  4914.     error indicator 0 and the requested information. If the requested
  4915.     information is not available, this procedure returns the appropriate
  4916.     error indicator to explain the reason for non-availability.
  4917.      
  4918.      
  4919.      
  4920.     FUNCTION NAME: INQ_SET_OF_SEGMENT_NAMES_IN_USE
  4921.      
  4922.     CATEGORY: INQUIRY
  4923.      
  4924.      
  4925.     BRIEF DESCRIPTION:  This procedure returns the set of segment names
  4926.     in use.
  4927.      
  4928.      
  4929.      
  4930.      
  4931.      
  4932.      
  4933.      
  4934.     INPUTS:
  4935.      
  4936.      
  4937.      
  4938.      
  4939.      
  4940.      
  4941.      
  4942.      
  4943.     OUTPUTS:
  4944.          ERROR_INDICATOR: 0  Requested value is available and is being
  4945.                              returned.
  4946.                           7  GKS is not in one of the states WSOP, WSAC,
  4947.                              or SGOP.
  4948.          SEGMENT:         This is the list of segment names in use.
  4949.      
  4950.      
  4951.      
  4952.     ERRORS/EXCEPTIONS:
  4953.      
  4954.      
  4955.      
  4956.      
  4957.      
  4958.      
  4959.      
  4960.      
  4961.      
  4962.      
  4963.     LEVEL: 1A
  4964.      
  4965.      
  4966.     DETAILED DESCRIPTION:
  4967.          If the requested information is available, this procedure returns
  4968.     error indicator 0 and the requested information. If the requested
  4969.     information is not available, this procedure returns the appropriate
  4970.     error indicator to explain the reason for non-availability.
  4971.      
  4972.      
  4973.      
  4974.     FUNCTION NAME: INQ_SET_OF_ASSOCIATED_WS
  4975.      
  4976.     CATEGORY: INQUIRY
  4977.      
  4978.      
  4979.     BRIEF DESCRIPTION:  This procedure returns the set of workstations
  4980.     associated with a particular segment.
  4981.      
  4982.      
  4983.      
  4984.      
  4985.      
  4986.      
  4987.      
  4988.     INPUTS:
  4989.          SEGMENT: This is the identifier of the segment on which the set
  4990.                   of workstations is being inquired.
  4991.      
  4992.      
  4993.      
  4994.      
  4995.      
  4996.      
  4997.     OUTPUTS:
  4998.          ERROR_INDICATOR:  0   Requested value is available and is being
  4999.                                returned.
  5000.                            7   GKS is not in one of the states WSOP, WSAC,
  5001.                                or SGOP.
  5002.                            122 Specified segment does not exist.
  5003.          LIST_OF_WS:       The list of workstations associated with this
  5004.                            segment.
  5005.      
  5006.     ERRORS/EXCEPTIONS:
  5007.      
  5008.      
  5009.      
  5010.      
  5011.      
  5012.      
  5013.      
  5014.      
  5015.      
  5016.      
  5017.     LEVEL: 1A
  5018.      
  5019.      
  5020.     DETAILED DESCRIPTION:
  5021.          If the requested information is available, this procedure returns
  5022.     error indicator 0 and the requested information. If the requested
  5023.     information is not available, this procedure returns the appropriate
  5024.     error indicator to explain the reason for non-availability.
  5025.      
  5026.      
  5027.      
  5028.     FUNCTION NAME: INQ_SEGMENT_ATTRIBUTES
  5029.      
  5030.     CATEGORY: INQUIRY
  5031.      
  5032.      
  5033.     BRIEF DESCRIPTION:  This procedure returns the values of the segment
  5034.     attributes.
  5035.      
  5036.      
  5037.      
  5038.      
  5039.      
  5040.      
  5041.     INPUTS:
  5042.          SEGMENT: This is the identifier of the segment on which the
  5043.                   attributes are being inquired.
  5044.      
  5045.      
  5046.      
  5047.      
  5048.      
  5049.      
  5050.     OUTPUTS:
  5051.          ERROR_INDICATOR:  0   Requested value is available and is being
  5052.                                returned.
  5053.                            7   GKS is not in one of the states WSOP, WSAC,
  5054.                            122 Specified segment does not exist.
  5055.          TRANSFORMATION:   This is the transformation matrix.
  5056.          VISIBILITY:       This is the visibility of the segment. Values
  5057.                            can be VISIBLE or INVISIBLE.
  5058.          HIGHLIGHTING:     This is the highlighting of the segment. Values
  5059.                            can be NORMAL or HIGHLIGHTED.
  5060.          PRIORITY:         This is the priority of the segment.
  5061.          DETECTABILITY:    This is the detectability of the segment.
  5062.                            Values can be UNDETECTABLE or DETECTABLE.
  5063.      
  5064.     ERRORS/EXCEPTIONS:
  5065.      
  5066.      
  5067.      
  5068.      
  5069.      
  5070.      
  5071.     LEVEL: 1A
  5072.      
  5073.      
  5074.     DETAILED DESCRIPTION:
  5075.          If the requested information is available, this procedure returns
  5076.     error indicator 0 and the requested information. If the requested
  5077.     information is not available, this procedure returns the appropriate
  5078.     error indicator to explain the reason for non-availability.
  5079.      
  5080.      
  5081.      
  5082.     FUNCTION NAME: INQ_LIST_OF_POLYLINE_INDICES
  5083.      
  5084.     CATEGORY: INQUIRY
  5085.      
  5086.      
  5087.     BRIEF DESCRIPTION:  This procedure returns the list of polyline
  5088.     indices.
  5089.      
  5090.      
  5091.      
  5092.      
  5093.      
  5094.      
  5095.     INPUTS:
  5096.          WS: An integer value representing the workstation identifier.
  5097.      
  5098.      
  5099.      
  5100.      
  5101.      
  5102.      
  5103.      
  5104.     OUTPUTS:
  5105.          ERROR_INDICATOR:  0  Requested value is available and is being
  5106.                               returned.
  5107.                            7  GKS is not in one of the states WSOP, WSAC,
  5108.                               or SGOP.
  5109.                            25 Specified workstation is not open.
  5110.                            33 Specified workstation is of category MI.
  5111.                            35 Specified workstation is of category INPUT.
  5112.                            36 Specified workstation is Workstation
  5113.                               Independent Segment Storage.
  5114.          INDICES:          This is the list of polyline indices.
  5115.      
  5116.     ERRORS/EXCEPTIONS:
  5117.      
  5118.      
  5119.      
  5120.      
  5121.      
  5122.      
  5123.      
  5124.      
  5125.     LEVEL: 1A
  5126.      
  5127.      
  5128.     DETAILED DESCRIPTION:
  5129.          If the requested information is available, this procedure returns
  5130.     error indicator 0 and the requested information. If the requested
  5131.     information is not available, this procedure returns the appropriate
  5132.     error indicator to explain the reason for non-availability.
  5133.      
  5134.      
  5135.      
  5136.     FUNCTION NAME: INQ_POLYLINE_REPRESENTATION
  5137.      
  5138.     CATEGORY: INQUIRY
  5139.      
  5140.      
  5141.     BRIEF DESCRIPTION:  This procedure returns the polyline
  5142.     representation.
  5143.      
  5144.      
  5145.      
  5146.      
  5147.     INPUTS:
  5148.          WS:              An integer value representing the workstation
  5149.                           identifier.
  5150.          INDEX:           The identifier of the index into the set of
  5151.                           polylines discerning which polyline
  5152.                           representation is being inquired.
  5153.          RETURNED_VALUES: This determines how the values will be returned.
  5154.                           If it is 'set,' the values will be returned
  5155.                           according to the program setting. If it is
  5156.                           'realized,' they will be returned according to
  5157.                           how they are actually represented.
  5158.      
  5159.     OUTPUTS:
  5160.          ERROR_INDICATOR:  0  Requested value is available and is being
  5161.                               returned.
  5162.                            7  GKS is not in one of the state WSOP, WSAC,
  5163.                               or SGOP.
  5164.                            25 Specified workstation is not open.
  5165.                            33 Specified workstation is of category MI.
  5166.                            35 Specified workstation is of category INPUT.
  5167.                            36 Specified workstation is Workstation
  5168.                               Independent Segment Storage.
  5169.                            61 A representation for the specified polyline
  5170.                               has not been defined on this workstation.
  5171.          LINE:             This is the line type.
  5172.          WIDTH:            This is the line width scale factor.
  5173.          COLOUR:           This is the colour index.
  5174.      
  5175.     ERRORS/EXCEPTIONS:
  5176.      
  5177.      
  5178.      
  5179.     LEVEL: 1A
  5180.      
  5181.      
  5182.     DETAILED DESCRIPTION:
  5183.          If the requested information is available, this procedure returns
  5184.      
  5185.      
  5186.      
  5187.      
  5188.      
  5189.      
  5190.      
  5191.      
  5192.      
  5193.      
  5194.      
  5195.      
  5196.      
  5197.      
  5198.      
  5199.      
  5200.     error indicator 0 and the requested information. If the requested
  5201.     information is not available, this procedure returns the appropriate
  5202.     error indicator to explain the reason for non-availability.
  5203.      
  5204.      
  5205.      
  5206.     FUNCTION NAME: INQ_LIST_OF_POLYMARKER_INDICES
  5207.      
  5208.     CATEGORY: INQUIRY
  5209.      
  5210.      
  5211.     BRIEF DESCRIPTION:  This procedure returns the list of polymarker
  5212.     indices.
  5213.      
  5214.      
  5215.      
  5216.      
  5217.      
  5218.      
  5219.      
  5220.     INPUTS:
  5221.          WS: An integer value representing the workstation identifier.
  5222.      
  5223.      
  5224.      
  5225.      
  5226.      
  5227.      
  5228.      
  5229.     OUTPUTS:
  5230.          ERROR_INDICATOR:  0  Requested value is available and is being
  5231.                               returned.
  5232.                            7  GKS is not in one of the states WSOP, WSAC,
  5233.                               or SGOP.
  5234.                            25 Specified workstation is not open.
  5235.                            33 Specified workstation is category MI.
  5236.                            35 Specified workstation is category INPUT.
  5237.                            36 Specified workstation is Workstation
  5238.                               Indpendent Segment Storage.
  5239.          INDICES:          This is the list of defined polymarker indices.
  5240.      
  5241.     ERRORS/EXCEPTIONS:
  5242.      
  5243.      
  5244.      
  5245.      
  5246.      
  5247.      
  5248.      
  5249.     LEVEL: 1A
  5250.      
  5251.      
  5252.     DETAILED DESCRIPTION:
  5253.          If the requested information is available, this procedure returns
  5254.     error indicator 0 and the requested information. If the requested
  5255.     information is not available, this procedure returns the appropriate
  5256.     error indicator to explain the reason for non-availability.
  5257.      
  5258.      
  5259.      
  5260.     FUNCTION NAME:  INQ_POLYMARKER_REPRESENTATION
  5261.      
  5262.     CATEGORY: INQUIRY
  5263.      
  5264.      
  5265.     BRIEF DESCRIPTION:  This procedure returns the list of polymarker
  5266.     indices.
  5267.      
  5268.      
  5269.      
  5270.     INPUTS:
  5271.          WS:              An integer value representing the workstation
  5272.                           identifier.
  5273.          INDEX:           This is the identifier of the index into the
  5274.                           list of polymarker discerning which polymarker
  5275.                           representation is being inquired.
  5276.          RETURNED_VALUES: This determines how the values will be returned.
  5277.                           If it is 'set,' the values will be returned
  5278.                           according to the program setting. If it is
  5279.                           'realized,' they will be returned according to
  5280.                           how they are actually represented.
  5281.      
  5282.     OUTPUTS:
  5283.          ERROR_INDICATOR:  0  Requested value is available and is being
  5284.                               returned.
  5285.                            7  GKS is not in one of the states WSOP, WSAC,
  5286.                               or SGOP.
  5287.                            25 Specified workstation is not open.
  5288.                            33 Specified workstation is category MI.
  5289.                            35 Specified workstation is category INPUT.
  5290.                            36 Specified workstation is Workstation
  5291.                               Indpendent Segment Storage.
  5292.                            67 A representation for the specified
  5293.                               polymarker index had not been defined on
  5294.                               this workstation.
  5295.          MARKER:           This is the marker type.
  5296.          SIZE:             This is the marker size scale factor.
  5297.          COLOUR:           This is the polymarker colour index.
  5298.      
  5299.      
  5300.     ERRORS/EXCEPTIONS:
  5301.      
  5302.      
  5303.     LEVEL: 1A
  5304.      
  5305.      
  5306.     DETAILED DESCRIPTION:
  5307.          If the requested information is available, this procedure returns
  5308.     error indicator 0 and the requested information. If the requested
  5309.     information is not available, this procedure returns the appropriate
  5310.     error indicator to explain the reason for non-availability.
  5311.      
  5312.      
  5313.      
  5314.     FUNCTION NAME: INQ_LIST_OF_TEXT_INDICES
  5315.      
  5316.     CATEGORY: INQUIRY
  5317.      
  5318.      
  5319.     BRIEF DESCRIPTION:  This procedure returns the list of text indices.
  5320.      
  5321.      
  5322.      
  5323.      
  5324.      
  5325.      
  5326.      
  5327.      
  5328.     INPUTS:
  5329.          WS: An integer value representing the workstation identifier.
  5330.      
  5331.      
  5332.      
  5333.      
  5334.      
  5335.      
  5336.      
  5337.     OUTPUTS:
  5338.          ERROR_INDICATOR:  0  Requested value is available and is being
  5339.                               returned.
  5340.                            7  GKS is not in one of the states WSOP, WSAC,
  5341.                               or SGOP.
  5342.                            25 Specified workstation is not open.
  5343.                            33 Specified workstation is category MI.
  5344.                            35 Specified workstation is category INPUT.
  5345.                            36 Specified workstation is Workstation
  5346.                               Indpendent Segment Storage.
  5347.          INDICES:          This is the list of text indices.
  5348.      
  5349.      
  5350.     ERRORS/EXCEPTIONS:
  5351.      
  5352.      
  5353.      
  5354.      
  5355.      
  5356.      
  5357.     LEVEL: 1A
  5358.      
  5359.      
  5360.     DETAILED DESCRIPTION:
  5361.          If the requested information is available, this procedure returns
  5362.     error indicator 0 and the requested information. If the requested
  5363.     information is not available, this procedure returns the appropriate
  5364.     error indicator to explain the reason for non-availability.
  5365.      
  5366.      
  5367.      
  5368.     FUNCTION NAME: INQ_TEXT_REPRESENTATION
  5369.      
  5370.     CATEGORY: INQUIRY
  5371.      
  5372.      
  5373.     BRIEF DESCRIPTION:  This procedure returns the text representation.
  5374.      
  5375.      
  5376.     INPUTS:
  5377.          WS:              An integer value representing the workstation
  5378.                           identifier.
  5379.          INDEX:           This is the identifier of the index into the
  5380.                           list of text types discerning which text
  5381.                           representation is being inquired.
  5382.          RETURNED_VALUES: This determines how the values will be returned.
  5383.                           If it is 'set,' the values will be returned
  5384.                           according to the program setting. If it is
  5385.                           'realized,' they will be returned according to
  5386.                           how they are actually represented.
  5387.      
  5388.     OUTPUTS:
  5389.          ERROR_INDICATOR:  0  Requested value is available and is being
  5390.                               returned.
  5391.                            7  GKS is not in one of the states WSOP, WSAC,
  5392.                               or SGOP.
  5393.                            25 Specified workstation is not open.
  5394.                            33 Specified workstation is category MI.
  5395.                            35 Specified workstation is category INPUT.
  5396.                            36 Specified workstation is Workstation
  5397.                               Indpendent Segment Storage.
  5398.                            73 A representation for the specified text
  5399.                               index has not beeen defined on this
  5400.                               workstation.
  5401.          FONT_PRECISION:   This is the font precision of the text
  5402.                            representation.
  5403.          EXPANSION:        This is the character expansion factor of the
  5404.                            text representation.
  5405.          SPACING:          This is the character spacing.
  5406.          COLOUR:           This is the text colour index.
  5407.      
  5408.     ERRORS/EXCEPTIONS:
  5409.      
  5410.      
  5411.     LEVEL: 1A
  5412.      
  5413.      
  5414.     DETAILED DESCRIPTION:
  5415.          If the requested information is available, this procedure returns
  5416.     error indicator 0 and the requested information. If the requested
  5417.     information is not available, this procedure returns the appropriate
  5418.     error indicator to explain the reason for non-availability.
  5419.      
  5420.      
  5421.      
  5422.     FUNCTION NAME: INQ_LIST_OF_FILL_AREA_INDICES
  5423.      
  5424.     CATEGORY: INQUIRY
  5425.      
  5426.      
  5427.     BRIEF DESCRIPTION:  This procedure returns the list of fill area
  5428.     indices.
  5429.      
  5430.      
  5431.      
  5432.      
  5433.      
  5434.      
  5435.      
  5436.     INPUTS:
  5437.          WS: An integer value representing the workstation identifier.
  5438.      
  5439.      
  5440.      
  5441.      
  5442.      
  5443.      
  5444.      
  5445.     OUTPUTS:
  5446.          ERROR_INDICATOR:  0  Requested value is available and is being
  5447.                               returned.
  5448.                            7  GKS is not in one of the states WSOP, WSAC,
  5449.                               or SGOP.
  5450.                            25 Specified workstation is not open.
  5451.                            33 Specified workstation is category MI.
  5452.                            35 Specified workstation is category INPUT.
  5453.                            36 Specified workstation is Workstation
  5454.                               Indpendent Segment Storage.
  5455.          INDICES:          This is the list of fill area indices.
  5456.      
  5457.      
  5458.     ERRORS/EXCEPTIONS:
  5459.      
  5460.      
  5461.      
  5462.      
  5463.      
  5464.      
  5465.     LEVEL: 1A
  5466.      
  5467.      
  5468.     DETAILED DESCRIPTION:
  5469.          If the requested information is available, this procedure returns
  5470.     error indicator 0 and the requested information. If the requested
  5471.     information is not available, this procedure returns the appropriate
  5472.     error indicator to explain the reason for non-availability.
  5473.      
  5474.      
  5475.      
  5476.     FUNCTION NAME: INQ_FILL_AREA_REPRESENTATION
  5477.      
  5478.     CATEGORY: INQUIRY
  5479.      
  5480.      
  5481.     BRIEF DESCRIPTION:  This procedure returns the fill area
  5482.     representation.
  5483.      
  5484.      
  5485.      
  5486.     INPUTS:
  5487.          WS:              An integer value representing the workstation
  5488.                           identifier.
  5489.          INDEX:           This is the identifier of the index into the
  5490.                           list of fill areas discerning which fill area
  5491.                           representation is being inquired.
  5492.          RETURNED_VALUES: This determines how the values will be returned.
  5493.                           If it is 'set,' the values will be returned
  5494.                           according to the program setting. If it is
  5495.                           'realized,' they will be returned according to
  5496.                           how they are actually represented.
  5497.      
  5498.     OUTPUTS:
  5499.          ERROR_INDICATOR:  0  Requested value is available and is being
  5500.                               returned.
  5501.                            7  GKS is not in one of the states WSOP, WSAC,
  5502.                               or SGOP.
  5503.                            25 Specified workstation is not open.
  5504.                            33 Specified workstation is category MI.
  5505.                            35 Specified workstation is category INPUT.
  5506.                            36 Specified workstation is Workstation
  5507.                               Indpendent Segment Storage.
  5508.                            81 A representation for the specified fill area
  5509.                               index has not been defined on this
  5510.                               workstation.
  5511.          INTERIOR:         This is the fill area interior style. Values
  5512.                            can be HOLLOW, SOLID, PATTERN, or HATCH.
  5513.          STYLE:            This is the fill area style index.
  5514.          COLOUR:           This is the fill area colour index.
  5515.      
  5516.     ERRORS/EXCEPTIONS:
  5517.      
  5518.      
  5519.     LEVEL: 1A
  5520.      
  5521.      
  5522.     DETAILED DESCRIPTION:
  5523.          If the requested information is available, this procedure returns
  5524.     error indicator 0 and the requested information. If the requested
  5525.     information is not available, this procedure returns the appropriate
  5526.     error indicator to explain the reason for non-availability.
  5527.      
  5528.      
  5529.      
  5530.     FUNCTION NAME: INQ_LIST_OF_PATTERN_INDICES
  5531.      
  5532.     CATEGORY: INQUIRY
  5533.      
  5534.      
  5535.     BRIEF DESCRIPTION:  This procedure returns the list of pattern
  5536.     indices.
  5537.      
  5538.      
  5539.      
  5540.      
  5541.      
  5542.      
  5543.      
  5544.     INPUTS:
  5545.          WS: An integer value representing the workstation identifier.
  5546.      
  5547.      
  5548.      
  5549.      
  5550.      
  5551.      
  5552.      
  5553.     OUTPUTS:
  5554.          ERROR_INDICATOR:  0  Requested value is available and is being
  5555.                               returned.
  5556.                            7  GKS is not in one of the states WSOP, WSAC,
  5557.                               or SGOP.
  5558.                            25 Specified workstation is not open.
  5559.                            33 Specified workstation is category MI.
  5560.                            35 Specified workstation is category INPUT.
  5561.                            36 Specified workstation is Workstation
  5562.                               Indpendent Segment Storage.
  5563.          INDICES:          This is the list of pattern indices.
  5564.      
  5565.      
  5566.     ERRORS/EXCEPTIONS:
  5567.      
  5568.      
  5569.      
  5570.      
  5571.      
  5572.      
  5573.     LEVEL: 1A
  5574.      
  5575.      
  5576.     DETAILED DESCRIPTION:
  5577.          If the requested information is available, this procedure returns
  5578.     error indicator 0 and the requested information. If the requested
  5579.     information is not available, this procedure returns the appropriate
  5580.     error indicator to explain the reason for non-availability.
  5581.      
  5582.      
  5583.      
  5584.     FUNCTION NAME: INQ_PATTERN_REPRESENTATION
  5585.      
  5586.     CATEGORY: INQUIRY
  5587.      
  5588.      
  5589.     BRIEF DESCRIPTION:  This procedure returns the pattern representation.
  5590.      
  5591.      
  5592.      
  5593.      
  5594.     INPUTS:
  5595.          WS:              An integer value representing the workstation
  5596.                           identifier.
  5597.          INDEX:           This is the identifier of the index into the
  5598.                           list of fill areas discerning which fill area
  5599.                           representation is being inquired.
  5600.          RETURNED_VALUES: This determines how the values will be returned.
  5601.                           If it is 'set,' the values will be returned
  5602.                           according to the program setting. If it is
  5603.                           'realized,' they will be returned according to
  5604.                           how they are actually represented.
  5605.      
  5606.     OUTPUTS:
  5607.          ERROR_INDICATOR:  0  Requested value is available and is being
  5608.                               returned.
  5609.                            7  GKS is not in one of the states WSOP, WSAC,
  5610.                               or SGOP.
  5611.                            25 Specified workstation is not open.
  5612.                            33 Specified workstation is category MI.
  5613.                            35 Specified workstation is category INPUT.
  5614.                            36 Specified workstation is Workstation
  5615.                               Indpendent Segment Storage.
  5616.                            88 A representation for the specified pattern
  5617.                               index has not been defined on this
  5618.                               workstation.
  5619.                            90 Interior style PATTERN is not supported on
  5620.                               this workstation.
  5621.          PATTERN:          This is the set of pattern indices.
  5622.      
  5623.     ERRORS/EXCEPTIONS:
  5624.      
  5625.      
  5626.      
  5627.     LEVEL: 1A
  5628.      
  5629.      
  5630.     DETAILED DESCRIPTION:
  5631.          If the requested information is available, this procedure returns
  5632.     error indicator 0 and the requested information. If the requested
  5633.     information is not available, this procedure returns the appropriate
  5634.     error indicator to explain the reason for non-availability.
  5635.      
  5636.      
  5637.      
  5638.     FUNCTION NAME: INQ_SET_OF_SEGMENT_NAMES_ON_WS
  5639.      
  5640.     CATEGORY: INQUIRY
  5641.      
  5642.      
  5643.     BRIEF DESCRIPTION:  This procedure returns the set of segment names
  5644.     on a particular workstation.
  5645.      
  5646.      
  5647.      
  5648.      
  5649.      
  5650.      
  5651.      
  5652.     INPUTS:
  5653.          WS: An integer value representing the workstation identifier.
  5654.      
  5655.      
  5656.      
  5657.      
  5658.      
  5659.      
  5660.      
  5661.     OUTPUTS:
  5662.          ERROR_INDICATOR:  0  Requested value is available and is being
  5663.                               returned.
  5664.                            7  GKS is not in one of the states WSOP, WSAC,
  5665.                               or SGOP.
  5666.                            25 Specified workstation is not open.
  5667.                            33 Specified workstation is category MI.
  5668.                            35 Specified workstation is category INPUT.
  5669.          SEGMENTS:         This is the set of segment names.
  5670.      
  5671.      
  5672.      
  5673.      
  5674.      
  5675.     ERRORS/EXCEPTIONS:
  5676.      
  5677.      
  5678.      
  5679.      
  5680.      
  5681.     LEVEL: 1A
  5682.      
  5683.      
  5684.     DETAILED DESCRIPTION:
  5685.          If the requested information is available, this procedure returns
  5686.     error indicator 0 and the requested information. If the requested
  5687.     information is not available, this procedure returns the appropriate
  5688.     error indicator to explain the reason for non-availability.
  5689.      
  5690.      
  5691.      
  5692.     FUNCTION NAME: WRITE_ITEM_TO_GKSM
  5693.      
  5694.     CATEGORY: METAFILES
  5695.      
  5696.      
  5697.     BRIEF DESCRIPTION:  This procedure is used to write non-graphical
  5698.     data to the GKS metafile.
  5699.      
  5700.      
  5701.      
  5702.      
  5703.      
  5704.      
  5705.      
  5706.     INPUTS:
  5707.          WS:   Specifies the metafile workstation where the item is
  5708.                written.
  5709.          ITEM: A record written to the specified metafile.
  5710.      
  5711.      
  5712.      
  5713.      
  5714.      
  5715.     OUTPUTS:
  5716.      
  5717.      
  5718.      
  5719.      
  5720.      
  5721.      
  5722.      
  5723.      
  5724.     ERRORS/EXCEPTIONS:
  5725.          5:   STATE_ERROR. GKS is not in the proper state. GKS shall be
  5726.               in one of the states WSAC or SGOP.
  5727.          32:  WS_ERROR. Specified workstation is not of category MO.
  5728.          160: METAFILE_ERROR. Item type is not allowed for user items.
  5729.          161: METAFILE_ERROR. Item length is invalid.
  5730.      
  5731.      
  5732.      
  5733.      
  5734.      
  5735.     LEVEL: 0A
  5736.      
  5737.      
  5738.     DETAILED DESCRIPTION:
  5739.          This procedure is used to write alphanumeric data to a metafile.
  5740.     The user specifies the workstation where the item is to be written
  5741.     and then inputs the record to be stored.
  5742.      
  5743.      
  5744.      
  5745.      
  5746.     FUNCTION NAME: GET_ITEM_TYPE_FROM_GKSM
  5747.      
  5748.     CATEGORY:  METAFILE
  5749.      
  5750.      
  5751.     BRIEF DESCRIPTION:  This procedure returns the item type from the
  5752.     next available metafile item.
  5753.      
  5754.      
  5755.      
  5756.      
  5757.      
  5758.      
  5759.     INPUTS:
  5760.          WS: Specifies the appropriate metafile workstation.
  5761.      
  5762.      
  5763.      
  5764.      
  5765.      
  5766.      
  5767.     OUTPUTS:
  5768.          ITEM_TYPE: This is the type of the current item.
  5769.      
  5770.      
  5771.      
  5772.      
  5773.      
  5774.      
  5775.     ERRORS/EXCEPTIONS:
  5776.          7:   STATE_ERROR. GKS is not in the proper state. GKS shall be in
  5777.               one of the states WSOP, WSAC, or SGOP.
  5778.          25:  WS_ERROR. Specified workstation is not open.
  5779.          34:  WS_ERROR. Specified workstation is not of category MI.
  5780.          162: METAFILE_ERROR. No item is left in GKS metafile input.
  5781.          163: METAFILE_ERROR. Metafile item is invalid.
  5782.      
  5783.      
  5784.      
  5785.      
  5786.     LEVEL: 0A
  5787.      
  5788.      
  5789.     DETAILED DESCRIPTION:
  5790.          This is one of the three GKS metafile procedures that the user
  5791.     invokes to retrieve and redisplay graphical output that has been
  5792.     previously saved in a metafile. Usually they are used in this order:
  5793.          1) GET_ITEM_TYPE_FROM_GKSM
  5794.          2) READ_ITEM_FROM_GKSM
  5795.          3) INTERPRET_ITEM.
  5796.      
  5797.      
  5798.      
  5799.      
  5800.     FUNCTION NAME: READ_ITEM_FROM_GKSM
  5801.      
  5802.     CATEGORY: METAFILE
  5803.      
  5804.      
  5805.     BRIEF DESCRIPTION:  This procedure returns the current item from the
  5806.     output metafile.
  5807.      
  5808.      
  5809.      
  5810.      
  5811.      
  5812.      
  5813.     INPUTS:
  5814.          WS: Specifies the appropriate metafile workstation.
  5815.      
  5816.      
  5817.      
  5818.      
  5819.      
  5820.     OUTPUTS:
  5821.          ITEM: The current GKS metafile data record.
  5822.      
  5823.      
  5824.      
  5825.      
  5826.      
  5827.     ERRORS/EXCEPTIONS:
  5828.          7:   STATE_ERROR. GKS is not in the proper state. GKS shall be in
  5829.               one of the states WSOP, WSAC, or SGOP.
  5830.          25:  WS_ERROR. Specified workstation is not open.
  5831.          34:  WS_ERROR. Specified workstation is not of category MI.
  5832.          162: METAFILE_ERROR. No item is left in GKS metafile input.
  5833.          163: METAFILE_ERROR. Metafile item is invalid.
  5834.          165: METAFILE_ERROR. Content of item data record is invalid for
  5835.               the specified item type.
  5836.      
  5837.      
  5838.     LEVEL: 0A
  5839.      
  5840.      
  5841.     DETAILED DESCRIPTION:
  5842.          READ_ITEM_FROM_GKSM returns the current item on the GKS metafile
  5843.     back to the application program and then makes the next item in the
  5844.     metafile the current item. This is one of three GKS metafile
  5845.     procedures that the user invokes to retrieve and display graphical
  5846.     output that was previously saved in a metafile. They are usually used
  5847.     in this order:
  5848.          1) GET_ITEM_TYPE_FROM_GKSM
  5849.          2) READ_ITEM_FROM_GKSM
  5850.          3) INTERPRET_ITEM.
  5851.      
  5852.      
  5853.      
  5854.     FUNCTION NAME: SKIP_ITEM
  5855.      
  5856.     CATEGORY: METAFILE
  5857.      
  5858.      
  5859.     BRIEF DESCRIPTION:  This procedure allows the user to skip over items
  5860.     in the metafile.
  5861.      
  5862.      
  5863.      
  5864.      
  5865.      
  5866.      
  5867.      
  5868.     INPUTS:
  5869.          WS: Specifies the appropriate metafile workstation.
  5870.      
  5871.      
  5872.      
  5873.      
  5874.      
  5875.      
  5876.      
  5877.     OUTPUTS:
  5878.      
  5879.      
  5880.      
  5881.      
  5882.      
  5883.      
  5884.      
  5885.      
  5886.     ERRORS/EXCEPTIONS:
  5887.          7:   STATE_ERROR. GKS is not in the proper state. GKS shall be in
  5888.               one of the states WSOP, WSAC, or SGOP.
  5889.          25:  WS_ERROR. Specified workstation is not open.
  5890.          34:  WS_ERROR. Specified workstation is not of category MI.
  5891.          162: METAFILE_ERROR. No item is left in GKS metafile input.
  5892.          163: METAFILE_ERROR. Metafile item is invalid.
  5893.      
  5894.      
  5895.      
  5896.      
  5897.     LEVEL: 0A
  5898.      
  5899.      
  5900.     DETAILED DESCRIPTION:
  5901.          This procedure is intended to accompany the procedure READ_ITEM_
  5902.     FROM_GKSM. It allows the user more mobility in the GKS metafile by
  5903.     providing the ability to skip over items rather than having to read
  5904.     all items sequentially.
  5905.      
  5906.      
  5907.      
  5908.     FUNCTION NAME: INTERPRET_ITEM
  5909.      
  5910.     CATEGORY: METAFILE
  5911.      
  5912.      
  5913.     BRIEF DESCRIPTION:  This procedure interprets and displays the
  5914.     returned item.
  5915.      
  5916.      
  5917.      
  5918.      
  5919.      
  5920.     INPUTS:
  5921.          ITEM: The current GKS metafile data record.
  5922.      
  5923.      
  5924.      
  5925.      
  5926.      
  5927.     OUTPUTS:
  5928.      
  5929.      
  5930.      
  5931.      
  5932.      
  5933.     ERRORS/EXCEPTIONS:
  5934.          7:   STATE_ERROR. GKS is not in the proper state. GKS shall be in
  5935.               one of the states WSOP, WSAC, or SGOP.
  5936.          161: METAFILE_ERROR. Item length is invalid.
  5937.          163: METAFILE_ERROR. Metafile item is invalid.
  5938.          164: METAFILE_ERROR. Item type is not a valid GKS item.
  5939.          165: METAFILE_ERROR. Content of item data record is invalid for
  5940.               the specified item type.
  5941.          167: METAFILE_ERROR. User item cannot be interpreted.
  5942.          168: METAFILE_ERROR. Specified function is not supported by this
  5943.               level of GKS.
  5944.      
  5945.     LEVEL: 0A
  5946.      
  5947.      
  5948.     DETAILED DESCRIPTION:
  5949.          This procedure interprets the supplied item. This causes
  5950.     appropriate changes in ths set of GKS state variables and the
  5951.     generation of appropriate graphical output, as determined by the
  5952.     metafile specification. This is one of three GKS metafile procedures
  5953.     that the user invokes to retrieve and redisplay graphical output that
  5954.     was previously saved in a metafile. Usually, these procedures are used
  5955.     in the following order:
  5956.          1) GET_ITEM_TYPE_FROM_GKSM
  5957.          2) READ_ITEM_FROM_GKSM
  5958.          3) INTERPRET_ITEM.
  5959.      
  5960.      
  5961.      
  5962.     FUNCTION NAME: SET_LINE_TYPE
  5963.      
  5964.     CATEGORY: OUTPUT ATTRIBUTES
  5965.      
  5966.      
  5967.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  5968.     line type.
  5969.      
  5970.      
  5971.      
  5972.     INPUTS:
  5973.          LINE:  Indicates the line style to be used for subsequent
  5974.                 polylines.
  5975.      
  5976.      
  5977.      
  5978.      
  5979.     OUTPUTS:
  5980.      
  5981.      
  5982.      
  5983.      
  5984.     ERRORS/EXCEPTIONS:
  5985.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be
  5986.              in one of the states GKOP, WSOP, WSAC, or SGOP.
  5987.          63: OUTPUT_ATTRIBUTE_ERROR. Line type is equal to zero.
  5988.      
  5989.      
  5990.      
  5991.      
  5992.      
  5993.     LEVEL: Ma
  5994.      
  5995.      
  5996.     DETAILED DESCRIPTION:  The current linetype entry in the GKS_STATE_
  5997.     LIST is set to the value specified by the parameter. This value is
  5998.     used for the display of subsequent POLYLINE output primitives, created
  5999.     when the 'current linetype ASF' entry in the GKS_STATE_LIST is
  6000.     INDIVIDUAL. This value does not affect the display of subsequent
  6001.     POLYLINE output primitives, created when the 'current linetype ASF'
  6002.     entry in the GKS_STATE_LIST is BUNDLED.
  6003.          Linetype values produce linetypes as indicated:
  6004.               1    Solid line
  6005.               2    Dashed line
  6006.               3    Dotted line
  6007.               4    Dashed-Dotted line
  6008.      
  6009.          If the specified linetype is not available on a workstation,
  6010.     linetype 1 is used on that workstation.
  6011.      
  6012.      
  6013.      
  6014.      
  6015.      
  6016.     FUNCTION NAME: SET_POLYLINE_COLOUR_INDEX
  6017.      
  6018.     CATEGORY: OUTPUT ATTRIBUTES
  6019.      
  6020.      
  6021.     BRIEF DESCRIPTION: This procedure sets the value of the current
  6022.     polyline colour index.
  6023.      
  6024.      
  6025.      
  6026.      
  6027.     INPUTS:
  6028.          COLOUR:  Indicates the colour to be used for subsequent
  6029.                   polylines.
  6030.      
  6031.      
  6032.      
  6033.      
  6034.     OUTPUTS:
  6035.      
  6036.      
  6037.      
  6038.      
  6039.     ERRORS/EXCEPTIONS:
  6040.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6041.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6042.          92: OUTPUT_ATTRIBUTE_ERROR. Colour index is less than zero.
  6043.      
  6044.      
  6045.      
  6046.      
  6047.     LEVEL: Ma
  6048.      
  6049.      
  6050.     DETAILED DESCRIPTION:
  6051.          The 'current polyline colour index' entry in the GKS_STATE_LIST
  6052.     is set to the value specified by the parameter. This value is used for
  6053.     the display of subsequent POLYLINE output primitives, created when the
  6054.     'current polyline colour index ASF' entry in the GKS_STATE_LIST is
  6055.     INDIVIDUAL. This value does not affect the display of subsequent
  6056.     POLYLINE output primitives, created when the 'current polyline colour
  6057.     index ASF' entry in the GKS_STATE_LIST is BUNDLED.
  6058.          The colour index is a pointer into the colour tables of the
  6059.     workstations. If the specified colour index is not present in a
  6060.     workstation colour table, a workstation dependent colour index is used
  6061.     on that workstation.
  6062.          The color denoted by a particulart color index is determined by a
  6063.     call to the SET_COLOUR_REPRESENTATION procedure. This associates color
  6064.     indices to colors specified in red, green and blue intensities.
  6065.      
  6066.      
  6067.      
  6068.      
  6069.      
  6070.     FUNCTION NAME: SET_MARKER_TYPE
  6071.      
  6072.     CATEGORY: OUTPUT ATTRIBUTES
  6073.      
  6074.      
  6075.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6076.     marker type.
  6077.      
  6078.      
  6079.      
  6080.      
  6081.     INPUTS:
  6082.          MARKER:  Indicates the marker style to be used for subsequent
  6083.                   polymarkers.
  6084.      
  6085.      
  6086.      
  6087.      
  6088.     OUTPUTS:
  6089.      
  6090.      
  6091.      
  6092.     ERRORS/EXCEPTIONS:
  6093.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6094.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6095.          69: OUTPUT_ATTRIBUTE_ERROR. Marker type is equal to zero.
  6096.      
  6097.      
  6098.      
  6099.     LEVEL: Ma
  6100.      
  6101.      
  6102.     DETAILED DESCRIPTION:  The 'current marker type' entry in the GKS_
  6103.     STATE_LIST is set to the value specified by the parameter. This value
  6104.     is used for the display of subsequent POLYMARKER output primitives,
  6105.     created when the 'current marker type ASF' entry in the GKS_STATE_
  6106.     LIST is INDIVIDUAL. This value does not affect the display of
  6107.     subsequent polymarker output primitives, created when the 'current
  6108.     marker type ASF' entry in the GKS state list is bundled.
  6109.          Marker type values produce centered symbols as indicated:
  6110.               1    .
  6111.               2    +
  6112.               3    *
  6113.               4    0
  6114.               5    X
  6115.      
  6116.          Marker type 1 is always displayed as the smallest displayable
  6117.     dot. If the specified marker type is not available on a workstation,
  6118.     marker type 3 is used on that workstation.
  6119.      
  6120.      
  6121.      
  6122.      
  6123.      
  6124.     FUNCTION NAME: SET_POLYMARKER_COLOUR_INDEX
  6125.      
  6126.     CATEGORY: OUTPUT ATTRIBUTES
  6127.      
  6128.      
  6129.     BRIEF DESCRIPTION: This procedure sets the value of the current
  6130.     polymarker colour index.
  6131.      
  6132.      
  6133.      
  6134.      
  6135.     INPUTS:
  6136.          COLOUR:  Indicates the colour to be used for subsequent
  6137.                   polymarkers.
  6138.      
  6139.      
  6140.      
  6141.      
  6142.     OUTPUTS:
  6143.      
  6144.      
  6145.      
  6146.      
  6147.     ERRORS/EXCEPTIONS:
  6148.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6149.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6150.          92: OUTPUT_ATTRIBUTE_ERROR. Colour index is less than zero.
  6151.      
  6152.      
  6153.      
  6154.      
  6155.     LEVEL: Ma
  6156.      
  6157.      
  6158.     DETAILED DESCRIPTION:
  6159.          The 'current polymarker colour index' entry in the GKS state list
  6160.     is set to the value specified by the parameter. This value is used for
  6161.     the display of subsequent polymarker output primitives, created when
  6162.     the 'current polymarker colour index ASF' entry in the GKS state list
  6163.     is individual. This value does not affect the display of subsequent
  6164.     polymarker output primitives, created when the 'current polymarker
  6165.     colour index ASF' entry in the GKS state list is bundled.
  6166.          The colour index is a pointer into the colour tables of the
  6167.     workstations. If the specified colour index is not present in a
  6168.     workstation colour table, a workstation dependent colour index is used
  6169.     on that workstation.
  6170.          The color denoted by a particular color index is determined by a
  6171.     call to the SET_COLOUR_REPRESENTATION procedure. This associates color
  6172.     indices to colors specified in red, green, and blue intensities.
  6173.      
  6174.      
  6175.      
  6176.      
  6177.      
  6178.     FUNCTION NAME: SET_TEXT_COLOUR_INDEX
  6179.      
  6180.     CATEGORY: OUTPUT ATTRIBUTES
  6181.      
  6182.      
  6183.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6184.     test colour index.
  6185.      
  6186.      
  6187.      
  6188.      
  6189.     INPUTS:
  6190.          COLOUR:  Indicates the colour of subsequent text primitives.
  6191.      
  6192.      
  6193.      
  6194.      
  6195.     OUTPUTS:
  6196.      
  6197.      
  6198.      
  6199.      
  6200.     ERRORS/EXCEPTIONS:
  6201.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6202.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6203.          92: OUTPUT_ATTRIBUTE_ERROR. Colour index is less than zero.
  6204.      
  6205.      
  6206.      
  6207.      
  6208.      
  6209.     LEVEL: Ma
  6210.      
  6211.      
  6212.     DETAILED DESCRIPTION:
  6213.          The 'current text colour index' entry in the GKS state list is
  6214.     set to the value specified by the parameter. This value is used for
  6215.     the display of subsequent text output primitives, created when the
  6216.     'current text colour index ASF' entry in the GKS state list is
  6217.     individual. This value does not affect the display of subsequent text
  6218.     output primitives created when the 'current text colour index ASF'
  6219.     entry in the GKS state list is bundled.
  6220.          The colour index is a pointer into the colour tables of the
  6221.     workstations. If the specified colour index is not present in a
  6222.     workstation colour table, a workstation dependent colour index is used
  6223.      
  6224.      
  6225.      
  6226.      
  6227.      
  6228.      
  6229.      
  6230.      
  6231.      
  6232.      
  6233.      
  6234.      
  6235.      
  6236.      
  6237.      
  6238.      
  6239.     on that workstation.
  6240.          The color denoted by a particular color index is determined by a
  6241.     call to the SET_COLOUR REPRESENTATION procedure. This associates color
  6242.     indices to colors specified in red, green, and blue intensities.
  6243.      
  6244.      
  6245.      
  6246.      
  6247.      
  6248.     FUNCTION NAME: SET_FILL_AREA_INTERIOR_STYLE
  6249.      
  6250.     CATEGORY: OUTPUT ATTRIBUTES
  6251.      
  6252.      
  6253.     BRIEF DESCRIPTION: This procedure sets the value of the current fill
  6254.     area interior style.
  6255.      
  6256.      
  6257.      
  6258.      
  6259.      
  6260.     INPUTS:
  6261.          STYLE:  Indicates the interior style to be used for fill area
  6262.                  primitives. The values may be HOLLOW, SOLID, PATTER, or
  6263.                  HATCH.
  6264.      
  6265.      
  6266.      
  6267.      
  6268.     OUTPUTS:
  6269.      
  6270.      
  6271.      
  6272.      
  6273.      
  6274.     ERRORS/EXCEPTIONS:
  6275.          8: STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6276.             one of the states GKOP, WSOP, WSAC, or SGOP.
  6277.      
  6278.      
  6279.      
  6280.      
  6281.     LEVEL: MA
  6282.      
  6283.      
  6284.     DETAILED DESCRIPTION:
  6285.          The 'current fill area interior style' entry in the GKS state
  6286.     list is set to the value specified by the parameter. This value is
  6287.     used for the display of subsequent fill area output primitives,
  6288.     created when the 'current fill area interior style ASF' entry in the
  6289.     GKS state list is individual. This value does not affect the display
  6290.     of subsequent fill area output primitives, created when the 'current
  6291.     fill area interior style ASF' entry in the GKS state list is bundled.
  6292.          The fill area interior style is used to determine in what style
  6293.     the area is filled and the possible values are HOLLOW, SOLID, PATTERN,
  6294.     and HATCH.
  6295.          If the requested interior style is not available on a
  6296.     workstation, HOLLOW is used on that workstation.
  6297.      
  6298.      
  6299.      
  6300.      
  6301.      
  6302.     FUNCTION NAME: SET_FILL_AREA_COLOUR_INDEX
  6303.      
  6304.     CATEGORY: OUTPUT ATTRIBUTES
  6305.      
  6306.      
  6307.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6308.     fill area colour index.
  6309.      
  6310.      
  6311.      
  6312.      
  6313.     INPUTS:
  6314.          COLOUR:  Indicates the colour to be used in subsequent fill
  6315.                   area primitives.
  6316.      
  6317.      
  6318.      
  6319.     OUTPUTS:
  6320.      
  6321.      
  6322.      
  6323.      
  6324.     ERRORS/EXCEPTIONS:
  6325.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6326.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6327.          92: OUTPUT_ATTRIBUTE_ERROR. Colour index is less than zero.
  6328.      
  6329.      
  6330.      
  6331.      
  6332.      
  6333.     LEVEL: Ma
  6334.      
  6335.      
  6336.     DETAILED DESCRIPTION:
  6337.          The 'current fill area colour index' entry in the GKS state list
  6338.     is set to the value specified by the parameter. This value is used for
  6339.     the display of subsequent fill area output primitives, created when
  6340.     the 'current fill area colour index ASF' entry in the GKS state list
  6341.     is individual. This value does not affect the display of subsequent
  6342.     fill area output primitives, created when the 'current fill area
  6343.     colour index ASF' entry in the GKS state list is bundled.
  6344.          The colour index is a pointer into the colour tables of the
  6345.     workstation. If the specified colour index is not present in a
  6346.     workstation colour table, a workstation dependent colour index is used
  6347.     on that workstation.
  6348.          The color denoted by a particular color index is determined by a
  6349.     call to the SET_COLOUR_REPRESENTATION procedure. The associates color
  6350.     indices to colors specified in red, green, and blue intensities.
  6351.      
  6352.      
  6353.      
  6354.      
  6355.      
  6356.     FUNCTION NAME: SET_CHAR_HEIGHT
  6357.      
  6358.     CATEGORY: OUTPUT ATTRIBUTES
  6359.      
  6360.      
  6361.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6362.     character height.
  6363.      
  6364.      
  6365.      
  6366.      
  6367.      
  6368.      
  6369.     INPUTS:
  6370.          HEIGHT:  Indicates the nominal height of the capital letter
  6371.                   character.
  6372.      
  6373.      
  6374.      
  6375.      
  6376.      
  6377.      
  6378.     OUTPUTS:
  6379.      
  6380.      
  6381.      
  6382.      
  6383.      
  6384.      
  6385.      
  6386.     ERRORS/EXCEPTIONS:
  6387.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6388.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6389.          78: OUTPUT_ATTRIBUTE_ERROR. Character height is less than or
  6390.              equal to zero.
  6391.      
  6392.      
  6393.      
  6394.      
  6395.      
  6396.      
  6397.     LEVEL: Ma
  6398.      
  6399.      
  6400.     DETAILED DESCRIPTION:
  6401.          This procedure sets the character height in world coordinates to
  6402.     the value specified by the parameter. Character size is mapped to the
  6403.     closest character size the device supports.
  6404.      
  6405.      
  6406.      
  6407.      
  6408.      
  6409.      
  6410.     FUNCTION NAME: SET_CHAR_UP_VECTOR
  6411.      
  6412.     CATEGORY: OUTPUT ATTRIBUTES
  6413.      
  6414.      
  6415.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6416.     character up vector.
  6417.      
  6418.      
  6419.      
  6420.      
  6421.      
  6422.      
  6423.     INPUTS:
  6424.          CHAR_UP_VECTOR:  Indicates the up direction of the character.
  6425.      
  6426.      
  6427.      
  6428.      
  6429.      
  6430.      
  6431.      
  6432.     OUTPUTS:
  6433.      
  6434.      
  6435.      
  6436.      
  6437.      
  6438.      
  6439.     ERRORS/EXCEPTIONS:
  6440.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6441.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6442.          79: OUTPUT_ATTRIBUTE_ERROR. Length of character up vector is
  6443.              zero.
  6444.      
  6445.      
  6446.      
  6447.      
  6448.      
  6449.      
  6450.     LEVEL: Ma
  6451.      
  6452.      
  6453.     DETAILED DESCRIPTION:
  6454.          This procedure specifies the 'up' direction for characters. A
  6455.     vector from the origin (0,0) to the point specified defines the up
  6456.     direction for a character.
  6457.      
  6458.      
  6459.      
  6460.      
  6461.      
  6462.      
  6463.      
  6464.     FUNCTION NAME: SET_TEXT_ALIGNMENT
  6465.      
  6466.     CATEGORY: OUTPUT ATTRIBUTES
  6467.      
  6468.      
  6469.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6470.     text alignment.
  6471.      
  6472.      
  6473.      
  6474.      
  6475.      
  6476.      
  6477.     INPUTS:
  6478.          ALIGNMENT:  Indicates the positioning of the text extent
  6479.                      rectangle in relation to the text position. It is a
  6480.                      record with a horizontal component and a vertical
  6481.                      component.
  6482.      
  6483.      
  6484.      
  6485.      
  6486.     OUTPUTS:
  6487.      
  6488.      
  6489.      
  6490.      
  6491.      
  6492.      
  6493.     ERRORS/EXCEPTIONS:
  6494.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  6495.              one of the states GKOP, WSOP, WSAC, or SGOP.
  6496.      
  6497.      
  6498.      
  6499.      
  6500.      
  6501.      
  6502.      
  6503.      
  6504.     LEVEL: Ma
  6505.      
  6506.      
  6507.     DETAILED DESCRIPTION:
  6508.          The 'current text alignment' entry in the GKS state list is set
  6509.     to the value specified by the parameter. This value is used when
  6510.     creating subsequent text output primitives. Text alignment has two
  6511.     components: horizontal and vertical. Horizontal can be set to Normal,
  6512.     Left, Center, or Right. Vertical can be set to Normal, Top, Cap, Half,
  6513.     Base, or Bottom.
  6514.      
  6515.      
  6516.      
  6517.      
  6518.     FUNCTION NAME: SET_COLOUR_REPRESENTATION
  6519.      
  6520.     CATEGORY: OUTPUT ATTRIBUTES
  6521.      
  6522.      
  6523.     BRIEF DESCRIPTION:  This procedure modifies the colour associated
  6524.     with a colour index on a specified workstation.
  6525.      
  6526.      
  6527.      
  6528.      
  6529.      
  6530.      
  6531.      
  6532.     INPUTS:
  6533.          WS:     An integer value indicating the workstation
  6534.                  identification.
  6535.          INDEX:  Indicates the entry in the colour table to be set.
  6536.          COLOUR: Defines the representation of a colour as a combination
  6537.                  of RED, GREEN, and BLUE intensities which are the
  6538.                  components of the record.
  6539.      
  6540.      
  6541.     OUTPUTS:
  6542.      
  6543.      
  6544.      
  6545.      
  6546.      
  6547.      
  6548.      
  6549.      
  6550.     ERRORS/EXCEPTIONS:
  6551.          7:  STATE_ERROR. GKS is not in the proper state. GKS shall be in
  6552.              one of the states WSOP, WSAC, or SGOP.
  6553.          20: WS_ERROR. Specified workstation identifier is invalid.
  6554.          25: WS_ERROR. Specified workstation is not open.
  6555.          33: WS_ERROR. Specified workstation is of category MI.
  6556.          35: WS_ERROR. Specified workstation is of category INPUT.
  6557.          36: WS_ERROR. Specified workstation is Workstation Independent
  6558.              Segment Storage.
  6559.          93: WS_ERROR: Colour index is invalid.
  6560.          96: WS_ERROR: Colour is outside range.
  6561.      
  6562.     LEVEL: Ma
  6563.      
  6564.      
  6565.     DETAILED DESCRIPTION:
  6566.          This procedure sets the color associated with a color index on a
  6567.     specified workstation. Colors are produced by mixing different
  6568.     intensities of red, green, and blue.
  6569.      
  6570.      
  6571.      
  6572.     FUNCTION NAME: SET_POLYLINE_INDEX
  6573.     CATEGORY: OUTPUT ATTRIBUTES
  6574.      
  6575.      
  6576.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6577.     polyline index.
  6578.      
  6579.      
  6580.      
  6581.      
  6582.      
  6583.      
  6584.      
  6585.     INPUTS:
  6586.          INDEX: Specifies the polyline index to be set.
  6587.      
  6588.      
  6589.      
  6590.      
  6591.      
  6592.      
  6593.      
  6594.     OUTPUTS:
  6595.      
  6596.      
  6597.      
  6598.      
  6599.      
  6600.      
  6601.      
  6602.      
  6603.     ERRORS/EXCEPTIONS:
  6604.          8:  GKS is not in the proper state; GKS shall be in one of the
  6605.              states GKOP, WSOP, WSAC, or SGOP.
  6606.          60: Polyline index is invalid.
  6607.      
  6608.      
  6609.      
  6610.      
  6611.      
  6612.      
  6613.      
  6614.     LEVEL: 0A
  6615.      
  6616.      
  6617.     DETAILED DESCRIPTION:
  6618.          This procedure sets the 'current polyline index' entry in the GKS
  6619.     state list to the specified value. This value is used when creating
  6620.     subsequent polyline output primitives.
  6621.      
  6622.      
  6623.      
  6624.      
  6625.     FUNCTION NAME: SET_POLYMARKER_INDEX
  6626.      
  6627.     CATEGORY: OUTPUT ATTRIBUTES
  6628.      
  6629.      
  6630.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6631.     polymarker index.
  6632.      
  6633.      
  6634.      
  6635.      
  6636.      
  6637.      
  6638.      
  6639.     INPUTS:
  6640.          INDEX: Specifies the value of the polymarker index.
  6641.      
  6642.      
  6643.      
  6644.      
  6645.      
  6646.      
  6647.      
  6648.     OUTPUTS:
  6649.      
  6650.      
  6651.      
  6652.      
  6653.      
  6654.      
  6655.      
  6656.      
  6657.     ERRORS/EXCEPTIONS:
  6658.          8:  GKS is not in the proper state; GKS shall be in one of the
  6659.              states GKOP, WSOP, WSAC, or SGOP.
  6660.          66: Polymarker index is invalid.
  6661.      
  6662.      
  6663.      
  6664.      
  6665.      
  6666.      
  6667.      
  6668.     LEVEL: 0A
  6669.      
  6670.      
  6671.     DETAILED DESCRIPTION:
  6672.          This procedure sets the 'current polymarker index' entry in the
  6673.     GKS state list to the value specified. This value is used when
  6674.     creating subsequent POLYMARKER output primitives.
  6675.      
  6676.      
  6677.      
  6678.      
  6679.     FUNCTION NAME: SET_TEXT_INDEX
  6680.      
  6681.     CATEGORY: OUTPUT ATTRIBUTES
  6682.      
  6683.      
  6684.     BRIEF DESCRIPTION:  This procedure sets the value of the current text
  6685.     index.
  6686.      
  6687.      
  6688.      
  6689.      
  6690.      
  6691.      
  6692.      
  6693.     INPUTS:
  6694.          INDEX: Specifies the value of the text index.
  6695.      
  6696.      
  6697.      
  6698.      
  6699.      
  6700.      
  6701.      
  6702.     OUTPUTS:
  6703.      
  6704.      
  6705.      
  6706.      
  6707.      
  6708.      
  6709.      
  6710.      
  6711.     ERRORS/EXCEPTIONS:
  6712.          8:  GKS is not in the proper state; GKS shall be in one of the
  6713.              states GKOP, WSOP, WSAC, or SGOP.
  6714.          72: Text index is invalid.
  6715.      
  6716.      
  6717.      
  6718.      
  6719.      
  6720.      
  6721.      
  6722.     LEVEL: 0A
  6723.      
  6724.      
  6725.     DETAILED DESCRIPTION:
  6726.          This procedure set the 'current text index' entry in the GKS
  6727.     state list to the value specified. This value is used when creating
  6728.     subsequent text output primitives.
  6729.      
  6730.      
  6731.      
  6732.      
  6733.     FUNCTION NAME: SET_FILL_AREA_INDEX
  6734.      
  6735.     CATEGORY: OUTPUT ATTRIBUTES
  6736.      
  6737.      
  6738.     BRIEF DESCRIPTION:  This procedure sets the value of the current fill
  6739.     area index.
  6740.      
  6741.      
  6742.      
  6743.      
  6744.      
  6745.      
  6746.      
  6747.     INPUTS:
  6748.          INDEX: Specifies the value of the fill area index.
  6749.      
  6750.      
  6751.      
  6752.      
  6753.      
  6754.      
  6755.      
  6756.     OUTPUTS:
  6757.      
  6758.      
  6759.      
  6760.      
  6761.      
  6762.      
  6763.      
  6764.      
  6765.     ERRORS/EXCEPTIONS:
  6766.          8:  GKS is not in the proper state; GKS shall be in one of the
  6767.              states GKOP, WSOP, WSAC, or SGOP.
  6768.          80: Fill area index is invalid.
  6769.      
  6770.      
  6771.      
  6772.      
  6773.      
  6774.      
  6775.      
  6776.     LEVEL: 0A
  6777.      
  6778.      
  6779.     DETAILED DESCRIPTION:
  6780.          This procedure set the 'current fill area index' entry in the GKS
  6781.     state list to the value specified. This value is used when creating
  6782.     subsequent fill area output primitives.
  6783.      
  6784.      
  6785.      
  6786.      
  6787.     FUNCTION NAME: SET_LINE_WIDTH_SCALE_FACTOR
  6788.      
  6789.     CATEGORY: OUTPUT_ATTRIBUTES
  6790.      
  6791.      
  6792.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6793.     line width scale factor.
  6794.      
  6795.      
  6796.      
  6797.      
  6798.      
  6799.      
  6800.      
  6801.     INPUTS:
  6802.          WIDTH: Specifies the value of the line width.
  6803.      
  6804.      
  6805.      
  6806.      
  6807.      
  6808.      
  6809.      
  6810.     OUTPUTS:
  6811.      
  6812.      
  6813.      
  6814.      
  6815.      
  6816.      
  6817.      
  6818.     ERRORS/EXCEPTIONS:
  6819.          8:  GKS is not in the proper state; GKS shall be in one of the
  6820.              states GKOP, WSOP, WSAC, or SGOP.
  6821.          65: Line width scale factor is less than zero.
  6822.      
  6823.      
  6824.      
  6825.      
  6826.      
  6827.      
  6828.     LEVEL: 0A
  6829.      
  6830.      
  6831.     DETAILED DESCRIPTION:
  6832.          This procedure sets the 'current line width scale factor' entry
  6833.     in the GKS state list to the value specified. This value is used for
  6834.     the display of subsequent polyline output primitives created when the
  6835.     current line width  scale factor aspect source flag is set to
  6836.     individual.
  6837.      
  6838.      
  6839.      
  6840.      
  6841.     FUNCTION NAME: SET_MARKER_SIZE_SCALE_FACTOR
  6842.      
  6843.     CATEGORY: OUTPUT ATTRIBUTES
  6844.      
  6845.      
  6846.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6847.     marker size scale factor.
  6848.      
  6849.      
  6850.      
  6851.      
  6852.      
  6853.      
  6854.      
  6855.     INPUTS:
  6856.          SIZE: Specifies the value of the marker size.
  6857.      
  6858.      
  6859.      
  6860.      
  6861.      
  6862.      
  6863.      
  6864.     OUTPUTS:
  6865.      
  6866.      
  6867.      
  6868.      
  6869.      
  6870.      
  6871.      
  6872.      
  6873.     ERRORS/EXCEPTIONS:
  6874.          8:  GKS is not in the proper state; GKS shall be in one of the
  6875.              states GKOP, WSOP, WSAC, or SGOP.
  6876.          71: Marker size scale factor is less than zero.
  6877.      
  6878.      
  6879.      
  6880.      
  6881.      
  6882.      
  6883.     LEVEL: 0A
  6884.      
  6885.      
  6886.     DETAILED DESCRIPTION:
  6887.          This procedure sets the 'current marker size scale factor' entry
  6888.     in the GKS state list to the value specified. This value is used for
  6889.     the display of subsequent polymarker output primitives created when
  6890.     the current marker size scale factor aspect source flag is set to
  6891.     individual.
  6892.      
  6893.      
  6894.      
  6895.     FUNCTION NAME: SET_TEXT_FONT_AND_PRECISION
  6896.      
  6897.     CATEGORY: OUTPUT ATTRIBUTES
  6898.      
  6899.      
  6900.     BRIEF DESCRIPTION:  This procedure sets the value of the current text
  6901.     font and precision.
  6902.      
  6903.      
  6904.      
  6905.      
  6906.      
  6907.      
  6908.      
  6909.     INPUTS:
  6910.          FONT_PRECISION: Specifies the value of the text font and
  6911.                          precision.
  6912.      
  6913.      
  6914.      
  6915.      
  6916.      
  6917.      
  6918.     OUTPUTS:
  6919.      
  6920.      
  6921.      
  6922.      
  6923.      
  6924.      
  6925.      
  6926.      
  6927.     ERRORS/EXCEPTIONS:
  6928.          8:  GKS is not in the proper state; GKS shall be in one of the
  6929.              states GKOP, WSOP, WSAC, or SGOP.
  6930.          75: Text font is equal to zero.
  6931.      
  6932.      
  6933.      
  6934.      
  6935.      
  6936.      
  6937.     LEVEL: 0A
  6938.      
  6939.      
  6940.     DETAILED DESCRIPTION:
  6941.          This procedure sets the 'current text font and precision' entry
  6942.     in the GKS state list to the value specified. This value is used for
  6943.     the display of subsequent text output primitives created when the
  6944.     current text font and precision aspect source flag is set to
  6945.     individual.
  6946.      
  6947.      
  6948.      
  6949.     FUNCTION NAME: SET_CHAR_EXPANSION_FACTOR
  6950.      
  6951.     CATEGORY: OUTPUT ATTRIBUTES
  6952.      
  6953.      
  6954.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  6955.     character expansion factor.
  6956.      
  6957.      
  6958.      
  6959.      
  6960.      
  6961.      
  6962.      
  6963.     INPUTS:
  6964.          EXPANSION: Specifies the value of the character expansion.
  6965.      
  6966.      
  6967.      
  6968.      
  6969.      
  6970.      
  6971.      
  6972.     OUTPUTS:
  6973.      
  6974.      
  6975.      
  6976.      
  6977.      
  6978.      
  6979.      
  6980.      
  6981.     ERRORS/EXCEPTIONS:
  6982.          8:  GKS is not in the proper state; GKS shall be in one of the
  6983.              states GKOP, WSOP, WSAC, or SGOP.
  6984.          77: Character expansion factor is less than or equal to zero.
  6985.      
  6986.      
  6987.      
  6988.      
  6989.      
  6990.      
  6991.     LEVEL: 0A
  6992.      
  6993.      
  6994.     DETAILED DESCRIPTION:
  6995.          This procedure sets the 'current character expansion factor'
  6996.     entry in the GKS state list to the value specified. This value is
  6997.     used for the display of subsequent text output primitives created
  6998.     when the current character expansion factor aspect source flag is set
  6999.     to individual.
  7000.      
  7001.      
  7002.      
  7003.     FUNCTION NAME: SET_CHAR_SPACING
  7004.      
  7005.     CATEGORY: OUTPUT ATTRIBUTES
  7006.      
  7007.      
  7008.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  7009.     character spacing.
  7010.      
  7011.      
  7012.      
  7013.      
  7014.      
  7015.      
  7016.      
  7017.     INPUTS:
  7018.          SPACING: Specifies the value of the current character spacing.
  7019.      
  7020.      
  7021.      
  7022.      
  7023.      
  7024.      
  7025.      
  7026.     OUTPUTS:
  7027.      
  7028.      
  7029.      
  7030.      
  7031.      
  7032.      
  7033.      
  7034.      
  7035.     ERRORS/EXCEPTIONS:
  7036.          8: GKS is not in the proper state; GKS shall be in one of the
  7037.             states GKOP, WSOP, WSAC, or SGOP.
  7038.      
  7039.      
  7040.      
  7041.      
  7042.      
  7043.      
  7044.      
  7045.      
  7046.     LEVEL: 0A
  7047.      
  7048.      
  7049.     DETAILED DESCRIPTION:
  7050.          This procedure set the 'current character spacing' entry in the
  7051.     GKS state list to the value specified. This value is used for the
  7052.     display of subsequent text output primitives created when the current
  7053.     character spacing aspect source flag is set to individual.
  7054.      
  7055.      
  7056.      
  7057.     FUNCTION NAME: SET_FILL_AREA_STYLE_INDEX
  7058.      
  7059.     CATEGORY: OUTPUT ATTRIBUTES
  7060.      
  7061.      
  7062.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  7063.     fill area style index.
  7064.      
  7065.      
  7066.      
  7067.      
  7068.      
  7069.      
  7070.      
  7071.     INPUTS:
  7072.          INDEX: Specifies the value of the fill area style index.
  7073.      
  7074.      
  7075.      
  7076.      
  7077.      
  7078.      
  7079.      
  7080.     OUTPUTS:
  7081.      
  7082.      
  7083.      
  7084.      
  7085.      
  7086.      
  7087.      
  7088.      
  7089.     ERRORS/EXCEPTIONS:
  7090.          8:  GKS is not in the proper state; GKS shall be in one of the
  7091.              states GKOP, WSOP, WSAC, or SGOP.
  7092.          84: Style (pattern of hatch) is equal to zero.
  7093.      
  7094.      
  7095.      
  7096.      
  7097.      
  7098.      
  7099.     LEVEL: 0A
  7100.      
  7101.      
  7102.     DETAILED DESCRIPTION:
  7103.          This procedure sets the 'current fill area style index' entry
  7104.     in the GKS state list to the value specified. This value is used for
  7105.     the display of subsequent fill area output primitives created when
  7106.     the current fill area style index aspect source flag is set to
  7107.     individual.
  7108.      
  7109.      
  7110.      
  7111.     FUNCTION NAME: SET_ASF
  7112.      
  7113.     CATEGORY: OUTPUT ATTRIBUTES
  7114.      
  7115.      
  7116.     BRIEF DESCRIPTION:  This procedure sets the values of the aspect
  7117.     source flags.
  7118.      
  7119.      
  7120.      
  7121.      
  7122.      
  7123.     INPUTS:
  7124.          ASF: Specifies the values for all of the aspect source flags.
  7125.      
  7126.      
  7127.      
  7128.      
  7129.      
  7130.     OUTPUTS:
  7131.      
  7132.      
  7133.      
  7134.      
  7135.     ERRORS/EXCEPTIONS:
  7136.          8: GKS is not in the proper state; GKS shall be in one of the
  7137.             states GKOP, WSOP, WSAC, or SGOP.
  7138.      
  7139.      
  7140.      
  7141.      
  7142.      
  7143.     LEVEL: 0A
  7144.      
  7145.      
  7146.     DETAILED DESCRIPTION:
  7147.          This procedure sets the values of the following aspect source
  7148.     flags:
  7149.          1) linetype asf
  7150.          2) linewidth scale factor asf
  7151.          3) polyline colour index asf
  7152.          4) marker types asf
  7153.          5) marker size scale factor asf
  7154.          6) polymarker colour index asf
  7155.          7) text font and precision asf
  7156.          8) character expansion factor asf
  7157.          9) character spacing asf
  7158.          10) text colour index asf
  7159.          11) fill area interior style asf
  7160.          12) fill area style index asf
  7161.          13) fill area colour index asf.
  7162.      
  7163.      
  7164.      
  7165.     FUNCTION NAME: SET_TEXT_PATH
  7166.      
  7167.     CATEGORY: OUTPUT ATTRIBUTES
  7168.      
  7169.      
  7170.     BRIEF DESCRIPTION:  This procedure sets the value of the current text
  7171.     path.
  7172.      
  7173.      
  7174.      
  7175.      
  7176.      
  7177.      
  7178.      
  7179.     INPUTS:
  7180.          PATH: Specifies the value of the test path.
  7181.      
  7182.      
  7183.      
  7184.      
  7185.      
  7186.      
  7187.      
  7188.     OUTPUTS:
  7189.      
  7190.      
  7191.      
  7192.      
  7193.      
  7194.      
  7195.      
  7196.      
  7197.     ERRORS/EXCEPTIONS:
  7198.          8: GKS is not in the proper state; GKS shall be in one of the
  7199.             states GKOP, WSOP, WSAC, or SGOP.
  7200.      
  7201.      
  7202.      
  7203.      
  7204.      
  7205.      
  7206.      
  7207.      
  7208.     LEVEL: 0A
  7209.      
  7210.      
  7211.     DETAILED DESCRIPTION:
  7212.          This procedure sets the 'current text path' entry in the GKS
  7213.     state list to the value specified. This value is used when creating
  7214.     subsequent text output primitives.
  7215.      
  7216.      
  7217.      
  7218.      
  7219.     FUNCTION NAME: SET_PATTERN_SIZE
  7220.      
  7221.     CATEGORY: OUTPUT ATTRIBUTES
  7222.      
  7223.      
  7224.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  7225.     pattern size.
  7226.      
  7227.      
  7228.      
  7229.      
  7230.      
  7231.      
  7232.      
  7233.     INPUTS:
  7234.          SIZE: Sets the value of the pattern size in world coordinates.
  7235.      
  7236.      
  7237.      
  7238.      
  7239.      
  7240.      
  7241.      
  7242.     OUTPUTS:
  7243.      
  7244.      
  7245.      
  7246.      
  7247.      
  7248.      
  7249.     ERRORS/EXCEPTIONS:
  7250.          8:  GKS is not in the proper state; GKS shall be in one of the
  7251.              states GKOP, WSOP, WSAC, or SGOP.
  7252.          87: Pattern size value is not positive.
  7253.      
  7254.      
  7255.      
  7256.      
  7257.      
  7258.      
  7259.     LEVEL: 0A
  7260.      
  7261.      
  7262.      
  7263.      
  7264.      
  7265.      
  7266.      
  7267.      
  7268.      
  7269.      
  7270.      
  7271.      
  7272.      
  7273.      
  7274.      
  7275.      
  7276.      
  7277.      
  7278.     DETAILED DESCRIPTION:
  7279.          This procedure sets the 'current pattern width vector' entry in
  7280.     the GKS state list to the vector (SX,0). The 'current pattern height
  7281.     vector' entry in the GKS state list is set to the vector (0,SY). When
  7282.     the currently selected fill area interior style is pattern, these
  7283.     value are used, where possible,  in conjunction with the 'current
  7284.     pattern reference point' entry in GKS state list for displaying the
  7285.     fill area output primitives.
  7286.      
  7287.      
  7288.      
  7289.     FUNCTION NAME: SET_PATTERN_REFERENCE_POINT
  7290.      
  7291.     CATEGORY: OUTPUT ATTRIBUTES
  7292.      
  7293.      
  7294.     BRIEF DESCRIPTION:  This procedure sets the value of the current
  7295.     pattern reference point.
  7296.      
  7297.      
  7298.      
  7299.      
  7300.      
  7301.      
  7302.      
  7303.     INPUTS:
  7304.          POINT: Specified the value of the pattern reference point.
  7305.      
  7306.      
  7307.      
  7308.      
  7309.      
  7310.      
  7311.      
  7312.     OUTPUTS:
  7313.      
  7314.      
  7315.      
  7316.      
  7317.      
  7318.      
  7319.      
  7320.     ERRORS/EXCEPTIONS:
  7321.          8: GKS is not in the proper state; GKS shall be in one of the
  7322.             states GKOP, WSOP, WSAC, or SGOP.
  7323.      
  7324.      
  7325.      
  7326.      
  7327.      
  7328.      
  7329.      
  7330.     LEVEL: 0A
  7331.      
  7332.      
  7333.     DETAILED DESCRIPTION:
  7334.          This procedure sets the 'current pattern reference point' entry
  7335.     in the GKS state list to the value specified. When the currently
  7336.     selected fill area interior style is pattern, this value is used,
  7337.     where possible, in conjunction with the 'current pattern width vector'
  7338.     and 'current pattern height vector' entries in the GKS state list for
  7339.     displaying the fill area output primitives.
  7340.      
  7341.      
  7342.      
  7343.     FUNCTION NAME: SET_POLYLINE_REPRESENTATION
  7344.      
  7345.     CATEGORY: OUTPUT ATTRIBUTES
  7346.      
  7347.      
  7348.     BRIEF DESCRIPTION:  This procedure defines an attribute bundle for
  7349.     polyline output for a specified workstation.
  7350.      
  7351.      
  7352.      
  7353.      
  7354.      
  7355.     INPUTS:
  7356.          WS:     An integer value representing the workstation identifier.
  7357.          INDEX:  This is the identifier of the polyline index being
  7358.                  changed or created.
  7359.          LINE:   This is the line type. Possible values are:
  7360.                    1         Solid line
  7361.                    2         Dashed line
  7362.                    3         Dotted line
  7363.                    4         Dashed-Dotted line.
  7364.          WIDTH:  This is the linewidth scale factor.
  7365.          COLOUR: This is the polyline colour index. It is a pointer into
  7366.                  the colour table of the workstation.
  7367.      
  7368.     OUTPUTS:
  7369.      
  7370.      
  7371.      
  7372.      
  7373.      
  7374.      
  7375.     ERRORS/EXCEPTIONS:
  7376.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  7377.              one of the states WSOP, WSAC, or SGOP.
  7378.          25: WS_ERROR. Specified workstation is not open.
  7379.          33: WS_ERROR. Specified workstation is of category MI.
  7380.          35: WS_ERROR. Specified workstation is of category INPUT.
  7381.          36: WS_ERROR. Specified workstation is Workstation Independent
  7382.              Segment Storage.
  7383.          63: OUTPUT_ATTRIBUTE_ERROR. Linetype is equal to zero.
  7384.          64: OUTPUT_ATTRIBUTE_ERROR. Specified linetype is not supported
  7385.              on this workstation.
  7386.      
  7387.     LEVEL: 1A
  7388.      
  7389.      
  7390.     DETAILED DESCRIPTION:
  7391.          This procedure allows the user to modify a set of bundled
  7392.     attributes for polylines. These values are used whenever POLYLINE
  7393.     is called.
  7394.      
  7395.      
  7396.      
  7397.     FUNCTION NAME: SET_POLYMARKER_REPRESENTATION
  7398.      
  7399.     CATEGORY: OUTPUT ATTRIBUTES
  7400.      
  7401.      
  7402.     BRIEF DESCRIPTION:  This procedure defines an attribute bundle for
  7403.     polymarker output for a specified workstation.
  7404.      
  7405.      
  7406.      
  7407.      
  7408.     INPUTS:
  7409.          WS:     An integer value representing the workstation identifier.
  7410.          INDEX:  This is the identifier of the polymarker index being
  7411.                  changed or created.
  7412.          MARKER: This is the marker type. Possible values are:
  7413.                    1    .
  7414.                    2    +
  7415.                    3    *
  7416.                    4    0
  7417.                    5    X
  7418.          SIZE:   This is the marker size scale factor.
  7419.          COLOUR: This is the polymarker colour index. It is a pointer
  7420.                  into the colour table of the workstation.
  7421.      
  7422.     OUTPUTS:
  7423.      
  7424.      
  7425.      
  7426.      
  7427.     ERRORS/EXCEPTIONS:
  7428.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  7429.              one of the states WSOP, WSAC, or SGOP.
  7430.          25: WS_ERROR. Specified workstation is not open.
  7431.          33: WS_ERROR. Specified workstation is of category MI.
  7432.          35: WS_ERROR. Specified workstation is of category INPUT.
  7433.          36: WS_ERROR. Specified workstation is Workstation Independent
  7434.              Segment Storage.
  7435.          67: OUTPUT_ATTRIBUTE_ERROR. A representation for the specified
  7436.              polymarker index has not been defined on this workstation.
  7437.          70: OUTPUT_ATTRIBUTE_ERROR. Specified marker type is not
  7438.              supported on this workstation.
  7439.      
  7440.      
  7441.     LEVEL: 1A
  7442.      
  7443.      
  7444.     DETAILED DESCRIPTION:
  7445.          This procedure allows the user to create or modify a set of
  7446.     bundled attributes for polymarker output. These values are used
  7447.     whenever POLYMARKER is called.
  7448.      
  7449.      
  7450.      
  7451.     FUNCTION NAME: SET_TEXT_REPRESENTATION
  7452.      
  7453.     CATEGORY: OUTPUT ATTRIBUTES
  7454.      
  7455.      
  7456.     BRIEF DESCRIPTION:  This procedure defines an attribute bundle for
  7457.     text output for a specified workstation.
  7458.      
  7459.      
  7460.      
  7461.     INPUTS:
  7462.          WS:             An integer value representing the workstation
  7463.                          identifier.
  7464.          INDEX:          This is the identifier of the text index being
  7465.                          created or changed.
  7466.          FONT_PRECISION: This is the font precision of the text
  7467.                          representation.
  7468.          EXPANSION:      This is the character expansion factor. It
  7469.                          specifies the deviation of the width to height
  7470.                          ratio of the characters from the ratio
  7471.                          indicated by the font designer.
  7472.          SPACING:        This specifies how much space is to be inserted
  7473.                          between two characters.
  7474.          COLOUR:         This is the text colour index. It is a pointer
  7475.                          into the colour table of the workstation.
  7476.      
  7477.     OUTPUTS:
  7478.      
  7479.      
  7480.      
  7481.     ERRORS/EXCEPTIONS:
  7482.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  7483.              one of the states WSOP, WSAC, or SGOP.
  7484.          25: WS_ERROR. Specified workstation is not open.
  7485.          33: WS_ERROR. Specified workstation is of category MI.
  7486.          35: WS_ERROR. Specified workstation is of category INPUT.
  7487.          36: WS_ERROR. Specified workstation is Workstation Independent
  7488.              Segment Storage.
  7489.          75: OUTPUT_ATTRIBUTE_ERROR. Text font is equal to zero.
  7490.          76: OUTPUT_ATTRIBUTE_ERROR. Requested text font is not supported
  7491.              for the specified precision on this workstation.
  7492.      
  7493.      
  7494.      
  7495.     LEVEL: 1A
  7496.      
  7497.      
  7498.     DETAILED DESCRIPTION:
  7499.          This procedure allows the user to create or modify a set of
  7500.     bundled attributes for text output. These values are used whenever
  7501.     TEXT is called.
  7502.      
  7503.      
  7504.      
  7505.     FUNCTION NAME: SET_FILL_AREA_REPRESENTATION
  7506.      
  7507.     CATEGORY: OUTPUT ATTRIBUTES
  7508.      
  7509.      
  7510.     BRIEF DESCRIPTION:  This procedure defines an attribute bundle for
  7511.     fill area output for a specified workstation.
  7512.      
  7513.      
  7514.      
  7515.     INPUTS:
  7516.          WS:       An integer value representing the workstation
  7517.                    identifier.
  7518.          INDEX:    This is the identifier of the fill area index being
  7519.                    created or changed.
  7520.          INTERIOR: This is the interior style of the fill area. Possible
  7521.                    values are HOLLOW, SOLID, PATTERN, or HATCH.
  7522.          STYLE:    This is the style index to be associated with the
  7523.                    fill area bundle being created or modified. It
  7524.                    Selects a pattern or a hatch style, depending on how
  7525.                    the parameter INTERIOR is set. This parameter is
  7526.                    ignored if the user selects HOLLOW or SOLID as the
  7527.                    interior style.
  7528.          COLOUR:   This is the fill area colour index. It is a pointer
  7529.                    into the colour table of the workstation.
  7530.      
  7531.     OUTPUTS:
  7532.      
  7533.      
  7534.      
  7535.     ERRORS/EXCEPTIONS:
  7536.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  7537.              one of the states WSOP, WSAC, or SGOP.
  7538.          25: WS_ERROR. Specified workstation is not open.
  7539.          33: WS_ERROR. Specified workstation is of category MI.
  7540.          35: WS_ERROR. Specified workstation is of category INPUT.
  7541.          36: WS_ERROR. Specified workstation is Workstation Independent
  7542.              Segment Storage.
  7543.          83: OUTPUT_ATTRIBUTE_ERROR. Specified fill area interior style
  7544.              is not supported on this workstation.
  7545.          86: OUTPUT_ATTRIBUTE_ERROR. Specified hatch style is not
  7546.              supported on this workstation.
  7547.      
  7548.      
  7549.     LEVEL: 1A
  7550.      
  7551.      
  7552.     DETAILED DESCRIPTION:
  7553.          This procedure allows the user to create or modify a set of
  7554.     bundled attributes for fill area output. These values are used
  7555.     whenever FILL AREA is called.
  7556.      
  7557.      
  7558.      
  7559.     FUNCTION NAME: SET_PATTERN_REPRESENTATION
  7560.      
  7561.     CATEGORY: OUTPUT ATTRIBUTES
  7562.      
  7563.      
  7564.     BRIEF DESCRIPTION:  This procedure defines a pattern to be displayed
  7565.     on the specified workstation.
  7566.      
  7567.      
  7568.      
  7569.      
  7570.      
  7571.      
  7572.      
  7573.     INPUTS:
  7574.          WS:      An integer value representing the workstation
  7575.                   identifier.
  7576.          INDEX:   This is the identifier of the pattern index being
  7577.                   created or modified.
  7578.          PATTERN: This specifies the dimensions of the pattern to be set.
  7579.      
  7580.      
  7581.      
  7582.     OUTPUTS:
  7583.      
  7584.      
  7585.      
  7586.      
  7587.      
  7588.      
  7589.     ERRORS/EXCEPTIONS:
  7590.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  7591.              one of the states WSOP, WSAC, or SGOP.
  7592.          25: WS_ERROR. Specified workstation is not open.
  7593.          33: WS_ERROR. Specified workstation is of category MI.
  7594.          35: WS_ERROR. Specified workstation is of category INPUT.
  7595.          36: WS_ERROR. Specified workstation is Workstation Independent
  7596.              Segment Storage.
  7597.          90: OUTPUT_ATTRIBUTE_ERROR. Interior style PATTERN is not
  7598.              supported on this workstation.
  7599.      
  7600.      
  7601.      
  7602.      
  7603.      
  7604.     LEVEL: 1A
  7605.      
  7606.      
  7607.     DETAILED DESCRIPTION:
  7608.          This procedure allows the user to create or modify a set of
  7609.     bundled attributes for the fill area routine interior style PATTERN.
  7610.      
  7611.      
  7612.      
  7613.     FUNCTION NAME: POLYLINE
  7614.      
  7615.     CATEGORY: OUTPUT
  7616.      
  7617.      
  7618.     BRIEF DESCRIPTION:  This procedure draws a sequence of connected
  7619.     straight lines.
  7620.      
  7621.      
  7622.      
  7623.      
  7624.      
  7625.     INPUTS:
  7626.          LINE_POINTS:  Provides the array of world coordinate points.
  7627.      
  7628.      
  7629.      
  7630.      
  7631.      
  7632.     OUTPUTS:
  7633.      
  7634.      
  7635.      
  7636.      
  7637.     ERRORS/EXCEPTIONS:
  7638.          5:   STATE_ERROR. GKS is not in the proper state; GKS shall be
  7639.               either in the state WSAC or in the state SGOP.
  7640.          100: OUTPUT_PRIMITIVE_ERROR. Number of points is invalid.
  7641.      
  7642.      
  7643.      
  7644.      
  7645.      
  7646.      
  7647.      
  7648.     LEVEL: Ma
  7649.      
  7650.      
  7651.     DETAILED DESCRIPTION:
  7652.          This procedure draws a sequence of connected straight lines,
  7653.     starting from the first point and ending at the last point. The
  7654.     polyline attributes used can be set by calling the SET_POLYLINE_TYPE,
  7655.     SET_POLYLINE_WIDTH_SCALE_FACTOR, and SET_COLOUR_INDEX procedures.
  7656.      
  7657.      
  7658.      
  7659.      
  7660.      
  7661.      
  7662.      
  7663.      
  7664.      
  7665.      
  7666.      
  7667.     FUNCTION NAME: POLYMARKER
  7668.      
  7669.     CATEGORY: OUTPUT
  7670.      
  7671.      
  7672.     BRIEF DESCRIPTION: This procedure draws a sequence of markers.
  7673.      
  7674.      
  7675.      
  7676.      
  7677.      
  7678.      
  7679.     INPUTS:
  7680.          MARKER_POINTS:  Provides the array of world coordinate points.
  7681.      
  7682.      
  7683.      
  7684.      
  7685.      
  7686.      
  7687.     OUTPUTS:
  7688.      
  7689.      
  7690.      
  7691.      
  7692.     ERRORS/EXCEPTIONS:
  7693.          5:   STATE_ERROR. GKS is not in the proper state; GKS shall be
  7694.               either in the state WSAC or in the state SGOP.
  7695.          100: OUTPUT_PRIMITIVE_ERROR. Number of points is invalid.
  7696.      
  7697.      
  7698.      
  7699.      
  7700.      
  7701.      
  7702.      
  7703.     LEVEL: Ma
  7704.      
  7705.      
  7706.     DETAILED DESCRIPTION:
  7707.          This procedure draws the current marker symbol at each of the
  7708.     points specified by the X world coordinate and Y world coordinate. The
  7709.     marker displayed is specified using the current polymarker attributes,
  7710.     whcih can be set by calling the SET_POLYMARKER_TYPE,
  7711.     SET_POLYMARKER_SCALE_FACTOR, and SET_POLYMARKER_COLOUR_INDEX
  7712.     procedures.
  7713.      
  7714.      
  7715.      
  7716.      
  7717.      
  7718.      
  7719.      
  7720.      
  7721.     FUNCTION NAME: FILL_AREA
  7722.      
  7723.     CATEGORY: OUTPUT
  7724.      
  7725.      
  7726.     BRIEF DESCRIPTION:  This procedure draws a fill area and fills it
  7727.     with the currently defined color, pattern, or hatch style.
  7728.      
  7729.      
  7730.      
  7731.      
  7732.      
  7733.     INPUTS:
  7734.          FILL_AREA_POINTS:  Provides the array of world coordinate
  7735.                             points.
  7736.      
  7737.      
  7738.      
  7739.      
  7740.      
  7741.     OUTPUTS:
  7742.      
  7743.      
  7744.      
  7745.      
  7746.     ERRORS/EXCEPTIONS:
  7747.          5:   STATE_ERROR. GKS is not in the proper state; GKS shall be
  7748.               either in the state WSAC or in the state SGOP.
  7749.          100: OUTPUT_PRIMITIVE_ERROR. Number of points is invalid.
  7750.      
  7751.      
  7752.      
  7753.      
  7754.      
  7755.      
  7756.      
  7757.     LEVEL:  Ma
  7758.      
  7759.      
  7760.     DETAILED DESCRIPTION:
  7761.          The polygon defined by the input points is filled using the
  7762.     currents fill area style, fill area style index, and fill area color.
  7763.     These attributes can be set by calling the
  7764.     SET_FILL_AREA_INTERIOR_STYLE, SET_FILL_AREA_STYLE_INDEX, and
  7765.     SET_FILL_AREA_COLOUR_INDEX procedures.
  7766.      
  7767.      
  7768.      
  7769.      
  7770.      
  7771.      
  7772.      
  7773.      
  7774.      
  7775.     FUNCTION NAME: TEXT
  7776.      
  7777.     CATEGORY: OUTPUT
  7778.      
  7779.      
  7780.     BRIEF DESCRIPTION:  This procedure generates a character string.
  7781.      
  7782.      
  7783.      
  7784.      
  7785.      
  7786.     INPUTS:
  7787.          POSITION:     This is a point in world coordinates at which the
  7788.                        text will begin.
  7789.          TEXT_STRING:  The text to be displayed.
  7790.      
  7791.      
  7792.      
  7793.      
  7794.      
  7795.     OUTPUTS:
  7796.      
  7797.      
  7798.      
  7799.      
  7800.      
  7801.      
  7802.     ERRORS/EXCEPTIONS:
  7803.          5:   STATE_ERROR. GKS is not in the proper state; GKS shall be
  7804.               either in the state WSAC or SGOP.
  7805.          101: OUTPUT_PRIMITIVE_ERROR. Invalid code in string.
  7806.      
  7807.      
  7808.      
  7809.      
  7810.      
  7811.      
  7812.     LEVEL: Ma
  7813.      
  7814.      
  7815.     DETAILED DESCRIPTION:
  7816.          This procedure outputs a string of text using current text
  7817.     attributes which can be set by calling the SET_TEXT_COLOUR_INDEX,
  7818.     SET_TEXT_FONT_AND_PRECISIONS, SET_TEXT_ALIGNMENT,
  7819.     SET_CHARACTER_HEIGHT, and SET_CHARACTER_UP_VECTOR procedures. The
  7820.     location is specified by the X and Y world coordinates.
  7821.      
  7822.      
  7823.      
  7824.      
  7825.      
  7826.      
  7827.      
  7828.      
  7829.     FUNCTION NAME: CELL_ARRAY
  7830.      
  7831.     CATEGORY: OUTPUT
  7832.      
  7833.      
  7834.     BRIEF DESCRIPTION:  This procedure defines and displays a rectangular
  7835.     area for a cell. It then displays color representation within the
  7836.     cell.
  7837.      
  7838.      
  7839.      
  7840.      
  7841.      
  7842.      
  7843.     INPUTS:
  7844.          CORNER_1_1:   Specifies the lower left point of the cell array.
  7845.          CORNER_DX_DY: Specifies the lower right point of the cell array.
  7846.          CELL:         Specifies a matrix of color indices for the calls
  7847.                        created in the cell array.
  7848.      
  7849.      
  7850.      
  7851.      
  7852.     OUTPUTS:
  7853.      
  7854.      
  7855.      
  7856.      
  7857.     ERRORS/EXCEPTIONS:
  7858.          5:  STATE_ERROR. GKS is not in the proper state. GKS shall be in
  7859.              one of the states WSAC or SGOP.
  7860.      
  7861.      
  7862.      
  7863.      
  7864.      
  7865.      
  7866.     LEVEL: 0A
  7867.      
  7868.      
  7869.     DETAILED DESCRIPTION:
  7870.          The cell array primitive allows the user to define a rectangular
  7871.     area and divide it into a grid of DX columns and DY rows. The color of
  7872.     each of these cells is determined by the cell's corresponding index in
  7873.     the color index array.
  7874.          This area is then transformed and mapped onto the display device.
  7875.     The transformation could affect the rectangular cells, making them
  7876.     parallelograms. Also, if part of the transformed cell is outside the
  7877.     window, it may be clipped.
  7878.      
  7879.      
  7880.      
  7881.      
  7882.      
  7883.     FUNCTION NAME: GDP_CIRCLE
  7884.      
  7885.     CATEGORY: OUTPUT
  7886.      
  7887.      
  7888.     BRIEF DESCRIPTION:  This procedure draws a circle.
  7889.      
  7890.      
  7891.      
  7892.      
  7893.      
  7894.      
  7895.      
  7896.      
  7897.     INPUTS:
  7898.          CENTER:           Provides the center point of the circle in
  7899.                            world coordinates.
  7900.          PERIPHERAL_POINT: Provides a peripheral point on the circle in
  7901.                            world coordinates.
  7902.      
  7903.      
  7904.      
  7905.      
  7906.     OUTPUTS:
  7907.      
  7908.      
  7909.      
  7910.      
  7911.      
  7912.      
  7913.      
  7914.      
  7915.     ERRORS/EXCEPTIONS:
  7916.          5:   STATE_ERROR. GKS is not in the proper state. GKS shall be in
  7917.               one of the state WSAC or SGOP.
  7918.          104: OUTPUT_PRIMITIVE_ERROR. At least one active workstation is
  7919.               not able to generate the specified generalized drawing
  7920.               primitive.
  7921.          105: OUTPUT_PRIMITIVE_ERROR. At least one active workstation is
  7922.               not able to generate the specified generalized drawing
  7923.               primitive under the current transformation and clipping
  7924.               rectangle.
  7925.      
  7926.     LEVEL: 0A
  7927.      
  7928.      
  7929.     DETAILED DESCRIPTION:
  7930.          GDP_CIRCLE draws a circle based on user inputs for the circle
  7931.     center and one point for the perimeter.
  7932.      
  7933.      
  7934.      
  7935.      
  7936.      
  7937.     FUNCTION NAME: SET_SEGMENT_TRANSFORMATION
  7938.      
  7939.     CATEGORY: SEGMENT
  7940.      
  7941.      
  7942.     BRIEF DESCRIPTION:  This procedure sets the transformation matrix for
  7943.     a segment.
  7944.      
  7945.      
  7946.      
  7947.      
  7948.      
  7949.      
  7950.      
  7951.     INPUTS:
  7952.          SEGMENT:        This is the identifier of the segment on which
  7953.                          the transformation is to be set.
  7954.          TRANSFORMATION: This is the transformation matrix.
  7955.      
  7956.      
  7957.      
  7958.      
  7959.      
  7960.     OUTPUTS:
  7961.      
  7962.      
  7963.      
  7964.      
  7965.      
  7966.      
  7967.      
  7968.     ERRORS/EXCEPTIONS:
  7969.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be
  7970.               in one of the states WSOP, WSAC, or SGOP.
  7971.          122: SEGMENT_ERROR. Specified segment does not exist.
  7972.      
  7973.      
  7974.      
  7975.      
  7976.      
  7977.      
  7978.     LEVEL: 1A
  7979.      
  7980.      
  7981.     DETAILED DESCRIPTION:
  7982.          This procedure specifies the transformation matrix for a segment.
  7983.     Segment transformations perform scaling, rotation, translation, and
  7984.     skewing of segments. The 2 x 3 transformation matrix is composed of a
  7985.     2 x 2 scaling and rotation matrix and a 2 x 1 translation matrix.
  7986.          The segment transformation is applied after the normalization
  7987.     transformation, but before clipping is performed on the segment.
  7988.      
  7989.      
  7990.      
  7991.     FUNCTION NAME: SET_VISIBILITY
  7992.      
  7993.     CATEGORY: SEGMENT
  7994.      
  7995.      
  7996.     BRIEF DESCRIPTION:  This procedure specifies whether or not a segment
  7997.     is visible.
  7998.      
  7999.      
  8000.      
  8001.      
  8002.      
  8003.      
  8004.      
  8005.     INPUTS:
  8006.          SEGMENT:    This is the identifier of the segment on which the
  8007.                      visibility is to be set.
  8008.          VISIBILITY: This is the segment visibility. Possible values are
  8009.                      VISIBLE or INVISIBLE.
  8010.      
  8011.      
  8012.      
  8013.      
  8014.     OUTPUTS:
  8015.      
  8016.      
  8017.      
  8018.      
  8019.      
  8020.      
  8021.      
  8022.      
  8023.     ERRORS/EXCEPTIONS:
  8024.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be
  8025.               in one of the states WSOP, WSAC, or SGOP.
  8026.          122: SEGMENT_ERROR. Specified segment does not exist.
  8027.      
  8028.      
  8029.      
  8030.      
  8031.      
  8032.      
  8033.      
  8034.     LEVEL: 1A
  8035.      
  8036.      
  8037.     DETAILED DESCRIPTION:
  8038.          This procedure sets the visibility of the segment to the value
  8039.     specified by the parameter.
  8040.      
  8041.      
  8042.      
  8043.      
  8044.      
  8045.     FUNCTION NAME: SET_HIGHLIGHTING
  8046.      
  8047.     CATEGORY: SEGMENT
  8048.      
  8049.      
  8050.     BRIEF DESCRIPTION:  This procedure sets the highlighting on a
  8051.     specified segment.
  8052.      
  8053.      
  8054.      
  8055.      
  8056.      
  8057.      
  8058.      
  8059.     INPUTS:
  8060.          SEGMENT:      This is the identifier of the segment on which
  8061.                        the highlighting is to be set.
  8062.          HIGHLIGHTING: This is the highlighting value of the segment.
  8063.                        Possible values are NORMAL or HIGHLIGHTED.
  8064.      
  8065.      
  8066.      
  8067.      
  8068.     OUTPUTS:
  8069.      
  8070.      
  8071.      
  8072.      
  8073.      
  8074.      
  8075.      
  8076.      
  8077.     ERRORS/EXCEPTIONS:
  8078.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8079.               one of the states WSOP, WSAC, or SGOP.
  8080.          122: SEGMENT_ERROR. Specified segment does not exist.
  8081.      
  8082.      
  8083.      
  8084.      
  8085.      
  8086.      
  8087.      
  8088.     LEVEL: 1A
  8089.      
  8090.      
  8091.     DETAILED DESCRIPTION:
  8092.          This procedure sets the highlighting of a specified segment to
  8093.     the value specified by the parameter.
  8094.      
  8095.      
  8096.      
  8097.      
  8098.      
  8099.     FUNCTION NAME: SET_SEGMENT_PRIORITY
  8100.      
  8101.     CATEGORY: SEGMENT
  8102.      
  8103.      
  8104.     BRIEF DESCRIPTION:  This procedure sets the segment priority.
  8105.      
  8106.      
  8107.      
  8108.      
  8109.      
  8110.      
  8111.      
  8112.      
  8113.     INPUTS:
  8114.          SEGMENT:  This is the identifier of the segment on which the
  8115.                    priority is to be set.
  8116.          PRIORITY: This is the value of the segment priority. Possible
  8117.                    values range from 0.0 to 1.0.
  8118.      
  8119.      
  8120.      
  8121.      
  8122.     OUTPUTS:
  8123.      
  8124.      
  8125.      
  8126.      
  8127.      
  8128.      
  8129.      
  8130.      
  8131.     ERRORS/EXCEPTIONS:
  8132.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8133.               one of the states WSOP, WSAC, or SGOP.
  8134.          122: SEGMENT_ERROR. Specified segment does not exist.
  8135.      
  8136.      
  8137.      
  8138.      
  8139.      
  8140.      
  8141.     LEVEL: 1A
  8142.      
  8143.      
  8144.     DETAILED DESCRIPTION:
  8145.          This procedure sets the segment priority to the value specified.
  8146.     Segment priority affects the display of segments and pick input if
  8147.     segments overlap, in which case GKS gives precedence to segments with
  8148.     higher priority. If segments with same priority overlap, the result is
  8149.     implementation dependent.
  8150.      
  8151.      
  8152.      
  8153.     FUNCTION NAME: CREATE_SEGMENT
  8154.      
  8155.     CATEGORY: SEGMENT
  8156.      
  8157.      
  8158.     BRIEF DESCRIPTION:  This procedure creates a segment.
  8159.      
  8160.      
  8161.      
  8162.      
  8163.      
  8164.      
  8165.      
  8166.      
  8167.     INPUTS:
  8168.          SEGMENT: This is the identifier of the segment to be created.
  8169.      
  8170.      
  8171.      
  8172.      
  8173.      
  8174.      
  8175.      
  8176.     OUTPUTS:
  8177.      
  8178.      
  8179.      
  8180.      
  8181.      
  8182.      
  8183.      
  8184.      
  8185.     ERRORS/EXCEPTIONS:
  8186.          3:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8187.               the state WSAC.
  8188.          121: SEGMENT_ERROR. Specified segment name is already in use.
  8189.      
  8190.      
  8191.      
  8192.      
  8193.      
  8194.      
  8195.      
  8196.     LEVEL: 1A
  8197.      
  8198.      
  8199.     DETAILED DESCRIPTION:
  8200.          This procedure creates a segment. All subsequent output
  8201.     primitives until the next CLOSE_SEGMENT will be collected into the
  8202.     named segment. The new segment is associated with all currently active
  8203.     workstations. Primitive attributes are not affected.
  8204.      
  8205.      
  8206.      
  8207.     FUNCTION NAME: CLOSE_SEGMENT
  8208.      
  8209.     CATEGORY: SEGMENT
  8210.      
  8211.      
  8212.     BRIEF DESCRIPTION:  This procedure closes a segment.
  8213.      
  8214.      
  8215.      
  8216.      
  8217.      
  8218.      
  8219.      
  8220.      
  8221.     INPUTS:
  8222.      
  8223.      
  8224.      
  8225.      
  8226.      
  8227.      
  8228.      
  8229.      
  8230.     OUTPUTS:
  8231.      
  8232.      
  8233.      
  8234.      
  8235.      
  8236.      
  8237.      
  8238.      
  8239.     ERRORS/EXCEPTIONS:
  8240.          4: STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8241.             the state SGOP.
  8242.      
  8243.      
  8244.      
  8245.      
  8246.      
  8247.      
  8248.      
  8249.      
  8250.     LEVEL: 1A
  8251.      
  8252.      
  8253.     DETAILED DESCRIPTION:
  8254.          This procedure defines the end of a segment. After a segment is
  8255.     closed, primitives may no longer be added to it.
  8256.      
  8257.      
  8258.      
  8259.      
  8260.      
  8261.     FUNCTION NAME: RENAME_SEGMENT
  8262.      
  8263.     CATEGORY: SEGMENT
  8264.      
  8265.      
  8266.     BRIEF DESCRIPTION:  This procedure renames a segment.
  8267.      
  8268.      
  8269.      
  8270.      
  8271.      
  8272.      
  8273.      
  8274.      
  8275.     INPUTS:
  8276.          OLD_SEGMENT: This is the segment identifier which is being
  8277.                       changed.
  8278.          SEGMENT:     This is the new segment identifier.
  8279.      
  8280.      
  8281.      
  8282.      
  8283.      
  8284.     OUTPUTS:
  8285.      
  8286.      
  8287.      
  8288.      
  8289.      
  8290.      
  8291.      
  8292.      
  8293.     ERRORS/EXCEPTIONS:
  8294.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8295.               one of the states WSOP, WSAC, or SGOP.
  8296.          121: SEGMENT_ERROR. Specified segment name already in use.
  8297.          122: SEGMENT_ERROR. Specified segment does not exist.
  8298.      
  8299.      
  8300.      
  8301.      
  8302.      
  8303.      
  8304.      
  8305.      
  8306.      
  8307.      
  8308.      
  8309.      
  8310.      
  8311.      
  8312.      
  8313.      
  8314.      
  8315.      
  8316.      
  8317.      
  8318.      
  8319.      
  8320.     LEVEL: 1A
  8321.      
  8322.      
  8323.     DETAILED DESCRIPTION:
  8324.          This procedure replaces the existing segment name with a new
  8325.     segment name.
  8326.      
  8327.      
  8328.      
  8329.      
  8330.      
  8331.     FUNCTION NAME: DELETE_SEGMENT
  8332.      
  8333.     CATEGORY: SEGMENT
  8334.      
  8335.      
  8336.     BRIEF DESCRIPTION:  This procedure deletes a segment.
  8337.      
  8338.      
  8339.      
  8340.      
  8341.      
  8342.      
  8343.      
  8344.      
  8345.     INPUTS:
  8346.          SEGMENT: This is the identifier of the segment that is to be
  8347.                   deleted.
  8348.      
  8349.      
  8350.      
  8351.      
  8352.      
  8353.      
  8354.     OUTPUTS:
  8355.      
  8356.      
  8357.      
  8358.      
  8359.      
  8360.      
  8361.      
  8362.      
  8363.     ERRORS/EXCEPTIONS:
  8364.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8365.               one of the states WSOP, WSAC, or SGOP.
  8366.          122: SEGMENT_ERROR. Specified segment does not exist.
  8367.          125: SEGMENT_ERROR. Specified segment is open.
  8368.      
  8369.      
  8370.      
  8371.      
  8372.      
  8373.      
  8374.     LEVEL: 1A
  8375.      
  8376.      
  8377.     DETAILED DESCRIPTION:
  8378.          This procedure deletes the named segment from all workstations.
  8379.      
  8380.      
  8381.      
  8382.      
  8383.      
  8384.      
  8385.     FUNCTION NAME: DELETE_SEGMENT_FROM_WS
  8386.      
  8387.     CATEGORY: SEGMENT
  8388.      
  8389.      
  8390.     BRIEF DESCRIPTION:  This procedure deletes a segment from a specific
  8391.     workstation.
  8392.      
  8393.      
  8394.      
  8395.      
  8396.      
  8397.      
  8398.      
  8399.     INPUTS:
  8400.          WS:      This is the identifier of the workstation from which
  8401.                   the segment is to be deleted.
  8402.          SEGMENT: This is the identifier of the segment to be deleted.
  8403.      
  8404.      
  8405.      
  8406.      
  8407.      
  8408.     OUTPUTS:
  8409.      
  8410.      
  8411.      
  8412.      
  8413.      
  8414.      
  8415.      
  8416.      
  8417.     ERRORS/EXCEPTIONS:
  8418.          7:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8419.               one of the states WSOP, WSAC, or SGOP.
  8420.          25:  WS_ERROR. Specified workstation is not open.
  8421.          33:  WS_ERROR. Specified workstation is of category MI.
  8422.          35:  WS_ERROR. Specified workstation is of category INPUT.
  8423.          123: SEGMENT_ERROR. Specified segment does not exist on specified
  8424.               workstation.
  8425.          125: SEGMENT_ERROR. Specified segment is open.
  8426.      
  8427.      
  8428.     LEVEL: 1A
  8429.      
  8430.      
  8431.     DETAILED DESCRIPTION:
  8432.          This procedure deletes a segment from the specified workstation.
  8433.     If the segment does not then belong to any workstations, this
  8434.     procedure has the same effect as DELETE_SEGMENT.
  8435.      
  8436.      
  8437.      
  8438.      
  8439.     FUNCTION NAME: ASSOCIATE_SEGMENT_WITH_WS
  8440.      
  8441.     CATEGORY: SEGMENT
  8442.      
  8443.      
  8444.     BRIEF DESCRIPTION:  This procedure associates a segment with a
  8445.     specified workstation.
  8446.      
  8447.      
  8448.      
  8449.      
  8450.      
  8451.      
  8452.      
  8453.     INPUTS:
  8454.          WS:      An integer value representing the workstation
  8455.                   identifier.
  8456.          SEGMENT: This is the identifier of the segment which is to be
  8457.                   associated with the workstation.
  8458.      
  8459.      
  8460.      
  8461.      
  8462.     OUTPUTS:
  8463.      
  8464.      
  8465.      
  8466.      
  8467.      
  8468.      
  8469.      
  8470.      
  8471.     ERRORS/EXCEPTIONS:
  8472.          6:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8473.               either of the states WSOP or WSAC.
  8474.          27:  WS_ERROR. Workstation Independent Segment Storage is not
  8475.               open.
  8476.          33:  WS_ERROR. Specified workstation is of category MI.
  8477.          35:  WS_ERROR. Specified workstation is of category INPUT.
  8478.          124: SEGMENT_ERROR. Specified segment does not exist on
  8479.               Workstation Independent Segment Storage.
  8480.      
  8481.      
  8482.     LEVEL: 1A
  8483.      
  8484.      
  8485.     DETAILED DESCRIPTION:
  8486.          This procedure sends the segment from Workstation Independent
  8487.     Segment Storage to the specified workstation in the same way as if the
  8488.     workstation were active when the segment was created. Clipping
  8489.     rectangles are copied unchanged.
  8490.      
  8491.      
  8492.      
  8493.     FUNCTION NAME: COPY_SEGMENT_TO_WS
  8494.      
  8495.     CATEGORY: SEGMENT
  8496.      
  8497.      
  8498.     BRIEF DESCRIPTION:  This procedure copies the primitives in a segment
  8499.     to the specified workstation.
  8500.      
  8501.      
  8502.      
  8503.      
  8504.      
  8505.     INPUTS:
  8506.          WS:      An integer value representing the workstation
  8507.                   identifier.
  8508.          SEGMENT: The identifier of the segment to be copied.
  8509.      
  8510.      
  8511.      
  8512.      
  8513.      
  8514.     OUTPUTS:
  8515.      
  8516.      
  8517.      
  8518.      
  8519.      
  8520.     ERRORS/EXCEPTIONS:
  8521.          6:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8522.               either of the states WSOP or WSAC.
  8523.          27:  WS_ERROR. Workstation Independent Segment Storage is not
  8524.               open.
  8525.          33:  WS_ERROR. Specified workstation is of category MI.
  8526.          35:  WS_ERROR. Specified workstation is of category INPUT.
  8527.          36:  WS_ERROR. Specified workstation is Workstation Independent
  8528.               Segment Storage.
  8529.          124: SEGMENT_ERROR. Specified segment does not exist on
  8530.               Workstation Independent Segment Storage.
  8531.      
  8532.      
  8533.      
  8534.      
  8535.      
  8536.     LEVEL: 1A
  8537.      
  8538.      
  8539.     DETAILED DESCRIPTION:
  8540.          This procedure sends the primitives in the segment to the
  8541.     specified workstation after segment transformation and clipping at the
  8542.     rectangle stored with each primitive. The primitives are not stored in
  8543.     a segment when they are sent to the workstation.
  8544.      
  8545.      
  8546.      
  8547.     FUNCTION NAME: INSERT_SEGMENT
  8548.      
  8549.     CATEGORY: SEGMENT
  8550.      
  8551.      
  8552.     BRIEF DESCRIPTION:  This procedure copies the primitives of a segment
  8553.     into either an open segment or a stream of primitive output.
  8554.      
  8555.      
  8556.      
  8557.      
  8558.      
  8559.      
  8560.     INPUTS:
  8561.          SEGMENT:        The identifier of the segment to be inserted.
  8562.          TRANSFORMATION: This is the transformation matrix used to insert
  8563.                          the segment.
  8564.      
  8565.      
  8566.      
  8567.      
  8568.      
  8569.     OUTPUTS:
  8570.      
  8571.      
  8572.      
  8573.      
  8574.      
  8575.     ERRORS/EXCEPTIONS:
  8576.          5:   STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8577.               either of the states WSAC or SGOP.
  8578.          27:  WS_ERROR. Workstation Independent Segment Storage is not
  8579.               open.
  8580.          124: SEGMENT_ERROR. Specified segment does not exist on
  8581.               Workstation Independent Segment Storage.
  8582.          125: SEGMENT_ERROR. Specified segment is open.
  8583.      
  8584.      
  8585.      
  8586.     LEVEL: 1A
  8587.      
  8588.      
  8589.     DETAILED DESCRIPTION:
  8590.          This procedure copies the primitives in the segment to the open
  8591.     segment or to the stream of output primitives if no segment is open.
  8592.          In both cases the transformed primitives are sent to all active
  8593.     workstations. The coordinates of the primitives contained in the
  8594.     inserted segment are transformed first by the segment transformation
  8595.     specified for it, and secondly by applying the segment transformation
  8596.     specified by the input matrix. Together the segment transformation
  8597.     and transformation matrix form the insert transformation.
  8598.      
  8599.      
  8600.      
  8601.     FUNCTION NAME: SET_WINDOW
  8602.      
  8603.     CATEGORY: TRANSFORMATION
  8604.      
  8605.      
  8606.     BRIEF DESCRIPTION:  This procedure sets the window limits.
  8607.      
  8608.      
  8609.      
  8610.      
  8611.      
  8612.      
  8613.     INPUTS:
  8614.          TRANSFORMATION:  An integer value representing a normalization
  8615.                           transformation.
  8616.          WINDOW_LIMITS:   This record defines the extent of the window
  8617.                           RECTANGLE_LIMITS in world coordinates. Its X
  8618.                           and Y components give the limits in relation to
  8619.                           the X and Y axes.
  8620.      
  8621.      
  8622.     OUTPUTS:
  8623.      
  8624.      
  8625.      
  8626.      
  8627.      
  8628.      
  8629.     ERRORS/EXCEPTIONS:
  8630.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8631.              one of the states GKOP, WSOP, WSAC, or SGOP.
  8632.          50: TRANSFORMATION_ERROR. Transformation number is invalid.
  8633.          51: TRANSFORMATION_ERROR. Rectangle definition is invalid.
  8634.      
  8635.      
  8636.      
  8637.      
  8638.      
  8639.      
  8640.     LEVEL: Ma
  8641.      
  8642.      
  8643.     DETAILED DESCRIPTION:
  8644.          This procedure specifies the 2-D window extents for the specified
  8645.     transformation number. The window specifies that portion of the world
  8646.     that is mapped to the extents of the viewport. The sides of the window
  8647.     are always vertical, and the top and bottom are always horizontal.
  8648.     Once selected by the SELECT_NORMALIZATION_TRANSFORMATION routine, the
  8649.     viewport remains in effect until respecified.
  8650.      
  8651.      
  8652.      
  8653.      
  8654.      
  8655.     FUNCTION NAME: SET_VIEWPORT
  8656.      
  8657.     CATEGORY: TRANSFORMATION
  8658.      
  8659.      
  8660.     BRIEF DESCRIPTION:  This procedure sets the viewport.
  8661.      
  8662.      
  8663.      
  8664.      
  8665.      
  8666.      
  8667.     INPUTS:
  8668.          TRANSFORMATION:  An integer value representing a normalization
  8669.                           transformation.
  8670.          VIEWPORT_LIMITS: This record defines the extent of the viewport
  8671.                           rectangle in normalized device coordinates.
  8672.                           Its X and Y components give the limits in
  8673.                           relation to the X and Y axes.
  8674.      
  8675.      
  8676.     OUTPUTS:
  8677.      
  8678.      
  8679.      
  8680.      
  8681.      
  8682.     ERRORS/EXCEPTIONS:
  8683.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8684.              one of the states GKOP, WSOP, WSAC, or SGOP.
  8685.          50: TRANSFORMATION_ERROR. Transformation number is invalid.
  8686.          51: TRANSFORMATION_ERROR. Rectangle definition is invalid.
  8687.          52: TRANSFORMATION_ERROR. Viewport is not within the normalized
  8688.              device coordinate unit square.
  8689.      
  8690.      
  8691.      
  8692.      
  8693.     LEVEL: Ma
  8694.      
  8695.      
  8696.     DETAILED DESCRIPTION:
  8697.          This procedure specifies the 2_D viewport NDC coordinates for the
  8698.     transformation number. The viewport is that portion of NDC space that
  8699.     the window is mapped into. The extents of the 2-D window will map to
  8700.     the extents of the viewport. The extents of the viewport are limited
  8701.     to the range 0.0 to 1.0 inclusive. Once selected by the
  8702.     SELECT_NORMALIZATION_TRANSFORMATION procedure, the viewport remains in
  8703.     effect until respecified.
  8704.      
  8705.      
  8706.      
  8707.      
  8708.      
  8709.     FUNCTION NAME: SELECT_NORMALIZATION_TRANSFORMATION
  8710.      
  8711.     CATEGORY: TRANSFORMATION
  8712.      
  8713.      
  8714.     BRIEF DESCRIPTION:  This procedure selects the normalization
  8715.     transformation for graphical output.
  8716.      
  8717.      
  8718.      
  8719.      
  8720.      
  8721.     INPUTS:
  8722.          TRANSFORMATION:  An integer value representing a normalization
  8723.                           transformation.
  8724.      
  8725.      
  8726.      
  8727.      
  8728.      
  8729.      
  8730.     OUTPUTS:
  8731.      
  8732.      
  8733.      
  8734.      
  8735.      
  8736.     ERRORS/EXCEPTIONS:
  8737.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8738.              one of the states GKOP, WSOP, WSAC, or SGOP.
  8739.          50: TRANSFORMATION_ERROR. Transformation number is invalid.
  8740.      
  8741.      
  8742.      
  8743.      
  8744.      
  8745.      
  8746.      
  8747.     LEVEL: Ma
  8748.      
  8749.      
  8750.     DETAILED DESCRIPTION:
  8751.          This procedure allows the user to define many viewport/window
  8752.     transformations and then select which one is to be used in scaling and
  8753.     positioning subsequent primitives.
  8754.          Each normalization transformation is identified by a
  8755.     transformation number to a maximum of 7. Zero is the unity
  8756.     transformation which maps world coordinates (0,1) x (0,1) to NDC (0,1)
  8757.     x (0,1). Normalization transformations 1 to 7 are user-definable.
  8758.      
  8759.      
  8760.      
  8761.      
  8762.      
  8763.     FUNCTION NAME: SET_CLIPPING_INDICATOR
  8764.      
  8765.     CATEGORY: TRANSFORMATION
  8766.      
  8767.      
  8768.     BRIEF DESCRIPTION:  This procedure sets the clipping indicator.
  8769.      
  8770.      
  8771.      
  8772.      
  8773.      
  8774.      
  8775.     INPUTS:
  8776.          CLIPPING:  The value of this enumerated parameter may be CLIP or
  8777.                     NOCLIP. Its value determines whether or not clipping
  8778.                     will be performed on successive output.
  8779.      
  8780.      
  8781.      
  8782.      
  8783.      
  8784.     OUTPUTS:
  8785.      
  8786.      
  8787.      
  8788.      
  8789.      
  8790.      
  8791.     ERRORS/EXCEPTIONS:
  8792.          8:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8793.              one of the states GKOP, WSOP, WSAC, or SGOP.
  8794.      
  8795.      
  8796.      
  8797.      
  8798.      
  8799.      
  8800.      
  8801.      
  8802.     LEVEL: Ma
  8803.      
  8804.      
  8805.     DETAILED DESCRIPTION:
  8806.          This procedure specifies whether 2-D window clipping is on or
  8807.     off. If window clipping is on, all output primitives will be clipped
  8808.     to the window and will not exceed the viewport boundaries. If window
  8809.     clipping is turned off, output primitives may exceed the viewport
  8810.     boundaries. If the output primitives exceed the limits of the
  8811.     workstation window, they will be clipped.
  8812.      
  8813.      
  8814.      
  8815.      
  8816.      
  8817.     FUNCTION NAME: SET_WS_WINDOW
  8818.      
  8819.     CATEGORY: TRANSFORMATION
  8820.      
  8821.      
  8822.     BRIEF DESCRIPTION:  This procedure sets the workstation window to
  8823.     the value specified.
  8824.      
  8825.      
  8826.      
  8827.      
  8828.     INPUTS:
  8829.          WS:               An integer value representing the workstation
  8830.                            identification.
  8831.          WS_WINDOW_LIMITS: This record defines the extent of the
  8832.                            workstation window rectangle in normalized
  8833.                            device coordinates. Its X and Y components give
  8834.                            the limits in relation to the X and Y axes.
  8835.      
  8836.      
  8837.     OUTPUTS:
  8838.      
  8839.      
  8840.      
  8841.      
  8842.     ERRORS/EXCEPTIONS:
  8843.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8844.              one of the states WSOP, WSAC, or SGOP.
  8845.          20: WS_ERROR. Specified workstation identifier is invalid.
  8846.          25: WS_ERROR. Specified workstation is not open.
  8847.          33: WS_ERROR. Specified workstation is of category MI.
  8848.          36: WS_ERROR. Specified workstation is Workstation Independent
  8849.              Segment Storage.
  8850.          51: TRANSFORMATION_ERROR. Rectangle definition is invalid.
  8851.          53: TRANSFORMATION_ERROR. Workstation window is not within the
  8852.              Normalized Device Coordinate unit square.
  8853.      
  8854.     LEVEL: Ma
  8855.      
  8856.      
  8857.     DETAILED DESCRIPTION:
  8858.          This procedure specifies the 2-D NDC workstation extents. The
  8859.     workstation window specifies the portion of NDC space that is mapped
  8860.     to the extents of the workstation viewport. The extents of the
  8861.     workstation wind
  8862. 'Gow are limited to the range of 0.0 to 1.0 inclusive.
  8863.     If the aspect ratio of the workstation window to the workstation
  8864.     viewport is not one to one, then the workstation window is mapped to
  8865.     the largest rectangle in the workstation viewport that maintains a one
  8866.     to one ratio without exceeding the extents specified by
  8867.     SET_WORKSTATION_VIEWPORT.
  8868.      
  8869.      
  8870.      
  8871.      
  8872.     FUNCTION NAME: SET_WS_VIEWPORT
  8873.      
  8874.     CATEGORY: TRANSFORMATION
  8875.      
  8876.      
  8877.     BRIEF DESCRIPTION:  This procedure sets the workstation viewport to
  8878.     the specified value.
  8879.      
  8880.      
  8881.      
  8882.      
  8883.     INPUTS:
  8884.          WS:                 An integer value representing the workstation
  8885.                              identification.
  8886.          WS_VIEWPORT_LIMITS: This record defines the extent of the
  8887.                              viewport rectangle in device coordinates. Its
  8888.                              X and Y components give the limits in
  8889.                              relation to the X and Y axes.
  8890.      
  8891.      
  8892.     OUTPUTS:
  8893.      
  8894.      
  8895.      
  8896.      
  8897.     ERRORS/EXCEPTIONS:
  8898.          7:  STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8899.              one of the states WSOP, WSAC, or SGOP.
  8900.          20: WS_ERROR. Specified workstation identifier is invalid.
  8901.          25: WS_ERROR. Specified workstation is not open.
  8902.          33: WS_ERROR. Specified workstation is of category MI.
  8903.          36: WS_ERROR. Specified workstation is Workstation Independent
  8904.              Segment Storage.
  8905.          51: TRANSFORMATION_ERROR. Rectangle definition is invalid.
  8906.          54: TRANSFORMATION_ERROR. Workstation viewport is not within the
  8907.              display space.
  8908.      
  8909.      
  8910.     LEVEL: Ma
  8911.      
  8912.      
  8913.     DETAILED DESCRIPTION:
  8914.          This routine specifies the 2-D device coordinate viewport. The
  8915.     workstation viewport is that portion of the workstation display
  8916.     surface into which the workstation window will be mapped. The extents
  8917.     of the workstation window will be mapped into the largest rectangle
  8918.     within the specified workstation viewport that will maintain a 1 to 1
  8919.     aspect ratio between the workstation window and the workstation
  8920.     viewport. Points extending beyond the maximum input to this function
  8921.     are clipped. The extents of the viewport are limited to the extents of
  8922.     the workstation display surface.
  8923.      
  8924.      
  8925.      
  8926.     FUNCTION NAME: EVALUATE_TRANSFORMATION_MATRIX
  8927.      
  8928.     CATEGORY: UTILITY
  8929.      
  8930.      
  8931.     BRIEF DESCRIPTION:  This procedure evaluates the transformation
  8932.     matrix.
  8933.      
  8934.      
  8935.      
  8936.      
  8937.      
  8938.      
  8939.      
  8940.     INPUTS:
  8941.          FIXED_POINT:    This is the fixed point used either for scaling
  8942.                          or as the centerpoint in rotation.
  8943.          SHIFT_VECTOR:   This is the shift vector.
  8944.          ROTATION_ANGLE: This is the rotation angle in radians. It is
  8945.                          positive if the rotation is anticlockwise.
  8946.          SCALE_FACTORS:  This is the scale factor.
  8947.      
  8948.      
  8949.     OUTPUTS:
  8950.          TRANSFORMATION: This is the resulting transformation matrix.
  8951.      
  8952.      
  8953.      
  8954.      
  8955.      
  8956.      
  8957.      
  8958.     ERRORS/EXCEPTIONS:
  8959.          8: STATE_ERROR. GKS is not in the proper state; GKS shall be in
  8960.             one of the states GKOP, WSOP, WSAC, or SGOP.
  8961.      
  8962.      
  8963.      
  8964.      
  8965.      
  8966.      
  8967.      
  8968.      
  8969.     LEVEL: 1A
  8970.      
  8971.      
  8972.     DETAILED DESCRIPTION:
  8973.          This procedure is a utility that can be used to create a
  8974.     transformation matrix. The transformation matrix can then be used by
  8975.     SET_SEGMENT_TRANSFORMATION, ACCUMULATE_TRANSFORMATION_MATRIX, or
  8976.     INSERT_SEGMENT.
  8977.      
  8978.      
  8979.      
  8980.     FUNCTION NAME: ACCUMULATE_TRANSFORMATION_MATRIX
  8981.      
  8982.     CATEGORY: UTILITY
  8983.      
  8984.      
  8985.     BRIEF DESCRIPTION:  This procedure accumulates transformation
  8986.     matrices.
  8987.      
  8988.      
  8989.      
  8990.      
  8991.      
  8992.      
  8993.      
  8994.     INPUTS:
  8995.          SOURCE_TRANSFORMATION: The name of the transformation matrix to
  8996.                                 be concatenated.
  8997.          FIXED_POINT:           This is the fixed point used either for
  8998.                                 scaling or as the centerpoint in rotation.
  8999.          SHIFT_VECTOR:          This is the shift vector.
  9000.          ROTATION_ANGLE:        This is the rotation angle in radians. It
  9001.                                 is positive if anticlockwise.
  9002.          SCALE_FACTORS:         This is the scale factor.
  9003.      
  9004.     OUTPUTS:
  9005.          RESULT_TRANSFORMATION: This is the transformation matrix that
  9006.                                 results from the specified input
  9007.                                 parameters.
  9008.      
  9009.      
  9010.      
  9011.      
  9012.      
  9013.     ERRORS/EXCEPTIONS:
  9014.          8: STATE_ERROR. GKS is not in the proper state; GKS shall be in
  9015.             one of the states GKOP, WSOP, WSAC, or SGOP.
  9016.      
  9017.      
  9018.      
  9019.      
  9020.      
  9021.      
  9022.      
  9023.      
  9024.     LEVEL: 1A
  9025.      
  9026.      
  9027.     DETAILED DESCRIPTION:
  9028.          This procedure is a utility that can be used to concatenate
  9029.     transformations. It constructs a segment transformation matrix to be
  9030.     used by SET_SEGMENT_TRANSFORMATION or INSERT_SEGMENT.
  9031.      
  9032.      
  9033.                   APPENDIX B
  9034.      
  9035.         This appendix contains a macroinstruction for compiling all
  9036. of level ma. This macro is for use with a Data General AOS/VS
  9037. operating system. If the files are to be compiled on another operating
  9038. system, this appendix merely suplies the correct order of compilation
  9039. for the files.
  9040.         The first five lines in the macro compile the package
  9041. specifications for the first of the Device Driver files. The sixth
  9042. line is another macro which is used to import the necessary
  9043. relocatable binary object files and then create the package bodies
  9044. and object code for those first five Device Driver packages.
  9045.         If these files are to be compiled on some other operating
  9046. system, the user will have to use whatever command that system
  9047. supplied to successfully compile the Device Driver packages.
  9048.      
  9049.      
  9050.      
  9051. ADA IMPORT_READ.ADA
  9052. ADA IMPORT_WRITE.ADA
  9053. ADA IMPORT_VARIABLES.ADA
  9054. ADA IMPORT_WAIT.ADA
  9055. ADA IMPORT_OPEN.ADA
  9056. NAME_IMPORT
  9057. ADA GKS_CONFIGURATION_MA.ADA
  9058. ADA GKS_COOR_SYS.ADA
  9059. ADA GKS_MATRIX_UTILITIES.ADA
  9060. ADA GKS_LIST_UTILITIES.ADA
  9061. ADA GKS_LIST_UTILITIES_B.ADA
  9062. ADA GKS_TYPES_A.ADA
  9063. ADA LEXI3700_COMM.ADA
  9064. ADA LEXI3700_COMM_B.ADA
  9065. ADA LEXI3700_CONFIG.ADA
  9066. ADA LEXI3700_TYPES.ADA
  9067. ADA LEXI_OUT_DRIVER.ADA
  9068. ADA LEXI_OUT_DRIVER_B.ADA
  9069. ADA OUT_ATTR_TYP.ADA
  9070. ADA CGI_MA.ADA
  9071. ADA DICTIONARY.ADA
  9072. ADA DICTIONARY_B.ADA
  9073. ADA CGI_OPEN_WS_OPS.ADA
  9074. ADA LEXI3700_WSD_MA.ADA
  9075. ADA ERROR_ROUTINES_MA.ADA
  9076. ADA GKS_CONTROL.ADA
  9077. ADA GKS_NORM.ADA
  9078. ADA INQ_BUNDLE_IDX.ADA
  9079. ADA INQ_GKS_DSCR_TBL_MA.ADA
  9080. ADA INQ_GKS_ST_LST_MA.ADA
  9081. ADA INQ_INDV_ATTR.ADA
  9082. ADA INQ_PRIM_ATTR.ADA
  9083. ADA INQ_WS_DSCR_TBL_MA.ADA
  9084. ADA INQ_WS_ST_LST_MA.ADA
  9085. ADA OUT_PRIM.ADA
  9086. ADA SET_CLR_TBL.ADA
  9087. ADA SET_INDV_ATTR_MA.ADA
  9088. ADA SET_PRIM_ATTR_MA.ADA
  9089. ADA WS_CONTROL.ADA
  9090. ADA WS_XFORM.ADA
  9091. ADA WS_TBL_TYP.ADA
  9092. ADA WS_DSCR_TBL_TYP.ADA
  9093. ADA WSR_INQ_WS_DSCR_MA.ADA
  9094. ADA WSR_INQ_WS_DSCR_MA_B.ADA
  9095. ADA RECTANGLE_OPS.ADA
  9096. ADA RECTANGLE_OPS_B.ADA
  9097. ADA DC_OPS_DEFS.ADA
  9098. ADA DC_OPS_DEFS_B.ADA
  9099. ADA DC_OPS.ADA
  9100. ADA NDC_OPS_DEFS.ADA
  9101. ADA NDC_OPS_DEFS_B.ADA
  9102. ADA NDC_OPS.ADA
  9103. ADA DC_POINT_OPS.ADA
  9104. ADA DC_POINT_OPS_B.ADA
  9105. ADA NDC_POINT_OPS.ADA
  9106. ADA NDC_POINT_OPS_B.ADA
  9107. ADA CONVERT_NDC_DC.ADA
  9108. ADA CONVERT_NDC_DC_B.ADA
  9109. ADA WS_ST_LST_TYP_MA.ADA
  9110. ADA LEXI3700_TBLS_MA.ADA
  9111. ADA LEXI_UTILITIES.ADA
  9112. ADA LEXI_UTILITIES_B.ADA
  9113. ADA LEXI_OUT_PRIM_MA.ADA
  9114. ADA WSR_SET_PRIM_MA.ADA
  9115. ADA WSR_SET_PRIM_MA_B.ADA
  9116. ADA WSR_SET_CHAR_VECS.ADA
  9117. ADA WSR_SET_TEXT_AL.ADA
  9118. ADA WSR_SET_INDV_MA.ADA
  9119. ADA WSR_SET_INDV_MA_B.ADA
  9120. ADA WSR_SET_LINETYPE.ADA
  9121. ADA WSR_SET_PLIN_CLR_IDX.ADA
  9122. ADA WSR_SET_PMRK_CLR_IDX.ADA
  9123. ADA WSR_SET_TEXT_CLR_IDX.ADA
  9124. ADA WSR_SET_FA_INT_STY.ADA
  9125. ADA WSR_SET_FA_CLR_IDX.ADA
  9126. ADA WSR_SET_MARK_TYPE.ADA
  9127. ADA WSR_WS_XFORM.ADA
  9128. ADA WSR_WS_XFORM_B.ADA
  9129. ADA WSR_UPDATE_WS_XFORM.ADA
  9130. ADA GKS_ERRORS.ADA
  9131. ADA WSR_INQ_WS_ST_MA.ADA
  9132. ADA WSR_INQ_WS_ST_MA_B.ADA
  9133. ADA WSR_INQ_WS_CON_TYPE.ADA
  9134. ADA WSR_INQ_WS_XFORM.ADA
  9135. ADA WSR_INQ_LST_CLR_IDC.ADA
  9136. ADA WSR_INQ_CLR_REP.ADA
  9137. ADA WSR_SET_CLR_TABLE.ADA
  9138. ADA WSR_SET_CLR_TABLE_B.ADA
  9139. ADA WSR_UTILITIES.ADA
  9140. ADA WSR_UTILITIES_B.ADA
  9141. ADA LEXI_OUT_PRIM_MA_B.ADA
  9142. ADA WSR_PLINE_CLIP.ADA
  9143. ADA WSR_PMRK_CLIP.ADA
  9144. ADA WSR_AREA_CLIP.ADA
  9145. ADA WSR_TEXT_CLIP.ADA
  9146. ADA WSR_LINE_CLIP.ADA
  9147. ADA WSR_TEXT_HANDLING.ADA
  9148. ADA WSR_TRANSFORM.ADA
  9149. ADA LEXI_CLR_OPS.ADA
  9150. ADA LEXI_CLR_OPS_B.ADA
  9151. ADA WSD_SET_CLR_REP.ADA
  9152. ADA WSR_GKS_NORM.ADA
  9153. ADA WSR_GKS_NORM_B.ADA
  9154. ADA ADD_ST_LST_TO_LST_MA.ADA
  9155. ADA DELETE_ST_LST_FR_LST_MA.ADA
  9156. ADA GET_ST_LST_PTR_MA.ADA
  9157. ADA LEXI_WS_CONT_MA.ADA
  9158. ADA LEXI_WS_CONT_MA_B.ADA
  9159. ADA WSD_OPEN_WS.ADA
  9160. ADA WSD_CLOSE_WS_MA.ADA
  9161. ADA WSD_CLEAR_WS_MA.ADA
  9162. ADA WSD_UP_WS_MA.ADA
  9163. ADA LEXI_INQ_TEXT.ADA
  9164. ADA LEXI_INQ_TEXT_B.ADA
  9165. ADA WSD_INQ_TEXT_EXT.ADA
  9166. ADA LEXI3700_WSD_MA_B.ADA
  9167. ADA LEXI3700_TBLS_MA_B.ADA
  9168. ADA WSM_MA.ADA
  9169. ADA WS_COMM.ADA
  9170. ADA WS_COMM_B.ADA
  9171. ADA XMIT.ADA
  9172. ADA XMIT_TYPE.ADA
  9173. ADA XMIT_ALL.ADA
  9174. ADA WSM_MA_B.ADA
  9175. ADA GKS_ST_LST.ADA
  9176. ADA TRANS_FACT.ADA
  9177. ADA TRANS_FACT_B.ADA
  9178. ADA GKS_ST_LST_B.ADA
  9179. ADA TRANS_MATH.ADA
  9180. ADA TRANS_MATH_B.ADA
  9181. ADA GKS_OPERATING_ST_LST.ADA
  9182. ADA GKS_DSCR_TBL_MA.ADA
  9183. ADA GKS_DSCR_TBL_MA_B.ADA
  9184. ADA GKS_ERROR_ST_LST.ADA
  9185. ADA SQUARE_ROOT.ADA
  9186. ADA SQUARE_ROOT_B.ADA
  9187. ADA GET_OUTPUT_ATTR.ADA
  9188. ADA GET_OUTPUT_ATTR_B.ADA
  9189. ADA SET_INDV_ATTR_MA_B.ADA
  9190. ADA SET_PRIM_ATTR_MA_B.ADA
  9191. ADA INQ_PRIM_ATTR_B.ADA
  9192. ADA INQ_BUNDLE_IDX_B.ADA
  9193. ADA INQ_INDV_ATTR_B.ADA
  9194. ADA GKS_NORM_B.ADA
  9195. ADA WS_XFORM_B.ADA
  9196. ADA INQ_GKS_ST_LST_MA_B.ADA
  9197. ADA INQ_GKS_DSCR_TBL_MAB.ADA
  9198. ADA INQ_WS_ST_LST_MA_B.ADA
  9199. ADA INQ_WS_DSCR_TBL_MA_B.ADA
  9200. ADA SET_CLR_TBL_B.ADA
  9201. ADA ERROR_ROUTINES_MA_B.ADA
  9202. ADA WS_CONTROL_B.ADA
  9203. ADA GKS_CONTROL_B.ADA
  9204. ADA OUT_PRIM_B.ADA
  9205. ADA ERROR_LOGGING_S.ADA
  9206. ADA ACTIVATE_WS_S.ADA
  9207. ADA DEACTIVATE_WS_S.ADA
  9208. ADA CLEAR_WS_S.ADA
  9209. ADA CLOSE_WS_S.ADA
  9210. ADA CLOSE_GKS_S.ADA
  9211. ADA FA_S.ADA
  9212. ADA OPEN_GKS_S.ADA
  9213. ADA OPEN_WS_S.ADA
  9214. ADA PLIN_S.ADA
  9215. ADA PMRK_S.ADA
  9216. ADA TXT_S.ADA
  9217. ADA UP_WS_S.ADA
  9218. ADA A_CLIP_UTILITIES_B.ADA
  9219. ADA A_ADD_EDGES.ADA
  9220. ADA A_ADD_INTERIOR.ADA
  9221. ADA A_ADD_TO_EDGE_LIST.ADA
  9222. ADA A_BEGIN_INTERIOR.ADA
  9223. ADA A_JOIN_LINES.ADA
  9224. ADA A_SEP_NEXT_SEGMENT.ADA
  9225. ADA A_SORT_BY_X.ADA
  9226. ADA A_SORT_BY_Y.ADA
  9227. ADA CLIP_ON_BOTTOM.ADA
  9228. ADA BOTTOM_S_AND_H.ADA
  9229. ADA CLIP_ON_LEFT.ADA
  9230. ADA CLIP_ON_RIGHT.ADA
  9231. ADA CLIP_ON_TOP.ADA
  9232. ADA LEFT_S_AND_H.ADA
  9233. ADA RIGHT_S_AND_H.ADA
  9234. ADA TOP_S_AND_H.ADA
  9235. ADA WSD_FA_MA.ADA
  9236. ADA WSD_FIND_EXTENTS.ADA
  9237. ADA WSD_PLINE_MA.ADA
  9238. ADA WSD_PMRK_MA.ADA
  9239. ADA WSD_TEXT_MA.ADA
  9240.