Metroid Construction

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
^Address^Decimal^Width^Height^Description^
|0x2007000|xxxxxxx|xx|x|Hatch Transition Tilemap RAM, uncompressed[1]|
|0x8364F80|3559296|xx|x|Hatch Transition Tilemap (ROM, RLE compressed)[1]|
|0x83655A0|3560864|32|?|Hatch Animation Tilemap[2]|
|0x85D940C|6132748|32|4|Generic BG GFX (Zebes)|
|0x85DA40C|6136844|32|4|Generic BG GFX (Mothership)|
|0x85D980C|6133772|17|1|Zebes Hatch Open Animation|
|0x85DA80C|6137868|17|1|Mothership Hatch Open Animation|
|0x85DFE20|6159904|Palette|1 Row|Generic BG Tiles Palette|
|0x85DFE40|6159936|Palette|1 Row|Generic BG Hatch Palette|
|0x85E0420|6161440|Palette|6 Rows|Zebes Hatch Unlock Palette|
|0x85E0220|6160928|Palette|6 Rows|Mothership Hatch Unlock Palette|
{{zero_mission:locations:hatches.png}}

===== 1: To Edit RLE Graphics =====

To edit:\\ 
1) Open ROM in nocash and load a save file. set a breakpoint for ''[0x2007000]?!'' . Go through a hatch to start a room transition.\\
2) Resume the game until it breaks right before the DMA at 0x8003248. This should happen the third time it breaks.\\
3) Go to 0x2007000 in the data window and dump 4096 (0x1000 bytes) using ''no$ -> utility -> "binary dump to .bin file"''\\
4) Export generic BG GFX as raw. (use the default .gfx filetype)\\
5) Pad the beginning of exported generic BG with 2048 (0x800) bytes of 00.\\
6) ''MAGE -> tools -> compression -> lz77 compress file...'' exported generic BG and dumped tilemap\\
7) Append both files to the end of ROM using a hex editor. Take note of the offset before you paste in the bytes of the first and second file.\\
8) Reload rom in MAGE, then open ''MAGE -> editors -> tile table editor -> offset''. punch in compressed tile table, compressed generic bg, and generic bg palette.\\
9) Make desired edits, then export raw. rename file to "tt.bin" then grab this C code below.((<code c rle_encode.c>
#include <iostream>
#include <fstream>
#include <cstring>

using namespace std;

int main() {
    char * buffin = (char*)malloc(1024*4+4);//+4 prevents need for index out of range checks
    char * buffout = (char*)malloc(1024*4);
    char * bufftmp = (char*)malloc(1024*4);
    
    std::fstream file;
    file.open ("/uploads/tt.bin", std::fstream::in | std::fstream::binary);
    file.read(buffin,1024*4);
    file.close();
	buffin[1024*4+0]=buffin[1024*4-2]+1;buffin[1024*4+1]=buffin[1024*4-1]+1; //ensure last four bytes don't match
	buffin[1024*4+2]=buffin[1024*4-2]-1;buffin[1024*4+3]=buffin[1024*4-1]-1; //ensure last four bytes don't match
    file.open ("/myfiles/tt.rle", std::fstream::out | std::fstream::binary);
    
    char cur;
    int i=0;int o=0;
    buffout[o++]=0x01;//size 4kb
    buffout[o++]=0x01;//size of count values?
    int t;
    while (i<1024*4){ //low bytes
		if (buffin[i]!=buffin[i+2]){ //start of nonrepeating
			t=0;
			while ((i<1024*4) && (buffin[i+2]!=buffin[i+4]) && (t<127-1)) {bufftmp[t++]=buffin[i];i+=2;} //while not start of repeating
			bufftmp[t++]=buffin[i];i+=2;
			buffout[o++]=t;memcpy(buffout+o,bufftmp,t);o+=t;continue;
		} else { //start of repeating
			t=1;i+=2;
			while ((i<1024*4) && (buffin[i-2]==buffin[i]) && (t<127)) {t++;i+=2;} //while not start of repeating
			buffout[o++]=0x80|t;buffout[o++]=buffin[i-2];continue;
			
		}

    }
	buffout[o++]=0x00; //terminator
	buffout[o++]=0x02; //size of count values?

	i=1;
    while (i<1024*4){ //high bytes
		if (buffin[i]!=buffin[i+2]){ //start of nonrepeating
			t=0;
			while ((i<1024*4) && (buffin[i+2]!=buffin[i+4]) && (t<32767-1)) {bufftmp[t++]=buffin[i];i+=2;} //while not start of repeating
			bufftmp[t++]=buffin[i];i+=2;
			buffout[o++]=t>>8;buffout[o++]=0xff&t;memcpy(buffout+o,bufftmp,t);o+=t;continue;
		} else { //start of repeating
			t=1;i+=2;
			while ((i<1024*4) && (buffin[i-2]==buffin[i]) && (t<32767)) {t++;i+=2;} //while not start of repeating
			buffout[o++]=(t>>8)|0x80;buffout[o++]=0xff&t;buffout[o++]=buffin[i-2];continue;
			
		}

    }
	buffout[o++]=0x00; //terminator
	buffout[o++]=0x00; //terminator
	
    file.write(buffout,o);
    file.close();
    free(buffin);free(buffout);free(bufftmp);
    return 0;
}
</code>))\\ 
10) Go to [[https://www.jdoodle.com/online-compiler-c++/|jdoodle]] and paste in the code.\\
11) Upload tt.bin, then run the code. you should get tt.rle.\\
12) Open tt.rle in a hex editor and copy all the bytes. (Ctrl A, then Ctrl C)\\ 
13) Open your rom in a hex editor, go to 0x8364F80, and replace the bytes with the ones you just copied in step 12. You can do this with Ctrl+B in HxD. Do not use Ctrl V unless you have the correct number of bytes to replace highlighted, because that ADDS bytes instead of REPLACING them\\

===== 2: To View Hatch Animation Tilemap =====

To view in MAGE, add tileset (blank), open tileset editor, substract two from offset (0x836559E) and write it to new tileset's tiletable pointer, apply. then open tile table editor to new tileset.