prevnext   » SZS: Wiimms SZS Tools » wszst: Wiimms SZS Tool » wszst autoadd

wszst autoadd

Add files to the main auto-add archive for future use of option --auto-add. If 'source' is a directory, all standard track and arena file names are searched in it. Without any source files an archive status is printed.

Try »wszst AUTOADD ./path_to/Race/Course/« to add all supported files.

Contents

1.   Syntax

wszst AUTOADD [source]...

2.   Options

Options
Option Param Description
-i --ignore Ignore non existing source files without warning.
-q --quiet If set, suppress logging.
-v --verbose If set, list all missed files of the current auto-add archive after adding the adding operation. If set twice, then additionally list first all already existing files in the current auto-add archive.
-d --dest path Define a destination directory as current auto-add archive. The default is the standard auto-add path. Try AUTOADD without sources to view the path.
-D --DEST path Like --dest, but create the directory path automatically.
-o --overwrite Overwrite already existing files instead of only adding new files to the auto-add archive.
-r --remove-dest Remove already existing files before creating it. If set, --overwrite is ignored. --rm-dest is a short cut.
-p --preserve Preserve file times (atime+mtime) while converting or copying files.

3.   Concept

Autoadd is a concept for automated addition of missed subfiles into a track szs file. Therefor the tool wszst have an internal object database und knows which object needs which subfile. After analyzing the global objects of the KMP and the file list of the SZS, wszst knows, which subfiles are missed. If the user set the option --auto-add (or shorter --aadd), the missed files are added automatically by copying it from Autoadd Archive.

The user must create this Autoadd Archive only once before the first use of option --auto-add.

4.   Autoadd Archive

The Autoadd Archive is only a collection of files extracted from Nintendos original tracks (files in ./Race/Course/). The supported files are all global object (KMP/GOBJ) related files.

Use the command »wszst AUTOADD« to manage the Autoadd Archive. To find the archive directory, just type »wszst AUTOADD« without options. The output will something like this:

# wszst autoadd

CURRENT AUTO-ADD PATH: /usr/local/share/szs/auto-add/
       SEARCH PATH[0]: /usr/local/share/szs/auto-add
       SEARCH PATH[1]: ./auto-add
The first line (CURRENT AUTO-ADD PATH) is the place of the standard Autoadd Archive, but the tools can search the missed files in more directories. The ./auto-add subdirectory in the current working directory is one of them.

4.1   Create the Archive

To create the Autoadd Archive, the user must have a directory with all Nintendos original track files. It is the complete DVD directory ./Race/Course/. To create the archive, use:
wszst AUTOADD ./path_to/Race/Course/
This command will search the entered directory for all track and arena files and extract all needed files, that not already exist. Add option ---overwrite to overwrite existing files.

4.2   Test the Archive

Use the command »wszst autoadd -v« to verify the Autoadd Archive.

If the LIST OF MISSED FILES is empty, the Autoadd Archive is complete.

5.   Auto add files

If option --auto-add is set and a SZS track file is created, then all missed files are searched in the Autoadd Archive and added to the track file. Therefor the KMP file is scanned for global objects. wszst have an internal database and knows, which sub files are needed for which global object.

Command »wszst CHECK« will give you a report about missing files.

If you want to add missing files to an already existing SZS, you must extract and re create the SZS file, because --auto-add is only supported while creating a track file.
Example:

wszst extract mytrack.szs
wszst create mytrack.d --dest newtrack.szs --auto-add

Option »--slot mode« will also use the Autoadd Archive to insert file that are needded for the conversion.

5.1   --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'; try »wszst AUTOADD« to view them. Command »wszst AUTOADD« may also create an auto-add database. --aadd is a short cut.