home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / System / RAWBInfo / RAWBInfo.doc < prev    next >
Text File  |  2000-08-24  |  12KB  |  305 lines
  1.                  RAWBInfo
  2.         © 1999/2000 by Stephan Rupprecht
  3.             All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  RAWBInfo is copyrighted 1999-2000 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the 
  12.  program(s) it describes.
  13.  
  14.  
  15. REQUIREMENTS
  16.  Any Amiga® (compatible) computer with at least OS3.5 and
  17.  68020+ cpu.
  18.  gtdrag.library v3+ for drag'n'drop support from one RAWBInfo
  19.  window to another one (dev/gui/gtdrag#?.lha).
  20.  
  21.  
  22. DESCRIPTION
  23.  RAWBInfo is a replacement for the AmigaOS3.5 icon information.
  24.  Unlike the original one, this one uses ReAction for the user
  25.  interface.
  26.  
  27.  
  28. STARTING THE PROGRAM
  29.  The program can be started from shell as well as workbench. It
  30.  currently takes the following arguments:
  31.  
  32.  SDT=SHORTDATETIME/S,AC=ALLCONTROLS/S,WP=WINPOS/K,SBB=SIZEBBOTTOM/S,
  33.  DNI=DROPNEWICONSDATA/S,DP=DROPPLANARDATA/S,MV=MULTIVIEW/K,LOADPATH/K,
  34.  SAVEPATH/K,TOOLS/M,AGS=AUTOGETSIZE/S,DW=DESTWIDTH/N/K,DH=DESTHEIGHT/N/K,
  35.  CREATEICON/K,AGV=AUTOGETVERSION/S
  36.  
  37.  SDT=SHORTDATETIME/S: this option tells RAWBInfo to use the
  38.   short date and time format of the current locale. Enabling it
  39.   makes the icon information windows a bit smaller.
  40.  
  41.  AC=ALLCONTROLS/S: no function as of 1.8.
  42.  
  43.  WP=WINPOS/K: place where the window should be opened. Possible keywords
  44.   are (default is TOPLEFT):
  45.   TOPLEFT: open the window in the left corner right under the titlebar.
  46.   CENTER: center the window on the screen.
  47.   MOUSE: open it relative to the mouse pointer.
  48.  
  49.  SIZEBBOTTOM/S: makes the bottom border of information windows as high
  50.   as the sizing gadget.
  51.   
  52.  DNI=DROPNEWICONSDATA/S: when an icon was originally saved in NewIcons
  53.   format, setting this option keeps icon.library from saving the
  54.   information back to the .info file.
  55.  
  56.  DP=DROPPLANARDATA/S: setting this option will keep icon.library from
  57.   storing any pre OS3.5 image data.
  58.  
  59.  MV=MULTIVIEW/K: the path were multiview can be found. Default: Sys/
  60.   Utilities/Multiview.
  61.   
  62.  IE=ICONEDIT/K: the path of IconEdit, defaults to Sys:Tools/IconEdit.
  63.  
  64.  LOADPATH/K: initial path of the "Icon Image/Load ..." filerequester
  65.   (see later).
  66.  
  67.  SAVEPATH/K: initial path of the "Icon Image/Save ..." filerequester
  68.   (see later).
  69.   
  70.  TOOLS/M: a list of default tools that are available when you click
  71.   on the dropdown chooser (that's the button on the _right_ side of
  72.   the default tool string gadget).
  73.   Example: TOOLS="MultiView" "Installer"
  74.   
  75.  CREATEICON/K: For objects that don't have an icon, rawbinfo automatically
  76.   saves one to disk. If you don't want this to happen or only optionally,
  77.   you can set this option to either NEVER or ASK.
  78.   
  79.  AGS=AUTOGETSIZE/S: setting this option causes RAWBInfo to automatically
  80.   start calculating the drawer size.
  81.   
  82.  AGV=AUTOGETVERSION/S: setting this option causes RAWBInfo to automatically
  83.   get the version number of a file/program.
  84.   
  85.  DW=DESTWIDTH/N/K,DH=DESTHEIGHT/N/K: the maximum size of the icon to create
  86.   when creating a new icon image from a picture object (eg. via IconImages/
  87.   Extras/Pic2Icon).
  88.   
  89.  Once the program has been started it can be removed by either 
  90.  sending CTRL-C to it, by the system tool Exchange or by starting
  91.  it a second time.
  92.  
  93.  
  94. USAGE
  95.  Well, if you know how to use the original icon information, you'll
  96.  know how to use this replacement ;) So, I will just mention the
  97.  extras here:
  98.  
  99.  ° dropping an icon on the window will open another icon information
  100.    window with information on the dropped icon.
  101.    
  102.  ° if you drop an icon on the tooltypes gadget, the program will replace
  103.    the current tooltypes with the one the dropped icon has.
  104.  
  105.  ° the default tool of a project can also be changed by drag&drop.
  106.  
  107.  ° double-clicking the icon will open the workbench object.
  108.  
  109.  ° you can dragNdrop icons from one rawbinfo window to another one
  110.    (requires gtdrag.library by Axel Dörfler, dev/gui/gtdrag#?.lha).
  111.    
  112.  ° starting 1.7 the following menu functions are available:
  113.    
  114.    Project
  115.    ============
  116.    Next        activate and bring to front the next rawbinfo window.
  117.    Previous    same as above but the previous one.
  118.    ------------
  119.    Version...    get the version of the file (requires c:version!).
  120.    ------------
  121.    Save        save the icon to disk.
  122.    Load default Replaces the current icon with the default one.
  123.    icon   
  124.    Save as     allows you to save the icon as default one to disk.
  125.    default icon 
  126.    ...
  127.    ------------
  128.    Delete icon    delete icon.
  129.    ------------
  130.    About    program copyright and version.
  131.    ------------    
  132.    Quit        guess what it does ;)
  133.    
  134.    Type        the Type menu allows you to change the icon type.
  135.    ============
  136.    Disk
  137.    Drawer
  138.    Project
  139.    Tool
  140.    Garbage
  141.    
  142.    Icon Image
  143.    ============
  144.    Default    get default image (supports DefIcons).
  145.    Copy        copies current icon image to the clipboard.
  146.    Paste    replaces current icon image with the one
  147.            stored in the clipboard.
  148.    Restore    restore original icon image.
  149.    ------------
  150.    Convert to    allows you to convert any old style icon
  151.    palette     to an os3.5 color icon.
  152.    mapped
  153.    Extras     -> Remap 1.3/2.0   
  154.             swaps the colors of any *4 color* old style icon.
  155.              this is useful for converting os1.3 icon colors to
  156.             os2.0 colors.
  157.              -> Pic2Icon
  158.                 when the file that belongs to the .info file is a
  159.                 picture, the icon images will be replaced by this
  160.                 picture.
  161.              -> Delete alternate image
  162.                   this one will delete the 2nd image from any color
  163.                   mapped icon (NewIcons, os3.5), icon.library creates
  164.                   a shadowed version of the normal image as a replace-
  165.                   ment. NOTE: there's a bug in icon.library that will
  166.                   produce garbage instead of a shadowed image. The
  167.                   icon will be correctly saved to disk (be aware of
  168.                   some enforcer hits! BB#2 will fix this problem).
  169.    ------------
  170.    Show clip ..    shows contents of the clipboad (see also
  171.            MULTIVIEW/K option).
  172.    IconEdit ... starts IconEdit.
  173.    ------------
  174.    Load ...    replace the current icon image with another one.
  175.    Save ...    allows you to save the current image to disk.
  176.    ------------
  177.    Frameless    make the icon frameless (works only for os3.5
  178.              coloricons, not for NewIcons!).
  179.    Drop     don't save NewIcons back in the NewIcons format.
  180.    NewIcons    
  181.    data
  182.    Drop planar    remove any old style image data from the icon.
  183.    data
  184.   
  185.    Tooltypes
  186.    ============
  187.    Clear    clear all tooltypes.
  188.    Sort        sort,
  189.    ------------
  190.    Disable all    disable,
  191.    Enable all    enable,
  192.    Toggle    toggle them ;)
  193.    ------------
  194.    Restore    restore original tooltypes.
  195.    
  196.  
  197. EXTRAS
  198.  The Installer script automatically installs an command called
  199.  WBInfo to your C: drawer. This command allows you to open an
  200.  icon information window from a shell. WBInfo takes the following
  201.  arguments: FILE=DRAWER=OBJECT/M/A,PUBSCREEN/K.
  202.  Where FILE,DRAWER or OBJECT is/are the object(s) to get information
  203.  on and PUBSCREEN the screen where the window should be opened
  204.  (defaults to Workbench).
  205.  
  206.  
  207. INSTALLATION
  208.  Simply use the supplied Installer script.
  209.  
  210.  
  211. SPECIAL THANKS GO TO
  212.  Thomas Richter for his help.
  213.  Nils Görs for the bug reports.
  214.  Roland Florac, Francis Labrie, Aleksandr, Alfredo Soro
  215.  Adam Chodorowski, Dámaso D. Estévez, Javier de las Rivas,
  216.  Llorenç Grau, Raul Silva, Joni Halme, Sinan Gürkan, Roger Sivertsen
  217.  for the catalogs. Also thanks to Raul for the icons.
  218.  
  219.  
  220. HISTORY
  221.  1.0    first public release for os35 betatesters.
  222.  1.1    various changes. supports localisation now.
  223.  1.2    added AC=ALLCONTROLS/S and SDT=SHORTDATETIME/S options.
  224.      fixed Enforcer hit on exit (FreeClass() stub instead
  225.      of inline was used). Thanks to Nils Goers for the bug 
  226.      report.
  227.  1.3    More than 127 tooltypes weren't supported (crashed badly).
  228.      Fixed. Thanks again to Nils Goers :)
  229.  1.4    included french catalog by R.Florac (Roland, there's something
  230.      wrong with your email account, I wasn't able to reply to your
  231.      message). some internal changes I can't remember ;) Changed the
  232.      way the icon gadget reacts to mouse clicks, now it behaves
  233.      like workbench icons (well, almost;).
  234.  1.5    Calculation of drawersize can be aborted at any time now. fixed
  235.      small bug in icon duplication function.
  236.  1.6    added CENTERED/S,SIZEBBOTTOM/S,TOOLS/M options.
  237.  1.7    released to my homepage. added a couple of new functions, the majority 
  238.      of them were adapted from SwazInfo (Icon Image menu/Tooltypes menu ...).
  239.      Added drag'n'drop support via gtdrag.library. misc house-keeping
  240.      changes. included russian catalog by Aleksandr <nikolya@bios.iuf.net>,
  241.      new french one by Francis Labrie and a spanish catalog by
  242.      Alfredo Soro.
  243.  1.8    swedish catalog by Adam Chodorowski. changed the user interface
  244.      a bit (still has to be improved) and added some more "SwazInfo
  245.      functions". ALLCONTROLS/S option is obsolete now, the layout code tries
  246.      its best to make the gui fit on the screen.
  247.  1.9    just a minor update, I am currently too lazy to add the requested 
  248.      features ;) added stackswapping code. now disables the "Type" menu
  249.      when calculting the drawer size. added a requester when changing
  250.      the icon type. new options IE=ICONEDIT/K and CI=CREATEICON/K.
  251.  1.10    fixed bug in menu handling code, "Icon Image / Copy" crashed
  252.      when cgx pictdt was used <Javier de las Rivas>.
  253.  1.11    fixed an english text <G.Donner>. replaced CENTERED/S with WINPOS/K.
  254.      new menu item "Project / Load default icon". fixed Installer script.
  255.  1.11a    fixed another english text (loose->lose;). Thanks again to G.Donner.
  256.  1.12    the get size gadget could report the wrong size for very big drives
  257.      and drawers (>4gb) <Stephen White>. now disables "Project / Load
  258.      default icon" while retrieving the size of a drive or drawer. new
  259.      option AGS=AUTOGETSIZE/S. note to the translators: new rawbinfo.cd!
  260.  1.13    added a new menu item to the "Project" menu to get the version of
  261.      a file. removed the space between the last word of a menu item and
  262.      the ellipsis (...) <G.Donner>. for drawers >2gb and <4gb, a negative
  263.      size was shown because of a wrong formating code (note to the 
  264.      translators: MSG_DRAWER_SIZE_FMT_NEW has changed) <Klaus B. Küsche>.
  265.      new menu item "Image / Extras / Remap 1.3/2.0" to remap os1.3
  266.      icon colors to os2.0 colors and vice versa <Klaus B. Küsche>.
  267.  1.14    the size gadget updates in real time, now. replacing the icon image(s)
  268.      by drag'n'drop could fail when the source icon didn't have 2nd
  269.      image <Arturo Franzin>.
  270.  1.15    saving an icon back to disk will now even work when the .info file
  271.      is protected from deletion <Arturo Franzin>. added "Icon Image /
  272.      Extras / Pic2Icon" and " ... / Delete alt. image" menu items.
  273.      the program can scale down images loaded via "Icon Image / Load ...",
  274.      now. when the name of the .info file exceeds the maximum length,
  275.      a (new) error requester will come up.
  276.  1.16    when replacing the image of an icon through the one of another icon,
  277.      both image types (new- and oldstyle) will be copied. Before the old
  278.      style image was ignored for icons that contained both types of images. 
  279.  1.17    pressing the zoom gadget maximizes the window, now <opi@snafu.de>,
  280.         added "version" gadget and AUTOGETSIZE/S option, rearranged GUI elements
  281.         and distributed them on two pages to make the windows smaller, changed
  282.         the way dropzones get highlighted.
  283.  
  284.  
  285. TODO (in no special order)
  286.  - implement rename function.
  287.  
  288.  
  289. AUTHOR
  290.  
  291.  Please send bug reports and ideas to:
  292.  
  293.     Stephan Rupprecht
  294.     Apfeldweg 1
  295.     D44359 Dortmund
  296.     Germany
  297.  
  298.  Send emails to
  299.  
  300.     info@stephan-rupprecht.de
  301.     
  302.  WWW
  303.  
  304.      http://stephan-rupprecht.de
  305.