KWQPainter.h

/*
 * Copyright (C) 2001 Apple Computer, Inc.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
 */

#ifndef QPAINTER_H_
#define QPAINTER_H_

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <qnamespace.h>
#include <qpaintdevice.h>
#include <qcolor.h>
#include <qpen.h>
#include <qbrush.h>
#include <qrect.h>
#include <qregion.h>
#include <qpoint.h>
#include <qstring.h>
#include <qfontmetrics.h>

class QFont;
class QPixmap;
class QWidget;

// class QWMatrix ==============================================================

class QWMatrix {
friend QPainter;
public:

    // typedefs ----------------------------------------------------------------
    // enums -------------------------------------------------------------------
    // constants ---------------------------------------------------------------
    // static member functions -------------------------------------------------
    
    // constructors, copy constructors, and destructors ------------------------
    
    QWMatrix();
    
// add no-op destructor
#ifdef _KWQ_PEDANTIC_
    ~QWMatrix() {}
#endif

    // member functions --------------------------------------------------------

    QWMatrix &scale(double, double);

    // operators ---------------------------------------------------------------

// protected -------------------------------------------------------------------
// private ---------------------------------------------------------------------

private:

// add copy constructor
// this private declaration prevents copying
#ifdef _KWQ_PEDANTIC_
    QWMatrix(const QWMatrix &);
#endif

#ifdef _KWQ_
    bool empty;
    double sx;
    double sy;
#endif

}; // class QWMatrix ===========================================================


// class QPainter ==============================================================

class QPainter : public Qt {
public:

    // typedefs ----------------------------------------------------------------
    // enums -------------------------------------------------------------------
    // constants ---------------------------------------------------------------
    // static member functions -------------------------------------------------

    // constructors, copy constructors, and destructors ------------------------

    QPainter();
    
    // We may be able to remove this constructor and remove QPaintDevice.
    QPainter(const QPaintDevice *);
    
#ifdef _KWQ_
    QPainter(QWidget *);
#endif

    ~QPainter();
    
    // member functions --------------------------------------------------------

    const QFont &font() const;
    void setFont(const QFont &);
    QFontMetrics fontMetrics() const;
    const QPen &pen() const;
    void setPen(const QPen &);
    void setPen(PenStyle);
    void setBrush(const QBrush &);
    void setBrush(BrushStyle);

    QRect xForm(const QRect &) const;

    void save();
    void restore();
    
    void drawRect(int, int, int, int);
    void drawLine(int, int, int, int);
    void drawEllipse(int, int, int, int);
    void drawArc(int, int, int, int, int, int);
    void drawPolyline(const QPointArray &, int index=0, int npoints=-1);
    void drawPolygon(const QPointArray &, bool winding=FALSE, int index=0,
        int npoints=-1);
    void drawPixmap(const QPoint &, const QPixmap &);
    void drawPixmap(const QPoint &, const QPixmap &, const QRect &);
    void drawPixmap( int x, int y, const QPixmap &,
			    int sx=0, int sy=0, int sw=-1, int sh=-1 );
    void drawTiledPixmap(int, int, int, int, const QPixmap &, int sx=0, int sy=0);
    void drawText(int x, int y, const QString &, int len=-1);
    void drawText(int, int, int, int, int flags, const QString&, int len=-1, 
        QRect *br=0, char **internal=0);
    void fillRect(int, int, int, int, const QBrush &);

    void setClipping(bool);
    void setClipRegion(const QRegion &);
    void setClipRect(const QRect &);
    void setClipRect(int,int,int,int);
    const QRegion &clipRegion() const;
    bool hasClipping() const;
    RasterOp rasterOp() const;
    void setRasterOp(RasterOp);

    void translate(double dx, double dy);
    void scale(double dx, double dy);

    bool begin(const QPaintDevice *);
    bool end();

    QPaintDevice *device() const;

    // operators ---------------------------------------------------------------

// protected -------------------------------------------------------------------

// private ---------------------------------------------------------------------

private:
    // no copying or assignment
    // note that these are "standard" (no pendantic stuff needed)
    QPainter(const QPainter &);
    QPainter &operator=(const QPainter &);

#ifdef _KWQ_
    void _lockFocus();
    void _unlockFocus();

    void _setColorFromBrush();
    void _setColorFromPen();

    void _initialize(QWidget *widget);
    void _drawPoints (const QPointArray &_points, bool winding, int index, int _npoints, bool fill);

    struct KWQPainterData {	// QPainter data.
        QWidget *widget;	// Has a reference to a KWQView.
	QFont qfont;
	QBrush qbrush;
	QPen qpen;
	uint isFocusLocked:1;
        void *ps_stack;
#if (defined(__APPLE__) && defined(__OBJC__) && defined(__cplusplus))
        NSCompositingOperation compositingOperation;
#else
        uint compositingOperation;
#endif
    } *data;
#endif
}; // end class QPainter

// =============================================================================

#endif