home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d2xx / d243 / lpe.lha / LPE / lpe.ReadMe < prev    next >
Text File  |  1989-09-04  |  9KB  |  249 lines
  1.                              LPE V1.0
  2.               A LaTeX-Picture-Editor for the Amiga
  3.  
  4.                 Written and Copyright (C) 1989 by
  5.                          Joerg Geissler
  6.                           Distelweg 30
  7.                           2805 Stuhr 3
  8.                           West-Germany
  9.  
  10.                      Version 1.0   8/20/89
  11.  
  12.        This program is freeware. You know what that means.
  13.        It may be freely copied. For distribution with any
  14.         commercial product you need a written approval of
  15.                            the author.
  16.  
  17.  
  18. INTRODUCTION
  19.  
  20. LPE stands for LaTeX-Picture-Editor and is a graphical
  21. editor to produce "pictures" for the LaTeX system which
  22. may be imported. It is my first project with Amiga-C and
  23. Intuition. For this reason, I do not offer any source for
  24. this version because that would be too painful for me.
  25.  
  26. LPE is an interesting tool for those of you, who are
  27. looking for a small quick program which allows you
  28. to produce even more complex combinations of objects in
  29. a picture environment for LaTeX.
  30.  
  31. - You will get best results when you place LPE on your
  32.   TeX: disk with all your Workbench files.
  33. - A tool like Heliosmouse or DMouse (what I use) might be helpful.
  34. - Be sure that mathtrans.library is available.
  35. - 16000 is a good stack value.
  36.  
  37.  
  38. GETTING STARTED
  39.  
  40. LPE may be run from Workbench simply by double-click on
  41. its icon.
  42. CLI users may start it by typing its name:
  43.  
  44.    lpe
  45.  
  46. There is another version to run LPE without the run
  47. command: it is called "lpe.NoRun" and detaches LPE from CLI.
  48.  
  49. As a matter of fact, I do not know any command to check
  50. if you are using a PAL-Amiga or the NTSC-version (someone
  51. may help me in this case). Because of this, there are
  52. special versions for the NTSC guys with  smaller screen
  53. dimensions ("lpeNTSC" and "lpeNTSC.NoRun"). I hope they
  54. are ok, I wasn't able to check it out.
  55.  
  56.  
  57. FIRST IMPRESSION
  58.  
  59. When the program has loaded, you will see a Hires-Interlace(sorry!)-
  60. Screen with one bitplane. It contains a large window
  61. with a grid and a smaller one full of gadgets. The large
  62. window is the drawing area, the gadget window contains the drawing
  63. tools and some other functions.
  64.  
  65. By pressing the right mouse button a Project menu will appear with
  66. functions like loading and saving.
  67.  
  68. Later versions may have a button to turn off the interlace
  69. (although it looks so professional).
  70.  
  71.  
  72. THE DRAWING AREA
  73.  
  74. The large window with the grid is the drawing area. Here you will
  75. compose your picture. It is a 10 units grid to facilitate any
  76. estimation. You may turn it off as you will see later on.
  77.  
  78. Additionally, there is a cross in the lower left corner of the
  79. drawing area. That is the origin (0,0) of the system of co-
  80. ordinates used by LPE. It may be moved by the user.
  81.  
  82.  
  83. THE GADGET WINDOW
  84.  
  85. In the gadget window you will find most of the functions LPE
  86. offers. There are the drawing tools BOX, DASHBOX, LINE, VECTOR,
  87. CIRCLE, TEXT and TBOX, and other like UNDO, CLEAR, CENTER, GRID.
  88. They may be used by clicking on their gadgets.
  89.  
  90. Later on, when you have chosen one of those functions, some
  91. pairs of digits will appear on the right side of this window.
  92. These are the co-ordinates of the cursor according to the
  93. origin.
  94. In the title of the window you will find some notes, what to do,
  95. what LPE does, error messages etc. I hope, you will never need this
  96. documentation when using LPE.
  97.  
  98.  
  99. THE GADGETS
  100.  
  101. The following gadgets are available in this version:
  102.  
  103. BOX     You may draw a box with this drawing tool.
  104.         First, one edge, then the opposite one. It
  105.         does not make any difference, if you first fix the
  106.         upper left corner and then the lower right one
  107.         or if you first fix the lower left and then ...
  108.         or ... or ...
  109.         Note: because of the single bitplane LPE uses,
  110.         a box right on the same place like another box
  111.         with the same dimensions would delete the first
  112.         one so that both are invisible though both still
  113.         exist!
  114.         Before you fix the first edge of the box a pair of
  115.         numbers will appear to the right of the gadget window.
  116.         They stand for x- and y-co-ordinates of the cursor
  117.         according to the origin.
  118.         After you have fixed the first point, another pair
  119.         will appear: it describes the co-ordinates according
  120.         to the first point. It is the grade of a straight line
  121.         from point one to point two.
  122.         Using these information, it is easy to make a box with
  123.         specific dimensions.
  124.  
  125. DASHBOX see BOX
  126.         The difference: the box is drawn using dashed lines.
  127.  
  128. LINE    You need a line? OK. Click on LINE.
  129.         Like a box you have to fix first and second point of
  130.         the line.
  131.         But stop! LaTeX only knows lines of a specific grade!
  132.         This is why LPE continuously checks the grade of the
  133.         line from the fixed first point to the variable second
  134.         one. If you see an "OK" above the displayed co-ordinates
  135.         you have a line LaTeX will accept. If you fix the second
  136.         point without any "OK" no line will be drawn!
  137.         Note: you may wonder why only one pair of co-ordinates
  138.         changes whereas the other pair doesn't if you want to
  139.         fix the first point. This last one is the pair of the second
  140.         point used in the previous drawing action. You may now
  141.         fix the actual first point right on the same place as the
  142.         previous second one. It is the way to draw continuous lines.
  143.  
  144. VECTOR  see LINE
  145.         The orientation of the vector is important: it is the
  146.         second point, symbolized by a small circle.
  147.  
  148. CIRCLE  First, set the center of the circle and then its radius
  149.         (the line from point one to point two). Circles larger
  150.         than the drawing area will not be drawn.
  151.         Note: LaTeX (the version I know) is not able to draw
  152.         every circle you can think of. Just try and error.
  153.  
  154. TEXT    You may place a text up to 80 characters in the picture.
  155.         FIRST, you have to click on the large gadget (called
  156.         "Text") where you may input your text. THEN click on
  157.         TEXT to place it in the drawing area and adjust the text.
  158.         I know, it is a quite primitive way, but I did not like
  159.         to work on an input requester in this version of LPE.
  160.  
  161. TBOX    LaTeX offers the possibility to draw a box with a centered
  162.         text in it. That is T(ext)BOX. First input your text in the
  163.         large gadget, then click on TBOX to draw the box. LPE
  164.         will center your text as possible.
  165.  
  166. UNDO    deletes last object
  167.  
  168. CLEAR   deletes whole picture
  169.  
  170. CENTER  Place an new origin in the drawing area.
  171.         Note: There is still a bug when you save a picture with a
  172.         changed origin! Be careful!
  173.  
  174. GRID    turns the grid and the origin on/off
  175.  
  176.  
  177. THE PROJECT MENU
  178.  
  179. You may use the following functions in the Project menu:
  180.  
  181. LOAD LPEFILE      loads a LPE file.
  182.                   Be sure that you have entered the file name in
  183.                   the large gadget.
  184.                   WARNING: if you try to load an existing file
  185.                   which is not a LPE file, you may meet the GURU.
  186.                   I suggest the suffix ".lpe".
  187.  
  188. LOAD LATEXFILE    not yet implemented
  189.  
  190. SAVE AS LPEFILE   saves the actual picture as LPE file.
  191.                   File name is the text in the large gadget!
  192.                   Suggested suffix: ".lpe"
  193.  
  194. SAVE AS LATEXFILE saves the picture as an ASCII-file in a format
  195.                   that can be imported by LaTeX.
  196.                   The picture environment is scaled to 640x400
  197.                   with a unitlength of 0.2mm.
  198.                   You may change these values with a file monitor;
  199.                   it can be found as ASCII in the source.
  200.                   Note: suffix should be ".tex"!
  201.  
  202. ABOUT             what ? of whom ? when ?
  203.  
  204. HELP              not yet implemented (unnecessary ?)
  205.  
  206. QUIT              quits the program
  207.                   You may also quit by click on the close gadget.
  208.  
  209.  
  210.  
  211. KNOWN BUGS
  212.  
  213. You already know the bug at CENTER. Furthermore, there may
  214. be a 00000003 GURU when using LINE. I never had this message
  215. when I work with LPE in my C programming environment
  216. (1.4MB in VD0:), but it sometimes appears on normal Disk use!?
  217. Nevertheless, the stack should be 16000 or higher.
  218.  
  219.  
  220. CREDITS AND THANKS
  221.  
  222. Special thanks to:
  223.  
  224. - Commodore for this highly advanced computer
  225. - Manx for the Compiler and the terrific SDB
  226. - Fred Fish for this great AmigaLibDisks series
  227. - those of you who will test LPE and send me bug reports,
  228.   comments and lots of suggestions for future enhancements
  229. - a few friends who were of the opinion that I would
  230.   never be able to write even a much more simple LPE;
  231.   they will be surprised about future versions
  232. - Douglas Adams for "So long, and thanks for all the fish"-
  233.   the only novel I did not understand; the same feeling like the
  234.   first steps on Amiga C
  235.  
  236.  
  237. Did you hear the news? Commodore decided to produce an Amiga
  238. with a 150 MHz CPU, 200 MB of RAM, 1.5 GB on Disk, a screen
  239. resolution of 4096x4096 pixels (24Bit), voice recognition input,
  240. portable (fits in your shirt pocket) and costs about $400! What's
  241. the first question of the computer community? "Is it PC compatible?"
  242.  
  243. Have fun with LPE.
  244.  
  245. Suggestions, donations, insults and test results may be send to
  246. the address above.
  247.  
  248.                                        - Joerg -
  249.