home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / pictures / picdraw1 / README.TXT < prev   
Text File  |  1993-01-12  |  11KB  |  227 lines
  1.             PicDraw v. 1.0
  2.     Freeware (c) 1993 by Luís Miguel Sequeira
  3.  
  4. Introduction
  5. ============
  6.  
  7. PicDraw is an application to create and modify .PIC files on the Psion 
  8. Series 3. It is designed primarily to create application icons, but it isn't 
  9. limited to 24 x 24 icons; you can create larger or smaller icons.
  10. It is not a generic drawing application, however; drawing lines and 
  11. geometrical figures, or filling areas with patterns is still beyond the scope 
  12. of the current version. However, you can copy, cut and paste areas of the 
  13. picture, and even merge other icons and add text in different fonts and 
  14. styles.
  15. Other features include adding and deleting rows and columns, zooming 
  16. parts of the picture for finer detail, and drawing modes and other special 
  17. effects.
  18.  
  19. Installation
  20. ============
  21.  
  22. You should have received a file named "picdraw1.zip". Decompress it 
  23. (with PKUNZIP) to get the following files:
  24.  
  25. copying        - The GNU General Public License, under which terms this 
  26.           software is distributed
  27. readme.rtf    - This file, in Rich Text Format
  28. readme.txt    - The same file, in plain ASCII text
  29. picdraw.opa    - The PicDraw application
  30. picdmod.opo    - A module loaded by PicDraw to enable the "zoom" 
  31.           feature
  32. *.opl        - The source files for PicDraw
  33. picdraw.pic    - The PicDraw application icon
  34.  
  35. To install, simply copy the files "picdraw.opa" and "picdmod.opo" to the 
  36. \APP directory on your Psion, and install the application pressing Psion-I 
  37. from the System menu.
  38. If you want, you can also copy the "picdraw.pic" to the \APP directory; 
  39. the PicDraw status window will show then this icon.
  40. All the other files aren't necessary; they are included only if you like to 
  41. change the source code for any reason.
  42.  
  43. Basics
  44. ======
  45.  
  46. Run PicDraw normally. If there are no .PIC files on your \OPD 
  47. directory, a new icon will be created, sizing 24 x 24 and centred on the 
  48. screen (you can change this later, if you wish). The icon will be shown at 
  49. its normal size. To the right appears a status window; it shows the 
  50. PicDraw icon (only if you've copied the "picdraw.pic" file to the \APP 
  51. directory - else you'll just get the application name), the name of the 
  52. current .PIC file, the cursor position, and the current drawing mode 
  53. (initially "Move").
  54. A small blinking dot is the "cursor"; it shows the current position. 
  55. Cursor keys move it around as expected. If you press Control with the 
  56. cursor keys, the cursor moves in steps of four. It also wraps around at the 
  57. borders. If you press Psion with the cursor keys, it moves to one of the 
  58. borders.
  59. To set pixels, press Space; to clear them, use Delete. Pressing Tab 
  60. inverts the pixel, that is, it becomes black if it was white, and vice-versa.
  61. All these keys are available in all modes.
  62. To save your work, select "Save" from the "File" menu; to quit, select 
  63. "Quit". Note that quitting does not save the current icon!
  64. Pressing "Help" gives you a short description of many commands (but 
  65. unfortunately, not all of them).
  66.  
  67. Drawing modes
  68. =============
  69.  
  70. PicDraw starts on the "Move" mode. This means that you can move 
  71. freely the cursor around, without affecting the current picture.
  72. If you press Enter, or select "Draw" from the menu, the cursor sets 
  73. pixels each time you move (pressing Enter again, or selecting "Move" from 
  74. the menu, returns again to the "Move" mode). Similarly, pressing Esc or 
  75. selecting "Clear" from the menu, the cursor resets pixels while moving (i. 
  76. e., draws white lines). If you select "Invert" from the menu, pixels are 
  77. inverted as the cursor moves (white turns black and vice-versa).
  78. The keys Space, Delete and Tab have always the same meaning, 
  79. independently from the current drawing mode.
  80. Also note that the mode also affects the way how copy & paste works, or 
  81. how icons are merged with the current picture.
  82.  
  83. Region commands - copying selected areas
  84. ========================================
  85.  
  86. If you select "Copy" or "Cut", PicDraw enters the "Select" mode. The 
  87. current cursor position is the top left corner of the selected area; move it to 
  88. the bottom right of the area you wish to select and press Enter. 
  89. Unfortunately, there are no rubber-band rectangles which show the 
  90. current selected area (this may change in future versions).
  91. Selecting "Paste" will copy the currently selected area to the cursor 
  92. position. You can paste many copies (until you select a new area) if you 
  93. wish; this can be useful to create patterns, etc.
  94. Note that the drawing mode has an effect on the way regions are 
  95. copied. If the mode is "Move", black & white pixels are copied (i. e., 
  96. overwriting everything beneath). With "Draw" mode, only the black pixels 
  97. are copied (that is, you can "merge" pictures). "Clear" mode clears what 
  98. was set with black pixels on the original; and "Invert" mode inverts black 
  99. and white pictures. This can be used for some special effects; normally, 
  100. you'll use "Move" or "Draw" modes only.
  101. "Cut" also affects the original area. With "Move" mode only, the area is 
  102. simply cleared; other modes set or clear the original area according to the 
  103. mode (this isn't probably very useful; however, if you want to invert a 
  104. large block, select it with "Cut", get into "Invert" mode and paste it on the 
  105. bottom right corner - the selected area will be inverted!).
  106. "Merge Icon" can be used to merge icons and pictures stored on other 
  107. files with the current picture. Unlike "Paste", the icon merged isn't 
  108. "remembered"; you'll have to reselect in again from the file dialog that 
  109. appears. If you want to merge a lot of copies, merge once, then select it 
  110. and use paste to get the desired number of copies.
  111.  
  112. Scrolling
  113. =========
  114.  
  115. This menu gives the choice of scrolling the picture one pixel in the 
  116. selected direction. It takes effect from the current cursor position only. 
  117. Thus, "Insert Row" moves everything down, "Insert Column" scrolls right, 
  118. "Delete Row" scrolls up and "Delete Column" moves everything to the left.
  119. New rows or columns are inserted as necessary (and they are initially 
  120. blank); you cannot retrieve "lost" rows or columns which have been 
  121. scrolled away. They are lost.
  122.  
  123. Inserting text
  124. ==============
  125.  
  126. If you choose "Add text..." from the menu, you are prompted with a 
  127. dialog box. The first line is for you to type your text; next is a font selector 
  128. (just the common three fonts available normally on your Psion: normal, 
  129. bold or small).
  130. You can add one style, too, i. e., specefying italics or underline, etc.
  131. Finally, there is the mode of inserting text on the picture: normally this 
  132. is "Replace", which puts the text surrounded with white pixels (so the text 
  133. will always be readable). If you choose "Set", only the black pixels will be 
  134. set; "Clear" displays text pixels as white (useful to write text on black 
  135. backgrounds); and "Invert" merges the text with the background, 
  136. inverting pixels in the process.
  137. At the moment, you cannot combine styles; thus, you cannot get italics 
  138. and underlined text simultaneously.
  139.  
  140. Changing the settings
  141. =====================
  142.  
  143. Normally, the picture will be 24 x 24 pixels large, and centred on the 
  144. screen. You can change this by selecting "Change settings..." from the 
  145. menu. New sizes will take effect immediately, with the picture appearing 
  146. at the (new) top left corner. You can also place the drawing area at the top 
  147. left corner of the screen instead of centring it; this is useful on the "zoom" 
  148. mode explained below.
  149. Settings are not saved between sessions.
  150.  
  151. Zoom mode
  152. =========
  153.  
  154. Selecting "Zoom" from the menu or pressing Psion-Z puts you on the 
  155. "zoom" mode. This displays a 24 x 24 blowup, starting from the current 
  156. cursor position. The cursor keys, Space, Delete, Tab, Enter, Esc and Psion-
  157. I work as expected, doing exactly the same as on the "small" picture. 
  158. Drawing is done on both pictures at the same time; you may wish to 
  159. position the "small" picture at the top left corner to observe the effect.
  160. Note that no other function is available on "zoom" mode; also, the 
  161. blownup picture will not scroll if you reach its edges; instead, the cursor 
  162. will just wrap around. You must