home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_09 / RUNNER.ZIP / SETUP.HLP < prev    next >
Text File  |  1992-05-25  |  17KB  |  321 lines
  1.  
  2.                         Runner -- A Desktop Alternative
  3.  
  4.                                      SETUP
  5.  
  6.                 Installation / Picture Setup / Other Help Files
  7.  
  8.                       Copyright (C) 1993 by Dave Thorson
  9.                       Version 1.61     November 18, 1993
  10.  
  11.  
  12.         
  13.         Runner v1.6 consists of the following files:
  14.  
  15.         
  16.         Program and Data Files
  17.  
  18.         RUNNER.PRG - the Runner program file
  19.         RUNNER.CFG - sample configuration file (note: unless your hard 
  20.            disk is set up exactly like mine, you cannot access programs 
  21.            from the menus in this file -- it's just included so you can 
  22.            get an idea how I use Runner every day)
  23.         RCONVERT.PRG  - Converts older RUNNER.CFG files for use with                   
  24.            newer versions (1.50 or higher) of Runner
  25.         RPICNAME.PRG - Easy way to assign default pictures for loading 
  26.            into Runner at startup
  27.         RUNR_REG.PRG - Lets you remove the protection from the 
  28.            "protected" programs included in Runner v1.6 and above, once 
  29.            you send in the $10-$15 (US) shareware registration fee
  30.         
  31.         Protected Program Files (see OTHERS.HLP for more info)
  32.         
  33.         MINI_RUN.TTP - Mini-Run program, for running large programs 
  34.            (frees about 80% of memory used by Runner), also can help 
  35.            correct problems some programs leave behind since it reloads 
  36.            Runner after the other program exits.  (has a looonnnnggg 
  37.            delay before running programs*)
  38.         REGIONS.TTP - Regions program, for defining areas on the screen 
  39.            that you can click to activate any of Runner's functions, 
  40.            menus or programs in the menus.  (saves disabled*)
  41.         RPICSEL.PRG - Create a list of background pictures for each 
  42.            resolution; Runner randomly selects a picture from the 
  43.            appropriate list when it starts.  (saves disabled*)
  44.         
  45.         * - When you send in the shareware registration fee, you'll be 
  46.            given a serial number and security code; use these with the 
  47.            RUNR_REG.PRG program to create fully working copies of these 
  48.            protected programs.
  49.  
  50.  
  51.         Documentation Files
  52.  
  53.         READ_ME.1ST - quick start notes for the impatient
  54.         OVERVIEW.HLP - Overview of Runner and related programs, 
  55.            shareware info, miscellaneous stuff, what's next?
  56.         RUNNER.HLP - displayed by pressing the HELP key from Runner's 
  57.            main menu; you may want to print it for reference.
  58.         NEWSTUFF.HLP - Summary of features, changes and fixes, by 
  59.            program version
  60.         SETUP.HLP - Description of Runner files and how to set them up 
  61.            (the very file you are reading now)
  62.         STARTUP.HLP - Tells how to start Runner and describes the main 
  63.            screen
  64.         MENU_BAR.HLP - Description of Runner's menu bar functions.
  65.         DIALOG.HLP - Explains the Description Dialog Box, including 
  66.            QuickKeys, Comment/Parameter line, and Installed Applications
  67.         FILSELCT.HLP - How to use file selector to run and view programs 
  68.            and files not in your menus
  69.         KEYBOARD.HLP - Keyboard equivalents and other keyboard functions 
  70.            including color changes, drive select and picture select
  71.         OTHERS.HLP - Instructions for MINI_RUN, REGIONS, RPICNAME, 
  72.            RCONVERT, RPICSEL, RUNR_REG, and any other related programs.
  73.  
  74.  
  75.         Picture and Picture Configuration Files
  76.         (all pictures by Dave Thorson except as noted)
  77.  
  78.         INVASION.PC1/2/3 - Low res version uses color cycling to make 
  79.            the stars twinkle
  80.         BORIS.PC1/3 - I don't know who painted this copy of a Boris 
  81.            Vallejo pic (or is it just in his style?) but it does make
  82.            a nice background!
  83.         WORMS.PC1 - demo of animation by color cycling
  84.         REGIONS1.PC1/3 - Low res background pic (demo for Regions)
  85.         FRIDGE.PC2 - Med res background pic
  86.         GRIDLAND.PC3 - High res background pic
  87.         HANO.PC1/2 - my attempt at copying a painting by Dan Namingha.  
  88.            Low res version is closer to original colors.
  89.         GUIDE.PI1  - Template for designing low res pictures
  90.         GUIDE.PI2  - Template for designing medium res pictures
  91.         GUIDE.PI3  - Template for designing high res pictures
  92.         *.CF1, *.CF2, *.CF3 - Picture configuration files
  93.  
  94.  
  95.  
  96. $$      Installation
  97.  
  98.         Runner can be run from a hard disk or floppy disk, from any 
  99.         folder (directory).  Copy the file RUNNER.PRG where you want to 
  100.         start it from (it CANNOT be placed in an AUTO folder).
  101.         
  102.         Runner stores most of its information in a configuration file 
  103.         called RUNNER.CFG.  An example RUNNER.CFG file is provided (play 
  104.         around with it, add and delete menu entries and so on, but don't 
  105.         expect any of the listed programs to run unless you have them 
  106.         stored using exactly the same drive and folder names I use).
  107.           
  108.         You can also create a new RUNNER.CFG file from scratch, within 
  109.         Runner, simply by renaming my RUNNER.CFG to something else like 
  110.         RUNNER.DLT so no RUNNER.CFG file is found by Runner.  Remember 
  111.         to save your work before exiting Runner (select "Save config" 
  112.         from the "File" menu).  You can use names other than RUNNER.CFG 
  113.         but that's the filename Runner looks for when it starts.  Files 
  114.         with other names can be loaded from within Runner later (use the 
  115.         "Load config" option in the "File" menu).
  116.  
  117.                 
  118.         When you start Runner, it searches for RUNNER.CFG in the 
  119.         following sequence:
  120.         
  121.         1. in the current directory (folder), where RUNNER.PRG is
  122.         2. in the root directory (outside all folders) of the current 
  123.            disk (the disk RUNNER.PRG was loaded from, such as D:\ )
  124.         3. in a folder in the root directory of the current disk called    
  125.            Runner (ex: D:\RUNNER\ )
  126.  
  127.         
  128. $$      Home Directory         * * *  IMPORTANT CONCEPT!  * * *
  129.  
  130.         If RUNNER.CFG is found, that directory (folder) is assumed to be 
  131.         Runner's "home" directory.  Whenever you save or load a 
  132.         configuration file or load a picture file, Runner takes you to 
  133.         that directory by default.  If RUNNER.CFG is NOT found, then the 
  134.         root directory of the current drive becomes Runner's home 
  135.         directory.
  136.  
  137.         If you have MINI_RUN.TTP and REGIONS.TTP, they MUST also be 
  138.         placed in this home directory.  Runner won't find them anywhere 
  139.         else, and they CANNOT be run like other programs!
  140.         
  141.  
  142. $$      Picture Files
  143.         
  144.         After loading (or trying to load) RUNNER.CFG, Runner next looks 
  145.         for a picture file to load from Runner's home directory.  Runner 
  146.         can use any Degas-compatible (.PI1/.PI2/.PI3) or Degas-Elite 
  147.         compressed (.PC1/.PC2/.PC3) pictures as a background.  To 
  148.         autoload a picture when Runner starts, copy a picture to 
  149.         Runner's home directory and rename it to one of the following, 
  150.         depending on the screen resolution for the picture:
  151.  
  152.            RUNNER.PI1 (or .PC1) for low resolution
  153.            RUNNER.PI2 (or .PC2) for medium resolution
  154.            RUNNER.PI3 (or .PC3) for high resolution
  155.  
  156.         Use the pictures included with Runner (who knows what possessed 
  157.         me to paint them), or use the guide pictures provided to create 
  158.         your own.  The names above are used for automatically loading a 
  159.         background picture, so to autoload one of your own works of art, 
  160.         simply rename your picture to RUNNER.PIx ("x" is 1, 2 or 3) or 
  161.         RUNNER.PCx, as appropriate.  You should also rename any 
  162.         RUNNER.CFx (see below) file in the same manner.
  163.         
  164.         There IS an easier way to define autoload pictures: Run the 
  165.         RPICNAME.PRG program and select the picture you want for each 
  166.         resolution.  The name and location of the picture is written to 
  167.         RUNNER.PIx rather than picture data, and runner will load your 
  168.         selected pictures on startup.  This way you don't lose track of 
  169.         the real name of the picture in RUNNER.PI1 or don't need two 
  170.         copies of the same picture file, one named RUNNER.PI1!  Another 
  171.         option is to use RPICSEL.PRG.  RPICSEL will let you create a 
  172.         list of pictures from which Runner will randomly pick the 
  173.         startup pic.  See OTHERS.HLP for more information.
  174.           
  175.         If Runner cannot find the appropriate file for the current 
  176.         resolution, no picture is loaded.
  177.  
  178.         Note: if you hold Control key when Runner starts, Runner will 
  179.         not look for a picture file to load.
  180.  
  181.         
  182. $$      Picture Configuration Files
  183.         
  184.         Starting with Runner v1.4, pictures can have configuration files 
  185.         associated with them, independent of the RUNNER.CFG files 
  186.         described above.  These files contain info on altered colors, 
  187.         menu positions, and any REGIONS information for the picture.  
  188.         They are named after the picture's filename, and must be kept in 
  189.         the same directory as the picture file.  If you have a picture 
  190.         called E:\PICS\FLOWER.PC1, its associated configuration file 
  191.         would be E:\PICS\FLOWER.CF1.  The number (1, 2 or 3) matches the 
  192.         resolution number of the picture file, and CF stands for 
  193.         ConFiguration.  Picture config files are automatically saved 
  194.         when you save your current Runner configuration, IF any picture-
  195.         related data has been changed.  You can also force Runner to 
  196.         save only the picture configuration file (whether it needs to or 
  197.         not) by holding down the Control key when selecting "Save 
  198.         config" from the "File" menu.
  199.         
  200.         Version 1.60c added the ability to use .CFx files -without- a 
  201.         picture file in memory.  This means you can use Regions to set 
  202.         up areas on the screen where a mouse click will do anything you 
  203.         can do in Runner and more, and set up an Autorun program that 
  204.         will be run when Runner starts, all without using a background 
  205.         picture (yes, memory is often a precious commodity).  If you do 
  206.         not use a RUNNER.PIx or RUNNER.PCx file, you can still use a 
  207.         RUNNER.CFx file at startup.  To create one, copy a .CFx file for 
  208.         a picture to RUNNER.CFx, or start Runner, go to Regions, set up 
  209.         everything the way you like, exit Regions, and use Save or 
  210.         Control/S to save the Regions information.  It will go into a 
  211.         file called NO_PIC.CFx if no picture is in memory.  Rename this 
  212.         file to RUNNER.CFx if you like.  You can also load .CFx files 
  213.         instead of .PIx or .PCx using the Background command.
  214.  
  215.         
  216. $$      Possible Setups
  217.         
  218.         I have Runner set up for my system as follows:
  219.  
  220.         Top (root) directory
  221.             of drive D:            Runner's "home" directory:
  222.  
  223.            D:\RUNNER.PRG              D:\RUNNER\RUNNER.CFG
  224.                                       D:\RUNNER\RUNNER.PI1
  225.                                       D:\RUNNER\RUNNER.CF1
  226.                                       D:\RUNNER\RUNNER.PI2
  227.                                       D:\RUNNER\RUNNER.CF2
  228.                                       D:\RUNNER\RUNNER.PI3
  229.                                       D:\RUNNER\RUNNER.CF3
  230.                                       D:\RUNNER\RUNNER.HLP
  231.                                       D:\RUNNER\MINI_RUN.TTP
  232.                                       D:\RUNNER\REGIONS.TTP
  233.                                       D:\RUNNER\RPICNAME.PRG
  234.         
  235.         RUNNER.PRG is in the root directory of drive D: (outside of any 
  236.         folders).  All other files are stored in a folder called Runner 
  237.         which appears in the window when drive D: is first opened from 
  238.         the desktop (it's a folder within the root directory of drive 
  239.         D:).  "D:\RUNNER\" is considered to be Runner's home directory 
  240.         in my setup.
  241.  
  242.  
  243.         For floppy disks, you may want a Runner disk with all the Runner 
  244.         files in the root directory.  This disk must be in the drive 
  245.         whenever you ask for help (or else your help request will be 
  246.         ignored).  On a two drive system you can keep MINI_RUN.TTP in 
  247.         the drive where Runner started, and put application disks in 
  248.         drive B.  Or, place Mini-Run in the root directory of your 
  249.         application disks in drive A (assuming you started Runner so 
  250.         that RUNNER.CFG was in the root directory of drive A).  Then 
  251.         Mini-Run will be found and can load your application.  Be sure 
  252.         to replace your Runner disk in drive A before exiting the 
  253.         application.  Of course, if you don't use Mini-Run then you 
  254.         don't need to mess with most of this....
  255.         
  256.         Floppy disk users may also want to keep Runner files in a 
  257.         "\RUNNER\" directory.  Once Runner locks in on "A:\RUNNER\" as 
  258.         its home directory, it doesn't care if you switch disks.  You 
  259.         could put RUNNER.PRG, RUNNER.CFG, and your startup picture files 
  260.         on one disk in a "\RUNNER\" directory.  Another disk could 
  261.         contain more picture files in a "\RUNNER\" directory.  Another 
  262.         could hold REGIONS.TTP, the .HLP files, and RPICNAME.PRG in its 
  263.         own "\RUNNER\" directory.  Finally, create a "\RUNNER\" 
  264.         directory on every disk containing a program you want use with 
  265.         Mini-Run, and place MINI_RUN.TTP in each of those folders (it's 
  266.         small, don't worry).  Runner will be able to find all these 
  267.         files even though you change disks.
  268.  
  269.         I use HeadStart (version 1.1) from the experts at CodeHead 
  270.         Software to start Runner whenever my ST is turned on.  A file 
  271.         called HEADSTRT.DAT goes in the root directory of my C: drive, 
  272.         and HEADST11.PRG is in the AUTO folder of the C: drive.  
  273.         HEADSTRT.DAT contains the line:
  274.  
  275.              D:\RUNNER.PRG
  276.  
  277.         HeadStart reads its data file, and loads Runner after the 
  278.         desktop appears.  I no longer need to open any desktop windows 
  279.         at all!  HEADST11.PRG is available on GEnie and possibly 
  280.         Compuserve, or contact CodeHead Software at: (213) 386-5735.  It 
  281.         may also be in the library of your local Atari User's Group.
  282.  
  283.  
  284.         
  285.         The only  * required *  files needed are RUNNER.PRG and your 
  286.         RUNNER.CFG file, although you may want the RUNNER.HLP file for 
  287.         on-line help, MINI_RUN.TTP to save space for larger programs, 
  288.         and your favorite background picture files and related .CFx 
  289.         files....  REGIONS.TTP is only needed if you want to create or 
  290.         edit screen regions and their functions, or save a background 
  291.         picture with the current colors -- it's not needed to use screen 
  292.         regions once you've saved them in a picture config file.
  293.  
  294.  
  295.                 
  296.         This ends the discussion on setting up Runner.  To get acquainted 
  297.         with using the program, you can try banging keys and selecting 
  298.         menu options, or you can read the following files in this 
  299.         recommended sequence (where have I seen this list before?):
  300.  
  301.         OVERVIEW.HLP - Overview of Runner and related programs, 
  302.            shareware info, what's next?
  303.         STARTUP.HLP - Tells how to start Runner and describes the main 
  304.            screen
  305.         MENU_BAR.HLP - Description of Runner's GEM menu bar functions 
  306.            (how to Load, Save, Add, Change, Drop, select color palettes 
  307.            and other useful goodies)
  308.         DIALOG.HLP - Explains the Description Dialog Box, including 
  309.            QuickKeys, Comment/Parameter line, and Installed Applications 
  310.            (you'll see this box anytime you add or change a program, 
  311.            menu or title)
  312.         FILSELCT.HLP - How to use file selector to run and view programs 
  313.            and files not in your menus
  314.         KEYBOARD.HLP - Keyboard equivalents and other keyboard functions 
  315.            including color changes, drive select and picture select
  316.         OTHERS.HLP - Instructions for MINI_RUN, REGIONS, RPICNAME, 
  317.            RCONVERT, RPICSEL, RUNR_REG and any other related programs.
  318.         
  319.         
  320.         [end of file SETUP.HLP]
  321.