
                                         L u a T i l e A r r a n g e r  v.0.4
--------------------------------------------------------------------------------------------------------------------------------------------------

LuaTileArranger (LuTA) is a powerful tool to create and organise 
maps for certain games and programs. Code& Design by 
Lukas Meisterhofer; http://dasblattwerk.net

 
 C o n t e n t :

  1. Main controls
  2. The menues
  3. Dialogues
  4. LuTA files in other Apps
  5. Useful Tipps


--------------------------------------------------------------------------------------------------------------------------------------------------


1.1   M a i n   C o n t r o l s :

  [D-Pad]
                            Paintscreen: move cursor
                            Menu: move selection, scroll text
  [A-Pad]  
                            Used to select charset in the saveing menu
  [Start]  
                            Paintscreen: Enters the main-menu
  [Select]  
                            Something like "ESC"
  [Cross]  
                            Paintscreen: Paint foreground tile
                            Menu: accept selection
  [Square]
                            Paintscreen: move cursor just one tile
                            Menu: move the cursor/ scroll the text quickly
  [Triangle]
                            Paintscreen: Draw background tile.
  [Circle]
                            Paintsreen: take a screenshot. The saved picture 
                            is in the PNG format, and you'll find it in the
                            PHOTO folder of your PSP. It's named by your project.
  [L-Trigger]
                            Paintscreen: Hides the grid& the cursor.
  [R-Trigger]
                            Paintscreen: Enters the Brushselection. (2.2.1)

--------------------------------------------------------------------------------------------------------------------------------------------------


2.1.1   M a i n   M e n u e :

  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, press [Square] to move
  faster.
  When you start LuTA youre automatically in the main menu. Go back 
  to the paintscreen by hitting [Select]. To accept your selection, press [Cross].


2.1.2  I n f o r m a t i o n s :

  On the top of the main menu you can find many useful informations, like the 
  projectname, your current selection and the position of your cursor. This may 
  helps when you will include your map in an other program.

  On the bottom you can see the Tools (2.1.3) and your Layers. If a layer is printed
  gray it's hide, if it's white you can see it. The little arrow below the Layers marks
  the active layer witch is ready to be edited.
  Further you can see your batterie's life and the actual time. 


2.1.3  T o o l s :

  Pencil
                                          A rencil. Draw foreground tile by pressig [Cross] in the 
                                          paintscreen. Draw background tile by pressing [Triangle].
  Rubber
                                          A rubber. Erase tiles by pressing [Cross]. Draw 
                                          background tile by pressing [Triangle].
  Paintbucket
                                          Fills all(!) selected tiles with the foregroundcolour. 
                                          Draw background tile by pressing [Triangle].
  Eyedropper Tool
                                          You can select your foreground tile by pressig [Cross] and
                                          the background tile by pressing [Triangle]. After you made
                                          your selection the Eyedropper Tool will change to the 
                                          pencil.
  Load Tiles
                                          Load a tileset for the active layer. (3.1)
  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 keep track of your
                                          project, or to save speed.
  New Project
                                          Start a new project.
  File Manager
                                          Load an older project, text files, images or lua files. (3.2)
  Save Project
                                          Save your project. (3.3)
  Help
                                          Opens the readme.txt


2.2.1   B r u s h s e l e c t i o n   M e n u e :

  You reach the brushselection menue by pressing the [R-Trigger] in the 
  paintscreen. Use the [D-Pad] to move the selection, marked by an little 
  arrow, and press [Square] to move it faster.
  By pressing [Cross] you set the foreground tile you want to draw with,
  [Triangle] sets the background tile.


--------------------------------------------------------------------------------------------------------------------------------------------------


3.1   L o a d  T i l e s e t :

  Load tilesets for your layers. You can only load PNG files with
  69x69 px. 
  
3.2   F i l e   M a n a g e r :

  With the Filemanager you can load *.map files to edit them. But 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 you want, load them as a tileset in your
  project.

  You can run *.lua files too, but it's not recommend, LuaTileArranger may
  crash, and all unsaved data will be lost.


3.3  S a v e  P r o j e c t :

  At first you have to define the folder where to save the project. Do
  this with [Start].
  With the [A-Pad] you can select the Charset. Press [Triangle] to write the
  upper letter, [Circle] for the left, [Cross] for the under and
  [Square] for the right one.
  Press and hold the [L-Trigger] for numbers, Hit [R-Trigger] to change to 
  the capital letters.
  You are only allowed to write 15 charakters. 
  Accept your filename with [Start] and save your project.


--------------------------------------------------------------------------------------------------------------------------------------------------


4.1  B a s i c s :

  A *.map file consists of 53 lines and 30 letters between "a" and "p".
  The letter "a" stands for the first tile, transparency.
  Reading *.map files is nothing else than 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. (4.4) 

  The following codes are for Lua, but you can also use the maps you've
  created in C, C++, Python and any other language.


4.2  I T s  J u s t  T h a t  E a s y !

  Copy the file "maploader.lua" you can find in the folder
  ->ms0:/PSP/GAME/LuaTileArranger/Applications/files/LoadingMap
  and the Tiles you have used (found in the folder "Tiles") to your Apps folder.
  Now type

   dofile("maploader.lua")

  to add the map functions to your programm.
  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 this functions:

   drawLayer1() 
   drawLayer2()
   drawLayer3()


--------------------------------------------------------------------------------------------------------------------------------------------------
  

5.1  T i p p s  f o r  M a p s :

  Use as less layers as possible, using all 3 layers is maybe very slow.
  Draw as less as possible. It's not recommend to draw the backgrond
  of your map with tiles. When you load a 480x272px PNG as backgroundimage
  in your application (maybe you'll use the screenshot function?) , 
  your programm will load and run much faster!

  
5.2  L u a  W e b t i p p s :

  English:
   http://lua-users.org/
   http://www.lua.org/
  
  Deutsch:
   http://lua.gts-stolberg.de/
   http://www.bumucklzone.de.vu/

  Get the LuaPlayer for Windows:
   http://luaplayer.org/downloads/lp20/luaplayerwindows-0.20.zip

  You can meet me at
   http://www.pspsource.de




-------------------------------------------------------------------------------------------------------------------------------------------------- 