Kwave::CurveWidget Class Reference

#include <CurveWidget.h>

Inheritance diagram for Kwave::CurveWidget:

Collaboration diagram for Kwave::CurveWidget:

Public Slots
void	selectInterpolationType (QAction *action)
void	scaleFit ()
void	VFlip ()
void	HFlip ()
void	deleteLast ()
void	deleteSecond ()
void	firstHalf ()
void	secondHalf ()
void	savePreset ()
void	loadPreset (QAction *action)

Public Member Functions
	CurveWidget (QWidget *parent)
virtual	~CurveWidget () Q_DECL_OVERRIDE
QString	getCommand ()
void	setCurve (const QString &command)
void	addPoint (double x, double y)
Kwave::Curve::Point	findPoint (int sx, int sy)

Protected Slots
virtual void	mousePressEvent (QMouseEvent *) Q_DECL_OVERRIDE
virtual void	mouseReleaseEvent (QMouseEvent *) Q_DECL_OVERRIDE
virtual void	mouseMoveEvent (QMouseEvent *) Q_DECL_OVERRIDE
virtual void	paintEvent (QPaintEvent *) Q_DECL_OVERRIDE

Protected Member Functions
void	loadPresetList ()

Private Attributes
int	m_width
int	m_height
Kwave::Curve	m_curve
QMenu *	m_menu
QMenu *	m_preset_menu
Kwave::Curve::Point	m_current
Kwave::Curve::Point	m_last
bool	m_down
QPixmap	m_knob
QPixmap	m_selected_knob

Detailed Description

Definition at line 37 of file CurveWidget.h.

Constructor & Destructor Documentation

CurveWidget()

Kwave::CurveWidget::CurveWidget ( QWidget *  parent )

explicit

Constructor

Definition at line 55 of file CurveWidget.cpp.

References _, Kwave::connect(), deleteLast(), deleteSecond(), Kwave::Interpolation::descriptions(), firstHalf(), Kwave::Curve::fromCommand(), HFlip(), loadPreset(), loadPresetList(), m_curve, m_knob, m_menu, m_preset_menu, m_selected_knob, savePreset(), scaleFit(), secondHalf(), selectInterpolationType(), and VFlip().

    :QWidget(parent), m_width(0), m_height(0), m_curve(), m_menu(Q_NULLPTR),
     m_preset_menu(Q_NULLPTR), m_current(Kwave::Curve::NoPoint),
     m_last(Kwave::Curve::NoPoint),
     m_down(false), m_knob(), m_selected_knob()
{
    KIconLoader *icon_loader = KIconLoader::global();

    // set the default curve
    m_curve.fromCommand(_("curve(linear,0,0,1,1)"));

    QPalette pal = palette();
    pal.setColor(QPalette::Window, Qt::black);
    setPalette(pal);

    // create the pixmaps for the selected and non-selected knob
    if (icon_loader) {
        m_knob = icon_loader->loadIcon(_("knob.xpm"), KIconLoader::Small);
        m_selected_knob = icon_loader->loadIcon(_("selectedknob.xpm"),
                                                KIconLoader::Small);
    }

    // set up the context menu for the right mouse button
    m_menu = new QMenu(this);
    Q_ASSERT(m_menu);
    if (!m_menu) return;

    QMenu *interpolation = m_menu->addMenu(i18n("Interpolation"));
    Q_ASSERT(interpolation);
    if (!interpolation) return;

    m_menu->addSeparator();
    QMenu *transform = m_menu->addMenu(i18n("Transform"));
    Q_ASSERT(transform);
    if (!transform) return;
    transform->addAction(i18n("Flip horizontal"),
                         this, SLOT(HFlip()));
    transform->addAction(i18n("Flip vertical"),
                         this, SLOT(VFlip()));
    transform->addSeparator();
    transform->addAction(i18n("Into first half"),
                         this, SLOT(firstHalf()));
    transform->addAction(i18n("Into second half"),
                         this, SLOT(secondHalf()));

    QMenu *del = m_menu->addMenu(i18n("Delete"));
    Q_ASSERT(del);
    if (!del) return;

    m_menu->addAction(i18n("Fit In"), this, SLOT(scaleFit()));
    m_menu->addSeparator();

    /* list of presets */
    m_preset_menu = m_menu->addMenu(i18n("Presets"));
    Q_ASSERT(m_preset_menu);
    if (!m_preset_menu) return;
    loadPresetList();
    connect(m_preset_menu, SIGNAL(triggered(QAction*)),
            this, SLOT(loadPreset(QAction*)));

    m_menu->addAction(
        QIcon::fromTheme(_("document-export")),
        i18n("Save Preset"),
        this, SLOT(savePreset()));

    del->addAction(
        QIcon::fromTheme(_("edit-delete")),
        i18n("Currently Selected Point"),
        this, SLOT(deleteLast()),
        QKeySequence::Delete);
    del->addAction(i18n("Every Second Point"),
                   this, SLOT(deleteSecond()));

    QStringList types = Kwave::Interpolation::descriptions(true);
    int id = 0;
    foreach (const QString &text, types) {
        QAction *action = new QAction(interpolation);
        action->setText(text);
        action->setData(id++);
        interpolation->addAction(action);
    }
    connect(interpolation, SIGNAL(triggered(QAction*)),
            this,          SLOT(selectInterpolationType(QAction*)));

    setMouseTracking(true);

    QShortcut *delkey = new QShortcut(this);
    Q_ASSERT(delkey);
    if (!delkey) return;
    delkey->setKey(Qt::Key_Delete);
    connect(delkey, SIGNAL(activated()), this, SLOT (deleteLast()));

}

Here is the call graph for this function:

~CurveWidget()

Kwave::CurveWidget::~CurveWidget ( )

virtual

Destructor

Definition at line 150 of file CurveWidget.cpp.

References m_menu.

{
    if (m_menu) delete m_menu;
}

Member Function Documentation

addPoint()

void Kwave::CurveWidget::addPoint	(	double	x,
		double	y
	)

Adds a new point to the curve.

Parameters

x	the point's x coordinate, should be [0.0...1.0]
y	the point's y coordinate, should be [0.0...1.0]

Definition at line 341 of file CurveWidget.cpp.

References Kwave::Curve::insert(), m_curve, m_last, and Kwave::Curve::NoPoint.

Referenced by mousePressEvent().

{
    m_curve.insert(newx, newy);
    m_last = Kwave::Curve::NoPoint;
    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

deleteLast

void Kwave::CurveWidget::deleteLast ( )

slot

Deletes the last point of the curve.

Definition at line 310 of file CurveWidget.cpp.

References Kwave::Curve::deletePoint(), m_curve, m_last, and Kwave::Curve::NoPoint.

Referenced by CurveWidget().

{
    if (m_last != Kwave::Curve::NoPoint) {
        m_curve.deletePoint(m_last, true);
        m_last = Kwave::Curve::NoPoint;
        repaint();
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

deleteSecond

void Kwave::CurveWidget::deleteSecond ( )

slot

Deletes the every second (even) point of the curve.

Definition at line 302 of file CurveWidget.cpp.

References Kwave::Curve::deleteSecondPoint(), m_curve, m_last, and Kwave::Curve::NoPoint.

Referenced by CurveWidget().

{
    m_curve.deleteSecondPoint();
    m_last = Kwave::Curve::NoPoint;
    repaint ();
}

Here is the call graph for this function:

Here is the caller graph for this function:

findPoint()

Kwave::Curve::Point Kwave::CurveWidget::findPoint	(	int	sx,
		int	sy
	)

Tries to find a point that is nearest to the given widget coordinates and within a tolerance.

Parameters

sx	screen x coordinate, left is 0
sy	screen y coordinate, top is 0

Returns

the point of the curve or Curve::NoPoint if nothing found

Definition at line 349 of file CurveWidget.cpp.

References Kwave::Curve::findPoint(), m_curve, m_height, m_width, and Kwave::Curve::NoPoint.

Referenced by mouseMoveEvent(), and mousePressEvent().

{
    Q_ASSERT(m_width > 1);
    Q_ASSERT(m_height > 1);
    if ((m_width <= 1) || (m_height <= 1)) return Kwave::Curve::NoPoint;

    return m_curve.findPoint((static_cast<double>(sx)) / (m_width - 1),
        (static_cast<double>(m_height) - sy) / (m_height - 1));
}

Here is the call graph for this function:

Here is the caller graph for this function:

firstHalf

void Kwave::CurveWidget::firstHalf ( )

slot

Scales the x coordinates of all points to 50% so that the curve's points move into the first half of the curve. A new "last" point with the y value of the previous last point will be inserted at x coordinate 1.0.

Definition at line 294 of file CurveWidget.cpp.

References Kwave::Curve::firstHalf(), m_curve, m_last, and Kwave::Curve::NoPoint.

Referenced by CurveWidget().

{
    m_curve.firstHalf ();
    m_last = Kwave::Curve::NoPoint;
    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

getCommand()

QString Kwave::CurveWidget::getCommand

(

)

Returns a command string for the curve.

Definition at line 156 of file CurveWidget.cpp.

References Kwave::Curve::getCommand(), and m_curve.

{
    return m_curve.getCommand();
}

Here is the call graph for this function:

HFlip

void Kwave::CurveWidget::HFlip ( )

slot

Mirrors the curve on the y axis

Definition at line 320 of file CurveWidget.cpp.

References Kwave::Curve::HFlip(), and m_curve.

Referenced by CurveWidget().

{
    m_curve.HFlip();
    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

loadPreset

void Kwave::CurveWidget::loadPreset ( QAction *  action )

slot

Loads an existing preset.

Parameters

action

the menu actio of the corresponding menu entry

Definition at line 256 of file CurveWidget.cpp.

References DBG, Kwave::Curve::fromCommand(), m_current, m_curve, m_last, m_preset_menu, and Kwave::Curve::NoPoint.

Referenced by CurveWidget().

{
    Q_ASSERT(m_preset_menu);
    Q_ASSERT(action);
    if (!m_preset_menu || !action) return;
    if (!action->data().isValid()) return;

    // invalidate the current selection
    m_current = Kwave::Curve::NoPoint;
    m_last    = Kwave::Curve::NoPoint;

    // get the path of the file and check whether it (still) exists
    QString filename = action->data().toString();
    QFileInfo fi(filename);
    if (!fi.exists(filename)) return;

    // load the file
    QFile file(filename);
    if (!file.open(QIODevice::ReadOnly)) {
        qWarning("CurveWidget::loadPreset('%s') - FAILED", DBG(filename));
        return;
    }
    QTextStream stream(&file);
    m_curve.fromCommand(stream.readLine());
    file.close();

    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

loadPresetList()

void Kwave::CurveWidget::loadPresetList ( )

protected

(Re-)Loads the list of preset files and fills the popup menu with all preset files.

Definition at line 226 of file CurveWidget.cpp.

References _, m_preset_menu, and name.

Referenced by CurveWidget(), and savePreset().

{
    const QChar s = QDir::separator();
    QString presetSubDir = s + _("kwave") + s + _("presets") + s + _("curves");
    QStringList files;
    QStringList presetPaths = QStandardPaths::standardLocations(
        QStandardPaths::GenericDataLocation);
    foreach (const QString &path, presetPaths) {
        QDir d(path + presetSubDir);
        QStringList f = d.entryList(QDir::Files, QDir::Name);
        foreach (const QString &file, f) {
            QString preset = d.path() + s + file;
            if (!files.contains(preset)) files.append(preset);
        }
    }
    files.sort();

    m_preset_menu->clear();
    foreach (const QString &file, files) {
        QFileInfo fi(file);
        QString name = fi.baseName();
        QAction *action = new (std::nothrow) QAction(name, m_preset_menu);
        Q_ASSERT(action);
        if (!action) continue;
        action->setData(file);
        m_preset_menu->addAction(action);
    }
}

Here is the caller graph for this function:

mouseMoveEvent

void Kwave::CurveWidget::mouseMoveEvent ( QMouseEvent *  e )

protectedvirtualslot

Definition at line 397 of file CurveWidget.cpp.

References Kwave::Curve::deletePoint(), findPoint(), Kwave::Curve::findPoint(), Kwave::Curve::insert(), m_current, m_curve, m_height, m_width, and Kwave::Curve::NoPoint.

{
    Q_ASSERT(e);
    Q_ASSERT(m_width > 1);
    Q_ASSERT(m_height > 1);
    if (!e || (m_width <= 1) || (m_height <= 1)) return;

    int x = e->pos().x();
    int y = e->pos().y();

    // if a point is selected...
    if (m_current != Kwave::Curve::NoPoint) {
        if (m_current == m_curve.first()) x = 0;
        if (m_current == m_curve.last())  x = m_width - 1;

        m_curve.deletePoint(m_current, false);

        m_current.setX(static_cast<double>(x) / (m_width - 1));
        m_current.setY(static_cast<double>(m_height - y) / (m_height - 1));

        if (m_current.x() < 0.0) m_current.setX(0.0);
        if (m_current.y() < 0.0) m_current.setY(0.0);
        if (m_current.x() > 1.0) m_current.setX(1.0);
        if (m_current.y() > 1.0) m_current.setY(1.0);

        double dx = (1.0 / static_cast<double>(m_width - 1));
        do {
            Kwave::Curve::Point nearest = m_curve.findPoint(
                m_current.x(), m_current.y(), 1.0);
            if (qFuzzyCompare(nearest.x(), m_current.x())) {
                if (nearest == m_curve.last())
                    m_current.setX(m_current.x() - dx);
                else
                    m_current.setX(m_current.x() + dx);
            }
            else
                break;
        } while (true);

        m_curve.insert(m_current.x(), m_current.y());

        repaint ();
    } else {
        if (findPoint(x, y) != Kwave::Curve::NoPoint)
            setCursor(Qt::SizeAllCursor);
        else
            setCursor(Qt::ArrowCursor);
    }
}

Here is the call graph for this function:

mousePressEvent

void Kwave::CurveWidget::mousePressEvent ( QMouseEvent *  e )

protectedvirtualslot

Definition at line 361 of file CurveWidget.cpp.

References addPoint(), findPoint(), m_current, m_down, m_height, m_menu, m_width, and Kwave::Curve::NoPoint.

{
    Q_ASSERT(e);
    Q_ASSERT(m_width > 1);
    Q_ASSERT(m_height > 1);
    if (!e || (m_width <= 1) || (m_height <= 1)) return;

    if (e->buttons() == Qt::RightButton) {
        // right mouse button -> context menu
        QPoint popup = QCursor::pos();
        if (m_menu) m_menu->popup(popup);
    } else if (e->buttons() == Qt::LeftButton) {
        // left mouse button -> select existing or create new point
        m_down = true;
        m_current = findPoint(e->pos().x(), e->pos().y());
        if (m_current == Kwave::Curve::NoPoint) {
            // no matching point is found -> generate a new one !
            addPoint(static_cast<double>(e->pos().x()) / (m_width - 1),
                     static_cast<double>(m_height - e->pos().y()) /
                     (m_height - 1));
            m_current = findPoint(e->pos().x(), e->pos().y());
        }
        repaint();
    }
}

Here is the call graph for this function:

mouseReleaseEvent

void Kwave::CurveWidget::mouseReleaseEvent ( QMouseEvent *  )

protectedvirtualslot

Definition at line 388 of file CurveWidget.cpp.

References m_current, m_down, m_last, and Kwave::Curve::NoPoint.

{
    m_last = m_current;
    m_current = Kwave::Curve::NoPoint;
    m_down = false;
    repaint();
}

paintEvent

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

protectedvirtualslot

Definition at line 448 of file CurveWidget.cpp.

References Kwave::Curve::interpolation(), m_current, m_curve, m_down, m_height, m_knob, m_last, m_selected_knob, m_width, rect(), and Kwave::toInt().

{
//    qDebug("CurveWidget::paintEvent (QPaintEvent *)");
    QPainter p;
    int ly;

    m_height = rect().height();
    m_width  = rect().width();

    if (!m_curve.count()) return; // nothing to draw

    const int kw = m_knob.width();
    const int kh = m_knob.height();

    QVector<double> y = m_curve.interpolation(m_width);
    Q_ASSERT(Kwave::toInt(y.count()) == m_width);
    if (Kwave::toInt(y.count()) < m_width) {
        qWarning("CurveWidget: unable to get interpolation !");
        return;
    }

    p.begin(this);
    p.fillRect(rect(), QBrush(palette().dark()));
    p.setPen(palette().text().color());

    // draw the lines
    ly = (m_height-1) - Kwave::toInt(y[0] * (m_height - 1));
    for (int i = 1; i < m_width; i++) {
        int ay = (m_height-1) - Kwave::toInt(y[i] * (m_height - 1));
        p.drawLine (i - 1, ly, i, ay);
        ly = ay;
    }

    // draw the points (knobs)
    foreach (const Kwave::Curve::Point &pt, m_curve) {
        int lx = Kwave::toInt(pt.x() * (m_width - 1));
        ly = (m_height - 1) - Kwave::toInt(pt.y() * (m_height - 1));

        if ((pt == m_current) || (!m_down && (pt == m_last)) )
            p.drawPixmap(lx - (kw >> 1), ly - (kh >> 1), m_selected_knob);
        else
            p.drawPixmap(lx - (kw >> 1), ly - (kh >> 1), m_knob);
    }
    p.end();

}

Here is the call graph for this function:

savePreset

void Kwave::CurveWidget::savePreset ( )

slot

Definition at line 182 of file CurveWidget.cpp.

References _, DBG, Kwave::Curve::getCommand(), Kwave::Logger::Info, loadPresetList(), Kwave::Logger::log(), m_curve, name, and Kwave::FileDialog::SaveFile.

Referenced by CurveWidget().

{
    QString presetSubDir = _("presets") + QDir::separator() + _("curves");
    QString presetPath = QStandardPaths::writableLocation(
        QStandardPaths::AppDataLocation) +
        QDir::separator() + presetSubDir;
    if (!QDir(presetPath).exists()) {
        Kwave::Logger::log(this, Logger::Info,
            _("curve preset directory did not exist, creating '%1'").arg(
            presetPath));
        QDir(presetPath).mkpath(presetPath);
    }

    QPointer<Kwave::FileDialog> dlg = new (std::nothrow) Kwave::FileDialog(
        presetPath, Kwave::FileDialog::SaveFile,
        _("*.curve *.CURVE|") +
        i18nc("Filter description for Kwave curve presets, "
              "for use in a FileDialog",
              "Kwave curve preset (*.curve)"),
         this, QUrl(), _("*.curve"));
    if (!dlg) return;
    dlg->setWindowTitle(i18n("Save Curve Preset"));
    if (dlg->exec() != QDialog::Accepted) {
        delete dlg;
        return;
    }

    QString name = dlg->selectedUrl().toLocalFile();
    delete dlg;

    // append the extension if not given
    if (!name.endsWith(_(".curve")))
        name.append(_(".curve"));

    QFile out(name);
    out.open(QIODevice::WriteOnly);
    QString cmd = m_curve.getCommand();
    out.write(DBG(cmd), cmd.length());

    // reload the list of known presets
    loadPresetList();
}

Here is the call graph for this function:

Here is the caller graph for this function:

scaleFit

void Kwave::CurveWidget::scaleFit ( )

slot

Scales the size of the curve so that all interpolated points are between 0.0 and 1.0 in x and y direction.

Definition at line 334 of file CurveWidget.cpp.

References m_curve, and Kwave::Curve::scaleFit().

Referenced by CurveWidget().

{
    m_curve.scaleFit();
    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

secondHalf

void Kwave::CurveWidget::secondHalf ( )

slot

Like firstHalf(), but moves points to the right half.

Definition at line 286 of file CurveWidget.cpp.

References m_curve, m_last, Kwave::Curve::NoPoint, and Kwave::Curve::secondHalf().

Referenced by CurveWidget().

{
    m_curve.secondHalf ();
    m_last = Kwave::Curve::NoPoint;
    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

selectInterpolationType

void Kwave::CurveWidget::selectInterpolationType ( QAction *  action )

slot

Selects a new interpolation type by it's numeric index. Used from the mouse context menu.

Definition at line 169 of file CurveWidget.cpp.

References Kwave::Interpolation::findByIndex(), m_curve, and Kwave::Curve::setInterpolationType().

Referenced by CurveWidget().

{
    if (!action) return;

    QVariant data = action->data();
    int index = data.toInt();

    m_curve.setInterpolationType(Kwave::Interpolation::findByIndex(index));

    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

setCurve()

void Kwave::CurveWidget::setCurve

(

const QString &

command

)

Sets the curve parameters/points from a command string.

Definition at line 162 of file CurveWidget.cpp.

References Kwave::Curve::fromCommand(), and m_curve.

{
    m_curve.fromCommand(command);
    repaint();
}

Here is the call graph for this function:

VFlip

void Kwave::CurveWidget::VFlip ( )

slot

Mirrors the curve on the y axis

Definition at line 327 of file CurveWidget.cpp.

References m_curve, and Kwave::Curve::VFlip().

Referenced by CurveWidget().

{
    m_curve.VFlip();
    repaint();
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

m_current

Kwave::Curve::Point Kwave::CurveWidget::m_current

private

Currently selected point or null if none selected

Definition at line 151 of file CurveWidget.h.

Referenced by loadPreset(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), and paintEvent().

m_curve

Kwave::Curve Kwave::CurveWidget::m_curve

private

The curve to be edited

Definition at line 139 of file CurveWidget.h.

Referenced by addPoint(), CurveWidget(), deleteLast(), deleteSecond(), findPoint(), firstHalf(), getCommand(), HFlip(), loadPreset(), mouseMoveEvent(), paintEvent(), savePreset(), scaleFit(), secondHalf(), selectInterpolationType(), setCurve(), and VFlip().

m_down

bool Kwave::CurveWidget::m_down

private

State of the left mouse button (when moving points)

Definition at line 157 of file CurveWidget.h.

Referenced by mousePressEvent(), mouseReleaseEvent(), and paintEvent().

m_height

int Kwave::CurveWidget::m_height

private

Cached height of the widget

Definition at line 136 of file CurveWidget.h.

Referenced by findPoint(), mouseMoveEvent(), mousePressEvent(), and paintEvent().

m_knob

QPixmap Kwave::CurveWidget::m_knob

private

pixmap for the unselected knob

Definition at line 160 of file CurveWidget.h.

Referenced by CurveWidget(), and paintEvent().

m_last

Kwave::Curve::Point Kwave::CurveWidget::m_last

private

Last selected point, remembered for deleting.

Definition at line 154 of file CurveWidget.h.

Referenced by addPoint(), deleteLast(), deleteSecond(), firstHalf(), loadPreset(), mouseReleaseEvent(), paintEvent(), and secondHalf().

m_menu

QMenu* Kwave::CurveWidget::m_menu

private

Popup (context) menu for the right mouse button

Definition at line 142 of file CurveWidget.h.

Referenced by CurveWidget(), mousePressEvent(), and ~CurveWidget().

m_preset_menu

QMenu* Kwave::CurveWidget::m_preset_menu

private

Part of the popup (context) menu for the right mouse button with the list of preset files

Definition at line 148 of file CurveWidget.h.

Referenced by CurveWidget(), loadPreset(), and loadPresetList().

m_selected_knob

QPixmap Kwave::CurveWidget::m_selected_knob

private

pixmap for the selected knob

Definition at line 163 of file CurveWidget.h.

Referenced by CurveWidget(), and paintEvent().

m_width

int Kwave::CurveWidget::m_width

private

Cached width of the widget

Definition at line 133 of file CurveWidget.h.

Referenced by findPoint(), mouseMoveEvent(), mousePressEvent(), and paintEvent().

---

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

• libgui/CurveWidget.h
• libgui/CurveWidget.cpp