home *** CD-ROM | disk | FTP | other *** search
/ Chestnut's Multimedia Mania / MM_MANIA.ISO / slide / leo / leo.doc < prev    next >
Text File  |  1985-11-12  |  19KB  |  420 lines
  1. LEONARDO Graphics Assistant 
  2.  
  3.      Leonardo is a full featured graphics editor for the IBM-PC and 
  4. compatible.  Leo is designed to make efficient use of the keyboard 
  5. so that a mouse is not required.  The products of Leonardo are 4 
  6. color graphics screens and screen and Icon files.  Leo's artworks 
  7. can be easily used in BASIC programs.  Now all your BASIC programs 
  8. can benefit from the impact of full color graphics. 
  9.      Leonardo also has a built-in slide show feature that can be 
  10. used to produce colorful and informative presentations. 
  11.  
  12. Getting Started:
  13.  
  14.      To start the program insert the disk in the current default 
  15. disk drive and type "leonardo" and hit return.  The program will 
  16. first look on the disk for a slide show script called "start.sho". 
  17. If Start.sho exists it will be loaded and run. Otherwise leo will 
  18. display an error message.  If you get an error message don't worry, 
  19. just hit any key and the message will go away. You may stop the 
  20. slide show at any time by pressing the ESC key.
  21.      You're now ready to create pictures.  On the screen you will 
  22. see a small arrow.  This is the Pen.  You will also find a small 
  23. plus sign.  This is called the Mark.  You can move the pen around 
  24. the screen with the cursor control keys located on the number-pad 
  25. area of the keyboard.  All 8 direction keys are active (up, down, 
  26. left, right, and the 4 diagonals).  Only the pen moves, the mark is 
  27. stationary.  While you can't move the mark directly you can do two 
  28. things with it.  You may swap the pen and mark with the ESC key, and 
  29. you cam move the mark to the pen's location with the INS key.
  30.      To draw lines with the pen first select a color using the 
  31. numbers 0 thru 3 (0 is the background color).  To turn-on the pen 
  32. hit the ENTER key.  Now wherever you move the pen it draws a line. 
  33. To change colors just type the number of the color you want.  To 
  34. turn the pen off hit ENTER again.
  35.      In addition to the Pen and Mark there are 3 other graphics 
  36. cursors available, the Box, the Alpha cursor and the User cursor.  
  37. To select a different cursor hit the backspace key (BKSP).  Hit 
  38. backspace once and you will have the Box.  The Box works the same 
  39. way as the pen but it draws a wide line.  The Box is useful for 
  40. erasing also.  Hit BKSP again and you will have the Alpha cursor.  
  41. Now any letter key you press will be displayed on the screen in the 
  42. current text style, color and size. 
  43.      When you are using a cursor other than the alpha cursor, typing 
  44. a letter on the keyboard will access one of Leonardo's many commands.  
  45. The meaning and uses of the commands are described on the pages 
  46. that follow.
  47.  
  48. Keyboard Layout Overview: 
  49.  
  50. ┌──────┐  ┌──────────────────────────────┬──────┐ ┌───────────────────┐ 
  51. │      │  │  Numbers 0-4 select color    │<-BKSP│<│--Change cursor    │ 
  52. │ Icon │  └──────────────────────────────┴──────┘ │                   │ 
  53. │      │  ┌────────────────────────────────┬────┐ │                   │ 
  54. │ GET  │  │                                │Entr│ │  \   ^   /        │ 
  55. │      │  │   Use letters to               │line│ │   Cursor          │ 
  56. │ PUT  │  │   envoke commands              │mode│ │  <-     ->        │ 
  57. │      │  │                                │ on │ │   Control         │ 
  58. │      │  │                                └────┤ │  /   v   \        │ 
  59. │      │  └─────────────────────────────────────┘ │            draw   │ 
  60. ├──────┤    ┌───────────────────────────────┐     │ Pen-mark   line   │ 
  61. │ UNDO │    │ Space= put down dot           │     └───────────────────┘ 
  62. └──────┘    └───────────────────────────────┘ 
  63.  
  64.  
  65. Alpha Mode 
  66.  
  67.      Alpha mode is entered by selecting the alpha cursor using the 
  68. backspace key [<-]. In alpha mode, letters will be displayed on the 
  69. screen as they are typed. To enter a command, you must first leave alpha 
  70. mode by selecting another cursor (again using the backspace key).  You 
  71. may select the size, color and style of the characters by using the "a" 
  72. command. 
  73.  
  74.  
  75. Block commands: 
  76.  
  77.      Many of the commands in leonardo work on blocks of the screen.  The 
  78. block is the area bounded by the two cursors, the pen and the mark. To 
  79. use the block command first specify the area of the screen affected by 
  80. placing the pointer and mark in opposite corners.  Then invoke the 
  81. command by typing it's letter. 
  82.  
  83.        '\  = pen     -|-   = mark 
  84.  
  85.              Block Commands: 
  86.              c - Circle
  87.              d - Shadow
  88.              m - Mottle
  89.              x - eXchange colors
  90.              q - sQuare
  91.              o - Outline
  92.              r - Reverse image 
  93.  
  94. Icon capture is also determined by the block location. 
  95.  
  96.  
  97. Help Screen 
  98.  
  99.      Two HELP facilities are provided for your convenience.  The "h" 
  100. command displays several windows of information suitable for quick 
  101. reference.  There is also a help screen on the disk which may be loaded 
  102. using the "l", load command.  CAUTION: loading the help screen over- 
  103. writes the current display. You may save your display with the F9 key 
  104. before you load HELP.SCR. and then restore your display with F10 after 
  105. you have referred to the help information. 
  106.  
  107. Icons 
  108.  
  109.      Icons are small areas or blocks of the screen which may be capt- 
  110. ured and moved around on the screen.  The 10 function keys control the 
  111. capture, display and storage of icons. The area of the screen to be 
  112. remembered as an icon is boxed by placing the pen and mark at opposite 
  113. corners of the block. Then press F1.  This GETS icon 1.  Whatever was in 
  114. the block is now remembered in icon 1.  To display icon 1 on the screen 
  115. hit F2.  F2 PUTS icon 1 on the screen.  If you put an icon on top of 
  116. itself it disappears.  This is because icons are displayed in an 
  117. exclusive OR logical operation (this may be changed using the "i" 
  118. command). 
  119.     Using Icons you may move objects around the screen.  First GET the 
  120. icon.  Then PUT the icon on top of itself, making it disappear.  Now 
  121. move to a new location and PUT the icon again. You have just moved an 
  122. object. 
  123.     Not all the icons are the same size.  F1 gets an icon up to 1/4 of 
  124. the screen in size. F3 gets an icon up to 1/8 of the screen while F5 and 
  125. F7 get icons up to 1/16 and 1/32 of a screen respectively.  This saves 
  126. on disk space when the icon is saved to disk. F9 and F10 have a special 
  127. use (see the UNDO command). 
  128.     Icons may be saved to disk and recalled later.  This is done by 
  129. holding the ALT key and pressing F1 to load an icon (alternate get 
  130. source=disk). Similarly ALT-F2 "PUTS" the icon to the disk. ALT F3...F10 
  131. work the same way. 
  132.  
  133. Function Keys - Icon control
  134.  
  135. f1-f2        Get, put ICON1   4Kb 
  136. f3-f4        Get, put ICON2   2Kb 
  137. f5-f6        Get, put ICON3   1Kb 
  138. f7-f8        Get, put ICON4   500 bytes 
  139. f9-f10       Get, put ICON5   Whole screen 
  140.  
  141. ALT Function keys: Icon storage 
  142.  
  143. ALT f1       Load ICON1 from disk 
  144. ALT f2       Save ICON1 to disk 
  145. ALT f3-f4    Load, save ICON2 
  146. ALT f5-f6    Load, save ICON3 
  147. ALT f7-f8    Load, save ICON4 
  148. ALT f9-f10   Load, save ICON5 
  149.  
  150.  
  151. Patterns - mixing paints.
  152.  
  153.      The zoom editor does double duty as the pattern maker.  You may 
  154. edit a pattern in the pattern memory without affecting the screen with 
  155. the "e", Edit command.  You may repeat your pattern over an area of the 
  156. screen with the pattern option of the Mottle, "m", command.  To do this 
  157. first put your pattern in pattern memory with either the "z", Zoom or 
  158. "e", Edit commands.  Next mark the area you want to pattern by placing 
  159. the pen and mark in opposite corners of the block.  Next hit "m" for the 
  160. mottle command.  Choose the "p", pattern option.  The pattern may be put 
  161. over everything or just over a certain color, it's your choice. 
  162.  
  163.  
  164. Reverse image 
  165.  
  166.     You may reverse an image, i.e. make a mirror image of something with 
  167. the "r" command.  You may reverse it in the up/down or left/right 
  168. direction. This is a block command so you will have to specify the area 
  169. that you want to reverse by placing the pen and mark in opposite corners 
  170. of the block. Hit "r" and answer the prompt as to up/down or left/right. 
  171. Whatever was in the block will then be inverted. 
  172.  
  173.  
  174. Slide Shows 
  175.  
  176.      Leonardo provides a built in slide show capability with the "t" 
  177. (scripT) command. In the script window you may "a" Add or "d" Delete 
  178. items from the script.  You may also save your completed script with the 
  179. "s" command and load it later with "l". 
  180.      To write a script you simply add items (screens or icons) to the 
  181. script. Enter the name of the screen or icon, its location (not neces- 
  182. sary for screens) and the pause time in seconds.  Optionally, "k" may be 
  183. entered for the pause time in which case the computer will wait for a 
  184. key to be hit. 
  185.      When leonardo first starts it will look on the disk for a script 
  186. called "start.sho".  If "start.sho" is present it will be loaded and 
  187. run. 
  188.  
  189.  
  190. UNDO - Recovering from mistakes. 
  191.  
  192.      A convenient UNDO facility is provided in two parts.  First, 
  193. function key F9 remembers the current display screen.  Later, F10 will 
  194. restore the screen to the way it was remembered by the F9 command. 
  195.  
  196.  
  197. User cursor - make your own.
  198.  
  199.     Leonardo provides several types of graphics cursors: a pen for fine 
  200. lines, a box for erasing and fat lines, and the alpha cursor for 
  201. letters.  There is one other cursor that you may use.  It is called the 
  202. user cursor because you get to design it yourself with the "u" command.  
  203. It can be any size from 2X2 to 15X15 and it is created the same way you 
  204. make patterns, with the "zoom" editor.  When you are using the user 
  205. cursor the color that you specify (by typing a number key) affects the 
  206. mode in which the user cursor image is put on the screen.  You'll just 
  207. have to experiment with it a little. 
  208.  
  209.  
  210. Window - work space
  211.  
  212.     The "w" command opens a window about 1/4 of the screen in size. You 
  213. may work in the window without disturbing the screen.  Pressing "w" 
  214. again closes the window and returns the screen to the way it was.  This 
  215. is convenient for trying things when you don't want to mess up your 
  216. picture. 
  217.  
  218.  
  219. ZOOM - pixel editor 
  220.  
  221.     The Zoom command, "z", allows you to enlarge a portion of the screen 
  222. for fine detail editing.  Place the pen in the upper left corner of the 
  223. area you wish to expand and hit "z".  That area of the screen will be 
  224. enlarged.  Now you may use the cursor keys to move the pointer around 
  225. the enlarged view.  To change the color of a pixel just hit the number 
  226. of the color you want.  Hit [enter] when you are done and the changes 
  227. you made will be put on the screen. The size of the zoom frame can be 
  228. varied from 2X2 to 15X15 with the "Z" command. 
  229.  
  230.  
  231. Interfacing to BASIC 
  232.  
  233.    The screen files and icon files produced by Leonardo are easily 
  234. incorporated into your own BASIC programs. Remember, you must be in 
  235. color graphics mode (SCREEN 1). 
  236.  
  237.     Screen Files: 
  238.                   Screen files are usually saved by Leonardo with an 
  239.                SCR extension added to the file name. Screen files are 
  240.                stored as the memory image of the IBM display memory. 
  241.                Display memory starts at address B800 hex.  To load 
  242.                a screen file use the following subroutine: 
  243.  
  244.                     10  SCREEN 1
  245.                     100 ' Screen Load Subroutine 
  246.                     110 DEF SEG=&HB800 
  247.                     120 BLOAD "fname.scr",0 
  248.  
  249.    Icon Files: 
  250.                 Icon files are saved with an .LEO extension. Icons 
  251.              can be used with the BASIC GET and PUT commands to 
  252.              produce animation. Icon data is loaded into single 
  253.              precision arrays. Since the Icons come in several 
  254.              different sizes you should dimension your array just 
  255.              large enough to hold the icon. 
  256.  
  257.                     100 ' Subroutine to Load and Display Icon 
  258.                     110 dim I(1000)            ' large icon, 1/4 screen 
  259.                     120 bload "file.leo",varptr(I(0))  ' load icon 
  260.                     130 put (50,70),I          ' display icon
  261.  
  262.              The following program segment demonstrates how icons may 
  263.              be moved smoothly to produce animation. The idea is to 
  264.              first PUT the icon to the screen, then wait a short time 
  265.              so the viewer can see the picture (you may calculate the 
  266.              new position during this time).  When you are ready to 
  267.              move the icon first PUT it again it the old location (this 
  268.              erases the first image of the icon) then PUT it to the new 
  269.              location.  After a short pause repeat the process.
  270.  
  271.  
  272.                    150 put (x,y),I             ' Display the image 
  273.                    160 xx=x : yy=y             ' remember old location
  274.                    170 x=x+1 : y=y+1           ' Calculate new position
  275.                    180 PUT (xx,yy),i           ' erase old image
  276.                    190 goto 150                ' repeat process
  277.  
  278. Appendix A:          Command Summary
  279.  
  280. Commands: 
  281.  
  282. 1           Select color 1
  283. 2           Select color 2
  284. 3           Select color 3
  285. 4,0         Select color 0
  286.             In all cases the keys 4 and 0 may be used 
  287.             interchangeably when referring to colors. 
  288. a           Alpha settings 
  289.             You may set the color, size and style of type. 
  290. b           Background color 
  291.             Select one of 16 colors for the background. 
  292. c           Circle 
  293.             The circle will be drawn in the current color.  It will 
  294.             be centered about the pen.  The size and shape of the 
  295.             circle or ellipse is determined by the positions of the 
  296.             pen and marker.
  297. C           Clear the screen.
  298. d           Shadow
  299.             When prompted you supply the shadow color, the object 
  300.             color and the direction in which the shadow is cast. 
  301. e           Edit zoom pattern 
  302.             You may change the pattern in memory without affecting 
  303.             the screen.  This can be used to make a pattern which can 
  304.             then be put-down using the Mottle command. 
  305. f           Toggle fast cursor (5<->1)
  306.             If the cursor speed is slow (<5) then this command 
  307.             will increase it to 5.  If the cursor speed is fast (>=5) 
  308.             then it will return the speed to 1.
  309. h,?         Help windows
  310.             Opens a window on the screen which contains a quick 
  311.             reference to the commands.  Hit any key to get the next 
  312.             window.  There are 8 windows in all.  Hit BKSP to see the 
  313.             previous window. 
  314. m           Mottel (pattern over color)
  315.             Use this command to add texture to solid color areas.  
  316.             Select a pattern by pressing the space bar to view your 
  317.             choices of pattern types.  Hit ENTER to indicate your 
  318.             choice.  You will be prompted for the pattern color and 
  319.             the color over which the pattern is to be put.  One option 
  320.             is to select the zoom pattern as the pattern color by 
  321.             selecting "p" when asked for the pattern color. 
  322. o           Outline
  323.             You may outline one color with any other color. 
  324. p           Paint 
  325.             You will be prompted for the boarder color and the 
  326.             paint color.  The area contiguous with the pen and bounded 
  327.             by the boarder will be filled with the paint color. 
  328. P           Palette
  329.             The palette is the color set in use. There are 2 
  330.             Palettes available.  Palette 1: Cyan, Magenta, White  
  331.             Palette 2: Brown, Red, Yellow.  Any background color may 
  332.             be used with either palette. 
  333. q           Square 
  334.             Draws a square defined by the pen and mark in the 
  335.             current color.
  336. r           Reverse image
  337.             Reverse the image bounded by the block either left- 
  338.             right or up-down.
  339. s           Save the screen 
  340.             Saves the current screen to the disk as a 16K file. 
  341. T           Begin slide show 
  342.             Starts the show currently in memory 
  343. t           Write slide show 
  344.             Opens the slide show editing window.  You may edit the 
  345.             script of the show using the subcommands below:
  346.                       a - Add item to script
  347.                       d - Delete an item from script
  348.                       l - Load a script from disk
  349.                       s - Save a script to disk
  350.                 up-curs - view previous item
  351.                 dn-curs - view last item
  352. u           User cursor 
  353.             You may use or edit the USER cursor.  The USER cursor 
  354.             is a graphics cursor that you can define to be any color 
  355.             or shape that you want.  You may use it for drawing also.
  356. w           Open window 
  357.             The window is an area about 1/4 of the screen in size 
  358.             that you can work in without affecting the screen.  Hit 
  359.             "w" once to open the window; hit it again to close the 
  360.             window.
  361. x           Exchange colors
  362.             Exchange one color for another inside the block. 
  363. Z           Change zoom pattern size 
  364.             Sizes from 2x2 to 15x15 are allowed. 
  365. z           Zoom 
  366.             Expands the area defined by the zoom size and having 
  367.             the pen pointing to the upper left corner.  You may edit 
  368.             the image pixel by pixel using the cursor control keys and 
  369.             the numbers 0-4 for the colors.  When ENTER is pressed the 
  370.             edited image is put on the screen.
  371. &           Status 
  372.             Provides the x and y cursor location and current color. 
  373. *           Line alpha mode 
  374.             Type characters in normal IBM 40 column mode until the 
  375.             next carriage return. 
  376. +           Increase cursor speed
  377.             Increases cursor speed by 1 unit.
  378. -           Decrease cursor speed 
  379.             Decreases cursor speed by 1 unit.   
  380.  
  381. Appendix B:   Keyboard Controls 
  382.  
  383. Cursor Control Group 
  384.  
  385. ^ v <- ->    Move Cursor 
  386. <ENTER>      Toggle draw mode 
  387. <--(BKSP)    Select cursor type 
  388. ESC          Exchange pointer and mark 
  389. INS          Bring marker to pointer 
  390. DEL          Draw line in current color 
  391. SPACE        Draw dot in current color 
  392.  
  393.  
  394. Function Keys 
  395. f1-f2    Get, put ICON1   4Kb 
  396. f3-f4    Get, put ICON2   2Kb 
  397. f5-f6    Get, put ICON3   1Kb 
  398. f7-f8    Get, put ICON4   500 bytes 
  399. f9-f10   Get, put ICON5   Whole screen 
  400.  
  401. ALT Function keys: Icon storage 
  402.  
  403. ALT f1       Load ICON1 from disk 
  404. ALT f2       Save ICON1 to disk 
  405. ALT f3-f4    Load, save ICON2 
  406. ALT f5-f6    Load, save ICON3 
  407. ALT f7-f8    Load, save ICON4 
  408. ALT f9-f10   Load, save ICON5 
  409.  
  410.  
  411. ICON#      MAX SIZE         BYTES
  412. ----------------------------------------- 
  413.   1      1/4 screen         4000 
  414.   2      1/8 screen         2000
  415.   3      1/16 screen        1000
  416.   4      1/32 screen         500
  417.   5      whole screen      16000
  418.  
  419.  
  420.