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. Option --overwrite is set implicitly.
If SOURCE starts with colon (
|-d||--dest||path||Define a destination path (directory/file). The destination
The path may contain escape sequences:
|-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.|
|-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
|--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.
|--strip||If creating a PNG file, don't add comments about creator and source formats.|
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
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.
wimgt copy source.tpl dest.png --overwrite wimgt copy source.tpl dest.tex --remove