QBasicUnixFontDatabase Class Reference

#include <qbasicunixfontdatabase.h>

Inheritance diagram for QBasicUnixFontDatabase:

Public Functions
QStringList	addApplicationFont (const QByteArray &fontData, const QString &fileName)
	Adds an application font described by the font contained supplied fontData or using the font contained in the file referenced by fileName. More...
QStringList	fallbacksForFamily (const QString family, const QFont::Style &style, const QFont::StyleHint &styleHint, const QUnicodeTables::Script &script) const
	Returns a list of alternative fonts for the specified family and style and script using the styleHint given. More...
QFontEngine *	fontEngine (const QFontDef &fontDef, QUnicodeTables::Script script, void *handle)
	Returns the font engine that can be used to render the font described by the font definition, fontDef, in the specified script. More...
void	populateFontDatabase ()
	This function is called once at startup by Qts internal fontdatabase. More...
void	releaseHandle (void *handle)
	Releases the font handle and deletes any associated data loaded from a file. More...
Public Functions inherited from QPlatformFontDatabase
virtual QString	fontDir () const
	Returns the path to the font directory. More...
virtual QFontEngine *	fontEngine (const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference)

Static Public Functions
static QStringList	addTTFile (const QByteArray &fontData, const QByteArray &file)
Static Public Functions inherited from QPlatformFontDatabase
static void	registerFont (const QString &familyname, const QString &foundryname, QFont::Weight weight, QFont::Style style, QFont::Stretch stretch, bool antialiased, bool scalable, int pixelSize, const QSupportedWritingSystems &writingSystems, void *handle)
	Registers a font with the given set of attributes describing the font's foundry, family name, style and stretch information, pixel size, and supported writing systems. More...
static void	registerQPF2Font (const QByteArray &dataArray, void *handle)
	Registers the pre-rendered QPF2 font contained in the given dataArray. More...

Detailed Description

Definition at line 55 of file qbasicunixfontdatabase.h.

Functions

addApplicationFont()

QStringList QBasicUnixFontDatabase::addApplicationFont ( const QByteArray &  fontData, const QString &  fileName  )

virtual

Adds an application font described by the font contained supplied fontData or using the font contained in the file referenced by fileName.

Returns a list of family names, or an empty list if the font could not be added.

Note

The default implementation of this function does not add an application font. Subclasses should reimplement this function to perform the necessary loading and registration of fonts.

Reimplemented from QPlatformFontDatabase.

Definition at line 249 of file qbasicunixfontdatabase.cpp.

{
    return addTTFile(fontData,fileName.toLocal8Bit());
}

addTTFile()

QStringList QBasicUnixFontDatabase::addTTFile ( const QByteArray &  fontData, const QByteArray &  file  )

static

Definition at line 260 of file qbasicunixfontdatabase.cpp.

Referenced by addApplicationFont(), and populateFontDatabase().

{
    extern FT_Library qt_getFreetype();
    FT_Library library = qt_getFreetype();

    int index = 0;
    int numFaces = 0;
    QStringList families;
    do {
        FT_Face face;
        FT_Error error;
        if (!fontData.isEmpty()) {
            error = FT_New_Memory_Face(library, (const FT_Byte *)fontData.constData(), fontData.size(), index, &face);
        } else {
            error = FT_New_Face(library, file.constData(), index, &face);
        }
        if (error != FT_Err_Ok) {
            qDebug() << "FT_New_Face failed with index" << index << ":" << hex << error;
            break;
        }
        numFaces = face->num_faces;

        QFont::Weight weight = QFont::Normal;

        QFont::Style style = QFont::StyleNormal;
        if (face->style_flags & FT_STYLE_FLAG_ITALIC)
            style = QFont::StyleItalic;

        if (face->style_flags & FT_STYLE_FLAG_BOLD)
            weight = QFont::Bold;

        QSupportedWritingSystems writingSystems;
        // detect symbol fonts
        for (int i = 0; i < face->num_charmaps; ++i) {
            FT_CharMap cm = face->charmaps[i];
            if (cm->encoding == ft_encoding_adobe_custom
                    || cm->encoding == ft_encoding_symbol) {
                writingSystems.setSupported(QFontDatabase::Symbol);
                break;
            }
        }

        TT_OS2 *os2 = (TT_OS2 *)FT_Get_Sfnt_Table(face, ft_sfnt_os2);
        if (os2) {
            quint32 unicodeRange[4] = {
                quint32(os2->ulUnicodeRange1), quint32(os2->ulUnicodeRange2),
                quint32(os2->ulUnicodeRange3), quint32(os2->ulUnicodeRange4)
                    };
            quint32 codePageRange[2] = {
                quint32(os2->ulCodePageRange1), quint32(os2->ulCodePageRange2)
                    };

            writingSystems = determineWritingSystemsFromTrueTypeBits(unicodeRange, codePageRange);
        }

        QString family = QString::fromAscii(face->family_name);
        FontFile *fontFile = new FontFile;
        fontFile->fileName = file;
        fontFile->indexValue = index;

        QFont::Stretch stretch = QFont::Unstretched;

        registerFont(family,"",weight,style,stretch,true,true,0,writingSystems,fontFile);

        families.append(family);

        FT_Done_Face(face);
        ++index;
    } while (index < numFaces);
    return families;
}

fallbacksForFamily()

QStringList QBasicUnixFontDatabase::fallbacksForFamily ( const QString  family, const QFont::Style &  style, const QFont::StyleHint &  styleHint, const QUnicodeTables::Script &  script  ) const

virtual

Returns a list of alternative fonts for the specified family and style and script using the styleHint given.

Reimplemented from QPlatformFontDatabase.

Reimplemented in QFontconfigDatabase.

Definition at line 240 of file qbasicunixfontdatabase.cpp.

{
    Q_UNUSED(family);
    Q_UNUSED(style);
    Q_UNUSED(styleHint);
    Q_UNUSED(script);
    return QStringList();
}

fontEngine()

QFontEngine * QBasicUnixFontDatabase::fontEngine ( const QFontDef &  fontDef, QUnicodeTables::Script  script, void *  handle  )

virtual

Returns the font engine that can be used to render the font described by the font definition, fontDef, in the specified script.

Reimplemented from QPlatformFontDatabase.

Reimplemented in QFontconfigDatabase.

Definition at line 210 of file qbasicunixfontdatabase.cpp.

{
    QFontEngineFT *engine;
    FontFile *fontfile = static_cast<FontFile *> (usrPtr);
    QFontEngine::FaceId fid;
    fid.filename = fontfile->fileName.toLocal8Bit();
    fid.index = fontfile->indexValue;
    engine = new QFontEngineFT(fontDef);

    bool antialias = !(fontDef.styleStrategy & QFont::NoAntialias);
    QFontEngineFT::GlyphFormat format = antialias? QFontEngineFT::Format_A8 : QFontEngineFT::Format_Mono;
    if (!engine->init(fid,antialias,format)) {
        delete engine;
        engine = 0;
        return engine;
    }
    if (engine->invalid()) {
        delete engine;
        engine = 0;
    } else if (scriptRequiresOpenType(script)) {
        HB_Face hbFace = engine->harfbuzzFace();
        if (!hbFace || !hbFace->supported_scripts[script]) {
            delete engine;
            engine = 0;
        }
    }

    return engine;
}

populateFontDatabase()

void QBasicUnixFontDatabase::populateFontDatabase ( )

virtual

This function is called once at startup by Qts internal fontdatabase.

Reimplement this function in a subclass for a convenient place to initialise the internal fontdatabase.

The default implementation looks in the fontDir() location and registers all qpf2 fonts.

Reimplemented from QPlatformFontDatabase.

Reimplemented in QFontconfigDatabase.

Definition at line 188 of file qbasicunixfontdatabase.cpp.

{
    QPlatformFontDatabase::populateFontDatabase();
    QString fontpath = fontDir();

    if(!QFile::exists(fontpath)) {
        qFatal("QFontDatabase: Cannot find font directory %s - is Qt installed correctly?",
               qPrintable(fontpath));
    }

    QDir dir(fontpath);
    dir.setNameFilters(QStringList() << QLatin1String("*.ttf")
                       << QLatin1String("*.ttc") << QLatin1String("*.pfa")
                       << QLatin1String("*.pfb"));
    dir.refresh();
    for (int i = 0; i < int(dir.count()); ++i) {
        const QByteArray file = QFile::encodeName(dir.absoluteFilePath(dir[i]));
//        qDebug() << "looking at" << file;
        addTTFile(QByteArray(), file);
    }
}

releaseHandle()

void QBasicUnixFontDatabase::releaseHandle ( void *  handle )

virtual

Releases the font handle and deletes any associated data loaded from a file.

Reimplemented from QPlatformFontDatabase.

Definition at line 254 of file qbasicunixfontdatabase.cpp.

{
    FontFile *file = static_cast<FontFile *>(handle);
    delete file;
}

---

The documentation for this class was generated from the following files:

• /src/plugins/platforms/fontdatabases/basicunix/qbasicunixfontdatabase.h
• /src/plugins/platforms/fontdatabases/basicunix/qbasicunixfontdatabase.cpp