home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / tt / brshwrks / readme.doc < prev   
Text File  |  1992-08-26  |  15KB  |  334 lines
  1.                 BRUSHWORKS TT
  2.  
  3. What is this anyway?
  4.  
  5. Brushworks TT is a full featured painting package for the TT' 256 color
  6. graphics mode, it contains many features not found in even the most expensive
  7. commercial programs and outperforms all in speed and ease of use.
  8.  
  9. Brushworks TT is SHAREWARE, it represents almost a year of coding and many 
  10. late nights hunched over my assembler. I have many more features I'd like to
  11. add and only you can help me do it. If you use this demo of the program and
  12. would like a version with the save options added as well as a couple of other
  13. extras, please send in your registration fee. In return you'll get the latest
  14. version of the program (with save enabled), a couple of my other handy TT
  15. utilities (screen grabber etc.) and a warm fuzzy feeling deep inside.
  16. You'll be helping a starving Australian programmer carry on his favourite
  17. pastime, and I know you'll all want to see a version of this on the Falcon.
  18.  
  19. O.K. So what do I have to do?
  20.  
  21. Send me $40 AUD (Australian dollars) or the equivalent thereof to this
  22. address:
  23.         Tony Barker
  24.         Moving Pixels
  25.         2/39 Frazer St
  26.         Leichhardt NSW 2040
  27.         AUSTRALIA
  28.  
  29. and make sure you include your address so I can send you your registered
  30. version.
  31. If your as poor as I am or a student and can't really afford that much or
  32. you don't think it's worth that much in the first place then send what you 
  33. can afford or what you think it is worth. I'm also open to suggestions as to
  34. features you'd like to see.
  35.  
  36. Possible troubles
  37.  
  38. If your tool bar flickers and jumps around then you've discovered a strange
  39. bug that affects the program on some TT's. I'm using a very sophisticated
  40. method for handling the toolbar involving some complex interrupts, this seems
  41. to cause a problem on some machines. A fix is at hand and will be included in
  42. all registered versions. You might try turning off the cache to remove the
  43. problem as a temporary fix.
  44.  
  45. So what can this version do ?
  46.  
  47. The following description will work across the front tools menu describing 
  48. each icon in turn and anything special about it's function. There will be a 
  49. description for what happens when clicked with the left mouse button and also 
  50. the right mouse button.
  51.  
  52. First a few explanations-
  53.  
  54. The program uses the concept of a foreground color and a background color. 
  55. The palette can be activated by hitting 'P' on the keyboard and the currently 
  56. selected fore and background colors are shown in 2 differrent ways. Firstly 
  57. the current foreground color has a solid horizontal marker above it and a 
  58. large bar of it appears in the bottom right hand corner. The background color 
  59. is indicated by a stippled bar underneath the color and a large bar of it 
  60. appears to the left of the foreground color bar. The foreground color is set 
  61. by clicking on it with the left mouse button and the background by the right 
  62. mouse button. When drawing with a brush you can draw with the background 
  63. color by pressing the right mouse button. Transparency is a complex feature 
  64. and takes some time getting to know but can be very powerful .Some things to 
  65. remember when using transparency are that it will work better on some 
  66. pictures than others due to the make up of their palettes. The better the 
  67. range of each of the main hues in the palette the more effective the feature 
  68. works. The reasons for this is that although there are 4096 colors, only the 
  69. 256 in the current picture are available so the transparency code has to do a 
  70. 'best fit' to get it's in between colors, this also explains the speed (or 
  71. lack of it) of this function.
  72.  
  73.  
  74. POINT DRAW:
  75. left mouse button-
  76.     The top left most icon, and the startup default is the PointDraw icon 
  77.     this allows freehand drawing with any one of the 8 predefined brushes 
  78.     or the user definable brush.
  79.  
  80. right mouse button-
  81.     Brings up the brush preferences menu. See the description under User 
  82.     definable brush.
  83.  
  84. CONTINUOUS DRAW:
  85. left mouse button-
  86.     Switches to continuous draw mode, lines will not be made up of a 
  87.     series of dots but will be continuous. This can make drawing very 
  88.     slow with large user brushes.
  89. right mouse button-
  90.     Brings up the brush preferences menu. See the description under User 
  91.     definable brush.
  92.  
  93. BOX DRAW:
  94. left mouse button-
  95.     Switches to box draw mode. Draws a box in the currently defined style
  96.     set by right mouse button.
  97. right mouse button-
  98.     Brings up the line preferences menu. 
  99.     When in the line preferences menu clicking on any of 
  100.     the boxes under the words 'Line Style' will edit the line pattern 
  101.     used when drawing boxes ,lines and curves. Clicking on 
  102.     them with the Right mouse button clears the particular 'bit' and 
  103.     clicking with the Right will set it. Clicking 'ALL' will set all the 
  104.     bits in the line to on and clicking 'NONE will do the opposite. 
  105.     Clicking on any of the 5 predefined line styles underneath the main 
  106.     style editor will set the editor up with that pattern. Clicking any 
  107.     of those boxes with the right mouse button will set the editor up 
  108.     with the inverse of that line pattern.
  109.     Under the line style settings are 3 buttons allowing you to choose
  110.     the style of box drawn. "BRUSH" will draw the box filled with a 
  111.     repeating pattern of the currently defined user brush (if none
  112.     defined the box will be empty or clear). "SOLID" will draw the box
  113.     filled with the current foreground color and "EMPTY" will just draw
  114.     the outline using the line preferences as described above.
  115.  
  116. ELIPSE DRAW:
  117. left mouse button-
  118.     Switches to elipse drawing mode. Allows you to draw an elipse
  119.     using the currently selected line, fill and brush settings.
  120. right mouse button-
  121.     Brings up the line style editor, see BOX DRAW mode.
  122.        
  123. LINE DRAW:
  124. left mouse button-
  125.     Switches to line draw mode. Will draw a line using the currently 
  126.     selected brush and linestyle.
  127. right mouse button-
  128.     Brings up the line style editor, see BOX DRAW mode.
  129.     Note that the "BRUSH FILLED EMPTY" buttons will not appear as they
  130.     do not apply to this tool.
  131.  
  132. SPLINE DRAW:
  133. left mouse button-
  134.     Switches to spline draw. A basic 4 point spline will be drawn on the
  135.     screen with thew control points visible. Clicking on the control
  136.     points allows you to "mould" the spline to how and where you want
  137.     it. When you have the spline as you require hitting the "SPACE" bar
  138.     will set it on the screen permanently. The spline will be drawn using
  139.     all the current settings.
  140. right mouse button-
  141.     Brings up the line style editor, see BOX DRAW mode.
  142.     Note that the "BRUSH FILLED EMPTY" buttons will not appear as they
  143.     do not apply to this tool.
  144.  
  145. AIRBRUSH MODE:
  146. left mouse button-
  147.     Switches to airbrush mode. Simulates a real airbrush with a
  148.     "centre weighted random elipsoidal dither". As usual the spray is
  149.     drawn using all the current settings and brush.
  150. right mouse button-
  151.     Brings up the airbrush settings menu. From here you can change the
  152.     flow rate (how fast new pixels are drawn) and the spray size.
  153.  
  154. USER BRUSH:
  155. left mouse button-
  156.     Allows the user to grab any rectangular area of the screen to use as 
  157.     a brush. When the selection is made the current draw mode will be 
  158.     returned (ie: line, box, pointdraw, linedraw etc)
  159. right mouse button-
  160.     Brings up the brush preferences menu. This is one of the most complex 
  161.     of the preference screens and should be read carefully.
  162.  
  163.     The 5 buttons on the left of this menu are used to set the current 
  164.     drawing mode for the brush. Only COLOR and CYCLE are applicable to 
  165.     predefined brushes but all apply to the user brush. COLOR sets all 
  166.     subsequent drawing to the currently selected foreground color 
  167.     regardless of what colors the brush may have in it. CYCLE, sets all 
  168.     drawing to be in colors cycling between the current foreground color 
  169.     and the current background color (see the palette menu for more 
  170.     info). MATTE, means the background color in the brush shall be 
  171.     considered transparent. REPLACE means the background color will 
  172.     replace any behind it making the brush appear as a solid block.
  173.  
  174.     All of these 5 modes can be accessed by the Function keys 1 to 5.
  175.  
  176.     TRANSPARENT means the brush will be drawn transparently over the 
  177.     screen using the current setting on the right half of this 
  178.     preferences screen. The 4 buttons under the heading DITHER set the 
  179.     amount of dithering used when transparently pasting a brush over the 
  180.     screen, the dither settings currently have no effect on any other 
  181.     drawing mode. The 4 buttons situated above the small picture are the 
  182.     various transparency types. The left most is uniform transparency, 
  183.     This means the brush will be drawn with the same transparency factor 
  184.     uniformly applied across it's entire surface. The transparency factor 
  185.     is set with the small buttons on either side of the small picture. 
  186.     The left column of buttons sets the centre transparency (top=solid, 
  187.     bottom = clear) and the right column set the edge transparency. In 
  188.     uniform transparency mode both edge and centre are neccessarily the 
  189.     same. The next button across is the Vertical transparency mode. In 
  190.     this mode the edge and centre transparencies can be differrent and 
  191.     the brush will be draw with the centre transparency running verticaly 
  192.     through it. Next is Horizontal transparency, the same as vertical 
  193.     but, of course, horizontal. I should mention here the picture 
  194.     underneath these buttons. You should see a small white square that 
  195.     can be clicked on and dragged with the mouse. This is the centre of 
  196.     transparency for your brush. The final button is the Point 
  197.     transparency mode. This mode allows pasting of a brush on the screen 
  198.     with the edges transparent or many other effects. The best way to 
  199.     learn of these features is to load a picture cut out a brush, click 
  200.     on TRANSP and adjust a few of these values then exit and paste the 
  201.     brush on top of your screen.
  202.     The "Background color" buttons set how background colors in a brush
  203.     are treated when being used as a fill pattern or being pasted with
  204.     a transparency factor. "TRNSP" means treat the backgound color as
  205.     transparent and "REPLC" means it is treated the same as the rest of
  206.     the colors
  207.  
  208. FLOOD FILL:
  209. left mouse button-
  210.     Sets flood fill mode. Changes the mouse pointer to a small paint can
  211.     dripping paint the tip of which represents the point from which the
  212.     paint will flow when the button is clicked.
  213. right mouse button-
  214.     Brings up the line style editor, see BOX DRAW mode.
  215.     NOTE that "EMPTY" has no effect
  216.  
  217. CLEAR:
  218. left mouse button-
  219.     Clears the current screen. Undo can restore from this.
  220. right mouse button-
  221.     nothing
  222.  
  223. DRAG BAR:
  224. left mouse button-
  225.     Drags the menu up and down to reveal hidden parts of the current 
  226.     screen. This menu can be removed entirely by hitting the F10 key. F10 
  227.     also restores it.
  228. right mouse button-
  229.     Nothing.
  230.     
  231. BOTTOM ROW.............
  232.  
  233. PREDEFINED BRUSHES:
  234. left mouse button-
  235.     Clicking on any of these makes it the current brush.
  236. right mouse button-
  237.     Restores the last user brush. CAUTION, it is possible to use the 
  238.     right mouse button to restore the last brush when none was defined.
  239.     This results in a totally invisible brush.
  240.  
  241. PALETTE EDITOR:
  242. left mouse button-
  243.     Brings up the palette editor. If the palette wasn't previoulsy 
  244.     visible (acivated by 'P' on the keyboard) it becomes visible and a 
  245.     new menu appears. On the extreme left is the RGB of the currently 
  246.     selected foreground color. The Red, Green and Blue components of this 
  247.     color can be changed with the up and down arrows above and below each 
  248.     of the numbers. COPY will change the mouse pointer to a small arrow 
  249.     and the word TO when you click on another color block the current 
  250.     foreground color will be copied to it. SPREAD works in a similar 
  251.     fashion only an even spread of colors will be calculated between the 
  252.     foreground color and the color chsen by the 'TO' pointer. EXCHANGE 
  253.     will exchange the foreground color and that chosen by the 'TO' 
  254.     pointer. The disk icon with the arrow pointing to it will save the 
  255.     current palette out to disk and the icon with the arrow pointing away 
  256.     from it will load a previously saved palette in. Saved palettes also 
  257.     store the current fore and background colors and they are set
  258.     accordingly when loaded.
  259.     The Icon with the boxes and lines will return you to the main tools 
  260.     menu.
  261.  
  262.     When in the palette manipulation menu clicking with the right or
  263.     left mouse buttons on the currently displayed picture will set the 
  264.     foreground or background colors to the color under the cursor.
  265.  
  266. right mouse button-
  267.     Nothing.
  268.  
  269. FILE MENU:
  270. left mouse button-
  271.     Brings up the file menu. Allows the loading and saving of pictures in 
  272.     various formats. Choose the format you wish and click on the load 
  273.     icon. IFF can only be 320*200*16 color format. When loading a pic
  274.     in 320*200 format you will be given the option of doubling its'
  275.     vertical resolution to keep its' aspect ration correct. 
  276.     NEO handles the original NEO and the extended TT neo format. PNT 
  277.     files can only be 320*480*256. You will be warned if a file is in an 
  278.     incompatable resolution or format.
  279.     When loading a picture you can choose whether you wish to use that
  280.     pictures palette or remap it to the existing palette, the program 
  281.     will do a 'best fit' of the incoming pictures colors to those already
  282.     in use. The results of this option range from very good to poor
  283.     depending on the disparity of the two palettes.
  284.     Save options are not available in unregistered version.
  285. right mouse button-
  286.     Nothing.
  287.  
  288. UNDO:
  289. left mouse button-
  290.     Undoes the last screen access.
  291. right mouse button-
  292.     Nothing.
  293.  
  294.  
  295. KEYBOARD COMMANDS
  296. Brushes can be flipped on the x and y axis simply by hitting the 'x' or 'y' 
  297. keys .They can also have their size halved by hitting the 'h' key.
  298.  
  299. There is a color cycling feature that will cycle the colors between and 
  300. including the background color marker and the foreground color marker, this 
  301. is activated by hitting the 'TAB' key. Try loading in the 'RAINBOW.PAL' 
  302. palette and setting the background color to the start of the rainbow and the 
  303. foreground color to the end. Then choose a brush, get the brush preferences 
  304. menu up by hitting the draw icon with the right mouse button and choose 
  305. 'CYCLE' as the draw mode (or hit F4), now draw some lines on the screen and
  306. hit the 'TAB' key and see the effect. 'TAB' is a toggle and will turn
  307. cycling off as well.
  308.  
  309. 'Q' quits from the program back to the desktop.
  310.  
  311. The program will run from any resolution but is designed to be launched
  312. from TT medium. Do not run it from the super high rez mode.
  313.  
  314.  
  315. The program and this documentation was written by Tony Barker of MOVING 
  316. PIXELS and is copyright him (1991/92).
  317. This demo version of the program may be copied and distributed freely by any        
  318. means as long as it remains complete, unaltered and all files remain together
  319. and intact. If the program is to be included in a PD library the library must
  320. contact the author for permission first.
  321. This software comes with no warranty whatsoever either stated or implied.
  322.  
  323.     Moving Pixels are at:-
  324.  
  325.     2/39 Frazer St.
  326.     Leichhardt 2040
  327.     Australia
  328.     Phone or fax. (02) 555 7312
  329.  
  330.  
  331.  
  332.  
  333.  
  334.