home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / r / riscript / ReadMe next >
Text File  |  1994-09-17  |  5KB  |  102 lines
  1. Getting Started
  2. ---------------
  3.  
  4. There are two applications in the archive: RiScript and ScripTerm.
  5. RiScript is a PostScript-previewer that can save the image as a draw
  6. file (no, not only a sprite but real objects). ScripTerm is a terminal
  7. that can be connected to the previewer.
  8.  
  9. Globally, there are two ways of using the software, namely interactively
  10. and in batch mode. When double clicking a PostScript-file RiScript will
  11. be started (when it is not running yet, of course) in batch mode, i.e.
  12. without a terminal (ScripTerm). When starting the RiScript application
  13. (double clicking the application icon) then RiScript will be started in
  14. interactive mode (i.e. with separate terminal).
  15.  
  16. When RiScript is running in batch mode, double clicking a PostScript-file 
  17. will start a new job, i.e. the current page will be erased etc. When 
  18. RiScript is running in batch mode, a terminal can be attached by starting 
  19. the ScripTerm application _and_ selecting the menu item "interactive" in 
  20. the RiScript-application (in this order).
  21.  
  22. When the previewer is in interactive mode, it is also possible to enter 
  23. commands via the terminal (ScripTerm window). Double clicking on a Post-
  24. Script-file in this mode will not start a new job but `add' the contents
  25. to the current job (this means that the output will be merged). Pressing
  26. ^D will start a new interactive job. Selecting the "interactive" menu item
  27. when in interactive mode will cause the previewer to run in batch mode.
  28. This can also be achieved by quitting ScripTerm.
  29.  
  30.  
  31. Known `Bugs'
  32. ------------
  33.  
  34. It grabs quite a lot of memory. This can be changed, but only statically.
  35. This means that it can only be set at start-up with program parameters.
  36. How to change this is explained in one of the Doc files. Remember, however,
  37. that a real PostScript printer needs quite some memory (e.g. 6M).
  38.  
  39. Some missing features are:
  40.   - packed arrays (not _very_ important; the PostScript printer driver
  41.     of Acorn does however use this feature for unavailable fonts);
  42.   - Type 1 fonts (this can be a real nuisance when using special fonts);
  43.   - clipping (depends on the file whether important).
  44.  
  45. RiScript and ScripTerm are both implemented in C. This will limit the speed
  46. but more importantly it is quite difficult to detect integer overflow (if
  47. somebody knows a trick, please tell us). This might cause some problems.
  48.  
  49. Sometimes the bounding boxes of the objects are wrong. We're not sure what
  50. to do, but draw can handle most of the generated files. Furthermore, there
  51. appear to be programs that give awidthshow real numbers as parameters. We
  52. so far have only implemented it for integers.
  53.  
  54. RiScript does not run on RISC OS 2 machines. Sorry, but we use quite some
  55. RISC OS 3 features, so it will probably not appear for RO2.
  56.  
  57. There are files where the result is different from the result on a PS-
  58. printer. If you have such a PS-file, please send it to us and we will try
  59. to improve RiScript.
  60.  
  61.  
  62. Hints and Tips
  63. --------------
  64.  
  65. There are quite some people who have the RISC OS font AvantG instead of 
  66. AvantGarde. Please change the file <RiScript$Dir>.Fonts.AvantGarde in such 
  67. a way that the first set of mappings instead of the second are commented 
  68. out (for those without PostScript knowledge: comments start with a percent 
  69. sign (%) and end at the end of a line). A comparable procedure has to be
  70. executed if you have selwyn instead of zapf.dingbats.
  71.  
  72. In this archive, clip paths are shown by thin red dashed lines in the
  73. generated image. If you do not want this, you'll have to edit the file
  74. <RiScript$Dir>.System.Utils and ‘decomment’ the first defintion of clip
  75. and comment out the second definition (lines upto and including "} def").
  76.  
  77. The path returned by the clippath operator is useless. If your PostScript
  78. program make use of it, there can happen funny things.
  79.  
  80. If you want to preview PS-files that use Auto Kerning they probably are
  81. quite slow. You better turn off this feature, if you are generating the
  82. file yourself, for it will slow down the process considerably (this is 
  83. probably the case with other PostScript generating tools too) and will 
  84. generate many many objects. It is even better not to right justify your 
  85. document.
  86.  
  87. W.r.t. draw: there can be quite some white rectangles in the file, especially 
  88. using Impression with coloured (i.e. not transparant) frames. Furthermore, 
  89. remember that the ‘paper’ is also saved (this is the object I throw away 
  90. immediatly when editing the generated draw-file; perhaps this should be 
  91. an option).
  92.  
  93.  
  94. Questions, remarks, and problems
  95. --------------------------------
  96.  
  97. Please let us know when you have questions, remarks, or problems.
  98.  
  99.       bos@prl.philips.nl
  100.    medema@prl.philips.nl
  101.  
  102.