home *** CD-ROM | disk | FTP | other *** search
/ CICA 1995 May / cica_0595_4.zip / cica_0595_4 / UTIL / GPT34SRC / README.OS2 < prev    next >
Text File  |  1993-05-11  |  4KB  |  96 lines
  1. GNUPLOT 3.3 for OS/2 v 2.0
  2. ==========================
  3.  
  4. 1) Introduction
  5. ===============
  6.  
  7. This file discusses the version of GNUPLOT 3.3 implemented for OS/2 2.0.
  8.  
  9. The command line interface of GNUPLOT is retained, while graphics output is
  10. plotted in a Presentation Manager Window. The GNUPLOT command line
  11. appears in another text-mode window on the screen.
  12.  
  13. The PM window has facilities for printing the plot on the default printer,
  14. for changing the fonts used on the plot, and for switching between different
  15. ways of plotting the lines (with colour, as dot/dashed lines, or both).
  16.  
  17. The command line window offers the usual GNUPLOT interface. Both Unix-style
  18. and DOS-style editing keys are supported.
  19.  
  20. The GNUPLOT program was compiled with the emx version of the GNU compiler.
  21. It supports the shell command (type 'exit' to return to GNUPLOT), can pipe
  22. datafiles through external commands using '<', and supports command-line
  23. substitution. It runs the full set of demonstration programs supplied in
  24. the GNUPLOT source code distribution without problems.
  25.  
  26. The GNUPLOT 3.3 port to OS/2 differs slightly from the 3.2 port, in that
  27. the PM driver is started from GNUPLOT, rather than the other way round.
  28. This means that the program name will have to be changed in the program
  29. object that runs GNUPLOT, if you install 3.3 over 3.2.
  30. This change does however make the GNUPLOT command line accessible to programs
  31. that pipe commands to GNUPLOT.
  32.  
  33.  
  34. 2) Running GNUPLOT
  35. ==================
  36.  
  37. GNUPLOT can be run from the command line of an OS/2 session (preferrably
  38. a windowed command session, so that the command line and the displayed
  39. graph can be viewed at the same time), or can be set up as a program object
  40. in the WPS.
  41.  
  42. GNUPLOT starts up as a command line session which accepts the usual
  43. GNUPLOT input. The Presentation Manager window for graphics display
  44. is only opened when the first 'plot' or 'splot' command is entered.
  45.  
  46. If GNUPLOT is set up as a program object, it can be configured for
  47. 'drag and drop' in the usual way, by specifying '%*' as the program
  48. parameter.
  49.  
  50. The PM window has facilities for printing the plot, for changing
  51. the fonts used in the plot, and so on. These of course are handled
  52. through the usual PM interface.
  53. In addition, you can 'drop' a font onto the window to change the font.
  54.  
  55. The usual GNUPLOT commands can also be used to produce output on
  56. supported devices.
  57.  
  58. Settings and the positions and sizes of the windows can be saved in
  59. the file gnushell.ini. This file is saved in the program's working
  60. directory; several different directories can be set up (as program
  61. objects) with different options, if you wish.
  62.  
  63. GNUPLOT can be run with the PM display window maximised: clicking on
  64. the 'GNUPLOT' menu item (or pressing 'ESC') will bring the GNUPLOT
  65. window to the foreground; it will disappear again when plotting begins.
  66.  
  67. GNUPLOT itself communicates with the PM display window (which is a
  68. separate program) through a named pipe. Plotting commands are sent to
  69. the PM window which produces the plot when all commands have been received.
  70.  
  71. 3) The port of GNUPLOT to OS/2
  72. ==============================
  73.  
  74. Changes to the code have been kept minimal. Besides the obvious addition
  75. of the PM driver code, the following are the major changes:
  76.  
  77. 1) Addition of code in readline.c to map keypad keys to editing functions,
  78.    to duplicate the MS-DOS mode of editing the command line. (See GNUPLOT manual,
  79.    page 2.)
  80.  
  81. The rest of the changes are associated with defining the use of the OS2
  82. conditional value, and setting system-dependent stuff like names, signal
  83. handling, and end-of-line handling (LF vs CR+LF).
  84.  
  85. See the file patches.os2 for changes to the GNUPLOT source.
  86.  
  87. 4) gnupmdrv.exe
  88. ===============
  89.  
  90. Gnupmdrv.exe is the 'outboard' driver for GNUPLOT. It is a multithreaded
  91. PM program.
  92.  
  93. Roger Fearick
  94. fearick@physci.uct.ac.za
  95. 5 November 1992
  96.