prev

next

» SZS: Wiimms SZS Toolset » wszst: Wiimms SZS Tool

Wiimms SZS Tools

Privacy Statement

Tools

wszst

wszst commands

decompress, dec

distribution, dis

is-arena, isarena

is-texture, istexture

name-ref, nameref

normalize, norm

vr-calc, vrcalc

vr-race, vrrace

wszst: Wiimms SZS Tool

Wiimms SZS Tool : List, compare, (de-)compress, extract and create SZS, U8, PACK, BRRES, BREFF and BREFT archives. Additonally, RARC archive can be extracted. It is also a wrapper to all other tools.

Contents

1. Syntax
2. Features of wszst
3. Commands
4. Options in alphabetic order
5. Wrapper
- 5.1 Tool activation
- 5.2 Wrapper commands

1. Syntax

wszst [option]... command [option|parameter|@file]...

2. Features of wszst

wszst supports compressed and uncompressed SZS files. Uncompressed files are good for analysis. Supported archive formats are U8, WU8, PACK, BRRES, BREFF, BREFT and RARC. The format of each source file is detected independent of the file name.
wszst LIST lists the content of a SZS, U8, WBZ, WU8, PACK, BRRES, BREFF, BREFT and RARC archives and directories, if wanted recursive. It lists also extracted file systems to preview the creation process.
wszst MEMORY prints a memory dump of all known archives and file types, if wanted recursive. Normal files are cutted into section and peaces, if option --cut is set. This helps to find location of individual parts of the files.
wszst NORMALIZE read an U8 archive, compressed or not, and write it back in a normalized form:
- The files are sorted in a Nintendo like order.
- Unused data holes are removed.
- If directory '.' is available it becomes the root directory for all others.
- Compressed sources are compressed again with maximum compression (level 9).
- The destination is only written if any data changed.
wszst COMPRESS and wszst DECOMPRESS convert SZS files from and to compressed format.
wszst EXTRACT extract the directories and files to the local file system to make access very easy. Recursive extraction and automatic decoding of some file formats is also possible.
wszst EXTRACT can extract known archives reclusively and can decode BMG files and graphic images on the fly.
wszst CREATE creates SZS files from directory structures. All files are included, include and exlcude lists are supported. Recursive creation and automatic encoding of some file formats is also possible.
wszst CAT allow to access one or more sub files within SZS files. The output of all sources is concatenated and written to stdout.
Extrating a SZS file and creating again results in the same SZS file. Only the internal order of the files may be changed.
wszst DIFF compares 2 archive files on file level. This comparing is independent of the compression and of file order.

Read »Features« for features of the whole toolset.

3. Commands

`VERSION`	`V`	Print program name and version and exit.
`HELP`	`H`	Print help for commands and options.
`CONFIG`		Show all information about the search for the configuration file and its content. The command can also export the settings for scripts or can create or update configuration files.
`INSTALL`		Install files to the shared directory. Wildcards and pipe characters are parsed. Use `wszst CONFIG` to list related pathes.
`ARGTEST`		This debug command accepts all kinds of parameters and prints one line for each parameter. All tools know the ARGTEST command.
`EXPAND`		This debug command accepts (like ARGTEST) all kinds of parameters and prints one line for each parameter. After that, the parameter is treated as a filename with wildcards and all matching files are searched. All tools know the EXPAND command.
`WILDCARDS`		Wildcards and pipe characters are parsed. The special parameters '>+' and '\|-' enable or disable the search for hidden directories and files (files beginning with a point) for the following parameters. Finally, one line is printed for each file name of the list.
`TEST`		This debugging command accepts all options and parameters and prints a list of the internal option values. The command is designed to test the option parameters. The non option parameters are completely ignored.
`COLORS`		Ignore all parameters and print colored text for testing.
`ERROR`	`ERR`	Translate an exit code to a message name. If no exit code is entered, print a table with all error messages. All tools know the ERROR command.
`FILETYPE`	`FT`	Scan the header of the entered files and print file type and path for each file as list. Wildcards and pipe characters are parsed. All tools know the FILETYPE command.
`UI-CHECK`	`UC`	Classify SZS files from directory .../Scene/UI/. For the analysis, the filename is ignored and only the content is examined. Wildcards and pipe characters are parsed.
`FILEATTRIB`	`FA`	Print a table with attributes for all known file types. If at least one keyword is entered, only matching file types are printed. A keyword is either a file type (like 'BRRES' or 'BMG') or one of the printed keywords (like 'ARCHIVE' or 'EXTRACT'). All tools know the FILEATTRIB command.
`BRSUB`		If no file is defined, print a table with known BRRES sub files consisting of file format, version, number of sections and warn level. Otherwise analyse the version numbers of each BRRES sub file of each source and print warnings about invalid versions. Wildcards and pipe characters are parsed.
`SYMBOLS`		Print predefined symbols of text parser to standard output. Many tools know the SYMBOLS command.
`FUNCTIONS`		Print a list with all parser functions. If one or more keys entered, then only functions that match at least one key are printed. Many tools know the FUNCTIONS command.
`CALCULATE`		Calculate each expression and print the result to standard output. Many tools know the CALCULATE command.
`MATRIX`		Use the transformation options as base and calculate and print the related vectors and the transformation matrices. Then do a forward and backward transformation for each vector parameter using the matrices and print the results.
`FLOAT`		This commands helps to convert hex values into floating point numbers and vice versa. For each non empty parameter, a line with 4 bytes hex and a float, 8 bytes hex and a double float, and the parameter itself is printed. If a parameter begins with 'x' or '0x', it is a hex string, otherwise it is a floating point number. The special parameters "+" and "-" mean: Increment or decrement the previous value by the smallest possible value. Use different increments for floats and doubles. All conversions are done using big endian.
`VR-CALC`	`VRCALC`	Calculate a VR increment for each given delta value (=VR_winner-VR_loser). Print results as table.
`VR-RACE`	`VRRACE`	Print a table with VR calculations for a race. Each VR is the current rating of a player. The vr-list is well ordered: The first VR is for the winner and the last VR for the looser. Up to 30 VR values will be accpeted. Each VR can be preceeded by "NUM*" to define a repeat factor.
`AUTOADD`		Manage the auto-add library. Primarily add files to the main auto-add archive for future use of option `--auto-add` or to convert WU8 files. If SOURCE is a directory, all standard track and arena file names are searched for the missed auto-add files. Wildcards and pipe characters are parsed. Without source files, the status of the auto-add archive is printed. Try `wszst AUTOADD ./path_to/Race/Course/` to add all supported files.
`TRACKS`		Print a list of all known track SZS files of Mario Kart internal directory './Race/Course'. These files are 32 standard track files and 10 arena files. The first column shows an unique ID of exact 3 upper case characters or digits. For '_d' files, a 'd' is appended. The second column shows the internal file name. Use BMG files to print real names as third column.
`SCANCACHE`		Scan the cache directory for SZS files and re-build the checksum table. Store the result as file 'cache-content.txt' in the same directory. The file is used by option `--cache` to optimize file access.
`LIST`	`LS`	List all sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives. If listing a directory, then a virtual SZS file is created (like CREATE does it) and listed. Wildcards and pipe characters are parsed.
`LIST-L`	`LL`	List all sub files with size. 'LIST-L' and 'LL' are short cuts for `LIST --long`. Wildcards and pipe characters are parsed.
`LIST-LL`	`LLL`	List all sub files with offset and size. 'LIST-LL' and 'LLL' are short cuts for `LIST --long --long`. Wildcards and pipe characters are parsed.
`LIST-LLL`	`LLLL`	List all sub files with offset and size in debugging mode. 'LIST-LLL' and 'LLLL' are short cuts for `LIST --long --long --long`. Wildcards and pipe characters are parsed.
`LIST-A`	`LA`	List recursive all sub files with size. 'LIST-A' and 'LA' are short cuts for `LIST --long --all --all`. Wildcards and pipe characters are parsed.
`LIST-LA`	`LLA`	List recursive all sub files with offset and size. 'LIST-LA' and 'LLA' are short cuts for `LIST --long --long --all --all`. Wildcards and pipe characters are parsed.
`NAME-REF`	`NAMEREF`	For each BRRES file or subfile, create a name based cross reference and print the result as list ordered by names in BRRES order. For U8 archives (e.g. track SZS files), sub file course_model.brres is analysed. Wildcards and pipe characters are parsed.
`ILIST`	`IL`	List the images files of all sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives; non image files are ignored. If listing a directory, then a virtual SZS file is created (like CREATE does it) and listed. Wildcards and pipe characters are parsed.
`ILIST-L`	`ILL`	List all image files with geometry data. 'ILIST-L' and 'ILL' are short cuts for `ILIST --long`.
`ILIST-LL`	`ILLL`	List all sub files with advanced geometry data. 'ILIST-LL' and 'ILLL' are short cuts for `ILIST --long --long`.
`ILIST-A`	`ILA`	List recursive all image files. 'ILIST-A' and 'ILA' are short cuts for `ILIST --all`.
`ILIST-LA`	`ILLA`	List recursive all image files with geometry data. 'ILIST-LA' and 'ILLA' are short cuts for `ILIST --long --all`.
`MEMORY`	`MEM`	Dump a memory map of each source file. Virtual images (extracted directories) are also supported. Wildcards and pipe characters are parsed.
`MEMORY-A`	`MEMA`	Dump recursive a memory map of each source file. 'MEMORY-A' and 'MEMA' are short cuts for `MEMORY --all --all`.
`DUMP`		Dump the internal structure of a BRRES files, compressed or not. Other archives are ignored. The main goal is to verify string relocation. Virtual images (extracted directories) are also supported. Wildcards and pipe characters are parsed.
`SHA1`		Print a SHA1 checksum for each source. The checksum is calculated by using the uncompressed data and after patching. Wildcards and pipe characters are parsed.
`ANALYZE`	`ANA`	Analyse track files and LE-CODE binaries. Print the results in machine-readable form. The output format is selected by options. Wildcards and pipe characters are parsed.
`SPLIT`		Analyse (file) names and split them into the different parts. Print the results in machine readable format. Wildcards and pipe characters are parsed.
`IS-TEXTURE`	`ISTEXTURE`	Test each source to see if it's a texture hack versus a reference file. For each source, one human and machine readable status line is printed. It is either »-1=err« on error, »1=yes« for a texture hack, or »0=no LIST« with a comma separated list of reasons. Wildcards and pipe characters are parsed. At the moment KCL, KMP (see notes) and LEX are checked. KMP section CAME has been intentionally left out. Section ENPT is only checked if KCL contains a least one face of type force-recalculation.
`FEATURES`		Analyse track files and create a feature list for each source in machine readable format. CTGP uses the feature lists to manage ghosts. See option `--lex-features` for details. Wildcards and pipe characters are parsed.
`DISTRIBUTION`	`DIS`	Load each SOURCE (SZS, WBZ, U8 or WU8) and calculate a checksum of the uncompressed data. If SOURCE is a directory, scan it for SZS, WBZ, U8 and WU8 files. If a source directory starts with "arena", all tracks of the directory are assumed to be battle arenas. Finally print the results into file RESULT. Wildcards and pipe characters are parsed. The default name for RESULT is "distribution.txt". Extension .txt is appended to the filename if not defined. If RESULT is a directory, it is used as first source too. If file RESULT exists, it is automatically added as last source to the list of option --source, but only if not already added. On scanning of file result, parameters are scanned too. See »welect DISTRIBUTION« for a new and alternative implementation of this.
`DIFF`	`CMP`	Compare two or more sources (each SZS, U8, LTA, PACK, BRRES, BREFF, BREFT, RARC or directory) on file level and report mismatches for each sub file. If option `--dest` is set, then each source file is compared with a file in the destination.
`CHECK`		Make a validity check for track files: Try to read KCL and KMP (and check both) and find unknown, modified, needed and unneeded files. Also analyse cannons and make slot proposals. This command uses an internal object and file database. The source can be a SZS, U8, WU8 or WBZ file, or an U8 like directory. Wildcards and pipe characters are parsed.
`SLOTS`		Try to find out the slots, that will run a track. Each source can be a SZS, U8, WU8 or WBZ file, or an U8 like directory. For each source one status line is printed. The status line contains either a positive or a negative slot list, whatever is shorter. For battle arenas, the keyword ARENA is printed. Wildcards and pipe characters are parsed.
`STGI`		Find the first KMP:STGI of each file and print an analysis of it as single line statistic. Additional the number of lap counter check points ('LC') is printed. Track and KMP (binary and text) files are accepted as input. Wildcards and pipe characters are parsed.
`IS-ARENA`	`ISARENA`	Analyse each track for its arena status and print a line with a status code and the track name. Wildcards and pipe characters are parsed. The status code is: »-RACE« for a racing track, »?MAYBE« for likely an arena, »+ARENA« for an arena, »+DISPATCH« for an arena with dispatch points or any error hint beginning with an »!«. So the very first character (one of »!-?+«) can be used to distinguish the status class. The exit status is >2 on error, 2 (DIFFER), if at least one file is a racing track, or 0 (OK), if all sources are arenas.
`NORMALIZE`	`NORM`	Normalize an U8 archive, compressed or not: The files are sorted in `Nintendo like' order and unused data holes are removed. If directory '.' is available it becomes the root directory for all others. Compressed sources are compressed again with maximum compression (level 9). The destination is only written if any data changed. Wildcards and pipe characters are parsed. `wszst NORMALIZE` is the same as `wszst PATCH --norm`.
`PATCH`		Patch an U8 archive, compressed or not: Load the archive, apply all patching and transforming options and store the file again. Compressed sources are compressed again. The destination is only written if any data changed or if stored in another file. Wildcards and pipe characters are parsed.
`COPY`	`CP`	COPY is an alternative command for copying and patching files. It uses the same internal procedure as command PATCH, but has another command line syntax. The command copies all source files to the destination. If no destination is defined by options `--dest` or `--DEST`, then the last parameter is used as destination. If more than 1 source is defined, the destination must be either a directory or a destination filename with escapes. Wildcards and pipe characters are parsed. Patching is also possible and option --overwrite is set implicitly.
`DUPLICATE`	`DUP`	The command reads a single track file and duplicates it several times to DEST. Therefor it analyzes the presence flags combinations with and without extension support and creates one file for each relevant scenario. A LEX section TEST will be inserted to force the execution mode for offline tests. The destination filename (not directory part) is searched for the first occurance of '@'. If not found, the place before the last point is used. At this place an identification string is inserted. Depending on option `--gamemodes` up to 1573 files will be created. So the use of option `--fast` is recommended to speed up the process. Use command `wkmpt GAMEMODES` to list all variants and to check them beforehand.
`MINIMAP`		Print minimap data (more exact: the visual field of the minimap) of a SZS, U8, BRRES or MDL file. If patching options are used, modify the data and write back the file using its original file format. Only the translation vector is modified and new translation and inverse matrices are calculated. Wildcards and pipe characters are parsed.
`COMPRESS`	`COM`	Compress and create a SZS archives. If the source is already compressed, then decompress and compress it again. The default destination is '%P/%N.szs'. Wildcards and pipe characters are parsed.
`DECOMPRESS`	`DEC`	Decompress SZS files. The default destination is '%P/%N.u8'. Wildcards and pipe characters are parsed.
`ENCODE`	`E`	Create and/or encode sub files if necessary. It works like command CREATE, but without creating a new first level archive file. Wildcards and pipe characters are parsed.
`CREATE`	`C`	Create SZS, U8, PACK, BRRES, BREFF or BREFT archives by adding all not hidden files of the directory structure. Create and/or encode sub files if necessary. The default destination is '%P/%N%T'. Wildcards and pipe characters are parsed.
`UPDATE`	`U`	Update an existing SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARCarchive. This is done in similar way as the `EXTRACT` command, but instead of extracting, source files are searched in a prior extracted archive. Only files with the same size are updated. The secondary source is used to find the source sub files. The default secondary source is '%P/%N.d/'. Wildcards and pipe characters are parsed.
`EXTRACT`	`X`	Extract all sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives. The default destination is '%P/%N.d/'. Wildcards and pipe characters are parsed.
`XDECODE`	`XD`	Command XDECODE is a short cut for `EXTRACT --decode`. It extract all sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives and decodes all supported files. The default destination is '%P/%N.d/'. Wildcards and pipe characters are parsed.
`XEXPORT`	`XX`	Command XEXPORT is a short cut for `EXTRACT --decode --export`. It extract all sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives and decodes all supported files with enabled export mode. The default destination is '%P/%N.d/'. Wildcards and pipe characters are parsed.
`XALL`	`XA`	Command XALL is a short cut for `EXTRACT --all`. It extract all sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives recursively and decodes all supported files. The default destination is '%P/%N.d/'. Wildcards and pipe characters are parsed.
`XCOMMON`		Command XCOMMON is a short cut for `EXTRACT --basedir=common`. Scan archives and extract files from archives, that are below directory 'common'. The default destination is '%P/%N.d/'. Wildcards and pipe characters are parsed.
`BINARY`	`BIN`	Read each source file (binary or text, but never archives) and write the content as binary file. Wildcards and pipe characters are parsed. The file extension of the new file depends on the file type, but is usually .bin. Currently supported file formats are BMG, GEOHIT, ITEMSLOT, KCL, KMG, KMP, LEX, OBJFLOW, PAT and the related text formats.
`TEXT`	`TXT`	Read each source file (binary or text, but never archives) and write the content as text file. Wildcards and pipe characters are parsed. The file extension of the new file is usually .txt. Currently supported file formats are BMG, GEOHIT, ITEMSLOT, KCL, KMG, KMP, LEX, OBJFLOW, PAT and the related text formats.
`CAT`		Extract one or more sub files of SZS, U8, LTA, PACK, BRRES, BREFF, BREFT and RARC archives. Wildcards, pipe characters and sub-files are parsed. The output of all source files is concatenated and written to stdout.
`BMG`		For each archive all BMG sub files are searched and, if found, decoded and printed as combined BMG text file. The command works exactly like `wbmgt MIX`. Wildcards and pipe characters are parsed.
`KCL`		For each archive the KCL sub file course.kcl is searched and, if found, decoded and printed (copied to stdout). Wildcards, pipe characters and sub-files are parsed. Automated dropping of bad KCL triangles is enabled if no other drop option is specified by option `--kcl`. Wildcards and pipe characters are parsed.
`KMP`		For each archive the KMP sub file course.kmp is searched and, if found, decoded and printed (copied to stdout). Wildcards, pipe characters and sub-files are parsed.
`LEX`		For each archive the LEX sub file course.lex is searched and, if found, decoded and printed (copied to stdout). Wildcards and pipe characters are parsed.
`INFO`		For each archive a file named info.txt and, if not found, credits.txt is searched, ignoring case. The first found file of each archive is printed (copied to stdout). Wildcards, pipe characters and sub-files are parsed.
`YAZDUMP`	`YD`	Analyze YAZ compression and print a dump to stdout. Ignore files without YAZ compression. Wildcards and pipe characters are parsed.

4. Options in alphabetic order

Options
Option		Param	Description
	`--9laps`		Patch RACE*.szs files from directory .../Scene/UI/ to support 9 laps. It is based on https://wiki.tockdom.com/wiki/Lap_Texture_Fix v1.03.
	`--align`	size	Define an align value for the sub files in all archives. This is a short cut for `--align-u8=size {--align-lta=size --align-pack=size --align-brres=size --align-breff=size --align-breft=size`.
	`--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-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-lta`	size	Define an align value for the sub files in LTA archives. The value must be a power of 2 and the default value is 32 (0x20) This value is only relevant if creating LTA 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-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.
`-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.
	`--allow-all`		Usually commands accept only options with impact to the command. All other options fire a syntax error. But if --allow-all is set, all commands accept all options. This makes changing the command of a long command line without removing useless options easier. It also helps to override wrong option permissions.
`-A`	`--arenas`	arenas	Define a new arena order. A comma separated list in the format [a=]b or a:=b is expected. 'a' and 'b' are arena names or slot numbers. 'a' is the destination slot and 'b' the assigned arena. If 'a' is omitted, the next slot is used; this means [a=]b,c,d is possible. Arenas will only be exchanged so that always all arenas are assigned. But if using ':=' the new slots are assigned without exchanging and the old values are lost.
	`--arot`	degree[@pos1]@pos2	Transform the data and do an axis rotation: Close the current transformation step like `--next` and rotate the data by 'degree' around the axis defined by the 2 points. If 'pos1' is not set, use 0,0,0 instead. Store the resulting matrix as single transformation step and open a new one. This kind of transformation is EXPERIMENTAL!
	`--array`		Use an array on script output if possible. If arrays are not supported, then append a '_#' suffix with an zero based index to the variable name defined by `--var name`. In this case, only one output file is created.
	`--ascale`	factor@dir	Transform the data and do an axis scale: Close the current transformation step like `--next` and scale the data by 'factor' into the direction given by the vector 'dir'. Store the resulting matrix as single transformation step and open a new one. This kind of transformation is EXPERIMENTAL!
	`--auto`		Calculate the minimap translations automatically by using the minimum and maximum vertex coordinates. The 'scale' and 'rotation' fields are reset. This is done as first action before the SET, CENTER and the other transformations.
	`--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 'SEARCH_PATH'; use command `wszst AUTOADD` to view them. Command `wszst AUTOADD` may also create an auto-add database. --aadd is a short cut.
	`--autoadd-path`	directory	Define an alternative directory as autoadd library. The default is, that the sub-directory called './auto-add/' of all search paths are used. Use `wszst config -ll` for tests.
	`--avar`	varname	Shortcut for: `--array --var name`
	`--base64`	[=mode]	Encode the the checksum string as BASE64 with 27 characters instead of hex. If a parameter is set, it acts like `--coding=mode`.
	`--basedir`	directory	Extract only files from archives, that are below the DIRECTORY. Leading points and slashes and trailing slahes are removed from the parameter. --bdir is short cut for --basedir.
	`--bash`		Dump info using BASH syntax. Use `--var name` as prefix.
	`--battle`	[=mode]	MODE is either OFF, AUTO (default) or ON. Without value, ON is used. If mode is ON, assume a battle arena and enable a special battle support. If mode is OFF, disable special battle arena support. If mode is AUTO, analyse the KMP and estimate, if it is a battle areana. Modes ON and OFF override KMP parameter BATTLE-MODE.
	`--bmg-colors`		Force output of '\c{color}' escape sequences with names, even for foreign (not MKWii) BMG files.
	`--bmg-encoding`	name	Force an encoding for new BMG files. Accepted encoding names are CP-1252, UTF-16BE (or UTF-16), SHIFT-JIS, UTF-8 and AUTO for automatic detection (default). Same keywords without minus signs are accepted too. Mario Kart Wii uses encoding UTF-16BE; the default if no other encoding is defined.
	`--bmg-endian`	name	Force an endian for new BMG files. Accepted values are BIG or BE for big endian, LITTLE or LE for little endian and AUTO for automatic detection (default). Mario Kart Wii uses big endian; the default if no other endian is defined.
	`--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 MID1. Suppress the creation, if mode is OFF. Force the creation, if mode is ON. On mode AUTO (default), the source is analysed for the decision.
	`--breff`		Create a BREFF archive.
	`--breft`		Create a BREFT archive.
`-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.
	`--brres`		Create a BRRES archive.
	`--bz`		If creating a compressed file, force BZ compression (a YAZ0 like file format with BZIP2 compression).
	`--bzip2`		If creating a compressed file, create a BZIP2 compatible file.
	`--cache`	dir	Define a directory for an SZS cache. If creating a YAZ0, BZ, BZIP2, LZ or LZMA compressed file with standard compression (levels 9,9,9,6,6), the cache is searched for the compressed version. File cache-content.txt is used as file list with hash values. If the cache file is not found or the content differ, the file is (re-)created and exit status 2=differ is returned. Option `--remove-dest` is set automatically to protect cache integrity. The idea behind the cache: Loading an SZS file and comparing the decompressed content is clearly faster than compressing the file. For legay reasons: If parameter DIR is a file, the filename is split into directory and base name. The directory is used for the cache directory and the base name for option `--cname`, but only if `--cname` is not used.
	`--case`	case	CASE is one of LOWER, AUTO (default) or UPPER.If LOWER or UPPER are set, then the lower/upper case of the variable names is adjusted accordingly.
	`--center`		Center the minimap in all 3 directions. This is a short cut for `--xcenter --ycenter --zcenter`.
	`--chdir`	dir	Set a new working directory for all following options, for all parameters and for the command execution. This option can be used multiple times, but for parameter parsing and for command execution only the last usage is relevant. Nevertheless, '@param' values are scanned while reading the command line.
	`--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 RGB2 is missed, a copy of RGB1 is used. As first step, both colors are converted to RGB565 colors C1 and C2 and sorted, so that C1<C2 (mandatory for CMPR). If C1 and C2 are identical, the least significant bit of green is cleared for C1 and set for C2. Use parameter '0' to force black, '-1' to force white, or '-' to reset to auto calculation.
	`--cname`	name	Name of the first cache file. This parameter overrides the generated cache name. The name is used only once for the very first cache candidate.
	`--coding`	mode	Define the coding of the non alphanumeric characters for BASE64: STANDARD (+/=, default), URL (-_=), STAR (-_) or XML (.-).
	`--colors`	[=modus]	Define the modus for colored text output. Allowed keywords are: OFF or NO-COLORS to disable colors, AUTO (default) for automatic detection, ON for automatic detection but never OFF, 8-COLORS and 256-COLORS to force 8 or 256 color support. Without parameter, ON is used. AUTO will enable colorized output only for terminals. AUTO and ON use environment variable TERM to find the correct color modus. If a command is prefixed by 'C-', then --color=ON is used implicitly as default.
	`--compatible`	vers	The option expects a version number (format '#.##' or 'v#.##') or a revision number (format 'r#') as parameter. If set, the tools try to create BMG and KMP text files, that are compatible to the entered version of the tools. This may override other legacy options.
`-C`	`--compr`	level	Define a compression level between 0..9: 0 (or NOCHUNKS) disables finding chunks, 1 (or FAST) for the fastest standard compression and 9 (or BEST) for the best (=default) compression. 10 (or ULTRA) and 100-150 are special time-consuming compression modes. They are dedicated to competitions with size limitations. The special value UNCOMPRESSED acts like option `--no-compress`. Because of many repeated data, the best bz-compression mode varies. Therefor the levels TRY2..TRY5 (or short T2..T5) are defined to find the best compression mode with testing the first N modes of 9, 1, 8, 2, 5. TRY2 is used for normalizing. For non bz-compression, TRY* are the same as BEST. Do not use compression level >6 for LZMA if the file is intended for Mario Kart Wii, as too much memory is required for decoding. Option `--norm` takes precedence over `--compr` and sets the compression level for bzip2 to TRY2 (BEST) and for LZMA to 6. For more modes and details type `wszst -C list`. To force colorized output type `wszst -C clist`.
	`--config`	file	Define a configuration file or a directory as source. In later case, file 'wiimms-szs-tools.conf' is searched. If option is not not set, then file 'wiimms-szs-tools.conf' is searched in different directories. Use command 'wszst CONFIG' to get more details.
`-c`	`--const`	list	Define constant values, that are used by the internal encoders and by the numeric options as predefined global variables. This option allows a conditional encoding of text files. It can be used multiple times for multiple definitions. The parameter is a comma separated list of terms and a term is 'name=expression'. The expression is calculated by the text parser.
	`--ct-code`		Enable CT-CODE support.
	`--cup-icons`	image	Load given image, convert it to TPLx.CMPR and add the result as sub-files 'button/timg/ct_icons.tpl' and as 'control/timg/ct_icons.tpl' to files 'Channel.szs', 'MenuMulti.szs' and 'MenuSingle.szs'. Both sub-files are always linked, so that storage space is saved. The usual size for each single icon is 128x128.
	`--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.
	`--cybz`		If creating a compressed file, force YBZ compression (YAZ0 file header, but BZIP2 compression), but don't change the payload.
	`--cylz`		If creating a compressed file, force YLZ compression (YAZ0 file header, but LZMA compression), but don't change the payload.
	`--db64`	[=mode]	Encode the the checksum string and some length as BASE64 with 32 characters instead of hex for database searches. This options implies `--coding=URL` if no other coding is defined. If a parameter is set, it acts like `--coding=mode`. Option `--db64` has priority over `--base64`.
	`--de`		Use german track and arena names.
	`--decode`		If a extracted file is known and can be decoded, do it. --dec is a short cut.
	`--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 [1].
	`--delta`		Print only modified records or sections on text output. Supported file formats until now: GEOHIT, ITEMSLOT, KMG and OBJFLOW. If set twice, limit output to modified records (only relevant for ITEMSLOT).
`-d`	`--dest`	path	Define a destination path (directory/file). The destination - means: write to standard output. The path may contain escape sequences: %Q is replaced by the fully qualified source name. %P and %F are replaced by the source path or by the filename. %N and %E are replaced by source filename without extension or by the source extension. Finally, %T is replaced by the default extension of the destination format. A '?' direct behind '%' in %E and %T conversions avoid that the same extension is used twice in row.
`-D`	`--DEST`	path	Like `--dest`, but create the directory path automatically.
	`--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.
	`--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] section of the file 'wszst-setup.txt' are candidates for encoding. --eall is a short cut. Option `--no-encode` takes precedence over `--encode-all`.
	`--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 [encode] section of the file 'wszst-setup.txt' are candidates for encoding. --eimg is a short cut. If set, option `--no-encode` is ignored for images.
`-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 '-E$'.
`-X`	`--export`		Enable the export mode and create small and machine readable text files for easy post processing. The option works similar like -HBB for KMP and like -HBl1 for BMG text files.
	`--export-flags`	[=mode]	MODE is either OFF, AUTO (default) or ON. Without value, ON is used. --exflags is an alternative name for the option. If mode is ON, this feature is forced: On creating a KMP text file, the option EXPORT-FLAGS is always set to 1. On creating a binary KMP file, the flags are always exported as lowest byte of the scale factors or x-rotation. If mode is OFF, this feature is totally disabled. If mode is not AUTO, KMP parameter EXPORT-FLAGS is overridden.
`-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'.
`-Y`	`--extended-errors`		Enable extended error messages. This includes a source file and line reference. Logging level 1 activates it too. --xerr is a short cut.
	`--fast`		Short cut for `--compr=fast`: Set the fastest real compression. It also overrides compression rates set by `--norm` or `--compr`.
	`--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. --fast-mm is a short cut.
	`--filter-bmg`	list	If this option is set, the BMG messages are filtered by this list. Only enabled messages are exported to the output BMG file (binary or text). The parameter is a list of message ids (short MID, 'Txx' or 'Uxx' or Mxx' or hex number) or message ranges (MID:MID) or one of the keywords NONE, IDENT (=ID), PARAM, CUPS, TRACKS, ARENAS, CHAT, CTCODE (=CT), CTUPS, CTTRACKS, CTARENAS, CTREFS, LECODE (=LE), LEUPS, LETRACKS, LEARENAS, LEREFS, XCODE (=X), XUPS, XTRACKS, XARENAS, XREFS, ALLCODE, ALLUPS, ALLTRACKS, ALLARENAS, ALLREFS, GENERIC or ALL. If an element is preceded by a minus sign, it is removed from the filter list (disabled). With v2.01a, this option was renamed from --msg to the more meaningful name --filter-bmg. The old name is still available.
	`--flag-file`	filename	Define a flag file if scanning an OBJ file (KCL processing). The file name may contain %-escapes. Set it to an empty string to disable flag files at all. The tool search the flag file in the following order until found: File defined by --flag-file; OBJ file name with replaced extension ('a.obj' becomes 'a.flag'); OBJ file name with appended extension ('a.obj' becomes 'a.obj.flag').
	`--force`		The tools analyse input files and reject files with invalid data structures. If --force is set, little repairable issues are ignored and a warning is printed. Option `--kmp force` does the same, but only for KMP files. >>> THE RESULT MAY BE INVALID OUTPUT FILES! <<<
	`--force-attrib`	attrib	Forces, that all attributes are set to this vector.
	`--gamemodes`	list	Filter the list of combinations. The parameter is a comma separated list of keywords: AUTO: Add a automatic mode without conditions first. STANDARD (or STD): Add standard modes. 1STANDARD (or 1STD): Add standard modes first. BALLOON: Add balloon battle modes. COIN: Add coin runners modes. BATTLE: Short cut for 'BALLOON,COIN'. VERSUS (or VS): Add versus modes. ITEMRAIN: Add itemrain modes. RACE: Short cut for 'VERSUS,ITEMRAIN'. ALL (default): Short cut for 'STANDARD,BATTLE,RACE'. NO-MODES: Exclude 'ALL' and create auto modes only. ENGINE: Include engine classes (default). NO-ENGINE: Exclude engine classes. RANDOM: Include random modes (default). NO-RANDOM: Exclude random modes. OFFLINE: Filter offline modes. ONLINE: Filter online modes. NO-TT: Exclude time trial. TT: Force a time trial scenario, even if it is a duplicate. FULL: Don't eliminate duplicates from list (up to 1573 modes). NSORT: Sort the list by name. ISORT: Sort the list by index. DEBUG: Print a debug info about this option.
`-h`	`--help`		Stop parsing the command line, print a help message and exit.
	`--id`		Print an ID with 8 characters instead of a SHA-1 sum with 40 characters. The SHA-1 sum is used to calculate the ID. The ID consists of '0'-'9' and 'a'-'v' (32 different characters).
`-i`	`--ignore`		Ignore non existing source files without warning.
	`--ignore-setup`		Ignore hidden setup file 'wszst-setup.txt'. This file is used to determine some default settings and to find out sub archives and files to encode. Use this option only if you know what you do.
	`--in-order`		Process the input files in order of the command line and don't delete duplicates.
	`--install`		Manage configuration for an installation.
	`--json`		Dump info using JSON syntax. Options `--var` and `--array` are ignored.
	`--kcl`	list	Set global options for KCL processing. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables a setting. Each occurrence of the option will only change entered settings and all other settings are untouched. Keyword DEFAULT resets the default settings and CLEAR disables all. Keywords SMALL, MEDIUM and CHARY select the default parameters for the octree creation. The other allowed keywords are: FAST, NEW, CENTER, ROUND, NORMALS, MTL, WIIMM, TRIANGLES, OUT-SWAP, G, USEMTL, CLIP, IN-SWAP, AUTO, HEX4, HEX23, HEX, DROP-UNUSED, DROP-FIXED, DROP-INVALID, DROP, RM-FACEDOWN, RM-FACEUP, FIX-ALL, TINY-0 ... TINY-7, CONV-FACEUP, WEAK-WALLS, SORT, INPLACE, SILENT and LOG.
	`--kcl-flag`	joblist	Modify the KCL flag of KCL files. A comma separated job list in the format 'srclist=dest' is expected. 'srclist' is a plus sign separated list with single values like <val>, T<type> and <val>/<mask> or ranges like <val>:<val>, T<type>:<type> and <val>:<val>/<mask>. '<val>' is a complete KCL flag in the range of 0..0xffff. '<type>' are only the base types in the range of 0..0x1f. If <mask> is present, it marks the relevant bits. For the T<type> variant, the mask is set to 0x1f. All KCL flags of the source list are assigned to the new value 'dest', but only the set bits of '<mask>' are modified. A later definition overrides the previous one.
	`--kcl-script`	script	After reading a KCL source file and executing all transformations, the text file 'script' is executed by the internal text parser. The script should use the parser functions tri$*() to read and modify the triangle positions and flags, or to add or remove complete triangles. If this option is used multiple times, each script is executed in the entered order.
	`--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.
	`--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.
	`--kmp`	list	Set global options for KMP processing. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables a setting. Each occurrence of the option will only change entered settings and all other settings are untouched. Keyword DEFAULT resets the default settings and CLEAR disables all. The other allowed keywords are: FORCE, NEW, RM-SPCITEM, LEFT, RIGHT, WIDE, NARROW, FIX-CKPH, FIX-ENPH, FIX-ITPH, FIX-PH, FIX-CKNEXT, FIX-CKJGPT, FIX-CK, FIX-ALL, MASK-PFLAGS, RM-LECODE, PURGE-GOBJ, FULL-DEFOBJ, DUMP-CLASS, DUMP-ONEWAY, DUMP-ALL, 1LAP .. 9LAPS, MAX-LAPS, RM-EMPTY, TINY-0 .. TINY-7, INPLACE, SILENT and LOG.
	`--ktpt2`	vector	Insert or replace a second KTPT. Use VECTOR as new position. VECTOR is either X,Z or X,Y,Z or an expression. Set Y to 0 for an automatic defined height. If the first 4 characters of VECTOR are 'AUTO' (ignoring case), then the position is calculated automatically and set to the recommendation of command wkmpt KTPT. The tool looks for the nearest lap counter (CKPT with mode 0) and adjust the KTPT: The direction of the lap counter is copied and the KTPT is moved to the lap counter line using the new direction. LE-CODE uses the second KTPT to draw the finish line at another place away from the start position.
	`--le-04x`		Use format %04x instead of %03x for LE-CODE slots to enable uniform slot numbers if slots >4095 are used.
	`--le-code`	[=param]	Enable LE-CODE and CT-CODE support. The optional parameter is deprecated and ignored.
	`--le-menu`		Patch language independent SZS files from directory .../Scene/UI/ to change the menu as required by LE-CODE to be able to select tracks from more than 8 cups.
	`--lex-features`		Calculate LEX setion FEAT (features) by analysing the track file. If no features found, delete the section and the possibly empty sub-file course.lex. If features found, then insert the section or update an existing section. If necessary, the sub-file course.lex is created. This option is executed after all --lt-* options and after --lex-purge. CTGP uses the FEAT section to manage ghosts.
	`--lex-purge`		Delete LEX sections without any impact. Delete sub-file course.lex if it no longer contains a section. This option is executed after all --lt-* and --lex-* options.
	`--lex-rm-features`		Remove LEX setion FEAT (features) if exists and the possibly empty sub-file course.lex. This option is ignored if --lex-features is set. It is executed after all --lt-* options and after --lex-purge.
	`--lfl`		Create a LFL (LE-CODE File List) archive.
	`--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.
	`--load-bmg`	file	Load immediately the file to fill an internal message pool. The option can be used multiple times to fill the message pool by different sources. A later message overrides the previous message. The internal message pool is patched by all `--patch-bmg` options.
	`--load-category`	file	Read in a CATEGORY file and replace the internal category database with the content. https://ct.wiimm.de/export/category is the authoritative source for this.
	`--load-kcl`	file	Load a KCL or OBJ file for reference issues.
	`--load-prefix`	file	Read in a PREFIX file and replace the internal prefix database with the content. https://ct.wiimm.de/export/prefix is the authoritative source for this.
	`--log-cache`	file	Define a file to log chache activities. Use '-' to log to stdout or stderr. The file is openend in append-mode.
`-L`	`--logging`		This debug option enables the logging of internal lists and maps. Set it up to three times to be more verbose.
`-l`	`--long`		Print in long format. Multiple usage possible.
	`--lt-clear`		Clear LEX sections TEST and DEV1 and remove them and course.lex if empty. This option is executed before all other --lt-* options.
	`--lt-cond-bit`	bitnum	Set LEX:TEST parameter COND-BIT to this integer value. Use -1 to deactivate this COND-BIT. Only track.szs files are modified. If needed, file course.lex and section TEST are created or removed if empty.
	`--lt-engine`	mode	Set LEX:TEST parameter ENGINE to this MODE. MODE is one of AUTO (default), BATTLE, 50CC, 100CC, 150CC, 200CC, 150M or 200M. Only track.szs files are modified. If needed, file course.lex and section TEST are created or removed if empty.
	`--lt-game-mode`	mode	Set LEX:TEST parameter GAME-MODE to this MODE. MODE is one of AUTO (default), BALLOON, COIN, VERSUS or ITEMRAIN. Only track.szs files are modified. If needed, file course.lex and section TEST are created or removed if empty.
	`--lt-n-players`	offline,online	Set LEX:TEST parameters N-OFFLINE and N-ONLINE to these integer values. Only track.szs files are modified. If needed, file course.lex and section TEST are created or removed if empty.
	`--lt-online`	mode	Set LEX:TEST parameter OFFLINE-ONLINE to this MODE. MODE is one of AUTO (default), NEVER or ALWAYS. Only track.szs files are modified. If needed, file course.lex and section TEST are created or removed if empty.
	`--lt-random`	index	Force a random scenario, if INDEX is between 1 and 8. Value 0 enables auto selection and -1 disables this option. Only track.szs files are modified. If needed, file course.lex and section TEST are created or removed if empty.
	`--lz`		If creating a compressed file, force LZ compression (a YAZ0 like file format with LZMA compression).
	`--lzma`		If creating a compressed file, create a LZMA compatible file.
	`--macro-bmg`	file	Load a BMG file and add the messages to the macro library; already existing entries are replaced. The macro library is accessed by escape sequence \m{MID} as fallback, if the active file has not already defined the message MID by itself.
	`--makedoc`		Dump infos using MakeDoc syntax. Use `--var name` as variable name of the resulting map.
`-M`	`--max-file-size`	size	This security option defines the maximum file size for input files; larger files are ignored with a warning. The default unit is MiB and the default size is 100 MiB (2 GiB for LTA); that should be enough for standard usage.
	`--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 --n-mipmaps is enabled. --max-mm is a short cut.
	`--max-width`	maxwidth	Define the maximum terminal width (number of columns) for help and some other messages. The default is 120. This option is ignored if --width is set.
	`--mdl`	list	Set global options for MDL processing. To enable MDL patching, use option `--patch-files` and select BRRES files for patching. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables a setting. Each occurrence of the option will only change entered settings and all other settings are untouched. A MDL transformation (controlled by the transformation options) is only done, if at least one of the keywords VECTOR or VERTEX is set. Keyword DEFAULT resets the default settings (VERTEX) and CLEAR disables all. The other allowed keywords are: VECTOR, MATRIX, VERTEX, PARENT, CHILD and LOG.
	`--minimap`		Fix the minimap position in the same way as `wszst MINIMAP --auto`. All other minimap related options are ignored for the minimap processing.
	`--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 --n-mipmaps is enabled. --mm-size is a short cut.
	`--mipmaps`		If reading a source, scan for mipmaps and load them too. For PNG files, files named NAME.mm#.EXT with #=1.. are searched. This is the default. --mm is a short cut.
	`--n-mipmaps`	num	Force the number of mipmaps. Values between 0 and 20 are allowed. Value OFF (default) disables this option. If enabled, options --max-mipmaps and --mipmap-size are ignored. The creation of mipmaps stops if the width or the height of the mipmap becomes 0. --n-mm is a short cut.
	`--next`		Close the current transformation step with all scaling, shifting, rotation and translation options and open a new step with cleared options. On transformation each step is logical done one by one. In real, one total transformation matrix is calculated and used for fast transformations. If option --next is used, the ability for modifying the scale and rotation vectors (not the positions) of different KMP sections is nearly always lost. A warning is printed if this occurs.
	`--no-attrib`		Suppress the output of any BMG attributes if creating BMG text files.
	`--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.
	`--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.
`-N`	`--no-check`		Do not make plausibility checks for KCL and KMP files.
	`--no-colors`		Deactive colorized text. This is the default, if an output file is not a terminal.
	`--no-compress`		Create an uncompressed file instead of a compressed SZS file. The default destination changes to '%P/%N%T'. --noc is a short cut.
	`--no-copy`		Don't copy a file if it was not modified.
	`--no-echo`		Suppress output of @ECHO commands while scanning text files.
	`--no-encode`		Do not encode files before creating an archive. --noenc is a short cut. Option `--no-encode` takes precedence over `--encode-all`, but `--encode-img` takes precedence for images.
`-H`	`--no-header`		Suppress printing of header and footer.
	`--no-mipmaps`		If reading a source, ignore mipmaps. This disables not the creation of mipmaps (see `-n-mipmaps`). --no-mm is a short cut.
	`--no-pager`		Forbid the internal usage of a pager.
`-P`	`--no-param`		Disable parameter support in decoded KMP text files.
	`--no-recurse`		Do not create archives recursively. Normally files in the [create] section of the file 'wszst-setup.txt' are created first. --norec is a short cut.
	`--no-wildcards`		Disable wildcard parsing and use each filename exactly as specified.
`-n`	`--norm`		The uncompressed data will be normalized. See command `NORMALIZE` for more details.
	`--null`		Create a neutral transformation without affecting the coordinates. The only influence is, that the dependent values (like maximum) are re-calculated as if a transformation has taken place.
	`--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. --num is a short cut.
	`--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.
`-o`	`--overwrite`		Overwrite already existing files without warning and ignore option `--number`.
	`--pack`		Create a PACK archive.
	`--parallel`		Tell the tool that it will be called multiple times in parallel. Currently it only has an effect if `--cache` is enabled.
	`--pat`	list	Set global options for PAT processing. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables a setting. Each occurrence of the option will only change entered settings and all other settings are untouched. Keyword DEFAULT resets the default settings and CLEAR disables all. The other allowed keywords are: AUTO, SIMPLE, COMPLEX, BOTH, SILENT and LOG.
	`--patch-bmg`	mode[cond][=param]	This option specifies a BMG patch mode. Some of the modes need a parameter or a file name of a BMG patch file (raw or text BMG), both separated by an equal sign. Modes with required file names are PRINT, REPLACE, INSERT, OVERWRITE, DELETE, MASK, EQUAL and NOTEQUAL. Modes with text parameter are FORMAT, REGEXP and RM-REGEXP. Standalone modes are ID, ID-ALL, UNICODE, RM-ESCAPES, RM-CUPS, CT-COPY, CT-FORCE-COPY, CT-FILL, LE-COPY, LE-FORCE-COPY, LE-FILL, X-COPY, X-FORCE-COPY and X-FILL. Unique abbreviations are allowed. The optional condition COND is either '?MID' or '!MID'. In case of '?MID', the patch is only applied if the message id MID already exists. In case of '!MID', the patch is only applied if the message id MID does not exists. If this option is used multiple times, all patch files will be processed in the entered order.
	`--patch-files`	list	Define, which kind of KMP, KCL and BRRES/MDL files are objects for patching. --pfile is a short cut. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables a setting. Each occurrence of the option will only change entered settings and all other settings are untouched. Keyword DEFAULT resets the default settings (TRACK,LOG) and NONE disables all. The other allowed keywords are: KMP, KCL, OTHER-KCL, ALL-KCL, MODEL, MAP, VRCORN, OTHER-BRRES, ALL-BRRES, TRACK (=KMP,KCL,MODEL,MAP,VRCORN), ALL, LOG and LOG-ALL.
	`--php`		Dump infos using PHP syntax. Use `--var name` as variable name of the resulting object.
	`--pipe`		Use pipe sign instead of spaces to separate columns.
	`--plus`	chars	If a name begins with a plus sign, then all characters up to the first space are recognized as a plus prefix. The first part consists of all the plus signs followed by any other characters. The first character of the second part is used to determine the sort value. If the second part is empty, then the last plus sign is used instead. The higher sorting value is now calculated from the number of plus signs in the first part, the more plus signs, the smaller the value. The first character from the second part determines the lower value. If it is in parameter CHARS then the position determines the value, otherwise the ASCII value to which 500 is added.
`-p`	`--preserve`		Preserve file times (atime+mtime) while converting or copying files.
	`--printf`	format	Add an output line with a formatted string.
	`--pt-dir`	[=mode]	Set one of the `point directory' modes REMOVE (=0), FORCE (=1) or AUTO (default). If --pt-dir is used without parameter, then FORCE is assumed. 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.
	`--purge`		Remove repeated files with same checksum.
`-q`	`--quiet`		Be quiet and print only error messages. Multiple use is possible. Previous use of --verbose is reverted. The impact is command dependent. If set at least three times, almost all error messages will be suppressed.
	`--raw`		Extract BRRES sub file in raw mode and do not adjust string pointers and other offsets.
`-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 (=NONE) deactivates this. If --recurse is used without parameter, then UNLIMITED is assumed. -R does'nt accept a parameter and is a short cut for `--recurse=unlimited`.
	`--ref`	path	Define a reference SZS.
`-r`	`--remove-dest`		Remove already existing files before creating it. If set, `--overwrite` is ignored. --rm-dest is a short cut.
	`--remove-src`		Remove the source file after successful operation. --rm-src is a short cut.
	`--repair-magics`	[=mode]	Control the reparing of missing or wrong magics of files and sub-files by analysing file path and file extension. MODE is one of OFF (default), ANALYZE or REPAIR (default, if set without mode). OFF disables this feature, ANALYZE enables it for analysis only, and REPAIR repairs all magics while reading the files. Keyword FNAME can be appended (separated by a comma) to give filename scanning the highest priority. >>> THE RESULT MAY BE INVALID OUTPUT FILES! <<<
	`--repair-xpflags`	file	Load a KMP file and use it to repair the settings of the extended presence flags, if they are destroyed by another KMP tool. --repxpf is a short cut for this option.
	`--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. --rmai is a short cut.
	`--rm-gobj`	objlist	Remove objects from the KMP section GOBJ. Therefor a comma separated object list with single values like 'a' or ranges like 'a:b' is expected. 'a' and 'b' are numbers, object names (prefixed by 'o$') or any other parser expressions.
	`--rot`	degree[@origin]	Transform the data: Rotate all coordinates and rotation values by the angle 'degree' (is a vector) around the 3 axes. All 3 axes goes through the point 'origin'. If the origin is not set, 0,0,0 is used instead. Each parameter is either a vector expression or a comma separated expression list of coordinates ('x,y,z'). Option --rot is an alternative for `--xrot`, `--yrot` and `--zrot` to define all 3 rotations in one step. Transformations are calculated in the order SCALE, SHIFT, X-ROTATE, Y-ROTATE, Z-ROTATE, TRANSLATE.
	`--round`		Print additional lines with rounded values (to 3 and 2 bytes for floats and 7 and 6 bytes for doubles).
	`--route-options`	[=mode]	MODE is either OFF, AUTO (default) or ON. Without value, ON is used. On mode ON, the new commands $PREV and $NEXT are printed for each group of KMP sections ENPT and ITPT. On mode AUTO, the command is only printed, if any option is set or if parameter SHOW-OPTIONS is >0. On mode OFF, this feature is totally disabled to create KMP text files that are compatible with versions <1.60a. This option exists only for a transition period. Its behaviour will be changed in the future. --ropt is a short cut.
	`--scale`	vector[@origin]	Transform the data: Scale all coordinates and size values by 'vector' relative to the point 'origin'. If the origin is not set, 0,0,0 is used instead. Negative values mirror the coordinates. Each parameter is either a vector expression or a comma separated expression list of coordinates ('x,z' or 'x,y,z'). Transformations are calculated in the order SCALE, SHIFT, ROTATE, TRANSLATE.
	`--sections`		Print in machine readable sections and parameter lines.
	`--set-flags`	flag	Define the flag values (default 0x31f) of the minimap.
	`--set-rot`	vector	Define the rotation values (default 0.0) of the minimap. The parameter is either a vector expression or a comma separated list of coordinates ('x,z' or 'x,y,z').
	`--set-scale`	vector	Define the scale values (default 1.0) of the minimap. The parameter is either a vector expression or a comma separated list of coordinates ('x,z' or 'x,y,z').
	`--set-x`	v1[,v2]	Define 2 values and sort them to define the minimum and maximum x-coordinates of the minimap. If 'v2' is not entered, '-v1' is used as second value.
	`--set-y`	v1[,v2]	Define 2 values and sort them to define the minimum and maximum y-coordinates of the minimap. If 'v2' is not entered, '-v1' is used as second value.
	`--set-z`	v1[,v2]	Define 2 values and sort them to define the minimum and maximum z-coordinates of the minimap. If 'v2' is not entered, '-v1' is used as second value.
	`--sh`		Dump info using SH syntax. Use `--var name` as prefix.
	`--shift`	vector	Transform the data: Add 'vector' to all coordinates. It's simlar to `--translate`, but the addition is done before rotation. The parameter is either a vector expression or a comma separated expression list of coordinates ('x,z' or 'x,y,z'). Transformations are calculated in the order SCALE, SHIFT, ROTATE, TRANSLATE.
`-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.
	`--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 DAISY, DESERT, SHERBET, SHYGUY, STANDARD and MOST. Slot numbers (except '42' and '4.2') and different other track names are also accepted. For some conversions, the auto-add library is needed.
`-S`	`--sort`	mode	Define a sort mode. Allowed keywords are: NONE (default), NAME, OFFSET, U8, PACK, BRRES, BREFT and AUTO
`-s`	`--source`	path	Define a secondary source path (directory/file). The path may contain escape sequences: %Q is replaced by the fully qualified primary source name. %P and %F are replaced by the primary source path or by the filename. %N and %E are replaced by primary source filename without extension or by the source extension. Finally, %T is replaced by the default extension of a virtual destination format. A '?' direct behind '%' in %E and %T conversions avoid that the same extension is used twice in row.
	`--speed-mod`	factor	The speed modifier is a user extensions to change the basic speed of all vehicles. The speed factor itself is stored into KMP:STGI section of a track. If --speed-mod is set to a value >0.0, then the last 2 bytes of the STGI section are patched. The value 0.0 reset these 2 bytes and deactivates the speed modifier.
	`--split`	num	>) is used as a separator. An alternative output format can be defined with the `--printf` option.
	`--strip`		If creating a PNG file, don't add comments about creator and source formats.
	`--szs`		Short cut for `--u8 --yaz0`: Create an U8 archive, if possible, and set the compression method to Yaz0.
`-t`	`--test`		Run in test mode, modify nothing. >>> USE THIS OPTION IF UNSURE! <<<
	`--tform-kmp`	list	Select KMP sections and objects for a transformation. --tkmp is a short cut. The option expects a comma separated list of keywords. Non ambiguous of keywords are allowed and minus signs within keywords are optional (e.g. GOBJS). A minus sign before a keyword disables transformation of the related section or object. Sections are selected by the KMP section names AREA, CAME, CKPT, CNPT, ENPT, GOBJ, ITPT, JGPT, KTPT, MSPT and POTI. Objects are selected by the keywords AREA-POSITION, AREA-ROTATE, AREA-SCALE, CAME-POSITION, CKPT-POSITION, CNPT-POSITION, CNPT-ROTATE, ENPT-POSITION, ENPT-SCALE, GOBJ-POSITION, GOBJ-ROTATE, GOBJ-SCALE, ITPT-POSITION, ITPT-SCALE, JGPT-POSITION, JGPT-ROTATE, KTPT-POSITION, KTPT-ROTATE, MSPT-POSITION, MSPT-ROTATE and POTI-POSITION. The keywords NONE and ALL (default) complete the field.
	`--tform-script`	script	Load the script and execute it by the text parser. Then for each coordinate (2D and 3D), call the macro TRANSFORM after all other transformations. Call it without parameters and set variable $I with a zero based index of all vertices, variable $D to the dimension (2 or 3) and the variable $P to the vector of the current vertex. If the macro returns a vector, it is the new position. For each file, macro BEGIN is called at the beginning and END after processing all points, but only, if the macros are defined. For END, variable $I is set to the number of processed vertices in the current file. Before each macro call, the private and local variables are cleared and only global parameters are permanent. The zero based index is cleared for each new source. The parameters of the macro calls are defined in the local name space.
	`--timing`		Activate the timing of some operations. Logging level 3 activates them too.
	`--tiny`	mode	Set tiny mode to a level between 0 and 7.
	`--title-screen`	dir	Specify a directory from which to search and replace title screens. Title screens only appear in the file 'Title.szs' and there in the sub-directory './title/timg/'. If the replacement file is not found, then search file 'title1.szs' to patch standard files or file 'title2.szs' to patch bokeboke files.
	`--touch`		Mark the minimap as modified to force a new calculation of the translation and inverse matrices.
`-T`	`--tracks`	tracks	Define a new track order. A comma separated list in the format [a=]b or a:=b is expected. 'a' and 'b' are track names or slot numbers. 'a' is the destination slot and 'b' the assigned track. If 'a' is omitted, the next slot is used; this means [a=]b,c,d is possible. Tracks will only be exchanged so that always all tracks are assigned. But if using ':=' the new slots are assigned without exchanging and the old values are lost.
`-x`	`--transform`	list	Convert image formats. A comma separated list with terms is expected. A term have the syntax '[SRC=]DEST'. It means: convert SRC format into DEST format. If SRC= is not set, the destination format is used for all source formats. This makes only sense as last rule. If DEST is empty no transformation is done for the source. Examples: 'TPL' or 'GRAY' or 'BTI.IA8' or 'TPL.I4+I8=IA8,TEX=,CMPR' SRC and DEST are tuples of file, image and palette formats and of 2 more attributes. All parts are optional and separated by points, the order is irrelevant. Allowed file formats are: TPL, TEX, BTI, BREFT-IMG (=BTIMG), PNG (import). Allowed image formats are: I4, I8, IA4, IA8, RGB565 (=R565), RGB5A3 (=R3), RGBA32 (=R32), C4, C8, C14X2, CMPR. Allowed palette formats are: P-IA8 (=P8), P-RGB565 (=P565), P-RGB5A3 (=P3). Attributtes are PALETTE, NO-PALETTE, GRAY, COLOR, ALPHA and NO-ALPHA. 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.
	`--translate`	vector	Transform the data: Add 'vector' to all coordinates. It's simlar to `--shift`, but the addition is done after rotation. The parameter is either a vector expression or a comma separated expression list of coordinates ('x,z' or 'x,y,z'). --trans is a short cut. Transformations are calculated in the order SCALE, SHIFT, ROTATE, TRANSLATE.
	`--tri-area`	EXPR	Define the minimal area size of KCL triangles. The intention is to ignore triangles that are generally to small. EXPR is a floating point number or expression. Triangles are invalidated if their area size is smaller than EXPR. The test is executed after reading files, after transformations, and after calculating normals and lengths. Values between 0.01 and 4.0 are recommended. The careful value 1.0 is used as default. Value 0 disables this filter functionality.
	`--tri-height`	EXPR	Define the minimal height of KCL triangles. The intention is to ignore deformed triangles (very slim, but long). EXPR is a floating point number or expression. Triangles are invalidated if at least 1 of the 3 heights is smaller than EXPR. The test is executed after reading files, after transformations, and after calculating normals and lengths. Values between 0.01 and 2.0 are recommended. The careful value 1.0 is used as default. Value 0 disables this filter functionality. --tri-ht is an alternative name for the option.
	`--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 'wszst-setup.txt' has no other definition. The default compression mode is set to Yaz0 (see `--yaz0`).
	`--ui-source`	dir	This option affects options `--le-menu` and `--9laps`. If subfiles are to be exchanged in UI files, the files are first searched for in the specified directory. The internal files are only used if the file was not found.
`-u`	`--update`		Update only existing files and don't create new files. If set, `--overwrite` and `--remove-dest` are ignored.
	`--var`	varname	Use VARNAME as variable name or prefix on script output. The default value is 'res' for variables and 'res_' as prefix.
`-v`	`--verbose`		Be verbose and print more progress information. Multiple use is possible. Previous use of --quiet is reverted. The impact is command dependent.
	`--verify`		Calculate the checksum and compare the filename and return exit status (0=valid, 2=differ). The result is valid, if the checksum is found with a leading and a following point or minus sign. If `--quiet` is set, error messages are suppressed.
`-V`	`--version`		Stop parsing the command line, print a version info and exit.
`-W`	`--warn`	list	Enable or disable warnings. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables a warning. Each occurrence of the option will only change entered warning and all other warnings are untouched. Keyword DEFAULT resets the default settings, OFF disables and ALL enables all. The other allowed keywords are: INVALID-OFFSET.
	`--wbz`		Short cut for `--wu8 --bz`: Create a WU8 archive, if possible, and set the compression method to BZ.
	`--width`	width	Define the terminal width (number of columns) for help and some other messages and disable the automatic detection of the terminal width.
	`--wim0`	[=mode]	MODE is either OFF, AUTO (default) or ON. Without value, ON is used. If mode is ON, a KMP section called WIM0 is added on binary KMP creation. The sections contains information for Wiimms tools. If mode is OFF, this feature is totally disabled. If mode is not AUTO, KMP parameter KMP-WIM0 is overridden.
	`--wlz`		Short cut for `--wu8 --lz`: Create a WU8 archive, if possible, and set the compression method to LZ.
	`--wu8`		Create a WU8 archive, if possible. If the source is an U8 archive, convert it to a WU8 archive.
	`--x-escapes`		Use \x{} escapes instead of \z{} escapes.
	`--xcenter`		Center the minimap in x-direction. This is done after AUTO and SET, but before SCALE and SHIFT.
	`--xhelp`		Stop parsing the command line and print a help message with all commands included. Exit after printing.
	`--xrot`	degree[@origin]	Transform the data: Rotate all coordinates and rotation values by the angle 'degree' around the x-axis, that goes through the point 'origin'. If the origin is not set, 0,0,0 is used instead. Each parameter is either a vector expression or a comma separated expression list of coordinates ('y,z' or 'x,y,z'). Transformations are calculated in the order SCALE, SHIFT, X-ROTATE, Y-ROTATE, Z-ROTATE, TRANSLATE.
	`--xss`	x1old,x1new,x2old,x2new	--xss (x-scale-shift) calculates the X values of `--scale` and `--shift`, so that old values are transformed to the new values. The parameters are numbers or expression.
	`--xyz`		If creating a compressed file, force XYZ compression (an experimental Yaz0 variant).
	`--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'.
	`--ybz`		If creating a compressed file, force archive format U8 with YBZ compression (YAZ0 file header, but BZIP2 compression). Therefore it is a short cut for `--u8 --cybz`.
	`--ycenter`		Center the minimap in y-direction. This is done after AUTO and SET, but before SCALE and SHIFT.
	`--ylz`		If creating a compressed file, force archive format U8 with YLZ compression (YAZ0 file header, but LZMA compression). Therefore it is a short cut for `--u8 --cylz`.
	`--ypos`	pos	This option defines an Y position for KMP:CKPT transformations. It has only impact to X and Z rotations (Options `--xrot` and `--zrot`). If not set, the mean y of the active rotation origins are used.
	`--yrot`	degree[@origin]	Transform the data: Rotate all coordinates and rotation values by the angle 'degree' around the x-axis, that goes through the point 'origin'. If the origin is not set, 0,0,0 is used instead. This is a horizontal counterclockwise rotation and the old option name --hrot can also used. Each parameter is either a vector expression or a comma separated expression list of coordinates ('x,z' or 'x,y,z'). Transformations are calculated in the order SCALE, SHIFT, X-ROTATE, Y-ROTATE, Z-ROTATE, TRANSLATE.
	`--yss`	y1old,y1new,y2old,y2new	--yss (y-scale-shift) calculates the Y values of `--scale` and `--shift`, so that old values are transformed to the new values. The parameters are numbers or expression.
	`--zcenter`		Center the minimap in z-direction. This is done after AUTO and SET, but before SCALE and SHIFT.
`-z`	`--zero`		This option affects the exit status of the programs. Instead of an exit status, the value 0 is returned for OK. This happens for notices (`-v`, status<15), warnings (`-vv`, status<29), errors (`-vvv`, status<115) and fatal errors (`-vvvv`). The exit status for INTERRUPT (112) is never replaced.
	`--zrot`	degree[@origin]	Transform the data: Rotate all coordinates and rotation values by the angle 'degree' around the z-axis, that goes through the point 'origin'. If the origin is not set, 0,0,0 is used instead. Each parameter is either a vector expression or a comma separated expression list of coordinates ('x,y' or 'x,y,z'). Transformations are calculated in the order SCALE, SHIFT, X-ROTATE, Y-ROTATE, Z-ROTATE, TRANSLATE.
	`--zss`	z1old,z1new,z2old,z2new	--zss (z-scale-shift) calculates the Z values of `--scale` and `--shift`, so that old values are transformed to the new values. The parameters are numbers or expression.

5. Wrapper

From the beginning wszst was able to decode and encode BMG, KMP, images and more file types. It is simply a part of the SZS extraction and creation process. So it contains the complete functionality of all tools.

As of version 1.38 the tool wszst is also a wrapper to all other tools with their interfaces. So technically only one image (wszst) is needed to have the functionality of all tools. The size of wszst growed about 300-400k. Just copy and rename tool wszst for example to wlect and it acts like wlect.

The advantage is, that only one tool is needed. And this merged tool needs much less disk space then all tools together.

The wrapper itself is implemented on a way that it is not noticeable in normal operation and without knowledge of it. It is noticeable only active when it is addressed with special keywords as very first parameter.

5.1 Tool activation

The different built-in tools can be activated by a parameter, by renaming the main application (standard name wszst), or by linking (soft and hard) to the main application.

If the main application (generally wszst) is started, it enters wrapper mode and tries to find out the tool to start:

If the very first parameter (before any option or other parameters) is 'wrapper' (exact 7 characters, case ignored), then the special wrapper mode is activated and a help is printed or a wrapper subcommand is executed.
Example: wszst wrapper help
See »wrapper commands« for more details.
If the very first parameter is one of the tools name (exact 5 characters, case ignored), then the parameter is removed from the command line and the named tool is started as usual.
Example:
```
  $ wszst wbmgt version
  wbmgt: Wiimms BMG Tool v1.38a r6056 x86_64 - Dirk Clemens - 2015-02-27
```
This mechanism can also be used to create wrapper shell scripts. A not so simple bash example for wkmpt:
```
  #!/usr/bin/env bash
  "$(dirname "$BASH_SOURCE")/wszst" wkmpt "$@"
```
If both steps above failed, then the file name of the tool is analyzed. Again case is ignored. If the first letter is 'w', then it is skipped. Then the next 3 characters are analyzed. If they equal to the middle 3 characters of the tool names (szs, bmg, img, kmp, ...), then the related tool is started.
This methods works for renamed files and for hard and soft links pointing to the main application.
Examples for creating links:
```
  ln -s wszst wkmpt  # softlink for the KMP tool (wkmpt)
  ln -s wszst kmp    # softlink for the KMP tool, but with shorter name
  ln wszst wkclt     # hardlink to the KCL tool (wkclt)
  ln wszst ctcode    # hardlink to the CTC tool (wctct) with other name
```
The wrapper commands can create the links for you.
Otherwise automatic detection failed and the wrapper starts wszst. This is transparent to the old behavior: If calling wszst with the usual options and parameters, it works like ever.

5.2 Wrapper commands

If the very first parameter 'wrapper' (exact 7 characters, case ignored, before any other parameter or option), then and only then the wrapper support mode with own commands is activated.

The wrapper support mode has a very easy interface. Without parameters or with at least 1 unknown parameter or with an invalid combination of parameters a simple help page is printed.

Read the help page for more information:


Wrapper commands:

   WRAPPER HELP
   WRAPPER CREATE    [QUIET] HARDLINKS|SOFTLINKS|BESTLINKS|CYGWIN|SHELL|BASH
   WRAPPER OVERWRITE [QUIET] HARDLINKS|SOFTLINKS|BESTLINKS|CYGWIN|SHELL|BASH

   H[ELP]      : Print this help and exit.
   CRE[ATE]    : Create links or scripts, but don't overwrite.
   OVER[WRITE] : Create links or scripts and remove existing files before.
   HARD[LINKS] : Create hard links to the main program.
   SOFT[LINKS] : Create soft links to the main program.
   BEST[LINKS] : For Cygwin same as HARDLINKS, for all other same as SOFTLINKS.
   CYG[WIN]    : Create softlinks for Cygwin (plain files with special content).
   SH[ELL]     : Create simple `sh| scripts assuming the main program is in PATH.
   BASH        : Create `bash| scripts with run time path detection.
   Q[UIET]     : Option to suppress creation messages.

A SHELL script for wbmgt looks like this:

#!/bin/sh
wszst wbmgt "$@"

The same as BASH script:

#!/usr/bin/env bash
"$(dirname "$BASH_SOURCE")/wszst" wbmgt "$@"