home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / virus / expel.zip / MB.DOC < prev    next >
Text File  |  1989-12-12  |  16KB  |  327 lines
  1. Document for MicroMacroBat....................................................
  2.  
  3. MB.EXE is a program which when run with an argument on the command line, from
  4. either the DOS prompt or within a batch file, performs the operations specified
  5. by that argument.  For example, by typing or placing this line in a batch
  6. file or on the command line:
  7.  
  8. MB BOX/1/1/12/80/1/112
  9.  
  10. MicroMacroBat will perform the operation specified by the argument
  11. BOX/1/1/12/80/1/112. The argument tells MicroMacroBat to place a BOX with the
  12. upper left corner at row 1, column 1, the lower right corner at row 12,
  13. column 80, use the single line box character and make the color black on
  14. white.
  15.  
  16. MicroMacroBat can be a very handy extention to your batch file writing tools
  17. without having to learn a new batch-file-writing language or performing
  18. a compilation.
  19.  
  20. MB.EXE can be tucked away in your utilities directory with a "path" pointing
  21. to it.  MicroMacroBat calls may be intermixed with the batch file routines you
  22. normally use without any further consideration other than proper syntax usage.
  23.  
  24. MicroMacroBat will have many uses:
  25.  
  26. *             In your AUTOEXEC.BAT files.
  27. *             In distribution disc BAT files for hard drive installations.
  28. *             In BAT files for making file backups.
  29. *             In BAT files for demonstration programs and slide shows.
  30. *             For Shareware distributors GO files.
  31. *             BLOADable screen design.  See note 3 under REGISTRATION.
  32.  
  33. DEMO.BAT is a batch file which demonstrates some of the routines and contains
  34. some important remarks.
  35.  
  36. NOTE:  In order that MB can load and execute as quickly as possible, syntax
  37. .      and error checking are non-existent.  Make no errors and you will have
  38. .      no problems.
  39.  
  40. The ONLY legal argument separator is the "/".  DO NOT use anything else.
  41. Either upper or lower case text is acceptable.  Remember, each line is to
  42. be prefixed with MB, followed by a space and the argument, ie:
  43.  
  44. .                        MB BOX/1/1/12/80/1/31
  45.  
  46. The following is a list of supported arguments, their proper syntax and an
  47. explanation of what the operation does.  The meaning of the parameter TEXT$
  48. is:  Any group of ASCII characters in the range of 0 to 255.
  49.  
  50.  
  51. BOX/BR/BC/ER/EC/CHARACTER/COLOR/C       Draws a box where BR is the beginning
  52. .                                       row, BC the beginning column, ER the
  53. .                                       ending row, EC the ending column where
  54. .                                       BR < ER, BC < EC and COLOR < 256.
  55. .                                       CHARACTER is either 1 or 2 indicating
  56. .                                       a single or double line box.  COLOR
  57. .                                       is a single value representing the
  58. .                                       foreground and background colors.  See
  59. .                                       the single color chart below.  The
  60. .                                       values for   BR,  BC,  ER  and  EC
  61. .                                       should be within the allowable limits
  62. .                                       as dictated by the lines/columns mode
  63. .                                       of your monitor.  Appending /C to the
  64. .                                       argument clears the inside of the box
  65. .                                       to the background color specified in
  66. .                                       the COLOR argument.
  67. .                           Example:    BOX/1/5/12/75/1/79 draws a single-line
  68. .                                       box with the upper left corner at row
  69. .                                       1, column 5, the lower right corner at
  70. .                                       row 12 column 75 in bright white on
  71. .                                       red and not cleared.
  72.  
  73. CLEARSCR/BR/BC/ER/EC/COLOR              Clears an area of the screen where BR,
  74. .                                       BC, ER, EC and COLOR have the meanings
  75. .                                       as described above.
  76. .                           Example:    CLEARSCR/1/5/12/75/31
  77.  
  78. BLOAD/FILENAME$                         BLOADS a file into video memory as
  79. .                                       the BASIC's BLOAD command.  The area
  80. .                                       of video memory the file is loaded into
  81. .                                       is automatically determined by the
  82. .                                       monitor in use.  This command is for
  83. .                                       "slide shows" of predetermined screen
  84. .                                       files made with Basic's BSAVE or a
  85. .                                       screen capture utility.
  86. .                           Example:    BLOAD/MAINMENU.SCR
  87.  
  88. FILLSCRN/BR/BC/ER/EC/COLOR/ASCII        Fills the screen with the character
  89. .                                       represented by the value ASCII.  BR,
  90. .                                       BC, ER, EC and COLOR are as previously
  91. .                                       described.
  92. .                           Example:    FILLSCRN/1/5/12/75/30/45 will fill the
  93. .                                       described area with dashes colored
  94. .                                       yellow on blue.
  95.  
  96. PAINT/BR/BC/ER/EC/COLOR                 Paints the screen without disturbing
  97. .                                       the existing text.
  98. .                           Example:    PAINT/1/5/12/75/7
  99.  
  100. OCPRINT/ROW/COLUMN/TEXT$/COLOR          Same as PRINT, below, except that
  101. .                                       printing takes place slowly; one
  102. .                                       character at a time, for effect.
  103.  
  104. PRINT/ROW/COLUMN/TEXT$/COLOR            Rapidly prints TEXT$ in COLOR at the
  105. .                                       ROW/COLUMN.  TEXT$ will be displayed
  106. .                                       exactly as entered, including quotes
  107. .                                       if used.  Extended ASCII characters
  108. .                                       may be displayed. The routine writes
  109. .                                       to video memory; no line feed issued.
  110. .                           Example:    PRINT/5/1/display these words/31
  111.  
  112. CURSOROFF                               Turns the cursor off.  Be sure to turn
  113. .                                       the cursor back on at the end of the
  114. .                                       bat file.
  115.  
  116. CURSORON                                Turns the cursor on.
  117.  
  118. LOCATE/ROW/COLUMN                       Locates the cursor at ROW/COLUMN.
  119. .                                       Handy if you want to use the ECHO
  120. .                                       command.  Printing by DOS will begin
  121. .                                       at the cursor position.
  122. .                           Example:    LOCATE/1/1
  123.  
  124. WAIT                                    Suspends operation and waits for a
  125. .                                       keypress.
  126.  
  127. CHIME/WHICHONE                          Makes a chime-like tone.  WHICHONE
  128. .                                       must be in the range of 1 to 10.
  129. .                           Example:    CHIME/7
  130.  
  131. SLEEP/SECONDS                           Suspends operation until SECONDS
  132. .                                       seconds elapses.
  133. .                           Example:    SLEEP/4
  134.  
  135. STUFF/TEXT$                             Stuffs text into the keyboard buffer,
  136. .                                       appending an <ENTER> keypress.
  137. .                                       To simulate pressing <ENTER>, simply
  138. .                                       use STUFF without parameters.  TEXT$
  139. .                                       CANNOT be more than 15 characters.
  140. .                           Example:    STUFF/Y
  141.  
  142. USCROLL/BR/BC/ER/EC/TIMES               Provides for scrolling of a selected
  143. DSCROLL/BR/BC/ER/EC/TIMES               area of the screen, either Up, Down,
  144. LSCROLL/BR/BC/ER/EC/TIMES               Left or Right, TIMES times.
  145. RSCROLL/BR/BC/ER/EC/TIMES
  146. .                           Example:    LSCROLL/1/1/12/80/4
  147.  
  148. FADE/COLOR                              Provides for a screen disolve to COLOR.
  149. .                           Example:    FADE/64
  150.  
  151. BIG/TEXT/CHR/R/C/COLOR                  Prints large block text; 3 rows, 10
  152. .                                       columns in COLOR color with ASCII
  153. .                                       character CHR.
  154. .                           Example:    BIG/Hello there/219/1/1/31
  155.  
  156. RECOLOR/OLD/NEW                         Changes all instances of color OLD to
  157. .                                       color NEW.
  158. .                           Example:    RECOLOR/31/78
  159.  
  160. LIST/ROW/COLUMN/COLOR/X/word/word/....  Prints a vertical list of words (18max)
  161. .                                       starting at ROW, COLUMN in COLOR.
  162. .                                       There will be X rows between words.
  163. .                           Example:    LIST/12/1/31/1/Item 1/Item 2/Item 3
  164.  
  165.  
  166. VPRINT/ROW/COLUMN/TEXT/COLOR            Prints TEXT vertically in starting at
  167. .                                       ROW, COLUMN.  Do not print more text
  168. .                                       than there is room for.
  169. .                           Example:    VPRINT/1/1/HELLO THERE/2
  170.  
  171. CBUF                                    Clears the keyboard buffer.
  172.  
  173.  
  174.  
  175.  
  176. __________________________________OneColor Chart______________________________
  177.  
  178. .             ......................Background...........................
  179. .             Black   Blue   Green   Cyan   Red   Magenta   Brown   White
  180.  
  181. Foreground
  182. ..........
  183. Black          0      16      32     48     64      80      96      112
  184. Blue           1      17      33     49     65      81      97      113
  185. Green          2      18      34     50     66      82      98      114
  186. Cyan           3      19      35     51     67      83      99      115
  187. Red            4      20      36     51     67      83     100      116
  188. Magenta        5      21      37     52     68      84     101      117
  189. Brown          6      22      38     52     69      85     102      118
  190. White          7      23      39     53     70      86     103      119
  191. Gray           8      24      40     54     71      87     104      120
  192. Bright blue    9      25      41     55     72      88     105      121
  193. Bright green  10      26      42     56     73      89     106      122
  194. Bright cyan   11      27      43     57     74      90     107      123
  195. Bright red    12      28      44     58     75      91     108      124
  196. Bright Mag    13      29      45     59     76      92     109      125
  197. Bright Brown  14      30      46     60     77      93     110      126
  198. Bright White  15      31      47     61     78      94     111      127
  199.  
  200. For a blinking foreground, add 128 to the above values.
  201.  
  202.  
  203. REGISTRATION.................................................................
  204.  
  205. The $35 registration fee for this program will provide you with:
  206.  
  207. The MicroMacroBat program broken down into it's component parts.  VMB, UMB and
  208. DMB are the video, utility and display/printing controllers, respectively.
  209. Separate controllers load and execute faster, but the speed is partly offset
  210. by the additional disc seek time.  Also, you may only need, or have room for,
  211. one controller on a disc.  The breakdown is as follows:
  212.  
  213. ------------------------------------------------------------------------------
  214. .          VMB                     UMB                        DMB
  215. ------------------------------------------------------------------------------
  216. .        ClearScr                 CBuf                       Big
  217. .        FillScrn                 Chime                      VPrint
  218. .        Paint                    Stuff                      BLoad
  219. .        CursorOn                 Sleep                      OCPrint
  220. .        CursorOff                                           RScroll
  221. .        Print                Future additions               UScroll
  222. .        Recolor              will be in this                DScroll
  223. .        Box                  file.                          LScroll
  224. .        List                                                Wait-Rotate
  225. .        Wait                                                Fade
  226. .        Locate
  227.  
  228. You will also be provided with:
  229.  
  230. 1.      A handy four page manual.
  231.  
  232. 2.      A collection of even smaller, individual control programs, each
  233. .         containing a SINGLE routine.  These will prove to be of value,
  234. .         especially if you need only one or two.  You may use these stand
  235. .         alones in your batch files or run them from the DOS command line.
  236. .         The single routines will not need the MB prefix, are called by
  237. .         name and will use the same syntax as required by MicroMacroBat.
  238.  
  239. 3.      Other routines which will have been developed since the release
  240. .          of this shareware program.  One of these will DEFINITELY be a
  241. .          routine to allow MicroMacroBat to be used as a screen design
  242. .          utility; use a batch file to call MB repeatedly until you like
  243. .          the design then, simply press ^F1 and the screen is saved as a
  244. .          BLOADable file.  Using a small batch file to put you in a loop
  245. .          with a text editor will allow you to completely design a screen
  246. .          in less than 15 minutes!  You can save screens prior to registering
  247. .          MicroMacroBat with one of the screen capture utilities available.
  248.            WAIT-ROTATE, a moving sign "marguee" will also be included.
  249.  
  250. 4.      Possible inclusion of YOUR suggestions in the registered disc you
  251. .          recieive.
  252.  
  253. 5.      Placement on the update list.  You will automatically receive notices
  254. .          of program enhancements and have the opportunity to upgrade for a
  255. .          pittance.
  256.  
  257. 6.      Access to the 25th line of the monitor with the removal of our copyright
  258. .          notice.
  259.  
  260. Even if you do not wish to receive the separate controllers & other advantages
  261. of registration, you are still expected to register your continued use of
  262. MicroMacroBat.
  263.  
  264. Send your $35 registration fee to:  Sitting Duck Software
  265. .                                   POBox 130
  266. .                                   Veneta, OR 97487
  267. .                                   (503) 935-3982
  268.  
  269. If you have suggestions for additional features, we are happy to consider
  270. them.
  271.  
  272. SITE and DISTRIBUTION LICENSES................................................
  273.  
  274. Site licenses are available for MicroMacroBat.  In order to legally distribute
  275. MB.EXE with your products, distribution licenses are also available.  Because
  276. the execution speed of MicroMacroBat depends on the size of the MB.EXE file,
  277. licensees may ask that only the routines they require be included.  Contact
  278. us at the above address for details.
  279.  
  280. MicroMacroBat (c) 1989        Sitting Duck Software         All rights reserved
  281.  
  282. REGISTRATION FORM
  283.  
  284.  
  285. Date______________________               Telephone  (    )    -
  286.  
  287. Name_________________________________________________ Apt_________________
  288.  
  289. Address___________________________________________________________________
  290.  
  291. City______________________________________ State_______ Zip_______________
  292.  
  293.  
  294. Registration for MicroMacroBat                                      $35.00
  295.  
  296.  
  297. Registration fee includes First Class postal shipment.                n/c
  298.  
  299. Specify here if you prefer UPS ground         [ ]                     n/c
  300.  
  301. Specify here if you prefer UPS Blue (air)     [ ]        @            5.00
  302.  
  303.  
  304.                                                Total enclosed:    _________
  305.  
  306. Sorry, we are not set up to accept charge cards.
  307.  
  308. Shipping address if different from above:
  309.  
  310. ___________________________________________________________________________
  311.  
  312. ___________________________________________________________________________
  313.  
  314. ___________________________________________________________________________
  315.  
  316. ___________________________________________________________________________
  317.  
  318.  
  319. Mail payment to:   Sitting Duck Software
  320.                    POBox 130
  321.                    Veneta, OR 97487
  322.  
  323.  
  324.  
  325.  
  326.  
  327.