qfontmanager_qws.h Include File

Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# qfontmanager_qws.h

This is the verbatim text of the qfontmanager_qws.h include file. It is provided only for illustration; the copyright remains with Trolltech.

    /****************************************************************************
    ** $Id: qt/qfontmanager_qws.h   3.3.8   edited Jan 11 14:38 $
    **
    ** Definition of font rendering infrastructure for Embedded Qt
    **
    ** Created : 940721
    **
    ** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
    **
    ** This file is part of the kernel module of the Qt GUI Toolkit.
    **
    ** This file may be used under the terms of the GNU General Public
    ** License versions 2.0 or 3.0 as published by the Free Software
    ** Foundation and appearing in the file LICENSE.GPL included in the
    ** packaging of this file. Alternatively you may (at your option) use any
    ** later version of the GNU General Public License if such license has
    ** been publicly approved by Trolltech ASA (or its successors, if any)
    ** and the KDE Free Qt Foundation.
    **
    ** Please review the following information to ensure GNU General
    ** Public Licensing requirements will be met:
    ** http://trolltech.com/products/qt/licenses/licensing/opensource/.
    ** If you are unsure which license is appropriate for your use, please
    ** review the following information:
    ** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
    ** or contact the sales department at sales@trolltech.com.
    **
    ** Licensees holding valid Qt Commercial licenses may use this file in
    ** accordance with the Qt Commercial License Agreement provided with
    ** the Software.
    **
    ** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
    ** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
    ** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
    ** herein.
    **
    **********************************************************************/

    #ifndef QFONTMANAGER_QWS_H
    #define QFONTMANAGER_QWS_H

    #ifndef QT_H
    #include "qfont.h"
    #include "qptrlist.h"
    #include <private/qtextengine_p.h>
    #endif // QT_H

    // These are stored in the shared memory segment in front of their
    // data, and indexed at the start of the segment

    // This needs to be a multiple of 64 bits

    class QFontDef;

    class Q_PACKED QGlyphMetrics {

    public:
        Q_UINT8 linestep;
        Q_UINT8 width;
        Q_UINT8 height;
        Q_UINT8 flags;

        Q_INT8 bearingx;      // Difference from pen position to glyph's left bbox
        Q_UINT8 advance;       // Difference between pen positions
        Q_INT8 bearingy;      // Used for putting characters on baseline

        Q_INT8 reserved;      // Do not use

        // Flags:
        // RendererOwnsData - the renderer is responsible for glyph data
        //                    memory deletion otherwise QGlyphTree must
        //                    delete [] the data when the glyph is deleted.
        enum Flags { RendererOwnsData=0x01 };
    };

    class QGlyph {
    public:
        QGlyph() { metrics=0; data=0; }
        QGlyph(QGlyphMetrics* m, uchar* d) :
    	metrics(m), data(d) { }
        ~QGlyph() {}

        QGlyphMetrics* metrics;
        uchar* data;
    };

    class QFontFactory;
    class QDiskFont;

    // This is a particular font instance at a particular resolution
    // e.g. Truetype Times, 10 point. There's only one of these though;
    // we want to share generated glyphs

    class QRenderedFont {

    public:

        // Normal font-type is monochrome; glyph data is a
        //   bitmap, which doesn't use much memory

        // Initialise for name A, renderer B, font type C, D glyphs

        QRenderedFont(QDiskFont *,const QFontDef&);
        virtual ~QRenderedFont();

        QFontDef fontDef() const;

        int refcount;

        int ptsize;

        bool italic;
        unsigned int weight;

        void ref() { refcount++; }
        bool deref() { refcount--; return refcount==0; }

        bool match(const QFontDef &);

        QDiskFont* diskfont;
        int fascent,fdescent;
        int fleftbearing,frightbearing;
        int fmaxwidth;
        int fleading;
        int funderlinepos;
        int funderlinewidth;
        bool smooth;
        int maxchar;

        int ascent() { return fascent; }
        int descent() { return fdescent; }
        int width(int);
        int width( const QString&, int =-1 );
        int leftBearing(int);
        int rightBearing(int);

        // Calling any of these can trigger a full-font metrics check
        // which can be expensive
        int minLeftBearing();
        int minRightBearing();
        int maxWidth();

        virtual bool inFont(glyph_t g) const=0;
        virtual QGlyph render(glyph_t g)=0;

    private:

    };

    // Keeps track of available renderers and which font is which

    class QDiskFontPrivate {};

    class QDiskFont {

    public:
        QDiskFont(QFontFactory *f, const QString& n, bool i, int w, int s,
    	      const QString &fl, const QString& fi) :
    	factory(f), name(n), italic(i), weight(w), size(s), flags(fl), file(fi)
        {
    	loaded=FALSE;
    	p=0;
        }

        QRenderedFont* load(const QFontDef &);

        QFontDef fontDef() const;

        QFontFactory *factory;
        QString name;
        bool italic;
        int weight;
        int size;
        QString flags;
        QString file;
        bool loaded;

        QDiskFontPrivate * p;
    };

    class QCachePolicy {

    public:

        virtual void cache(QRenderedFont *)=0;
        virtual void uncache(QRenderedFont *)=0;

    };

    // Exposed here so the default policy can be reset

    class QDefaultCachePolicy : public QCachePolicy {

    public:

        virtual void cache(QRenderedFont *);
        virtual void uncache(QRenderedFont *);

    };

    class QFontManager {

    public:

        QPtrList<QFontFactory> factories;
        QPtrList<QRenderedFont> cachedfonts;
        QPtrList<QDiskFont> diskfonts;

        QFontManager();
        ~QFontManager();

        // Font definition, type and color
        QDiskFont * get(const QFontDef &);

        static int cmpFontDef(const QFontDef & goal, const QFontDef & choice);

        static void initialize();
        static void cleanup();

        void setPolicy(QCachePolicy *);

        void cache(QRenderedFont * f) { policy->cache(f); }
        void uncache(QRenderedFont * f) { policy->uncache(f); }
        QRenderedFont * getCached(const QFontDef &);

    private:

        QCachePolicy * policy;

    };

    class QFontFactory {

    public:

        QFontFactory() {}
        virtual ~QFontFactory() {}

        virtual QRenderedFont * get(const QFontDef &,QDiskFont *)=0;
        virtual void load(QDiskFont *) const=0;
        virtual void unload(QDiskFont *) {}
        virtual QString name()=0;
    };

    void qt_init_fonts();

    extern QFontManager * qt_fontmanager;

    #endif