home *** CD-ROM | disk | FTP | other *** search
/ DTP en Graphics 1 / dtpgraf1.zip / dtpgraf1 / M_MEDIA / SS4 / SP4.HLP < prev    next >
Text File  |  1994-02-03  |  35KB  |  1,122 lines

  1. ;New Script      Alt+N
  2.  This option clears the currently loaded script
  3.  from the screen and resets the script filename to
  4.  WORKING.SPT.  You will NOT be asked if you wish to
  5.  save the file before clearing.
  6. <
  7. ;Load Script     Alt+L
  8.  This option loads an existing SuperShow script
  9.  file into the editor.  When choosing this option,
  10.  a dialog box will appear containing all script
  11.  files (.SPT files) in the current directory.
  12.  
  13.  You may also choose another drive or directory.
  14.  
  15.  Choose the script file to load by pressing the Tab
  16.  and arrow keys and then press Enter.  The file
  17.  will then be loaded into the Editor.
  18. <
  19. ;Save Script     Alt+F
  20.  This option allows you to save the current script
  21.  file.  A window appears with the default script
  22.  file name/path.  If that's acceptable press enter.
  23.  You may also change the name of the script file.
  24. <
  25. ;Merge Script    Alt+M
  26.  Frequently, the best way to build presentations is
  27.  with separate scripts for each part of your show.
  28.  The merge feature lets you combine multiple
  29.  scripts into one script file.
  30.  
  31.  Choosing this option will open a dialog box with
  32.  names of the script files in the current
  33.  directory.  Choose a file to merge and press
  34.  enter.  The file will be appended to the end of
  35.  the current script.
  36. <
  37. ;Print Script
  38.  When choosing this option, all lines of the
  39.  currently loaded script will be sent to your line
  40.  printer.  ShowPrep uses LPT port #1 as the printer
  41.  port.  Other printer ports are not supported.
  42. <
  43. ;Search Script   Alt-F2
  44.  This option pop-ups a window requesting the search
  45.  word/phrase.  Type the information and press
  46.  enter.  The search will find the next occurance of
  47.  the entered word or phrase.  The search always
  48.  occurs forward from the current cursor position.
  49. <
  50. ;Search/Replace  Alt-F3
  51.  Similar to Search, this choice also has the
  52.  ability to replace the word/phrase with another.
  53.  
  54.  In addition to the search window, you will find a
  55.  replace window.  Enter the information you wish to
  56.  search; press the tab key; enter the replacement
  57.  information and press enter.
  58. <
  59. ;Save/Run Script    F10
  60.  This is the presentation preview option. Choosing
  61.  this item will save your script and then run it.
  62.  You may also press the F10 function key directly
  63.  from the editor.
  64. <
  65. ;DOS Shell
  66.  Choosing this option will shell out of ShowPrep
  67.  putting you at a DOS prompt in current directory.
  68.  You may perform normal DOS tasks like Copy, Erase,
  69.  Dir, etc.  DO NOT load any TSR's (memory resident)
  70.  programs while in the shell.  To return, type EXIT
  71.  at the prompt and press Enter.
  72. <
  73. ;Quit            Alt+F1
  74.  Choosing this option exits ShowPrep and returns
  75.  you to the DOS prompt or calling program.
  76. <
  77. ;SHOW @         Alt+S
  78.  This script command is used to display an image at
  79.  a desired pixel location using a designated
  80.  transition effect.  The proper syntax is:
  81.  
  82.            Show @ x,y filename.ext #
  83.  
  84.  where x is the pixel column, y is the pixel row,
  85.  filename is the DOS filename, .ext is either .pcx
  86.  or .gif, and # is a number between 0 and 39 which
  87.  designates the desired transition effect.
  88.  
  89.  Using the pull-down menu will take you through
  90.  each step and then automatically write the command
  91.  to your script.
  92. <
  93. ;CLR            Alt+C
  94.  This script command is used to clear the screen at
  95.  the desired pixel location using a designated
  96.  color and transition effect.  Proper syntax is:
  97.  
  98.          CLR color#,fx#,x1,y1,x2,y2
  99.  
  100.  where color# is a number between 0 and 255, fx# is
  101.  a transition effect number between 0 and 30.  x1
  102.  and y1 are the beginning pixel column and row and
  103.  x2 and y2 are the ending pixel column and row.
  104. <
  105. ;Animation      Alt+A
  106.  This option will display a list of all script
  107.  commands that may be used when creating animation
  108.  in your presentation.
  109.  
  110.  Further help is available from that list by
  111.  highlighting the command and pressing F1.
  112. <
  113. ;Set Animate1
  114.  This command designates a list of pcx images you
  115.  wish to include in an animation sequence.  The
  116.  proper syntax for this process is:
  117.  
  118.   Set Animate1
  119.   file1.pcx
  120.   file2.pcx
  121.   (..etc..)
  122.   End Set
  123.  
  124.  The maximum number of images used in an animation
  125.  sequence depends on the size of the images and
  126.  memory available to your system.  Consult the
  127.  chapter titled Animation in your manual for full
  128.  details on the animation process.
  129. <
  130. ;Set Animate2
  131.  This command allows you to create a second list of
  132.  images to include in an animation sequence.  The
  133.  proper syntax for this process is:
  134.  
  135.   Set Animate2
  136.   file1.pcx
  137.   file2.pcx
  138.   (..etc..)
  139.   End Set
  140.  
  141.  The maximum number of images used in an animation
  142.  sequence depends on the size of the images and
  143.  memory available to your system.  Consult the
  144.  chapter titled Animation in your manual for full
  145.  details on the animation process.
  146. <
  147. ;End Set
  148.  This is the final command used when creating a
  149.  list of images to include in an animation
  150.  sequence.  See Set Animate1 help for the syntax.
  151. <
  152. ;Put @
  153.  The Put command is used to transparently display
  154.  an image at a designated pixel location. The
  155.  proper syntax is:
  156.  
  157.             Put @ x,y filename.ext
  158.  
  159.  where x is the pixel column, y is the pixel row,
  160.  filename is the dos filename and .ext is either
  161.  .pcx or .gif.
  162.  
  163.  The transparent color is chosen with the KeyColor
  164.  script command.
  165. <
  166. ;Animate1
  167.  The Animate1 command is used to display the
  168.  animation sequence created by Set Animate1.  The
  169.  proper syntax for this command is:
  170.  
  171.      Animate1 x1,y1,x2,y2,step#,restore#
  172.  
  173.  where x1 is the beginning pixel column, y1 is the
  174.  beginning pixel row, x2 and y2 are the ending
  175.  column & row, respectively.  Step# designates how
  176.  many steps the images move for each animation.
  177.  Restore# is a number between 0 & 2 and determines
  178.  whether the image will remain displayed on the
  179.  screen at the end of the animation sequence.
  180.  
  181.  The speed of the animation may be controlled by
  182.  using the FxDelay script command.  Consult the
  183.  chapter titled Animation in your manual for full
  184.  details on the animation process.
  185. <
  186. ;Animate2
  187.  The Animate2 command is used to display the
  188.  animation sequence created by Set Animate2.  The
  189.  proper syntax for this command is:
  190.  
  191.      Animate2 x1,y1,x2,y2,step#,restore#
  192.  
  193.  where x1 is the beginning pixel column, y1 is the
  194.  beginning pixel row, x2 and y2 are the ending
  195.  column & row, respectively.  Step# designates how
  196.  many steps the images move for each animation.
  197.  Restore# is a number between 0 & 2 and determines
  198.  whether the image will remain displayed on the
  199.  screen at the end of the animation sequence.
  200.  
  201.  The speed of the animation may be controlled by
  202.  using the FxDelay script command.  Consult the
  203.  chapter titled Animation in your manual for full
  204.  details on the animation process.
  205. <
  206. ;PFloat
  207.  This command is used for displaying single image
  208.  animation.  The proper syntax is:
  209.  
  210.   PFloat x1,y1,x2,y2,step#,restore#,filename.pcx
  211.  
  212.  x1 is the beginning column, y1 is the beginning
  213.  row, x2 and y2 are the ending column and row,
  214.  respectively.  Step# designates how many steps the
  215.  image moves during each cycle.  Restore# is a
  216.  number between 0 and 2. Zero (0) means the image
  217.  will disappear from the display at the end of the
  218.  sequence.  1 means the image will leave a trail
  219.  from beginning to end.  2 means the image will
  220.  remain on the screen at the end of the sequence.
  221.  Filename.pcx is the name of the image to float.
  222.  
  223.  The speed of PFloat effect may be controlled by
  224.  using the FxDelay script command.  Consult the
  225.  chapter titled Animation in your manual for full
  226.  details on the animation process.
  227. <
  228. ;TFloat
  229.  This command is used for displaying a text message
  230.  using an animation effect.  The proper syntax is:
  231.  
  232.    TFloat x1,y1,x2,y2,step#,restore#,"message"
  233.  
  234.  x1 and y1 are the beginning row and column, x2 and
  235.  y2 are the ending column and row, respectively.
  236.  Step# designates how many steps the message moves
  237.  during each cycle.  Restore# is a number between 0
  238.  and 2. Zero means the text will disappear from the
  239.  display at the end of the sequence.  1 means the
  240.  text will leave a trail from beginning to end.  2
  241.  means the text will remain on the screen at the
  242.  end of the sequence. "Message" are the words you
  243.  wish to float.
  244.  
  245.  The speed of TFloat effect may be controlled by
  246.  using the FxDelay script command.  Consult the
  247.  chapter titled Animation in your manual for full
  248.  details on the animation process.
  249. <
  250. ;Kill Animate
  251.  This command frees the memory used to store images
  252.  you created used in Set Animate# command.  Once
  253.  the animation sequence is completed and won't be
  254.  used again, you should free memory by using this
  255.  command.  It's important to use this command
  256.  before re-using the Set Animate# command.
  257. <
  258. ;KeyColor
  259.  This command designates which color will be
  260.  transparent during an animation, float or put
  261.  sequence.  The syntax is:
  262.  
  263.             KeyColor [colornumber]
  264.  
  265.  where colornumber is an associated color number
  266.  between 0 and 255.  The default KeyColor is black
  267.  which is color number 0 (zero).
  268. <
  269. ;Do Loop
  270.  A Do Loop allows you to repeat a designated series
  271.  of script commands.  Here is an example of a Do
  272.  Loop script sequence:
  273.  
  274.             Do Loop
  275.             Color 0,0
  276.             Print @ 100,100 "This is a test"
  277.             Wait .5
  278.             Color 15,0
  279.             Print @ 100,100 "This is a test"
  280.             Wait .5
  281.             Loop 10
  282.  
  283.  This would flash the message "This is a test"
  284.  every second for ten times.  The maximum loop
  285.  number is 20.  Do not nest a second Do Loop inside
  286.  an existing Do Loop.
  287. <
  288. ;Loop
  289.  This is the end statement of a Do Loop sequence.
  290.  The proper syntax is:
  291.  
  292.               Loop [number#]
  293.  
  294.  where number# is a number between 2 and 20.  See
  295.  the help on Do Loop for a sample sequence.
  296. <
  297. ;Set File Type  Alt+F9
  298.  This option sets ShowPrep to work with pcx or gif
  299.  files.  While you may mix pcx and gif images in a
  300.  presentation, many of the tools need to know the
  301.  active image type.  The default is pcx.
  302. <
  303. ;PixNum
  304.  This command sets the number of horizontal and
  305.  vertical pixels displayed during a transition
  306.  effect.  Changing these numbers creates dozens of
  307.  different effects for each transition.  It also
  308.  affects the speed with which an image appears. The
  309.  proper syntax is:
  310.  
  311.               PIXNUM [horiz#,vert#]
  312.  
  313.  where horiz# is the horizontal pixel number and
  314.  vert# is the vertical pixel number.  The default
  315.  is 8,8.
  316. <
  317. ;FXDelay
  318.  FxDelay controls the speed of transition and
  319.  animation effects.  The higher the number, the
  320.  slower the effect.  The syntax is:
  321.  
  322.               FxDelay [number#]
  323.  
  324.  where number# is a number from 0 to 5000.  In
  325.  reality you probably would not use a number larger
  326.  than 200.  The default is zero (0).
  327. <
  328. ;Special FX     Alt+X
  329.  Choosing this option will display a list of all
  330.  special effects script commands that may be used
  331.  when creating your presentation.
  332.  
  333.  Further help is available from that list by
  334.  highlighting the command and pressing F1.
  335. <
  336. ;EscKey On
  337.  This command activates the Esc key as the active
  338.  termination key.  That means when the Esc key is
  339.  pressed, the show will end as soon as the current
  340.  script command is completed.
  341.  
  342.  When a presentation is ended by pressing the Esc
  343.  key a DOS Error Level number 27 is returned.  DOS
  344.  Error Level may be read/recognized in a batch
  345.  file.  This is useful if you wish to determine how
  346.  someone exited your presentation.
  347.  
  348.  EscKey On is the default.
  349. <
  350. ;EscKey Off
  351.  This command de-activates the Esc key as the
  352.  active termination key.  This means when the Esc
  353.  key is pressed, the show will continue to run
  354.  until the script is completed or a Stop script
  355.  command is encountered.
  356.  
  357.  EscKey On is the default.
  358. <
  359. ;Shake
  360.  This special effects command will shake the video
  361.  display for a designated number of cycles.  The
  362.  proper syntax is:
  363.  
  364.                     Shake #
  365.  
  366.  where # is the number of cycles you wish to shake
  367.  the video display.
  368. <
  369. ;Flash
  370.  This command creates a flashing marquee effect on
  371.  selected colors.  The syntax is:
  372.  
  373.       Flash [Color#,TotColors,Repeat,Delay]
  374.  
  375.  where Color# is the beginning color number,
  376.  TotColors is the number of colors to flash, Repeat
  377.  is the number of times to flash and Delay is a
  378.  number that designates the speed of the flashing
  379.  effect.  The higher the Delay number, the slower
  380.  the flashing rate.
  381. <
  382. ;Paint
  383.  This re-maps a color number to a different color
  384.  number for one display sequence.  The syntax is:
  385.  
  386.                 Paint [Old#,New#)
  387.  
  388.  where Old# is the color number you wish to change
  389.  and New# is the color you wish to change to.
  390. <
  391. ;Kalid
  392.  This command generates a kaleidoscope screen using
  393.  the current palette.  The syntax is:
  394.  
  395.                 Kalid [number]
  396.  
  397.  where number is any number between -32000 and
  398.  32000.  By designating a number you guarantee that
  399.  the same pattern will be drawn each time you run
  400.  your presentation.
  401. <
  402. ;Pattern
  403.  This command generates a line pattern display
  404.  using the current palette.  The syntax is:
  405.  
  406.            Pattern [size,type]
  407.  
  408.  where size is a number from 1 to 2000 which
  409.  represents how large the pattern will display on
  410.  the screen.  Type is a number from 1 to 600 and
  411.  designates different pattern types.
  412. <
  413. ;Crwlat
  414.  This command is used to set the parameters for the
  415.  Crawl special effect.  The syntax is:
  416.  
  417.              Crwlat [x,y,x2,Delay]
  418.  
  419.  where x is the pixel column start, y is the pixel
  420.  row, and x2 is the pixel column end; Delay is the
  421.  number of seconds you wish the message to crawl
  422.  across the screen.
  423. <
  424. ;Crawl
  425.  This command will display a ticker tape type
  426.  message while waiting for a key press or for a
  427.  specified amount of time.  The syntax is:
  428.  
  429.         Crawl ["Message"]
  430.  
  431.  where "Message" is the text you wish to display
  432.  using the crawl effect.  The text should be
  433.  surrounded by quotes.
  434. <
  435. ;Type @
  436.  This command will display a line of text with a
  437.  typewriter sound effect.  The syntax is:
  438.  
  439.             Type @ [x,y "Message"]
  440.  
  441.  where x and y are the beginning pixel column and
  442.  row and "Message is the text you wish to display
  443.  using the Type effect.  The text should be
  444.  surrounded by quotes.
  445. <
  446. ;SType @
  447.  This command will display a line of text with a
  448.  silent typewriter effect.  The syntax is:
  449.  
  450.             SType @ [x,y "Message"]
  451.  
  452.  where x and y are the beginning pixel column and
  453.  row and "Message is the text you wish to display
  454.  using the Type effect.  The text should be
  455.  surrounded by quotes.
  456. <
  457. ;$Type @
  458.  This command will display a single line of user
  459.  input text stored in string using the typewriter
  460.  sound effect.  The syntax is:
  461.  
  462.                $Type @ [x,y,$#]
  463.  
  464.  where x and y are the beginning pixel column and
  465.  row and $# is the number of the user input string
  466.  you wish to display using the Type effect.  
  467. <
  468. ;Logo At
  469.  This command sets the location of the 3D logo
  470.  effect.  The syntax is:
  471.  
  472.                 Logo At [x,y]
  473.  
  474.  where x & y are beginning pixel column and row.
  475. <
  476. ;Logo ,
  477.  This command displays a text line using one of
  478.  three 3D logo special effects.  The syntax is
  479.  
  480.              Logo [color#,"Message"]
  481.  
  482.  where color# is the foreground color of the text
  483.  and "Message" is the text you wish to display
  484.  using this effect.  The text should be surrounded
  485.  by quotation marks.
  486. <
  487. ;Logo1 ,
  488.  This command displays a text line using one of
  489.  three 3D logo special effects.  The syntax is
  490.  
  491.              Logo1 [color#,"Message"]
  492.  
  493.  where color# is the foreground color of the text
  494.  and "Message" is the text you wish to display
  495.  using this effect.  The text should be surrounded
  496.  by quotation marks.
  497. <
  498. ;Logo2 ,
  499.  This command displays a text line using one of
  500.  three 3D logo special effects.  The syntax is
  501.  
  502.              Logo2 [color#,"Message"]
  503.  
  504.  where color# is the foreground color of the text
  505.  and "Message" is the text you wish to display
  506.  using this effect.  The text should be surrounded
  507.  by quotation marks.
  508. <
  509. ;Explode @
  510.  This command will cause a gif or pcx image to
  511.  grown on screen until it has reached full size.
  512.  The syntax is:
  513.  
  514.         Explode @ [x,y,filename.ext,scale%]
  515.  
  516.  where x and y are the offset from center of the
  517.  pixel column and row locations, filename.ext is
  518.  the name of the image file, and scale% is a number
  519.  from 2 to 25 that determines how quickly the image
  520.  will grow to full size.
  521. <
  522. ;Scale @
  523.  This command will display a scaled version of an
  524.  image file.  The proper syntax is:
  525.  
  526.            Scale @ [x,y,filename.ext,%]
  527.  
  528.  where x and y are the beginning pixel column and
  529.  row locations, filename.ext is the name of the
  530.  image file, and % represents the amount of scaling
  531.  you wish to occur.
  532. <
  533. ;Date @
  534.  This command will display the current date using
  535.  the currently active font.  The syntax is:
  536.  
  537.                 Date @ [x,y]
  538.  
  539.  where x and y are the pixel column and row
  540.  locations where you wish the date displayed.
  541. <
  542. ;Time1 @
  543.  This command will display the current time in
  544.  hours, minutes and seconds using the currently
  545.  active font.  The syntax is:
  546.  
  547.               Time1 @ [x,y,delay]
  548.  
  549.  where x and y are the pixel column and row
  550.  where you wish the time displayed and delay is the
  551.  amount of time you wish the the time displayed.
  552. <
  553. ;Time2 @
  554.  This command will display the current time in
  555.  hours and minutes using the currently active font.
  556.  The syntax is:
  557.  
  558.               Time2 @ [x,y,delay]
  559.  
  560.  where x and y are the pixel column and row where
  561.  you wish the time displayed and delay is the
  562.  amount of time you wish the the time displayed.
  563. <
  564. ;Delay
  565.  This command will delay a presentation for a
  566.  designated number of seconds, or until a key or
  567.  mouse click occurs.  The syntax is:
  568.  
  569.                 Delay [seconds]
  570.  
  571.  where seconds is the number of seconds you wish to
  572.  delay the currently running presentation.
  573. <
  574. ;Pause
  575.  Pause is used to halt the currently running
  576.  presentation.  The presentation will resume if a
  577.  user presses a key or clicks the mouse.
  578. <
  579. ;Sleep
  580.  Sleep is almost identical to Delay, but uses a
  581.  different timer.  Occasionally, Delay may
  582.  interfere with sound being played in the
  583.  background.  If that occurs, try the Sleep
  584.  command.  The proper syntax is:
  585.  
  586.                 Sleep [seconds]
  587.  
  588.  where seconds is the number of seconds you wish to
  589.  delay the currently running script.
  590. <
  591. ;Wait
  592.  Wait is a forced delay command.  Where Delay and
  593.  Sleep will end if the user strikes a key or clicks
  594.  the mouse, Wait will not respond to any mouse
  595.  action or keypress except the Esc key if the
  596.  EscKey On command is active.  The syntax is:
  597.  
  598.                 Wait [seconds]
  599.  
  600.  where seconds is the number of seconds you wish to
  601.  delay.  Wait also is the most accurate of the
  602.  timing commands and you may actually designate
  603.  time in tenths of seconds.  If you need to control
  604.  the speed of a Do Loop or coordinate sound with
  605.  video, Wait is the ideal timing command to use.
  606. <
  607. ;Run
  608.  Run will execute any program file with an .exe,
  609.  .com or .bat extension.  This includes shows you
  610.  create with the MakeShow utility.  You may also
  611.  include an optional line label parameter.  Once
  612.  the called program is run, you will NOT return to
  613.  the calling script.  This command only works in a
  614.  compiled (created by MakeShow) version of your
  615.  presentation.  The syntax is:
  616.  
  617.          Run FILENAME.EXT [:LINE LABEL]
  618.  
  619.  where FILENAME.EXT is the program file name. The
  620.  optional line label parameter is for running other
  621.  presentations created with the MakeShow utility.
  622.  By including a line label, the presentation you
  623.  are running will begin at the label you designate
  624.  in the Run command.
  625. <
  626. ;TRun
  627.  The TRun command is identical to the Shell command
  628.  except that the video mode is switched to text
  629.  mode.  This will blank your screen.  As opposed to
  630.  Run, TRun shells to DOS, which means upon task
  631.  completion, you are returned to the calling
  632.  script.  This command will work from ShowPrep or
  633.  in a compiled version. The proper syntax is:
  634.  
  635.      TRun [FILENAME.EXT] or [DOS parameters]
  636.  
  637.  where FILENAME.EXT is a program file.  You may use
  638.  TRun to perform such DOS tasks as listing a
  639.  directory or copying a file.  Upon return, your
  640.  show continues at the next script command
  641.  following the TRun command.
  642. <
  643. ;Shell
  644.  Shell is similar to Trun except the video card
  645.  remains set in the current mode.  This means you
  646.  may continue to display a screen from your show
  647.  and still shell a program file.  Example: Playing
  648.  an external sound file while displaying an image
  649.  or images on your screen.  The syntax is:
  650.  
  651.       Shell [FILENAME.EXT] or [DOS parameters]
  652.  
  653.  where FILENAME.EXT is a program file.  You may use
  654.  Shell to perform DOS tasks such as listing a
  655.  directory or copying a file.  Upon return, your
  656.  show continues at the next script command
  657.  following the Shell command.
  658. <
  659. ;Stop
  660.  When the Stop command is encountered, the show
  661.  ends and returns to ShowPrep (or DOS in a
  662.  compiled version).
  663. <
  664. ;Screen Mode
  665.  This command sets a specific screen mode.  A menu
  666.  of all screen modes appears on your screen.
  667.  Highlight the desired mode and press the Enter key
  668.  and the screen mode command will be placed in your
  669.  script at the current cursor location.
  670. <
  671. ;Color
  672.  This is used to set foreground and background
  673.  colors for displaying text, boxes, circles, etc.
  674.  The syntax is:
  675.  
  676.                Color [fg,bg]
  677.  
  678.  where fg is the foreground color and bg is the
  679.  background color.
  680. <
  681. ;PAL
  682.  This command will cause the palette of the
  683.  designated image to become the active palette.
  684.  The syntax is:
  685.  
  686.               PAL [filename.ext]
  687.  
  688.  where filename.ext is the name of the image file.
  689.  This command does NOT load the image file, only
  690.  the palette from that image.
  691. <
  692. ;EPAL
  693.  This command will change a designated color in the
  694.  EGA palette to a new color.  The syntax is:
  695.  
  696.                 EPAL [old#,new#]
  697.  
  698.  where old# is a number from 0 to 15 and the new
  699.  number is a number from 0 to 63.
  700. <
  701. ;VPAL
  702.  This command will change a desingated color in the
  703.  VGA palette to a new color.  The syntax is:
  704.  
  705.            VPAL [color#,red,blue,green]
  706.  
  707.  where color# is the number of the color you wish
  708.  to change, red, blue and green are palette
  709.  intensities and are numbers from 0 to 63.
  710. <
  711. ;Box
  712.  This command will draw a rectangle on the screen
  713.  using the active colors.  The syntax is:
  714.  
  715.                 Box [x1,y1,x2,y2]
  716.  
  717.  where x1 and y1 are the beginning pixel column and
  718.  row locations and x2 and y2 are the ending pixel
  719.  column and row locations.
  720. <
  721. ;Circle
  722.  This command will draw an ellipse on the screen
  723.  using the active colors.  The syntax is:
  724.  
  725.              Circle [x,y,h,v]
  726.  
  727.  where x and y designate the pixel location of
  728.  where the ellipse will be centered, h is the
  729.  horizontal axis and v the vertical axis.
  730. <
  731. ;Fill
  732.  This command is used to fill a box or circle with
  733.  a specified fill character.  The syntax is:
  734.  
  735.                 Fill [style]
  736.  
  737.  where style is the fill type.  The choices are
  738.  solid, bricks, diagonal, links, smalldots and
  739.  bigdots.
  740. <
  741. ;Tile
  742.  This command will tile the screen (also referred
  743.  to as wall-paper) with a designated image.  The
  744.  proper syntax is:
  745.  
  746.            Tile [x1,y1,x2,y2,filename.ext]
  747.  
  748.  where x1 and y1 are the beginning pixel column and
  749.  row locations, x2 and y2 are the ending pixel
  750.  column and row locations, and filename.ext is the
  751.  name of the image file.
  752. <
  753. ;:LABEL
  754.  This is a line label command.  A line label must
  755.  always by preceded by a colon.  Line labels are
  756.  used in conditional branching.  See the manual for
  757.  details on creating conditional branching.
  758. <
  759. ;INPUT
  760.  This is a conditional branching command.  It's
  761.  purpose is to register a keypress or mouse click
  762.  by the user of your show.  The syntax is:
  763.  
  764.                 INPUT [delay]
  765.  
  766.  where delay is the number of seconds the show will
  767.  wait to receive a keypress or mouse click before
  768.  going on to the next script command.
  769. <
  770. ;IF   GOTO :
  771.  This is a conditional branching command.  It's
  772.  purpose is to send program specific instructions
  773.  if a designated key was pressed by the user during
  774.  an INPUT command.  The syntax is:
  775.  
  776.           IF [key] GOTO :[line label]
  777.  
  778.  where key is the key pressed and line label is the
  779.  label to goto when that key is pressed.
  780. <
  781. ;RETURN :
  782.  This is a conditional branching command.  It's
  783.  purpose is to return the show to a specific line
  784.  label after encountering an if goto command. The
  785.  proper syntax is:
  786.  
  787.                 RETURN :[name]
  788.  
  789.  where name is the label where the show returns.
  790. <
  791. ;GOTO :
  792.  This command will force the program to a
  793.  designated line label.  The proper syntax is:
  794.  
  795.                 GOTO :[name]
  796.  
  797.  where name is the label where the show is to go.
  798. <
  799. ;Count Commands
  800.  This option will display a list of all counting
  801.  and scoring script commands.
  802.  
  803.  Further help is available from that list by
  804.  highlighting the command and pressing F1.
  805. <
  806. ;TCount
  807.  This counting & scoring command adds a count of
  808.  one to the existing TCount number.
  809. <
  810. ;FCount
  811.  This counting & scoring command adds a count of
  812.  one to the existing FCount number.
  813. <
  814. ;ReSet
  815.  This command will re-set the number count for
  816.  TCount and FCount to zero.
  817. <
  818. ;CPrint TCount
  819.  This will print the TCount number to the screen
  820.  using the active font.
  821. <
  822. ;CPrint FCount
  823.  This will print the FCount number to the screen
  824.  using the active font.
  825. <
  826. ;CPrint Score
  827.  This will print a score percentage based on the
  828.  total TCount & FCount number divided by TCount.
  829. <
  830. ;FONT Directory  Alt+Z
  831.  This option will pop-up a dialog box listing the
  832.  custom fonts in the current directory.  Highlight
  833.  the desired font, press Enter and the FONT command
  834.  and filename will be inserted in your script.
  835. <
  836. ;FONT ROM8
  837.  This option will insert a FONT command in your
  838.  script making the ROM 8x8 font the active font.
  839. <
  840. ;FONT ROM14
  841.  This option will insert a FONT command in your
  842.  script making the ROM 8x14 font the active font.
  843. <
  844. ;FONT ROM16
  845.  This option will insert a FONT command in your
  846.  script making the ROM 8x16 font the active font.
  847. <
  848. ;Textfade        Alt+Q
  849.  This option pops up a dialog box listing the text
  850.  fade effects.  Highlight the effect, press Enter
  851.  and the text fade will be inserted in your script.
  852. <
  853. ;Print @
  854.  This command is used to print text to the screen.
  855.  The proper syntax is:
  856.  
  857.             Print @ [x,y "Message"]
  858.  
  859.  where x and y are the beginning pixel column and
  860.  row locations and "Message" is the text you wish
  861.  to display.
  862. <
  863. ;Style
  864.  This option pops up a dialog box listing the text
  865.  styles.  Highlight a style, press Enter and the
  866.  text style command will be placed in your script.
  867.  
  868.  Styles are cumulative, meaning that you may have
  869.  multiple styles (such as bold, underline and
  870.  overlay) active at the same time.  To reset the
  871.  text style choose style normal.
  872. <
  873. ;Rotate
  874.  This command affects the rotation angle of the
  875.  custom and rom fonts.  The syntax is:
  876.  
  877.             Rotate [angle]
  878.  
  879.  where angle is 0, 90, 180 or 270.
  880. <
  881. ;Scroll
  882.  This command will access an external ascii text
  883.  file and allow scrolling of that text on the
  884.  screen.  Scrolling occurs by pressing the pgup,
  885.  pgdn, home, end or arrow keys.  Press esc to exit
  886.  from the scroll box.  The syntax is:
  887.  
  888.         Scroll [x1,y1,x2,y2,textfile.txt]
  889.  
  890.  where x1 and y1 designate the upper left corner of
  891.  the scroll box; x2 and y2 designate the lower
  892.  right corner of the scroll box; and textfile.txt
  893.  is the file you wish to display in the scroll box.
  894. <
  895. ;User Input Commands
  896.  This displays a list of all user input commands.
  897.  Further help is available from that list by
  898.  highlighting the command and pressing F1.
  899. <
  900. ;Get @ $
  901.  This user input command allows the user of your
  902.  presentation to input a line of information that
  903.  you may later retrieve or save. Maximum number of
  904.  lines is 21.  The syntax is:
  905.  
  906.               Get @ [x,y] $[#]
  907.  
  908.  where x and y are the starting pixel column and
  909.  row locations and # is a string ($) number between
  910.  zero and 20.  As the user inputs text from the
  911.  keyboard, the input will be displayed on the
  912.  screen using the active font.
  913. <
  914. ;$Print @
  915.  This command will print the contents of a user
  916.  string to the screen using the current active
  917.  font.  The syntax is:
  918.  
  919.              $Print @ [x,y] $[#]
  920.  
  921.  where x and y are the starting pixel column and
  922.  row and # is the user string number to display.
  923. <
  924. ;$SPrint @
  925.  This will print the contents of a user string to
  926.  the screen using the SuperFont.  The syntax is:
  927.  
  928.              $Print @ [x,y] $[#]
  929.  
  930.  where x and y are the starting pixel column and
  931.  row and # is the user string number to display.
  932. <
  933. ;$Size
  934.  This command designates the length of the string
  935.  allowed for user input.  The syntax is:
  936.  
  937.                 $Size [#]
  938.  
  939.  where # is the number of characters allowed for
  940.  user input.  The $Size affects both the Get and
  941.  Read commands.
  942. <
  943. ;Read
  944.  This is the command used to read an external user
  945.  input file.  The proper syntax is:
  946.  
  947.                Read [textfile.txt]
  948.  
  949.  where textfile.txt is the name of the textfile you
  950.  wish to read.
  951. <
  952. ;Save $
  953.  This command will save all user input strings to a
  954.  file named with $ parameter.  The syntax is:
  955.  
  956.                 Save $[#]
  957.  
  958.  where # is a number from 0 to 20 and is a user
  959.  string that's been designated as a filename.
  960.  Example: $1 = "myfile.txt" followed by Save $1
  961.  will saved all user input strings to myfile.txt.
  962. <
  963. ;$ =
  964.  This command forces the designated user string
  965.  number to contain the quoted text.  The syntax is:
  966.  
  967.                  $[#] = "Message"
  968.  
  969.  where # is a string number between 0 and 20 and
  970.  "Message" is the text you wish to designate.
  971. <
  972. ;SBPlay
  973.  The SBPlay command plays a digitized .VOC file in
  974.  the foreground.  This menu option will pop up a
  975.  list of all .VOC files in the current directory.
  976.  Highlight the desired file, press Enter and the
  977.  SBPlay command will be written to your script.
  978. <
  979. ;XBPlay
  980.  The XBPlay command plays a digitized .VOC file in
  981.  the background.  This menu option will pop up a
  982.  list of all .VOC files in the current directory.
  983.  Highlight the desired file, press Enter and the
  984.  SBPlay command will be written to your script.
  985.  
  986.  The maximum size of a .VOC file is 150K.  If your
  987.  sound requirements exceed that, split the sound
  988.  file into multiple files of 150K or less.
  989. <
  990. ;LBPlay
  991.  This command continuously plays a .VOC file in
  992.  the background for a designated number of times.
  993.  The syntax is:
  994.  
  995.                 LBPlay [sound.voc, #]
  996.  
  997.  where sound.voc is the name of the sound file and
  998.  # is the number of times you wish to play it.  If
  999.  # is equal to 0, the sound file plays continuously
  1000.  until a KillXB command is encountered.
  1001. <
  1002. ;KillXB
  1003.  This command frees the memory used to play .VOC
  1004.  files with the XB/LB/SB Play commands.  It is
  1005.  important to use this command before playing
  1006.  another .VOC file.
  1007. <
  1008. ;Play
  1009.  This command will directly play music through your
  1010.  pc speaker.  The proper syntax is:
  1011.  
  1012.                   Play [notes]
  1013.  
  1014.  where notes may be a single or multiple music
  1015.  notes or other music language commands.  See the
  1016.  chapter titled Music Language for details on the
  1017.  built in music language of SuperShow.
  1018. <
  1019. ;XPlay
  1020.  This command will play an external music file
  1021.  (.MUS) in the background, through your pc speaker.
  1022.  The syntax is:
  1023.  
  1024.                 XPlay [filename.mus]
  1025.  
  1026.   where filename.mus is the name of the external
  1027.   music file you wish to play.
  1028. <
  1029. ;KillXP
  1030.  This command frees the memory used to play .MUS
  1031.  files with the XPlay command.
  1032. <
  1033. ;Sound
  1034.  This command will play one of 10 different beep
  1035.  sequences through your pc speaker.  The syntax is:
  1036.  
  1037.                 Sound [#]
  1038.  
  1039.  where # is a number from -4 to 5.
  1040. <
  1041. ;CMFPlay
  1042.  This command will play an external CMF midi music
  1043.  file in the background if you have a Sound Blaster
  1044.  or compatible music card.  The syntax is:
  1045.  
  1046.                 CMFPlay [filename.cmf]
  1047.  
  1048.  where filename.cmf is the name of the sound file
  1049.  you wish to play.  You must load the external
  1050.  driver, SBFMDRV.COM, prior to running your
  1051.  presentation when playing .CMF sound files.
  1052. <
  1053. ;CMFKill
  1054.  This command will stop the playing of a CMF midi
  1055.  music file and restore the memory used to play
  1056.  that file in the background.
  1057. <
  1058. ;Blaster On
  1059.  This command will load the internal Sound Blaster
  1060.  driver and must be issued before you can play any
  1061.  digitized .VOC files.  This command does not
  1062.  affect .CMF files since a separate driver
  1063.  (SBFMDRV.COM) is loaded to play .CMF files.
  1064.  
  1065.  If the Blaster On command is issued on a system
  1066.  with no sound card, SuperShow just ignores the
  1067.  command and continues with your presentation.
  1068. <
  1069. ;Blaster Off
  1070.  This command will turn off the internal Sound
  1071.  Blaster driver.  SB/XB or LB Play commands will be
  1072.  ignored if the Blaster driver is turned off.
  1073.  
  1074.  If the Blaster Off command is issued on a system
  1075.  with no sound card, SuperShow just ignores the
  1076.  command and continues with your presentation.
  1077. <
  1078. ;Mouse On
  1079.  This command will make the mouse cursor visible
  1080.  during your show.  You may turn the mouse on or
  1081.  off any number of times during a presentation.
  1082. <
  1083. ;Mouse Off
  1084.  This command will make the mouse cursor invisible
  1085.  during your show.  You may turn the mouse on or
  1086.  off any number of times during a presentation.
  1087. <
  1088. ;Mouse At
  1089.  This command will locate the mouse cursor at a
  1090.  desired pixel column and row.  The syntax is:
  1091.  
  1092.                 Mouse At [x,y]
  1093.  
  1094.  where x and y are the pixel column and row
  1095.  locations.
  1096. <
  1097. ;MouseIn
  1098.  This is the command to create mouse input
  1099.  hot-spots on the screen.  The syntax is:
  1100.  
  1101.         MouseIn# [x1,y1,x2,y2 :label]
  1102.  
  1103.  where # is a number from 0 to 19 designating one
  1104.  of 20 possible mouse inputs.  x1 and y1 designate
  1105.  the upper left pixel column and row of the
  1106.  hot-spot area; x2 and y2 designate the lower right
  1107.  pixel column and row of the hot-spot area.  :label
  1108.  is the line label name to which the presentation
  1109.  branches if a user clicks on this hot-spot.
  1110. <
  1111. ;Mouse Cursor
  1112.  Choosing this menu option will pop-up a dialog box
  1113.  containing the names of the nine different mouse
  1114.  cursor's.  Highlight the desired name and press
  1115.  Enter.  The syntax is:
  1116.  
  1117.         Mouse Cursor [name,color#]
  1118.  
  1119.  where name is the cursor type and color# is the
  1120.  color in which the cursor will appear.
  1121. <
  1122.