summaryrefslogtreecommitdiffstats
path: root/src/tools.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/tools.h')
-rw-r--r--src/tools.h95
1 files changed, 95 insertions, 0 deletions
diff --git a/src/tools.h b/src/tools.h
new file mode 100644
index 0000000..338abfd
--- /dev/null
+++ b/src/tools.h
@@ -0,0 +1,95 @@
+/***************************************************************************
+ * Copyright (C) 2003 by Sébastien Laoût *
+ * slaout@linux62.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. *
+ * *
+ * 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 TOOLS_H
+#define TOOLS_H
+
+class QString;
+class QColor;
+class QMimeSource;
+
+class StopWatch
+{
+ public:
+ static void start(uint id);
+ static void check(uint id);
+ private:
+ static QMemArray<QTime> starts;
+ static QMemArray<double> totals;
+ static QMemArray<uint> counts;
+};
+
+/** Some useful functions for that application.
+ * @author Sébastien Laoût
+ */
+namespace Tools
+{
+ // Text <-> HTML Conversions and Tools:
+ QString textToHTML(const QString &text);
+ QString textToHTMLWithoutP(const QString &text);
+ QString htmlToParagraph(const QString &html);
+ QString htmlToText(const QString &html);
+ QString tagURLs(const QString &test);
+ QString cssFontDefinition(const QFont &font, bool onlyFontFamily = false);
+
+ // String Manipulations:
+ QString stripEndWhiteSpaces(const QString &string);
+
+ // Pixmap Manipulations:
+ /** @Return true if it is a Web color
+ */
+ bool isWebColor(const QColor &color);
+ /** @Return a color that is 50% of @p color1 and 50% of @p color2.
+ */
+ QColor mixColor(const QColor &color1, const QColor &color2);
+ /** @Return true if the color is too dark to be darkened one more time.
+ */
+ bool tooDark(const QColor &color);
+ /** Make sure the @p pixmap is of the size (@p width, @p height) and @return a pixmap of this size.
+ * If @p height <= 0, then width will be used to make the picture square.
+ */
+ QPixmap normalizePixmap(const QPixmap &pixmap, int width, int height = 0);
+ /** @Return the pixmap @p source with depth*deltaX transparent pixels added to the left.\n
+ * If @p deltaX is <= 0, then an indent delta is computed depending on the @p source width.
+ */
+ QPixmap indentPixmap(const QPixmap &source, int depth, int deltaX = 0);
+
+ // File and Folder Manipulations:
+ /** Delete the folder @p folderOrFile recursively (to remove sub-folders and child files too).
+ */
+ void deleteRecursively(const QString &folderOrFile);
+ /** @Return a new filename that doesn't already exist in @p destFolder.
+ * If @p wantedName alread exist in @p destFolder, a dash and a number will be added before the extenssion.
+ * Id there were already such a number in @p wantedName, it is incremented until a free filename is found.
+ */
+ QString fileNameForNewFile(const QString &wantedName, const QString &destFolder);
+
+ // Other:
+ //void iconForURL(const KURL &url);
+ /** @Return true if the source is from a file cutting in Konqueror.
+ * @Return false if it was just a copy or if it was a drag.
+ */
+ bool isAFileCut(QMimeSource *source);
+
+ // Debug
+ void printChildren(QObject* parent);
+}
+
+#endif // TOOLS_H