Series60 demo, 'PixelFont_S60'

This demo is based on a as-fast-as-possible hack of the S60 1.2 SDK example application called 'multiviews'. This for one thing means that the application is still called multiviews :-).

SIS - Tested on a Siemens SX1 (64k colours). Please note that the PixelFont.dll in this sis is almost guaranteed to be an older version than the source package below will build.

Source v0.1 – You will need the project sources to build PixelFont.dll itself.

S o u r c e

The source has of time beeing been developed and tested on a Series60 SDK version 1.2, and a Siemens SX1 only. Version independence from Symbian OS versions, SDK versions, UIQ/S60 and their versions, color depths etc etc is therefore non-existent at the moment.

There are in total 4 projects in the source zip file, and a little intro as to what goes where and why is given here :

\DebugUtil

A debugger utility. Place it in development root, build it for wins and thumb and you can basically forget about it again.

\PixelFont

Contains at least the following 3 central projects.

PixelFont : The runtime dll for both target and emulator. Note that the font files are expected to be in c:\system\data\PixelFont\ on target which equals \Epoc32\Wins\c\system\data\PixelFont\ on the emulator.

PixelFontConverterExe : An .exe console application used for generation of the .inf files required by the PixelFont.dll. The .exe is intended for emulator only. It expects the source bitmap files to be in \Epoc32\Wins\c\system\data\PixelFontSource\ (*) and it places the output files in \Epoc32\Wins\c\system\data\PixelFont\ (*). The .exe supports a commandline and can be used as a windows executable if executed from within a commandshell in the directory \epoc32\release\wins\udeb\.
(*) The paths are defined in the 'PixelFontBuild.h', see below.

PixelFontTestExe : Also an .exe console application intended for emulator only. This is the one that is used for the screen captures shown all over the place. Its a fast way to verify new fonts and the workings of the BitmapFont dll.

Things to do as well :
- Manually copy the file \PixelFont\inc\PixelFontBuild\PixelFontBuild.h to the system include directory \epoc32\include\. Have a look at the readme next to the include file for an explanation why.
- There are some ready-to-convert fonts in \PixelFont\PixelFontSource\. You have to manually copy those to \Epoc32\Wins\c\system\data\PixelFontSource\ and while you are at it also make the directory \Epoc32\Wins\c\system\data\PixelFont\. Then execute the batch jobs in the source directory in order to make the .MBM files and execute 'PixelFontConverterExe' to convert the files. If .MBM files and .INF files for each of the fonts are now present in the ...\PixelFont\ directory then hopefully the fonts are ready to use.

Other stuff :
Currently there is a linear fade-in/fade-out project subclassing PixelFont in the workings. Try it out if you want to. Feel free to add displacement if you feel the need to do so :-) Then the base is laid for some cool eye-candy....

License :
The source for PixelFont is released under the LGPL licence. See http://creativecommons.org/licenses/LGPL/2.1/ for a human-readable version of the LGPL. See http://www.gnu.org/copyleft/lesser.html for the actual LGPL license.

Sources :
PixelFontSources_0_5.zip

If you intend to make nontrivial fixes or features then please request the latest sources.

D o x y g e n

Please be aware that the online doxygen documentation per definition is in some kind of undefined out-of-date state. If you can live with that then have a peek Here

The source file package contains the doxygen configuration file if you want to make sure you are up to date.