| Options | |||
|---|---|---|---|
| Option | Param | Description | |
| -R | --recurse | [=level] | If a extracted file is a known and supported archive, than extract it recursively until the entered level is reached. Level 0 (= -R does'nt accept a parameter and is a short cut for --recurse=unlimited. |
| -e | --ext | For BRRES archives only: If a file is extracted, add a handy file extension like '.mdl' to the file name. If set twice and a textual file magic is available, use the file magic in lower case instead like '.mdl0'. | |
| --cut | Cut different non archive files into smaller peaces (logical units like headers, groups, sections) or list these peaces as single sub files for a more detailed analysis. Supported file types are BMG, BREFT-IMG, KMP, PAT, TEX, TPL, BRRES sub files and more. | ||
| -a | --all | Extract and decode all known and supported files recursively. This is a short cut for »--recurse --decode --mipmaps«. If entered twice, option --cut is included too. | |
| -l | --long | If set, the size of each file is printed. If set twice, offset and size are printed. If set three times, debugging mode is enabled. | |
| -S | --sort | mode | Define a sort mode. Allowed keywords are: |
| -H | --no-header | Suppress printing of header and footer. | |
| --ignore-setup | Ignore hidden setup file ' |
||
| --u8 | Create an U8 archive, if possible. If the source is a WU8 archive, convert it to an U8 archive. This is the default if the setup file ' |
||
| --wu8 | Create a WU8 archive, if possible. If the source is an U8 archive, convert it to a WU8 archive. | ||
| --pack | Create a PACK archive. | ||
| --brres | Create a BRRES archive. | ||
| --breff | Create a BREFF archive. | ||
| --breft | Create a BREFT archive. | ||
| --yaz0 | If creating a compressed file, force Yaz0 compression. Yaz0 compression is the default, if no compression method is defined by option or setup file. | ||
| --yaz1 | If creating a compressed file, force Yaz1 compression. The difference to Yaz0 is only the magic, which is set to 'Yaz1'. | ||
| --bz | If creating a compressed file, force BZ compression (a BZIP2 variant). | ||
| --szs | Short cut for »--u8 --yaz0«: Create an U8 archive, if possible, and set the compression method to Yaz0. | ||
| --wbz | Short cut for »--wu8 --bz«: Create a WU8 archive, if possible, and set the compression method to BZ. | ||
| --pt-dir | [=mode] | Set one of the `point directory' modes This option is only relevant if creating an U8 archive. It decides, if a special directory with name '.' will be added as base for all other files. |
|
| --links | Support hardlinks while creating U8 and WU8 archives. Keep hardlinks if normalizing U8 and WU8 archives. On extracting, search hardlinks in every archive and try to create hardlinks at local file system. | ||
| --rm-aiparam | Remove the directory AIParam and all files from the archive. This option has only impact, if creating a new archive or normalizing an existing archive. |
||
| --align-u8 | size | Define an align value for the sub files in U8 archives. The value must be a power of 2 and the default value is 32 (0x20) This value is only relevant if creating or normalizing U8 archives. | |
| --align-pack | size | Define an align value for the sub files in PACK archives. The value must be a power of 2 and the default value is 32 (0x20) This value is only relevant if creating or normalizing OACK archives. | |
| --align-brres | size | Define an align value for the sub files in BRRES archives. The value must be a power of 2 and the default value is 4 This value is only relevant if creating or normalizing BRRES archives. | |
| --align-breff | size | Define an align value for the sub files in BREFF archives. The value must be a power of 2 and the default value is 4 This value is only relevant if creating or normalizing BREFF archives. | |
| --align-breft | size | Define an align value for the sub files in BREFT archives. The value must be a power of 2 and the default value is 0x20 This value is only relevant if creating or normalizing BREFT archives. | |
| --align | size | Define an align value for the sub files in all archives. This is a short cut for »--align-u8=size --align-pack=size --align-brres=size --align-breff=size --align-breft=size«. | |
| -L | --logging | This debug option enables the logging of internal lists and maps. Set it up to three times to be more verbose. | |
| -Y | --extended-errors | Enable extended error messages. This includes a source file and line reference. Logging level 1 activates it too. |
|
| --timing | Activate the timing of some operations. Logging level 3 activates them too. | ||
| --encode-all | Encode all files. Normally a file is only encoded, if the source is younger than the destination or the destination is missing. Only files in the |
||
| --encode-img | Encode all image files. Normally a image file is only encoded, if the source is younger than the destination or the destination is missing. Only files in the |
||
| --no-encode | Do not encode files before creating an archive. |
||
| --no-recurse | Do not create archives recursively. Normally files in the |
||
| --no-echo | Suppress output of @ECHO commands while scanning text files. | ||
| -N | --no-check | Do not make plausibility checks for KCL and KMP files. | |
| -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. | ||
| --auto-add | Analyze the KMP (if exist) and add missing BRRES, BREFF, BREFT, BRASD and KCL files automatically, if the tool can find the files in any sub directory named 'auto-add'. This sub directory is searched in all directories of |
||
| --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). |
||
| --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 |
|
| --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 ' |
|
| -i | --ignore | Ignore non existing source files without warning. | |
| -n | --norm | The uncompressed data will be normalized. See command NORMALIZE for more details. | |
| --slot | keyword | Patch a track file to run at the specified slot. KMP and KCL may be modified. BRRES files may be added to or removed from SZS. The main keywords are |
|