home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / postscript / DrawingServant.README < prev    next >
Encoding:
Text File  |  1993-07-12  |  4.0 KB  |  94 lines
  1. Got an old, rusty C program that is just dying to have a NeXT
  2. graphics port?  Then consider...
  3.  
  4.     DrawingServant
  5.  
  6. Now is the updated to the ever advancing version 0.2
  7.  
  8. The "usual" way of porting an application to NeXTStep
  9. seems to be to create an NeXT frontend with IB or equivalent,
  10. then invoke the underlying application through some interprocess
  11. communication.  DrawingServant is a utility for performing
  12. a port from the opposite direction.  The intended use of this
  13. program is as a graphics head to an existing terminal-based
  14. program.  The client program may be invoked from the terminal line;
  15. the client forks a process and establishes pipes to DrawingServant,
  16. then send raw postscript though a pipe to the server.
  17. The server has a small vocabulary of commands, but for the most
  18. part just copies everything not in its vocabulary with a DPSPrintf
  19. to the window manager.  The server has a simple NeXT interface
  20. that allows for saving, printing and clearing the window.
  21.  
  22. One primary application in mind is for some sort of plotting
  23. program.  The main usually have its own setups to perform and
  24. an event loop based on things typed into it.  Normally, this is
  25. difficult to fit into the NeXT event loop without some major
  26. hacking of the main.  However, if the main has some simple
  27. hooks along the line of
  28.     device_setup
  29.     device_drawaline
  30.     device_writesometext, etc.
  31. then it is a simple matter to write a few lines of c code in
  32. setup for fork DrawingServant, and a few more lines to send
  33. a moveto--lineto combination in drawaline for the operation.
  34. The code to invoke the server can be very plain and therefore
  35. likely to be compilable with any set of compiler switches and
  36. without including any NeXT specific include files (in fact, it really
  37. doesn't have to be on a NeXT).
  38.  
  39. Many aspects of real NeXT applications are intentionally left out.
  40. Preferences, Help, multiple language support is all omitted.
  41. Since this program is intended to be only marginally present,
  42. most of the functionality of it should be performed by the main
  43. program.  For example, the size and placement of the drawing window
  44. are entirely controlled by the client program.  If preferences are
  45. needed, they should be handled by the client.
  46.  
  47. The code for DrawingServant is small enough to make it easily hacked.
  48. Interface Builder or Project Builder were not used. 
  49.  
  50. Invoking the server should be done with an exec with the argument
  51. list (optional)
  52.     DrawingServant w# h# x# y# i# o#
  53.     where
  54.         w    width of the window in pixels (default=500)
  55.         h    height in pixels (default=500)
  56.         x    x location of upper left corner (default=400)
  57.         y    y location of upper left (default=250)
  58.         i    fd of input pipe (default=0)
  59.         o    fd or output pipe (default=1)
  60.  
  61. The vocabulary of existing commands is:
  62.  
  63.     DSversion    Return a string to the client of the version id
  64.     DSclear    Erase the DrawingServant window (also on a menu)
  65.     DSsave    Save the DrawingServant window in .eps (menu, too)
  66.     DSoops    Erase the last postscript string sent to the server
  67.     DSprint    Print the window (also in a menu)
  68.     DSmouseon    Return a string to the client reporting mouse clicks
  69.     DSmouseoff    Turn off mouse reporting
  70.     DSackon    Return "Ok" after processing command
  71.     DSackoff    No acknowledgement
  72.     DSquit    Die
  73.     DSfront    Move window to the very front (even above the terminal)
  74.     DShide    Same as hide from the menu
  75.  
  76. This is clearly not the absolutely most efficient way to draw in NeXTStep,
  77. but may be the quickest way to provide a graphics capability to a
  78. vanilla terminal-based C program.
  79.  
  80. DrawingServant can also be invoked from terminal shell (or double clicked),
  81. in which case it becomes another postscript hacking tool.  Also include is
  82. a trivial example client program tester.c; a Metafont online previewer may
  83. also be available at archive sites.
  84.  
  85. Suggestions and complaints are welcome.  Anyone want to write a
  86. tektronix emulator for kermit?
  87.  
  88. The code is copyright 1993 by Joe Carlson.  Permission is granted for
  89. noncommercial redistribution of this program.  If you port an common
  90. application using this, or have problems doing so, drop me a line and
  91. I'll try to keep track of things.
  92.  
  93.     joe@ril3.tamri.com
  94.