This is an alternative for the ENCODE and DECODE commands. The default destination file format is selected by scanning the file extension of the destination. Option --transform may override this.
Options | |||
---|---|---|---|
Option | Param | Description | |
-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 maximal existing index+1. |
||
-r | --remove-dest | Remove already existing files before creating it. If set, --overwrite is ignored. |
|
-u | --update | Create only files that do not exist. Already existing files are ignored without warning. If set, --overwrite and --remove-dest are ignored. | |
-p | --preserve | Preserve file times (atime+mtime) while converting or copying files. | |
-i | --ignore | Ignore non existing source files without warning. | |
-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 |
|
--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 |
--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). |
||
--smart | If resizing an image, use the new smart resize function. The new function is much slower (factor 2-4) than the old function, but creates much better resized images. This is only relevant for creating mimaps with odd width or height. THIS NEW FUNCTION IS EXPERIMENTAL! | ||
-x | --transform | list | Convert image formats when reading. 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 tupel of a term matches the graphic. Then the destination tupel is used for the transformation. The command »wimgt TEST« prints a clearly arranged readable table as result of this option. |
The basic syntax is very easy:
wimgt copy <SRC_FILE> <DEST_FILE>All tools look always into the source file to determine the formats. These source formats are the defaults for the destination formats. The destination formats can be overwritten by scanning the destination file name and by the option
To change the file format, choose an adequate file extension:
wimgt copy source.tpl dest.png wimgt copy source.tpl dest.texIn the first example, the file
The option
wimgt copy source.png dest.tex --transform cmpr wimgt copy source.png dest.tex --transform tpl wimgt copy source.png dest.tex --transform tpl.cmprThe first example create a
The copy command will not overwrite existing files.
Add
wimgt copy source.tpl dest.png --overwrite wimgt copy source.tpl dest.tex --remove