home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 8 / amigaformatcd08.iso / locale / help / newicons.guide (.txt) next >
Amigaguide Document  |  1996-07-15  |  53KB  |  965 lines

  1. @database NewIcons.guide
  2. @$VER: 39.1 (09-Jul-96)
  3. @author "Philip A. Vedovatti/Eric Sauvageau"
  4. @(c) "1996"
  5. @node "MAIN" "NewIcons"
  6. @next "Introduction"
  7.                            @{b}The NewIcons Package@{ub}
  8.                                @{b}Version 3.0@{ub}
  9.                   brought to you by @{"
  10. NewIcons
  11. " link "Authors" 0}
  12.        ____________________________________________________________
  13.                               @{"
  14. Introduction
  15. " link "Introduction" 0}
  16.                               @{"
  17. Features
  18. " link "Features" 0}
  19.                               @{"
  20. Installation
  21. " link "Installation" 0}
  22.                             @{b}The Main Programs:@{ub}
  23.                                 @{"
  24. NewIcons
  25. " link "NewIcons" 0}
  26.                                 @{"
  27. DefIcons
  28. " link "DefIcons" 0}
  29.                             @{b}The Support Files:@{ub}
  30.                             @{"
  31. NewIconsPrefs
  32. " link "NewIconsPrefs" 0}
  33.                             @{"
  34. CopyNewIcon
  35. " link "CopyNewIcon" 0}
  36.                             @{"
  37. InjectBrush
  38. " link "InjectBrush" 0}
  39.                             @{"
  40. CreateDefaultIcon
  41. " link "CreateDefaultIcon" 0}
  42.                             @{"
  43. KillNewIcon
  44. " link "KillNewIcon" 0}
  45.                             @{"
  46. PatchOpenWb
  47. " link "PatchOpenWb" 0}
  48.                             @{"
  49. Tricks
  50. " link "TipsAndTricks" 0}
  51.                             @{"
  52. Authors
  53. " link "Authors" 0}
  54.                             @{"
  55. Acknowledgements
  56. " link "Acknowledgements" 0}
  57.                             @{"
  58. Distribution
  59. " link "Distribution" 0}
  60.                             @{"
  61. Version
  62. History
  63. " link "History" 0}
  64. @endnode
  65. @node "Introduction" "Introduction"
  66. @next "Features"
  67. @prev "MAIN"
  68.  @{fg fill}Greetings Amiga User!@{fg text}
  69. The @{b}NewIcons Package@{ub} is a revolutionary GUI enhancement system for the Amiga
  70. computer. It adds many new features to the Workbench that, we hope, will be
  71. standard in the next generation Amiga operating system.  Specifically, it
  72. allows for a palette independent icon system whereby icons look color correct
  73. on any system, no matter what your Workbench palette is set to.  It allows you
  74. to use icons in up to 256 colors, adds default icons for many, many file
  75. types, and works on any Amiga with OS2.04 and up.
  76. If you have never used NewIcons before, please read the documentation
  77. carefully...it will save you from any trouble you should encounter. If you are
  78. a seasoned NewIcons user, also be sure to read the documentation
  79. carefully...there are a lot of new @{"features" link "Features" 0} in this latest version.
  80. This archive is not "just another set of icons". This is a completely new
  81. concept, which we hope will revolutionize, and push in the right direction,
  82. the idea of GUI on the Amiga.
  83.                              BACKGROUND INFORMATION
  84.                              ======================
  85. Kickstart 3.0 was Commodore's first step towards ReTargetable Graphics. There
  86. isn't a device independent graphic engine yet, but there is a new pen
  87. arbitration system which allows applications to obtain a given color, or the
  88. one which is closest to it if there are not enough free pens.
  89. It's simply ridiculous that, on a system capable of displaying a 256 color
  90. Workbench screen, and with a pen arbitration system like the one described
  91. above, icons are limited to 8 colors. Various solutions have been proposed,
  92. ranging from "use some colors and hope they are right" to "allocate some pens
  93. and reserve them for icon display", but they all miss the point, which is:
  94.   Why should I, the user, have to care about the icon palette?
  95.   Why should I set the system palette in a way decided by someone else
  96.   (the icon designer) and not the way _I_ like it?
  97. When you display a picture on the Workbench screen using MultiView, you don't
  98. have to care about the palette: the system chooses it for you. So why should
  99. one care about the palette used by icons? The system should take care of it,
  100. not the user.
  101. Unfortunately, icons don't carry palette information. Therefore, Nicola had to
  102. defiine a new standard for icon files, and write a system patch to make the
  103. system recognize them. Several goals had to be reached:
  104.  The new standard should be backward compatible, that is users not
  105.    running the patch program should see the standard 4-color icons.
  106.  Manipulation of icons by users not running the patch program should not
  107.    cause the new icon information to be lost.
  108.  Remapping of the icons to the Workbench palette should be as fast as
  109.    possible.
  110.  Data should be compressed in order to reduce disk usage.
  111.  The patch should work even on Kickstart 2.0 systems, with limited
  112.    features.
  113. All of the above goal have been reached. The new icon information is stored in
  114. the ToolTypes, so it is completely backwards compatible. A library,
  115. newicon.library, takes care of reading and writing the imagery in the
  116. ToolTypes; it also hides away the special ToolTypes so that when one asks for
  117. Information about an icon only the standard ToolTypes are shown. A patch
  118. program, NewIcons, intercepts calls to icon.library, redirecting them to
  119. newicon.library, so that Workbench and all other applications transparently
  120. get the new icon imagery.
  121. @endnode
  122. @node "Features" "NewIcon Features"
  123. @next "Installation"
  124. @prev "Introduction"
  125.  @{"NewIcons" link "NewIcons" 0} is a revolutionary system patch which enhances your Workbench
  126.  and gives the user much more power and configurability over the
  127.  appearance of the GUI (Graphical User Interface).  The NewIcons
  128.  system works transparently, and provides for a standard icon system
  129.  that will look the same on any system, no matter what the palette is
  130.  set to.
  131.  @{"DefIcons" link "DefIcons" 0} complements the Newicons system.  It works by
  132.  recognizing a file's type, and instantly displaying the appropriate
  133.  icon image for files without icons attached to them.
  134.  @{u}The system's features include:@{uu}
  135.  Allows up to 256 color icons on an AGA machine. (!)
  136.  Icon colors are color correct on an AGA system @{i}no matter what your
  137.     palette is set to@{ui}.  They automatically appear in perfect color.
  138.  Default icons for dozens of file types automatically appear for
  139.     files without icons (@{u}FAST@{uu}!).  Recognizes file types in a very
  140.     efficient manner.  If you click on a "fake" icon, your appropriate
  141.     user-defined default tool will appear in the "Execute command" text
  142.     field automatically!
  143.  Make a brush, convert it to an icon.  It will appear on your workbench
  144.     in the @{u}exact@{uu} proper colors you created it in, no matter what your
  145.     palette is set to.  Imagine making gorgeous icons from your digitized
  146.     pics, in @{u}more@{uu} than 16 colors!
  147.  Icon images are compressed to maximize disk space.  They are
  148.     uncompressed faster than you can say "NewIcons"!
  149.  Also KS 2.04 compatible (16 color icon limitation).
  150.  Fix that ugly Cross-DOS icon to look like a standard NewIcon.
  151.  Unique icons for RAM-Disks and CD-ROM's that don't have icons.
  152.  A complete set of beautiful, standardized Workbench icons, drawn by
  153.     artist Roger McVey.
  154.  Comprehensive set of utilities to allow you to manipulate your
  155.     NewIcons.
  156.  FREEWARE!  Why would anyone want to pay cash for icons?
  157.  Dithering of icon images is selectable for users with fewer available
  158.     Workbench colors.  This is turned off by default.
  159.  Icons can be given a single tooltype, which will tell NewIcons to display
  160.     a NewIcon image from elsewhere on the system.  This feature
  161.     has some @{"caveats" link "TipsAndTricks" 140}, but introduces a huge number of neat possibilities
  162.     for configuring your Workbench, and saves on disk space and chip RAM.
  163.     Imagine having your Workbench icons appear randomly different on EACH
  164.     reboot!
  165.  The source for deficons.prefs has been included, so any enterprising
  166.     programmer can add their own file identification types to the system!
  167.  @{fg shine}NEW!@{fg text}  User configurable, GUI enhanced Preferences program to configure all
  168.     attributes of the NewIcons system (dither, pen precision, etc.)
  169.  @{fg shine}NEW!@{fg text}  The NewIcons system is now a commodity, which can be enabled and
  170.     disabled on the fly, using Commodities Exchange.
  171.  @{fg shine}NEW!@{fg text}  RTG (ReTargetable Graphics) mode, which allows graphics card users
  172.     to store icon data in fast RAM instead of chip RAM.  This has the
  173.     advantage of saving your valuable chip RAM for other uses, and speeds
  174.     up rendering of icons on the Workbench.
  175.  @{fg shine}NEW!@{fg text}  Borderblank option!  Remember the Kickstart 1.3 days when there
  176.     were no gray border boxes around the icons?  This new option removes
  177.     those silly looking boxes once again, and is user configurable.
  178.  @{fg shine}NEW!@{fg text}  Faster icon rendering routines should speed things up even more.
  179.  @{fg shine}NEW!@{fg text}  Optimized newicon.library for '020+ machines.  ZOOOM!
  180.  @{fg shine}NEW!@{fg text}  New DefIcons brainfile which recognizes many more file types,
  181.     including .lzx, .png, and much more.
  182. @endnode
  183. @node "Installation" "Installation"
  184. @next "NewIcons"
  185. @prev "Features"
  186.   To install the package, just double click on the "Install_NewIcons"
  187.   icon.  If you are currently running a previous version of NewIcons,
  188.   double click on the "Update_NewIcons" instead -- the updater script
  189.   will update only the binaries and won't install the icons.
  190.   Make sure you have some disk space on your SYS: partition.
  191.   You should have at least 250K available if you install the entire
  192.   package.  If you don't have enough room on your partition and
  193.   you still want to install the package, see the @{"tips
  194. tricks" link "TipsAndTricks" 0} section
  195.   to learn how to make more room for the images.  Alternatively, you
  196.   can install @{"NewIcons" link "NewIcons" 0} without the @{"DefIcons" link "DefIcons" 0} files.
  197.   You will be prompted as to which parts of the distribution you want
  198.   to install.  For maximum performance, it is suggested that you install
  199.   both NewIcons and DefIcons.
  200.   The installer script will install the icon images on your system.  The
  201.   existing tooltypes of your icons will not be touched by the installation
  202.   script, and the original icon images will not be altered.  You will not see
  203.   the new icon images until the NewIcons program is run.  The installer
  204.   script will launch NewIcons immediately, so you can view the new images 
  205.   right away.  Since your original icon images are not actually deleted, 
  206.   it is easily possible to restore the icons to their original appearance, 
  207.   so don't be intimidated by the installation process.
  208.   The NewIcons program will be copied to your c: directory, and
  209.   newicon.library will be put in your Libs: directory.  You'll
  210.   be given the option of where you would like to put the other icon
  211.   utilities.  If you choose to install DefIcons (highly recommended),
  212.   the program will be copied to your c: directory and the default icons
  213.   and brainfile will be put in ENVARC:.  Your old default icons will
  214.   be backed up by the installer.
  215.   The program @{"PatchOpenWB" link "PatchOpenWb" 0} will be copied to c:.
  216.   Two short commands will be added to your s:user-startup file to launch
  217.   NewIcons and DefIcons whenever you boot your system.
  218.   @{b}Users of previous versions of NewIcons!  IMPORTANT!:@{ub}
  219.   The 3.0 version of NewIcons requires a change in how it is run in the
  220.   user-startup script.  For technical reasons, it must now be RUN'ned
  221.   like this:
  222.   RUN <>NIL: c:NewIcons
  223.   If you installed NewIcons previously with the installer script, the
  224.   installer will seek out the ;Begin Newicons line in the user-startup,
  225.   and will make the change for you automatically.  If you have altered
  226.   your user-startup and removed the ";Begin Newicons" section, or added
  227.   the NewIcons commmand elsewhere in your startup, you will have to
  228.   remove the old NewIcons command from the user-startup script.
  229.   @{b}@{fg shine}If your user-startup script launches NewIcons the old way (without
  230.   "RUN <>NIL: c:NewIcons"), your Amiga will freeze during bootup.@{ub}@{fg text}
  231.   @{b}Kickstart 3.x users! IMPORTANT:@{ub}
  232.   ----------
  233.   You need to add a line to your s:startup-sequence to fix a bug in
  234.   Kickstart 3.x.  Add the following line to your startup-sequence,
  235.   before IPrefs and after SetPatch:
  236.   C:PatchOpenWB
  237.   Users of 2.04 need not worry about this step.
  238.   ---------
  239.   Once the installation is complete, reboot your computer and you're
  240.   ready to have the best looking GUI anywhere!
  241.   The installation program only installs images for the standard WB, so
  242.   some files will likely not be "NewIconized" by the installer script.
  243.   Don't worry; you can add images to these icons later using the
  244.   @{"CopyNewIcon" link "CopyNewIcon" 0} utility supplied in this archive.
  245.   NewIcons works by installing compressed images of the new icons into
  246.   tooltype lines of the .info files.  Once NewIcons is launched, you
  247.   will not see these tooltypes, so they will not interfere with your
  248.   work.  If for some reason you are not happy with NewIcons, you can
  249.   use the utility @{"KillNewIcon" link "KillNewIcon" 0} to remove these images from the .info
  250.   files, restoring them to their original appearance.
  251.   The big advantage of this system is that when the NewIcons program
  252.   is run, you see the new icon images.  When NewIcons has not been
  253.   started, you will see the boring old icon you viewed before you
  254.   received this package.  Therefore, icons that are transferred to
  255.   users not running NewIcons will still be visible as a plain,
  256.   old-style icon.
  257. @endnode
  258. @node "NewIcons" "NewIcons"
  259. @next "DefIcons"
  260. @prev "Installation"
  261.   @{fg shine}NEWICONS@{fg text}
  262.   ========
  263.   This program is the heart of the package, and is launched from
  264.   your user-startup.  It must be RUN'ned from the user-startup
  265.   like this:
  266.    RUN <>NIL: c:newicons
  267.   It accepts three parameters, and its template is as follows:
  268.   @{b}CX_PRIORITY/N/K,CX_POPKEY/K,PE=PREFSEDITOR/K@{ub}
  269.   @{b}CX_PRIORITY/N/K@{ub}  -  This is the standard commodity hotkey priority.
  270.                       This parameter prevents conflicts with hotkeys
  271.                       between different programs.  Consult your
  272.                       Workbench manual if you don't understand this
  273.                       parameter.  The default setting for this
  274.                       parameter is 0, and most likely you won't need
  275.                       to change it.
  276.   @{b}CX_POPKEY/K@{ub}  -      NewIcons is now a commodity, and pressing the
  277.                       specified hotkey will open a window displaying
  278.                       information about NewIcons, the current settings
  279.                       for NewIcons, and displays a gadget to launch
  280.                       the prefs program.  The default hotkey is
  281.                       Lalt Shift N.
  282.   @{b}PE=PREFSEDITOR/K@{ub} -  This defines where NewIcons should looks for its
  283.                       preferences program.  By default, it looks for
  284.                       Sys:Prefs/NewIconsPrefs.  If you have placed
  285.                       the prefs editor in another location, use this
  286.                       parameter so NewIcons can find it.
  287.   Examples:
  288.   RUN <>NIL: C:NewIcons  (most people will use this)
  289.   RUN <>NIL: C:NewIcons CX_POPKEY "lalt shift P"
  290.   RUN <>NIL: C:NewIcons PE Work:Prefs/NewIconsPrefs
  291.   The idea behind NewIcons is that we shouldn't need a fixed color
  292.   scheme for icons anymore. NewIcons will automatically remap icon images
  293.   using the colors available on the Workbench screen. A specific palette
  294.   is therefore not required (icons look @{i}reasonable@{ui} even on a 2-color
  295.   Workbench) but it is suggested to obtain best results. If you use a
  296.   Workbench with >= 64 colors, you can ignore the palette completely.
  297.   The file "palette.preset" is the palette I use on my Workbench. Note
  298.   I have changed the pens used by bright and dark edges to have smoother
  299.   button gadgets, and that color 3 is the same as color 0 so that the
  300.   shell cursor is of the correct color. This palette uses 7 out of the
  301.   standard 14 colors used by the NewIcons.  The remaining 7 are dynam-
  302.   ically allocated at run time.
  303.  @{b}Workbench 2.0 users:@{ub}
  304.   If you are running Kickstart 2.0, you will have to set up a suitable
  305.   palette.  The colors used by the supplied icons are:
  306.                       Dec
  307.                    R   G   B
  308.                   --- --- ---
  309.      Black         0   0   0
  310.      Gray1         2   2   2
  311.      Gray2         5   5   5
  312.      Gray3         8   8   8
  313.      Gray4        10  10  10
  314.      Gray5        12  12  12
  315.      White        15  15  15
  316.      Green         2   8   2
  317.      Yellow       13  11   3
  318.      Red          13   2   2
  319.      Purple        9   4  10 
  320.      Light Brown  12   9   6
  321.      Dark Blue     0   5   9
  322.      Light Blue    5   8  11
  323.   Of course you can sort them anyway you like, since NewIcons will pick
  324.   the correct colors from the above palette for you.
  325.   A palette for 2.0 is supplied in the Extras drawer of this
  326.   distribution.
  327.   In this version, there is a new tooltype feature.  Any icon that does
  328.   not have NewIcon image data in it can be given a single tooltype to
  329.   cause NewIcons to "borrow" an image from another NewIcon icon. To
  330.   use this feature, you simply add the following tooltype to the icon:
  331.   @{b}DEFAULTIMAGE=<location of image to "borrow">@{ub}
  332.   For example, you could direct all your drawer icons to a single image
  333.   on your harddisk or RAM: disk.  Once this is done, you can change the
  334.   image of all your drawers by changing the single "loaner" icon.  You
  335.   can read more about using this feature @{"here" link "TipsAndTricks" 145}.
  336. @endnode
  337. @node "DefIcons" "DefIcons"
  338. @next "NewIconsPrefs"
  339. @prev "NewIcons"
  340.   @{fg shine}DEFICONS@{fg text}
  341.   ========
  342.  Deficons is run as a single command in the user-startup.  It takes no
  343.  parameters, and does not need to be RUN'ned, since it automatically
  344.  detaches from the CLI.
  345.  The DefIcons patch will magically transform Workbench's silly fake icons
  346.  (displayed when you pick the menu item Window/Show/All Files) into more
  347.  meaningful ones.  The program not only recognizes files such as projects
  348.  and tools, but identifies various other file types:
  349.        
  350.  IFF, JPEG, ANIM. GIF and PNG files
  351.        
  352.  8SVX, SMUS, DCMS, Med, and PT/ST mods
  353.        
  354.  Handlers, Kickfiles, and Filesystems
  355.        
  356.  ASCII, TeX, AmigaGuide and Postscript files
  357.        
  358.  Source codes of various languages
  359.        
  360.  Keymaps, Datatypes, Libraries, and Printer Drivers
  361.        
  362.  Various crunched filetypes
  363.        
  364.  Bitmap and Outline Fonts
  365.          ...and several more.
  366.  Just like any "fake" icon, you can't double click on fake icons to
  367.  start the associated tool immediately, but if you have designated a
  368.  default tool for the deficon (located in ENVARC:sys), the "Execute
  369.  Command" text field will automatically have the default tool entered
  370.  for you.  This feature is very handy for things like text files and
  371.  picture files that don't have icons attached to them.
  372.  Additionally, you can transform a fake icon into a real icon using
  373.  the @{"CreateDefaultIcon" link "CreateDefaultIcon" 0} utility.
  374.  DefIcons has a brainfile called deficons.prefs, which is copied to ENVARC:
  375.  by the install_NewIcons script. Unfortunately, it is currently not possible
  376.  to easily edit the brainfile, so you can't add your filetypes, but the
  377.  source code for deficons.prefs is included.  Will a little programming
  378.  knowledge, you can create your own deficons classes.  When you install
  379.  NewIcons, the Installer script copies the default def_xxx icon images to
  380.  ENVARC:.  These icons are used by DefIcons.
  381.  Apart from fake icons, DefIcons has another wonderful feature: if a
  382.  volume doesn't have a disk.info icon, it will replace the standard
  383.  def_disk.info icon used by Workbench with a user-defined one. For
  384.  example, it will use def_CD0disk.info for a CD in CD0:, and
  385.  def_RAMdisk.info for the Ram Disk.  If you did the old 'copy ramdisk.info
  386.  to ram:disk.info' trick, you can remove that command from your
  387.  startup-sequence.
  388.  DefIcons works well with multiple files systems and MFS.  When a disk
  389.  without disk.info is inserted in DF0:, it first searches for an icon
  390.  named def_DF0disk.info; if it can't find it, it looks for an icon
  391.  named after the file system (def_DOS0disk.info, def_MSD0disk.info,
  392.  def_PFS0disk.info...) so you can have different icons for different
  393.  file sytems.  Latest versions of CrossDos use an icon of their own
  394.  for MS-DOS disks.  Since the icon is really ugly, you may want to use
  395.  your def_MSD0disk.info.  To do that, load L:crossdosfilesystem into
  396.  a hex editor, search for the string "disk.info" and replace it with
  397.  something else, for example "dusk.info".
  398.  The disk trick will also work for non-DOS disks.  In this case, the
  399.  basename is the one displayed by Workbench under the icon.  For
  400.  example if Workbench shows "DF0:NDOS", the icon named def_NDOSdisk.info
  401.  will be used.  DF0:???? is a special case: def_BADdisk.info will be
  402.  used.
  403.  DefIcons uses a tree structure when identifying files.  For a JPEG
  404.  picture, for example, DefIcons will search in order first for
  405.  def_jpeg.info, def_picture.info and def_project.info.  IFF files are
  406.  special, and DefIcons will search for def_XXXX.info, where XXXX is the
  407.  FORM type of the file.  If it can't be found, def_iff.info is used.
  408.  For archived files there are three families: def_archive (lha, zip,...),
  409.  def_filearchive (for uuencode, compress, gzip,...) and def_diskarchive
  410.  (DMS).  These families can have sons (i.e, def_lha,  def_dms, etc)
  411.  if you create and add them to your ENVARC:sys directory.
  412. @endnode
  413. @node "NewIconsPrefs" "NewIconsPrefs"
  414. @next "CopyNewIcon"
  415. @prev "DefIcons"
  416.   @{fg shine}NewIconsPrefs@{fg text}
  417.   =============
  418.   This is a new feature in NewIcons v3.  All configuration of
  419.   NewIcons options done with the preferences program.  There
  420.   are three ways of launching the preferences program for your
  421.   convenience:
  422.    1)  Start the Commodities Exchange program and select NewIcons.
  423.        Click on the "Show Interface" gadget, or:
  424.    2)  Double-click on the NewIconsPrefs icon from the Workbench,
  425.        or:
  426.    3)  Just hit the NewIcons hotkey (default is Left-Alt+shift+N)
  427.        NewIcons will open a status window showing how many Newicons
  428.        are currently open, and all the current options.  From here
  429.        you can click on "OK" to close the window, or click on
  430.        "Prefs" to launch the preferences program.
  431.   @{b}Using NewIcons Prefs@{ub}
  432.   There are five configurable options from the Preferences program:
  433.    @{b}DITHERING@{ub}  -  (default: OFF)  -  Normally NewIcons does not dither
  434.                  the icon images.  This generally results in better
  435.                  looking icons for AGA systems, since the icons
  436.                  appear exactly as they were created.  For users
  437.                  with a limited number of available colors on the
  438.                  Workbench (such as those with <32 colors or a 2.04
  439.                  system), you can try the DITHER option to improve
  440.                  the appearance of the icons.
  441.                  
  442.    @{b}NO BORDERS@{ub} -  (default: OFF)  -  Using this option removes the
  443.                  bounding icon boxes around your icons.  This can
  444.                  dramatically change the appearance of your WB.
  445.                  This option is recommended primarily for die-
  446.                  hard NewIcons users who have done away with all
  447.                  those non-NewIcon images on their system.  It
  448.                  can make non-NewIcon icons look strange at times,
  449.                  but can transform your Workbench into a visually
  450.                  stunning interface.  Color zero is made completely
  451.                  transparent, so the backdrop will fill where the
  452.                  box was.
  453.    @{b}RTG MODE@{ub} -    (default: OFF)  -  This new feature has been added
  454.                  for the benefit of graphics card users only, and if
  455.                  you have a graphics card, you should set this mode
  456.                  to ON.  RTG mode allows NewIcons to render the icon
  457.                  images in Fast RAM instead of Chip RAM.  It has
  458.                  several advantages, including saving your precious
  459.                  chip RAM for other uses, and speeds up icon render-
  460.                  ing, since access to fast RAM is, well, faster! :)
  461.                  If you don't have a graphics card, keep this mode
  462.                  OFF or you will meet the Guru, most likely.
  463.                  Note: RTG mode is only available with the '020+
  464.                  version of the library.
  465.    @{b}DEPTH PROMOTE@{ub}-(default: NONE)  -  This option is really only use-
  466.                  ful when using the NO BORDERS option.  If you have
  467.                  non-NewIcon images that look particularly strange,
  468.                  you can try this option.  Turning on this option
  469.                  causes all non-NewIcon images to be promoted to
  470.                  8 bitplanes, and can sometimes fix those wierd
  471.                  looking non-NewIcon images.  The drawback of using
  472.                  this mode is that it eats more memory.  There are
  473.                  3 modes available with this cyclegadget: NONE,
  474.                  which will not promote icons (default), ONLY
  475.                  WORKBENCH, which will promote only Workbench icons,
  476.                  and ALL, which will promote appicons and other
  477.                  images like dock icons that use icon images.
  478.                  Depth promote may look better or worse, depending
  479.                  on your OS/configuration.  Play with the settings
  480.                  and find the best effect for you.
  481.                  @{fg fill}IMPORTANT!@{fg text}  If you are doing some editing on non-
  482.                  NewIcons with an icon editor, be sure to turn
  483.                  the DEPTH PROMOTE option to NONE or ONLY WB.  If you
  484.                  don't you'll be playing with an icon copy, and your
  485.                  editor won't save it properly.  You have been
  486.                  warned.
  487.    @{b}PEN PRECISION@{ub}-(default:16)  -  This option allows you to set
  488.                  how exact NewIcons will select the colors for
  489.                  displaying the icons.  The default value is
  490.                  16, which is reasonable if you have a limited
  491.                  number of pen colors available on your WB.  It
  492.                  won't steal all the colors from your other
  493.                  programs, but may not display everything with
  494.                  exact precision.  The lower the PRECISION
  495.                  parameter, the greater the precision when
  496.                  picking colors to map the icons.  Zero is very
  497.                  high precision, -1 is the highest, and is
  498.                  recommended for graphics card users or those
  499.                  with lots of available WB pens.
  500.                  Note: If you are running Kickstart 2.0, this
  501.                  parameter does nothing.
  502.   The four other gadgets in the Preferences window are fairly
  503.   self explanatory:
  504.    @{b}SAVE@{ub}           -  Saves the currently set configuration permanently.
  505.    @{b}USE@{ub}            -  Keeps the currently set configuration until the
  506.                      next reboot.
  507.    @{b}CANCEL@{ub}         -  Cancels any changed parameters.
  508.    @{b}NewIcons Logo@{ub}  -  Click here for version and author information.
  509.   NewIconsPrefs uses the ClassAct GUI system, and requires a few ClassAct
  510.   gadgets to be installed in Sys:classes.  The installer will take care of
  511.   installing these.
  512. @endnode
  513. @node "CopyNewIcon" "CopyNewIcon"
  514. @next "CreateDefaultIcon"
  515. @prev "NewIconsPrefs"
  516.   CopyNewIcon will likely be the most used of the support utilities.
  517.   This command is used to copy the NewIcon image from one icon to another.
  518.   You can use it to add NewIcon images to your other programs/files.
  519.   ONLY the NewIcon image is copied. The standard image and the other
  520.   properties of the destination icons are not affected.
  521.   You'll need this command to use the icons contained in the Icons/Misc
  522.   drawer. @{b}DO NOT USE THE USUAL 'COPY' COMMAND TO COPY THOSE ICONS@{ub}. You
  523.   should consider the Icons drawer as a sort of "catalog" of images,
  524.   which you can pick @{b}IMAGES@{ub}, and not true icons, from.
  525.   From CLI:
  526.      @{b}Copynewicon srcicon desticon1 [desticon2...]@{ub}
  527.   From Workbench:
  528.      click on CopyNewIcon
  529.      shift-click the icon you want to copy from
  530.      shift-click the icons you want to copy to
  531.      shift-double click the last icon
  532.   You can also add this command to the Tools menu using ToolManager or
  533.   ToolsPrefs.
  534. @endnode
  535. @node "CreateDefaultIcon" "CreateDefaultIcon"
  536. @next "InjectBrush"
  537. @prev "CopyNewIcon"
  538.   This will convert a fake icon to a real icon. Of course it is much more
  539.   useful if @{"DefIcons" link "DefIcons" 0} is running.
  540.   It also replaces real icons with standard icons, that is with the ones
  541.   which would be used as fake icons if there wasn't a real icon. I hope
  542.   I've been convoluted enough to confuse you ;-)
  543.   Anyway, the interesting part is that if you use this command on a real
  544.   icon, the original properties will not be lost (position, drawer
  545.   dimensions, tooltypes, default tool - @{u}unless@{uu} the def_icon has a default
  546.   tool by itself). This command is VERY handy to quickly replace all the
  547.   drawer icons in your hard disk.  
  548.   Usage is the same as @{"KillNewIcon" link "KillNewIcon" 0} :
  549.   Click on CreateDefaultIcon, then shift-click on the icons you want
  550.   to make into a real icon.  Double-click on the last icon selected.
  551.   If you have a standard default tool for certain files (like Multiview
  552.   for your AmigaGuide
  553.  files), you can add that tooltype to your
  554.   default icon (Envarc:sys/def_guide.info) and any AmigaGuide
  555.  files you
  556.   use CreateDefaultIcon on will have the correct default tool associated
  557.   with it.  This technique is useful for picture and sound files, and ASCII
  558.   text files as well.
  559. @endnode
  560. @node "InjectBrush" "InjectBrush"
  561. @next "KillNewIcon"
  562. @prev "CreateDefaultIcon"
  563.   This command is used to create a NewIcon. It can be used only from CLI.
  564.   It takes the name of the icon to NewIcon-ize and the names of two ILBM
  565.   brushes. The brushes should be 36x40 in size, and use the standard
  566.   palette. In the Extras/BUILDING_BLOCKS directory you find some standard
  567.   elements to use in creating NewIcon images.
  568.   Template:
  569.   ICON/A,NORMALIMAGE/A,SELECTEDIMAGE,FORCE/S
  570.   Example:  @{b}injectbrush myicon.info brush1.iff brush2.iff@{ub}
  571.   You can leave off the ".info" extension if you like.  Injectbrush is
  572.   smart enough to know you mean the icon file, not the file itself.
  573.   Note that the original image is not removed from the icon. It stays
  574.   there so that users not running NewIcons can see an old-style icon.
  575.   Color 0 of the brush used to create a NewIcon is always considered
  576.   the transparent color.  That is, it will always be remapped to color
  577.   0 of the screen.
  578.   The newicon.library does not optimize the color data. Thus, if you use
  579.   an 8 bitplane brush to create an icon, and it uses only 16 colors of
  580.   the 256 available, the icon created will be larger than if you used a 4
  581.   bitplane brush.  The best thing to do is to always work on a 16 color
  582.   screen, using the building_blocks/platform provided to start from.
  583.   Injectbrush expects the brushes to be of the standard size and color
  584.   palette.  You will be prompted if the brushes are not 36x40, or if the
  585.   palette colors are non-standard.  This is NOT implemented to force you
  586.   to use a particular icon size or palette.  Rather it is included as a
  587.   feature for those who want to keep their icons the same palette and size,
  588.   consistent with the included icon set.
  589.   This feature can be overridden by using the @{b}Force@{ub} option.
  590. @endnode
  591. @node "KillNewIcon" "KillNewIcon"
  592. @next "PatchOpenWb"
  593. @prev "InjectBrush"
  594.   This is the complementary of @{"InjectBrush" link "InjectBrush" 0}. It removes the NewIcon and
  595.   restores the icon to its original image.
  596.   From CLI:
  597.      @{b}Killnewicon icon1 [icon2...]@{ub}
  598.   From Workbench:
  599.      click on KillNewIcon
  600.      shift-click the icons you want to remove the NewIcon from
  601.      shift-double click the last icon
  602.   You can also add this command to the Tools menu using ToolManager or
  603.   ToolsPrefs.
  604. @endnode
  605. @node "PatchOpenWb" "PatchOpenWB"
  606. @next "TipsAndTricks"
  607. @prev "KillNewIcon"
  608.  Kickstart 3.x has a serious bug concerning Workbench screen opening. If the
  609.  Workbench screen is closed and a program causes it to be opened, either by
  610.  calling OpenWorkBench(), or OpenWindow(), or LockPubScreen(), the system
  611.  may hang. Specifically:
  612.  If the program has priority less then 0, it will always hang.
  613.  If the priority is greater than 0, it will never hang.
  614.  If the priority is 0, it may or may not hang; it depends on when
  615.       task switching happens.
  616.  This program is a workaround for the bug. It will intercept OpenWorkBench(),
  617.  OpenWindow() and LockPubScreen() calls and temporarily raise the priority to
  618.  1, thus avoiding the deadlock. This patch is @{b}necessary@{ub} when running
  619.  NewIcons, otherwise the system will always hang when the Workbench screen
  620.  is closed and reopened.
  621.  Users of Workbench 2.0 do @{b}not@{ub} need to use this command.
  622.  To install the patch, just execute the program @{b}PatchOpenWb@{ub} in your
  623.  startup-sequence, preferably before IPrefs, and after SetPatch.
  624. @endnode
  625. @node "TipsAndTricks" "Tips And Tricks"
  626. @next "Authors"
  627. @prev "PatchOpenWb"
  628.    Here are some tips to help you make the most of the Newicons system:
  629.  Q:  I just installed NewIcons version 3.  Now my computer seems to freeze up
  630.      during the boot process.  What the hell?!
  631.  A:  Hopefully we have placed this information in enough places in the
  632.      archive that users won't have this problem.  If you have updated from a
  633.      previous release of NewIcons, and didn't originally install everything
  634.      with the installer, you may have to make a change in the user-startup.
  635.      NewIcons now requires a change in the command line that launches it.
  636.      NewIcons MUST be launched with "RUN <>NIL: c:NewIcons" now.  If your
  637.      old command line in user-startup still says "c:NewIcons", you must
  638.      change it.  If you installed NewIcons previously with the Amiga
  639.      Installer program, the version 3 installation should take care of
  640.      this automatically.
  641.  Q:  When I ran the installer script, it didn't convert every single icon on
  642.      my hard drive.  Why not?
  643.  A:  Since everyone's system can be configured differently, the installer
  644.      can't possibly configure for all setups.  The installer is designed
  645.      to install the typical Workbench System file icons.  To convert the
  646.      rest of your icons, use the @{"CopyNewIcon" link "CopyNewIcon" 0} utility to copy images to
  647.      other icons.
  648.      
  649.  Q:  I used CreateDefaultIcon to convert my icons into NewIcons.  Now my
  650.      tooltypes and default tool settings are missing from the icons.  Help!
  651.  A:  Go back and read the documentation.  If the default icon in Env:sys
  652.      associated with the icon you created has a default tool setting in it,
  653.      it will be used, as well as the tooltype settings.  For general use in
  654.      converting @{b}existing@{ub} icons to NewIcons, use @{"CopyNewIcon" link "CopyNewIcon" 0} instead.
  655.      @{"CreateDefaultIcon" link "CreateDefaultIcon" 0} is for adding icons to files that don't have .info
  656.      files!
  657.  Q:  With 2 images in each icon, my icon sizes are a bit bigger than standard
  658.      icons.  Is there anything I can do about this?
  659.  A:  If you decide that you really like the NewIcons system, and make it a
  660.      permanent part of your Workbench, you can make the standard icon images
  661.      very small, i.e. a few pixels large.   This is done quite easily with
  662.      the included utility "Killoldicon", by Michael Barsoom.   This changes
  663.      the old icon images permanently, so don't do this procedure unless you
  664.      are sure you won't need them back.  To use, simply shift-click on
  665.      killoldicon, then shift-click on the icons you wish to convert.  While
  666.      holding shift, double-click on the last icon to convert.  Since NewIcon
  667.      images are compressed, the resulting final icon can be considerably
  668.      smaller than a standard icon with the equivalent number of colors.
  669.      Also these icons load considerably faster with the old image removed.
  670.      One drawback of this method, however is that if you share these icons
  671.      with people not running NewIcons, they will only see the tiny pixel
  672.      icon.
  673.  Q: Can I run Deficons without running NewIcons?
  674.  A: Absolutely, if you only want to use the default icon feature.  In this
  675.     case you will only have the standard icon images to view, however.
  676.     @{"NewIcons" link "NewIcons" 0} can be run without @{"Deficons" link "DefIcons" 0} also, although you won't get
  677.     default icon images for "fake" icons.
  678.  Q: Sometimes when I change screenmodes, the colors of my NewIcon appicons
  679.     don't look right.  What's going on?
  680.  A: Intuition doesn't reset the colors properly for appicons, unfortunately.
  681.     You'll have to switch back to the screenmode you were using, or restart
  682.     the program that created the appicon.  Sorry, this is a fault of the OS.
  683.     For Toolmanager Docks, this shouldn't be a problem with NewIcons version
  684.     3.  A fix for Toolmanager docks only has been implemented.  This might
  685.     break with future versions of Toolmanager.
  686.  Q: My icon colors don't look the right colors.
  687.  A: The NewIcons system dynamically allocates colors as needed when
  688.     an icon appears on the Workbench.  Most likely if you are having
  689.     a problem with the icon colors, you don't have enough free colors
  690.     available on your Workbench screen.  Unless you are using a back-
  691.     drop with a large number of colors, 32 or 64 colors is usually
  692.     plenty with the supplied icons.  Increasing the number of bitplanes
  693.     in the screenmode settings should fix this problem.  Alternatively,
  694.     you can set the DITHER mode in @{"NewIconsPrefs" link "NewIconsPrefs" 0} to ON.
  695.  Q: I want to make my own icons that are different sizes and colors from
  696.     the supplied icons.   How can I get injectbrush to work with the
  697.     brushes I use to make the images?
  698.  A: All the supplied icons use the same 15 color palette to preserve the
  699.     number of available colors on the Workbench.  If you choose, you are
  700.     certainly not limited to these colors and you can make icons as complex
  701.     as your heart desires.  Icons also do not have to be the 36 x 40 pixel
  702.     size either.   Using the "FORCE" option in @{"injectbrush" link "InjectBrush" 0} will allow you to
  703.     use nonstandard palettes and sizes (up to 93 x 93 pixels).  Make sure
  704.     your brushes are the same size and palette, or injectbrush won't allow
  705.     you to make them into icons.
  706.     Note:  Although you can create up to 256 color icons, this is not really
  707.     recommended, since you will very likely lock all the available colors
  708.     for the workbench, and programs like Multiview will not be able to
  709.     dynamically allocate the correct colors for viewing pictures and
  710.     so forth.  In addition, icons with large palettes take up a larger
  711.     amount of disk space.
  712.  Q: IconEdit doesn't work with my NewIcon images.  What gives?
  713.  A: Do NOT use standard icon editing tools to manipulate NewIcon
  714.     images.  Some programs could cause serious damage to the icon
  715.     data, saving the NewIcon image as an old-style image, therefore
  716.     losing palette information.  The best way to create NewIcon images
  717.     is to use a paint program; create a brush, and then use injectbrush;
  718.     there are NewIcon editors out there as well, such as Iconian.
  719.  Q: I prefer the magic workbench style of icons.  Can I get the benefits
  720.     of using NewIcons with mwb?
  721.  A: Absolutely.  Just convert the images to brushes and change them into
  722.     NewIcons with @{"injectbrush." link "InjectBrush" 0}   From now on you'll never have to worry
  723.     about what your palette is set to.  There is also a utility to convert
  724.     mwb icons to NewIcons available on Aminet, called MWB2NI.
  725.  Q: If I want to make my own default disk icons, do I have to make them
  726.     a disk type icon?
  727.  A: No.  @{"Deficons" link "DefIcons" 0} can use drawer type icons for disks or drawers in most
  728.     cases.  It will also use any type of icon for the "kick" type icons.
  729.     Therefore, if you make new default icons for your ENVARC:sys drawer,
  730.     you don't usually have to convert them to a disk or kick type icon.
  731.     This applies to the custom icons only, such as def_RAMdisk, etc.
  732.     The standard def_disk.info and def_kick.info icons still must be of
  733.     the proper type.
  734.  Q: When I double click on an iconless file, sometimes the "Execute Command"
  735.     gadget doesn't get filled in with the default tool like it's supposed to.
  736.  A: This is due to Intuition, not Deficons.  If you open a drawer and click
  737.     on an iconless Amigaguide file for example, Multiview should be selected
  738.     in the "Execute Command" field.  However, if you open a second drawer or
  739.     click on other icons in a different drawer than the first, then try to
  740.     open that same AmigaGuide file, the default tool will not appear.  Sorry,
  741.     there is no easy solution to this problem; it's a fault of the OS.
  742.  Q: I really don't want a great looking Workbench...how can I deinstall it?
  743.  A: There is a script in the archive that will deinstall the package for you.
  744.     To remove NewIcon images from icons by hand, just run @{"KillNewIcon" link "KillNewIcon" 0} on
  745.     them.
  746.  Q: How do I use the DEFAULTIMAGE tooltype?
  747.  A: Use it with icons that have NO NewIcon image data in them.  For example,
  748.     to make all your drawers use the image of an icon called
  749.     Work:MyDrawer.info,  add this tooltype to your non-NewIconized drawers:
  750.       DEFAULTIMAGE=Work:MyDrawer.info
  751.    Now, you can change the look of ALL your system drawers just by changing
  752.    the MyDrawer icon's image.  Pretty cool!  You could even set up your
  753.    user-startup to randomly copy a different image at each bootup to
  754.    Env:sys, and make your Workbench look different every time you start
  755.    your computer!
  756.    Using this feature slows down loading time slightly, because two icons
  757.    have to be loaded (the main one and the one whose image is to be
  758.    borrowed), but has several advantages, especially with icons which are
  759.    used frequently, like drawer icons:
  760.     1) It saves disk space, because the image is stored only once.
  761.     2) Saves memory when the icons are on screen, because the Tooltypes
  762.        containing the compressed image are loaded, decompressed, and freed,
  763.        whereas in the normal method they stay in memory until the icon
  764.        is freed.
  765.     3) If you get bored of an image, just replace the default one, and all
  766.        the others will change automatically!
  767.     Remember that the image stored in the icon has precedence.  Therefore,
  768.     you have to run @{"KillNewIcon" link "KillNewIcon" 0} on a NewIcon to have the DEFAULTIMAGE
  769.     ToolType work.
  770.     WARNING!!!:  This trick is recursive, that is, if DEFAULTIMAGE points to
  771.     an icon which has a DEFAULTIMAGE itself, a third icon will be loaded,
  772.     and so on.  Pay attention not to create loops which refer back to
  773.     another icon.  If you do, you will likely meet the big GURU.  You
  774.     have been warned.
  775.  Q: I'm using the borderblank option and some of my old non-NewIcon images
  776.     look very strange.  What's wrong?
  777.  A: Workbench 2.04 and up was not designed to have the borders removed around
  778.     the icons.  With the borderblank option turned on, color zero is now
  779.     transparent.  Any area of the icon with color zero will now show the
  780.     backdrop through the icon.  This can cause some icons to appear strange.
  781.     The options for fixing it are 1) change your backdrop to a somewhat
  782.     neutral gray color  2) don't use the borderblank option, or 3) get
  783.     rid of those old icons altogether, and use NewIcon images instead.
  784.     Another note about the borderblank option:  some non-newicon icons will
  785.     really look bizarre, especially the secondary image if the alternate
  786.     image is just a complemented color.  You can try toggling the DEPTH
  787.     PROMOTE option in @{"NewIconsPrefs" link "NewIconsPrefs" 0} on or off.  Depending on whether
  788.     you use a graphics card, this option might help either way.
  789.     One further note about the borderblank option:  If you use colorfonts
  790.     for your icon font, these can look weird also with non-NewIcon icons.
  791.     It appears to be a quirk in the OS.  The solution is the same as above:
  792.     1) don't use borderblank, or 2) use only NewIcon images on the Workbench.
  793.  Q: Can I use RTG mode if I don't have a graphics card?
  794.  A: NO!  Don't even try it.  You will surely end up looking at a flashing red
  795.     and black system error screen (i.e. GURU).
  796.  Q: If I have a graphics card, must I use the RTG mode?
  797.  A: You don't have to, but there's certainly no reason not to, unless you
  798.     like eating up all your chip RAM.
  799.  Q: How can I make my NewIcon icons into brushes for editing?
  800.  A: There's a utility on Aminet (gfx/conv/newicontobrush) which will do this
  801.     for you.
  802.  Q: Where can I get more icons in the isometric/McVey style?
  803.  A: There are loads of them on Aminet (well over 1000 images) in the pix/icon
  804.     directory.  Some of the best ones are @{"McVey's" link "Authors" 0} NewIconsXTRA and NI-V2
  805.     packages, and the AESicons series by @{"Phil
  806. Vedovatti" link "Authors" 0} (IMHO! ;-).
  807.  Q: Are there any backdrop sets for NewIcons?
  808.  A: Yes!  Look in the pix/icon directory on Aminet.  Roger McVey has uploaded
  809.     literally hundreds of NewIcons compatible backdrops.  They look great!
  810. @endnode
  811. @node "Authors" "Authors"
  812. @next "Acknowledgements"
  813. @prev "TipsAndTricks"
  814.  @{fg shine}The NewIcons Team@{fg text}
  815.  =================
  816.  The NewIcons project is the result of many months of idea-exchanging,
  817.  late-night IRC sessions, numerous reboots and collaboration among people
  818.  who have never once met each other in person.  The NewIcons package
  819.  was created purely for the enjoyment of its users.
  820.  Please send any bug reports to Eric or Phil.
  821.  Brainstorming, programming, documentation and artwork for Newicons 3+:
  822.    @{b}Eric Sauvageau@{ub}
  823.    5338 10th Avenue
  824.    Montreal, Quebec
  825.    CANADA
  826.    H1Y-2G6
  827.    IRC: RMerlin
  828.    E-mail: dream@step.polymtl.ca
  829.    @{b}Phil Vedovatti@{ub}
  830.    2424 41st Ave E. #370F
  831.    Seattle, Washington 98112
  832.    USA
  833.    IRC: Aesculape
  834.    E-mail: vedovatt@u.washington.edu
  835.  The new deficons.prefs file:
  836.    @{b}Ariel Magnum@{ub}
  837.    IRC: Ariel
  838.    E-mail: arielmag@actcom.co.il
  839.  The icon artwork was done by
  840.    @{b}Roger McVey@{ub}
  841.    E-Mail: r.mcvey@genie.geis.com
  842.  Original concept, and programming for versions 1.0 - 2.0:
  843.    @{b}Nicola Salmoria@{ub}
  844.    Via Piemonte 11
  845.    53100 Siena   ITALY
  846.    E-Mail: MC6489@mclink.it
  847. @endnode
  848. @node "Acknowledgements" "Acknowledgements"
  849. @next "Distribution"
  850. @prev "Authors"
  851.  Acknowledgements
  852.  ================
  853.  Many thanks go out to our beta testers, who risked crashing their systems
  854.  for the sake of NewIcons:
  855.  @{b}Steve Bara@{ub}        (IRC: Frotz)
  856.  @{b}Jonathan Larson@{ub}   (IRC: Multitask)
  857.  @{b}Giacomo Magnini@{ub}   (IRC: Swatch)
  858.  @{b}Ariel Magnum@{ub}      (IRC: Ariel)
  859.  @{b}Peter J. Mills@{ub}    (IRC: DrPhuQt)
  860.  @{b}Andrew G. Robson@{ub}  (IRC: Greebo)
  861.  @{b}Chris Townsend@{ub}    (IRC: Vidar)
  862.  @{b}Joshua B. Wingell@{ub} (IRC: Shape)
  863.  Thanks to @{b}Chris Green@{ub}, whose chunky to planar routine was based upon.
  864.  (Chris based his routine on one by @{b}Richard Addison@{ub}).
  865.  Thanks to @{b}Federico Giannici@{ub} who pushed Nicola to make the color remapping
  866.  faster, and faster, and faster...
  867.  Thanks also to @{b}Michael Barsoom@{ub}, who kindly allowed the inclusion of his
  868.  program, "killoldicon" in the package.
  869.  A special thanks to our friends who transcribed the installer scripts:
  870.  @{b}Eric Sauvageau@{ub} for the French version, @{b}Giacomo Magnini@{ub} for the
  871.  Italian version, @{b}Volker Schleifstein@{ub} for the German version.
  872.  @{b}B
  873. rge N
  874. st@{ub} for optimizing the ASM DecodeLine routine.
  875.  @{b}Christopher Aldi@{ub}, @{b}Tim Aston@{ub} and @{b}Osma Ahvenlampi@{ub} for Class Act.
  876.  All the folks on EFNET IRC channel #amiga who begged us to finish this
  877.  release.
  878.  And thanks to all the NewIcons fans out there!
  879. @endnode
  880. @node "Distribution" "Distribution"
  881. @next "History"
  882. @prev "Acknowledgements"
  883. @{b}This software is FreeWare. It is freely distributable as long as the archive
  884. remains intact, and only a nominal fee is charged for its distribution.
  885. This software is provided "AS IS" without warranty of any kind, either
  886. expressed or implied. By using it, you agree to accept the entire risk as to
  887. the quality and performance of the program.@{ub}
  888. @endnode
  889. @node "History" "History"
  890. @prev "Distribution"
  891. Version History:
  892. @{fg shine}V1.0:@{fg text}
  893. Original public release.
  894. @{fg shine}V2.0:@{fg text}
  895. In the previous version of the docs I forgot to mention that the chunky to
  896. planar routine was based on a routine by Chris Green (who based his routine on
  897. one by Richard Addison).
  898. fixed bug in DefIcons, was causing "plase insert volume dir c" after doing
  899. execute command - dir c:
  900. fixed bug in DefIcons, would hang if it couldn't find deficons.prefs
  901. fixed bug in DefIcons, was causing a disk icon to appear for files called
  902. "disk".
  903. fixed bug in DefIcons, would show a drawer as disk icon for disks containing a
  904. directory called "disk" (which is a bad idea anyway).
  905. The GetDiskObjectNew() patch now returns NULL if the given name doesn't exist
  906. (like the standard function)
  907. now does dithering (optional)
  908. some file types added to deficons.prefs.
  909. bug fix: createdefaulticon now preserves the tooltypes of tool icons and of
  910. project icons whose default icon have no default tool.
  911. bug fix: newicons would check the argarray after FreeArgs(). Thanks to Nicola
  912. Soggia for discovering it and not reporting it. Thanks to Moreno Magnani who
  913. did report it.
  914. bugfix, arj files were not recognized
  915. bug fix: DefIcons now uses Stricmp() to avoid problems with international
  916. sorting
  917. DEFAULTIMAGE special ToolType added
  918. Fixed installer: no longer copies over the original def_#? icons in
  919. Envarc:sys. It now just copies them to a safe place.
  920. Localized installer and documentation files added
  921. Replaced "ReplaceImage" utility with "KillOldIcon", since ReplaceImage
  922. required NewIcons not to be running to use.
  923. Changed a few of the icons from the original distribution archive
  924. @{fg shine}CHANGES since last version from Nicola (Release 2, V38.3)@{fg text}
  925. =========================================================
  926. @{fg shine}3.0@{fg text}
  927.  - Development is now done by @{"Phil
  928. Vedovatti" link "Authors" 0} and @{"Eric
  929. Sauvageau" link "Authors" 0}.
  930.  - A much requested feature: you can now have borderless icons on your
  931.    Workbench, just like under Kickstart 1.x :)  Note that it is really a
  932.    hack, so it _might_ break under future versions of Workbench, and it
  933.    has some minor drawbacks.  Make sure you read the @{"NewIconsPrefs" link "NewIconsPrefs" 0} section
  934.    about it before enabling it.
  935.  - New RTG Mode which uses Fast RAM instead of Chip on systems with graphics
  936.    cards.
  937.  - Library (V39.1) now comes in two versions:
  938.       o 68020 and up, OS 3.x (Required for RTG Mode)
  939.       o 68000, OS 2.x
  940.    The library base has also changed, so application programmers
  941.    should check the updated libraries/newicon.h include file.  Note
  942.    that things are still fully backward compatible).
  943.    Various speed optimisations have been done, and the tooltype
  944.    decoding routine has been rewritten by B
  945. rge N
  946. st.  We're hoping to
  947.    also have the C2P routine rewritten in a future version :)
  948.  - NewIcons has been rewritten in E, and is now a commodity which can be
  949.    enabled/disabled.  The hotkey will let you see some information about
  950.    the current settings, and allow you to directly launch the external
  951.    @{"preferences" link "NewIconsPrefs" 0} editor.
  952.  - NewIcons will no longer auto-detach from the CLI so it must be
  953.    Run <>NIL:.  It also has a totaly new template:
  954.         'CX_PRIORITY/N/K,CX_POPKEY/K,PE=PREFSEDITOR/K'
  955.    Hopefully NewIcons will auto-detach again in a future version.
  956.  - The former Newicons settings have been moved to a separate prefs editor.
  957.    Makes it easier for the user to install/configure, and gives you more
  958.    freedom to experiment with the various settings without needing to
  959.    reboot.
  960.    This editor uses the ClassAct BOOPSI package for its GUI (all the
  961.    required classes are included in this archive.)
  962.  - Added a "kludge" so that icons used by ToolManager docks get properly
  963.    remapped on screenmode changes.
  964. @endnode
  965.