More actions
LuaTileArranger | |
---|---|
![]() | |
General | |
Author | Lukas Meisterhofer (fujah) |
Type | Other |
Version | 0.4 |
License | Mixed |
Last Updated | 2007/12/04 |
Links | |
Download | |
Website | |
Source | |
The program is used to create maps for various games and applications directly on the Sony PSP.
The maps can be read with almost any programming language.
User guide
Enter the main menu by hitting Start in the paintscreen. Here you can select the tools, switch through layers, load/save a map, and open the readme.
Use the D-Pad to move the selection, and press Square to move faster. When you start LuaTileArranger, you're automatically in the main menu. Go back to the paintscreen by hitting Select. To accept your selection, press Cross.
Interface
At the top of the main menu, you'll find useful information, like the project name, your current selection, and the position of your cursor. This can help when including your map in another program.
At the bottom, you can see the Tools and your Layers. If a layer is grayed out, it's hidden; if it's white, you can see it. The little arrow below the Layers marks the active layer, which is ready to be edited. Also, you can see your battery life and the current time.
Tools
Pencil | Draw foreground tile by pressing Cross in the paintscreen. Draw background tile by pressing Triangle. |
---|---|
Rubber | Erase tiles by pressing Cross. Draw background tile by pressing Triangle. |
Paintbucket | Fills all selected tiles with the foreground color. Draw background tile by pressing Triangle. |
Eyedropper Tool | Select your foreground tile by pressing Cross and the background tile by pressing Triangle. After making your selection, the Eyedropper Tool will change to the pencil. |
Load Tiles | Load a tileset for the active layer. |
Show/Hide Grid | Turns the grid on/off. Default is on. |
Select Layer | Switch through the three layers. |
Show/Hide Layer | Show/Hide Layers. |
Turn USB On/Off | Turns the USB connection on/off to track your project or save speed. |
New Project | Start a new project. |
File Manager | Load an older project, text files, images, or Lua files. |
Save Project | Save your project. |
Help | Opens the readme.txt. |
You can access the brush selection menu by pressing R-Trigger in the paintscreen.
Use the D-Pad to move the selection (marked by a small arrow), and press Square to move it faster.
By pressing Cross, you set the foreground tile you want to draw with, and Triangle sets the background tile.
Load tileset
Load tilesets for your layers. You can only load PNG files that are 69x69 px.
File manager
With the File Manager, you can load *.map files to edit them. You can also read *.txt, *.html, *.htm, *.php, *.asp, *.aspx, *.ini, *.cpp, *.hpp, *.cxx, *.hxx, *.c, *.h, *.java, *.js, *.vb, *.vbs, *.asm, and *.bat files.
You can open *.png images and, if desired, load them as a tileset in your project.
You can run *.lua files as well, but it's not recommended, as LuaTileArranger may crash, and all unsaved data will be lost.
Save project
First, you need to define the folder where you want to save the project. Do this by pressing Start.
- Use the Aanalog to select the charset.
- Press Triangle for the upper letter, Circle for the left, Cross for the lower, and Square for the right one.
- Press and hold the L-Trigger for numbers, and hit R-Trigger to change to capital letters.
You can only write up to 15 characters. Accept your filename with Start and save your project.
Reading map file
A .map file consists of 53 lines and 30 letters between "a" and "p". The letter "a" represents the first tile, transparency. Reading .map files involves changing letters to pictures.
The first layer is from line 1 to 17, the second from 18 to 35, and the third from 36 to 53.
(The following codes are for Lua, but you can also use the maps you've created in C, C++, Python, and other languages.)
Copy the file maploader.lua from the folder ms0:/PSP/GAME/LuaTileArranger/Applications/files/LoadingMap
and the tiles you've used (found in the "Tiles" folder) to your Apps folder. Then type:
dofile("maploader.lua")
This adds the map functions to your program. Load the tiles with this:
tiles01 = Image.load("tiles/tiles01.png") tiles02 = Image.load("tiles/tiles02.png") tiles03 = Image.load("tiles/tiles03.png")
To load a map, type:
loadmap("maps/map.map")
To draw the layers of the map, use the following functions:
drawLayer1() drawLayer2() drawLayer3()
Tips for Maps
Use as few layers as possible; using all three layers can be very slow. Avoid drawing the background of your map with tiles.
When you load a 480x272px PNG as a background image in your application (maybe using the screenshot function?), your program will load and run much faster.
Controls
Menu:
D-Pad - Move selection, Scroll text
Analog - Select charset in saving menu
Cross - Accept selection
Select - Go back, Cancel
Square - Move the cursor, Scroll the text quickly
Paintscreen:
D-Pad - Move cursor
Square - Move cursor just one tile
Cross - Paint foreground tile
Triangle - Draw background tile
Circle - Take a screenshot (in PHOTO)
Start - Main menu
L - Hide the grid & the cursor
R - Brushselection
Screenshots
Changelog
v0.4
- The program now runs smoothly.
- Completely redesigned graphics.
- New file browser, now you can browse the entire memory stick.
- Lua scripts can be executed.
- Added text reader; now you can read the readme right where you need it—inside the program while working. It can also open *.html, *.php, *.asp, *.aspx, *.ini, *.cpp, *.hpp, *.cxx, *.hxx, *.c, *.h, *.java, *.js, *.vb, *.vbs, *.asm, and *.bat files.
- Maps can now be saved as *.png files.
- It's now even easier to import *.map files into other Lua projects. A clear example script is included in the download, and more details can be found in the readme.
- The program is now self-explanatory, making navigation faster and easier.
- English readme.
- Many, many bug fixes.
Credits
Code& Design by Lukas Meisterhofer; http://dasblattwerk.net
External links
PSPSource - http://pspsource.de/hdp_plugins/forum/forum_viewtopic.php?109759 (archived)