 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-

		PuzzleShuffle vo.2

		by: luckymouse

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-


 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-

		1. Introduction
		2. About
		3. Contents + controls
		4. Added functions
		5. Creating your own puzzles
		6. Credits

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   1. Introduction
 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
Somewhere in November 2005 I decided to publicly 
release one of my first lua apps:
PuzzleShuffle vo.1

I then said that one day there would be a 
PuzzleShuffle vo.2. But that day never came;
I grew bored of my psp and lua.

But a few days ago I came across the old files of
v0.1 and decided to rewrite it. This resulted in
vo.2, now being released. roughly 1.5 years after
v0.1 was released

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   2. About	
 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
Well what is this app ? Basicly it's an app that 
lets you play.. slide puzzles. Exciting isn't it?

The only thing I'm happy about is the Save/load
option. The only thing I wanted to add anyway :P

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   3. Contents + controls
 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   [Puzzle Select screen]
   [ x  ] Play puzzle
   [ [] ] Load savefile for puzzle
   [ O  ] Next Page
   [ /\ ] While on page 2 and above:
          Previous Page
	  while on page 1:
	  Enter puzzle creation screen
   [ R  ] Next Puzzle
   [ L  ] Previous Puzzle
   [ se ] delete current puzzle :(
   [ st ] exit
   
   [dpad] Edit configurations

   [Puzzle screen]
   [ x  ] --
   [ [] ] Save current progress
   [ O  ] --
   [ /\ ] exit puzzle
   [ R  ] Show finished puzzle
   [ L  ] Show finished puzzle
   [ se ] Show finished puzzle
   [ st ] --
   
   [dpad] Move around the puzzle :P

   [Puzzle creation screen #1]
   [ x  ] select file / directory
   [ [] ] --
   [ O  ] --
   [ /\ ] --
   [ R  ] --
   [ L  ] --
   [ se ] exit to Puzzle select
   [ st ] --
   
   [dpad] Move around the file cursor

   [Puzzle creation screen #3]
   [dpad] Move around the Image
   [dpad]+[ R  ] Move Thumbnail border
   [dpad]+[ L  ] Move Puzzle border
   [dpad]+[ R  ]+[ L  ] Move Selection Image border..

   [Puzzle creation screen #4]
   [ /\ ] Exit back to Puzzle Select
   [ L  ] Whilest Text-input window is active:
          backspace

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   4. Added functions
 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   [] Save / Load option
   [] Create Puzzle option
   [] Timer function // 'high-score' function
   [] Modify Number of Tiles per Puzzle
   [] Tile spacing
   [] Moving tile: transparent or transparent bordered

 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   5. Creating your own puzzles
 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
Although there is an option to do this in the app
itself I'd like to devote a bit of .txt space to 
it. Why ? because the function might error out,
a lot.

You can only use .jpg and .png as puzzle images 
when using the puzzle creation option in the app.
Aside from this, these images should not be larger
that 500x500 pixels. Why ? Lua can't load anything
bigger than that. Well maybe it can, but I don't 
feel like pinning down the exact number of pixels
right now. 

If you dont feel comfortable using this option,
you can always create one yourself.
Here is how:

- create a 260x260 image called p*yourname*.png
  and put it in Img/puzzles/
  This will be the puzzle itself.
- create a 198x21 image called s*yourname*.png
  and put it in Img/selection/
  This will be the little image in the menu
- create a 204x116 image called t*yourname*.png
  and put it in Img/thumb/
  this will be the little image shown under the
  menu

	*note: these all have to be .png*

- open puzzles.txt and add a new line with *yourname*
  example:

  001\n
  002\n
  003\n
  004\n
  MyAweSomeNewPuzzle

  '\n' represents a new line. Make sure that you
  don't hit 'enter'/'newline' after adding your
  name


 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
   6. Credits
 _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
I'd like to thank everyone who has made it 
possible for people to run lua scrips on psp's.

And additionly I'd like to thank LuMo for his 
str_explode function