home *** CD-ROM | disk | FTP | other *** search
/ Chestnut's Multimedia Mania / MM_MANIA.ISO / slide / txtsho21 / textshow.doc < prev    next >
Text File  |  1991-01-03  |  20KB  |  461 lines
  1.                     ********************************
  2.                     *          TEXT-SHOW           *
  3.                     *       ShareWare Version      *
  4.                     *   Documentation/Information  *
  5.                     ********************************
  6.  
  7. OVERVIEW:
  8. =========
  9.  
  10. TEXT-SHOW is a highly stylized screen presentation program from DECISIONS
  11. Software of Phoenix, Arizona.  The program allows the user to create customized
  12. screen presentations using text screens saved or captured with the included
  13. TXTCAP.COM resident screen capture utility.  TEXT-SHOW features include
  14. multiple screen fades and segues, special screen effects, text display using
  15. customized and computer fonts, border and screen clearing effects and more.
  16.  
  17. The text screen is one of the may be used by any computer system, with or
  18. without a color monitor and/or graphics card.  The program will run on any IBM
  19. compatible computer with a minimum of 256K of RAM memory.
  20.  
  21. The files included in this ShareWare version are:
  22.  
  23.                 TXTSHOW.EXE      -  The Text-Show program
  24.                 TEXTSHOW.SPT     -  Demonstration Script File
  25.                 TEXTSHOW.DOC     -  This documentation file
  26.                 TXTCAP.COM       -  Screen Capture Program
  27.                 ORDER.FRM        -  Order Form
  28.                 *.SCR            -  Several captured screen files
  29.                                     used in the demo Text-Show
  30.                                     script.
  31.  
  32. TEXT-SHOW Demonstration Show
  33. ===========================
  34.  
  35. A demonstration of many of the features of TEXT-SHOW is included in this
  36. ShareWare version.  To view the demo, change to the directory where the
  37. TEXT-SHOW files are stored.  From that directory type  TXTSHOW  at the DOS
  38. prompt and press the Enter key.  A brief ShareWare screen will appear.  In a
  39. few seconds, the demonstration program will begin.
  40.  
  41.  
  42. TEXT-SHOW SHAREWARE VERSION
  43. ==========================
  44.  
  45. The ShareWare concept is quite simple.  Try out TEXT-SHOW for a short period
  46. of time (30 days maximum).  If you would like to order TEXT-SHOW, simply send
  47. in the Registration/Order form included with this file (ORDER.FRM) along with
  48. your payment.  If not, erase the files, discontinuing all use of the program.
  49.  
  50. The ShareWare version of TEXT-SHOW is identical to the registered version with
  51. a couple of exceptions.
  52.  
  53.         1.  A brief ShareWare screen appears at the beginning and end of each
  54.         session of TEXT-SHOW.  These screens are removed in the registered
  55.         version.
  56.  
  57.         2.  The registered version includes a professionally printed and bound
  58.         user manual.  The documentation in this manual is more in depth.
  59.  
  60. Page 2.
  61.         
  62.  
  63. REGISTRATION/ORDER INFORMATION
  64. ==============================
  65.  
  66. We plan to continually add to and improve the TEXT-SHOW series of programs.
  67. Plans call for adding new and unique screen fades/segues, allow for user
  68. queries, and so forth.  Registration will guarantee that you receive the
  69. latest version of TEXT-SHOW and associated files and that you will be notified
  70. as each update is available.
  71.  
  72. We have included a form for your use in ordering TEXT-SHOW.  The order form is
  73. contained in the file  ORDER.FRM  and is stored as simple ASCII text.  You may
  74. print this form on your line printer.  To print, first log on to the
  75. drive/directory where the order form file is located.  Be sure your printer is
  76. turned on and ready to print.  At the DOS prompt type:
  77.  
  78.                 TYPE ORDER.FRM>PRN
  79.  
  80. and press the Enter key.  You may also load and print the form from any
  81. editor/word processor that accepts and prints ASCII text files.
  82.  
  83. Once you've printed the form, fill out the information requested and return
  84. along with your payment to the address indicated and we'll rush you your
  85. registered version of TEXT-SHOW.
  86.  
  87. All orders and inquiries should be directed to:
  88.  
  89.         DECISIONS Software
  90.         P.O. Box 31418
  91.         Phoenix, AZ  85046
  92.         (602)-992-0310
  93.  
  94.  
  95. HARDWARE REQUIREMENTS:
  96. ======================
  97.  
  98. Minimum hardware requirements for using TEXT-SHOW are an IBM compatible
  99. computer, DOS 2.xx or higher, 256K RAM memory and a monitor.
  100.  
  101. Page 3.
  102.  
  103. USING TEXT-SHOW
  104. ==============
  105.  
  106. This ShareWare documentation file contains information on how to use TEXT-SHOW
  107. to create your own customized screen presentations.  It covers each of the
  108. features available in TEXT-SHOW.  In-depth explanations and tutorials are
  109. included in the printed and bound manual that accompanies the registered
  110. version but are not included in this ShareWare documentation.  We do provide
  111. you, however, with all the information needed to tryout and use every feature
  112. available in TEXT-SHOW.
  113.  
  114. If you haven't viewed the demonstration of TEXT-SHOW yet, we suggest you do so
  115. before continuing with this documentation.  The demo will give you a good
  116. overview of the capabilities of the program.  To see the demo show, change to
  117. the directory where you have installed your TEXT-SHOW files.  At the DOS
  118. prompt type:
  119.  
  120.                         TXTSHOW
  121.  
  122. and press the Enter key.  The program will load and run the demonstration
  123. files.
  124.  
  125. A.  VIDEO MODE:  TEXT-SHOW uses the standard ASCII text mode of your computer.
  126. While not required, presentations may be viewed on systems that contain CGA,
  127. EGA, VGA and Super VGA graphics cards.  It is important to have an
  128. understanding of how TEXT-SHOW stores and displays screen files.
  129.  
  130. To accomplish the nifty screen fades and segues, TEXT-SHOW must store at least
  131. one screen file in background memory while displaying another visual (or
  132. foreground) screen.  The number of screens you store in the background at any
  133. one time depends on the memory available to your system.  To use the features
  134. of the program, you only need memory for two screens. . . the foreground,
  135. visible screen and one background screen.
  136.  
  137. There is NO limit to the total number of screen files you may use in a
  138. presentation.  For those with limited memory, we have included a CLEAR
  139. command.  When you have displayed a screen you may clear the memory that was
  140. required for its display and then load a new screen file.  You will notice in
  141. the demo that we load up to 5 screens at any one time.  This is the maximum
  142. amount that may be in memory in this ShareWare version.  To load more, simply
  143. load new screens in one of the 5 screen slots.  The size of each captured
  144. screen file is 4007 bytes.
  145.  Page 4.
  146.  
  147. HOW TEXT-SHOW WORKS
  148. ==================
  149.  
  150. You interface your captured text screens with TEXT-SHOW using a proprietary
  151. Script format.  The Script format is simply a set of one or two word commands
  152. that tells TEXT-SHOW what you want to do.  An example of a Script file is the
  153. demonstration file  TEXTSHOW.SPT.  Take a look at this file in any editor/word
  154. processor that is able to load and read ASCII based text files.
  155.  
  156. Once you have created or captured the text screens you wish to include, you
  157. need to tell TEXT-SHOW when and how you want them displayed.  You may also use
  158. the Script to display text (using custom or computer fonts), clear screens or
  159. draw screen borders.
  160.  
  161. You may create the Script in any editor/word processor that can save a file in
  162. standard ASCII format.  Once you've completed your Script you can name it using
  163. any conventional DOS characters.  To see the show at the DOS prompt you would
  164. type:
  165.  
  166.                         TXTSHOW [Filename.Ext]
  167.  
  168. and then press the Enter key.  The Script file and TXTSHOW.EXE file must be in
  169. the same drive/directory.  If no file name is given when TXTSHOW is entered at
  170. the DOS prompt, the program looks for a default file named TEXTSHOW.SPT.
  171. That's what we named our demo Script. If TEXT-SHOW can't find the Script file
  172. it will tell you.
  173.  
  174. Let's say you created a Script file named MYSHOW.SHW and you want to view the
  175. show.  From the DOS prompt you type:
  176.  
  177.                        TXTSHOW MYSHOW.SHW
  178.  
  179. and press the Enter key.  Be sure there is a space between TXTSHOW and your
  180. Script file name.  You may, of course, add to, change or delete lines/commands
  181. in your Script file at any time.
  182.  
  183.  
  184. SCRIPT COMMANDS
  185. ===============
  186.  
  187. The following is a review of all the Script commands available in TEXT-SHOW.
  188. Script files may be prepared in any editor/word processor that is able to save
  189. files in the ASCII format.  Each Script command must be on a separate line.
  190. Any combination of upper and lower case letters are allowed.  The proper syntax
  191. outlined below must be followed.
  192.  
  193. We have grouped the commands in six main categories.  They are:
  194.  
  195.         1.  File Commands
  196.         2.  Fades, Segues & Effects
  197.         3.  Clearing the Screen
  198.         4.  BIG Fonts
  199.         5.  Text Display
  200.         6.  Miscellanous Commands
  201.  
  202. Page 5.
  203.  
  204. 1.  File Commands:  There are three file commands.  They are LOAD, CLEAR and
  205. SEND.
  206.  
  207. LOAD [Filename.Ext] [Number]
  208. ----------------------------
  209. This script command is used to load a SCR screen file.  The LOAD command is
  210. followed by the filename and extension.  Finally, you must assign that file a
  211. number.  For example, if you wanted to load a SCR file named MYFILE and assign
  212. it as file number one the syntax would be:  LOAD MYFILE.SCR 1
  213.  
  214. You may also designate a drive and directory if your SCR file is not in the
  215. same directory as the TXTSHO.EXE program.  For example, if your file is located
  216. on drive C in a directory named SCRPICS, then the proper syntax would be:
  217. LOAD C:\SCRPICS\MYFILE.SCR 1
  218.  
  219. Be sure there is a space between each element of the command.  The LOAD command
  220. does not display the file on screen, but simply sends the information to
  221. memory.  To display a file, you use the SEND and FADES script commands after
  222. the LOAD command.
  223.  
  224. CLEAR
  225. --------------
  226. This command is the opposite of the LOAD command.  It removes all SCR screen
  227. file information from memory.  It does not affect the display screen.
  228.  
  229. SEND [Number]
  230. -------------
  231. This command identifies the loaded SCR screen file you wish to manipulate by
  232. it's number.  The SEND command is used just prior to identifying how you want
  233. the screen displayed.  The actual command to display the screen is the FADES
  234. command.  We will next examine the multiple fades available in the category
  235. named Fades & Seques.
  236.       
  237. 2.  Fades, Seques & Effects:  These commands actually display's your loaded
  238. SCR screen file on to your screen.  There are two commands in this category.
  239. They are FADES & SHAKE.   The proper syntax for the FADES command is:
  240.  
  241. FADES [Number]
  242. --------------
  243. There are 17 possible fade/segue numbers that follow the FADES command.  Here
  244. is a list of the screen fade numbers and the type of fade/segue it invokes.
  245.  
  246.  1 -  Explode
  247.  2 -  Slide Left
  248.  3 -  Slide Right
  249.  4 -  Slide Up
  250.  5 -  Slide Down
  251.  6 -  Horizontal Blinds
  252.  7 -  Puzzle Pieces
  253.  8 -  Radar Sweep
  254.  9 -  Page Roll
  255. 10 -  Vertical Blinds
  256. 11 -  Window Wipe
  257. 12 -  Fast Dissolve
  258. 13 -  Slow Dissolve
  259. 14 -  Open Curtain
  260. 15 -  Close Curtain
  261. 16 -  Side Wipe
  262. 17 -  Instant On (Entire Screen appears instantaneously)
  263.  
  264. Page 6.
  265.  
  266. SHAKE [Seconds]
  267. ---------------
  268. The SHAKE command is a special effects script command.  It will shake your
  269. video display for the number of seconds you wish.  View the demo to see how we
  270. used this special effects command.
  271.  
  272. 3.  Clearing the Screen:  There are two commands in this category.  They are
  273. CLS and SEND 6.  The proper syntax for CLS is:
  274.  
  275. CLS
  276. ---
  277. The CLS script command clears the screen.  It fills the screen with blank
  278. characters. You may designate colors for the screen with the COLOR command
  279. discussed next.
  280.  
  281. COLOR [Foreground Color Number,Background Color Number]
  282. -------------------------------------------------------
  283. The color command is used for foreground and background color of the screen.
  284. For example, the script command COLOR 15,4 would display any text in white
  285. letters on a red background.
  286.  
  287. The following list contains the Color Numbers used in TEXT-SHOW.
  288.  
  289.         0 - Black               8 - Dark Gray
  290.         1 - Blue                9 - Bright Blue
  291.         2 - Green              10 - Bright Green
  292.         3 - Cyan               11 - Bright Cyan
  293.         4 - Red                12 - Bright Red
  294.         5 - Purple             13 - Bright Purple
  295.         6 - Brown              14 - Yellow
  296.         7 - Gray               15 - White
  297.  
  298. To invoke blinking simply add 16 to the number in the chart above.  For
  299. example, the script command COLOR 31,4 would display any text in blinking
  300. white letters on a red background.
  301.  
  302.  
  303. Page 7.
  304.  
  305. SEND 6
  306. ------
  307. This command will send blank characters to memory.  You then may use any of
  308. the 17 fades with the FADES command to clear the screen using the fade effect.
  309.  
  310. 5.  Text Display:  TEXT-SHOW features the ability to display any text you wish
  311. to add to any screen.  The text may be in your resident computer font or in the
  312. custom BIG Font supplied with TEXT-SHOW.
  313.  
  314. For your resident computer font there are two script commands used to display
  315. the desired text and an optional color command.  They commands are:
  316.  
  317. COLOR [Foreground Color Number,Background Color Number]
  318. -----------------------------
  319. The color command is used for foreground and background color of the text.  The
  320. colors may be different than the screen color (For color selection numbers see
  321. the color chart above).  For example, the script command COLOR 15,4 would
  322. display any text in white letters on a red background.
  323.  
  324. AT [Row, Column]
  325. ----------------
  326. The AT script command places the desired text to begin at a specific screen row
  327. and screen column.  There are 25 rows and 80 columns on each screen.  If you
  328. wanted a line of text to appear in the upper left hand corner you would enter
  329. the following script command:  AT 1,1
  330.  
  331. PRINT ["Text"]
  332. --------------
  333. This is the script command that actually displays the text on your screen.
  334. Your text must be enclosed by quotation marks.  Example:  If you wanted to
  335. enter text that said ACME Widgets Budget Review the proper syntax would be:
  336. PRINT "ACME Widgets Budget Review"
  337.  
  338. TEXT-SHOW also lets you display custom Big Fonts.  These would mainly be used
  339. for titles and special effects.  The commands for display text in this font
  340. are similar to the commands above.
  341.  
  342. BCOL [Foreground Color Number]
  343. -------------------------------------------------------
  344. Big Fonts use the current background color of the screen. You must designate
  345. the foreground color of the font text using the color chart.  A special color
  346. number of -1 (negative one) is used when you desire a multi-colored font.
  347.  
  348. BAT [Row Word,Column Word]
  349. -----------------------------
  350. The BAT script command is identical to the AT command.
  351.  
  352. BPRNT ["Text"]
  353. --------------
  354. This is the script command that actually displays the custom font text on your
  355. screen. Your text must be enclosed by quotation marks.  Example:  If you wanted
  356. to enter text that said ACME Widgets Budget Review the proper syntax would be:
  357. FPRNT "ACME Widgets Budget Review"
  358.  
  359. BCHR [ASCII Character Number]
  360. -----------------------------
  361. This command allows you to display your Big Font using any of the 255 ASCII
  362. Characters.  See the demo script for sample characters.
  363.  
  364. Page 8.
  365.  
  366. BWID [Number]
  367. -------------
  368. This will adjust the size of the Big Font.  One is a normally Big Font.  Two
  369. is a Huge Font.
  370.  
  371. 6.  Miscellanous Script Commands
  372.  
  373. MOUSE [On/Off]:
  374. ---------------
  375. If you have a mouse active on your computer you may use it as a pointer and a
  376. remote control device.  To activate the mouse the proper syntax is MOUSE ON.
  377. When you turn the mouse on, a cursor will appear in the upper right hand
  378. corner of your screen.  You may then move the cursor on your screen as you
  379. move your mouse.  To make the cursor disappear the proper syntax is MOUSE OFF.
  380.  
  381. If the mouse is connected, you may use it as a remote control device wether or
  382. not the pointer is displayed.  Clicking the right and center mouse buttons move
  383. forward one screen.  Clicking the left mouse button will end the show.
  384.  
  385. DELAY [Seconds]
  386. ---------------
  387. You may create a designated delay between screens by using the DELAY script
  388. command.  If you wanted to delay 3 seconds between screen actions the proper
  389. syntax would be:  DELAY 3
  390.  
  391. PAUSE
  392. -----
  393. Pause is similar to delay except that a key press or mouse click is required
  394. for the show to continue.  Pressing the left mouse key or the Esc keyboard key
  395. will terminate the show.  Pressing any other key will move forward to the next
  396. script command.
  397.  
  398. LOOP
  399. ----
  400. If you wish to redisplay the entire show from the beginning without having to
  401. rerun TEXT-SHOW you would use the LOOP command.  This will start the show over
  402. from the very beginning.  In the ShareWare version, this means from the opening
  403. ShareWare screen.  In the registered version, this means from the first command
  404. in your script file.
  405.  
  406. BORDER [ASCII Character Number]
  407. --------------------------------
  408. You may draw a border around any screen with the BORDER script command.  You
  409. may also choose a color for that border using the color chart listed earlier in
  410. this documentation.  To draw a single line border on your screen the proper
  411. syntax would be:  BORDER 1  To draw a double line border the proper syntax
  412. would be BORDER 2.  To draw a border comprised of ASCII Character 219 the
  413. proper syntax would be BORDER 219.
  414.  
  415.  
  416. Page 9
  417. ----------
  418. TXTCAP.COM
  419. ----------
  420.  
  421. TXTCAP.COM is memory resident screen capture program.  The purpose of this
  422. program is to capture any text screen you can display on your monitor in the
  423. Bload, Text-Show, SCR file format.
  424.  
  425. To use this program, simply type TXTCAP.COM at the DOS prompt.  You will see a
  426. brief message appear on your screen.  The message tells you that the program
  427. has been loaded, is memory resident and may be invoked by pressing the Ctrl-F9
  428. key combination.
  429.  
  430. HOW TO CAPTURE SCREENS:  When you have a text screen displayed that you wish
  431. to capture, press the Ctrl-F9 key combination (while holding down the Ctrl
  432. key press the F9 function key).  A prompt will appear at the upper left hand
  433. corner of your screen.  This prompt asks you to enter a filename.  The
  434. filename must contain no more than 8 valid DOS filename characters and should
  435. be followed with a SCR extension.  After you have entered the filename, press
  436. the Enter key.  The program will then capture the graphics screen in SCR
  437. Text-Show file format.  The captured file will reside in the current drive and
  438. directory.
  439.  
  440. If after pressing the Ctrl-F9 key combination you determine that you really
  441. don't want to save the screen, simply press the Esc key.  Your screen will
  442. return and the file will NOT be saved.
  443.  
  444. To remove the ScreenCapture program from memory, simply type  TXTCAP /U
  445. at the DOS prompt and press the Enter key.  This will unload (remove) the
  446. program from memory, i.e., it will no longer be memory resident.
  447.  
  448.  
  449. ==========
  450. DISCLAIMER
  451. ==========
  452.  
  453. TEXT-SHOW is a copyrighted program of Decisions Software of Phoenix, Arizona.
  454. These programs are provided "as is" without warranty of any kind, either
  455. expressed or implied, including but not limited to the implied warranties of
  456. merchantability and fitness for a particular purpose. Decisions Software and
  457. it's employees shall have no responsibility or liability to you or any other
  458. person, persons, or entity with respect to loss or damage caused or alleged to
  459. be caused directly or indirectly by use of these programs or their
  460. documentation.
  461.