home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / printers / utilities / redaktu / readme.txt < prev    next >
Text File  |  1991-02-14  |  11KB  |  284 lines
  1.  
  2.                              Redaktu.ps
  3.  
  4. This program is intended as an aid to the enhancement of Pro Page.  Its main
  5. purpose is to allow Pro Page users to output characters for which there does
  6. not exist any PostScript font or matrix file.  This is done by editing the
  7. PostScript output file itself.  This program is itself written in PostScript
  8. and therefor requires an interpreter program.  The author uses PixelScript
  9. for this purpose.  PixelScript has a few minor bugs,  but Redaktu.ps has
  10. been written to work around these.
  11.  
  12. At present this program is fully configured for use in producing diacritical
  13. marks used in the international language Esperanto.  The necessary operators
  14. for these marks are contained in three arrays...fadenArray, psArray and
  15. txtArray.
  16.  
  17. Three empty arrays are also provided for any such operators as you may
  18. choose to write.  Their names are...prologArray, postPrologArray, and
  19. otherArray.  Comments in the PostScript code of Redaktu.ps will explain
  20. what to put in each of these arrays.  Refer to comments at the bottom of
  21. file for further guidance.
  22.  
  23.  
  24.                           FOLLOW THESE STEPS
  25.  
  26.              TO PRODUCE ESPERANTO DIACRITICALS IN PRO PAGE.
  27.  
  28.  
  29. 1.  WORD PROCESSING STEPS
  30.  
  31.     a. Before calling up Pro Page,  edit your import file.  The missing
  32.        characters should be substituted as follows.  The import file must
  33.        be in plain ASCII.  No specific word processor file formats are
  34.        supported in Redaktu.ps.
  35.  
  36.                       type   Q   for   C^
  37.  
  38.                              q   for   c^
  39.  
  40.                              W   for   U^
  41.  
  42.                              w   for   u^
  43.  
  44.                              Y   for   J^
  45.  
  46.                              y   for   j^
  47.  
  48.                              X   for   S^
  49.  
  50.                              x   for   s^
  51.  
  52.                              {   for   G^
  53.  
  54.                              [   for   g^
  55.  
  56.                              }   for   H^
  57.  
  58.                              ]   for   h^
  59.  
  60.        Notes:
  61.  
  62.        This substitution set was selected for rapid touch typing.  There is
  63.          no other logic to it.  But this is the set which matches the
  64.          entries found in the array txtArray.  Change them if you wish.
  65.  
  66.        But as an aid to those who prefer rapid touch typing,  I have
  67.          included two bit map fonts,  Esperanta 17 and Angla 17.  Pull them
  68.          out of the FONTS: directory of this disk.
  69.  
  70.  
  71.     b. Save this as a simple ASCII file.  Make sure that it has a .txt
  72.        suffix.  Otherwise Redaktu.ps won't recognize it.
  73.  
  74.  
  75.        Note:
  76.        Editing will go much faster if you put your file in the RAM DISK
  77.          or ASDG-RAM disk.  Many files exceed PixelScript's string size
  78.          limit, so Redaktu.ps reads line by line.  Heavy disk gronking
  79.          will result from files being edited while on the disk.
  80.  
  81.  
  82.     c. Get PixelScript running.  Type the name of your file in the command
  83.        window.  Hit the return key.
  84.  
  85.  
  86.     d. Using the mouse.  Select the select file gaget and find the program
  87.        Redaktu.ps.  Select OK.
  88.  
  89.  
  90.     e. When PixelScript says, "All done", note the name of your output file.
  91.        This is the file which you will import into Pro Page.
  92.  
  93.  
  94.  
  95. 2.  PRO PAGE STEPS
  96.  
  97.     a. Import your file (with the ".fmtd" suffix) into Pro Page.
  98.  
  99.        Note:
  100.        Observe that some of the letters are elevated above the baseline.
  101.          This is intentional,  do not try to fix it.  Redaktu.ps will fix it
  102.          later.
  103.  
  104.     b. Save your Pro Page document using the OUTPUT menu,  selecting
  105.        POSTSCRIPT from the sub menu.
  106.  
  107.     c. Enter RAM DISK (or preferably ASDG-RAM) as the output location.
  108.  
  109.     d. Enter a file name containing the suffix ".ps" and select OK.
  110.  
  111.        Note:
  112.        Do not download fonts.  The superscript operators included in
  113.          Redaktu.ps are sized for the Times-Roman font.  You will have to
  114.          write your own for best results with another font.
  115.  
  116.  
  117. 3.  FINAL STEPS
  118.  
  119.     a. Get PixelScript going again.  Enter your PostScript file name in the
  120.        command window and hit return.
  121.  
  122.     b. Using the select file gaget and file requester,  select Redaktu.ps
  123.        and then select OK.
  124.  
  125.     c. Note the name of your output file.  It will have a ".Eo-ps" suffix.
  126.  
  127.     d. That is all.  You may either run your resulting .Eo-ps file with
  128.        PixelScript immediately,  or transfer the file to the hard disk
  129.        for use later.
  130.  
  131.        Note:
  132.        As a quick check,  try running your new .Eo-ps file with PixelScript
  133.           configured for the DPS screen file display program which is
  134.           included with PixelScript.
  135.  
  136.  
  137. That is all you need to know to make it work for Esperanto diacriticals.  To
  138. modify it according to your specific needs,  read the following.
  139.  
  140.  
  141. THEORY OF OPERATION
  142.  
  143. 1.  The first part causes Pro Page to elevate certain substitution letters
  144.     above the baseline.  This elevation serves as a marker for later steps
  145.     which replace the elevated character.
  146.  
  147. 2.  When these elevated letters are handled in the PostScript output they
  148.     create a uniquely identifiable sequence of lines in the code beginning
  149.     with  " -1.041 mvy "  followed by a second line containing a single-
  150.     character string and the "show" operator,  followed by a third line
  151.     showing "0.000 mvy".
  152.  
  153. 3.  Redaktu.ps looks for this sequence.  Deletes the first and third lines
  154.     containing the "mvy" operator.  This does away with the baseline
  155.     elevation.  It then replaces part of the middle line,  adding in the
  156.     appropriate custom PostScript operator from an array.
  157.  
  158. 4.  Redaktu.ps also makes insertions into the prolog of the PostScript file
  159.     so as to provide needed operators for the substitutions and insertions
  160.     described in step three.
  161.  
  162.  
  163. COMMENTS
  164.  
  165. If your need is for characters other than those provided,  you may learn how
  166. to create them with any of the following books on PostScript.
  167.  
  168.  
  169.   PostScript Language Tutorial and Cookbook,  Addison Wesley Pub. Co.
  170.   PostScript Language Reference Manual,  Addison Wesley Pub. Co.
  171.   PostScript Language Program Design,  Addison Wesley Pub Co.
  172.   Thinking in PostScript,  Addison Wesley Pub Co.
  173.   Understanding PostScript Programming,  Sybex
  174.   Graphic Design with PostScript,  Scott, Forseman and Co.
  175.   PostScript - A Visual Approach,  Peachpit Press
  176.  
  177.  
  178. Although Redaktu.ps comes set up for character substitution,  there is no
  179. reason whatsoever why you could not choose to modify it for some other type
  180. of substitution or insertion.  You might,  for instance,  elect to use
  181. Redaktu.ps to do automatic logo insertions,  or any other such operation
  182. you may wish.
  183.  
  184.  
  185. BUGS
  186.  
  187. PixelScript has a few trivial bugs.  You will notice,  after you have
  188. edited your text file for Pro Page insertion,  that the edited file will
  189. have strings of reverse @ symbols.  These are not ASCII characters.  I don't
  190. know what they are.  But they do not affect Pro Page in any way.  When Pro
  191. Page imports an ASCII file,  these characters are invisible to it.  They do
  192. not show up in the imported text on the page,  and they do not show up in
  193. the PostScript output either.  So just ignore them.  But for your
  194. information this is how they are caused to appear...
  195.  
  196.   If a string is read from a file and modified before being written to the
  197.   second file,  then the string written after it will put a string of the
  198.   reverse @ symbols at its head which is proportional in length to the
  199.   amount of modifying done to the string before it.
  200.  
  201. It only affects the editing of .txt files,  not .ps files.  This is because
  202. Redaktu.ps edits PostScript files by deleting and substituting whole strings
  203. and not by breaking up and re-assembling strings as it does with text files.
  204. When editing PostScript files for inserted characters,  Redaktu.ps knows
  205. that a mvy operator will preceed it.  Thus it can predict the comming
  206. characters and be ready.  When editing .txt files,  Redaktu.ps has no such
  207. warning and must be ready for anything.  Thus it must break up and
  208. re-assemble the strings.  So it was not possible to get rid of these reverse
  209. @'s from the process.
  210.  
  211. PixelScript also has a problem with its implementation of the PostScript
  212. search operator.  That is it will return a false instead of a true when
  213. seek is the terminal substring of string.  I have worked around this.  But
  214. you need to be aware of it when you modify.
  215.  
  216. PixelScript has one other problem with its writestring operator.  It will
  217. sometimes truncate a string which it is supposed to write.  This only
  218. happens with strings over a certain length.  I have broken up strings which
  219. are very long.  This is the purpose of fadenArray.  It is an array of
  220. substrings which I would have rather sent as a single string.  You should
  221. follow this example if you modify your copy of Redaktu.ps.
  222.  
  223.  
  224. LIST OF FILES PROVIDED
  225.  
  226.       1.  ReadMe.txt   The file you are now reading.
  227.  
  228.       2.  ASCII.txt    A sample ASCII file,  without the suggested
  229.           alphabetical substitutions,  such as you might wish to import into
  230.           Pro Page.
  231.  
  232.       3.  ASCII.fmtd   The result of editing the above ASCII.txt file with
  233.           Redaktu.ps.  This is what you would really import into Pro Page.
  234.           Note the strange reverse @ symbols;  this is a PixelScript bug
  235.           But it doesn't bother Pro Page in the least.  Refer to the text
  236.           above which appears under the heading BUGS below.
  237.  
  238.       4.  PostScript.ps   This is what you get after importing ASCII.fmtd
  239.           to Pro Page and saving the document as a PostScript file.  This
  240.           is the file which you would pass through Redaktu.ps for the
  241.           final result.
  242.  
  243.       5.  PostScript.Eo-ps   This is what you get when you edit the above
  244.           file mentioned above through Redaktu.ps.  This is the file which
  245.           you would run on PixelScript to get your final output.
  246.  
  247.       6.  Redaktu.ps   This is the editing program.  It is written all in
  248.           PostScript and must be run on PixelScript.  It will probably work
  249.           on any PostScript interpreter program,  but I haven't tried it.
  250.  
  251.       7.  FinalResult   This is the result of running the above file on
  252.           the PixelScript interpreter which is set for a screen file.  Just
  253.           double click on it to view a screen representation of the final
  254.           result.  Bear in mind that the 72 dpi screen file in no way shows
  255.           the smoothness you would bet by running PixelScript configured
  256.           or output to a 300 dpi printer.  I use the OKI Laser 800 type LED
  257.           page printer.  Results with it are excellent.
  258.  
  259.       8.  Alphabet   This is a screen print file of a PostScript program
  260.           which shows the effects of scaling the Times-Roman font to
  261.           different sizes.  This is a demo to show that Redaktu.ps does
  262.           indeed handle font sizing for you in printing the diacritical
  263.           marks.
  264.  
  265.       9.  ProPageFile  This is what it says.  It is the Pro Page file made
  266.           by importing ASCII.fmtd into Pro Page and then saved in Pro Page
  267.           format.  This is only for show.  Pro Page document files are not
  268.           a part of the Redaktu.ps editing process.
  269.  
  270.  
  271.  
  272. RESTRICTIONS AND CONDITIONS
  273.  
  274. There aren't any.
  275.  
  276. This program is released into the public domain.  But I would like to ask,
  277. should anyone make improvements upon it,  that I be sent a copy.  My
  278. address is:
  279.  
  280.  
  281.                        John Wesley Starling
  282.                        224 Rose Place
  283.                        Kalamazoo MI 49001-2617
  284.                        USA