home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 006.lha / APAINT.HINTS < prev    next >
Encoding:
Text File  |  1986-02-01  |  10.4 KB  |  233 lines
  1. 1000  GOSUB 10000
  2. 1010  ?
  3. 1020  ?"             ======== APAINT HINTS ========             "
  4. 1030  ?"              Last Revision:  01/03/86 CJF              "
  5. 1040  ?
  6. 1050  ?"   This program gives some tips on using APaint and"
  7. 1060  ?" methods for displaying your pictures in your own basic"
  8. 1070  ?" programs. For advice on copying APaint, look under that"
  9. 1080  ?" program's 'Extras' menu."
  10. 1090  GOSUB 10100
  11. 1100  ?"                 ---- GENERAL HINTS ----"
  12. 1110  ?
  13. 1120  ?"   APaint must be on the disk you use to boot up your"
  14. 1130  ?" Amiga, and should be left in the built-in disk drive at"
  15. 1140  ?" all times. This means if you only have one drive then"
  16. 1150  ?" you'll have to save the pictures you create on the same"
  17. 1160  ?" disk. If the disk is stripped down to just the files"
  18. 1170  ?" required by AmigaDOS there should be enough room to"
  19. 1180  ?" store five images. With two disk drives, you can save"
  20. 1190  ?" files on any disk inserted into the external drive."
  21. 1200  ?
  22. 1210  ?"   I suggest that you use the Preferences Tool to change"
  23. 1220  ?" the cursor shape into a cross something like:"
  24. 1230  ?" Put the 'Hot Spot', the pixel used to actually"
  25. 1240  ?" pick something, right in the center. Make the"
  26. 1250  ?" middle of each arm of the cross transparent. Then you"
  27. 1260  ?" can see the pixel on the screen that you are drawing."
  28. 1270  ?" Adding a bit of shading as shown helps make the cursor"
  29. 1280  ?" visible when it's on a background of the same color."
  30. 1292  '
  31. 1294  '    DRAW SAMPLE CURSOR SHAPE
  32. 1296  '
  33. 1300  PENA 3:OUTLINE 0
  34. 1310  BOX(490,118;520,121),1:BOX(501,112;508,127),1
  35. 1320  PENA 4:BOX(490,118;518,120),1
  36. 1322  BOX(501,112;506,126),1
  37. 1330  PENA 0:DRAW(490,119 TO 520,119)
  38. 1340  BOX(503,112;504,127),1
  39. 1380  PENA 2:GOSUB 10100
  40. 1390  '
  41. 1400  ?
  42. 1410  ?"   The menus in APaint drop down as soon as your cursor"
  43. 1420  ?" is on the menu title. You do not have to push either of"
  44. 1430  ?" the mouse buttons. The menu closes up again when the"
  45. 1440  ?" cursor goes outside of the menu or moves off its title."
  46. 1450  ?
  47. 1460  ?"   Many of the tools in APaint will not carry out their"
  48. 1470  ?" action until you release the mouse button. While you"
  49. 1480  ?" keep the button depressed you can examine the interm"
  50. 1490  ?" results and change the pointer position until you are"
  51. 1500  ?" satisfied. Then release the button to make it permanent."
  52. 1510  ?" Take for example drawing lines. Pressing the button"
  53. 1520  ?" fixes the start of the line, and as you move the cursor"
  54. 1530  ?" a 'rubber-band' line is drawn from that point to the"
  55. 1540  ?" current position. Release the button to draw the final"
  56. 1550  ?" line. When pasting a clipping onto a picture, keep the"
  57. 1560  ?" button pressed and move it around until it is exactly"
  58. 1570  ?" where you want it, then let go to fix it in place."
  59. 1580  ?
  60. 1590  GOSUB 10100
  61. 1600  ?
  62. 1610  ?"             ---- WORKING WITH PROJECTS ----"
  63. 1620  ?
  64. 1630  ?"   Select 'OPEN' from the Project menu to see a list of"
  65. 1640  ?" pictures on disk. You can scroll through the list or"
  66. 1650  ?" simply click on the title you want to see. If you want to"
  67. 1660  ?" switch disks (2-drive users only) click on 'Disk:' and"
  68. 1670  ?" choose one from the list of those available. After a"
  69. 1680  ?" few seconds that disk's file titles will be displayed."
  70. 1690  ?
  71. 1700  ?"   If you have already specified a name for a project,"
  72. 1710  ?" e.g. through loading or saving it previously, the Save"
  73. 1720  ?" command will use the same name again. Otherwise you'll"
  74. 1730  ?" have to type in a name for the picture.
  75. 1740  ?
  76. 1750  ?"   Clearing a project lets you start over but keeps the"
  77. 1760  ?" same project name. The New command erases the name too."
  78. 1770  ?
  79. 1780  ?
  80. 1790  GOSUB 10100
  81. 1798  ?
  82. 1800  ?"                 ---- DRAWING TOOLS ----"
  83. 1810  ?
  84. 1820  ?"   APaint has a pretty standard assortment of drawing"
  85. 1830  ?" tools: freehand brush, lines & connected lines, text"
  86. 1840  ?" entry, painting enclosed areas, plus open and filled"
  87. 1850  ?" boxes, ovals, and irregular polygons. The brush shape"
  88. 1860  ?" you select is used with all tools except text, painting"
  89. 1870  ?" and the filled versions of the shapes."
  90. 1880  ?
  91. 1890  ?"   When drawing connected lines you can end the sequence"
  92. 1900  ?" of lines by moving the cursor to the top of the screen."
  93. 1920  ?"   The circle is drawn by clicking where you want the"
  94. 1930  ?" center, then keeping the button pressed and moving the"
  95. 1940  ?" cursor to specify the radius of the circle."
  96. 1960  ?"   The irregular polygon tool works something like the"
  97. 1970  ?" connected lines tool, but it stops when you put the"
  98. 1980  ?" endpoint of the last line segment within two pixels of"
  99. 1990  ?" the start of the first segment, closing the shape."
  100. 1992  GOSUB 10100
  101. 2000  ?
  102. 2010  ?"                 ----EDITING TOOLS ----"
  103. 2020  ?
  104. 2030  ?"   Most of the editing tools work by first marking the"
  105. 2040  ?" area you want to affect, then carrying out the desired"
  106. 2050  ?" action. Push the mouse button and move the cursor to"
  107. 2060  ?" stretch out a dashed editing frame. When you release"
  108. 2070  ?" the button the tool performs its function on that area."
  109. 2080  ?
  110. 2090  ?"   Three editing tools; Copy area, Cut area, and Load"
  111. 2100  ?" clipping from disk, end by putting an image in the edit"
  112. 2110  ?" buffer, or clipboard. Other tools will paste this image"
  113. 2120  ?" on the screen, use it as a brush, or save it to disk."
  114. 2130  ?" These tools only work if something is in the clipboard."
  115. 2140  ?
  116. 2142  GOSUB 10100
  117. 2144  ?
  118. 2150  ?"   To use the Stretch tool first draw an edit frame"
  119. 2160  ?" around the area to be stretched. Then press the mouse"
  120. 2170  ?" button and move the cursor to draw a second frame. The"
  121. 2180  ?" initial area is stretched and/or squeezed so it fits"
  122. 2190  ?" within the second frame. This transformation can be"
  123. 2200  ?" very slow, especially if you are 'transforming' areas"
  124. 2210  ?" of background color and nothing appears to be happening."
  125. 2212  ?" Put the cursor on a menu title and when the menu drops"
  126. 2214  ?" you'll know the stretching has finished."
  127. 2220  GOSUB 10100
  128. 2230  ?
  129. 2240  ?"              ---- COLORS AND PATTERNS ----"
  130. 2250  ?
  131. 2260  ?"   The type of 'paint' you draw with is determined by"
  132. 2270  ?" three things: foreground color, background color and"
  133. 2280  ?" pattern. The foreground color is used for all the 'set'"
  134. 2290  ?" pixels of the pattern and text characters. Of course,"
  135. 2300  ?" if the pattern is solid then all you'll see is this"
  136. 2310  ?" color. The background color is used for all the 'unset'"
  137. 2320  ?" pixels and the space around text characters. A special"
  138. 2330  ?" background color is 'transparent'. When you use this,"
  139. 2340  ?" anything that is already on the screen will show right"
  140. 2350  ?" through instead of being painted over."
  141. 2370  ?
  142. 2380  ?"   To copy a color from one place in the palette to"
  143. 2390  ?" another click on 'Copy', the color to be copied and the"
  144. 2400  ?" spot where you want it to end up. This is often done to"
  145. 2410  ?" prepare for creating a color range. To produce a range"
  146. 2420  ?" of colors, click on 'Range' then on the starting and"
  147. 2430  ?" ending colors. The ones in between will be modified."
  148. 2440  GOSUB 10100
  149. 2450  ?
  150. 2460  ?"   You can modify the color you've selected by changing"
  151. 2470  ?" the amount of red, green, and blue primaries contained."
  152. 2480  ?" Click on the RGB bars to adjust the level of each."
  153. 2490  ?
  154. 2500  ?"   The first three and last three colors in the palette"
  155. 2510  ?" are reset every time you use a menu. You can modify"
  156. 2520  ?" them if you wish, but they'll revert back to normal so"
  157. 2530  ?" the menus are always readable. Also note that three"
  158. 2540  ?" colors may be used with the cursor shape. Changing"
  159. 2550  ?" these could make it difficult to see."
  160. 2560  ?
  161. 2570  ?"   It can be handy to save a color palette for future"
  162. 2580  ?" use. For example, having a palette of flesh tones on"
  163. 2590  ?" disk will save you the trouble of setting them every"
  164. 2600  ?" time you do a portrait."
  165. 2610  GOSUB 10100
  166. 2620  ?
  167. 2630  ?"                 ---- IMAGE FORMAT ----"
  168. 2640  ?
  169. 2650  ?"   At present APaint saves its pictures in its own format."
  170. 2660  ?" When more information on the I.F.F. standard for Amiga"
  171. 2670  ?" file interchange becomes available, APaint will support"
  172. 2680  ?" that format too. Then you will be able to use APaint"
  173. 2690  ?" pictures with many other Amiga programs. For the meantime"
  174. 2700  ?" you can use your pictures with your own basic programs"
  175. 2710  ?" by following the information given below."
  176. 2720  ?
  177. 2730  ?"   Pictures are saved as binary files. Both the actual"
  178. 2740  ?" image and the color register settings are stored. Only"
  179. 2750  ?" the visible area of the screen is saved: 0-303 pixels"
  180. 2760  ?" across by 0-188 lines vertically. This takes 35918 bytes."
  181. 2770  ?" The color data uses another 384 bytes."
  182. 2772  GOSUB 10100
  183. 2780  ?
  184. 2790  ?"   Normally the picture is held in an integer array, for"
  185. 2800  ?" example TPIC%(). Elements 0 to 8980 contain the image,"
  186. 2810  ?" TPIC%(8981) is a version number which may be used with"
  187. 2820  ?" future releases of APaint, TPIC%(8982) - TPIC%(8984)"
  188. 2830  ?" hold the R,G,B values for color register 0, TPIC%(8985)"
  189. 2840  ?" to TPIC%(8987) are the values for color register 1, etc."
  190. 2850  ?
  191. 2860  ?"   To load a picture from disk and display it in your"
  192. 2870  ?" own program, you must first 1) dimension an array large"
  193. 2880  ?" enough to hold it, 2) load the image from disk, 3) use"
  194. 2890  ?" the color data to reset the RGB registers, and finally"
  195. 2900  ?" 4) display the image. For example:
  196. 2910  ?
  197. 2920  ?"   1)  DIM TPIC%(9100)"
  198. 2930  ?"   2)  BLOAD filename,VARPTR(TPIC%(0))"
  199. 2940  ?"   3)  FOR N=0 TO 31"
  200. 2950  ?"       RGB N,TPIC%(8982+N*3),TPIC%(8983+N*3),TPIC%(8984+N*3)"
  201. 2960  ?"       NEXT"
  202. 2970  ?"   4)  GSHAPE(0,0),TPIC%()
  203. 2972  GOSUB 10100
  204. 2980  ?
  205. 2990  ?"   There is a bit of unused space in the array at present."
  206. 3000  ?" This may be used in future versions of APaint to hold"
  207. 3010  ?" color cycling information, etc."
  208. 3020  GOSUB 10100
  209. 3030  PRINT AT(24,10);"Have Fun!"
  210. 3040  GOSUB 10100
  211. 9999  END
  212. 10000 '
  213. 10010 '    SET UP 60 COLUMN SCREEN
  214. 10020 '
  215. 10030 SCREEN 1,4:FONT 2:GRAPHIC 0
  216. 10040 RGB 0,1,3,9
  217. 10050 RGB 1,14,14,14
  218. 10060 RGB 2,10,10,10
  219. 10070 RGB 3,0,0,0
  220. 10080 RGB 4,11,0,0
  221. 10090 RETURN
  222. 10100 '
  223. 10110 '    PROMPT TO CONTINUE
  224. 10120 '
  225. 10122 GRAPHIC 1
  226. 10130 PRINT AT(58,184);"(Press <SPACE> to continue, or <ESC> to quit) ";
  227. 10132 GRAPHIC 0
  228. 10140 ASK MOUSE X%,Y%,B%:IF B%<>0 THEN PRINT:SCNCLR:RETURN
  229. 10150 GET Z$:IF Z$="" THEN 10140
  230. 10160 IF Z$=CHR$(27) THEN SCNCLR:END
  231. 10170 IF Z$=" " OR Z$=CHR$(13) THEN PRINT:SCNCLR:RETURN
  232. 10180 GOTO 10140
  233.