home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 8 / af008.adf / UltraPaint / UltraPaint.Doc < prev    next >
Text File  |  1988-06-28  |  11KB  |  318 lines
  1.                 * Ultra Paint *
  2.             Copyright 1988 by Steve Hines
  3.  
  4.                  Version 1.00
  5.  
  6.     UltraPaint is Shareware! If you like it and use it, send me $15 and I 
  7. will send you the latest version with IFF Save enabled! If you don't find Ultra
  8. Paint useful, please pass it along.
  9.  
  10.     Send Money, Bugs, Suggestions, and general correspondence to:
  11.  
  12.                         Steve Hines
  13.                         701 Paul Street
  14.                         Esondido, Ca.,
  15.                         92027
  16.  
  17. Credits::
  18.  
  19.     Thanks to RJ Mical for the great Palette tool and File Requester.
  20.  
  21.  
  22. And now, on with the show...
  23.  
  24. Starting up::
  25.  
  26.     To start from Workbench:
  27.         Set ToolTypes in the UltraPaint Icon (using the menu item
  28.         'info'). The format of entries is...
  29.         
  30.         h=(height)
  31.         w=(width)
  32.         d=(depth)
  33.         p=(preset)
  34.         
  35.         These Options are explained below.
  36.  
  37.     To start from CLI:
  38.         type [run] cdraw h(height) w(width) d(depth) [p(preset)]
  39.  
  40.     Options:
  41.         Height is any number from 1 to 400 (automatically switched to
  42.                             interlace mode)
  43.  
  44.         Width is any number from 1 to 640 (automatically switched to   
  45.                            hires)
  46.  
  47.         Depth is any number from 1 to 5 in LoRes, 1 to 4 in Med-HighRes
  48.  
  49.         Preset is an optional argument, from 1 to 4. 
  50.             1. 320x200x5
  51.             2. 320x400x5
  52.             3. 640x200x4
  53.             4. 640x400x4
  54.  
  55. The Color Window::
  56.  
  57.     The Color Window is the color selector window on the screen. Clicking
  58.     on any of the little color boxes changes the current Foreground drawing
  59.     color. The current Foreground color is in the big box on the left.
  60.  
  61. The Menus::
  62.  
  63. Project-
  64.  
  65.     About:    Shareware info...
  66.     
  67.     Save:    NOT enabled in this version...see above
  68.     
  69.     Load:
  70.         1. Picture:     Load picture does just that, loads a picture.
  71.                 Brings up a file requester. This requester will
  72.                 list files in the big box on the left. Clicking
  73.                 the mouse anywhere outside this box and any
  74.                 other gadgets will stop the files from listing
  75.                 in the box. File selection is just like any
  76.                 other file requester. Next Disk flips to the
  77.                 next dos device mounted to the system. 
  78.                 
  79.         2. Brush:       Brings up the file requester mentioned above.   
  80.                 You can select any IFF picture. If you are in 
  81.                 freehand or airbrush mode (mentioned later), 
  82.                 the brush will appear and follow your cursor. 
  83.                 See Custom and Makebrush for details.
  84.                 
  85.     Load Opts:
  86.         1. Clr on Load:    This option allows to clear the screen when a
  87.                 Picture is loaded. This could be useful
  88.                 if you want to merge to 'half' pictures
  89.                 together.
  90.         
  91.         2. Load to Spare: This option allows you to load a picture into
  92.                 the Spare screen (memory permitting).
  93.  
  94.     Undo:    This will undo your LAST draw action (but will not undo an undo
  95.         ) a 'draw action' is anything that would draw something ON the 
  96.         screen. This does NOT include something like 'grabbing' a brush
  97.         or turning on/off crosshairs, etc...
  98.     
  99.     Spare:
  100.         1. Copy to spare:This copies the current screen to 'spare',
  101.                 allowing you to save a screen for later
  102.                 reference, or clip-art.
  103.                 
  104.         2. Swap spare:    This swaps the current screen with the current
  105.                 one, making it the spare.
  106.         
  107.     Newpic:    This erases the current picture.
  108.     
  109.     Quit:    Quits the program, give you 'one last chance' before exiting.
  110.     
  111. Mode-    
  112.  
  113.     Freehand: This is the 'main' drawing mode in Ultra Paint. Brush size
  114.           and shape only have effect on this and Airbrush mode. The
  115.           brush, when in block or slash mode, draws from pointer
  116.           position down. BkSlash draws from position up, and circle
  117.           draws from centerpoint around.
  118.           
  119.     Sketch:   Very fast draw mode. Will only draw single pixel lines. Meant
  120.           for sketching drawing or ideas.
  121.           
  122.     Line:      The basic Line mode. Will draw a line from here to there.    
  123.           This mode uses the Standard interface, which all Modes use
  124.           from here on unless otherwise noted. Press and hold the      
  125.           'Select' (Left) button on the mouse. When the mouse is moved
  126.           the object (whatever is being drawn) follows the mouse. 
  127.           Releasing the Select button will drop the object. 
  128.           
  129.     Ray:      Will draw multiple lines from any fixed vertex to any other  
  130.           Point on the screen. This interface is a little different.   
  131.           First, to select a vertex, Click the Select button on the    
  132.           vertex point. To draw a 'ray' move the mouse, without the
  133.           button pressed, to the endpoint. Press Select button, and the
  134.           ray will be drawn. If the Select button is held down, and the
  135.           mouse moved, multiple rays will be drawn to follow the mouse 
  136.           pointer until the Select button is released. To exit Ray and 
  137.           select another vertex, stop all movement of the mouse, and   
  138.           press the 'Menu' (Right) mouse button. While in Ray draw mode
  139.           the color can be changed, and draw from the same point,      
  140.           without exiting.
  141.         
  142.     Box:      Just the general box draw thingy. Uses the standard
  143.           interface.
  144.           
  145.     Solid Box: When drawing the Solid box, a diagonal line will be draw
  146.            across the box to denote that is is going to be solid. This 
  147.            was done for speed.
  148.            
  149.     Ellipse:   It's just that, an ellipse.
  150.     
  151.     Solid Ellipse: Solid Ellipse.
  152.     
  153.     Polygon:  To draw polygon, select a startpoint, and click the Select   
  154.           button there. Select as many lines as you want using the     
  155.           Select button. To exit, Either click the Menu button, or
  156.           Click on the Startpoint.
  157.         
  158.     Solid Poly: To draw a solid poly, select a startpoint, and click the 
  159.           Select button. Select as many lines as you want using the     
  160.           Select button, but please no more that 120 lines... To exit, 
  161.           Click on the Startpoint and the shape will be filled.
  162.  
  163.     Fill:      Very simple. Just click on the area to fill, and voila!    
  164.     
  165.     Airbrush: Airbrush is very simple. Just press and hold the Select
  166.           button. The area the size of the Airbrush (see below) will   
  167.           slowly be filled in with whatever brush is active. When the   
  168.           mouse is moved, the Airbrush will move with it.
  169.           
  170.     Airbrush size:  This will bring up a requester asking for input. The    
  171.             current value will be displayed. Clicking on the window
  172.             close gadget will cancel. Typing in a number and
  173.             pressing return will change the Airbrush spray width. 
  174.  
  175.     Zoom:      To zoom, Click and hold the select button anywhere on the    
  176.           screen. A box will appear that is the size of the zoom area (
  177.            see below). When the button is released, A window will appear
  178.           on the left side of the screen with the area zoom in it. It  
  179.           may take several seconds for the area to fill the zoom
  180.           window. 
  181.           
  182.           Zoom Menus-
  183.               Palette: Allows you to modify colors without exiting   
  184.                  zoom mode. See below for instructions on this 
  185.                  tool.
  186.                  
  187.             Move:     Will move the zoom window to the other side of
  188.                  screen.
  189.                  
  190.             Grid:     Will switch the grid on and off.
  191.             
  192.             Quit:     Quits!
  193.             
  194.           Using Zoom: Click anywhere in the zoom window. A dot of the  
  195.                   appropriate color will appear in the zoom and    
  196.                   main window simultamiously. The crosshairs and   
  197.                   coordinates will show the relative place on the  
  198.                   screen from zoom.
  199.                   
  200.     Zoom Config:
  201.     
  202.           Grid: Allows you to toggle Grid outside of zoom.
  203.           
  204.           Mag: Brings up requester. This number is the amount of pixels
  205.                to be included in the zoom, and will be sized
  206.                appropriately.
  207.  
  208.     Crosshairs: These follow the pointer around the screen. Useful for
  209.             lining things up on the screen. Turn off in draw modes.
  210.             
  211.     Coordinates: Report the position of the pointer. This is updated in all
  212.              draw modes.
  213.              
  214.     Tog Coords: Move the coordinated to opposite side of the screen. Gets
  215.             them out of the way when drawing.
  216.             
  217. Brush-
  218.     Type: Pretty self explainatory, except..:
  219.     
  220.         Custom: If you have allready grabbed a brush and are in
  221.             Airbrush or Freehand, the brush previously grabbed will
  222.             become the current drawing tool.
  223.  
  224.         Make Custom: To grab custom, Click on the Top-Left edge of the 
  225.                  brush, and move the mouse to the Bottom-Right and
  226.                  release the button. Brushes greater than 320
  227.                  across and 200 high are not allowed. If all goes 
  228.                  well, the custom brush will be the new drawing 
  229.                  tool. (If the brush size is a limitation, try
  230.                  using the spare screen.)
  231.  
  232.     Size: Again, self explainatory. 4 preset sizes are listed along with...
  233.         
  234.         Makesize: Brings up requester. This entry is the new diameter
  235.               (for circle) or width & height (for all else) of the 
  236.               current brush Type.
  237.               
  238.     Brush: This menu is for custom brush only. The first 2 items do NOT
  239.            require having a brush in 'hand', the rest do.
  240.            
  241.         Matte: When selected, the backround color is transparent.
  242.         
  243.         Corner: When Selected, the brush is handled in the top-left 
  244.             corner, otherwise, it is held in the middle.
  245.  
  246.             FlipX: Will flip your custom brush in the X direction.
  247.             
  248.             FlipY: Will flip your custom brush in the Y direction.
  249.             
  250.             The ghosted items are 'planned' brush functions.
  251.             
  252. Stuff-
  253.     Color:
  254.         Palette: Brings up the palette modifier. The colors selected
  255.              here ALSO change the drawing color. The sliders change
  256.              the R, G, and B values. Clicking on the RGB on the
  257.              lefthand side will change to and HSL scale (Hue,      
  258.              Saturation, Luminance). Clicking Cancel will undo ALL 
  259.              the colors that were changed. OK okays all changes
  260.              made in the palette. After clicking Range, which will 
  261.              do a 'dither' effect between colors selected, The next
  262.              2 color selections you make will be the colors to     
  263.              'range' between.
  264.  
  265.         Default: This will reset ALL colors to the ORIGINAL colors.
  266.              This is not undoable, so BE CAREFUL!
  267.  
  268.     Other:
  269.         WB: Allows you to turn Workbench on and off, if possible, that 
  270.             is, if there are NO other programs that have open windows  
  271.             on the Workbench.
  272.             
  273.         Title:  Will turn the title bar on/off. The title bar displays  
  274.             the current memory available and is periodically
  275.             updated.
  276.             
  277.         Free: Brings up three requesters. Selecting YES for any of
  278.               these will disable the said function forever.
  279.               
  280.         Sleep:  Will put Ultra Paint to sleep. This is relatively
  281.             useless now, but was in there when the program was a
  282.             multitasking hog. Left it in here 'just because'.
  283.             
  284.     CW:
  285.         On/Off: Will enable/disable the color window on the screen.
  286.  
  287.  
  288. Bugs:: So far...
  289.  
  290.     There is a high possibility that any brush with a horizontal resolution
  291.     greater than 320 will guru the program, or load in a very strange
  292.     version of that brush. I am hoping this will be of little trouble,
  293.     since Ultra Paint will only allow 320x200 brushes. If this poses a
  294.     problem to you, please send me a letter.
  295.  
  296.     When a brush is loaded into a HiRes or HiRes Interlace screen, it is
  297.     possible that Ultra Paint will guru, and a very good chance it will
  298.     guru upon exit. As an alternative, load the brush as 'clip art' into
  299.     the spare screen until this is fixed.
  300.  
  301.     Also, for some strange reason, zoom sometimes guru's when exiting. This
  302.     only happens on certain occations, that I have not pinpointed yet. The
  303.     only thing I can suggest is to exit slowly (like not move too many 
  304.     things at the same time). If you have any idea of how this could be 
  305.     fixed, tell me PLEASE! Thanks... 
  306.     (I think this bug has been fixed, or at least I have not been able to
  307.     get it to recur    after the fix...)
  308.  
  309.  
  310.     Other than that...It's ok!
  311.  
  312. Well, that's everything...Hope you like Ultra Paint!!! 
  313.  
  314. Lots of additions to come, like gadgets, brush functions, line thickness, etc..!
  315. so please register now! 
  316.  
  317. Steve...
  318.