home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 397.lha / PPB_v1.0 / PPB.Doc < prev    next >
Text File  |  1990-07-10  |  11KB  |  317 lines
  1.                    PPB  1.0
  2.                      WRITTEN BY
  3.                   THOMAS C. DEVEAU
  4.                  Copyright 1990 (c)
  5.                 All Rights Reserved
  6.  
  7.  
  8. Shareware Notice:
  9.     PPB is Shareware. This means that if you like PPB and use it,
  10.     PLEASE send a registration fee of $5.00 (US). By sending me the 
  11.     registration fee, your name will be put on my users list and
  12.     you will be sent a serial number to use if technical support
  13.     is required. Technical support CANNOT be given to un-registered
  14.     users. Fill in form below and send with fee to address below.
  15.                 Thank You.
  16.  
  17. What is PPB?
  18.  
  19.         PPB is a Full-Featured Paint Program and Image Editor. 
  20.     Originally designed for my gadget programming needs, it is well 
  21.     suited for creating clip art and other graphics. 
  22.         For artists, you have the choice of painting in 4 different 
  23.     resolutions, with upto 32 color choices.
  24.         For programmers, there are 3 choices of languages supported
  25.     for creating source code, plus the ability for saving images as RAW
  26.     data.
  27.  
  28. What's inside PPB?
  29.  
  30.     When PPB is started (CLI only, for now), you are presented with an
  31.     options window. Here you specify resolution and depth of the screen
  32.     that you will be using. The gadgets are as follows:
  33.  
  34.             320x200    320x400  ->    RESOLUTION 
  35.             640x200    640x400  ->    GADGETS
  36.              1  2  3  4  5   ->    DEPTH GADGETS
  37.             OKAY      Cancel ->    CHOICE GADGETS
  38.  
  39.     When you select a resolution gadget, if the depth is set for a depth
  40.     greater than is allowed for that resolution, the depth will
  41.     automatically be reset to the maximum allowed.
  42.  
  43.     Selecting OKAY enters PPB.
  44.     Selecting CANCEL returns you to the CLI.
  45.  
  46.     The next window that is presented is the current status. This shows
  47.     the author info, the current pen color, the current tool, the current
  48.     font, the current font size, available CHIP and FAST memory.
  49.     Use the CloseWindow gadget to proceed.
  50.  
  51.     Under the status window is the heart of PPB, the "Tool Screen".
  52.     This is where you control PPB. There are NO menus in PPB, everything
  53.     is controlled by the tool screen. When a tool is selected, the mouse
  54.     pointer will be changed to represent that tool. By doing this, if the
  55.     tool screen has been sent to the back of the display, you can identify
  56.     the current tool by the shape of the pointer.
  57.  
  58.     The SPACE BAR toggles the Tool Screen to the front/back of the display.
  59.  
  60.     THE GADGETS:
  61.  
  62.         1st Row:
  63.         CLEAR     = Clears the screen.
  64.  
  65.         UNDO     = Undoes the last action.
  66.                Keyboard Shortcut: U
  67.  
  68.         DRAW     = Allows freehand drawing.
  69.  
  70.         BOX     = Allows drawing rectangles.
  71.  
  72.         ELLIPSE     = Allows drawing ellipses.
  73.  
  74.         PAINT     = Allows filling an area with color.
  75.  
  76.         ZOOM     = Allows editing a potion of the current project.
  77.                See "Using The Zoom Funtion" below.
  78.  
  79.         TEXT     = Allows direct text entry. See "Text Note" below.
  80.  
  81.         2nd Row:
  82.             ORIGINAL = This is a supplement to the UNDO function.
  83.                After a pic has been loaded, and it's too late
  84.                to use UNDO, select ORIGINAL to get the pic back
  85.                without having to reload.
  86.                Keyboard Shortcut: O
  87.  
  88.         BG COLOR = Opens a requester for BackGround COLOR selection. 
  89.  
  90.         LINE     = Allows drawing lines.
  91.  
  92.         CIRCLE     = Allows drawing circles. See "Circle Note" below.
  93.  
  94.         FILL     = This works with BOX, CIRCLE, and ELLIPSE. It is a 
  95.                toggled function that allows filling to be done 
  96.                when drawn.
  97.  
  98.         BRUSH     = This allows creation of custom brushes.
  99.  
  100.         GRID     = This turns on/off the invisible grid, and sets the
  101.                grid-snap function.
  102.  
  103.         FONT     = This allows selection of the current Font.
  104.         
  105.         3rd Row:    
  106.             Note: For using the file requester, see "FR_User.Doc".
  107.  
  108.             OPEN PIC = Loads a pic file from disk.
  109.  
  110.         SAVE AS     = Save a pic file under a new name.
  111.  
  112.         OPEN BRU = Loads a brush file from disk.
  113.  
  114.         ASM SRC     = Saves current brush as Assembly Language source.
  115.  
  116.         C SRC     = Saves current brush a C Language source.
  117.  
  118.         PALETTE     = Open the Palette requester for color modification.
  119.  
  120.         STATUS     = Opens the Status window.
  121.         
  122.         4th Row:
  123.             SAVE PIC = Saves pic under current file name.
  124.  
  125.         PRINT     = Performs a 'Screen Dump' to the printer.
  126.  
  127.         IFF     = Saves current brush as an IFF file.
  128.                 See "Brush Note" below.
  129.  
  130.         BAS SRC     = Saves current brush a AmigaBASIC source.
  131.  
  132.         RAW DATA = Saves current brush as Raw Data with the option
  133.                of C language Image structure.
  134.  
  135.         RS GRID     = Resize the invisible grid.
  136.  
  137.         FONTS:     = Allows reAssigning the current FONTS: directory.
  138.                See "FONTS: Note" below.
  139.         
  140.         5th Row:
  141.             SAVE/EXIT = Saves current project under current file name,
  142.                 then exits PPB.
  143.         EXIT      = If project has NOT been saved you are asked if 
  144.                 you want to save it. If no, PPB exits. If yes,
  145.                 the project is saves and PPB exits.
  146.  
  147.     MOUSE POINTERS:
  148.         D.....................:    DRAW
  149.         L with arrow..........:    LINE
  150.         Square................:    BOX
  151.         Circle................:    CIRCLE
  152.         Oval..................:    ELLIPSE
  153.         Paint Roller..........:    PAINT
  154.         Small F lower right
  155.         of Box,Circle,Ellipse.:    FILL
  156.         Cross Hair w/rubberbox:    ZOOM
  157.         Cross Hair w/o box....:    BRUSH
  158.         T.....................:    TEXT
  159.  
  160.     Note: When using PAINT Mode, the "Hot Spot" of the pointer
  161.           is in the center of the roller section of the pointer.
  162.           It is also aligned with the left side of the roller handle.
  163.  
  164. Using The Zoom Function:
  165.  
  166.     Select Zoom from the Tools screen. Position the box that is attached 
  167.     to the pointer and click the left mouse button. Inside the Zoom window,
  168.     drawing will be allowed after the 'scanning phase'. The Zoom window
  169.     opens in 4x magnification. Current implemented magnification powers
  170.     are 4x, 8x, 16x. To change the power setting, click on the ZOOM gadget.
  171.     Scrolling is done using the cursor keys.
  172.     To select a new color, click the mouse Menu button.This is the same 
  173.     as when in the main drawing window.
  174.  
  175.     When finished with the Zoom, click on the close window gadget.
  176.  
  177. Using PPB:
  178.  
  179.     To select a color, press the mouse menu button. A requester will
  180.     appear for color selection. After selecting a color the requester
  181.     will disappear.
  182.  
  183.     For drawing Freehand, hold the left mouse button and do your drawing.
  184.     When drawing is to your liking, release the left mouse button.
  185.  
  186.     Please Note: The drawing is not continuous. Unless drawing is done
  187.              slowly, there will be breaks in the line.
  188.  
  189.     For drawing Lines, Boxes, Circles and Ovals, hold the left mouse 
  190.     button. When you are satisfied with the final position, release the 
  191.     left mouse button. If you are not satisfied, click the right 
  192.     mouse button to abort the operation.
  193.  
  194.     When using the OVAL and the CIRCLE tools, a cross-hair will appear
  195.     where the mouse is first clicked. This is a center point indicator.
  196.     Also, a box will be drawn when the mouse is moved. This shows the
  197.     x,y diameter of the oval or circle to be drawn.
  198.     
  199.     When using the Text function, move the pointer to where you want to
  200.     begin entering text, click the left mouse button and a box will 
  201.     appear according to the size of the current font. Normal keyboard
  202.     entry will then be allowed. 
  203.     Note: when either SHIFT or CAPS LOCK is engaged, all printable 
  204.     character will be their uppercase equivelent, INCLUDING the numeric 
  205.     keys on the main keyboard.
  206.  
  207.     To break out of TEXT mode, use the ESC key. To Abort TEXT mode use
  208.     the DEL key. By using the DEL key, it acts as UNDO erasing the 
  209.     current string.
  210.  
  211. Using The Palette Requester:
  212.  
  213.     The palette requester that is used is unique, in that there are no
  214.     sliders. What I have used in thier place are simple boolean gadgets 
  215.     (i.e. on or off). Modifying the palette to colors more to your liking 
  216.     is easy. You are presented with a number of gadgets. The description 
  217.     of the requester is as follows:
  218.  
  219.     R    ->     Indicates current Red Intensity.
  220.     G    ->     Indicates current Green Intensity.
  221.     B    ->     Indicates current Blue Intensity.
  222.     
  223.     The three "+" gadgets and the three "-" gadget are for increasing or
  224.     decreasing the color intensity by one (1). The intensity values are 
  225.     displayed in Hexadecimal.
  226.  
  227.     The long, thin block (at the top of the requester) of color is the 
  228.     current color indicator.
  229.  
  230.     On the right side of the requester, are the main color selection 
  231.     gadgets. Click one of these to select the current color to be modified 
  232.     (NOTE: These gadgets do not highlight in any way.).
  233.  
  234.     OKAY!    ->    Means that you are happy with your choices.
  235.     SWAP    ->    Allows swapping two colors.
  236.     RESET    ->    Resets the default colors.
  237.     CANCEL  ->    Resets the default colors and returns to the main 
  238.             program.
  239.     
  240. Using The Modify Grid Requester:
  241.     
  242.     This is where you can change the grid size. All functions in this 
  243.     requester can be accessed by either the mouse or keyboard.
  244.     Entry in the X or Y gadgets is in pixels.
  245.     
  246.     The Gadgets include:
  247.             X    ->    For modifying the left-right size.
  248.             Y    ->    For modifying the up-down size.
  249.             MODIFY    ->    This puts your changes into effect,
  250.                     and set the grid to the new values.
  251.             CANCEL    ->    This cancels whatever changes you have
  252.                     made, and resets the grid.
  253.  
  254.     The Keyboard Shortcuts are:
  255.             X    ->    Selects the X gadget.
  256.             Y    ->    Selects the Y gadget.
  257.             M    ->     Selcets the MODIFY gadget.
  258.             C    ->    Selects the CANCEL gadget.
  259.  
  260. Using The File Requester:
  261.     See the file "FR_User.Doc".
  262.  
  263.  
  264. TEXT Note:
  265.     When in TEXT mode, using the BackSpace key erases the previous
  266.     character using the background color. It is suggested that if 
  267.     the text is to be placed on a multi-colored background, that you 
  268.     enter your text in a large enough  area where the background color 
  269.     is visible.
  270.  
  271. CIRCLE Note:
  272.     When using CIRCLE in 320x400 or 620x200, the circle drawn is a vertical
  273.     ellipse. It is best to use the ELLIPSE function instead.
  274.  
  275. BRUSH Note:
  276.     When using a program such as Power Windows(tm), you will find that
  277.     IFF brushes created with PPB are used as images for gadgets, the width
  278.     has been extended to the next full WORD. I realise that this means 
  279.     extra work, but until I find a saving routine to correct this, we have
  280.     to live with it. This problem is not a problem with PPB source code
  281.     creation.
  282.  
  283. FONTS: Note:
  284.     The following files MUST be in your C: directory for the FONTS: 
  285.     function to work. C:Run and C:Assign.
  286.  
  287.     Thomas C. DeVeau            Compuserve ID#: 72500,21
  288.  
  289. ---------------------- CUT HERE ---------------- CUT HERE ----------------------
  290.  
  291. NAME..........:_________________________________________________________________
  292.  
  293. ADDRESS.......:_________________________________________________________________
  294.  
  295. CITY..........:_________________________________________________________________
  296.  
  297. STATE/PROVINCE:_________________________________________________________________
  298.  
  299. COUNTRY.......:_________________________________________________________________
  300.  
  301. AMIGA MODEL...:_________________________________________________________________
  302.  
  303. OS VERSION....:_________________________________________________________________
  304.  
  305. (Personal Info: this section is optional. Just curious about the users)
  306.  
  307. AGE:________________________________    GENDER:_________________________________
  308.  
  309.         Send this form and $5.00 (US) registration fee to:
  310.  
  311.                 Thomas C. DeVeau
  312.                 P.O. Box 594
  313.                 Manlius, N.Y. 13104-0594
  314.                 USA
  315.  
  316. Thank you for using PPB. 
  317.