diff options
| author | louist103 <35883445+louist103@users.noreply.github.com> | 2021-10-22 14:02:34 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-22 20:02:34 +0200 |
| commit | 42b8cec3d02de005b49b80a373517ee641a1c00a (patch) | |
| tree | 57f47982114997a47710d64ad7862b52ba39b54c /tools/ZAPD/docs | |
| parent | ceb571423db37b87336bff905078aabc6c627572 (diff) | |
Zapd hotfix (#1009)
* remove fake match
* git subrepo pull --force tools/ZAPD
subrepo:
subdir: "tools/ZAPD"
merged: "4f7b8393e"
upstream:
origin: "https://github.com/zeldaret/ZAPD.git"
branch: "master"
commit: "4f7b8393e"
git-subrepo:
version: "0.4.3"
origin: "https://github.com/ingydotnet/git-subrepo.git"
commit: "2f68596"
Diffstat (limited to 'tools/ZAPD/docs')
| -rw-r--r-- | tools/ZAPD/docs/zapd_extraction_xml_reference.md | 23 |
1 files changed, 22 insertions, 1 deletions
diff --git a/tools/ZAPD/docs/zapd_extraction_xml_reference.md b/tools/ZAPD/docs/zapd_extraction_xml_reference.md index 818d9f1c7..06b95bb57 100644 --- a/tools/ZAPD/docs/zapd_extraction_xml_reference.md +++ b/tools/ZAPD/docs/zapd_extraction_xml_reference.md @@ -98,7 +98,7 @@ This table summarizes if the asset will be marked `static` (✅) or not (❌) - `Name`: Required. The name of the file in `baserom/` which will be extracted. - `OutName`: Optional. The output name of the generated C source file. Defaults to the value passed to `Name`. - - `Segment`: Required. This is the segment number of the current file. Expects a decimal number, usually 6 if it is an object, or 128 for overlays (It's kinda a whacky hack to get around of the `0x80` addresses). + - `Segment`: Optional. This is the segment number of the current file. Expects a decimal number between 0 and 15 inclusive, usually 6 if it is an object. If not specified, the file will use VRAM instead of segmented addresses. - `BaseAddress`: Optional. RAM address of the file. Expects a hex number (with `0x` prefix). Default value: `0`. - `RangeStart`: Optional. File offset where the extraction will begin. Hex. Default value: `0x000000000`. - `RangeEnd`: Optional. File offset where the extraction will end. Hex. Default value: `0xFFFFFFFF`. @@ -106,6 +106,27 @@ This table summarizes if the asset will be marked `static` (✅) or not (❌) ------------------------- +### ExternalFile + +Allows ZAPD to map segmented addresses to variables declared in other files by using its XML. + +It is useful for objects that use variables from `gameplay_keep`, `gameplay_dangeon_keep`, `gameplay_field_keep`, etc. + +This tag can be used in the global `config.xml` file. + +- Example of this tag: + +```xml +<ExternalFile XmlPath="objects/gameplay_keep.xml" OutPath="objects/gameplay_keep/"/> +``` + +- Attributes: + + - `XmlPath`: Required. The path of the XML, relative to the value set by `ExternalXMLFolder` in the configuration file. + - `OutPath`: Required. The path were the header for the corresponding external file is. It is used to `#include` it in the generated `.c` file. + +------------------------- + ### Texture Textures are extracted as `.png` files. |