qgsfontmanager.h

Go to the documentation of this file.

/***************************************************************************
    qgsfontmanager.h
    ------------------
    Date                 : June 2022
    Copyright            : (C) 2022 Nyall Dawson
    Email                : nyall dot dawson at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   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 QGSFONTMANAGER_H
#define QGSFONTMANAGER_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgssettingsentryimpl.h"
#include <QObject>
#include <QMap>
#include <QReadWriteLock>
#include <QSet>
 
class CORE_EXPORT QgsFontManager : public QObject
{
    Q_OBJECT
 
  public:
 
#ifndef SIP_RUN
    static const inline QgsSettingsEntryStringList settingsFontFamilyReplacements = QgsSettingsEntryStringList( QStringLiteral( "fontFamilyReplacements" ), QgsSettings::Prefix::FONTS, QStringList(), QStringLiteral( "Automatic font family replacements" ) );
 
    static const inline QgsSettingsEntryBool settingsDownloadMissingFonts = QgsSettingsEntryBool( QStringLiteral( "downloadMissingFonts" ), QgsSettings::Prefix::FONTS, true, QStringLiteral( "Automatically download missing fonts whenever possible" ) );
#endif
 
    explicit QgsFontManager( QObject *parent SIP_TRANSFERTHIS = nullptr );
 
    QMap< QString, QString > fontFamilyReplacements() const;
 
    void addFontFamilyReplacement( const QString &original, const QString &replacement );
 
    void setFontFamilyReplacements( const QMap< QString, QString> &replacements );
 
    QString processFontFamilyName( const QString &name ) const;
 
    void installUserFonts() SIP_SKIP;
 
    bool tryToDownloadFontFamily( const QString &family, QString &matchedFamily SIP_OUT );
 
    void enableFontDownloadsForSession();
 
    QString urlForFontDownload( const QString &family, QString &matchedFamily SIP_OUT ) const;
 
    void downloadAndInstallFont( const QUrl &url, const QString &identifier = QString() );
 
    bool installFontsFromData( const QByteArray &data, QString &errorMessage SIP_OUT, QStringList &families SIP_OUT, QString &licenseDetails SIP_OUT, const QString &filename = QString() );
 
    void addUserFontDirectory( const QString &directory );
 
    QMap< QString, QStringList > userFontToFamilyMap() const;
 
    bool removeUserFont( const QString &path );
 
  signals:
 
    void fontDownloaded( const QStringList &families, const QString &licenseDetails );
 
    void fontDownloadErrorOccurred( const QUrl &url, const QString &identifier, const QString &error );
 
  private:
 
    QMap< QString, QString > mFamilyReplacements;
    QMap< QString, QString > mLowerCaseFamilyReplacements;
    QMap< QString, QStringList > mUserFontToFamilyMap;
    QMap< QString, int > mUserFontToIdMap;
    mutable QReadWriteLock mReplacementLock;
    QStringList mUserFontDirectories;
 
    bool mEnableFontDownloads = false;
    QMap< QString, QString > mPendingFontDownloads;
    QMap< QString, QString > mDeferredFontDownloads;
 
    void storeFamilyReplacements();
    void installFontsFromDirectory( const QString &dir );
};
 
#endif // QGSFONTMANAGER_H