home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / POWERMAG / POWER052.MSA / DESKSWIT_DESKSWIT.DOC < prev    next >
Text File  |  1990-06-03  |  9KB  |  195 lines
  1.  
  2.                            Desk Switch
  3.  
  4.                The Ultimate Read-Only Control Panel
  5.  
  6.                       By Charles F. Johnson
  7.           Copyright 1990 Little Green Footballs Software
  8.  
  9.                            Version 1.1
  10.  
  11.                   Revised: Monday, June 4, 1990
  12.  
  13.  
  14.                            Introduction
  15.                            ------------
  16.  
  17.      Desk Switch is a versatile and powerful little program, that lets
  18. you instantly switch from one desktop setup to another.  Desk Switch
  19. reads .INF files created with the GEM desktop's 'Save Desktop' function,
  20. and sets every parameter saved in the file.  It can be run as an
  21. ordinary program (by double-clicking from the desktop), or as an
  22. "Installed Application" from the desktop or from CodeHead Software's
  23. HotWire.
  24.  
  25.      The Atari Control Panel desk accessory is normally used to set most
  26. of the parameters in the DESKTOP.INF file, but it has some distinct
  27. disadvantages.  First, it gobbles up a fairly large chunk of memory. 
  28. Second, it doesn't allow you to load a new .INF file; after the initial
  29. bootup configuration, you must make all other adjustments individually,
  30. by hand. 
  31.  
  32.      There are many "read-only control panel" desk accessories available
  33. as shareware or public domain, which will install the parameters in the
  34. DESKTOP.INF file (just once, at bootup), but don't allow you to edit any
  35. of these parameters.  (Hence the term "read-only.")  The advantage that
  36. Desk Switch has over any other "read-only control panel" is that it
  37. performs these functions in less than 1K of code, does not stay resident
  38. in memory when its job is finished, and allows you to load and install a
  39. new .INF file at just about any time. 
  40.  
  41.      Here's a list of the parameters Desk Switch reads and sets from an
  42. .INF file:
  43.  
  44.      o The name and position of every desktop icon, including the drives
  45.        and the trash can.
  46.  
  47.      o The position and status (open or not) of all GEM desktop windows.
  48.  
  49.      o Screen colors.
  50.  
  51.      o Printer settings.
  52.  
  53.      o RS232 settings.
  54.  
  55.      o Blitter setting.  (If you have a blitter in your machine, that
  56.        is.)
  57.  
  58.      o Key repeat/delay settings.
  59.  
  60.      o Bell and keyclick on/off settings.
  61.  
  62.      o Mouse double-click response rate.
  63.  
  64.      o The list of installed applications contained in the .INF file.
  65.  
  66.  
  67.                   Copyright and Shareware Notice
  68.                   ------------------------------
  69.  
  70.      Desk Switch was originally published in ST-Log (under a "one time
  71. only" contract).  Since the issue that featured it is long out of print,
  72. and very difficult to find, I rewrote the documentation (and tweaked the
  73. code a bit) and decided to rerelease Desk Switch as a Little Green
  74. Footballs shareware product.
  75.  
  76.      "Shareware" means that this program may be freely distributed; but
  77. if, after trying it out, you end up using Desk Switch, you're expected
  78. to pay a small registration fee of $10.00.  If Desk Switch fills a need
  79. for you, send a check or money order for $10.00 to:
  80.  
  81.      Charles F. Johnson
  82.      P.O. Box 1250
  83.      Pacific Palisades, CA 90272
  84.  
  85. and please indicate on your check that this is a registration payment
  86. for Desk Switch -- this will enable me to enter your name properly in my
  87. shareware data base.  If you'd like me to acknowledge your payment,
  88. include a stamped, self-addressed envelope.  And if you also include a
  89. floppy disk, I'll fill it up with the very latest versions of all Little
  90. Green Footballs programs, and send it back to you. 
  91.  
  92.      Desk Switch is Copyright 1990 Charles F. Johnson and Little Green
  93. Footballs Software.  All Rights Reserved.  This program may be freely
  94. distributed, as long as both the program file and this documentation are
  95. included.  Neither file may be altered in any way whatsoever, and no
  96. part of this program or its accompanying documentation may be reprinted
  97. in any form without the express permission of the author.
  98.  
  99.  
  100.                    Preparing To Use Desk Switch
  101.                    ----------------------------
  102.  
  103.      First, you should boot up with the Atari Control Panel installed,
  104. to set up your desktop, screen colors, mouse/keyboard parameters, etc. 
  105. Then save the desktop, with the 'Save Desktop' selection in the
  106. 'Options' drop-down menu.  This will write a file to your boot drive
  107. called DESKTOP.INF; this file contains all the parameters used by the
  108. Control Panel and the desktop to configure your system. 
  109.  
  110.      After saving the desktop, rename the newly-written DESKTOP.INF file
  111. to something else (retaining the .INF extension).  Now you can repeat
  112. this procedure for as many color setups, disk icon arrangements,
  113. installed applications, etc.  as you wish, renaming the DESKTOP.INF each
  114. time after saving your desktop.  When you have several of these .INF
  115. files prepared, you may want to move them all into a folder of their own
  116. to keep things neat. 
  117.  
  118.      Desk Switch checks to make sure the file you're attempting to read
  119. is a valid .INF file, created with "Save Desktop."  If you tell Desk
  120. Switch to read something that is not an .INF file, you won't see any
  121. warning; the program will simply exit without doing anything.
  122.  
  123.  
  124.             Running Desk Switch Without a Command Line
  125.             ------------------------------------------
  126.  
  127.      If you run Desk Switch directly (by double-clicking it from the
  128. desktop or running it from CodeHead's HotWire), you will be presented
  129. with the GEM file selector.  Use the selector to locate and choose an
  130. .INF file to install, and then click the file selector's OK button.  The
  131. new desktop setup will be installed, and Desk Switch will immediately
  132. exit.
  133.  
  134.  
  135.            Using Desk Switch With "Install Application"
  136.            --------------------------------------------
  137.  
  138.      Desk Switch can also be run through the desktop's "Install
  139. Application" feature, by installing DESKSWIT.PRG as an application for
  140. .INF documents.  (See your ST User's Manual for more info about "Install
  141. Application".)  If you do this, you can install new desktop setups
  142. simply by double-clicking the .INF file you wish to install from the GEM
  143. desktop.
  144.  
  145.  
  146.                   Using Desk Switch With HotWire
  147.                   ------------------------------
  148.  
  149.      If you use CodeHead Software's HotWire, you can build an entire
  150. HotWire menu of .INF files to pass to Desk Switch, and instantly install
  151. any setup with a single click of the button, or a single keypress. 
  152. There are two ways you can do this:
  153.  
  154.      1) Click on any empty HotWire menu slot and locate DESKSWIT.PRG
  155.         with the file selector that appears.  In the Program Options box
  156.         that appears after you've chosen DESKSWIT.PRG, enter "INF" as
  157.         one of the "Documents" for DESKSWIT.PRG.  Now you can install
  158.         your .INF files as "documents" in the HotWire menu. 
  159.  
  160.      2) Click on a blank line and locate DESKSWIT.PRG (as above).  This
  161.         time, in the Program Options box, type in the name of the .INF
  162.         file you want to install in this slot as the title (yes, even
  163.         though we're actually going to be running Desk Switch), and
  164.         select the button labelled 'Command Line'.
  165.  
  166.         You should now have a slot in the HotWire menu with the title
  167.         you've chosen for the .INF file.  Click on that slot -- HotWire
  168.         will present you with its Command Line box.  On the command
  169.         line, enter the full path and name of the .INF file you wish to
  170.         use.  (HotWire's Command Line box also lets you use the file
  171.         selector to select the path and name, instead of typing it.)  As
  172.         the last thing in the line, type the '~' (tilde) character.
  173.         (You can get this character by holding either Shift key and
  174.         typing the key immediately to the left of the Backspace key on
  175.         the top row.)  The tilde is a special character which tells
  176.         HotWire not to pause and present the Command Line box when this
  177.         entry is run; instead HotWire will immediately run the program
  178.         and pass it the currently defined command line. 
  179.  
  180.      The advantage of running Desk Switch by the second method is that
  181. it can be chained to other programs this way.  (HotWire does not allow
  182. "documents" to be chained.)
  183.  
  184. -----------------------------------------------------------------------
  185.  
  186.                            Version 1.1
  187.                            -----------
  188.  
  189.      The first shareware release of Desk Switch had a bug in its color
  190. setting routine -- in medium resolution, the second color register was
  191. being set incorrectly.  Version 1.1 fixes this problem. 
  192.  
  193.      Also, a small problem with "mouse droppings" has been fixed in
  194. version 1.1.
  195.