Files
cantata/support/utils.h
2014-06-04 18:45:30 +00:00

125 lines
4.7 KiB
C++

/*
* Cantata
*
* Copyright (c) 2011-2014 Craig Drummond <craig.p.drummond@gmail.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.
*
* 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; see the file COPYING. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef UTILS_H
#define UTILS_H
#include <math.h>
#include <sys/types.h>
#include <QtGlobal>
#include <QString>
#include <QLatin1Char>
#include <QDir>
#include <QFont>
#ifdef ENABLE_KDE_SUPPORT
#include <KDE/KGlobal>
#include <KDE/KLocale>
#include <KDE/KStandardDirs>
#endif
#include <stdlib.h>
#ifdef Q_OS_WIN32
#include <time.h>
#endif
#include <sys/time.h>
class QString;
class QWidget;
namespace Utils
{
extern const QLatin1Char constDirSep;
extern const QLatin1String constDirSepStr;
extern const char * constDirSepCharStr;
inline bool equal(double d1, double d2, double precision=0.0001)
{
return (fabs(d1 - d2) < precision);
}
inline int random(int max=0) { return max ? (qrand()%max) : qrand(); }
inline void initRand() { timeval time; gettimeofday(&time, NULL); qsrand((time.tv_sec*1000)+(time.tv_usec/1000)); }
extern QString strippedText(QString s);
extern QString stripAcceleratorMarkers(QString label);
extern QString fixPath(const QString &d);
// Convert directory to a format suitable fo rUI - e.g. use native separators, and remove any traling separator
extern QString convertDirForDisplay(const QString &dir);
// Convert directory from a UI field - convert to / separators, and add a trailing separator
extern QString convertDirFromDisplay(const QString &dir);
extern QString getDir(const QString &file);
extern QString getFile(const QString &file);
extern QString changeExtension(const QString &file, const QString &extension);
#ifndef Q_OS_WIN
extern gid_t getGroupId(const char *groupName="users"); // Return 0 if user is not in group, otherwise returns group ID
#endif
extern void setFilePerms(const QString &file, const char *groupName="users");
#ifdef ENABLE_KDE_SUPPORT
inline bool makeDir(const QString &dir, int mode) { return KStandardDirs::makeDir(dir, mode); }
#else
extern bool makeDir(const QString &dir, int mode);
#endif
extern bool createWorldReadableDir(const QString &dir, const QString &base, const char *groupName="users");
extern void msleep(int msecs);
inline void sleep() { msleep(100); }
#ifdef ENABLE_KDE_SUPPORT
inline QString findExe(const QString &appname, const QString &pathstr=QString()) { return KStandardDirs::findExe(appname, pathstr); }
inline QString formatByteSize(double size) { return KGlobal::locale()->formatByteSize(size, 1); }
inline QString formatNumber(double number, int precision) { return KGlobal::locale()->formatNumber(number, precision); }
#else
extern QString findExe(const QString &appname, const QString &pathstr=QString());
extern QString formatByteSize(double size);
inline QString formatNumber(double number, int precision) { return QString::number(number, 'f', precision); }
#endif
extern QString formatDuration(const quint32 totalseconds);
extern QString formatTime(const quint32 seconds, bool zeroIsUnknown=false);
extern QString cleanPath(const QString &p);
extern QString dataDir(const QString &sub=QString(), bool create=false);
extern QString cacheDir(const QString &sub=QString(), bool create=true);
extern QString systemDir(const QString &sub);
extern QString helper(const QString &app);
extern bool moveFile(const QString &from, const QString &to);
extern void moveDir(const QString &from, const QString &to);
extern void clearOldCache(const QString &sub, int maxAge);
extern void touchFile(const QString &fileName);
extern bool isDirReadable(const QString &dir);
extern double smallFontFactor(const QFont &f);
extern QFont smallFont(QFont f);
extern int layoutSpacing(QWidget *w);
extern bool isHighDpi();
extern int scaleForDpi(int v);
enum Desktop {
KDE,
Gnome,
Unity,
Other
};
extern Desktop currentDe();
extern void setTouchFriendly(bool t);
extern bool touchFriendly();
}
#endif