home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / pictures / iconed3a / ICONED3A.TXT < prev   
Text File  |  1994-08-03  |  10KB  |  301 lines
  1. ICONEDIT 3A V1.1c
  2.  
  3. Copyright 1994 Stephen Robertson
  4. 106 All Saints Road, Northfleet, Kent, DA11 8RN
  5.  
  6.  
  7. DISTRIBUTION
  8.  
  9. You may freely distribute ICONEDIT 3A providing that all copies are
  10. identical and all copies contain the above copyright notice.
  11.  
  12. ICONEDIT 3A MAY NOT BE SOLD OR DISTRIBUTED COMMERCIALLY IN ANY WAY
  13. WITHOUT THE AUTHOR'S WRITTEN PERMISSION.
  14.  
  15. Though this version of ICONEDIT 3A (v1.1c) is SHAREWARE, I (the
  16. author) require no payment for this version, but I reserve the right
  17. to charge for future updated versions, or to sell them commercially.
  18.  
  19.  
  20. COMMENTS
  21.  
  22. I've tested ICONEDIT 3A thoroughly, but it's quite likely that
  23. one or two bugs have slipped past me. If you find any then please
  24. let me know. 
  25.  
  26. Also, If you have any other comments regarding ICONEDIT 3A, such as
  27. ideas for new features, or improvments or even just to say that
  28. you like ICONEDIT 3A and use it a lot, then please contact me.
  29.  
  30. The more positive feedback I get, the more likely it is that I'll
  31. update ICONEDIT 3A, and include new features.
  32.  
  33. Contact me at the above address, or via PEPSIMAX @ CIX. I don't have a CIX
  34. account, but PEPSIMAX has kindly uploaded this for me.
  35.  
  36.  
  37. WHAT IS ICONEDIT 3A?
  38.  
  39. It's a utility written in OPL especially for the Psion Series 3a that
  40. allows you to create icons and other bitmaps for your own programs or
  41. for other utilities.
  42.  
  43. It has taken me three months to write, comprises approx. 35k of
  44. source code and was coded in its entireity on an unexpanded  512k
  45. Psion Series 3a.
  46.  
  47.  
  48. HOW DO I INSTALL IT?
  49.  
  50. * Copy the ICONED3A.OPA to the APP directory on any Psion drive.
  51.  
  52. * Make a directory in the same APP dir, called ICONED3A.
  53.  
  54. * Copy the two cursor bitmap files CURSOR-A.CRS and CURSOR-B.CRS into
  55.   the ICONED3A directory you just created.
  56.  
  57. * If you haven't got a PIC directory, then create one in the root
  58.   directory of each of the drives you wish to save icons to.
  59.  
  60. * Finally, select INSTALL from the FILE menu and select ICONED3A.OPA
  61.  
  62. The ICONEDIT 3A icon should then appear, with a file list below it if
  63. you already have a PIC directory and .PIC files. 
  64.  
  65.  
  66. HOW MUCH MEMORY DOES IT NEED?
  67.  
  68. The actual ICONEDIT 3A OPA takes up about 15k of space. When running
  69. ICONEDIT 3A uses about 40k of memory.
  70.  
  71.  
  72. WHAT TYPE OF FILES DOES IT USE?
  73.  
  74. It loads and saves 48x48 bitmaps with both a black an grey plane. The
  75. file extension it uses is .PIC, and these files are saved in a PIC
  76. directory in the root directory of A, B or the internal disk. 
  77.  
  78.  
  79. HOW DO I RUN ICONEDIT 3A?
  80.  
  81. ICONEDIT 3A runs, and uses files in exactly the same way as the other
  82. standard psion applications.
  83.  
  84. To run it select ICONEDIT 3A on the system screen, and press return.
  85.  
  86. If there are no .PIC files then ICONEDIT 3A will create one called
  87. ICONED3A.PIC when it is run.
  88.  
  89. If there are .PIC files then ICONEDIT 3A will display a list of them
  90. below its icon, and you may select one of these and press return to
  91. run the program and load the file.
  92.  
  93. If you wish to create a new PIC file, you may do so using the FILE
  94. menu on the system screen.
  95.  
  96.  
  97. SCREEN LAYOUT
  98.  
  99. The large window with a grid on the left of the screen is the EDIT
  100. window. This is a magnified version of the DRAW window which is
  101. displayed next to it.
  102.  
  103. Most drawing actions take place in the EDIT window, and are also
  104. displayed in the draw window simultaneously.
  105.  
  106. The UNDO window shows what picture would replace the one in the DRAW
  107. window, if the UNDO function were used.
  108.  
  109. The ICON status window which is on the right of the DRAW window shows
  110. the current cursor coordinates plus the current drawing shade and the
  111. drawing mode.
  112.  
  113. On the extreme right hand side of the screen is the application
  114. status window, as used by most Psion Series 3a applications.
  115.  
  116. The diamond list has three items, BLACK, GREY and ERASE. The item
  117. with the diamond character next to it is the shade that ICONEDIT 3A
  118. is currently drawing in. 
  119.  
  120.  
  121. HOW DO I USE ICONEDIT 3A?
  122.  
  123. To move the drawing cursor around the screen press the cursor keys.
  124. If you press SHIFT+cursor the cursor will skip to the next grid space
  125. (4 pixels). If you press PSION+cursor, then the cursor will jump to
  126. the edge of the icon, in the direction indicated by the cursor. If
  127. you move the cursor off the edge of the EDIT window it will appear on
  128. the opposite side.
  129.  
  130. To draw you have two methods: For continous drawing, hold down
  131. CONTROL and press the cursor keys. Wherever you move the cursor,
  132. pixels will be drawn. For fine work, use the TAB key, this draws
  133. singe pixels, and performs a toggle action - press once to set a
  134. pixel and again to clear it.
  135.  
  136.  
  137. MENUS
  138.  
  139. If you press the MENU button a menu will be displayed.
  140.  
  141. FILE MENU
  142.  
  143. NEW FILE - PSION+N
  144. Creates a new icon. The program will prompt you to confirm the new
  145. file if there are unsaved changes.
  146.  
  147. OPEN ICON - PSION+O
  148. Loads in a new icon. The program will prompt you to confirm the open
  149. if there are unsaved changes.
  150.  
  151. When the icon is loaded, the EDIT window is redrawn. With a
  152. complicated icon using black and grey shades this may take a few
  153. seconds.
  154.  
  155. SAVE - PSION+S
  156. Saves the current icon to the same file name.
  157.  
  158. SAVE AS - PSION+A
  159. Saves the current icon to a new file.
  160.  
  161.  
  162. MODE MENU
  163.  
  164. ICONEDIT 3A works in MODES. It starts off in DRAW MODE, where pixels
  165. may be drawn, but other drawing modes are selectable.
  166.  
  167. DRAW MODE - d or PSION+D
  168. In DRAW MODE you can draw single pixels in BLACK, GREY or WHITE
  169. (erase) using CONTROL+CURSOR for continuous drawing, or TAB for
  170. togglng single pixels. The shade used is shown in the status windows.
  171.  
  172. Draw mode is the default mode, and ICONEDIT 3A defaults to this after
  173. completing/aborting an action in any other mode.
  174.  
  175. LINE MODE - l or PSION+L
  176. This mode allows you to draw straight lines between any two points in
  177. any shade.
  178.  
  179. If you select this mode, then when you next move the cursor a "rubber
  180. band" line will be drawn between the start point and the cursor in the
  181. EDIT window.
  182.  
  183. If you change your mind and wish to stop DRAW mode, then pressing ESC
  184. will place you back in DRAW mode.
  185.  
  186. Pressing RETURN will cause a line to be plotted between the start
  187. position and cursor position on both the EDIT and DRAW windows.
  188.  
  189. BOX MODE - b or PSION+B
  190. This mode draws hollow boxes in any shade between two corner
  191. positions. Selecting this mode then moving the cursor causes a rubber band"
  192. box to be drawn between the original position and the cursor.
  193.  
  194. Pressing RETURN causes the box to be drawn in both the EDIT and DRAW windows.
  195. As in LINE mode, pressing ESC aborts the mode.
  196.  
  197. SOLID BOX MODE - B or SHIFT+PSION+B
  198. Exactly the same as BOX mode, except the boxes are filled with the
  199. current shade.
  200.  
  201. BORDER MODE - O or SHIFT+PSION+O
  202. This allows you to draw Series 3/3a style 3d borders, and works the
  203. same way as BOX mode, except that when RETURN is pressed a dialog
  204. will appear.
  205.  
  206. The dialog allows you to change the type of border drawn.
  207. Pressing RETURN will cause the border to be drawn in the DRAW WINDOW.
  208. The EDIT  window will be refreshed to show the new border.
  209.  
  210.  
  211. SPECIAL MENU
  212.  
  213. GRID ON/OFF - g or PSION+G
  214. Toggles the visible grid on/off. Turning the grid off causes a
  215. partial re-draw, and so may take a couple of seconds.
  216.  
  217. ERASE ICON - PSION+E
  218. Clears the EDIT and DRAW windows, thus erasing the current image. If
  219. there are unsaved changes you will be prompted to confirm it.
  220.  
  221. STORE TO UNDO
  222.  
  223. Copies the DRAW window to the UNDO window, so that you have a backup that
  224. you can restore using UNDO.
  225.  
  226. This is done automatically for you every time you draw a line, box,
  227. solid box or border, and when you erase the icon.
  228.  
  229. It's a good idea to do a STORE TO UNDO before doing any drawing in
  230. DRAW mode, as drawing pixels in this mode doesn't trigger a STORE TO
  231. UNDO.
  232.  
  233. UNDO - u or PSION+U
  234.  
  235. Copies the undo window to the draw window and redraws the EDIT window, thus
  236. undoing any changes since the last "STORE TO UNDO"
  237.  
  238. EXIT, LOSE CHANGES - SHIFT+PSION+X
  239.  
  240. Quits ICONEDIT3A without saving the icon. If there are any unsaved changes
  241. you will be asked to confirm this.
  242.  
  243. EXIT - PSION+X
  244. Quits ICONEDIT 3A, saving any changes.
  245.  
  246.