okular/core/fontinfo.h

/***************************************************************************
 *   Copyright (C) 2007 by Pino Toscano <pino@kde.org>                     *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 ***************************************************************************/

#ifndef _OKULAR_FONTINFO_H_
#define _OKULAR_FONTINFO_H_

#include <QList>
#include <QMetaType>
#include <QSharedDataPointer>
#include <QString>

#include "okularcore_export.h"

namespace Okular
{
class FontInfoPrivate;

/**
 * @short A small class that represents the information of a font.
 */
class OKULARCORE_EXPORT FontInfo
{
public:
    typedef QVector<FontInfo> List;

    /**
     * The possible kinds of fonts.
     */
    enum FontType {
        Unknown,
        Type1,
        Type1C,
        Type1COT,
        Type3,
        TrueType,
        TrueTypeOT,
        CIDType0,
        CIDType0C,
        CIDType0COT,
        CIDTrueType,
        CIDTrueTypeOT,
        TeXPK,             ///< @since 0.10 (KDE 4.4)
        TeXVirtual,        ///< @since 0.10 (KDE 4.4)
        TeXFontMetric,     ///< @since 0.10 (KDE 4.4)
        TeXFreeTypeHandled ///< @since 0.10 (KDE 4.4)
    };

    /**
     * The possible kinds of embed.
     */
    enum EmbedType { NotEmbedded, EmbeddedSubset, FullyEmbedded };

    /**
     * Construct a new empty font info.
     */
    FontInfo();
    /**
     * Copy constructor.
     */
    FontInfo(const FontInfo &fi);
    /**
     * Destructor.
     */
    ~FontInfo();

    /**
     * Returns the name of the font.
     */
    QString name() const;
    /**
     * Sets a new name for the font.
     */
    void setName(const QString &name);

    /**
     * Returns the substitute name for the font.
     */
    QString substituteName() const;

    /**
     * Sets a new substitute name for the font.
     */
    void setSubstituteName(const QString &substituteName);

    /**
     * Returns the type of the font.
     */
    FontType type() const;
    /**
     * Change the type of the font.
     */
    void setType(FontType type);

    /**
     * Returns the type of font embedding.
     */
    EmbedType embedType() const;
    /**
     * Sets the type of font embedding.
     */
    void setEmbedType(EmbedType type);

    /**
     * In case of not embedded font, returns the path of the font that
     * represents this font.
     */
    QString file() const;
    void setFile(const QString &file);

    /**
     * In case of embedded fonts, returns if the font can be extracted into a QByteArray
     *
     * @since 0.8 (KDE 4.2)
     */
    bool canBeExtracted() const;

    /**
     * Sets if a font can be extracted or not. False by default
     */
    void setCanBeExtracted(bool extractable);

    /**
     * Sets the "native" @p id of the font info.
     *
     * This is for use of the Generator, that can optionally store an
     * handle (a pointer, an identifier, etc) of the "native" font
     * object, if any.
     *
     * @since 0.8 (KDE 4.2)
     */
    void setNativeId(const QVariant &id);

    /**
     * Returns the "native" id of the font info.
     *
     * @since 0.8 (KDE 4.2)
     */
    QVariant nativeId() const;

    FontInfo &operator=(const FontInfo &fi);

    /**
     * Comparison operator.
     */
    bool operator==(const FontInfo &fi) const;

    bool operator!=(const FontInfo &fi) const;

private:
    /// @cond PRIVATE
    friend class FontInfoPrivate;
    /// @endcond
    QSharedDataPointer<FontInfoPrivate> d;
};

}

Q_DECLARE_METATYPE(Okular::FontInfo)

#endif