Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

makeqpf

Due to performance or size constraints on the device there may be a need to convert the installed Qt/Embedded fonts into Qt Pre-rendered Font (QPF) font files. The makeqpf tool can be used to convert a True-type Font (TTF) or Bitmap Distribution Format (BDF) font into a QPF font taking into account:

• display transformation(rotation)
• the symbol ranges required

The makeqpf requires certain macros to be (un)defined. If Qt/Embedded is configured with "-qconfig makeqpf" the file $QTDIR/src/tools/qconfig-makeqpf.h defines all required macros. As a result:

• QT_NO_QWS_TRANSFORMED and QT_NO_QWS_SAVEFONTS are not defined
• QT_TRANSFORM_VFB is defined to enable transformed QVFb support
• QT_NO_BDF is defined so that BDF font files can be converted
• QT_NO_FREETYPE is defined so that TTF font files can be converted

For a description of all features in Qt/Embedded see The Feature Definition File

Warning: If TTF support is allowed then the freetype development headers libraries need to be available.

To build makeqpf using a Qtopia 2.2.x source package

tar -xzvf qtopia-p*-src-*.tar.gz
cd qtopia-p*-2*
./configure
cd qt2
export QTDIR=$PWD
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
QPEDIR=$QTDIR ./configure -embedded -no-xft -no-sm -qconfig makeqpf -static -qvfb -depths 8,16,24,32 \
-I3rdparty/freetype/src -I3rdparty/freetype/include -I3rdparty/freetype/builds/unix
make sub-src
echo "Build makeqpf"
make -C tools/makeqpf
cd ..
echo "Build QVFb"
make qt2


To build makeqpf using a Qt/Embedded source package:

./configure -qconfig makeqpf [extra options]
make
make -C tools/makeqpf


QWS fonts

Makeqpf, like any other Qt/Embedded application, relies on $QTDIR/lib/fonts/fontdir to correctly list the available fonts. For more information see QWS Fonts.

To add a new font for use by Qt/Embedded edit the $QTDIR/lib/fonts/fontdir file then run either makeqpf or makeall.

Usage

• -A - Render and save all fonts in fontdir
• -f - File of lines: fontname character-ranges e.g. "smoothtimes 0-ff,20a0-20af"
• font - Font to render and save

For example, to convert all symbols in the "fixed" font into a QPF font, for all rotations then run :

./makeall fixed

A more complicated example is to make a "fixed" font with the currency symbols

• create a file fontlist with the line eg:
cd $QTDIR/tools/makeqpf
echo "fixed 0-ff,20a0-20af" > fontlist
• Specify in $QWS_DISPLAY a transformed driver eg:
export QWS_DISPLAY=Transformed
• If you need to generate fonts for all rotations then you can make use of the script makeall eg:
./makeall -f fontlist
  
• If only the current rotation is being used then run:
./makeqpf -f fontlist

See also ./makeqpf --help

Hint:Press <CTRL>-Q should you wish to quit makeqpf.