qvaluesaxis.cpp
367 lines
| 8.1 KiB
| text/x-c
|
CppLexer
|
r1540 | /**************************************************************************** | ||
** | ||||
** Copyright (C) 2012 Digia Plc | ||||
** All rights reserved. | ||||
** For any questions to Digia, please use contact form at http://qt.digia.com | ||||
** | ||||
** This file is part of the Qt Commercial Charts Add-on. | ||||
** | ||||
** $QT_BEGIN_LICENSE$ | ||||
** Licensees holding valid Qt Commercial licenses may use this file in | ||||
** accordance with the Qt Commercial License Agreement provided with the | ||||
** Software or, alternatively, in accordance with the terms contained in | ||||
** a written agreement between you and Digia. | ||||
** | ||||
** If you have questions regarding the use of this file, please use | ||||
** contact form at http://qt.digia.com | ||||
** $QT_END_LICENSE$ | ||||
** | ||||
****************************************************************************/ | ||||
#include "qvaluesaxis.h" | ||||
#include "qvaluesaxis_p.h" | ||||
|
r1561 | #include "chartvaluesaxisx_p.h" | ||
#include "chartvaluesaxisy_p.h" | ||||
|
r1661 | #include "domain_p.h" | ||
|
r1698 | #include <cmath> | ||
|
r1556 | #include <QDebug> | ||
|
r1540 | |||
QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
|
r1547 | /*! | ||
\class QValuesAxis | ||||
\brief The QValuesAxis class is used for manipulating chart's axis. | ||||
\mainclass | ||||
|
r1639 | ValuesAxis can be setup to show axis line with tick marks, grid lines and shades. | ||
Values of axis are drawn to position of ticks | ||||
|
r1547 | */ | ||
/*! | ||||
|
r1639 | \qmlclass ValuesAxis QValuesAxis | ||
\brief The ValuesAxis element is used for manipulating chart's axes | ||||
|
r1547 | |||
|
r1639 | ValueAxis can be setup to show axis line with tick marks, grid lines and shades. | ||
Values of axis are drawn to position of ticks | ||||
|
r1547 | |||
To access Axes you can use ChartView API. For example: | ||||
\code | ||||
ChartView { | ||||
|
r1639 | ValuesAxis { | ||
id: xAxis | ||||
min: 0 | ||||
max: 10 | ||||
} | ||||
// Add a few series... | ||||
|
r1547 | } | ||
\endcode | ||||
*/ | ||||
/*! | ||||
\property QValuesAxis::min | ||||
Defines the minimum value on the axis. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty real ValuesAxis::min | ||
|
r1547 | Defines the minimum value on the axis. | ||
*/ | ||||
/*! | ||||
\property QValuesAxis::max | ||||
Defines the maximum value on the axis. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty real ValuesAxis::max | ||
|
r1547 | Defines the maximum value on the axis. | ||
*/ | ||||
/*! | ||||
\fn void QValuesAxis::minChanged(qreal min) | ||||
Axis emits signal when \a min of axis has changed. | ||||
*/ | ||||
|
r1654 | /*! | ||
\qmlsignal ValuesAxis::onMinChanged(real min) | ||||
Axis emits signal when \a min of axis has changed. | ||||
*/ | ||||
|
r1547 | |||
/*! | ||||
\fn void QValuesAxis::maxChanged(qreal max) | ||||
Axis emits signal when \a max of axis has changed. | ||||
*/ | ||||
|
r1654 | /*! | ||
\qmlsignal ValuesAxis::onMaxChanged(real max) | ||||
Axis emits signal when \a max of axis has changed. | ||||
*/ | ||||
|
r1547 | |||
/*! | ||||
\fn void QValuesAxis::rangeChanged(qreal min, qreal max) | ||||
Axis emits signal when \a min or \a max of axis has changed. | ||||
*/ | ||||
|
r1540 | |||
|
r1575 | /*! | ||
\property QValuesAxis::ticksCount | ||||
The number of tick marks for the axis. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty int ValuesAxis::ticksCount | ||
|
r1575 | The number of tick marks for the axis. | ||
*/ | ||||
/*! | ||||
\property QValuesAxis::niceNumbersEnabled | ||||
Whether the nice numbers algorithm is enabled or not for the axis. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty bool ValuesAxis::niceNumbersEnabled | ||
|
r1575 | Whether the nice numbers algorithm is enabled or not for the axis. | ||
*/ | ||||
|
r1636 | /*! | ||
Constructs an axis object which is a child of \a parent. | ||||
*/ | ||||
|
r1540 | QValuesAxis::QValuesAxis(QObject *parent) : | ||
QAbstractAxis(*new QValuesAxisPrivate(this),parent) | ||||
{ | ||||
} | ||||
|
r1638 | /*! | ||
\internal | ||||
*/ | ||||
|
r1540 | QValuesAxis::QValuesAxis(QValuesAxisPrivate &d,QObject *parent) : QAbstractAxis(d,parent) | ||
{ | ||||
} | ||||
|
r1638 | /*! | ||
Destroys the object | ||||
*/ | ||||
|
r1540 | QValuesAxis::~QValuesAxis() | ||
{ | ||||
} | ||||
void QValuesAxis::setMin(qreal min) | ||||
{ | ||||
Q_D(QValuesAxis); | ||||
setRange(min,d->m_max); | ||||
} | ||||
qreal QValuesAxis::min() const | ||||
{ | ||||
Q_D(const QValuesAxis); | ||||
return d->m_min; | ||||
} | ||||
void QValuesAxis::setMax(qreal max) | ||||
{ | ||||
Q_D(QValuesAxis); | ||||
setRange(d->m_min,max); | ||||
} | ||||
qreal QValuesAxis::max() const | ||||
{ | ||||
Q_D(const QValuesAxis); | ||||
return d->m_max; | ||||
} | ||||
/*! | ||||
Sets range from \a min to \a max on the axis. | ||||
*/ | ||||
void QValuesAxis::setRange(qreal min, qreal max) | ||||
{ | ||||
Q_D(QValuesAxis); | ||||
|
r1578 | bool changed = false; | ||
|
r1698 | |||
|
r1578 | if (!qFuzzyIsNull(d->m_min - min)) { | ||
d->m_min = min; | ||||
changed = true; | ||||
emit minChanged(min); | ||||
} | ||||
if (!qFuzzyIsNull(d->m_max - max)) { | ||||
d->m_max = max; | ||||
changed = true; | ||||
emit maxChanged(max); | ||||
} | ||||
|
r1698 | if(d->m_niceNumbers) d->looseNiceNumbers(d->m_min, d->m_max, d->m_tickCount); | ||
|
r1578 | if (changed) { | ||
|
r1593 | emit rangeChanged(d->m_min,d->m_max); | ||
|
r1698 | d->emitUpdated(); | ||
|
r1578 | } | ||
|
r1540 | } | ||
/*! | ||||
Sets \a count for ticks on the axis. | ||||
*/ | ||||
void QValuesAxis::setTicksCount(int count) | ||||
{ | ||||
Q_D(QValuesAxis); | ||||
|
r1700 | if (d->m_tickCount != count && count >=2) { | ||
|
r1698 | d->m_tickCount = count; | ||
d->emitUpdated(); | ||||
|
r1540 | } | ||
} | ||||
/*! | ||||
|
r1575 | \fn int QValuesAxis::ticksCount() const | ||
|
r1540 | Return number of ticks on the axis | ||
*/ | ||||
int QValuesAxis::ticksCount() const | ||||
{ | ||||
Q_D(const QValuesAxis); | ||||
|
r1698 | return d->m_tickCount; | ||
|
r1540 | } | ||
void QValuesAxis::setNiceNumbersEnabled(bool enable) | ||||
{ | ||||
Q_D(QValuesAxis); | ||||
if (d->m_niceNumbers != enable){ | ||||
d->m_niceNumbers = enable; | ||||
|
r1700 | if(enable && !qFuzzyIsNull(d->m_max - d->m_min)) setRange(d->min(),d->max()); | ||
|
r1540 | } | ||
} | ||||
bool QValuesAxis::niceNumbersEnabled() const | ||||
{ | ||||
Q_D(const QValuesAxis); | ||||
return d->m_niceNumbers; | ||||
} | ||||
|
r1637 | /*! | ||
Returns the type of the axis | ||||
*/ | ||||
|
r1540 | QAbstractAxis::AxisType QValuesAxis::type() const | ||
{ | ||||
return AxisTypeValues; | ||||
} | ||||
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||||
QValuesAxisPrivate::QValuesAxisPrivate(QValuesAxis* q): | ||||
QAbstractAxisPrivate(q), | ||||
|
r1698 | m_min(0), | ||
m_max(0), | ||||
m_tickCount(5), | ||||
|
r1566 | m_niceNumbers(false) | ||
|
r1540 | { | ||
} | ||||
QValuesAxisPrivate::~QValuesAxisPrivate() | ||||
{ | ||||
} | ||||
|
r1698 | void QValuesAxisPrivate::handleDomainUpdated() | ||
|
r1540 | { | ||
Q_Q(QValuesAxis); | ||||
|
r1698 | Domain* domain = qobject_cast<Domain*>(sender()); | ||
Q_ASSERT(domain); | ||||
if(orientation()==Qt::Horizontal){ | ||||
q->setRange(domain->minX(),domain->maxX()); | ||||
}else if(orientation()==Qt::Vertical){ | ||||
q->setRange(domain->minY(),domain->maxY()); | ||||
} | ||||
|
r1540 | } | ||
|
r1544 | |||
|
r1578 | void QValuesAxisPrivate::setMin(const QVariant &min) | ||
|
r1544 | { | ||
|
r1578 | Q_Q(QValuesAxis); | ||
bool ok; | ||||
qreal value = min.toReal(&ok); | ||||
if(ok) q->setMin(value); | ||||
|
r1544 | } | ||
|
r1578 | void QValuesAxisPrivate::setMax(const QVariant &max) | ||
|
r1544 | { | ||
|
r1652 | |||
|
r1578 | Q_Q(QValuesAxis); | ||
bool ok; | ||||
qreal value = max.toReal(&ok); | ||||
if(ok) q->setMax(value); | ||||
|
r1544 | } | ||
|
r1611 | void QValuesAxisPrivate::setRange(const QVariant &min, const QVariant &max) | ||
|
r1544 | { | ||
Q_Q(QValuesAxis); | ||||
|
r1578 | bool ok1; | ||
bool ok2; | ||||
qreal value1 = min.toReal(&ok1); | ||||
qreal value2 = max.toReal(&ok2); | ||||
if(ok1&&ok2) q->setRange(value1,value2); | ||||
|
r1544 | } | ||
|
r1556 | ChartAxis* QValuesAxisPrivate::createGraphics(ChartPresenter* presenter) | ||
{ | ||||
Q_Q(QValuesAxis); | ||||
if(m_orientation == Qt::Vertical){ | ||||
|
r1561 | return new ChartValuesAxisY(q,presenter); | ||
|
r1556 | }else{ | ||
|
r1561 | return new ChartValuesAxisX(q,presenter); | ||
|
r1556 | } | ||
} | ||||
|
r1695 | void QValuesAxisPrivate::intializeDomain(Domain* domain) | ||
|
r1661 | { | ||
|
r1705 | Q_Q(QValuesAxis); | ||
|
r1662 | if(qFuzzyCompare(m_max,m_min)) { | ||
|
r1661 | if(m_orientation==Qt::Vertical){ | ||
|
r1705 | q->setRange(domain->minY(),domain->maxY()); | ||
|
r1661 | }else{ | ||
|
r1705 | q->setRange(domain->minX(), domain->maxX()); | ||
|
r1661 | } | ||
|
r1703 | } else { | ||
if(m_orientation==Qt::Vertical){ | ||||
domain->setRangeY(m_min, m_max); | ||||
}else{ | ||||
domain->setRangeX(m_min, m_max); | ||||
} | ||||
|
r1661 | } | ||
} | ||||
|
r1698 | //algorithm defined by Paul S.Heckbert GraphicalGems I | ||
void QValuesAxisPrivate::looseNiceNumbers(qreal &min, qreal &max, int &ticksCount) const | ||||
{ | ||||
qreal range = niceNumber(max-min,true); //range with ceiling | ||||
qreal step = niceNumber(range/(ticksCount-1),false); | ||||
min = floor(min/step); | ||||
max = ceil(max/step); | ||||
ticksCount = int(max-min) +1; | ||||
min*=step; | ||||
max*=step; | ||||
} | ||||
//nice numbers can be expressed as form of 1*10^n, 2* 10^n or 5*10^n | ||||
qreal QValuesAxisPrivate::niceNumber(qreal x,bool ceiling) const | ||||
{ | ||||
qreal z = pow(10,floor(log10(x))); //find corresponding number of the form of 10^n than is smaller than x | ||||
qreal q = x/z;//q<10 && q>=1; | ||||
if(ceiling) { | ||||
if(q <= 1.0) q=1; | ||||
else if(q <= 2.0) q=2; | ||||
else if(q <= 5.0) q=5; | ||||
else q=10; | ||||
} | ||||
else { | ||||
if(q < 1.5) q=1; | ||||
else if(q < 3.0) q=2; | ||||
else if(q < 7.0) q=5; | ||||
else q=10; | ||||
} | ||||
return q*z; | ||||
} | ||||
|
r1540 | #include "moc_qvaluesaxis.cpp" | ||
#include "moc_qvaluesaxis_p.cpp" | ||||
QTCOMMERCIALCHART_END_NAMESPACE | ||||