Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

LuaTileArranger PSP

From GameBrew
LuaTileArranger
Luatilearrangerpsp.png
General
AuthorLukas Meisterhofer (fujah)
TypeOther
Version0.4
LicenseMixed
Last Updated2007/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

Main menu

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.

Brush selection menu

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

luatilearrangerpsp2.png

luatilearrangerpsp3.png

luatilearrangerpsp4.png

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)

Advertising: