Network Working Group                                  Karl C. Kelley
Request for Comments:  387                                Jaacov Meir
NIC:  11359                                                   8/10/72
Categories:  D.6, F
Obsoletes:
References:  RFC #292


   SOME EXPERIENCES IN IMPLEMENTING NETWORK GRAPHICS PROTOCOL LEVEL 0


    We are in the process of implementing NGP-0 at several hosts.  For
the time being, we are forced to consider the remote host as the "last
intelligent machine". We are attempting to translate NGP-0 to a machine
dependent code for the Computek display. The remote hosts are CCN, UCSD,
and soon RANDCSG. More comments about that work will be made in
subsequent RFC's. The concern of this RFC is twofold:

    1.  Clarify the coordinate number system.

    2.  Puzzle over how to do TEXTR string without either:

        a.  Reading current position and saving it while the text string
            is being output, or

        b.  Monitoring the beam position for each NGP command and saving
            this information somewhere.

    An appendix to this RFC will outline the conversion from the NGP
coordinate system to the floating point arithmetic on the PDP-1O.

The Coordinate Data

    The document for NGP-0 (RFC 292) does not say specifically that the
format of coordinate data is the same whether the command is in absolute
or relative mode. The only thing stated is that they are in two's
complement notation with the leftmost bit being the sign bit.  It is
possible to use two different 2's complement schemes:













Kelley & Meir                                                   [Page 1]


RFC 387      Experience Implementing Net Graphics Protocol   August 1972


           System A                            System B
    (Absolute Coordinates)              (Relative Coordinates)

  -1 -2 -3                 -16         0 -1 -2                 -15
 -2  2  2  ...          ...2         -2  2  2  ...             2
 +--+--+--+--+---------+--+--+       +--+--+--+--+---------+--+--+
 |  |  |  |  |         |  |  |       |  |  |  |  |         |  |  |
 +--+--+--+--+---------+--+--+       +--+--+--+--+---------+--+--+
 ^                                      ^


 .0111 ...............11 = +1/2-e    0.11 ..............11 = 1-e

 .00 .................01 = +e        0.100 .............00 = 1/2

 .00 .................0 = 0          0.00...............01 = e

 .111 ................11 = -e        0.00 ..............00 = 0

 .100 ................   = 1/2       1.11 ..............11 = -e

                                     1.10 ..............00 = -1/2

                                     1.00 ..............01 = -1+e = -(1-e)

                                     1.00 ..............00 = -1


               -16                               -15
 Where:    e = 2                     Where:  e = 2

                          -16                           -15
 Range:    -1/2 to +1/2 - 2          Range:  -1 to +1 - 2

    I submit that one could interpret the requirement for absolute
coordinate data to be in the range -1/2 to +1/2 - e as requiring that
two different number systems should be used.  Thinking along those
lines, System A has the advantage that you never get handed a number out
of range, which saves some checking worries.  It also has one whole bit
more of precision.

    I further submit that having two systems to contend with merely
clouds the issue and requires extra coding.  It makes more sense just to
stick with System B above.  Among the advantages in its use are:

    1.  The single system can handle both absolute and relative
        coordinates.




Kelley & Meir                                                   [Page 2]


RFC 387      Experience Implementing Net Graphics Protocol   August 1972


    2.  If an absolute coordinate exceeds range, simply forcing the sign
        bit on causes a nice wrap-around.

    3.  The representation is the same as the mantissa for floating
        point numbers on most machines.  Notice, however, that mantissas
        of normalized floating point numbers are not in the range for
        absolute coordinates.  The program will have to shift the
        mantissa until exponent is 0.

    It may be that few of us interpreted the NGP document to mean two
number systems were needed.  If that is the case, so much the better.
In any case, until shaken from the position by the overwhelming force of
contrary logic, we will, in all of our implementations, use System B
above for both absolute and relative coordinates.

The TEXTR Command
-----------------

    The last paragraph on page 4 of RFC 292 says, "...a command be
included only if its output is a function solely of the current command
and the "beam position" current at the start of the command.  In other
words, the interpreter for level 0 need have no internal storage for
'modes' or pushdown stacks."

    In the case of the Computek display, most of the NGP commands
correspond to capabilities of the device. The lone exception is the
TEXTR command. There are two ways to know what beam position to return
to after the string is displayed. One way is to read the cursor position
from the display just before doing the string output. This is no good
because it requires reading from the device (which we can't do until
input protocols are implemented). Also, on this device, the cursor
position is accurate only to within 4 scope points.

    The second way to know what beam position to return to is to monitor
all motions of the beam in software. Thus our implementations of NGP-0
to Computek translations will employ a software X register and Y
register. On absolute commands, the registers will be set to the
coordinates for that command.  On relative commands, the coordinate data
will be added to the registers.  At the beginning and end of picture,
these registers will be set to 0.

    The TEXTR command will also cause these software beam registers to
be changed.  That is, the X register will be incremented for each
character of the string to correspond to what is happening in the
display itself.






Kelley & Meir                                                   [Page 3]


RFC 387      Experience Implementing Net Graphics Protocol   August 1972


                                APPENDIX

                     NGP-0 to PDP-10 Floating Point
                     ------------------------------

       The NGP-0 looks at all data numbers (X and Y parameters) as a
fraction number in the following format (16 bits per number).


             +--+--+--+--+--+--+-----------------+--+--+--+--+
             |  |  |  |  |  |  | ...         ... |  |  |  |  |
             +--.--+--+--+--+--+-----------------+--+--+--+--+
Bit position   0  1  2  3 ......                        14 15



with the binary point assumed between bits 0 and 1.  Bit 0 is the sign
bit and all negative numbers are represented as their two's complement.
The PDP-10 machine code representation of fractions in floating point
(mantissa part) is very similar to the above (with one exception--the
number -1), so the transformation could be obtained simply by two
operations, move and substitute.


                         Data (X,Y) Conversion
                         ---------------------

   NGP (extreme points)                    Floating Point (PDP-10)

        (16 bits)                                 (36 bits)
                                           exp   mantissa

1/2   0.1000 . . . . . .0              0 10000000  10 . . . . . .0

-1/2  1.1000 . . . . . .0              1 01111111  10 . . . . . .0

-1    1.00   . . . . . .0              1 01111101  10 . . . . . .0
                                                        Special case

1-e   0.11   . . . . . .1              0 10000000  1111 . . . . .1











Kelley & Meir                                                   [Page 4]


RFC 387      Experience Implementing Net Graphics Protocol   August 1972


    Translation from NGP into floating point for PDP-1O:

    1.  Move sign bit (leftmost one) to sign bit.

    2.  Move fraction part (15 bits) to mantissa part (left justified;
        fill with zero's to right).

    3.  Fill in exponent part (8 bits) according to:

        a.  If positive number      exp = 10000000 = (80) hex

        b.  If negative number      exp = 01111111 = (7F) hex

        c.  Exception _in_only_ one number

            -1 in NGP (negative sign and fraction all zero's)

            (1)  mantissa becomes same as -1/2

            (2)  exponent becomes the one's complement of (82) hex
                 = (7D) hex

    The methods of conversion will remain the same regardless of the
    number of bits (up to 24) that are used for the NGP fraction.



         [ This RFC was put into machine readable form for entry ]
         [ into the online RFC archives by Alex McKenzie with    ]
         [ support from GTE, formerly BBN Corp.             9/99 ]





















Kelley & Meir                                                   [Page 5]