Kwave::SignalWidget Class Reference

#include <SignalWidget.h>

Inheritance diagram for Kwave::SignalWidget:

Collaboration diagram for Kwave::SignalWidget:

Public Slots
void	requestRepaint (Kwave::SignalView *view)
void	forwardCommand (const QString &command)

Signals
void	sigRepaint ()
void	selectedTimeInfo (sample_index_t offset, sample_index_t length, double rate)
void	sigCommand (const QString &command)
void	sigCursorChanged (sample_index_t pos)

Public Member Functions
	SignalWidget (QWidget *parent, Kwave::SignalManager *signal_manager, QVBoxLayout *upper_dock, QVBoxLayout *lower_dock)
virtual	~SignalWidget () Q_DECL_OVERRIDE
void	setZoomAndOffset (double zoom, sample_index_t offset)
int	mapToViewPort (const QPoint &pos) const
int	visibleWidth () const
virtual void	insertView (Kwave::SignalView *view, QWidget *controls) Q_DECL_OVERRIDE
Public Member Functions inherited from Kwave::ViewManager
virtual	~ViewManager ()

Protected Slots
virtual void	contextMenuEvent (QContextMenuEvent *e) Q_DECL_OVERRIDE

Protected Member Functions
virtual void	wheelEvent (QWheelEvent *event) Q_DECL_OVERRIDE

Private Slots
void	repaintTimerElapsed ()
void	slotTrackInserted (unsigned int index, Kwave::Track *track)
void	slotTrackDeleted (unsigned int index, Kwave::Track *track)
void	contextMenuEditUndo ()
void	contextMenuEditRedo ()
void	contextMenuEditCut ()
void	contextMenuEditCopy ()
void	contextMenuEditPaste ()
void	contextMenuSaveSelection ()
void	contextMenuSelectionExpandToLabels ()
void	contextMenuSelectionNextLabels ()
void	contextMenuSelectionPrevLabels ()
void	updateMinimumHeight ()

Private Member Functions
void	setVerticalZoom (double zoom)
void	insertRow (int index, Kwave::SignalView *view, QWidget *controls)
void	deleteRow (int index)

Private Attributes
Kwave::SignalManager *	m_signal_manager
QList< QPointer< Kwave::SignalView > >	m_views
QGridLayout	m_layout
QPointer< QVBoxLayout >	m_upper_dock
QPointer< QVBoxLayout >	m_lower_dock
sample_index_t	m_offset
double	m_zoom
double	m_vertical_zoom
QTimer	m_repaint_timer
QQueue< QPointer< Kwave::SignalView > >	m_repaint_queue

Detailed Description

The SignalWidget class is responsible for displaying and managing the views that belong to a signal.

Definition at line 75 of file SignalWidget.h.

Constructor & Destructor Documentation

SignalWidget()

Kwave::SignalWidget::SignalWidget	(	QWidget *	parent,
		Kwave::SignalManager *	signal_manager,
		QVBoxLayout *	upper_dock,
		QVBoxLayout *	lower_dock
	)

Constructor

Parameters

parent	parent widget
signal_manager	signal manager of the file context
upper_dock	layout of the upper docking area
lower_dock	layout of the lower docking area

Definition at line 83 of file SignalWidget.cpp.

References Kwave::connect(), m_layout, m_repaint_timer, m_signal_manager, repaintTimerElapsed(), slotTrackDeleted(), and slotTrackInserted().

    :QWidget(parent),
     m_signal_manager(signal_manager),
     m_views(),
     m_layout(this),
     m_upper_dock(upper_dock),
     m_lower_dock(lower_dock),
     m_offset(0),
     m_zoom(0.0),
     m_vertical_zoom(1.0),
     m_repaint_timer()
{
//    qDebug("SignalWidget::SignalWidget()");

    // connect to the signal manager's signals
    Kwave::SignalManager *sig = m_signal_manager;

    connect(sig,  SIGNAL(sigTrackInserted(uint,Kwave::Track*)),
            this, SLOT(slotTrackInserted(uint,Kwave::Track*)));
    connect(sig,  SIGNAL(sigTrackDeleted(uint,Kwave::Track*)),
            this, SLOT(slotTrackDeleted(uint,Kwave::Track*)));

    // use a timer for limiting the repaint rate
    m_repaint_timer.setSingleShot(true);
    connect(&m_repaint_timer, SIGNAL(timeout()),
            this,             SLOT(repaintTimerElapsed()));

//     // -- accelerator keys for 1...9 --
//     for (int i = 0; i < 10; i++) {
//      Kwave::ShortcutWrapper *shortcut =
//          new Kwave::ShortcutWrapper(this, tbl_keys[i], i);
//      connect(shortcut, SIGNAL(activated(int)),
//              this, SLOT(parseKey(int)));
//     }

    setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);

    m_layout.setColumnStretch(0,   0);
    m_layout.setColumnStretch(1, 100);
    m_layout.setMargin(0);
    m_layout.setVerticalSpacing(3);
    setLayout(&m_layout);
    m_layout.activate();
}

Here is the call graph for this function:

~SignalWidget()

Kwave::SignalWidget::~SignalWidget ( )

virtual

Destructor

Definition at line 132 of file SignalWidget.cpp.

{
}

Member Function Documentation

contextMenuEditCopy

void Kwave::SignalWidget::contextMenuEditCopy ( )

inlineprivateslot

context menu: "edit/copy"

Definition at line 182 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

{ forwardCommand(_("copy()")); }

Here is the caller graph for this function:

contextMenuEditCut

void Kwave::SignalWidget::contextMenuEditCut ( )

inlineprivateslot

context menu: "edit/cut"

Definition at line 179 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

{ forwardCommand(_("cut()"));  }

Here is the caller graph for this function:

contextMenuEditPaste

void Kwave::SignalWidget::contextMenuEditPaste ( )

inlineprivateslot

context menu: "edit/paste"

Definition at line 185 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

{forwardCommand(_("paste()")); }

Here is the caller graph for this function:

contextMenuEditRedo

void Kwave::SignalWidget::contextMenuEditRedo ( )

inlineprivateslot

context menu: "edit/redo"

Definition at line 176 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

{ forwardCommand(_("redo()")); }

Here is the caller graph for this function:

contextMenuEditUndo

void Kwave::SignalWidget::contextMenuEditUndo ( )

inlineprivateslot

context menu: "edit/undo"

Definition at line 173 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

{ forwardCommand(_("undo()")); }

Here is the caller graph for this function:

contextMenuEvent

void Kwave::SignalWidget::contextMenuEvent ( QContextMenuEvent *  e )

protectedvirtualslot

Handler for context menus

Definition at line 177 of file SignalWidget.cpp.

References _, Kwave::SignalManager::canRedo(), Kwave::SignalManager::canUndo(), Kwave::connect(), contextMenuEditCopy(), contextMenuEditCut(), contextMenuEditPaste(), contextMenuEditRedo(), contextMenuEditUndo(), contextMenuSaveSelection(), contextMenuSelectionExpandToLabels(), contextMenuSelectionNextLabels(), contextMenuSelectionPrevLabels(), forwardCommand(), Kwave::ClipBoard::instance(), Kwave::SignalManager::isEmpty(), Kwave::Selection::length(), m_signal_manager, m_views, Kwave::SignalManager::metaData(), Kwave::SignalManager::selection(), and sigCommand().

{
    Q_ASSERT(e);

    bool have_signal = m_signal_manager && !m_signal_manager->isEmpty();
    if (!have_signal)return;
    bool have_selection = (m_signal_manager->selection().length() > 1);
    bool have_labels =
        !(Kwave::LabelList(m_signal_manager->metaData()).isEmpty());

    QMenu *context_menu = new QMenu(this);
    Q_ASSERT(context_menu);
    if (!context_menu) return;

    /* menu items common to all cases */

    // undo
    QAction *action;
    action = context_menu->addAction(
        QIcon::fromTheme(_("edit-undo")),
        i18n("&Undo"), this, SLOT(contextMenuEditUndo()),
        Qt::CTRL + Qt::Key_Z);
    Q_ASSERT(action);
    if (!action) return;
    if (!m_signal_manager->canUndo())
        action->setEnabled(false);

    // redo
    action = context_menu->addAction(
        QIcon::fromTheme(_("edit-redo")),
        i18n("&Redo"), this, SLOT(contextMenuEditRedo()),
        Qt::CTRL + Qt::Key_Y);
    Q_ASSERT(action);
    if (!action) return;
    if (!m_signal_manager->canRedo())
        action->setEnabled(false);
    context_menu->addSeparator();

    // cut/copy/paste
    QAction *action_cut = context_menu->addAction(
        QIcon::fromTheme(_("edit-cut")),
        i18n("Cu&t"), this, SLOT(contextMenuEditCut()),
        Qt::CTRL + Qt::Key_X);
    QAction *action_copy = context_menu->addAction(
        QIcon::fromTheme(_("edit-copy")),
        i18n("&Copy"), this, SLOT(contextMenuEditCopy()),
        Qt::CTRL + Qt::Key_C);
    QAction *action_paste = context_menu->addAction(
        QIcon::fromTheme(_("edit-paste")),
        i18n("&Paste"), this, SLOT(contextMenuEditPaste()),
        Qt::CTRL + Qt::Key_V);
    context_menu->addSeparator();
    if (action_cut)   action_cut->setEnabled(have_selection);
    if (action_copy)  action_copy->setEnabled(have_selection);
    if (action_paste)
        action_paste->setEnabled(!Kwave::ClipBoard::instance().isEmpty());

    int mouse_x = mapFromGlobal(e->globalPos()).x();
    int mouse_y = mapFromGlobal(e->globalPos()).y();
    if (mouse_x < 0) mouse_x = 0;
    if (mouse_y < 0) mouse_y = 0;
    if (mouse_x >= width())   mouse_x = width()   - 1;
    if (mouse_y >= height())  mouse_y = height()  - 1;


    QMenu *submenu_select = context_menu->addMenu(i18n("Selection"));
    Q_ASSERT(submenu_select);
    if (!submenu_select) return;

    // Selection / &Save
    QAction *action_select_save = submenu_select->addAction(
        QIcon::fromTheme(_("document-save")),
        i18n("&Save..."), this, SLOT(contextMenuSaveSelection()));
    Q_ASSERT(action_select_save);
    if (!action_select_save) return;
    action_select_save->setEnabled(have_selection);

    // Selection / &Expand to labels
    QAction *action_select_expand_to_labels = submenu_select->addAction(
        i18n("&Expand to Labels"), this,
        SLOT(contextMenuSelectionExpandToLabels()), Qt::Key_E);
    Q_ASSERT(action_select_expand_to_labels);
    if (!action_select_expand_to_labels) return;
    action_select_expand_to_labels->setEnabled(have_labels);

    // Selection / to next labels
    QAction *action_select_next_labels = submenu_select->addAction(
        i18n("To Next Labels"), this,
        SLOT(contextMenuSelectionNextLabels()),
        Qt::SHIFT + Qt::CTRL + Qt::Key_N);
    Q_ASSERT(action_select_next_labels);
    if (!action_select_next_labels) return;
    action_select_next_labels->setEnabled(have_labels);

    // Selection / to previous labels
    QAction *action_select_prev_labels = submenu_select->addAction(
        i18n("To Previous Labels"), this,
        SLOT(contextMenuSelectionPrevLabels()),
        Qt::SHIFT + Qt::CTRL + Qt::Key_P);
    Q_ASSERT(action_select_prev_labels);
    if (!action_select_prev_labels) return;
    action_select_prev_labels->setEnabled(have_labels);

    // find out whether there was a click within a signal view
    QSharedPointer<Kwave::ViewItem> item(Q_NULLPTR);
    foreach (QPointer<Kwave::SignalView> view, m_views) {
        // map the rect of the view to our coordinate system
        const QRect view_rect = QRect(
            view->mapToParent(view->rect().topLeft()),
            view->mapToParent(view->rect().bottomRight()));

        // check: mouse click was into that view?
        if (view_rect.contains(mouse_x, mouse_y)) {
            // map mouse click position to coordinate system of the view
            QPoint pos = view->mapFromParent(QPoint(mouse_x, mouse_y));

            // give the view the chance to extend the context menu
            view->handleContextMenu(pos, context_menu);

            // try to find a view item at these coordinates
            item = view->findItem(pos);

            // if found, give the item the chance to extend the context menu
            if (!item.isNull()) {
                connect(item.data(), SIGNAL(sigCommand(QString)),
                        this,        SLOT(forwardCommand(QString)));
                item->appendContextMenu(context_menu);
            }

            // we process only one view, views cannot overlap!
            break;
        }
    }

    context_menu->exec(QCursor::pos());
    delete context_menu;
}

Here is the call graph for this function:

contextMenuSaveSelection

void Kwave::SignalWidget::contextMenuSaveSelection ( )

inlineprivateslot

context menu: "save selection"

Definition at line 188 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

                                        {
            forwardCommand(_("saveselect()"));
        }

Here is the caller graph for this function:

contextMenuSelectionExpandToLabels

void Kwave::SignalWidget::contextMenuSelectionExpandToLabels ( )

inlineprivateslot

context menu: "expand to labels"

Definition at line 193 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

                                                  {
            forwardCommand(_("expandtolabel()"));
        }

Here is the caller graph for this function:

contextMenuSelectionNextLabels

void Kwave::SignalWidget::contextMenuSelectionNextLabels ( )

inlineprivateslot

context menu: "select next labels"

Definition at line 198 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

                                               {
            forwardCommand(_("selectnextlabels()"));
        }

Here is the caller graph for this function:

contextMenuSelectionPrevLabels

void Kwave::SignalWidget::contextMenuSelectionPrevLabels ( )

inlineprivateslot

context menu: "select previous labels"

Definition at line 203 of file SignalWidget.h.

References _.

Referenced by contextMenuEvent().

                                               {
            forwardCommand(_("selectprevlabels()"));
        }

Here is the caller graph for this function:

deleteRow()

void Kwave::SignalWidget::deleteRow ( int  index )

private

delete a row in the m_layout, shifting all following rows back to the start by one

Parameters

index

the index if the row

Definition at line 416 of file SignalWidget.cpp.

References m_layout.

Referenced by slotTrackDeleted().

{
    const int rows = m_layout.rowCount();
    const int cols = m_layout.columnCount();

    if (index >= rows)
        return;

    // update the layout: move all items from this row to the previous
    for (int row = index; row < (rows - 1); row++) {
        for (int col = 0; col < cols; col++) {
            QLayoutItem *item = m_layout.itemAtPosition(row + 1, col);
            if (item) {
                m_layout.removeItem(item);
                m_layout.addItem(item, row, col);
            }
        }
    }
}

Here is the caller graph for this function:

forwardCommand

void Kwave::SignalWidget::forwardCommand ( const QString &  command )

slot

forward a sigCommand to the next layer

Definition at line 145 of file SignalWidget.cpp.

References sigCommand().

Referenced by contextMenuEvent().

{
    emit sigCommand(command);
}

Here is the caller graph for this function:

insertRow()

void Kwave::SignalWidget::insertRow ( int  index, Kwave::SignalView *  view, QWidget *  controls  )

private

insert a row in the m_layout, shifting all following rows to the end by one

Parameters

index	the index if the row
view	a view widget, must not be null
controls	a widget with controls, can be null

Definition at line 375 of file SignalWidget.cpp.

References Kwave::SignalView::addSibling(), and m_layout.

Referenced by insertView().

{
    const int rows = m_layout.rowCount();
    const int cols = m_layout.columnCount();

    // update the layout: move all items from the index on to the next row
    for (int row = rows; row > index; row--) {
        for (int col = 0; col < cols; col++) {
            QLayoutItem *item = m_layout.itemAtPosition(row - 1, col);
            if (item) {
                m_layout.removeItem(item);
                m_layout.addItem(item, row, col);
            }
        }
    }

    // add the widget to the layout
    m_layout.addWidget(view, index, 1);

    if (controls) {
        // add the controls to the layout
        m_layout.addWidget(controls, index, 0);

        // associate the controls to the view, so that when the view
        // gets removed/deleted, the controls get removed as well
        view->addSibling(controls);

        m_layout.activate();
        // NOTE: QLayout::activate() does not really activate the layout
        //       synchronously as expected. Instead it posts an event to
        //       invalidate the layout of it's parent widget.
        //       Unfortunately we need reliable geometry information
        //       already *now*, which forces us to do the event loop
        //       right here.
        qApp->processEvents(QEventLoop::ExcludeUserInputEvents |
                            QEventLoop::ExcludeSocketNotifiers);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

insertView()

void Kwave::SignalWidget::insertView ( Kwave::SignalView *  view, QWidget *  controls  )

virtual

Insert a new signal view into this widget (or the upper/lower dock area.

Parameters

view	the signal view, must not be a null pointer
controls	a widget with controls, optionally, can be null

Implements Kwave::ViewManager.

Definition at line 437 of file SignalWidget.cpp.

References Kwave::SignalView::AboveTrackBottom, Kwave::SignalView::AboveTrackTop, Kwave::SignalView::BelowTrackBottom, Kwave::SignalView::BelowTrackTop, Kwave::SignalView::Bottom, Kwave::connect(), insertRow(), Kwave::SignalView::LowerDockBottom, Kwave::SignalView::LowerDockTop, m_layout, m_lower_dock, m_offset, m_upper_dock, m_vertical_zoom, m_views, m_zoom, Kwave::SignalView::preferredLocation(), requestRepaint(), Kwave::SignalView::setVerticalZoom(), Kwave::SignalView::setZoomAndOffset(), sigCommand(), sigCursorChanged(), Kwave::SignalView::Top, Kwave::SignalView::track(), updateMinimumHeight(), Kwave::SignalView::UpperDockBottom, and Kwave::SignalView::UpperDockTop.

Referenced by slotTrackInserted().

{
    Q_ASSERT(m_upper_dock);
    Q_ASSERT(m_lower_dock);
    Q_ASSERT(view);
    if (!m_upper_dock || !m_lower_dock) return;
    if (!view) return;

    // set initial vertical zoom
    view->setVerticalZoom(m_vertical_zoom);

    // find the proper row to insert the track view
    int index = 0;
    int track = (view) ? view->track() : -1;
    const Kwave::SignalView::Location where = view->preferredLocation();
    switch (where) {
        case Kwave::SignalView::UpperDockTop: {
            // upper dock area, top
            index = 0;
            m_upper_dock->insertWidget(0, view);
            Q_ASSERT(!controls);
            break;
        }
        case Kwave::SignalView::UpperDockBottom: {
            // upper dock area, bottom
            index = m_upper_dock->count();
            m_upper_dock->addWidget(view);
            Q_ASSERT(!controls);
            break;
        }
        case Kwave::SignalView::Top: {
            // central layout, above all others
            index = m_upper_dock->count();
            int row = 0;
            insertRow(row, view, controls);
            break;
        }
        case Kwave::SignalView::AboveTrackTop: {
            // above the corresponding track, start of group
            index = m_upper_dock->count();
            int row = 0;
            for (;index < m_views.count(); ++row, ++index) {
                if (m_views[index]->track() >= track) break; // reached top
                if (m_views[index]->preferredLocation() >=
                        Kwave::SignalView::Bottom) break;
            }
            insertRow(row, view, controls);
            break;
        }
        case Kwave::SignalView::AboveTrackBottom: {
            // above the corresponding track, end of group
            index = m_upper_dock->count();
            int row = 0;
            for (;index < m_views.count(); ++row, ++index) {
                if (m_views[index]->track() < track) continue; // too early
                if (m_views[index]->track() != track) break; // next track
                if (m_views[index]->preferredLocation() !=
                        Kwave::SignalView::AboveTrackTop) break;
            }
            insertRow(row, view, controls);
            break;
        }
        case Kwave::SignalView::BelowTrackTop: {
            // below the corresponding track, start of group
            index = m_upper_dock->count();
            int row = 0;
            for (;index < m_views.count(); ++row, ++index) {
                if (m_views[index]->track() < track) continue; // too early
                if (m_views[index]->track() != track) break; // next track
                if (m_views[index]->preferredLocation() >=
                        Kwave::SignalView::BelowTrackTop) break;
            }
            insertRow(row, view, controls);
            break;
        }
        case Kwave::SignalView::BelowTrackBottom: {
            // below the corresponding track, end of group
            index = m_upper_dock->count();
            int row = 0;
            for (;index < m_views.count(); ++row, ++index) {
                if (m_views[index]->track() < track) continue; // too early
                if (m_views[index]->track() != track) break; // next track
                if (m_views[index]->preferredLocation() >=
                        Kwave::SignalView::Bottom) break;
            }
            insertRow(row, view, controls);
            break;
        }
        case Kwave::SignalView::Bottom: {
            // below all others
            int row = m_layout.rowCount();
            index = m_upper_dock->count() + row;
            insertRow(row, view, controls);
            break;
        }
        case Kwave::SignalView::LowerDockTop: {
            // lower dock area, top
            index = m_upper_dock->count() + m_layout.rowCount();
            m_lower_dock->insertWidget(0, view);
            Q_ASSERT(!controls);
            break;
        }
        case Kwave::SignalView::LowerDockBottom:
            // lower dock area, bottom
            index = m_upper_dock->count() + m_layout.rowCount() +
                    m_lower_dock->count();
            m_lower_dock->addWidget(view);
            Q_ASSERT(!controls);
            break;
    }

    // insert the view into the list of views
    Q_ASSERT(index >= 0);
    Q_ASSERT(index < m_upper_dock->count() + m_layout.rowCount() +
             m_lower_dock->count());
    m_views.insert(index, view);

    // initially set the current view info
    view->setZoomAndOffset(m_zoom, m_offset);

    // connect all signals
    connect(view,       SIGNAL(sigCommand(QString)),
            this,       SIGNAL(sigCommand(QString)),
            Qt::QueuedConnection);

    connect(view,       SIGNAL(sigNeedRepaint(Kwave::SignalView*)),
            this,       SLOT(requestRepaint(Kwave::SignalView*)));

    connect(view,       SIGNAL(contentSizeChanged()),
            this,       SLOT(updateMinimumHeight()));
    connect(view,       SIGNAL(destroyed(QObject*)),
            this,       SLOT(updateMinimumHeight()));
    connect(view,       SIGNAL(sigCursorChanged(sample_index_t)),
            this,       SIGNAL(sigCursorChanged(sample_index_t)));
    connect(this,       SIGNAL(sigCursorChanged(sample_index_t)),
            view,       SLOT(showCursor(sample_index_t)));

    updateMinimumHeight();
}

Here is the call graph for this function:

Here is the caller graph for this function:

mapToViewPort()

int Kwave::SignalWidget::mapToViewPort

(

const QPoint &

pos

)

const

Returns the x coordinate of an absolute pixel position to a relative coordinate within the viewport area (without controls)

Definition at line 361 of file SignalWidget.cpp.

References m_layout, and m_views.

Referenced by Kwave::MainWidget::wheelEvent().

{
    if (m_views.isEmpty()) return mapFromGlobal(pos).x(); // if empty
    return mapFromGlobal(pos).x() - m_layout.cellRect(0, 1).left();
}

Here is the caller graph for this function:

repaintTimerElapsed

void Kwave::SignalWidget::repaintTimerElapsed ( )

privateslot

called when the repaint timer has elapsed, to refresh all views that have requested a repaint and are in the repaint queue

Definition at line 166 of file SignalWidget.cpp.

References m_repaint_queue, and Kwave::SignalView::refresh().

Referenced by SignalWidget().

{
    while (!m_repaint_queue.isEmpty())
    {
        Kwave::SignalView *view = m_repaint_queue.dequeue();
        if (!view) continue;
        view->refresh();
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

requestRepaint

void Kwave::SignalWidget::requestRepaint ( Kwave::SignalView *  view )

slot

can be called by views to request a repaint, synchronized and throttled through our repaint timer

Definition at line 151 of file SignalWidget.cpp.

References m_repaint_queue, m_repaint_timer, and REPAINT_INTERVAL.

Referenced by insertView().

{
    // add the view to the repaint queue (if not already there)
    if (!m_repaint_queue.contains(view))
        m_repaint_queue.enqueue(view);

    if (!m_repaint_timer.isActive()) {
        // start the repaint timer
        m_repaint_timer.start(REPAINT_INTERVAL);
    }
    // else: repainting is inhibited -> wait until the
    // repaint timer is elapsed
}

Here is the caller graph for this function:

selectedTimeInfo

void Kwave::SignalWidget::selectedTimeInfo ( sample_index_t  offset, sample_index_t  length, double  rate  )

signal

Emits the offset and length of the current selection and the sample rate for converting it into milliseconds

Parameters

offset	index of the first selected sample
length	number of selected samples
rate	sample rate

setVerticalZoom()

void Kwave::SignalWidget::setVerticalZoom ( double  zoom )

private

propagates the vertical zoom to all views

Definition at line 341 of file SignalWidget.cpp.

References m_vertical_zoom, m_views, VERTICAL_ZOOM_MAX, and VERTICAL_ZOOM_MIN.

Referenced by wheelEvent().

{
    if (zoom > VERTICAL_ZOOM_MAX) zoom = VERTICAL_ZOOM_MAX;
    if (zoom < VERTICAL_ZOOM_MIN) zoom = VERTICAL_ZOOM_MIN;
    if (qFuzzyCompare(zoom, m_vertical_zoom)) return; // no change

    // take over the zoom factor
    m_vertical_zoom = zoom;

    // propagate the zoom to all views
    foreach (QPointer<Kwave::SignalView> view, m_views)
        if (view) view->setVerticalZoom(m_vertical_zoom);

    // get back the maximum zoom set by the views
    foreach (QPointer<Kwave::SignalView> view, m_views)
        if (view && view->verticalZoom() > m_vertical_zoom)
            m_vertical_zoom = view->verticalZoom();
}

Here is the caller graph for this function:

setZoomAndOffset()

void Kwave::SignalWidget::setZoomAndOffset	(	double	zoom,
		sample_index_t	offset
	)

sets new zoom factor and offset

Parameters

zoom	the new zoom factor in pixels/sample
offset	the index of the first visible sample

Definition at line 137 of file SignalWidget.cpp.

References m_views.

Referenced by Kwave::MainWidget::updateViewRange().

{
    Q_ASSERT(zoom >= 0.0);
    foreach (QPointer<Kwave::SignalView> view, m_views)
        view->setZoomAndOffset(zoom, offset);
}

Here is the caller graph for this function:

sigCommand

void Kwave::SignalWidget::sigCommand ( const QString &  command )

signal

Emits a command to be processed by the next higher instance.

Referenced by contextMenuEvent(), forwardCommand(), and insertView().

Here is the caller graph for this function:

sigCursorChanged

void Kwave::SignalWidget::sigCursorChanged ( sample_index_t  pos )

signal

emitted to request update of the cursor

Referenced by insertView().

Here is the caller graph for this function:

sigRepaint

void Kwave::SignalWidget::sigRepaint ( )

signal

child views can connected to this signal to synchronize repaints

slotTrackDeleted

void Kwave::SignalWidget::slotTrackDeleted ( unsigned int  index, Kwave::Track *  track  )

privateslot

Connected to the signal's sigTrackDeleted.

Parameters

index	numeric index of the deleted track
track	reference to the deleted track

See also

Signal::sigTrackInserted

Definition at line 612 of file SignalWidget.cpp.

References deleteRow(), m_layout, m_views, Kwave::SignalView::setTrack(), Kwave::toInt(), and Kwave::SignalView::track().

Referenced by SignalWidget().

{
    Q_UNUSED(track);

    // loop over all views, delete those that are bound to this track
    // and adjust the index of the following ones
    bool empty = true;
    QMutableListIterator<QPointer<Kwave::SignalView> > it(m_views);
    while (it.hasNext()) {
        Kwave::SignalView *view = it.next();
        if (view->track() == Kwave::toInt(index)) {
            it.remove();
            delete view;
        } else if (view->track() > Kwave::toInt(index)) {
            view->setTrack(view->track() - 1);
            empty = false;
        } else if (view->track() != -1) {
            empty = false;
        }
    }

    // find out if there are any empty rows in the grid now
    const int rows = m_layout.rowCount();
    const int cols = m_layout.columnCount();
    for (int row = 0; row < rows; row++) {
        bool row_is_empty = true;
        for (int col = 0; col < cols; col++) {
            QLayoutItem *item = m_layout.itemAtPosition(row, col);
            if (item) {
                row_is_empty = false;
                break;
            }
        }
        if (row_is_empty) deleteRow(row);
    }

    // if there are only views with track() == -1, we are empty,
    // in that case delete the rest (all views)
    if (empty) {
        while (!m_views.isEmpty())
            delete m_views.takeFirst();
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

slotTrackInserted

void Kwave::SignalWidget::slotTrackInserted ( unsigned int  index, Kwave::Track *  track  )

privateslot

Connected to the signal's sigTrackInserted.

Parameters

index	numeric index of the inserted track
track	reference to the inserted track

See also

Signal::sigTrackInserted

Definition at line 579 of file SignalWidget.cpp.

References insertView(), m_signal_manager, m_views, Kwave::SignalView::setTrack(), and Kwave::toInt().

Referenced by SignalWidget().

{
    Q_ASSERT(track);
    if (!track) return;

    // create a container widget for the track controls
    QWidget *controls = new QWidget(Q_NULLPTR);
    Q_ASSERT(controls);
    if (!controls) return;

    // create a new view for the track's signal
    Kwave::SignalView *new_view = new Kwave::TrackView(
        this, controls, m_signal_manager, track);
    Q_ASSERT(new_view);
    if (!new_view) {
        delete controls;
        return;
    }

    // loop over all views and adjust the track index of the following ones
    foreach (QPointer<Kwave::SignalView> view, m_views) {
        if (view->track() >= Kwave::toInt(index))
            view->setTrack(view->track() + 1);
    }

    // assign the view to the new track
    new_view->setTrack(index);

    insertView(new_view, controls);
}

Here is the call graph for this function:

Here is the caller graph for this function:

updateMinimumHeight

void Kwave::SignalWidget::updateMinimumHeight ( )

privateslot

updates the minimum height of the widget according to the number of rows

Definition at line 658 of file SignalWidget.cpp.

References m_layout.

Referenced by insertView().

{
    int height = 0;

    const int rows = m_layout.rowCount();
    const int cols = m_layout.columnCount();
    for (int row = 0; row < rows; row++) {
        int h = 0;
        for (int col = 0; col < cols; col++) {
            QLayoutItem *item = m_layout.itemAtPosition(row, col);
            QWidget *widget = (item) ? item->widget() : Q_NULLPTR;
            if (widget) {
                int min_height = widget->minimumSize().height();
                if (min_height > h) h = min_height;
            }
        }
        height += h;
    }
    if (rows > 1) height += (rows - 1) * m_layout.verticalSpacing();

    setMinimumHeight(height);
}

Here is the caller graph for this function:

visibleWidth()

int Kwave::SignalWidget::visibleWidth

(

)

const

Returns the width of the viewport with the signal (without controls)

Returns

width of the signal area [pixels]

Definition at line 368 of file SignalWidget.cpp.

References m_layout, and m_views.

Referenced by Kwave::MainWidget::visibleWidth().

{
    if (m_views.isEmpty()) return width(); // if empty
    return m_layout.cellRect(0, 1).width();
}

Here is the caller graph for this function:

wheelEvent()

void Kwave::SignalWidget::wheelEvent ( QWheelEvent *  event )

protectedvirtual

slot for mouse wheel events, used for vertical zoom

Definition at line 316 of file SignalWidget.cpp.

References m_vertical_zoom, setVerticalZoom(), and VERTICAL_ZOOM_STEP_FACTOR.

{
    if (!event) return;

    // we currently are only interested in <Alt> + <WheelUp/Down>
    if (event->modifiers() != Qt::AltModifier) {
        event->ignore();
        return;
    }

    if (event->delta() > 0) {
        // zoom in
        setVerticalZoom(m_vertical_zoom  * VERTICAL_ZOOM_STEP_FACTOR);
        event->accept();
    } else if (event->delta() < 0) {
        // zoom out
        setVerticalZoom(m_vertical_zoom  / VERTICAL_ZOOM_STEP_FACTOR);
        event->accept();
    } else {
        // no change
        event->ignore();
    }
}

Here is the call graph for this function:

Member Data Documentation

m_layout

QGridLayout Kwave::SignalWidget::m_layout

private

the central layout with the views

Definition at line 273 of file SignalWidget.h.

Referenced by deleteRow(), insertRow(), insertView(), mapToViewPort(), SignalWidget(), slotTrackDeleted(), updateMinimumHeight(), and visibleWidth().

m_lower_dock

QPointer<QVBoxLayout> Kwave::SignalWidget::m_lower_dock

private

layout of the lower docking area

Definition at line 279 of file SignalWidget.h.

Referenced by insertView().

m_offset

sample_index_t Kwave::SignalWidget::m_offset

private

Offset from which signal is being displayed. This is equal to the index of the first visible sample.

Definition at line 285 of file SignalWidget.h.

Referenced by insertView().

m_repaint_queue

QQueue< QPointer<Kwave::SignalView> > Kwave::SignalWidget::m_repaint_queue

private

queue with pointers to all signal views that need a repaint

Definition at line 297 of file SignalWidget.h.

Referenced by repaintTimerElapsed(), and requestRepaint().

m_repaint_timer

QTimer Kwave::SignalWidget::m_repaint_timer

private

timer for limiting the number of repaints per second

Definition at line 294 of file SignalWidget.h.

Referenced by requestRepaint(), and SignalWidget().

m_signal_manager

Kwave::SignalManager* Kwave::SignalWidget::m_signal_manager

private

the signal manager of the corresponding context

Definition at line 262 of file SignalWidget.h.

Referenced by contextMenuEvent(), SignalWidget(), and slotTrackInserted().

m_upper_dock

QPointer<QVBoxLayout> Kwave::SignalWidget::m_upper_dock

private

layout of the upper docking area

Definition at line 276 of file SignalWidget.h.

Referenced by insertView().

m_vertical_zoom

double Kwave::SignalWidget::m_vertical_zoom

private

vertical zoom factor

Definition at line 291 of file SignalWidget.h.

Referenced by insertView(), setVerticalZoom(), and wheelEvent().

m_views

QList< QPointer<Kwave::SignalView> > Kwave::SignalWidget::m_views

private

list of signal views. Contains one entry for each signal view, starting with the ones in m_upper_dock, then the ones in m_layout, and at the end the ones from m_lower_dock. The list is sorted in the order of the appearance in the GUI.

Definition at line 270 of file SignalWidget.h.

Referenced by contextMenuEvent(), insertView(), mapToViewPort(), setVerticalZoom(), setZoomAndOffset(), slotTrackDeleted(), slotTrackInserted(), and visibleWidth().

m_zoom

double Kwave::SignalWidget::m_zoom

private

number of samples per pixel

Definition at line 288 of file SignalWidget.h.

Referenced by insertView().

---

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

• libgui/SignalWidget.h
• libgui/SignalWidget.cpp