You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
512 lines
17 KiB
512 lines
17 KiB
/* ksim - a system monitor for kde
|
|
*
|
|
* Copyright (C) 2001 Robbie Ward <linuxphreak@gmx.co.uk>
|
|
*
|
|
* 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 THEMELOADER_H
|
|
#define THEMELOADER_H
|
|
|
|
#include <tqstring.h>
|
|
#include <tqrect.h>
|
|
#include <tqcolor.h>
|
|
#include <tqfont.h>
|
|
#include <tqvaluelist.h>
|
|
|
|
#include <kdemacros.h>
|
|
|
|
class TQStringList;
|
|
template<class> class TQValueVector;
|
|
class TDEConfig;
|
|
class TQWidget;
|
|
|
|
namespace KSim
|
|
{
|
|
class Base;
|
|
|
|
/**
|
|
* a class containing various information
|
|
* about a theme, use KSim::ThemeLoader to
|
|
* get an instance
|
|
* @author Robbie Ward <linuxphreak@gmx.co.uk>
|
|
* @short Provides a loader for the themes
|
|
*/
|
|
class KDE_EXPORT Theme
|
|
{
|
|
friend class ThemeLoader;
|
|
public:
|
|
enum PixmapType { KrellPanel = 0, KrellMeter, KrellSlider };
|
|
~Theme();
|
|
bool operator==(const KSim::Theme &rhs) const;
|
|
bool operator!=(const KSim::Theme &rhs) const;
|
|
KSim::Theme &operator=(const KSim::Theme &rhs);
|
|
/**
|
|
* @return the theme path
|
|
*/
|
|
const TQString &path() const;
|
|
/**
|
|
* @return the name of the theme
|
|
*/
|
|
TQString name() const;
|
|
/**
|
|
* @return the author of the theme
|
|
*/
|
|
TQString author() const;
|
|
/**
|
|
* @return the set font item for the theme
|
|
*/
|
|
int fontItem() const;
|
|
/**
|
|
* @return the amount of alternatives the theme has
|
|
*/
|
|
int alternative() const;
|
|
/**
|
|
* @return the amount of alternatives the theme has
|
|
*/
|
|
int alternatives() const;
|
|
/**
|
|
* @return the width leds should be scaled to (if scaling() returns true)
|
|
*/
|
|
int chartWidthRef(int defValue = 0) const;
|
|
int chartWidthMin(int defValue = 0) const;
|
|
/**
|
|
* @return true if sacling should be enabled
|
|
*/
|
|
bool scaling(bool defValue = false) const;
|
|
/**
|
|
* @return the height of the top frame
|
|
*/
|
|
int frameTopHeight(int defValue = 0) const;
|
|
/**
|
|
* @return the height of the bottom frame
|
|
*/
|
|
int frameBottomHeight(int defValue = 0) const;
|
|
/**
|
|
* @return the width of the left frame
|
|
*/
|
|
int frameLeftWidth(int defValue = 0) const;
|
|
/**
|
|
* @return the width of the right frame
|
|
*/
|
|
int frameRightWidth(int defValue = 0) const;
|
|
/**
|
|
* @return a rect of the top frame border
|
|
*/
|
|
TQRect frameTopBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return a rect of the bottom frame border
|
|
*/
|
|
TQRect frameBottomBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return a rect of the left frame border
|
|
*/
|
|
TQRect frameLeftBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return a rect of the right frame border
|
|
*/
|
|
TQRect frameRightBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return the color of the chart in
|
|
*/
|
|
TQColor chartInColour(const TQColor &defValue = TQColor()) const;
|
|
/**
|
|
* @return the color of the chart in grid
|
|
*/
|
|
TQColor chartInColourGrid(const TQColor &defValue = TQColor()) const;
|
|
/**
|
|
* @return the color of the chart out
|
|
*/
|
|
TQColor chartOutColour(const TQColor &defValue = TQColor()) const;
|
|
/**
|
|
* @return the color of the chart out grid
|
|
*/
|
|
TQColor chartOutColourGrid(const TQColor &defValue = TQColor()) const;
|
|
/**
|
|
* if false then the grid lines should be drawn at the
|
|
* top and bottom of the graphs
|
|
*/
|
|
bool bgGridMode(bool defValue = false) const;
|
|
/**
|
|
* @return the X location of the receive led
|
|
*/
|
|
int rxLedX(int defValue = 0) const;
|
|
/**
|
|
* @return the Y location of the receive led
|
|
*/
|
|
int rxLedY(int defValue = 0) const;
|
|
/**
|
|
* @return the X location of the send led
|
|
*/
|
|
int txLedX(int defValue = 0) const;
|
|
/**
|
|
* @return the Y location of the send led
|
|
*/
|
|
int txLedY(int defValue = 0) const;
|
|
/**
|
|
* @return the amount of mail frames
|
|
*/
|
|
int mailFrames(int defValue = 0) const;
|
|
/**
|
|
* @return the mail check delay
|
|
*/
|
|
int mailDelay(int defValue = 0) const;
|
|
/**
|
|
* @return the slider depth
|
|
*/
|
|
int krellSliderDepth(int defValue = 7) const;
|
|
/**
|
|
* @return the vertical location of the start of the image
|
|
*/
|
|
int krellSliderXHot(int defValue = 0) const;
|
|
/**
|
|
* @return the area for the slider panel
|
|
*/
|
|
TQRect sliderPanel(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return the area for the slider meter
|
|
*/
|
|
TQRect sliderMeter(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return the border for the timer label/button
|
|
*/
|
|
TQRect timerBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return the border for the panel button
|
|
*/
|
|
TQRect buttonPanelBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return the border for the meter button
|
|
*/
|
|
TQRect buttonMeterBorder(const TQRect &defValue = TQRect()) const;
|
|
/**
|
|
* @return the large font that the theme specifies
|
|
*/
|
|
TQFont largeFont() const;
|
|
/**
|
|
* @return the normal font that the theme specifies
|
|
*/
|
|
TQFont normalFont() const;
|
|
/**
|
|
* @return the small font that the theme specifies
|
|
*/
|
|
TQFont smallFont() const;
|
|
/**
|
|
* @return the current font to be used
|
|
* according to fontItem()
|
|
*/
|
|
TQFont currentFont() const;
|
|
/**
|
|
* @return the meter image (bg_meter.[png|jpg|gif])
|
|
* of the current theme, if type is specified then it will
|
|
* look in the folder type.
|
|
*
|
|
* it will first look in the dir 'type' if no image is found
|
|
* it will drop back a dir
|
|
* @param type is one of: none, apm, cal, clock, fs,
|
|
* host, mail, mem, swap, timer, uptime
|
|
*/
|
|
TQString meterPixmap(int type, bool useDefault = true) const;
|
|
/**
|
|
* @return the meter image (bg_panel.[png|jpg|gif])
|
|
* of the current theme, it will first look in the dir 'type'
|
|
* if no image is found it will drop back a dir
|
|
* @param type is one of: net, inet
|
|
*/
|
|
TQString panelPixmap(int type, bool useDefault = true) const;
|
|
/**
|
|
* @return the decal net leds image
|
|
* (usually decal_net_leds.[png|jpg|gif]) of the
|
|
* current theme, it will first look in the dir 'type'
|
|
* if no image is found it will drop back a dir
|
|
* @param type is one of: net, inet
|
|
*/
|
|
TQString ledPixmap(int type, bool useDefault = true) const;
|
|
/**
|
|
* @return the frame image of the current theme,
|
|
* @param type is one of: top, bottom, left, right
|
|
*/
|
|
TQString framePixmap(int type, bool useDefault = true) const;
|
|
/**
|
|
* @return the krell chart image (bg_chart.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString chartPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the krell grid image (bg_grid.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString gridPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the krell panel image (krell_panel.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString krellPanelPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the krell meter image (krell_meter.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString krellMeterPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the krell slider image (krell_slider.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString krellSliderPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the data in image (data_in.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString dataInPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the data out image (data_out.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString dataOutPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return the mail image (mail/decal_mail.[png|jpg|gif])
|
|
* of the current theme
|
|
*/
|
|
TQString mailPixmap(bool useDefault = true) const;
|
|
/**
|
|
* @return a segmant of an image, using @p itemNo to
|
|
* get the segmant and from the ImageType @p type
|
|
*/
|
|
TQPixmap splitPixmap(PixmapType type, uint itemNo = 0,
|
|
bool useDefault = true) const;
|
|
/**
|
|
* Same as the above function but returns an array of pixmaps
|
|
* with the maximum size of limitAmount, or all the pixmaps if @p
|
|
* limitAmount is -1 (default)
|
|
* @return an array of pixmaps
|
|
*/
|
|
TQValueList<TQPixmap> pixmapToList(PixmapType type,
|
|
int limitAmount = -1, bool useDefault = true) const;
|
|
/**
|
|
* returns the transparency level from the specified keys
|
|
*/
|
|
int transparency(const TQString &, const TQString &) const;
|
|
/**
|
|
* @return true if shadow text is enabled
|
|
*/
|
|
bool textShadow(const TQString &, const TQString &) const;
|
|
/**
|
|
* @return the shadow color (if any) for the specified keys
|
|
*/
|
|
TQColor shadowColour(const TQString &, const TQString &) const;
|
|
/**
|
|
* @return the text color for the specified keys
|
|
*/
|
|
TQColor textColour(const TQString &, const TQString &) const;
|
|
/**
|
|
* reads an entry and returns it as an int
|
|
*/
|
|
int readIntEntry(const TQString &, const TQString &) const;
|
|
/**
|
|
* @return a rect from the specified keys
|
|
*/
|
|
TQRect readRectEntry(const TQString &, const TQString &) const;
|
|
/**
|
|
* reads an entry from the specified keys
|
|
*/
|
|
TQString readEntry(const TQString &, const TQString &) const;
|
|
/**
|
|
* reads a color entry from the specified keys
|
|
*/
|
|
TQString readColourEntry(const TQString &, const TQString &, int) const;
|
|
/**
|
|
* reads a font entry from the specified keys
|
|
*/
|
|
TQFont readFontEntry(const TQString &, const TQString &) const;
|
|
/**
|
|
* sets the font, textColour, shadowColour and showShadow to
|
|
* the fonts and colours KSim should use depending on type and
|
|
* string.
|
|
*
|
|
* returns true if one of the parameters were changed using
|
|
* type and string, else the parameters will be set to the current
|
|
* colours and font that KSim should use and returns false.
|
|
*
|
|
* example usage:
|
|
* <pre>
|
|
* TQFont font;
|
|
* TQColor textColour, shadowColour;
|
|
* bool showShadow;
|
|
* if (KSim::ThemeLoader::self().current().fontColours(type(), configString(), font,
|
|
* textColour, shadowColour, showShadow)
|
|
* {
|
|
* setFont(font);
|
|
* // Do something with textColour, shadowColour and showShadow
|
|
* }
|
|
* </pre>
|
|
* @param type is the theme type you want, generally if you're calling this
|
|
* from a KSim::Base (or derived from) object then use type()
|
|
* @param string is the config string entry you want the function to read
|
|
* from, generally if you're calling this from a KSim::Base (or derived from)
|
|
* object then use configString()
|
|
*/
|
|
bool fontColours(int type, const TQString &string, TQFont &font,
|
|
TQColor &textColour, TQColor &shadowColour, bool &showShadow) const;
|
|
/**
|
|
* convenience function.
|
|
*
|
|
* collects the theme type and config key from the base pointer
|
|
*/
|
|
bool fontColours(const KSim::Base *const base, TQFont &font,
|
|
TQColor &textColour, TQColor &shadowColour, bool &showShadow) const;
|
|
|
|
Theme(const KSim::Theme &);
|
|
|
|
private:
|
|
Theme();
|
|
Theme(const TQString &url, const TQString &fileName, int alt,
|
|
const TQValueVector<TQString> &vector, const TQStringList &list,
|
|
TDEConfig *globalReader);
|
|
void create(const TQValueVector<TQString> &, const TQStringList &, TDEConfig *);
|
|
void init(const TQString &url, const TQString &fileName, int alt);
|
|
void reparse(const TQString &url, const TQString &fileName, int alt);
|
|
TQString parseConfig(const TQString &, const TQString &);
|
|
TQString loader(int, bool useDefault = true) const;
|
|
TQString createType(int, const TQString &) const;
|
|
void setRecolour(bool);
|
|
|
|
int internalNumEntry(const TQString &, int) const;
|
|
TQRect internalRectEntry(const TQString &, const TQRect &) const;
|
|
TQColor internalColourEntry(const TQString &, const TQColor &) const;
|
|
TQString internalStringEntry(const TQString &, const TQString &) const;
|
|
|
|
class Private;
|
|
Private *d;
|
|
};
|
|
|
|
/**
|
|
* returns a class Theme containing
|
|
* information of the current theme or
|
|
* of the theme path specified
|
|
* @author Robbie Ward <linuxphreak@gmx.co.uk>
|
|
* @short Provides a loader for the themes
|
|
*/
|
|
class KDE_EXPORT ThemeLoader
|
|
{
|
|
public:
|
|
/**
|
|
* @return a reference to the instance
|
|
*/
|
|
static ThemeLoader &self();
|
|
/**
|
|
* @return true if the theme has changed
|
|
*/
|
|
bool isDifferent() const;
|
|
/**
|
|
* Updates the info to the current theme
|
|
*/
|
|
void reload();
|
|
/**
|
|
* @return the current theme that is set
|
|
*/
|
|
const KSim::Theme ¤t() const;
|
|
/**
|
|
* @return a theme from the path specified
|
|
* @param url is the path of the theme dir
|
|
* @param rcFile is the filename of the config file (optional)
|
|
* @param alt is the theme alternative number (optional)
|
|
*/
|
|
KSim::Theme theme(const TQString &url,
|
|
const TQString &rcFile = "gkrellmrc", int alt = 0) const;
|
|
/**
|
|
* re-colours an image to the current KDE
|
|
* color scheme
|
|
*/
|
|
void reColourImage(TQImage &image);
|
|
/**
|
|
* changes some of the entries in the config file so tdeconfig
|
|
* can handle the file better.
|
|
* @return the location of the config file
|
|
*/
|
|
TQString parseConfig(const TQString &url, const TQString &file);
|
|
/**
|
|
* change the dir structure of a theme directory
|
|
* so KSim can understand them better
|
|
*/
|
|
void parseDir(const TQString &url, int alt);
|
|
/**
|
|
* checks if the themeUrl entry is valid,
|
|
* if not it then reverts the current theme
|
|
* to the default url
|
|
*/
|
|
void validate();
|
|
/**
|
|
* sets the pallete of the current theme
|
|
*/
|
|
void themeColours(TQWidget *);
|
|
/**
|
|
* @return current theme name
|
|
*/
|
|
static TQString currentName();
|
|
/**
|
|
* @return current theme url, if there is no current theme
|
|
* then it will return the default theme
|
|
*/
|
|
static TQString currentUrl();
|
|
/**
|
|
* @return the default theme url
|
|
*/
|
|
static TQString defaultUrl();
|
|
/**
|
|
* @return the current theme alternative
|
|
*/
|
|
static int currentAlternative();
|
|
/**
|
|
* @return the current theme alternative as a string, eg if the
|
|
* current theme alt is 1 then this will return '_1'.
|
|
* if there is no theme alt this will return a null string.
|
|
*
|
|
* if this is set to -1 (the default) then the current alternative
|
|
* will be used
|
|
*/
|
|
static TQString alternativeAsString(int alt = -1);
|
|
/**
|
|
* @return the font of the theme if the theme font is set to custom
|
|
*/
|
|
static TQFont currentFont();
|
|
/**
|
|
* @return the font item of the theme, eg: 0 would be the small font
|
|
*/
|
|
static int currentFontItem();
|
|
|
|
protected:
|
|
/**
|
|
* Default constructor, use self() to get an instance
|
|
*/
|
|
ThemeLoader();
|
|
~ThemeLoader();
|
|
|
|
private:
|
|
ThemeLoader(const ThemeLoader &);
|
|
ThemeLoader &operator=(const ThemeLoader &);
|
|
/**
|
|
* Deletes the instance and cleans up after itself
|
|
*/
|
|
static void cleanup();
|
|
void reColourItems();
|
|
void grabColour();
|
|
|
|
class Private;
|
|
Private *d;
|
|
KSim::Theme m_theme;
|
|
static ThemeLoader *m_self;
|
|
};
|
|
}
|
|
#endif
|