faithcore/faith/painter.h

Go to the documentation of this file.

#ifndef KDE__PAINTER_H
#define KDE__PAINTER_H

#include <faith/point.h>
#include <faith/color.h>
#include <faith/application.h>
#include <faith/rect.h>
#include <faith/string.h>
#include <faith/pen.h>

namespace Faith
{

class PaintDevice;
class Widget;
class Font;
class Image;
class Pixmap;

namespace Internal
{
        class Drawable;
}


class FAITH_CORE_EXPORT Painter
{
        struct PainterPrivate;
        PainterPrivate *d;
        PaintDevice *mDest;
        mutable bool mInvalidated;

public:
        enum TextDirection
        {
                Auto,
                LTR,
                RTL
        };

        Painter(PaintDevice *dest, const Widget *copyAttrib=0);
        Painter();
        ~Painter();

        void save();
        void restore();

        void begin(PaintDevice *dest, const Widget *copyAttrib=0);
        void end();

        Point xForm(const Point &pt);
        Rect xForm(const Rect &pt);

        Internal::Drawable *handle();

public: // actions
        void drawLine(int ax, int ay, int bx, int by)
                { drawLine(Point(ax,ay), Point(bx, by)); }
        void drawLine(const Point &a, const Point &b);

        void drawPolygon(const std::vector<Faith::Point> &points, int start=0, int count=-1);
        void drawPolygon(int count, const Faith::Point *points);

        void drawText(const Point &p, const String &str, int pos=0, int len=-1, TextDirection dir=Auto);
        
        void drawText(int x, int y, const String &str, int pos=0, int len=-1, TextDirection dir=Auto)
        {
                drawText(Point(x,y), str, pos, len, dir);
        }

        void drawText(const Rect &rect, int textflags, const String &str, int pos=0, int len=-1);
        void drawText(int x, int y, int w, int h, int textflags, const String &str, int pos=0, int len=-1)
        {
                drawText(Rect(x,y,w,h), textflags, str, pos, len);
        }

        void fillRect(const Rect &rect, const Color &color);
        
        void fillRect(int x, int y, int w, int h, const Color &color)
        {
                fillRect(Rect(x, y, w, h), color);
        }

        void drawImage(const Point &p, const Image &image, int fromx=0, int fromy=0, int w=-1, int h=-1);
        
        void drawImage(int x, int y, const Image &image, int fromx=0, int fromy=0, int w=-1, int h=-1)
        {
                drawImage(Point(x, y), image, fromx, fromy, w,h);
        }
        
        void drawImage(const Image &image, int fromx=0, int fromy=0, int w=-1, int h=-1)
        {
                drawImage(Point(0, 0), image, fromx, fromy, w,h);
        }

        void drawPixmap(const Point &p, const Faith::Pixmap &pixmap, int fromx=0, int fromy=0, int w=-1, int h=-1);
        
        void drawPixmap(int x, int y, const Faith::Pixmap &pixmap, int fromx=0, int fromy=0, int w=-1, int h=-1)
        {
                drawPixmap(Point(x, y), pixmap, fromx, fromy, w,h);
        }
        
        void drawPixmap(const Faith::Pixmap &pixmap, int fromx=0, int fromy=0, int w=-1, int h=-1)
        {
                drawPixmap(Point(0, 0), pixmap, fromx, fromy, w,h);
        }

        void drawPoint(const Point &pt);
        
        void drawPoint(int x, int y)
        {
                drawPoint(Point(x,y));
        }

public: // modes
        void setBackground(const Color &color);
        
        Color background() const;

        void setFont(const Font &font);
        Font font() const;

        void setPen(const Pen &pen);
        Pen pen() const;

        void setOrigin(const Point &point);

        void setOrigin(int x, int y)
                { setOrigin(Faith::Point(x,y)); }
        
        Point origin() const;

        void setClipRectangle(const Rect &rectangle);
        
        Rect clipRectangle() const;

        void setClipping(bool c);
        
        bool isClipping() const;

private:
        void updateGC() const;
        void invalidateGC();
};

}

#endif

---