home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / business / showbat.zip / SHOWBAT.DOC < prev    next >
Text File  |  1992-03-21  |  22KB  |  516 lines

  1. ShowBAT Ver. 2.11
  2. -------------------------------
  3. Slide show Batch file utilities
  4.  
  5. for all IBM compatibles.
  6.  
  7. Documentation and Technical Notes March 16, 1992
  8.  
  9. Copyright (C) 1991, 1992 by A & Z Management Service, Inc.
  10. All rights reserved.
  11.  
  12.  
  13. Legal Limitations
  14.  
  15. ShowBAT is provided on an "as is" basis without warranty of any kind
  16. expressed or implied.  In no event will A & Z Management Service, Inc. be
  17. liable to you for any damages, including any lost profits, lost savings,
  18. or other incidental or consequential damages arising out of the use of or
  19. inability to use the program, even if A & Z Management Services has been
  20. advised of the possibility of such damages, or for any claim by any other
  21. party.
  22.  
  23. ShowBAT is copyrighted by A & Z Management Service, Inc.  You are
  24. encouraged to give copies to your friends and upload it to bulletin
  25. boards, however, sale of the program for profit by anyone except A & Z
  26. Management Service, Inc.  is strictly prohibited, with the exception of a
  27. small fee for duplication.  That fee does not register you as a user of
  28. ShowBAT. If you like ShowBAT and find it useful, you are asked to register
  29. as a user with A & Z Management Service, Inc.  A form is provided in this
  30. document.
  31.  
  32.  
  33. Shareware Notice--------
  34.  
  35. ShowBat is released as Shareware.  This is copyrighted material: it is NOT
  36. "free software."  You are permitted to experiment with this package long
  37. enough to determine if it suits your needs (up to three presentations).
  38. This means you have the opportunity to use and evaluate it before you
  39. decide to buy.  If you regularly use ShowBAT then you are required to send
  40. your registration fee to the author according to the instructions below.
  41. (The cost as of this writing is $35.00 per single-user license plus $4.00
  42. handling).  Using these programs to create more then three presentations
  43. constitutes regular use under this license agreement, and requires the user
  44. to register with the author.
  45.  
  46. LICENSE AGREEMENT:
  47. -------------------
  48.  
  49. All ShowBAT EXE files, data files, and ShowBAT.DOC are Copyright (C) 1991,
  50. 1992 A & Z Management Services, Inc. All rights reserved.
  51.  
  52. Whether or not you become a registered user, you are permitted under
  53. this license to copy and distribute all the ShowBAT files freely. The
  54. ShowBAT files may be distributed via electronic Bulletin Board Systems and
  55. other electronic information storage and retrieval services only under the
  56. terms described above.  No BBS or  other storage and retrieval service may
  57. request any donation, or charge any fee or premium, for the electronic
  58. transfer of any of these files, excluding that service's ordinary connect
  59. charges, if any, without the express written permission of the copyright
  60. holder.
  61.  
  62. Any use, copying or distribution of the ShowBAT files, other than that
  63. described above, is in violation of this license agreement.
  64.  
  65.  
  66. Please REGISTER YOUR ShowBAT
  67.  
  68. Thank you for your interest in ShowBAT, slide show BATch file utilities
  69. for the IBM compatibles. Please register by sending the order form below
  70. with your check or money order for $35.00 per copy plus $4.00 for
  71. materials, postage and handling, to:
  72.  
  73. A & Z Management Services, Inc.
  74. 4151 Bay Front Road
  75. Mobile, Alabama 36605
  76.  
  77. +---------------------------------------------------------------------+
  78. |  I wish to license _____ copy/copies of the latest release of the   |
  79. |  ShowBAT programs. I have enclosed $35.00 for each single-user      |
  80. |  license plus $4.00 for handling etc. (Prices subject to change).   |
  81. |                                                                     |
  82. |  Name ___________________________________________________________   |
  83. |                                                                     |
  84. |  Company (if applicable) ________________________________________   |
  85. |                                                                     |
  86. |  Address ________________________________________________________   |
  87. |                                                                     |
  88. |  City _______________________________  State ______  Zip ________   |
  89. |                                                                     |
  90. |  I prefer:  _____ 3-1/2" disk; _____ 5-1/4" disk (check one)        |
  91. |                                                                     |
  92. |                                                                     |
  93. |  If you received your copy of ShowBAT from a Bulletin Board System, |
  94. |  User's Group, or software distributor, please supply its name and  |
  95. |  location (if from a public BBS, please add the phone number):      |
  96. |  __________________________________________________________________ |
  97. |                                                               03/92 |
  98. +---------------------------------------------------------------------+
  99.  
  100. * To license one copy, for example, send $39.00; to license 10 copies,
  101.   send $354.00.  Please use the order form above.
  102. * U.S. funds only, please.
  103. * These prices are subject to change.
  104.  
  105. +---------------------------------------------------------------------+
  106. | To print a registration form:                                       |
  107. |   1. Make sure your printer is ready (on with paper).               |
  108. |   2. Type: PRINTREG<-'   (the character: <-' is a short hand way of |
  109. |      saying to press the enter key).                                |
  110. +---------------------------------------------------------------------+
  111.  
  112.  
  113.                        Table of Contents
  114.  
  115.  
  116. OVERVIEW ShowBAT ...................................
  117. Installing .........................................
  118. ShowBAT requirements ...............................
  119. What ShowBAT Does ..................................
  120. FOR Fast STARTERS ..................................
  121. Preparing YOUR own Screens .........................
  122. DATA.xxx Options ...................................
  123. Using ShowBAT with other Programs ..................
  124. DEMO.BAT ...........................................
  125. REPORTING PROBLEMS/BUGS ............................
  126.  
  127.  
  128. OVERVIEW ShowBAT--------------------
  129.  
  130. ShowBAT is a program set that provides you with the capability of
  131. performing professional screen transitions when using BATch files for the
  132. creation of presentations. An IBM Personal Computer or compatible PC using
  133. MS-DOS or PC DOS version 3.0 or newer is required.  ShowBAT may work on
  134. some older versions of DOS, however, it has not been tested.
  135.  
  136. There are 13 programs in the current version of the ShowBAT program set:
  137.  
  138. BOT0.EXE    and BOT1.EXE    Replaces screen bottom-up  moving-bar/wipe-out
  139. CENTER0.EXE and CENTER1.EXE Replaces screen center-out moving-bar/wipe-out
  140. CURSOR.EXE                  Turns the cursor on after slide show
  141. LEFT0.EXE   and LEFT1.EXE   Replaces screen left-right moving-bar/wipe-out
  142. RANRE.EXE                   Replaces screen randomly   with/without banks
  143. RIGHT0.EXE  and RIGHT1.EXE  Replaces screen right-left moving-bar/wipe-out
  144. SHOW1.EXE                   Moving display box for text.
  145. TOP0.EXE    and TOP1.EXE    Replaces screen top-down   moving-bar/wipe-out
  146.  
  147.  
  148. There are 12 data files.  Each program uses its own data file that requires
  149. either six or seven entries.  The data file tells the program: Display
  150. width (40 or 80), text color, background color, the display delay in
  151. milliseconds, the transition control selection (press any key, timed, or
  152. continuous), the American Standard Code for Information Interchange (ASCII)
  153. code number of the character to be used for the moving bar and screen
  154. cover, and for RANRE.EXE (only) whether to include a random character
  155. cover.  Because SHOW1.EXE requires more than two colors, the data files
  156. only have a limited control of the color plan.
  157.  
  158. DATA.B00        DATA.B01        DATA.C00        DATA.C01        DATA.L00
  159. DATA.L01        DATA.R00        DATA.R01        DATA.RA0        DATA.S01
  160. DATA.T00        DATA.T01
  161.  
  162. Typing the name of a program without a file name results in a help screen
  163. that identifies the required data file.
  164.  
  165. All numbers in the data files must be left justified.  The default values
  166. in the DATA files were:
  167.  
  168. 80         for an eighty character display
  169. 15         for white text
  170. *          numbers from 0 to 7 for a variety of backgrounds
  171. 100        for an 100 millisecond character delay
  172. 0          requires user to press a key to continue
  173. 176        uses a open box character: ░ for moving bar
  174.  
  175. in addition DATA.RA0 has a YES on the line after the 176.
  176.  
  177. +---------------------------------------------------------------------+
  178. | When you first receive ShowBAT, please make a backup copy and put it|
  179. | in a safe place.  When you make copies to pass on, please send a    |
  180. | copy of the original.  Our explanation in this document depends on  |
  181. | starting with the original files.                                   |
  182. +---------------------------------------------------------------------+
  183.  
  184. If you received your copy of ShowBAT from a friend, the data files may have
  185. been changed.  If you are getting strange results, such as a screen with no
  186. letters, it may be that the prior user set the background and text colors
  187. equal to each other. Please check your DATA.xxx file carefully when you
  188. have problems.
  189.  
  190. There are a total of 43 files on your disk. In addition to 13 *.EXE files
  191. and 12 DATA.* files, you should find 11 PART.*, files, 4 *.BAT files, one
  192. README, one REGISTER, and one SHOWBAT.DOC file on your disk.  The * is a
  193. wildcard.  If you count the number of files ending with *.EXE you will find
  194. 13.  Each file will have its own first name.
  195.  
  196. Installing -------------------
  197.  
  198. ShowBAT may be executed from a floppy or hard disk.  If the program comes
  199. as a named SHOWBAT.ZIP file from a bulletin board, you will need
  200. PKUNZIP.EXE to un-zip the files.  The procedure is to place ShowBAT on a
  201. diskette or in a subdirectory by itself and type:
  202.  
  203. PKUNZIP *.ZIP<-'
  204.  
  205. Once the ShowBAT files are available, you may use them directly on the disk
  206. where they are stored, by including the disk or subdirectory, or by
  207. including a path statement (please see your DOS manual for additional
  208. information on paths) in front of the instruction.  BUT BUT -- the DATA.xxx
  209. file must be in the active subdirectory or disk.  We designed the procedure
  210. this way because DATA.xxx files are custom to an application.
  211.  
  212.  
  213. ShowBAT REQUIREMENTS---------------------
  214.  
  215. To use ShowBAT, you need:
  216.  
  217.  a) IBM PC "compatible" computer
  218.  b) at least one floppy diskette drive
  219.  c) IBM-PC DOS (Disk Operating System), or MS-DOS, version 3.0 or higher
  220.  
  221. You can use ShowBAT with both color or monochrome screens and with LCD
  222. overhead projectors.
  223.  
  224.  
  225. WHAT ShowBAT DOES-------------------------------------
  226.  
  227. ShowBAT gives the computer user the capability of enhancing presentations
  228. by providing custom screen transfer displays.  Figure 1 below illustrates
  229. the computer screen in the process of having its current display replaced
  230. by a new display.
  231.  
  232.  
  233. Figure 1  Screen Transfer
  234.  
  235. +---------------------------------------|
  236. |  I wish to license _____ copy/copies  |----------------------------+
  237. |  ShowBAT programs. I have enclosed    |                            |
  238. |  license plus $4.00 for handling etc. | and User's Groups:         |
  239. |                                       |--------------------        |
  240. |  Name ________________________________|is document for important   |
  241. |                                       |ns.                         |
  242. |  Company (if applicable) _____________|                            |
  243. |                                       |----------------------------+
  244. |  Address _____________________________|
  245. |                                       |UR ShowBAT
  246. |  City _______________________________ |
  247. |                                       |tm), slide show BATch file
  248. |  I prefer:  _____ 3-1/2" disk; _____ 5|e register by sending the order
  249. |                                       |r for $35.00 per copy plus $4.00
  250. |                                       |
  251. |  If you received your copy of ShowBAT |
  252. |  User's Group, or software distributor|
  253. |  location (if from a public BBS, pleas|
  254. |  _____________________________________|
  255. |                                       |
  256. +---------------------------------------|
  257.  
  258.  
  259.  
  260. FOR Fast STARTERS ----------------------------
  261.  
  262. The novice and power user may use ShowBAT to create slide shows with a
  263. multiple of transition procedures.  If your have not done so (at the DOS
  264. prompt), type:
  265.  
  266. A>README<-'
  267.  
  268. After you type README and press the Enter key, you will see a demonstration
  269. of one of our screen transitions and then a short message on the screen.
  270. Our README file includes an overview of the package and some messages.
  271.  
  272. The README.BAT file is a simple example of how to use ShowBAT.  At the DOS
  273. prompt type:
  274.  
  275. A>TYPE README.BAT<-'
  276.  
  277. and examine the contents of the README.BAT file.  You should see:
  278.  
  279. @echo off
  280. center0 readme
  281. cursor
  282. @echo on
  283.  
  284. There are four instructions in README.BAT. The first instruction: @echo off
  285. tells your disk operating system not to display future computer
  286. instructions (on the screen).  Our DOS 5.0 manual tells us that including
  287. the @ in front of ECHO OFF means that this instruction will not be printed
  288. and that not including the @ means the instruction will be printed.  We
  289. have found that some operating systems will not work right with the @ while
  290. others have trouble working without it.  Check the your DOS manual, if the
  291. instruction does not work as indicated. The second instruction in
  292. README.BAT is: center0 readme.  CENTER0.EXE is one of the ShowBAT programs.
  293. The instruction CENTER0.EXE README executes the program using the README
  294. file for data. The next instruction: cursor tells DOS to execute
  295. CURSOR.EXE. CURSOR.EXE turns the cursor on. The last instruction @echo on
  296. is the reverse of @echo off.
  297.  
  298. Note: DOS and ShowBAT instructions are not case sensitive.  You may use
  299. either upper or lower case.
  300.  
  301. DEMO.BAT is BATch file that illustrates the use of all of the ShowBat
  302. transition screens.  At the DOS prompt type:
  303.  
  304. A>DEMO<-'
  305.  
  306. to run the file.  Press <-' to move from one illustration to the next.
  307. Examine DEMO.BAT in the same manner as you examined README.BAT.  Notice
  308. that all programs (except CURSOR.EXE) in the ShowBAT collection require
  309. that you type the name of the program and then the name of the file to be
  310. displayed.  For example:
  311.  
  312. A>BOT0 part.001
  313.  
  314. ShowBAT instructions may be entered directly from the keyboard as well as
  315. in BATch file.  Type BOT0 part.001<-', press <-' to exit, and then type
  316. BOT0<-'.  The first instruction executes BOT0 using the screen display
  317. part.001, the <-' exist the program, and the BOT0<-' displays a copyright
  318. and default help screen.  On this help screen you will find the name of the
  319. DATA.xxx file required by the program you are using.
  320.  
  321.  
  322. Preparing YOUR own Screens---------------
  323.  
  324. A word processor or some type of text editor is required to create a
  325. ShowBAT data screen.  ShowBat programs display screen stored in the America
  326. Standard Code for Information Interchange (ASCII) format.  We recommend
  327. formatting the text using 79 columns by 24 rows for 80 column output or 39
  328. columns by 24 rows for 40 column output.
  329.  
  330. Almost all word processing, text editors, spreadsheet, and database
  331. programs can create ASCII files.  ASCII files may be called DOC, DOS, TXT,
  332. text, PRN, and print files.  If the file is readable when you:
  333.  
  334. A>TYPE filename<-'
  335.  
  336. then the file is an ASCII file.
  337.  
  338. An ASCII file may be created in an ASCII editor, some spreadsheet programs,
  339. and some database programs.
  340.  
  341.  
  342.  
  343. DATA.xxx Options ----------------------------
  344.  
  345. With the exception of DATA.RA0 each DATA.xxx file contains six numbers.
  346. DATA.RA0 requires one addition datum, a YES or NO (in upper case only).
  347.  
  348. Number 1:
  349.  
  350. The first number in the data set is the number 80 or 40.  The number tells
  351. ShowBAT that an 80 or 40 column screen is being used, it does not instruct
  352. DOS to change to from one type of screen to another.  The statement:
  353.  
  354. MODE 40   or MODE 80
  355.  
  356. must be used to change screen modes.  MODE.COM is a DOS utility that comes
  357. with your operating system.  MODE.COM must be available to be used.  You
  358. may copy MODE.COM from your system disk or subdirectory or include the DOS
  359. subdirectory in your path statement.
  360.  
  361.  
  362. Number 2 and 3:
  363.  
  364. Table 1 lists the text and background colors available.  We recommend you
  365. experiment with the color controls and examine their effect on your screen.
  366. We have found that the color displays vary from screen to screen. In
  367. particular, LCD overhead screens should be checked out before use.
  368.  
  369. Table 1  Color Chart
  370.  
  371. Text Color   Text Background
  372. 0 Black      0 Black
  373. 1 Blue       1 Blue
  374. 2 Green      2 Green
  375. 3 Cyan       3 Cyan
  376. 4 Red        4 Red
  377. 5 Magenta    5 Magenta
  378. 6 Brown      6 Brown
  379. 7 Light gray 7 Light gray
  380. 8 Dark gray
  381. 9 Light blue
  382. 10 Light green
  383. 11 Light cyan
  384. 12 Light red
  385. 13 Light Magenta
  386. 14 Yellow
  387. 15 White
  388. ----------------
  389.  
  390. Number 4:
  391.  
  392. ShowBAT's display speed is a function of the speed of your computer.
  393. Experiment with the character delay speed to determine what is best for
  394. your computer. We recommend you start with 100.  The larger you make this
  395. value the slower the operation.
  396.  
  397. Number 5:
  398.  
  399. Number 5 may take on values of -1, 0, or a slide show delay value. A value
  400. of -1 means that ShowBAT does not include any slow down controls.  It
  401. should be selected when using sound files or the PAUSE statement to control
  402. your show.  A value of 0 means you must press <-' to proceed.  The slide
  403. show delay value is used for automated ShowBAT shows. We recommend you
  404. select an initial delay value of 9000 and vary the value according to your
  405. system performance.
  406.  
  407.  
  408. Number 6:
  409.  
  410. Number six controls the character for your moving bar.  Check a DOS ASCII
  411. chart to determine what character you would prefer.  The code number may be
  412. from 01 to 255.
  413.  
  414. Word 7:
  415.  
  416. DATA.RA0 requires a YES or NO (all upper case) on line 7 of its data file.
  417. If you include YES, RANRE.EXE first covers the screen with characters and
  418. then its text.  If you include NO, the first step is skipped.
  419.  
  420.  
  421.  
  422. Using ShowBAT with other Programs -------------------
  423.  
  424. Our original intent in developing ShowBAT was to integrate slide show
  425. capabilities with sound and graphics show functions.
  426.  
  427.  
  428. SOUND
  429.  
  430. Sound may be produced using the internal speaker, an external speaker-sound
  431. printer (connected to your printer port), and an internal speaker add-on
  432. board.  Sound includes voice, music, animal sounds, and buzzing.  Sound may
  433. be recorded (digitized) or created from data files (synthesized).
  434.  
  435. Sound speakers, boards, and support software for recording, playback, and
  436. voice synthesizing are available from both commercial and shareware
  437. vendors.  We have used several external speakers system and have been very
  438. satisfied with how ShowBAT and these systems work together.
  439.  
  440.  
  441. GRAPHICS
  442.  
  443. The integration of graphics into a batch file requires a program that
  444. displays a file and does not take over any other controls.  There are a
  445. number of shareware vendors that provide programs of this type.
  446.  
  447.  
  448. DEMO.BAT ---------------------------------
  449.  
  450. Included on this disk is a sample BATch file: DEMO.BAT.  A BATch file
  451. contains instructions that tell the computer what to do.  The instructions
  452. in this file are listed in table 2.  The first instruction @echo off tells
  453. the operating system to execute instructions, but not to display the
  454. instructions on the screen.  Depending on your operating system, you may
  455. find it necessary to leave off the @ when giving this instruction.
  456.  
  457. Table 2  DEMO.BAT
  458.  
  459. @echo off
  460. prompt
  461. cls
  462. mode 80
  463. show1 showbat.doc
  464. cls
  465. BOT0 part.001
  466. BOT1 part.002
  467. CENTER0 part.003
  468. CENTER1 part.004
  469. LEFT0 part.005
  470. LEFT1 part.006
  471. RANRE part.007
  472. RIGHT0 part.008
  473. RIGHT1 part.009
  474. TOP0 part.010
  475. TOP1 part.001
  476. CURSOR
  477. prompt $p$g
  478. cls
  479.  
  480. The instruction: cls tells the operating system to clear the screen. Mode
  481. 80 changes the display from 40 to 80 characters across.  The MODE.COM
  482. command must recorded in a subdirectory that is part of the PATH statement,
  483. or recorded in the same subdirectory as ShowBAT. MODE.COM is one of the
  484. utilities that comes with your operating system.
  485.  
  486. The instruction: show1 showbat.doc tells the operating system to start the
  487. program SHOW1.EXE using the text file SHOWBAT.DOC  SHOW1.EXE displays the
  488. files indicated by scrolling it in a display box on the screen.  The data
  489. file DATA.S01 contains the information that tells SHOW1.EXE what colors to
  490. use.
  491.  
  492. DEMO.BAT then proceeds with the execution of the other programs and
  493. instructions as indicated.
  494.  
  495.  
  496. REPORTING PROBLEMS/BUGS ------------------------
  497.  
  498. Please let us know (in writing, please) if ShowBAT ever fails to function
  499. on your system as documented in these pages. Also, if you feel there is an
  500. aspect of the program which is insufficiently documented here, I appreciate
  501. your written suggestions.
  502.  
  503. If you submit a problem report, please be as specific as possible about
  504. what happens and in what sequence or situation. Be sure to mention these
  505. specific things: 1) your brand and model of PC; 2) your brand and version
  506. of DOS; 3) your brand and model of video adapter and display screen; and
  507. 4) what software program you are running when the problem occurs.
  508.  
  509. Please send all correspondence to:
  510.  
  511.                            A & Z Management Service, Inc.
  512.                               4151 Bay Front Road
  513.                              Mobile, Alabama 36605
  514.                                   U.S.A.
  515.  
  516.