Textool Live Tutorial

Textool is the images convert and package tool for MAGIC101.

0. Overview of Textool's interface
1. Open Files/Project
2. Open Palette
3. Save Project
4. Export Image
5. Export Package
6. Remove Files
7. Clear Project
8. Set Color Key(transparent color)
9. Set Background Color
10. Show/Hide Current Palette

0. Overview of Textool's interface

This figure shows the user-interface of Textool with an opened project:

File List View show all files in current project.
Image View shows current selected image.
Palette shows current project's palette.
You can get/set current image/project's information at Info Panel.

1. Open Files/Project


Press Ctrl+O , click on Open Speed Button or choose File->Open menu, a file open dialog will appear.

1.1 Open Images:
By now Textool only support Windows Bitmap format as input image, select images you want to open(add to current project) and click Open button, the files you selected will add to current project.

1.2 Open Project:
You can open image project(*.prj,*.ipj). A image project is a set of images and export information(like palette, color key). When you choose open a project file, all files in that project will add to current project. So if you want to just open a project, choose new project option at first.

 

2. Open Palette

In MAGIC101 SDK for MGS 9200 or for palette based games, all output image and package should be paletted. So you need to refer a palette for the project. To open a palette for this project, press Ctrl+P or choose Palette->Open Palette menu. You can create and edit a palette with MAGIC101 Palette Tool.

 

3. Save Project

To save(not build) current project, you can either choose File->Save Project menu, click on Save speed button or just press Ctrl+S. A Save Project dialog will appear to guide you.

 

4. Export Image

To save memory space and speed up the game, MAGIC101 uses it's own image file format. There are 2 image formats that Textool support: IMG files and RPK files.
IMG files are target to row-images( MAGRowImage ) that's a rectangle image without a transparent color. RLE files are target to color-key based images(MAGRLEImage).
To export IMG images, select images first, press Ctrl+I or choose File->Export Image->IMG. Then choose a color depth, 8-bit for palette based images. Then choose file path and name for the image.
To export a RLE image, select images first, press Ctrl+L or choose File->Export Image->RLE. Then choose file path and name for the image. Notice that you should adjust the project's color key well first.

Choose color dialog:

 

 

5. Export Package

You can export and pack all images in project into one package. Like the image, there are 2 kind of image package: BIN and RPK.
BIN package are target to row-images( MAGRowImage ) that's a rectangle image without a transparent color. RPK package are target to color-key based images(MAGRLEImage).
To export a BIN package, press Ctrl+B or choose File->Export Project->BIN. Then choose file path and name for the package. Then choose a color depth, 8-bit for palette based images. Then choose a RTH file path and name, this is a C++ header file for your game to identity every image's ID.
To export a RPK package, press Ctrl+R or choose File->Export Project->RPK. Then choose file path and name for the package. Then choose a color depth, 8-bit for palette based images. Then choose a RTH file path and name, this is a C++ header file for your game to identity every image's ID.

 

6. Remove files

To remove files from project, you should first select the files you want to remove. Then press Del (or press Delete Speed button).

 

7. Clear a project

To clear a project(remove all files from current project). Press Ctrl+N, click New speed button or choose File->New Project menu.

 

8. Set Color Key

To set color key double click Color Key button in the Info Pannel's ColorKey page.

 

9. Set Back Ground


To set color key double click Back Color button in the Info Pannel's View page.

 

10. Show/Hide Palette

To show/hide the palette adujst the Draw Palette check box in the Info Pannel's View page.