home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 080.lha / UG / UG.readme < prev    next >
Encoding:
Text File  |  1986-11-21  |  7.0 KB  |  147 lines
  1. Copyright © Dennis Janssen 1987. All Rights Reserved.
  2. This program may be freely distributed as long as the accompanying files
  3. including this `readme' file remain with it.
  4.  
  5. Utility Gadgets (UG) is a programmable `control panel' creation tool.  It allows
  6. the user to custom design `gadget windows' to run his/her programs with the mouse.
  7. I have included some example files to help you get the right idea.
  8.  
  9.   To test Utility Gadgets:
  10.   ------------------------
  11.  
  12.              1. change directory to the directory that you arced the file in,
  13.                 the one with the `.ug' files
  14.              2. type `run ug .ug0'
  15.  
  16.   a better demo can be seen by copying the .ug files to ram: first-
  17.     -----------
  18.              1. change directory to the directory that you arced the file in,
  19.                 the one with the `.ug' files
  20.              2. copy #?ug#? ram:
  21.              3. cd ram:
  22.              4. type `run ug .ug0'
  23.  
  24.   The last gadgets at the end of the window with names containing `.ug' or
  25.                                                  -------------------------
  26. numbers are commands to redefine the gadgets and window setup. Click on these for a
  27. -------
  28. demonstration of some of the types of possible setups you can arrange.  (Most of
  29. -------------
  30. these `definition files' may not be the best one could do as far as aesthetics goes
  31. but they are examples of some of the features. I use a version of one of them as
  32. my basic control panel.)  You can edit the `.ug' file to put any gadget name in
  33. a window gadget with any corresponding command string which will be passed directly
  34. to AmigaDOS.
  35.   Be sure you click on each definition file from `.ug0' to `.ug15', most are quite
  36. unique and they give you some feel for the range of possible window sizings, and
  37. colors..
  38.  
  39. Clicking on the other gadgets in the window will run a command that is associated
  40. with that gadget. Most of the gadgets have commands which you may not have in
  41. your c: directory but you should get the idea -- these gadget names and commands
  42. are totally programmable by you the user.
  43.  
  44.   Utility Gadgets can take one argument from the cli which designates the file
  45. that is to defines the gadgets. If you don't give it an argument it will try to
  46. read `s:.ug' if that file doesn't exist and there is no argument then ug won't
  47. run.
  48.  
  49.   The sale price of this program is $10.  This will get you the full
  50. documentation and support if necessary via telephone.  Please send a
  51. self-addressed stamped envelope with a check to:
  52.  
  53.                     Dennis Janssen
  54.                     2452 Bancroft,#5
  55.                     Berkeley,CA
  56.                     94704
  57.  
  58.   Utility Gadgets is easy to use and to program but to help ensure user
  59. cooperation I am only including here a portion of the documentation.  With
  60. this information you will be able to experiment with UG but won't be able to
  61. fine tune it.  I recommend you look at it along side of a definition file, eg.
  62. `.ug6'.
  63.  
  64.   First a few simple, possibly obvious terms:
  65.   1. the `defintion file' is the file that defines the gadgets (default=
  66.      `s:.ug')
  67.   2. the `number line' is the first line of the
  68.      defintion file
  69.   3. a `gadget definition line' is one of the other lines in the definition
  70.      file eg.:
  71.  
  72.          Format ? run format drive df1: name blank noicons
  73.  
  74.   4. a `field' is a delimited string of characters in the definition file the 2
  75.      delimiters are the space character and the end of the line
  76.   5. the `name field' on a gadget defintion line is the first field, here
  77.      `Format'
  78.   6. the `gadget name' is the name actually printed on the gadget
  79.      in the window
  80.   7. the optional `requester field' is the second field, here `?'. This
  81.      can be used to prevent a mistake of accidentally hitting a gadget
  82.      that could cause problems if it is improperly executed.
  83.   8. the `command field' is any remaining string on the line here `run
  84.      format drive df1: name blank noicons', it's delimiter is the end of the line
  85.  
  86.  
  87. Number Line Variables:
  88.  
  89. 1. In the defintion file the first number on the number line is for the number
  90. of gadgets you want in the window.
  91.  
  92. 2. The length of the gadget can be fixed or variable depending on the second
  93. number on the number line. A zero there will make the gadget name exactly
  94. equal to its name field.  Any other value there will limit the gadget name
  95. length to that value.  This is so you can pack the gadgets in the window and
  96. save on precious screen `real estate' or place them in a more regular and
  97. maybe more aesthetically pleasing way.
  98.  
  99.   `Redefine' is a special built in command, not a DOS command.  It allows
  100. you to redefine the gadgets with a new definition file. It also works with `+'.
  101.  
  102.   The other variables, explained in the full documentation, allow you to
  103. position the window anywhere on the screen, to give your window any title you
  104. like, to control the window's maximum width, allow you to change spacing between
  105. gadgets both vertically and horizontally, to change the border spacing around
  106. the gadget name in the gadget box, to change change the gadget colors, the color
  107. for the windowborder, string gadget border, to set the system gadget flags for the
  108. window, how to use the string gadget, how to set its size, border color, etc.
  109.   I will give more explantion over the telephone if the documentation fails to
  110. answer you questions.
  111.  
  112.   You do not have to fill in all these variables every time from scratch.  Rather
  113. you copy the file that is nearest to what you want and edit it till it fits your
  114. needs.  You can do this until you get the documentation.
  115.  
  116.   One interesting idea for using UG is to have it in your startup-sequence (eg.
  117. "run ug") and to have in the initial defintion file ("s:.ug" in this case)
  118. defintions to redefine it according to the different major types of uses you have
  119. for your computer. You can go from one `control panel' or ` window menu' to another
  120. as you need to in a linked tree and all the commands you usually have to type are
  121. only a click of the mouse away. This is especially fast if the definition files
  122. are in ram: or vd0: , the whole system including the defintion files and the window
  123. bitmap only takes about 20k.
  124.  
  125.  
  126.   I hope you find this program useful.  I don't know of any bugs (except for maybe
  127. in the documentation), please let me know if you find any. I intend to improve                                  ---
  128. the documentation and I have some interesting ideas for new extensions to the
  129. software.  More will come, with your cooperation!
  130.  
  131.   Thank you for your interest.
  132.  
  133. Version 1.2 is incompatible with the earlier versions.  I added a new variable.
  134. -----------
  135. If UG doesn't get enough variables to eat it's been known to make a mess.  So
  136. you must use the new definition files with this version.  I also made some other
  137. improvements in the program and the defintion file examples are quite a bit better.
  138.  
  139. I work on an interlace screen so the defintion files are first designed for this
  140. mode and then edited for the non-interlaced modes (they work with 60 column also).
  141. To prevent having to 2 or 3 versions of these files I made some concessions.
  142. There is still some work to be done to smooth them out but I think you'll get the
  143. idea of what Utility Gadgets is all about.
  144.  
  145.  
  146.  
  147.