Rainbow

Download latest dev build from here.

File formats documentation here.

If you want to contact me: marco.calautti [at] gmail [.] com. For bug/issues reports, please use the github page.

If you want to compile Rainbow, please refer to this wiki page.

Rainbow is a tool, written in C#, intended to handle different graphics formats from video games assets. Currently, Rainbow supports almost every variant of the TIM2 format and some game specific formats (see the Feature section below). It requires the .NET framework v4.0+ or any version of mono supporting v4.0. Download it here https://github.com/marco-calautti/Rainbow/releases

File Formats

• TIM2 (full support*)
• Super Robot Wars MX P TX48 (full support)
• The 3rd Birthday DAT (full support)
• NUT (partial support, only Open and export to png)
• TPL (partial support, only Open and export to png)
• EFX (Tactics Ogre PSP)

*TIM2 support is almost complete. The app supports multi-layer, multi-clut, swizzled (PSP)/unswizzled TIM2 images with both linear, interleaved palettes, and segments headers eventually extended with custom user data (usually used by programmers).

Features

• Can open textures in any format supported by the underlying image library.
• Can open whole folders in search of supported texture formats. All known texture files are then displayed in a list.
• Can export textures to an editable format (like png).
• Can import editable formats to be then saved to the original texture format.
• Any additional information specific to the texture is preserved when exporting/importing (like the TIM2 header data), in order to have a one-to-one correspondence with the original texture.
• Customizable background color for transparent and semi-transparent images with chessboard like pattern.
• Finally, Rainbow supports parameters via command line: the first parameter is the name of a texture you would like to open.

How to use Rainbow

• Use the "Open" menu to open any supported texture.
• Use the property grid on the left side to change some texture parameters (like swizzle).
• The "Export" menu allows to save textures to a user editable format, like png.
• The "Import" menu allows to import graphics in user editable format so that they can eventually be saved to the original format by means of the "Save" menu.
• The "Save" menu allows to save a texture to its original format (e.g., to TIM2).

Note for multi clut TIM2 images. When importing a png obtained by a single-clut TIM2 file, Rainbow will take care of everything for you by applying quantization to the given png, in order to keep the number of used colors under the maximum allowed by the original TIM2. When a multi-clut TIM2 is exported, instead, a png file for each clut is created. When editing such pngs, make sure that the pixel "structure" of every png is preserved. Rainbow will use the first exported png as reference to construct the pixels indexes of the image and then will create the palettes from each pngs' colors. Make also sure that the number of colors used by these pngs does not exceed the maximum allowed by the original TIM2. Because of how multi-clut TIM2s work, Rainbow cannot apply quantization to all the exported pngs.

To-do

Currently working on

• Fix DXT1Decoder.
• Reverse engineer NUT encoding.
• Complete GenericTextureFormat to be constructible from Image, ColorEncoder ecc.
• Fix export/import for multiclut TIM2 imags using reference image.
• Let IndexedImageEncoders to be constructed using a reference gray scale image.
• Add missing copyright snippet to new files.

Future work

• Add support to mipmap TIM2 textures. They are rare and usually used just for materials.
• Add support to GIM textures (eventually through GimSharp).
• Add scanning of textures inside other files in order to extract and reinsert textures with one click. Actually, there is a tool from Vash that allows to achieve such a task http://www.romhacking.net/utilities/659/.
• Improve performance of rendering and import code.