RFC 336






NIC 9929                                                Ira Cotton
NWG/RFC #336                                            Mitre
Level 0 Graphic Input Protocol                          5 May 1972

        Level 0 Graphic Input Protocol

           At its meeting on April 16-18 the network Graphics working
           group began to consider the definition of levels of protocol
           for graphic Input Protocol.  The following describes the
           Level 0 graphics input protocol.

           The philosophy guiding the establishment of this protocol is
           the same as suggested in RFC #178, "Network Graphic Attention
           Handling." Briefly, all input will be described by type,
           origin, and length, followed by the actual data.

           Only two types of input are defined at Level 0: text and
           simple position.

              Text Input

                  Text input will be conveyed in the following format:

                   TEXTIN : DEVICE : COUNT: Text String



                 TEXTIN is a protocol code indicating the nature of this
                 input string.  For the present this code is defined to
                 be 1.

                 DEVICE is a code indicating the device from which the
                 input originated.  The following codes are presently
                 defined:

                      0 - unspecified device
                      1 - primary keyboard
                      2 - tablet
                      3 - mouse
                      4 - joystick
                      5 - lightpen
                      6 - cursor
                      7 - keyset
                      8 - mouse & keyset







                                                                [Page 1]

NIC 9929
NWG/RFC# 336
Level 0 Graphic Input Protocol

                 Count is an integer number indicating the number of
                 characters (bytes) which follow.

                 Text String is a string of "Count" bytes of characters
                 in network ASCII.

              Position Input

                   Simple position data will be conveyed in the
              following format:

                   POSIT : DEVICE : COUNT : x : y

                 POSIT is a protocol code indicating that this string
                 contains position data.  For the present this code is
                 defined to be 2.

                 DEVICE is a code indicating the input device on which
                 this data was generated.  The codes are as defined
                 above.

                 COUNT is an integer number indicating the number of
                 bytes of data which follow.  This includes data for
                 both x and y coordinates.  Thus, the number of bytes of
                 x coordinate data is COUNT divided by 2.  At level 0,
                 COUNT should always be 4, since at this level all
                 coordinates are expressed in 2 bytes of data.

                 x and y coordinate data are represented as signed
                 fractions in the same fashion that position data is
                 represented in the Level 0 graphic output protocol.

           It should be emphasized that input data from a level 0
           graphics user which is not in a format described above should
           be sent on a different link than the graphics input link.
           This may be desirable for certain applications to avoid the
           overhead of the protocol.

       [ This RFC was put into machine readable form for entry ]
       [ into the online RFC archives by BBN Corp. under the   ]
       [ direction of Alex McKenzie.                   12/96   ]






                                                                [Page 2]