home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 18 / CD_ASCQ_18_111294_W.iso / dos / graphic / datashow / manual.txt < prev    next >
Text File  |  1994-11-01  |  247KB  |  9,185 lines
  1.     
  2.     
  3.     ///////   ///  ///  ///////     ///////    //////   ///////   //////
  4.     //    //  // // //  //    //    //    //  //    //    //     //    //
  5.     ////////  // // //  ///////     //    //  ////////    //     ////////
  6.     //  //    // // //  //          //    //  //    //    //     //    //
  7.     //   //   //    //  //          ///////   //    //    //     //    //
  8.     
  9.     
  10.     Proudly Presents:
  11.     
  12.     
  13.     ///////    //////   ///////   //////    ///////  //    //  ///////  //  //  //
  14.     //    //  //    //    //     //    //  //        //    //  //   //  //  //  //
  15.     //    //  ////////    //     ////////  ////////  ////////  //   //  //  //  //
  16.     //    //  //    //    //     //    //        //  //    //  //   //   // // // 
  17.     ///////   //    //    //     //    //  ///////   //    //  ///////    //////  
  18.     
  19.     
  20.     Manual for DataShow, Version 5.0A As of: Nov. 1st. 1994
  21.     
  22.     All rights reserved.
  23.     
  24.     
  25.     ┌───┐    ┌─┬─┐         ┌───┐
  26.     ├─┬─┘    │ │ │         ├───┘
  27.     │ │ ene  │   │ ichael  │ lambek
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                               --- Page: 1 ---                               
  54.  
  55.     Copyright (c) 1990-94 by: RMP DATA.
  56.  
  57.     CHAPTER: 1, Help on Help
  58.     ──────────────────────────────────────────────────────────────────────
  59.     
  60.     
  61.     ▄ Help on Help
  62.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  63.     The HELP system you are now looking at is made  as a complete
  64.     online manual. Every aspect of DataShow is covered.
  65.     
  66.     The online HELP system therefore - somewhat - eliminates  the
  67.     need for a written manual.  A fully textbased manual  is how-
  68.     ever available  upon registration  of DataShow.  Actually the
  69.     online manual is formattet into a text file that can be prin-
  70.     ted to a printer of your choise.
  71.     
  72.     
  73.     This Help on Help section is divided into these three topics:
  74.     
  75.              1.  Keys to use in DataShow
  76.              2.  How to navigate in the help menus
  77.              3.  How to interpret the command syntax
  78.     
  79.     Please do read this manual as you normally would read one ...
  80.     
  81.     Time spent reading this  online manual now  will come back to
  82.     you again many times when you start using DataShow.
  83.     
  84.     
  85.     1. Keys to use in DataShow.
  86.     -------------------------------------------------------------
  87.     A  brief  description of keys that are used in various menus
  88.     is shown here below.   In general you can get around in Data-
  89.     Show with the use of a few keys. <Enter>, <Esc>, the function
  90.     keys <F1> through <F10>, and the arrow keys are what you need
  91.     most of the time.  To answer some questions or fill in infor-
  92.     mation you use the ordinary letters on your keyboard.  If se-
  93.     lections are shown on the screen  you can usually set them by
  94.     tapping the + or - keys.
  95.     
  96.     
  97.     A brief description of the most commonly used keys is this:
  98.     
  99.     <Enter>   Accepts data that is entered.
  100.     
  101.     <Esc>     Jump back one step without performing an operation.
  102.     
  103.     <F1>      In most places this will bring up a help message.
  104.     
  105.     <F10>     Usually has the same function as the <Esc> key.  It
  106.               takes you one step back.
  107.  
  108.  
  109.                               --- Page: 2 ---                               
  110.  
  111.     Chapter 1  : Help on Help, Copyright (c) 1990-94 by: RMP DATA.
  112.  
  113.     
  114.     
  115.     Also in most places  you can use  a mouse.  In these places a
  116.     mouse cursor  is shown as a full box in red or an arrow.
  117.     
  118.     Use the mouse to select  from the main menu,  to move between
  119.     commands in  the Script Center  (after selecting the F9 key),
  120.     to select and scroll between help pages (F1 key) or to select
  121.     a specific file  (F2 key).  Finally you can use  the mouse in
  122.     the Draw Center (graphics mode) to assist you  in making your
  123.     drawings.
  124.     
  125.     
  126.     2. How to navigate in the HELP menus.
  127.     -------------------------------------------------------------
  128.     
  129.              <F1>     Gives you an index of topics
  130.              <Esc>    Brings you out of the help menus
  131.              <DnKey>  Highlights next topic in list
  132.              <UpKey>  Highlights previous topic in list
  133.              <Enter>  Select topic from list
  134.              <PgDn>   Next screen (if applicable)
  135.              <PgUp>   Previous screen (if applicable)
  136.     
  137.     Also within a HELP menu,  there may be  "hot-links"  to other
  138.     topics. You simply use the arrow keys to move the highlighted
  139.     topic, and then press <Enter>.
  140.     
  141.     Finally the <Alt> key pushed in combination with the <F1> key
  142.     brings you back to the most recently used help menu.
  143.     
  144.     If DataShow finds that a mouse driver is loaded,  you can use
  145.     the mouse to select  between help pages.  Use the left button
  146.     to select, right button to quit  or both buttons to go to the
  147.     help index.
  148.     
  149.     
  150.     3. How to interpret the command syntax.
  151.     -------------------------------------------------------------
  152.     The explanations  given on  various commands  follow a simple
  153.     syntax, called the BNF syntax. These are the rules:
  154.     
  155.     A.  Words that are written  in capital letters  are commands,
  156.     that are supposed to be written exactly as they are shown.
  157.     
  158.                           SCREEN CLEAR
  159.     
  160.     Is thus a command,  and must be spelled the exact same way in
  161.     a script.
  162.     
  163.  
  164.  
  165.                               --- Page: 3 ---                               
  166.  
  167.     Chapter 1  : Help on Help, Copyright (c) 1990-94 by: RMP DATA.
  168.  
  169.     B.  A vertical separator  between two commands  mean that you
  170.     can choose from either of the two (or more) in the list.
  171.     
  172.                       SET CURSOR  ON | OFF
  173.     
  174.     After you have written the command you must give a parameter.
  175.     The parameter can here be either ON or OFF, but not both.
  176.     
  177.     Example of a valid command:
  178.     
  179.                          SET CURSOR OFF
  180.     
  181.     C.  Words written in square brackets can be omitted  from the
  182.     command. You can write a command with or without parameters.
  183.     
  184.                   WAIT [<seconds> | "<text>"]
  185.     
  186.     Here you can  issue the command  with or without  parameters,
  187.     and if you use a parameter  you can choose between two in the
  188.     example shown above.
  189.     
  190.     Example of a valid command:
  191.     
  192.                            WAIT
  193.     
  194.     D.  Words written in small letters within <> signs, are to be
  195.     replaced by you with something in the appropriate format.
  196.     
  197.                   WAIT [<seconds> | "<text>"]
  198.     
  199.     If you choose the first parameter here, you must enter a num-
  200.     ber that tells  the number of seconds to wait.  If you choose
  201.     the other parameter, you simply type in a text of you own.
  202.     
  203.     Example of valid commands with specific information inserted:
  204.     
  205.                          WAIT 5
  206.                          WAIT "Push any key"
  207.     
  208.     
  209.     In general it should be fairly easy to write commands after a
  210.     syntax and a description has been read.  As a further help an
  211.     example is shown with each command.  Also you can have a look
  212.     at the example script files that are provided with DataShow.
  213.     
  214.     Finally (and this goes  with the help system  as well as with
  215.     the  command  syntax),  you are encouraged  to "play" around.
  216.     Playing around with the program is often a good way  to learn
  217.     all the many features.
  218.     
  219.  
  220.  
  221.                               --- Page: 4 ---                               
  222.  
  223.     Chapter 1  : Help on Help, Copyright (c) 1990-94 by: RMP DATA.
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                               --- Page: 5 ---                               
  278.  
  279.     Chapter 1  : Help on Help, Copyright (c) 1990-94 by: RMP DATA.
  280.  
  281.     CHAPTER: 2, About DataShow
  282.     ──────────────────────────────────────────────────────────────────────
  283.     
  284.     
  285.     ▄ About DataShow
  286.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  287.     On the following pages DataShow will be described. The topics
  288.     follow this order.
  289.     
  290.     1. Short introduction to DataShow and RMP Data
  291.     2. Warranty
  292.     3. Files to be used and some technical information
  293.     4. List of released versions
  294.     5. List of enhancements under consideration
  295.     
  296.     1. Short introduction to DataShow and RMP Data
  297.     -------------------------------------------------------------
  298.     
  299.     1.1 Short introduction to DataShow.
  300.     
  301.     DataShow is a program in which you can make beautiful presen-
  302.     tations.  You can  show screens  from other programs,  design
  303.     your own screens, draw, and choose if texts should be written
  304.     fast or slow. Screens and texts can continue to show forever.
  305.     DataShow gives you a hole range of choices  to select colors,
  306.     and sizes of words written on the screen. Eg. create your own
  307.     logo and show it on the screen or use DataShow to demonstrate
  308.     the products you are selling in your company. DataShow is the
  309.     best tool to make presentations in.  Also with DataShow there
  310.     comes a lot of interesting tutorial scriptfiles, that you can
  311.     easily run from the main menu. They will give you a good idea
  312.     about how to make scripts, so you can get a good start.
  313.     
  314.     
  315.     1. Short introduction to DataShow and RMP Data
  316.     -------------------------------------------------------------
  317.     
  318.     1.2 Short introduction to RMP Data.
  319.     
  320.     As you have or will discover when you look at the topic after
  321.     this (warranty),  the programmer would like you to contribute
  322.     to further development.
  323.     
  324.     Further developments could be:
  325.     
  326.               1) improved graphics,
  327.               2) improved set of commands,
  328.               3) games generator,
  329.               4) inclusion of artificial intelligence facilities,
  330.               5) picture scanning...
  331.  
  332.  
  333.                               --- Page: 6 ---                               
  334.  
  335.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  336.  
  337.     
  338.     You can contribute!
  339.     
  340.     DataShow is developed in Borland Pascal v. 7.0 (tm),  and you
  341.     can contribute with both money and wisdom.  Since RMP Data is
  342.     made up of only one person as of February 1994, contributions
  343.     are welcome.
  344.     
  345.     Master of Science degree  in Business Administration and Com-
  346.     puter Science, Rene Michael Plambek, Copenhagen, Denmark.
  347.     
  348.     Also I have a lot  of product ideas.  My specialty is strate-
  349.     gic information systems, object oriented methods, and the in-
  350.     tegration of business administration principles,  - What ever
  351.     is needed  to run a professional EDP department.   Already on
  352.     the drawing board are programs to address these problems: Ma-
  353.     nagement of a sales force, which can be aggregated to involve
  354.     personnel management and financial management for businesses.
  355.     DataShow  can  (and will)  be used to promote these products.
  356.     
  357.     DataShow makes it very easy and fast to make  DEMO  PROGRAMS.
  358.     
  359.     DataShow can only be enhanced through your support...
  360.     
  361.     So contribute now!
  362.     
  363.     
  364.     1. Short introduction to DataShow and RMP Data
  365.     -------------------------------------------------------------
  366.     
  367.     1.3 DataShow fact sheet:
  368.     
  369.     All Programming by.................: Rene Michael Plambek
  370.     All Support programs by............: Rene Michael Plambek
  371.     All English documentation by.......: Rene Michael Plambek
  372.     All rights reserved by.............: Rene Michael Plambek
  373.     
  374.     
  375.     2. Warranty
  376.     -------------------------------------------------------------
  377.     DataShow is a product that is offered as shareware and as is.
  378.     
  379.     Though the best and most serious  efforts  have been  made to
  380.     secure the product, it is impossible to give a guarantee that
  381.     DataShow will work to your full satisfaction. But even though
  382.     we cannot be held responsible for loss of data  or other pro-
  383.     blems or errors on your computers, we would like to hear your
  384.     comments.  Your comments can be  forwarded to the address be-
  385.     low and you can also forward US$59, in Bank Cheque, for regi-
  386.     stration bonuses (this applies  under the shareware rules  if
  387.  
  388.  
  389.                               --- Page: 7 ---                               
  390.  
  391.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  392.  
  393.     you keep DataShow for more than ONE MONTH TRIAL PERIOD). Read
  394.     the enclosed INFO.TXT file for information on registration.
  395.     
  396.     RMP Data can currently be reached at this address:
  397.     
  398.                    ┌───┐    ┌─┬─┐         ┌───┐
  399.                    ├─┬─┘    │ │ │         ├───┘
  400.                    │ │ ene  │   │ ichael  │ lambek
  401.                    Victor Bendix Gade 1, 2. th.
  402.                    2100 Copenhagen Oe., Denmark
  403.     
  404.     3. Files to be used and some technical information
  405.     -------------------------------------------------------------
  406.     Files to expect on disk (and used by DataShow) are:
  407.     
  408.       SHOW    .EXE   Main file to create and run scripts with. It
  409.                      uses approximately 350 Kb. on disk and about
  410.                      400 Kb. of RAM when active.  The graphic li-
  411.                      brary takes up  approximately 80 Kb. of this
  412.                      space on disk and at runtime.  And the voice
  413.                      capabilities uses around 20 Kb.
  414.     
  415.       SHOW    .HLP   Help file associated with main program file.
  416.     
  417.       CAPTURE .EXE   Makes it possible  to  capture screens  from
  418.                      programs,  so they can be shown in DataShow.
  419.                      It uses approximately 40 Kb.  on  disk,  and
  420.                      about 50 Kb. of RAM when resident.
  421.     
  422.       *       .SHW   Suggested name for script files  so they can
  423.                      be separated from other files.
  424.     
  425.       *       .SCR   Suggested name  for text screens  saved with
  426.                      the  Capture Utility program,  or  from  the
  427.                      Text Center.
  428.     
  429.       *       .SLD   Is what we suggest you call slide files made
  430.                      from DataShow. See SHOW SLIDE
  431.     
  432.       *       .GRA   This is what we  suggest  you  call  graphic
  433.                      files created from DataShow.
  434.     
  435.       *       .PCX   Files in the PCX format that DataShow reads.
  436.     
  437.       *       .GIF   Files in the GIF format that DataShow reads.
  438.     
  439.       *       .SND   This is what we suggest you call music files
  440.                      so they can be separated from other files.
  441.     
  442.       *       .WAV   Files in the WAV music format  that DataShow
  443.  
  444.  
  445.                               --- Page: 8 ---                               
  446.  
  447.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  448.  
  449.                      can play.
  450.     
  451.     Also  there is a registration package,  which also includes a
  452.     lot of files, that isn't included in the unregistered version. these files:
  453.     
  454.       SHOWDOC .TXT   Documentation  (manual)  for DataShow  in an
  455.                      ASCII (plain text) file,  so it can be prin-
  456.                      ted on a printer.
  457.     
  458.       SHOWRUN .EXE   A runtime version of DataShow. Appr. 200 KB.
  459.                      on disk and 220 KB  when running.  This run-
  460.                      time version  can be freely distributed once
  461.                      you have registered. It makes it possible to
  462.                      run tokenized scripts (MAIN MENU F2 key).
  463.     
  464.                      The runtime version is a version without all
  465.                      the menues of the integrated environment. It
  466.                      is smaller  and executes  tokenized  scripts
  467.                      faster.
  468.     
  469.       SHOWUTIL.EXE   A program where you can  create music  files
  470.                      from Pianoman v. 4,  or you can enter notes,
  471.                      octaves,  and durations to make music files.
  472.                      Also you can view PCX/GIF graphics files.
  473.     
  474.       *       .SND   More music files for your DataShow  scripts.
  475.                      For more info; see MUSIC PROCESS.
  476.     
  477.       *       .WAV   More music files for your DataShow  scripts.
  478.                      For more info; see MUSIC PROCESS.
  479.     
  480.       *       .PCX   More graph files for your DataShow  scripts.
  481.                      For more info; see SHOW SCREEN.
  482.     
  483.     You receive the registration package, together with a version
  484.     of DataShow  (the integrated environment)  that has a correct
  485.     serial number, when you register.
  486.     
  487.     4. List of released versions
  488.     -------------------------------------------------------------
  489.     Here is a complete list of versions released.  With each ver-
  490.     sion the details on changes are shown.  Here the most updated
  491.     news can always be found about new features  and enhancements
  492.     of DataShow.
  493.     
  494.     Version 1.0A  (1. May. 1990),  Version 1.1A  (1. Jun. 1990):
  495.     ------------------------------------------------------------
  496.     First test version not fully featured,  released to a few Da-
  497.     nish software companies.  Intended as promotion only.  Then a
  498.     full featured version  with many commands included,  released
  499.  
  500.  
  501.                               --- Page: 9 ---                               
  502.  
  503.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  504.  
  505.     as SHAREWARE.
  506.     
  507.     Version 1.2A  (1. Oct. 1990),  Version 1.2B  (1. Dec. 1990):
  508.     ------------------------------------------------------------
  509.     Commands has been corrected and improved.  Also some restruc-
  510.     turing of screens.  Menus not fully implemented  in prior re-
  511.     leases has been further developed.
  512.     
  513.     Version 1.5A  (1. Apr. 1991),  Version 1.5B  (1. Jun. 1991):
  514.     ------------------------------------------------------------
  515.     Several command extensions has been added,  and some new com-
  516.     mands has arrived.  Some mouse support has been added.
  517.     
  518.     Version 2.0A  (1. Aug. 1991):
  519.     -----------------------------
  520.     Improved user interface  and restructuring  of screens.  Com-
  521.     mands has been altered somewhat,  and now many commands  work
  522.     in graphics mode as well.
  523.     
  524.     Much improved graphic capabilities from inside DataShow. That
  525.     means improved looks on designs. Also now it is possible  for
  526.     you to switch into  graphics mode with the SET command.  Some
  527.     commands (the ON/OFF ones) in  prior releases,  has now got a
  528.     SET in front of them.
  529.     
  530.       SET           Command has been added (new command)
  531.       SET GRAPHICS  Now it is possible to make graphic scripts
  532.     
  533.     Version 2.5A  (1. Mar. 1992):
  534.     -----------------------------
  535.     As you can see it has taken quite a while to get from 2.0A to
  536.     2.5A - 8 month, longer than any other version before. I'm ex-
  537.     cited that so many things has been changed and improved - but
  538.     unfortunately  not all of the features  I had anticipated for
  539.     this version made it. The wait would then have been even more
  540.     unbearable.
  541.     
  542.     More work  on user interface  and more graphic commands.  The
  543.     mouse is now  supported  in almost  every menu  and screen in
  544.     DataShow.
  545.     
  546.       GRAPHICS      Command has been incorporated in SHOWSCREEN
  547.       SHOWSCREEN    Command has been changed to include graphics
  548.       SET ESCAPE    Command has been changed (see SET ESCAPEKEY)
  549.       SET SHADOW    Writing in graphics can now have shadows
  550.       EFFECT        New special effects command has been added
  551.       COLOR         Command has incorporated 3 former commands
  552.       SOUND         Command has been incorporated in MUSIC
  553.     
  554.     Some other commands  has been enhanced and  some commands has
  555.  
  556.  
  557.                               --- Page: 10 ---                              
  558.  
  559.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  560.  
  561.     been incorporated into other commands.
  562.     
  563.     Version 3.0A  (1. Sep. 1992):
  564.     -----------------------------
  565.     It has taken 6 month from version 2.5 to version 3.0.  A fine
  566.     interval between versions. That gives RMP Data time to market
  567.     the new version,  and also time  to develop  a new and better
  568.     one.  But minor releases  might  be necessary  if  registered
  569.     users find errors and/or have good ideas to be implemented.
  570.     
  571.     Much improved graphics capabilities,  and several command ad-
  572.     ditions and enhancements.
  573.     
  574.       READ          Command has been added (new command)
  575.       MATH          Command has been added (new command)
  576.       VARIABLE      Command has been enhanced (more types)
  577.       SHOWSCREEN    Command has been enhanced (more graph modes)
  578.     
  579.     Here's a list of features that are included in version 3.0A:
  580.     
  581.     - Enhancements of the Graphics Center (draw with the mouse).
  582.     - More variable types and math functions (school scripts).
  583.     
  584.     More work has been done on the command language. Now the lan-
  585.     guage is more coherent,  and the ongoing restructuring should
  586.     now be finished.
  587.     
  588.     Version 3.5A  (1. Feb. 1993):
  589.     -----------------------------
  590.     Minor enhancements has been made  to some registered users on
  591.     the way  to a  more general available  new  release.  So some
  592.     registered versions 3.xx have been sent out with CGA graphics
  593.     capability restored due to customer demands.
  594.     
  595.     Some enhancements in graphics parts.  Also a bunch of new ex-
  596.     citing  commands has  been added.  A very major  new  release
  597.     (you'll see).
  598.     
  599.       MUSIC         Command has been enhanced (Now WAV files)
  600.       VARIABLE      Command has been enhanced (LOAD/SAVE)
  601.       SHOW SCREEN   Command has been renamed (SHOWSCREEN)
  602.       SHOW SLIDE    Command has been added (new command)
  603.       IF            Command has been enhanced (operators)
  604.     
  605.     Here's a list of features that are included in version 3.5A:
  606.     
  607.     - Enhanced PCX viewing (more graph modes supported).
  608.     - A new menu for making slides (see the SHOW SLIDE command).
  609.     
  610.     Version 3.8A  (1. Mar. 1993):
  611.  
  612.  
  613.                               --- Page: 11 ---                              
  614.  
  615.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  616.  
  617.     -----------------------------
  618.     A small error in  an example script (uh) was found in version
  619.     3.5A.  This is why a new release is sent out so early.  But a
  620.     new facility set is also included:
  621.     
  622.     - Tokenizing of scripts (better execution and distribution).
  623.       (see the MAIN MENU under F2 key for description).
  624.     
  625.     - Much enhanced possibilities for graphic modes.
  626.       (Now CGA, MCGA, EGA, VGA and SVGA are supported).
  627.     
  628.     - Enhanced GIF viewing (more graph modes supported).
  629.     
  630.     Version 4.0A  (1. Dec. 1993):
  631.     -----------------------------
  632.     Small errors corrected (eg. there was an error  in tokenizing
  633.     scripts that had small letter commands, and it was impossible
  634.     to run scripts more than 15 times  from the IDE before it ran
  635.     out of file handles).
  636.     
  637.     Also some rework of main menu has been made  (in order to ac-
  638.     commodate  a new menu for creating charts).  Enhancements  to
  639.     the integrated environment include:
  640.     
  641.     - A totally new graphics Drawing Center.  The  Drawing Center
  642.       now supports many graphic modes and PCX file editing).
  643.     
  644.     - A brand new Chart Center for creating charts from different
  645.       numeric data supplied by the user. Charts can easily be in-
  646.       cluded into scripts.
  647.     
  648.     New commands include:
  649.     
  650.       MOUSE         Command has been added (new command)
  651.       INSTALL       Command has been added (new command)
  652.       SCREEN WIPE   Command has been added (new command)
  653.       CASE STRING   Command has been enhanced (UPPER key word)
  654.     
  655.     You can now support mouse movement and input in your scripts!
  656.     And you can install more fonts yourself.
  657.     
  658.     Version 4.2A  (1. Feb. 1994),  Version 4.3A  (1. Jun. 1994):
  659.     ------------------------------------------------------------
  660.     Some minor enhancements  like being able to print charts to a
  661.     printer. An error that occurred in tokenized scripts with the
  662.     graphics show screen command, has been corrected.
  663.     
  664.        SHOW SCREEN   Command has been enhanced (now support FLI)
  665.        INSTALL SOUND Command has been added (Adlib/SB support)
  666.     
  667.  
  668.  
  669.                               --- Page: 12 ---                              
  670.  
  671.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  672.  
  673.     Also a bit better drawing with mouse button down  in the Draw
  674.     Center, together with more draw functions.
  675.     
  676.     Many fixes and enhancements.  A lot is "under the hood" work,
  677.     but some you'll notice on the screen  in the integrated envi-
  678.     ronment and some in scripts.
  679.     
  680.     Version 5.0A  (1. Nov. 1994):
  681.     -----------------------------
  682.     The two most important features in this release is the abili-
  683.     ty to make sprites in the Animation Center  and faster script
  684.     execution.  Now DataShow also is better suited for making ga-
  685.     mes.
  686.     
  687.     New commands include:
  688.     
  689.       SPRITE         Command has been added (new command)
  690.       DRAW           Command has been enhanced (BAR parameter)
  691.     
  692.     
  693.     IN GENERAL
  694.     -----------------------------
  695.     RMP Data is committed to supporting DataShow.  Therefore  new
  696.     releases will be available.  But funds are vital, so register
  697.     now,  and you'll get  the most recent version  -  don't wait!
  698.     Free upgrade information  will then be mailed  to you,  every
  699.     time a new version is ready,  and you can decide  if you wish
  700.     to upgrade (for a minimal fee) or not...
  701.     
  702.     Also if there is an interest, Windows and OS/2 versions could
  703.     be developed.  Write RMP Data stating your interest for more
  704.     platforms.
  705.     
  706.     Together with  this help file  and SHOW.EXE you should find a
  707.     text  INFO.TXT  file.  This file states  how to register  and
  708.     receive  a version  with serial number  as well as a SHOWUTIL
  709.     package that includes a program to make sounds in,  more gra-
  710.     phics and sound files, and documentation in a form that makes
  711.     it easy for it to be printed on a printer.
  712.     
  713.     5. List of enhancements under consideration
  714.     -------------------------------------------------------------
  715.     Here is a list of known bugs,  as well as  new features  that
  716.     might be implemented in coming releases.  As stated above (in
  717.     subtopic 1.2) you the user can contribute.
  718.     
  719.     ERRATA:
  720.     1)   Some graphic capabilities, and a few of the commands are
  721.          still under the knife (being worked at that is). As sta-
  722.          ted in the list of commands  (see commands in help list)
  723.  
  724.  
  725.                               --- Page: 13 ---                              
  726.  
  727.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  728.  
  729.          each command is described separately also if it is still
  730.          under some sort of development.
  731.     
  732.     ENHANCEMENT POSSIBILITIES (if you people are interested):
  733.     1)   Graphics
  734.          - Better support for making games with DataShow.
  735.          - More special effects and graph modes.
  736.     2)   Sound
  737.          - More music formats and better speech capabilities.
  738.     3)   Processes
  739.          - A MUSIC process so music is playing in the background.
  740.          - It should be possible to have more than the MUSIC pro-
  741.            ces on while other commands are being run (threads).
  742.     4)   Variables
  743.          - The definition could be expanded to include more types
  744.            than those supported today (NUMBER & STRING).  For ex-
  745.            ample type like DATE and LOGIC could be added.
  746.     5)   Compiler
  747.          - By cloning scripts  into a  standard  runtime  module.
  748.     6)   Artificial intelligence
  749.          - Inclusion of a knowledge base as KNOWLEDGE <filename>.
  750.     
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.                               --- Page: 14 ---                              
  782.  
  783.     Chapter 2  : About DataShow, Copyright (c) 1990-94 by: RMP DATA.
  784.  
  785.     CHAPTER: 3, Capture utility
  786.     ──────────────────────────────────────────────────────────────────────
  787.     
  788.     
  789.     ▄ Capture utility
  790.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  791.     Together with this program,  a file called  "CAPTURE.EXE"  is
  792.     distributed.
  793.     
  794.     CAPTURE is a  resident program  (it is kept  in memory  while
  795.     other programs  are running),  that can  pop-up  while you're
  796.     running other text oriented programs.  It is then possible to
  797.     save to a file, the screen that is being shown.
  798.     
  799.     Later on in DataShow, you can SHOW the saved screen from your
  800.     own script.
  801.     
  802.     To start CAPTURE
  803.     ----------------
  804.     At the  Operating System  prompt (with no other programs run-
  805.     ning)  you type  CAPTURE.  A short message is then displayed,
  806.     and you can start capture on top of other programs by hitting
  807.     the keys <Ctrl> and <+>. The grey plus on the numeric keypad.
  808.     
  809.     Using CAPTURE in textmode
  810.     -------------------------
  811.     When activated, CAPTURE asks you for a filename.  This is the
  812.     name under which the screen will be saved.
  813.     
  814.     You can choose which format the current screen is to be saved
  815.     in.  By pressing <F5>  you can  select between  DataShow .SCR
  816.     format or ordinary .ASC format.  The .SCR format  you can use
  817.     from scripts, in order to show a screen from another program.
  818.     The .ASC format you can take  into any plain ascii  word pro-
  819.     cessor for further handling...
  820.     
  821.     Use the SHOW SCREEN command with the TXT extension  to show a
  822.     .SCR file from  a DataShow script  or use  the Text Center to
  823.     manipulate  it further.  If you have  a registered version of
  824.     DataShow you also have the program SHOWUTIL, in which you can
  825.     control .SCR and .ASC files.
  826.     
  827.     CAPTURE can also be unloaded  from memory.  By pressing <F10>
  828.     while in the filenameprompt in capture, and no other programs
  829.     are on top (no program is residing in memory after capture).
  830.     
  831.     Using CAPTURE in graphmode
  832.     --------------------------
  833.     NEW in CAPTURE is, that you can also save graphic screens! By
  834.     pressing the "hot-keys" <Ctrl> and <+>  you can save the gra-
  835.  
  836.  
  837.                               --- Page: 15 ---                              
  838.  
  839.     Chapter 3  : Capture utility, Copyright (c) 1990-94 by: RMP DATA.
  840.  
  841.     phic image to a PCX file. The Capture program gives the saved
  842.     PCX image a number (You will not be prompted for a filename).
  843.     The number starts with 1,  so that the first image saved will
  844.     be called PCX00001.PCX. If this number exists when you try to
  845.     save a new image the number will be increased. This will con-
  846.     tinue until you have 255 images in the same directory.
  847.     
  848.     If anything goes wrong in saving  a graphic image to disk you
  849.     will hear a bell sound.  Typically this happens if you try to
  850.     save an image  that CAPTURE  does not support.
  851.     
  852.     Graphic modes supported from CAPTURE are:
  853.     
  854.         CGA.......:  320x200x016
  855.         EGA, VGA..:  640x200x016, 640x350x016
  856.         VGA, +....:  640x480x016, 320x200x256
  857.     
  858.     Use the SHOW SCREEN command with the PCX extension  to show a
  859.     .PCX file  from a DataShow script.  If you have  a registered
  860.     version of DataShow  you also  have the program SHOWUTIL,  in
  861.     which you can look at and control .PCX files.
  862.     
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.                               --- Page: 16 ---                              
  894.  
  895.     Chapter 3  : Capture utility, Copyright (c) 1990-94 by: RMP DATA.
  896.  
  897.     CHAPTER: 4, The Main Menu
  898.     ──────────────────────────────────────────────────────────────────────
  899.     
  900.     
  901.     ▄ The Main Menu
  902.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  903.     In the Main Menu  you can select between  one of the function
  904.     keys F1-F10.  You simply press the desired key or if you have
  905.     a mouse installed,  you move the mouse to the desired area on
  906.     the screen  and push  the left mouse button.  Here is a short
  907.     description of each of the choices:
  908.     
  909.     <F1>   HELP: Brings you into the help menu. See Help on Help.
  910.     
  911.     <F2>   FILES:  Makes it possible  to run  a script  (program)
  912.            file. To choose a filename, look at topic File select.
  913.     
  914.            You are given four choices (called A-D here):
  915.     
  916.            A)  SCRIPT RUN FROM START:  By entering  the name of a
  917.            script file,  execution of that script  will begin  at
  918.            once.  The script will run from the first line  in the
  919.            script file.
  920.     
  921.            B)  SCRIPT RUN FROM LINE:  By entering  the name  of a
  922.            script file and then a line number, execution will be-
  923.            gin from that line. This makes it easier to debug your
  924.            scripts.
  925.     
  926.            C)  SCRIPT TOKENIZE:  A script  will be converted into
  927.            symbols  that are somewhat unreadable.  For registered
  928.            users it means that  they can distribute scripts  that
  929.            execute faster  and that aren't  too easy  to read and
  930.            change.  The typical  development lifecycle looks like
  931.            this:
  932.     
  933.               1) Develop and test your script from the DataShow
  934.               integrated environment.
  935.     
  936.               2) When your script is finished you tokenize it.
  937.     
  938.               3) Run the  tokenized script  with the runtime ver-
  939.               sion SHOWRUN.EXE  (you get it with the registration
  940.               package).  Distribute  the runtime version  and the
  941.               tokenized scripts  together  with all  your support
  942.               picture and sound files.
  943.     
  944.            Files that are tokenized  will have the extension .TOK
  945.            so they  can be separated  from other files.  For this
  946.            reason you should not use .TOK for text script names.
  947.  
  948.  
  949.                               --- Page: 17 ---                              
  950.  
  951.     Chapter 4  : The Main Menu, Copyright (c) 1990-94 by: RMP DATA.
  952.  
  953.     
  954.            Note that tokenized scripts  doesn't run faster in the
  955.            DataShow integrated environment.  Eg. jumps isn't fas-
  956.            ter,  due to the use  of overlays in the DataShow exe-
  957.            cutable.  The runtime version  that is supplied to re-
  958.            gistered users does not use internal overlays.  There-
  959.            fore scripts (with eg. jumps)  that are tokenized does
  960.            run considerably faster in the runtime version.
  961.     
  962.            D) MORE FILES:  Gives you a small menu. From this menu
  963.            you can choose one of the following (called D1-D4):
  964.     
  965.            D1) Directory:  Makes it possible to see the directory
  966.            that you specify. Enter a full path, and use wildcards
  967.            as desired. Use the mouse to scroll between filenames.
  968.     
  969.            Note:  If you select  a file  with the <Enter> key  or
  970.            left mouse button,  you'll see the file in a text file
  971.            browser. Use arrow keys to scroll through the file.
  972.     
  973.            D2) Change Dir:  Enter a directory name,  and that di-
  974.            rectory becomes the current. Eg. you can have  one set
  975.            of script files and screens in one directory,  and an-
  976.            other set of scripts in another directory.
  977.     
  978.            D3) Operating System: You can enter the operating sys-
  979.            tem, and at the prompt, you can enter the commands you
  980.            wish. Type EXIT to return to DataShow.
  981.     
  982.            D4) Info: brief description of the text files that co-
  983.            mes with DataShow. See Info.
  984.     
  985.     <F3>   SCRIPT:  Brings you into the Script Center. From there
  986.            you  can design  your own scripts  in an  easy manner.
  987.            Scripts can be run with the Main Menu F2 key.
  988.     
  989.     <F4>   DRAW:  Brings you into the Draw Center. From there you
  990.            can make graphic drawings  and write texts to be shown
  991.            on screen from script files.  The command you need  to
  992.            issue from script files can be seen under SHOW SCREEN.
  993.     
  994.     <F5>   TEXT:  Brings you into the Text Center. From there you
  995.            can design  text mode  screens.  Screens can be saved,
  996.            and then shown from DataShow with the SHOW SCREEN com-
  997.            mand.  Screens are saved  in the same format  that the
  998.            Capture Utility files  are.  So  you  can  edit  those
  999.            screens that has been captured from other programs, or
  1000.            just simply add other colors or texts to the screens.
  1001.     
  1002.     <F6>   SLIDE:  Brings you into the Slide Center. In the Slide
  1003.  
  1004.  
  1005.                               --- Page: 18 ---                              
  1006.  
  1007.     Chapter 4  : The Main Menu, Copyright (c) 1990-94 by: RMP DATA.
  1008.  
  1009.            Center you can easily create forms that can be run via
  1010.            the SHOW SLIDE command in a script.  A slide de-
  1011.            finition form cannot be run as a stand alone file, but
  1012.            needs the mentioned script command.
  1013.     
  1014.     <F7>   GRAPH:  Gives you a menu, where you can choose between
  1015.            the Animation Center or the Chart Center.  In the Ani-
  1016.            mation Center you can easily make sprites, that can be
  1017.            moved around the screen  with the SPRITE command.  And
  1018.            in the Chart Center  you can easily  make charts  that
  1019.            can be run via the SHOW CHART command in a script.
  1020.     
  1021.     <F8>   PRINT:  Brings you into the Printer Center. From there
  1022.            you can print scripts to a printer.  Since scripts are
  1023.            actually just plain ascii files, you can print out ot-
  1024.            her  ascii documents  also.  For example you can print
  1025.            the INFO.TXT file  with registration information or if
  1026.            you have the registered version  you can print out the
  1027.            SHOWDOC.TXT file (the manual).
  1028.     
  1029.            You can also print SLD files  for slide definition in-
  1030.            formation,  as well as  graphics GRA, PCX and GIF type
  1031.            files to the printer.
  1032.     
  1033.            You  select between options  by using the cursor keys,
  1034.            and you  use  the <+> or <-> keys  to change  the set-
  1035.            tings.  Once you have made your selections, you  go to
  1036.            the "start print" location and hit <+>.
  1037.     
  1038.            See topic Printer Center for more information.
  1039.     
  1040.     <F9>   SETUP:  This window  gives you two kinds  of features.
  1041.     
  1042.            On the first part of the window a STATUS is shown.  An
  1043.            overview of the PC  that tells you  how much memory is
  1044.            available, etc.
  1045.     
  1046.            On the  second part of the window  you can set up  how
  1047.            DataShow will act.
  1048.     
  1049.            Use the keys specified in the window,  and set either
  1050.            of the following:
  1051.     
  1052.                   - Which key that can interrupt a script.
  1053.                   - If a beep should be sound upon errors.
  1054.                   - If windows should have "explode effect".
  1055.                   - Graphic mode in Draw Center (CGA, EGA, VGA).
  1056.     
  1057.     <F10>  EXIT:  To exit DataShow.
  1058.     
  1059.  
  1060.  
  1061.                               --- Page: 19 ---                              
  1062.  
  1063.     Chapter 4  : The Main Menu, Copyright (c) 1990-94 by: RMP DATA.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.                               --- Page: 20 ---                              
  1118.  
  1119.     Chapter 4  : The Main Menu, Copyright (c) 1990-94 by: RMP DATA.
  1120.  
  1121.     CHAPTER: 5, The Script Center
  1122.     ──────────────────────────────────────────────────────────────────────
  1123.     
  1124.     
  1125.     ▄ The Script Center
  1126.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1127.     In the Script Center,   you can design your own scripts (pro-
  1128.     grams) easily.  An editor is shown on the screen,  and if you
  1129.     press <F9> you can  choose between all the available commands
  1130.     in an easy fashion.
  1131.     
  1132.     The script editor  can have a total of 500 lines,  each at 80
  1133.     characters in length. The total maximum length  for a file is
  1134.     40.000 bytes. For longer files  it is suggested, that you se-
  1135.     parate them into  smaller modules,  or alternatively  you can
  1136.     use any ASCII editor.  The DataShow script center is  however
  1137.     (as you'll see) designed especially for the purpose of making
  1138.     DataShow scripts.
  1139.     
  1140.     The status line contains  the current line number and the to-
  1141.     tal number of lines  in the left corner.  In the right corner
  1142.     a filename is shown,  when a file is loaded or  a new file is
  1143.     named. A star (*) appears when a change is made in the editor
  1144.     and you'll be asked to confirm when you leave the script cen-
  1145.     ter. If no star is shown in front of the filename,  you leave
  1146.     the script center imidiately when you push F10.
  1147.     
  1148.     These keys are appropriate in the DataShow Script Center:
  1149.     
  1150.     <Any-key> By pushing  any of the  alfa-numeric keys  you will
  1151.               start typing a line to be inserted at that specific
  1152.               location in the script.  Eg.  use the  <Space>  key
  1153.               each time  you wish to alter an existing line or to
  1154.               enter a completely new line.
  1155.     
  1156.     <Up-key>  If you're not at the first line in the editor, this
  1157.               key will bring you up one line.
  1158.     
  1159.     <Dn-key>  If you're not at the last line in the editor,  this
  1160.               key will bring you down one line.
  1161.     
  1162.     <Home>    Brings you to the first line in the editor.
  1163.     
  1164.     <End>     Brings you to the last line in the editor.
  1165.     
  1166.     <PgUp>    Brings you fast to the prior screen in the script.
  1167.     
  1168.     <PgDn>    Brings you fast to the next screen in the script.
  1169.     
  1170.     <Enter>   If you're on the last line of the editor,  this key
  1171.  
  1172.  
  1173.                               --- Page: 21 ---                              
  1174.  
  1175.     Chapter 5  : The Script Center, Copyright (c) 1990-94 by: RMP DATA.
  1176.  
  1177.               will  let  you fill in more lines at  the bottom of
  1178.               the script. Otherwise it works like the <Dn-key>.
  1179.     
  1180.     <F1>      HELP:  Gives you this helpscreen. From here you can
  1181.               select further help (eg. help on commands).
  1182.     
  1183.     <F2>      FILES:  From here, you can choose to either load or
  1184.               save a file.  The small menu gives access to either
  1185.               of the following.
  1186.     
  1187.               A) Load:  You're prompted for a file name (script).
  1188.               It has to be a normal ASCII-file,  and a legal ope-
  1189.               rating system name.  If the file exists in the cur-
  1190.               rent directory  or  if the filename includes a full
  1191.               path,  it is loaded into  the editor  to be further
  1192.               manipulated there.
  1193.     
  1194.               B) Save:  You're prompted for a file name (script).
  1195.               It has to be a normal ASCII-file,  and a legal ope-
  1196.               rating system name.  If the file exists in the cur-
  1197.               rent directory, you're warned that it will be over-
  1198.               written if you answer Y for yes.  You are  instruc-
  1199.               ting DataShow to save the file from the editor.
  1200.     
  1201.               To choose a filename see also topic File select.
  1202.     
  1203.               C) More:  Here you are presented with the same menu
  1204.               as is the case in the Main Menu, when you press the
  1205.               <F2> key. You can choose to display a directory, to
  1206.               change the current directory or to go to the opera-
  1207.               ting system.
  1208.     
  1209.     <F3>      CLEAR: Makes it possible to erase the entire script
  1210.               you are working on  in the  Script Center.  This is
  1211.               useful if you wish to start on a new script.
  1212.     
  1213.     <F4>      BLOCK:  You are given  a small menu to select from.
  1214.               These are the choices.
  1215.     
  1216.               A) Mark: You start by setting a mark on a line. You
  1217.               can then browse between the lines in the editor and
  1218.               when you choose  mark  again,  you set an end mark.
  1219.               The lines between and  including the two marked li-
  1220.               nes are  copied into  a clipboard.  You can at most
  1221.               mark 10 lines at a time.
  1222.     
  1223.               B) Unmark: Before you wish to mark a new block, you
  1224.               must first unmark any block that has previously be-
  1225.               en copied to the clipboard.
  1226.     
  1227.  
  1228.  
  1229.                               --- Page: 22 ---                              
  1230.  
  1231.     Chapter 5  : The Script Center, Copyright (c) 1990-94 by: RMP DATA.
  1232.  
  1233.               C) Paste:  If the clipboard is not empty (that is a
  1234.               block is marked), the content of the clipboard will
  1235.               be inserted at the current line.
  1236.     
  1237.               D) Status: Here you can see the status of the clip-
  1238.               board.  Eg. if any block  is currently marked,  and
  1239.               the number of lines in the clipboard.
  1240.     
  1241.     <F5>      PLACE:  This small menu gives you a chance to go to
  1242.               a line quickly in two ways.
  1243.     
  1244.               A) Line: You'll be prompted for a line number. When
  1245.               a number is entered  you'll be placed at that line,
  1246.               if it is possible.
  1247.     
  1248.               B) Search:  You can enter a string, and a search is
  1249.               started from the current line  for an occurrence of
  1250.               the string. Note that the search is case sensitive.
  1251.     
  1252.     <F6>      INSERT: A line is inserted at the current location.
  1253.               All other lines beneath  are moved  one line  down,
  1254.               and thus the total number of lines is increased.
  1255.     
  1256.     <F7>      DELETE:  A line is deleted at the current location.
  1257.               All other lines beneath are moved one line up,  and
  1258.               thus the total number of lines is decreased.
  1259.     
  1260.     <F8>      EDIT:  The current line is displayed in a box,  and
  1261.               you can then edit it as you like. When you push the
  1262.               <Enter> key the changes are recorded.
  1263.     
  1264.     <F9>      COMMAND:  You get a list  of all the available com-
  1265.               mands to select from.  Use  the arrow keys  to move
  1266.               the highlighted field and push <Enter> to select an
  1267.               appropriate command. By typing a character you ini-
  1268.               tiate a search for a command  that begins with that
  1269.               letter.  Then type a second character  for the next
  1270.               letter in the command. You can also use the <PgUp>,
  1271.               <PgDn>, <Home>,  and <End> keys  to position you at
  1272.               the command  you wish to select.  You will then  be
  1273.               prompted for more parameters as necessary.  You can
  1274.               also use a mouse  to select between commands. If F1
  1275.               is pushed while the commands are listed in the win-
  1276.               dow,  you get specific help about  the current com-
  1277.               mand.
  1278.     
  1279.     <F10>     EXIT: Let you return to the main menu.  Remember to
  1280.               save the script you're working on.  Since  DataShow
  1281.               reads  a script from the disk when you  wish to run
  1282.               it,  the file you just entered or altered must have
  1283.  
  1284.  
  1285.                               --- Page: 23 ---                              
  1286.  
  1287.     Chapter 5  : The Script Center, Copyright (c) 1990-94 by: RMP DATA.
  1288.  
  1289.               been saved  before it is to be run,  reflecting any
  1290.               of the changes.
  1291.     
  1292.     The file that is created from the Script Center is an ordina-
  1293.     ry ASCII-file. And this is what DataShow reads, when you want
  1294.     to run a script. You may thus use any editor you wish to cre-
  1295.     ate scripts. The Script Center however is especially designed
  1296.     for you to create scripts for DataShow fast and easily.
  1297.     
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.                               --- Page: 24 ---                              
  1342.  
  1343.     Chapter 5  : The Script Center, Copyright (c) 1990-94 by: RMP DATA.
  1344.  
  1345.     CHAPTER: 6, The Draw Center
  1346.     ──────────────────────────────────────────────────────────────────────
  1347.     
  1348.     
  1349.     ▄ The Draw Center
  1350.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1351.     In the Draw Center,  you can draw you own pictures,  that can
  1352.     be shown on the screen from a script file.  You can draw when
  1353.     you have entered the Draw Screen.
  1354.     
  1355.     You enter the Draw Screen by pressing <F4> from the Draw Cen-
  1356.     ter.  And then you can draw  by moving around  with the arrow
  1357.     keys, and  7,  9,  1,  3 on the numeric keyboard (remember to
  1358.     turn off "Num Lock").  After the description of the keys that
  1359.     can be used in the Draw Center,  the mouse and keyboard func-
  1360.     tions of the Draw Screen is described in detail.
  1361.     
  1362.     First the Draw Center keys:
  1363.     ---------------------------
  1364.     The keys listed below here generally do  -not- work the exact
  1365.     same way, when you're in the Draw Screen (editor).  You enter
  1366.     the Draw Screen (editor) with the <F4> key).  These keys thus
  1367.     only pertain to the DataShow Draw Center menu.
  1368.     
  1369.     <F1>      HELP:  Gives you this helpscreen. From here you can
  1370.               select further help (eg. help on drawing).
  1371.     
  1372.     <F2>      FILES:  From here, you can choose to either load or
  1373.               save a file.  The small menu gives access to either
  1374.               of the following.
  1375.     
  1376.               A) Load:  You are prompted for a file name (graph).
  1377.               It has to be a special graphfile,  and a legal ope-
  1378.               rating system name.  If the file exists in the cur-
  1379.               rent directory,  it is loaded  into the draw editor
  1380.               for  further manipulation  there.  The  Draw Center
  1381.               will try to open the file according  to you current
  1382.               graphics mode (set from the main menu F9 setup) and
  1383.               the setting of the graphics file type.
  1384.     
  1385.               Note that if you want to load a PCX type file,  you
  1386.               must be  in the graphics mode that the PCX file re-
  1387.               quires.  You set the graphics mode in the Main Menu
  1388.               with F9 key, before entering the Draw Center.  With
  1389.               the registered version of DataShow  you can use the
  1390.               ShowUtil program to get information about preffered
  1391.               modes of PCX files.  If you're not in the same gra-
  1392.               phics mode as the PCX file is in, you'll receive an
  1393.               error message "Mode not correct".
  1394.     
  1395.  
  1396.  
  1397.                               --- Page: 25 ---                              
  1398.  
  1399.     Chapter 6  : The Draw Center, Copyright (c) 1990-94 by: RMP DATA.
  1400.  
  1401.               The above is also true for GRA type files.
  1402.     
  1403.               B) Save:  You are prompted for a file name (graph).
  1404.               It has to be a special graphfile,  and a legal ope-
  1405.               rating system name.  If the file exists in the cur-
  1406.               rent  directory,  you are  warned  that it  will be
  1407.               overwritten  if you answer Y for yes.  Pressing the
  1408.               key will prompt DataShow to save the drawing in the
  1409.               draw editor to a file.
  1410.     
  1411.               To choose a filename see also topic File select.
  1412.     
  1413.               C) More:  Here you are presented with the same menu
  1414.               as is the case in the Main Menu, when you press the
  1415.               <F2> key. You can choose to display a directory, to
  1416.               change the current directory or to go to the opera-
  1417.               ting system.
  1418.     
  1419.     <F3>      CLEAR:  Makes it possible to erase the entire draw-
  1420.               ing  that you are  working on  in the  Draw Center.
  1421.               This is useful if you wish to start on a new draw-
  1422.               ing.
  1423.     
  1424.     <F4>      DRAW:  As  mentioned here above,  you get in to the
  1425.               draw screen,  from where you can  draw pictures  in
  1426.               "free hand".  You use  the arrow keys  as mentioned
  1427.               earlier, and you can  toggle  between move and draw
  1428.               mode, and toggle the step size.  You exit  from the
  1429.               draw screen to the draw center with the <F10> key.
  1430.     
  1431.     <F5>      BAR:  You are prompted  to enter  two numbers.  The
  1432.               numbers are the length and height  from the current
  1433.               location where the arrow pointer is.  At that loca-
  1434.               tion a 3-D bar is drawn  with the colors set by the
  1435.               <F9> key.
  1436.     
  1437.     <F6>      BOX:  You are prompted  to enter  two numbers.  The
  1438.               numbers are the length and height from the  current
  1439.               location where the arrow pointer is.  At that loca-
  1440.               tion a box is drawn with colors set by <F9>.
  1441.     
  1442.     <F7>      CIRC:   You are prompted  to enter  a number.  This
  1443.               number is a radius from the  current location where
  1444.               the arrow pointer is. At that location with the ra-
  1445.               dius given,  a circle is drawn  with the colors set
  1446.               by the <F9> key.
  1447.     
  1448.     <F8>      MOVE:  Here you can select  a part of the screen to
  1449.               be moved to another location on the drawing.
  1450.     
  1451.  
  1452.  
  1453.                               --- Page: 26 ---                              
  1454.  
  1455.     Chapter 6  : The Draw Center, Copyright (c) 1990-94 by: RMP DATA.
  1456.  
  1457.     <F9>      SETUP:  Here you can setup which colors to use, how
  1458.               large letters  should be,  and in which  style they
  1459.               should be written. Push <F1> when in setup for more
  1460.               help.
  1461.     
  1462.               Note that you can set the graphics file type to ei-
  1463.               ther PCX (default) or GRA. However to load (F2 key)
  1464.               a graphic image  you have to be in the same mode as
  1465.               the file is saved in.  You set the graphics mode in
  1466.               the Main Menu  with the f9 key  before entering the
  1467.               Draw Center.
  1468.     
  1469.     <F10>     EXIT:  Let you return to the main menu. Remember to
  1470.               save the drawing you're working on.  Since DataShow
  1471.               reads drawings on the disk  when you wish  to run a
  1472.               script,  the file  you just altered  must have been
  1473.               saved before it can be run, reflecting the changes.
  1474.     
  1475.     A little advice about GRA files  and PCX files  is necessary.
  1476.     
  1477.     GRA files are uncompressed images. They therefore tend to get
  1478.     quite big. A GRA type file will vary in size according to the
  1479.     graphics mode  in which it was created.  Eg. 64000 bytes  for
  1480.     EGA1 mode and over 150.000 bytes for VGA1 mode GRA files. GRA
  1481.     files were the first graphic images that DataShow could mani-
  1482.     pulate.
  1483.     
  1484.     Now however,  you have the ability to manipulate PCX files in
  1485.     the Draw Center.  PCX files are used by many drawing programs
  1486.     and it is a compressed version of an image. That usually mean
  1487.     smaller file sizes than the GRA type files.
  1488.     
  1489.     You can load  GRA type files  and save them  as PCX files and
  1490.     vice versa.  Just change the graphics file type  with the  F9
  1491.     setup key.
  1492.     
  1493.     Since GRA type files are uncompressed they are faster to load
  1494.     and save.  A good devellopment cycle can therefore be  to use
  1495.     GRA files while you are drawing a picture, and when it is fi-
  1496.     nished and ready for distribution,  you can save it  as a PCX
  1497.     type file (which saves disk space).
  1498.     
  1499.     The Draw Screen:
  1500.     ----------------
  1501.     If DataShow finds  that a mouse  is installed,  the mouse can
  1502.     also be used to move around on the draw screen:
  1503.     
  1504.     <RMB>     Right mouse button.  If you push it down, a menu is
  1505.               shown on the left and right side of the screen. You
  1506.               can then choose  (with the left mouse button)  from
  1507.  
  1508.  
  1509.                               --- Page: 27 ---                              
  1510.  
  1511.     Chapter 6  : The Draw Center, Copyright (c) 1990-94 by: RMP DATA.
  1512.  
  1513.               that menu eg. file load and save.
  1514.     
  1515.               You start with the Draw Screen being in "Draw" mode
  1516.               and you can change that to eg. fill mode (that fill
  1517.               circles or boxes) or Brush mode (that gives thicker
  1518.               air pen brush like drawings).  In the  "Draw" mode,
  1519.               you can hold the button pressed and move around the
  1520.               screen to create images.
  1521.     
  1522.     <LMB>     Left mouse button.  If you have  selected  to draw,
  1523.               fill, brush, bar, box, circle,  from the menu  men-
  1524.               tioned above  under <RMB>,  holding down <LMB> will
  1525.               generate the desired action.
  1526.     
  1527.     Also you have these keys available in the Draw Screen:
  1528.     
  1529.     <Enter>   Let you go from draw to move mode, and back.   When
  1530.               you're in move mode,  you  can use the same keys as
  1531.               when you're in draw mode. But (as you can guess) no
  1532.               line will be dragged after the arrow in move mode.
  1533.     
  1534.     <+>       Increases the step size for move or draw mode.  The
  1535.               maximum number of steps that can be taken is 10.
  1536.     
  1537.     <->       Decreases the step size for move or draw mode.  The
  1538.               minimum number of steps is 1.
  1539.     
  1540.     <arrows>  You can use the arrow keys in the draw editor,   as
  1541.               mentioned above. (Remember to turn Num Lock off).
  1542.     
  1543.     <F1>      Short help for the Draw Screen is shown.
  1544.     
  1545.     <F2>      Quick file load/save menu.
  1546.     
  1547.     <F3>      Quick clear Draw Screen menu.
  1548.     
  1549.     <F9>      Quick setup for Draw Screen menu.
  1550.     
  1551.     <F10>     Exit draw screen and return to Draw Center.
  1552.     
  1553.                         ┌───────┬───────┬───────┐
  1554.                         │ 7     │ 8     │ 9     │
  1555.                         │ Home  │       │ PgUp  │
  1556.                         ├───────┼───────┼───────┤
  1557.                         │ 4     │       │ 6     │
  1558.                         │       │       │       │
  1559.                         ├───────┼───────┼───────┤
  1560.                         │ 1     │ 2     │ 3     │
  1561.                         │ End   │       │ PgDn  │
  1562.                         └───────┴───────┴───────┘
  1563.  
  1564.  
  1565.                               --- Page: 28 ---                              
  1566.  
  1567.     Chapter 6  : The Draw Center, Copyright (c) 1990-94 by: RMP DATA.
  1568.  
  1569.     
  1570.     <Any-key> When you type a character in the draw editor,  that
  1571.               character  will be displayed  according to the cur-
  1572.               rent setup (the <F9> key from the Draw Center).
  1573.     
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.                               --- Page: 29 ---                              
  1622.  
  1623.     Chapter 6  : The Draw Center, Copyright (c) 1990-94 by: RMP DATA.
  1624.  
  1625.     CHAPTER: 7, The Text Center
  1626.     ──────────────────────────────────────────────────────────────────────
  1627.     
  1628.     
  1629.     ▄ The Text Center
  1630.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1631.     In the Text center  you can create  text mode screens.  These
  1632.     screens work in the exact same way that the screens  you grab
  1633.     with the CAPTURE Utility do. This mean, that you can have the
  1634.     screens  shown  from a DataShow script  with the  SHOW SCREEN
  1635.     command.  You can also  load screens  that you have captured,
  1636.     and then alter them as you please in the Text Center.  A list
  1637.     of the keys that work in the center is given here below:
  1638.     
  1639.     <F1>      HELP:  Gives you this helpscreen. From here you can
  1640.               select further help (see help on help).
  1641.     
  1642.     <F2>      FILES:  From here, you can choose to either load or
  1643.               save a file.  The small menu gives access to either
  1644.               of the following.
  1645.     
  1646.               A) Load:  You are prompted for a file name (graph).
  1647.               It has to be a special screenfile, and a legal ope-
  1648.               rating system name.  If the file exists in the cur-
  1649.               rent directory,  it is loaded into  the text design
  1650.               editor for further manipulation there.
  1651.     
  1652.               B) Save:  You are prompted for a file name (graph).
  1653.               It has to be a special screenfile, and a legal ope-
  1654.               rating system name.  If the file exists in the cur-
  1655.               rent  directory,  you are  warned  that it  will be
  1656.               overwritten  if you answer Y for yes.  Pressing the
  1657.               key will prompt DataShow to save the screen  in the
  1658.               text mode design editor to a file.
  1659.     
  1660.               To choose a filename see also topic File select.
  1661.     
  1662.               C) More:  Here you are presented with the same menu
  1663.               as is the case in the Main Menu, when you press the
  1664.               <F2> key. You can choose to display a directory, to
  1665.               change the current directory or to go to the opera-
  1666.               ting system.
  1667.     
  1668.     <F3>      CLEAR: Makes it possible to erase the entire screen
  1669.               that you  are working on  in the Text Center.  This
  1670.               is useful if you wish to start on a new screen.  It
  1671.               should be noted, that only when you select CLEAR is
  1672.               the new background color you have  selected for all
  1673.               of the screen (with <F9 SETUP>) actually set. So to
  1674.               set a new background color to begin designing a new
  1675.  
  1676.  
  1677.                               --- Page: 30 ---                              
  1678.  
  1679.     Chapter 7  : The Text Center, Copyright (c) 1990-94 by: RMP DATA.
  1680.  
  1681.               screen, select the color with <F9> and then <F3> to
  1682.               clear and have the changes take effect.
  1683.     
  1684.     <F4>      DRAW: You enter the text draw screen from where you
  1685.               can design screens in "free hand".  You can use the
  1686.               arrow keys to move around, and you  can toggle  be-
  1687.               tween move and draw mode. The keys you can use are:
  1688.     
  1689.               <Enter>   Toggles between move and  line draw mode.
  1690.     
  1691.               <Arrow>   When in line draw mode, once you push one
  1692.                         of the arrow keys, a line will be printed
  1693.                         at that location.
  1694.     
  1695.               <Any-key> The character the key represents  will be
  1696.                         printed at that location.
  1697.     
  1698.               <F2>      With  the  <F9> key  (in the  Text Center
  1699.                         Setup) you can  select a background  cha-
  1700.                         racter. That character is assigned to the
  1701.                         <F2> key in the draw mode,  so by pushing
  1702.                         this key  the selected character will ap-
  1703.                         pear.
  1704.     
  1705.               <F4>      Lines  that shows  current  location  and
  1706.                         special characters keys.
  1707.     
  1708.               <F5..F8>  Special characters shown from <F4> key.
  1709.     
  1710.               <F9>      Gives you  a small box  with the diffrent
  1711.                         color attributes. Select one, and it will
  1712.                         be you new drawing color.
  1713.     
  1714.               <F10>     Exit the Text draw screen  to go  back to
  1715.                         the Text Center screen.
  1716.     
  1717.     <F8>      FILL:  Here you can change the background color for
  1718.               all of the screen quickly.  All the letters  on the
  1719.               screen will not be changed, only their color.
  1720.     
  1721.     <F9>      SETUP:  Here you can setup which colors to use, how
  1722.               lines are to be written, etc. You simply follow the
  1723.               instructions on how to set up the screen design. If
  1724.               you are in the  Draw Color field,  you can push the
  1725.               <Tab> key and get a box with choises for colors.
  1726.     
  1727.     <F10>     EXIT:  Let you return to the main menu. Remember to
  1728.               save the screen you are working on.  Since DataShow
  1729.               reads screens  on the disk  when you wish  to run a
  1730.               script,  the file  you just altered  must have been
  1731.  
  1732.  
  1733.                               --- Page: 31 ---                              
  1734.  
  1735.     Chapter 7  : The Text Center, Copyright (c) 1990-94 by: RMP DATA.
  1736.  
  1737.               saved before it can be run, reflecting the changes.
  1738.     
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.                               --- Page: 32 ---                              
  1790.  
  1791.     Chapter 7  : The Text Center, Copyright (c) 1990-94 by: RMP DATA.
  1792.  
  1793.     CHAPTER: 8, The Slide Center
  1794.     ──────────────────────────────────────────────────────────────────────
  1795.     
  1796.     
  1797.     ▄ The Slide Center
  1798.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1799.     In the Slide Center,   you can design your own slides easily.
  1800.     A slide editor is shown on the screen,  and if you press <F4>
  1801.     you can easily create or modify a slide page.
  1802.     
  1803.     The slide definition can the be executed  with the SHOW SLIDE
  1804.     command from a script file.
  1805.     
  1806.     These keys are appropriate in the DataShow Slide Center:
  1807.     
  1808.     <Up-key>  If you're not at the first line in the editor, this
  1809.               key will bring you up one line.
  1810.     
  1811.     <Dn-key>  If you're not at the last line in the editor,  this
  1812.               key will bring you down one line.
  1813.     
  1814.     <F1>      HELP:  Gives you this helpscreen. From here you can
  1815.               select further help (eg. help on commands).
  1816.     
  1817.     <F2>      FILES:  From here, you can choose to either load or
  1818.               save a file.  The small menu gives access to either
  1819.               of the following.
  1820.     
  1821.               A) Load:  You're prompted  for a file name (slide).
  1822.               It has to be a legal operating system name.  If the
  1823.               file exists in the current directory  or if the fi-
  1824.               lename includes  a full path,  and it is recognised
  1825.               as a slide file,  it is loaded into  the editor  to
  1826.               be further manipulated there.
  1827.     
  1828.               B) Save:  You're prompted  for a file name (slide).
  1829.               It has to be a legal operating system name.  If the
  1830.               file exists in the current directory, you're warned
  1831.               that it will be overwritten if you answer Y for yes
  1832.               to overwrite.  You are instructing DataShow to save
  1833.               the file from the editor.
  1834.     
  1835.               To choose a filename see also topic File select.
  1836.     
  1837.               C) More:  Here you are presented with the same menu
  1838.               as is the case in the Main Menu, when you press the
  1839.               <F2> key. You can choose to display a directory, to
  1840.               change the current directory or to go to the opera-
  1841.               ting system.
  1842.     
  1843.  
  1844.  
  1845.                               --- Page: 33 ---                              
  1846.  
  1847.     Chapter 8  : The Slide Center, Copyright (c) 1990-94 by: RMP DATA.
  1848.  
  1849.     <F3>      CLEAR:  Makes it possible to erase the entire slide
  1850.               you  are working on  in the  Slide Center.  This is
  1851.               useful if you wish to start on a new slide.
  1852.     
  1853.     <F4>      EDIT: You are placed in the Slide scratch pad, and
  1854.               from there you can use the following keys:
  1855.     
  1856.               <Up>         Moves one line up.
  1857.               <Dn>         Moves one line down.
  1858.               <Enter>      Moves to the next entry field.
  1859.               <Tab>        Moves to the next entry field.
  1860.               <Shft><Tab>  Moves backward in entry fields.
  1861.               <F9>         Gives you options for entry field.
  1862.               <F10>        Goes back to the slide screen.
  1863.     
  1864.               It should be easy for you to put together a list of
  1865.               slide definitions.  You decide  how to advance from
  1866.               one slide to the next (with seconds or a key), what
  1867.               effects there should be between slides (Clear, Fade
  1868.               or Glitter). See description further below here.
  1869.     
  1870.     <F5>      PAGE:  This key moves you to the next page.  In all
  1871.               there can be 50 lines  in the slide command center,
  1872.               with 10 lines on each page.
  1873.     
  1874.     <F6>      INSERT: A line is inserted at the current location.
  1875.               All other lines beneath  are moved  one line  down,
  1876.               and thus the total number of lines is increased.
  1877.     
  1878.     <F7>      DELETE:  A line is deleted at the current location.
  1879.               All other lines beneath are moved one line up,  and
  1880.               thus the total number of lines is decreased.
  1881.     
  1882.     <F8>      PREVIEW:  Here you can look at PCX, GIF or GRA type
  1883.               files.  The file  you choose  will be shown  on the
  1884.               screen.  This makes it possible for you to remember
  1885.               which file it is,  that you will show in your slide
  1886.               show.
  1887.     
  1888.     <F9>      COMMAND: This key is used when you first have push-
  1889.               ed the <F4> EDIT key. Depending on the field you're
  1890.               currently in,  a small menu with the applicable op-
  1891.               tions are shown. You can the select between the op-
  1892.               tions. This is also true for files.
  1893.     
  1894.     <F10>     EXIT: Let you return to the main menu.  Remember to
  1895.               save the slide  you're working on.  Since  DataShow
  1896.               reads slides from the disk when you wish to run it,
  1897.               the file you just entered or altered must have been
  1898.               saved before it is to be run, reflecting any of the
  1899.  
  1900.  
  1901.                               --- Page: 34 ---                              
  1902.  
  1903.     Chapter 8  : The Slide Center, Copyright (c) 1990-94 by: RMP DATA.
  1904.  
  1905.               changes.
  1906.     
  1907.     You have to  fill information into the different lines on the
  1908.     slide scratchpad. Each line constitutes one slide to be shown
  1909.     on the screen. Each field is described here:
  1910.     
  1911.     FILENAME:
  1912.     You enter a file name. Remember to include the file extension
  1913.     eg. PCX for PCX type files, etc...  You can select files with
  1914.     <F9> key.
  1915.     
  1916.     FILETYPE:
  1917.     You enter a file type. This is often equal to the file exten-
  1918.     sion. Eg. PCX for PCX type files, etc...  You can select type
  1919.     with the <F9> key.
  1920.     
  1921.     EFFECT:
  1922.     You can enter the effect that is shown between two slides. To
  1923.     select between effects you can use the <F9> key.
  1924.     
  1925.     PAUSE:
  1926.     Between slides a pause can be inserted.  You can either enter
  1927.     a number,  in which case  the next slide  will be shown after
  1928.     the number of seconds. Or you can enter KEY in which case the
  1929.     next slide will be shown after you use the <space> or <arrow>
  1930.     keys.  Left arrow moves on  to next slide (until there are no
  1931.     more, then the script continues)  and right arrow  moves to a
  1932.     prior slide.
  1933.     
  1934.     Remember that you cannot mix text- and graphmode slides.  You
  1935.     must make slides in either of the two.  You can however blend
  1936.     music type slides in with the other slides.
  1937.     
  1938.     
  1939.     ENTERING DATA, EXAMPLE:
  1940.     -------------------------------------------------------------
  1941.     Here's an example  of a text mode slide definition of two li-
  1942.     nes in the Slide Center.  You have to have the two files text
  1943.     screens saved  either with the Capture program  or made  from
  1944.     the Text Center.
  1945.     
  1946.        FILENAME:        FILETYPE:         EFFECT:        PAUSE:
  1947.     
  1948.     1: SHOW1.SCR        TXT               W-SPLIT        4
  1949.     2: SHOW4.SCR        TXT               W-RIGHT        4
  1950.     
  1951.     This example defines a slide show  with only two slides.  The
  1952.     effect is shown as the transition between slides after a cer-
  1953.     tain pause has taken place.  The slide definition  is invoked
  1954.     with the SHOW SLIDE command.
  1955.  
  1956.  
  1957.                               --- Page: 35 ---                              
  1958.  
  1959.     Chapter 8  : The Slide Center, Copyright (c) 1990-94 by: RMP DATA.
  1960.  
  1961.     
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.                               --- Page: 36 ---                              
  2014.  
  2015.     Chapter 8  : The Slide Center, Copyright (c) 1990-94 by: RMP DATA.
  2016.  
  2017.     CHAPTER: 9, The Graph Menu
  2018.     ──────────────────────────────────────────────────────────────────────
  2019.     
  2020.     
  2021.     ▄ The Graph Menu
  2022.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2023.     Choose either of these two Centers, to get more detailed in-
  2024.     formation:
  2025.     
  2026.                         Animation Center
  2027.                         Chart Center
  2028.     
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.                               --- Page: 37 ---                              
  2070.  
  2071.     Chapter 9  : The Graph Menu, Copyright (c) 1990-94 by: RMP DATA.
  2072.  
  2073.     CHAPTER: 10, Errormessages
  2074.     ──────────────────────────────────────────────────────────────────────
  2075.     
  2076.     
  2077.     ▄ Errormessages
  2078.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2079.     Beneath here is a list of all the  errormessages that you can
  2080.     get while using a scriptfile. Errormessages you can get while
  2081.     using DataShows menu interface should be self explanatory and
  2082.     therefore they are not mentioned here.
  2083.     
  2084.     In general, when you receive an errormessage  while running a
  2085.     script,  the message is accompanied by a line number, and the
  2086.     command that either caused the error  or is near to where the
  2087.     error is.  You'll quickly be able to find the location in the
  2088.     file, and correct the problem.
  2089.     
  2090.     Because of a hurried release,  this list is not finished, but
  2091.     some of the more important/common ones are shown here...
  2092.     
  2093.     COMMAND ERROR:
  2094.     -------------------------------------------------------------
  2095.     This errormessage is usually followed  by the offending  com-
  2096.     mand. In general there are two ways you can expect to see the
  2097.     message:  1. You have  entered something where the first word
  2098.     on the line  cannot be interpreted  as one of the  valid com-
  2099.     mands, or 2. The file is not a valid DataShow script file. In
  2100.     case of problem number 1. you should be able to see  if some-
  2101.     thing has been misspelled or if you're missing the first com-
  2102.     mand on the line.  In case of problem 2. you should choose to
  2103.     run a valid DataShow script file  (eg. not a slide definition
  2104.     file).
  2105.     
  2106.     Endline expected:
  2107.     -------------------------------------------------------------
  2108.     This errormessage is shown  when the DataShow interpreter ex-
  2109.     pects the line to be finished. You have entered too many com-
  2110.     mands or parameters on a line. Check the command and its syn-
  2111.     tax one more time.
  2112.     
  2113.     Error in file or format:
  2114.     -------------------------------------------------------------
  2115.     This errormessage is shown when a filename was expected,  but
  2116.     then file wasn't found  or there  was an error encountered in
  2117.     the format of the file.  Make sure the file exists,  and that
  2118.     it has the correct format, eg. .SCR files must have been made
  2119.     with the Text Center or the Capture utility.
  2120.     
  2121.     Error in name:
  2122.     -------------------------------------------------------------
  2123.  
  2124.  
  2125.                               --- Page: 38 ---                              
  2126.  
  2127.     Chapter 10 : Errormessages, Copyright (c) 1990-94 by: RMP DATA.
  2128.  
  2129.     Either  a variable name is spelled incorrectly  or a variable
  2130.     name is missing.  In the first case,  some name has been read
  2131.     but that name hasn't been found  among the variables - Either
  2132.     the variable hasn't been declared first  or the name is spel-
  2133.     led wrong.  In the second case the command line stops,  but a
  2134.     variable name is expected.
  2135.     
  2136.     Error in name or number:
  2137.     -------------------------------------------------------------
  2138.     This errormessage is shown when a variable name  or a number
  2139.     is incorrect.  You can  use variables (number variables)  by
  2140.     entering their names to certain commands, or you can enter a
  2141.     number constant  directly.  But either  the variable name is
  2142.     spelled wrongly or a wrong number has been entered.  Enter a
  2143.     correct number variable name or enter a correct number.
  2144.     
  2145.     Error in parameter:
  2146.     -------------------------------------------------------------
  2147.     This errormessage is shown  when a missing or wrong parameter
  2148.     to a command  is encountered.  Check the command and its syn-
  2149.     tax one more time.
  2150.     
  2151.     Error in quote:
  2152.     -------------------------------------------------------------
  2153.     This errormessage is shown in these cases:
  2154.     1) You have forgotten  to start a filename or textstring with
  2155.        a quotation mark (").
  2156.     2) You have entered a  too long filename or string (the maxi-
  2157.        mum length is 80 chars) before an end quotation mark.
  2158.     Check the command and enter a quotation mark in the beginning
  2159.     of the string if one is missing or make the string a shorter.
  2160.     
  2161.     Error in value:
  2162.     -------------------------------------------------------------
  2163.     You have entered a number or a variable name (of a number va-
  2164.     riable) that is incorrect. The number that corresponds to the
  2165.     variable name or the number you've entered directly is out of
  2166.     the acceptable range. Please change the value to fit the syn-
  2167.     tax for the command in question.
  2168.     
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.                               --- Page: 39 ---                              
  2182.  
  2183.     Chapter 10 : Errormessages, Copyright (c) 1990-94 by: RMP DATA.
  2184.  
  2185.     CHAPTER: 11, Commands
  2186.     ──────────────────────────────────────────────────────────────────────
  2187.     
  2188.     
  2189.     ▄ Commands
  2190.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2191.     When you're in the script menu, and when pushing function key
  2192.     <F9>, you can select from a number of commands.   Listed here
  2193.     below,   you can select each of the commands you wish to have
  2194.     further information on. See also Quick Start further below.
  2195.     
  2196.      SCREEN         SHOW           WRITE          COLOR
  2197.     
  2198.      GOXY           WAIT           SPEAK          MUSIC
  2199.     
  2200.      EFFECT         DRAW           SET            DO
  2201.     
  2202.      MARK           JUMPMARK       VARIABLE       READ
  2203.     
  2204.      IF             CASE           MATH           DEFINE
  2205.     
  2206.      END            MOTION         MOUSE          BUTTON
  2207.     
  2208.      WINDOW         CONTINUE       BREAK          CALL
  2209.     
  2210.      INSTALL        SPRITE         QUIT
  2211.     
  2212.     
  2213.     Obsolete commands:
  2214.     
  2215.      SAY            WAITKEY        GRAPHICS       SOUND
  2216.     
  2217.      POINT          ESCAPEKEY      * (Comments)   Screen
  2218.     
  2219.     
  2220.     
  2221.     ▄ Commands, Quick Start:
  2222.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2223.     Here, all the commands and their syntax is shown. For Further
  2224.     descriptions please  look at the command descriptions indivi-
  2225.     dually.
  2226.     
  2227.     SCREEN CLEAR
  2228.        Command clears the screen.
  2229.     
  2230.     SCREEN GET
  2231.        This command saves a screen to a buffer
  2232.     
  2233.     SCREEN PUT
  2234.        This command shows a screen that has been previously saved
  2235.  
  2236.  
  2237.                               --- Page: 40 ---                              
  2238.  
  2239.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2240.  
  2241.     
  2242.     SCREEN WIPE <SPLIT | LEFT | RIGHT | UP | DOWN | OUT>
  2243.        This commands clears the screen using the parameter
  2244.     
  2245.     SHOW SCREEN "<filename>" <TXT | GRA | PCX | GIF | FLI>
  2246.        Command shows a screen from a separate file
  2247.     
  2248.     SHOW SLIDE "<filename>"
  2249.        Command shows several slides according to file specified
  2250.     
  2251.     SHOW CHART "<filename>" <BAR | PIE | LIN>
  2252.        Command shows a chart according to file and type specified
  2253.     
  2254.     WRITE <"<text to be printed on screen>" | <variable>>
  2255.           {+ again}
  2256.        Command writes texts to the screen
  2257.     
  2258.     COLOR <BACKGROUND | FOREGROUND | ATTRIBUTE>
  2259.        Command sets the color that effects other commands
  2260.     
  2261.     GOXY <x-coordinate> <y-coordinate>
  2262.        Command sets the coordinates that effects other commands
  2263.     
  2264.     WAIT [<seconds> | "<text>"]
  2265.        Command stops script execution until seconds are passed or
  2266.        any key is pushed
  2267.     
  2268.     SPEAK <number> | <variablename> | "<text>"
  2269.        Command talks through the speaker
  2270.     
  2271.     MUSIC SOUND <notechar> <number> <number>
  2272.        Command makes a single sound through the speaker
  2273.     
  2274.     MUSIC PROCESS "<filename>" SND
  2275.        Command reads a DataShow music file and plays it
  2276.     
  2277.     MUSIC PROCESS "<filename>" WAV <frequency>
  2278.        Command reads a Windows music file and plays it
  2279.     
  2280.     MUSIC PROCESS "<filename>" VOC <frequency>
  2281.        Command reads a Creative Labs music file and plays it
  2282.     
  2283.     EFFECT SCROLL <UP | DOWN>
  2284.        Command scrolls the screen up or down
  2285.     
  2286.     EFFECT FADE <IN | OUT | BOTH>
  2287.        Command fades the screen
  2288.     
  2289.     EFFECT GLITTER
  2290.        Command makes lots of glitter on the screen
  2291.  
  2292.  
  2293.                               --- Page: 41 ---                              
  2294.  
  2295.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2296.  
  2297.     
  2298.     EFFECT TEXTTYPE <font-number> <size-number>
  2299.        Command sets the text type and size for graphic writes
  2300.     
  2301.     EFFECT POINT <x-coordinate> <y-coordinate>
  2302.        Command writes an arrow on specified place
  2303.     
  2304.     DRAW BOX <length> <height>
  2305.        Command draws a box from current location
  2306.     
  2307.     DRAW LINE <length-number>
  2308.        Command draws a line from current location
  2309.     
  2310.     DRAW CIRCLE <radius-number>
  2311.        Command draws a circle with center in current location
  2312.     
  2313.     DRAW BAR <length> <height>
  2314.        Command draws a bar from current location
  2315.     
  2316.     SET GRAPHICS <OFF|CGA|EGA1|EGA2|VGA1|VGA2|SVGA1|SVGA2>
  2317.        Command set scripts in either text or graphics mode
  2318.     
  2319.     SET DELAYFACTOR <number>
  2320.        Command set the delays for other commands
  2321.     
  2322.     SET SHADOW <OFF | <number>>
  2323.        Command sets shadow on graphics writes
  2324.     
  2325.     SET CURSOR <ON | OFF>
  2326.        Command sets cursor in text mode
  2327.     
  2328.     SET TIMEOUT <number>
  2329.        Command makes scripts pass the WAIT command
  2330.     
  2331.     SET ESCAPEKEY <OFF | <number>>
  2332.        Command let you control the interruption of scripts
  2333.     
  2334.     SET TEXTSOUND <ON | OFF>
  2335.        Command sets the sound on writes to screen
  2336.     
  2337.     SET DOUBLELINE <ON | OFF>
  2338.        Command sets single or double lines
  2339.     
  2340.     SET DEBUG <ON | OFF>
  2341.        Command enables debug <alt+d> halting of scripts
  2342.     
  2343.     DO "<filename>"
  2344.        Command lets you execute another script file
  2345.     
  2346.     MARK <name | number>
  2347.  
  2348.  
  2349.                               --- Page: 42 ---                              
  2350.  
  2351.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2352.  
  2353.        Command marks a place to jump to
  2354.     
  2355.     JUMPMARK <name | number>
  2356.        Command jumps to a mark
  2357.     
  2358.     VARIABLE CREATE <name> TYPE
  2359.                     <STRING "<text>" | NUMBER <value> | KEY>
  2360.        The command creates a variable of a given type
  2361.     
  2362.     VARIABLE INCREASE <name> <number>
  2363.        This command increases a number variable by a given number
  2364.     
  2365.     VARIABLE DECREASE <name> <number>
  2366.        This command decreases a number variable by a given number
  2367.     
  2368.     VARIABLE RELEASE <name>
  2369.        This command deletes a given variable
  2370.     
  2371.     VARIABLE VALUE <name> <value>
  2372.        This command forces a value to a given variable
  2373.     
  2374.     VARIABLE LOAD <name> FROM "<filename>"
  2375.        The command loads a variable from disk
  2376.     
  2377.     VARIABLE SAVE <name> TO "<filename>"
  2378.        The command saves a variable to disk
  2379.     
  2380.     READ CHOISE <number> <number>
  2381.        This command reads a number key in the given range
  2382.     
  2383.     READ STRING [UPPER] <variable name> <length number>
  2384.        This command reads a string with the given length
  2385.     
  2386.     READ KEY <variable name>
  2387.        This command reads a key into a variable
  2388.     
  2389.     IF <variable name> <EQ | NE | LT | LE | GT | GE | IN>
  2390.        <<number> | <variable name>> DO
  2391.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2392.        This command let you test the value of a number variable
  2393.     
  2394.     IF [NOT] GRAPH <VGA | EGA | CGA> DO
  2395.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2396.        This command let you check the graphics adapter
  2397.     
  2398.     IF [NOT] MOUSE DO
  2399.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2400.        This command let you check if a mouse is present
  2401.     
  2402.     IF [NOT] FILE <"filename"> DO
  2403.  
  2404.  
  2405.                               --- Page: 43 ---                              
  2406.  
  2407.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2408.  
  2409.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2410.        This command let you check if a file exists
  2411.     
  2412.     IF [NOT] SOUND <ADLIB | BLAST> DO
  2413.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2414.        Command checks if a sound blaster or adlib is available
  2415.     
  2416.     CASE CHOISE <number> DO
  2417.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2418.        This command let you examine the value read by READ CHOISE
  2419.     
  2420.     CASE STRING [UPPER] <variable name>
  2421.        <<"text"> | <variable name>> DO
  2422.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2423.        This command let you test the value of a string variable
  2424.     
  2425.     CASE KEY <variable name> <key number> DO
  2426.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  2427.        This command let you test the value of a key variable
  2428.     
  2429.     MATH <variable name> = <expression>
  2430.        This command let you do mathematic operations
  2431.     
  2432.     DEFINE
  2433.        This command marks the beginning of a defined area
  2434.     
  2435.     END
  2436.        This command marks the end of a defined area
  2437.     
  2438.     MOTION <LEFT | RIGHT> <times>
  2439.        This command lets you move a defined area across screen
  2440.     
  2441.     MOUSE <ON | OFF | GOXY | TRACK | QUERY | TYPE | DRAW>
  2442.        The command makes it possible for you to use a mouse
  2443.     
  2444.     BUTTON
  2445.        *** This command is under construction...
  2446.     
  2447.     WINDOW <length> <height>
  2448.        This command selects part of the screen for output
  2449.     
  2450.     CONTINUE
  2451.        This command restarts script execution from the beginning
  2452.     
  2453.     BREAK
  2454.        This command goes to a continue command and goes on there
  2455.     
  2456.     CALL "<command>"
  2457.        This command calls an operating system file or program
  2458.     
  2459.  
  2460.  
  2461.                               --- Page: 44 ---                              
  2462.  
  2463.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2464.  
  2465.     INSTALL FONT "<filename>"
  2466.        The command makes it possible to install more fonts
  2467.     
  2468.     INSTALL SOUND <SPEAK| ADLIB | BLAST>
  2469.        Sets music output to sound blaster, adlib or PC speaker
  2470.     
  2471.     SPRITE <LOAD | GOXY | SHOW | HIDE | FRAME | RELEASE>
  2472.        The command let you move aprite objects around the screen
  2473.     
  2474.     QUIT
  2475.        This command end script and DataShow execution
  2476.     
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.                               --- Page: 45 ---                              
  2518.  
  2519.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2520.  
  2521.     Printer Center
  2522.     
  2523.     ▄ The Printer Center
  2524.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2525.     In  the Printer Center  you can print out  most of the  files
  2526.     that are used in DataShow.  You can print out ascii text (eg.
  2527.     scripts), graphic pictures (eg. PCX, GIF and GRA), Slide File
  2528.     definitions (SLD) and you can select  which printer  it is to
  2529.     be printed on.
  2530.     
  2531.     First you enter a file name.  Then you move around  the setup
  2532.     screen with the arrow keys.  Use + / - keys to alter the por-
  2533.     tions that needs to be changed.  Use the + key  in the appro-
  2534.     priate place to begin the printing.
  2535.     
  2536.     You can select file names  by entering a  *.<extension>  com-
  2537.     mand. Eg. if it is a GIF file you will print, enter *.GIF and
  2538.     select the file from the file list. The name will be shown in
  2539.     the file name field on the screen. Hit <Enter> to accept. Now
  2540.     DataShow suggest  to you that  it is a GIF type file  (in the
  2541.     source type field).
  2542.     
  2543.     You can select between two type of printers, a standard prin-
  2544.     ter that adheres to the codes of Epson and IBM Pro Printer or
  2545.     a  HP Laser Jet type printer (many printers can emulate those
  2546.     three types of printers).
  2547.     
  2548.     Select the type of printer  and select the type of file  that
  2549.     you would like to print. Then push the + key at the place the
  2550.     "start print" instruction is shown.
  2551.     
  2552.     If it is  a graphics file  the picture  will be shown  on the
  2553.     screen  and it is copied to the printer.  This takes a little
  2554.     while and then you're returned to the Print Center.
  2555.     
  2556.     With the F9 key you can direct the output to another parallel
  2557.     printer (signified by the LPT setup).  This is usefull if you
  2558.     have more printers connected to a computer or if the computer
  2559.     prints out via a network.  You cannot set the print output to
  2560.     a serial printer at this time.
  2561.     
  2562.     Please note  that configuring printers  can be somewhat  like
  2563.     running around in a jungle.  It takes time  to figure you way
  2564.     around.  If the printer is set up correctly to one of the two
  2565.     printer types in DataShow,  you'll get a nice picture on your
  2566.     printer, otherwise you'll see nothing at all or many pages of
  2567.     meaningless numbers and/or text.
  2568.     
  2569.     Another approch  to printing graphics  might be  to load  the
  2570.     GRAPHICS.COM program that comes with DOS. In the Slide Center
  2571.  
  2572.  
  2573.                               --- Page: 46 ---                              
  2574.  
  2575.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2576.  
  2577.     You can preview graphics files - they are shown on the screen
  2578.     until you hit a key. If you press the <Print Screen> key, the
  2579.     pricture will be copied to your printer.
  2580.     
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.                               --- Page: 47 ---                              
  2630.  
  2631.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2632.  
  2633.     Animation
  2634.     
  2635.     ▄ The Animation Center
  2636.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2637.     The Animation Center is where you can make sprites and icons.
  2638.     
  2639.     When you choose to enter the center, DataShow will try to put
  2640.     your computer into VGA 640x480x16 mode.  Your computer has to
  2641.     support this mode for you to be able to make animations.
  2642.     
  2643.     The screen  that is shown,  contains a sprite editor grid  on
  2644.     the right side, and color buttons  and control buttons on the
  2645.     left side.
  2646.     
  2647.     You use the mouse by pressing  the left button in the grid to
  2648.     draw in the current color. By pressing the right mouse button
  2649.     in the grid, you erase at the current place.
  2650.     
  2651.     In  the upper left hand cornor,  you can see  what the sprite
  2652.     actually looks like.
  2653.     
  2654.     You can use the up, down, left, right arrow keys to trim/move
  2655.     the drawing within the grid.
  2656.     
  2657.     The frame push button has no meaning at the moment.
  2658.     
  2659.     Once you have made a sprite you can use the SPRITE command to
  2660.     manipulate the sprite around the screen from a script.
  2661.     
  2662.     
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.                               --- Page: 48 ---                              
  2686.  
  2687.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2688.  
  2689.     Chart
  2690.     
  2691.     ▄ The Chart Center
  2692.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2693.     In the Chart Center,   you can design your own charts easily.
  2694.     A chart editor is shown on the screen,  and if you press <F4>
  2695.     you can easily create or modify a chart definition.
  2696.     
  2697.     The chart definition can the be executed  with the SHOW CHART
  2698.     command from a script file.
  2699.     
  2700.     These keys are appropriate in the DataShow Chart Center:
  2701.     
  2702.     <Up-key>  If you're not at the first line in the editor, this
  2703.               key will bring you up one line.
  2704.     
  2705.     <Dn-key>  If you're not at the last line in the editor,  this
  2706.               key will bring you down one line.
  2707.     
  2708.     <F1>      HELP:  Gives you this helpscreen. From here you can
  2709.               select further help (eg. help on commands).
  2710.     
  2711.     <F2>      FILES:  From here, you can choose to either load or
  2712.               save a file.  The small menu gives access to either
  2713.               of the following.
  2714.     
  2715.               A) Load:  You're prompted  for a file name (chart).
  2716.               It has to be a legal operating system name.  If the
  2717.               file exists in the current directory  or if the fi-
  2718.               lename includes  a full path,  and it is recognised
  2719.               as a chart file,  it is loaded into  the editor  to
  2720.               be further manipulated there.
  2721.     
  2722.               B) Save:  You're prompted  for a file name (chart).
  2723.               It has to be a legal operating system name.  If the
  2724.               file exists in the current directory, you're warned
  2725.               that it will be overwritten if you answer Y for yes
  2726.               to overwrite.  You are instructing DataShow to save
  2727.               the file from the editor.
  2728.     
  2729.     Note  that lines in the editor that are blank, are considered
  2730.     to be the last line!  Do not have blank lines in a  chart de-
  2731.     finition.
  2732.     
  2733.               To choose a filename see also topic File select.
  2734.     
  2735.               C) More:  Here you are presented with the same menu
  2736.               as is the case in the Main Menu, when you press the
  2737.               <F2> key. You can choose to display a directory, to
  2738.               change the current directory or to go to the opera-
  2739.  
  2740.  
  2741.                               --- Page: 49 ---                              
  2742.  
  2743.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2744.  
  2745.               ting system.
  2746.     
  2747.     <F3>      CLEAR:  Makes it possible to erase the entire chart
  2748.               you  are working on  in the  Chart Center.  This is
  2749.               useful if you wish to start on a new chart.
  2750.     
  2751.     <F4>      EDIT: You are placed in the Chart scratch pad, and
  2752.               from there you can use the following keys:
  2753.     
  2754.               <Up>         Moves one line up.
  2755.               <Dn>         Moves one line down.
  2756.               <Enter>      Moves to the next entry field.
  2757.               <Tab>        Moves to the next entry field.
  2758.               <Shft><Tab>  Moves backward in entry fields.
  2759.               <F10>        Goes back to the chart screen.
  2760.     
  2761.               It should be easy for you to put together a list of
  2762.               chart definitions.  You simply enter the name of an
  2763.               entity that you wish  to show in a chart.  Then you
  2764.               enter  the integer value  that is connected  to the
  2765.               name. A total of 10 names and values is possible.
  2766.     
  2767.     <F6>      INSERT: A line is inserted at the current location.
  2768.               All other lines beneath  are moved  one line  down,
  2769.               and thus the total number of lines is increased.
  2770.     
  2771.     <F7>      DELETE:  A line is deleted at the current location.
  2772.               All other lines beneath are moved one line up,  and
  2773.               thus the total number of lines is decreased.
  2774.     
  2775.     <F8>      PREVIEW:  Here you can look at a chart. The current
  2776.               chart from the chart editor will be shown, if there
  2777.               is more  than one line  of data.  You simply choose
  2778.               how the chart is to be shown (as bar, pie or line).
  2779.               The chart is shown in the default graphics mode set
  2780.               from the main menu. This makes it possible  for you
  2781.               to see the outcome of a chart definition.
  2782.     
  2783.     Note  that lines in the editor that are blank, are considered
  2784.     to be the last line!  Do not have blank lines in a  chart de-
  2785.     finition.
  2786.     
  2787.     <F10>     EXIT: Let you return to the main menu.  Remember to
  2788.               save the chart  you're working on.  Since  DataShow
  2789.               reads charts  from the disk  when you wish to run a
  2790.               script,  the file you just entered  or altered must
  2791.               have been saved  before it can be shown, reflecting
  2792.               any of the changes.
  2793.     
  2794.     
  2795.  
  2796.  
  2797.                               --- Page: 50 ---                              
  2798.  
  2799.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2800.  
  2801.     IMPORTING DATA:
  2802.     -------------------------------------------------------------
  2803.     Chart definition files in DataShow consist of pure Ascii cha-
  2804.     racters.  The files follow  the DIF (data interchange format)
  2805.     standard.
  2806.     
  2807.     This makes it possible  for you  to have your data  stored in
  2808.     eg. a spreadsheet or another database,  dump the data  into a
  2809.     comma seperated file and show the result in DataShow.
  2810.     
  2811.     The syntax of the chart definition file looks like this:
  2812.     
  2813.     "<range name>", <range value>
  2814.     
  2815.     Where the range name is contained within ", and has a maximum
  2816.     of 10 characters. And the range value is an integer number.
  2817.     
  2818.     So if you export data from a spreadsheet or database it has
  2819.     to look like this example:
  2820.     
  2821.     "Division 1",       5000
  2822.     "Division 2",       2800
  2823.     "Division 3",       7600
  2824.     
  2825.     
  2826.     ENTERING DATA, EXAMPLE:
  2827.     -------------------------------------------------------------
  2828.     Here's an example of a graph definition of three lines in the
  2829.     Chart Center. They can have been entered directly in the Cen-
  2830.     ter or loaded from a file  that holds the format described a-
  2831.     bove.
  2832.     
  2833.         RANGE NAME:            RANGE VALUE:
  2834.     
  2835.     1:  Division 1                     5000
  2836.     2:  Division 2                     2800
  2837.     3:  Division 3                     7600
  2838.     
  2839.     This example  defines a chart with only three elements in it.
  2840.     You have the ability  to have up to ten elements  in a chart.
  2841.     The chart definition is invoked with the SHOW CHART command.
  2842.     
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.                               --- Page: 51 ---                              
  2854.  
  2855.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2856.  
  2857.     Info
  2858.     
  2859.     ▄ Information
  2860.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2861.     DataShow is a shareware program.  It is not for free.  So to-
  2862.     gether  with this version of DataShow,  you should be able to
  2863.     find several text files that give you more information.
  2864.     
  2865.     The file  INFO.TXT  contains much relevant information  about
  2866.     DataShow.  You can read  about registration  and registration
  2867.     bonuses. There's a list of files included and there's a quick
  2868.     start section. The system requirements are listed.  Also con-
  2869.     tact and support addresses are listed.
  2870.     
  2871.     The file  ORDER.TXT  contains  the  order form,  and the file
  2872.     REFER.TXT contains a reference guide for commands.
  2873.     
  2874.     You can use  the Print Center to print out  those files  to a
  2875.     printer.  Set the source type to Text (script) or choose your
  2876.     favorite printer program to print out the above files.
  2877.     
  2878.     Or if you just wish to view the files,  you can choose  F2 in
  2879.     many menues, select "more files", then select "directory" and
  2880.     choose the file you wish to view by pressing the <Enter> key.
  2881.     You can then see the file on the screen.
  2882.     
  2883.     DataShow  doesn't contain  any "harmfull" features.  DataShow
  2884.     does not erase itself  after a certain period,  and it has no
  2885.     hidden features. This shareware version is a full functioning
  2886.     piece of software,  where registrering  gives you  additional
  2887.     programs (eg. the runtime program), pictures and sounds.
  2888.     
  2889.     Remember,  DataShow is a shareware program,  which means  you
  2890.     can try it before you buy it.  But please register if you use
  2891.     it regularly.
  2892.     
  2893.     Registration gives you many bonusses.
  2894.     
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.                               --- Page: 52 ---                              
  2910.  
  2911.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2912.  
  2913.     Miscellaneous
  2914.     
  2915.     ▄ Miscellaneous Help pages
  2916.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2917.     On the following pages,  some general topics concerning Data-
  2918.     Show are discussed. These topics include how to select a file
  2919.     in various cases and how to use the setup command in the Draw
  2920.     and Text Centers of DataShow.
  2921.     
  2922.     
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.                               --- Page: 53 ---                              
  2966.  
  2967.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  2968.  
  2969.     Topic Select
  2970.     
  2971.     ▄ Topic Select
  2972.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2973.     You are given a range to choose from. Please enter one of the
  2974.     choises in the range (or esc to exit without choosing).
  2975.     
  2976.     The range can be numbers  or it can be between Y for Yes or N
  2977.     for No.  If the range is Y/N  usually there also is a default
  2978.     ansvar, in which case you can just hit <Enter>  (or push left
  2979.     mouse button).
  2980.     
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.                               --- Page: 54 ---                              
  3022.  
  3023.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3024.  
  3025.     File select
  3026.     
  3027.     ▄ File select
  3028.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3029.     When you are prompted for a filename in DataShow,  you can in
  3030.     general  use the wildcard letter *.  If you haven't entered a
  3031.     filename before, DataShow will suggest an extension to you.
  3032.     
  3033.     An example:  You have just started DataShow and you're in the
  3034.     Script Center.  Here you wish  to load a file.  DataShow will
  3035.     now suggest *.SHW to you.  If you push  the <Enter> key,  all
  3036.     *.SHW files  in the current directory are shown,  and you can
  3037.     pick between them easily.  If you choose to load another file
  3038.     the prior filename will be shown, but you can then again just
  3039.     type *.SHW to have the pick list shown once more.
  3040.     
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.                               --- Page: 55 ---                              
  3078.  
  3079.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3080.  
  3081.     Select
  3082.     
  3083.     ▄ Selecting between topics
  3084.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3085.     You are given a list of topics to select from.  You can use a
  3086.     mouse to move between the topics and click on the left button
  3087.     to select or right button to ignore.
  3088.     
  3089.     You can also use the keyboard  where the arrow keys  can move
  3090.     you up or down. Use the <Enter> key to select. If you type in
  3091.     a letter a search for a word beginning with that letter  will
  3092.     take place.
  3093.     
  3094.     If the topics to select from  are commands in the script Cen-
  3095.     ter,  you can see more information  about each command  under
  3096.     Commands.
  3097.     
  3098.     Otherwise  you can see information  about the items under the
  3099.     menu you are currently in. Go to the help index with <F1>.
  3100.     
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.                               --- Page: 56 ---                              
  3134.  
  3135.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3136.  
  3137.     Setup in various menues
  3138.     
  3139.     ▄ Setup
  3140.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3141.     You use the arrow keys  to move the cursor up and down to the
  3142.     field you want to change.  Then you push  either the plus <+>
  3143.     (to increment the number)  or the minus <-> (to decrement the
  3144.     number) key.  When you have finished  making the changes, you
  3145.     can exit setup by pressing the F10 key.
  3146.     
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.                               --- Page: 57 ---                              
  3190.  
  3191.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3192.  
  3193.     Entering a number
  3194.     
  3195.     ▄ Number
  3196.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3197.     You are asked to enter a number.  You can then use the keys 0
  3198.     to 9. Anything else will be invalid.  Generally there is also
  3199.     a maximum length of the number that can be entered. You can't
  3200.     move beyond that point.
  3201.     
  3202.     See editing keys for more information about entering data.
  3203.     
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.                               --- Page: 58 ---                              
  3246.  
  3247.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3248.  
  3249.     Entering text
  3250.     
  3251.     ▄ Text
  3252.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3253.     You are asked to enter some text. You can use all the keys on
  3254.     your keyboard. That is keys like letters, numbers and special
  3255.     signs.  Generally there is a maximum length  of the text that
  3256.     can be entered. You cannot move beyond that point.
  3257.     
  3258.     See editing keys for more information about entering data.
  3259.     
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.                               --- Page: 59 ---                              
  3302.  
  3303.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3304.  
  3305.     Entering filenames
  3306.     
  3307.     ▄ Filenames
  3308.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3309.     You are asked to enter a filename. You must follow some gene-
  3310.     ral rules about filenames. Eg. you can only enter letters and
  3311.     numbers.
  3312.     
  3313.     See file select about more ways to select file names.
  3314.     
  3315.     See editing keys for more information about entering data.
  3316.     
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.                               --- Page: 60 ---                              
  3358.  
  3359.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3360.  
  3361.     Directory
  3362.     
  3363.     ▄ Directory
  3364.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3365.     Shown from the "More files" menues.
  3366.     
  3367.     From here you can see a directory.  You enter a mask  (*.* is
  3368.     shown default for all of the current directory, so if that is
  3369.     acceptable just hit <Enter>).
  3370.     
  3371.     See editing keys for more information about entering data.
  3372.     
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.                               --- Page: 61 ---                              
  3414.  
  3415.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3416.  
  3417.     Change Directory
  3418.     
  3419.     ▄ Change Directory
  3420.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3421.     Shown from the "More files" menues.
  3422.     
  3423.     From here you can change to another directory. You simply en-
  3424.     the name of the directory you want to be the working directo-
  3425.     ry.
  3426.     
  3427.     See editing keys for more information about entering data.
  3428.     
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.                               --- Page: 62 ---                              
  3470.  
  3471.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3472.  
  3473.     Editing keys
  3474.     
  3475.     ▄ Editing
  3476.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3477.     In general you can use the keys described in Help on Help (in
  3478.     section 1).  But when you enter and edit data  on a line  you
  3479.     also have some more keys available.
  3480.     
  3481.     <Arrow keys>  Left and right arrow key moves one character.
  3482.     <Insert key>  Toggles overwrite / insert mode.
  3483.     <Delete key>  Deletes character above cursor.
  3484.     <Backspace>   Deletes character left of cursor.
  3485.     <Home key>    Moves to the first character.
  3486.     <End key>     Moves to the last character.
  3487.     
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.                               --- Page: 63 ---                              
  3526.  
  3527.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3528.  
  3529.     
  3530.     
  3531.     ▄ Commands, detailed descriptions:
  3532.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3533.     On the following many pages, the command language of DataShow
  3534.     will be shown. Each command syntax is shown, and examples are
  3535.     given.
  3536.     
  3537.     
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.                               --- Page: 64 ---                              
  3582.  
  3583.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3584.  
  3585.     SCREEN
  3586.     
  3587.     The screen command consist of three parts.  You can clear the
  3588.     screen  or you can save  or restore the screen to/from a buf-
  3589.     fer. Choose either of the following:
  3590.     
  3591.                         SCREEN CLEAR
  3592.                         SCREEN GET.
  3593.                         SCREEN PUT.
  3594.                         SCREEN WIPE.
  3595.     
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.                               --- Page: 65 ---                              
  3638.  
  3639.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3640.  
  3641.     SCREEN CLEAR
  3642.     
  3643.     Syntax.:  SCREEN CLEAR
  3644.     
  3645.     Modes..:  + text, + graphic
  3646.     
  3647.     This command clears the current window,   and set the x and y
  3648.     coordinates to 1 and 1 (top left corner).  The current window
  3649.     is always the full screen,   unless another WINDOW has been
  3650.     specified.  The blank screen  will have the color  set by the
  3651.     the current COLOR command setting.
  3652.     
  3653.     Example:
  3654.     
  3655.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  3656.        WRITE "Hello 1"             ; write text at location
  3657.        WAIT 2                      ; pause to see text
  3658.        GOXY 10 10                  ; place cursor at 10,10
  3659.        WRITE "Hello 2"             ; write text at location
  3660.        WAIT 2                      ; pause to see text
  3661.        GOXY 9 9                    ; set cursor at location
  3662.        WINDOW 10 10                ; window 10 long, 10 high
  3663.        SCREEN CLEAR                ; clears the current window
  3664.        WAIT 2                      ; pause to see clear window
  3665.     
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.                               --- Page: 66 ---                              
  3694.  
  3695.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3696.  
  3697.     SCREEN GET
  3698.     
  3699.     Syntax.:  SCREEN GET
  3700.     
  3701.     Modes..:  + text, - graphic
  3702.     
  3703.     This command saves the current screen into a screen buffer so
  3704.     that you later on can restore it with the SCREEN PUT command.
  3705.     The screen buffer can hold up to 4 screens. Attempts to store
  3706.     more than that number of screens  will result in an errormes-
  3707.     sage. The screen buffer works so that the  last  screen saved
  3708.     is the  first  screen restored (Last In First Out principle).
  3709.     The idea  is to have  a fast way  to recall screens  that are
  3710.     used frequently.
  3711.     
  3712.     Example:
  3713.     
  3714.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  3715.        WRITE "Here screen 1"       ; print text at position
  3716.        WAIT 2                      ; pause to see text
  3717.        SCREEN GET                  ; save current screen
  3718.        SCREEN CLEAR                ; blank out entire screen
  3719.        WRITE "Screen 2"            ; print text on blank screen
  3720.        WAIT 2                      ; pause to see text
  3721.        SCREEN PUT                  ; retrieve saved screen
  3722.        WAIT 2                      ; pause to see text
  3723.     
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.                               --- Page: 67 ---                              
  3750.  
  3751.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3752.  
  3753.     SCREEN PUT
  3754.     
  3755.     Syntax.:  SCREEN PUT
  3756.     
  3757.     Modes..:  + text, - graphic
  3758.     
  3759.     This command restores a screen previously saved into a screen
  3760.     buffer with  the SCREEN GET command.  If no screens are saved
  3761.     currently in the screenbuffer, an errormessage will be shown.
  3762.     The screen buffer works so that the  last screen saved is the
  3763.     first screen restored (Last In First Out principle). The idea
  3764.     is to have a  fast  way to recall screens that are frequently
  3765.     used.
  3766.     
  3767.     Example:
  3768.     
  3769.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  3770.        WRITE "Here screen 1"       ; print text at position
  3771.        WAIT 2                      ; pause to see text
  3772.        SCREEN GET                  ; save current screen
  3773.        SCREEN CLEAR                ; blank out entire screen
  3774.        WRITE "Screen 2"            ; print text on blank screen
  3775.        WAIT 2                      ; pause to see text
  3776.        SCREEN PUT                  ; retrieve saved screen
  3777.        WAIT 2                      ; pause to see text
  3778.     
  3779.  
  3780.  
  3781.  
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.                               --- Page: 68 ---                              
  3806.  
  3807.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3808.  
  3809.     SCREEN WIPE
  3810.     
  3811.     Syntax.:  SCREEN WIPE
  3812.                  <SPLIT | LEFT | RIGHT | UP | DOWN | OUT>
  3813.     
  3814.     Modes..:  + text, + graphic
  3815.     
  3816.     This command wipes out the screen going from left to right or
  3817.     right from left or top to bottom or bottom to top.  It can be
  3818.     useful to make better looking transitions from one screen  to
  3819.     another.  In  textmode the wipe color  is set  by  the  COLOR
  3820.     ATTRIBUTE command. In graphics mode the color is set by
  3821.     COLOR FOREGROUND.
  3822.     
  3823.     Example:
  3824.     
  3825.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  3826.        GOXY 10 10                  ; place the cursor for write
  3827.        WRITE "This is a long text" ; write a text to the screen
  3828.        WAIT 2                      ; wait a little while
  3829.        SCREEN WIPE RIGHT           ; clear screen from the right
  3830.        WAIT 1                      ; wait to see the result
  3831.     
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.  
  3849.  
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.                               --- Page: 69 ---                              
  3862.  
  3863.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3864.  
  3865.     SHOW
  3866.     
  3867.     The SHOW command has two separate parameters.  You can either
  3868.     show one screen from a specific file. Or you can show several
  3869.     files one at a time specified from a list of file names given
  3870.     in a SLIDE file. Further help is shown as:
  3871.     
  3872.                         SHOW SCREEN
  3873.                         SHOW SLIDE.
  3874.                         SHOW CHART.
  3875.     
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.                               --- Page: 70 ---                              
  3918.  
  3919.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3920.  
  3921.     SHOW SCREEN
  3922.     
  3923.     Syntax.:  SHOW SCREEN "<filename>"  <TXT|GRA|PCX|GIF|FLI>
  3924.     
  3925.     This command has two distinct functions.  Either you can show
  3926.     text mode screens or you can show graphic mode screens.
  3927.     
  3928.     Here beneath the two distinct functions  are show separately,
  3929.     as TEXT SCREENS or GRAPHIC SCREENS.
  3930.     
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.                               --- Page: 71 ---                              
  3974.  
  3975.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  3976.  
  3977.     TEXT SCREENS
  3978.     
  3979.     Syntax.:  SHOW SCREEN "<filename>" TXT
  3980.     
  3981.     Modes..:  + text, - graphic
  3982.     
  3983.     This command displays a screen that has previously been saved
  3984.     with the Capture Utility.  That way you can use  DataShow as
  3985.     promotion for your own applications, or applications you sell
  3986.     to customers.  You start Capture,  and save  several  screens
  3987.     from your program to disk, and then recall them from a script
  3988.     file in DataShow by using this command.
  3989.     
  3990.     Example:
  3991.     
  3992.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  3993.        WRITE "Here I am"           ; print text at position
  3994.        WAIT 2                      ; pause to see text
  3995.        SHOW SCREEN "s1.scr" TXT    ; show file s1.scr
  3996.        WAIT 4                      ; pause to see screen
  3997.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  3998.        WRITE "And again"           ; print text at position
  3999.        WAIT 2                      ; pause to see text
  4000.     
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.                               --- Page: 72 ---                              
  4030.  
  4031.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4032.  
  4033.     GRAPHIC SCREENS
  4034.     
  4035.     Syntax.:  SHOW SCREEN "<filename>" <GRA | PCX | GIF | FLI>
  4036.     
  4037.     Modes..:  - text, + graphic
  4038.     
  4039.     This command  is used to show one of several types of graphic
  4040.     images on the screen.
  4041.     
  4042.     1.  For the GRA type graphic files,  this command  is used to
  4043.     display  a screen  that previously  has  been saved  from the
  4044.     Draw Center.  You go into DataShow,  and with the Draw Center
  4045.     you draw freehand,  write texts,  change colors,  make boxes,
  4046.     and make circles.  Then from a script file you can issue this
  4047.     command, and the drawing will appear.
  4048.     
  4049.     2.  For the PCX and GIF type files,  this command  is used to
  4050.     display  a screen that previously has been saved from another
  4051.     program than DataShow.  Or you can use the Capture Utility to
  4052.     save files  in the PCX format.  Many other programs  can also
  4053.     save a graphic image in either the PCX or the GIF formats. In
  4054.     the Draw Center  you can also select to save drawings  in the
  4055.     PCX format.
  4056.     
  4057.     3.  For the FLI type files, this command is used to display a
  4058.     numer of screens saved from another program than DataShow.  A
  4059.     FLI file is a file that contains animation screens.  They are
  4060.     typically created with the program Autodesk Animator (TM) and
  4061.     they can be found in many places. You must be able to run  in
  4062.     the VGA mode 320x200x256 for FLI files to work.
  4063.     
  4064.     The picture,  drawing or whatever in either of the three for-
  4065.     mats will remain on the screen until it is cleared or another
  4066.     picture is shown.
  4067.     
  4068.     Just remember to switch your machine into graphics mode prior
  4069.     to giving this command. Which graphics mode you are in before
  4070.     calling this command isn't important, since this rutine by it
  4071.     self figures out,  which mode  is needed.  NOTE however, that
  4072.     when the SHOW SCREEN command  has finished, the graphics mode
  4073.     might have been switched according to the format in the gra-
  4074.     phics screen file! See also SET GRAPHICS.
  4075.     
  4076.     Example:
  4077.     
  4078.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4079.        WRITE "Now text"            ; print text at position
  4080.        WAIT 2                      ; pause to see text
  4081.        SET GRAPHICS EGA1           ; initialize graphics
  4082.        SHOW SCREEN "g1.gra" GRA    ; show file called g1.gra
  4083.  
  4084.  
  4085.                               --- Page: 73 ---                              
  4086.  
  4087.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4088.  
  4089.        WAIT 2                      ; pause to see picture
  4090.        SET GRAPHICS OFF            ; go back to text mode
  4091.        WRITE "Text again"          ; print text at position
  4092.        WAIT 2                      ; pause to see text
  4093.     
  4094.     Comments and hints: The GIF reader in DataShow takes a lot of
  4095.     memory to run,  therefore you  may sometimes  run out of free
  4096.     memory.  You can  either free up memory  by removing resident
  4097.     programs, or you can convert GIF files to the PCX format that
  4098.     in DataShow doesn't require as much memory. There are several
  4099.     public domain  programs  that converts  between  graphic file
  4100.     formats.  This can  also help you, if there  is a  problem in
  4101.     displaying  a graphic file  from DataShow - try to convert it
  4102.     to the other format.
  4103.     
  4104.     Also if you have  a registered version of DataShow,  the run-
  4105.     time version called SHOWRUN takes up a lot less memory, so it
  4106.     is possible for your presentation to run there instead.
  4107.     
  4108.     Here's a list of the modes that DataShow graphics supports:
  4109.     
  4110.     ╔═══════════════════════════════════════════════════════════╗
  4111.     ║ Mode:                GRA           PCX           GIF      ║
  4112.     ║                                                           ║
  4113.     ║ CGA                                                       ║
  4114.     ║    320x200x016        X             X             X       ║
  4115.     ║                                                           ║
  4116.     ║ EGA                                                       ║
  4117.     ║    640x200x016        X             X             X       ║
  4118.     ║    640x350x016        X             X             X       ║
  4119.     ║                                                           ║
  4120.     ║ VGA                                                       ║
  4121.     ║    640x480x016        X             X             X       ║
  4122.     ║    320x200x256        X             X             X       ║
  4123.     ║                                                           ║
  4124.     ║ SVGA                                                      ║
  4125.     ║    640x400x256                                    X       ║
  4126.     ║    640x480x256                                    X       ║
  4127.     ║    800x600x016                                    X       ║
  4128.     ║    800x600x256                                    X       ║
  4129.     ║   1024x768x016                                    X       ║
  4130.     ║   1024x768x256                                    X       ║
  4131.     ╚═══════════════════════════════════════════════════════════╝
  4132.     
  4133.     These cryptic codes are to be interpreted as follows:
  4134.     
  4135.     The first number  is the number of pixels  across the screen.
  4136.     The second number  is the number of pixels  down the  screen.
  4137.     The last number  is the number of colors each pixel can have.
  4138.     
  4139.  
  4140.  
  4141.                               --- Page: 74 ---                              
  4142.  
  4143.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4144.  
  4145.     So if you look at a GRA type file,  that file can be shown on
  4146.     a EGA screen. A GRA file can then for example be shown on all
  4147.     of the screen in a resolution called 640x200x16.
  4148.     
  4149.     Note that high resolution monitors supports the lower resolu-
  4150.     tions.  Eg. a SVGA or XGA monitor/graphics card  supports all
  4151.     of the above mentioned monitors.
  4152.     
  4153.     Of course you have to have a graphics card and a monitor that
  4154.     supports the mode you  wish to use.  Also the PCX or GIF file
  4155.     must have either of the screen dimensions.
  4156.     
  4157.     In any event,  it is  -always a very good idea-  to test your
  4158.     script on the computer on which the presentation is to be run
  4159.     since that will assure  that everything you've  made will run
  4160.     properly. Demonstrations on fairs will then be a success!!!
  4161.     
  4162.     Ways of showing graphic images:
  4163.     
  4164.     As you probably know by now  (otherwise goto  the appropriate
  4165.     section on the Capture Utility)  you have the possibility  to
  4166.     capture text mode screens and  have them shown  from DataShow
  4167.     with  the SHOW SCREEN command.  There are several ways  to do
  4168.     the same with graphic mode screens.  The first  is to use one
  4169.     of many screen grabbers, and then convert them into on of the
  4170.     formats  that DataShow supports.  The other method  is to use
  4171.     Microsoft Windows 3.x (tm) to grab any of the window applica-
  4172.     tion screens. The method is as follows.
  4173.     
  4174.     1) Go to the screen you wish to grab.
  4175.     2) Push the <Print Screen> key on the keyboard.
  4176.     3) Load PaintBrush (it comes with the windows package).
  4177.     4) Select the <View> menu, and the <Zoom out> option.
  4178.     5) Select the <Edit> menu, and the <Paste> option.
  4179.     6) Select the <Edit> menu, and the <Paste> option (again).
  4180.     7) Select the <View> menu, and the <Zoom in> option.
  4181.     
  4182.     Now the screen  is in the PaintBrush editor.  From there you
  4183.     can save it  as a PCX type file.  That PCX file  can then be
  4184.     shown from DataShow with the SHOW SCREEN <name> PCX command.
  4185.     
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.                               --- Page: 75 ---                              
  4198.  
  4199.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4200.  
  4201.     SHOW SLIDE
  4202.     
  4203.     Syntax.:  SHOW SLIDE "<filename>"
  4204.     
  4205.     Modes..:  + text, + graphic
  4206.     
  4207.     The SHOW SLIDE command  is especially designed  for presenta-
  4208.     tions that should be run on overhead via a projector, eg. the
  4209.     one's that you nowadays can connect to a computer.
  4210.     
  4211.     You can then shown a row of pictures, and easily move forward
  4212.     when you have finished one slide... You simply press a button
  4213.     on a mouse or a key on the keyboard. The keys you can use are
  4214.     the following (only with the KEY slide separator):
  4215.     
  4216.            <Left key>     Brings you one slide back.
  4217.     
  4218.            <Right key>    Brings you one slide forward.
  4219.            <Enter key>    Brings you one slide forward.
  4220.            <Space key>    Brings you one slide forward.
  4221.     
  4222.            <Tab key>      Enter number for slide to go to.
  4223.            <Esc key>      Stop showing slides.
  4224.     
  4225.     With a mouse installed you can also use the left mouse button
  4226.     to move one slide forward, and right mouse button to stop the
  4227.     slide show.
  4228.     
  4229.     The  SHOW SLIDE command  can include  special effects between
  4230.     slides and you can include "music slides".
  4231.     
  4232.     You could program the same functionality by using other Data-
  4233.     Show commands - this is just an easier way to control  a demo
  4234.     on an overhead.
  4235.     
  4236.     The slides are designed in the Slide Center,  and screens are
  4237.     designed  in  the Text Center,  the Draw Center  or  anywhere
  4238.     you wish.
  4239.     
  4240.     The  examples here below  are  for either  text- or graphmode
  4241.     slides.
  4242.     
  4243.     Example 1:
  4244.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4245.        SHOW SLIDE "txtslide1.sld"  ; show slides from file
  4246.     
  4247.     Example 2:
  4248.        SET GRAPHIC EGA1            ; just go into one graph mode
  4249.        SHOW SLIDE "graslide1.sld"  ; show slides from file
  4250.     
  4251.  
  4252.  
  4253.                               --- Page: 76 ---                              
  4254.  
  4255.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4256.  
  4257.     Note that when you write your slides  in the Slide Center you
  4258.     should not include blank fields between two slide lines. When
  4259.     DataShow encounters a blank line in the slide definition file
  4260.     when  running  the SLIDE SHOW command,  it regards  the slide
  4261.     file as finished, and continues  with the next command in the
  4262.     script file.
  4263.     
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.                               --- Page: 77 ---                              
  4310.  
  4311.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4312.  
  4313.     SHOW CHART
  4314.     
  4315.     Syntax.:  SHOW CHART "<filename>" <BAR | PIE | LIN>
  4316.     
  4317.     Modes..:  - text, + graphic
  4318.     
  4319.     With this command you can show charts on the screen.  A chart
  4320.     definition  can be made  in the Chart Center  or  it can come
  4321.     from spreadsheets or databases in a DIF format  (see descrip-
  4322.     tion under the Chart Center).
  4323.     
  4324.     You enter some graphics mode, and then issue this command.
  4325.     
  4326.     Example:
  4327.     
  4328.        SET GRAPHICS EGA2           ; initialize graphics
  4329.        SHOW CHART "tst.cht" PIE    ; show a pie chart
  4330.        WAIT KEY                    ; wait for a key to be pressed
  4331.     
  4332.     Where the "tst.cht" file looks like this:
  4333.     
  4334.        "DIVISION 1",    50000
  4335.        "DIVISION 2",    23000
  4336.        "DIVISION 3",    70000
  4337.     
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.                               --- Page: 78 ---                              
  4366.  
  4367.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4368.  
  4369.     WRITE
  4370.     
  4371.     Syntax.:  WRITE "<text to be printed on screen>" | <variable>
  4372.                     {+ again}
  4373.     
  4374.     Modes..:  + text, + graphic
  4375.     
  4376.     This command prints the text you have written within the quo-
  4377.     tation marks.   The text is printed starting from the current
  4378.     coordinates,  selected by GOXY,  and the current color set by
  4379.     COLOR command. Or it writes the value of the named variable.
  4380.     
  4381.     You can also enter a + symbolizing a concatenation of a vari-
  4382.     able or string following the +. This is shown in example 2.
  4383.     
  4384.     Note that  if you start the text to be written with an " sign
  4385.     you can have ' signs in the text.  Everyhing is written until
  4386.     another " is seen, symbolising the end of the text to be wri-
  4387.     tten.  On the other hand,  if you start  with an ' sign,  the
  4388.     text to be written must end with an ' sign.  The latter makes
  4389.     it possible to put " in a text to be written. See example 3.
  4390.     
  4391.     Example 1:
  4392.     
  4393.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4394.        GOXY 10 10                  ; move position to 10,10
  4395.        WRITE "Here"                ; print text at position
  4396.        WAIT 2                      ; pause to see cursor position
  4397.        GOXY 20 18                  ; move to line 18,20 places in
  4398.        WRITE "Now here"            ; print text at position
  4399.        WAIT 2                      ; pause to see cursor position
  4400.     
  4401.     Example 2:
  4402.     
  4403.        VARIABLE CREATE testnum TYPE NUMBER 1
  4404.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4405.        GOXY 10 10                  ; move position to 10,10
  4406.        WRITE "Number is "+testnum  ; print text at position
  4407.        WAIT 2                      ; pause to see text
  4408.     
  4409.     Example 3:
  4410.     
  4411.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4412.        GOXY 10 10                  ; move position to 10,10
  4413.        WRITE "This is a 'test'"    ; print text at position
  4414.        GOXY 10 12                  ; move position to 10,10
  4415.        WRITE 'This is a "test"'    ; print text at position
  4416.        WAIT 2                      ; pause to see text
  4417.     
  4418.  
  4419.  
  4420.  
  4421.                               --- Page: 79 ---                              
  4422.  
  4423.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4424.  
  4425.     COLOR
  4426.     
  4427.     Syntax.:  COLOR <BACKGROUND | FOREGROUND | ATTRIBUTE>
  4428.     
  4429.     Modes..:  + text, + graphic
  4430.     
  4431.     This command sets the colors that are used  in many places in
  4432.     conjunction with different types of screen writes.
  4433.     
  4434.     Here beneath the two distinct functions are shown separately,
  4435.     as BACKGROUND, FOREGROUND and ATTRIBUTE.
  4436.     
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.                               --- Page: 80 ---                              
  4478.  
  4479.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4480.  
  4481.     BACKGROUND
  4482.     
  4483.     Syntax.:  COLOR BACKGROUND < <number> | <variable name> >
  4484.     
  4485.     Modes..:  + text, + graphic
  4486.     
  4487.     This command sets the background color, that determines which
  4488.     color some texts are to be written in. Only  the  background,
  4489.     not the letter itself is given the color set by this command.
  4490.     Commands that are affected by this command are the following:
  4491.     SCREEN CLEAR,  WRITE,  and DRAW.  These background colors are
  4492.     available:
  4493.     
  4494.                0    is black            1    is blue
  4495.                2    is green            3    is cyan
  4496.                4    is red              5    is magenta
  4497.                6    is brown            7    is light grey
  4498.     
  4499.     Instead of entering an exact number  as shown above,  you can
  4500.     also use a variable name as a parameter to this command.  The
  4501.     value of the variable will then be used to set the color.
  4502.     
  4503.     Example:
  4504.     
  4505.        COLOR BACKGROUND 2          ; set a green background color
  4506.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4507.        COLOR BACKGROUND 4          ; set a red background color
  4508.        WRITE "Fantastic!"          ; write text in color
  4509.        WAIT 2                      ; pause to see text
  4510.     
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.                               --- Page: 81 ---                              
  4534.  
  4535.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4536.  
  4537.     FOREGROUND
  4538.     
  4539.     Syntax.:  COLOR FOREGROUND < <number> | <variable name> >
  4540.     
  4541.     Modes..:  + text, + graphic
  4542.     
  4543.     This command sets the foreground color, that determines which
  4544.     color some texts  are to be written in. Only  the foreground,
  4545.     not whats behind the letter, gets the color  by this command.
  4546.     Commands that are affected by this command are the following:
  4547.     WRITE and DRAW. The following foreground colors are available:
  4548.     
  4549.                0    is black            1    is blue
  4550.                2    is green            3    is cyan
  4551.                4    is red              5    is magenta
  4552.                6    is brown            7    is light grey
  4553.                8    is dark grey        9    is light blue
  4554.               10    is light green     11    is light cyan
  4555.               12    is light red       13    is light magenta
  4556.               14    is yellow          15    is white
  4557.     
  4558.     Instead of entering an exact number  as shown above,  you can
  4559.     also use a variable name as a parameter to this command.  The
  4560.     value of the variable will then be used to set the color.
  4561.     
  4562.     Example:
  4563.     
  4564.        COLOR BACKGROUND 2           ; set a green background color
  4565.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4566.        COLOR FOREGROUND 4          ; set a red foreground color
  4567.        WRITE "Fantastic!"          ; write text in color
  4568.        WAIT 2                      ; pause to see text
  4569.     
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.                               --- Page: 82 ---                              
  4590.  
  4591.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4592.  
  4593.     ATTRIBUTE
  4594.     
  4595.     Syntax.:  COLOR ATTRIBUTE < <number> | <variable name> >
  4596.     
  4597.     Modes..:  + text, + graphic
  4598.     
  4599.     This command sets the colors that some commands will be using
  4600.     when they are called.  Commands affected are MOTION and DRAW.
  4601.     The command has no effect in graphic mode, where all commands
  4602.     are printed in the colors set by FORE- and BACKGROUND, except
  4603.     the EFFECT GLITTER glitter command that also in both text and
  4604.     graphics mode is affected by the ATTRIBUTE setting.
  4605.     
  4606.     The attribute number  can be between 0 - 255.  The attribute
  4607.     consist of both fore- and background colors.  The table goes
  4608.     like this:
  4609.     
  4610.       0 -  15: black   background, with varying foreground color,
  4611.      16 -  31: blue    background, with varying foreground color,
  4612.      32 -  47: green   background, with varying foreground color,
  4613.      48 -  63: cyan    background, with varying foreground color,
  4614.      64 -  79: red     background, with varying foreground color,
  4615.      80 -  95: magenta background, with varying foreground color,
  4616.      96 - 111: brown   background, with varying foreground color,
  4617.     112 - 127: lt grey background, with varying foreground color.
  4618.     
  4619.     Then from there the table is more intense (or blinking on mo-
  4620.     nochrome screens.  The default value for attribute  is 31 for
  4621.     blue background with white foreground.
  4622.     
  4623.     The varying foreground colors follow the codes that are shown
  4624.     in the COLOR FOREGROUND command.
  4625.     
  4626.     Instead of entering an exact number  as shown above,  you can
  4627.     also use a variable name as a parameter to this command.  The
  4628.     value of the variable will then be used to set the color.
  4629.     
  4630.     Example:
  4631.     
  4632.        COLOR BACKGROUND 0          ; set a black background color
  4633.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4634.        COLOR ATTRIBUTE 79          ; set red back + white fore
  4635.        BOX 15 15                   ; draw a box (frame)
  4636.        WAIT 2                      ; pause to see box
  4637.     
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.                               --- Page: 83 ---                              
  4646.  
  4647.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4648.  
  4649.     GOXY
  4650.     
  4651.     Syntax.:  GOXY <x-coordinate> <y-coordinate>
  4652.     
  4653.     Modes..:  + text, + graphic
  4654.     
  4655.     This command places the cursor at the specified position. The
  4656.     screen starts at upper left corner, with coordinates 1,1. The
  4657.     lower right corner is 80,25.  So picture the screen as a lar-
  4658.     ge coordinate system,  where you can  place the cursor  where
  4659.     ever you wish within the boundaries.
  4660.     
  4661.     Instead of entering an exact number  as shown above,  you can
  4662.     also use a variable name as a parameter to this command.  The
  4663.     value of the variable will then be used to go to.
  4664.     
  4665.     This GOXY command  can be immidiately followed  by one of the
  4666.     WRITE,  DRAW,  READ  commands  on the  same line.  This makes
  4667.     scripts a bit smaller so they are more manageable  within the
  4668.     Script Center.  See example 2 here beneath.
  4669.     
  4670.     Example 1:
  4671.     
  4672.        SET CURSOR ON               ; make sure cursor is visible
  4673.        SCREEN CLEAR                ; cursor position is now 1,1
  4674.        GOXY 80 25                  ; now in rightmost corner
  4675.        WAIT 2                      ; pause to see cursor position
  4676.        GOXY 30 12                  ; approximately screen center
  4677.        WAIT 2                      ; pause to see cursor position
  4678.        WRITE "Whaouu"              ; write text at position
  4679.        WAIT 2                      ; pause to see text on screen
  4680.     
  4681.     Example 2:
  4682.     
  4683.        SET CURSOR ON               ; make sure cursor is visible
  4684.        SCREEN CLEAR                ; cursor position is now 1,1
  4685.        GOXY 30 12 WRITE "Whaouu"   ; position cursor and write
  4686.        WAIT 2                      ; pause to see text on screen
  4687.     
  4688.     Note that the  GOXY command works  the same way  in both text
  4689.     and graphics mode. This can sometimes make it a bit difficult
  4690.     exactly to figure out, where in graphics mode writing will be
  4691.     written,  since graphics writes can have bigger size letters.
  4692.     Try out different settings  until you're satisfied,  it isn't
  4693.     hard at all - you usually get it right the first time around.
  4694.     
  4695.  
  4696.  
  4697.  
  4698.  
  4699.  
  4700.  
  4701.                               --- Page: 84 ---                              
  4702.  
  4703.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4704.  
  4705.     WAIT
  4706.     
  4707.     Syntax.:  WAIT [<seconds> | "<text>"]
  4708.     
  4709.     Modes..:  + text, + graphic
  4710.     
  4711.     This command stops the script for a given amount of time.  It
  4712.     is useful to  stop  without asking the user to press any key,
  4713.     when for example you're using  DataShow  to  demonstrate your
  4714.     own program demo. Then when showing screens you can make them
  4715.     roll continuously on the screen. As you can see in the syntax
  4716.     there are a number of ways  the command works.
  4717.     
  4718.     You can  issue the command  without parameters  in which case
  4719.     script execution stops until a key is struck. You can specify
  4720.     to  stop script execution  for a given number of seconds.  Or
  4721.     you can stop the execution specifying a text to be written at
  4722.     the current coordinates and waiting for a key to be pushed.
  4723.     
  4724.     Whenever  a key is waited upon,  script execution is stopped.
  4725.     This is not always a good idea (eg. when running nonstop pre-
  4726.     sentations), so therefor you can use the WAIT command in con-
  4727.     junction with the SET TIMEOUT command.
  4728.     
  4729.     Wait in seconds can also be a decimal value. Thus the command
  4730.     WAIT 0.5 halts script execution for 1/2 a second. The minimum
  4731.     value for seconds is 0.1.
  4732.     
  4733.     Example:
  4734.     
  4735.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4736.        SHOW SCREEN "s1.scr" TXT    ; show file s1.scr
  4737.        WAIT 4                      ; pause to see screen
  4738.        SHOW SCREEN "s2.scr" TXT    ; show file s2.scr
  4739.        WAIT 4                      ; pause to see screen
  4740.        SCREEN CLEAR                ; start on a new fresh screen
  4741.        GOXY 5 24                   ; go to bottom of the screen
  4742.        WAIT "Push any key"         ; wait for a key to be pushed
  4743.        CONTINUE                    ; make script run forever
  4744.     
  4745.     Note that the script can be set to be halted temporarily with
  4746.     the SET DEBUG command.  This enables you  to see  a page with
  4747.     status information.
  4748.     
  4749.     Example:
  4750.     
  4751.        SET DEBUG ON                ; make ready for debugging
  4752.        VARIABLE CREATE n1 TYPE NUMBER 1  ; create variable
  4753.        VARIABLE CREATE n2 TYPE NUMBER 2  ; create variable
  4754.        VARIABLE CREATE n3 TYPE NUMBER 3  ; create variable
  4755.  
  4756.  
  4757.                               --- Page: 85 ---                              
  4758.  
  4759.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4760.  
  4761.        MATH n1 = n1 + 3            ; do calculation
  4762.        WAIT                        ; wait until keypressed
  4763.     
  4764.     Now in the last command you could hit <alt> + <d> and you can
  4765.     see the content of all the variables. This makes it easier to
  4766.     find errors in assignments to variables.
  4767.     
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.                               --- Page: 86 ---                              
  4814.  
  4815.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4816.  
  4817.     SPEAK
  4818.     
  4819.     Syntax.:  SPEAK <number> | <name> | "<text>"
  4820.     
  4821.     Modes..:  + text, + graphic
  4822.     
  4823.     This  command  sends  the number or the text given, to the PC
  4824.     speaker.  It must  be either a number, a  variable name  or a
  4825.     string of text, since they require different handling.
  4826.     
  4827.     NB: This command needs to figure out the speed of your compu-
  4828.     ter. Therefor it runs a test. This test reveals a wrong speed
  4829.     for your system,  if network or other resident software is in
  4830.     use. To obtain a maximum sound, unload any resident software.
  4831.     
  4832.     The number that can be spoken is a positive integer between 1
  4833.     and 32765.
  4834.     
  4835.     In the text string you can use the following phoneme codes to
  4836.     create the right sounds:
  4837.     
  4838.         CODE    SOUND   (capitalized in sample word)
  4839.         ----    -----
  4840.          A      mAke    =  m-A-k
  4841.          AE     bAt     =  b-AE-t
  4842.          AH     cAr     =  k-AH-r
  4843.          AW     dOg     =  d-AW-g
  4844.          B      Bat     =  B-ae-t
  4845.          CH     CHeese  =  CH-ee-z
  4846.          D      Dog     =  D-aw-g
  4847.          EE     bE      =  b-EE
  4848.          EH     bEt     =  b-EH-t
  4849.          F      raFt    =  r-ae-F-t
  4850.          G      Go      =  G-oh
  4851.          H      Hive    =  H-i-v
  4852.          I      tIme    =  t-I-m
  4853.          IH     sIt     =  s-IH-t
  4854.          J      Jet     =  J-eh-t
  4855.          K      Kill    =  K-ih-l
  4856.          L      Love    =  L-uh-v
  4857.          M      Map     =  M-ae-p
  4858.          N      Nab     =  N-ae-b
  4859.          OH     gO      =  g-OH
  4860.          OO     gOO     =  g-OO
  4861.          P      Pat     =  P-ae-t
  4862.          R      Rat     =  R-ae-t
  4863.          S      Sat     =  S-ae-t
  4864.          SH     SHe     =  SH-ee
  4865.          T      Tap     =  T-ae-p
  4866.          TH     THin    =  TH-ih-n
  4867.  
  4868.  
  4869.                               --- Page: 87 ---                              
  4870.  
  4871.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4872.  
  4873.          TZ     THis    =  TZ-ih-s
  4874.          U      wOrd    =  w-U-r-d
  4875.          UH     bUt     =  b-UH-t
  4876.          V      Vat     =  V-ae-t
  4877.          W      With    =  W-ih-th
  4878.          WH     WHich   =  WH-ih-ch
  4879.          Y      Yes     =  Y-eh-s
  4880.          Z      Zap     =  Z-ae-p
  4881.          ZH     viSion  =  v-ih-ZH-eh-n
  4882.          -      inter-phoneme separator
  4883.         space   inter-word pause
  4884.     
  4885.     We know it can be a tedious job to get the sounds right,  but
  4886.     if you try and try and try,  hopefully the time spent will be
  4887.     worth it.
  4888.     
  4889.     Example:
  4890.     
  4891.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  4892.        WRITE "Keep quiet"          ; write text
  4893.        SPEAK "N-O W-A-Y"           ; speak text through speaker
  4894.        WAIT 1                      ; pause before ending
  4895.     
  4896.  
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.                               --- Page: 88 ---                              
  4926.  
  4927.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4928.  
  4929.     MUSIC
  4930.     
  4931.     Syntax.:  MUSIC
  4932.                  < SOUND <notechar> <number> <number> >  |
  4933.                  < PROCESS "<filename>" <SND | WAV> >
  4934.     
  4935.     Modes..:  + text, + graphic
  4936.     
  4937.     This command has two separate functions,  both of which makes
  4938.     it possible to play music or make sounds however.
  4939.     
  4940.     Beneath here the two are mentioned separately.  Choose either
  4941.     of PROCESS or SOUND.
  4942.     
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.                               --- Page: 89 ---                              
  4982.  
  4983.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  4984.  
  4985.     PROCESS
  4986.     
  4987.     Syntax.:  MUSIC PROCESS "<filename>" SND |
  4988.     
  4989.               MUSIC PROCESS "<filename>" <WAV|VOC> <frequency> |
  4990.     
  4991.               MUSIC <QUIT|SUSPEND|RESUME>
  4992.     
  4993.     Modes..:  + text, + graphic
  4994.     
  4995.     This command either starts or stops a process that on the ba-
  4996.     sis of a file  keeps on playing music,  while other  commands
  4997.     are being executed. It is an alternative to the SOUND command
  4998.     where you directly can  create your  own music via  notes and
  4999.     specify durations,  but can't execute them in the background.
  5000.     
  5001.     The .SND DataShow music files can be created with an ordinary
  5002.     ASCII editor. Save the file you create to disk, and give this
  5003.     command from DataShow,  and the music can be heard via the PC
  5004.     speaker while other commands in your script are executed. See
  5005.     the syntax for ASCII file below.
  5006.     
  5007.     .SND files can only be played on the built in PC speaker, and
  5008.     no frequency has to be supplied (since it is given in the SND
  5009.     file itself).
  5010.     
  5011.     WAV and VOC  type files  are raw sound files  and they can be
  5012.     played on the PC speaker, an Adlib or Sound Blaster according
  5013.     to the setting of the INSTALL SOUND command.
  5014.     
  5015.     The .WAV Windows music files can be created via some programs
  5016.     that you can get for MicroSoft Windows v. 3.x (tm).  You have
  5017.     to supply a frequency with this command.  You can try out se-
  5018.     veral values until you find the right value,  where the sound
  5019.     is the best it can be on the internal PC speaker, to an Adlib
  5020.     or Sound Blaster Card. Usually the Wave files that comes with
  5021.     Windows has a frequency of 12MHz.
  5022.     
  5023.     The .VOC music files are files that exists in abundance. They
  5024.     include music and speach.  As is the case with .WAV files you
  5025.     must supply a frequency. Trial and error is the best way.  If
  5026.     the sound sounds slow like a record running at too slow speed
  5027.     you must increase the frequency.  You must decrease the freq-
  5028.     uency if the sounds goes too fast.
  5029.     
  5030.     PLEASE NOTE, This has been changed from Version 4.2A:
  5031.     -----------------------------------------------------
  5032.     Frequencies can be in the range 20-44400,  so examples of of-
  5033.     ten used frquencies looks like this:
  5034.     
  5035.  
  5036.  
  5037.                               --- Page: 90 ---                              
  5038.  
  5039.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5040.  
  5041.                     For   8MHz the value is   8000
  5042.                     For  12MHz the value is  12000
  5043.                     For  23MHz the value is  23000
  5044.     
  5045.     With the registered version of DataShow you get a large bunch
  5046.     of .WAV files ready for you to play!
  5047.     
  5048.     Example 1:
  5049.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5050.        WRITE "Playing music.."     ; write text on the screen
  5051.        MUSIC PROCESS "m1.snd" SND  ; start a music file
  5052.     
  5053.     Example 2:
  5054.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5055.        WRITE "Playing music.."     ; write text on the screen
  5056.        MUSIC PROCESS "beback.wav" WAV 12000 ; start a music file
  5057.     
  5058.     This command is still under construction. The syntax shown a-
  5059.     bove is correct, but the command doesn't work as a background
  5060.     process.  You can only issue  the command,  and then wait for
  5061.     the process to stop. A utility is supplied to create DataShow
  5062.     sound files from PianoMan v. 4 files, look further below!
  5063.     
  5064.     The syntax for the .SND file goes like this; On the first li-
  5065.     ne there has to be a semicolon followed directly  by the word
  5066.     DataShow.  Then there has to be one or more lines, where each
  5067.     line represents a sound (frequency) and the time the sound is
  5068.     to be played (duration). An example is the following:
  5069.     
  5070.              ;DataShow music file: Noise.snd
  5071.              Freq:   1564   Dur: 360
  5072.              Freq:   1315   Dur: 360
  5073.              Freq:   1756   Dur: 540
  5074.              Freq:   1756   Dur: 180
  5075.              Freq:   1394   Dur: 360
  5076.              Freq:   1172   Dur: 360
  5077.              Freq:   1564   Dur: 540
  5078.              Freq:   1564   Dur: 180
  5079.              Freq:   1315   Dur: 360
  5080.              Freq:   1044   Dur: 360
  5081.              Freq:   1394   Dur: 360
  5082.              Freq:   1172   Dur: 360
  5083.              Freq:   1564   Dur: 540
  5084.              Freq:   1564   Dur: 180
  5085.              Freq:   1044   Dur: 720
  5086.     
  5087.     The example music file shown above is supplied with the SHOW-
  5088.     UTIL pack. It is shipped  together with DataShow when you re-
  5089.     gister  by following  the method  described  in the  enclosed
  5090.     INFO.TXT text file.
  5091.  
  5092.  
  5093.                               --- Page: 91 ---                              
  5094.  
  5095.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5096.  
  5097.     
  5098.     To calculate the frequency used in DataShow  you can use this
  5099.     formula:
  5100.     
  5101.              Frequency is set to 32.625
  5102.     
  5103.              For 1 to Octave
  5104.                  Frequency is set to Frequency times 2
  5105.     
  5106.              For 1 to NoteValue-1
  5107.                  Frequency is set to Frequency times 1.059463094
  5108.     
  5109.              The Duration is supplied in milliseconds
  5110.     
  5111.     NoteValues are:
  5112.     
  5113.              C=1, CF=2, D=3, DF=4, E=5, F=6, FF=7,
  5114.              G=8, GF=9, A=10, AS=11, B=12.
  5115.     
  5116.     Alternatively you can use the SHOWUTIL pack to create a .SND
  5117.     file by entering notes, octaves and durations.
  5118.     
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.                               --- Page: 92 ---                              
  5150.  
  5151.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5152.  
  5153.     SOUND
  5154.     
  5155.     Syntax.:  MUSIC SOUND <notechar> <number> <number>
  5156.     
  5157.     Modes..:  + text, + graphic
  5158.     
  5159.     This command makes it possible to generate sounds.  When cal-
  5160.     led the command requires a character symbolizing a note (A-G,
  5161.     AS,CF,DF,GF,FF). Then a number for the octave,  and finally a
  5162.     number giving the duration  of the sound.  So by making loops
  5163.     you can create music on your own.
  5164.     
  5165.     Example:
  5166.     
  5167.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5168.        GOXY 1 3                    ; move to new location
  5169.        WRITE "TELEPHONE.."         ; write text
  5170.        VARIABLE CREATE loop 1 TYPE NUMBER   ; to control loop
  5171.        MARK 1                      ; set a mark to jump to
  5172.        MUSIC SOUND G 4 70          ; sound G in octave in m.secs.
  5173.        MUSIC SOUND D 4 70          ; sound D in octave in m.secs.
  5174.        VARIABLE INCREASE loop 1    ; increment control variable
  5175.        IF loop EQ 8 DO JUMPMARK 2  ; test the variable
  5176.        JUMPMARK 1                  ; if we're here, go to mark 1
  5177.        MARK 2                      ; set a mark to jump to
  5178.        VARIABLE RELEASE loop       ; clean up after us
  5179.        WAIT 1                      ; pause before returning
  5180.     
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.  
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.                               --- Page: 93 ---                              
  5206.  
  5207.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5208.  
  5209.     EFFECT
  5210.     
  5211.     Syntax.:  EFFECT <SCROLL | FADE | GLITTER | TEXTTYPE | POINT>
  5212.     
  5213.     As you can see,  there are several different types of parame-
  5214.     ters to this command.  Choose the one  you wish to have  more
  5215.     information about.
  5216.     
  5217.         SCROLL        FADE         GLITTER
  5218.     
  5219.         TEXTTYPE      POINT
  5220.     
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.                               --- Page: 94 ---                              
  5262.  
  5263.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5264.  
  5265.     EFFECT SCROLL
  5266.     
  5267.     Syntax.:  EFFECT SCROLL <UP | DOWN>
  5268.     
  5269.     Modes..:  + text, + graphic
  5270.     
  5271.     This command scrolls the  entire screen one line UP  or DOWN,
  5272.     with all text on the screen being moved. The new line at the
  5273.     bottom or  at the top of the screen,  will have the color set
  5274.     by the COLOR command.
  5275.     
  5276.     Example:
  5277.     
  5278.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5279.        GOXY 10 10                  ; move position to 10,10
  5280.        WRITE "Here"                ; print text at position
  5281.        VARIABLE CREATE loop 1 TYPE NUMBER  ; variable for loops
  5282.        MARK 1                      ; mark a place to jump to
  5283.        EFFECT SCROLL UP            ; move all screen one place up
  5284.        IF loop EQ 10 DO JUMPMARK 2 ; test the variable
  5285.        VARIABLE INCREASE loop 1    ; increment loop variable
  5286.        JUMPMARK 1                  ; if reached here, goto mark 1
  5287.        MARK 2                      ; jump to here if loop is 10
  5288.     
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.  
  5308.  
  5309.  
  5310.  
  5311.  
  5312.  
  5313.  
  5314.  
  5315.  
  5316.  
  5317.                               --- Page: 95 ---                              
  5318.  
  5319.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5320.  
  5321.     EFFECT FADE
  5322.     
  5323.     Syntax.:  EFFECT FADE  <IN | OUT | BOTH>
  5324.     
  5325.     Modes..:  + text, + graphic
  5326.     
  5327.     This command either fades the screen in, fades the screen out
  5328.     or does first a fade out and then a fade in (this is the BOTH
  5329.     command).
  5330.     
  5331.     Example:
  5332.     
  5333.        SET GRAPHICS EGA1           ; initialize graphics
  5334.        SHOW SCREEN "g1.gra" GRA    ; show file called g1.gra
  5335.        WAIT 2                      ; pause to see picture
  5336.        EFFECT FADE OUT             ; slowly clear out the screen
  5337.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5338.        WRITE "Text again"          ; continue as usual
  5339.        WAIT 2                      ; pause to see text
  5340.     
  5341.     Please note that this command requires a VGA or better screen
  5342.     but  on such a screen it  will work  in text and all graphics
  5343.     modes.
  5344.     
  5345.     
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.                               --- Page: 96 ---                              
  5374.  
  5375.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5376.  
  5377.     EFFECT GLITTER
  5378.     
  5379.     Syntax.:  EFFECT GLITTER
  5380.     
  5381.     Modes..:  + text, + graphic
  5382.     
  5383.     This command works equally well in text and graphics mode. It
  5384.     fills the screen with blanks and the COLOR ATTRIBUTE setting.
  5385.     
  5386.     The effect is that the screen is blanked out  in a "firework"
  5387.     sort of way. You can then continue with the next command.
  5388.     
  5389.     Example:
  5390.     
  5391.        SHOW SCREEN "s1.scr" TXT    ; show file s1.scr
  5392.        WAIT 2                      ; pause to see screen
  5393.        EFFECT GLITTER              ; make the image disappear
  5394.        SHOW SCREEN "s2.scr" TXT    ; show file s2.scr
  5395.        WAIT 2                      ; pause to see screen
  5396.     
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.                               --- Page: 97 ---                              
  5430.  
  5431.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5432.  
  5433.     EFFECT TEXTTYPE
  5434.     
  5435.     Syntax.:  EFFECT TEXTTYPE <font-number> <size-number>
  5436.     
  5437.     Modes..:  + text, + graphic
  5438.     
  5439.     This command makes it possible for you to change the style in
  5440.     which graphic writes are to be done.  The command have no in-
  5441.     fluence on textmode writes.
  5442.     
  5443.     The first parameter you specify is a number that tell which
  5444.     character font you wish to have displayed. Choose between:
  5445.     
  5446.                  0  Default    (8x8 Bitmapped font)
  5447.                  1  Triplex    (stroked font)
  5448.                  2  Sansserif  (stroked font)
  5449.                  3  Script     (stroked font)
  5450.                  4  - User installed font
  5451.     
  5452.     The command can be used in conjunction  with the INSTALL FONT
  5453.     if you want to install a font yourself,  and then make it the
  5454.     current one. (That is the "4" parameter above).
  5455.     
  5456.     With the second parameter  you tell which size  you want  the
  5457.     font displayed in. You can have numbers between 1 and 10 with
  5458.     1 being the smallest and 10 the largest.
  5459.     
  5460.     Example:
  5461.     
  5462.        SET GRAPHICS EGA1           ; make sure we're in graphics
  5463.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5464.        GOXY 10 10                  ; set current coordinates
  5465.        EFFECT TEXTTYPE 1 6         ; change font and size
  5466.        WRITE "IMPORTANT"           ; print text on blank screen
  5467.        WAIT 2                      ; pause to see text
  5468.        GOXY 10 20                  ; set current coordinates
  5469.        EFFECT TEXTTYPE 0 1         ; change default font and size
  5470.        WRITE "This is normal"      ; print text on blank screen
  5471.        WAIT 2                      ; pause to see text
  5472.     
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.                               --- Page: 98 ---                              
  5486.  
  5487.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5488.  
  5489.     EFFECT POINT
  5490.     
  5491.     Syntax.:  EFFECT POINT <x-coordinate> <y-coordinate>
  5492.     
  5493.     Modes..:  + text, + graphic
  5494.     
  5495.     This command is used to show an  arrow  on the screen.  So if
  5496.     you wish to point out a specific place on the screen, you is-
  5497.     sue  this  command,  with  similar  coordinates  as the  GOXY
  5498.     command. But the x, and y coordinates set by GOXY are not as-
  5499.     fected by the POINT command.
  5500.     
  5501.     Example:
  5502.     
  5503.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5504.        GOXY 10 10                  ; set current coordinates
  5505.        WRITE "IMPORTANT"           ; print text on blank screen
  5506.        WAIT 2                      ; pause to see text
  5507.        EFFECT POINT 10 9           ; print arrow on screen
  5508.        WAIT 2                      ; pause to see text
  5509.     
  5510.  
  5511.  
  5512.  
  5513.  
  5514.  
  5515.  
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.                               --- Page: 99 ---                              
  5542.  
  5543.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5544.  
  5545.     DRAW
  5546.     
  5547.     Syntax.:  DRAW <BOX | LINE | CIRCLE | BAR>
  5548.     
  5549.     Modes..:  + text, + graphic
  5550.     
  5551.     This command  has several different  parameters.  Choose  the
  5552.     one you wish to have more information about.
  5553.     
  5554.        BOX      LINE       CIRCLE     BAR
  5555.     
  5556.  
  5557.  
  5558.  
  5559.  
  5560.  
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.  
  5570.  
  5571.  
  5572.  
  5573.  
  5574.  
  5575.  
  5576.  
  5577.  
  5578.  
  5579.  
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.  
  5588.  
  5589.  
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.                              --- Page: 100 ---                              
  5598.  
  5599.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5600.  
  5601.     DRAW BOX
  5602.     
  5603.     Syntax.:  DRAW BOX <length> <height>
  5604.     
  5605.     Modes..:  + text, + graphic
  5606.     
  5607.     This command draws a frame from the current x and y coordina-
  5608.     tes with the length and height specified on the command line.
  5609.     The box must  fit within the coordinates of the screen set by
  5610.     the  current  settings of the  x-coordinate and y-coordinate,
  5611.     which are set by the GOXY command. The command can be useful
  5612.     in cases where you wish to have a box (frame) printed  around
  5613.     a WINDOW. The color is set by COLOR.
  5614.     
  5615.     Example:
  5616.     
  5617.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5618.        GOXY 10 10                  ; move position to 10,10
  5619.        DRAW BOX 5 10               ; print frame at position
  5620.        WAIT 2                      ; pause to see box
  5621.     
  5622.  
  5623.  
  5624.  
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.                              --- Page: 101 ---                              
  5654.  
  5655.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5656.  
  5657.     DRAW LINE
  5658.     
  5659.     Syntax.:  DRAW LINE <length-number>
  5660.     
  5661.     Modes..:  + text, + graphic
  5662.     
  5663.     This command prints a line on the screen, with the length gi-
  5664.     ven at the command line.  The line can be a  single line or a
  5665.     double line  according to the  setting of the SET DOUBLELINE
  5666.     command.  The line  is drawn  in the  current back- and fore-
  5667.     ground colors.
  5668.     
  5669.     Example:
  5670.     
  5671.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5672.        SET DOUBLELINE OFF          ; set single lines writes
  5673.        DRAW LINE 10                ; write single line
  5674.        WAIT 2                      ; pause to see cursor position
  5675.        GOXY 1 3                    ; move to new location
  5676.        SET DOUBLELINE ON           ; write double lines
  5677.        DRAW LINE 10                ; write double lines
  5678.        WAIT 2                      ; pause to see cursor position
  5679.     
  5680.  
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.                              --- Page: 102 ---                              
  5710.  
  5711.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5712.  
  5713.     DRAW CIRCLE
  5714.     
  5715.     Syntax.:  DRAW CIRCLE <radius-number>
  5716.     
  5717.     Modes..:  - text, + graphic
  5718.     
  5719.     This command draws  a circle in the color defined by the cur-
  5720.     rent COLOR setting.  The middle point of the circle is set by
  5721.     the GOXY command.  The radius is a positive number that auto-
  5722.     matically is scaled according to the current size of the
  5723.     screen. So a number of 1 will make a small circle an a number
  5724.     of 10 will make a large circle in any graphics mode.
  5725.     
  5726.     The command only has meaning in graphic scripts  (since it is
  5727.     impossible to make circles in text mode),  but no error  will
  5728.     occur is you give this command in text mode.
  5729.     
  5730.     Example:
  5731.     
  5732.        SET GRAPHICS EGA2           ; make sure we're in graphics
  5733.        GOXY 10 10                  ; current position is set
  5734.        DRAW CIRCLE 1               ; draw small circle at place
  5735.        WAIT 2                      ; pause to see picture
  5736.        DRAW CIRCLE 10              ; draw large circle at place
  5737.        WAIT 2                      ; pause to see picture
  5738.     
  5739.  
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.  
  5750.  
  5751.  
  5752.  
  5753.  
  5754.  
  5755.  
  5756.  
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.  
  5763.  
  5764.  
  5765.                              --- Page: 103 ---                              
  5766.  
  5767.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5768.  
  5769.     DRAW BAR
  5770.     
  5771.     Syntax.:  DRAW BAR <length> <height>
  5772.     
  5773.     Modes..:  - text, + graphic
  5774.     
  5775.     This command draws a bar from the current x and y coordinates
  5776.     with the length and height specified on the command line. The
  5777.     bar must  fit within the coordinates of the screen set by the
  5778.     current settings of the  x-coordinate and y-coordinate, which
  5779.     are set by the GOXY command.  The command can be useful
  5780.     in cases where you wish to have an area  blanked out with the
  5781.     current foreground color set by COLOR.
  5782.     
  5783.     Example:
  5784.     
  5785.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5786.        GOXY 10 10                  ; move position to 10,10
  5787.        DRAW BAR 5 10               ; print bar at position
  5788.        WAIT 2                      ; pause to see bar
  5789.     
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.  
  5816.  
  5817.  
  5818.  
  5819.  
  5820.  
  5821.                              --- Page: 104 ---                              
  5822.  
  5823.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5824.  
  5825.     SET
  5826.     
  5827.     Syntax.:  SET <parameter>
  5828.     
  5829.     This command has many parameters,  that can be switched on or
  5830.     off.  Beneath here, the different parameters are shown, toge-
  5831.     ther with their default states. Simply choose which parameter
  5832.     you wish to see described.
  5833.     
  5834.         GRAPHICS       DELAYFACTOR    SHADOW
  5835.     
  5836.         CURSOR         TIMEOUT        ESCAPEKEY
  5837.     
  5838.         TEXTSOUND      DOUBLELINE     DEBUG
  5839.     
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.  
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.                              --- Page: 105 ---                              
  5878.  
  5879.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5880.  
  5881.     SET GRAPHICS
  5882.     
  5883.     Syntax.:  SET GRAPHICS <OFF | CGA | EGA1 | EGA2 | VGA1 |
  5884.                                   VGA2 | SVGA1 | SVGA2>
  5885.     
  5886.     Modes..:  + text, + graphic
  5887.     
  5888.     This command either starts  or stops  the use of the graphics
  5889.     mode.  Many commands work  in the same way  regardless of the
  5890.     video mode. However many texts looks more interesting in gra-
  5891.     phics mode, since they are more easy to see.
  5892.     
  5893.     So by specifying a graphicsmode as the parameter to this com-
  5894.     mand, you'll switch DataShow into that graphics mode if it is
  5895.     possible given your graphics adapter.
  5896.     
  5897.     The possible values are:
  5898.     
  5899.        Value:       Adapters supported:          Resolution:
  5900.     
  5901.        CGA          CGA, EGA, VGA, SVGA, XGA     320x200x16
  5902.        EGA1         EGA, VGA, SVGA, XGA          640x200x16
  5903.        EGA2         EGA, VGA, SVGA, XGA          640x350x16
  5904.        VGA1         MCGA, VGA, SVGA, XGA         640x480x16
  5905.        VGA2         MCGA, VGA, SVGA, XGA         320x200x256
  5906.        SVGA1        SVGA/VESA                    640x480x256
  5907.        SVGA2        SVGA/VESA                    800x600x256
  5908.     
  5909.     The default value that is used for the SHOW SCREEN <filename>
  5910.     GRA command is EGA1,  except if DataShow finds  that you only
  5911.     have a CGA monitor  in which case the default will be set  to
  5912.     CGA.
  5913.     
  5914.     Note:  Since some of the SHOW SCREEN  commands  (PCX and GIF)
  5915.     manipulates  the colors on the  graphics screen  quite a bit,
  5916.     DataShow  has to  switch  back  and forth  between text-  and
  5917.     graphicsmode to reset the screen.
  5918.     
  5919.     The default setting  for  SET GRAPHICS,  at the  beginning of
  5920.     DataShow is OFF however,  since many programs still use text-
  5921.     mode screens only.
  5922.     
  5923.     Example:
  5924.     
  5925.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  5926.        SET DELAYFACTOR 4           ; set for slow writes
  5927.        GOXY 10 10                  ; move position to 10,10
  5928.        WRITE "NOW TEXTMODE"        ; print text at position
  5929.        WAIT 2                      ; pause to see cursor position
  5930.        SET GRAPHICS EGA1           ; switch into graphics mode
  5931.  
  5932.  
  5933.                              --- Page: 106 ---                              
  5934.  
  5935.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5936.  
  5937.        GOXY 10 10                  ; move to line 18,20 places in
  5938.        WRITE "NOW GRAPHICS"        ; print text at position
  5939.        WAIT 2                      ; pause to see cursor position
  5940.     
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.  
  5980.  
  5981.  
  5982.  
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.  
  5989.                              --- Page: 107 ---                              
  5990.  
  5991.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  5992.  
  5993.     SET DELAYFACTOR
  5994.     
  5995.     Syntax.:  SET DELAYFACTOR <number>
  5996.     
  5997.     Modes..:  + text, + graphic
  5998.     
  5999.     This command  controls  various output to screen.  By setting
  6000.     the delayfactor you control how long time in 1/10 of a second
  6001.     the is between writes with the WRITE command.
  6002.     
  6003.     Example:
  6004.     
  6005.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6006.        GOXY 1 8                    ; set coordinates
  6007.        WRITE "Now fast"            ; print text at position
  6008.        WAIT 4                      ; wait to see text
  6009.        GOXY 1 10                   ; show file screen2.scr
  6010.        SET DELAYFACTOR 5           ; make text slower on screen
  6011.        WRITE "Now slow"            ; same result as above
  6012.        WAIT 2                      ; wait to see text
  6013.     
  6014.  
  6015.  
  6016.  
  6017.  
  6018.  
  6019.  
  6020.  
  6021.  
  6022.  
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.  
  6030.  
  6031.  
  6032.  
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.  
  6044.  
  6045.                              --- Page: 108 ---                              
  6046.  
  6047.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6048.  
  6049.     SET SHADOW
  6050.     
  6051.     Syntax.:  SET SHADOW <OFF | <number>>
  6052.     
  6053.     Modes..:  + text, + graphic
  6054.     
  6055.     This command makes it possible for you to have several of the
  6056.     write functions to display a shadow. This makes an effectfull
  6057.     presentation.
  6058.     
  6059.     The command has no effect in text mode.
  6060.     
  6061.     The number  that is used is the same  as COLOR FOREGROUND for
  6062.     all screens that has 0-15 different colors,  and in the range
  6063.     0-255 for screens that has modes up to 256 different colors.
  6064.     
  6065.     Example:
  6066.     
  6067.        SET GRAPHICS EGA1           ; switch into graphics mode
  6068.        GOXY 10 10                  ; move to line 10,10 places in
  6069.        WRITE "NOW NO SHADOW"       ; print text at position
  6070.        WAIT 2                      ; pause to see cursor position
  6071.        SET SHADOW 3                ; set the shadow attribute
  6072.        GOXY 10 20                  ; move to line 20,10 places in
  6073.        WRITE "NOW A SHADOW"        ; print text at position
  6074.        WAIT 2                      ; pause to see cursor position
  6075.     
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.  
  6089.  
  6090.  
  6091.  
  6092.  
  6093.  
  6094.  
  6095.  
  6096.  
  6097.  
  6098.  
  6099.  
  6100.  
  6101.                              --- Page: 109 ---                              
  6102.  
  6103.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6104.  
  6105.     SET CURSOR
  6106.     
  6107.     Syntax.:  SET CURSOR  ON | OFF
  6108.     
  6109.     Modes..:  + text, + graphic
  6110.     
  6111.     This command controls the cursor. When turned on,  the cursor
  6112.     is shown as a small blinking line in the current location se-
  6113.     lected by GOXY.  When turned off,  the cursor is not shown
  6114.     on the screen.  Default (at the start of DataShow) the cursor
  6115.     is ON.
  6116.     
  6117.     The command can be issued in both text and graphics mode.  In
  6118.     textmode the function is as described above. In graphics mode
  6119.     however the command is just ignored.  In graphics mode  there
  6120.     is no visible cursor.
  6121.     
  6122.     Example:
  6123.     
  6124.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6125.        SET CURSOR ON               ; make sure we see the cursor
  6126.        GOXY 10 10                  ; move position to 10,10
  6127.        WRITE "NOW HERE"            ; print text at position
  6128.        WAIT 2                      ; pause to see cursor position
  6129.        SET CURSOR OFF              ; turn cursor off
  6130.        GOXY 20 18                  ; move to line 18,20 places in
  6131.        WRITE "NOW GONE"            ; print text at position
  6132.        WAIT 2                      ; pause to see cursor position
  6133.     
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.  
  6149.  
  6150.  
  6151.  
  6152.  
  6153.  
  6154.  
  6155.  
  6156.  
  6157.                              --- Page: 110 ---                              
  6158.  
  6159.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6160.  
  6161.     SET TIMEOUT
  6162.     
  6163.     Syntax.:  SET TIMEOUT <number>
  6164.     
  6165.     Modes..:  + text, + graphic
  6166.     
  6167.     This command lets you set a time for which the WAIT command
  6168.     will wait  for a key  to be pressed.  If the number is 0, the
  6169.     command will always wait for any key to be pressed.  A number
  6170.     greater than 0 will wait for that number of seconds, and then
  6171.     continue the next command in the script file.  This is useful
  6172.     when you do not want  a script to stop running,  just because
  6173.     nobody has touched the keyboard.  Default (at program start),
  6174.     the value for TIMEOUT is 0, which means that when a WAIT com-
  6175.     mand is issued, the script will await a key press.
  6176.     
  6177.     Example:
  6178.     
  6179.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6180.        SET TIMEOUT 5               ; set timeout time to 5 secs.
  6181.        WAITKEY "Any key"           ; wait for any key for 5 secs.
  6182.        GOXY 10 10                  ; position cursor on screen
  6183.        WRITE "Here we go"          ; key pushed or 5 secs. passed
  6184.        SET TIMEOUT 0               ; resets, to force key input
  6185.        WAIT "Any key"              ; wait for any key (will wait)
  6186.     
  6187.  
  6188.  
  6189.  
  6190.  
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.  
  6197.  
  6198.  
  6199.  
  6200.  
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.  
  6212.  
  6213.                              --- Page: 111 ---                              
  6214.  
  6215.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6216.  
  6217.     SET ESCAPEKEY
  6218.     
  6219.     Syntax.:  SET ESCAPEKEY  OFF | <number>
  6220.     
  6221.     Modes..:  + text, + graphic
  6222.     
  6223.     This command makes it possible to turn on or off the possibi-
  6224.     lity to interrupt scriptfiles with  a given key.  If a script
  6225.     should continue to run no matter which key is pressed, speci-
  6226.     fy OFF.  If you wish to have the possibility to stop the exe-
  6227.     cution of  a script at any time, the number you write  in the
  6228.     command is the ASCII number associated with a key,  eg. 27 is
  6229.     the <Esc> key.
  6230.     
  6231.     By default  (at the beginning of DataShow) it is  possible to
  6232.     stop a script by using the <Esc> key.
  6233.     
  6234.     Example:
  6235.     
  6236.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6237.        SET ESCAPEKEY 81            ; script can stop with Q key
  6238.        WRITE "NOW ON"              ; print text at position
  6239.        GOXY 10 10                  ; write at new location
  6240.        WRITE "Use key <Q>"         ; print text at new location
  6241.        WAIT 2                      ; pause to see cursor position
  6242.        SCREEN CLEAR                ; blank out entire screen
  6243.        SET ESCAPEKEY OFF           ; script cannot be stopped
  6244.        WRITE "NOW OFF"             ; print text at position
  6245.        WAIT 2                      ; pause to see cursor position
  6246.     
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.  
  6253.  
  6254.  
  6255.  
  6256.  
  6257.  
  6258.  
  6259.  
  6260.  
  6261.  
  6262.  
  6263.  
  6264.  
  6265.  
  6266.  
  6267.  
  6268.  
  6269.                              --- Page: 112 ---                              
  6270.  
  6271.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6272.  
  6273.     SET TEXTSOUND
  6274.     
  6275.     Syntax.:  SET TEXTSOUND  ON | OFF
  6276.     
  6277.     Modes..:  + text, + graphic
  6278.     
  6279.     This command control sound when text is written on screen. If
  6280.     turned on, a sound will be heard when each letter is written.
  6281.     If turned off, no sound is heard. See also WRITE. Default (at
  6282.     the start of DataShow) textsound is OFF.    Textsound is con-
  6283.     trolled together with the SET DELAYFACTOR setting.  Textsound
  6284.     is not related to the MUSIC SOUND command.
  6285.     
  6286.     Example:
  6287.     
  6288.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6289.        SET DELAYFACTOR 4           ; setup for slow printing
  6290.        SET TEXTSOUND OFF           ; set silence first
  6291.        GOXY 10 10                  ; move position to 10,10
  6292.        WRITE "Silence"             ; print text at position
  6293.        WAIT 2                      ; pause to see cursor position
  6294.        SET TEXTSOUND ON            ; turn writing sound on
  6295.        GOXY 20 18                  ; move to line 18,20 places in
  6296.        WRITE "Hear this"           ; print text at position
  6297.        WAIT 2                      ; pause to see cursor position
  6298.     
  6299.  
  6300.  
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.                              --- Page: 113 ---                              
  6326.  
  6327.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6328.  
  6329.     SET DOUBLELINE
  6330.     
  6331.     Syntax.:  SET DOUBLELINE  ON | OFF
  6332.     
  6333.     Modes..:  + text, + graphic
  6334.     
  6335.     This command specifies that lines written by certain commands
  6336.     are to be printed with or without double borders. The default
  6337.     setting is OFF, and then only one line will show.   If set to
  6338.     ON, two lines next to each other will be shown.  See also the
  6339.     DRAW LINE command.
  6340.     
  6341.     Example:
  6342.     
  6343.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6344.        SET DOUBLELINE OFF          ; set single lines print
  6345.        LINE 10                     ; print line at position
  6346.        WAIT 2                      ; pause to see cursor position
  6347.        GOXY 1 3                    ; move to new location
  6348.        SET DOUBLELINE ON           ; write double lines
  6349.        LINE 10                     ; write double lines
  6350.        WAIT 2                      ; pause to see cursor position
  6351.     
  6352.  
  6353.  
  6354.  
  6355.  
  6356.  
  6357.  
  6358.  
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.  
  6365.  
  6366.  
  6367.  
  6368.  
  6369.  
  6370.  
  6371.  
  6372.  
  6373.  
  6374.  
  6375.  
  6376.  
  6377.  
  6378.  
  6379.  
  6380.  
  6381.                              --- Page: 114 ---                              
  6382.  
  6383.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6384.  
  6385.     SET DEBUG
  6386.     
  6387.     Syntax.:  SET DEBUG  ON | OFF
  6388.     
  6389.     Modes..:  + text, - graphic
  6390.     
  6391.     This command let you halt a script with the <alt+d> keys. You
  6392.     simply set this command to ON and then with the <alt> and the
  6393.     <d> keys pressed together, a page of current information will
  6394.     be shown.  After you press enter, you will be returned to the
  6395.     exact same spot, where you interrupted the script. This makes
  6396.     it easy to trace the value of variables  at certain places in
  6397.     your script. Once you have completed your script and it works
  6398.     as it should you could just  remove this line from the script
  6399.     before sending it out. The default setting is OFF.
  6400.     
  6401.     Note that when you are in a READ command, you cannot halt the
  6402.     script with <alt+d>.  The best way to make "breakpoints" in a
  6403.     script  is to issue eg. a WAIT command  and at that point hit
  6404.     the <alt+d> key combination.
  6405.     
  6406.     Example:
  6407.     
  6408.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6409.        SET DEBUG ON                ; make script debugable
  6410.        VARIABLE CREATE test TYPE NUMBER 1  ; make a variable
  6411.        WAIT 10                     ; now <alt+d> will show status
  6412.     
  6413.  
  6414.  
  6415.  
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.  
  6423.  
  6424.  
  6425.  
  6426.  
  6427.  
  6428.  
  6429.  
  6430.  
  6431.  
  6432.  
  6433.  
  6434.  
  6435.  
  6436.  
  6437.                              --- Page: 115 ---                              
  6438.  
  6439.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6440.  
  6441.     DO
  6442.     
  6443.     Syntax.:  DO "<filename>"
  6444.     
  6445.     Modes..:  + text, + graphic
  6446.     
  6447.     This command executes another scriptfile. You thereby get the
  6448.     chance to branch into a submodule from your program.  Once in
  6449.     another submodule, you cannot branch from that submodule into
  6450.     other submodules.  You are restricted to only branch into one
  6451.     submodule at a time.  Back in the  main program you can again
  6452.     branch to another or the same submodule.
  6453.     
  6454.     Example:
  6455.     
  6456.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6457.        WRITE "Main file"           ; print text at position
  6458.        WAIT 2                      ; pause to see text
  6459.        DO "file2.shw"              ; branch to other scriptfile
  6460.     
  6461.        ; File 2
  6462.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6463.        GOXY 10 10                  ; move position to 10,10
  6464.        WRITE "In file2"            ; print text at position
  6465.        WAIT 2                      ; pause to see text
  6466.        ; End file 2
  6467.     
  6468.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6469.        WRITE "I am back"           ; print text at position
  6470.        WAIT 2                      ; pause to see text
  6471.     
  6472.     Note that when  a script is tokenized,  the extension  of all
  6473.     .SHW files are changed to .TOK.  This is also done  in all DO
  6474.     commands automatically.
  6475.     
  6476.  
  6477.  
  6478.  
  6479.  
  6480.  
  6481.  
  6482.  
  6483.  
  6484.  
  6485.  
  6486.  
  6487.  
  6488.  
  6489.  
  6490.  
  6491.  
  6492.  
  6493.                              --- Page: 116 ---                              
  6494.  
  6495.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6496.  
  6497.     MARK
  6498.     
  6499.     Syntax.:  MARK <name | number>
  6500.     
  6501.     Modes..:  + text, + graphic
  6502.     
  6503.     This command  sets a marker  in a  script file.  Then you can
  6504.     jump to that location with the JUMPMARK command.   It is easy
  6505.     to control  the sequence  of transactions  in the script with
  6506.     this command. Marks can be any name or number.  Eg. gotohere1
  6507.     or just 1.
  6508.     
  6509.     Example:
  6510.     
  6511.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6512.        GOXY 20 10                  ; position place to write text
  6513.        WRITE "Hello there"         ; display text
  6514.        MARK 1                      ; set a marker
  6515.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6516.        GOXY 10 10                  ; position place to write text
  6517.        WRITE "Hello here"          ; display text
  6518.        JUMPMARK 1                  ; next command is executed
  6519.     
  6520.  
  6521.  
  6522.  
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.  
  6533.  
  6534.  
  6535.  
  6536.  
  6537.  
  6538.  
  6539.  
  6540.  
  6541.  
  6542.  
  6543.  
  6544.  
  6545.  
  6546.  
  6547.  
  6548.  
  6549.                              --- Page: 117 ---                              
  6550.  
  6551.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6552.  
  6553.     JUMPMARK
  6554.     
  6555.     Syntax.:  JUMPMARK <name | number>
  6556.     
  6557.     Modes..:  + text, + graphic
  6558.     
  6559.     This command together with the MARK command, lets you control
  6560.     the execution flow of a program.  When a marker  has been set
  6561.     you use this command  to jump  to that location.  The command
  6562.     can only be issued to a MARK within the same command file.
  6563.     
  6564.     Example:
  6565.     
  6566.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6567.        GOXY 20 10                  ; position place to write text
  6568.        WRITE "Hello there"         ; display text
  6569.        MARK 1                      ; set a marker
  6570.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6571.        GOXY 10 10                  ; position place to write text
  6572.        WRITE "Hello here"          ; display text
  6573.        JUMPMARK 1                  ; next command is executed
  6574.     
  6575.  
  6576.  
  6577.  
  6578.  
  6579.  
  6580.  
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.  
  6590.  
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.  
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604.  
  6605.                              --- Page: 118 ---                              
  6606.  
  6607.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6608.  
  6609.     VARIABLE
  6610.     
  6611.     Syntax.:  VARIABLE  <CREATE   | RELEASE  |
  6612.                          INCREASE | DECREASE |
  6613.                          VALUE    | LOAD     | SAVE>
  6614.     
  6615.     With this command you can manipulate values of variables. You
  6616.     start by creating a variable and then increase or decrease it
  6617.     to control eg. loops in you scripts.  When you don't need the
  6618.     variable any more, you simply issue the release command.
  6619.     
  6620.     For more specific information on each of the items, choose:
  6621.     
  6622.         CREATE         INCREASE        DECREASE
  6623.     
  6624.         RELEASE        VALUE           LOAD
  6625.     
  6626.         SAVE
  6627.     
  6628.  
  6629.  
  6630.  
  6631.  
  6632.  
  6633.  
  6634.  
  6635.  
  6636.  
  6637.  
  6638.  
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.  
  6645.  
  6646.  
  6647.  
  6648.  
  6649.  
  6650.  
  6651.  
  6652.  
  6653.  
  6654.  
  6655.  
  6656.  
  6657.  
  6658.  
  6659.  
  6660.  
  6661.                              --- Page: 119 ---                              
  6662.  
  6663.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6664.  
  6665.     VARIABLE CREATE
  6666.     
  6667.     Syntax.:  VARIABLE CREATE <name> TYPE
  6668.                               <STRING "<text>" | NUMBER <value>>
  6669.     
  6670.     Modes..:  + text, + graphic
  6671.     
  6672.     This command creates a variable with a given name and a given
  6673.     type.  At the same time the variable is assigned a value.
  6674.     
  6675.     If the variable  is of a string type,  a text value has to be
  6676.     assigned. The string variable can then be used in a number of
  6677.     other commands such as: IF and SPEAK.
  6678.     
  6679.     If the variable is of a number type, the variable can then be
  6680.     manipulated with the INCREASE and DECREASE commands.  This is
  6681.     useful to control eg. loops,  and to setup other control se-
  6682.     quences in a script file.  A number type variable can also be
  6683.     used in the MATH command.
  6684.     
  6685.     A variable can be removed with the RELEASE command.
  6686.     
  6687.     Note that once a variable has been created with a certain na-
  6688.     me,  the value of that variable will not be effected if a new
  6689.     CREATE variable is encountered.  That makes it easier to con-
  6690.     trol loops.  If you wish to reassign a given value to a given
  6691.     variable name you must first release the variable.
  6692.     
  6693.     A maximum of 15 variables can be active at the same time.
  6694.     
  6695.     Example:
  6696.     
  6697.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6698.        VARIABLE CREATE test TYPE NUMBER 1  ; create variable
  6699.        MARK 1                      ; mark a place to jump to
  6700.        GOXY 1 1                    ; go to location on screen
  6701.        WRITE "Test is"             ; write text at location
  6702.        GOXY 10 1                   ; go to location on screen
  6703.        WRITE test                  ; write variable at location
  6704.        IF test EQ 4 DO "file1"     ; check the variable
  6705.        IF test EQ 8 DO JUMPMARK 2  ; check the variable
  6706.        IF test EQ 10 DO BREAK      ; check the variable
  6707.        VARIABLE INCREASE test 1    ; increase variable
  6708.        JUMPMARK 1                  ; go top the marked position
  6709.        MARK 2                      ; mark a place to jump to
  6710.        VARIABLE RELEASE test       ; delete variable
  6711.        CONTINUE                    ; reset script
  6712.     
  6713.  
  6714.  
  6715.  
  6716.  
  6717.                              --- Page: 120 ---                              
  6718.  
  6719.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6720.  
  6721.     VARIABLE INCREASE
  6722.     
  6723.     Syntax.:  VARIABLE INCREASE <name> <number>
  6724.     
  6725.     Modes..:  + text, + graphic
  6726.     
  6727.     This command increases a named variable  with a given number.
  6728.     First the variable  must be created  with the CREATE command.
  6729.     Then it can be increased with a positive number. This is use-
  6730.     full to control eg. loops, and to setup other control sequen-
  6731.     ces in a script file.
  6732.     
  6733.     Example:
  6734.     
  6735.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6736.        VARIABLE CREATE test TYPE NUMBER 1  ; create variable
  6737.        MARK 1                      ; mark a place to jump to
  6738.        GOXY 1 1                    ; go to location on screen
  6739.        WRITE "Test is"             ; write text at location
  6740.        GOXY 10 1                   ; go to location on screen
  6741.        WRITE test                  ; write variable at location
  6742.        IF test EQ 4 DO "file1"     ; check the variable
  6743.        IF test EQ 8 DO JUMPMARK 2  ; check the variable
  6744.        IF test EQ 10 DO BREAK      ; check the variable
  6745.        VARIABLE INCREASE test 1    ; increase variable
  6746.        JUMPMARK 1                  ; go top the marked position
  6747.        MARK 2                      ; mark a place to jump to
  6748.        VARIABLE RELEASE test       ; delete variable
  6749.        CONTINUE                    ; reset script
  6750.     
  6751.  
  6752.  
  6753.  
  6754.  
  6755.  
  6756.  
  6757.  
  6758.  
  6759.  
  6760.  
  6761.  
  6762.  
  6763.  
  6764.  
  6765.  
  6766.  
  6767.  
  6768.  
  6769.  
  6770.  
  6771.  
  6772.  
  6773.                              --- Page: 121 ---                              
  6774.  
  6775.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6776.  
  6777.     VARIABLE DECREASE
  6778.     
  6779.     Syntax.:  VARIABLE DECREASE <name> <number>
  6780.     
  6781.     Modes..:  + text, + graphic
  6782.     
  6783.     This command decreases a named variable  with a given number.
  6784.     First the variable  must be created  with the CREATE command.
  6785.     Then it can be decreased with a positive number. This is use-
  6786.     full to control eg. loops, and to setup other control sequen-
  6787.     ces in a script file.
  6788.     
  6789.     Example:
  6790.     
  6791.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6792.        VARIABLE CREATE test TYPE NUMBER 1  ; create variable
  6793.        MARK 1                      ; mark a place to jump to
  6794.        GOXY 1 1                    ; go to location on screen
  6795.        WRITE "Test is"             ; write text at location
  6796.        GOXY 10 1                   ; go to location on screen
  6797.        WRITE test                  ; write variable at location
  6798.        IF test EQ 4 DO "file1"     ; check the variable
  6799.        IF test EQ 8 DO JUMPMARK 2  ; check the variable
  6800.        IF test EQ 10 DO BREAK      ; check the variable
  6801.        VARIABLE INCREASE test 1    ; increase variable
  6802.        JUMPMARK 1                  ; go top the marked position
  6803.        MARK 2                      ; mark a place to jump to
  6804.        VARIABLE RELEASE test       ; delete variable
  6805.        CONTINUE                    ; reset script
  6806.     
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.  
  6818.  
  6819.  
  6820.  
  6821.  
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.  
  6829.                              --- Page: 122 ---                              
  6830.  
  6831.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6832.  
  6833.     VARIABLE RELEASE
  6834.     
  6835.     Syntax.:  VARIABLE RELEASE  <name> | ALL
  6836.     
  6837.     Modes..:  + text, + graphic
  6838.     
  6839.     This  command  deletes  a variable  that previously  has been
  6840.     created with the CREATE command. If you specify the ALL para-
  6841.     meter, all variables will be deleted.
  6842.     
  6843.     Example:
  6844.     
  6845.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6846.        VARIABLE CREATE test TYPE NUMBER 1  ; create variable
  6847.        MARK 1                      ; mark a place to jump to
  6848.        GOXY 1 1                    ; go to location on screen
  6849.        WRITE "Test is"             ; write text at location
  6850.        GOXY 10 1                   ; go to location on screen
  6851.        WRITE test                  ; write variable at location
  6852.        IF test EQ 4 DO "file1"     ; check the variable
  6853.        IF test EQ 8 DO JUMPMARK 2  ; check the variable
  6854.        IF test EQ 10 DO BREAK      ; check the variable
  6855.        VARIABLE INCREASE test 1    ; increase variable
  6856.        JUMPMARK 1                  ; go top the marked position
  6857.        MARK 2                      ; mark a place to jump to
  6858.        VARIABLE RELEASE test       ; delete variable
  6859.        CONTINUE                    ; reset script
  6860.     
  6861.  
  6862.  
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.  
  6869.  
  6870.  
  6871.  
  6872.  
  6873.  
  6874.  
  6875.  
  6876.  
  6877.  
  6878.  
  6879.  
  6880.  
  6881.  
  6882.  
  6883.  
  6884.  
  6885.                              --- Page: 123 ---                              
  6886.  
  6887.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6888.  
  6889.     VARIABLE VALUE
  6890.     
  6891.     Syntax.:  VARIABLE VALUE <name> <value>
  6892.     
  6893.     Modes..:  + text, + graphic
  6894.     
  6895.     This command forces a value to a variable that previously has
  6896.     been created with the CREATE command. You can force values to
  6897.     string, number and key type variables.  For number type vari-
  6898.     ables you can also force a new value with the MATH command.
  6899.     
  6900.     For strings this is useful,  if you have just read  one value
  6901.     into the variable and the want to read another.  By forcing a
  6902.     value,  the previous string  will be erased  and you can read
  6903.     an all new string into the variable. You can also make "defa-
  6904.     ult" values ready in string commands.
  6905.     
  6906.     Example:
  6907.     
  6908.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  6909.        VARIABLE CREATE str TYPE STRING "" ; create variable
  6910.        GOXY 1 1                    ; go to location on screen
  6911.        WRITE "Type 'TEST'"         ; write text on screen
  6912.        MARK 1                      ; make place to jump to
  6913.        GOXY 12 1                   ; go to location on screen
  6914.        READ STRING str 8           ; read string into variable
  6915.        CASE STRING UPPER str "TEST" DO JUMPMARK 2  ; test string
  6916.        JUMPMARK 1                  ; string is not right
  6917.        MARK 2                      ; string is right
  6918.        ; /// Note ///
  6919.        VARIABLE VALUE str ""       ; make string empty
  6920.        GOXY 1 3                    ; go to location on screen
  6921.        WRITE "Type 'QUICK'"        ; write text on screen
  6922.        MARK 3                      ; make place to jump to
  6923.        GOXY 12 3                   ; go to location on screen
  6924.        READ STRING str 8           ; read string into variable
  6925.        CASE STRING UPPER str "QUICK" DO JUMPMARK 4  ; test string
  6926.        JUMPMARK 3                  ; string is not right
  6927.        MARK 2                      ; string is right
  6928.     
  6929.     If  you didn't  reset  the variable  at the place  where  the
  6930.     /// Note /// is placed,  when you made the next  READ STRING,
  6931.     the prior content  of string  would be shown  (TEST that is).
  6932.     Now an empty string will result in a blank field.
  6933.     
  6934.  
  6935.  
  6936.  
  6937.  
  6938.  
  6939.  
  6940.  
  6941.                              --- Page: 124 ---                              
  6942.  
  6943.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  6944.  
  6945.     VARIABLE LOAD
  6946.     
  6947.     Syntax.:  VARIABLE LOAD <name> FROM "<filename>"
  6948.     
  6949.     Modes..:  + text, + graphic
  6950.     
  6951.     This  command  loads  a  variable  that  previously  has been
  6952.     created  with the CREATE  command,  and  then saved  with the
  6953.     SAVE command.
  6954.     
  6955.     This is a means of saving variables  from one run of a script
  6956.     to another.
  6957.     
  6958.     Example:
  6959.     
  6960.        SCREEN CLEAR                ; empty screen
  6961.        VARIABLE CREATE test1 TYPE NUMBER 1  ; make variable
  6962.        WRITE test1                 ; write variable value
  6963.        WRITE " "                   ; write separator
  6964.        VARIABLE SAVE test1 TO "test1.var"  ; save variable
  6965.        VARIABLE INCREASE test1 1   ; increase variable value
  6966.        WRITE test1                 ; write variable value
  6967.        WRITE " "                   ; write separator
  6968.        VARIABLE LOAD test1 FROM "test1.var" ; load variable
  6969.        WRITE test1                 ; write variable value
  6970.        WRITE " "                   ; write separator
  6971.        WAIT 2
  6972.     
  6973.  
  6974.  
  6975.  
  6976.  
  6977.  
  6978.  
  6979.  
  6980.  
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.  
  6989.  
  6990.  
  6991.  
  6992.  
  6993.  
  6994.  
  6995.  
  6996.  
  6997.                              --- Page: 125 ---                              
  6998.  
  6999.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7000.  
  7001.     VARIABLE SAVE
  7002.     
  7003.     Syntax.:  VARIABLE SAVE <name> TO "<filename>"
  7004.     
  7005.     Modes..:  + text, + graphic
  7006.     
  7007.     This  command  saves  a  variable  that  previously  has been
  7008.     created with the CREATE  command.  You can then load it again
  7009.     with the LOAD command.
  7010.     
  7011.     This is a means of saving variables  from one run of a script
  7012.     to another.
  7013.     
  7014.     Example:
  7015.     
  7016.        SCREEN CLEAR                ; empty screen
  7017.        VARIABLE CREATE test1 TYPE NUMBER 1  ; make variable
  7018.        WRITE test1                 ; write variable value
  7019.        WRITE " "                   ; write separator
  7020.        VARIABLE SAVE test1 TO "test1.var"  ; save variable
  7021.        VARIABLE INCREASE test1 1   ; increase variable value
  7022.        WRITE test1                 ; write variable value
  7023.        WRITE " "                   ; write separator
  7024.        VARIABLE LOAD test1 FROM "test1.var" ; load variable
  7025.        WRITE test1                 ; write variable value
  7026.        WRITE " "                   ; write separator
  7027.        WAIT 2
  7028.     
  7029.  
  7030.  
  7031.  
  7032.  
  7033.  
  7034.  
  7035.  
  7036.  
  7037.  
  7038.  
  7039.  
  7040.  
  7041.  
  7042.  
  7043.  
  7044.  
  7045.  
  7046.  
  7047.  
  7048.  
  7049.  
  7050.  
  7051.  
  7052.  
  7053.                              --- Page: 126 ---                              
  7054.  
  7055.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7056.  
  7057.     READ
  7058.     
  7059.     Syntax.:  READ CHOISE <number> <number> |
  7060.                 STRING [UPPER] <variable name> <length number> |
  7061.                 KEY <variable name>
  7062.     
  7063.     Modes..:  + text, + graphic
  7064.     
  7065.     This command has three ways of working.
  7066.     
  7067.     In the first way,  the command  let the user  enter a number.
  7068.     The number must be in the range between the two numbers given
  7069.     in the command. A key is then awaited to be pressed. The num-
  7070.     ber entered by the user can then be further examined with the
  7071.     CASE CHOISE command.
  7072.     
  7073.     In the second way, a variable can be read.  It doesn't matter
  7074.     if the variable is of type string or type number. The current
  7075.     content (if any) is shown in an  edit field and  the user can
  7076.     edit the variable quite easily. After the Carriage Return key
  7077.     has been hit, the variable will have the new content.  A READ
  7078.     STRING variable can not be longer than 80 characters. The va-
  7079.     riable can be further examined by the CASE STRING command.
  7080.     If you add the word UPPER to the command, any letter you type
  7081.     will be forced to upper case.
  7082.     
  7083.     In the third way, a key variable can be read. A single key is
  7084.     awaited,  and that key  can then be  further evaluated by the
  7085.     CASE KEY command.
  7086.     
  7087.     Example 1 (READ CHOISE...):
  7088.     
  7089.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7090.        GOXY 20 10                  ; position place to write text
  7091.        WRITE "1: test1"            ; display text
  7092.        GOXY 20 12                  ; position place to write text
  7093.        WRITE "2: test2"            ; display text
  7094.        GOXY 20 14                  ; position place to write text
  7095.        WRITE "3: Exit"             ; display text
  7096.        GOXY 20 16                  ; position place to write text
  7097.        WRITE "[1..3]:"             ; display text
  7098.        READ CHOISE 1 3             ; get input from user
  7099.        CASE CHOISE 1 DO "test1"    ; do the file test1
  7100.        CASE CHOISE 2 DO JUMPMARK 4 ; jump to a new location
  7101.        CASE CHOISE 3 DO QUIT       ; halt DataShow
  7102.        ; handle the error situation with eg. jumpmark command
  7103.     
  7104.     Example 2 (READ STRING...):
  7105.     
  7106.        VARIABLE CREATE name TYPE STRING "" ; create variable
  7107.  
  7108.  
  7109.                              --- Page: 127 ---                              
  7110.  
  7111.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7112.  
  7113.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7114.        GOXY 20 10                  ; position place to write text
  7115.        WRITE "Enter your name:"    ; prompt user for input
  7116.        GOXY 20 11                  ; position place to read text
  7117.        READ STRING name 20         ; read the input
  7118.        GOXY 20 13                  ; position place to write text
  7119.        WRITE "Hello"               ; write text
  7120.        GOXY 20 14                  ; position place to write text
  7121.        WRITE name                  ; write variable
  7122.     
  7123.     Example 3 (READ KEY...):
  7124.     
  7125.     ; Main file:
  7126.        VARIABLE CREATE test TYPE KEY    ; create variable
  7127.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7128.        GOXY 20 10                  ; position place to write text
  7129.        WRITE "Hit any key"         ; prompt user for input
  7130.        GOXY 20 11                  ; position place to read text
  7131.        READ KEY test               ; read the input
  7132.        CASE KEY test 113 DO JUMPMARK 1  ; q
  7133.        CASE KEY test 81 DO JUMPMARK 1   ; Q
  7134.        DO "testkey"
  7135.        CONTINUE
  7136.        MARK 1
  7137.     
  7138.     ; Testkey file:
  7139.        GOXY 20 12                  ; position place to write text
  7140.        CASE KEY test 472 DO JUMPMARK 1
  7141.        CASE KEY test 480 DO JUMPMARK 2
  7142.        WRITE "Unknown key"         ; write text
  7143.        JUMPMARK 3
  7144.        MARK 1
  7145.        WRITE "You hit the UP key"
  7146.        JUMPMARK 3
  7147.        MARK 2
  7148.        WRITE "You hit the DN key"
  7149.        MARK 3
  7150.        WAIT 2
  7151.     
  7152.  
  7153.  
  7154.  
  7155.  
  7156.  
  7157.  
  7158.  
  7159.  
  7160.  
  7161.  
  7162.  
  7163.  
  7164.  
  7165.                              --- Page: 128 ---                              
  7166.  
  7167.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7168.  
  7169.     IF
  7170.     
  7171.     Syntax.:
  7172.     
  7173.        IF <<variable name> <EQ | NE | LT | LE | GT | GE | IN>
  7174.           <<number> | <variable name>> DO
  7175.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7176.     
  7177.        IF [NOT] GRAPH <VGA | EGA | CGA> DO
  7178.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7179.     
  7180.        IF [NOT] MOUSE DO
  7181.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7182.     
  7183.        IF [NOT] FILE <"filename"> DO
  7184.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7185.     
  7186.        IF [NOT] SOUND <ADLIB | BLAST> DO
  7187.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7188.     
  7189.        IF [NOT] VERSION <EQ | NE | LT | LE | GT | GE | IN>
  7190.           <number> DO
  7191.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7192.     
  7193.     Modes..:  + text, + graphic
  7194.     
  7195.     This command  has five  meanings.  The first command  variant
  7196.     executes a given command if a named variable compares with an
  7197.     operator to a given number or to a given variable. The second
  7198.     variant uses some predefined commands to determine which kind
  7199.     of graphic adapter the user of a script has.  The third vari-
  7200.     ant let you test if a mouse driver and mouse can be detected.
  7201.     The fourth variant  let you test if a file  with a given name
  7202.     can be found. And finally the fifth variant let you check for
  7203.     the presence of certain sound cards.
  7204.     
  7205.     See the syntax  for each of the commands  that follow  the DO
  7206.     in the appropriate individual sections.
  7207.     
  7208.     You have the possibility  to not just execute one command af-
  7209.     ter the DO statement.  On several new lines you can execute a
  7210.     lot of commands, as long as the last line in the list is END.
  7211.     This makes it easier to execute a number of commands if a gi-
  7212.     ven criteria is fulfilled.  You can not however issue a JUMP-
  7213.     MARK command from within a IF ... DO ... END number of state-
  7214.     ments.
  7215.     
  7216.     The meaning of the operators in the first command variant are
  7217.     as follows:
  7218.     
  7219.  
  7220.  
  7221.                              --- Page: 129 ---                              
  7222.  
  7223.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7224.  
  7225.               EQ       Equals
  7226.               NE       Not equal
  7227.               LT       Less than
  7228.               LE       Less than or equal
  7229.               GT       Greater than
  7230.               GE       Greater than or equal
  7231.     
  7232.     The IN operator requires one more number or variable  to com-
  7233.     pare with:
  7234.     
  7235.     IN <<number> | <variable name>> <<number> | <variable name>>
  7236.     
  7237.     If a number or a variable is in the range specified after the
  7238.     IN command, the command following the DO will be executed.
  7239.     
  7240.     All command variants  are useful  to control  the sequence of
  7241.     execution  of a script  file.  A variable  can be manipulated
  7242.     through the VARIABLE command.
  7243.     
  7244.     The GRAPH function  let you check the graphic adapter card on
  7245.     a computer.  The function will return true with the VGA para-
  7246.     meter  on a VGA or better adapter.  It will return true  with
  7247.     EGA if any EGA adapter is found.  And it will return true for
  7248.     CGA if a CGA or MCGA card is detected.
  7249.     
  7250.     So if the GRAPH function returns false in all the above cases
  7251.     you know that you're dealing with an unsupported adapter. See
  7252.     the PROMOTE1.SHW file for an example.
  7253.     
  7254.     The IF VERSION function makes it possible for you to test the
  7255.     version of DataShow. From version 5.0A of DataShow this func-
  7256.     tion will always return a hole number  representing the Data-
  7257.     Show version.  Eg. version 5.0A will return 50  and 6.0A will
  7258.     return 60.  This makes it easy  for you  to make sure  that a
  7259.     script is run under the proper DataShow version.
  7260.     
  7261.     Example 1 (IF <variable name> <operator> <number> DO ...):
  7262.     
  7263.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7264.        VARIABLE CREATE test TYPE NUMBER 1  ; create variable
  7265.        MARK 1                      ; mark a place to jump to
  7266.        GOXY 1 1                    ; go to location on screen
  7267.        WRITE "Test is"             ; write text at location
  7268.        GOXY 10 1                   ; go to location on screen
  7269.        WRITE test                  ; write variable at location
  7270.        IF test EQ 4 DO "file1"     ; check the variable
  7271.        IF test EQ 8 DO JUMPMARK 2  ; check the variable
  7272.        IF test EQ 10 DO BREAK      ; check the variable
  7273.        VARIABLE INCREASE test 1    ; increase variable
  7274.        JUMPMARK 1                  ; go top the marked position
  7275.  
  7276.  
  7277.                              --- Page: 130 ---                              
  7278.  
  7279.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7280.  
  7281.        MARK 2                      ; mark a place to jump to
  7282.        VARIABLE RELEASE test       ; delete variable
  7283.        CONTINUE                    ; reset script
  7284.     
  7285.     Example 2 (IF GRAPH DO ...):
  7286.     
  7287.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7288.        IF GRAPH VGA DO JUMPMARK 1  ; check the graphics adapter
  7289.     
  7290.        WRITE "THIS PRESENTATION ONLY WORKS ON VGA SCREENS!"
  7291.        GOXY 1 2
  7292.        WAIT "PUSH ANY KEY..."
  7293.        QUIT
  7294.     
  7295.        MARK 1
  7296.        SET GRAPHICS VGA1
  7297.        ...
  7298.     
  7299.     Example 3 (IF MOUSE DO ...):
  7300.     
  7301.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7302.        IF MOUSE DO JUMPMARK 1      ; check for a mouse driver
  7303.     
  7304.        WRITE "Sorry - You need a mouse for this presentation!"
  7305.        GOXY 1 2
  7306.        WAIT "PUSH ANY KEY..."
  7307.        QUIT
  7308.     
  7309.        MARK 1
  7310.        ...
  7311.     
  7312.     Example 4 (IF FILE <"filename"> DO ...):
  7313.     
  7314.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7315.        IF FILE "scores.dat" DO JUMPMARK 1  ; look for the file
  7316.     
  7317.        WRITE "Sorry! A file is missing for this presentation!"
  7318.        GOXY 1 2
  7319.        WAIT "PUSH ANY KEY..."
  7320.        QUIT
  7321.     
  7322.        MARK 1
  7323.        ...
  7324.     
  7325.        See the file GUESS.SHW in the EXAMPLES file for a more ex-
  7326.        tensive example of the IF FILE command.
  7327.     
  7328.     Example 5: (IF SOUND <ADLIB | BLAST> DO ...):
  7329.     
  7330.        ; Create variable to control sound output
  7331.  
  7332.  
  7333.                              --- Page: 131 ---                              
  7334.  
  7335.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7336.  
  7337.        VARIABLE CREATE soundtype TYPE NUMBER 0
  7338.     
  7339.        ; Check for presence of sound cards
  7340.        IF SOUND ADLIB DO MATH soundtype = 1
  7341.        IF SOUND BLAST DO MATH soundtype = 2
  7342.     
  7343.        IF soundtype EQ 0 DO JUMPMARK 3
  7344.        IF soundtype EQ 2 DO JUMPMARK 2
  7345.     
  7346.        IF soundtype EQ 1 DO
  7347.           INSTALL SOUND ADLIB
  7348.        END
  7349.        JUMPMARK 3
  7350.     
  7351.        MARK 2
  7352.        IF soundtype EQ 2 DO
  7353.           INSTALL SOUND BLAST
  7354.        END
  7355.     
  7356.        ; Now play music via selected output device
  7357.        MARK 3
  7358.        MUSIC PROCESS "beback.wav" WAV 12000
  7359.     
  7360.     Example 6: (IF VERSION ... DO):
  7361.     
  7362.        SCREEN CLEAR
  7363.        IF VERSION LT 50 DO
  7364.           WRITE "Error in version"
  7365.        ELSE
  7366.           WRITE "OK version"
  7367.        END
  7368.        WAIT 2
  7369.     
  7370.     General example (DO ... END):
  7371.     
  7372.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7373.        IF NOT FILE "scores.dat" DO ; look for the file
  7374.           WRITE "Sorry! A file is missing for this presentation!"
  7375.           GOXY 1 2
  7376.           WAIT "PUSH ANY KEY..."
  7377.           QUIT
  7378.        END
  7379.        ...
  7380.     
  7381.  
  7382.  
  7383.  
  7384.  
  7385.  
  7386.  
  7387.  
  7388.  
  7389.                              --- Page: 132 ---                              
  7390.  
  7391.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7392.  
  7393.     CASE
  7394.     
  7395.     Syntax.:
  7396.     
  7397.        CASE <CHOISE <number>> DO
  7398.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7399.     
  7400.        CASE <STRING [UPPER] <variable name>
  7401.        <<"text"> | <variable name>>> DO
  7402.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7403.     
  7404.        CASE <KEY <variable name> <key number>> DO
  7405.        "<filename>" | JUMPMARK | BREAK | MATH | QUIT | .. END
  7406.     
  7407.     Modes..:  + text, + graphic
  7408.     
  7409.     This command has three ways of working.
  7410.     
  7411.     Remember  that each command  must  fit  on to  one line  in a
  7412.     script.  The above syntax  is only written over more than one
  7413.     line in order for it to fit into the help window.
  7414.     
  7415.     See the syntax  for each of the commands  that follow  the DO
  7416.     in the appropriate sections.
  7417.     
  7418.     The  first  command  variant let you  test the  content of  a
  7419.     READ CHOISE command.  It will then execute a given command if
  7420.     the number entered in a prior READ CHOISE command is equal to
  7421.     the number in this command.
  7422.     
  7423.     The second  command variant  let you examine the content of a
  7424.     string variable. String variables can be assigned values with
  7425.     either  the VARIABLE CREATE  or the READ STRING commands.  If
  7426.     the string value  is equal  to the text  in quotation marks a
  7427.     given command is executed.  To compare strings  you could add
  7428.     the UPPER keyword which causes the comparison between the two
  7429.     strings  to both be in upper case.  Example:  UtiLiTy matches
  7430.     the word UTiliTY. That makes it easier to compare the strings
  7431.     no matter how they have been read.
  7432.     
  7433.     The third  command variant  let you  examine the content of a
  7434.     READ KEY command. (Look after example 3 hereunder for all the
  7435.     key numbers that you can compare the entered key with).
  7436.     
  7437.     Example 1 (CASE CHOISE <number> DO ...):
  7438.     
  7439.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7440.        GOXY 20 10                  ; position place to write text
  7441.        WRITE "1: test1"            ; display text
  7442.        GOXY 20 12                  ; position place to write text
  7443.  
  7444.  
  7445.                              --- Page: 133 ---                              
  7446.  
  7447.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7448.  
  7449.        WRITE "2: test2"            ; display text
  7450.        GOXY 20 14                  ; position place to write text
  7451.        WRITE "3: Exit"             ; display text
  7452.        GOXY 20 16                  ; position place to write text
  7453.        WRITE "[1..3]:"             ; display text
  7454.        READ CHOISE 1 3             ; get input from user
  7455.        CASE CHOISE 1 DO "test1"    ; do the file test1
  7456.        CASE CHOISE 2 DO JUMPMARK 4 ; jump to a new location
  7457.        CASE CHOISE 3 DO QUIT       ; halt DataShow
  7458.     
  7459.     Example 2 (CASE STRING <variable name> <"text"> DO ...):
  7460.     
  7461.        MARK 1                      ; set a mark to jump to
  7462.        VARIABLE CREATE name TYPE STRING "" ; create variable
  7463.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7464.        GOXY 20 10                  ; position place to write text
  7465.        WRITE "Write: TEST"         ; prompt user for input
  7466.        GOXY 20 11                  ; position place to read text
  7467.        READ STRING name 20         ; read the input
  7468.        CASE STRING name "TEST" DO JUMPMARK 2  ; test the input
  7469.        GOXY 20 13                  ; position place to write text
  7470.        WRITE "Invalid input"       ; write text
  7471.        WAIT 4                      ; pause to see text
  7472.        GOXY 20 13                  ; position place to write text
  7473.        WRITE "             "       ; write text
  7474.        JUMPMARK 1                  ; start over
  7475.        MARK 2                      ; here right input is entered
  7476.        GOXY 20 13                  ; position place to write text
  7477.        WRITE "Fabulous!!!"         ; write text
  7478.        WAIT 4                      ; pause to see text
  7479.     
  7480.     Example 3 (CASE KEY <variable name> <key number> DO ...):
  7481.     
  7482.     ; Main file:
  7483.        VARIABLE CREATE test TYPE KEY    ; create variable
  7484.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7485.        GOXY 20 10                  ; position place to write text
  7486.        WRITE "Hit any key"         ; prompt user for input
  7487.        GOXY 20 11                  ; position place to read text
  7488.        READ KEY test               ; read the input
  7489.        CASE KEY test 113 DO JUMPMARK 1  ; q
  7490.        CASE KEY test 81 DO JUMPMARK 1   ; Q
  7491.        DO "testkey"
  7492.        CONTINUE
  7493.        MARK 1
  7494.     
  7495.     ; Testkey file:
  7496.        GOXY 20 12                  ; position place to write text
  7497.        CASE KEY test 472 DO JUMPMARK 1
  7498.        CASE KEY test 480 DO JUMPMARK 2
  7499.  
  7500.  
  7501.                              --- Page: 134 ---                              
  7502.  
  7503.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7504.  
  7505.        WRITE "Unknown key"         ; write text
  7506.        JUMPMARK 3
  7507.        MARK 1
  7508.        WRITE "You hit the UP key"
  7509.        JUMPMARK 3
  7510.        MARK 2
  7511.        WRITE "You hit the DN key"
  7512.        MARK 3
  7513.        WAIT 2
  7514.     
  7515.     Key Numbers:
  7516.     
  7517.          Plain  Shift  Control  Alt
  7518.     Up     472    ---    ---    ---
  7519.     Down   480    ---    ---    ---
  7520.     Left   475    ---    ---    ---
  7521.     Right  477    ---    ---    ---
  7522.     Home   471    ---    ---    ---
  7523.     End    479    ---    ---    ---
  7524.     PgUp   473    ---    ---    ---
  7525.     PgDn   481    ---    ---    ---
  7526.     
  7527.          Plain  Shift  Control  Alt
  7528.     Ins    482    ---    ---    ---
  7529.     Del    483    ---    ---    ---
  7530.     Enter   13     13     13    ___
  7531.     Esc     27     27     27    ---
  7532.     Tab      9    415    ---    ---
  7533.     BkSp     8    ---    ---    ---
  7534.     
  7535.          Plain  Shift  Control  Alt
  7536.     F1     459    484    494    504
  7537.     F2     460    485    495    505
  7538.     F3     461    486    496    506
  7539.     F4     462    487    497    507
  7540.     F5     463    488    498    508
  7541.     F6     464    489    499    509
  7542.     F7     465    490    500    510
  7543.     F8     466    491    501    511
  7544.     F9     467    492    502    512
  7545.     F10    468    493    503    513
  7546.     
  7547.       Plain  Shift  Control  Alt      Plain  Shift  Control  Alt
  7548.     a    97     65    ---    430    n   110     78    ---    449
  7549.     b    98     66    ---    448    o   111     79    ---    424
  7550.     c    99     67    ---    445    p   112     80    ---    425
  7551.     d   100     68    ---    432    q   113     81    ---    416
  7552.     e   101     69    ---    418    r   114     82    ---    419
  7553.     f   102     70    ---    433    s   115     83    ---    431
  7554.     g   103     71    ---    434    t   116     84    ---    420
  7555.  
  7556.  
  7557.                              --- Page: 135 ---                              
  7558.  
  7559.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7560.  
  7561.     h   104     72    ---    435    u   117     85    ---    422
  7562.     i   105     73    ---    436    v   118     86    ---    447
  7563.     j   106     74    ---    437    w   119     87    ---    417
  7564.     k   107     75    ---    438    x   120     88    ---    445
  7565.     l   108     76    ---    439    y   121     89    ---    421
  7566.     m   109     77    ---    450    z   122     90    ---    444
  7567.     
  7568.         Plain  Shift  Control  Alt     Plain  Shift  Control  Alt
  7569.     1 !    49     33    ---    520 [ {    91    ---    ---    ---
  7570.     2 @    50     64    ---    521 ] }   ---    ---    ---    ---
  7571.     3 #    51     35    ---    522 ; :   ---    ---    ---    ---
  7572.     4 $    52     35    ---    523 ' "   ---    ---    ---    ---
  7573.     5 %    53     37    ---    524 , <   ---    ---    ---    ---
  7574.     6 ^    54     94    ---    525 . >   ---    ---    ---    ---
  7575.     7 &    55     38    ---    526 / ?   ---    ---    ---    ---
  7576.     8 *    56     42    ---    527 ` ~   ---    ---    ---    ---
  7577.     9 (    57     40    ---    528 \ |   ---    ---    ---    ---
  7578.     0 )    48     41    ---    529
  7579.     
  7580.  
  7581.  
  7582.  
  7583.  
  7584.  
  7585.  
  7586.  
  7587.  
  7588.  
  7589.  
  7590.  
  7591.  
  7592.  
  7593.  
  7594.  
  7595.  
  7596.  
  7597.  
  7598.  
  7599.  
  7600.  
  7601.  
  7602.  
  7603.  
  7604.  
  7605.  
  7606.  
  7607.  
  7608.  
  7609.  
  7610.  
  7611.  
  7612.  
  7613.                              --- Page: 136 ---                              
  7614.  
  7615.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7616.  
  7617.     MATH
  7618.     
  7619.     Syntax.:  MATH <variable name> = <expression>
  7620.     
  7621.     Modes..:  + text, + graphic
  7622.     
  7623.     This command let you do mathematic operations  with predefined
  7624.     mathematic commands, variables and numbers.
  7625.     
  7626.     An expression can be put together after the following rules:
  7627.     
  7628.     
  7629.     Expression  =  [+ | -] Term { + Term | - Term }
  7630.     
  7631.     An expression consist of  an optional + or - sign followed by
  7632.     a Term. After that, zero or more (symbolized by the {}) Terms
  7633.     preceded by a + or - sign can follow.
  7634.     
  7635.     
  7636.     Term        =  Factor { * Factor | / Factor }
  7637.     
  7638.     A term consist of a factor.  After that, zero or more factors
  7639.     preceded  by a  * (multiplication)  or  / (division) sign can
  7640.     follow.
  7641.     
  7642.     
  7643.     Factor       =  Value | (Expression) { ^ Factor }
  7644.     
  7645.     A factor consist of  a value or a parenthesis  with a expres-
  7646.     sion in.  After that,  zero or more  values  preceded  by a ^
  7647.     (raised to the power of) sign can follow.
  7648.     
  7649.     
  7650.     Value        =  Number | Variable name | Predefined command
  7651.     
  7652.     A value consist of a number  or the value of a variable  or a
  7653.     predefined command value (see further below).
  7654.     
  7655.     
  7656.     Number       =  Digit { Digit } [. { Digit }] | . { Digit }
  7657.     
  7658.     Digit        =  { 0|1|2|3|4|5|6|7|8|9 }
  7659.     
  7660.     A number  consist of  one or more digits followed by a an op-
  7661.     tional decimal separator and one or more digits.  Or a number
  7662.     consist of a decimal point followed by one or more digits.
  7663.     
  7664.     
  7665.     Here's a list of predefined commands:
  7666.     
  7667.  
  7668.  
  7669.                              --- Page: 137 ---                              
  7670.  
  7671.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7672.  
  7673.     MIN(expression 1 {,expression n}):
  7674.        Gives the smallest value of numbers specified.
  7675.     
  7676.     MAX(expression 1 {,expression n}):
  7677.        Gives the largest value of numbers specified.
  7678.     
  7679.     AVERAGE(expression 1 {,expression n}):
  7680.        Gives the average value of numbers specified.
  7681.     
  7682.     SIN <factor>:
  7683.        Gives the sine value of a number specified.
  7684.     
  7685.     COS <factor>:
  7686.        Gives the cosine value to a number specified.
  7687.     
  7688.     TAN <factor>:
  7689.        Gives the tangent value to a number specified.
  7690.     
  7691.     COT <factor>:
  7692.        Gives you the cotangent value to a number.
  7693.     
  7694.     ARCTAN <factor>:
  7695.        Gives the arcustangent value of a number.
  7696.     
  7697.     LN <factor>:
  7698.        Gives the natural logarithm value of a number.
  7699.     
  7700.     LOG <factor>:
  7701.        Gives logarithm to a number specified.
  7702.     
  7703.     EXP <factor>:
  7704.        Gives the exponential value of a number specified.
  7705.     
  7706.     ABS <factor>:
  7707.        Gives the absolute (positive) value of a number.
  7708.     
  7709.     SQRT <factor>:
  7710.        Gives the square root of a number as result.
  7711.     
  7712.     FAC(<expressions>):
  7713.        Gives the faculty value of a number specified.
  7714.     
  7715.     FRAC <factor>:
  7716.        Gives you the fractional part of a real.
  7717.     
  7718.     INT <factor>:
  7719.        Gives you the integer part of a real.
  7720.     
  7721.     ROUND <factor>:
  7722.        Gives you the rounded value to a given number.
  7723.  
  7724.  
  7725.                              --- Page: 138 ---                              
  7726.  
  7727.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7728.  
  7729.     
  7730.     TRUNC <factor>:
  7731.        Gives you the truncated value to a given number.
  7732.     
  7733.     PI:
  7734.        Gives the value of pi which is 3.14...'
  7735.     
  7736.     RANDOM(<expression>):
  7737.        Gives you  a randomly generated number,  between 1 and the
  7738.        the expression given.
  7739.     
  7740.     
  7741.     So here's what it all boils down to. Look also in the accom-
  7742.     panying example file called MATHWIZZ.SHW to see a live exam-
  7743.     ple of how the MATH command can be used.
  7744.     
  7745.     Example:
  7746.     
  7747.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7748.        VARIABLE CREATE var1 TYPE NUMBER 0  ; create a variable
  7749.        VARIABLE CREATE var2 TYPE NUMBER 0  ; create a variable
  7750.     
  7751.        GOXY 10 2                   ; position place to write text
  7752.        WRITE "Enter a value:"      ; write text
  7753.        GOXY 30 2                   ; position to read number
  7754.        READ STRING var1 3          ; read number
  7755.     
  7756.        MATH var2 = SIN(var1)       ; do math operation on number
  7757.        GOXY 10 4                   ; position place to write text
  7758.        WRITE "Sine value is:"      ; write text
  7759.        GOXY 30 4                   ; position to write number
  7760.        WRITE var2                  ; write variable
  7761.     
  7762.        MATH var2 = var1 * var1     ; do math operation on number
  7763.        GOXY 10 6                   ; position place to write text
  7764.        WRITE "Times itself:"       ; write text
  7765.        GOXY 30 6                   ; position to write number
  7766.        WRITE var2                  ; write variable
  7767.     
  7768.        GOXY 10 10                  ; position to write text
  7769.        WAIT "Press any key"        ; wait for any key
  7770.     
  7771.  
  7772.  
  7773.  
  7774.  
  7775.  
  7776.  
  7777.  
  7778.  
  7779.  
  7780.  
  7781.                              --- Page: 139 ---                              
  7782.  
  7783.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7784.  
  7785.     DEFINE
  7786.     
  7787.     Syntax.:  DEFINE
  7788.     
  7789.     Modes..:  + text, + graphic
  7790.     
  7791.     This command is used to mark lines.  Together with the MOTION
  7792.     and the END commands it is possible to define texts to be mo-
  7793.     ved around the screen.  This command marks  the start  of the
  7794.     definition area.
  7795.     
  7796.     Example:
  7797.     
  7798.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7799.        DEFINE                      ; start defining text
  7800.            //                      ; first defined line
  7801.          ////                      ; second defined line
  7802.        //  //                      ; third defined line
  7803.            //                      ; fourth line
  7804.            //                      ; fifth line
  7805.           ////                     ; sixth line
  7806.        END                         ; mark end of defined lines
  7807.        DELAYFACTOR 4               ; set speed for motion
  7808.        GOXY 10 0                   ; set place to begin motion
  7809.        MOTION RIGHT 0              ; start motion across screen
  7810.     
  7811.  
  7812.  
  7813.  
  7814.  
  7815.  
  7816.  
  7817.  
  7818.  
  7819.  
  7820.  
  7821.  
  7822.  
  7823.  
  7824.  
  7825.  
  7826.  
  7827.  
  7828.  
  7829.  
  7830.  
  7831.  
  7832.  
  7833.  
  7834.  
  7835.  
  7836.  
  7837.                              --- Page: 140 ---                              
  7838.  
  7839.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7840.  
  7841.     END
  7842.     
  7843.     Syntax.:  END
  7844.     
  7845.     Modes..:  + text, + graphic
  7846.     
  7847.     This command is used to mark lines.  Together with the MOTION
  7848.     and the DEFINE commands  it is possible to define texts to be
  7849.     moved around the screen.  This command  marks the end  of the
  7850.     definition area.
  7851.     
  7852.     Example:
  7853.     
  7854.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7855.        DEFINE                      ; start defining text
  7856.            //                      ; first defined line
  7857.          ////                      ; second defined line
  7858.        //  //                      ; third defined line
  7859.            //                      ; fourth line
  7860.            //                      ; fifth line
  7861.           ////                     ; sixth line
  7862.        END                         ; mark end of defined lines
  7863.        DELAYFACTOR 4               ; set speed for motion
  7864.        GOXY 10 0                   ; set place to begin motion
  7865.        MOTION RIGHT 0              ; start motion across screen
  7866.     
  7867.  
  7868.  
  7869.  
  7870.  
  7871.  
  7872.  
  7873.  
  7874.  
  7875.  
  7876.  
  7877.  
  7878.  
  7879.  
  7880.  
  7881.  
  7882.  
  7883.  
  7884.  
  7885.  
  7886.  
  7887.  
  7888.  
  7889.  
  7890.  
  7891.  
  7892.  
  7893.                              --- Page: 141 ---                              
  7894.  
  7895.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7896.  
  7897.     MOTION
  7898.     
  7899.     Syntax.:  MOTION <LEFT | RIGHT> <times>
  7900.     
  7901.     Modes..:  + text, + graphic
  7902.     
  7903.     This command is used to move lines.  Together with the DEFINE
  7904.     and the END commands it is possible to define texts to be mo-
  7905.     ved around the screen.
  7906.     
  7907.     This command starts the motion of the defined area.  You must
  7908.     specify the direction of the motion, and the number of times
  7909.     to the left or right that the defined area is to be moved.
  7910.     
  7911.     If times is equal to zero, the defined text will be moved all
  7912.     the way across the screen. The number that times is to be set
  7913.     to must lie between 0 and 160, since the motion really starts
  7914.     off the screen (which is 80 characters wide).
  7915.     
  7916.     The speed  with which  the motion  is carried out,  is set by
  7917.     SET DELAYFACTOR and color is set by the COLOR command.
  7918.     
  7919.     Note that in graphics mode,  this command only works when you
  7920.     use the default font with the size 1 (see the EFFECT command).
  7921.     
  7922.     Example:
  7923.     
  7924.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  7925.        DEFINE                      ; start defining text
  7926.            //                      ; first defined line
  7927.          ////                      ; second defined line
  7928.        //  //                      ; third defined line
  7929.            //                      ; fourth line
  7930.            //                      ; fifth line
  7931.           ////                     ; sixth line
  7932.        END                         ; mark end of defined lines
  7933.        DELAYFACTOR 4               ; set speed for motion
  7934.        GOXY 10 0                   ; set place to begin motion
  7935.        MOTION RIGHT 0              ; start motion across screen
  7936.     
  7937.  
  7938.  
  7939.  
  7940.  
  7941.  
  7942.  
  7943.  
  7944.  
  7945.  
  7946.  
  7947.  
  7948.  
  7949.                              --- Page: 142 ---                              
  7950.  
  7951.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  7952.  
  7953.     MOUSE
  7954.     
  7955.     Syntax.:  MOUSE <ON | OFF> |
  7956.     
  7957.               MOUSE GOXY <x-coordinate> <y-coordinate> |
  7958.     
  7959.               MOUSE TRACK <button number> <var1> <var2> |
  7960.     
  7961.               MOUSE QUERY <variable name> <var1> <var2> |
  7962.     
  7963.               MOUSE TYPE <number> |
  7964.     
  7965.               *** MOUSE DRAW under construction
  7966.     
  7967.     Modes..:  + text, + graphic
  7968.     
  7969.     This command let you control a mouse from a script. First you
  7970.     turn the mouse on, then you track the mouse around the screen
  7971.     and then the mouse position  is returned to you.  This can be
  7972.     useful eg. if users of a script must point to a certain place
  7973.     on the screen before continuing.
  7974.     
  7975.     The command has slightly different meanings in the two modes.
  7976.     In text mode it is not possible to call this command  without
  7977.     there actually is a mouse present.  It is however possible in
  7978.     graphic mode.
  7979.     
  7980.     In both modes you can also use the keyboard to move the mouse
  7981.     pointer. By using the arrow keys the mouse will be moved, and
  7982.     pressing  <ctrl>+L for left, <ctrl>+R for right,  or <ctrl>+M
  7983.     for middle mouse button.  The first variable  will hold the X
  7984.     coordinate and the second variable will hold the Y coordinate
  7985.     of the mouse at the time the <button number> was pressed. The
  7986.     <button number> constant can be 1 for left, 2 for right, or 3
  7987.     for middle mouse button.
  7988.     
  7989.     The main diffenrence  between the MOUSE TRACK  and the  MOUSE
  7990.     QUERY commands is that the first waits until a specific mouse
  7991.     button is pressed, while the second gives you the possibility
  7992.     to get any mouse button back.
  7993.     
  7994.     Note that switching the mouse on and off is your own respons-
  7995.     ability. Certain other commands that deal with the screen can
  7996.     give weird results,  if you haven't turned the mouse off  be-
  7997.     fore the command is issued.
  7998.     
  7999.     Example (in text mode):
  8000.     
  8001.        SCREEN CLEAR                ; blank out screen
  8002.        IF NOT MOUSE DO             ; check for mouse
  8003.  
  8004.  
  8005.                              --- Page: 143 ---                              
  8006.  
  8007.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8008.  
  8009.           WRITE "Mouse required"   ; write text
  8010.           WAIT                     ; wait for any key press
  8011.           QUIT                     ; halt execution
  8012.        END                         ; end of if
  8013.        VARIABLE CREATE MX TYPE NUMBER 0  ; create x coordinate
  8014.        VARIABLE CREATE MY TYPE NUMBER 0  ; create y coordinate
  8015.        MOUSE ON                    ; turn mouse on
  8016.        MOUSE TRACK 1 MX MY         ; track mouse and keyboard
  8017.        MOUSE OFF                   ; hide mouse
  8018.        GOXY 1 1 WRITE "X: "+MX     ; position cursor and write
  8019.        GOXY 1 2 WRITE "Y: "+MY     ; position cursor and write
  8020.        WAIT                        ; wait for any key press
  8021.     
  8022.     Example (in graph mode):
  8023.     
  8024.        VARIABLE CREATE MX TYPE NUMBER 0  ; create x coordinate
  8025.        VARIABLE CREATE MY TYPE NUMBER 0  ; create y coordinate
  8026.        SET GRAPHICS VGA1           ; go to graphics mode
  8027.        MOUSE ON                    ; turn mouse on
  8028.        MOUSE TRACK 1 MX MY         ; track mouse and keyboard
  8029.        MOUSE OFF                   ; turn mouse off
  8030.        CLEARSCREEN                 ; clean screen
  8031.        GOXY 1 1 WRITE "X: "+MX     ; position cursor and write
  8032.        GOXY 1 2 WRITE "Y: "+MY     ; position cursor and write
  8033.        WAIT                        ; wait for any key press
  8034.     
  8035.     Note that in graphic mode, the return value for var1 and var2
  8036.     will depend on the graphic mode you're currently in. Eg. mode
  8037.     VGA1 will be in the range 640 for var1 and 480 for var 2.
  8038.     
  8039.     Example (MOUSE GOXY):
  8040.     
  8041.        SET GRAPHICS VGA1           ; go to graphics mode
  8042.        SET DELAYFACTOR 1           ; set step size
  8043.        MOUSE ON                    ; turn mouse on
  8044.        MOUSE GOXY 02 02            ; move mouse to location
  8045.        WAIT 1                      ; wait a little
  8046.        MOUSE GOXY 78 20            ; move mouse to location
  8047.        WAIT                        ; wait for any key
  8048.     
  8049.     Note  that this command  uses the delayfactor setting to move
  8050.     the mouse cursor. The command corresponds to the GOXY command
  8051.     in that it uses  a scaling factor  in graphics mode,  so that
  8052.     all modes has x values from 1 to 80, y values from 1 to 24.
  8053.     
  8054.     Example (MOUSE TYPE):
  8055.     
  8056.        VARIABLE CREATE MX TYPE NUMBER 0  ; create x coordinate
  8057.        VARIABLE CREATE MY TYPE NUMBER 0  ; create y coordinate
  8058.        SET GRAPHICS VGA1           ; go to graphics mode
  8059.  
  8060.  
  8061.                              --- Page: 144 ---                              
  8062.  
  8063.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8064.  
  8065.        MOUSE ON                    ; turn mouse on
  8066.        MOUSE TYPE 2                ; make mouse into checkmark
  8067.        MOUSE TRACK 1 MX MY         ; track mouse and keyboard
  8068.        MOUSE OFF                   ; turn mouse off
  8069.     
  8070.     Note that this command only works in graphics mode and that a
  8071.     mouse must be present.  If no mouse is present the command is
  8072.     ignored, and you continue with the default arrow cursor.
  8073.     
  8074.     These numbers gives you different mouse cursors:
  8075.     
  8076.                      0     arrow (default)
  8077.                      1     stop hand
  8078.                      2     check mark
  8079.                      3     hour glass
  8080.                      4     question mark
  8081.     
  8082.     The number given to the command must be in the range 0 to 4.
  8083.     
  8084.  
  8085.  
  8086.  
  8087.  
  8088.  
  8089.  
  8090.  
  8091.  
  8092.  
  8093.  
  8094.  
  8095.  
  8096.  
  8097.  
  8098.  
  8099.  
  8100.  
  8101.  
  8102.  
  8103.  
  8104.  
  8105.  
  8106.  
  8107.  
  8108.  
  8109.  
  8110.  
  8111.  
  8112.  
  8113.  
  8114.  
  8115.  
  8116.  
  8117.                              --- Page: 145 ---                              
  8118.  
  8119.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8120.  
  8121.     BUTTON
  8122.     
  8123.     Syntax.:  BUTTON ...
  8124.     
  8125.     Modes..:  + text, + graphic
  8126.     
  8127.     THIS COMMAND IS UNDER CONSTRUCTION...
  8128.     
  8129.     IE. NOT WORKING AT THE MOMENT..
  8130.     
  8131.     ***
  8132.     
  8133.  
  8134.  
  8135.  
  8136.  
  8137.  
  8138.  
  8139.  
  8140.  
  8141.  
  8142.  
  8143.  
  8144.  
  8145.  
  8146.  
  8147.  
  8148.  
  8149.  
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.  
  8159.  
  8160.  
  8161.  
  8162.  
  8163.  
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.  
  8170.  
  8171.  
  8172.  
  8173.                              --- Page: 146 ---                              
  8174.  
  8175.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8176.  
  8177.     WINDOW
  8178.     
  8179.     Syntax.:  WINDOW <length> <height>
  8180.     
  8181.     Modes..:  + text, - graphic
  8182.     
  8183.     This command splits up the screen,  so that you can use parts
  8184.     of it without affecting other parts. There is not automatica-
  8185.     ly put a frame (DRAW BOX) around  the window,  so you'll have
  8186.     to do that yourself. Also the coordinates must fit within the
  8187.     coordinates of the screen set by the  current  settings of the
  8188.     x- and y-coordinate, which are set by the GOXY command.
  8189.     
  8190.     Example:
  8191.     
  8192.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  8193.        GOXY 10 10                  ; move position to 10,10
  8194.        BOX 5 10                    ; print frame at position
  8195.        GOXY 11 11                  ; move to 11,11 (within box)
  8196.        WINDOW 4 9                  ; make window in framed area
  8197.        SCREEN CLEAR                ; position 1,1 in window
  8198.        WRITE "Hey you!"            ; print text in window
  8199.        WAIT 2                      ; pause to see box
  8200.     
  8201.  
  8202.  
  8203.  
  8204.  
  8205.  
  8206.  
  8207.  
  8208.  
  8209.  
  8210.  
  8211.  
  8212.  
  8213.  
  8214.  
  8215.  
  8216.  
  8217.  
  8218.  
  8219.  
  8220.  
  8221.  
  8222.  
  8223.  
  8224.  
  8225.  
  8226.  
  8227.  
  8228.  
  8229.                              --- Page: 147 ---                              
  8230.  
  8231.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8232.  
  8233.     CONTINUE
  8234.     
  8235.     Syntax.:  CONTINUE
  8236.     
  8237.     Modes..:  + text, + graphic
  8238.     
  8239.     This command  starts  from the beginning of the  script  file
  8240.     again.  It cannot however be given from a second commandfile,
  8241.     eg.  if you have written the  command in a  scriptfile called
  8242.     from another scriptfile with the DO command.
  8243.     
  8244.     Example:
  8245.     
  8246.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  8247.        WRITE "Testing.."           ; print text on blank screen
  8248.        WAIT 2                      ; pause to see text
  8249.        GOXY 10 10                  ; move to new location
  8250.        WRITE "Moved.."             ; print text at new location
  8251.        WAIT 2                      ; pause to see text
  8252.        CONTINUE                    ; start scriptfile over again
  8253.     
  8254.  
  8255.  
  8256.  
  8257.  
  8258.  
  8259.  
  8260.  
  8261.  
  8262.  
  8263.  
  8264.  
  8265.  
  8266.  
  8267.  
  8268.  
  8269.  
  8270.  
  8271.  
  8272.  
  8273.  
  8274.  
  8275.  
  8276.  
  8277.  
  8278.  
  8279.  
  8280.  
  8281.  
  8282.  
  8283.  
  8284.  
  8285.                              --- Page: 148 ---                              
  8286.  
  8287.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8288.  
  8289.     BREAK
  8290.     
  8291.     Syntax.:  BREAK
  8292.     
  8293.     Modes..:  + text, + graphic
  8294.     
  8295.     This  command  finds  the  next CONTINUE command,  and resume
  8296.     execution of the script from the command following the conti-
  8297.     nue statement. This makes it possible to control the sequence
  8298.     of execution of a script.
  8299.     
  8300.     Example:
  8301.     
  8302.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  8303.        GOXY 20 10                  ; position place to write text
  8304.        WRITE "Hello there"         ; write text
  8305.        BREAK                       ; look for continue
  8306.        WRITE "No more"             ; this is not executed
  8307.        CONTINUE                    ; next command is executed
  8308.        QUIT                        ; stop script and end DataShow
  8309.     
  8310.  
  8311.  
  8312.  
  8313.  
  8314.  
  8315.  
  8316.  
  8317.  
  8318.  
  8319.  
  8320.  
  8321.  
  8322.  
  8323.  
  8324.  
  8325.  
  8326.  
  8327.  
  8328.  
  8329.  
  8330.  
  8331.  
  8332.  
  8333.  
  8334.  
  8335.  
  8336.  
  8337.  
  8338.  
  8339.  
  8340.  
  8341.                              --- Page: 149 ---                              
  8342.  
  8343.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8344.  
  8345.     CALL
  8346.     
  8347.     Syntax.:  CALL "<command>"
  8348.     
  8349.     Modes..:  + text, + graphic
  8350.     
  8351.     With this command you can call a operating system command. It
  8352.     is possible to execute another program,  or a batch file. You
  8353.     simply name the command you wish to have executed.
  8354.     
  8355.     Example:
  8356.     
  8357.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  8358.        CALL "command.com"          ; start dos again; "EXIT" back
  8359.        SCREEN CLEAR                ; empty screen after program
  8360.        WRITE "Back again"          ; write text from DataShow
  8361.        WAIT 5                      ; wait for 5 seconds to end
  8362.     
  8363.     In this way  you can call  executable files (programs), batch
  8364.     files, or the OS shell. Eg. you can call another graphic pro-
  8365.     gram, and then return to DataShow after it finishes. The com-
  8366.     mand you specify must be a valid OS command.
  8367.     
  8368.  
  8369.  
  8370.  
  8371.  
  8372.  
  8373.  
  8374.  
  8375.  
  8376.  
  8377.  
  8378.  
  8379.  
  8380.  
  8381.  
  8382.  
  8383.  
  8384.  
  8385.  
  8386.  
  8387.  
  8388.  
  8389.  
  8390.  
  8391.  
  8392.  
  8393.  
  8394.  
  8395.  
  8396.  
  8397.                              --- Page: 150 ---                              
  8398.  
  8399.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8400.  
  8401.     INSTALL
  8402.     
  8403.     With this command  you can set up extra features  not readily
  8404.     and normally available i DataShow. Some of these features are
  8405.     taken from external files,  and some features  are built into
  8406.     Datashow, but has to be activated before you can use them.
  8407.     
  8408.     The commands can be found as:
  8409.     
  8410.                             INSTALL FONT.
  8411.                             INSTALL SOUND.
  8412.     
  8413.  
  8414.  
  8415.  
  8416.  
  8417.  
  8418.  
  8419.  
  8420.  
  8421.  
  8422.  
  8423.  
  8424.  
  8425.  
  8426.  
  8427.  
  8428.  
  8429.  
  8430.  
  8431.  
  8432.  
  8433.  
  8434.  
  8435.  
  8436.  
  8437.  
  8438.  
  8439.  
  8440.  
  8441.  
  8442.  
  8443.  
  8444.  
  8445.  
  8446.  
  8447.  
  8448.  
  8449.  
  8450.  
  8451.  
  8452.  
  8453.                              --- Page: 151 ---                              
  8454.  
  8455.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8456.  
  8457.     
  8458.     
  8459.     Syntax.:  INSTALL FONT "<filename>"
  8460.     
  8461.     Modes..:  - text, + graphic
  8462.     
  8463.     This command  let you  install more fonts  than the ones that
  8464.     are already built  into DataShow.  This makes it possible  to
  8465.     display text on the screen that takes on several styles.
  8466.     
  8467.     With the registered version of DataShow comes some files with
  8468.     the extension "CHR". You can use them one at a time with this
  8469.     command.
  8470.     
  8471.     Note that you have to be in graphics mode before you issue
  8472.     the command,  and if you switch into another mode the font
  8473.     installation will be forgotten. Just install one again.
  8474.     
  8475.     The command is used in conjunction with the EFFECT TEXTTYPE.
  8476.     
  8477.     Example:
  8478.     
  8479.        SET GRAPHICS EGA1           ; make sure we're in graphics
  8480.        GOXY 1 1                    ; set current coordinates
  8481.        EFFECT TEXTTYPE 1 2         ; change font and size
  8482.        WRITE "FONT: Triplex"       ; print text on blank screen
  8483.        WAIT 2                      ; pause to see text
  8484.        INSTALL FONT "EURO.CHR"     ; install a user font
  8485.        GOXY 1 10                   ; set current coordinates
  8486.        EFFECT TEXTTYPE 4 1         ; change default font and size
  8487.        WRITE "USER FONT: Euro"     ; print text on blank screen
  8488.        WAIT 2                      ; pause to see text
  8489.        INSTALL FONT "BOLD.CHR"     ; install a user font
  8490.        GOXY 1 20                   ; set current coordinates
  8491.        EFFECT TEXTTYPE 4 1         ; change default font and size
  8492.        WRITE "USER FONT: Bold"     ; print text on blank screen
  8493.        WAIT 2                      ; pause to see text
  8494.     
  8495.  
  8496.  
  8497.  
  8498.  
  8499.  
  8500.  
  8501.  
  8502.  
  8503.  
  8504.  
  8505.  
  8506.  
  8507.  
  8508.  
  8509.                              --- Page: 152 ---                              
  8510.  
  8511.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8512.  
  8513.     
  8514.     
  8515.     Syntax.:  INSTALL SOUND <SPEAK | ADLIB | BLAST>
  8516.     
  8517.     Modes..:  + text, + graphic
  8518.     
  8519.     This command  sets the output device  with which  music files
  8520.     are played with the MUSIC PROCESS command. The necessary dri-
  8521.     vers are built into DataShow,  so this command activates  the
  8522.     appropriate one.
  8523.     
  8524.     Note that the  MUSIC PROCESS command  produce an error  if an
  8525.     Adlib  or  Sound Blaster  is not found.  You should therefore
  8526.     check for their presence with the  IF SOUND  command,  before
  8527.     executing this command. INSTALL SOUND SPEAK will always work,
  8528.     and sets the output device to the internal PC speaker.
  8529.     
  8530.     The speaker  is set to be the output device (default)  at the
  8531.     beginning of DataShow.
  8532.     
  8533.     Example:
  8534.     
  8535.        ; Create variable to control sound output
  8536.        VARIABLE CREATE soundtype TYPE NUMBER 0
  8537.     
  8538.        ; Check for presence of sound cards
  8539.        IF SOUND ADLIB DO MATH soundtype = 1
  8540.        IF SOUND BLAST DO MATH soundtype = 2
  8541.     
  8542.        IF soundtype EQ 0 DO JUMPMARK 3
  8543.        IF soundtype EQ 2 DO JUMPMARK 2
  8544.     
  8545.        IF soundtype EQ 1 DO
  8546.           INSTALL SOUND ADLIB
  8547.        END
  8548.        JUMPMARK 3
  8549.     
  8550.        MARK 2
  8551.        IF soundtype EQ 2 DO
  8552.           INSTALL SOUND BLAST
  8553.        END
  8554.     
  8555.        ; Now play music via selected output device
  8556.        MARK 3
  8557.        MUSIC PROCESS "beback.wav" WAV 12000
  8558.     
  8559.  
  8560.  
  8561.  
  8562.  
  8563.  
  8564.  
  8565.                              --- Page: 153 ---                              
  8566.  
  8567.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8568.  
  8569.     SPRITE
  8570.     
  8571.     Syntax.:  SPRITE "<name>"
  8572.                  <LOAD | GOXY | SHOW | HIDE | FRAME | RELEASE>
  8573.     
  8574.     Modes..:  - text, + graphic
  8575.     
  8576.     This command work with the sprites that can be created in the
  8577.     Animation Center.
  8578.     
  8579.     The LOAD command loads a sprite from a file, that is saved in
  8580.     the Animation Center. You can load a total of 10 sprites into
  8581.     a sprite buffer  at a time.  The sprite is not shown  by this
  8582.     command.
  8583.     
  8584.     The GOXY command  moves the named sprite from one location to
  8585.     another on the screen.  The sprite is not shown  by this com-
  8586.     mand, unless the sprite is already visible.
  8587.     
  8588.     The SHOW and HIDE commands shows or hides sprites if they are
  8589.     either hidden or visible.
  8590.     
  8591.     The RELEASE command  let you control the sprite buffer by re-
  8592.     leasing a sprite from memory.  That way  you can load and un-
  8593.     load sprites as they are needed.
  8594.     
  8595.     The FRAME command has no meaning at the moment.
  8596.     
  8597.     Example:
  8598.     
  8599.        ; Go into graphics mode
  8600.        SET GRAPHICS VGA1
  8601.        ; Create variable to control sprite loop
  8602.        VARIABLE CREATE loopno TYPE NUMBER 80
  8603.        ; Read file into sprite buffer
  8604.        SPRITE "mann.spr" LOAD
  8605.        ; Position sprite
  8606.        SPRITE "mann.spr" GOXY 80 300
  8607.        SPRITE "mann.spr" SHOW
  8608.     
  8609.        MARK 1
  8610.        MATH loopno=loopno+1
  8611.        SPRITE "mann.spr" GOXY loopno 300
  8612.        IF loopno LE 300 DO JUMPMARK 1
  8613.     
  8614.        ; Clean up after us
  8615.        SPRITE "mann.spr" RELEASE
  8616.        VARIABLE loopno RELEASE
  8617.     
  8618.  
  8619.  
  8620.  
  8621.                              --- Page: 154 ---                              
  8622.  
  8623.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8624.  
  8625.     QUIT
  8626.     
  8627.     Syntax.:  QUIT
  8628.     
  8629.     Modes..:  + text, + graphic
  8630.     
  8631.     This  command ends script execution immediately, returning to
  8632.     the operating system.
  8633.     
  8634.     Example:
  8635.     
  8636.        SCREEN CLEAR                ; empty screen, cursor at 1,1
  8637.        WRITE "Testing.."           ; write text
  8638.        WAIT 2                      ; pause to see text
  8639.        QUIT                        ; stop script and end DataShow
  8640.        WRITE "No more"             ; this is not executed
  8641.     
  8642.  
  8643.  
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.  
  8650.  
  8651.  
  8652.  
  8653.  
  8654.  
  8655.  
  8656.  
  8657.  
  8658.  
  8659.  
  8660.  
  8661.  
  8662.  
  8663.  
  8664.  
  8665.  
  8666.  
  8667.  
  8668.  
  8669.  
  8670.  
  8671.  
  8672.  
  8673.  
  8674.  
  8675.  
  8676.  
  8677.                              --- Page: 155 ---                              
  8678.  
  8679.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8680.  
  8681.     SAY
  8682.     
  8683.     This command has been replaced by the WRITE command.  This is
  8684.     because  there from version 1.2A has been  added a SPEAK com-
  8685.     mand which could cause confusion because of ambiguity.
  8686.     
  8687.  
  8688.  
  8689.  
  8690.  
  8691.  
  8692.  
  8693.  
  8694.  
  8695.  
  8696.  
  8697.  
  8698.  
  8699.  
  8700.  
  8701.  
  8702.  
  8703.  
  8704.  
  8705.  
  8706.  
  8707.  
  8708.  
  8709.  
  8710.  
  8711.  
  8712.  
  8713.  
  8714.  
  8715.  
  8716.  
  8717.  
  8718.  
  8719.  
  8720.  
  8721.  
  8722.  
  8723.  
  8724.  
  8725.  
  8726.  
  8727.  
  8728.  
  8729.  
  8730.  
  8731.  
  8732.  
  8733.                              --- Page: 156 ---                              
  8734.  
  8735.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8736.  
  8737.     WAITKEY
  8738.     
  8739.     This command  has been  incorporated  into the  WAIT command.
  8740.     There is no reel need to have two separate commands.  You can
  8741.     use the WAIT command with the same options  that you used the
  8742.     WAITKEY command.  That is, you can enter a text next to it or
  8743.     you can enter it without  parameters.  In both cases the exe-
  8744.     cution will be stopped until a key is hit. So all you have to
  8745.     do to upgrade is remove the KEY letters in WAITKEY...
  8746.     
  8747.  
  8748.  
  8749.  
  8750.  
  8751.  
  8752.  
  8753.  
  8754.  
  8755.  
  8756.  
  8757.  
  8758.  
  8759.  
  8760.  
  8761.  
  8762.  
  8763.  
  8764.  
  8765.  
  8766.  
  8767.  
  8768.  
  8769.  
  8770.  
  8771.  
  8772.  
  8773.  
  8774.  
  8775.  
  8776.  
  8777.  
  8778.  
  8779.  
  8780.  
  8781.  
  8782.  
  8783.  
  8784.  
  8785.  
  8786.  
  8787.  
  8788.  
  8789.                              --- Page: 157 ---                              
  8790.  
  8791.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8792.  
  8793.     GRAPHICS
  8794.     
  8795.     This command has been incorporated into the SHOW SCREEN com-
  8796.     mand.  Simply substitute  the word GRAPHICS  with  the  words
  8797.     SHOW SCREEN.
  8798.     
  8799.  
  8800.  
  8801.  
  8802.  
  8803.  
  8804.  
  8805.  
  8806.  
  8807.  
  8808.  
  8809.  
  8810.  
  8811.  
  8812.  
  8813.  
  8814.  
  8815.  
  8816.  
  8817.  
  8818.  
  8819.  
  8820.  
  8821.  
  8822.  
  8823.  
  8824.  
  8825.  
  8826.  
  8827.  
  8828.  
  8829.  
  8830.  
  8831.  
  8832.  
  8833.  
  8834.  
  8835.  
  8836.  
  8837.  
  8838.  
  8839.  
  8840.  
  8841.  
  8842.  
  8843.  
  8844.  
  8845.                              --- Page: 158 ---                              
  8846.  
  8847.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8848.  
  8849.     SOUND
  8850.     
  8851.     This command has been incorporated into the MUSIC SOUND com-
  8852.     mand. Simply put the word MUSIC in front of the old command.
  8853.     
  8854.  
  8855.  
  8856.  
  8857.  
  8858.  
  8859.  
  8860.  
  8861.  
  8862.  
  8863.  
  8864.  
  8865.  
  8866.  
  8867.  
  8868.  
  8869.  
  8870.  
  8871.  
  8872.  
  8873.  
  8874.  
  8875.  
  8876.  
  8877.  
  8878.  
  8879.  
  8880.  
  8881.  
  8882.  
  8883.  
  8884.  
  8885.  
  8886.  
  8887.  
  8888.  
  8889.  
  8890.  
  8891.  
  8892.  
  8893.  
  8894.  
  8895.  
  8896.  
  8897.  
  8898.  
  8899.  
  8900.  
  8901.                              --- Page: 159 ---                              
  8902.  
  8903.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8904.  
  8905.     POINT
  8906.     
  8907.     This command has been incorporated into the EFFECT command.
  8908.     Simply put the word EFFECT in front of the old command.
  8909.     
  8910.  
  8911.  
  8912.  
  8913.  
  8914.  
  8915.  
  8916.  
  8917.  
  8918.  
  8919.  
  8920.  
  8921.  
  8922.  
  8923.  
  8924.  
  8925.  
  8926.  
  8927.  
  8928.  
  8929.  
  8930.  
  8931.  
  8932.  
  8933.  
  8934.  
  8935.  
  8936.  
  8937.  
  8938.  
  8939.  
  8940.  
  8941.  
  8942.  
  8943.  
  8944.  
  8945.  
  8946.  
  8947.  
  8948.  
  8949.  
  8950.  
  8951.  
  8952.  
  8953.  
  8954.  
  8955.  
  8956.  
  8957.                              --- Page: 160 ---                              
  8958.  
  8959.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  8960.  
  8961.     ESCAPE
  8962.     
  8963.     This command has been incorporated into the SET command. You
  8964.     now issue the command SET ESCAPEKEY with either the parameter
  8965.     OFF or with a number that signifies the key that can halt the
  8966.     execution of a script.
  8967.     
  8968.  
  8969.  
  8970.  
  8971.  
  8972.  
  8973.  
  8974.  
  8975.  
  8976.  
  8977.  
  8978.  
  8979.  
  8980.  
  8981.  
  8982.  
  8983.  
  8984.  
  8985.  
  8986.  
  8987.  
  8988.  
  8989.  
  8990.  
  8991.  
  8992.  
  8993.  
  8994.  
  8995.  
  8996.  
  8997.  
  8998.  
  8999.  
  9000.  
  9001.  
  9002.  
  9003.  
  9004.  
  9005.  
  9006.  
  9007.  
  9008.  
  9009.  
  9010.  
  9011.  
  9012.  
  9013.                              --- Page: 161 ---                              
  9014.  
  9015.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  9016.  
  9017.     ; (Comment)
  9018.     
  9019.     From version 3.0A a new MATH command has been added.  Since a
  9020.     star (*) denotes multiplication, a star can no longer also be
  9021.     the symbol  telling the interpreter  that a comment has begun
  9022.     and that the rest of the line should be ignored.
  9023.     
  9024.     Therefore a new comment marker  is introduced.  From now on a
  9025.     comment marker is a semicolon (;).
  9026.     
  9027.     To change your existing scripts, simply replace all stars (*)
  9028.     with semicolons (;).  This has been done in all the promotion
  9029.     scripts and in the examples given here in the help manual.
  9030.     
  9031.  
  9032.  
  9033.  
  9034.  
  9035.  
  9036.  
  9037.  
  9038.  
  9039.  
  9040.  
  9041.  
  9042.  
  9043.  
  9044.  
  9045.  
  9046.  
  9047.  
  9048.  
  9049.  
  9050.  
  9051.  
  9052.  
  9053.  
  9054.  
  9055.  
  9056.  
  9057.  
  9058.  
  9059.  
  9060.  
  9061.  
  9062.  
  9063.  
  9064.  
  9065.  
  9066.  
  9067.  
  9068.  
  9069.                              --- Page: 162 ---                              
  9070.  
  9071.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  9072.  
  9073.     Screen
  9074.     
  9075.     The SCREEN command consist of the CLEARSCREEN, GETSCREEN, and
  9076.     the PUTSCREEN commands.  They have been put together  as part
  9077.     of the work of making DataShow easier to use. Simply change:
  9078.     
  9079.                CLEARSCREEN    to     SCREEN CLEAR
  9080.                GETSCREEN      to     SCREEN GET
  9081.                PUTSCREEN      to     SCREEN PUT
  9082.  
  9083.  
  9084.  
  9085.  
  9086.  
  9087.  
  9088.  
  9089.  
  9090.  
  9091.  
  9092.  
  9093.  
  9094.  
  9095.  
  9096.  
  9097.  
  9098.  
  9099.  
  9100.  
  9101.  
  9102.  
  9103.  
  9104.  
  9105.  
  9106.  
  9107.  
  9108.  
  9109.  
  9110.  
  9111.  
  9112.  
  9113.  
  9114.  
  9115.  
  9116.  
  9117.  
  9118.  
  9119.  
  9120.  
  9121.  
  9122.  
  9123.  
  9124.  
  9125.                              --- Page: 163 ---                              
  9126.  
  9127.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  9128.  
  9129.     
  9130.     INDEX FOR MANUAL:
  9131.     ----------------------------------------------------------------------
  9132.     
  9133.     CHAPTER:                                PAGE:
  9134.     
  9135.     1  : Help on Help                       2
  9136.     
  9137.     2  : About DataShow                     6
  9138.     
  9139.     3  : Capture utility                    15
  9140.     
  9141.     4  : The Main Menu                      17
  9142.     
  9143.     5  : The Script Center                  21
  9144.     
  9145.     6  : The Draw Center                    25
  9146.     
  9147.     7  : The Text Center                    30
  9148.     
  9149.     8  : The Slide Center                   33
  9150.     
  9151.     9  : The Graph Menu                     37
  9152.     
  9153.     10 : Errormessages                      38
  9154.     
  9155.     11 : Commands                           40
  9156.     
  9157.     
  9158.     
  9159.     *** End of Manual ***
  9160.  
  9161.  
  9162.  
  9163.  
  9164.  
  9165.  
  9166.  
  9167.  
  9168.  
  9169.  
  9170.  
  9171.  
  9172.  
  9173.  
  9174.  
  9175.  
  9176.  
  9177.  
  9178.  
  9179.  
  9180.  
  9181.                              --- Page: 164 ---                              
  9182.  
  9183.     Chapter 11 : Commands, Copyright (c) 1990-94 by: RMP DATA.
  9184.  
  9185.