QCPAxis Class Reference

Manages a single axis inside a QCustomPlot. More...

#include <qcustomplot.h>

Inherits QObject.

Public Types
enum	AxisType { ATLeft, ATRight, ATTop, ATBottom }
enum	LabelType { LTNumber, LTDateTime }
enum	ScaleType { STLinear, STLogarithmic }

Public Slots
QCustomPlot *	parentPlot () const
AxisType	axisType () const
QRect	axisRect () const
ScaleType	scaleType () const
double	scaleLogBase () const
const QCPRange	range () const
bool	rangeReversed () const
bool	visible () const
bool	grid () const
bool	subGrid () const
bool	autoTicks () const
int	autoTickCount () const
bool	autoTickLabels () const
bool	autoTickStep () const
bool	autoSubTicks () const
bool	ticks () const
bool	tickLabels () const
int	tickLabelPadding () const
LabelType	tickLabelType () const
QFont	tickLabelFont () const
double	tickLabelRotation () const
QString	dateTimeFormat () const
QString	numberFormat () const
int	numberPrecision () const
double	tickStep () const
QVector< double > *	tickVector () const
QVector< QString > *	tickVectorLabels () const
int	tickLengthIn () const
int	tickLengthOut () const
int	subTickCount () const
int	subTickLengthIn () const
int	subTickLengthOut () const
QPen	basePen () const
QPen	gridPen () const
QPen	subGridPen () const
QPen	zeroLinePen () const
QPen	tickPen () const
QPen	subTickPen () const
QFont	labelFont () const
QString	label () const
int	labelPadding () const
int	padding () const
void	setScaleType (ScaleType type)
void	setScaleLogBase (double base)
void	setRange (double lower, double upper)
void	setRange (double position, double size, Qt::AlignmentFlag alignment)
void	setRangeLower (double lower)
void	setRangeUpper (double upper)
void	setRangeReversed (bool reversed)
void	setVisible (bool on)
void	setGrid (bool show)
void	setSubGrid (bool show)
void	setAutoTicks (bool on)
void	setAutoTickCount (int approximateCount)
void	setAutoTickLabels (bool on)
void	setAutoTickStep (bool on)
void	setAutoSubTicks (bool on)
void	setTicks (bool show)
void	setTickLabels (bool show)
void	setTickLabelPadding (int padding)
void	setTickLabelType (LabelType type)
void	setTickLabelFont (const QFont &font)
void	setTickLabelRotation (double degrees)
void	setDateTimeFormat (const QString &format)
void	setNumberFormat (const QString &formatCode)
void	setNumberPrecision (int precision)
void	setTickStep (double step)
void	setTickVector (QVector< double > *vec, bool copy=false)
void	setTickVectorLabels (QVector< QString > *vec, bool copy=false)
void	setTickLength (int inside, int outside=0)
void	setSubTickCount (int count)
void	setSubTickLength (int inside, int outside=0)
void	setBasePen (const QPen &pen)
void	setGridPen (const QPen &pen)
void	setSubGridPen (const QPen &pen)
void	setZeroLinePen (const QPen &pen)
void	setTickPen (const QPen &pen)
void	setSubTickPen (const QPen &pen)
void	setLabelFont (const QFont &font)
void	setLabel (const QString &str)
void	setLabelPadding (int padding)
void	setPadding (int padding)
Qt::Orientation	orientation () const
void	moveRange (double diff)
void	scaleRange (double factor, double center)
void	setScaleRatio (const QCPAxis *otherAxis, double ratio=1.0)
double	pixelToCoord (double value) const
double	coordToPixel (double value) const
void	setRange (const QCPRange &range)

Signals
void	ticksRequest ()
void	rangeChanged (const QCPRange &newRange)

Public Member Functions
	QCPAxis (QCustomPlot *parentPlot, AxisType type)
virtual	~QCPAxis ()

Protected Member Functions
void	setAxisType (AxisType type)
void	setAxisRect (const QRect &rect)
virtual void	generateTickVectors ()
virtual void	generateAutoTicks ()
virtual int	calculateAutoSubTickCount (double tickStep) const
virtual int	calculateMargin () const
virtual void	drawGrid (QPainter *painter)
virtual void	drawSubGrid (QPainter *painter)
virtual void	drawAxis (QPainter *painter)
virtual void	drawTickLabel (QPainter *painter, double position, int distanceToAxis, const QString &text, QSize *tickLabelsSize)
virtual void	getMaxTickLabelSize (const QFont &font, const QString &text, QSize *tickLabelsSize) const
void	visibleTickBounds (int &lowIndex, int &highIndex) const
double	baseLog (double value) const
double	basePow (double value) const

Protected Attributes
QVector< double > *	mTickVector
QVector< QString > *	mTickVectorLabels
QCPRange	mRange
QString	mDateTimeFormat
QString	mLabel
QRect	mAxisRect
QPen	mBasePen
QPen	mGridPen
QPen	mSubGridPen
QPen	mZeroLinePen
QPen	mTickPen
QPen	mSubTickPen
QFont	mTickLabelFont
QFont	mLabelFont
LabelType	mTickLabelType
ScaleType	mScaleType
AxisType	mAxisType
double	mTickStep
double	mScaleLogBase
double	mScaleLogBaseLogInv
int	mSubTickCount
int	mTickLengthIn
int	mTickLengthOut
int	mSubTickLengthIn
int	mSubTickLengthOut
int	mAutoTickCount
int	mTickLabelPadding
int	mLabelPadding
int	mPadding
double	mTickLabelRotation
bool	mVisible
bool	mGrid
bool	mSubGrid
bool	mTicks
bool	mTickLabels
bool	mAutoTicks
bool	mAutoTickLabels
bool	mAutoTickStep
bool	mAutoSubTicks
bool	mRangeReversed
QCustomPlot *	mParentPlot
QVector< double > *	mSubTickVector
QChar	mExponentialChar
QChar	mPositiveSignChar
int	mNumberPrecision
char	mNumberFormatChar
bool	mNumberBeautifulPowers
bool	mNumberMultiplyCross
Qt::Orientation	mOrientation

Friends
class	QCustomPlot

Detailed Description

Manages a single axis inside a QCustomPlot.

Usually doesn't need to be instantiated externally. Access QCustomPlot's axes via QCustomPlot::xAxis (bottom), QCustomPlot::yAxis (left), QCustomPlot::xAxis2 (top) and QCustomPlot::yAxis2 (right).

Definition at line 667 of file qcustomplot.h.

Member Enumeration Documentation

enum QCPAxis::AxisType

Defines at which side of the axis rect the axis will appear. This also affects how the tick marks are drawn, on which side the labels are placed etc.

See also

setAxisType

Enumerator
ATLeft	Axis is vertical and on the left side of the axis rect of the parent QCustomPlot.
ATRight	Axis is vertical and on the right side of the axis rect of the parent QCustomPlot.
ATTop	Axis is horizontal and on the top side of the axis rect of the parent QCustomPlot.
ATBottom	Axis is horizontal and on the bottom side of the axis rect of the parent QCustomPlot.

Definition at line 711 of file qcustomplot.h.

                {ATLeft,  
                 ATRight, 
                 ATTop,   
                 ATBottom 
                };

enum QCPAxis::LabelType

When automatic tick label generation is enabled (setAutoTickLabels), defines how the numerical value (coordinate) of the tick position is translated into a string that will be drawn at the tick position.

See also

setTickLabelType

Enumerator
LTNumber	Tick coordinate is regarded as normal number and will be displayed as such. (see setNumberFormat)
LTDateTime	Tick coordinate is regarded as a date/time (seconds since 1970-01-01T00:00:00 UTC, see QDateTime::toTime_t) and will be displayed and formatted as such. (see setDateTimeFormat)

Definition at line 723 of file qcustomplot.h.

                 {LTNumber,  
                  LTDateTime 
                 };

enum QCPAxis::ScaleType

Defines the scale of an axis.

See also

setScaleType

Enumerator
STLinear	Normal linear scaling.
STLogarithmic	Logarithmic scaling with correspondingly transformed plots and (major) tick marks at every base power (see setScaleLogBase).

Definition at line 731 of file qcustomplot.h.

                 {STLinear,     
                  STLogarithmic 
                 };

Constructor & Destructor Documentation

QCPAxis::QCPAxis ( QCustomPlot *  parentPlot, AxisType  type  )

explicit

Constructs an Axis instance of Type type inside parentPlot.

Definition at line 3074 of file qcustomplot.cc.

{
  mParentPlot = parentPlot;
  mTickVector = new QVector<double>;
  mSubTickVector = new QVector<double>;
  mTickVectorLabels = new QVector<QString>;
  setAxisType(type);
  setAxisRect(parentPlot->axisRect()); 
  setScaleType(STLinear);
  setScaleLogBase(10);
  
  setVisible(true);
  setRange(0, 5);
  setRangeReversed(false);
  
  setTicks(true);
  setTickStep(1);
  setAutoTickCount(6);
  setAutoTicks(true);
  setAutoTickLabels(true);
  setAutoTickStep(true);
  setTickLabelFont(parentPlot->font());
  setTickLength(5);
  setTickPen(QPen(Qt::black));
  setTickLabels(true);
  setTickLabelType(LTNumber);
  setTickLabelRotation(0);
  setDateTimeFormat("hh:mm:ss\ndd.MM.yy");
  setNumberFormat("gbd");
  setNumberPrecision(6);
  setLabel("");
  setLabelFont(parentPlot->font());
  
  setAutoSubTicks(true);
  setSubTickCount(4);
  setSubTickLength(2);
  setSubTickPen(QPen(Qt::black));
  
  QPen gPen;
  gPen.setColor(QColor(200,200,200));
  gPen.setStyle(Qt::DotLine);
  setGridPen(gPen);
  setGrid(true);
  QPen subgPen;
  subgPen.setColor(QColor(220,220,220));
  subgPen.setStyle(Qt::DotLine);
  setSubGridPen(subgPen);
  setSubGrid(false);
  QPen zlinePen;
  zlinePen.setColor(QColor(200,200,200));
  setZeroLinePen(zlinePen);
  setBasePen(QPen(Qt::black));
  
  setPadding(0);
  if (type == ATTop)
  {
    setTickLabelPadding(3);
    setLabelPadding(6);
  } else if (type == ATRight)
  {
    setTickLabelPadding(7);
    setLabelPadding(12);
  } else if (type == ATBottom)
  {
    setTickLabelPadding(3);
    setLabelPadding(3);
  } else if (type == ATLeft)
  {
    setTickLabelPadding(5);
    setLabelPadding(10);
  }
}

QCPAxis::~QCPAxis ( )

virtual

Definition at line 3147 of file qcustomplot.cc.

{
  delete mTickVector;
  delete mTickVectorLabels;
  delete mSubTickVector;
}

Member Function Documentation

bool QCPAxis::autoSubTicks ( ) const

inlineslot

Definition at line 755 of file qcustomplot.h.

{ return mAutoSubTicks; }

int QCPAxis::autoTickCount ( ) const

inlineslot

Definition at line 752 of file qcustomplot.h.

{ return mAutoTickCount; }

bool QCPAxis::autoTickLabels ( ) const

inlineslot

Definition at line 753 of file qcustomplot.h.

{ return mAutoTickLabels; }

bool QCPAxis::autoTicks ( ) const

inlineslot

Definition at line 751 of file qcustomplot.h.

{ return mAutoTicks; }

bool QCPAxis::autoTickStep ( ) const

inlineslot

Definition at line 754 of file qcustomplot.h.

{ return mAutoTickStep; }

QRect QCPAxis::axisRect ( ) const

inlineslot

Definition at line 743 of file qcustomplot.h.

{ return mAxisRect; }

AxisType QCPAxis::axisType ( ) const

inlineslot

Definition at line 742 of file qcustomplot.h.

{ return mAxisType; }

double QCPAxis::baseLog ( double  value ) const

protected

Definition at line 4752 of file qcustomplot.cc.

{
  return log(value)*mScaleLogBaseLogInv;
}

QPen QCPAxis::basePen ( ) const

inlineslot

Definition at line 773 of file qcustomplot.h.

{ return mBasePen; }

double QCPAxis::basePow ( double  value ) const

protected

Definition at line 4763 of file qcustomplot.cc.

{
  return pow(mScaleLogBase, value);
}

int QCPAxis::calculateAutoSubTickCount ( double  tickStep ) const

protectedvirtual

Definition at line 4147 of file qcustomplot.cc.

{
  int result = mSubTickCount; // default to current setting, if no proper value can be found
  
  // get mantissa of tickstep:
  double magnitudeFactor = pow(10, (int)floor(log10(tickStep))); // get magnitude factor e.g. 0.01, 1, 10, 1000 etc.
  double tickStepMantissa = tickStep/magnitudeFactor;
  
  // separate integer and fractional part of mantissa:
  double epsilon = 0.01;
  double intPartf;
  int intPart;
  double fracPart = modf(tickStepMantissa, &intPartf);
  intPart = intPartf;
  
  // handle cases with (almost) integer mantissa:
  if (fracPart < epsilon || 1.0-fracPart < epsilon)
  {
    if (1.0-fracPart < epsilon)
      intPart++;
    switch (intPart)
    {
      case 1: result = 4; break; // 1.0 -> 0.2 substep
      case 2: result = 3; break; // 2.0 -> 0.5 substep
      case 3: result = 2; break; // 3.0 -> 1.0 substep
      case 4: result = 3; break; // 4.0 -> 1.0 substep
      case 5: result = 4; break; // 5.0 -> 1.0 substep
      case 6: result = 2; break; // 6.0 -> 2.0 substep
      case 7: result = 6; break; // 7.0 -> 1.0 substep
      case 8: result = 3; break; // 8.0 -> 2.0 substep
      case 9: result = 2; break; // 9.0 -> 3.0 substep
    }
  } else
  {
    // handle cases with significantly fractional mantissa:
    if (qAbs(fracPart-0.5) < epsilon) // *.5 mantissa
    {
      switch (intPart)
      {
        case 1: result = 2; break; // 1.5 -> 0.5 substep
        case 2: result = 4; break; // 2.5 -> 0.5 substep
        case 3: result = 4; break; // 3.5 -> 0.7 substep
        case 4: result = 2; break; // 4.5 -> 1.5 substep
        case 5: result = 4; break; // 5.5 -> 1.1 substep (won't occur with autoTickStep from here on)
        case 6: result = 4; break; // 6.5 -> 1.3 substep
        case 7: result = 2; break; // 7.5 -> 2.5 substep
        case 8: result = 4; break; // 8.5 -> 1.7 substep
        case 9: result = 4; break; // 9.5 -> 1.9 substep
      }
    }
    // if mantissa fraction isnt 0.0 or 0.5, don't bother finding good sub tick marks, leave default
  }
  
  return result;
}

int QCPAxis::calculateMargin ( ) const

protectedvirtual

Definition at line 4781 of file qcustomplot.cc.

{
  // run through similar steps as QCPAxis::drawAxis, and caluclate margin needed to fit axis and its labels
  int margin = 0;
  
  if (mVisible)
  {
    int lowTick, highTick;
    visibleTickBounds(lowTick, highTick);
    
    // get length of tick marks reaching outside axis rect:
    margin += qMax(0, qMax(mTickLengthOut, mSubTickLengthOut));
    // calculate size of tick labels:
    QSize tickLabelsSize(0, 0);
    if (mTickLabels)
    {
      for (int i=lowTick; i <= highTick; ++i)
      {
        getMaxTickLabelSize(mTickLabelFont, mTickVectorLabels->at(i), &tickLabelsSize);
      }
      if (orientation() == Qt::Horizontal)
        margin += tickLabelsSize.height() + mTickLabelPadding;
      else
        margin += tickLabelsSize.width() + mTickLabelPadding;
    }
    
    // calculate size of axis label (only height needed, because left/right labels are rotated by 90 degrees):
    if (!mLabel.isEmpty())
    {
      QFontMetrics fontMetrics(mLabelFont);
      QRect bounds;
      bounds = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter | Qt::AlignVCenter, mLabel);
      margin += bounds.height() + mLabelPadding;
    }
  }
  
  margin += mPadding;
  
  if (margin < 15) // need a bit of margin if no axis text is shown at all (i.e. only baseline and tick lines, or no axis at all)
    margin = 15;
  return margin;
}

double QCPAxis::coordToPixel ( double  value ) const

slot

Definition at line 3927 of file qcustomplot.cc.

{
  if (orientation() == Qt::Horizontal)
  {
    if (mScaleType == STLinear)
    {
      if (mRangeReversed)
        return (mRange.upper-value)/mRange.size()*mAxisRect.width()+mAxisRect.left();
      else
        return (value-mRange.lower)/mRange.size()*mAxisRect.width()+mAxisRect.left();
    } else // mScaleType == STLogarithmic
    {
      if (value >= 0 && mRange.upper < 0) // invalid value for logarithmic scale, just draw it outside visible range
        return mRangeReversed ? mAxisRect.left()-200 : mAxisRect.right()+200;
      else if (value <= 0 && mRange.upper > 0) // invalid value for logarithmic scale, just draw it outside visible range
        return mRangeReversed ? mAxisRect.right()+200 : mAxisRect.left()-200;
      else
      {
        if (mRangeReversed)
          return baseLog(mRange.upper/value)/baseLog(mRange.upper/mRange.lower)*mAxisRect.width()+mAxisRect.left();
        else
          return baseLog(value/mRange.lower)/baseLog(mRange.upper/mRange.lower)*mAxisRect.width()+mAxisRect.left();
      }
    }
  } else // orientation() == Qt::Vertical
  {
    if (mScaleType == STLinear)
    {
      if (mRangeReversed)
        return mAxisRect.bottom()-(mRange.upper-value)/mRange.size()*mAxisRect.height();
      else
        return mAxisRect.bottom()-(value-mRange.lower)/mRange.size()*mAxisRect.height();
    } else // mScaleType == STLogarithmic
    {     
      if (value >= 0 && mRange.upper < 0) // invalid value for logarithmic scale, just draw it outside visible range
        return mRangeReversed ? mAxisRect.bottom()+200 : mAxisRect.top()-200;
      else if (value <= 0 && mRange.upper > 0) // invalid value for logarithmic scale, just draw it outside visible range
        return mRangeReversed ? mAxisRect.top()-200 : mAxisRect.bottom()+200;
      else
      {
        if (mRangeReversed)
          return mAxisRect.bottom()-baseLog(mRange.upper/value)/baseLog(mRange.upper/mRange.lower)*mAxisRect.height();
        else
          return mAxisRect.bottom()-baseLog(value/mRange.lower)/baseLog(mRange.upper/mRange.lower)*mAxisRect.height();
      }
    }
  }
}

QString QCPAxis::dateTimeFormat ( ) const

inlineslot

Definition at line 762 of file qcustomplot.h.

{ return mDateTimeFormat; }

void QCPAxis::drawAxis ( QPainter *  painter )

protectedvirtual

Definition at line 4320 of file qcustomplot.cc.

{
  if (!mVisible) return;
  painter->save();
  painter->setRenderHint(QPainter::Antialiasing, mParentPlot->antialiasedElements().testFlag(QCustomPlot::AEAxes));
  QPoint origin;
  if (mAxisType == ATLeft)
    origin = mAxisRect.bottomLeft();
  else if (mAxisType == ATRight)
    origin = mAxisRect.bottomRight();
  else if (mAxisType == ATTop)
    origin = mAxisRect.topLeft();
  else if (mAxisType == ATBottom)
    origin = mAxisRect.bottomLeft();
  
  int xCor = 0, yCor = 0; // paint system correction, for pixel exact matches (affects baselines and ticks of top/right axes)
  if (mAxisType == ATTop)
    yCor = -1;
  else if (mAxisType == ATRight)
    xCor = 1;
  
  int margin = 0;
  int lowTick, highTick;
  visibleTickBounds(lowTick, highTick);
  int t; // helper variable, result of coordinate-to-pixel transforms

  /* draw axes */
  // baselines:
  painter->setPen(mBasePen);
  if (orientation() == Qt::Horizontal)
    painter->drawLine(origin+QPoint(xCor, yCor), origin+QPoint(mAxisRect.width()+xCor, yCor));
  else
    painter->drawLine(origin+QPoint(xCor, yCor), origin+QPoint(xCor, -mAxisRect.height()+yCor));
  
  // ticks:
  if (mTicks)
  {
    painter->setPen(mTickPen);
    // direction of ticks ("inward" is right for left axis and left for right axis)
    int tickDir = (mAxisType == ATBottom || mAxisType == ATRight) ? -1 : 1;
    if (orientation() == Qt::Horizontal)
    {
      for (int i=lowTick; i <= highTick; ++i)
      {
        t = coordToPixel(mTickVector->at(i)); // x
        painter->drawLine(t+xCor, origin.y()-mTickLengthOut*tickDir+yCor, t+xCor, origin.y()+mTickLengthIn*tickDir+yCor);
      }
    } else
    {
      for (int i=lowTick; i <= highTick; ++i)
      {
        t = coordToPixel(mTickVector->at(i)); // y
        painter->drawLine(origin.x()-mTickLengthOut*tickDir+xCor, t+yCor, origin.x()+mTickLengthIn*tickDir+xCor, t+yCor);
      }
    }
  }
  
  // subticks:
  if (mTicks && mSubTickCount > 0)
  {
    painter->setPen(mSubTickPen);
    // direction of ticks ("inward" is right for left axis and left for right axis)
    int tickDir = (mAxisType == ATBottom || mAxisType == ATRight) ? -1 : 1;
    if (orientation() == Qt::Horizontal)
    {
      for (int i=0; i<mSubTickVector->size(); ++i) // no need to check bounds because subticks are always only created inside current mRange
      {
        t = coordToPixel(mSubTickVector->at(i));
        painter->drawLine(t+xCor, origin.y()-mSubTickLengthOut*tickDir+yCor, t+xCor, origin.y()+mSubTickLengthIn*tickDir+yCor);
      }
    } else
    {
      for (int i=0; i<mSubTickVector->size(); ++i)
      {
        t = coordToPixel(mSubTickVector->at(i));
        painter->drawLine(origin.x()-mSubTickLengthOut*tickDir+xCor, t+yCor, origin.x()+mSubTickLengthIn*tickDir+xCor, t+yCor);
      }
    }
  }
  margin += qMax(0, qMax(mTickLengthOut, mSubTickLengthOut));
  
  // tick labels:
  QSize tickLabelsSize; // size of largest tick label, for offset calculation of axis label
  if (mTickLabels)
  {
    margin += mTickLabelPadding;
    painter->setFont(mTickLabelFont);
    for (int i=lowTick; i <= highTick; ++i)
    {
      t = coordToPixel(mTickVector->at(i));
      drawTickLabel(painter, t, margin, mTickVectorLabels->at(i), &tickLabelsSize);
    }
  }
  if (orientation() == Qt::Horizontal)
    margin += tickLabelsSize.height();
  else
    margin += tickLabelsSize.width();

  // axis label:
  if (!mLabel.isEmpty())
  {
    margin += mLabelPadding;
    painter->setFont(mLabelFont);
    QRect bounds;
    bounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip, mLabel);
    if (mAxisType == ATLeft)
    {
      QTransform oldTransform = painter->transform();
      painter->translate((origin.x()-margin-bounds.height()), origin.y());
      painter->rotate(-90);
      painter->drawText(0, 0, mAxisRect.height(), bounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
      painter->setTransform(oldTransform);
    }
    else if (mAxisType == ATRight)
    {
      QTransform oldTransform = painter->transform();
      painter->translate((origin.x()+margin+bounds.height()), origin.y()-mAxisRect.height());
      painter->rotate(90);
      painter->drawText(0, 0, mAxisRect.height(), bounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
      painter->setTransform(oldTransform);
    }
    else if (mAxisType == ATTop)
      painter->drawText(origin.x(), origin.y()-margin-bounds.height(), mAxisRect.width(), bounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
    else if (mAxisType == ATBottom)
      painter->drawText(origin.x(), origin.y()+margin, mAxisRect.width(), bounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
  }

  painter->restore();
}

void QCPAxis::drawGrid ( QPainter *  painter )

protectedvirtual

Definition at line 4209 of file qcustomplot.cc.

{
  if (!mVisible || (!mGrid && mZeroLinePen.style() == Qt::NoPen)) return;
  painter->save();
  int lowTick, highTick;
  visibleTickBounds(lowTick, highTick);
  int t; // helper variable, result of coordinate-to-pixel transforms
  if (orientation() == Qt::Horizontal)
  {
    // draw zeroline:
    int zeroLineIndex = -1;
    if (mZeroLinePen.style() != Qt::NoPen && mRange.lower < 0 && mRange.upper > 0)
    {
      painter->setRenderHint(QPainter::Antialiasing, mParentPlot->antialiasedElements().testFlag(QCustomPlot::AEZeroLine));
      painter->setPen(mZeroLinePen);
      double epsilon = mRange.size()*1E-6; // for comparing double to zero
      for (int i=lowTick; i <= highTick; ++i)
      {
        if (fabs(mTickVector->at(i)) < epsilon)
        {
          zeroLineIndex = i;
          t = coordToPixel(mTickVector->at(i)); // x
          painter->drawLine(t, mAxisRect.bottom(), t, mAxisRect.top());
          break;
        }
      }
    }
    // draw grid lines:
    if (mGrid)
    {
      painter->setRenderHint(QPainter::Antialiasing, mParentPlot->antialiasedElements().testFlag(QCustomPlot::AEGrid));
      painter->setPen(mGridPen);
      for (int i=lowTick; i <= highTick; ++i)
      {
        if (i == zeroLineIndex) continue; // don't draw a gridline on top of the zeroline
        t = coordToPixel(mTickVector->at(i)); // x
        painter->drawLine(t, mAxisRect.bottom(), t, mAxisRect.top());
      }
    }
  } else
  {
    // draw zeroline:
    int zeroLineIndex = -1;
    if (mZeroLinePen.style() != Qt::NoPen && mRange.lower < 0 && mRange.upper > 0)
    {
      painter->setRenderHint(QPainter::Antialiasing, mParentPlot->antialiasedElements().testFlag(QCustomPlot::AEZeroLine));
      painter->setPen(mZeroLinePen);
      double epsilon = mRange.size()*1E-6; // for comparing double to zero
      for (int i=lowTick; i <= highTick; ++i)
      {
        if (fabs(mTickVector->at(i)) < epsilon)
        {
          zeroLineIndex = i;
          t = coordToPixel(mTickVector->at(i)); // y
          painter->drawLine(mAxisRect.left(), t, mAxisRect.right(), t);
          break;
        }
      }
    }
    // draw grid lines:
    if (mGrid)
    {
      painter->setRenderHint(QPainter::Antialiasing, mParentPlot->antialiasedElements().testFlag(QCustomPlot::AEGrid));
      painter->setPen(mGridPen);
      for (int i=lowTick; i <= highTick; ++i)
      {
        if (i == zeroLineIndex) continue; // don't draw a gridline on top of the zeroline
        t = coordToPixel(mTickVector->at(i)); // y
        painter->drawLine(mAxisRect.left(), t, mAxisRect.right(), t);
      }
    }
  }
  painter->restore();
}

void QCPAxis::drawSubGrid ( QPainter *  painter )

protectedvirtual

Definition at line 4289 of file qcustomplot.cc.

{
  if (!mVisible || !mSubGrid || !mGrid) return;
  painter->save();
  painter->setRenderHint(QPainter::Antialiasing, mParentPlot->antialiasedElements().testFlag(QCustomPlot::AESubGrid));
  
  int t; // helper variable, result of coordinate-to-pixel transforms
  painter->setPen(mSubGridPen);
  if (orientation() == Qt::Horizontal)
  {
    for (int i=0; i<mSubTickVector->size(); ++i)
    {
      t = coordToPixel(mSubTickVector->at(i)); // x
      painter->drawLine(t, mAxisRect.bottom(), t, mAxisRect.top());
    }
  } else
  {
    for (int i=0; i<mSubTickVector->size(); ++i)
    {
      t = coordToPixel(mSubTickVector->at(i)); // y
      painter->drawLine(mAxisRect.left(), t, mAxisRect.right(), t);
    }
  }
  painter->restore();
}

void QCPAxis::drawTickLabel ( QPainter *  painter, double  position, int  distanceToAxis, const QString &  text, QSize *  tickLabelsSize  )

protectedvirtual

Definition at line 4468 of file qcustomplot.cc.

{
  // warning: if you change anything here, also adapt getMaxTickLabelSize() accordingly!
  
  // determine whether beautiful decimal powers should be used
  bool useBeautifulPowers = false;
  int ePos = -1;
  if (mAutoTickLabels && mNumberBeautifulPowers && mTickLabelType == LTNumber)
  {
    ePos = text.indexOf('e');
    if (ePos > -1)
      useBeautifulPowers = true;
  }
  
  // calculate text bounding rects and do string preparation for beautiful decimal powers:
  QRect bounds, baseBounds, expBounds;
  QString basePart, expPart;
  QFont expFont;
  if (useBeautifulPowers)
  {
    // split string parts for part of number/symbol that will be drawn normally and part that will be drawn as exponent:
    basePart = text.left(ePos);
    // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base:
    if (mScaleType == STLogarithmic && basePart == "1")
      basePart = "10";
    else
      basePart += (mNumberMultiplyCross ? QString(QChar(215)) : QString(QChar(183))) + "10";
    expPart = text.mid(ePos+1);
    // clip "+" and leading zeros off expPart:
    while (expPart.at(1) == '0' && expPart.length() > 2) // length > 2 so we leave one zero when numberFormatChar is 'e'
      expPart.remove(1, 1);
    if (expPart.at(0) == mPositiveSignChar)
      expPart.remove(0, 1);
    // prepare smaller font for exponent:
    expFont = painter->font();
    expFont.setPointSize(expFont.pointSize()*0.75);
    // calculate bounding rects of base part, exponent part and total one:
    baseBounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip, basePart);
    QFontMetrics expFontMetrics(expFont);
    expBounds = expFontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip, expPart);
    bounds = baseBounds.adjusted(0, 0, expBounds.width(), 0);
  } else // useBeautifulPowers == false
  {
    bounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, text);
  }
  
  // if using rotated tick labels, transform bounding rect, too:
  QRect rotatedBounds = bounds;
  if (!qFuzzyCompare(mTickLabelRotation+1.0, 1.0))
  {
    QTransform transform;
    transform.rotate(mTickLabelRotation);
    rotatedBounds = transform.mapRect(bounds);
  }
  // expand passed tickLabelsSize if current tick label is larger:
  if (rotatedBounds.width() > tickLabelsSize->width()) 
    tickLabelsSize->setWidth(rotatedBounds.width());
  if (rotatedBounds.height() > tickLabelsSize->height())
    tickLabelsSize->setHeight(rotatedBounds.height());
  
  // calculate coordinates (non-trivial, for best visual appearance):
  // short explanation for bottom axis: The anchor, i.e. the point in the label that is placed horizontally under the
  //   corresponding tick is always on the label side that is closer to the axis (e.g. the left side of the text when we're
  //   rotating clockwise). On that side, the height-edge is halved and the resulting median point is defined the anchor. This way,
  //   a 90 degree rotated text will be centered under the tick (i.e. displaced horizontally by half its height). At the
  //   same time, a 45 degree rotated text will "point toward" its tick, as is typical for rotated tick labels.
  bool doRotation = !qFuzzyCompare(mTickLabelRotation+1.0, 1.0);
  double angle = mTickLabelRotation/180.0*M_PI;
  int x=0,y=0;
  if (mAxisType == ATLeft)
  {
    if (doRotation)
    {
      if (mTickLabelRotation > 0)
      {
        x = mAxisRect.left()-cos(angle)*bounds.width()-distanceToAxis;
        y = position-sin(angle)*bounds.width()-cos(angle)*bounds.height()/2.0;
      } else
      {
        x = mAxisRect.left()-cos(-angle)*bounds.width()-sin(-angle)*bounds.height()-distanceToAxis;
        y = position+sin(-angle)*bounds.width()-cos(-angle)*bounds.height()/2.0;
      }
    } else
    {
      x = mAxisRect.left()-bounds.width()-distanceToAxis;
      y = position-bounds.height()/2.0;
    }
  } else if (mAxisType == ATRight)
  {
    if (doRotation)
    {
      if (mTickLabelRotation > 0)
      {
        x = mAxisRect.right()+sin(angle)*bounds.height()+distanceToAxis;
        y = position-cos(angle)*bounds.height()/2.0;
      } else
      {
        x = mAxisRect.right()+distanceToAxis;
        y = position-cos(-angle)*bounds.height()/2.0;
      }
    } else
    {
      x = mAxisRect.right()+distanceToAxis;
      y = position-bounds.height()/2.0;
    }
  } else if (mAxisType == ATTop)
  {
    if (doRotation)
    {
      if (mTickLabelRotation > 0)
      {
        x = position-cos(angle)*bounds.width()+sin(angle)*bounds.height()/2.0;
        y = mAxisRect.top()-sin(angle)*bounds.width()-cos(angle)*bounds.height()-distanceToAxis;
      } else
      {
        x = position-sin(-angle)*bounds.height()/2.0;
        y = mAxisRect.top()-cos(-angle)*bounds.height()-distanceToAxis;
      }
    } else
    {
      x = position-bounds.width()/2.0;
      y = mAxisRect.top()-bounds.height()-distanceToAxis;
    }
  } else if (mAxisType == ATBottom)
  {
    if (doRotation)
    {
      if (mTickLabelRotation > 0)
      {
        x = position+sin(angle)*bounds.height()/2.0;
        y = mAxisRect.bottom()+distanceToAxis;
      } else
      {
        x = position-cos(-angle)*bounds.width()-sin(-angle)*bounds.height()/2.0;
        y = mAxisRect.bottom()+sin(-angle)*bounds.width()+distanceToAxis;
      }
    } else
    {
      x = position-bounds.width()/2.0;
      y = mAxisRect.bottom()+distanceToAxis;
    }
  }
  
  // if label would be partly clipped by widget border on sides, don't draw it:
  if (orientation() == Qt::Horizontal)
  {
    if (x+bounds.width() > mParentPlot->mViewport.right() ||
        x < mParentPlot->mViewport.left())
      return;
  } else
  {
    if (y+bounds.height() > mParentPlot->mViewport.bottom() ||
        y < mParentPlot->mViewport.top())
      return;
  }
  
  // transform painter to position/rotation:
  QTransform oldTransform = painter->transform();
  painter->translate(x, y);
  if (doRotation)
    painter->rotate(mTickLabelRotation);
  // draw text:
  if (useBeautifulPowers)
  {
    // draw base:
    painter->drawText(0, 0, 0, 0, Qt::TextDontClip, basePart);
    // draw exponent:
    painter->setFont(expFont);
    painter->drawText(baseBounds.width()+1, 0, expBounds.width(), expBounds.height(), Qt::TextDontClip,  expPart);
    painter->setFont(mTickLabelFont);
  } else // useBeautifulPowers == false
  {
    painter->drawText(0, 0, bounds.width(), bounds.height(), Qt::TextDontClip | Qt::AlignHCenter, text);
  }
  
  // reset rotation/translation transform to what it was before:
  painter->setTransform(oldTransform);
}

void QCPAxis::generateAutoTicks ( )

protectedvirtual

Definition at line 4069 of file qcustomplot.cc.

{
  if (mScaleType == STLinear)
  {
    if (mAutoTickStep)
    {
      // Generate tick positions according to linear scaling:
      mTickStep = mRange.size()/(double)mAutoTickCount; // mAutoTickCount ticks on average
      double magnitudeFactor = pow(10, (int)floor(log10(mTickStep))); // get magnitude factor e.g. 0.01, 1, 10, 1000 etc.
      double tickStepMantissa = mTickStep/magnitudeFactor;
      if (tickStepMantissa < 5)
      {
        // round digit after decimal point to 0.5
        mTickStep = (int)(tickStepMantissa*2)/2.0*magnitudeFactor;
      } else
      {
        // round to first digit in multiples of 2
        mTickStep = (int)((tickStepMantissa/10.0)*5)/5.0*10*magnitudeFactor;
      }
    }
    if (mAutoSubTicks)
      mSubTickCount = calculateAutoSubTickCount(mTickStep);
    // Generate tick positions according to mTickStep:
    int firstStep = floor(mRange.lower/mTickStep);
    int lastStep = ceil(mRange.upper/mTickStep);
    int tickcount = lastStep-firstStep+1;
    if (tickcount < 0) tickcount = 0;
    mTickVector->resize(tickcount);
    for (int i=0; i<tickcount; ++i)
    {
      (*mTickVector)[i] = (firstStep+i)*mTickStep;
    }
  } else // mScaleType == STLogarithmic
  {
    // Generate tick positions according to logbase scaling:
    if (mRange.lower > 0 && mRange.upper > 0) // positive range
    {
      double lowerMag = basePow((int)floor(baseLog(mRange.lower)));
      double currentMag = lowerMag;
      mTickVector->clear();
      mTickVector->append(currentMag);
      while (currentMag < mRange.upper && currentMag > 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case
      {
        currentMag *= mScaleLogBase;
        mTickVector->append(currentMag);
      }
    } else if (mRange.lower < 0 && mRange.upper < 0) // negative range
    {
      double lowerMag = -basePow((int)ceil(baseLog(-mRange.lower)));
      double currentMag = lowerMag;
      mTickVector->clear();
      mTickVector->append(currentMag);
      while (currentMag < mRange.upper && currentMag < 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case
      {
        currentMag /= mScaleLogBase;
        mTickVector->append(currentMag);
      }
    } else // invalid range for logarithmic scale, because lower and upper have different sign
    {
      mTickVector->clear();
      qDebug() << FUNCNAME << "Invalid range for logarithmic plot: " << mRange.lower << "-" << mRange.upper;
    }
  }
}

void QCPAxis::generateTickVectors ( )

protectedvirtual

Definition at line 3984 of file qcustomplot.cc.

{
  if ((!mTicks && !mTickLabels && !mGrid) || mRange.size() <= 0) return;
  
  // fill tick vectors, either by auto generating or by notifying user to fill the vectors himself
  if (mAutoTicks)
  {
    generateAutoTicks();
  } else
  {
    emit ticksRequest();
  }
  
  if (mTickVector->isEmpty())
  {
    mSubTickVector->clear();
    return;
  }
  
  // generate subticks between ticks:
  mSubTickVector->resize((mTickVector->size()-1)*mSubTickCount);
  if (mSubTickCount > 0)
  {
    double subTickStep = 0;
    double subTickPosition = 0;
    int subTickIndex = 0;
    bool done = false;
    for (int i=1; i<mTickVector->size(); ++i)
    {
      subTickStep = (mTickVector->at(i)-mTickVector->at(i-1))/(double)(mSubTickCount+1);
      for (int k=1; k<=mSubTickCount; ++k)
      {
        subTickPosition = mTickVector->at(i-1) + k*subTickStep;
        if (subTickPosition < mRange.lower)
          continue;
        if (subTickPosition > mRange.upper)
        {
          done = true;
          break;
        }
        (*mSubTickVector)[subTickIndex] = subTickPosition;
        subTickIndex++;
      }
      if (done) break;
    }
    mSubTickVector->resize(subTickIndex);
  }

  // generate tick labels according to tick positions:
  mExponentialChar = mParentPlot->locale().exponential();   // will be needed when drawing the numbers generated here, in drawTickLabel()
  mPositiveSignChar = mParentPlot->locale().positiveSign(); // will be needed when drawing the numbers generated here, in drawTickLabel()
  if (mAutoTickLabels)
  {
    int vecsize = mTickVector->size();
    mTickVectorLabels->resize(vecsize);
    if (mTickLabelType == LTNumber)
    {
      for (int i=0; i<vecsize; ++i)
        (*mTickVectorLabels)[i] = mParentPlot->locale().toString(mTickVector->at(i), mNumberFormatChar, mNumberPrecision);
    } else if (mTickLabelType == LTDateTime)
    {
      for (int i=0; i<vecsize; ++i)
        (*mTickVectorLabels)[i] = mParentPlot->locale().toString(QDateTime::fromTime_t(mTickVector->at(i)), mDateTimeFormat);
    }
  } else // mAutoTickLabels == false
  {
    if (mAutoTicks) // ticks generated automatically, but not ticklabels, so emit ticksRequest here for labels
    {
      emit ticksRequest();
    }
    // make sure provided tick label vector has correct (minimal) length:
    if (mTickVectorLabels->size() < mTickVector->size())
      mTickVectorLabels->resize(mTickVector->size());
  }
}

void QCPAxis::getMaxTickLabelSize ( const QFont &  font, const QString &  text, QSize *  tickLabelsSize  ) const

protectedvirtual

Definition at line 4655 of file qcustomplot.cc.

{
  // This function does the same as drawTickLabel but omits the actual drawing
  // changes involve creating extra QFontMetrics instances for font, since painter->fontMetrics() isn't available
  
  // determine whether beautiful powers should be used
  bool useBeautifulPowers = false;
  int ePos=-1;
  if (mAutoTickLabels && mNumberBeautifulPowers && mTickLabelType == LTNumber)
  {
    ePos = text.indexOf(mExponentialChar);
    if (ePos > -1)
      useBeautifulPowers = true;
  }
  
  // calculate and draw text, depending on whether beautiful powers are applicable or not:
  QRect bounds, baseBounds, expBounds;
  QString basePart, expPart;
  QFont expFont;
  if (useBeautifulPowers)
  {
    // split string parts for part of number/symbol that will be drawn normally and part that will be drawn as exponent:
    basePart = text.left(ePos);
    // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base:
    if (mScaleType == STLogarithmic && basePart == "1")
      basePart = "10";
    else
      basePart += (mNumberMultiplyCross ? QString(QChar(215)) : QString(QChar(183))) + "10";
    expPart = text.mid(ePos+1);
    // clip "+" and leading zeros off expPart:
    while (expPart.at(1) == '0' && expPart.length() > 2) // length > 2 so we leave one zero when numberFormatChar is 'e'
      expPart.remove(1, 1);
    if (expPart.at(0) == mPositiveSignChar)
      expPart.remove(0, 1);
    // prepare smaller font for exponent:
    expFont = font;
    expFont.setPointSize(expFont.pointSize()*0.75);
    // calculate bounding rects of base part, exponent part and total one:
    QFontMetrics baseFontMetrics(font);
    baseBounds = baseFontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip, basePart);
    QFontMetrics expFontMetrics(expFont);
    expBounds = expFontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip, expPart);
    bounds = baseBounds.adjusted(0, 0, expBounds.width(), 0); 
  } else // useBeautifulPowers == false
  {
    QFontMetrics fontMetrics(font);
    bounds = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, text);
  }
  
  // if rotated tick labels, transform bounding rect, too:
  QRect rotatedBounds = bounds;
  if (!qFuzzyCompare(mTickLabelRotation+1.0, 1.0))
  {
    QTransform transform;
    transform.rotate(mTickLabelRotation);
    rotatedBounds = transform.mapRect(bounds);
  }
  // expand passed tickLabelsSize if current tick label is larger:
  if (rotatedBounds.width() > tickLabelsSize->width()) 
    tickLabelsSize->setWidth(rotatedBounds.width());
  if (rotatedBounds.height() > tickLabelsSize->height())
    tickLabelsSize->setHeight(rotatedBounds.height());
}

bool QCPAxis::grid ( ) const

inlineslot

Definition at line 749 of file qcustomplot.h.

{ return mGrid; }

QPen QCPAxis::gridPen ( ) const

inlineslot

Definition at line 774 of file qcustomplot.h.

{ return mGridPen; }

QString QCPAxis::label ( ) const

inlineslot

Definition at line 780 of file qcustomplot.h.

{ return mLabel; }

QFont QCPAxis::labelFont ( ) const

inlineslot

Definition at line 779 of file qcustomplot.h.

{ return mLabelFont; }

int QCPAxis::labelPadding ( ) const

inlineslot

Definition at line 781 of file qcustomplot.h.

{ return mLabelPadding; }

void QCPAxis::moveRange ( double  diff )

slot

If the scale type (setScaleType) is STLinear, diff is added to the lower and upper bounds of the range. The range is simply moved by diff. If the scale type is STLogarithmic, the range bounds are multiplied by diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff).

Definition at line 3813 of file qcustomplot.cc.

{
  if (mScaleType == STLinear)
  {
    mRange.lower += diff;
    mRange.upper += diff;
  } else // mScaleType == STLogarithmic
  {
    mRange.lower *= diff;
    mRange.upper *= diff;
  }
  emit rangeChanged(mRange);
}

QString QCPAxis::numberFormat ( ) const

slot

Returns the number Format.

See also

setNumberFormat

Definition at line 3158 of file qcustomplot.cc.

{
  QString result;
  result.append(mNumberFormatChar);
  if (mNumberBeautifulPowers)
  {
    result.append("b");
    if (mNumberMultiplyCross)
      result.append("c");
  }
  return result;
}

int QCPAxis::numberPrecision ( ) const

inlineslot

Definition at line 764 of file qcustomplot.h.

{ return mNumberPrecision; }

Qt::Orientation QCPAxis::orientation ( ) const

inlineslot

Definition at line 827 of file qcustomplot.h.

{ return mOrientation; }

int QCPAxis::padding ( ) const

inlineslot

Definition at line 782 of file qcustomplot.h.

{ return mPadding; }

QCustomPlot* QCPAxis::parentPlot ( ) const

inlineslot

Definition at line 741 of file qcustomplot.h.

{ return mParentPlot; }

double QCPAxis::pixelToCoord ( double  value ) const

slot

Definition at line 3888 of file qcustomplot.cc.

{
  if (orientation() == Qt::Horizontal)
  {
    if (mScaleType == STLinear)
    {
      if (mRangeReversed)
        return -(value-mAxisRect.left())/(double)mAxisRect.width()*mRange.size()+mRange.upper;
      else
        return (value-mAxisRect.left())/(double)mAxisRect.width()*mRange.size()+mRange.lower;
    } else // mScaleType == STLogarithmic
    {
      if (mRangeReversed)
        return pow(mRange.upper/mRange.lower, (mAxisRect.left()-value)/(double)mAxisRect.width())*mRange.upper;
      else
        return pow(mRange.upper/mRange.lower, (value-mAxisRect.left())/(double)mAxisRect.width())*mRange.lower;
    }
  } else // orientation() == Qt::Vertical
  {
    if (mScaleType == STLinear)
    {
      if (mRangeReversed)
        return -(mAxisRect.bottom()-value)/(double)mAxisRect.height()*mRange.size()+mRange.upper;
      else
        return (mAxisRect.bottom()-value)/(double)mAxisRect.height()*mRange.size()+mRange.lower;
    } else // mScaleType == STLogarithmic
    {
      if (mRangeReversed)
        return pow(mRange.upper/mRange.lower, (value-mAxisRect.bottom())/(double)mAxisRect.height())*mRange.upper;
      else
        return pow(mRange.upper/mRange.lower, (mAxisRect.bottom()-value)/(double)mAxisRect.height())*mRange.lower;
    }
  }
}

const QCPRange QCPAxis::range ( ) const

inlineslot

Definition at line 746 of file qcustomplot.h.

{ return mRange; }

void QCPAxis::rangeChanged ( const QCPRange &  newRange )

signal

bool QCPAxis::rangeReversed ( ) const

inlineslot

Definition at line 747 of file qcustomplot.h.

{ return mRangeReversed; }

double QCPAxis::scaleLogBase ( ) const

inlineslot

Definition at line 745 of file qcustomplot.h.

{ return mScaleLogBase; }

void QCPAxis::scaleRange ( double  factor, double  center  )

slot

Scales the range of this axis by factor around the coordinate center. For example, if factor is 2.0, center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed it's position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0).

Definition at line 3833 of file qcustomplot.cc.

{
  
  if (mScaleType == STLinear)
  {
    QCPRange newRange;
    newRange.lower = (mRange.lower-center)*factor + center;
    newRange.upper = (mRange.upper-center)*factor + center;
    if (QCPRange::validRange(newRange))
      mRange = newRange.sanitizedForLinScale();
  } else // mScaleType == STLogarithmic
  {
    if ((mRange.upper < 0 && center < 0) || (mRange.upper > 0 && center > 0)) // make sure center has same sign as range
    {
      QCPRange newRange;
      newRange.lower = pow(mRange.lower/center, factor)*center;
      newRange.upper = pow(mRange.upper/center, factor)*center;
      if (QCPRange::validRange(newRange))
        mRange = newRange.sanitizedForLogScale();
    } else
      qDebug() << FUNCNAME << "center of scaling operation doesn't lie in same logarithmic sign domain as range:" << center;
  }
  emit rangeChanged(mRange);
}

ScaleType QCPAxis::scaleType ( ) const

inlineslot

Definition at line 744 of file qcustomplot.h.

{ return mScaleType; }

void QCPAxis::setAutoSubTicks ( bool  on )

slot

Sets whether then number of sub ticks in one tick interval is determined automatically. This works, as long as the tick step mantissa is a multiple of 0.5 (which it is, when setAutoTickStep is enabled).
When on is set to false, you may set the sub tick count with setSubTickCount manually.

Definition at line 3428 of file qcustomplot.cc.

{
  mAutoSubTicks = on;
}

void QCPAxis::setAutoTickCount ( int  approximateCount )

slot

When setAutoTickStep is true, approximateCount determines how many ticks should be generated in the visible range approximately.

Definition at line 3389 of file qcustomplot.cc.

{
  mAutoTickCount = approximateCount;
}

void QCPAxis::setAutoTickLabels ( bool  on )

slot

Sets whether the tick labels are generated automatically depending on the tick label type (LTNumber or LTDateTime).

If on is set to false, you should provide the tick labels via setTickVectorLabels. (This is usually used in a combination with setAutoTicks set to false for complete control over tick positions and labels, e.g. when the ticks should be at multiples of pi and show n*pi as tick labels.)

Definition at line 3402 of file qcustomplot.cc.

{
  mAutoTickLabels = on;
}

void QCPAxis::setAutoTicks ( bool  on )

slot

Sets whether the tick positions should be calculated automatically (either from an automatically generated tick step or a tick step provided manually via setTickStep, see setAutoTickStep).

If on is set to false, you must provide the tick positions manually via setTickVector. For these manual ticks you may let QCPAxis generate the appropriate labels automatically by setting/leaving setAutoTickLabels true. If you also wish to control the displayed labels manually, set setAutoTickLabels to false and provide the label strings with setTickVectorLabels.

Definition at line 3380 of file qcustomplot.cc.

{
  mAutoTicks = on;
}

void QCPAxis::setAutoTickStep ( bool  on )

slot

Sets whether the tick step, i.e. the interval between two (major) ticks, is calculated automatically. If on is set to true, the axis finds a tick step that is reasonable for human readable plots. This means the tick step mantissa is chosen such that it's either a multiple of two or ends in 0.5. The number of ticks the algorithm aims for within the visible range can be set with setAutoTickCount. It's not guaranteed that this number of ticks is met exactly, but approximately within a tolerance of two or three.

If on is set to false, you may set the tick step manually with setTickStep.

Definition at line 3417 of file qcustomplot.cc.

{
  mAutoTickStep = on;
}

void QCPAxis::setAxisRect ( const QRect &  rect )

protected

Definition at line 3190 of file qcustomplot.cc.

{
  mAxisRect = rect;
}

void QCPAxis::setAxisType ( AxisType  type )

protected

Definition at line 3177 of file qcustomplot.cc.

{
  mAxisType = type;
  mOrientation = (type == ATBottom || type == ATTop) ? Qt::Horizontal : Qt::Vertical;
}

void QCPAxis::setBasePen ( const QPen &  pen )

slot

Sets the pen, the axis base line itself is drawn with.

Definition at line 3710 of file qcustomplot.cc.

{
  mBasePen = pen;
}

void QCPAxis::setDateTimeFormat ( const QString &  format )

slot

Sets the format in which dates and times are displayed as tick labels, if setTickLabelType is LTDateTime. for details about the format string, see the documentation of QDateTime::toString(). Newlines can be inserted with "\n".

Definition at line 3497 of file qcustomplot.cc.

{
  mDateTimeFormat = format;
}

void QCPAxis::setGrid ( bool  show )

slot

Sets whether the grid lines are visible.

See also

setSubGrid, setGridPen

Definition at line 3357 of file qcustomplot.cc.

{
  mGrid = show;
}

void QCPAxis::setGridPen ( const QPen &  pen )

slot

Sets the pen, grid lines are drawn with.

See also

setSubGridPen

Definition at line 3719 of file qcustomplot.cc.

{
  mGridPen = pen;
}

void QCPAxis::setLabel ( const QString &  str )

slot

Sets the axis label that will be shown below/above or next to the axis, depending on its orientation.

Definition at line 3775 of file qcustomplot.cc.

{
  mLabel = str;
}

void QCPAxis::setLabelFont ( const QFont &  font )

slot

Sets the font of the axis label.

Definition at line 3767 of file qcustomplot.cc.

{
  mLabelFont = font;
}

void QCPAxis::setLabelPadding ( int  padding )

slot

Sets the distance between the tick labels and the axis label.

See also

setTickLabelPadding, setPadding

Definition at line 3784 of file qcustomplot.cc.

{
  mLabelPadding = padding;
}

void QCPAxis::setNumberFormat ( const QString &  formatCode )

slot

Sets the number format for the numbers drawn as tick labels (if tick label type is LTNumber). This formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class. formatCode is a string of one, two or three characters. The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter.

The second and third characters are optional and specific to QCustomPlot:
If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which is ugly in a plot. So when the second char of formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot.

If the scale type (setScaleType) is STLogarithmic and the formatCode uses the 'b' option (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10 [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]" part). To only display the decimal power, set the number precision to zero with setNumberPrecision.

Examples for formatCode:

• g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used
• gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign
• ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign
• fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'.
• hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed.

Definition at line 3538 of file qcustomplot.cc.

{
  if (formatCode.length() < 1) return;
  
  // interpret first char as number format char:
  QString allowedFormatChars = "eEfgG";
  if (allowedFormatChars.contains(formatCode.at(0)))
  {
    mNumberFormatChar = formatCode.at(0).toAscii();
  } else
  {
    qDebug() << FUNCNAME << "Invalid number format code (first char not in 'eEfgG'):" << formatCode;
    return;
  }
  if (formatCode.length() < 2)
  {
    mNumberBeautifulPowers = false;
    mNumberMultiplyCross = false;
    return;
  }
  
  // interpret second char as indicator for beautiful decimal powers:
  if (formatCode.at(1) == 'b' && (mNumberFormatChar == 'e' || mNumberFormatChar == 'g'))
  {
    mNumberBeautifulPowers = true;
  } else
  {
    qDebug() << FUNCNAME << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode;
    return;
  }
  if (formatCode.length() < 3)
  {
    mNumberMultiplyCross = false;
    return;
  }
  
  // interpret third char as indicator for dot or cross multiplication symbol:
  if (formatCode.at(2) == 'c')
  {
    mNumberMultiplyCross = true;
  } else if (formatCode.at(2) == 'd')
  {
    mNumberMultiplyCross = false;
  } else
  {
    qDebug() << FUNCNAME << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode;
    return;
  }
}

void QCPAxis::setNumberPrecision ( int  precision )

slot

Sets the precision of the numbers drawn as tick labels. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Format starting with 'e', see setNumberFormat

If the scale type (setScaleType) is STLogarithmic and the number format (setNumberFormat) uses the 'b' format code (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10 [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]" part). To only display the decimal power, set precision to zero.

Definition at line 3599 of file qcustomplot.cc.

{
  mNumberPrecision = precision;
}

void QCPAxis::setPadding ( int  padding )

slot

Sets the padding of the axis.

When QCustomPlot::setAutoMargin is enabled, the padding is the additional distance to the respective widget border, that is left blank. If padding is zero (default), the auto margin mechanism will find a margin that the axis label (or tick label, if no axis label is set) barely fits inside the QCustomPlot widget. To give the label closest to the border some freedom, increase padding.

The axis padding has no meaning if QCustomPlot::setAutoMargin is disabled.

See also

setLabelPadding, setTickLabelPadding

Definition at line 3802 of file qcustomplot.cc.

{
  mPadding = padding;
}

void QCPAxis::setRange ( double  lower, double  upper  )

slot

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Sets the lower and upper bound of the axis range.

There is also a slot to set a range, see setRange(const QCPRange &range).

Definition at line 3259 of file qcustomplot.cc.

{
  if (!QCPRange::validRange(lower, upper)) return;
  mRange.lower = lower;
  mRange.upper = upper;
  if (mScaleType == STLogarithmic)
  {
    mRange = mRange.sanitizedForLogScale();
  } else
  {
    mRange = mRange.sanitizedForLinScale();
  }
  emit rangeChanged(mRange);
}

void QCPAxis::setRange ( double  position, double  size, Qt::AlignmentFlag  alignment  )

slot

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Sets the range of the axis.

Parameters

position	the position coordinate indicates together with the alignment parameter, where the new range will be positioned.
size	defines the size (upper-lower) of the new axis range.
alignment	determines how position is to be interpreted. If alignment is Qt::AlignLeft, position will be the lower bound of the range. If alignment is Qt::AlignRight, position will be the upper bound of the range. If alignment is Qt::AlignCenter, the new range will be centered around position. Any other values for alignment will default to Qt::AlignCenter.

Definition at line 3287 of file qcustomplot.cc.

{
  if (alignment == Qt::AlignLeft)
    setRange(position, position+size);
  else if (alignment == Qt::AlignRight)
    setRange(position-size, position);
  else // alignment == Qt::AlignCenter
    setRange(position-size/2.0, position+size/2.0);
}

void QCPAxis::setRange ( const QCPRange &  range )

slot

Sets the range of the axis.

This slot may be connected with the rangeChanged signal of another axis in order for the ranges to be synchronized (in one direction).

To invert the direction of an axis range, use setRangeReversed.

Definition at line 3240 of file qcustomplot.cc.

{
  if (!QCPRange::validRange(range)) return;
  if (mScaleType == STLogarithmic)
  {
    mRange = range.sanitizedForLogScale();
  } else
  {
    mRange = range.sanitizedForLinScale();
  }
  emit rangeChanged(mRange);
}

void QCPAxis::setRangeLower ( double  lower )

slot

Sets the lower bound of the axis range, independently of the upper bound.

See also

setRange

Definition at line 3301 of file qcustomplot.cc.

{
  mRange.lower = lower;
  if (mScaleType == STLogarithmic)
  {
    mRange = mRange.sanitizedForLogScale();
  } else
  {
    mRange = mRange.sanitizedForLinScale();
  }
  emit rangeChanged(mRange);
}

void QCPAxis::setRangeReversed ( bool  reversed )

slot

Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When reversed is set to true, the direction of increasing values is inverted. Note that the range and data interface stays the same for reversed axes, e.g. the lower part of the setRange interface will still reference the mathematically smaller number than the upper part.

Definition at line 3338 of file qcustomplot.cc.

{
  mRangeReversed = reversed;
}

void QCPAxis::setRangeUpper ( double  upper )

slot

Sets the upper bound of the axis range, independently of the lower bound.

See also

setRange

Definition at line 3318 of file qcustomplot.cc.

{
  mRange.upper = upper;
  if (mScaleType == STLogarithmic)
  {
    mRange = mRange.sanitizedForLogScale();
  } else
  {
    mRange = mRange.sanitizedForLinScale();
  }
  emit rangeChanged(mRange);
}

void QCPAxis::setScaleLogBase ( double  base )

slot

If setScaleType is set to STLogarithmic, base will be the logarithm base of the scaling. In logarithmic axis scaling, major tick marks appear at all powers of base.

Properties like tick step (setTickStep) don't apply in logarithmic scaling. If you wish a decimal base but less major ticks, consider choosing base 100, 1000 or even higher.

Definition at line 3222 of file qcustomplot.cc.

{
  if (base > 1)
  {
    mScaleLogBase = base;
    mScaleLogBaseLogInv = 1.0/log(mScaleLogBase); // buffer for faster baseLog() calculation
  } else
    qDebug() << FUNCNAME << "Invalid logarithmic scale base (must be greater 1):" << base;
}

void QCPAxis::setScaleRatio ( const QCPAxis *  otherAxis, double  ratio = 1.0  )

slot

Sets the range of this axis to have a certain scale ratio to otherAxis. For example, if ratio is 1, this axis is the yAxis and otherAxis is xAxis, graphs plotted with those axes will appear in a 1:1 ratio, independent of the aspect ratio the axis rect has. This is an operation that changes the range of this axis once, it doesn't fix the scale ratio indefinitely. Consequently calling this function in the constructor won't have the desired effect, since the widget's dimensions aren't defined yet, and a resizeEvent will follow.

Definition at line 3866 of file qcustomplot.cc.

{
  int otherPixelSize, ownPixelSize;
  
  if (otherAxis->orientation() == Qt::Horizontal)
    otherPixelSize = otherAxis->mAxisRect.width();
  else
    otherPixelSize = otherAxis->mAxisRect.height();
  
  if (orientation() == Qt::Horizontal)
    ownPixelSize = mAxisRect.width();
  else
    ownPixelSize = mAxisRect.height();
  
  double newRangeSize = ratio*otherAxis->mRange.size()*ownPixelSize/(double)otherPixelSize;
  setRange(range().center(), newRangeSize, Qt::AlignCenter);
}

void QCPAxis::setScaleType ( ScaleType  type )

slot

Sets whether the axis uses a linear scale or a logarithmic scale. If type is set to STLogarithmic, the logarithm base can be set with setScaleLogBase. In logarithmic axis scaling, major tick marks appear at all powers of the logarithm base. Properties like tick step (setTickStep) don't apply in logarithmic scaling. If you wish a decimal base but less major ticks, consider choosing a logarithm base of 100, 1000 or even higher.

If type is STLogarithmic and the number format (setNumberFormat) uses the 'b' option (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10 [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]" part). To only display the decimal power, set the number precision to zero with setNumberPrecision.

Definition at line 3208 of file qcustomplot.cc.

{
  mScaleType = type;
  if (mScaleType == STLogarithmic)
    mRange = mRange.sanitizedForLogScale();
}

void QCPAxis::setSubGrid ( bool  show )

slot

Sets whether the sub grid lines are visible.

See also

setGrid, setSubGridPen

Definition at line 3366 of file qcustomplot.cc.

{
  mSubGrid = show;
}

void QCPAxis::setSubGridPen ( const QPen &  pen )

slot

Sets the pen, the sub grid lines are drawn with. (By default, subgrid drawing needs to be enabled first with setSubGrid.)

See also

setGridPen

Definition at line 3729 of file qcustomplot.cc.

{
  mSubGridPen = pen;
}

void QCPAxis::setSubTickCount ( int  count )

slot

Sets the number of sub ticks in one (major) tick step. A sub tick count of three for example, divides the tick intervals in four sub intervals.

By default, the number of sub ticks is chosen automatically in a reasonable manner as long as the mantissa of the tick step is a multiple of 0.5 (which it is, when setAutoTickStep is enabled). If you want to disable automatic sub ticks and use this function to set the count manually, see setAutoSubTicks.

Definition at line 3689 of file qcustomplot.cc.

{
  mSubTickCount = count;
}

void QCPAxis::setSubTickLength ( int  inside, int  outside = 0  )

slot

Sets the length of the subticks in pixels. inside is the length the subticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also

setTickLength

Definition at line 3701 of file qcustomplot.cc.

{
  mSubTickLengthIn = inside;
  mSubTickLengthOut = outside;
}

void QCPAxis::setSubTickPen ( const QPen &  pen )

slot

Sets the pen, subtick marks will be drawn with.

See also

setSubTickCount, setSubTickLength

Definition at line 3759 of file qcustomplot.cc.

{
  mSubTickPen = pen;
}

void QCPAxis::setTickLabelFont ( const QFont &  font )

slot

Sets the font of the tick labels, i.e. the numbers drawn next to tick marks.

Definition at line 3477 of file qcustomplot.cc.

{
  mTickLabelFont = font;
}

void QCPAxis::setTickLabelPadding ( int  padding )

slot

Sets the distance between the axis base line (or any tick marks pointing outward) and the tick labels.

See also

setLabelPadding, setPadding

Definition at line 3454 of file qcustomplot.cc.

{
  mTickLabelPadding = padding;
}

void QCPAxis::setTickLabelRotation ( double  degrees )

slot

Sets the rotation of the tick labels, i.e. the numbers drawn next to tick marks. If degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by degrees clockwise. The specified angle is bound to values from -90 to 90 degrees.

Definition at line 3487 of file qcustomplot.cc.

{
  mTickLabelRotation = qBound(-90.0, degrees, 90.0);
}

void QCPAxis::setTickLabels ( bool  show )

slot

Sets whether tick labels are displayed.

Definition at line 3445 of file qcustomplot.cc.

{
  mTickLabels = show;
}

void QCPAxis::setTickLabelType ( LabelType  type )

slot

Sets whether the tick labels display numbers or dates/times.
If type is set to LTNumber, the format specifications of setNumberFormat apply.
If type is set to LTDateTime, the format specifications of setDateTimeFormat apply.
In QCustomPlot, date/time coordinates are double numbers representing the seconds since 1970-01-01T00:00:00 UTC. This format can be retrieved from QDateTime objects with the QDateTime::toTime_t() function. Since this only gives a resolution of one second, there is also the QDateTime::toMSecsSinceEpoch() function which returns the timespan described above in milliseconds. Divide its return value by 1000.0 to get a value with the format needed for date/time plotting, this time with a resolution of one millisecond.

Definition at line 3469 of file qcustomplot.cc.

{
  mTickLabelType = type;
}

void QCPAxis::setTickLength ( int  inside, int  outside = 0  )

slot

Sets the length of the ticks in pixels. inside is the length the ticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also

setSubTickLength

Definition at line 3674 of file qcustomplot.cc.

{
  mTickLengthIn = inside;
  mTickLengthOut = outside;
}

void QCPAxis::setTickPen ( const QPen &  pen )

slot

Sets the pen, tick marks will be drawn with.

See also

setTickLength

Definition at line 3750 of file qcustomplot.cc.

{
  mTickPen = pen;
}

void QCPAxis::setTicks ( bool  show )

slot

Sets whether tick marks are displayed. Setting show to false does not imply, that tick labels are invisible, too. To achieve that, see setTickLabels.

Definition at line 3437 of file qcustomplot.cc.

{
  mTicks = show;
}

void QCPAxis::setTickStep ( double  step )

slot

If setAutoTickStep is set to false, use this function to set the tick step manually. The tick step is the interval between (major) ticks, in plot coordinates.

See also

setSubTickCount

Definition at line 3609 of file qcustomplot.cc.

{
  mTickStep = step;
}

void QCPAxis::setTickVector ( QVector< double > *  vec, bool  copy = false  )

slot

If you want full control over what ticks (and possibly labels) the axes show, this function is used to set the coordinates at which ticks will appear.setAutoTicks must be disabled, else the provided tick vector will be overwritten with automatically generated tick coordinates. The labels of the ticks can either be generated automatically when setAutoTickLabels is left enabled, or be set manually with setTickVectorLabels, when setAutoTickLabels is disabled.

Parameters

vec	a pointer to the vector containing the positions of the ticks
copy	if this is set to true, the provided vec is copied to the internal tick vector. In this case, QCPAxis does not take ownership of vec. If it's set to false, the internal tick vector is deleted and replaced by vec, QCPAxis takes ownership of the vector memory vec points to. The latter might give slight performance benefits.

See also

setTickVectorLabels

Definition at line 3628 of file qcustomplot.cc.

{
  if (copy)
  {
    *mTickVector = *vec;
  } else
  {
    delete mTickVector;
    mTickVector = vec;
  }
}

void QCPAxis::setTickVectorLabels ( QVector< QString > *  vec, bool  copy = false  )

slot

If you want full control over what ticks and labels the axes show, this function is used to set a number of QStrings that will be displayed at the tick positions which you need to provide with setTickVector. These two vectors should have the same size. (Note that you need to disable setAutoTicks and setAutoTickLabels first.)

Parameters

vec	a pointer to the vector containing the labels of the ticks
copy	if this is set to true, the provided vec is copied to the internal label vector. In this case QCPAxis does not take ownership of vec. If it's set to false, the internal label vector is deleted and replaced by vec, QCPAxis takes ownership of the vector memory vec points to. The latter might give slight performance benefits.

See also

setTickVector

Definition at line 3655 of file qcustomplot.cc.

{
  if (copy)
  {
    *mTickVectorLabels = *vec;
  } else
  {
    delete mTickVectorLabels;
    mTickVectorLabels = vec;
  }
}

void QCPAxis::setVisible ( bool  on )

slot

Sets whether the axis (including all its decoration, i.e. labels and grid lines) is visible. An invisible axis doesn't mean a non functional axis. Graphs attached to an invisible axis can still be plotted/moved/zoomed normally as if the axis was visible.

Definition at line 3348 of file qcustomplot.cc.

{
  mVisible = on;
}

void QCPAxis::setZeroLinePen ( const QPen &  pen )

slot

Sets the pen with which a single grid-like line will be drawn at value position zero. The line will be drawn instead of a grid line at that position, and not on top. To disable the drawing of a zero-line, set pen to Qt::NoPen. Then, if setGrid is enabled, a grid line will be drawn instead.

See also

setGrid, setGridPen

Definition at line 3741 of file qcustomplot.cc.

{
  mZeroLinePen = pen;
}

bool QCPAxis::subGrid ( ) const

inlineslot

Definition at line 750 of file qcustomplot.h.

{ return mSubGrid; }

QPen QCPAxis::subGridPen ( ) const

inlineslot

Definition at line 775 of file qcustomplot.h.

{ return mSubGridPen; }

int QCPAxis::subTickCount ( ) const

inlineslot

Definition at line 770 of file qcustomplot.h.

{ return mSubTickCount; }

int QCPAxis::subTickLengthIn ( ) const

inlineslot

Definition at line 771 of file qcustomplot.h.

{ return mSubTickLengthIn; }

int QCPAxis::subTickLengthOut ( ) const

inlineslot

Definition at line 772 of file qcustomplot.h.

{ return mSubTickLengthOut; }

QPen QCPAxis::subTickPen ( ) const

inlineslot

Definition at line 778 of file qcustomplot.h.

{ return mSubTickPen; }

QFont QCPAxis::tickLabelFont ( ) const

inlineslot

Definition at line 760 of file qcustomplot.h.

{ return mTickLabelFont; }

int QCPAxis::tickLabelPadding ( ) const

inlineslot

Definition at line 758 of file qcustomplot.h.

{ return mTickLabelPadding; }

double QCPAxis::tickLabelRotation ( ) const

inlineslot

Definition at line 761 of file qcustomplot.h.

{ return mTickLabelRotation; }

bool QCPAxis::tickLabels ( ) const

inlineslot

Definition at line 757 of file qcustomplot.h.

{ return mTickLabels; }

LabelType QCPAxis::tickLabelType ( ) const

inlineslot

Definition at line 759 of file qcustomplot.h.

{ return mTickLabelType; }

int QCPAxis::tickLengthIn ( ) const

inlineslot

Definition at line 768 of file qcustomplot.h.

{ return mTickLengthIn; }

int QCPAxis::tickLengthOut ( ) const

inlineslot

Definition at line 769 of file qcustomplot.h.

{ return mTickLengthOut; }

QPen QCPAxis::tickPen ( ) const

inlineslot

Definition at line 777 of file qcustomplot.h.

{ return mTickPen; }

bool QCPAxis::ticks ( ) const

inlineslot

Definition at line 756 of file qcustomplot.h.

{ return mTicks; }

void QCPAxis::ticksRequest ( )

signal

double QCPAxis::tickStep ( ) const

inlineslot

Definition at line 765 of file qcustomplot.h.

{ return mTickStep; }

QVector<double>* QCPAxis::tickVector ( ) const

inlineslot

Definition at line 766 of file qcustomplot.h.

{ return mTickVector; }

QVector<QString>* QCPAxis::tickVectorLabels ( ) const

inlineslot

Definition at line 767 of file qcustomplot.h.

{ return mTickVectorLabels; }

bool QCPAxis::visible ( ) const

inlineslot

Definition at line 748 of file qcustomplot.h.

{ return mVisible; }

void QCPAxis::visibleTickBounds ( int &  lowIndex, int &  highIndex  ) const

protected

Definition at line 4728 of file qcustomplot.cc.

{
  lowIndex = 0;
  highIndex = -1;
  // make sure only ticks that are in visible range are returned
  for (int i=0; i < mTickVector->size(); ++i)
  {
    lowIndex = i;
    if (mTickVector->at(i) >= mRange.lower) break;
  }
  for (int i=mTickVector->size()-1; i >= 0; --i)
  {
    highIndex = i;
    if (mTickVector->at(i) <= mRange.upper) break;
  }
}

QPen QCPAxis::zeroLinePen ( ) const

inlineslot

Definition at line 776 of file qcustomplot.h.

{ return mZeroLinePen; }

Friends And Related Function Documentation

friend class QCustomPlot

friend

Definition at line 892 of file qcustomplot.h.

Member Data Documentation

bool QCPAxis::mAutoSubTicks

protected

Definition at line 856 of file qcustomplot.h.

int QCPAxis::mAutoTickCount

protected

Definition at line 853 of file qcustomplot.h.

bool QCPAxis::mAutoTickLabels

protected

Definition at line 856 of file qcustomplot.h.

bool QCPAxis::mAutoTicks

protected

Definition at line 856 of file qcustomplot.h.

bool QCPAxis::mAutoTickStep

protected

Definition at line 856 of file qcustomplot.h.

QRect QCPAxis::mAxisRect

protected

Definition at line 844 of file qcustomplot.h.

AxisType QCPAxis::mAxisType

protected

Definition at line 849 of file qcustomplot.h.

QPen QCPAxis::mBasePen

protected

Definition at line 845 of file qcustomplot.h.

QString QCPAxis::mDateTimeFormat

protected

Definition at line 842 of file qcustomplot.h.

QChar QCPAxis::mExponentialChar

protected

Definition at line 862 of file qcustomplot.h.

bool QCPAxis::mGrid

protected

Definition at line 856 of file qcustomplot.h.

QPen QCPAxis::mGridPen

protected

Definition at line 845 of file qcustomplot.h.

QString QCPAxis::mLabel

protected

Definition at line 843 of file qcustomplot.h.

QFont QCPAxis::mLabelFont

protected

Definition at line 846 of file qcustomplot.h.

int QCPAxis::mLabelPadding

protected

Definition at line 854 of file qcustomplot.h.

bool QCPAxis::mNumberBeautifulPowers

protected

Definition at line 865 of file qcustomplot.h.

char QCPAxis::mNumberFormatChar

protected

Definition at line 864 of file qcustomplot.h.

bool QCPAxis::mNumberMultiplyCross

protected

Definition at line 865 of file qcustomplot.h.

int QCPAxis::mNumberPrecision

protected

Definition at line 863 of file qcustomplot.h.

Qt::Orientation QCPAxis::mOrientation

protected

Definition at line 866 of file qcustomplot.h.

int QCPAxis::mPadding

protected

Definition at line 854 of file qcustomplot.h.

QCustomPlot* QCPAxis::mParentPlot

protected

Definition at line 860 of file qcustomplot.h.

QChar QCPAxis::mPositiveSignChar

protected

Definition at line 862 of file qcustomplot.h.

QCPRange QCPAxis::mRange

protected

Definition at line 841 of file qcustomplot.h.

bool QCPAxis::mRangeReversed

protected

Definition at line 857 of file qcustomplot.h.

double QCPAxis::mScaleLogBase

protected

Definition at line 851 of file qcustomplot.h.

double QCPAxis::mScaleLogBaseLogInv

protected

Definition at line 851 of file qcustomplot.h.

ScaleType QCPAxis::mScaleType

protected

Definition at line 848 of file qcustomplot.h.

bool QCPAxis::mSubGrid

protected

Definition at line 856 of file qcustomplot.h.

QPen QCPAxis::mSubGridPen

protected

Definition at line 845 of file qcustomplot.h.

int QCPAxis::mSubTickCount

protected

Definition at line 852 of file qcustomplot.h.

int QCPAxis::mSubTickLengthIn

protected

Definition at line 852 of file qcustomplot.h.

int QCPAxis::mSubTickLengthOut

protected

Definition at line 852 of file qcustomplot.h.

QPen QCPAxis::mSubTickPen

protected

Definition at line 845 of file qcustomplot.h.

QVector<double>* QCPAxis::mSubTickVector

protected

Definition at line 861 of file qcustomplot.h.

QFont QCPAxis::mTickLabelFont

protected

Definition at line 846 of file qcustomplot.h.

int QCPAxis::mTickLabelPadding

protected

Definition at line 854 of file qcustomplot.h.

double QCPAxis::mTickLabelRotation

protected

Definition at line 855 of file qcustomplot.h.

bool QCPAxis::mTickLabels

protected

Definition at line 856 of file qcustomplot.h.

LabelType QCPAxis::mTickLabelType

protected

Definition at line 847 of file qcustomplot.h.

int QCPAxis::mTickLengthIn

protected

Definition at line 852 of file qcustomplot.h.

int QCPAxis::mTickLengthOut

protected

Definition at line 852 of file qcustomplot.h.

QPen QCPAxis::mTickPen

protected

Definition at line 845 of file qcustomplot.h.

bool QCPAxis::mTicks

protected

Definition at line 856 of file qcustomplot.h.

double QCPAxis::mTickStep

protected

Definition at line 850 of file qcustomplot.h.

QVector<double>* QCPAxis::mTickVector

protected

Definition at line 839 of file qcustomplot.h.

QVector<QString>* QCPAxis::mTickVectorLabels

protected

Definition at line 840 of file qcustomplot.h.

bool QCPAxis::mVisible

protected

Definition at line 856 of file qcustomplot.h.

QPen QCPAxis::mZeroLinePen

protected

Definition at line 845 of file qcustomplot.h.

---

The documentation for this class was generated from the following files:

• /build/rock-master-18.09-gui-rock-widget-collection-0.20180124/src/plot2d/qcustomplot.h
• /build/rock-master-18.09-gui-rock-widget-collection-0.20180124/src/plot2d/qcustomplot.cc