The file extension of the new file is usually
| 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. | |
| --decode | If a extracted file is known and can be decoded, do it. |
||
| --kmg-limit | seconds | Limit the run time for Ballon Battle and Coin Runners to the given time in SECONDS. Smaller values are not changed. The limitation is carried out after loading a binary file and before scanning a text file. Value 0 disables this option. | |
| --kmg-copy | id | Make all 10 slots of a KMG file equal after loading a binary file and before scanning a text file. ID is either a slot index (0..9) or a slot name (A11..A25) and declares the source slot. Value -1 disables this option. If ID contains brackets [...], then it is analysed as an arena name and the part between the brackets is searched for attributes A11..A25. | |
| -H | --no-header | Suppress the syntax information section in decoded text files. | |
| -B | --brief | Suppress information lines in decoded text files. This includes syntax information (--no-header). If set twice, the output of unneeded sections is also suppressed. | |
| --delta | Print only modified records or sections on text output. Supported file formats until now: |
||
| --diff | On text output, print only differences from original files. It's a short cut for --no-header --brief --brief --delta --delta. Additional, the output is limited to data sections. | ||
| -X | --export | Enable the export mode and create small and machine readable text files for easy post processing. The option works similar like |
|
| -P | --no-param | Disable parameter support in decoded KMP text files. | |
| --bmg-endian | name | Force an endian for new BMG files. Accepted values are Mario Kart Wii uses big endian; the default if no other endian is defined. |
|
| --bmg-encoding | name | Force an encoding for new BMG files. Accepted encoding names are
Mario Kart Wii uses encoding |
|
| --bmg-inf-size | size | Defines the 'INF1' size of new BMG files between 4 and 1000. The first 4 bytes of a INF1 record is an offset into the string pool and the remaining bytes the attributes. Maximal 40 attribute bytes are supported and additional bytes are assumed to be NULL. All BMG files of MKW have a size of 8. | |
| --bmg-mid | [mode] | Control the creation of BMG section |
|
| --force-attrib | attrib | Forces, that all attributes are set to this vector. | |
| --def-attrib | attrib | Define the default attributes for BMG files. If not set, the default attributes are estimated. On text output, strings with default attributes are printed without attribute vector. The usual default attribute for MKW is |
|
| --no-attrib | Suppress the output of any BMG attributes if creating BMG text files. | ||
| --x-escapes | Use \x{} escapes instead of \z{} escapes. | ||
| --old-escapes | To be compatible with v1.43 and earlier, print 1A escape sequences with total size of >12 bytes as single words using \x{}. Also don't use \x{} and \u{} with parameter lists. | ||
| -1 | --single-line | If set, don't print continuation lines for BMG text output. If set twice, print only single text lines and suppress attributes like option --no-attrib does it. | |
| --no-bmg-colors | If set, suppress the output of '\c{color}' escape sequences for colors definitions in BMG text output to be compatible with old versions of the tools. | ||
| --bmg-colors | Force output of '\c{color}' escape sequences with names, even for foreign (not MKWii) BMG files. | ||
| --no-bmg-inline | Print BMG attributes as separate line before the message definition to be compatible with versions until v1.39. The output for the standard value 0x01000000 is always suppressed. This was the default until v1.43. | ||
| -l | --long | Print long numeric message IDs instead of alternative message names like Txx, Uxx or Mxx. | |
| -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 |
| -p | --preserve | Preserve file times (atime+mtime) while converting or copying files. | |
| -u | --update | Update only existing files and don't create new files. If set, --overwrite and --remove-dest are ignored. | |
| -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. |
|
Use option
Some file formats support option
Text files are scanned by a 2-pass parser.
Because of the parser, expression enclosed in parenthesis
See »wszst BINARY« to create binary versions of text files.