home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / miscutil / lpe.lzh / LPE / LPE.DOC < prev    next >
Text File  |  1991-08-16  |  11KB  |  301 lines
  1.                              LPE V1.1
  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.1   11/01/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. Changes since V1.0:
  19.  
  20. - new drawing tools: dashed lines, dashed text box and double
  21.   vectors
  22. - the functions grid, clear and center are in an additional
  23.   menu strip called EDIT
  24. - the grid is drawn in relation to the origin
  25. - no more menu functions which are not yet implemented
  26. - BOTH x-/y-coords of the actual object will be fixed
  27. - opens screen on Workbench size, so no more special
  28.   PAL/NTSC/Overscan versions
  29. - LPE's own mouse pointer works on both windows
  30. - the value for LaTeX's dashed box may be changed, the value
  31.   for the grid size, as well
  32. - one extra string gadget for the filename
  33. - the gadget window may be disappeared to look at the whole picture
  34. - automatic suffix (".lpe" for LPEfiles and ".tex" for LaTeXfiles)
  35. - more requesters for errors
  36. - the possibility to build 255 objects (not 100 as in V1.0)
  37. - code will be loaded to fast memory
  38. - optimized code
  39.  
  40. Bugs fixed:
  41.  
  42. - UNDO seems to work correct now
  43. - the string gadgets have a correct cursor; no more centered
  44.   strings
  45. - no more GURU when you try to load an existing file which is
  46.   not a LPEfile or if you often use the menu
  47. - no more mouse buffering in the window you are not working in
  48.  
  49.  
  50. NOTE: THE NEW LPE-FILES ARE INCOMPATIBLE TO LPE V1.0 !!! (sorry)
  51. -------------------------------------------------------------------
  52.  
  53.  
  54. INTRODUCTION
  55.  
  56. LPE stands for 'LaTeX-Picture-Editor' and is a graphical
  57. editor to produce "pictures" for the LaTeX system which
  58. may be imported.
  59.  
  60. LPE is an interesting tool for those of you, who are
  61. looking for a small quick program which allows you
  62. to produce even more complex combinations of objects in
  63. a picture environment for LaTeX.
  64.  
  65. - you will get best results when you place LPE on your
  66.   TeX: disk with all your Workbench files
  67. - a tool like Heliosmouse or DMouse (what I use) might be helpful
  68. - be sure that mathtrans.library is available
  69. - 16000 is a good stack value.
  70.  
  71.  
  72. GETTING STARTED
  73.  
  74. LPE may be run from Workbench simply by double-click on
  75. its icon.
  76. CLI users may start it by typing its name:
  77.  
  78.    lpe
  79.  
  80. There is another version to run LPE without the run
  81. command: it is called "lpe.NoRun" and detaches LPE from CLI.
  82.  
  83. LPE will open its screen on Workbench size, so there won't be
  84. any problems with PAL/NTSC. My Workbench is using PAL/Overscan
  85. and it works fine.
  86.  
  87.  
  88. FIRST IMPRESSION
  89.  
  90. When the program has loaded, you will see a Hires-Interlace-
  91. Screen with one bitplane. It contains a large window
  92. with a grid and a smaller one full of gadgets. The large
  93. window is the drawing area, the gadget window contains the drawing
  94. tools and some other functions.
  95.  
  96. By pressing the right mouse button, a menu (Project/Edit) will
  97. appear with functions like loading, saving, grid, center etc.
  98.  
  99. The mouse pointer has chanded to crosshairs.
  100.  
  101.  
  102. THE DRAWING AREA
  103.  
  104. The large window with the grid is the drawing area. Here you will
  105. compose your picture. It is a 10 units grid to facilitate any
  106. estimation. You may turn it off as you will see later on. Maybe
  107. you want to change those grid units, as well.
  108.  
  109. Additionally, there is a cross in the lower left corner of the
  110. drawing area. That is the origin (0,0) of the system of co-
  111. ordinates used by LPE. It may be moved by the user.
  112.  
  113.  
  114. THE GADGET WINDOW
  115.  
  116. In the gadget window you will find most of the functions LPE
  117. offers. There are the drawing tools BOX, DASHBOX, LINE, D(ash)LINE,
  118. VECTOR, 2(double)VECTOR, CIRCLE, TEXT, T(ext)BOX and
  119. D(ashed)T(ext)BOX, plus the UNDO function. They may be used by
  120. clicking on their gadgets. Furthermore, there are two gadgets
  121. for text (filename and picture text).
  122.  
  123. Later on, when you have chosen one of those functions, three
  124. pairs of digits will appear on the right side of this window.
  125. These are the co-ordinates of the cursor according to the
  126. origin.
  127. In the title of the window you will find some notes: what to do,
  128. what LPE does etc. I hope, you will never need this documentation
  129. when using LPE.
  130.  
  131. ATTENTION: The close gadget of this window is no longer the way
  132. to quit LPE ! It is used to hide the window when you want to
  133. see the whole picture !
  134.  
  135.  
  136. THE GADGETS
  137.  
  138. The following gadgets are available in this version:
  139.  
  140. BOX     You may draw a box with this drawing tool.
  141.         First, one edge, then the opposite one. It
  142.         does not make any difference, if you first fix the
  143.         upper left corner and then the lower right one
  144.         or if you first fix the lower left and then ...
  145.         or ... or ...
  146.         Note: because of the single bitplane LPE uses,
  147.         a box right on the same place like another box
  148.         with the same dimensions would delete the first
  149.         one on the screen so that both are invisible though
  150.         both still exist!
  151.         Before you fix the first edge of the box, a pair of
  152.         numbers will appear to the right of the gadget window.
  153.         They stand for x- and y-co-ordinates of the cursor
  154.         according to the origin.
  155.         After you have fixed the first point, its coords will be
  156.         copied to the next line and a third pair
  157.         will appear: it describes the co-ordinates according
  158.         to the first point. It is the grade of a straight line
  159.         from point one to point two.
  160.         Using these information, it is easy to make a box with
  161.         specific dimensions.
  162.         When you have finished the box, the second point coords
  163.         will be copied to the third line of numbers.
  164.         Once again: the first of the three pairs always
  165.         represents the actual position of the mouse pointer.
  166.         The second one has the coords of the first point of the
  167.         object you are drawing. If there is no first point yet,
  168.         it is the one of the previous object (!). The third
  169.         pair is the second point of the actual/previous object.
  170.         So you always have the points of the object before; this
  171.         helps you to draw things like polygons.
  172.  
  173. DASHBOX see BOX
  174.         The difference: the box is drawn using dashed lines.
  175.  
  176. LINE    You need a line? OK. Click on LINE.
  177.         Like a box, you have to fix first and second point of
  178.         the line.
  179.         But stop! LaTeX only knows lines of a specific grade!
  180.         This is why LPE continuously checks the grade of the
  181.         line from the fixed first point to the variable second
  182.         one. If you see an "OK" above the displayed co-ordinates
  183.         you have a line LaTeX will accept. If you fix the second
  184.         point without any "OK" no line will be drawn!
  185.  
  186. DLINE   see LINE
  187.         This is a dashed line.
  188.         NOTE: For LaTeX there are no dashed lines! This is why
  189.         LPE uses a dashed box of height/width 0. So you only
  190.         may draw horizontal/vertical lines (look out for "OK").
  191.  
  192. VECTOR  see LINE
  193.         The orientation of the vector is important: it is the
  194.         second point, symbolized by a small circle.
  195.  
  196. 2VECTOR see VECTOR
  197.         It is a double vector with small circles at its ends.
  198.  
  199. CIRCLE  First, set the center of the circle and then its radius
  200.         (the line from point one to point two). Circles larger
  201.         than the drawing area will not be drawn.
  202.         Note: LaTeX (the version I know) is not able to draw
  203.         every circle you can think of. Just try and error.
  204.  
  205. TEXT    You may place a text up to 80 characters in the picture.
  206.         First, you have to click on the lower large gadget (called
  207.         "Text:") where you may input your text. Then click on the
  208.         TEXT gadget to place it in the drawing area and adjust
  209.         the text.
  210.  
  211. TBOX    LaTeX offers the possibility to draw a box with a centered
  212.         text in it. That is T(ext)BOX. First input your text in the
  213.         lower large gadget, then click on TBOX to draw the box. LPE
  214.         will center your text as possible.
  215.  
  216. DTBOX   see TBOX
  217.         This is a text in a dashed box. D(ashed)T(ext)BOX
  218.  
  219. The CloseGadget lets the gadget window disappear. You may click
  220. somewhere in the drawing area to bring it back.
  221.  
  222. There are two gadgets left: Grid and Dash.
  223. The Grid gadgets includes the actual grid size. You may change
  224. the value by clicking in it and enter a new one (it has to be
  225. 10 or higher).
  226. The value in the Dash gadget may be changed as well, if you
  227. would like to have another one for the dashed lines/boxes. It
  228. will not have any consequences on LPE but on the LaTeXfile
  229. LPE creates.
  230.  
  231.  
  232. THE PROJECT MENU
  233.  
  234. You may use the following functions in the Project menu:
  235.  
  236. LOAD LPEFILE      loads a LPE file after asking if you know that
  237.                   everything in the actual picture will be deleted.
  238.                   Be sure that you have entered the file name in
  239.                   the upper large gadget called "File:" when you
  240.                   call this function. PLEASE DO NOT USE ANY
  241.                   SUFFIX, because LPE will do that automatically. All
  242.                   LPEfiles have the suffix ".lpe", the LaTeXtext
  243.                   ".tex". If loading is succesful, LPE will draw the
  244.                   picture.
  245.  
  246. SAVE AS LPEFILE   saves the actual picture as LPE file.
  247.                   File name is the text in the upper large gadget.
  248.  
  249. SAVE AS LATEXFILE saves the picture as an ASCII-file in a format
  250.                   that can be imported by LaTeX.
  251.                   The picture environment is scaled to 640x400
  252.                   with a unitlength of 0.2mm.
  253.                   You may change these values with a file monitor;
  254.                   it can be found as ASCII in the source.
  255.  
  256. ABOUT             what ? of whom ? when ?
  257.  
  258. QUIT              quits the program
  259.  
  260.  
  261. THE EDIT MENU
  262.  
  263. has the following items:
  264.  
  265. GRID              turns the Grid on/off
  266.                   The grid size may be changed in the Grid gadget.
  267.  
  268. CLEAR             deletes the drawing area and all objects
  269.  
  270. CENTER            gives you the chance the place a new origin in the
  271.                   drawing area.
  272.                   Any changes influence the coordinates of all
  273.                   objects you are working on.
  274.                   NOTE: the new center will not be saved with the
  275.                   objects!
  276.  
  277.  
  278.  
  279.  
  280.  
  281. CREDITS AND THANKS
  282.  
  283. Special thanks to:
  284.  
  285. - Commodore for this highly advanced computer
  286. - Manx for the Compiler and the terrific SDB
  287. - Fred Fish for this great AmigaLibDisks series
  288. - those of you who will test LPE and send me bug reports,
  289.   comments and lots of suggestions for future enhancements
  290.  
  291.  
  292.  
  293.  
  294. Have fun with LPE.
  295.  
  296. Suggestions, donations, insults and test results may be sent to
  297. the address above.
  298.  
  299.                                        -  Joerg  -
  300.                                        Nov 1, 1989
  301.