[RELEASE] Twelve Walls Module v.3

[ci0ud]

After several delays, here are the third version. I haven't been able to release it before because of lack of time. I leave here the readme:

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>:\seplugi ns 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>:\seplugi ns 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

[Proxin]

What is the max resolution of the wallpapers you can put on it?

Edit: Nvm. Sorry.

[Spirit Hawk Leon]

So is there anyway to have full sized wallpapers? =/

[The_Kills]

This is awsome! CUstom wallpaper themes for each month, instead of just all plain black or just 1 type. Really convienient to use

[anonymous_349]

Nice brew. just needs a lil more work on the readme.txt IMHO.
My suggestion is to be more specific and clearer next time.
It would also help to give pointers out like the date settings, exact size of the .bmp file, warnings for possible XMB icon(s) curroptions and the MOST important of all, flash0 space. have something in bold or something that stands out that says be sure to have sertain available space to flash0 if flashing x12 150kb files. Because in some peoples cases. They have custom sounds, gameboots, bootsounds, etc... that would take some room up in their flash0 that after this plug in is installed the flash0 runs out of space and creates un-wanted effects such as MORE bad XMB icons, no click sound on XBM and even in my case a semi-brick (Thank god for DA's recovery).
Also, it would be a good idea to have a requirement list (Minimum req. and reccomended req. etc...)

Anyhooz, Well done and thnx!

[kamui2511]

this doesn't really support the new version 3.30OEA on my PSP. Could you have a way to make this plug in work?

[Anti-QuickJay]

Good job on the release!

[TiagoUndead]

Man, I have tried this in a 3.30OE, but don't work... You don't like to release a new version compatible with the new CFWs like 3.30OE or 3.40OE?