home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ICONVERT.ZIP / ICONVERT.TXT < prev    next >
Text File  |  1992-08-02  |  7KB  |  178 lines
  1.                          IconVert Version 1.0
  2.                               July, 1992
  3. ┌──────────┐
  4. │ Contents │
  5. └──────────┘
  6.  
  7. o  Features
  8. o  Quick Start
  9. o  Syntax
  10. o  Comments
  11. o  DISCLAIMER
  12.  
  13. ┌──────────┐
  14. │ Features │
  15. └──────────┘
  16.  
  17. o   Converts Windows 3.0 and 3.1 icon files (.ICO) to OS/2 1.2 icon files
  18.     containing a single image that is the same size as the original icon
  19.  
  20. o   Extracts icons from Windows 3.0 and 3.1 executable files (.EXE)
  21.     and dynamic link libraries (.DLL) and converts them to OS/2 1.2 icon
  22.     files
  23.  
  24. o   Can convert
  25.     -   a file
  26.     -   a directory
  27.     -   a directory and all its subdirectories
  28.  
  29. o   Converts 16x16, 32x32, 64x64 and 32x16 (CGA) icons
  30.  
  31. o   Converts 2, 8 and 16 color icons
  32.  
  33. o   Converts "screen" and "inverse screen" colors properly
  34.  
  35. o   Converts multiple images in a file to multiple icon files
  36.  
  37. o   Supports wild cards in file specs
  38.  
  39. o   Supports long file names
  40.  
  41. o   Provides additional options to
  42.     -   allow overwrite of existing files
  43.     -   provide display of icon characteristics
  44.     -   inhibit audible error signals
  45.  
  46. o   Provides error checking
  47.  
  48.  
  49. ┌─────────────┐
  50. │ Quick Start │
  51. └─────────────┘
  52.  
  53. The following examples assume that IconVert.exe is in your current
  54. directory or is in a directory in your PATH statement.
  55.  
  56. Example 1. Convert C:\WIN\WIN.ICO to the file OS2.ICO in your current
  57. directory and display the characteristics of the icon:
  58.  
  59.     iconvert  c:\win\win.ico  os2.ico  /v
  60.  
  61. Example 2. Convert all icon files in D:\WIN\ICONS to D:\OS2\ICONS and do
  62. not request permission to overwrite existing files with the same name:
  63.  
  64.     iconvert  d:\win\icons  d:\os2\icons  /o
  65.  
  66. Example 3. Convert an icon in D:\WIN\WINBX.DLL to Test.BX.ico in the
  67. current directory of drive E: (which is an HPFS drive):
  68.  
  69.     iconvert  d:\win\winbx.dll  e:Test.BX.ico
  70.  
  71. Example 4. Scan all files in C:\WIN and all its subdirectories;
  72. extract any icons in any icon, executable or dynamic link library
  73. files; place them in OS/2 icon files in a subdirectory of your current
  74. directory named ICONS, creating subdirectories under ICONS as needed
  75. to match the subdirectory structure under C:\WIN; avoid listening to
  76. the error beeps for files with no icons; and write the (verbose) log
  77. to ICONVERT.LOG in your current directory:
  78.  
  79.     iconvert  c:\win\*.*  icons\*.*  /s  /q  /v  >  iconvert.log
  80.  
  81.  
  82. ┌────────┐
  83. │ Syntax │
  84. └────────┘
  85.  
  86.  ╔══════╗
  87.  ║ OS/2 ║
  88.  ╚══════╝                                   ┌────────────────────┐
  89.                                             v                    │
  90.  ──┬────────────┬─┬──────────┬- IconVert ───┬─ SOURCE ── TARGET ─┼──┤
  91.    └─ [drive:] ─┘ └─ [path] ─┘              ├──────── /o ────────┤
  92.                                             ├──────── /q ────────┤
  93.                                             ├──────── /s ────────┤
  94.                                             ├──────── /v ────────┤
  95.                                             └──────── /? ────────┘
  96.  
  97. SOURCE is the source file specification. The source specification can be the
  98. name of a directory or a file. If it is a directory, IconVert converts all
  99. files with a .ICO extension to the target specification; if it is a file name,
  100. IconVert converts the file to the target specification. SOURCE is required.
  101.  
  102. TARGET is the target file specification. The target specification can be an
  103. existing directory or file or the name of a new directory or file that you
  104. want to create. TARGET is required.
  105.  
  106. SOURCE and TARGET need not be fully-qualified; i.e., the current drive and
  107. all current directories will be recognized as necessary in order to find the
  108. specified file or directory. They can contain wild card characters. Note that
  109. for HPFS drives long file names can be used and the case of new target
  110. directories and file names is preserved.
  111.  
  112. SOURCE and TARGET must be different--Iconvert will not convert a file "in
  113. place." If SOURCE is a directory specification, TARGET must also be a
  114. directory specification. If SOURCE is a file specification and TARGET does
  115. not exist, TARGET is assumed to be a file specification (rather than a
  116. directory specification).
  117.  
  118. /o is the "overwrite" switch: it allows the overwrite of existing files
  119. without warning. If /o is not present, IconVert will request permission
  120. before overwriting any existing target files. /o is optional.
  121.  
  122. /q is the "quiet" switch: it forces suppression of beeps on error messages.
  123. /q is optional.
  124.  
  125. /s is the "subdirectories" switch. With this switch, Iconvert converts files
  126. in the source directory and ALL of its subdirectories. Without this switch,
  127. IconVert works only within the source directory. Note that subdirectories of
  128. the target directory that do not exist will be created, but only if needed.
  129. /s is optional.
  130.  
  131. /v is the "verbose" switch: it forces display of the characteristics of
  132. converted icons. /v is optional.
  133.  
  134. If Iconvert is not in your current directory or a directory specified in your
  135. PATH statement, you must provide the full path using the drive: and path
  136. parameters.
  137.  
  138.  
  139. ┌──────────┐
  140. │ Comments │
  141. └──────────┘
  142.  
  143. The distribution package contains the following files:
  144.     IconVert.exe             OS/2 1.2 executable file
  145.     IconVert.ico             OS/2 1.2 icon file for IconVert
  146.     IconVert.txt             ASCII documentation for IconVert (this file)
  147.     Win.ico                  Sample Windows 3.0 icon file
  148.  
  149. You can send comments, bug reports or whatever to the following address:
  150.     Philip Engel
  151.     10 E Schiller St
  152.     Chicago IL 60610-2146
  153. Or send to me on the IBM National Support Center BBS (1-404-895-4042).
  154. I usually read the OS/2 2.0 conference at least once a week. (By the way,
  155. I am not an IBM employee.)
  156.  
  157.  
  158. ┌────────────┐
  159. │ DISCLAIMER │
  160. └────────────┘
  161.  
  162. THIS PROGRAM IS FREEWARE. IF YOU DOWNLOAD OR USE THIS PROGRAM, YOU AGREE TO
  163. THE FOLLOWING TERMS:
  164.  
  165. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED
  166. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  167.  
  168. UNDER NO CIRCUMSTANCES AM I LIABLE FOR
  169. 1. LOSS OF, OR DAMAGE TO, YOUR RECORDS OR DATA
  170. 2. ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS)
  171.    OR INCIDENTAL DAMAGES, EVEN IF I AM INFORMED OF THEIR POSSIBILITY
  172. 3. THIRD-PARTY CLAIMS AGAINST YOU FOR LOSSES OR DAMAGES
  173.  
  174. I DO NOT WARRANT UNINTERRUPTED OR ERROR-FREE OPERATION OF ICONVERT. I
  175. HAVE NO OBLIGATION TO PROVIDE SERVICE, DEFECT CORRECTION, OR ANY
  176. MAINTENANCE FOR ICONVERT. I HAVE NO OBLIGATION TO SUPPLY ANY UPDATES
  177. OR ENHANCEMENTS TO YOU, EVEN IF THEY ARE OR LATER BECOME AVAILABLE.
  178.