Textool is the images convert
and package tool for MAGIC101.
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.
|