home *** CD-ROM | disk | FTP | other *** search
/ The Best of the Best / _.img / 02161 / sshow.doc < prev    next >
Text File  |  1992-03-05  |  92KB  |  1,970 lines

  1.                               PCX SuperShow
  2.                       A Presentation Software System
  3.                       ==============================
  4.                               INTRODUCTION
  5.                       ==============================
  6.  
  7. PCX-SuperShow is a highly stylized multi-media presentation program from PC
  8. WEST Software & Services of Phoenix, Arizona.  The program allows the user to
  9. create customized screen presentations using pictures/screens saved or captured
  10. in the PCX file format.  PCX-SuperShow features include multiple screen fades
  11. and segues, kaleidoscope screen effects, special effects, circle and box
  12. drawing, support of digitized voice and music with the Sound Blaster and
  13. compatible sound cards, PC Speaker music and sound, text display using
  14. customized and computer fonts, border and screen clearing effects and more.
  15.  
  16. The PCX file format is one of the single most used graphics file formats in the
  17. DOS world.  It is the native format of the PC Paintbrush series of programs and
  18. was developed by ZSoft Corporation.  Most of the major graphics programs allow
  19. the importing and/or exporting of graphics screens in this format.
  20.  
  21. PCX-SuperShow works by creating a script consisting of one or two script
  22. commands that tells the program what and how you want your files or text and
  23. drawings to be displayed.  An example of a complete script is the file
  24. PCXSHOW.SPT.
  25.  
  26. The files included in this shareware version are:
  27.  
  28.         PCXSS.EXE               -  PCX-SuperShow program
  29.         PCXSP.EXE                  -  The Script Generator/Editor
  30.         PCXSHOW.SPT             -  Full Demo Script File for VGA systems
  31.     *.PCX            -  Various PCX Screen files for demo
  32.     *.FNT            -  Various GEM Screen fonts
  33.     *.MUS            -  Various Music/Song Files
  34.     SUPER.OTL        -  SuperFont Data
  35.         SSORDER.FRM             -  SuperShow order form (ASCII text file)
  36.  
  37. The shareware executable SuperShow Files PCXSS.EXE and PCXSP.EXE are identical
  38. to the registered version with the exception of a brief shareware sign-on and
  39. sign-off screen that appears each time you run your show.
  40.  
  41. There are a number of files not included with this shareware version that you
  42. will receive when you register PCX-SuperShow.  The main reason we have not
  43. included these files is for the reason of space.  The entire PCX-SuperShow
  44. registered version includes programs and files that total over 1.5 megabytes.
  45.  
  46. Additonal files/programs you'll receive with the registered version include:
  47.  
  48.         Ten (10) PCX file utilities:  These utilities include graphics and text
  49.         screen capture programs, image sizing, printing, and viewing programs.
  50.  
  51.         Over 2 dozen custom font files:  SuperShow uses the GEM font format and
  52.         we include over 2 dozen custom font files with your registered version.
  53.  
  54.         Runtime Module:  The registered version includes a couple of programs
  55.         that allow you to make a runtime version of your presentation for
  56.         distribution with no royalties.
  57.  
  58.         Music/Voice Files:  SuperShow supports the Sound Blaster compatible
  59.         digitized voice files and also a music file format for your pc speaker.
  60.         You receive additional music & voice files when registering.
  61.  
  62.         A professionally printed and bound manual that is more in depth than
  63.         this documentation.
  64.  
  65. And of course we are constantly updating our series of programs and files.
  66. When you register, you'll receive the very latest version of SuperShow.
  67.  
  68. This documentation is a subset of our printed manual.  There may be references
  69. to some of the programs not included with the shareware version.  For the most
  70. part, chapters dealing with these files have been removed from this shareware
  71. documentation.
  72. ------------------------------------------------------------------------------
  73.  
  74.                         PCX-SuperShow Demonstration Show
  75.  
  76. A demonstration of many of the features of PCX-SuperShow is included in this
  77. version. To view the demo, change to the directory where the PCX-SuperShow
  78. files are stored.  From that directory type  PCXSS  at the DOS prompt and press
  79. the Enter key.  In a few seconds, the demonstration program will begin.  If you
  80. haven't viewed the demonstration of PCX-SuperShow yet, we suggest you do so.
  81. The demo will give you a good overview of the capabilities of the program.
  82.  
  83. This version of PCX-SuperShow includes PCX-ShowPrep (PCXSP.EXE).  This is an
  84. ASCII based text editor that allows you to create your PCX-SuperShow script and
  85. run the show right from the editor with a simple key stroke.  ShowPrep also
  86. features pull-down menu selections that automatically write script commands for
  87. you.  Details on using PCXSP.EXE are found in the chapter titled PCX-ShowPrep.
  88.  
  89. All orders and inquiries should be directed to:
  90.  
  91.  
  92.                                     PC WEST
  93.                                 P.O. Box 31418
  94.                                Phoenix, AZ  85046
  95.                                  (602)-992-0310
  96.  
  97.                                 ============
  98.                                 REQUIREMENTS
  99.                                 ============
  100.  
  101. Graphics programs, especially ones requiring high screen resolution displays,
  102. such as VGA or Super VGA, are very memory and speed intensive.  PCX-SuperShow
  103. is no exception.
  104.  
  105. As you will note below, PCX-SuperShow will run on a simple PC or PC-XT with a
  106. clock speed of 4.77 mhz.  However, if you plan to use the VGA or Super VGA mode
  107. on this type of system you will be disappointed.  The speed is "Oh so slow".
  108. On the other hand, if your presentation is comprised of files and screens in
  109. the CGA or even EGA mode, then the speed is certainly acceptable.
  110.  
  111. Below, we've listed three types of hardware requirements.  You will be most
  112. pleased if your requirements match those of the recommended or ideal.
  113.  
  114. Minimum Hardware Requirements:  Minimum hardware requirements for using
  115. PCX-SuperShow are an IBM computer (PC, XT, AT, PS/2) or compatible, DOS 2.xx or
  116. higher, 512K Conventional RAM memory available when running PCX-SuperShow and a
  117. CGA, EGA, VGA or SVGA graphics card with 256K Video Memory.
  118.  
  119. Recommended Hardware Requirements:  The recommended hardware requirements for
  120. using PCX-SuperShow are an AT class 286, 386SX, 386, 486 computer with 16mhz
  121. chip speed or better, 1mb of expanded memory (or extended memory that may be
  122. made expanded by DOS 5.0 or other memory manager software), 512K Conventional
  123. RAM memory available when running PCX-SuperShow and a VGA graphics card.
  124.  
  125. Ideal Hardware Requirements:  The ideal hardware configuration for using
  126. PCX-SuperShow is a 386SX, 386 or 486 class computer with 20mhz chip speed or
  127. better, 2mb of expanded memory, 512K Conventional RAM memory available when
  128. running PCX-SuperShow and a supported SVGA graphics card.  A printer is also
  129. desirable but not required.
  130.  
  131. If your presentations will always be in CGA or EGA mode, we recommend you
  132. consider acquiring our PCX-Show 4.0.  This version in our Show series uses
  133. video ram, for the most part, for EGA & CGA pcx files and will run smoothly on
  134. a PC or PC-XT.
  135.  
  136. Supported SVGA Graphics Cards:  The computer industry was together when
  137. creating the standards for CGA, EGA and VGA graphic cards. . . but then along
  138. came Super VGA and we ended up with several different standards for the Super
  139. VGA graphics mode.  The industry is trying to rectify that now with the VESA
  140. standard.  In the meantime, there are a lot of different SVGA cards out there.
  141. We've attempted to include support for most of them.  PCX-SuperShow definitely
  142. supports the following cards/chip sets:
  143.  
  144.     Diamond SpeedStar    Paradise        Orchid
  145.         Video Seven             ATI                     Hercules
  146.     Tseng Chip Set Cards
  147.  
  148. There are other brands that use different names but actually use an acceptable
  149. chip set.  For example, there are several different brand names that use the
  150. Tseng 4000 based chip set.  PCX-SuperShow will perform well in the SVGA mode
  151. with any of those brands. 
  152.  
  153. What if you have an unsupported chip set?  We're working on it.  In the
  154. meantime, you will be able to use PCX-SuperShow in the CGA, EGA and VGA modes.
  155.  
  156. Memory Information:  As we've indicated, graphics programs require lots of
  157. memory.  Here is the way PCX-SuperShow uses memory.  
  158.  
  159.         A. First, the program itself will take up about 200K of conventional
  160.         memory.  If you started with 512K free, that leaves you with about 312K
  161.         of ram.  Next, the program sets aside 64K ram for the custom fonts.
  162.         Another 12K or so for the SuperFont.  Now we are down to about 200K of
  163.         conventional memory for loading pcx files and creating buffers to store
  164.         them and so forth.  If you have an SVGA pcx file that is 250K in size,
  165.         it becomes clear that there isn't enough conventional ram to handle it.
  166.  
  167.         B.  When conventional ram is exhausted, then SuperShow looks for
  168.         expanded memory.  If it's available, it will use it to store and
  169.         display your pcx files very rapidly.
  170.  
  171.         C.  When there is no conventional ram or expanded memory available the
  172.         avenue of last resort is your hard disk.  SuperShow will use your hard
  173.         disk as virtual memory.  The penalty is speed.  We are at the mercy of
  174.         the speed of your hard drive for displaying pcx files stored this way.
  175.         The net effect will be a very slow screen write.
  176.  
  177. The Bottom Line:  There is a saying that "you can never be too rich or too
  178. thin."  For computers the saying is "Computers can never be too fast or have
  179. too much memory."   
  180.  
  181.                                       ========
  182.                                       OVERVIEW
  183.                                       ========
  184.  
  185. You interface your PCX formatted screens with PCX-SuperShow using a proprietary
  186. Script format.  The Script format is simply a set of one or two word commands
  187. that tells PCX-SuperShow what you want to do.  An example of a Script file is
  188. the demonstration file  PCXSHOW.SPT.  Take a look at this file in the
  189. PCX-ShowPrep editor or any editor/word processor that is able to load and read
  190. ASCII based text files.  
  191.  
  192. If you've never used PCX-SuperShow before, a great way to begin learning the
  193. program is to load the tutorial scripts in the PCX-ShowPrep editor.  You may
  194. view the script contents in the editor and run the script from the editor.
  195.  
  196. Once you have created or captured the PCX screens you wish to include, you need
  197. to tell PCX-SuperShow when and how you want them displayed.  That is the
  198. purpose of the script.  
  199.  
  200. In it's simplest form, your show centers around the SHOW script command.  This
  201. is the command you use to display your pcx files.  You may, of course, display
  202. your pictures using the dozens of fades, segues and special effects found in
  203. PCX SuperShow.  
  204.  
  205. You may also use the Script to display text (using custom , SuperFont or the
  206. ROM computer fonts), pop-up window boxes and or circles, create kaleidoscope
  207. screens, clear screens, draw screen borders and more.   The demo script,
  208. PCXSHOW.SPT demonstrates the use of these script commands.
  209.  
  210. You may create the Script in PCX-ShowPrep or any editor/word processor that can
  211. save a file in standard ASCII format.  We strongly recommend your using the
  212. PCX-ShowPrep program to prepare your script.  This program allows you to choose
  213. any of the dozens of script commands from a pull-down menu system.  When you
  214. choose the script command, the program will insert it in your script, saving
  215. you the time of typing or typo error correction.
  216.  
  217. Once you've completed your Script you can name it using any conventional DOS
  218. characters.  To see the show at the DOS prompt you would type:
  219.  
  220.                         PCXSS [Filename.Ext]
  221.  
  222. and then press the Enter key.  The Script file and PCXSS.EXE file must be in
  223. the same drive/directory.  If no file name is given when PCXSS is entered at
  224. the DOS prompt, the program looks for a default file named PCXSHOW.SPT.  That's
  225. what we named our full-demo Script. If PCX-SuperShow can't find the Script file
  226. it will tell you.
  227.  
  228. Let's say you created a Script file named MYSHOW.SHW and you want to view the
  229. show.  From the DOS prompt you type:
  230.  
  231.                        PCXSS MYSHOW.SHW
  232.  
  233. and press the Enter key.  Be sure there is a space between PCXSS and your
  234. Script file name.  You may, of course, add to, change or delete lines/commands
  235. in your Script file at any time.
  236.  
  237. Of course, the easiest way to create and view your script/show is by using our
  238. new PCX-ShowPrep editor/script generator.  This program allows you to choose
  239. your script commands from menus and automatically writes the script for you.
  240. You also may run the script directly from the editor so you may monitor your
  241. progress without having to leave the editor.
  242.  
  243. One of the best ways to learn to use PCX-SuperShow is by looking and modifying
  244. the demo script, PCXSHOW.SPT.  We have included just about every script command
  245. available in SuperShow in this script file.  Loading this script file will show
  246. you how each effect, transition, fade, segue, screen write, etc., was
  247. accomplished.
  248.  
  249. There are dozens of script commands in PCX-SuperShow.  The next chapter, SCRIPT
  250. COMMANDS, covers each of those commands in depth.  The script commands are
  251. listed in alphabetical order.
  252.  
  253.                                 ===============
  254.                                 SCRIPT COMMANDS
  255.                                 ===============
  256.  
  257. The following is a review of all the Script commands available in
  258. PCX-SuperShow.  Script files may be prepared in any editor/word processor that
  259. is able to save files in the ASCII format.  We do highly recommend, however,
  260. that you use PCX-ShowPrep.  From ShowPrep you will be able to pick your script
  261. commands from pull-down menus.  It will make creating your script very easy.
  262.  
  263. Each Script command must be on a separate line.  Any combination of upper and
  264. lower case letters is allowed.  The proper syntax outlined with each script
  265. command listed below must be followed.
  266.  
  267. We have grouped the commands in alphabetical order to make it easy for you to
  268. find a particular script command quickly.
  269.  
  270.  
  271. ATPIX [Pixel Column,Pixel Row]
  272. ------------------------------
  273. Purpose:  This command allows you to place a custom font, SuperFont and/or pcx
  274. image at any screen location.  It designates, in pixels, the upper left hand
  275. corner where you wish to place your pcx picture.
  276.  
  277. Comments: The main use of this command is to locate where you wish your print
  278. statement or pcx image to be located on your screen.  For full screen pcx
  279. images the command is always ATPIX 0,0.  Smaller pcx images may be located
  280. anywhere on the screen using the ATPIX command.
  281.  
  282. The total number of pixel columns and rows for any given screen varies
  283. depending on the screen mode being used.  A typical EGA screen has 640 pixel
  284. columns and 350 pixel rows.  A VGA screen has 640 pixel columns and 480 pixel
  285. rows.  A super VGA screen may have 800 pixel columns and 600 pixel rows or 1028
  286. pixel columns and 768 pixel rows.  When you begin using PCX-SuperShow the
  287. default is set at column 0 and row 0, or the upper left hand corner. Once you
  288. issue this command the pixel column and row remains set to those locations
  289. until another ATPIX script command is encountered.
  290.  
  291. See Also: SHOW, PRINT, SPRINT, TYPE, LOGO
  292.  
  293. ANGLE [degrees]
  294. ---------------
  295. Purpose:  The ANGLE command is used to rotate text displayed using the
  296. SuperFont.  
  297.  
  298. Comments:  The default is 0 degrees which means the SuperFont text will be
  299. displayed normally.  To display the SuperFont at a 45 degree angle the command
  300. would be ANGLE 45.  That angle will remain in effect until another ANGLE script
  301. command is issued.  Both negative and positive angle degree numbers may be
  302. used.  Valid degree numbers are from -359 to 359.
  303.  
  304. See Also:  SPRINT, OUTLINE, SIZE, SPACE
  305.  
  306.  
  307. BOX [X1,Y1,X2,Y2]
  308. ------------------
  309. Purpose:  The BOX script command gives you the ability to pop-up boxes
  310. (windows) of any size, color and fill design during your presentation.  
  311.  
  312. Comments:  This command may now be used in all screen modes.  You control the
  313. size and location of the boxes by entering the beginning and ending pixel rows
  314. and columns immediately following the BOX command.  
  315.  
  316. The easiest way to create your pop-up box is by using the Box drawing tool
  317. found in the ShowPrep editor.  This allows you to size, shape and move the box
  318. to the exact location on the screen using your cursor keys.  See Box drawing
  319. tool in the ShowPrep portion of this manual for full instructions.
  320.  
  321. The BOX X and Y coordinates are as follows:
  322.  
  323.             X1 = Beginning Column Pixel Location
  324.             Y1 = Beginning Row Pixel Location
  325.             X2 = Ending Column Pixel Location
  326.             Y2 = Ending Row Pixel Location
  327.  
  328. Remember, the EGA mode has 640 column pixels and 350 row pixels.  They are
  329. numbered 0 to 639 and 0 to 349 respectively.  The VGA screen mode has 640
  330. column pixels and 480 row pixels.  They are numbered 0 to 639 and 0 to 479
  331. respectively.  For example, if you wish to draw a pop-up box in the center of
  332. the screen the command is:   BOX 200,128,451,220
  333.  
  334. IMPORTANT:  It is no longer necessary to have three digits for each coordinate.
  335. For example, if you wanted to draw the above box beginning at column 1 and row
  336. 15 the proper syntax is:  BOX 1,15,451,220.
  337.  
  338. To control the color of the box, simply issue the COLOR script command before
  339. entering the BOX command.  For example, to draw a blue box with a white border,
  340. the proper color command is:  COLOR 15,1  
  341.  
  342. To control the fill design of the box, simply issue the FILL script command
  343. before entering the BOX command.  The default FILL command is solid.
  344.  
  345. See Also:  COLOR, FILL, Box Drawing Tool in ShowPrep, CIRCLE
  346.  
  347.  
  348. CGA2
  349. ----
  350. Purpose:  To set the screen mode to CGA, 2 color at 640 x 200.
  351.  
  352. Comments:  This is one of the screen setting modes.  You must set your screen
  353. to a desired mode (CGA2, CGA4, EGA, VGA16, or VGA320) as the first script
  354. command.  The default is CGA2.
  355.  
  356. See Also:  CGA4, EGA, VGA16, VGA320
  357.  
  358.  
  359. CGA4
  360. ----
  361. Purpose:  To set the screen mode to CGA, 4 color at 320 x 200.
  362.  
  363. Comments:  This is one of the screen setting modes.  You must set your screen
  364. to a desired mode (CGA2, CGA4, EGA, VGA16, or VGA320) as the first script
  365. command.  The default is CGA2.
  366.  
  367. See Also:  CGA2, EGA, VGA16, VGA320
  368.  
  369.  
  370. CIRCLE [X,Y,H,V]
  371. ----------------
  372. Purpose:  The CIRCLE script command gives you the ability to pop-up
  373. circles/ellipse of any size, color and fill design during your presentation.
  374. While this command is called circle, since you can control the size of both the
  375. major and minor axis, this means that you can draw an ellipse as well as
  376. circles.
  377.  
  378. Comments:  This command may be used in all screen modes.  You control the size
  379. and location of the ellipse by entering the beginning and ending pixel rows,
  380. columns and axis immediately following the CIRCLE command.  
  381.  
  382. The easiest way to create your pop-up ellipse is by using the Circle drawing
  383. tool found in the ShowPrep editor.  This allows you to size, shape and move the
  384. ellipse to the exact location on the screen using your cursor keys.  See Circle
  385. drawing tool in the ShowPrep portion of this manual for full instructions.
  386.  
  387. The CIRCLE coordinates are as follows:
  388.  
  389.         X,Y = The ellipse will be centered at (X,Y) pixel location.
  390.         H = This is the major (horizontal) axis.
  391.         V = This is the minor (vertical) axis.
  392.  
  393. The CIRCLE script command will draw an ellipse centered at (X,Y).  The radius
  394. of that ellipse is H by V.
  395.  
  396. Remember, the EGA mode has 640 column pixels and 350 row pixels.  They are
  397. numbered 0 to 639 and 0 to 349 respectively.  The VGA screen mode has 640
  398. column pixels and 480 row pixels.  They are numbered 0 to 639 and 0 to 479
  399. respectively.  
  400.  
  401. For example, if you wish to draw a circle in the center of a VGA screen with a
  402. radius of 140 by 140 the command is:   CIRCLE 320,240,140,140
  403.  
  404. To control the color of the ellipse, simply issue the COLOR script command
  405. before entering the CIRCLE command.  For example, to draw a blue ellipse with a
  406. white border, the proper color command is:  COLOR 15,1
  407.  
  408. To control the fill design of the box, simply issue the FILL script command
  409. before entering the CIRCLE command.  The default FILL command is solid.
  410.  
  411. See Also:  COLOR, FILL, Circle Drawing Tool in ShowPrep, BOX
  412.  
  413.  
  414. CLR [Color Number],[Fade Number],[X1,Y1,X2,Y2]
  415. ----------------------------------------------
  416. Purpose:  The CLR script command clears any portion or the entire screen using
  417. your choice of color and fade effect.
  418.  
  419. Comments:  When CLR is issued the screen is filled with blank characters using
  420. one of 30 different fade techniques.  In addition, you may designate pixel
  421. locations and background color for the screen.  The following is a list of
  422. screen clear fade numbers and the type they invoke:
  423.  
  424.      1- Instant On        11- Diag. Down Left    21- Close Horizontal
  425.      2- Wipe Down        12- Diag. Up Right    22- Close Vertical
  426.          3- Wipe Up             13- Diag. Up left       23- Drip Down
  427.          4- Wipe Right          14- Explode             24- Drip Up
  428.          5- Wipe Left           15- Implode             25- Pour Down
  429.          6- Slide Down          16- Puzzle Pieces       26- Pour Up
  430.          7- Slide Up            17- Spiral Out          27- Weave Horizontal
  431.      8- Slide Right        18- Spiral In        28- Weave Vertical
  432.      9- Slide Left        19- Open Horizontal    29- Horizontal Blinds
  433.         10- Diag. Down Right    20- Open Vertical       30- Vertical Blinds
  434.  
  435. These 30 screen transitions may be further modified by separately adjusting the
  436. number of horizontal and vertical pixel numbers with the PIXNUM command. . .
  437. thus creating totally different screen clearing effects.  See the PIXNUM script
  438. command for further details.
  439.  
  440. For Color Number selection see the color number chart listed in the COLOR
  441. script command summary.
  442.  
  443. You may clear any portion of the screen using the color and fade effects.  You
  444. control the portion cleared by entering the desired pixel coordinates.  To
  445. clear the entire screen all the pixel coordinates should be zero (0). 
  446.  
  447. The CLR X and Y coordinates are as follows:
  448.  
  449.             X1 = Beginning Column Pixel Location
  450.             Y1 = Beginning Row Pixel Location
  451.             X2 = Ending Column Pixel Location
  452.             Y2 = Ending Row Pixel Location
  453.  
  454. See Also:  COLOR, PIXNUM
  455.  
  456. COLOR [Combined Color # |or| Foreground Color #,Background Color #]
  457. --------------------------------------------------------------------
  458. Purpose:  The color command is used to set the foreground and background color
  459. when displaying text; to set the foreground color when displaying text with a
  460. custom font or SuperFont; to set the screen color when clearing the screen with
  461. the CLR command; and to set the frame and fill color when drawing boxes or
  462. circles.
  463.  
  464. Comments:  There are two forms of syntax acceptable when issuing the COLOR
  465. script command.  One is using a single, combined color number.  The other is
  466. using separate foreground and background color numbers separated by a comma.
  467. For example, the script command COLOR 15,1 or COLOR 31, both set the foreground
  468. to white and the background to blue.  The combined color number is primarily
  469. for use when using PCX-ShowPrep's color pop-up menu for color selection.
  470. ShowPrep uses the combined color syntax when insert ing the command into your
  471. script.
  472.  
  473. When used just prior to issuing a BOX or CIRCLE drawing command, the foreground
  474. color will be the color of the box or circle frame and the background color
  475. will be the fill color.
  476.  
  477. When used just prior to printing text with SuperFont, the background number
  478. will be ignored as it uses whatever colors are currently on the screen as
  479. background.
  480.  
  481. When you choose STYLE NORMAL with custom fonts both the background and
  482. foreground colors are in effect.  If you choose STYLE OVERLAY then only the
  483. foreground color is in effect.
  484.  
  485. The following list contains the individual Color Numbers used in PCX-SuperShow.
  486. For a complete table of combined color numbers, view the color window (F2
  487. hot-key) in the PCX-Showprep program.
  488.  
  489.         0 - Black            8 - Dark Gray
  490.         1 - Blue            9 - Bright Blue
  491.         2 - Green            10 - Bright Green
  492.         3 - Cyan            11 - Bright Cyan
  493.                 4 - Red                         12 - Bright Red
  494.         5 - Purple            13 - Bright Purple
  495.         6 - Brown            14 - Yellow
  496.         7 - Gray            15 - White
  497.                   
  498. Also See: PAL, EPAL, VPAL, BOX, PRINT, SPRINT, CLR, FONT, STYLE
  499.  
  500.  
  501. CONDITIONAL BRANCHING:
  502. ----------------------
  503. Purpose:  Conditional branching allows you to construct a menu system that
  504. permits the user to move forward and/or backward to certain predesignated
  505. points in your show.  There are four script commands that are used in
  506. combination to create conditional branching in your show.  We will discuss them
  507. in the order they should be created in your show.  Also, be sure to see the
  508. tutorial script GOTO1.SPT listed in Appendix B of this manual and also
  509. contained on your distribution disk in electronic form.
  510.  
  511. :[LABEL]
  512. ---------
  513. The first thing you'll want to do is decide and create the points in the script
  514. you want the user to be able to go to and return to/from.  These points are
  515. designated by creating line labels.  A line label always begins with a colon
  516. (:).  Then you may designate any word as your label immediately following the
  517. colon.  For example, if you wanted to create a label named MAIN MENU you would
  518. enter the script command :MAIN MENU on a line by itself.
  519.  
  520. INPUT
  521. -----
  522. After you have created your line labels, you'll next decide where in the script
  523. you wish to give the user the opportunity to branch to these labels.  This is
  524. accomplished with the INPUT and IF _ GOTO commands.  The INPUT command is very
  525. similar to the PAUSE command.  It stops your show and waits for the user to
  526. press a key.  The difference is that when using INPUT, the program records the
  527. key that was pressed.  INPUT waits for only one key press and then goes on to
  528. process the next script command which shou ld always be the IF _ GOTO command.
  529. Using INPUT without the IF _ GOTO command would be just like using the PAUSE
  530. command.
  531.  
  532. IF [key] GOTO :[label]
  533. ----------------------
  534. This is the command that determines which line label the program will go to.
  535. You may go forward or backward from that point in the script.  The program will
  536. recognize any normal, printable ASCII character as the key.  You will probably
  537. want to use a single digit number or alphabet character to designate the
  538. desired key press.  For example, if you had two choices for your user the
  539. proper syntax might be IF 1 GOTO :LABEL1 and the next line would be IF A GOTO
  540. :LABEL2.
  541.  
  542. If the user in the above example presses any other key than 1 or A, the program
  543. will simply go forward and execute the next script command.  If a non-existent
  544. line label is encountered the program will execute from the beginning.
  545.  
  546. RETURN :[label]
  547. ---------------
  548. Finally, if you wish the user to be able to return from branching you will need
  549. to issue a RETURN : script command.  This command would almost always be
  550. inserted as the last command in your branching routine, i.e., at the end of the
  551. series of script commands following the :LABEL.  Using the example cited above,
  552. if you want the user to return to the MAIN MENU label after branching to
  553. another label the proper syntax would be RETURN :MAIN MENU.
  554.  
  555. Here is what a simple conditional branching script may look like:
  556.  
  557. ------------------------------------------------------------------------------
  558.  
  559. :MAIN
  560. VGA16
  561. FONT ROM16
  562. COLOR 14,0
  563. :TOPP
  564. CLR 1,0,0,0,0,0
  565. ATPIX 100,100
  566. PRINT "1.  Choice Number One"
  567. ATPIX 100,120
  568. PRINT "A.  Choice Number Two"
  569. INPUT 
  570. IF 1 GOTO :LABEL1
  571. IF A GOTO :LABEL2
  572. CLR 1,1,0,0,0,0
  573. ATPIX 100,100
  574. PRINT "A KEY OTHER THAN 1 OR A WAS PRESSED"
  575. DELAY 4
  576. GOTO :TOP
  577. :LABEL1
  578. CLR 2,2,0,0,0,0
  579. ATPIX 100,100
  580. PRINT "THIS IS CHOICE NUMBER ONE"
  581. DELAY 4
  582. RETURN :TOP
  583. :LABEL2
  584. CLR 2,3,0,0,0,0
  585. ATPIX 100,100
  586. PRINT "THIS IS CHOICE NUMBER TWO"
  587. DELAY 4
  588. RETURN :TOP
  589. -------------------------------------------------------------------------------
  590.  
  591. It is not necessary to return to the calling line label.  You may return to any
  592. valid line label.
  593.  
  594. If a RETURN script command is encountered without being sent by an IF _ GOTO
  595. command it will simply be ignored.
  596.  
  597. ee Also:  GOTO, PCXSHOW.SPT sample script
  598.  
  599.  
  600.  
  601. CRAWL ["Message"]
  602. ------------------
  603. Purpose:  The CRAWL command will display a ticker tape type message while
  604. waiting for a key press or until a specified time expires.
  605.  
  606. Comments:  This command is similar to the PAUSE script command, except that a
  607. message you enter scrolls, right to left, across the screen until a key is
  608. pressed or until the time set with the CRWLAT script expires.  The message must
  609. not contain more than 254 characters or an error will occur.  The message and
  610. number of desired spaces must be enclosed with quotation marks.  The color of
  611. the text and the screen location are determined by the COLOR and CRWLAT script
  612. commands respectively.  A demonstration of t he CRAWL command is included in
  613. the PCXSHOW.SPT sample script file.
  614.  
  615. See Also:  CRWLAT, COLOR, ATPIX
  616.  
  617.  
  618. CRWLAT [X,Y,X2,Display Time]
  619. ----------------------------
  620. Purpose:  To set the parameters for using the CRAWL special effect.
  621.  
  622. Comments:  This command is used to set the screen location and display time for
  623. the CRAWL script command.  The coordinates are as follows:
  624.  
  625. X= Pixel Column Start;  Y= Pixel Row; X2= Pixel Column End; Display Time= The
  626. length in seconds you wish the message to continuously crawl across the screen.
  627.  
  628. For example:  The following script command CRWLAT 100,200,400,30 means you wish
  629. to display the CRAWL message at row 200, beginning at column 100 and ending at
  630. column 400 for 30 seconds.
  631.  
  632. See Also:  CRAWL, ATPIX
  633.  
  634.  
  635. DELAY [Seconds]
  636. ---------------
  637. Purpose: This script command creates a delay of a designated number of seconds
  638. before executing the next script command.
  639.  
  640. Comments:  You would use this command to allow the user to view/read a
  641. particular screen before executing the next script command.  For example if you
  642. wanted to delay 3 seconds between screen actions the proper syntax would be:
  643. DELAY 3
  644.  
  645. See Also:  PAUSE, WAIT, SLEEP, CRWLAT
  646.  
  647.  
  648. ESCKEY [On/Off]
  649. ---------------
  650. Purpose:  To activate/deactivate the Esc key during pcx image fades.
  651.  
  652. Comments:  You may now activate or deactivate the Esc key as a fade abort key
  653. during the SHOW fade screen transitions.  The default is ESCKEY On.  This means
  654. that when the Esc key is pressed during the middle of a screen fade/transition,
  655. the fade will be aborted and the very next script command will be executed.  To
  656. turn this feature off, issue the ESCKEY OFF command.
  657.  
  658. See Also:  SHOW, PIXNUM
  659.  
  660.  
  661.  
  662. EGA
  663. ---
  664. Purpose:  To set the screen to EGA mode, which means 640x350 pixels, 16 colors.
  665.  
  666. Comments:  This is one of the screen setting modes.  You must set your screen
  667. to a desired mode (CGA2, CGA4, EGA, VGA16, or VGA320) as the first script
  668. command.  The default is CGA2.
  669.  
  670. See Also:  CGA4, CGA2, VGA16, VGA320
  671.  
  672.  
  673. EPAL [Color#,Palette#]
  674. ----------------------
  675. Purpose:  This script command is to be used to control the color palette while
  676. in EGA screen mode.
  677.  
  678. Comments:  The Color# is a standard color number from 0 to 15 (See the COLOR
  679. script command summary for color numbers).  The Palette# is a color shading
  680. number from 0 to 63.  For example, to change the color light grey to a bright
  681. red using the EPAL command the proper syntax would be:
  682.  
  683.             EPAL 7,44
  684.  
  685. Now every time the light gray color (7) is used, it will appear as bright red.
  686.  
  687. See Also: PAL, VPAL, COLOR
  688.  
  689.  
  690. FILL [style]
  691. -------------
  692. Purpose:  To fill a box or circle with a specified fill character.
  693.  
  694. Comments:  SuperShow allows you to fill any box or circle you draw with a
  695. variety of different fill characters.  Your style choices are:
  696.  
  697.     Solid   Bricks   Diagonal   Links   Smalldots   Bigdots
  698.  
  699. The default is solid.  Once you change the Fill style, it remains in effect
  700. until another FILL command is issued.  The sample script, PCXSHOW.SPT, shows
  701. the different fill styles available.
  702.  
  703. See Also:  BOX, CIRCLE, COLOR, ATPIX
  704.  
  705.  
  706. FLASH [Beginning Color #,Total Colors,Number of times,Delay]
  707. -------------------------------------------------------------
  708. Purpose:  A special effect to draw attention to a portion of the screen or to
  709. create a marquee like action.
  710.  
  711. Comments:  Flash will blink a selected color or colors for a specified number
  712. of times at a specified delay rate.  PCXSHOW.SPT shows examples of the flash
  713. effect. The script command FLASH 4,1,40,2 means begin with color 4; use only
  714. one color, flash on and off 40 times (20 on, 20 off) and do it rapidly with a
  715. delay of 2.  Beginning Color # must be a number between 0 and 15.  Total color
  716. numbers may be between 1 and 256, depending on how many colors are available in
  717. the screen.  The Times and Delay may contai n any number.
  718.  
  719. Note:  The FLASH command works off of palette information.  Consequently, you
  720. must show at least one pcx picture with palette information before successfully
  721. using the FLASH script command.
  722.  
  723. See Also:  COLOR, PAL, EPAL, VPAL
  724.  
  725.  
  726. FONT [Font Filename]
  727. --------------------
  728. Purpose:  This script command is used to load the custom font you wish to
  729. display.
  730.  
  731. Comments:  There are dozens of different font styles available in this version
  732. of PCX-SuperShow.  They are the files with the FNT file name extension.
  733.  
  734. For example, to use the helvetica 30 point font the syntax would be: FONT
  735. HELV30.FNT   You may boldface, underline, and color these fonts using the
  736. appropriate STYLE and COLOR script commands.  You position and print the font
  737. using the ATPIX and PRINT script commands.  Custom and internal fonts may be
  738. displayed in any screen mode.
  739.  
  740. In addition to the custom fonts, you also are able to choose from among your
  741. computers resident fonts.  These are designated as ROM8, ROM14, and ROM16.  ROM
  742. 8 is an 8 pixel by 8 pixel font; ROM 14 is an 8 pixel by 14 pixel font; ROM16
  743. is an 8 pixel by 16 pixel font.
  744.  
  745. The easiest way to choose fonts is using the pull-down font menu in Super
  746. ShowPrep.  This will show you all the fonts available on your disk.  You then
  747. choose from that list and the font script command is automatically written for
  748. you.
  749.  
  750. See Also:  STYLE, COLOR, ATPIX, PRINT
  751.  
  752.  
  753. FXDELAY [delay number]
  754. ----------------------
  755. Purpose:  This command controls the speed of the transition fades when using
  756. the SHOW command.
  757.  
  758. Comments:  FXDelay controls the speed of any of the fades used when displaying
  759. your pcx pictures with the SHOW command.  The higher the number, the slower the
  760. transition.  A delay number of zero resets the FXDelay timer to inactive.  Once
  761. the delay is set, it remains in effect until it is reset using the FXDelay
  762. command.  The speed of the fades/segues may be affected by the combined use of
  763. the PIXNUM and FXDELAY script commands.  
  764.  
  765. See Also:  SHOW, PIXNUM
  766.  
  767. GOTO :[line label]
  768. ------------------
  769. Purpose:  The GOTO script command allows unconditional branching, as opposed to
  770. the IF-GOTO command which requires user input.  An example of the proper usage
  771. would be  GOTO :LABEL1
  772.  
  773. Comments:  There are two primary uses for the GOTO command.  One is to use the
  774. GOTO command after a series of IF _ GOTO : commands.  When used in this fashion
  775. the command serves as an error check.  If the user hit a key other than one you
  776. were checking for, the GOTO command may be used to return back to the input
  777. command or, for that fact, to any other line label.  
  778.  
  779. Another very handy use is for a temporary command when creating your show
  780. scripts.  If you are working on a portion of the script that is several lines
  781. into the show, you may use the GOTO command to skip over the portion of your
  782. script that is already created, tested and working well.  If you use the GOTO
  783. command for this purpose, remember to go back and remove all those extraneous
  784. GOTO or line label commands when they no longer serve your editing purpose.
  785.  
  786. See Also:  WAIT, CONDITIONAL BRANCHING
  787.  
  788. IF  GOTO :
  789. ----------
  790. SEE CONDITIONAL BRANCHING SCRIPT COMMAND SUMMARY
  791.  
  792.  
  793. INPUT
  794. -----
  795. SEE CONDITIONAL BRANCHING SCRIPT COMMAND SUMMARY
  796.  
  797.  
  798. KALID [Kaleidoscope Number]
  799. ----------------------------
  800. Purpose:  The kaleidoscope feature of PCX-SuperShow gives you the ability to
  801. draw colorful designs on your screen to give your presentation motion and
  802. pizazz.
  803.  
  804. Comments:  The Kaleidoscope Number gives you some control over the appearance
  805. of the pattern drawn.  Any number between -32000 and +32000 may be used as the
  806. Kaleidoscope Number. . . or you may choose not to use any number at all.  By
  807. using a number, you guarantee that the same pattern will be drawn each time you
  808. run your PCX-SuperShow Script File.  You may use the kaleidoscope in any screen
  809. mode.  
  810.  
  811. See Also: PCXSHOW.SPT script file.
  812.  
  813. :LINE LABELS
  814. ------------
  815. SEE CONDITIONAL BRANCHING SCRIPT COMMAND SUMMARY
  816.  
  817. LOGO [Color number,"Text"]
  818. --------------------------
  819. Purpose:  This script command is used to display a text line using the LOGO
  820. special effect.
  821.  
  822. Comments:  The LOGO effect is an animated sequence of a word or phrase being
  823. displayed in different colors at slightly offset pixel locations to give a
  824. dazzling effect to display your logo or other brief information.  
  825.  
  826. This special effect uses the current font, three color numbers and the text
  827. information contained in the LOGO script command.  The first two color numbers
  828. are the background of the logo effect and is set with the COLOR script command.
  829. The color number in the LOGO script command is the color in which the last text
  830. will display.  You locate the beginning of the logo effect text using the ATPIX
  831. script command.
  832.  
  833. For example, if you wished to display the word LOGO at pixel row 300 and pixel
  834. column 100 with a combination of bright and dark red background with a white
  835. top text the script commands are: COLOR 4,12 LOGO 15,"LOGO"
  836.  
  837. Several examples of the LOGO effect are contained in the sample script
  838. PCXSHOW.SPT.
  839.  
  840. See Also:  COLOR, ATPIX, FONT
  841.  
  842.  
  843. LOOP
  844. ----
  845. Purpose:  Use this command if you wish to re-display the entire show from the
  846. beginning without having to rerun PCX-SuperShow.
  847.  
  848. Comments: Remember, when this script command is encountered your show will
  849. start over from the very beginning. . . this means from the opening Script
  850. command.  This command works well when you wish to have a continuous display of
  851. your show.  To re-display a show from a particular line label use the
  852. unconditional GOTO script command.
  853.  
  854. See Also:  RUN, STOP, GOTO
  855.  
  856. MOUSE [On/Off]:
  857. ---------------
  858. Purpose:  If you have a mouse active on your computer you may use it as a
  859. pointer and a remote control device.  
  860.  
  861. Comments:  To activate the mouse the proper syntax is MOUSE ON.  When you turn
  862. the mouse on, a pointer will appear at the location you gave in the MOUSE AT
  863. script command.  You may then move the pointer on your screen as you move your
  864. mouse.  To make the pointer disappear the syntax is MOUSE OFF.  If the mouse is
  865. connected, you may use it as a remote control device whether or not the pointer
  866. is displayed.  Clicking the right and center mouse buttons move forward one
  867. screen.  Clicking the left mouse button w ill end the show.  The default is
  868. MOUSE OFF.
  869.  
  870. See Also:  MOUSE AT
  871.  
  872.  
  873. MOUSE AT [X,Y]:
  874. ---------------
  875. Purpose:  To locate the mouse pointer on your screen.
  876.  
  877. Comments:  The coordinates X and Y are the pixel locations where you want your
  878. mouse pointer to appear.  X is the pixel column and Y is the pixel row.  To
  879. locate your mouse pointer at pixel row 100 and pixel column 300 the proper
  880. syntax would be  MOUSE AT 300,100.  You should use the MOUSE AT script command
  881. prior to turning your mouse on with the MOUSE ON command.
  882.  
  883. See Also:  MOUSE [On/Off]
  884.  
  885.  
  886. OUTLINE [ON/OFF]
  887. ----------------
  888. Purpose:  To turn the outline feature of SuperFont on or off.
  889.  
  890. Comments:  When issuing the script command OUTLINE ON, characters are displayed
  891. in outline form.  OUTLINE OFF displays the characters filled solid with the
  892. foreground color set with the COLOR command.  The default is OUTLINE OFF.  This
  893. script command only affects the SuperFont display.
  894.  
  895. See Also:  SPRINT, SPACE, SIZE, ANGLE
  896.  
  897.  
  898. PAL
  899. -------------------
  900. Purpose:  To restore the original default palette.
  901.  
  902. Comments:  This command simply restores the original default 16 or 256 color
  903. palette.
  904.  
  905. See Also:  EPAL, VPAL, SHOW
  906.  
  907.  
  908. PAUSE
  909. -----
  910. Purpose:  This command is used to pause the presentation of your show.  The
  911. program waits for a key press or mouse click from the user to continue.
  912.  
  913. Comments:  Pause is similar to delay except that a key press or mouse click is
  914. required for the show to continue.  Pressing the left mouse key or the Esc
  915. keyboard key will terminate the show.  Pressing any other key will move forward
  916. to the next script command.
  917.  
  918. See Also:  DELAY, SLEEP, INPUT
  919.  
  920.  
  921. PLAY [Music Language]
  922. ---------------------
  923. Purpose:  To play music or sound directly from your script.
  924.  
  925. Comments:  See the Music Language section this manual for details on playing
  926. sound and music from your script.
  927.  
  928. See Also: Music Language Chapter
  929.  
  930.  
  931. PIXNUM [Horizontal Number, Vertical Number]
  932. -------------------------------------------
  933. Purpose:  This command controls the number of pixels being displayed during the
  934. fade/segue routines when using the SHOW command.  The higher the numbers, the
  935. more pixels are displayed at a time and the quicker the image appears on your
  936. screen.
  937.  
  938. Comments:  Valid numbers are 0 to 1024 (or maximum screen resolution).  Once
  939. the number is set, it remains in effect until it is reset using the PIXNUM
  940. command. 
  941.  
  942. SuperShow now gives you the ability to set both the horizontal and vertical
  943. pixel numbers.  Varying these numbers will give you unique screen fades as
  944. shown in the sample script, PCXSHOW.SPT.
  945.  
  946. In addition, the speed of the fades/segues may be affected by the combined use
  947. of the PIXNUM and FXDELAY script commands.   
  948.  
  949. See Also:  SHOW, FXDELAY
  950.  
  951.  
  952. PRINT ["Text"]
  953. --------------
  954. Purpose:  This is the script command that actually displays text on your screen
  955. using the custom fonts or your internal, resident computer fonts.
  956.  
  957. Comments:  This is for use with custom and resident fonts in any screen mode.
  958. Your text must be enclosed by quotation marks.  Example:  If you wanted to
  959. enter text that said ACME Widget Budget Review the proper syntax would be:  
  960.     
  961.     PRINT "ACME Widget Budget Review"
  962.  
  963. To display the SuperFont see the SPRINT script command summary.
  964.  
  965. See Also:  ATPIX, SPRINT, COLOR, STYLE
  966.  
  967.  
  968. RETURN :
  969. ---------
  970. SEE CONDITIONAL BRANCHING SCRIPT COMMAND SUMMARY
  971.  
  972.  
  973.  
  974. ROTATE [Degrees]
  975. ----------------
  976. Purpose:  This script command will rotate a custom or internal computer font at
  977. 90, 180, 270 or 0 degrees.
  978.  
  979. Comments:  This is similar to the SuperFont angle command with the exception
  980. that ROTATE may be used only with the four degree angles cited above.  The
  981. rotation angle remains in effect until a new ROTATE command is given or until a
  982. new font is designated using the FONT script command.
  983.  
  984. See Also:  FONT, PRINT, STYLE
  985.  
  986.  
  987. RUN [Filename.Extension]
  988. ------------------------
  989. Purpose:  This command is a built in shell feature of PCX-SuperShow and may be
  990. used to run other executable (.EXE or .COM) programs without disturbing your
  991. screen presentation in PCX-SuperShow.  
  992.  
  993. Comments:  This command was originally created to allow users to play music
  994. while a screen from PCX-SuperShow appears on the monitor.  You may also use the
  995. command to run any program.  When the shelled program ends, you are returned to
  996. your PCX-SuperShow where you left off.  For example, if you wish to run a
  997. program named EXAMPLE.COM from within your PCX-SuperShow, the proper syntax
  998. would be:  RUN EXAMPLE.COM Be sure there is a space between the command RUN and
  999. the full filename of the program.
  1000.  
  1001. See Also:  STOP, LOOP, CONDITIONAL BRANCHING
  1002.  
  1003.  
  1004. SBPLAY [Filename.VOC]
  1005. ---------------------
  1006. Purpose:  To play a digitized sound file from Sound Blaster or compatible sound
  1007. files.
  1008.  
  1009. Comments:  SuperShow now gives you the ability to play any Sound Blaster (VOC)
  1010. or compatible digitized sound file directly from your script.  The filename may
  1011. include a drive and directory if it is not stored in the same location as your
  1012. SuperShow program.  When the sound file finishes playing the next script
  1013. command will be executed.
  1014.  
  1015. Note:  You must have a Sound Blaster card or compatible to use this script
  1016. command.
  1017.  
  1018. See Also: Play, Xplay
  1019.  
  1020. SHAKE [number]
  1021. ---------------
  1022. Purpose:  This special effects command literally causes the picture on your
  1023. screen to shake up and down.  
  1024.  
  1025. Comments:  The [number] parameter is the length of time you wish the screen to
  1026. shake.  The higher the number, the longer the screen will shake.
  1027.  
  1028.  
  1029. SHOW [Filename.Ext] [Fade Number]
  1030. ---------------------------------
  1031. Purpose:  This script command is used to display a PCX screen file, in any
  1032. screen mode (CGA through Super VGA) using one of the dozens of available screen
  1033. fades/segues.
  1034.  
  1035. Comments:  The SHOW command is followed by the filename and extension of the
  1036. pcx image you wish to display.  Finally, you must assign that file a fade
  1037. number.  For example, if you wanted to load a PCX file named MYFILE and display
  1038. it using a diagonal fade down right the syntax would be:  SHOW MYFILE.PCX 10
  1039. You may also designate a drive and directory if your PCX file is not in the
  1040. same directory as the PCXSS.EXE program.  For example, if your file is located
  1041. on drive C in a directory named PICS, then  SHOW C:\PICS\MYFILE.PCX 10  would
  1042. be the proper syntax.  Be sure a space is between each element of the command.
  1043. The command first looks to use expanded memory to store and display screens.
  1044. If none is found, it will use conventional memory and finally it will look to
  1045. use disk space on your hard drive as virtual memory if none other is available.
  1046.  
  1047. There are 35 basic fade numbers with the SHOW command.  Additional fades are
  1048. created by varying the horizontal and vertical pixels using the PIXNUM command.
  1049. Here is a list of the basic screen fade numbers and the type of fade/segue it
  1050. invokes.
  1051.  
  1052.      1- Instant On        11- Diag. Down Left    21- Close Horizontal
  1053.      2- Wipe Down        12- Diag. Up Right    22- Close Vertical
  1054.          3- Wipe Up             13- Diag. Up left       23- Drip Down
  1055.          4- Wipe Right          14- Explode             24- Drip Up
  1056.          5- Wipe Left           15- Implode             25- Pour Down
  1057.          6- Slide Down          16- Puzzle Pieces       26- Pour Up
  1058.          7- Slide Up            17- Spiral Out          27- Weave Horizontal
  1059.      8- Slide Right        18- Spiral In        28- Weave Vertical
  1060.      9- Slide Left        19- Open Horizontal    29- Horizontal Blinds
  1061.         10- Diag. Down Right    20- Open Vertical       30- Vertical Blinds
  1062.                                                         31- Snake
  1063.  
  1064. Also, slow screen fades in both 16 color and 256 color modes are available
  1065. using these screen fade numbers:
  1066.  
  1067.    32- Fade-In 256    33- Fade-In 16    34- Fade-Out 256    35- Fade-Out 16
  1068.  
  1069.  
  1070. See Also: ATPIX, PIXNUM, FXDELAY, Appendix A, LOAD
  1071.  
  1072.  
  1073. SIZE [Number]
  1074. --------------
  1075. Purpose:  This script command is used to enlarge or shrink the size of the
  1076. SuperFont.
  1077.  
  1078. Comments:  The number may be any number, however, there are reasonable
  1079. parameters.  A very small SuperFont does not look very good.  If you are going
  1080. to use a small font then use the internal or one of the small custom fonts.
  1081. The average size you will use will probably be in the range of 6 to 16.
  1082.  
  1083. See Also:  FONT, ATPIX, SPRINT, OUTLINE
  1084.  
  1085.  
  1086. SLEEP [Seconds]
  1087. ---------------
  1088. Purpose:  This script command acts as a delaying mechanism much like the DELAY
  1089. script command, but disables the Esc key as an abort mechanism.
  1090.  
  1091. Comments: There are two differences between the SLEEP and DELAY script
  1092. commands.  Pressing the ESC key during the execution of the SLEEP command will
  1093. NOT abort the script and return to DOS as is true with the DELAY command.
  1094. Pressing the Esc key during the SLEEP command will move forward to the next
  1095. script command.
  1096.  
  1097. Therefore, if you wish to keep the end user from aborting your script by
  1098. pressing the ESC key, use the SLEEP command for delays.
  1099.  
  1100. The second difference is in the way in which the program tracks time.  Using
  1101. the DELAY immediately following a SOUND or PLAY command may cause some strange
  1102. sounds from your speaker.  This is because DELAY uses some of the same timing
  1103. routines as SOUND and PLAY.  Therefore, it is best to use SLEEP for a script
  1104. delay in conjunction with SOUND or PLAY.
  1105.  
  1106. See Also:  DELAY, WAIT, PAUSE
  1107.  
  1108.  
  1109. SOUND [Number]
  1110. --------------
  1111. Purpose:  You may use this command when you desire a sound to highlight a
  1112. screen or message.  
  1113.  
  1114. Comments:  There are five distinct sounds included in this version of
  1115. PCX-SuperShow.  All sounds are relatively short in duration.  The number
  1116. following the Sound script command must be between -4 and +5.  Sometimes a
  1117. sound is used to draw the user's attention to the necessity of pressing a key.
  1118.  
  1119. See Also:  PAUSE, INPUT, PLAY, SOUND OFF, XPLAY, SBPLAY
  1120.  
  1121.  
  1122. SOUND OFF
  1123. ---------
  1124. Purpose:  To kill any remaining sound stored in the sound buffer.
  1125.  
  1126. Comments:  The main purpose of the SOUND OFF script command is to stop any
  1127. sound you may have programmed using the PLAY or SOUND command.
  1128.  
  1129. See Also:  SOUND, PLAY, XPLAY
  1130.  
  1131.  
  1132. SPACE [Number]
  1133. --------------
  1134. Purpose:  This is for setting the space between characters when displaying text
  1135. with SuperFont.
  1136.  
  1137. Comments:  As you change the size and angle of the SuperFont, you probably will
  1138. also want to change the spacing between characters.  That is what the SPACE
  1139. script command does.  Normal spacing is in the range of 4 to 8.
  1140.  
  1141. See Also:  SPRINT, SIZE, ANGLE, OUTLINE
  1142.  
  1143.  
  1144. SPRINT ["Text"]
  1145. ---------------
  1146. Purpose:  This is the script command that actually displays text on your screen
  1147. using the SuperFont.
  1148.  
  1149. Comments:  This is for use with the SuperFont only.  SuperFont may be displayed
  1150. in CGA, EGA or VGA screen modes.  Your text must be enclosed by quotation
  1151. marks.  Example:  If you wanted to enter text that said ACME Widget Budget
  1152. Review the proper syntax would be:  
  1153.     
  1154.     SPRINT "ACME Widget Budget Review"
  1155.  
  1156. To display custom and internal fonts see the PRINT script command summary.
  1157.  
  1158. See Also:  ATPIX, PRINT, COLOR, ANGLE, SPACE
  1159.  
  1160.  
  1161. STOP
  1162. ----
  1163. Purpose:  To stop the presentation of your show, returning the user to DOS or
  1164. the calling program.
  1165.  
  1166. Comments:  The stop command serves a couple of purposes.  It aids in setting up
  1167. conditional branching where you wish to have the user choose a branch or stop
  1168. using the show.  It also may be used as an aid when building your script and
  1169. you wish to force a stop after certain script commands are executed.
  1170.  
  1171. See Also:  CONDITIONAL BRANCHING, RUN, LOOP
  1172.  
  1173.  
  1174. STYLE [Bold/Underline/Overlay/Normal]
  1175. -------------------------------------
  1176. Purpose:  The STYLE script command is used to change the appearance of a custom
  1177. or ROM computer font.
  1178.  
  1179. Comments:  The default when starting PCX-SuperShow is Normal.  You may use
  1180. combinations of the different styles.  For example you can make a font
  1181. transparent, bold and underlined by issuing the three appropriate STYLE script
  1182. commands.  Here is a definition for each of the styles available:
  1183.  
  1184.         ■ Normal:  Normal font display means that the font will have a
  1185.         foreground color and background color (set by the COLOR script command)
  1186.         and will write over anything previously displayed on the screen.  This
  1187.         is the default if no STYLE script command is encountered.
  1188.  
  1189.         ■ Overlay:  This means that the font will be transparent and only the
  1190.         foreground color is in effect.  The background color set with the COLOR
  1191.         command is ignored.  Words printed in this mode do not erase the
  1192.         portion of the screen on which they appear, but write over what is
  1193.         already there.
  1194.  
  1195.     ■ Bold:  This means the font will appear bold when displayed.
  1196.  
  1197.         ■ Underline:  Issuing this style command will display text with a
  1198.         single underline.
  1199.  
  1200. The STYLE command remains in effect until a new STYLE command is encountered.
  1201. Remember, most of the STYLE commands are cumulative. . . in other words, if you
  1202. have issued a bold style and then later issue an underline style, the next font
  1203. display will be both bold and underlined.  The exception is the Normal style
  1204. command.  This resets the STYLE back to just normal as outlined above.
  1205.  
  1206. See Also:  FONT, COLOR, PRINT, ROTATE, TYPE, LOGO, CRAWL
  1207.  
  1208.  
  1209. TYPE ["Message"]
  1210. ----------------
  1211. Purpose:  To display a single line of text with a typewriter sound effect.
  1212.  
  1213. Comments:  This command is used as a special effect to draw attention to a line
  1214. of text you wish to display.  The message and number of desired spaces must be
  1215. enclosed with quotation marks.  The color of the text and the screen location
  1216. are determined by the COLOR and ATPIX script commands respectively.  Both
  1217. custom and internal fonts may be used with this effect.
  1218.  
  1219. See Also:  COLOR, AT, PRINT
  1220.  
  1221.  
  1222. VGA16
  1223. -----
  1224. Purpose:  To set the screen to VGA mode, which means 640x480 pixels, 16 colors.
  1225.  
  1226. Comments:  This is one of the screen setting modes.  You must set your screen
  1227. to a desired mode (CGA2, CGA4, EGA, VGA16, or VGA320) as the first script
  1228. command.  The default is CGA2.
  1229.  
  1230. See Also:  CGA4, CGA2, EGA, VGA320
  1231.  
  1232.  
  1233. VGA320
  1234. ------
  1235. Purpose:  To set the screen to VGA 320 mode, which means 320x200 pixels, 256
  1236. colors.
  1237.  
  1238. Comments:  This is one of the screen setting modes.  You must set your screen
  1239. to a desired mode (CGA2, CGA4, EGA, VGA16, or VGA320) as the first script
  1240. command.  The default is CGA2.
  1241.  
  1242. See Also:  CGA4, CGA2, EGA, VGA16
  1243.  
  1244.  
  1245. VPAL [Color#,Red,Blue,Green]
  1246. ----------------------------
  1247. Purpose:  This is the VGA palette command to be used to control the color
  1248. palette while in VGA screen mode.  
  1249.  
  1250. Comments:  The Color# is a standard color number from 0 to 15.  (See the color
  1251. chart in the COLOR script command summary for color/number information).  The
  1252. Red, Blue and Green are palette intensities and are numbers from 0 to 63.  To
  1253. change a bright red VGA color to bright white, the proper syntax is:  
  1254.  
  1255.                 VPAL 12,63,63,63
  1256.  
  1257. An example of using VPAL is contained in the sample show script PCXSHOW.SPT.
  1258.  
  1259. See Also:  PAL, EPAL, COLOR
  1260.  
  1261.  
  1262. WAIT
  1263. ----
  1264. Purpose:  To allow the user to go forward to the next line label, backward to
  1265. the previous line label or to the first line label in a script file by pressing
  1266. predesignated keys.
  1267.  
  1268. Comments:  The WAIT script command is similar to the PAUSE and INPUT commands.
  1269. The special purpose of WAIT, however, is to allow the user to move forward to
  1270. the next line label or backward to the previous line label.  
  1271.  
  1272. To move forward the user may press the following keys:  PgDn, Down Arrow Key,
  1273. Right Arrow Key or Right Mouse Button. To move backward the user may press the
  1274. following keys:  PgUp, Up Arrow Key, Left Arrow Key or Left Mouse Button. To
  1275. move to the first line label in a script file the user would press the Home
  1276. key. To end the program the user would press the Esc key.
  1277.  
  1278. As opposed to INPUT, there is no need to tell the program the name of the line
  1279. label.  It will simply go to the next, previous or first line label in your
  1280. script file.  You may mix the PAUSE and INPUT/IF GOTO/RETURN commands with the
  1281. WAIT command.
  1282.  
  1283. See Also:  PAUSE, SLEEP, CONDITIONAL BRANCHING, DELAY, CRAWL
  1284.  
  1285.  
  1286. XPLAY [Filename.MUS]
  1287. --------------------
  1288. Purpose:  To play a pre-programmed text music/sound file from your PC Speaker.
  1289.  
  1290. Comments:  SuperShow now gives you the ability to play music/sound files
  1291. directly from your script.  The filename may include a drive and directory if
  1292. it is not stored in the same location as your SuperShow program.  When the
  1293. sound file finishes playing, the next script command will be executed.  Several
  1294. sound files are included with your registered version of SuperShow.
  1295.  
  1296. See the chapter on the Music/Sound Language for details on creating and playing
  1297. music and sound through your PC speaker.
  1298.  
  1299. See Also:  PLAY, SBPLAY, SOUND
  1300.  
  1301.                              ==================
  1302.                              PCX Super-ShowPrep
  1303.                              ==================
  1304.  
  1305. PCX Super-ShowPrep is an editor/script generating program that is an integral
  1306. part of PCX-SuperShow.  The program file name is PCXSP.EXE and is included with
  1307. every registered purchase of PCX-SuperShow.
  1308.  
  1309. ShowPrep is a DOS text, ASCII, editor.  It features pull-down menu's for editor
  1310. control and especially for creating script commands for your presentation.  
  1311.  
  1312. It is not necessary to use ShowPrep to create a script for use in
  1313. PCX-SuperShow.  All you need is any word processor or editor that can save
  1314. files in the DOS Text format (ASCII).  We do believe, however, that using
  1315. PCX-ShowPrep will save you a great deal of time since all the script commands
  1316. are available from drop down menus, including each of the fades available in
  1317. the SHOW commands.  Also, each of the PCX-Utilities and drawing tools for boxes
  1318. and circles are found in Super ShowPrep.  In addition, you may run the script
  1319. directly from the editor without having to go to DOS.  And, when the script is
  1320. done running in PCX-SuperShow, you are returned to the editor and the script
  1321. you are working on.
  1322.  
  1323. To begin using the program, simply type PCXSP at the prompt and press the enter
  1324. key.  If you wish to load a script file upon start-up of the program then type
  1325. the script filename on the same command line.  For example, if you wish to load
  1326. a script file named MYSHOW.SPT when starting PCX-ShowPrep, the proper syntax
  1327. would be:  PCXSP MYFILE.SPT
  1328.  
  1329. When you first begin ShowPrep, the editor is active.  This means that ShowPrep
  1330. is ready to have you start writing your script.  It functions at this point
  1331. much like any other editor/word processor.  We will cover the editing functions
  1332. in more detail shortly.
  1333.  
  1334. To activate the pull-down menu system you'll need to press one of the
  1335. associated function keys.  In addition to the function keys, many of the
  1336. ShowPrep functions are selected by pressing associated hot-keys.  We will cover
  1337. the menu function key and hot-key system in a moment.  First let's look at the
  1338. editor portion of the PCX-ShowPrep program.
  1339.  
  1340. EDITOR:  The program functions much like any editor/word processor with one
  1341. notable difference.  Since the scripts for PCX-SuperShow dictate one command
  1342. per line, the word wrap feature is turned off.  This means that the cursor will
  1343. not automatically jump down to the next line.  To move your cursor down you
  1344. will need to press the Enter or other edit keys mentioned below.
  1345.  
  1346. The editor otherwise has most of the functions of a standard DOS text editor.
  1347. You may search, save, load, merge, block copy, move, delete, insert and so
  1348. forth.  The maximum number of lines in a script is 2000.
  1349.  
  1350. IMPORTANT:  The F1 Function key will pop-up a help screen for using the editor.
  1351. There are 2 pages of help information.  The first page reviews the edit keys
  1352. available in the editor.  The second page tells how you may block copy, move
  1353. and or delete portions of your script text.
  1354.  
  1355. Here is a review of the edit keys:
  1356.  
  1357. Home/End - Go to begin/end of line      Ctrl+Home/End - top/bottom of screen
  1358. Pg Up/Dn - Display previous/next page    Ctrl+PgUp/Dn - Go to 1st/last page
  1359. Ctrl+Y - Delete current line            Ctrl+N - Insert blank line above
  1360. Ctrl+ - Move one word right             Ctrl+ - Move one word left
  1361.  
  1362. Shift+Cursor - Begins block mode.  You may continue to highlight the area you
  1363. wish to block by continuing to tap the cursor key (up or down) while holding
  1364. down the shift key.  The blocked text will appear in reverse video.  To paste
  1365. the block into the buffer for copying press any key but the Escape key.  To
  1366. delete the block and paste the block into a buffer for moving, press the shift
  1367. and delete keys.  To insert a text copied into the buffer, line up your cursor
  1368. at the point in your script where you wish to insert.  Press the shift and
  1369. insert keys and the buffer text will be inserted in your script.
  1370.  
  1371. PULL-DOWN MENUS, FUNCTION KEYS AND HOT-KEYS:  As mentioned earlier, the
  1372. function keys are used to activate the pull-down menu system of PCX-ShowPrep.
  1373. Once a menu has been pulled down you may display the previous or next pull down
  1374. menu by pressing the left or right cursor (arrow) keys.  You will also note
  1375. that many of the menu items have an associated hot-key.  The hot-key
  1376. combination may be found to the right of a displayed menu function.  For
  1377. example, the function Load Script has a hot- key combination of Alt+D.  The
  1378. hot-key combination has been assigned those functions that are used frequently.
  1379. You may use the hot-key combination to invoke the function without pulling down
  1380. the menu.  As you become more familiar with the program, this will speed up
  1381. your use of the program.
  1382.  
  1383. We will now cover each of the function keys and associated menu items and
  1384. hot-keys.  It should be noted that pressing the escape key (Esc) when using the
  1385. menu system will always take you to the previous menu or, eventually, to the
  1386. editor.
  1387.  
  1388. F1 - HELP:  As mentioned above, this function key displays two pages of help
  1389. information concerning the editing functions and keys of PCX-ShowPrep.
  1390.  
  1391. F2 - COLORS:  This special function key does not pull-down a menu, but rather
  1392. pops-up a color chart.  The purpose is the option of changing the colors of the
  1393. editor.  The default colors are white on blue.  You may choose any combination
  1394. of colors by moving the cursor to the color combination you wish and then press
  1395. the Enter key.  The editor will change to that color combination for the
  1396. remainder of your session.
  1397.  
  1398. F3 - FILES:  When pressed, this function key will display a menu of items
  1399. relating to maintenance of your script and pcx files.  We will cover each item
  1400. of the menu.
  1401.  
  1402. New Script:  Choosing this option will clear your screen, deleting any
  1403. previously entered or loaded text and change the name of the new script file to
  1404. WORKING.SPT.  Be sure you have saved any previously entered script text before
  1405. choosing this option.  The associated hot-key is Alt+N.
  1406.  
  1407. Load Script:  This option allows you to load any script text file of your
  1408. choice.  The first thing you'll see is an input box.  You may directly enter
  1409. the name of a script to be loaded in this box.  
  1410.  
  1411. If you would rather see a directory list of script files, then enter the
  1412. appropriate path, if different from the one displayed, and use the *.SPT mask.
  1413. The mask and path may be changed to any combination of characters.  Next, a
  1414. pop-up box will display all the files that matched the mask in the selected
  1415. directory.  Simply use your cursor keys to highlight the desired file and press
  1416. the enter key.  The file will then be loaded into the editor.
  1417.  
  1418. When a file is being loaded, any previously loaded text will be deleted and you
  1419. will briefly see a blinking message at the bottom of your screen.  Once the
  1420. file is loaded the path and filename will appear in the lower left hand corner
  1421. of your screen.  The associated hot-key is Alt+D.
  1422.  
  1423. Save Script:  This option will save your script to a disk file.  When choosing
  1424. this option an input box will appear with a default path and filename.  If this
  1425. is acceptable, simply press the enter key.  If you wish to change the path or
  1426. filename, then type the appropriate changes and press the enter key. If you
  1427. changed the path or name, the changes will be reflected in the lower left hand
  1428. corner of your screen.  Remember. . . WORKING.SPT is assigned to every new
  1429. script file.  You'll probably want to rename scripts initially designated with
  1430. this name.  The associated hot-key is Alt+F.
  1431.  
  1432. Merge Script:  This option allows you to combine multiple script files into one
  1433. main script file.  We suggest that you build your show, especially long
  1434. involved presentations, into separate scripts.  This makes creating, running
  1435. and debugging your script go much faster.  That's where the merge function is
  1436. handy.
  1437.  
  1438. Merging is almost the same and follows the same syntax as the Load Script
  1439. function.  The difference is that the previously entered or loaded text will
  1440. not be deleted.  The new merged file will be appended at the end of the
  1441. currently loaded script text.  You may then block copy, move, etc., the merged
  1442. text.  The associated hot-key is Alt+M.
  1443.  
  1444. Print Script:  This option sends the currently loaded script to parallel
  1445. printer port #1.  Be sure your printer is turned on before choosing this
  1446. function.  There is no associated hot-key.
  1447.  
  1448. Search Script:  The purpose of this function is to search for a word or
  1449. combination of words in your script text.  This is especially helpful if you
  1450. are editing a long script.  When you choose this selection, an input box will
  1451. appear asking for the string (word or words) you wish to search for.  The
  1452. search always begins at the cursor and goes forward.  Therefore, if you want to
  1453. search the entire text file, be sure your cursor is on the first line of the
  1454. text.  If the string is found, the line in which it wa s found will appear at
  1455. the top of your screen and the cursor will be resting on the beginning letter
  1456. of the string.  If the string is not found, a brief beep will be heard.  The
  1457. associated hot-key is the F9 Function key.
  1458.  
  1459. Save/Run Script:  One of the handiest features of PCX-ShowPrep is that you may
  1460. run the script directly from the editor.  That is what this option does.  When
  1461. you choose this option the file will automatically be saved to disk and then
  1462. the script will be run in PCX-SuperShow (PCXSS.EXE).  IMPORTANT:  You must have
  1463. the program PCXSS.EXE located in the same directory/path as PCX-ShowPrep for
  1464. this option to work properly.  Once the script has completed running, you will
  1465. be returned to the editor to continue wor n your script.  The associated
  1466. hot-key is the F10 Function key.
  1467.  
  1468. DOS Shell:  This option sends you to the DOS prompt.  You may perform any
  1469. normal DOS function here.  Do not attempt to load any memory resident programs
  1470. when in this shell.  To return to ShowPrep, type EXIT at the prompt and press
  1471. the enter key.
  1472.  
  1473. Quit:  This option ends your current session of ShowPrep returning you to DOS
  1474. or to the calling program.  The associated hot-key is the Alt+F1 Function keys.
  1475.  
  1476.  
  1477. F4 - TOOLS:  The options on this menu are all associated with your
  1478. PCX-Utilities and box and circle drawing tools.
  1479.  
  1480. View PCX File:  A handy feature in ShowPrep is you may view any pcx file on any
  1481. disk, in any directory.  Choosing this option runs the PCX ScreenView program
  1482. so you must have PCXSV4.EXE located in the same directory/path as PCX-ShowPrep.
  1483. For details on using this utility see the appropriate listing in the chapter
  1484. named PCX-UTILITIES.  The associated hot-key is Alt+V.
  1485.  
  1486. Crop PCX File:  Perhaps you've decided to you want to display only a portion of
  1487. one of your pcx files.  Choosing this option runs the PCX-Crop utility program
  1488. so you must have PCXCROP.EXE located in the same directory/path as
  1489. PCX-ShowPrep.  For details on using this utility see the appropriate listing in
  1490. the chapter named PCX-UTILITIES.  The associated hot-key is Alt+X.
  1491.  
  1492. Size PCX File:  Choosing this option runs the PCX-Size utility program so you
  1493. must have PCXSIZE.EXE located in the same directory/path as PCX-ShowPrep.  This
  1494. utility allows you to interactively change the horizontal and or vertical size
  1495. of a designated pcx image file.  For details on using this utility see the
  1496. appropriate listing in the chapter named PCX-UTILITIES.
  1497.  
  1498. Change PCX File:  Choosing this option runs the PCX-Change utility program so
  1499. you must have PCXCHANG.EXE located in the same directory/path as PCX-ShowPrep.
  1500. This utility allows you to change the display resolution header portion of a
  1501. pcx image file.  For details on using this utility see the appropriate listing
  1502. in the chapter named PCX-UTILITIES.
  1503.  
  1504. MakeShow:  You also may create your run-time script directly from ShowPrep by
  1505. choosing this option.  When you select this option, an input box appears
  1506. giving you the default filenames for MakeShow.  If these are acceptable simply
  1507. press the enter key.  If not, make the appropriate changes and then press the
  1508. enter key.  If you change your mind, pressing the Esc key will return you to
  1509. the editor.  See the chapter named RUN-TIME MODULES for more information on
  1510. using MakeShow.  There is no associated hot-key for this function.
  1511.  
  1512. Box Draw:  This is one of the new drawing utilities in PCX SuperShow.  The
  1513. purpose of this utility is to interactively draw a box on a pcx image file.
  1514. This will make locating and displaying your box much easier than trying to
  1515. guess where the pixel coordinates are located.
  1516.  
  1517. When you choose this option, an input box appears just like you were selecting
  1518. a pcx image file to display.  Choose the pcx image file on which you wish to
  1519. draw your box and press the enter key.  Next you will see that image on your
  1520. screen along with a box outline, much like the box outline in the PCX-Crop
  1521. utility.  It is by sizing, moving and manipulating this box that you may draw
  1522. your box.  You may control the speed and movement/size of the sides of the box
  1523. as follows:
  1524.  
  1525. By default the sides of the box move one pixel length at a time.  To speed the
  1526. movement to 5 pixels, press the Spacebar key.  This key acts as a toggle
  1527. switch. Pressing it will increase the speed/pixels.
  1528.  
  1529. You control the size and location of the box using the cursor (arrow) keys.
  1530. When you first start the box draw the up and down cursor keys will move the top
  1531. line of the box up or down.  The right and left cursor keys will move the left
  1532. side of the box left or right.
  1533.  
  1534. To move the other two sides of the box press the S key once.  Now the up
  1535. and down cursor keys will move the bottom line of the box up or down.  The
  1536. right and left cursor keys will move the right side of the box left or right.
  1537.  
  1538. The S key serves as a toggle switch.  If you press it a second time, you will
  1539. again be able to move the top and left sides of the box, and so forth.
  1540.  
  1541. Once you have located and sized the box the way you want it to appear in your
  1542. show, press the Enter key.  The BOX script command will now appear in your
  1543. script with the exact pixel coordinates.
  1544.  
  1545. Circle Draw: This is one of the new drawing utilities in PCX SuperShow.  The
  1546. purpose of this utility is to interactively draw a circle on a pcx image file.
  1547. This will make locating and displaying your circle much easier than trying to
  1548. guess where the circle coordinates are located.
  1549.  
  1550. When you choose this option, an input box appears just like you were selecting
  1551. a pcx image file to display.  Choose the pcx image file on which you wish to
  1552. draw your circle and press the enter key.  Next you will see that image on your
  1553. screen along with a circle outline, much like the box outline in the PCX-Crop
  1554. utility.  It is by sizing, moving and manipulating this box that you may draw
  1555. your circle.  You may control the speed and movement/size of the sides of the
  1556. box as follows:
  1557.  
  1558. The up, down, left and right cursor keys moves the circle, as drawn, in the
  1559. same direction as the chosen cursor key.
  1560.  
  1561. To change the size and shape of the circle you use the pgup, pgdn, home and end
  1562. keys.  Pgup increases the height of the circle, pgdn decreases the height.
  1563. Home increases the width of the circle while the end key decreases the width of
  1564. the circle.
  1565.  
  1566. By default the dimensions of the circle move one pixel length at a time.  To
  1567. speed the movement to press the space bar.  This key acts as a toggle switch.
  1568. Pressing it the first time will increase the speed/pixel movement by 5 pixels.
  1569. You may continue pressing the space bar to increase the speed as high as 25
  1570. pixels and then it will return to one pixel movement.
  1571.  
  1572. Once you have located and sized the circle the way you want it to appear in
  1573. your show, press the Enter key.  The CIRCLE script command will now appear in
  1574. your script with the exact coordinates.
  1575.  
  1576.  
  1577. F5 - EFFECTS:  The options on this menu are all associated with displaying pcx
  1578. image files, clearing the screen and other special screen effects.  Pressing
  1579. the F4 function key from the editor will pull-down this menu.  The options are:
  1580.  
  1581. Show Command:  If you wish to display a pcx file using the SHOW command, then
  1582. you would choose this option.  The first thing that occurs when you select this
  1583. option is that an input box appears asking for the path of the pcx file you
  1584. wish to display.  If it is the default, simply press the enter key.  Next, a
  1585. directory of pcx files will be displayed.  From this menu, use the cursor keys
  1586. to highlight the pcx file you wish to display and press the enter key.  Next a
  1587. menu of all the fades will appear on your screen.  Highlight the desired fade
  1588. using the cursor keys and then press the enter key.
  1589.  
  1590. The proper script command, reflecting your choices, will be inserted into your
  1591. script at the location of the cursor in the editor.  For example, if you chose
  1592. a pcx file named SAMPLE.PCX and you chose the fade Open Curtain the script
  1593. command SHOW SAMPLE.PCX 21  will automatically be inserted in your script.  The
  1594. associated hot-key is Alt+S.
  1595.  
  1596. ATPIX, PIXNUM, FXDELAY:  The next three options are all script commands
  1597. associated with the SHOW command.  They control the location and speed with
  1598. which the pcx file is displayed.  When you choose any of these options, the
  1599. command will be inserted in your script.  The cursor will be to the right of
  1600. the command waiting for you to enter an associated number.  See the chapter on
  1601. Script Commands for more information concerning these commands.
  1602.  
  1603. CLR Command:  This is the script command used to clear the screen.  When you
  1604. choose this option, you will first see a menu of colors which you may use to
  1605. clear the screen.  Highlight the desired color with the cursor key and press
  1606. enter.  Now you will see a menu of all possible screen clearing fade effects.
  1607. Highlight the desired effect with the cursor key and press enter.  The
  1608. appropriate CLR script command will now be automatically inserted into script
  1609. at the editor cursor location.  
  1610.  
  1611. For example, if you chose to clear the screen to black using the snake effect
  1612. the command CLR 10,0,0,0,0 would automatically be inserted in your script.
  1613. This command indicates you wish to clear the entire screen.  If you wish to
  1614. clear only a portion of the screen, then you need to enter the appropriate
  1615. pixel coordinates where the last four zero's now appear.  See the CLR command
  1616. information found in the Script Commands chapter of this manual for more
  1617. details.
  1618.  
  1619.  
  1620. Other Effects:  You'll also note other commands like ATPIX, PIXNUM, FXDELAY,
  1621. Delay, Pause, Sleep, etc. are contained on this menu.  To insert one of these
  1622. commands in your script, simply highlight the command with the cursor key and
  1623. then press enter.  The command will be inserted in your script at the cursor
  1624. location in the editor.  For details of each of these commands, see the chapter
  1625. named Script Commands.
  1626.  
  1627.  
  1628. F6 - SCREEN:  Pressing this function key will display a menu of PCX-SuperShow
  1629. screen related script commands.  Commands like EGA, VGA16, COLOR, and
  1630. CONDITIONAL BRANCHING commands are contained on this menu.  To insert one of
  1631. these commands in your script, simply highlight the command with the cursor key
  1632. and then press enter.  The command will be inserted in your script at the
  1633. cursor location in the editor.  For details of each of these commands, see the
  1634. chapter named Script Commands.
  1635.  
  1636.  
  1637. F7 - FONTS:  Pressing this function key will display a menu of PCX-SuperShow
  1638. font related script commands.  Commands for custom, internal and the SuperFont
  1639. are all located on this menu, as well as the commands for displaying fonts with
  1640. the Crawl, Type or Logo effect.  
  1641.  
  1642. Font Directory:  This option is associated with the custom GEM fonts used in
  1643. PCX SuperShow.  When you choose this option you will see a box asking for the
  1644. path/directory where you custom fonts are located.  It uses the current drive
  1645. and path as the default.  Press enter and a list of your custom fonts will
  1646. appear.  Using your cursor keys, highlight the desired font and press the Enter
  1647. key.  ShowPrep will then enter the appropriate FONT script command and filename
  1648. in your script.
  1649.  
  1650. Other Font Commands:  The remainder of the options in this menu may be chosen
  1651. by highlighting the desired command using your cursor keys.  Once highlighted,
  1652. press the Enter key and that command will be automatically written in your
  1653. script at the current cursor location.  For details of each of these commands,
  1654. see the chapter named Script Commands.
  1655.  
  1656.  
  1657. F8 - SOUND:  Pressing this function key will display a menu of PCX-SuperShow
  1658. sound and music related script commands.  Commands for digitized Sound Blaster
  1659. files and pc speaker sound and music are all located on this menu, as well as
  1660. some pre-programmed sounds.
  1661.  
  1662. SBPlay:  This is the command to play Sound Blaster digitized VOC files.  When
  1663. you choose this option you will see a box asking for the path/directory where
  1664. your VOC files are located.  It uses the current drive and path as the default.
  1665. Press enter and a list of your Sound Blaster VOC files will appear.  Using your
  1666. cursor keys, highlight the desired file and press the Enter key.  ShowPrep will
  1667. then enter the appropriate script command and filename in your script.
  1668.  
  1669. XPlay:  This is the command to play external music MUS files.  When you choose
  1670. this option you will see a box asking for the path/directory where your MUS
  1671. files are located.  It uses the current drive and path as the default.  Press
  1672. enter and a list of your music files will appear.  Using your cursor keys,
  1673. highlight the desired file and press the Enter key.  ShowPrep will then enter
  1674. the appropriate script command and filename in your script.
  1675.  
  1676. Other Sound Commands:  The remainder of the options in this menu may be chosen
  1677. by highlighting the desired command using your cursor keys.  Once highlighted,
  1678. press the Enter key and that command will be automatically written in your
  1679. script at the current cursor location.  For details of each of these commands,
  1680. see the chapter named Script Commands.
  1681.  
  1682.                                 ================
  1683.                                 RUN-TIME MODULES
  1684.                                 ================
  1685.  
  1686.                         NOT INCLUDED IN SHAREWARE VERSION
  1687.  
  1688.  
  1689.  
  1690.                                  =============
  1691.                                  PCX-UTILITIES
  1692.                                  =============
  1693.  
  1694.                         NOT INCLUDED IN SHAREWARE VERSION
  1695.  
  1696.  
  1697.  
  1698.                                 ==============
  1699.                                 MUSIC LANGUAGE
  1700.                                 ===============
  1701.  
  1702. In this version of PCX-SuperShow, we have added a music language that allows
  1703. you to play music/sounds right from your script or from an external music file.
  1704. Several sample external music files have been included with your registered
  1705. version of PCX-SuperShow.  In addition, samples of actual music language script
  1706. commands are included in the sample script file PCXSHOW.SPT.
  1707.  
  1708. Both the XPLAY music text and PLAY script command use a Music Language that is
  1709. very similar to that found in the Basic program language.
  1710.  
  1711. The music files, those with a .MUS extension, are simply self contained songs
  1712. saved in an ASCII text file format.  You can play these music files by using
  1713. the XPLAY command or by playing actual musical notes and notations right from
  1714. your script using the PLAY command.  Both methods use the same music language
  1715. syntax.
  1716.  
  1717. Basically, to use the PLAY script command you build a string of commands and
  1718. music notes which you include directly after issuing the PLAY script command.
  1719. Here is a list of the music commands:
  1720.  
  1721.  
  1722. PLAY [Commandstring]
  1723.  
  1724.     Commandstring is a string expression that contains music commands:
  1725.  
  1726. ───────────Set Octaves and Play Tones───────────────
  1727.  
  1728. Ox  Sets current octave (x = 0-6)    │  < or >  Up or down one octave
  1729. Nx  Plays note x (x = 0-84, 0 is a    │  A-G  Plays A, B, ..., G in current
  1730.      rest)                              │  octave (+ = sharp, - = flat)
  1731.  
  1732. ─────────────Set Tone Duration and Tempo───────────
  1733.  
  1734. Lx   Sets length of a note (L1 is    │  MS  Each note plays 3/4 of length
  1735.      whole note, L4 quarter note,    │  MN  Each note plays 7/8 of length
  1736.      etc.)  x = 1-64                    │  ML  Each note plays full length
  1737. Tx   Sets number of quarter        │  Px  Pause for the duration of
  1738.      notes per minute            │  x quarternotes (x = 1-64)
  1739.      (x = 32-255, 120 is default        │
  1740.  
  1741. ────────────────Set Operation────────────────
  1742.  
  1743. MF  Plays music in foreground        │  MB  Plays music in background
  1744.  
  1745. For example, lets play a few notes of Beethoven's Fifth Symphony.  We'll set
  1746. the tempo (T) at 180 quarter notes per minute and play in the second octave (o)
  1747. [that's the letter o not a zero].
  1748.  
  1749. PLAY T180 o2 P2 P8 L8 GGG L2 E-
  1750. PLAY P24 P8 L8 FFF L2 D
  1751.  
  1752. To interpret the first line:
  1753.       T180     = Tempo set at 180 quarter notes per minute.
  1754.     02    = 2nd octave
  1755.     P2    = Pause for 2 quarternotes
  1756.     P8    = Pause for 8 quarternotes
  1757.     L8    = Set note for eighth note
  1758.     GGG    = Plays three G notes
  1759.     L2    = Set note for half note
  1760.     E-    = Change to key of E flat
  1761.  
  1762. For the second line:
  1763.     P24    = Pause for 24 quarternotes
  1764.     P8    = Pause for 8 quarternotes
  1765.     L8    = Set note for eighth note    
  1766.     FFF    = Plays three F notes
  1767.     L2    = Set note for half note
  1768.     D    = Play a D note
  1769.  
  1770. You could actually put all of the music commands on one line and it would work
  1771. the same.  We try to keep the music command lines reasonably short for
  1772. readability.  Also you will note a space between each of the music commands.
  1773. This is not necessary, but again we do so for purposes of readability.
  1774.  
  1775.  
  1776. XPLAY [Filename.MUS]
  1777. --------------------
  1778. XPLAY will play an external ASCII text file containing a list of music commands
  1779. that normally comprise a song or portion of a song.  To create an external
  1780. music text file you simply write the commands much as you do in the script
  1781. using the PLAY script command.  The difference is that you do not need the word
  1782. PLAY preceding the music command.
  1783.  
  1784. If you want to include a comments in your music file, they must be preceded by
  1785. a apostrophe or they will be interpreted as a music commands and an error will
  1786. probably result. 
  1787.  
  1788. Here is a sample music file:
  1789.  
  1790. 'LaMarseille
  1791. mb O2 T150 mn
  1792. F16 F8. F16 B-4 B-4 >C4 C4 ml F4. mn D8 <B-8 P16
  1793. B-16 ml >D8. mn <B-16 G4 >E-2 ml C8. mn <A16 ml B-2 mn P8.
  1794.  
  1795. Here we include the name of the song as a comment by using the apostrophe.  We
  1796. also are telling the program to play this music in the background by using the
  1797. mb script command.  This means that while the song is playing you will be able
  1798. to execute other script commands.
  1799.  
  1800. The program will generate a music buffer that will hold up to 32 notes in the
  1801. background.  Depending on the tempo and note length, this means that when you
  1802. tell the program to play music in the background, you will be able to generate
  1803. several other script commands while the music is playing.  Important:  Do not
  1804. issue any other sound or music commands while playing music in the background.
  1805. The results will be unpredictable and most likely, undesirable. 
  1806.  
  1807.                                 ==============
  1808.                                 TECHNICAL HELP
  1809.                                 ==============
  1810.  
  1811. Technical assistance is available from PC WEST at no additional charge.  The
  1812. number to call is 602-992-0310.  The PC WEST phone is answered 24 hours a day,
  1813. seven days a week.  The best time to reach us, however, is Monday through
  1814. Friday from 9am to 2pm, Pacific Time.  If no one is available when you call,
  1815. you will be able to leave a recorded message and we will get back to you. . .
  1816. usually within 24 hours.
  1817.  
  1818. We are always looking for ways to improve our software.  If you have thoughts
  1819. of additional features you would like to see in future versions, please drop us
  1820. a line or call us at 602-992-0310 with your suggestions.
  1821.  
  1822. Thank you for using software from PC WEST!
  1823.  
  1824.                                                   APPENDIX A
  1825.                                                 ERROR MESSAGES
  1826.  
  1827. There may be times when you encounter errors when using the PCX-Show series of
  1828. programs.  Ninety percent of all errors reported to us deal with memory and
  1829. file problems.  We will cover the most common errors you may encounter.
  1830.  
  1831. OUT OF MEMORY:  Memory related problems are the most common and this error
  1832. means exactly what it says. . . the program could not find any memory to
  1833. continue operation.  As mentioned earlier, PCX-Show first attempts to use all
  1834. conventional memory available then it looks for expanded memory and finally it
  1835. uses disk space as virtual memory.  This error occurs when all those attempts
  1836. fail to provide enough memory for the show to continue.
  1837.  
  1838. SOLUTION:  This error most commonly occurs when running your show from
  1839. PCX-ShowPrep.  Graphics programs and files are very memory intensive.  ShowPrep
  1840. requires memory, as does Super-Show (PCXSP.EXE) as do each of your PCX files.
  1841. When running your show we recommend that you have 512K conventional memory
  1842. available.  To check how much memory is available, run the SHOWMEM.EXE utility
  1843. or CHKDSK DOS utility prior to running Super-Show or ShowPrep.  If you encounter
  1844. this error, unload all memory resident programs, f reeing as much conventional
  1845. memory as possible.  DOS 5.0 also provides more conventional memory to most
  1846. systems than earlier versions of DOS.
  1847.  
  1848. STRING SPACE CORRUPT:  This is also a memory related error message.  Again,
  1849. this error occurs most often when running your show from PCX-ShowPrep when you
  1850. have less than 512K conventional memory available.
  1851.  
  1852. SOLUTION:  See Out Of Memory error message solution above.
  1853.  
  1854.  
  1855. ILLEGAL FUNCTION CALL:  This error most commonly occurs when you issue commands
  1856. to the programs that contain parameters outside the legal boundaries.  For
  1857. example, if you issued the CRAWL script command with a text string containing
  1858. more than 255 characters you would encounter this error message. This error may
  1859. also be encountered with the PRINT, COLOR, CIRCLE and BOX script commands.
  1860.  
  1861. SOLUTION:  Locate the script command that causes this error message.  It may or
  1862. may not be the problem.  If it's not, the culprit isn't far behind.  For
  1863. example, say you found that the script command PRINT "Hello World" was executed
  1864. when the error occurred.  That command is okay.  Look back to the ATPIX
  1865. command, which locates where the text will be printed on your screen.  Say the
  1866. ATPIX command read AT 800,1.  There is the problem.  You are trying to print
  1867. the text at column 800, beginning at row 1.  Since there is no column 800
  1868. available, the illegal function call message is encountered.  Change the script
  1869. to the appropriate column number and run the show again.
  1870.  
  1871. CAN'T FIND [FileName.Ext]:  This means that the program cannot find a specific
  1872. file.  That file may be a font, script or pcx file.  Remember, the SUPER.OTL
  1873. font file must be included on any disk from which you use PCXSS.EXE or DEMO.EXE
  1874. since this is the default SuperFont file for the program.
  1875.  
  1876. SOLUTION:  Determine whether the error is caused by a missing file or an
  1877. incorrectly spelled filename.  If you try to display a non-existent pcx file
  1878. using the SHOW script command, a beep will sound and the program will continue
  1879. to execute the next script command.
  1880.  
  1881. SYSTEM LOCKUP:  We've tried to take every precaution to avoid the dreaded
  1882. system lock-up (aka "crash") when using the PCX-Show series of programs.
  1883. Unfortunately with the wide variety of hardware and memory resident software in
  1884. existence, you may encounter a lock-up.
  1885.  
  1886. SOLUTION:  This error usually occurs because of a memory resident process
  1887. conflict.  The solution is to note what command in the script is causing the
  1888. system to lock-up.  If you have unloaded all memory resident programs and the
  1889. system still locks-up when you execute a script command, please make note of
  1890. the command causing the problem and call us for technical assistance.
  1891.  
  1892. Please try to determine the reason for an error message by examining your
  1893. script and referring to the above error information.  If you still can't figure
  1894. out what's happening, give us a call.  Be sure you are by your computer with
  1895. the program loaded and ready when you call.
  1896.  
  1897.                         ============================
  1898.                         DISCLAIMER & ACKNOWLEDGMENTS
  1899.                         ============================
  1900.  
  1901. Warranty:  The PCX-SuperShow Software System and documentation is
  1902. provided "as-is" without warranty of any kind, either expressed or implied,
  1903. including but not limited to the implied warranties of merchantability and
  1904. fitness for a particular purpose.
  1905.  
  1906. Information in this manual/document is subject to change without notice and
  1907. does not represent a commitment on the part of PC West Software & Services.
  1908.  
  1909. PC WEST(sm) Software & Services and it's officers and employees shall have no
  1910. responsibility or liability to you or any other person, persons, or entity with
  1911. respect to loss or damage caused or alleged to be caused directly or indirectly
  1912. by use of PCX-SuperShow and/or its documentation.  The liability of PC WEST
  1913. Software & Services under the warranty set forth above shall be limited to the
  1914. amount paid by the customer for the product.  No other warranties are expressed
  1915. or implied as to the operation, use or suitability of PCX-SuperShow.
  1916.  
  1917. Copyright:  The computer files and this documentation are protected by United
  1918. States Copyright law.  PC WEST Software & Services owns and retains title to
  1919. the computer programs, files and the contents of this documentation.  Copyright
  1920. 1990/91/92, PC WEST Software & Services.
  1921.  
  1922. Acknowledgements:  The programs and utilities in the PCX-SuperShow software
  1923. package were created using various language editors, compiler, and link
  1924. programs and library toolbox routines.  These include Microsoft Professional
  1925. Development System 7.1, QuickBasic 4.5 and associated compiler and link
  1926. programs from Microsoft Corporation of Redmond, WA.  Portions also were
  1927. compiled/linked using PDQ from Crescent Software of Stamford, CT.  Code
  1928. includes toolbox routines from the QuickPak Professional Library & Graphics
  1929. Workshop also from Crescent Software of Stamford, CT.  Also, portions Copyright
  1930. Genus Microprogramming, Inc. 1988-1991. IBM is a registered trademark of
  1931. International Business Machines Corporation.  Microsoft, MS, MS-DOS are
  1932. registered trademarks of Microsoft Corporation.  PC WEST is a registered
  1933. service mark of PC WEST Software & Services.
  1934.  
  1935.     Published by:           PC WEST Software & Services 
  1936.                          P.O. Box 31418      
  1937.                          Phoenix, AZ 85046
  1938.  
  1939.  
  1940.  
  1941.  
  1942.          ----------------end-of-author's-documentation---------------
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.                                 HILLSOFT
  1949.  
  1950.                       Distributie en ontwikkeling van
  1951.                       Public-Domain/Shareware en
  1952.                       Commerciele software voor IBM
  1953.                       en compatibles.
  1954.  
  1955.                                Postbus 16
  1956.  
  1957.                            7670 AA  Vriezenveen
  1958.  
  1959.                             Tel. 05498-59599
  1960.                             Fax.      -58898
  1961.  
  1962.  
  1963.  
  1964.            U ontvangt onze menu-gestuurde catalogus op disk met
  1965.            een overzicht van alle programma's + beschrijving
  1966.            door f 3,-- (5,25" disk) of f 4,-- (3,5") over te
  1967.            maken op giro 14.64.418 of aan postzegels IN een
  1968.            envelop te sturen.
  1969.  
  1970.