
 ICL - IconLibrary Tool 

 Copyright (c)99 by Alexei Ivanov ( vinny@copris.com )
 Used code written by Jan Peter Stotz (jpstotz@gmx.de)

 Freeware for noncommercial use.

 ICL is archiver-like tool to worc with icon libraries.
 It allow to list icon library contents and extract icons or subicons to
 single ICO-file.
 It just test version, it must be buggy. It write extremely much to console
 - for debugging purposes. Feel free to e-mail me ( vinny@copris.com )
 if you find bugs, have suggestions or questions.

 Why command-line?

 Coz it's rulez! =)
 Well.. I don't like explorer - i use FAR as shell.
 FAR is text-mode program,  looks like Norton Commander in general.
 But it's native win32 application with great possibilities.
 Too hard to describe - just test it. Go to http://www.rarsoft.com.

 So, about FAR. It allow to "enter" in archives as in file system.
 Just place icl.exe on the path and add following text
 to \Plugins\MultiArc\Formats\custom.ini
 Now just peress Enter on ICl-file and you will enter into it as in dir.
 Now you can extract and view icons and subicons. (To view icons you have to
 assotiate *.ico with someone external viewer,  IrfanView for example)

 At this moment ICL can't add, replace or delete icons.
 May be later... if Jan will implement this in his icontools unit. =)

=======================================  

[ICL]
TypeName=ICL
IDOnly=0
Extension=icl
List="icl v "
Errorlevel=1
Format0="nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn"
Format1="zzzzzzzzzz aaaaa"
Extract=icl x %%A  @%%LM*
ExtractWithoutPath=icl e %%A  @%%LM*
AllFilesMask="*"

=======================================
  


 Usage:

 icl  <command>  <archive_name> [<file_names>...] [-<switches>...]
 icl  <command>  <archive_name> [@<file_list>...] [-<switches>...]
 <Commands>
 l : List contents of archive, only names of icon resources
 v : Verbosely list contents of archive, for external parser
 e : Extract icons from archive, don't create folder for subicons
 x : eXtract files with creating folder for subicons

 subicons shows as files in folders with parameters added:

 "Group icon\Group icon_16x16x256.ico
 "Group icon\Group icon_32x32x256.ico

 Main icons shows as files in root folder:

 "Group icon.ico"

 To extract subicons, specify group icon as folder. File masks allowed.

 additional parameters:

 -i- - DON'T ignore case, off by default
 -o override existing files without prompt'
 -m"[fomatstring]" - change subicons naming scheme. (Height, width, colors)
 Examples:
  -m" ( %d x %d %d c )" = "iconame ( 16 x 16 x 256 c ).ico"
  -m"-[%d-%d]" = "iconame-[16-16].ico"
  -m"" - default scheme, "iconame_16x16x256.ico"

 Examples (note, that extention ".ico" not needed, although allowed):

 icl x icolib.icl one    - extract single icon "one.ico"
 icl x icolib.icl *      - extract all group icons
 icl x icolib.icl a*     - extract all group icons with name starting with "a" char
 icl x icolib.icl *cool* - extract all group icons with "cool" substring in name
 icl x icolib.icl *a     - extract all group icons names ended with "a" char
 icl x icolib.icl one\one_16x16* - extract subicons from "one.ico" with 16x16 size
 icl x icolib.icl one\* - extract all subicons from "one.ico"
 icl x icolib.icl *\*   - extract all subicons from all group icons
 icl x icolib.icl 3d*\* - extract all subicons from group icons starting with "3d"
 icl e icolib.icl *\*   - extract all subicons from all group icons into current dir without
                          creating subimage folders.
