home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GR / GR034.ZIP / MBTUTOR.DOC < prev    next >
Text File  |  1989-08-14  |  43KB  |  918 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.        
  21.                           MAGIC  BRUSH and MAGIC SHOW
  22.  
  23.                                  Version 1.50 
  24.  
  25.  
  26.                                    Tutorial
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                                 
  43.  
  44.                                              
  45.                                              
  46.                                              
  47.                                              
  48.                                              
  49.                                              
  50.                                              
  51.                                              
  52.                                              
  53.                                              
  54.                                              
  55.  
  56.      Copyright (C) 1988, 1989 by Nassib Nassar, SoftBrush 
  57.      Member, Association of Shareware Professionals
  58.  
  59.  
  60.  
  61.  
  62.      MAGIC BRUSH/MAGIC SHOW Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                                     
  70.                             DISCLAIMER OF WARRANTY
  71.  
  72.      THIS  SOFTWARE  AND  DOCUMENTATION ARE SOLD "AS  IS"   AND  WITHOUT 
  73.      WARRANTIES  AS TO PERFORMANCE OR MERCHANTABILITY.   THESE  PROGRAMS 
  74.      ARE SOLD WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES WHATSOEVER.  THE 
  75.      USER  IS ADVISED TO TEST THE PROGRAMS THOROUGHLY BEFORE RELYING  ON 
  76.      THEM.   THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAMS.  
  77.      ANY LIABILITY OF SELLER OR MANUFACTURER WILL BE LIMITED EXCLUSIVELY 
  78.      TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE PRICE. 
  79.  
  80.  
  81.  
  82.  
  83.  
  84.                               SOFTWARE LICENSE
  85.  
  86.      MAGIC BRUSH, MAGIC SHOW, SNAPSHOT, MB.TP, and MBDMO are Copyright (C) 
  87.      1988,1989 by Nassib Nassar, SoftBrush.  All Rights Reserved.  You may 
  88.      use, copy, and distribute this software provided that all of the 
  89.      following conditions are satisfied: 
  90.      - The software is distributed complete and without any modification, 
  91.        addition, or omission, including all text and ancillary files.  No 
  92.        fee may be charged in connection with the distribution of this 
  93.        software except as specified in the file called VENDOR.DOC which is 
  94.        part of this software.
  95.      - It may not be distributed on the same diskette with other software 
  96.        or text or other files without express prior written permission from
  97.        the author (except as indicated in the accompanying file 
  98.        VENDOR.DOC).  Files on distribution diskettes shall not be 
  99.        compressed. 
  100.      - No part of the Reference Manual may be copied or distributed in any 
  101.        form.           
  102.      - The software is not distributed as part of or in conjunction 
  103.        with any other software package, or in conjunction with or as part 
  104.        of or installed on any computer or hardware system, without the 
  105.        express prior written permission of the author. 
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                   - ii -
  120.              
  121.  
  122.      MAGIC BRUSH/MAGIC SHOW Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  123.  
  124.                                  TUTORIAL                        
  125.                                Version 1.50
  126.               Please read the README.DOC file (type README)
  127.        * CAUTION: Do NOT run SNAPSHOT before reading this file * 
  128.  
  129.      The following tutorial is intended to allow you to start using MAGIC 
  130.      BRUSH and MAGIC SHOW right away.  It is not intended to replace the 
  131.      Magic Brush Reference Manual, which you should consult for detailed 
  132.      information, and for many features that cannot be covered in a quick 
  133.      tutorial.  The Manual also contains many hints and suggestions.
  134.  
  135.      This tutorial will guide you, step by step, through various commands  
  136.      in order to acquaint you with the mode of operation of the program.  
  137.      After you go through it, please read the Reference Manual in order to 
  138.      be able to fully utilize all the features of MAGIC BRUSH, MAGIC SHOW, 
  139.      SNAPSHOT, and MB.TP provided as part of Magic Brush.  Also please 
  140.      refer to the Manual if you would like to configure MAGIC BRUSH to read 
  141.      picture files and library files by default from subdirectories or 
  142.      drives you specify, or if you would like to configure it to work with 
  143.      a mouse or joystick (including modifying the function of the mouse or 
  144.      joystick buttons).
  145.  
  146.          Run Magic Brush    Load MAGIC BRUSH: type  MB and press ENTER 
  147.   
  148.          Cursor movement    The cursor appears in the middle of the screen.  
  149.                             To move the cursor, press one of the eight 
  150.                             cursor keys (on the numeric keypad) in the 
  151.                             desired direction. If the cursor does not 
  152.                             respond, it may be that Num Lock is "on": press 
  153.                             the Num Lock key once to set the keypad in the 
  154.                             cursor mode. Each press of a cursor key moves 
  155.          Cursor lost?       the cursor one pixel.  If you lose the cursor, 
  156.          [H]                press [H] to put it in the center of your screen 
  157.                             (if that fails, perhaps you inadvertently 
  158.                             changed its color to the background color: try 
  159.                             pressing the + key on the numeric keypad to 
  160.                             change pen color. 
  161.   
  162.          Pen down [Ins]     Press [Ins] for PEN DOWN. Now moving the 
  163.          pen up   [Del]     cursor will allow you to draw freehand.  For 
  164.                             PEN UP, press [Del]. 
  165.   
  166.          Cursor interval    Press 5 (at the top of the keyboard).  Press a 
  167.          [I]                cursor key: the cursor moves five pixels.  You 
  168.                             can chose any cursor INTERVAL from 1 to 10.  
  169.                             This allows you to move quickly over the 
  170.                             screen, and also to move by equal increments or 
  171.                             draw lines of equal length.  Press I to enter 
  172.                             an INTERVAL greater than 10 (up to 99).
  173.   
  174.          Help Screen        Press function key F1.  The on-line Help Screen 
  175.          [F1]               is displayed.  This shows the MAGIC BRUSH 
  176.                             commands arranged in fairly logical groupings, 
  177.                             within the space limitations of the screen.  
  178.  
  179.                                    - 1 -
  180.   
  181.  
  182.      MAGIC BRUSH TUTORIAL   Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  183.  
  184.                             Under the section marked ** Colors:  you can 
  185.          Pen color          see that [+] will change PEN COLOR.  While 
  186.          [+, -]             displaying the Help Screen, press [+]; the 
  187.                             drawing screen returns and the cursor color is 
  188.                             changed.  If you move the cursor with PEN DOWN, 
  189.                             you will draw in the new color.  Notice that 
  190.                             you can enter your commands directly from the 
  191.                             Help Screen, which makes it a "quasi menu".  
  192.                             Press [+] several times; the cursor cycles
  193.                             through four colors, including the background 
  194.                             color (cursor invisible). 
  195.   
  196.          Pen Thickness      With PEN UP ([Del]), select a (visible) PEN 
  197.          [Ctrl-T]           COLOR ([+]).  Press Ctrl-T and enter 3 <CR> to 
  198.                             choose a pen THICKNESS of 3.  Press [Ins]), and 
  199.                             move the cursor to draw.  
  200.  
  201.          Dot mode           Press [;] (semicolon) to select "dot' mode.  
  202.          [;]                Select pen down ([Ins]), THICKNESS of 5 (Ctrl-
  203.                             T), and cursor INTERVAL of 6 (press 6 at the 
  204.                             top of the keyboard).  Now move the cursor to 
  205.                             draw "dots" 5 pixels to the side. Change the 
  206.                             THICKNESS or the cursor interval, and try 
  207.                             again.  Press [;] again to toggle "dot" mode 
  208.                             off. 
  209.  
  210.          Erase screen       Clear the screen by pressing Ctrl-Home.  
  211.          [Ctrl-Home]        Now press [U] to restore it.  [U], in many 
  212.                             cases "undoes" the last operation if no 
  213.          Undo               intervening keys are pressed (see Reference 
  214.          [U]                Manual for list of operations that can be 
  215.                             reversed with [U]). Make sure pen is up ([Del]) 
  216.                             and clear the screen again to start afresh. 
  217.   
  218.          Paint              Select PEN COLOR cyan ([+]), and pen THICKNESS 
  219.          [P]                4 (Ctrl-T).  Select PEN DOWN ([Ins]), and draw 
  220.                             a polygon or any figure that is fully enclosed.  
  221.                             Select PEN UP, and move the cursor inside the 
  222.                             figure.  To paint the inside of the figure 
  223.                             magenta, first select PEN COLOR magenta (([+]), 
  224.                             and press [P].  Enter the number that 
  225.                             corresponds to the the color of the border (1, 
  226.                             in this case, since the polygon sides are cyan) 
  227.                             followed by <CR>.  The figure will be painted 
  228.                             magenta.  Note that painting is with the 
  229.                             currently selected PEN COLOR and the paint 
  230.                             spreads from the cursor location to the 
  231.                             "border" of the color you specified.  If paint 
  232.                             "leaks", that would be because either your 
  233.                             figure was not completely enclosed, or you 
  234.                             entered the wrong number corresponding to the 
  235.                             border color: press [U], make sure your figure 
  236.                             is completely enclosed, then repeat the 
  237.                             operation.  (please refer to the Reference 
  238.                             Manual for a more complete explanation). 
  239.  
  240.                                    - 2 -
  241.  
  242.      MAGIC BRUSH TUTORIAL   Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  243.   
  244.          Lines              To draw Lines between any two points on the 
  245.          [L]                screen, the ends of the lines must first be 
  246.          Mark points        Marked: select PEN UP, place the cursor at the 
  247.          [M]                beginning of the desired line, press [M] to 
  248.                             Mark the point (notice the word "Marked" 
  249.                             flashes in the top left corner of the screen to 
  250.                             confirm that a point was marked).  Mark the end 
  251.                             of the desired line ([M]).  Select PEN COLOR 
  252.                             ([+]), and press [L] to draw the line.  Mark 
  253.                             another point, and press [L] to continue the 
  254.                             line.  Or mark two new points and draw a line 
  255.                             between them.  Press [U] to remove the last 
  256.                             line you have just drawn. 
  257.  
  258.          Rectangle          Clear the screen (Ctrl-Home).  To draw a box or 
  259.          [R]                a Rectangle, Mark first the upper left corner, 
  260.                             next Mark the lower right corner of the 
  261.                             Rectangle.  Press [R] to draw a Rectangle.  
  262.                             Change PEN COLOR ([+]), and press [R] to change 
  263.                             its color.  Change pen color again, and press 
  264.                             [F] to Fill it with chosen PEN COLOR.  Change 
  265.                             pen color again and press [R] to draw a border 
  266.                             (rectangle) around the filled rectangle. 
  267.    
  268.          Circle:            Clear the screen if you like (Ctrl-Home).  
  269.          Center             Press [C] to draw a circle, its center 
  270.          & Radius           will be the first point marked (top left corner 
  271.          [C]                of the Rectangle drawn above) and the circle 
  272.                             will pass through the second marked point.  
  273.                             Notice that the old marked points remain until 
  274.                             replaced with new points (see Magic Brush
  275.                             Reference Manual for a complete discussion 
  276.          Circle:            of marked points).  Now try to press [D].  A 
  277.          Diameter           circle will be drawn whose diameter lies on the 
  278.          [D]                two marked points.  Thus to draw a circle when 
  279.                             you specify its diameter, mark the two points 
  280.                             defining the diameter and press [D]. 
  281.    
  282.          Cut & Paste        Draw any figure.  Mark ([M]) the upper left 
  283.                             corner first, then the lower right corner  of a 
  284.                             rectangle that contains the figure you want to 
  285.                             cut.  To see the exact location of the marked 
  286.                             points and the rectangle that they define, 
  287.          Status screen      press and hold [Shift].  The screen now shows 
  288.          [Shift]            two Status lines (at the top and the bottom) 
  289.                             indicating the current status of many of the 
  290.                             program parameters.  The center section of the 
  291.                             screen shows the exact location of the marked 
  292.                             points surrounded by two small circles, and a 
  293.                             diagonal line joining the marked points.  Note 
  294.                             that [untitled] appears on the top status line 
  295.                             indicating that the drawing has not yet been 
  296.                             written to disk, and has not been given a name.   
  297.  
  298.                             
  299.                               
  300.                                    - 3 -
  301.  
  302.      MAGIC BRUSH TUTORIAL   Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  303.  
  304.          Cut   [\]          Release the [Shift] key and press [\] to cut the 
  305.          Paste [/]          marked area (speaker "ticks"). Move the cursor to 
  306.                             a new location, and press [/] to paste.  Pasting 
  307.          Paste modes        can be done in TRANSPARENT, OPAQUE, or MERGE 
  308.          [Ctrl-\]           modes (selected by pressing Ctrl-\).  Try pasting 
  309.                             using the three modes.  Once cut, the figure 
  310.                             stays in memory until a new figure is cut (or 
  311.                             until you exit the program); it can therefore 
  312.                             be pasted repeatedly  (please refer to the 
  313.                             Reference Manual for a more complete explanation 
  314.                             of the paste function). 
  315.  
  316.          Flipping           Press Ctrl-V: you will hear a ticking sound as 
  317.          [Ctrl-H, Ctrl-V,   the program flips the figure you had cut        
  318.          Ctrl-D]            vertically; when the ticking sound ceases,      
  319.                             paste again (Ctrl-/).  Try Ctrl-H (horizontal   
  320.          90 degree          flip) in a similar manner.  Ctrl-D flips along  
  321.          rotation           a diagonal.  Combining diagonal, horizontal,    
  322.                             and vertical flips allows you to rotate the cut  
  323.                             figure (and Text, see below) 90 degrees. 
  324.         
  325.          Text               To add Text, choose PEN COLOR ([+]), then press 
  326.          [T]                [T] and write your text followed by <CR>.  Only 
  327.                             one line of text can be entered.  Text entered 
  328.                             can now be pasted at the cursor position by 
  329.                             pressing [/].  Multiple lines can be entered 
  330.                             and pasted, one at a time.  Any figure you had 
  331.                             previously cut will no longer be in memory (it 
  332.                             will be replaced by the text you entered).  
  333.                            
  334.          Plot               With PEN UP, you can draw or PLOT one point at 
  335.          [`]                a time by pressing [`].  The size of the point 
  336.                             is determined by the pen THICKNESS (Ctrl-T). 
  337.                             
  338.          Spray              Pressing [*] selects SPRAY mode ON or OFF.  
  339.          [*]                Select SPRAY ON, and with PEN DOWN you can 
  340.                             "spray paint".  You can experiment with 
  341.          Spray size         different PEN COLORs on the same area.  The 
  342.          [Ctrl-Y]           width of the spraY can be selected by pressing 
  343.                             Ctrl-Y.  Try PLOTting in SPRAY mode: this 
  344.          Spray burst        provides very good control since it sprays in 
  345.          [`]                single bursts. 
  346.                             
  347.          Writing to disk    Pictures can be Written (saved) to a disk file 
  348.          [Alt-W]            by pressing Alt-W.  You should enter a file 
  349.                             name.  The program adds an extension .MB to the 
  350.                             name.  Press Shift, and note that the name of 
  351.                             the file now appears on the top Status line.
  352.                            
  353.          Reading from disk  A MAGIC BRUSH picture file can be Read (loaded) 
  354.          [Alt-R]            and displayed on the screen by pressing Alt-R 
  355.                             and entering the name of the file.                 
  356.  
  357.  
  358.  
  359.  
  360.                                    - 4 -
  361.  
  362.      MAGIC BRUSH TUTORIAL   Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  363.  
  364.  
  365.          Symbols            Draw a figure, mark it, and cut it.  Save it on  
  366.          [Alt-X]            your disk as a "symbol": press Alt-XW and enter  
  367.                             a file name (MAGIC BRUSH  will add an extension  
  368.                             of .SB).  Erase the screen (Ctrl-Home) and draw  
  369.                             another figure, cut it, and paste it somewhere  
  370.                             else on the screen.  Now read the "symbol" file 
  371.                             by pressing Alt-XR.  It is now "cut" and can be  
  372.                             pasted on the screen ( / ).                     
  373.                            
  374.          Second Screen      You can display another screen on which you can 
  375.          [F6]               draw by pressing [F6].  You can quickly toggle 
  376.                             between the two screens using [F6].  You can 
  377.                             cut from one screen and paste on the other.  
  378.                             (Please see the Reference Manual, particularly 
  379.                             with reference to the relationship of marked 
  380.                             points on the two screens.) 
  381.                            
  382.          Libraries          You can display successively a number of 
  383.          [F7, F8]           picture libraries that are included on your 
  384.                             disk by pressing [F7] ([F8] displays them in 
  385.                             reverse sequence).  You can cut a figure from 
  386.                             one of these library screens and paste it on 
  387.                             your drawing screen.  You can make your own 
  388.                             library screens which you can then access using 
  389.                             [F7] and [F8] (see Reference Manual for details).
  390.  
  391.          Palette            To change the color palette you are using, 
  392.          [Q]                press [Q].  Pressing [Q] repeatedly allows you 
  393.                             to cycle through the four palettes available on 
  394.                             the CGA adapter.  You can configure MAGIC BRUSH
  395.                             to always start with the palette of your cnoice
  396.                             (see the Reference Manual for configuration). 
  397.                            
  398.          Background color   Press [B] repeatedly to cycle through all 
  399.          [B, V]             background colors.  [V] allows you to cycle 
  400.                             background colors in the opposite direction.  
  401.                             See the Reference Manual if you would like to 
  402.                             always start MAGIC BRUSH with a background 
  403.                             color different from black-- however BLACK or a 
  404.                             background color that is NOT one of the palette 
  405.                             colors is strongly recommended when drawing 
  406.                             (see Reference Manual for a discussion of this 
  407.                             point). 
  408.                            
  409.          Other              Experiment.  Make use of the help screen to 
  410.          features           try out various commands and features.  See the 
  411.                             Reference Manual for detailed description of 
  412.                             commands, saving your configuration (including 
  413.                             that for a mouse or joystick), "hints", "in 
  414.                             case of difficulty", etc. 
  415.                            
  416.  
  417.  
  418.  
  419.  
  420.                                    - 5 -
  421.  
  422.  
  423.      MAGIC BRUSH TUTORIAL   Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  424.  
  425.  
  426.          Printing           MAGIC BRUSH does not, at present, have a 
  427.                             printing routine.  You can print your picture 
  428.                             if you have a dot-matrix printer compatible 
  429.                             with the IBM Graphics Printer (includes many 
  430.                             Epson printers and other printers that emulate 
  431.                             them).  To do so, you must first load 
  432.                             GRAPHICS.COM from your DOS disk, then run Magic 
  433.                             Brush, load a picture, and press Alt-P.  Other 
  434.                             graphics screen dump programs are available 
  435.                             that offer more versatility and that support 
  436.                             various printers. 
  437.  
  438.          Exiting program    To exit Magic Brush, press Ctrl-End.  Be 
  439.          [Ctrl-End]         sure to Write (Alt-W) your work to disk before  
  440.                             you exit. Magic Brush reminds you to do so if 
  441.                             you have made changes to either of your drawing 
  442.                             screens and you have not saved these changes 
  443.                             before exiting. 
  444.  
  445.  
  446.          Hints              The Reference Manual has a chapter on Hints and 
  447.          In Case of         another on In Case of Difficulty.  Please 
  448.          Difficulty         consult those.  If you have registered your 
  449.                             copy and if you have further questions, please 
  450.                             do not hesitate to write to me: I will try my 
  451.                             best to help you with Magic Brush.  If you 
  452.                             have any suggestions or if you find any bugs 
  453.                             in the program, please let me know so that I 
  454.                             can improve it.  Because of the great 
  455.                             commitment in time, effort, and material 
  456.                             expense that goes into not only the initial 
  457.                             writing but also the continuous development and 
  458.                             maintenance of such software, I will be able to 
  459.                             provide support only to registered users. 
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.                                    - 5 -
  482.  
  483.  
  484.      MAGIC SHOW TUTORIAL    Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  485.  
  486.                                  MAGIC SHOW
  487.  
  488.      MAGIC SHOW allows you to display your pictures as a slide show.  You 
  489.      can instruct MAGIC SHOW to read your MAGIC BRUSH picture files into 
  490.      memory and display them according to a sequence you design.  A simple 
  491.      script language allows you to control the palette, the background 
  492.      color, and the duration.  You can "program" it to show a different 
  493.      sequence depending on which key you press.  Several vertical "slides" 
  494.      and "wipes" can be used.  This version of MAGIC SHOW allows you to 
  495.      load over 20 MAGIC BRUSH picture files in memory (depending on the 
  496.      amount of RAM available), making the program suitable for animation 
  497.      also. 
  498.                              
  499.          MS script          The MAGIC SHOW script language has much 
  500.          language           greater capability than that of the previous 
  501.                             version, yet remains simple to use.  This 
  502.                             improvement, however, makes script files 
  503.                             written for the older version incompatible with 
  504.                             the current version.     
  505.  
  506.  
  507.                  
  508.          Creating a         In order to write a MAGIC SHOW program (script 
  509.          script file        file), you will need to use your ASCII editor 
  510.                             or word processor.  Make sure you use it to 
  511.                             write an ASCII text file (also variously called 
  512.                             Non-Document mode, Unformatted mode, etc.) 
  513.                             The commands are written one command to a line, 
  514.                             with <CR> pressed at the end of each line. 
  515.                             
  516.          Script file        The file should be given a name with an        
  517.          name               extension of .MS                               
  518.  
  519.                             MAGIC SHOW commands and their syntax are: 
  520.                                                                              
  521.                             /label                  IFNKEY character,label
  522.                             BCOLOR color            LOAD screen,filename
  523.                             CLS screen              NEXT variable
  524.                             COPY source,destination PALETTE palette
  525.                             END                     PAUSE delay
  526.                             FOR variable,iterations RETURN 
  527.                             GETKEY                  SLIDE screen,type
  528.                             GOSUB label             WAITKEY
  529.                             GOTO label              WIPE screen,type
  530.                             IFKEY character,label 
  531.                                                   
  532.                                                   
  533.          Example            Following is a very simple example of a MAGIC 
  534.                             SHOW script file.  Please refer to the 
  535.                             Reference Manual for many more examples that 
  536.                             illustrate various possibilities.  
  537.                             
  538.                             Let us make a script file which we shall call 
  539.                             EXAMPLE.MS.  We will use our editor or word 
  540.                             processor to create an ASCII text file called 
  541.  
  542.                                    - 6 -
  543.  
  544.      MAGIC SHOW TUTORIAL    Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  545.  
  546.                             EXAMPLE.MS.  In the following, please 
  547.                             substitute for PIC1, PIC2, etc. the actual 
  548.                             names of your MAGIC BRUSH picture files that 
  549.                             you would like to use (these would have the 
  550.                             file name extension .MB, but you do not need to 
  551.                             include the extension, as MAGIC SHOW expects 
  552.                             the files to have the extension .MB):   
  553.    
  554.          Script file        command       explanation    
  555.                             ----------    ----------------------------------
  556.                             PALETTE 1     sets palette 
  557.                             LOAD 0,PIC1   loads file PIC1 and displays it
  558.                             LOAD 1,PIC2   loads PIC2 into memory location 1
  559.                             LOAD 2,PIC3   loads PIC3 into memory location 2
  560.                             PAUSE 2000    pauses (displaying PIC1) for 2 sec
  561.                             SLIDE 1,10    "slides" PIC2 from mem location 1
  562.                             BCOLOR 1      changes background color to 1
  563.                             PAUSE 1000    pauses for 1 second (1000 ms)
  564.                             PALETTE 3     changes palette to 3
  565.                             PAUSE 1000    pauses for 1 second
  566.                             COPY 2,0      moves PIC3 from memory location 2
  567.                             PAUSE 1000       to the display (0), & pauses.
  568.                             FOR A,5       repeats following loop 5 times
  569.                               BCOLOR 0
  570.                               COPY 1,0
  571.                               PAUSE 500
  572.                               BCOLOR 1 
  573.                               COPY 2,0
  574.                               PAUSE 500
  575.                             NEXT A
  576.                             END
  577.  
  578.          save script        Now save the file (as EXAMPLE.MS) in ASCII 
  579.                             form.  To run it, enter, from DOS:
  580.    
  581.          run MAGIC SHOW     MS <CR>  and enter the name of the file 
  582.                             (EXAMPLE).   MAGIC SHOW should display the 
  583.          errors             slide show you created.  If you made a mistake 
  584.                             in typing the script, MAGIC SHOW will display a 
  585.                             message on the screen.  In order to help you 
  586.                             locate your error, MAGIC SHOW will also write 
  587.                             the error message in your script file 
  588.                             (EXAMPLE.MS) indicating the position of the 
  589.                             error.  You can go back and edit the script 
  590.                             file to correct the error (pay attention to the 
  591.                             spaces or lack of spaces in the example above),
  592.                             and erase the line containing the error 
  593.                             message.  Now run it again. 
  594.  
  595.                             You can experiment, for example, with more than 
  596.                             3 picture files loaded simultaneously in memory 
  597.                             (depending on the amount of RAM available in 
  598.                             your computer), and try nesting a loop inside 
  599.                             another, and using the other commands to create 
  600.                             a more complex script. 
  601.  
  602.                                    - 7 -
  603.  
  604.      MAGIC SHOW TUTORIAL    Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  605.                             
  606.          Hint               When drawing pictures to be displayed by MAGIC 
  607.                             SHOW as animation, you can take advantage of 
  608.                             the two drawing screens available, and the fact 
  609.                             that marked points are marked on the actual 
  610.                             physical screen regardless of which picture is 
  611.                             actually displayed.  MAGIC BRUSH's cut-&-paste 
  612.                             feature allows very accurate control of 
  613.                             location of pasting through single pixel 
  614.                             movement, through the aid of the STATUS screen 
  615.                             (press & hold the shift key), and through the 
  616.                             GOTO screen coordinate command (Ctrl-G).  
  617.                             
  618.          Registration       If you use MAGIC BRUSH or MAGIC SHOW, please 
  619.                             register your copy.  Registered users receive a 
  620.                             detailed printed Manual, a special, registered 
  621.                             copy of the latest version of the program, 
  622.                             one year of support by mail, and information on 
  623.                             updates.  Registering your copy makes it 
  624.                             possible for me to continue improving the 
  625.                             program (a registration form is included at the 
  626.                             end of this tutorial). 
  627.                             
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.                             
  649.  
  650.  
  651.         
  652.  
  653.  
  654.  
  655.                             -------------------------
  656.                             IBM Graphics Printer is a registered trademark
  657.                                 of International Business Machines 
  658.                                 Corporation.
  659.                             Epson is a registered trademark of Epson
  660.                                 Corporation.
  661.  
  662.  
  663.                                    - 8 -
  664.                            
  665.                            
  666.                            
  667.                             
  668.  
  669.      MAGIC BRUSH/MAGIC SHOW Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  670.                            
  671.                            
  672.      A Note from the Author of Magic Brush 
  673.      -------------------------------------
  674.                            
  675.      My experience with computers began in 1981 when I was nine years old.  
  676.      For Christmas that year, I got a SINCLAIR ZX81 computer.  I learned 
  677.      BASIC on the Sinclair. 
  678.                            
  679.      I then "graduated" to a Commodore 64.  The Commodore's powerful 
  680.      graphics capabilities encouraged me to begin writing programs that 
  681.      used these capabilities.  I wrote several graphics drawing programs 
  682.      that allowed the user to sketch figures and paint them. 
  683.                            
  684.      In 1985, when I was 14, we got an IBM PC.  MAGIC BRUSH was my first 
  685.      large program on the IBM PC.  The program, written in BASICA, grew in 
  686.      size  and became unwieldy, and I was encouraged to use a compiled 
  687.      language.  So we bought Turbo Pascal, which I learned sufficiently 
  688.      to rewrite Magic Brush in its present form.  I also added MAGIC SHOW 
  689.      and other ancillary programs which I am distributing as part of the 
  690.      Magic Brush package and that I hope you will find useful.  Magic Brush 
  691.      is, therefore, the result of several years of learning and hard work 
  692.      in between school and other activities.  I hope that you will find it 
  693.      helpful in some way.  If you do find it useful and use it on a regular 
  694.      basis, please register the program and encourage your friends to copy 
  695.      the program (but not the manual, please) and send their registration 
  696.      fees!  The fees will help me, at the very least, in buying disks, 
  697.      books, printer supplies and software, and may even help with the cost 
  698.      of my future college education.  
  699.                            
  700.      I would like to continue to improve the program and to add new 
  701.      features to make it competitive with other similar programs as my 
  702.      programming and math get better, and as I receive your suggestions and 
  703.      support.  I already have a number of important improvements in mind 
  704.      that I will be working on.  I will, of course, notify registered users 
  705.      of new versions of the program when they become available.  However, I 
  706.      can continue doing this only if you, as a user, register the program.
  707.                            
  708.      I would like to thank Mr. Jeffrey H. Johnson for explaining to me 
  709.      (among other things) pointers in Pascal.  My younger brother, Karim 
  710.      (13 years), contributed a lot to the program:  he suggested the name 
  711.      MAGIC BRUSH, and he drew the pictures and libraries supplied with the 
  712.      program and used in the demo (MBDEMO).   
  713.  
  714.  
  715.                                              Nassib Nassar                  
  716.                                              (SoftBrush) 
  717.                                              September, 1988
  718.                                         (modified January, 1989)
  719.                                         (modified August, 1989)
  720.  
  721.  
  722.  
  723.  
  724.  
  725.                            
  726.                                   - 9 -
  727.                            
  728.  
  729.      MAGIC BRUSH/MAGIC SHOW Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  730.  
  731.  
  732.      Magic Brush History:
  733.  
  734.  
  735.      Version 1.01 corrects a few errors in version 1.00: 
  736.      1. When you typed the name of a non-existent MB file on the command 
  737.         line, you had to clear the screen. 
  738.      2. When you enter text, you no longer lose previously marked points. 
  739.      3. In version 1.00 of MAGIC SHOW, PAUSE paused about 0.02 seconds 
  740.         depending on the the computer. In version 1.01 PAUSE pauses for 
  741.         1 ms, and is independent of the speed of the computer. 
  742.      4. The License conditions were added to the README file and to 
  743.         MBTUTOR.DOC.       
  744.  
  745.                            
  746.      Version 1.02: circle routine is faster at aspect ratio of 1.00.
  747.  
  748.                            
  749.      Version 1.10: 
  750.      1. Added ability to read and write part of screen as a "symbol" file.
  751.      2. Added diagonal flipping of cut.
  752.      3. Added ability to center a figure to be pasted (F2, F4).
  753.      4. Modified Software License and opening program information screen.
  754.  
  755.  
  756.      Version 1.11: 
  757.      1. Corrected error that caused MAGIC BRUSH to crash when trying to
  758.         calibrate joystick if disk was full.
  759.      2. Modified README file & added ASP OMBUDSMAN statement.
  760.  
  761.  
  762.      Version 1.50 (released August, 1989)
  763.      I   General.  
  764.      1.  A statement of SUPPORT policy has been added in the README file, 
  765.          in compliance with the requirements of the ASP. 
  766.      2.  The Tutorial has been revised and expanded to include MAGIC SHOW.
  767.      3.  Some of the example/library files have been replaced with newer 
  768.          ones. 
  769.      4.  The file VENDOR.DOC has been added in accordance with the 
  770.          suggestions of the ASP.
  771.  
  772.      II  MAGIC BRUSH.  
  773.      1.  The status screen now shows name of the file currently being 
  774.          edited. 
  775.      2.  A bug which allowed saving an empty symbol file (without having 
  776.          first made a cut) was corrected. 
  777.      3.  The cursor interval range has been increased to allow intervals 
  778.          greater than 10 (pressing [I] allows entering intervals up to 99).
  779.      4.  The file directory (displayed by typing Alt-F) is now shown sorted 
  780.          alphabetically.
  781.      5.  Library files (F7, F8) are now displayed in alphabetical order by 
  782.          file name.
  783.      6.  Program no longer crashes if F7 or F8 is pressed when a very large 
  784.          number of .LB files is present.
  785.  
  786.                                   - 10 -
  787.  
  788.  
  789.      MAGIC BRUSH/MAGIC SHOW Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  790.  
  791.  
  792.  
  793.      III MAGIC SHOW has been completely rewritten, with major enhancements    
  794.          in several areas:                                                    
  795.      1.  The number of screens that can be in memory simultaneously is now    
  796.          limited only by the amount of free RAM available, improving the      
  797.          very limited animation capability of earlier versions, and allowing  
  798.          much enhanced rapid slide changes by reducing delays caused by       
  799.          frequent reading of files from the disk.                             
  800.      2.  The script language has been enhanced significantly, adding 
  801.          labels, conditional and unconditional branching, subroutines, 
  802.          nested loops, and other controls and commands, allowing much more 
  803.          flexible control of the display. 
  804.      3.  The program now writes error messages in the script file itself 
  805.          identifying the type and location of syntax errors. 
  806.      4.  Vertical "slides" and "wipes" have been added.  
  807.                                                                               
  808.                                       * * *
  809.  
  810.  
  811.      To print the ORDER/REGISTRATION form on your printer, please place the 
  812.      Magic Brush diskette in drive A:, type:   
  813.      
  814.      COPY A:REGFORM PRN
  815.      
  816.      and press Enter.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.                                   - 11 -
  849.  
  850.                            
  851.  
  852.                                   
  853.  
  854.  
  855.      MAGIC BRUSH/MAGIC SHOW Copyright (C) 1988,89 Nassib Nassar, SoftBrush 
  856.  
  857.                                 Magic Brush
  858.  
  859.                     (includes MAGIC BRUSH & MAGIC SHOW)
  860.  
  861.                         Registration / Order Form
  862.  
  863.  
  864.        Please send order form with check or money order to:
  865.  
  866.        Nassib Nassar
  867.        4035 Livingstone Pl.
  868.        Durham, NC  27707
  869.  
  870.  
  871.  
  872.  
  873.        Name:   ______________________________________
  874.  
  875.        Company:______________________________________
  876.  
  877.        Address:______________________________________
  878.  
  879.                ______________________________________
  880.  
  881.        City:   ___________________  State:___________   Zip:____________ 
  882.  
  883.  
  884.  
  885.        1.5                                                           0133
  886.        ==================================================================
  887.        |Quantity   Description                         Unit    Extended |
  888.        |---------|----------------------------------|--------|----------|
  889.        |         | Magic Brush Program & Manual*    | $25.00 |          |
  890.        |---------|----------------------------------|--------|----------|
  891.        |         | Magic Brush Manual only*         | $20.00 |          |
  892.        |---------|----------------------------------|--------|----------|
  893.        |         | Magic Brush Trial diskette only**| $ 7.00 |          |
  894.        |---------|----------------------------------|--------|----------|
  895.        |                                                                |
  896.        |                                          Subtotal  $           |
  897.        |                 NC residents please add Sales Tax  $           |
  898.        |                                                                |
  899.        |                                             Total  $           |
  900.        |----------------------------------------------------------------|
  901.      
  902.       * Includes registration.
  903.      ** Does not include registration
  904.    
  905.         Prices subject to change without notice.
  906.  
  907.         Magic Brush  will be shipped post free within the continental 
  908.         U.S.A. 
  909.  
  910.  
  911.      Please indicate diskette size:
  912.      
  913.        ___  5.25" diskette        ___  3.5" diskette
  914.  
  915.  
  916.  
  917.  
  918.