Support for Bomberman Land Touch images files

[Golem642]

Hello, could you add support for .dsar, .dsir, .dsor, .dsbr and .dscr files please ?
They come from the Bomberman Land Touch 2 game, and so far only one other program can (mostly) read them
The problem is that this program is not open sourced and pretty old, and gamemasterplc (the dev) doesn't seem to want to answer my DMs.
So I'm here asking you if you could help me research them and make them readable in NitroPaint as this would make my job easier

Here's the info I have so far :

• DSAR and DSBR files seems to be the main image files (DSAR seemingly being a sprite sheet, and DSBR being a whole image)
• DSCR is the color palette
• DSOR is some kind of filter data (e.g. when you get skulled in battle mode, your character colors pulses in purple, or when you get hit with an extra life you pulse in red)
• DSIR I don't know yet, but bltouch2image (gamemasterplc's program) requires it to build images

Here is a zip containing the program as well as some example files and results obtained (the program does not support .dsor files)

data.zip

Usage of the program is as follow :

Usage: .\bltouch2image.exe [OPTIONS...] <file1> <file2> <file3>
Options:
-h Display this usage message.
-l Assume tiles are linear bitmaps. Only valid if any file is a dsar file.
-b Bit depth of tiles. Only valid if any file is a dsbr file. Default value is 8.
-o Specifies prefix of output filename.
file1, file2, and file3 specify a dsir, dscr, and a dsar or dsbr in any order.

Thanks

[Garhoogin]

Taking a look at the files attached, it looks like the files are all having some sort of common header, or at least all having the same magic number. For the DSIR file, it looks to be a wrapper around compressed character data, which looks to be prepended with an 8-byte header. Details to be investigated further, and I haven't really looked much yet at the others in particular, but I think that support for these files should be feasible to implement.

The files all share a common header structure. This looks to be as follows:

Offset	Type	Meaning
00	char[4]	Signature "BLDT" (Bomberman Land Data?)
04	u32	Compression info. If the data are compressed, the msb is set, and the low 22 bits are the uncompressed size in bytes. Compressed data is in the LZ format (not required to be VRAM-safe). If the data is not compressed, this field is not used.
08	u8[...]	Main file data

Each file type defines the data format. These are outlined below.

DSCR: Color Palette data

Offset	Type	Meaning
00	u32	Palette data size in bytes
04	u32	?
08	u32	?
0C	u32	?
10	u16[...]	Color palette data

DSIR: Character data

Offset	Type	Meaning
00	u32	Size of character data
04	u8	Graphics tiles X (usually 32). Dimensions seemingly need not equal the size exactly, due to graphics optimization.
05	u8	Graphics tiles Y.
06	u8	Graphics 8-bit depth flag (0=4bpp, 1=8bpp)
06	u8	?
08	u8[...]	Character data

DSBR: BG Screen data

Offset	Type	Meaning
00	u32	Size of BG screen data in bytes
04	u32	?
08	u16	Screen tiles X
0A	u16	Screen tiles Y
0C	u32	?
10	u8[...]	BG screen data

DSOR: OBJ data?

DSAR: Animation data?

[Garhoogin]

I've been able to get the DSCR, DSIR, DSBR file format support working. Will see about trying to work out how the DSAR and DSOR files work, but for now I'm able to read/write the files for background. I'll leave this issue open in the meantime.