| Options | |||
|---|---|---|---|
| Option | Param | Description | |
| --no-wildcards | Disable wildcard parsing and use each filename exactly as specified. | ||
| --in-order | Process the input files in order of the command line and don't delete duplicates. | ||
| -i | --ignore | Ignore non existing source files without warning. | |
| -d | --dest | path | Define a destination path (directory/file). The destination
The path may contain escape sequences:
A |
| -D | --DEST | path | Like --dest, but create the directory path automatically. |
| -E | --esc | char | Define an alternative escape character for destination files. The default is '%'. For Windows batch files it is a good choice to set |
| -o | --overwrite | Overwrite already existing files without warning and ignore option --number. | |
| --number | If a file already exist, append a number directly before the file extension to make the filename unique. If other numbered files already exist (ignoring case), use the maximum existing index+1. |
||
| -r | --remove-dest | Remove already existing files before creating it. If set, --overwrite is ignored. |
|
| -u | --update | Update only existing files and don't create new files. If set, --overwrite and --remove-dest are ignored. | |
| -p | --preserve | Preserve file times (atime+mtime) while converting or copying files. | |
| -a | --all | If source and destination file are the same, the file is only written on modifications (transform, patch, ...). If --all is set, then the file is always written. | |
| --n-mipmaps | num | Force the number of mipmaps. Values between 0 and 20 are allowed. Value |
|
| --max-mipmaps | num | Control the automatic mipmap creation. Values between 0 and 20 are allowed and the default is 4. The mipmap creation for an image stops, if the set number is reached. This option is ignored, if |
|
| --mipmap-size | num | Define the minimal width and minimal height of a generated mipmap. Any value >0 is allowed. The default is 8. This option is ignored, if |
|
| --pre-convert | Convert the image before the image format for the destination file is selected. This results in a perhaps worser graphic and is only useful to control graphic conversions. | ||
| -P | --patch | mode1.mode2...=file | This option specifies patch mode list and a file, separated by an equal sign. Mode is a point separated list of the keywords:
Abbreviations are allowed. The default is
If FILE starts with colon ( |
| --mipmaps | If reading a source, scan for mipmaps and load them too. For PNG files, files named |
||
| --no-mipmaps | If reading a source, ignore mipmaps. This disables not the creation of mipmaps (see -n-mipmaps). |
||
| --fast-mipmaps | If resizing an image, use the old fast resize algorithm (default until v1.64a) instead of the new smart one. Both algorithms differ only, when creating a mipmap for images with odd width or odd height. The old algorithm is faster (factor 2-4) than the default algorithm, but the new algorithm creates better resized images. |
||
| --cmpr-default | rgb1[,rgb2] | Define 2 colors for the case, that all 16 pixels of a CMPR block are transparent. The default is to calculate an average color of all transparent pixels. Before v2.04 white was used.
2 RGB values (hex values with 6 digits each) are expected as parameter. If optional
Use parameter ' |
|
| -x | --transform | list | Convert image formats. A comma separated list with terms is expected. A term have the syntax
Allowed file formats are: All terms are managed as list. For each graphic the list is iterated until the first SRC tuple of a term matches the graphic. Then the destination tuple is used for the transformation. The command wimgt TEST prints a clearly arranged readable table as result of this option. |
| --strip | If creating a PNG file, don't add comments about creator and source formats. | ||