home *** CD-ROM | disk | FTP | other *** search
/ Personal Computing Magazine 1990 January / JAN_1990 / PIX / PIX.DOC next >
Encoding:
Text File  |  1990-01-01  |  18.8 KB  |  243 lines

  1. ┌──────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                              │
  3. │                          PIX A Computer Art Package                          │
  4. │                          ──────────────────────────                          │
  5. │                                                                              │
  6. │                for IBM PCs or Compatibles (Dos 2.0 or above)                 │
  7. │                           using CGA display format                           │
  8. │                  (Microsoft Compatible Mouse Also Required)                  │
  9. │          NOTE! Amstrad PC1512 and PC1640 mice probably won't work.           │
  10. │            Coded By Andrew T Gisby (Perfect Pixel Software 1989)             │
  11. │                                                                              │
  12. │    PLEASE ENSURE YOUR MOUSE IS PLUGGED IN & YOUR MOUSE DRIVER INSTALLED!     │
  13. │                                                                              │
  14. │                                                                              │
  15. │ To run this program form outside the PC menu system type:                    │
  16. │                                                                              │
  17. │    CD\PIX                                                                    │
  18. │    PIX                                                                       │
  19. │                                                                              │
  20. │ A command line can also be  entered.  This  command  line is the name of the │
  21. │ picture you wish to immediately edit. For example:                           │
  22. │                                                                              │
  23. │    CD\PIX                                                                    │
  24. │    PIX PIX.PIX                                                               │
  25. │                                                                              │
  26. │ From time to time you may find that the program traps an error (and stops!). │
  27. │ These errors should not be fatal, and  are  usually due to memory or drawing │
  28. │ parameter restrictions. If an error does  occur,  all  is not lost! Once the │
  29. │ standard error message has been  displayed,  the  program  should be able to │
  30. │ resume from your last edit.)                                                 │
  31. │                                                                              │
  32. │                                                                              │
  33. │ CONTROLS:-                                                                   │
  34. │                                                                              │
  35. │ PIX is almost entirely mouse  controlled.  The  only  other control keys you │
  36. │ need worry about are...                                                      │
  37. │                                                                              │
  38. │    [Esc]        - Quit the PIX program.                                      │
  39. │    [C] or [c]   - Clear the Work Screen.                                     │
  40. │    [U] or [U]   - Undo function just used.                                   │
  41. │                                                                              │
  42. │ To move the cross haired sight, simply move the mouse!                       │
  43. │                                                                              │
  44. │ The [Left] mouse button always activates the selected drawing function.      │
  45. │                                                                              │
  46. │ The [Right] mouse button will activate the function menu when in work screen │
  47. │ mode, or exit any function  that  operates  outside the workscreen (ie Pixel │
  48. │ Edit).                                                                       │
  49. │                                                                              │
  50. │ The  functions available on the menu are..                                   │
  51. │                                                                              │
  52. │  1.     Box                                                                  │
  53. │  2.     Filled Box                                                           │
  54. │  3.     Line                                                                 │
  55. │  4.     Horizontal Line                                                      │
  56. │  5.     Airbrush                                                             │
  57. │  6.     Free-Hand Draw                                                       │
  58. │  7.     CUT Blit (BLK)                                                       │
  59. │  8.     COPY Blit (OR)                                                       │
  60. │  9.     Circle                                                               │
  61. │ 10.     Filled Circle                                                        │
  62. │ 11.     Vertical Line                                                        │
  63. │ 12.     Text                                                                 │
  64. │ 13.     Adjust Size & Flow parameter                                         │
  65. │ 14.     Colour Fill                                                          │
  66. │ 15.     Tile Fill                                                            │
  67. │ 16.     Edit Tile                                                            │
  68. │ 17.     Hair-Line Draw                                                       │
  69. │ 18.     Pixel Edit                                                           │
  70. │ 19.     Load                                                                 │
  71. │ 20.     Save                                                                 │
  72. │                                                                              │
  73. │ Selecting a Function from the menu...                                        │
  74. │                                                                              │
  75. │ Press the [Right] mouse button & keep it de-pressed. The menu should now pop │
  76. │ up on the right hand  side  of  the  screen.  To  select an option, Keep the │
  77. │ [Right] button pressed & move the mouse Up & Down - A box cursor should also │
  78. │ move relative to the mouse. Also displayed  at  the  top of the menu are two │
  79. │ colour palette boxes (one for  black  the  other  for white!). To select the │
  80. │ colour your require, move the mouse Left & Right.                            │
  81. │                                                                              │
  82. │ 1. Box                                                                       │
  83. │                                                                              │
  84. │ This is a workscreen option. To draw a  box, move the cursor to the required │
  85. │ part of the screen & press the [Left]  mouse button - Keeping the Left mouse │
  86. │ button pressed, move the mouse  and  draw  your  box!  When the [Left] mouse │
  87. │ button is released, the box is placed onto your picture.                     │
  88. │                                                                              │
  89. │ 2. Filled Box                                                                │
  90. │                                                                              │
  91. │ See above - This function operates the identically to function 1. Box        │
  92. │                                                                              │
  93. │ 3. Line                                                                      │
  94. │                                                                              │
  95. │ See above - This function operates in the same way as Function 1. Box except │
  96. │ a straight line is drawn.                                                    │
  97. │                                                                              │
  98. │ 4. Horizontal Line                                                           │
  99. │                                                                              │
  100. │ See above - This function is used in  the same way as function 1. Box except │
  101. │ the line drawn will remain horizontal  to  the  place where the [Left] mouse │
  102. │ button was first pressed!                                                    │
  103. │                                                                              │
  104. │ 5. Airbrush (See Also 13. Adjust Size & Flow)                                │
  105. │                                                                              │
  106. │ When the [Left] mouse button is pressed  random dots are "sprayed" under the │
  107. │ cross-haired cursor. The range (size) & flow  of the airbrush is governed by │
  108. │ function 13.                                                                 │
  109. │                                                                              │
  110. │ 6. Free Hand Draw (See Also 13. Adjust Size)                                 │
  111. │                                                                              │
  112. │ When the [Left] mouse button is  pressed,  a  solid block is drawn under the │
  113. │ cross-haired cursor. The Size of this  block  is governed by the Size option │
  114. │ of function 13.                                                              │
  115. │                                                                              │
  116. │ 7. CUT Blit (BLK)                                                            │
  117. │                                                                              │
  118. │ Keeping the [Left] mouse button pressed, draw  a  box around the area of the │
  119. │ screen you wish to Cut away. When  the mouse button is released, the section │
  120. │ of screen specified, is instantly  cut  away.  Once  cut,  you can move this │
  121. │ block to any other part of the  work  screen & press the [Left] mouse button │
  122. │ to place or "paste" the block.  Pressing  the [Right] mouse button will exit │
  123. │ the block paste section.                                                     │
  124. │                                                                              │
  125. │ 8. COPY Blit (OR)                                                            │
  126. │                                                                              │
  127. │ See above - This function operates exactly the same way as function 7 except │
  128. │ that the area of screen is copied rather than being cut away!                │
  129. │                                                                              │
  130. │ ** WARNING ** - Due to  memory  restrictions  of PC's, pasting up large Blit │
  131. │ blocks (eg. a whole screen) will cause an error. Don't worry if this occurs. │
  132. │ The program will resume back to picture without trashing all your hard work! │
  133. │                                                                              │
  134. │ 9. Circle                                                                    │
  135. │                                                                              │
  136. │ With the [Left] mouse  button  pressed,  move  the  mouse  left  or right to │
  137. │ decrease & increase the radius of  the circle respectively. When sizing your │
  138. │ picture, a window is drawn  with  the  circle  to  aid sizing! releasing the │
  139. │ [Left] mouse button will place the circle onto the screen.                   │
  140. │                                                                              │
  141. │ 10. Filled Circle                                                            │
  142. │                                                                              │
  143. │ As above (See Function 9. for operation)                                     │
  144. │                                                                              │
  145. │ 11. Vertical Line                                                            │
  146. │                                                                              │
  147. │ As above (See Function 11. for operation)                                    │
  148. │                                                                              │
  149. │ 12. Text (See also Function 13. Adjust Size)                                 │
  150. │                                                                              │
  151. │ Using this option, the user can place text at variable size any where on the │
  152. │ work screen. Please note,  that  the  size  of  the  text is specified using │
  153. │ function 13. To place text onto  the  screen,  move  the cursor to where you │
  154. │ wish the text to appear. Press the [Left] mouse Button once! You will now be │
  155. │ asked (See top of screen) for the  text  you wish to use. After pressing the │
  156. │ [Return] key, you will be prompted  Italics  [Y]  or [N]. After pressing the │
  157. │ 'Y' or 'N'  keys,  the  text  will  be  painted  onto  the  work area at the │
  158. │ position where you click the left mouse button!                              │
  159. │                                                                              │
  160. │ 13. Adjust Size & Flow                                                       │
  161. │                                                                              │
  162. │ After pressing the [Left] mouse button & keeping the button pressed, two bar │
  163. │ scales are displayed. One labelled size,  the other labelled Flow. To adjust │
  164. │ the size bar, keep the left mouse button pressed & move the mouse Up or Down │
  165. │ (Big or Small). To adjust the  flow,  keep  the  left mouse button pressed & │
  166. │ move the mouse Left or Right  (Low  and  High). These parameters are used by │
  167. │ other options.                                                               │
  168. │                                                                              │
  169. │ 14. Colour Fill                                                              │
  170. │                                                                              │
  171. │ This will flood and area of the  screen  with the current colour setting. To │
  172. │ use, simply press the [Left] mouse button.                                   │
  173. │                                                                              │
  174. │ 15. Tile File                                                                │
  175. │                                                                              │
  176. │ This allows a user definable Tile to  be  used  as the fill medium. See also │
  177. │ Function 15. Pressing the [Left] mouse button will initiate the fill!        │
  178. │                                                                              │
  179. │ 16. Edit Tile                                                                │
  180. │                                                                              │
  181. │ After pressing the [Left] mouse  button,  the  screen  is  cleared, & an 8x8 │
  182. │ matrix grid is displayed. Using the cursor, move over the square of the grid │
  183. │ you wish to change & press the  {left]  mouse button. The square will change │
  184. │ black if previously  white,  or  white  if  previously  black!  Pressing the │
  185. │ [Right] mouse button exits the tile edit & re-displays your current picture. │
  186. │                                                                              │
  187. │ 17. Hair-Line Draw                                                           │
  188. │                                                                              │
  189. │ This Option should be used in  exactly  the  same  way as option 6. The only │
  190. │ difference here is the fact that a hairline is only 1 pixel thick & the line │
  191. │ is continuous.                                                               │
  192. │                                                                              │
  193. │ 18. Pixel Edit.                                                              │
  194. │                                                                              │
  195. │ Keeping the [Left] mouse button pressed, draw  a  box around the area of the │
  196. │ screen you wish to edit. When the  mouse  button is released, the section of │
  197. │ screen specified, is scaled and redisplayed  as large as possible! (This can │
  198. │ take a few seconds.. please be  patient).  You  can now edit pixel for pixel │
  199. │ the are of the screen  by  moving  the   mouse  &  pressing the [Left] mouse │
  200. │ button. When pressed, if the square  below  the  cursor was black, the paint │
  201. │ used will be white! - and vice-versa! Pressing the [Right] mouse button will │
  202. │ exit the function. (** nb. The maximum width  a pixel edit section can be is │
  203. │ 320 pixels **)                                                               │
  204. │                                                                              │
  205. │ 19. Load                                                                     │
  206. │                                                                              │
  207. │ After pressing the [left] mouse  button,  enter  the  path & filename of the │
  208. │ picture you wish to load!                                                    │
  209. │                                                                              │
  210. │ 20. Save                                                                     │
  211. │                                                                              │
  212. │ After Pressing the [Left] mouse button, enter the name you wish to save your │
  213. │ current picture as. Also, please  note  that  as  a  useful edition, the PIX │
  214. │ program can be instructed to create the source code for a basic program that │
  215. │ will load the picture  into  your  own  basic  programs.  If  this option is │
  216. │ selected, you will be prompted  for  a  basic  source file name. The routine │
  217. │ created, can be  used  with  GW-Basic,  Microsoft  Basic Compiler, Microsoft │
  218. │ QuickBasic etc..etc... (** This  routine  can  not  be  used with Locomotive │
  219. │ BASIC 2 **) nb. the routine  uses  the  string variable 'A$' as the filename │
  220. │ description.                                                                 │
  221. │                                                                              │
  222. │                                                                              │
  223. │ To quit the PIX program (in work screen mode), simply press the [Esc] key.   │
  224. │                                                                              │
  225. │ To UNDO or erase the last function used, simply press the [U] or [u] key.    │
  226. │                                                                              │
  227. │ To Clear the work screen, press the [C] or [c] key!                          │
  228. │                                                                              │
  229. │                                ----*****----                                 │
  230. │                                                                              │
  231. │ This program was developed by Andrew T  Gisby  in his lunch hour on a Tandon │
  232. │ PCA with an  80286  Processor  EGA  screen  &  Microsoft's "rather spiffing" │
  233. │ QuickBasic version 4.5.                                                      │
  234. │                                                                              │
  235. └──────────────────────────────────────────────────────────────────────────────┘
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.