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. |
|
--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. | |
--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 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 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. |
--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. |
||
--smart | This option is deprecated and ignored. Use option --fast-mipmaps instead. | ||
-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 |