Kwave::ScaleWidget Class Reference

#include <ScaleWidget.h>

Inheritance diagram for Kwave::ScaleWidget:

Collaboration diagram for Kwave::ScaleWidget:

Public Member Functions
	ScaleWidget (QWidget *parent)
	ScaleWidget (QWidget *parent, int low, int high, const QString &unit)
virtual	~ScaleWidget () Q_DECL_OVERRIDE
void	setMinMax (int min, int max)
void	setUnit (const QString &text)
void	setLogMode (bool log)
virtual QSize	minimumSize () const
virtual QSize	sizeHint () const Q_DECL_OVERRIDE

Protected Member Functions
virtual void	paintEvent (QPaintEvent *) Q_DECL_OVERRIDE
void	drawLinear (QPainter &p, int w, int h, bool inverse)
void	drawLog (QPainter &p, int w, int h, bool inverse)
void	paintText (QPainter &p, int x, int y, bool reverse, const QString &text)

Private Attributes
int	m_low
int	m_high
bool	m_logmode
QString	m_unittext

Detailed Description

Definition at line 33 of file ScaleWidget.h.

Constructor & Destructor Documentation

ScaleWidget() [1/2]

Kwave::ScaleWidget::ScaleWidget ( QWidget *  parent )

explicit

Primitve constructor for usage in a Qt designer's dialog

Parameters

parent

the widget's parent widget

Definition at line 37 of file ScaleWidget.cpp.

    :QWidget(parent), m_low(0), m_high(100), m_logmode(false),
     m_unittext(_("%"))
{
}

ScaleWidget() [2/2]

Kwave::ScaleWidget::ScaleWidget	(	QWidget *	parent,
		int	low,
		int	high,
		const QString &	unit
	)

Constructor with initialization.

Parameters

parent	the widget's parent widget
low	left/lower border value
high	right/upper border value
unit	text of the units to show

Definition at line 44 of file ScaleWidget.cpp.

    :QWidget(parent), m_low(low), m_high(high), m_logmode(false),
     m_unittext(unit)
{
}

~ScaleWidget()

Kwave::ScaleWidget::~ScaleWidget ( )

virtual

Destructor

Definition at line 52 of file ScaleWidget.cpp.

{
}

Member Function Documentation

drawLinear()

void Kwave::ScaleWidget::drawLinear ( QPainter &  p, int  w, int  h, bool  inverse  )

protected

Draws a linear scale

Parameters

p	reference to the painter
w	width of the drawing area in pixels
h	height of the drawing area in pixels
inverse	of true, the coordinate system is rotated to be upside-down and the scale has to be drawn mirrored in x and y axis.

Definition at line 164 of file ScaleWidget.cpp.

References _, FONTSIZE, m_high, m_low, m_unittext, paintText(), and Kwave::toInt().

Referenced by paintEvent().

{
    int dir = (inverse) ? -1 : +1;

    p.setPen(palette().dark().color());
    p.drawLine(0, dir * (h - 1), dir * w, dir * (h - 1));
    p.drawLine(dir * (w - 1), 0, dir * (w - 1), dir * (h - 1));

    p.setPen(palette().text().color());

    int a, x;
    double ofs;
    double t = w - 1;
    int h2 = h;

    // print the lines
    while ((t / 10 > 1) && (h2 > 0)) {
        for (ofs = 0; ofs < w - 1; ofs += t) {
            for (a = 0; a < 4; ++a) {
                x = Kwave::toInt(ofs + (t * a / 4));
                p.drawLine (dir * x, dir * 1, dir * x, dir * (h2 - 2));
            }
        }
        h2 >>= 1;
        t /= 4;
    }

    // print the text
    for (a = 0; a < 4; ++a) {
        QString buf = _("%1 %2");
        int value = m_low + (((m_high - m_low)* (inverse ? (4 - a) : a)) / 4);
        buf = buf.arg(value).arg(m_unittext);
        x = ((w - 1) * a) / 4;
        paintText(p, dir * (x + 4), dir * (h - FONTSIZE - 4), inverse, buf);
    }

}

Here is the call graph for this function:

Here is the caller graph for this function:

drawLog()

void Kwave::ScaleWidget::drawLog ( QPainter &  p, int  w, int  h, bool  inverse  )

protected

Todo:

implementation of logarithmic scale

Definition at line 107 of file ScaleWidget.cpp.

References _, FONTSIZE, m_high, m_low, m_unittext, paintText(), and Kwave::toInt().

Referenced by paintEvent().

{
    // only use base 10 for now, tested with others too,
    // but not configurable through a property
    const int base = 10;

    int dir = (inverse) ? -1 : +1;

    p.setPen(palette().dark().color());
    p.drawLine (0, dir*(h-1), dir*w, dir*(h-1));
    p.drawLine (dir*(w-1), 0, dir*(w-1), dir*(h-1));

    p.setPen(palette().text().color());

    int a, x;
    const int h2 = h;

    Q_ASSERT(m_low >= 0);
    Q_ASSERT(m_high > m_low);

    int dec_lo = (m_low) ? Kwave::toInt(floor(log(m_low)/log(base))) : 0;
    int dec_hi = Kwave::toInt(ceil(log(m_high)/log(base)));
    int decades = qAbs(dec_hi - dec_lo) + 1;

    // check if we have enough space for the small lines within a decade
    int w1 = Kwave::toInt(w / decades); // pixels per decade
    bool small_lines = (w1 - Kwave::toInt(
        static_cast<double>(w1) * log(base-1)/log(base))) > 1;

    // print the lines
    for (a = 0; a < decades; ++a) {
        // big line, for each decade
        x = Kwave::toInt((w-1) * a / decades);
        p.drawLine (dir * x, dir * 1, dir * x, dir * (h2 - 2));

        w1 = Kwave::toInt((w - 1) * (a + 1) / decades) - x + 1;
        if (small_lines) {
            // small lines, within the decade
            for (int i = 1; i < base; i++) {
                int x1 = x + Kwave::toInt(static_cast<double>(w1) *
                    log(i) / log(base));
                p.drawLine (dir * x1, dir * 1, dir * x1, dir * ((h2 / 2) - 2));
            }
        }
    }

    // print the text
    for (a = 0; a < decades; ++a) {
        QString buf = _("%1 %2");
        int value = Kwave::toInt(pow(base, dec_lo + a));
        buf = buf.arg(value).arg(m_unittext);
        x = ((w - 1) * a) / decades;
        paintText(p, dir * (x + 4), dir * (h - FONTSIZE - 4), inverse, buf);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

minimumSize()

QSize Kwave::ScaleWidget::minimumSize ( ) const

virtual

minimum size of the widtget,

See also

QWidget::minimumSize()

Definition at line 237 of file ScaleWidget.cpp.

References FONTSIZE.

{
    return QSize(5 * 2 * FONTSIZE, 5 * 2 * FONTSIZE);
}

paintEvent()

void Kwave::ScaleWidget::paintEvent ( QPaintEvent *  )

protectedvirtual

Draws the widget.

See also

QWidget::paintEvent

Definition at line 203 of file ScaleWidget.cpp.

References drawLinear(), drawLog(), and m_logmode.

{
    bool inverse = false;
    int h = height();
    int w = width();
    QPainter p;

    p.begin(this);
    p.save();
    p.setPen(palette().light().color());

    p.drawLine(0, 0, w, 0);
    if (h > w) {
        p.setWindow(-w, 0, w, h);
        p.rotate(-90);
        h = width();
        w = height();

        inverse = true;
    }

    (m_logmode) ? drawLog(p, w, h, inverse) : drawLinear(p, w, h, inverse);

    p.restore();
    p.end();
}

Here is the call graph for this function:

paintText()

void Kwave::ScaleWidget::paintText ( QPainter &  p, int  x, int  y, bool  reverse, const QString &  text  )

protected

Painting routine for own small font with fixed size There are Problems with smaller displays using QFont, sizes are not correct.

Parameters

p	reference to the painter
x	coordinate of the left edge of the first character
y	coordinate of the lower edge of the first character
reverse	if true, print reverse: x is right edge of the text, like "align right".
text	the text to be printed. Must only contain known characters that are present in the font bitmap, like numbers, letters and some special chars like "%", space, dot and comma.

Definition at line 81 of file ScaleWidget.cpp.

References FONTSIZE, and rect().

Referenced by drawLinear(), and drawLog().

{
    QFont font;
    font.setStyleHint(QFont::SansSerif);
    font.setFixedPitch(true);
    font.setPixelSize(FONTSIZE);
    font.setWeight(0);
    font.setStyle(QFont::StyleNormal);
    p.setFont(font);
    QFontMetrics fm(font);

    if (reverse) {
        x += FONTSIZE + 2;
        y -= FONTSIZE + 2;
    }

    QRect rect = fm.boundingRect(text);
    const int th = rect.height();
    const int tw = rect.width();
    p.drawText(x, y, tw, th,
        ((reverse) ? Qt::AlignLeft : Qt::AlignRight) | Qt::AlignBottom,
        text);
}

Here is the call graph for this function:

Here is the caller graph for this function:

setLogMode()

void Kwave::ScaleWidget::setLogMode

(

bool

log

)

Sets logarithmic or linear mode.

Parameters

log	if true, set logarithmic mode, if not select linear mode

Definition at line 64 of file ScaleWidget.cpp.

References m_logmode.

{
    if (m_logmode == log) return;
    m_logmode = log;
    repaint();
}

setMinMax()

void Kwave::ScaleWidget::setMinMax	(	int	min,
		int	max
	)

Sets the border values.

Parameters

min	left/lower border value
max	right/upper border value

Definition at line 72 of file ScaleWidget.cpp.

References m_high, and m_low.

Referenced by Kwave::SonagramWindow::updateScaleWidgets().

{
    if ((m_low == min) && (m_high == max)) return;
    m_low  = min;
    m_high = max;
    repaint();
}

Here is the caller graph for this function:

setUnit()

void Kwave::ScaleWidget::setUnit

(

const QString &

text

)

Set the text of the units.

Parameters

text	the units to show

Definition at line 57 of file ScaleWidget.cpp.

References m_unittext.

{
    m_unittext = text;
    repaint();
}

sizeHint()

QSize Kwave::ScaleWidget::sizeHint ( ) const

virtual

optimal size for the widget,

See also

QWidget::sizeHint()

Definition at line 231 of file ScaleWidget.cpp.

References FONTSIZE.

Referenced by Kwave::SonagramWindow::SonagramWindow().

{
    return QSize(4 * FONTSIZE, 4 * FONTSIZE);
}

Here is the caller graph for this function:

Member Data Documentation

m_high

int Kwave::ScaleWidget::m_high

private

Upper boundary value

Definition at line 128 of file ScaleWidget.h.

Referenced by drawLinear(), drawLog(), and setMinMax().

m_logmode

bool Kwave::ScaleWidget::m_logmode

private

If true, logarithmic mode, linear mode if false

Definition at line 131 of file ScaleWidget.h.

Referenced by paintEvent(), and setLogMode().

m_low

int Kwave::ScaleWidget::m_low

private

Lower boundary value

Definition at line 125 of file ScaleWidget.h.

Referenced by drawLinear(), drawLog(), and setMinMax().

m_unittext

QString Kwave::ScaleWidget::m_unittext

private

String containing the name of the unit

Definition at line 134 of file ScaleWidget.h.

Referenced by drawLinear(), drawLog(), and setUnit().

---

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

• libgui/ScaleWidget.h
• libgui/ScaleWidget.cpp