/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the QtGui module of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef QFONT_H

#define QFONT_H

#include <QtGui/qwindowdefs.h>

#include <QtCore/qstring.h>

#include <QtCore/qsharedpointer.h>

#if defined(Q_WS_X11) || defined(Q_WS_QWS)

typedef struct FT_FaceRec_* FT_Face;

#endif

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

class QFontPrivate;                                     /* don't touch */

class QStringList;

class QVariant;

class Q3TextFormatCollection;

class Q_GUI_EXPORT QFont

{

    Q_GADGET

    Q_ENUMS(StyleStrategy)

public:

    enum StyleHint {

        Helvetica,  SansSerif = Helvetica,

        Times,      Serif = Times,

        Courier,    TypeWriter = Courier,

        OldEnglish, Decorative = OldEnglish,

        System,

        AnyStyle

    };

    enum StyleStrategy {

        PreferDefault    = 0x0001,

        PreferBitmap     = 0x0002,

        PreferDevice     = 0x0004,

        PreferOutline    = 0x0008,

        ForceOutline     = 0x0010,

        PreferMatch      = 0x0020,

        PreferQuality    = 0x0040,

        PreferAntialias  = 0x0080,

        NoAntialias      = 0x0100,

        OpenGLCompatible = 0x0200,

        NoFontMerging    = 0x8000

    };

    enum Weight {

        Light    = 25,

        Normal   = 50,

        DemiBold = 63,

        Bold     = 75,

        Black    = 87

    };

    enum Style {

        StyleNormal,

        StyleItalic,

        StyleOblique

    };

    enum Stretch {

        UltraCondensed =  50,

        ExtraCondensed =  62,

        Condensed      =  75,

        SemiCondensed  =  87,

        Unstretched    = 100,

        SemiExpanded   = 112,

        Expanded       = 125,

        ExtraExpanded  = 150,

        UltraExpanded  = 200

    };

    enum Capitalization {

        MixedCase,

        AllUppercase,

        AllLowercase,

        SmallCaps,

        Capitalize

    };

    enum SpacingType {

        PercentageSpacing,

        AbsoluteSpacing

    };

    enum ResolveProperties {

        FamilyResolved         = 0x0001,

        SizeResolved           = 0x0002,

        StyleHintResolved      = 0x0004,

        StyleStrategyResolved  = 0x0008,

        WeightResolved         = 0x0010,

        StyleResolved          = 0x0020,

        UnderlineResolved      = 0x0040,

        OverlineResolved       = 0x0080,

        StrikeOutResolved      = 0x0100,

        FixedPitchResolved     = 0x0200,

        StretchResolved        = 0x0400,

        KerningResolved        = 0x0800,

        CapitalizationResolved = 0x1000,

        LetterSpacingResolved  = 0x2000,

        WordSpacingResolved    = 0x4000,

        AllPropertiesResolved  = 0x7fff

    };

    QFont();

    QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false);

    QFont(const QFont &, QPaintDevice *pd);

    QFont(const QFont &);

    ~QFont();

    QString family() const;

    void setFamily(const QString &);

    int pointSize() const;

    void setPointSize(int);

    qreal pointSizeF() const;

    void setPointSizeF(qreal);

    int pixelSize() const;

    void setPixelSize(int);

    int weight() const;

    void setWeight(int);

    inline bool bold() const;

    inline void setBold(bool);

    void setStyle(Style style);

    Style style() const;

    inline bool italic() const;

    inline void setItalic(bool b);

    bool underline() const;

    void setUnderline(bool);

    bool overline() const;

    void setOverline(bool);

    bool strikeOut() const;

    void setStrikeOut(bool);

    bool fixedPitch() const;

    void setFixedPitch(bool);

    bool kerning() const;

    void setKerning(bool);

    StyleHint styleHint() const;

    StyleStrategy styleStrategy() const;

    void setStyleHint(StyleHint, StyleStrategy = PreferDefault);

    void setStyleStrategy(StyleStrategy s);

    int stretch() const;

    void setStretch(int);

    qreal letterSpacing() const;

    SpacingType letterSpacingType() const;

    void setLetterSpacing(SpacingType type, qreal spacing);

    qreal wordSpacing() const;

    void setWordSpacing(qreal spacing);

    void setCapitalization(Capitalization);

    Capitalization capitalization() const;

    // is raw mode still needed?

    bool rawMode() const;

    void setRawMode(bool);

    // dupicated from QFontInfo

    bool exactMatch() const;

    QFont &operator=(const QFont &);

    bool operator==(const QFont &) const;

    bool operator!=(const QFont &) const;

    bool operator<(const QFont &) const;

    operator QVariant() const;

    bool isCopyOf(const QFont &) const;

#ifdef Q_WS_WIN

    HFONT handle() const;

#else // !Q_WS_WIN

    Qt::HANDLE handle() const;

#endif // Q_WS_WIN

#ifdef Q_WS_MAC

    quint32 macFontID() const;

#endif

#if defined(Q_WS_X11) || defined(Q_WS_QWS)

    FT_Face freetypeFace() const;

#endif

    // needed for X11

    void setRawName(const QString &);

    QString rawName() const;

    QString key() const;

    QString toString() const;

    bool fromString(const QString &);

    static QString substitute(const QString &);

    static QStringList substitutes(const QString &);

    static QStringList substitutions();

    static void insertSubstitution(const QString&, const QString &);

    static void insertSubstitutions(const QString&, const QStringList &);

    static void removeSubstitution(const QString &);

    static void initialize();

    static void cleanup();

#ifndef Q_WS_QWS

    static void cacheStatistics();

#endif

    QString defaultFamily() const;

    QString lastResortFamily() const;

    QString lastResortFont() const;

    QFont resolve(const QFont &) const;

    inline uint resolve() const { return resolve_mask; }

    inline void resolve(uint mask) { resolve_mask = mask; }

#ifdef QT3_SUPPORT

    static QT3_SUPPORT QFont defaultFont();

    static QT3_SUPPORT void setDefaultFont(const QFont &);

    QT3_SUPPORT void setPixelSizeFloat(qreal);

    QT3_SUPPORT qreal pointSizeFloat() const { return pointSizeF(); }

    QT3_SUPPORT void setPointSizeFloat(qreal size) { setPointSizeF(size); }

#endif

private:

    QFont(QFontPrivate *);

    void detach();

#if defined(Q_WS_MAC)

    void macSetFont(QPaintDevice *);

#elif defined(Q_WS_X11)

    void x11SetScreen(int screen = -1);

    int x11Screen() const;

#endif

    friend class QFontPrivate;

    friend class QFontDialogPrivate;

    friend class QFontMetrics;

    friend class QFontMetricsF;

    friend class QFontInfo;

    friend class QPainter;

    friend class QPSPrintEngineFont;

    friend class QApplication;

    friend class QWidget;

    friend class QWidgetPrivate;

    friend class Q3TextFormatCollection;

    friend class QTextLayout;

    friend class QTextEngine;

    friend class QStackTextEngine;

    friend class QTextLine;

    friend struct QScriptLine;

    friend class QGLContext;

    friend class QWin32PaintEngine;

    friend class QAlphaPaintEngine;

    friend class QPainterPath;

    friend class QTextItemInt;

    friend class QPicturePaintEngine;

    friend class QPainterReplayer;

    friend class QPaintBufferEngine;

    friend class QCommandLinkButtonPrivate;

#ifndef QT_NO_DATASTREAM

    friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QFont &);

    friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QFont &);

#endif

    QExplicitlySharedDataPointer<QFontPrivate> d;

    uint resolve_mask;

};

inline bool QFont::bold() const

{ return weight() > Normal; }

inline void QFont::setBold(bool enable)

{ setWeight(enable ? Bold : Normal); }

inline bool QFont::italic() const

{

    return (style() != StyleNormal);

}

inline void QFont::setItalic(bool b) {

    setStyle(b ? StyleItalic : StyleNormal);

}

/*****************************************************************************

  QFont stream functions

 *****************************************************************************/

#ifndef QT_NO_DATASTREAM

Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QFont &);

Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QFont &);

#endif

#ifndef QT_NO_DEBUG_STREAM

Q_GUI_EXPORT QDebug operator<<(QDebug, const QFont &);

#endif

QT_END_NAMESPACE

QT_END_HEADER

#endif // QFONT_H