home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / desktops / runner / others.hlp < prev    next >
Text File  |  1992-05-25  |  25KB  |  437 lines

  1.         
  2.                         Runner -- A Desktop Alternative
  3.         
  4.                                  Other Programs
  5.                 Mini-Run, Regions, Rpicname, Rconvert & Rpicsel
  6.  
  7.         
  8.                        Copyright (C) 1993 by Dave Thorson
  9.                        Version 1.61     November 18, 1993
  10.  
  11.  
  12.         This file describes Runner's companion programs and other 
  13.         support programs distributed with Runner or available when 
  14.         registering Runner.
  15.  
  16.         Some of these programs are disabled in one way or another, 
  17.         until you register Runner:
  18.         
  19.                REGIONS   - all saves are disabled
  20.                MINI-RUN  - a lengthy delay will discourage you 
  21.                          from using this day to day but you can 
  22.                          see how it works and test compatability 
  23.                RPICSEL   - all saves are disabled
  24.         
  25.         They are included in this form so you can try out most of 
  26.         their capabilities but still have incentive to pay the small 
  27.         shareware fee to have fully working programs!  It's all 
  28.         documented in other places, but basically you need to send 
  29.         $10.00 US (or more, if you, like others, find the programs 
  30.         worth more than that!) to me:
  31.         
  32.                     Dave Thorson
  33.                     4040 East Flower Street       <-- new address!
  34.                     Phoenix, AZ  85018
  35.                     USA
  36.                     (602) 954-6033
  37.                     On GEnie: MR.DAVE
  38.         
  39.         If you have already sent in your shareware registration for a 
  40.         previous version, no need to pay again unless you want to keep 
  41.         eniticing me to improve things....  Just call or write and I 
  42.         can give you the security code for the serial number already 
  43.         assigned to you.
  44.         
  45.         HOW TO GET WORKING COPIES OF THE PROGRAMS
  46.         
  47.         Once you register, I will send you a serial number and 
  48.         a special security code.  Put the program RUNR_REG.PRG (Runner 
  49.         Registration program) in the same folder (directory) as the 
  50.         programs listed above -- this should be Runner's home 
  51.         directory, or, for floppy disk users, the disk you keep these 
  52.         programs on.  DO NOT RUN THE RUNR_REG.PRG PROGRAM ON YOUR 
  53.         ORIGINAL RUNNER DISK.  Any Runner disk for version 1.61 or 
  54.         higher may now be copied for others or placed on bulletin 
  55.         boards, but not if it contains "fixed" versions of Regions, 
  56.         Mini-Run, or other "protected" runner programs.
  57.         
  58.         Run the RUNR_REG.PRG program, and if you agree to the terms 
  59.         and conditions it describes, enter your serial number and 
  60.         security code as requested.  RUNR_REG.PRG will then modify all 
  61.         protected programs to make them fully working versions AND to 
  62.         embed your serial number within them.  This way, if I find a 
  63.         working copy on a bulletin board or shareware disk, I can 
  64.         trace it back to you and take legal action for your violating 
  65.         my copyright on these programs.  Sneaky but effective, eh?  Oh 
  66.         yes, the odds of breaking the code are less than 1 in a 
  67.         million...
  68.  
  69.         Should you ever need to remove your serial number from the 
  70.         programs, run RUNR_REG.PRG again and enter your serial number 
  71.         with a different code (letter-number-letter).  You should test 
  72.         one of the programs to be certain they are now disabled.
  73.         
  74.         Enough of all this, what are these programs, anyway?
  75.         
  76.         
  77. $$      Mini-Run
  78.         
  79.         Mini-Run is a companion program callable only from within 
  80.         Runner.  It is used to free more memory for larger programs.  
  81.         It works like this:
  82.         
  83.         1. Runner determines which program to run
  84.         2. Runner tells GEM to call Mini-Run, and puts information about 
  85.            the program you wanted to run where Mini-Run can find it.
  86.         3. Runner exits from memory, and GEM loads Mini-Run
  87.         4. Mini-Run grabs the information Runner set up, the loads the 
  88.            program you requested based on this information.
  89.         5. Your program starts, you do what you need, and exit it.
  90.         6. Mini-Run resumes control and if you requested Hold Screen, it 
  91.            waits for a keypress or mouse click.
  92.         7. Mini-Run tells GEM to load Runner and exits.
  93.         8. Runner restarts.
  94.         
  95.         Of course there's more detail than that, but this sequence 
  96.         should give you a feel for what's going on.  It's all 
  97.         transparent to you as a user unless the information passed to 
  98.         Mini-Run gets to be too long (Runner will warn you of this and 
  99.         let you change the command line).  Mini-Run takes about an extra 
  100.         second to load on a hard drive, and then Runner must reload 
  101.         after Mini-Run exits, so there is some inconvenience.  But, 
  102.         Mini-Run takes about 29K of memory where runner needs nearly 
  103.         100K more than that if a background picture is loaded.
  104.         
  105.         Mini-Run MUST be copied to Runner's home directory.  That's all 
  106.         there is to installing it.  For floppy disk users, it might work 
  107.         best to put Mini-Run on each disk with a program that needs it, 
  108.         in a RUNNER directory.  See SETUP.HLP for more information.
  109.         
  110.         Mini-Run can be called in several ways:
  111.         
  112.         1. Press ESC.  The words "MINI-RUN" appear in Runner's upper 
  113.            right corner, replacing the time/date display if it's on.  
  114.            The next program run will be run via Mini-Run, and the MINI-
  115.            RUN indicator will be turned off.  Press Esc some more to 
  116.            cycle through HOLD_SCR, MRUN/HLD, and back to normal 
  117.            (date/time or blank).
  118.         
  119.         2. From the file selector, hold down Control when you select a 
  120.            program to run.  Note: if you select a data file that should 
  121.            trigger an installed application, holding down Control will 
  122.            simply bypass the application and send the file to File View 
  123.            instead.  Moral: You can't cause Mini-Run to be used for an 
  124.            installed application by using the Control key.  Press Esc 
  125.            BEFORE going to the file selector if needed.
  126.  
  127.         3. Within the Add/Change Dialog Box (you see this whenever you 
  128.            add or change a program) you can left-click on "Use Mini-Run" 
  129.            and then, whenever that program is run from Runner, Mini-Run 
  130.            will be used.  You can do this for programs, installed 
  131.            applications, or data/document files that trigger installed 
  132.            applications.
  133.         
  134.         If Runner senses that Mini-Run is requested by ANY of the above, 
  135.         Mini-Run will be used.  For example, if even though Spectrum 512 
  136.         does not have the "Use Mini-Run" flag set in the Add/Change 
  137.         Dialog Box, if you press Esc before selecting it from a menu 
  138.         then Spectrum 512 will be loaded using Mini-Run.
  139.         
  140.         If you hold down Control when exiting an application run via 
  141.         Mini-Run, then Mini-Run will return control to the desktop 
  142.         instead of Runner (if you want to go from Mini-Run back to 
  143.         Runner but want to supress the loading of a background picture, 
  144.         be sure to hold down Control AFTER Runner begins loading).  
  145.         Also, if a program is run with Hold Screen enabled, you can exit 
  146.         directly to the desktop by pressing Esc instead of a mouse click 
  147.         or other key, bypassing the return to Runner.
  148.         
  149.         One design decision made for Mini-Run will cause a problem if 
  150.         you try to enter parameters for a program with characters above 
  151.         ASCII 224.  These will be remapped into the lower-case character 
  152.         range.  Someone please let me know if this is a problem, but I 
  153.         can't imagine a program expecting characters in that range, far 
  154.         above the range of normally printable characters!  As a result 
  155.         of this, you can now pass lower case characters, intact, in your 
  156.         prarmeter strings (also known as command lines).
  157.  
  158.                 
  159. $$      Regions
  160.  
  161.         Regions is callable only from Runner, and only when a 
  162.         background picture is loaded (Not true -- as of Runner version 
  163.         1.60c you can use Regions without a picture!  See STARTUP.HLP 
  164.         for more info).  There is a lot of on-line help within 
  165.         Regions, so only the basics and obscure stuff are covered 
  166.         here.  Regions lets you define rectangular areas or regions 
  167.         (hence, the catchy name!) on the screen.  Within Runner, 
  168.         clicking within one of these regions causes almost any Runner 
  169.         function to happen.  It's great for setting up a mouse-driven 
  170.         front-end to your applications, to make life even easier for 
  171.         you, your clients, your kids, or anyone else getting close to 
  172.         your system.
  173.         
  174.         Press Y to call Regions.  REGIONS.TTP will be loaded from 
  175.         Runner's home directory (where Runner first found RUNNER.CFG or 
  176.         else the root directory of the drive Runner was loaded from -- 
  177.         see SETUP.HLP).  Once the program is loaded, information from 
  178.         Runner is passed through memory to Regions.  Regions has its own 
  179.         GEM menu bar.
  180.  
  181.         For help in Regions, press the Help key before selecting 
  182.         anything in the pull-down menus.  Press it again to turn off 
  183.         help.  Help is also turned off any time you select an item from 
  184.         a Regions menu.
  185.  
  186.         Regions displays the current background picture and lets you add 
  187.         or change up to 32 active screen regions for that picture.  When 
  188.         you exit Regions (using the Save & Quit option), all changes are 
  189.         updated in Runner's memory and Regions exits.  No disk access at 
  190.         all (nice, eh?) and your changes are all active within Runner, 
  191.         until you exit Runner or load in another picture.  To make your 
  192.         changes more permanent, you must save them in a picture 
  193.         configuration file.  Use Runner's pull-down menu option File, 
  194.         Save Config to save both picture and Runner config files, or 
  195.         hold down Control when you select Save Config to save ONLY the 
  196.         picture config file.  (You can also press S or Control/S, 
  197.         respectively).  See SETUP.HLP for information on picture 
  198.         configuration files.
  199.  
  200.         Since screen region information is saved in a picture 
  201.         configuration file, you can have different screen regions for 
  202.         each picture.  The idea is that you could create a background 
  203.         picture with "pseudo icons", pieces of a picture that act as 
  204.         icons but are really just pixels in the picture.  You might have 
  205.         different disk drive icons, one for exiting Runner, one or more 
  206.         for your favorite programs.  You can turn off Runner's menus and 
  207.         use nothing but screen regions to control Runner, if you prefer.
  208.         
  209.         You could dress up your game disks by showing a picture of each 
  210.         game that would be clicked on to start the game, or create a 
  211.         custom desktop with your own icon shapes to control your Atari 
  212.         system.  Of course these are not "real" icons; you cannot drag 
  213.         them around on the desktop.  To change them, you must change 
  214.         your picture in a paint program, then update where the screen 
  215.         regions are defined to match the new picture, using the Regions 
  216.         program.  More complex than dragging an icon on the desktop, but 
  217.         perhaps more fun and gratifying as well.
  218.  
  219. $$      Screen regions are created using the Add option.  You can define 
  220.         and adjust a rectangular region anywhere on the screen.  Then 
  221.         you need to assign a function to the region.  Five types of 
  222.         functions are currently available: 
  223.  
  224.         1. Menu Bar functions or those available from Runner's GEM menu 
  225.            bar.  About, Save, Load, Install, Add, Drop, colors, and so 
  226.            on, can be assigned to a spot on the screen.
  227.  
  228.         2. File Selector functions provide control of the file selector, 
  229.            just like the Space bar and Alt-letter keys.  Display a file 
  230.            selector for the last drive you visited, or start at the root 
  231.            directory of any active drive.
  232.  
  233.         3. QuickKeys can assigned to any region, so that anything a 
  234.            QuickKey can do (run a program, display a menu, show a text 
  235.            file, etc.) can be done from a screen region as well.
  236.  
  237.         4. Load Picture functions let you pick a picture file name using 
  238.            a file selector, and assign it to a shifted number key.  It 
  239.            is also assigned to a screen region.  Even if the region is 
  240.            later dropped, the name can remain assigned to the shifted 
  241.            number key.
  242.  
  243.         5. Miscellaneous functions cover most of the remaining keyboard-
  244.            only types of Runner commands, such as changing date format, 
  245.            exit via Undo key, menus on/off, Help, and so on....
  246.  
  247.         A Change option lets you alter anything about a region, 
  248.         including its priority.  If one or more regions or menus 
  249.         overlap, the one with the highest priority will be selected.  
  250.         Runner's menus have highest priority, then screen regions.  
  251.         Think of the regions as being in sequence on a list; those first 
  252.         in the list have a higher priority than those at the end.  A 
  253.         region may be moved to first or last place, moving other regions 
  254.         down or up as needed.  It's possible to have a region completely 
  255.         surrounded by another; as long as it has a higher priority it 
  256.         can still be selected and clicking in the surrounding region 
  257.         will activate its function instead.
  258.         
  259.         Regions also has the capability to save the current palette into 
  260.         a selected picture file.  Ideally, you should only save the 
  261.         palette to the file whose picture is displayed!  This option 
  262.         lets you take a palette changed within Runner, and update a 
  263.         picture file so it will have the same palette.  Normally, Runner 
  264.         only saves altered palette information in picture configuration 
  265.         files.
  266.         
  267.         Additional menu options let you load in other pictures or 
  268.         picture configuration files (Regions will even translate 
  269.         picture config files from other screen resolutions to the 
  270.         current one), and you can also save picture config files.  
  271.         These options give you a lot of flexibility for copying a 
  272.         setup from one picture to others, so you can use the same 
  273.         regions for a picture translated across different screen 
  274.         resoultions or use the same colors and regions across lots of 
  275.         pictures for a standardized, mouse-driven menu system.
  276.  
  277. $$      One other point should be made about the Regions program: it 
  278.         offers a lockout feature for Runner.  This is intended for use 
  279.         in making demos or custom applications where you don't the user 
  280.         to have access to anything else.  When lockout is selected, 
  281.         Runner's GEM menu bar goes away; selecting Exit Runner does 
  282.         nothing; the keyboard is ignored (mostly -- see below); the 
  283.         QuickKeys menu cannot be displayed; and anything else with 
  284.         potential danger is disabled.  Lockout takes effect only AFTER 
  285.         changes have been saved from Regions to Runner, and from Runner 
  286.         to a picture config file, and that picture is loaded into 
  287.         Runner.  Otherwise you would be unable to save changes from 
  288.         Runner!  Turning lockout OFF in Regions takes place immediately 
  289.         on return to Runner.  One problem: how do you get to Regions to 
  290.         disable lockout if the keys (including the Y key which starts 
  291.         Regions) are disabled?  A not-too-elegant solution: Runner 
  292.         watches for a sequence of keystrokes, namely Esc-y-Esc (three 
  293.         keys, no hyphens, and no shift on the y).  This is hard to hit 
  294.         at random and not too hard to remember.  You can prevent use of 
  295.         Regions for sure by simply removing it from Runner's home 
  296.         directory when it's not needed, or by renaming it to 
  297.         REGIONS.TTX or some name other than REGIONS.TTP.
  298.  
  299.         Since lockout removes the GEM menu bar and Runner's menus, you 
  300.         can create a nice looking custom desktop.  The menu bar area is 
  301.         not available for screen regions but you can put anything else 
  302.         in your picture up there.  Even a Macintosh logo (now wait a 
  303.         minute, let's not get carried away here).  All functions in 
  304.         Runner should be available through screen regions, including 
  305.         displaying sub menus and calling the file selector, but you can 
  306.         pick and choose the ones you need.  If something's not there, 
  307.         let me know!
  308.  
  309.         I can see uses for locked pictures in disk menus, tutorials 
  310.         where selecting an item on the screen displays a text file 
  311.         describing it, starts a program to animate it, or branches to 
  312.         another picture with all different regions to show more (or 
  313.         different) levels of detail.  You could simulate a large-than-
  314.         screen-size picture by setting up regions at the edges and 
  315.         corners which load a new picture of the view in that direction.  
  316.         You could even program a simple (or complex) maze, or a walk-
  317.         through of a house plan showing the view from any direction.  
  318.         Some of this is limited only by disk space for all the pictures, 
  319.         but you could always change disks before moving to a new 
  320.         picture.  Just be sure the picture's config file accompanies the 
  321.         picture.  And if you need a different set of Runner menus, 
  322.         create what you need and name it after the picture file (if 
  323.         STUFF.PI1 is the picture, then STUFF.CF1 is its config file and 
  324.         STUFF.CFG will be loaded as Runner's config file if it's in 
  325.         Runner's home directory).  Have fun with it!
  326.         
  327.         
  328. $$      An example picture file demonstrating the use of Regions 
  329.         is included for low, medium and high resolution.  Use Background 
  330.         from Runner's File menu to load REGIONS1.PC1, .PC2 or .PC3 and 
  331.         the corresponding REGIONS1.CF1, .CF2 or .CF3 file will load with 
  332.         it (if it's in the same directory as the picture).  Without the 
  333.         Regions program you cannot change anything, but you can click on 
  334.         the various "icons" to see what they do.  The Runner key 
  335.         equivalent letter for each icon is shown next to it.  If you 
  336.         have the Regions program you can call Regions to edit the 
  337.         functions or locations of regions in this file, using the 
  338.         REGIONS1 picture as a training ground.  [Note: as of Runner 
  339.         version 1.60, the recommended short-cut keys to access the file 
  340.         selector for various disk drives are the alt-letter keys, such 
  341.         as Alt-A for drive A:, Alt-B for drive B:, etc.  Older versions 
  342.         of Runner (and 1.60b, maybe even newer versions) allowed Shift-1 
  343.         to access drive A:, Shift-2 for drive B:, and so on.]
  344.  
  345.         
  346. $$      Rconvert
  347.         
  348.         This program is provided as an aid to prior users of Runner.  
  349.         It converts Runner configuration files (not picture 
  350.         configuration files) from older formats to the newest one.  
  351.         All information from older config files can be translated, 
  352.         except for installed application information.  Rconvert will, 
  353.         if you select the appropriate dialog box choices, send a list 
  354.         of all your installed applications to a disk file with a name 
  355.         similar to your config file's name.  Use this list to help you 
  356.         set up your applications in the new version of Runner (sorry, 
  357.         but the new approach to installing applications is just no 
  358.         longer compatible with the older information, and the 
  359.         potential for inconsistent results through an automated 
  360.         translation is just too high).
  361.         
  362.         Rconvert is easy to use, and it need not be in any particular 
  363.         directory.  Run it by double clicking on RCONVERT.PRG.  You can 
  364.         then remove the disk with RCONVERT.PRG on it and insert any 
  365.         others with .CFG files that need updating.  Follow the prompts; 
  366.         it's easy to use and quick!  You should be able to convert all 
  367.         your old .CFG files in a matter of minutes, and then you won't 
  368.         need RCONVERT.PRG any more....  Config files did not change 
  369.         formats between Runner versions 1.5x and 1.61.  Run Rconvert 
  370.         for more info!
  371.  
  372.         
  373. $$      Rpicname
  374.         
  375.         RPICNAME.PRG is a program that lets you quickly change default 
  376.         (startup) picture files for Runner.  Runner now looks at the 
  377.         size of picture files, and if a file is less than 100 bytes (or 
  378.         was it 128?) then it assumes the picture file contains a 
  379.         filename for another picture file instead of picture data.  
  380.         Runner also looks for RUNNER.PI1, RUNNER.PI2 and RUNNER.PI3 (or 
  381.         the .PCx equivalents for compressed pictures) at startup to use 
  382.         as autoloading picture files.  Rpicname ties these two concepts 
  383.         together.
  384.         
  385.         Run Rpicname by double clicking on RPICNAME.PRG (you can also 
  386.         put this one into a Runner menu, if you like).  Once it's loaded 
  387.         you can take out that disk and put in another if you need to.  
  388.         Rpicname displays a file selector.  Simply click on any picture 
  389.         file you want to use at startup, and Rpicname will put its 
  390.         filename and path into RUNNER.PIx for you (x is 1, 2 or 3, and 
  391.         is taken from the file extension of the picture file you 
  392.         select).  You can select files for any resolution in the same 
  393.         session.  If you did not select picture files from Runner's home 
  394.         directory, be sure to copy the resulting RUNNER.PIx file(s) into 
  395.         the home directory.  And be careful not to copy a name file over 
  396.         a real picture file (check the file sizes).  Rpicname works best 
  397.         if all the pictures you select from are in Runner's home 
  398.         directory.
  399.         
  400.         Rpicname assumes you want to use RUNNER.PIx for holding picture 
  401.         filenames instead of pictures.  If it tries to update a 
  402.         RUNNER.PIx file and finds it longer than 128 (or was it 100?) 
  403.         bytes, it will warn you and stop the update.  This way you 
  404.         cannot lose any picture files.
  405.         
  406.         If you only use one picture for each resolution and never plan 
  407.         to change, then you won't need Rpicname.  Otherwise it can be a 
  408.         very handy way to change the pictures you see on startup without 
  409.         a lot of renaming and copying of picture files.
  410.  
  411.         
  412. $$      Rpicsel        
  413.         
  414.         Rpicsel (short for Runner picture selector) lets you create a 
  415.         list of pictures you like as background pics.  Runner selects 
  416.         one picture from the list at random each time it starts up.  
  417.         Rpicsel lets you add to or delete from picture lists.  One list 
  418.         is used for each screen resoultion.  Runner can load in a 
  419.         picture list when it starts just like it loads in a single 
  420.         picture.  A simple and effective way to avoid the monotony of 
  421.         looking at the same desktop all the time!
  422.         
  423.         The only confusing thing about using RPICSEL.PRG (because it's 
  424.         different than most programs) is that it gives you the options 
  425.         of load/add and save, and when you select load/add you can 
  426.         specify a single picture, a list of pictures, or a wildcard 
  427.         filename (like C:\RUNNER\*.PI3) to load bunches of pictures into 
  428.         the list at once.  Rpicsel is smart enough to figure it all out 
  429.         for you.  No menu full of Load, Add, Replace, Update or other 
  430.         commands, and no need to specify what type of file you're 
  431.         loading.  Why aren't more programs written this way???  The only 
  432.         donwside is that you can only create lists for a given screen 
  433.         resolution while your system is in that resolution.  More help 
  434.         is available within RPICSEL.PRG.
  435.  
  436.         [end of OTHERS.HLP]
  437.