qmmp.h

/***************************************************************************
 *   Copyright (C) 2008-2025 by Ilya Kotov                                 *
 *   forkotov02@ya.ru                                                      *
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.         *
 ***************************************************************************/
#ifndef QMMP_H
#define QMMP_H
 
#include <QString>
#include <QLoggingCategory>
#include "qmmp_export.h"
 
#define QMMP_VERSION_MAJOR 2
#define QMMP_VERSION_MINOR 3
#define QMMP_VERSION_PATCH 1
#define QMMP_VERSION_STABLE 1
 
#define QMMP_VERSION_INT (QMMP_VERSION_MAJOR<<16 | QMMP_VERSION_MINOR<<8 | QMMP_VERSION_PATCH)

#ifdef Q_OS_WIN
#define QStringToFileName(s) TagLib::FileName(reinterpret_cast<const wchar_t *>(s.utf16()))
#else
#define QStringToFileName(s) s.toLocal8Bit().constData()
#endif
 
#if QT_VERSION < QT_VERSION_CHECK(6, 4, 0)
 
#include <QLatin1String>
 
namespace Qt {
inline namespace Literals {
inline namespace StringLiterals {
 
inline QString operator""_s(const char16_t *str, size_t size) noexcept
{
    return QString(QStringPrivate(nullptr, const_cast<char16_t *>(str), qsizetype(size)));
}
 
constexpr inline QLatin1String operator""_L1(const char *str, size_t size) noexcept
{
    return QLatin1String(str, int(size));
}
 
inline QByteArray operator""_ba(const char *str, size_t size) noexcept
{
    return QByteArray(QByteArrayData(nullptr, const_cast<char *>(str), qsizetype(size)));
}
 
} // StringLiterals
} // Literals
} // Qt
 
using QLatin1StringView = QLatin1String;
 
#endif
 
using namespace Qt::Literals::StringLiterals;
 
QMMP_EXPORT Q_DECLARE_LOGGING_CATEGORY(core)
QMMP_EXPORT Q_DECLARE_LOGGING_CATEGORY(plugin)
 
#if QT_VERSION < QT_VERSION_CHECK(6, 5, 0)
#define qCFatal qCCritical
#endif
 

class QMMP_EXPORT Qmmp
{
public:
    enum State
    {
        Playing = 0, 
        Paused,      
        Stopped,     
        Buffering,   
        NormalError, 
        FatalError   
    };
    enum MetaData
    {
        UNKNOWN = -1,
        TITLE = 0, 
        ARTIST,    
        ALBUMARTIST,
        ALBUM,     
        COMMENT,   
        GENRE,     
        COMPOSER,  
        YEAR,      
        TRACK,     
        DISCNUMBER 
    };
    enum TrackProperty
    {
        UNKNOWN_PROPERTY = -1,
        BITRATE = 0,
        SAMPLERATE,
        CHANNELS,
        BITS_PER_SAMPLE,
        FORMAT_NAME,
        DECODER,
        FILE_SIZE
    };
    enum ReplayGainKey
    {
        REPLAYGAIN_TRACK_GAIN = 0, 
        REPLAYGAIN_TRACK_PEAK,     
        REPLAYGAIN_ALBUM_GAIN,     
        REPLAYGAIN_ALBUM_PEAK      
    };
    enum AudioFormat
    {
        PCM_UNKNOWN = -1, 
        PCM_S8 = 0, 
        PCM_U8,     
        PCM_S16LE,  
        PCM_S16BE,  
        PCM_U16LE,  
        PCM_U16BE,  
        PCM_S24LE,  
        PCM_S24BE,  
        PCM_U24LE,  
        PCM_U24BE,  
        PCM_S32LE,  
        PCM_S32BE,  
        PCM_U32LE,  
        PCM_U32BE,  
        PCM_FLOAT   
    };

    enum ChannelPosition
    {
        CHAN_NULL         = 0x00,   
        CHAN_FRONT_LEFT   = 0x01,   
        CHAN_FRONT_RIGHT  = 0x02,   
        CHAN_REAR_LEFT    = 0x04,   
        CHAN_REAR_RIGHT   = 0x08,   
        CHAN_FRONT_CENTER = 0x10,   
        CHAN_REAR_CENTER  = 0x20,   
        CHAN_SIDE_LEFT    = 0x40,   
        CHAN_SIDE_RIGHT   = 0x80,   
        CHAN_LFE          = 0x100,  
    };
    static QString configDir();
    static void setConfigDir(const QString &path);
    static QString cacheDir();
    static QString strVersion();
    static QString pluginPath();
    static QStringList findPlugins(const QString &prefix);
    static QString systemLanguageID();
    static QString uiLanguageID();
    static void setUiLanguageID(const QString &code);
    static QString dataPath();
    static QString userDataPath();
#ifdef Q_OS_WIN
    static bool isPortable();
#endif
 
private:
    static QString m_configDir;
    static QString m_langID;
#ifdef Q_OS_WIN
    static QString m_appDir;
#endif
 
};
 
#endif