prevnext   » SZS: Wiimms SZS Tools » wbmgt: Wiimms BMG Tool » wbmgt patch

wbmgt patch

Patch the entered files by using the patch list specified by option --patch-bmg. The coding of the source files is not changed. The default destination is '%P/%F'.

Use »wszst patch --patch-bmg ...« to patch BMG files within a SZS file.

Contents

1.   Syntax

wbmgt PATCH [source]...

2.   Options

Options
Option Param Description
-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.
-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$'.
-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 maximal existing index+1. --num is a short cut.
-r --remove-dest Remove already existing files before creating it. If set, --overwrite is ignored. --rm-dest is a short cut.
-u --update Create only files that do not exist. Already existing files are ignored without warning. If set, --overwrite and --remove-dest are ignored.
-p --preserve Preserve file times (atime+mtime) while converting or copying files.
-H --no-header Suppress the syntax information section in BMG text files.
-B --brief If set, the information header in decoded text files is suppressed (for historical reasons same as --no-header). If set at least twice, all comments are suppressed and the output is packed without empty lines. If set 3 times, the #BMG-TXT file indentification is also suppressed.
-1 --single-line If set, don't print continuation lines for BMG text output. If set twice, print only single text lines but not value lines.
--no-bmg-color 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.
-l --long Print long numeric message IDs instead of alternative message names like Txx, Uxx or Mxx.
-X --export Enable the export modus and create small and machine readable text files for easy post processing. The option works similar like -HBl11 for BMG text files.
-i --ignore Ignore non existing source files without warning.
-P --patch-bmg mode=file This option specifies a BMG patch mode. Some of the modes need a file name of a 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 NONEQUAL. Standalone modes are ID, ID-ALL, CT-COPY and CT-FILL. Unique abbreviations are allowed. If this option is used multiple times, all patch files will be processed in the entered order. --patch is a short cut.
--msg list If this option is set, the BMG messages are filtered by this list. Only enabled messages are exported to the ouput 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, CUPS, TRACKS, ARENAS, CHAT, CTCODE or ALL. If an element is preceeded by a minus sign, it is removed from the list.

--align size Define an align value for the sub sections in the archive. The value must be a power of 2 and the default value is 32 (0x20)

3.   Description

4.   -P mode=file   |   --patch-bmg mode=file

This option specifies a BMG patch mode. Some of the modes need a file name of a 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 NONEQUAL. Standalone modes are ID, ID-ALL, CT-COPY and CT-FILL. Unique abbreviations are allowed. If this option is used multiple times, all patch files will be processed in the entered order. --patch is a short cut.
For each appereance of this option, the mode and the patch file combination is appended to an internal patching list. All source files are patched by all files of this patching list in the entered order.

The mode describes how to patch the source file by the current patch file. wbmgt supports 8 patching modes with source files, abbreviations are allowed:

Patching Modes with source files
Mode Copy ... if
only
in
source
only
in
patch
source
!=
patch
source
==
patch
REPLACE source patch both
PRINT source print print
INSERT source patch source both
OVERWRITE source patch patch both
DELETE source
MASK source both
EQUAL both
NOT-EQUAL source

There are some more modes, with do not use any source file:

ID
Insert into all non empty messages the message id.
ID-ALL
Insert into all messages the message id.
CT-COPY
Copy all standard track and arena name messages to MID 4000–4029. This is a CT-CODE support.
CT-FILL
Create non existent messages in the range 4000-4100 if at least one other track name message exists. This is a CT-CODE support.

4.1   Mode REPLACE

The patch file will only replace strings that are already defined in the source. Other strings are ignored.

This is the standard usage.

4.2   Mode PRINT

The patch file will only change (not replace) strings that are already defined in the source. Other strings are ignored.

The new string is created like a printf function call. Is a escape sequence is found, it is replaced by its (calculated content). The format of escape sequences is one of:

'%' CONV_LETTER
'%' LEN CONV_LETTER
'%' BEGIN ':' END CONV_LETTER
An escape sequence starts always with a percent sign and ends with a conversion letter (CONV_LETTER). In between a length (LEN) or an index range (BEGIN:END) can be specified to select a sub string.

The following conversion letters are supported:

%s or %S
Copy the source string.
%i
Insert the hexadecimal message ID.
%I
Insert the hexadecimal message ID with at least 4 digits.
%n or %N
Insert the name of the source file. This helps to identify the relevant source SZS.

4.3   Mode INSERT

Insert only new strings into the source. Already existing strings are untouched.

4.4   Mode OVERWRITE

All strings of the patch file will overwrite the string in the source file. Non exisintg strings are created.

4.5   Mode DELETE

Remove strings from the source that are defined in the patch file. The content of the single string in the patch file is ignored.

4.6   Mode MASK

Remove strings from the source that are not defined in the patch file. The content of the single string in the patch file is ignored.

4.7   Mode EQUAL

Remove strings from the source that are not defined in the patch file or that are different. Leave equal strings only.

4.8   Mode NOT-EQUAL

Remove strings from the source that are defined in the patch file and that are equal.

Command reference

»wbmgt cat«,   »wbmgt decode«,   »wbmgt diff«,   »wbmgt encode«,   »wbmgt list«,   »wbmgt mix«,   »wbmgt patch«,   »wszst check«,   »wszst compress«,   »wszst copy«,   »wszst create«,   »wszst decompress«,   »wszst encode«,   »wszst extract«,   »wszst kcl«,   »wszst kmp«,   »wszst normalize«,   »wszst patch«,   »wszst slots«,   »wszst update«,   »wszst xall«,   »wszst xdecode«,   »wszst xexport«.

4.9   Mode ID

The mode ID is a standalone mode without filename.

Each defined and non empty message is prefixed by a letter representing the SZS filename (examples: T=Titel, E=Event, S=MenuSingle, ...) and the message id as hex number and a colon.

Example: 'Hello' of Event_E.szs becomes 'E1194:Hello'.

This mode helps to identify the messages while running the game.

4.10   Mode ID-ALL

The mode ID-ALL is a standalone mode without filename.

Each defined message including empty messages is prefixed by a letter representing the SZS filename (examples: T=Titel, E=Event, S=MenuSingle, ...) and the message id as hex number and a colon.

Example: 'Hello' of Event_E.szs becomes 'E1194:Hello' and an empty message becomes 'E1200'.

4.11   Mode CT-COPY

The mode CT-COPY is a standalone mode without filename and supports the CT-CODE extension of Wiimms SZS Tools.

All defined track and arena name message are copied to the messages in the MID range 4000–4029, but only, if the destioanton message is not defined or empty.

4.12   Mode CT-FILL

The mode CT-FILL is a standalone mode without filename and supports the CT-CODE extension of Wiimms SZS Tools.

All messages of MID range 4000–40ff, that are not defined or empty, will be defined and set to the message 'Slot xx', where xx is the right 2 letters of the message id. Additionally, message 4100 is set to '???', if not already defined or empty.

The definitions will only be done, if at least one track or arena name message is alrrady defined.

5.   --msg list

If this option is set, the BMG messages are filtered by this list. Only enabled messages are exported to the ouput 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, CUPS, TRACKS, ARENAS, CHAT, CTCODE or ALL. If an element is preceeded by a minus sign, it is removed from the list.
???