TGAHz Parsing

What is this?

So, HzMod is a 3DS image capturing system that is entirely software-based. It can stream the 3DS top screen to a PC like NTR CFW. Development is a little strange... Archives of builds are hosted on this website: https://chainswordcs.com/horizon-by-sono.html

So, older builds (February 2018) can stream in a TARGA image format. The capability is available for all games I believe, but for some games it is required (such as Mario Kart 7, Super Smash Bros. for Nintendo 3DS, Yoshi's New Island, and Pokemon Yellow Version)

The TARGA image format streamed by HzMod is non-standard, so this repository is to document our reverse engineering efforts. Eventually we plan to push some changes to Snickerstream to add support to TARGA streams: https://github.com/RattletraPM/Snickerstream

Running the Script

This script is written in Python 3. It requires the 'pillow' module.

This is not a generic TARGA reader. It is only designed to interpret HzMod TGAs, so certain header information is hard-coded as it is constant for HzMod.

All input, raw or as a file, is at the end of the command. For example, python TGAHzParse.py -txt -log input.txt takes input as a hex string in input.txt.

Output images are saved as TGAHZ.png for single frames or TGAHZ.gif for animations.

There are several available command-line arguments:

Input arguments
- -txt: Take input from a text file containing a hex string on the first line
- -txtanim: Create an animated image with input from a text file containing a hex string on each line
- -tga or -bin: Take input from a binary file
- -hex: Take input from a hex string
Experimental Features (Not finished, only had limited testing)
- -bit24: Force experimental 24-bit color decoding (16-bit is the default)
Debugging Tools
- -log: Log each packet and some metadata to the console
- -logcolor: Color-code log output as RGB, with purple for the attribute bit
- -loghex: Log each packet, but in 24-bit hex color values rather than binary (Only compatible with 24-bit color decoding)
- -forcerenderhbytes: Forcibly process and render the header byte of every RAW and RLE packet as a pixel in a shade of red. May be useful for visually debugging.
- -noimage: Don't output an image