home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d853 / appisizer.lha / AppISizer / AppISizer.doc < prev    next >
Text File  |  1993-03-24  |  8KB  |  196 lines
  1.  
  2.  
  3.  
  4.  
  5.                                mAppISizer Docm
  6.  
  7.  
  8.                           version 0.61   3-Mar-93
  9.  
  10.  
  11.                            © 1992-93 Gérard Cornu
  12.  
  13.                           Compiled with SAS/C® 6.2
  14.  
  15.  
  16.  
  17.    AppISizer is ©1992-93 Gérard Cornu but is freely redistributable. When
  18.    re-distributing don't forget to include this unmodified doc file. And
  19.    don't charge more than the cost of an AmigaLibdisk from Fred FISH.
  20.  
  21.    This program cannot be used for commercial purposes, or included on
  22.    magazine's cover disks, apart from "AMIGA DP" (the french AmigaNews
  23.    sister's magazine exclusively dedicated to Amiga PD, FD, Shareware,
  24.    etc...), without the written permission of the author (myself!).
  25.  
  26.    Peter Miles (see end of file) is certainly allowed to include it
  27.    in the ICPUG Amiga library.
  28.  
  29.    Fred Fish is obviously allowed to include it in its unique AmigaLibDisk
  30.    library.
  31.  
  32.                                                                              
  33.   |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~| 
  34.   |  As regard to  Fred and the  AmigaLibDisk  library,  don't  forget to  | 
  35.   |  contact  your club or  'Fish disks'  distributor to have them take a  | 
  36.   |  regular  subscription  to  the  AmigaLibDisk  library, if they don't  | 
  37.   |  already have one. This is very important for the future of the Amiga- | 
  38.   |  LibDisk library, therefore for the future of the Amiga.               | 
  39.   |                                                                        | 
  40.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  41.    
  42.    Thierry Colin (Amiga DP / DPAT) is authorised to include it in the french
  43.    speaking Amiga PD collection "DPAT" (Domaine Public Amiga Toulouse).
  44.  
  45.  
  46. Requirement:
  47. ~~~~~~~~~~~~
  48.    AppISizer needs at least KickStart 37.175 to run, and has been developed
  49.    and tested with KS 37.175 and WB 38.35. It should work with higher 
  50.    versions as well.
  51.  
  52.  
  53. Intro:
  54. ~~~~~~
  55.    AppISizer is the 'Workbenchised' version of my littl'ol' Sizer utility. 
  56.    Not only is it Workbenchised, but as soon as it is launched it transforms
  57.    itself into an 'AppIcon', what a miracle! No... easy, thanks to C= Amiga
  58.    software people, not forgetting the hardware guys!
  59.  
  60.    I almost forgot to tell you something very important, AppISizer SHOULD
  61.    be pronounced 'appy sizer ;-)
  62.  
  63.  
  64. Quick description:
  65. ~~~~~~~~~~~~~~~~~~
  66.    AppISizer puts an 'AppIcon' on your Workbench (see below for configura-
  67.    tion). If you need more info  about 'AppIcons' have a look in the RKRM 
  68.    Libraries 3rd edition page 359+ (ISBN 0-201-56774-1), or just try 
  69.    AppISizer and you'll quickly know what an AppIcon is ;-). Once you drop
  70.    an icon on it, the represented object will be 'sized' and a window will
  71.    open to give you the results.
  72.  
  73.    You can drop several icons at once, using multi or extended selection .
  74.  
  75.    See the doc for Sizer, the shell version, for a detailed explanation of
  76.    the results.
  77.  
  78.  
  79. Starting AppISizer:
  80. ~~~~~~~~~~~~~~~~~~~
  81.    It can be started either by entering its name in a Shell (preceded by
  82.    'run >NIL:', double-clicking on its icon, or by dropping AppISiszer 
  83.    in your WBStartup drawer. 
  84.    
  85.  
  86. Removing AppISizer:
  87. ~~~~~~~~~~~~~~~~~~~
  88.    Very easy, just double-click on AppISizer's appicon then click on
  89.    'Remove AppISizer'.
  90.  
  91.  
  92. AppIcon configuration and output window position:
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94.    AppISizer 0.61 supports 5 ToolTypes and 5 command line options. 
  95.    
  96.    The ToolTypes are:
  97.    
  98.       ICON_PATH     <<<<<< before version 0.61 was: APPICON_PATH
  99.       ICON_XPOS     <<<<<<   "       "     "    "   APPICON_XPOS  
  100.       ICON_YPOS     <<<<<<   "       "     "    "   APPICON_YPOS
  101.       WINDOW_XPOS   <<<<<< new from version 0.61
  102.       WINDOW_YPOS   <<<<<<  "    "     "     "
  103.  
  104.    
  105.    The command line template is:
  106.    
  107.    ICON_PATH/K,ICON_XPOS/K/N,ICON_YPOS/K/N,WINDOW_XPOS/K/N,WINDOW_YPOS/K/N:
  108.    
  109.    ICON_PATH is for specifying an alternate AppIcon, the full path should 
  110.    be given. The '.info' extension is optional. If this tooltype is not 
  111.    set or if this path doesn't indicate an icon, AppISizer will use its 
  112.    internal icon image. 
  113.  
  114.    ICON_XPOS and ICON_YPOS are for the X (left position), and Y (top 
  115.    position) of the internal or external AppIcon. Please note that if you 
  116.    specify a position which is already occupied by another icon, or if you 
  117.    specify either position as 0, or if you supply only one position, 
  118.    Workbench will place the AppIcon wherever it sees fit.
  119.  
  120.    WINDOW_XPOS and WINDOW_XPOS are for positioning the top left hand corner
  121.    of the output window.
  122.    
  123.    The following is only for people who don't know how to use tooltypes:
  124.    
  125.       The ones supplied are in the form:
  126.       
  127.       (TOOLTYPE_FOO=<quick explanation text>)    <--- note the parenthèses
  128.                                                       and the angle brakets
  129.                                                           
  130.       If for exemple you want to use the tooltype ICON_PATH, you have first 
  131.       to remove the two parenthèses, then replace the text and angle brakets
  132.       by your choice ie:
  133.    
  134.       ICON_PATH=My_icon_assign:contains/the_nicest_icon
  135.       ICON_XPOS=500
  136.       ICON_YPOS=128
  137.       WINDOW_XPOS=50
  138.       WINDOW_YPOS=25
  139.       
  140.       
  141.    Command line exemple:
  142.    
  143.    run >NIL: AppISizer icon_path=dir:containing/my_icon icon_xpos=500 
  144.    icon_ypos=20 window_xpos=120 window_ypos=25
  145.    
  146.    Those tooltypes and options were added following suggestions I received
  147.    from Lucas Janin, thanks Lucas.
  148.  
  149.  
  150. WARNING:
  151. ~~~~~~~~
  152.    A quick word about AppISizer and links. Personally I don't use links,
  153.    not yet, I didn't get time to look at them! So AppISizer has not been
  154.    tested with soft or hard links. But don't hesitate to give me any
  155.    information about them and AppISizer's behaviour.
  156.  
  157.  
  158.    And don't forget to...
  159.                                                                             
  160.   |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~| 
  161.   |  Send any suggestion, bug report, compliment ;-), dark chocolate,      |
  162.   |  freely distributable software, 16 Gb hard disks, A3 48 bits colour    |
  163.   |  scanners, brand new AMIGA 6000 with Alpha CPU, etc...                 | 
  164.   |                                                                        | 
  165.   |  OR JUST A POST CARD to:                                               | 
  166.   |                                                                        | 
  167.   |                       Gérard CORNU                                     | 
  168.   |                       11 avenue Edouard Aynard                         | 
  169.   |                       69130 ECULLY                                     | 
  170.   |                                                                        | 
  171.   |                       FRANCE.                                          | 
  172.   |                                                                        | 
  173.   |                                                                        | 
  174.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  175.  
  176.  
  177.  
  178.                     Have plenty of nice days! ... me too!
  179.  
  180.  
  181.  
  182.     ¤ Peter Miles: ICPUG Amiga library organiser, (among other
  183.       ~~~~~~~~~~~~ responsibilities!).
  184.  
  185.       ICPUG is the one and only Independent Commodore Products Users Group.
  186.       ICPUG is a non-profit making volontary group run by its members
  187.             for its members.
  188.  
  189.       To become a member of this brilliant club contact:
  190.  
  191.       Jack COHEN, ICPUG Membership secretary, P.O. Box 1309,
  192.       LONDON, N3 2UT, ENGLAND.
  193.  
  194.  
  195.  
  196.