home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT214.ZIP / SEBFU40.LZH / BOX.DOC < prev    next >
Text File  |  1991-09-01  |  9KB  |  295 lines
  1.  
  2.                               B O X     Ver. 4.0
  3.  
  4.  
  5.                     (C)1989,1990,1991  Scanlon Enterprises
  6.  
  7.  
  8.  
  9.  
  10.        BOX is a utility to draw boxes on the video display. The boxes 
  11.        can be draw using a variety of line drawing characters. This 
  12.        utility is useful for highlighting special comments or 
  13.        information on the screen. The box is drawn starting at the 
  14.        current cursor location.
  15.  
  16.        Syntax : BOX /Ln /Wn /Fn /Bn /Pn /Gn /D /R
  17.  
  18.        ERRORLEVELS:  0FF (255) Program Problem (call Author)
  19.                      002       Bad option/parameter
  20.                      000       OK
  21.  
  22.        Where  : '/Ln' The box will be drawn using 'n' number of lines.
  23.                 '/Wn' The box will be drawn using 'n' columns.
  24.                 '/Fn' The box will be drawn using 'n' foreground color.
  25.                 '/Bn' The box will be drawn using 'n' Background color.
  26.                 '/Pn' The box will be drawn using 'n' video page.
  27.                 '/Gn' The box will be drawn using 'n' character. If 'n'
  28.                       is a single character, then that character will
  29.                       be the graphics character. If 'n' is more than 1
  30.                       character, they must be decimal values, and the
  31.                       ascii value of the decimal string will become the
  32.                       box character. To produce box character for ascii
  33.                       values of single digits, simply precede the ascii
  34.                       value by a zero, thus, a '1' becomes '01'!
  35.                 '/D'  The box will be drawn using double line graphics
  36.                       characters instead of the default single line
  37.                       graphics characters.
  38.                 '/R'  The box will be drawn using DOS instead of the
  39.                       video bios.
  40.  
  41.        Defaults:      Single line graphics are used to draw the box
  42.                       unless either the '/D' or '/Gn' switch is
  43.                       specified.
  44.  
  45.                       The Box will be drawn using 3 video lines and
  46.                       4 video columns unless the '/Wn' and '/Ln' options
  47.                       are specified.
  48.         
  49.                       The Box will be drawn using the current video
  50.                       colors unless the '/Fn' and '/Bn' are specified.
  51.                       For values of 'n' in color specification, please
  52.                       read the COLOR.DOC file.
  53.  
  54.                       The box will be drawn on the current active video
  55.                       page unless the '/Pn' option is specified. The box
  56.                       will be invisible untill the user changes video
  57.                       pages using our GSMODE utility or other utility
  58.                       which can change the video page.
  59.  
  60.                       The box will be drawn using the video Bios unless
  61.                       the '/R' option is specified.
  62.  
  63.       Page 1 of 5
  64.  
  65.                               B O X     Ver. 4.0
  66.  
  67.  
  68.                     (C)1989,1990,1991  Scanlon Enterprises
  69.  
  70.  
  71.  
  72.  
  73.        USAGE  : BOX
  74.  
  75.        Draws a box starting at the current cursor location, and 
  76.        extending three lines below, and 4 columns over. IE... if the 
  77.        cursor is on line 1 column 1 the box will be drawn using lines 1 
  78.        thru 3 and columns 1 thru 4. The box will look like this:
  79.  
  80.                 ┌──┐
  81.                 │  │    {This will be drawn using standard ascii
  82.                 └──┘     characters if your printer or text viewing
  83.                          system does NOT support extended characters}
  84.  
  85.        The box will be drawn using the current video color (usually 
  86.        white on black).
  87.  
  88.                 
  89.  
  90.                 BOX /L2
  91.  
  92.        The box will be drawn as in the first usage, but will be 1 line 
  93.        longer (lines 1 thru 4).
  94.  
  95.  
  96.                 BOX /L2 /W3
  97.  
  98.        The box will be drawn as in the previous usage, execpt the box 
  99.        will be one column longer (using lines 1 thru 4 and columns 1 
  100.        thru 5).
  101.  
  102.  
  103.                 BOX /F7
  104.  
  105.        The box will be drawn as in the first usage, except the box 
  106.        will be drawn using white, as the foreground color.
  107.  
  108.  
  109.                 BOX /F7 /F1
  110.  
  111.        The box will be drawn as in the first usage, except the box will 
  112.        be drawn using white on blue. The middle of the box is left 
  113.        untouched.
  114.  
  115.  
  116.                 BOX /P2
  117.  
  118.        The box will be drawn as in the first usage, but will be drawn on 
  119.        video page 2, which may NOT be the current active page, thus may 
  120.        be invisible. Use our GSMODE to change the video page.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.       Page 2 of 5
  127.  
  128.                               B O X     Ver. 4.0
  129.  
  130.  
  131.                     (C)1989,1990,1991  Scanlon Enterprises
  132.  
  133.  
  134.  
  135.                 BOX /G*
  136.  
  137.        The box will be drawn as in the first usage, except the box will 
  138.        be drawn using the '*' instead of single line graphics.
  139.  
  140.  
  141.  
  142.                 BOX /D
  143.  
  144.        The box will be drawn as in the first usage, except the box 
  145.        will be drawn using double line graphics.
  146.  
  147.  
  148.  
  149.                 BOX /R
  150.  
  151.        The box will be drawn as in the first usage, except the box may 
  152.        be redirected to a file or printer.
  153.  
  154.  
  155.  
  156.        EXAMPLES:
  157.  
  158.                 ECHO OFF
  159.                 CLS
  160.                 LOCATE 3 5
  161.                 ECHO Hello
  162.                 LOCATE 2 4
  163.                 BOX /W5
  164.                 LOCATE 5 1
  165.  
  166.        This example will draw a box around the word hello, which was 
  167.        displayed using the DOS ECHO command. LOCATE is one of the SEBFU 
  168.        utilities which positions the cursor. The first usage was to 
  169.        position the cursor on line 3, column 5 (LOCATE 3 5). The second 
  170.        usage was to position the cursor on line 2, column 4.
  171.  
  172.        To create this short little batch file, enter :
  173.  
  174.                 COPY CON BOXTEST.BAT              {at a DOS prompt}
  175.  
  176.        Next, enter each of the above lines (below example, starting with 
  177.        the line ECHO OFF, and ending with the line LOCATE 5 1). Making 
  178.        sure that the cursor is on a new line, hold the control key down, 
  179.        and press the key labeled 'z', then release both keys. Your 
  180.        screen will display the string '^Z', now press the ENTER key. DOS 
  181.        will then display the message :
  182.  
  183.                 ONE FILE COPIED
  184.  
  185.        Now enter BOXTEST at the DOS prompt. A box with Hello should be 
  186.        displayed at the top right of your display.
  187.  
  188.  
  189.       Page 3 of 5
  190.  
  191.                               B O X     Ver. 4.0
  192.  
  193.  
  194.                     (C)1989,1990,1991  Scanlon Enterprises
  195.  
  196.  
  197.  
  198.  
  199.        EXAMPLES: {continued}
  200.  
  201.                  ECHO OFF
  202.                  CLS
  203.                  LOCATE 3 5
  204.                  ECHO Press the  ESC    key to abort
  205.                  LOCATE 4 5
  206.                  ECHO Press the  SPACE  key to continue
  207.                  LOCATE 2 15
  208.                  BOX /L2 /W5 /F7 /B1
  209.                  LOCATE 7 1
  210.  
  211.        This example shows how you can make a box around text spaning 
  212.        multilple lines. Here the box will only be drawn around the word 
  213.        ESC on line 3 and SPACE on line 4. Use the same process as 
  214.        described in the previous example to try this.
  215.  
  216.  
  217.        Redo the above example but add the switch '/D' to the end of the 
  218.        line containing the BOX command.
  219.  
  220.                  BOX /L2 /W5 /F7 /B1 /D
  221.  
  222.        This will produce the same box, using double line graphics 
  223.        instead of single line graphics.
  224.  
  225.  
  226.  
  227.        For additional usage and information on using these utilities see 
  228.        the file SEBFU.DOC or BATUT.DOC.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.       Page 4 of 5
  253.  
  254.                                B O X    Ver. 4.0
  255.  
  256.  
  257.                     (C)1989,1990,1991  Scanlon Enterprises
  258.  
  259.  
  260.  
  261.                              O R D E R     F O R M
  262.  
  263.  
  264.  
  265.  
  266.        BOX registration ........................................ $1.50
  267.  
  268.  
  269.  
  270.  
  271.        What you get :
  272.  
  273.        Unlimited usage of BOX, and phone or write in support. You will 
  274.        also be placed on our mailing list for future updates and new 
  275.        products.
  276.  
  277.        We are offering this utility seperate from SEBFU as a favor to 
  278.        users who do NOT wish to use many of the SEBFU utilities.
  279.  
  280.        This utility is automatically registered to you when you register 
  281.        SEBFU as a product (see REG.DOC). Registering SEBFU as a product 
  282.        is a better bargin, as each utility will cost less than $ .25 
  283.        each.
  284.  
  285.  
  286.        Vendors:
  287.  
  288.        You may distribute BOX seperately, provided this document is 
  289.        distributed as well. Any reasonable fee may be charged.
  290.  
  291.  
  292.        Send your order to : SCANLON ENTERPRISES
  293.                             38354 17TH ST E.
  294.                             PALMDALE, CA 93550
  295.