Icons from File Users' Guide vlsoftware.net

Command Line Usage

Contents Index

Icons from file command line specification is described here.

When constructing the Icons from file command line, you must precede all the command line switches (unless otherwise noted) with either a dash (-) or a slash (/). The switches are not case sensitive and their order is not significant.

Below, the switches and parameters, or their parts, that are enclosed in square brackets [] are optiona. The switches, enclosed in arrow brackets <> are required. The symbol | separates possible values for command line switches. Strings colored in red or blue show examples or possible values for command line switches.

[-e[xport]] [-closewhendone] [-iconsizesmall] [-opendestination] [-alliconsasoneimage] [-grayscale] [-includenumbers] [-drawborders] [-iconindex=icon_index] [-dbasedesttype=ICON|BITMAP|JPEG|GIF|PNG|METAFILE] [-htmldestimagetype=PNG|JPEG|GIF] [-dbasefieldname=dBase_field_name] [-desttype=ICO|BMP|JPEG|GIF|PNG|EMF|HTML|DBF] <SrcFileName> [DestFileOrFolderName]

Examples:

1. extraico "c:\my libs\pics.dll"

2. extraico -export -iconindex=2 -desttype=JPG c:\dbtour.exe "c:\export\dbtour2.jpg"

3. extraico -export -iconindex=0 -desttype=JPG c:\dbtour.exe "c:\export\dbtour"

Option (switch) Description

SrcFileName

(required option)

The name of file to extract icons from. File names that include spaces must be enclosed in quotes.

-e[xport] Exports extracted icons to file(s). Attention! There are no prompts for overwriting existing files when exporting icons using the command line.
The following options are meaningful only if -e[xport] option is used:
-closewhendoneCloses the program after successful export execution.
-iconsizesmall Specifies that small icons are to be extracted. If not specified or erroneous then large icons are extracted. This switch is ignored for ICO target format where icons are exported in their actual sizes.
-opendestinationOpens target file after successful export execution.
-alliconsasoneimageAll extracted icons are exported to one image file.
-grayscale Exported icons are converted to gray scale. This switch is ignored for ICO target format.
-includenumbersUses icon enumeration (e.g. numbers as icons follow in source file) when exporting icons to HTML format.
-drawbordersAdds table borders when exporting icons to HTML format.
-iconindex Index of icon to export, in the order from the source file. To extract one icon, use an index starting from 1. To extract all icons, use index 0. In the last case DestFileOrFolderName must be a folder name. If not specified or erroneous then index 1 is used. This switch is ignored for HTML and DBASE destination, where all icons are exported.
-dbasedesttype Specifies target graphic format, which will represent icons in dBase (DBF) table. Possible values are ICON, BITMAP, JPEG, GIF, PNG, or METAFILE.
-htmldestimagetype Specifies target graphic format, which will represent icons in HTML document. Possible values are PNG, JPEG, GIF.
-dbasefieldname Specifies the field name for dBase (DBF) destination format. It may contain only alphanumeric characters. If the length of the field name exceeds 10 characters, the name is truncated to 10 characters. If this switch is not specified in command line then 'ICON' is used for the field name.
-desttype

Specifies target format. If not specified or erroneous, the program uses the DestFileOrFolderName extension (if any). ICO format is used by default, except cases when -alliconsasoneimage is used, in which BMP format is used by default and ICO is not allowed. Possible values are ICO, EMF, WMF, BMP / BITMAP, JPG / JPEG, GIF, PNG, HTM / HTML, or DBF / DBASE.

In the last case, DBF / DBASE, the program will create two files with the same name, but with different extensions: .dbf and .dbt. A file with the .dbf extension is a dBase table and a file with the .dbt extension is a file for BLOB data containing the extracted icons. Already existing files are overwritten.

DestFileOrFolderName Specifies the target file or folder name, which must be a file name, if one icon is exported (-iconindex=1|2|...) or the target format is HTML or DBASE, and a folder name, if all icons are exported (-iconindex=0) and target format is not HTML or DBASE. File (folder) name that includes spaces must be enclosed in quotes. When the folder does not exist, it is created.