Categories: Symbian C++ | How To | Customization | Screen Savers | Graphics

This page was last modified 18:15, 24 March 2008.

From Forum Nokia Wiki

Steps to be followed to create a screensaver

Header files:

#include <screensaverpluginintdef.h>
#include <ImplementationProxy.h>

Libraries:

• euser.lib
• efsrv.lib
• cone.lib
• ECom.lib

In mmp-file:

TARGET        YourScreenSaverName.dll
TARGETTYPE    PLUGIN
UID           0x10009D8D 0xEA005C44

Don't forget to change dll-name and UID3.

Required capabilities:

• NetworkServices
• LocalServices
• Location
• ReadUserData
• WriteUserData
• ReadDeviceData
• WriteDeviceData
• SwEvent
• UserEnvironment
• PowerMgmt

Extend your class from CScreensaverPluginInterfaceDefinition

As the M Class MScreensaverPlugin is inherited by CScreensaverPluginInterfaceDefinition, implement the following virtual methods:

TInt InitializeL(MScreensaverPluginHost* aHost);
    TInt Draw(CWindowGc& aGc);
    TInt HandleScreensaverEventL(TScreensaverEvent aEvent, TAny* aData);

InitializeL() : This is used to initialize the plugin module after creation.Here you can personalize your screensaver:

• Set screensaver application to use standard indicator view.
• To override the standard indicator view, notify plugin host that plugin module is going to take care of drawing indicator view
• Set timeout value for refresh timer. Plugin module's draw method is called every time when refresh timer expires
• Activate screensaver partial mode.Partial mode area specifies an area on the screen where screensaver plugin module is going to draw during next refresh period
• Request screen backlight to be turned on or off, etc..

Draw(): When a plugin module is active this method is called every time when refresh timer expires in screensaver application.Here you can draw to the screen. You can change display partial mode in this method too.

HandleScreensaverEventL() : This is the handler function for screensaver events like start, stop, event timed out, etc..

Code Examples

• Image:Screensaver.zip
• Image:Sss.zip

Internal Links

Simple Screen Saver (EN)

External Links

• s60 3rd. edition: writing a screensaver.