Home   A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z  

GRAPHICS PROTOCOL :: RFC0493








Network Working Group                                        J. Michener
Request for Comments: 493                                            MAC
NIC: 15358                                                     I. Cotton
References: 282, 258                                               MITRE
Obsoletes: 292                                                 K. Kelley
                                                              U. of Ill.
                                                               D. Liddle
                                                              Ownes Ill.
                                                                E. Meyer
                                                                     MAC


                           GRAPHICS PROTOCOL

Introduction

   This document reflects opinions expressed and decisions reached at
   the second meeting of the Network Graphics Group, held at the
   Stanford Artificial Intelligence Laboratory in late November 1971.
   It describes part of a proposed Network Standard Graphics Protocol
   for transmitting graphics data within the ARPA network.  The
   particular aspects of the protocol covered in this document relate to
   the form and content of graphics information sent from a source of
   graphical information (an application program, say, in the "Serving
   Host") to a display package for output to a graphics console (at the
   "Using Host").  This will take the form of a sequence of 8-bit bytes,
   and will be called the graphics output byte stream.

   This document is intended to serve as a basis for discussion and for
   experimentation over the network.  This document does not include
   form or content of graphics input (data sent from the Using Host to
   the Serving Host) nor does it cover how the connection is established
   between the hosts.  A proposal for the former will be generated
   eventually by this committee; the latter is the job of the Connection
   Committee (of the Network Graphics Group).

   This RFC describes the commands which are available in the protocol
   in terms of the effect they would have at the receiving (Using Host)
   end.  Clearly, some subroutine package is desirable at the Serving
   Host for use by applications in transmitting graphics data, but on
   this topic this RFC does not intend to comment.

   It may be observed by the reader that no facility is specified in
   this protocol allowing the Using Host to report logical errors in the
   graphics output byte stream to the Serving Host.  Such a facility
   would have to be integrated with the graphics input byte stream,
   since it involves most of the problems related to synchrony of
   independent hosts.



Michener, et. al.                                               [Page 1]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


Background

   The reader should probably peruse RFC 282: "Graphics Meeting Report"
   by Mike Padlipsky to obtain some of the framework surrounding this
   discussion of network graphics.  Also it might be valuable to make
   note of the model described in RFC 285: "Network Graphics" by Donald
   Huff.

Levels and Ground Rules Pertaining Thereto

   Functions within the graphics protocol will be classified into a
   number of levels depending partly on how difficult it is to implement
   those functions.  It is intended that any host which claims to
   implement the functions of level N must implement all lower levels as
   well.  Thus, it is envisioned that sites will implement levels
   inclemently.  Implementations will be improved as a continuing
   process to include more and more functions, and it is intended that
   each implementation will be able to identify its own level to a
   graphics protocol at a remote site which is requesting a graphics
   interchange.  A side result is that each site will be able to
   determine its own priorities in committing programmers to the
   graphics protocol as opposed to other efforts.

   It is also our intention that implementation of level N will require
   no knowledge of level N+1.  Thus a site can implement a level in the
   (reasonably) firm knowledge that no changes at higher levels will
   alter the level implemented.  At some time it may be decided by the
   Network Graphics Group to redefine a level which has previously been
   firmed up.  It is not our intention that this shall happen but one
   must recognize that the proposed Graphics Protocol is experimental
   and may have to be changed.

   One further ground rule: a stream of commands and data which is valid
   at a given level, K, shall produce "identical" results on any
   interpreter of level K or higher.  By this we mean that as long as
   the commands and data take advantage only of strictly defined
   operations, similar pictures should result.  Aspects of the protocol
   which are not strictly defined (at this time) include character size,
   character position relative to the beam, how control characters in
   text output affect the terminal and what happens when the beam is
   moved or a line drawn outside of the logical screen boundary.  This
   rule forces upwards compatibility, so that an application written
   using features of a low numbered level will still work at sites which
   have moved on to implement higher levels.  Additionally, any aspects







Michener, et. al.                                               [Page 2]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   of this protocol which are explicitly "left unspecified" in the
   detailed operations descriptions below shall be explicitly specified
   in any public description of an actual implementation.

   We now describe the framework which will be common to all levels.

Basic Data Forms

   Information in the Network Standard Graphics Protocol will be
   expressed as a sequence of 8-bit bytes.  A command will consist of a
   command byte followed by zero or more arguments.  The same command
   byte will always take the same number of arguments in the same form.
   The length of each argument may be fixed or variable depending on the
   argument.

   A simple type of argument is a "value", which is a 8-bit integer.
   Another type of argument is a "string" which is a count followed by
   (count) number of 8-bit bytes.  If the count is between 0 and 127, it
   is sent in a single byte.  If the count is between 128 and 2**15-1
   (**means exponentiation), it is sent in two bytes with the high order
   bit of the first byte set to one.  The first byte contains the seven
   high order bits of the number and the second byte contains the eight
   low order bits.  A string is the only type of argument of a command
   which can vary in length.  For example, whenever a command has
   optional arguments, they will be represented inside of a string.

   Coordinate data engendered considerable discussion at the second
   Network Graphics Group meeting.  It was decided that a two-
   dimensional Logical Coordinate System was required, and each
   interpreter for the graphic command byte stream would be responsible
   for mapping this coordinate system to physical device coordinates.
   It was decided that data in the logical coordinate system would be in
   twos-complement notation, that it would be fractional, that each edge
   of the screen would have unit length, and that the origin would
   correspond to the center of the screen on the output device.  The
   vertical (horizontal) edges of the screen of the output device
   correspond to the lines X (Y) = -1/2 or X=+1/2-e where e is a small
   positive number determined by the precision of the fractional data.
   Particularly the points (-1/2, -1/2) (-1/2, 1/2-e), (1/2-e, -1/2) and
   (1/2-e, 1/2-e) shall be visible points at the corners of the logical
   screen. (In the case of a non-square display surface, the implementer
   may take his own decision.  Thus we shall say that the Logical
   Coordinate System contains points whose coordinates range from -1/2
   to a little less than +1/2.







Michener, et. al.                                               [Page 3]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   Commands which take coordinate data will be available in various
   modes.  In absolute mode, a position is specified by giving its
   coordinates in the Logical Coordinate System.  In relative mode, the
   difference between the coordinates of the position and the
   coordinates of the current position must be specified.  Thus a
   coordinate datum which is an argument for an absolute mode operation
   should be in the range -1/2 to +1/2-e, while one for a relative mode
   operation should be in the range -1+e to +1-e.

   Interest was expressed at the second Graphics Group Meeting in
   eventually allowing a very large coordinate space (many bits of
   precision in each fractional coordinate).  This is to be done by
   permitting the length, in 8-bit bytes, of each coordinate datum to be
   set (as a mode).  It was decided at the meeting that two bytes per
   coordinate would suffice for now.  Thus "e" in the above discussion
   is 2**(-15) (one in the least significant bit of a 15-bit plus sign
   fractional coordinate).

   Text data will be transmitted as an argument of various commands for
   display on the output device.  Network ASCII will be used to
   represent characters.  At the lowest-levels of the protocol only one
   character size will be available -- whatever is "normal" on the
   display device.  If the device has no "normal" size, 72 characters
   per line would be desirable.  At higher levels the size of each
   individual character can be specified.

   Also, at the lowest levels, control characters will be passed along
   to the device for it to do the best it can.  However, the consensus
   of the graphics meeting was that at some reasonably low (but non-
   zero) level, carriage return, line feed, and backspace should be
   interpreted to do the right thing.

Picture Subroutines and Related Topics

   At the second Network Graphics Group meeting, it was decided that two
   sorts of picture subroutines were desirable, the primary distinction
   between them being relative difficulty of implementation.  At the
   meeting, the simpler variety was called a subpicture, and the more
   complex was called a subroutine.  This author believes that these
   terms do not embody enough semantics to facilitate keeping the two
   straight and so proposes to standardize on "simple subroutine" and
   "full subpicture" instead.

   The only parameter which can be passed to a simple subpicture is the
   "current beam position".  In other words, if such a subpicture is
   called more than once in a picture, the only difference in appearance





Michener, et. al.                                               [Page 4]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   between the various calls is a translation due to the beam position
   at the time of the call.  Full subpictures, on the other hand, take
   parameters which can cause scaling, rotation, reflection, or anything
   else we come up with.

   It is planned that a subpicture definition need be transmitted only
   once (per network connection) and would not be deleted by a "new
   picture" operation.  Thus a changing picture could be subdivided into
   several parts on a basis of static versus changing information; only
   definitions of parts which change need be transmitted to redraw the
   picture.

   Traditionally, picture subroutines which depend only on the initial
   beam position have been restricted to relative data mode drawing
   operations.  In view of the fact that subpictures will probably be
   used to save static picture information, it is desirable to allow
   absolute data mode operations in simple subpictures.

   The next question naturally arises -- what does absolute data mean in
   a full subpicture which takes both position and scale parameters? Is
   absolute data really absolute in this case? This author believes that
   the answer is as follows: the full subpicture is really a picture in
   its own right, so it has its own logical coordinate system, and its
   absolute data is really within this coordinate system.  Thus
   "shifting and scaling" a full subpicture really means "scale the
   subpicture in its own coordinate system and shift the result as a
   whole".

   In summary, then, a major difference between simple and full
   subpictures is that a full subpicture has its own logical coordinate
   system and a simple subpicture uses the logical coordinate system of
   whoever calls it.  This distinction is the reason why full
   subpictures are harder to implement than simple subpictures.

   Another point discussed at the meeting was a special data mode
   whereby a subpicture can display data at absolute positions on the
   screen, i.e., absolutely in the main (picture) program.  To achieve
   this, the meeting proposed special data modes for the three
   operations: move beam invisibly, draw line, and display dot.  The
   intent of these data modes was to bypass all rotation, scaling, and
   clipping functions associated with the current level of subpicture
   nesting until this mode was cleared in a certain way.  This same
   effect can be achieved more directly and implemented more efficiently
   by two commands: one to save and one to re-establish the logical
   coordinate system for the current subpicture. (Additionally, of
   course, the "save" operation would establish the initial, highest
   level, logical coordinate system.)




Michener, et. al.                                               [Page 5]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


Simple Subpicture Calls

   Besides the  of the subpicture to be called, a simple
   subpicture call may specify two optional parameters; the first is an
    which is the "name" (in a sense described below) of this
   particular subpicture call and the second is an absolute position on
   the calling page to be invisibly moved to, prior to calling the
   subpicture.  When (eventually) the viewer is allowed to interact by
   "picking" information displayed before him, if the information is
   part of a subpicture, then the "name" of the subpicture call will be
   part of the "graphic input" reported to the serving host.  If the
   information picked by the viewer is within several levels of
   subpicture calls, the names of each of the calls will be reported in
   a manner which indicates their nesting. (Note that just the name of
   the subpicture by itself is not sufficient, since one subpicture may
   be displayed in several positions and the application may wish to
   distinguish between individual calls.) If the identifier is not
   specified it defaults to the null string.  If the position (for the
   invisible move) is not specified, the current beam position is used.

   Which of these two parameters are present is encoded by two bits in a
   code byte which precedes the parameters.  If both parameters are
   present then they are always in the same order; this order and the
   bits of the code byte assigned to the two parameters are specified in
   the detailed description of the Simple Instance command (and in the
   BNF in Appendix 1).  Preceding even the code byte, and immediately
   following the name of the subpicture which is being called upon, is a
   count of the data in the remainder of the instance command.  Thus is
   included so that it is not necessary to decode the code byte to
   determine the total length of any one Simple Instance operation.

Windowing: Clipping, Blanking, or (?)

   While on the subject of coordinate systems and subpictures, it might
   be good to touch on the topic of: who (which end of the connection)
   is responsible for doing what, when a picture is potentially going to
   be displayed beyond the edge of the virtual screen? It was the
   consensus at the graphics meeting that the interpreter of the
   graphics protocol (i.e., the using end) would not be held responsible
   for doing anything reasonable in case a picture displays information
   beyond the edge of the screen (e.g., by relative moves and draws).










Michener, et. al.                                               [Page 6]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   The interpreter must react properly to the next absolute data in the
   proper range, however.  Various solutions to this situation in
   existing graphics systems include:

      clipping a line to display as much as is proper,

      blanking the whole of a line if any part is invisible, or

      discarding high order bits of the current position register, so
      that no invisible positions can be represented ("wraparound").

   In addition to problems of the edge effects at the highest level,
   problems arise with respect to (full) subpictures.  It is nice to be
   able to select a rectangular portion of a subpicture to be displayed
   as part of a subpicture call. (See: Newman, Display procedures,
   Communications of the ACM, Volume 14, Number 10, October 1971,
   pp651-660).  In accordance with the consensus of the meeting, which
   was to make this capability optional, this author merely hopes to
   include in the protocol a method of encoding this information since
   his site a) can handle some such windowing, and b) hopes to provide a
   service facility to perform this function.

   Appendix 2 describes how to concatenate several levels of portions
   into a single rectangular test, as long as no rotations are involved.
   It also outlines the problems related to rotations and portioning.

Full Subpicture Calls

   We are now in position to consider what may be specified as part of a
   full subpicture call, in addition to the name of the subpicture being
   called, which is, of course, required.  The data described below will
   all be optional: a single code byte will precede all these data; the
   presence or absence of one of the parameters will be indicated by a
   bit in the code byte being one or zero.  The parameters will always
   appear in the same order, if they are present.  This order is given
   below in the detailed description of the Full Instance command (and
   in the BNF in Appendix 1).  Additionally, preceding even the code
   byte, will be a  of the following bytes, including the code
   byte to determine the total length of any particular Full Instance
   operation.

   One parameter is an  which can be used to distinguish
   this particular call to this subpicture from all other calls to the
   subpicture.  This parameter was already described under Simple
   Subpicture Calls.






Michener, et. al.                                               [Page 7]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   On parameter which may be specified is a translation: this will be
   specified by giving the absolute coordinates of the center (on the
   calling page) of the image of the subpicture; this will default to
   the beam position current at the time of the call.

   A rotation may be specified by giving a 16-bit fraction in the range
   0 to .1111111111111111 (binary) inclusive; this fraction will
   represent what part of a full circle (2pi) the rotation is.  The
   default value of angle of rotation will be zero.

   (Actually, the rotation representation scheme works identically if
   one thinks of it as a two's complement fraction from -1/2 to just
   less than +1/2.  That is, the same bit configurations encode the same
   rotation, due to the periodic nature of sine and cosine.  For
   example, binary zero always represents 0 pi 010000...0 denotes pi/2
   in both schemes; 100...00 denotes 1/2 in one scheme and -1/2 in the
   other, which correspond to rotations of +pi and -pi respectively,
   i.e. identical rotations.)

   Also specifiable as apart of a full subpicture call is a rectangular
   portion of the called picture to be imaged on the calling picture
   (see previous section for a discussion of clipping).  This rectangle
   is specified by its center and one half its total size in x and y.
   That is, the rectangle will consist of all points whose x coordinate
   differs from that of the center by no more than the specified x-size
   and whose y coordinate satisfies a similar condition.  The default
   for these values will place the center at the origin and give both
   the x half width and the y half width the value of +1/2.  Thus the
   default includes the whole of the logical coordinate system of the
   called page (and also some points one of whose coordinates are +1/2,
   which, strictly speaking, lie "outside" of the coordinate system; how
   this inconsistency is resolved is left unspecified).

   Finally, one must specify the scaling to be applied in determining
   the image; this can be done in many ways.  One way is to specify a
   uniform magnification to be applied to the subpicture.  So that
   magnifications in a wide range can be achieved, it is the author's
   opinion that some form of scientific notation (i.e., floating point)
   will have to be employed.  If there is already a network standard
   floating point notation (which I am not aware of) it should be
   employed.  Failing that, it is suggested that this notation consist
   of an 8-bit (two's complement) exponent followed by a 16-bit (two's
   complement) fractional part.

   Another form of scaling is to specify separate magnifications in x
   and in y, to be applied to the subpicture before any rotation is
   performed.  Yet a third way is to specify a rectangular area in the
   calling picture's coordinate system to be filled with the image of



Michener, et. al.                                               [Page 8]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   the subpicture.  Since the center of the image is already specified
   (by the translation), this image information consists only of half-
   edge size data.  If none of the three methods of scaling are chosen
   (and an affine transformation (see below) is not given explicitly),
   then a uniform magnification of unity (i.e., no scaling) is used.
   Note that the three forms of scaling tend to contradict each other
   and only one of them should be used in any one call.  What happens if
   self-contradictory information is given in these fields is left
   unspecified.

   Appendix 2 presents the mathematics involved in transforming the
   subpicture's coordinate system into the calling picture's coordinate
   system.  It is shown there that all the individual operations
   (scaling, rotating, and translating) can be represented as a single
   affine transformation (which consists of 6 values).  It might be nice
   to permit the serving program to specify this transformation
   directly.  Accordingly, one possible parameter of a full subpicture
   call will consist of six floating point numbers (of the form
   described under magnification, above) to be interpreted as an affine
   transformation.  Indeed, if the affine transformation has the
   following form:

   /_ |x  |y_/ = /_ x y_/ * / L11 L12  / + /_ T1 T2_/
                           /_ L21 L22 _/

   then the values shall (arbitrarily) be sent in the following
   (columnar) order: L11, L21, L12, L22, T1, T2.  This affine
   transformation should be invertible that is, L11*L22 - L21*L12 should
   not be zero.

Viewporting

   Another topic discussed at the meeting, and referred to the protocol
   committee for decision, was the capability of placing the "top level"
   picture in some rectangle of the virtual screen.  The default
   rectangle might be the full screen.  Alternatively it might be left
   up to the viewer to specify the default (via) interaction with the
   graphics system at the Using Host).  In general, viewporting allows
   more than one "top level" picture to be viewed at once.  The desire
   to view several different pictures on the same screen arises in cases
   where multiple users are working together and in cases where one user
   is interacting with a group of applications (in separate serving
   hosts).  This author maintains that the coordinate transformations
   required by this feature are simpler than that of "full subpictures"
   since no rotations are involved, and would be part of the same
   mechanism in its implementation.  In particular, merely another
   affine transformation (see Appendix 2) would be added to the levels
   caused by full subpicture calls.  All that is required is keeping



Michener, et. al.                                               [Page 9]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   track of viewport identifiers and the associated rectangles.  Since
   little extra work is involved, it is proposed that this feature be
   included at some high level of the protocol.

Command Codes

   Each command in the graphics protocol will be assigned a non-negative
   value which will represent this command in the byte stream.  The
   algorithm whereby values and commands are associated is, it turns
   out, a very touchy subject.  There are five or ten different criteria
   for a "best" algorithm, each criterion different in emphasis.  This
   Gordian knot will be cut, in this proposal, by ordering the commands
   approximately according to level, and then just numbering them.  In
   addition, if several closely related commands occur at the same
   level, some attempt will be made to encode variations of meanings in
   terms of bit configurations.  Even if some later consideration causes
   a change in ordering to be proposed, it is this committee's feeling
   that the numbering should not be altered.  However, until this matter
   is firmly settled, it is strongly advised that any implementation
   take into account the possibility of reassignment of command codes.

Particular Proposal for Level 0 Protocol

   It is proposed that level 0 be kept very simple.  This is so that
   implementation can be quickly accomplished and experimentation with
   the protocol begun.  Another reason is that the least powerful host
   and even programmable terminals should be able to implement it.  In
   accordance with this, the "rule" was made that 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.  With this restriction it is hoped that a
   very simple implementation will be possible for level 0.  In
   particular, perhaps one could eventually build a hardware translator
   from level 0 code to one's own particular terminal's code.

   Note that in the opcode assignment for level 0, bits 4, 2, and 1 have
   special meaning for the move, line, and dot commands.  In particular,
   the 1 bit encodes absolute versus relative data mode, the 4 bit
   encodes whether any visible output occurs, and the 2 bit determines
   whether the visible output is a line or a dot.

Level 0: Command Summary

   The following is a list of commands (and their syntax) in level zero.
   Detailed descriptions of these commands follow in the next section.
   Commands dealing with protocol may be added by the Connection
   Committee. (They currently request opcodes in the range 128 to 255.)



Michener, et. al.                                              [Page 10]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   (As described in Basic Data Forms, above, , ,  and  are two-byte coordinate values,
    is a count followed by  many bytes and  is an
   eight bit number.)

Decimal  Octal   Binary    Format
0        0       00000000  Null
1        1       00000001  Erase screen and reset beam
2        2       00000010  Move Absolute  
3        3       00000011  Move Relative  
4        4       00000100  Draw Absolute  
5        5       00000101  Draw Relative  
6        6       00000110  Dot Absolute  
7        7       00000111  Dot relative  
8        10      00001000  Text 
9        11      00001001  TextR 
10       12      00001010  End of Picture
11       13      00001011  Escape  


Level 0: Command Descriptions

0       Null Statement ("NULL").
This statement has no arguments--and no effect, either.

1       Erase screen and reset beam to origin ("ERASE").
This command indicates that a new picture is about to be drawn.  It
should always be (eventually) paired with a following End of Picture
command.

2       Move beam invisibly to absolute position
("MOVEA")  .
Nothing is drawn; the beam is positioned to the specified absolute x,y
position.

3       Move beam invisibly by relative amount
("MOVER")  .
Nothing is drawn; the beam is shifted by the specified amount in x and
y.

4       Draw line to absolute position
("DRAWA")  .
A line is drawn from the current beam position to the specified absolute
x,y position.







Michener, et. al.                                              [Page 11]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


5       Draw line to relative position
("DRAWR")  .
A line is drawn from the current beam position to the position delta x
and delta y away.

6       Display a Dot at absolute position
("DOTA")  .
The beam is moved invisibly to absolute position x,y and a dot is
displayed there.

7       Display a Dot at relative position
("DOTR")  .
The beam is moved invisibly by the specified amount in x and y and a dot
is displayed there.

8       Display text ("TEXT") .
At the current beam position, display some characters at the normal size
for the device being operated.  consists of a  followed
by count many characters.  If there is no "normal size", choose the size
so that seventy-two characters are displayed per line. The characters in
the string are coded in network ASCII all codes between 0 and 127
(decimal) inclusive are permitted. (At level zero, what happens to
control characters is left unspecified.) Where the beam is, following
execution of this command, is left unspecified, except that another
Display Text command immediately following will append its text to the
previous string. (The use of the TEXT command is discouraged; use TextR
instead.) The position of the first character relative to the initial
beam position is left unspecified.

9       Display text and restore beam ("TEXTR") .
At the current beam position, display a string of characters at the
normal size for the device being operated; then reposition the beam to
where it was before the command.  consists of a  followed
by count many characters. If there is no "normal size", choose the size
so that seventy-two characters are displayed per line. The characters in
the string are coded in network ASCII; all codes between 0 and 127
(decimal) inclusive are permitted. (At level zero, what happens to
control characters is left unspecified.) The position of the first
character relative to the initial beam position is left unspecified.

10      End of Picture ("ENDPIC").
This command denotes the end of a new picture. It must be paired with a
preceding ERASE command.

11      Escape to device specifics ("ESCDEV")  .
If "value" is the code assigned (by the Protocol Committee) to the
device being operated, then transmit the eight-bit bytes in 
(which starts with a  indicating the number of bytes) to the



Michener, et. al.                                              [Page 12]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


device without examining them. Otherwise ignore this command. If the
device does not accept 8-bit information, reformat the data in some
device specific way; an example would be throwing away the high order
bit for a seven bit device, or gathering 5 8-bit bytes into one 36-bit
word, again discarding the high order bits, perhaps. The action of the
bytes in the string should leave alone (or at least restore) any
hardware beam position registers in the device which the interpreter
might conceivably depend on.

This command really should not be used it was included at level 0 so
that specific applications can do mode setting and other device specific
manipulations. For example, ARDS terminals may optionally have several
independently addressable output scopes. The selection mechanism changes
state only when a particular sequence of ASCII characters reaches the
terminal. Thus ESCDEV would be used to select which scope(s) is/are to
be affected by following commands. (The current state is invisible to
the graphics package at the Using Host.)

Further, suppose that another make of terminal has a similar option,
which responds to a different code sequence. This possibility is the
motivation for conditionally ignoring the ESCDEV command based on the
"" specified. Given that a particular application will only be
used to output to either an ARDS or this second make (with the multiple
scope option), then the application could always send two ESCDEV
commands, one applicable only to ARDS terminals, and the other
applicable only to the second make.

LEVEL 1

   *Set Line mode ("LINMOD") .
   This command sets the current line mode possible modes and the
    which sets each are: solid (0), dashed (1), dotted (2), and
   others (3 or >). At the beginning of a new picture (i.e., after an
   Erase and Reset command), line mode is solid. If a site does not have
   a certain mode readily available, it may a) simulate it in software,
   b) substitute another in its place (dashed for dotted, or vice versa)
   c) ignore it entirely. What is provided should be clearly indicated
   in any public document. It is strongly recommend that at least solid
   and one other mode be provided.

   *Set intensity ("SETINT") .
   This command sets the intensity of lines, dots and characters
   displayed following the command. If  is 128 decimal, normal
   intensity should be set. If  is 255 decimal, brightest should
   be selected, and if it is 0, then the beam should be blanked.
   Intermediate values should be mapped appropriately as the implementer





Michener, et. al.                                              [Page 13]

RFC 493                    GRAPHICS PROTOCOL               26 April 1973


   sees fit. For instance, if brightest is the same as normal, all
   values from 128 through 255 should be mapped to normal. Information
   displayed between the start of a new picture (the ERASE command) and
   the first SETINT command appears at normal intensity.

   *Text out ("TEXTO") .
   Starting from the current beam position, this command displays the
    (of network ASCII characters) formatted as if it were typed
   material (at the current intensity).  consists of a 
   followed by count many characters. That is, text extending past the
   right margin will be broken and repositioned at the left margin on
   the next line down. Of the control characters, only carriage return,
   line feed, and backspace are required to be interpreted properly.

   *Subpicture header ("SUBHED")   
. This command begins the definition of a subpicture named "". This definition is terminated by a matching SUBEND command. The definition will be remembered until a new one is specified or until the graphics network connection is broken. Note that is a consisting solely of capital letters and numbers. Subpicture definitions may be nested this will be equivalent to transmitting the two definitions separately. In other words, all subpicture names are globals and are "known" to all other subpictures. If a subpicture definition has not been received prior to its use in a picture, the empty subpicture should be displayed in its place until a definition is received. A subpicture definition need not be transmitted as part of a picture (i.e., within an ERASE and END command pair). Indeed, all subpicture definitions might precede the main picture. Currently, the will always be 1, indicating only one byte of
follows, but at higher levels of the protocol room for expansion may be required. In the
, the 80 hex bit will be set if this subpicture can be a simple subpicture, and the 40 hex bit will be set if the subpicture can be a full subpicture. (It is possible that one subpicture can be both.) Other information that may eventually be present in
include whether the current value of a certain mode or parameter should be saved on entry to, and restored on exit from, this subroutine whenever it is called. These modes and parameters include: line mode, intensity, character size, and data length. Michener, et. al. [Page 14] RFC 493 GRAPHICS PROTOCOL 26 April 1973 *Subpicture end ("SUBEND"). This command ends the definition of a subpicture. Each SUBEND must match a preceding SUBHED command. *Simple instance ("INSTS") This command indicates that the subpicture is to be called (instanced). At this level, level 1, no subpicture may call another; if one does, what happens is left unspecified. Also, this must be a call to a simple subpicture. Thus the 80 hex bit of the single byte of
must have been set in the SUBHED command which started the definition of . If the subpicture has never been defined, the empty subpicture should be displayed in its place. The begins with a count of the amount of information which follows. This count may be zero. If non-zero, the next byte is a code byte to be interpreted to see what further information follows. If the 80-hex bit is set, next in the byte stream is an (called "AS information"). This is the name of this particular instance of the subpicture as described under Simple Subpicture Calls. If the 40-hex bit is set, then next in the byte stream (following the AS information, if present) is an x,y position (in the calling picture's coordinate scheme) at which the subpicture will be centered. (This is called AT information.) If AT information is not specified, the current beam position is used as a default. If AS information is not specified, it defaults to the containing zero characters. If neither the 40 hex nor the 80 hex bits are set, then neither the AT information not the AS information is present, and the code byte should be zero. (Also, the length count had better be 1.) Changes to levels 0 commands for level 1. TEXT and TEXTR -- Carriage return, line feed and backspace characters should definitely be interpreted whenever they appear in . The results of other control characters remain unspecified. The intensity of the characters shall be affected by the SETINT command. ERASE -- Normal intensity and solid line mode must be established at the start of a new picture. DRAWA and DRAWR -- Line mode and intensity shall be affected by the LINMOD and SETINT commands. DOTA and DOTR -- Intensity shall be affected by the SETINT command. Michener, et. al. [Page 15] RFC 493 GRAPHICS PROTOCOL 26 April 1973 LEVEL 2 *Mark ("MARK"). This command causes the current x,y beam position to be saved on a pushdown stack. This pushdown stack must be separate from the subpicture call pushdown stack. *Move to mark and pop ("MOVEMK"). This command sets the current beam position equal to the x,y position at the top of the "mark" pushdown stack. If the stack is empty, the origin is used, instead. Then the stack is popped up (unless it is empty). *Draw to mark and pop ("DRAWMK"). If the "mark" pushdown stack is not empty, this command draws a line (of the current line mode and intensity) from the current beam position to the x,y position at the top of the "mark" pushdown stack, and sets the beam position to that value. Then the stack is popped. If the stack is empty, the line is drawn to the origin and the beam position is set there also. Changes to level 0 and 1 for level 2. INTS -- arbitrary levels of simple subpictures must be supported. (Note that recursive use of subpictures is not allowed: once recursion starts, it can never be stopped.) The pushdown stack for subpicture calls must be kept separate from the "mark" pushdown stack. Level 3 (Perhaps all rotational transformations should be put at a higher level, for instance higher than viewport operations.) *Full Instance ("INSTF") This command indicates that the subpicture is to be called (instanced) in a "full" manner as described in an explanatory section. For one thing, this means that the 40 hex bit of the single byte of
must have been set in the SUBHED command which started the definition of . If has never been defined, the empty subpicture (i.e., nothing) should be displayed in its place. The is similar to the described under the INSTS command, but the former contains more information. Below is a list of the information which can be specified, and the bit assigned to the presence/absence of each piece of information. The pieces of information which are present always Michener, et. al. [Page 16] RFC 493 GRAPHICS PROTOCOL 26 April 1973 appear in the byte stream in the order they are described in this list. (All pieces of information are described more fully in Full Subpicture Calls, except for the "AS information" which is described in Simple Subpicture Calls.) Bit (hex) Information 80 As information --"name" of this particular instance. Consists of an . 40 Translation information -- Center of the subpicture's image on the calling page. Consists of an and a . 20 Rotation -- Fractional part of 2pi to rotate the image counterclockwise. Consists of a 16-bit unsigned fraction. 10 Portion Information -- Rectangular part of subpicture which is to be displayed. Consists of , , , and . 8 Uniform Magnification -- Amount to scale the whole subpicture. Consists of a floating point number (which should not be zero). 4 Separate x and y magnification -- Separate scales for the x and y axes of the subpicture. Consists of two floating point numbers (neither of which should be zero). 2 Image Size -- How large a rectangle on the calling page is the image to occupy. Consists of an and a (neither of which should be zero). 1 Affine transformation -- The map from the called to the calling coordinates system. Consists of six floating point numbers. Notes: 1) At most one of the three bits: 8, 4, and 2, should be set. 2) If the 1 bit is set, bits 2, 4, 8, 20, and 40, should not be set. 3) If additional optional parameters are ever added to the full subpicture call, another code byte could follow all the above information. In that case, the part of the would include this second code byte and any additional bytes of information. Michener, et. al. [Page 17] RFC 493 GRAPHICS PROTOCOL 26 April 1973 *Escape to top level coordinate system ("ESCTOP"). Until a RESLEV command is (subsequently) executed, all display commands (moves, draws, dots, and texts) shall operate as if they were issued by the top level (main) picture instead of the subpicture containing them. That is, they shall be mapped to the screen according to the map for the highest level. Subpicture calls themselves, which are made while an ESCTOP command is in effect, are not affected by the command. That is, transformations are calculated as if the command were not in effect. The calculated transformations are ignored, however, and information displayed by the subpicture still appears to be at the top level, until a RESLEV command nullifies the ESCTOP mode. Thus a subpicture call executed while an ESCTOP command is in effect, acts as if a RESLEV were executed immediately before the call, and an ESCTOP command were executed as the first command of the subpicture. Similar considerations hold for returning from subpictures. *Resume current level coordinate system ("RESLEV"). This command restores the logical coordinate system corresponding to the subpicture currently executing, in case that coordinate system was disabled by an ESCTOP command. (See ESCTOP.) Changes to levels 0, 1, and 2 for level 3. MARK -- the saved beam position shall be in terms of the logical coordinate system, not the physical coordinate system. TEXTR, TEXT, TEXTO -- Since a full subpicture is supposed to be transformed as a whole, as if it were a picture in its own right, it appears to this author that, in particular, all beam movements related to characters should be affected. This includes character size, tab, carriage return and line feed. In particular, carriage return should set the beam to the left margin--that is, to the left edge of the logical coordinate system of the called subpicture. All these changes may be very hard to accomplish, and what should be done will be left unspecified at this time, with comment from readers particularly invited. Level 4 (Perhaps viewpoint operations can be included in level 3.) *Declare Viewport ("SETVW") Set the viewport identified by to represent the indicated area of the logical screen. The x and y data are not physical screen coordinates, since that would involve device Michener, et. al. [Page 18] RFC 493 GRAPHICS PROTOCOL 26 April 1973 dependencies. This command completely supersedes any previous declaration of the same viewport. If information is already displayed within the viewport specified, this command causes the displayed information to be relocated on the screen to its new position. If the area specified exceeds the limits of the graphics standard display screen, what happens is left unspecified. Viewports need not be disjoint; in other words, two viewports can present display information at the same point on the screen. If or are negative, the viewport named should be deleted. All information displayed by it shall no longer appear. Because it affects the top level picture, this author feels that this command should not occur as part of a picture or in a subpicture declaration. *Add subpicture to viewport ("ADDSVW") The subpicture named is displayed within the viewport specified, if it is not already displayed there. (If it is, nothing is done.) The subpicture must be capable of being called via a full subpicture call. If the viewport has never been declared via a SETVW command what happens is left unspecified. (Three possibilities are: nothing is displayed; the viewport defaults to the whole logical screen; the human viewer is permitted by the Using Host to specify the viewport.) If the viewport is subsequently declared, the subpicture shall be displayed in it. If the subpicture has never be declared, nothing is displayed for it; when and if it is subsequently declared, the new definition is displayed in the viewport. More than one subpicture may be displayed in a single viewport at once. Because it affects the top level picture, this author feels that this command should not occur as part of a picture or in a subpicture declaration. *Clear viewport ("CLVW") All subpictures which have been added with the ADDSVW command to the viewport specified in this command are removed from it. Thus the specified viewport contributes nothing to what the human viewer sees. (After a CLVW, the area of the viewport may not be blank due to other, non-cleared viewports which overlap it.) Because it affects the top level picture, this author feels that this command should not occur as part of a picture or in a subpicture declaration. Changes to levels 0, 1, 2, and 3 for level 4. Michener, et. al. [Page 19] RFC 493 GRAPHICS PROTOCOL 26 April 1973 ERASE -- All viewports are cleared (as in the CLVW command) but their declarations are remembered. ENDPIC -- This command partially loses its purpose: it no longer serves to mark the end of all picture information to be presented to the user, since viewport operations may follow which amend or alter the picture. This function is partially taken over by the DELAY and NODELAY commands described below. Level ? *Set Character Size ("SETCHS") . Until further notice, characters shall be displayed so that each occupies approximately and in the appropriate coordinate direction in the current logical coordinate system. Inter-character and inter-line spacing could be certain percentages (any ideas?) more than and , or they could be specified separately. In any case, only a "best effort" would be expected at a site. Character size is always set to normal (as defined by level 0 character size being normal) by the ERASE command. and should be positive, except that if is equal to zero, then being negative, zero, or positive, correspond to a character size which is "smaller than normal", "normal", or "larger than normal". How much smaller or larger than normal is left up to the site. Changes to levels 0 and 1 for level ?. TEXTR, TEXT, and TEXTO -- Characters are to be displayed according to the current character size. ERASE -- Must establish normal character size, normal being that for level 0. Level ?' *Set Data Length ("SETDLN") . Until this mode is explicitly changed with another SETDLN, various data will consist of number of bytes. may be 1, 2, 3, or 4. Affected are the following syntactic types (refer to Appendix 1): , , , , , , , and the fractional part of a floating point number. When a network connection is initially established, the data length is two. Michener, et. al. [Page 20] RFC 493 GRAPHICS PROTOCOL 26 April 1973 Level ?'' (These commands should probably be at the same level as viewport operations, if not earlier.) *Extensive Changes Follow ("DELAY"). This optional command is designed to eliminate futile effort on the part of the Using Host programs. At some hosts and/or with some output devices (particularly storage tubes) a non-negligible amount of time may be required to present an image to the human viewer. If extensive changes are going to be made, this command would be used to prevent the Using Host graphics package from updating the image after every change. A NODELAY command exits from the DELAY mode and causes the image to be prepared and presented to the viewer. For example, the current picture may display four subpictures each of which is going to be redefined. Without a DELAY command, the viewer would see successive stages of the change, each possibly involving a large amount of computation or transmission time. *End of Extensive Changes ("NODELAY") This optional command undoes the effect of the DELAY command. Michener, et. al. [Page 21] RFC 493 GRAPHICS PROTOCOL 26 April 1973 Appendix 1: BNF for the Graphics Protocol Byte Stream Key to below: Non-terminals are represented in < >. Terminals which are keywords standing for particular eight-bit values are in capitals. Terminals whose meaning should be clear to the reader are in lower case. Note that "empty_string" means "zero bytes", not "a whose is zero." ::= empty_string | | | | ::= ::= ::= | | ::= | | ::= empty_string | ::= | | ::= | | | | | | | | | | ::= | | | | | | | Michener, et. al. [Page 22] RFC 493 GRAPHICS PROTOCOL 26 April 1973 | | | ::= ERASE ::= ENDPIC ::= SUBHED count>
::= 80-hex | 40-hex | C0-hex ::= SUBEND ::= SETVW ::= AADSVW ::= CLVW ::= DELAY ::= NODELAY ::= ESCDEV ::= ESCTOP ::= RESLEV ::= NULL ::= MARK ::= LINMOD ::= SETCHS ::= SETDLN ::= MOVEA ::= MOVER ::= DRAWA ::= DRAWR ::= DOTA ::= DOTR ::= MOVEMK ::= DRAWMK ::= TEXTR ::= TEXT ::= TEXTO ::= INST ::= INSTF ::= eight_bits_of_binary_0 | ::= bit_pattern_indicating_what_clauses_follow ::= eight_bits_of_binary_0 | ::= empty_string | ::= empty_string | ::= empty_string | Michener, et. al. [Page 23] RFC 493 GRAPHICS PROTOCOL 26 April 1973 ::= empty_string | ::= empty_string |floating point number> ::= empty_string | ::= empty_string | ::= empty_string | six_'s ::= 16-bit_non-negative_fractional_part_of_a_circle ::= ::= ::= ::= ::= signed,_two_s-complement,_fraction_in_range -1/2_to_less_than_+1/2 ::= signed,_two_s_complement,_fraction, range _strictly_between_-1_and_+1 ::= network_standard_floating_point number_if_any | 8-bit_two_s_complement_exponent_part and a 16-bit_two_s_complement_fraction_part ::= 7-bit_non-negative_integer | 15-bit_non-negative_integer_represented_in "excess_2**15"_notation ::= count_8-bit_bytes ::= count_upper_case_letters_or_numbers ::= ::= 8-bit_integer ::= 8-bit_integer Appendix 2. Mathematical Formulae for Subpictures Transformations In this appendix positions in a logical coordinate system will be represented by a row vector with two elements, as in /_ x y_/. Vectors and matrices will be delimited by these funny brackets: /_ _/. Various symbols will be used to represent parameters in a full subpicture call relating to a transformation from one coordinate system to another; these are defined below: Mx and My : magnifications in x and y to be applied before any rotation. They may be negative indicating reflection. A: an angle of rotation in the range 0 to just less than 2pi. /_ |cx |cy_/ : the center (in the calling picture) of the image of the subpicture. Michener, et. al. [Page 24] RFC 493 GRAPHICS PROTOCOL 26 April 1973 |sx |sy : the half-sizes, in the x and y directions, of the image on the calling page in terms of the calling page's coordinate system. They may be negative to indicate reflection. /_ x y_/ : a position on the called page. /_ |x |y_/ : the position on the calling page corresponding to /_x y_/. /_ Pcx Pcy_/ : The center of the portion of the called subpicture's coordinate system which is to be mapped to the calling page. This defaults to /_ 0 0_/ if not specified. Psx and Psy : The half-sizes in x and y of the portion of the subpicture to be mapped. These both default to +1/2 in not specified. (If a uniform magnification is specified, set Mx and My equal to it and proceed below as if they were specified.) If magnifications are specified, the following holds: /_ |x |y_/ = (/_ x y_/ - /_ Pcx Pcy_>) * / Mx/Psx 0 / * /_ 0 My/Psy_/ / cos 0 sin 0 / * / 1/2 0 / + /_ |cx |cy_/ /_ -sin0 cos0_/ /_ 0 1/2_/ or in other words, 1) /_|x |y_/ = /_ x-Pcx y-Pcy_/ * / Mx cosA/2Psx Mx sinA/2Psx / /_ -My sinA/2Psy My cosA/2Psy_/ +/_ |cx |cy_/ (The factor of 1/2 is necessary because, for instance, (x-Pcx)/Psx ranges from -1 to +1 for x values within the portion (i.e., such that |x-Pcx| <|Psx| ) whereas the image, in the calling subpicture's coordinate system, should only range from -1/2 to +1/2.) If the image size is specified instead of the magnification, we have the following: /_ |x |y_/ = (/_ x y_/ - /_Pcx Pcy_/) * / 1/Psx 0 / * /_ 0 1/Psy _/ / cosA sinA / * / |sx 0 / + /_ |cx |cy_/ /_ -sinA cosA _/ /_ 0 |sy _/ Michener, et. al. [Page 25] RFC 493 GRAPHICS PROTOCOL 26 April 1973 or, in other words, 2) /_|x |y_/ = /_x-Pcx y-Pcy_/ * /|sx cosA/Psx |sy sinA/Psx / /_-|sx sinA/Psy |sy cosA/Psy_/ + /_|cx |cy_/ Expanding the parenthesized quantities in equations 1) and 2), we have: 3a) /_|x |y_/ = /_x y_/ * /Mx cosA/2Psx Mx sinA/2Psx / /_-My sinA/2Psy My cosA/2Psy_/ + /_|cx-PcxMxcosA/2Psx+PcyMysinA/2Psy |cy-PcxMxsinA/2Psx-PcyMycosA/2Psy _/ and 3b) /_|x |y_/ = /_x y_/ * /|sx cosA/Psx |sy sinA/Psx / /_-|sx sinA/Psy |sy cosA/Psy_/ + /_|cx-Pcx|sxcosA/Psx+Pcy|sxsinA/Psy |cy-Pcy|sysinA/Psx-Pcy|sycosA/Psy_/ Various interesting substitutions can be made in 3a) and 3b). For example, if A=0 (no rotation), then we have: 4a) /_|x |y_/ = /_x y_/ * /Mx/2Psx 0 / + /_|cx-PcxMx/2Psx |cy-PcyMy/2Psy_/ /_ 0 My/2Psy_/ 4b) /_|x |y_/ = /_x y_/ * /|sx/Psx 0 / + /_|cx-Pcx|sx/Psx |cy-Pcy|sy/Psy_/ /_ 0 |sy/Psy_/ Another example is if no portioning is done (Pcx=Pcy=0, Psx=Psy=1/2): 5a) /_|x |y_/ = /_ x y_/ * /Mx cosA Mx sinA / + /_|cx |cy_/ /_-My sinA My sinA_/ 5b) /_|x |y_/ = /_ x y_/ * /2|sx cosA 2|sy sinA / + /_|cx |cy_/ /_-2|sx sinA 2|sx cosA_/ Michener, et. al. [Page 26] RFC 493 GRAPHICS PROTOCOL 26 April 1973 If in addition, 0=0, we have: 6a) /_|x |y_/ = /_ xMx+|cx yMy+|cy_/ 6b) /_|x |y_/ = /_ x*2|sx+|cx y*2|sy+|cy_/ Of course, in all cases, the transformation from /_x y_/ to /_|x |y_/ can be written in the form: /_|x |y_/ = /_x y_/ * / 2 by 2 / + /_ translation _/ /_ matrix _/ In general, a transformation combining a linear transformation and a translation is called an affine transformation. Transformations with Nested Levels The combination of two affine transformations is again an affine transformation. Indeed, if /_|x |y_/ = /_x y_/ * / Mat1 / + /_ Tran1 _/ /_ _/ and /_|x_ |y__/ = /_|x |y_/ * ( / Mat1 / * / Mat2 /) /_ _/ /_ _/ + (/_ Tran2 _/ + /_ Tran1 _/ * / Mat2 /) /_ _/ Thus if one has nested full subpicture calls, the data at any level need be transformed only once, namely, by the transformation which is the combination of the single step transformations at each level of nesting. A new "grand combination" affine transformation should be computed whenever a full subpicture is called (after pushing down the current transformation) by combining the current grand combination with the affine transformation for this particular subpicture call. Portions with Nested Levels As long as no rotations are involved, or even only rotations in multiples of pi/2, then multiple levels of portions are easy to implement. In the discussion in the next two paragraphs let us assume that no rotations other than whole multiples of pi/2 are involved. Just as one can keep track of a "grand combination" affine transformation, so can one keep a grand combination of portions. At each level, one can proceed as follows: Save a copy of the current Michener, et. al. [Page 27] RFC 493 GRAPHICS PROTOCOL 26 April 1973 grand portion, and use the inverse of the single level affine transformation (specified in the subpicture call) to determine what rectangle of the called page corresponds to the current grand portion (on calling page). Various relations may exist between this rectangle and the rectangle specified (or defaulted) in the subpicture call. They may be disjoint (in which case this subpicture need not be called at all); they may be equal (an easy case); one may contain the other or they may partially overlap. If there is any intersection, it will be a rectangle, and this rectangle becomes the new grand combination portion. The problem with rotations other than multiples of pi/2 is that the inverse image of the rectangle is no longer in the standard orientation (vertical and horizontal edges). This means that its intersection with the portion specified on the subpicture call may have 3, 4, 5, 6, 7, or 8 edges (if it is non-empty). Deeper levels may get even worse if they involve rotations too. While there may be no conceptual difficulty (for some) in working with such a situation, significantly more computation is involved than in the simple horizontal and vertical edge case. This protocol puts forward no recommendation in the case that rotations other than whole multiples of pi/2 are involved with portions. It does suggest that nested portions be handled as described above in the more straightforward case. [This RFC was put into machine readable form for entry] [into the online RFC archives by Helene Morin, Via Genie, 12/1999] Michener, et. al. [Page 28]

 

RFC, FYI, BCP