Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Implementing wallpaper applications

Wallpaper applications are typically implemented as follows:

  1. Query the device to determine which image formats are supported.

    Applications can call IWallpaper_MimeSupport() to query whether the device supports specific image formats. Alternatively, applications can enumerate the minX, minY, maxX, maxY, maxSize, anim and bitDepth settings keys to get more specific information about any constraints that may exist on the device.

  2. Using the information queried from the device, allow the user to browse the suitable wallpapers from the online catalog.
  3. When the user decides to download a particular wallpaper, the application should download the image file to a suitable directory on the device file system.

    To learn which directories are suitable, the application should enumerate the children beneath the wpDirs/protected and wpDirs/unprotected subtrees. Paid content should be downloaded to one of the protected directories. These directories will generally be locked Multimedia Content File (MCF) directories and are therefore protected by Serial Port Access Restrictions (SPAR) and Access Control Lists (ACL).

  4. After the wallpaper is downloaded, and if the user elects to immediately make the wallpaper active, call IWallpaper_SetWallpaper() to activate the wallpaper.