THPConv-Guide - Revision history

HummingOwl at 17:21, 10 May 2024

2024-05-10T17:21:06Z

← Older revision		Revision as of 17:21, 10 May 2024
Line 76:		Line 76:
	* The <code>-v</code> flag is used to print more info on the CMD when THPConv is converting the JPG frames and WAV audio into a THP video (optional).		* The <code>-v</code> flag is used to print more info on the CMD when THPConv is converting the JPG frames and WAV audio into a THP video (optional).
	* To check more info on the commands THPConv has, check its documentation (Wii SDK or [[THPConv \| here]]).		* To check more info on the commands THPConv has, check its documentation (Wii SDK or [[THPConv \| here]]).
	~~</blockquote>~~		}}

	Now you can replace the THP file with the one you want from your SMG1 dump and test the video on game!		Now you can replace the THP file with the one you want from your SMG1 dump and test the video on game!

HummingOwl at 14:26, 10 May 2024

2024-05-10T14:26:17Z

← Older revision		Revision as of 14:26, 10 May 2024
Line 90:		Line 90:

	* [[THPConv \| THPConv documentation]]		* [[THPConv \| THPConv documentation]]
	* [https://github.com/MasterofGalaxies/THPConv THPConv port to Linux]

HummingOwl: using new note box!

2024-05-10T04:06:30Z

using new note box!

← Older revision		Revision as of 04:06, 10 May 2024
Line 22:		Line 22:
	[[File:THPConv-Guide_Fig-1.webp\|right\|thumb\|Fig. 1 - Create temporal video]]		[[File:THPConv-Guide_Fig-1.webp\|right\|thumb\|Fig. 1 - Create temporal video]]

	~~<blockquote>~~		{{note \|
	All this information is extracted from the Wii SDK docs for THPConv.		* All this information is extracted from the Wii SDK docs for THPConv.
			* SMG uses 59.94 fps and 640x368 video dimensions for all THP files in the <code>MovieData</code> folder. Use <code>path\to\ffmpeg.exe -i [THP video file]</code> to see it yourself.
	SMG uses 59.94 fps and 640x368 video dimensions for all THP files in the <code>MovieData</code> folder. Use <code>path\to\ffmpeg.exe -i [THP video file]</code> to see it yourself.		* If you use different frame rates than 59.94 the video on SMG1 will play slower or faster but not at its "normal" speed.

	If you use different frame rates than 59.94 the video on SMG1 will play slower or faster but not at its "normal" speed.

	You can use different values for the width and height of the video, be sure they follow the rules said above and that the dimensions are a multiple of 16.		You can use different values for the width and height of the video, be sure they follow the rules said above and that the dimensions are a multiple of 16.
			* To get a better video resolution on the final THP video you can use the following flags on the above command <code>-preset veryslow -b:v 21M</code> (file size will increase a lot as <code>-b:v</code> sets the bitrate of the output video). <code>21M</code> was selected because of the bitrates of the OG THP videos on the MovieData folder (you can select any value you want, <code>M</code> means megabyte).
	To get a better video resolution on the final THP video you can use the following flags on the above command <code>-preset veryslow -b:v 21M</code> (file size will increase a lot as <code>-b:v</code> sets the bitrate of the output video). <code>21M</code> was selected because of the bitrates of the OG THP videos on the MovieData folder (you can select any value you want, <code>M</code> means megabyte).		}}
	~~</blockquote>~~

	Create a folder named <code>temp</code> in the same place the <code>[temp_video]</code> is and then type the following command (Fig. 2 and 3):		Create a folder named <code>temp</code> in the same place the <code>[temp_video]</code> is and then type the following command (Fig. 2 and 3):
Line 44:		Line 40:
	[[File:THPConv-Guide Fig-3.webp\|right\|thumb\|Fig. 3 - Dump temporal video frames into folder]]		[[File:THPConv-Guide Fig-3.webp\|right\|thumb\|Fig. 3 - Dump temporal video frames into folder]]

	~~<blockquote>~~		{{ note \|
	JPG or JPEG can be used, the only restriction the THPConv docs say is that they need to be in the baseline DCT format (which ffmpeg automatically converts them to with the above command).		* JPG or JPEG can be used, the only restriction the THPConv docs say is that they need to be in the baseline DCT format (which ffmpeg automatically converts them to with the above command).
			* The minimum frames a THP video can have without breaking the game is 21. Tested with <code>PrologueA.thp</code> in Riivolution.
	The minimum frames a THP video can have without breaking the game is 21. Tested with <code>PrologueA.thp</code> in Riivolution.		* Very low width and height values for the THP video (16x16 for example) will allow to show blue rectangles on the screen when reproducing the associated cutscene. Tested it very little so I am unsure if this happens all the time.
			* To get a video resolution similar to the [temp_video] on your THP video you can use the following flag on the above command <code>-q:v 1</code>
	Very low width and height values for the THP video (16x16 for example) will allow to show blue rectangles on the screen when reproducing the associated cutscene. Tested it very little so I am unsure if this happens all the time.		}}

	To get a video resolution similar to the [temp_video] on your THP video you can use the following flag on the above command <code>-q:v 1</code>
	~~</blockquote>~~

	Then, to get the audio part of the video execute (Fig. 4):		Then, to get the audio part of the video execute (Fig. 4):
Line 64:		Line 57:
	[[File:THPConv-Guide_Fig-4.webp\|right\|thumb\|Fig. 4 - Create WAV audio file]]		[[File:THPConv-Guide_Fig-4.webp\|right\|thumb\|Fig. 4 - Create WAV audio file]]

	~~<blockquote>~~		{{ note \|
	WAV audios are the only audio input THPConv can process. Specifically non-compressed 16-bit PCM data ones.		* WAV audios are the only audio input THPConv can process. Specifically non-compressed 16-bit PCM data ones.
			* WAV audios can be Mono or Stereo, they are both supported by THPConv.
	WAV audios can be Mono or Stereo, they are both supported by THPConv.		* The <code>-ar 32000</code> sets the frequency of the WAV audio. 32000 Hz is needed for the audio in SMG1 since different values make the audio sound at a higher or lower pitch.
			}}
	The <code>-ar 32000</code> sets the frequency of the WAV audio. 32000 Hz is needed for the audio in SMG1 since different values make the audio sound at a higher or lower pitch.
	~~</blockquote>~~

	Finally, to get the THP converted file we do (Fig. 5):		Finally, to get the THP converted file we do (Fig. 5):
Line 78:		Line 69:
	[[File:THPConv-Guide_Fig-5.webp\|right\|thumb\|Fig. 5 - Create THP file with THPConv]]		[[File:THPConv-Guide_Fig-5.webp\|right\|thumb\|Fig. 5 - Create THP file with THPConv]]

	~~<blockquote>~~		{{ note \|
	The <code>-j</code> flag is used to select the JPEG sequential frames that are going to be used in the THP video.		* The <code>-j</code> flag is used to select the JPEG sequential frames that are going to be used in the THP video.
			* The <code>-s</code> flag is used to select the WAV audio to be used in the THP video (optional).
	The <code>-s</code> flag is used to select the WAV audio to be used in the THP video (optional).		* The <code>-r</code> flag is used to set the frame rate of the THP video. If you want your video to reproduce normally on SMG1 use 59.94 as frame rate. If omitted THPConv will set the frame rate of the THP video to 29.97 fps.
			* The <code>-d</code> flag is used to set the THP file creation path and name.
	The <code>-r</code> flag is used to set the frame rate of the THP video. If you want your video to reproduce normally on SMG1 use 59.94 as frame rate. If omitted THPConv will set the frame rate of the THP video to 29.97 fps.		* The <code>-v</code> flag is used to print more info on the CMD when THPConv is converting the JPG frames and WAV audio into a THP video (optional).
			* To check more info on the commands THPConv has, check its documentation (Wii SDK or [[THPConv \| here]]).
	The <code>-d</code> flag is used to set the THP file creation path and name.

	The <code>-v</code> flag is used to print more info on the CMD when THPConv is converting the JPG frames and WAV audio into a THP video (optional).

	To check more info on the commands THPConv has, check its documentation (Wii SDK or [[THPConv \| here]]).
	</blockquote>		</blockquote>

	Now you can replace the THP file with the one you want from your SMG1 dump and test the video on game!		Now you can replace the THP file with the one you want from your SMG1 dump and test the video on game!

	~~<blockquote>~~		{{ note \|
	You can use VLC Media Player to play/test THP videos as well as FFmpeg to convert THP videos to other video formats (you can't convert to THP with FFmpeg).		* You can use VLC Media Player to play/test THP videos as well as FFmpeg to convert THP videos to other video formats (you can't convert to THP with FFmpeg).
			* When testing the THP video on console it is better to not use Riivolution but rather pack the THP into the WBFS file and run said WBFS in a USB Loader. Due to either Riivolution file copying velocity or how inefficient the THP processing algorhythm/video format is (or a combination of both) the video can't be reproduced at its normal speed when being replaced by Riivolution.
	When testing the THP video on console it is better to not use Riivolution but rather pack the THP into the WBFS file and run said WBFS in a USB Loader. Due to either Riivolution file copying velocity or how inefficient the THP processing algorhythm/video format is (or a combination of both) the video can't be reproduced at its normal speed when being replaced by Riivolution.		}}
	~~</blockquote>~~

	''Thanks to Lord-Giganticus and EmilyTheDemon for their support during the guide!''		''Thanks to Lord-Giganticus and EmilyTheDemon for their support during the guide!''

HummingOwl at 21:40, 9 May 2024

2024-05-09T21:40:36Z

← Older revision		Revision as of 21:40, 9 May 2024
Line 101:		Line 101:

	''Thanks to Lord-Giganticus and EmilyTheDemon for their support during the guide!''		''Thanks to Lord-Giganticus and EmilyTheDemon for their support during the guide!''

			== See also ==

			* [[THPConv \| THPConv documentation]]
			* [https://github.com/MasterofGalaxies/THPConv THPConv port to Linux]

HummingOwl: edited style, hope no information was deleted

2024-05-09T21:32:06Z

edited style, hope no information was deleted

Show changes

HummingOwl at 22:52, 15 May 2023

2023-05-15T22:52:38Z

← Older revision		Revision as of 22:52, 15 May 2023
Line 41:		Line 41:
	<br>		<br>

	[[File:~~Example~~.~~jpg~~\|center\|frame\|<b>Fig. 1 - Create temp video</b>]]		[[File:THPConv-Guide_Fig-1.webp\|center\|frame\|<b>Fig. 1 - Create temp video</b>]]

	<br>		<br>
Line 73:		Line 73:
	<br>		<br>

	[[File:~~Example~~.~~jpg~~\|center\|frame\|<b>Fig. 2 - Create temp folder</b>]]		[[File:THPConv-Guide Fig-2.webp\|center\|frame\|<b>Fig. 2 - Create temp folder</b>]]

	<br>		<br>

	[[File:~~Example~~.~~jpg~~\|center\|frame\|<b>Fig. 3 - Dump temp video frames into folder</b>]]		[[File:THPConv-Guide Fig-3.webp\|center\|frame\|<b>Fig. 3 - Dump temp video frames into folder</b>]]

	<br>		<br>
Line 109:		Line 109:
	<br>		<br>

	[[File:~~Example~~.~~jpg~~\|center\|frame\|<b>Fig. 4 - Create WAV audio file</b>]]		[[File:THPConv-Guide_Fig-4.webp\|center\|frame\|<b>Fig. 4 - Create WAV audio file</b>]]

	<br>		<br>
Line 133:		Line 133:
	</blockquote>		</blockquote>

	[[File:~~Example~~.~~jpg~~\|center\|frame\|<b>Fig. 5 - Create THP file with THPConv</b>]]		[[File:THPConv-Guide_Fig-5.webp\|center\|frame\|<b>Fig. 5 - Create THP file with THPConv</b>]]

	<br>		<br>

HummingOwl: Created page with "This guide is created specifically to make THP videos for SMG1. Other games that support THP can have a different THP setup.

Required Tools

* FFmpeg ([https://web.archive.org/web/20200901234146/https://ffmpeg.zeranoe.com/builds/win32/static/ Win32 older builds], for Linux you can use your package manager) * THPConv.exe (with dsptool.dll, [https://archive.org/details/WiiDevelopmentPackage/ Wii SDK]) * [https://github.com/Master..."

2023-05-15T13:36:42Z

Created page with "This guide is created specifically to make THP videos for SMG1. Other games that support THP can have a different THP setup.   <h1>Required Tools</h1> * FFmpeg ([https://web.archive.org/web/20200901234146/https://ffmpeg.zeranoe.com/builds/win32/static/ Win32 older builds], for Linux you can use your package manager) * THPConv.exe (with dsptool.dll, [https://archive.org/details/WiiDevelopmentPackage/ Wii SDK]) * [https://github.com/Master..."

New page

This guide is created specifically to make THP videos for SMG1. Other games that support THP can have a different THP setup.




<h1>Required Tools</h1>

* FFmpeg ([https://web.archive.org/web/20200901234146/https://ffmpeg.zeranoe.com/builds/win32/static/ Win32 older builds], for Linux you can use your package manager)

* THPConv.exe (with dsptool.dll, [https://archive.org/details/WiiDevelopmentPackage/ Wii SDK])

* [https://github.com/MasterofGalaxies/THPConv Alternative THPConv build] (for Linux users)

* [https://www.videolan.org/vlc/ VLC Media Player] (to reproduce THP files)

* [https://www.winehq.org/ Wine] (for Linux users)





<h1>Steps</h1>

:Open a CMD in the same place the video you want to convert is and type the following command (Fig. 1):

<blockquote style="border: none;">

<pre>path\to\ffmpeg.exe -i [input_video] -vf scale="[width]:[height]" -r [fps] [temp_video]</pre>

</blockquote>

*<code>[input_video]</code> is the video of your choice to convert. Can be any video format.

*<code>[width]</code> is the width the <code>[temp_video]</code> will have. Cannot exceed 672 pixels.

*<code>[height]</code> is the height the <code>[temp_video]</code> will have. There is no limit on this value.

*<code>[fps]</code> are the frames per second the <code>[temp_video]</code> will have. Frame rates can be from 1.0 to 59.94.

 

[[File:Example.jpg|center|frame|Fig. 1 - Create temp video]]

 

<hr>

:NOTE 1: All this information is extracted from the Wii SDK docs for THPConv.

:NOTE 2: SMG uses 59.94 fps and 640x368 video dimensions for all THP files in the <code>MovieData</code> folder. Use <code>path\to\ffmpeg.exe -i [THP video file]</code> to see it yourself.

:NOTE 3: if you use different frame rates than 59.94 the video on SMG1 will play slower or faster but not at its "normal" speed.

:NOTE 4: You can use different values for the width and height of the video, be sure they follow the rules said above and that the dimensions are a multiple of 16.

:NOTE 5: To get a better video resolution on the final THP video you can use the following flags on the above command <code>-preset veryslow -b:v 21M</code> (file size will increase a lot as <code>-b:v</code> sets the bitrate of the output video). <code>21M</code> was selected because of the bitrates of the OG THP videos on the <code>MovieData</code> folder (you can select any value you want, <code>M</code> means megabyte).

<hr>

 

:Create a folder named <code>temp</code> in the same place the <code>[temp_video]</code> is and then type the following command (Fig. 2 and 3):

<blockquote style="border: none;">

<pre>path\to\ffmpeg.exe -i [temp_video] temp\output%03d.jpg</pre>

</blockquote>

:This will dump all the frames the <code>[temp_video]</code> has into JPG images.

 

[[File:Example.jpg|center|frame|Fig. 2 - Create temp folder]]

 

[[File:Example.jpg|center|frame|Fig. 3 - Dump temp video frames into folder]]

 

<hr>

:NOTE 6: JPG or JPEG can be used, the only restriction the THPConv docs say is that they need to be in the :baseline DCT format (which ffmpeg automatically converts them to with the above command).

:NOTE 7: The minimum frames a THP video can have without breaking the game is 21. Tested with <code>PrologueA.thp</code> in Riivolution.

:NOTE 8: Very low width and height values for the THP video (16x16 for example) will allow to show :blue rectangles on the screen when reproducing the associated cutscene. Tested it very little so I am unsure if this happens all the time.

:NOTE 9: To get a video resolution similar to the <code>[temp_video]</code> on your THP video you can use the following flag on the above command <code>-q:v 1</code>.

<hr>

 

:Then, to get the audio part of the video execute (Fig. 4):

<blockquote style="border: none;">

<pre>path\to\ffmpeg.exe -i [temp_video] -acodec pcm_s16le -ar 32000 [WAV_audio].wav</pre>

</blockquote>

*<code>[WAV_audio].wav</code> is the name of the WAV audio file to use with THPConv.

:This will convert the audio of the <code>[temp_video]</code> in a WAV audio using the pcm_s16le format.

 

[[File:Example.jpg|center|frame|Fig. 4 - Create WAV audio file]]

 

<hr>

:NOTE 10: WAV audios are the only audio input THPConv can process. Specifically non-compressed 16-bit PCM data ones.

:NOTE 11: WAV audios can be Mono or Stereo, they are both supported by THPConv.

:NOTE 12: the <code>-ar 32000</code> sets the frequency of the WAV audio. 32000 Hz is needed for the audio in SMG1 since different values make the audio sound at a higher or lower pitch.

<hr>

 

:Finally, to get the THP converted file we do (Fig. 5):

<blockquote style="border: none;">

<pre>path\to\THPConv.exe -j temp\output*.jpg -s [WAV_audio].wav -r 59.94 -d [Output THP].thp -v</pre>

</blockquote>

[[File:Example.jpg|center|frame|Fig. 5 - Create THP file with THPConv]]

 

<hr>

:NOTE 13: the <code>-j</code> flag is used to select the JPEG sequential frames that are going to be used in the THP video.

:NOTE 14: the <code>-s</code> flag is used to select the WAV audio to be used in the THP video (optional).

:NOTE 15: the <code>-r</code> flag is used to set the frame rate of the THP video. If you want your video to reproduce normally on SMG1 use 59.94 as frame rate. If omitted THPConv will set the frame rate of the THP video to 29.97 fps.

:NOTE 16: the <code>-d</code> flag is used to set the THP file creation path and name.

:NOTE 17: the <code>-v</code> flag is used to print more info on the CMD when THPConv is converting the JPG frames and WAV audio into a THP video (optional).

:NOTE 18: to check more info on the commands THPConv has, check its documentation (Wii SDK).

<hr>

 

:Now you can replace the THP file with the one you want from your SMG1 dump and test the video on game!

 

<hr>

:NOTE 19: You can use VLC Media Player to play/test THP videos as well as FFmpeg to convert THP videos to other video formats (you can't convert to THP with FFmpeg).

:NOTE 20: When testing the THP video on console it is better to not use Riivolution but rather pack the THP into the WBFS file and run said WBFS in a USB Loader. Due to either Riivolution file copying velocity or how inefficient the THP processing algorhythm/video format is (or a combination of both) the video can't be reproduced at its normal speed when being replaced by Riivolution.

<hr>

:Thanks to Lord-Giganticus for his guidence and EmilyTheDemon for her enthusiasm. Tutorial based on the [https://luma.aurumsmods.com/wiki/THPConv.exe Luma's Workshop Wiki]

<hr>