Twelve Walls Module v.3, by ci0ud

CAUTION: THIS PROGRAM WRITES TO THE FLASH, USE IT UNDER YOUR OWN RESPONSIBILITY. IT ONLY HAS BEEN TESTED IN 3.03 OE-C, 3.10 OE-A AND 3.10 OE-A' FIRMWARES.


----------
CHANGE LOG
----------

v.3

- Now the module read the configuration in a .txt file (Read down for more details)

- New random function. If you enable it, each month the wallpaper will be one chosen randomly

- If the "No" file isn't in its place the module will create it

V.2

- If the wallpaper's size is bigger than the maximum allowed, the module would not have to flash it


------
README
------

- What does this module do?

This module is for those who use wallpapers too big to be mixed in one file (It also can be used with small wallpapers and have more free space in the flash). Each month the module will copy to the flash the corresponding wallpaper.

- Can this program cause a brick to my PSP?

There's always risk accessing to the flash. This program will only access to the 01-12.bmp file so in theory it couldn't cause a total brick. But, if you don't feel secure the better option to prevent a brick is don't use this program :)


------------
INSTALLATION
------------

- Copy twelve.prx to the <MEMORY_STICK>:\seplugins folder

- Edit (or create) the following file,

  <MEMORY_STICK>:\seplugins\vsh.txt

  In it add a new line (at the top) that reads,

  ms0:/seplugins/twelve.prx

- Copy to where you specifies in the txt (SourceFolder) the following file

  No (This file is essential, without it the module won't work)

- Copy the wallpaper files (Named as you set in the txt file) to the same folder than No

- Restart the PSP (holding R) to enter Recovery Mode

- In the Plugins-> section enable the twelve.prx in the [VSH] then go Back and Exit

- After enable the module, go to the theme setting and choose the WHITE theme that under the Original theme and then reset


CAUTION: Be sure the wallpaper files are 300X170 and 150Kb as maximum and exactly 24 bits of resolution



-------------
CONFIGURATION
-------------

You can customize certain parts of this module to your liking using the twelve.txt file that is in the <MEMORY_STICK>:\seplugins folder. Be sure all the lines ends with ; and there is an empty space after =

The following settings are available:

- SourceFolder

	This is the location on the PSP where the files are (Don't forget to write / at the end of the path)
	The default if twelve.txt isn't in its place is SourceFolder = ms0:/PICTURE/WALLS/;
	It's not advisable to use flash0:/ or flash1:/ AS THIS MAY BRICK YOUR PSP!

- File N

	Here you set the name of the wallpapers (N is the number of the month). Don't forget the extension (It MUST be .bmp)
	File 1 = 01.bmp; Is the default name of the first image
	File 2 = 02.bmp; Is the default name of the second image and thus the rest of the files

- RandomWall

	With this option you enable the random function. To enable it you only need to write YES; 
	The default is RandomWall = NO;



---
FAQ
---

- After the module changed the wallpaper some icons are now white, why?

The reason is the size of the image, with a smaller image this doesn't happen but evidently the quality is smaller. Between 220x125 and 200x113 all goes well, so unfortunately you should choose an image with a great quality and white icons, or normal icons with an image poorer
If you have a non original topmenu_plugin.rco (modified) it doesn't happen, but it isn't possible in 3.10 firmware

- I have a white wallpaper after a change

Check the image size and the resolution. Remember, 300X170 and 150Kb as maximum and exactly 24 bits of resolution. It also could be repair doing this: After enable the module, go to the theme setting and choose the WHITE theme under the Original theme (Perhaps you have to reset the PSP). Look also the next question

- I have upgraded/downgrade to a new firmware and now the module doesn't work

Remove the "No" file and go to Recovery Mode (Restart the PSP holding R) and in the Plugins-> section enable the twelve.prx in the [VSH] then go Back and Exit. did you disable all the plugins before you made the upgrade/downgrade?

- What does it happen if I disable the module?

Nothing, the current wallpaper will continue there until you change the 01-12.bmp file



----
TODO
----

- Go back to the previous wallpaper you had before use the module if you want to disable it



THANKS TO ADePSP FOR THE HELP