PCjs Machines

         


       ******************* HOW TO USE QBPaint VERSION 1.0 ***************** 



       ====================================================================
          
                                   CONTENTS 
                                                         Page
       QBPaint's Tile Design Screen                       1 
       Getting Started: Entering Colors                   2 
       How Many Rows?                                     3 
       Painting the Display Circle                        4 
       Examples of Paint Tile Patterns                    5 
       Printing the Tile Formula                          6 
       Using Paint Tiles in Your Own Program              7, 8 

       ====================================================================


       QBPaint's TILE DESIGN SCREEN

           The screen on which you create a new paint tile has five 
       components: 
           
           (i) In the DIALOGUE BOX in the center of the screen, you 
       are prompted for information about the tile.  Type the
       appropriate response to each question and press the Enter key.
       "Yes/no" answers can be given as "y/n" if you wish. 

           (ii) The PALETTE at the top displays the 15 colors that can be 
       used in a paint tile. 

           (iii) The TILE ENLARGEMENT grid on the left gives an enlarged 
       view of the tile you are creating. Each box of the grid represents 
       one screen pixel (one point on the screen), so that a completed 
       design grid gives a greatly magnified view of a graphic unit that 
       will be 8 pixels wide and a maximum of 16 rows tall.  

           (iv) After you complete each row of the tile enlargement, the 
       PAINT TILE DISPLAY circle on the lower right is painted with the 
       current form of the tile in its true size.  This is the same 
       display a PAINT statement in your own program will give in screen
       mode 9. 
        
           (v) The TO CREATE A TILE box in the upper right screen 
       follows your progress through the process of tile creation by 
       highlighting your current stage.                                                           

       ******************************************************************** 
           HELP!!  Get on-line help during tile creation by pressing the 
       <F1>  key. 
       ******************************************************************** 

                                                                Help : 2

       GETTING STARTED: ENTERING COLORS 

           In the  dialogue box,  QBPaint  prompts you for a color with 
       which  to color each of the eight boxes (i.e., pixels) of row A 
       (A1, A2,...,A8) of the  tile enlargement grid.  

       ******************************************************************** 
       From the PALETTE choose a color 1 through 15, type its number 
       next to the A1 prompt, and press the <Enter> key.  
       ********************************************************************
        
       Supply a number for each of the other boxes of row A in the same 
       manner. 


           To save time, use this shortcut whenever possible:

       ********************************************************************
       To repeat a color, just press <Enter>.  Hint: You can fill a row 
       whose boxes all need the same color very, very quickly by  just 
       holding down the <Enter> key!
       ********************************************************************

       For example, if you press <Enter> when you are prompted for a color
       for box A7, the color given to A6 will also be assigned to A7.  
       Pressing <Enter> at the prompt for box D1 assigns the color of  box 
       C8 to box D1.  If you are prompted for a color for box F8 and enter 
       "B" repeatedly to back up until you reach box F3, then press 
       <Enter>, the  color assigned  to box F2 will  be assigned to box F3.    
       

           This brings us to the third possible response to the prompt for 
       a box color: 
        
       ******************************************************************** 
       To go back to a previously colored box on the tile enlargement
       grid, enter "B" instead of a palette color.
       ********************************************************************

       The "B" feature erases the color from the previous box, and prompts
       you for a new color for that box.  You can back up along the current
       tile row  as far as needed,  erasing all box colors along the way.
       However, you cannot back up onto the previous row.  In other words,
       entering a color for box 8 of a row "locks in" all color entries  for
       that row.

                                                                HELP : 3

       HOW MANY ROWS?

           At the end of each row, QBPaint queries whether to begin a new 
       row.  A response of "no" signals the program that the tile design 
       is complete, and you will be given the option to print the tile 
       formula.  

       ******************************************************************** 
           A paint tile can consist of as little as one row of pixels or be 
       as tall as 16 rows.  It is always 8 pixels wide. 
       ******************************************************************** 

       (The earlier versions of BASIC may accept tiles of up to only
       8 rows.) 

                                                                Help : 4

       PAINTING THE DISPLAY CIRCLE 
       
       ******************************************************************** 
           After you supply a color for box 8 of each row, QBPaint paints 
       the display circle (in screen mode 9) with the current form of the
       tile you are  creating. 
       ******************************************************************** 

       The appearance of the tile pattern when your own program displays  
       it  will vary  somewhat  depending on which EGA/VGA screen mode is 
       used.  QBPaint shows the appearance of your paint tile in screen 
       mode 9.

           With each successive row of colors that you add to the tile 
       enlargement grid, the tiny tiles in the display circle "grow."  
       For your first few tile patterns, it will be much easier to see the 
       relationship between the single tile shown in the tile enlargement  
       grid and the repetition of the pattern in the tile display circle, 
       if the pattern is bold and simple.  For example, try a two- or 
       three-color tile consisting of large diamonds on a solid back-
       ground, perhaps with a single dot in the center of the diamond.
       As the tile grows in height on the enlargement grid, you can pick 
       out the tiny individual tiles lined up in the tile display circle.

           If  your tile design is complex, the appearance of the finished 
       paint tile in  the  display circle  may be different  than  you 
       anticipate.  While the design of strictly  geometrical  patterns  
       is straightforward,  constructing a textured or shadowy effect 
       from  component  colors is complicated.  Rapid experimentation  
       will probably  show  you more  quickly how adjacent colors blend 
       than  would  an   inordinate   amount of time  planning. 
       Typographical errors made   while  entering  color choices  often 
       result in an interesting effect  difficult  to plan or anticipate. 

           Upon registering your ownership of QBPaint, you will receive 
       Version 2.0, in which you can make an unlimited number of revisions 
       on your paint tile.  By  observing  the effects created by  color 
       changes,  corrections, additions, and deletions on your tile pattern  
       which  is  shown in the paint tile display circle,  you can quickly 
       find the subtle  touches  needed  to  enhance  your first try  at a 
       particular design. 

           The  revision  capabilities of  Version 2.0,  also  make the 
       conversion  to and saving of  one tile pattern in different color 
       schemes  nearly   instantaneous.  This is illustrated in the demo, 
       "A Look at QBPaint  Version 2.0." 



                                                                 Help : 5

       EXAMPLES OF PAINT TILE PATTERNS
 
           EXAMPLE: Create vertical stripes by supplying the colors for 
       just one row.  Suppose you assign these palette values to the eight 
       boxes of row A: [ 4 - 4 - 4 - 4 - 15 - 15 - 15 - 15 ].  This colors 
       boxes A1 to A4 of the enlargement grid red, and boxes A5 to A8 white.  
       When this design is repeated vertically (and horizontally) on the 
       screen by a PAINT command in your program, the result will be evenly 
       spaced red and white vertical stripes. Pixels in a painted section of 
       the screen would be colored thusly:

       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15
       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15
       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15
       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15
       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15
       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15
       4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15 4  4  4  4 15 15 15 15

       (A simple variation:  [ 4 - 4 - 15 - 15 - 15 - 15 - 15 - 15 ].  This 
       creates a pattern of narrow red stripes and wide white stripes.) 

           HINT: If the screen area to be painted is small, say less than
       an inch wide, a tile pattern composed of many narrow stripes may 
       look better than a pattern  of just two wide stripes.  For example, 
       try these colors:  [ 4 - 2 - 3 - 1 - 2 - 5 - 3 - 2 ].


           EXAMPLE: Fill two rows of the design grid by alternating two 
       colors This produces a solid color whose hue is between those of 
       the two component colors. 

           EXPERIMENT: By including more rows in your pattern, you can 
       create more complex geometric designs, interesting color 
       highlights, and textured and shadowed effects.  Try creating some 
       tiles that are 6 or so rows tall with random color choices to get 
       an idea of the wide range of possible effects. 


           EXAMPLE: The "TileEq.BAS" file of QBPaint contains the formula 
       of a paint tile called Leaf11$. To see its pattern  displayed on 
       screen, select "Sample Paint Tiles for Your Own Program" from the 
       Main Menu of QBPaint.  These are the palette values used to color 
       the tile enlargement grid of Leaf11$:

       Row A:   2  -  2  -  2  - 10  -   2  -   2  -   2  -   2
       Row B:   2  -  2  - 10  - 10  -  10  -   2  -   2  -   2
       Row C:   2  -  2  - 10  -  2  -   3  -  10  -   2  -   2
       Row D:   2  -  2  - 10  -  3  -   2  -  10  -  10  -  10
       Row E:   2  - 10  - 10  -  2  -   2  -   2  -   3  -  10



                                                                Help : 6

       PRINTING THE TILE FORMULA

           After you signal that no more rows are to be added to the tile 
       pattern,  QBPaint  queries on whether you want  to print the tile 
       formula.  In Version 1.0 you save the formula for future use by 
       printing it  on the printer,  or by printing it  on screen and 
       hand-copying it. (Note: QBPaint does not report an unsuccessful 
       attempt to print on the printer.  Be sure to verify  that you have 
       printed  a copy  of the paint tile equation  before skipping the 
       option to print on screen.)

       ******************************************************************** 
       In QBPaint Version 1.0, IF YOU CHOOSE NOT TO PRINT THE PAINT TILE 
       FORMULA,  YOUR PAINT TILE  WILL NOT BE SAVED IN ANY FORM. 
       ******************************************************************** 

       You supply the tile name, following the normal guidelines for 
       naming strings (it must end with the symbol $).  QBPaint adds the
       string symbol $ to the tile name if it is omitted. Sample paint tile 
       names are tile$, brick$, greentexture1$, redblend$. A descriptive 
       name will help you to recall its appearance. 

           Rather than naming each tile uniquely, it is often convenient 
       to make it a numbered member of a collection, such as 
       greentexture1$, or VertStripe7$. 

           The registered users' Version 2.0 has several new  features 
       related to saving the tile.  Most importantly, it can save the paint 
       tile name and formula on disk in a .BAS file, like the TileEq.BAS 
       file included on the QBPaint Version 1.0 disk.  You can   then 
       electronically copy it to your own program using the copy/paste 
       feature of the QuickBASIC editor -- no typing necessary.  

           Secondly, along with the tile name, you can save remarks about 
       the  tile, possibly a description of it or ideas for its future use. 

           Finally, all tiles that you save are automatically stored in a
       file similar to the "Sample Paint Tiles..." section of Version 1.0, 
       so that you can later display on screen any or all tiles labeled by 
       name to recall their appearances. The saved tile pattern can also be 
       loaded into QBPaint for further revision.

                                                               Help : 7

       USING PAINT TILES IN YOUR OWN PROGRAM 

           Two steps are necessary to use a paint tile in your program 
       after it has been created and saved: 

       1.  Insert its formula into the program at a point prior to its 
           use in a PAINT statement. This can be done either as an 
           equation(s) or as data that is read in. 

       2.  Insert the name of the tile in the PAINT statement in place 
           of a numeric color value.  

           INSERT AS EQUATION(S): The most straightforward way of 
       inserting the formula into your program is to type it as a one-
       line equation.                                               
       __________________________________________________________________ 
       Coding Example: 

         'Set EGA graphics mode:
              SCREEN 9 
         
         'Insert tile equation:
              PaintTile$ = CHR$(250) + CHR$(120) + CHR$(2) + ... + CHR$(55) 
         
         'Draw circle w/ radius 100 at screen coords. 200,100 in clr 8:
              CIRCLE (200, 100), 100, 8 
         
         'Begin painting at screen coords. 200,100 with tile pattern
         'PaintTile$, until border color 8 is reached:
              PAINT (200, 100), PaintTile$, 8 
       ___________________________________________________________________
        
           Note that when QBPaint prints the tile formula on the printer 
       or on  screen, it has  for clarity  been broken into several lines.  
       As you type  the formula  into your program, you should, of course, 
       join them to make a single line.

           EQUATIONS FOR AN .EXE FILE: If the file is to be made 
       executable, an error will be generated during compile time if the 
       equation contains more than twelve CHR$() elements (each row of a 
       tile contributes four CHR$() elements).  Because of this, a long 
       equation must be divided into smaller equations.   The file 
       TileEq.BAS on the Version 1.0 disk contains examples of paint tile 
       equations that have been broken into component equations of 12 or 
       fewer elements  each.  The final equation is a concatenation of 
       the component equations.  
           Thus, for an .EXE file the tile equation line of the coding 
       example above might need to be replaced by something like: 

       ------------------------------------------------------------------

        PaintTileA$ = CHR$(250) + CHR$(120) + CHR$(2) + ... + CHR$(225)  
        PaintTileB$ = CHR$(15) + CHR$(125) + CHR$(185) + ... + CHR$(155) 
        PaintTileC$ = CHR$(250) + CHR$(35) + CHR$(190) + ... + CHR$(55) 
        PaintTile$ = PaintTileA$ + PaintTileB$ + PaintTileC$         

       -----------------------------------------------------------------

                                                                Help : 8
       
           INSERT AS DATA: An alternative to using equations is to read 
       in values for each of the CHR$() elements through a loop. 

       __________________________________________________________________ 
       Coding Example: 

         READ num%                        'read number of elements in eq. 
         
         For i% = 1 to num%
            READ info%                    'read equation values 
            tile$ = tile$ + CHR$(info%)   'build formula 
         NEXT i%
         
         CIRCLE (200, 100), 100, 8        'draw a circle
         PAINT (200, 100), tile$, 8       'paint the circle
          . 
          . 
          .
         END
        
         'Values for num% and the CHR$() elements:
         DATA  20
         DATA  255, 255, 0, 4, 120, 180, 140, 100, 100, 225, 185, 15 
         DATA  200, 135, 155, 0, 160, 55, 255, 170  
       _________________________________________________________________ 

           As with any PAINT command, the coordinates of the area to be 
       painted must lie within the border, not on it, and the area must 
       be totally enclosed by a boundary of one color, or the "paint" 
       will flood the screen.  

           NOTE: QuickBASIC's LINE, CIRCLE, and DRAW commands do not 
       accept a paint tile string as the color parameter.  Hence, the 
       border of the graphic must be drawn by one of the usual colors 
       numbered 0 to 15. 

           To use the formulas of tiles created by QBPaint Version 1.0, 
       you will need to enter the formula into your program via the 
       keyboard.  

           As previously noted, the registered users' Version 2.0, saves 
       the tile formula in a .BAS file like TileEq.BAS which is included 
       on the QBPaint Version 1.0 disk.  TileEq.BAS contains the formulas 
       of two paint tiles shown in the "Sample Paint Tiles..."  section.  
       To copy and use them in your BASIC program, load  TileEq.BAS into 
       the BASIC environment  on your computer,  and use the copy/paste 
       feature of the editor.   (More detailed instructions  for copying 
       are given in  TileEq.BAS.) 


                                ---   END  ---            


       ************* INTRODUCTION TO PAINT TILES AND QBPaint ************ 


           QBPaint Version 1.0 is the shareware edition of QBPaint.  It 
       may be copied and distributed freely as long as these restrictions 
       are met:

           1. No part of the program is deleted or changed in any way.

           2. The charge, if any, for a copy of this shareware version
              of QBPaint is within the normal range of current market 
              prices for shareware.
           
           The copyright of QBPaint Version 1.0 is intended primarily
       to establish authorship and reserve revision rights, and does
       not limit the right to make copies of this version.

           QBPaint is a graphics utilities software package for 
       programmers using QuickBASIC, QBASIC, BASIC 7.0 Professional 
       Development System,  or earlier versions of the BASIC programming 
       language beginning with 2.0.  The paint tiles created can be 
       displayed by the PAINT statement in BASIC programs that use EGA 
       and VGA screen modes. 
           
           In QBPaint the user designs background and fill patterns known 
       as "paint tiles" on screen.  The formula representing each tile is 
       automatically calculated, and provided for transfer to BASIC 
       programs.    
           
           Whether you are a beginner or advanced programmer, if you know 
       how to use the PAINT command in your program, you can create and 
       paint with paint tiles with the help of QBPaint. 
           
           A paint tile is a small rectangular graphic unit which is used 
       repeatedly to cover an enclosed area of the screen in the same way 
       that a building's wall might be covered with identical ceramic 
       tiles. Upon execution of the PAINT command, QuickBASIC floods the 
       area with the tile pattern, in the same manner that it PAINTS with 
       one of the standard colors numbered 0 to 15.                                                               
           
           Using paint tiles makes possible a great variety of effects:  
       highlights and shading, interesting patterns and textured effects,  
       geometric patterns, and intermediate shades of color not available 
       in the standard numeric palette. QBPaint Version 1.0 displays a 
       number of examples of paint tiles on its opening screens, in 
       "Sample Paint Tiles...," and in the demonstration entitled, "Paint 
       Tiles in Action." 

                                                                Intro : 2

           Without the help of software such as QBPaint, creating paint 
       tiles to use in EGA and VGA screen modes (modes 7 and above) is 
       very complicated and very tedious.  This shareware version of 
       QBPaint enables the user to try out the rudimentary process of 
       designing a tile on screen and printing its formula.  If you 
       intend to continue designing paint tiles it is recommended that 
       you register with the author and receive a free copy of QBPaint 
       Version 2.0.   

           Version 2.0 allows unlimited on-screen corrections and 
       revisions as you design a tile.  It saves the tile's formula on 
       disk in a .BAS file so that no retyping of lengthy formulas into 
       your own program is necessary.  It also stores all patterns in a 
       graphics file, so that you can later view any or all of the paint 
       tiles that you have created and saved (to select one either for 
       use in a program or for further revision).  

           The QBPaint Version 1.0 package includes: 
  
       QBPaint.EXE        by running this you can:
                          -construct a paint tile and print its formula; 
                          -print Intro.DOC, Help.DOC, and  Register.DOC
                              on screen or printer;
                          -see a demo showing a screen before and after 
                              painting with paint tiles; 
                          -see a demo of QBPaint Version 2.0; 
                          -see "Sample Paint Tiles for Your Own Program" 

       Intro.DOC          the present document (2 pp.)

       Help.DOC           how to construct, save, and use a paint tile (8 pp.)

       Register.DOC       how to register QBPaint and the benefits of 
                          doing so (1 p.)

       TileEq.BAS         paint tile formulas that you can copy to your
                          own BASIC program by loading the file into a 
                          BASIC environment.  Their patterns are 
                          displayed in "Sample Paint Tiles..." which is 
                          accessed from the Main Menu of QBPaint.EXE 

       The .DOC files can also be printed from the DOS level.

       TECHNICAL INFORMATION

           QBPaint Version 1.0 was written entirely using QuickBASIC 4.5 
       with the exception of the .DOC files (which were written with a 
       word-processing program).
                                            
       LEGAL NOTICE 
                               
           QuickBASIC, QBASIC, and BASIC 7.0 Professional Development 
       System are trademarks of Microsoft Corporation. 


       ********************** REGISTERING QBPAINT **********************
                                                                      
           I hope you enjoy looking over this shareware version of    
       QBPaint.  Comments regarding it are most welcome. 

           The beauty of QBPaint is that it is a timesaver. Version 1.0
       has saved you the trouble of designing a tile on paper  and 
       working through a lot of complicated math to figure its formula 
       (without really knowing how the pattern will look on screen). 

           QBPaint Version 2.0 picks up where Version 1.0 leaves off. 
       If you have a tile pattern that you like, it lets you save the 
       formula in a .BAS file so you can insert it into your program 
       more quickly and accurately than you could by typing.  If you 
       want the same pattern in a different color, just use the 
       Exchange Color option.  Correct typos and try changing a pixel 
       here and there on your original design without having to start 
       over. Rotate the tile or add entire row of colors with quick 
       two-letter commands. Browse through a slide show of your tile 
       patterns to select one for further revision or for use in a 
       program.   Faster, easier. 

           Anticipated features of forthcoming versions of QBPaint 
       include the ability to color the boxes of an empty tile 
       enlargement grid in any sequence, optional mouse support, 
       and larger paint tiles. 
       
           Register your ownership of QBPaint if you have found it 
       useful. Upon receipt of your registration, a copy of QBPaint 
       Version 2.0 (or a later version if available) will be sent to 
       you.  The program is available on both 5.25" and 3.5" disks; 
       the 5.25" disk will be sent if no preference is indicated. 

       SUPPORT THE SHAREWARE MARKETING CONCEPT.  IF YOU CONTINUE 
       TO USE ANY PART OF THIS SOFTWARE, PLEASE REGISTER WITH THE 
       AUTHOR.  THANK YOU. 

       ***************************************************************** 
           To register and receive a copy of the latest version 
       of QBPaint, send a check for $15.00 to
                        
                        P. Oliva 
                        P.O. Box 39
                        Commack, NY  11725
       
       July 1992 
       ***************************************************************** 


 Volume in drive A has no label
 Directory of A:\

PC-SIG            1531   9-14-92   2:38p
QBPAINT  EXE    250148   7-25-92   8:30a
INTRO    DOC      5399   7-25-92   8:54a
HELP     DOC     19158   7-24-92   8:52p
REGISTER DOC      2512   7-24-92   8:55p
TILEEQ   BAS      8987   7-23-92  10:14a
GO       BAT        34  10-05-92   2:54p
SHOW     EXE      2040   9-12-88  10:48a
        8 file(s)     289809 bytes
                       28672 bytes free