Help:Updating the RSTB - Revision history

imported>Ginger: /* Updated Estimating resource sizes for BFRES (Wii U only) - texture estimates*/

2019-08-01T08:55:15Z

Updated Estimating resource sizes for BFRES (Wii U only) - texture estimates

← Older revision		Revision as of 08:55, 1 August 2019
Line 105:		Line 105:
	* If your texture BFRES is less than 100KB, your RSTB entry should be 200% of your BFRES file size.		* If your texture BFRES is less than 100KB, your RSTB entry should be 200% of your BFRES file size.
	* If your texture BFRES is greater than 100KB but less than 500KB, your RSTB entry should be 110% of your BFRES file size.		* If your texture BFRES is greater than 100KB but less than 500KB, your RSTB entry should be 110% of your BFRES file size.
	* If your texture BFRES is greater than 500KB, your RSTB entry should be ~~101~~% of your BFRES file size.		* If your texture BFRES is greater than 500KB, your RSTB entry should be 105% of your BFRES file size.

	[[File:Tex2rstb.png\|thumb\|RSTB size analysis for BFRES tex2 texture files. Y-axis: ratio, X-axis: BFRES file size, dot size: RSTB entry size.]]		[[File:Tex2rstb.png\|thumb\|RSTB size analysis for BFRES tex2 texture files. Y-axis: ratio, X-axis: BFRES file size, dot size: RSTB entry size.]]

imported>NiceneNerd: Moved BFRES RSTB estimation to this page

2019-08-01T05:04:46Z

Moved BFRES RSTB estimation to this page

@@ Line 84: / Line 84: @@
 === Why deleting entries is sometimes necessary ===
-Currently, rstbtool cannot calculate sizes for complex resources (e.g. [[bfres]], [[AAMP]] files). The workaround is to delete their RSTB entry: doing that causes the game to allocate a lot of memory, enough to ensure that the resource can be loaded correctly. This wastes a significant amount of memory, but it is a quick and simple workaround that is perfectly fine if you only do it for a limited number of resources (100 should be safe).
+Currently, rstbtool cannot calculate sizes for complex resources (e.g. [[bfres]], [[AAMP]] files). The workaround is to delete their RSTB entry: doing that causes the game to allocate a lot of memory, enough to ensure that the resource can be loaded correctly. This wastes a significant amount of memory, but it is a quick and simple workaround that is perfectly fine if you only do it for a limited number of resources (100 should be safe). Note that for BFRES files, it is possible to generate a workable estimate for an appropriate RSTB value using the method below instead of deleting entries.
 [[Category:Guides]]

imported>NiceneNerd: Undo revision 7727 by NiceneNerd (talk)

2019-07-26T14:26:47Z

Undo revision 7727 by NiceneNerd (talk)

← Older revision		Revision as of 14:26, 26 July 2019
Line 59:		Line 59:
	* [path to RSTB] and [resource path]: see above.		* [path to RSTB] and [resource path]: see above.
	* If you're editing a Wii U RSTB, add <code> -b</code> (Big Endian) at the end of the line.		* If you're editing a Wii U RSTB, add <code> -b</code> (Big Endian) at the end of the line.


	{{ex\|text=For Switch:		{{ex\|text=For Switch:

imported>NiceneNerd: /* Using rstbtool */

2019-07-26T14:23:32Z

Using rstbtool

← Older revision		Revision as of 14:23, 26 July 2019
Line 59:		Line 59:
	* [path to RSTB] and [resource path]: see above.		* [path to RSTB] and [resource path]: see above.
	* If you're editing a Wii U RSTB, add <code> -b</code> (Big Endian) at the end of the line.		* If you're editing a Wii U RSTB, add <code> -b</code> (Big Endian) at the end of the line.


	{{ex\|text=For Switch:		{{ex\|text=For Switch:

imported>NiceneNerd: /* Using Wild Bits */

2019-07-26T14:23:17Z

Using Wild Bits

← Older revision		Revision as of 14:23, 26 July 2019
Line 75:		Line 75:
	# Select the entry you wish to delete and click "Delete."		# Select the entry you wish to delete and click "Delete."
	# Save the RSTB or modify more entries.		# Save the RSTB or modify more entries.


	{{warning\|text='''Deleting entries does not always work!'''		{{warning\|text='''Deleting entries does not always work!'''

imported>NiceneNerd: Added instructions for deleting RSTB entries with Wild Bits

2019-07-26T14:23:05Z

Added instructions for deleting RSTB entries with Wild Bits

← Older revision		Revision as of 14:23, 26 July 2019
Line 51:		Line 51:

	== Deleting entries ==		== Deleting entries ==

			=== Using rstbtool ===
	Run the following command {{CLI help}}:		Run the following command {{CLI help}}:
	<pre>		<pre>
Line 67:		Line 69:
	rstbtool -b botw/System/Resource/ResourceSizeTable.product.srsizetable del Actor/GeneralParamList/Item_Fruit_A.bgparamlist		rstbtool -b botw/System/Resource/ResourceSizeTable.product.srsizetable del Actor/GeneralParamList/Item_Fruit_A.bgparamlist
	</pre>}}		</pre>}}

			=== Using Wild Bits ===
			Open Wild Bits from the command line using the <code>wildbits</code> command. {{CLI help}} Then:
			# Open the RSTB file in Wild Bits.
			# Select the entry you wish to delete and click "Delete."
			# Save the RSTB or modify more entries.

	{{warning\|text='''Deleting entries does not always work!'''		{{warning\|text='''Deleting entries does not always work!'''

imported>NiceneNerd: Added instructions for updating RSTB entries with Wild Bits

2019-07-26T14:19:01Z

Added instructions for updating RSTB entries with Wild Bits

← Older revision		Revision as of 14:19, 26 July 2019
Line 15:		Line 15:

	== Updating entries ==		== Updating entries ==

			=== Using rstbtool ===
	Open a terminal / command prompt and run the following command {{CLI help}}		Open a terminal / command prompt and run the following command {{CLI help}}
	<pre>		<pre>
Line 37:		Line 39:

	If everything goes well, no errors will be shown on the screen. If rstbtool says it is unable to calculate the resource size, then read the following section.		If everything goes well, no errors will be shown on the screen. If rstbtool says it is unable to calculate the resource size, then read the following section.

			=== Using Wild Bits ===
			Open Wild Bits from the command line using the command <code>wildbits</code> {{CLI help}}. Then:
			# Go to the RSTB Editor tab.
			# Click "Open" and select the [[ResourceSizeTable.product.rsizetable\|RSTB]] file you want to edit.
			# Find the RSTB entry you want to edit. Each game file is listed by its [[canonical resource path]]. Generally, this is the path of the resource (relative to any archive) without the "s" prefix in the extension for compressed files. If you're not sure what this is, look at the second column in the [[Canonical resource path#List of resources and associated canonical paths\|lists of resources]]. If necessary, use the search bar at the bottom of screen.
			# Click "Update." You can either enter the size for the RSTB entry yourself (measured in bytes) or select the file using the "Detect size from file" option.
			# Click "Ok." You can then save the RSTB or edit more entries.

			If everything goes well, no errors will be shown on the screen. If Wild Bits says it is unable to calculate the resource size, then read the following section.

	== Deleting entries ==		== Deleting entries ==

imported>NiceneNerd: Added Wild Bits as an RSTB option

2019-07-26T14:05:57Z

Added Wild Bits as an RSTB option

← Older revision		Revision as of 14:05, 26 July 2019
Line 12:		Line 12:
	== Prerequisites ==		== Prerequisites ==
	* Python 3.6+ 64 bit (more details at [[Help:Setting up tools]])		* Python 3.6+ 64 bit (more details at [[Help:Setting up tools]])
	* [[Help:Tools/rstb\|rstbtool]]		* [[Help:Tools/rstb\|rstbtool]] or [[Help:Tools/Wild_Bits\|Wild Bits]]

	== Updating entries ==		== Updating entries ==

imported>Leoetlino: add CLI help

2019-02-07T18:08:45Z

add CLI help

← Older revision		Revision as of 18:08, 7 February 2019
Line 15:		Line 15:

	== Updating entries ==		== Updating entries ==
	Open a terminal / command prompt and run the following command:		Open a terminal / command prompt and run the following command {{CLI help}}
	<pre>		<pre>
	rstbtool [path to RSTB] set [resource path] [new size]		rstbtool [path to RSTB] set [resource path] [new size]
Line 39:		Line 39:

	== Deleting entries ==		== Deleting entries ==
	Run the following command:		Run the following command {{CLI help}}:
	<pre>		<pre>
	rstbtool [path to RSTB] del [resource path]		rstbtool [path to RSTB] del [resource path]

imported>Leoetlino: /* Deleting entries */

2018-12-29T22:43:30Z

Deleting entries

← Older revision		Revision as of 22:43, 29 December 2018
Line 58:		Line 58:
	{{warning\|text='''Deleting entries does not always work!'''		{{warning\|text='''Deleting entries does not always work!'''

	Some parts of the game require valid RSTB entries and will crash or refuse to load if you delete them. Avoid deleting entries for the Animation Sequence (AS) files: .bas, .baslist}}		Some parts of the game require valid RSTB entries and will crash or refuse to load if you delete them. Avoid deleting entries for the Animation Sequence (AS) files: .bas, .baslist

			For those files, you must determine the required size manually by trial and error.}}

	=== Why deleting entries is sometimes necessary ===		=== Why deleting entries is sometimes necessary ===