Long live Qt!

1 files changed, 240 insertions, 0 deletions

diff --git a/src/qt3support/painting/q3painter.cpp b/src/qt3support/painting/q3painter.cpp
new file mode 100644
index 0000000..0b623f4
--- /dev/null
+++ b/src/qt3support/painting/q3painter.cpp
@@ -0,0 +1,240 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Qt Software Information (qt-info@nokia.com)
+**
+** This file is part of the Qt3Support module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain
+** additional rights. These rights are described in the Nokia Qt LGPL
+** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
+** package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@nokia.com.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "q3painter.h"
+#include "qpaintengine.h"
+
+#include <private/qpainter_p.h>
+
+QT_BEGIN_NAMESPACE
+
+/*!
+    \class Q3Painter
+    \brief The Q3Painter class is a Qt 3 compatibility wrapper for QPainter.
+
+    \compat
+
+    Prior to Qt 4, QPainter specialized the pen drawing for rectangle
+    based functions (in particular: drawRect, drawEllipse,
+    drawRoundRect, drawArc, drawChord and drawPie). When stroking a
+    rectangle of width 10, the pen would draw a rectangle of width 10.
+    Drawing a polygon defined by the corner points of the same
+    rectangle the stroke would have a width of 11.
+
+    The reason for this is best explained using the picture below:
+
+    \img q3painter_rationale.png
+
+    As we can see, stroking the rectangle so it gets a width of 10,
+    means the pen is drawn on a rectangle on width 9. The polygon,
+    however follows a consistent model.
+
+    In Qt 4, all rectangle based functions have changed to follow the
+    polygon approach, which means that the rectangle defines the size of
+    the fill, and the pen follows the edges of the shape. For pen widths
+    of 0 and 1 this means that the stroke will be inside the shape on the
+    left and the top and outside on the bottom and right.
+
+    The reason for the change in Qt 4 is so that we provide consistency
+    for all drawing functions even with complex transformations.
+*/
+
+/*!
+    \fn Q3Painter::Q3Painter()
+
+    Constructs a Q3Painter.
+*/
+
+/*!
+    \fn Q3Painter::Q3Painter(QPaintDevice *pdev)
+
+    Constructs a Q3Painter that operates on device \a pdev.
+*/
+
+/*!
+    \internal
+*/
+QRect Q3Painter::adjustedRectangle(const QRect &r)
+{
+    QRect rect = r.normalized();
+    int subtract = d_func()->rectSubtraction();
+    if (subtract != 0)
+        rect.setSize(QSize(rect.width() - subtract, rect.height() - subtract));
+    return rect;
+}
+
+
+/*!
+    \fn void Q3Painter::drawRect(int x, int y, int w, int h)
+
+    \overload
+
+    Draws the rectangle that fits inside the bounds specified by \a x,
+    \a y, \a w and \a h using the current pen and brush.
+*/
+
+/*!
+    \fn void Q3Painter::drawRect(const QRect &r)
+
+    Draws a rectangle that fits inside the rectangle \a r using the
+    current pen and brush.
+
+*/
+
+
+
+/*!
+    \fn Q3Painter::drawEllipse(const QRect &r)
+
+    Draws the ellipse that fits inside the bounds \a r using the
+    current pen and brush.
+
+*/
+
+/*!
+    \fn Q3Painter::drawEllipse(int x, int y, int width, int height)
+
+    \overload
+
+    Draws an ellipse that fits inside the bounds specified by \a x,
+    \a y, \a width and \a height using the current pen and brush.
+
+*/
+
+/*!
+    \fn void Q3Painter::drawPie(int x, int y, int w, int h, int
+    startAngle, int spanAngle)
+
+    \overload
+
+    Draws a pie segment that fits inside the bounds (\a{x}, \a{y},
+    \a{w}, \a{h}) with the given \a startAngle and \a spanAngle.
+*/
+
+/*!
+    \fn void Q3Painter::drawPie(const QRect &r, int a, int alen)
+
+    Draws a pie defined by the rectangle \a r, the start angle \a a
+    and the arc length \a alen.
+
+    The pie is filled with the current brush().
+
+    The angles \a a and \a alen are 1/16th of a degree, i.e. a full
+    circle equals 5760 (16*360). Positive values of \a a and \a alen
+    mean counter-clockwise while negative values mean the clockwise
+    direction. Zero degrees is at the 3 o'clock position.
+
+    \sa drawArc(), drawChord()
+*/
+
+/*!
+    \fn void Q3Painter::drawArc(int x, int y, int w, int h, int
+    startAngle, int spanAngle)
+
+    \overload
+
+    Draws the arc that fits inside the rectangle (\a{x}, \a{y}, \a{w},
+    \a{h}), with the given \a startAngle and \a spanAngle.
+*/
+
+/*!
+    \fn void Q3Painter::drawArc(const QRect &r, int a, int alen)
+
+    Draws an arc defined by the rectangle \a r, the start angle \a a
+    and the arc length \a alen.
+
+    The angles \a a and \a alen are 1/16th of a degree, i.e. a full
+    circle equals 5760 (16*360). Positive values of \a a and \a alen
+    mean counter-clockwise while negative values mean the clockwise
+    direction. Zero degrees is at the 3 o'clock position.
+
+    Example:
+    \snippet doc/src/snippets/code/src_qt3support_painting_q3painter.cpp 0
+
+    \sa drawPie(), drawChord()
+*/
+
+/*!
+    \fn void Q3Painter::drawChord(int x, int y, int w, int h, int
+    startAngle, int spanAngle)
+
+    \overload
+
+    Draws a chord that fits inside the rectangle (\a{x}, \a{y}, \a{w},
+    \a{h}) with the given \a startAngle and \a spanAngle.
+*/
+
+
+/*!
+    \fn void Q3Painter::drawChord(const QRect &r, int a, int alen)
+
+    Draws a chord defined by the rectangle \a r, the start angle \a a
+    and the arc length \a alen.
+
+    The chord is filled with the current brush().
+
+    The angles \a a and \a alen are 1/16th of a degree, i.e. a full
+    circle equals 5760 (16*360). Positive values of \a a and \a alen
+    mean counter-clockwise while negative values mean the clockwise
+    direction. Zero degrees is at the 3 o'clock position.
+
+    \sa drawArc(), drawPie()
+*/
+
+/*!
+    \fn void Q3Painter::drawRoundRect(const QRect &r, int xrnd, int yrnd)
+
+    Draws a rounded rect that fits into the bounds \a r using the current
+    pen and brush. The parameters \a xrnd and \a yrnd specifies the roundness
+    in x and y direction.
+*/
+
+/*!
+    \fn void Q3Painter::drawRoundRect(int x, int y, int w, int h, int xrnd, int yrnd)
+
+    \overload
+
+    Draws a rounded rect that fits into the bounds \a x, \a y, \a w
+    and \a h using the current pen and brush. The parameters \a xrnd
+    and \a yrnd specifies the roundness in x and y direction.
+*/
+
+QT_END_NAMESPACE