source: trunk/src/corelib/tools/qline.cpp@ 561

Last change on this file since 561 was 561, checked in by Dmitry A. Kuminov, 15 years ago

trunk: Merged in qt 4.6.1 sources.

File size: 20.2 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the QtCore module of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and Nokia.
15**
16** GNU Lesser General Public License Usage
17** Alternatively, this file may be used under the terms of the GNU Lesser
18** General Public License version 2.1 as published by the Free Software
19** Foundation and appearing in the file LICENSE.LGPL included in the
20** packaging of this file. Please review the following information to
21** ensure the GNU Lesser General Public License version 2.1 requirements
22** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
23**
24** In addition, as a special exception, Nokia gives you certain additional
25** rights. These rights are described in the Nokia Qt LGPL Exception
26** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you have questions regarding the use of this file, please contact
37** Nokia at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#include "qline.h"
43#include "qdebug.h"
44#include "qdatastream.h"
45#include "qmath.h"
46#include <private/qnumeric_p.h>
47
48QT_BEGIN_NAMESPACE
49
50/*!
51 \class QLine
52 \ingroup painting
53
54 \brief The QLine class provides a two-dimensional vector using
55 integer precision.
56
57 A QLine describes a finite length line (or a line segment) on a
58 two-dimensional surface. The start and end points of the line are
59 specified using integer point accuracy for coordinates. Use the
60 QLineF constructor to retrieve a floating point copy.
61
62 \table
63 \row
64 \o \inlineimage qline-point.png
65 \o \inlineimage qline-coordinates.png
66 \endtable
67
68 The positions of the line's start and end points can be retrieved
69 using the p1(), x1(), y1(), p2(), x2(), and y2() functions. The
70 dx() and dy() functions return the horizontal and vertical
71 components of the line. Use isNull() to determine whether the
72 QLine represents a valid line or a null line.
73
74 Finally, the line can be translated a given offset using the
75 translate() function.
76
77 \sa QLineF, QPolygon, QRect
78*/
79
80/*!
81 \fn QLine::QLine()
82
83 Constructs a null line.
84*/
85
86/*!
87 \fn QLine::QLine(const QPoint &p1, const QPoint &p2)
88
89 Constructs a line object that represents the line between \a p1 and
90 \a p2.
91*/
92
93/*!
94 \fn QLine::QLine(int x1, int y1, int x2, int y2)