path: root/doc/rfc/rfc177.txt

NETWORK WORKING GROUP                                       J. McConnell
Request for Comment: 177           Ames Research Center Moffet Field, CA
Obsoletes: none                                             15 June 1971
Updates: 125
NIC: 7102

           A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION

   As more nodes are connected to the ARPA network, the types of
   graphical display processors available to users is quite varied.  To
   attempt to facilitate the transmission of graphical information over
   the network, a device independent description of a display is
   described.  The using host may make any conversions necessary to
   realize the picture on a specific device.  It is also possible to
   interpose a form machine as proposed by Heafner and Harslem in RFC
   #94.  Some of the items and entities described herein were first
   discussed by Steve Crocker in RFC #86.  It is intended that this
   description is to be oriented to a refresh display with point,
   vector, and character drawing capability, these types of devices
   include the IBM 2250, IMLAC PDS-1, the DEC 338, and DEC 340, as well
   as the Evans and Sutherland LDS-1.  However, direct video storage
   tube devices represented by the ARDS, Tektronix and Computer devices
   can also serve as clumsy interactive devices.  Hard copy devices,
   such as microfilm or plotters, can also be used at the using host's
   discretion.

   There are several items and constructs which will be defined before
   discussing the specifics of the description:

      1.  The network standard graphics description stream (NGDS)
      contains the description, data, and operators necessary to effect
      a display.

      2.  The network standard stream interpreter (NGSI) parses the NGDS
      into its components.

      3.   The network standard display list (NGDL) is the basic entity
      which, when executed, causes graphical information to be
      displayed.

      4.  The network standard list interpreter (NGLI) is the entity
      which executes the NGDL and controls the beam movement to effect
      generation of graphical information.

      5.  The network standard screen (NGS) is the entity on which the
      information is to be displayed.  It may be divided into image
      areas to be defined later.




McConnell                                                       [Page 1]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


      6.  The network standard graphics list pointer (NGLP) and the
      network standard graphics execution stack (NGES) are entities
      which describe the state of the NGLI at any given time and provide
      the facilities to allow the NGLI to be a recursive interpreter.

   Figure 1. summarizes the preceding discussion graphically, which is
   appropriate.

   The network standard graphics screen is rectangular and positions on
   it are specified by an ordered pair of fractions representing the
   horizontal distance from the left edge and the vertical distance from
   the bottom edges respectively.  These shall be termed the (x,y)
   coordinates as is standard.  There is no specification of resolution,
   so that the quality of the picture will degrade with the decreasing
   resolution of a poor display device, or be improved if it is
   displayed on a higher resolution device.  Coordinate values are
   specified by a 16 bit unsigned fractions with the binary point to the
   left of the most significant bit - this provides a normalized screen
   with coordinates between 0.0 and .999...9.

   The NGS may be subdivided into rectangular image areas with
   possibility unique displays in each space. An image area has three
   attributes:  a 16 bit integer name, an x,y pair specifying the lower
   left corner and an x,y pair to specify the upper right corner of the
   area.  Image spaces may overlap, but may not be completely contained
   within each other.  The main image space has the name 0 and is
   coincident with the NGS.  The use of image spaces allows for
   manipulation of part of the NGS's contents, as well as redefining the
   coordinate space. Within an image area, coordinate values are
   fractional displacements from the lower left hand corner of the image
   space.  Thus an image area defined from (0.0, 0.0) to (0.5, 0.5)
   would contain an image one-fourth of the size of what it would be on
   the full NGS.

   Character strings may be displayed at arbitrary points in an image
   area.  Because many display devices have hardware character
   generators capable of producing one, or a few sizes, character
   scaling within an image area will not be expected.  Characters shall
   be assumed to be .014 screen width wide, and .025 screen height high
   including spacing.  This gives a screen capacity of 72 characters and
   40 lines.  When the beam is moved to be a screen position prior to
   drawing a character, it is assumed to be in the center of the
   rectangle defining the character space.  The beam position after
   drawing a character, or a string of characters, is undefined.

   The format of the NGDS can now be specified.  The NGSI parses the
   NGDS into commands.  The commands are in a prefix format with an
   eight bit command followed by the necessary parameters.  Their



McConnell                                                       [Page 2]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


   descriptions follow the numerical order of the command codes.

   ERASE (commands = 0) consists of a command byte and no parameters.
   Its effect is to erase the full NGS.

   DEFINE LIST (commands = 1) has three parameters.  A 16 bit integer
   for the list name is first.  If the name has already been used, then
   this command redefines the list.  The count of the items in the list
   is also a 16 bit integer defining the length of the list in items.
   The list items follow the count terminating with an end list item.

   The items themselves are used to control the NGLI and the movement of
   the beam when drawing pictures.  They are also in prefix format, with
   an eight bit item code followed by the necessary parameters.  All
   names are 16 bit integers, coordinate data are 16 bit unsigned
   fractions as previously described.  Any other parameters will have
   their type and size specified in individual descriptions.

      a.  OPEN IMAGE AREA (name) (item type = 0) instructs the NGLI that
      list commands which follow are to be adjusted to be contained
      within the named area.  A nonexistent area name is treated as a
      NOP.  If no image area is specified for the NGLI the default area
      is area 0, the NGS.  This directive remains in effect until
      another type 0 item is encountered by the NGLI.

      b.  RESET IMAGE AREA (name) (item type = 1) causes the NGLI to
      move the beam to the lower left corner of the image area.  A
      nonexistent name is again treated as a NOP.

      c.  CLEAR IMAGE AREA (name) (item type = 2) causes the NGLI to
      erase all graphical information in the specified area, and then to
      perform a reset command.

   The following items are display items which actually cause beam
   movement by the NGLI.  Coordinate data are relative to the origin of
   the current image area and are taken as fractional displacements
   within this area.

      d.  MOVE BEAM (x,y) (item type = 3) causes the NGLI to move the
      beam to (x,y) relative to the current origin.

      e.  DISPLAY CURRENT POSITION (item type = 4) causes the NGLI to
      display the current point on the NGS.








McConnell                                                       [Page 3]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


      f.  DISPLAY VECTOR (x,y) (item type = 5) causes a vector to be
      drawn from the current point to (x,y).  After the operation, (x,y)
      becomes the current point.

      g.  DISPLAY CHARACTERS (n, 'C1, C2...Cn') (item type = 6) causes
      the n characters to be displayed starting from the current point.
      N is the character count and is an eight bit byte.

   The character set recognized by the NGLI is composed of eight bit
   bytes interpreted in the following ways.  Any character with the most
   significant bit a zero is interpreted as an ASCII character.  Some
   non-graphic ASCII characters may have special functions within a
   string:

      1.  Line feed (LF) move the beam one line spacing downward.

      2.  Carriage return (CR) move the beam to the left most character
      position in the current line.

      3.  Backspace (BS) move the beam one character position to the
      left in the current line.

      4.  Tab move the beam a predetermined number of character
      positions to the right in the current line.  The number will
      follow the tab character in the string, but may not exceed the
      capacity of the current line.

      5.  Vertical tab (VT) move the beam down a predetermined number of
      line spacings.  The number of spacings follow the VT character and
      may not exceed the line capacity of the screen.  This is expanded
      as multiple line feeds.

      6.  Any other non-graphic character - could cause a space
      character to appear in its place on the display, or it may be used
      for any purpose two processes choose.

   Characters with the most significant bit a one are used for an
   extended character set where a device can support this.  These may
   also be used as an implicit stroke table, calls being the names of
   special graphic lists that may be defined in the NGDS.  If no eight
   bit list name exists, then the character is a space.

      h.  EXECUTE LIST (name, x, y) (item type =7) causes the NGLI to
      suspend interpretation of the list and interpret the named list.
      It is equivalent to a subroutine call.  The (x,y) pair specifies
      the origin of the new list relative to the current origin.  The
      actions taken by the NGLI are specified in the next section




McConnell                                                       [Page 4]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


      i.  COPY LIST (name, x,y) (item type = 8) cause the items
      contained in the named list to be copied into the place of the
      item with the origin of the list at (x,y) relative to the current
      origin.  This is analogous to item (h) as a subroutine is to a
      macro.

      j.  EXECUTE TABLE (name, mode, length) (item = 9) causes the NGLI
      to treat the named list as a special entity.  It is constrained to
      contain only coordinate pairs.  It may be executed in either point
      or vector mode as specified by the mode parameter 1= vector, 0=
      point.  The length of the list is specified by a 16 bit integer
      parameter.

      k.  END LIST (item type = 10) has no parameters and informs the
      NGLI that the end of a list has been reached.

      l.  TABLE (n) (item type = 11) specifies that there are (x,y)
      pairs in this list.  N is a 16 bit integer.

      m.  Set vector mode (mode) (item type = 12)

      n.  Set character mode (mode) (item type 13)

   In addition to the above display items, some items exist which
   control the display mode of the above where this is applicable.
   There are two mode items, the one governing vector modes, and one for
   character modes.  The quantities specified include brightness,
   blinking, color selection, and mode dependent descriptions.

   For vector modes, the texture of vectors such as dashed, solid or,
   dotted can be specified.  For characters, size, and orientation can
   be additionally specified.  The scope of a mode item extends to the
   next encountered mode item of the same type.  Mode specifications
   could have been included in the display items at the expense of more
   parameters and in possibly more data to be transmitted.  The mode
   specification consists of two eight bit bytes.  The bytes have the
   following organization:














McConnell                                                       [Page 5]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


   1    4         3            2                     2    3
 +-----------------------+  +-----------------+   +-------------------+
 |    |    |             |  |     |           |   |     |     |       |
 |  B | BL |     CLR     |  | TX  |           |   | OR  |  SZ |       |
 |    |    |             |  |     |           |   |     |     |       |
 +-----------------------+  +-----------------+   +-------------------+

 BYTEO - both modes         BYTE 1- vector        BYTE 1- Character mode
                            mode

 Where      B     Blink if set

            BL    Brightness level - 0 = invisible, IIII brightness

            CLR   Color          One bit for each primary

            TX    Texture        OO = solid

                                 01 = dashed

                                 10 = dotted

                                 11 = dot - dash

           OR     Orientation binary value x 90deg

           SZ     Size

   If the device will ot support them, or provide subroutines to perform
   these enhanced functions, they are treated as NOPs.

   Thus the NGDL is a set of named lists.

      DEFINE IMAGE AREA (command = 2) has three parameters a 16 bit area
      name; an (x,y) pair defining the lower left corner of the area and
      an (x,y) pair defining the upper right corner.  If the name has
      already been used to define an area then this command serves a
      re-definition of that area.  If the two (x,y) information
      displayed in it.  If X1 is greater than Xr or Y1 is greater than
      Yr then the definition is treated as NOP.

      The following commands are included to avoid retransmission of a
      list when some minor changes to it are necessary.  All instances
      of a list, where an instance is a command to execute the list will
      be effected.  Where a list has been copied into another list, no
      change will take place in the copied list.





McConnell                                                       [Page 6]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


      TRANSLATE LIST (command = 3) provides for translation of all
      instances of a list within all of the image spaces it occurs in.
      Parameters are the 16 bit list name, and two 16 fractions for the
      coordinate values of the translation.

      SCALE LIST (command = 4) can change the size of the picture
      created by a list in all image spaces.  The parameters are the 16
      bit list name followed by two 16 bit (X,Y) unsigned fractions with
      eight bits of exponent followed by eight bits of mantissa.  These
      alter the scale factors in the X and Y directions.

      ROTATE LIST (command = 5) will rotate all instances of a list.
      The parameters are for the 16 bit list name, and a 16 bit value
      corresponding to rotational angle in degrees with the sense being
      counter-clockwise for increasing values and the possible axis
      being zero degrees.

   The NGLI executes in a loop, taking items from the main list.  When
   the end of the main list is reached, the NGLI returns to the top of
   it.  At any point, the NGLP gives the NGLI the positional
   displacement of the next display item it is processing.  When a
   display item of the type h. is encountered, the current lists's
   execution is suspended,  the name of the list, the current origin,
   and the NGLP are saved in the NGES.  The NGLP is re-set to zero, the
   next current origin is calculated, and execution of the new list
   commences.  When the end of the list is encountered, the old values
   are restored from the NGES and execution of the suspended list
   continues.  The NGLI is then a recursive interpreter.  Whenever a new
   image area is opened, the name of that image area is stored in the
   current image area name.

   The problem of interacting with the displayed picture has yet to be
   addressed since this is a more complicated area.  Interaction may
   occur in two fashions:  the first, and the easiest to handle, are
   those kinds of events which are separate from the picture itself.
   This encompasses key boards and function key types of devices.  These
   can be handled as standard messages from the graphics device to the
   serving host.  The second class of interactions is with the picture
   itself.  This is more difficult because of the problem of associating
   the point selected with some meaningful entity such as a list.  This
   association can probably only be made by the serving host since the
   using host, or a Form Machine, may have transformed the NGDS in
   unknown ways, and the NGDS may no longer exist at the using host's
   site.

   There are essentially two classes of devices that can interact with
   the picture.  The first class is synchronous devices, ones who only
   cause some attention to occur while a given display item is being



McConnell                                                       [Page 7]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


   executed.  Light pens are synchronous devices.  Asynchronous devices
   are those which can interact regardless of which, or even when no,
   display item is being executed.  Asynchronous devices make
   associations more difficult since no relationship can be easily
   inferred as they can for synchronous devices.

   The NGES is created for the interaction with the picture.  For
   synchronous devices the current values for the list name, origin, and
   NGLP, as well as the contents of the NGES provides a hierarchical
   structure where associations can be made.  For asynchronous devices,
   the structure is probably not as necessary as the name and
   coordinates within the image space in which the interaction occurred.
   It will be necessary for the using host to understand which type of
   devices are available and to supply proper type of interaction
   information to the serving host.

   The form of the interaction information for synchronous devices
   follows:


INTERACTION (type, cia, cln, cor, clp, n, l1, or1, lp1, ...ln, orn, lpn)

   Where type describes the interaction type 0=synchronous
   cia     current image area name
   cln     current list name
   cor     current origin value
   clp     current NGLP value
   n       number of entries in NGES, higher value of n is older entry
   li      list name of the i th entry
   ori     origin of the i th entry
   lpi     NGLP of the i th entry

   The form for asynchronous i.. teraction is:

   INTERACTION (type, cia, iax, iay, sx, sy)

   Where type = 1 for asynchronous interactions
   cia     current image name
   iax     image area x coordinate
   iay     image area y coordinate
   sx,sy   screen x,y coordinates










McConnell                                                       [Page 8]
^L
RFC 177    A DEVICE INDEPENDENT GRAPHICAL DISPLAY DESCRIPTION  June 1971


NETWORK  |    Using Host
         |                +-------+
         |                |       |
         |                | NGDL  |          +--------+       +-------+
         +--------+       |       |--------->|        |       |       |
         |        |------>|       |          |  NGLI  |------>|  NGS  |
         |  NGDS  |       +-------+          |        |       |       |
         |        |       +-------+          |        |       |       |
         |        |------>|       |--------->|        |       +-------+
         +--------+       |IMAGE  |          +--------+
         |                |AREA   |              ^
         |                |DEFINI-|              |
         |                |TIONS  |              V
         |                +-------+          *--------+
         |                                   |  NGLES |
         |                                   |    &   |
         |                                   |  NGLP  |
         |                                   +--------+











        [This RFC was put into machine readable form for entry]
    [into the online RFC archives by Kelly Tardif, Viag�nie 12/1999]




















McConnell                                                       [Page 9]
^L