Executable: Difference between revisions - ZeldaMods (Breath of the Wild)

(7 intermediate revisions by one other user not shown)

Line 19:

== Symbols ==

Unfortunately, release versions of ''The Legend of Zelda: Breath of the Wild'' are stripped and have absolutely no debugging symbols. This has been verified for Switch 1.0.0, Wii U 1.5.0 ~~and~~ Switch 1.5.0.

Unfortunately, release versions of ''The Legend of Zelda: Breath of the Wild'' are stripped and have absolutely no debugging symbols. This has been verified for Switch 1.0.0, Wii U 1.5.0, Switch 1.5.0, Switch 1.6.0 and Switch RID_Demo.

The Switch 1.5.0 ~~executable~~ only ~~has~~ some RTTI data for UI classes.

The Switch 1.5.0 and 1.6.0 executables only have some RTTI data for UI classes. This is likely also the case for all older versions.

However, the game uses lots of [[Software libraries|software libraries]], some of which are included in games that do ship with complete symbols such as ''Super Mario Odyssey''. BotW seems to have been compiled at a higher optimisation level that causes unused functions to be fully removed.

Line 262:

</pre>

=== Leftover debug tools ===

=== Leftover debug or development tools ===

==== ActorCapture ====

See [[ActorCapture]] for more information.

The resource factory and resource classes are still present in release builds, but no ActorCapture parameter files are included in the ROM.

==== EventPatroller ====

Used to generate movies (prerendered cutscenes) for event flows. Receives orders via HostIO (in BYML format) in <code>%UKING_ROOT%/../workdir/EventPatroller/order.byml</code> and writes:

* A YAML report containing frame-by-frame data with camera position, actor information, etc. Written to <code>%s/report.yml</code> % (name).

* Screenshots for the entire event (maximum 18000 frames) captured using agl::utl::ScreenshotMgr, and written to <code>%s/%05d.tga</code> % (name, frame).

Throughout the execution of the order, <code>%%KSYS_ROOT%%/tools/EventPatroller/ChangeStatus.bat</code> is spawned to update the order status on the host computer.

EventPatroller can apparently make use of Havok script files (hks) in dev builds<ref><code>script_name</code> (in the order data) is a path to a hks file.</ref>. However, all script-related code is stubbed in release builds and both the <code>hks</code> and <code>lua</code> resource factories are unused.

==== Placement ====

The <code>bplacement</code> resource factory is stubbed in release builds. The associated resource class is also stubbed. It is unknown what Placement files would have contained. (Configuration for the [[PlacementMgr]]?)

Given the small resource size, it is likely that bplacement files are not [[AAMP]] resources but [[BYML]]s.

==== Demo ROM types ====

The game calls <code>sead::EnvUtil::getRomType()</code> to get the ROM type. The result is printed to a debug log along with SD card, revision and AoC (DLC) information.

Line 273:

Line 293:

* Anything else is treated as "Normal".

~~The release build crashes if~~ the ROM type is set to Show_2017_1st or RID_Demo~~, presumably because these types activate code paths that require a global debug heap which never gets initialised~~ in release ~~versions~~.

If the ROM type is set to Show_2017_1st or RID_Demo in release build, the title will change to the demo menu.

==== ErrorViewer and Stage Select ====

@@ Line 19: / Line 19: @@
 == Symbols ==
-Unfortunately, release versions of ''The Legend of Zelda: Breath of the Wild'' are stripped and have absolutely no debugging symbols. This has been verified for Switch 1.0.0, Wii U 1.5.0 and Switch 1.5.0.
+Unfortunately, release versions of ''The Legend of Zelda: Breath of the Wild'' are stripped and have absolutely no debugging symbols. This has been verified for Switch 1.0.0, Wii U 1.5.0, Switch 1.5.0, Switch 1.6.0 and Switch RID_Demo.
-The Switch 1.5.0 executable only has some RTTI data for UI classes.
+The Switch 1.5.0 and 1.6.0 executables only have some RTTI data for UI classes. This is likely also the case for all older versions.
 However, the game uses lots of [[Software libraries|software libraries]], some of which are included in games that do ship with complete symbols such as ''Super Mario Odyssey''. BotW seems to have been compiled at a higher optimisation level that causes unused functions to be fully removed.
@@ Line 262: / Line 262: @@
 </pre>
-=== Leftover debug tools ===
+=== Leftover debug or development tools ===
+==== ActorCapture ====
+See [[ActorCapture]] for more information.
+The resource factory and resource classes are still present in release builds, but no ActorCapture parameter files are included in the ROM.
+==== EventPatroller ====
+Used to generate movies (prerendered cutscenes) for event flows. Receives orders via HostIO (in BYML format) in <code>%UKING_ROOT%/../workdir/EventPatroller/order.byml</code> and writes:
+* A YAML report containing frame-by-frame data with camera position, actor information, etc. Written to <code>%s/report.yml</code> % (name).
+* Screenshots for the entire event (maximum 18000 frames) captured using agl::utl::ScreenshotMgr, and written to <code>%s/%05d.tga</code> % (name, frame).
+Throughout the execution of the order, <code>%%KSYS_ROOT%%/tools/EventPatroller/ChangeStatus.bat</code> is spawned to update the order status on the host computer.
+EventPatroller can apparently make use of Havok script files (hks) in dev builds<ref><code>script_name</code> (in the order data) is a path to a hks file.</ref>. However, all script-related code is stubbed in release builds and both the <code>hks</code> and <code>lua</code> resource factories are unused.
+==== Placement ====
+The <code>bplacement</code> resource factory is stubbed in release builds. The associated resource class is also stubbed. It is unknown what Placement files would have contained. (Configuration for the [[PlacementMgr]]?)
+Given the small resource size, it is likely that bplacement files are not [[AAMP]] resources but [[BYML]]s.
 ==== Demo ROM types ====
 The game calls <code>sead::EnvUtil::getRomType()</code> to get the ROM type. The result is printed to a debug log along with SD card, revision and AoC (DLC) information.
@@ Line 273: / Line 293: @@
 * Anything else is treated as "Normal".
-The release build crashes if the ROM type is set to Show_2017_1st or RID_Demo, presumably because these types activate code paths that require a global debug heap which never gets initialised in release versions.
+If the ROM type is set to Show_2017_1st or RID_Demo in release build, the title will change to the demo menu.
 ==== ErrorViewer and Stage Select ====