release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Search | Go
Wiki > Main > DocsIndex > CustomWPS > BackgroundWPS

Background WPS feature

(This page is because some info needs to get written to be copied into the manual... and to get themes using it until then...)

What?

The idea behind this feature is to pretty up the statusbar... it lets you display anything from the WPS in an area outside of the rest of the UI. This will be put in (if accepted...) after FS#8799 which lets you choose where to place the UI (menus/lists/etc) in the screen (so it could be centered with a margin, or only the top half or whatever.) This addition will then put the WPS in the rest of the screen.

How?

firstly, this will be controlled by a .cfg-only (i.e hidden) setting in the themes config file, and it will default to off (minimal work for existing themes). Themes will need to do the following:
  • Add a line to the .cfg to enable the background updating
  • Setup the UI viewport
  • Fix the .wps so it doesnt try to draw in the UI viewport... if it does it wont work. This means use the %wM conditional tag to disable the viewport you want to put the ui in.

Limitations

  • The wps and UI use 2 different background images... this could be a bad thing, or maybe not... when the wps is in the background mode it will use the background image from the UI... probably wont be fixed
  • it is entirely up to the .wps to make sure the UI viewport isnt drawn over... there will be a wps tag to use with conditionals to make solve this.
Other than that I cant think of anything that needs to be mentinoed.. All wps tags should work, except the peak bars probably will look crap if used because the update rate drops to 1/4s (or so)

save and finish later

A paragraph of text
r4 - 28 May 2009 - 03:51:41 - JonathanGordon

Parents: DocsIndex > CustomWPS
Copyright by the contributing authors.