home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / ikony / programy / ilib_11 / iconlib.doc < prev    next >
Encoding:
Text File  |  1996-02-13  |  20.9 KB  |  527 lines

  1.  
  2.  
  3.  
  4.  
  5.                                  The Icon Librarian
  6.  
  7.                              Version 1.0   April 8, 1993
  8.  
  9.  
  10.  
  11.                                  _______
  12.                             ____|__     |               (tm)
  13.                          --|       |    |-------------------
  14.                            |   ____|__  |  Association of
  15.                            |  |       |_|  Shareware
  16.                            |__|   o   |    Professionals
  17.                          -----|   |   |---------------------
  18.                               |___|___|    MEMBER
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                         Copyright (c) 1993 by Keith Ledbetter
  25.                                  4240 Ketcham Drive
  26.                                Chesterfield, VA  23832
  27.                                    (804) 674-0780
  28.                            (6:00pm - 10:00pm Eastern Time)
  29.  
  30.  
  31.  
  32.                        Tech Support BBS:   Blue Ridge Express
  33.                                     804-790-1675
  34.                               30 Phone Lines (2400 bd)
  35.                                   Sub-board KEITHL
  36.                                     ("J KEITHL")
  37.  
  38.  
  39.  
  40.                                   Email Addresses:
  41.  
  42.                              GEnie         : ORION.MICRO
  43.                              Compuserve    :  72240,1221
  44.                              America Online:  kledbetter
  45.  
  46.  
  47.  
  48.  
  49.                   Program and Documentation are Copyright (c) 1993
  50.                       by Keith Ledbetter.  All rights reserved.
  51.  
  52.  
  53.  
  54.                          Portions (c) Borland International.
  55.             The Icon Librarian was written with Borland C++ Professional.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.             This program  is produced  by a  member of  the Association  of
  63.           Shareware Professionals (ASP).  ASP wants  to make sure that  the
  64.           shareware principle works for you. If you are unable to resolve a
  65.           shareware related problem  with an ASP  member by contacting  the
  66.           member directly, ASP may be able  to help. The ASP Ombudsman  can
  67.           help you resolve  a dispute or  problem with an  ASP member,  but
  68.           does not provide technical support for members' products.  Please
  69.           write to the ASP Ombudsman at PO. Box 5786, Bellevue, WA 98006 or
  70.           send  a  Compuserve  message   via  easyplex  to  ASP   Ombudsman
  71.           70007,3536.
  72.  
  73.  
  74.  
  75.                                Definition of Shareware
  76.  
  77.  
  78.  
  79.           Shareware distribution  gives  users  a chance  to  try  software
  80.           before buying it.   If you try a  Shareware program and  continue
  81.           using it,  you  are  expected to  register.  Individual  programs
  82.           differ on  details  --  some request  registration  while  others
  83.           require  it,   some  specify   a  maximum   trial  period.   With
  84.           registration, you get anything from the simple right to  continue
  85.           using the software to an updated program with printed manual.
  86.  
  87.           Copyright laws apply to  both Shareware and commercial  software,
  88.           and the copyright holder retains all rights, with a few  specific
  89.           exceptions as stated  below. Shareware  authors are  accomplished
  90.           programmers, just like commercial  authors, and the programs  are
  91.           of comparable quality.  (In both cases,  there are good  programs
  92.           and  bad  ones!)  The  main  difference  is  in  the  method   of
  93.           distribution. The author  specifically grants the  right to  copy
  94.           and distribute the  software, either to  all and sundry  or to  a
  95.           specific  group.  For  example,  some  authors  require   written
  96.           permission  before  a  commercial  disk  vendor  may  copy  their
  97.           Shareware.
  98.  
  99.           Shareware is a distribution method, not  a type of software.  You
  100.           should find  software  that  suits  your  needs  and  pocketbook,
  101.           whether it's commercial or Shareware. The Shareware system  makes
  102.           fitting your needs easier,  because you can  try before you  buy.
  103.           And because the overhead is low,  prices are low also.  Shareware
  104.           has the ultimate  money-back guarantee --  if you  don't use  the
  105.           product, you don't pay for it.
  106.  
  107.  
  108.  
  109.  
  110.                                Disclaimer - Agreement
  111.  
  112.  
  113.  
  114.               Users of The Icon Librarian must accept this disclaimer of
  115.           warranty:
  116.  
  117.           "The Icon Librarian is supplied as is.  The author disclaims all
  118.           warranties, expressed or implied, including, without limitation,
  119.           the warranties of merchantability and of fitness for any purpose.
  120.           The author assumes no liability for damages, direct or
  121.           consequential, which may result from the use of The Icon
  122.           Librarian."
  123.  
  124.           The Icon Librarian is a "shareware program" and is provided at no
  125.           charge to the user for evaluation.  Feel free to share it with
  126.           your friends, but please do not give it away altered or as part
  127.           of another system.  The essence of "user-supported" software is
  128.           to provide personal computer users with quality software without
  129.           high prices, and yet to provide incentive for programmers to
  130.           continue to develop new products.  If you find this program
  131.           useful and find that you are using The Icon Librarian and
  132.           continue to use it after a reasonable trial period, you must make
  133.           a registration payment of $15 to Keith Ledbetter.  The $15
  134.           registration fee will license one copy for use on any one
  135.           computer at any one time.  You must treat this software just like
  136.           a book.  An example is that this software may be used by any
  137.           number of people and may be freely moved from one computer
  138.           location to another, so long as there is no possibility of it
  139.           being used at one location while it's being used at another.
  140.           Just as a book cannot be read by two different persons at the
  141.           same time.
  142.  
  143.           Commercial users of The Icon Librarian must register and pay for
  144.           their copies of the program within 30 days of first use or their
  145.           license is withdrawn.  Site-License arrangements may be made by
  146.           contacting Keith Ledbetter.
  147.  
  148.           You are encouraged to pass a copy of The Icon Librarian along to
  149.           your friends for evaluation.  Please encourage them to register
  150.           their copy if they find that they can use it.  All registered
  151.           users will receive a copy of the latest version of the Icon
  152.           Librarian system.
  153.  
  154.  
  155.  
  156.  
  157.                                   About the Program
  158.  
  159.  
  160.  
  161.                If you are a  regular Windows user, then  you have no  doubt
  162.           had to struggle to keep up with the multitude of icons  available
  163.           today.   The Icon  Librarian  (Librarian) makes  manipulation  of
  164.           these icons easy;  you can categorize,  delete, and choose  icons
  165.           from up to 100  user-defined categories (with  up to 1,000  icons
  166.           each) with  intuitive drag-and-drop  operations.   The  Librarian
  167.           keeps its icons in space-efficient library files, so you'll  save
  168.           valuable disk  space, too.     Icons can  be imported  into  your
  169.           libraries from ICO, EXE, DLL, Norton  Library, and PC Tools  .ICL
  170.           files.
  171.  
  172.  
  173.  
  174.                Developers will also  find the  Librarian very  useful.   It
  175.           will allow you  to keep  your development  icons in  well-defined
  176.           categories (buttons, hardware, etc.)  without wasting disk  space
  177.           by having multitudes of small .ICO files on your hard drive.
  178.  
  179.  
  180.  
  181.              The Librarian works by keeping a master directory on your hard
  182.           drive named  \ICONLIB\.      All  of  your  library  files  (.TIL
  183.           extension) will be stored here.   In addition, a directory  named
  184.           \ICONLIB\IN_USE\ will also be created to hold any icons that  you
  185.           use with the "quick extract" features (more about this later).
  186.  
  187.  
  188.  
  189.  
  190.                               Installing the Librarian
  191.  
  192.  
  193.  
  194.                To install  the Icon  Librarian,  copy the  ICONLIB.EXE  and
  195.           ICONLIB.HLP files to the directory of your choice.  Then, install
  196.           the ICONLIB.EXE file into the program  manager just as you  would
  197.           any other  Windows  program.   Next,  double-click  on  The  Icon
  198.           Librarian icon to load the program.
  199.  
  200.                The first time you execute the  Icon Librarian, you will  be
  201.           presented with an  "installation" screen.    All you  need to  do
  202.           here is to tell the Librarian which drive you'd like it to create
  203.           the \ICONLIB\ directory structure on.  Once you choose the  drive
  204.           letter and  press the  "Ok" button,  the  Librarian will  do  two
  205.           things:
  206.  
  207.                1.   It will create the \ICONLIB\ and \ICONLIB\IN_USE\
  208.                     directory structure on the drive you selected.
  209.  
  210.                2.   It will modify your WIN.INI file to add
  211.                     [The Icon Librarian] section to the system.
  212.  
  213.  
  214.                At this point,  you will be  presented with the  Librarian's
  215.           main screen.    The screen will look  bare at this point  because
  216.           you don't have  any library files  created yet.   As an  example,
  217.           we'll create a library (i.e.: a "category") that consists of  all
  218.           of the icons from your \Windows\ subdirectory.   Do these steps:
  219.  
  220.  
  221.           1.  From  the menu,  choose "File/New  Library" to  create a  new
  222.           library file.   You  will be  presented with  a dialog  box  that
  223.           allows you to  (a) give  this library a  name, and  (b) give  its
  224.           folder a color.    Key in "Windows Icons"  in the name field  and
  225.           pick a  color of  your choice.   You  can ignore  the  "filename"
  226.           field; if you don't key a filename in, the Librarian will  create
  227.           one for you.
  228.  
  229.           2.  Double-click the left mouse button on the new "Windows Icons"
  230.           folder that appeared in your main window.  This will "open"  that
  231.           library.
  232.  
  233.           3.  In the icon window, choose "File/Import icons" from the  menu
  234.           bar.  You  will be presented  with a file  open box; navigate  to
  235.           your \Windows\ directory and select all of the available files by
  236.           clicking on the "Select All" button.
  237.  
  238.           4.  You have just created your first icon library!
  239.  
  240.           5.  Repeat  these steps to  create libraries out  of all of  your
  241.           existing icons.
  242.  
  243.  
  244.  
  245.  
  246.                                The "Preferences" Menu
  247.                                ----------------------
  248.  
  249.                Before we  go any  further,  let's cover  the  "Preferences"
  250.           menu.  The preferences are  divided into two categories:  Library
  251.           preferences and Icon preferences.
  252.  
  253.  
  254.           Specify Icon Editor
  255.  
  256.                This option allows you to specify  the icon editor that  you
  257.           want to use  to edit  icons.  The  only requirement  is that  the
  258.           editor you  choose must  support filenames  passed to  it on  the
  259.           command line.
  260.  
  261.  
  262.           Library / Confirm Deletes
  263.  
  264.                If this option is checked, the Librarian will prompt you for
  265.           verification when  you  attempt  to  delete  a  library.    Since
  266.           deleting a library also deletes all icons in that library, it  is
  267.           highly recommended that you keep this option turned on.
  268.  
  269.  
  270.           Library / Open Window upon Creation
  271.  
  272.           If this option is checked, the Librarian will automatically  open
  273.           up any new library that you create.
  274.  
  275.  
  276.           Library / Color of New Folders
  277.  
  278.           This setting allows you to specify  the default color to be  used
  279.           for libraries in the "File/New Folder" dialog box.
  280.  
  281.  
  282.           Icons / Confirm Deletes
  283.  
  284.           If this  option is  checked, the  Librarian will  prompt you  for
  285.           verification when you attempt to delete an icon.
  286.  
  287.  
  288.           Icons / Display While Importing
  289.  
  290.           If this option is checked, icons will be displayed in the library
  291.           window as soon as they are imported.  If you are importing  large
  292.           amounts of icons at one time, turning this option off will  speed
  293.           up the import process.
  294.  
  295.  
  296.  
  297.  
  298.           Icons / Icon Spacing
  299.  
  300.                This option allows you to control the "white space" between
  301.           each icon in the library window.
  302.  
  303.  
  304.  
  305.                                     Moving Icons
  306.                                     ------------
  307.  
  308.                To start categorizing your Icons, you'll want to use the
  309.           Librarian "move" function.   All you need to do to move an icon
  310.           to another library is to grab (click and hold the left mouse
  311.           button) and then drag the icon to the new library.  This can be
  312.           accomplished in the following ways:
  313.  
  314.                1.   drop the icon in another open library window.
  315.  
  316.                2.   drop the icon on a closed library's "folder" in the
  317.                     main window.
  318.  
  319.                3.   drop the icon on an open library's minimized icon.
  320.  
  321.  
  322.           Note: You can rearrange icons in a window by dropping them in
  323.                 another position within that window.
  324.  
  325.           Note: To make a copy of an icon, simply hold down the control
  326.                 key while dropping the icon.
  327.  
  328.           Note: To move multiple icons, hold down the SHIFT key while
  329.                 clicking on each icon to "mark" them.
  330.  
  331.  
  332.  
  333.  
  334.                                   Using the Toolbar
  335.                                   -----------------
  336.  
  337.  
  338.                You use the Toolbar functions by dragging and then dropping
  339.           an icon on any of the Toolbar icons.  These tools perform the
  340.           following functions:
  341.  
  342.  
  343.                                The Text Clipboard Tool
  344.                                -----------------------
  345.  
  346.                Dropping an icon on the text clipboard will cause two things
  347.           to happen.
  348.  
  349.                1.   The icon will be saved as a .ICO file with a unique
  350.                     name in your \ICONLIB\IN_USE subdirectory.
  351.  
  352.                2.   The NAME of that icon file will be copied to the
  353.                     Windows clipboard.
  354.  
  355.  
  356.                You're probably saying  to yourself "OK,  so what does  this
  357.           buy me?".  If you think  about it, how does Windows normally  ask
  358.           you for an Icon?  That's right -- by the FILENAME.   That's where
  359.           the Librarian really shines.  Any time you are asked for an  Icon
  360.           name (for example, in the "Change icon" dialog box in the Program
  361.           Manager), you can simply open up the Librarian, find the icon you
  362.           want, and the drag  it to the "Text  Clipboard" icon.  This  will
  363.           cause the icon to  be "extracted" and then  copy the FILENAME  of
  364.           the icon to the Windows Clipboard.   Then you just return to your
  365.           text input box, press SHIFT-INSERT, and the full filename of  the
  366.           icon will be pasted into the text box.
  367.  
  368.                Let's take a normal example -- changing the icon of a
  369.           Program Manager item.    Here's the steps you'd take:
  370.  
  371.                    1.   Start the Icon Librarian, and then "minimize" it to
  372.                         an Icon.
  373.  
  374.                    2.   Single click on the item you want to change the
  375.                         icon for in the Program Manager.
  376.  
  377.                    3.   Choose "File / Properties" from the Program Manager
  378.                         menu bar.
  379.  
  380.                    4.   Click on the "Change Icon" button.  (Notice here
  381.                         that the icon's filename is already highlighted).
  382.  
  383.                    5.   Double-click on the Icon Librarian icon to bring it
  384.                         back to life.
  385.  
  386.  
  387.  
  388.  
  389.                    6.   Find the Icon you want to select, and then drag
  390.                         and drop it on the "Text Clipboard" icon.  The
  391.                         Librarian will beep once to let you know the name
  392.                         has been copied into the clipboard.
  393.  
  394.                    7.   Minimize the Icon Librarian again; this will return
  395.                         you to the Program Manager "change icon" dialog
  396.                         box.
  397.  
  398.                    8.   Press SHIFT-INSERT to paste the icon's name into
  399.                         the dialog box.
  400.  
  401.                    9.   Press OK twice -- all done!
  402.  
  403.  
  404.  
  405.  
  406.                               The Image Clipboard Tool
  407.                               ------------------------
  408.  
  409.                Dropping an icon on the Image Clipboard will copy the  image
  410.           of that icon  to the Windows  clipboard.  This  is useful if  you
  411.           want to get the icon into an image editor such as Window's  Paint
  412.           program.
  413.  
  414.  
  415.  
  416.  
  417.                                 The Icon Editor Tool
  418.                                 --------------------
  419.  
  420.                Dropping an icon here will cause the following actions to
  421.           happen:
  422.  
  423.                     1.   The icon will be extracted to a unique name in
  424.                          your \ICONLIB\IN_USE\ directory.
  425.  
  426.                     2.   The icon editor that you have specified will be
  427.                          called so you can edit the icon.
  428.  
  429.                     3.   After you exit your icon editor, The Icon
  430.                          Librarian will reload the icon from the file
  431.                          created in step 1.
  432.  
  433.                     4.   The file created in step 1 will be deleted.
  434.  
  435.  
  436.                Note: The Icon Librarian will be TOTALLY disabled until you
  437.                      exit your icon editor!
  438.  
  439.  
  440.  
  441.  
  442.                                   The Diskette Tool
  443.                                   -----------------
  444.  
  445.  
  446.                Dropping an icon on this tool allows you to extract the icon
  447.           from the Librarian file  and save it to  disk as a standard  icon
  448.           (.ICO) file.  You will be prompted for the name to save the  file
  449.           under.
  450.  
  451.  
  452.  
  453.                                   The Trashcan Tool
  454.                                   -----------------
  455.  
  456.                Surprise!  Dropping an icon here will delete that icon from
  457.           the library.
  458.  
  459.  
  460.  
  461.  
  462.                                 The Information Tool
  463.                                 --------------------
  464.  
  465.                Dropping an icon here will give you information about both
  466.           the icon you dropped and the library in which that icon resides.
  467.  
  468.  
  469.  
  470.  
  471.                 Tips: Moving Your LIBRARIAN to a Different Hard Drive
  472.                 -----------------------------------------------------
  473.  
  474.              If you ever need to move  your \ICONLIB\ directory to  another
  475.           hard drive,  there's  only  a little  work  involved.    In  this
  476.           example, we'll  assume that  you're moving  it from  drive C:  to
  477.           drive E:.  You would perform these steps:
  478.  
  479.                    1.   Exit Windows.
  480.  
  481.                    2.   XCOPY c:\IconLib\*.* e:\IconLib\*.* /s /e
  482.  
  483.                    3.   Delete the c:\IconLib directory.
  484.  
  485.                    4.   Edit the WIN.INI file in your \WINDOWS\ directory.
  486.  
  487.                    5.   In the [The Icon Librarian] section, change
  488.  
  489.                               Path=C:\IconLib
  490.                                     to
  491.                               Path=E:\IconLib
  492.  
  493.  
  494.  
  495.                     Tips: Exchanging Libraries With Other People
  496.                     --------------------------------------------
  497.  
  498.           If you download or in some other way receive some .TIL files that
  499.           you want to install with your  own libraries, here are the  steps
  500.           you will need to take:
  501.  
  502.  
  503.                     1.   Copy the .TIL file(s) that you have received into
  504.                          your \ICONLIB\ directory.
  505.  
  506.                     2.   Write down the filenames of the libraries.
  507.  
  508.                     3.   Start up The Icon Librarian, and choose the
  509.                          "File / New Folder" option.
  510.  
  511.                     4.   In the "filename" field, key in the name of the
  512.                          file that you wrote down in step 2 above.  Don't
  513.                          key in the extension; it will always be .TIL.  In
  514.                          other words, if the file is named CARTOONS.TIL,
  515.                          then key in "Cartoons" in the filename field.
  516.  
  517.                     5.   Double click on the new library's folder, and the
  518.                          icons will appear.
  519.  
  520.  
  521.  
  522.  
  523.                                     In Conclusion
  524.                                     -------------
  525.  
  526.  
  527.           I hope that you will enjoy using The Icon Librarian, and that  it
  528.           will help  make your  job of  icon collection  much easier.    As
  529.           always, I  would  appreciate  hearing  your  comments  about  the
  530.           program or suggestions for new ideas that you may have.
  531.  
  532.  
  533.           You can contact  me in any  of the ways  documented on the  title
  534.           page of this  document.    And,  thanks again  for supporting  my
  535.           Shareware products!
  536.  
  537.  
  538.                Keith Ledbetter
  539.