Kwave::SonagramDialog Class Reference

#include <SonagramDialog.h>

Inheritance diagram for Kwave::SonagramDialog:

Collaboration diagram for Kwave::SonagramDialog:

Public Slots
void	setPoints (int points)
void	setWindowFunction (Kwave::window_function_t type)
void	setColorMode (int color)
void	setTrackChanges (bool track_changes)
void	setFollowSelection (bool follow_selection)
void	setBoxPoints (int num)

Public Member Functions
	SonagramDialog (Kwave::Plugin &p)
virtual	~SonagramDialog ()
void	parameters (QStringList &list)

Private Slots
void	invokeHelp ()

Private Attributes
sample_index_t	m_length
double	m_rate

Detailed Description

Definition at line 36 of file SonagramDialog.h.

Constructor & Destructor Documentation

SonagramDialog()

Kwave::SonagramDialog::SonagramDialog ( Kwave::Plugin &  p )

explicit

Constructor

Definition at line 46 of file SonagramDialog.cpp.

References Kwave::connect(), Kwave::WindowFunction::count(), Kwave::WindowFunction::description(), invokeHelp(), m_length, setBoxPoints(), setPoints(), Kwave::toInt(), and Kwave::WINDOW_FUNC_NONE.

    :QDialog(p.parentWidget()), Ui::SonagramDlg(),
     m_length(p.selection(Q_NULLPTR, Q_NULLPTR, Q_NULLPTR, true)),
     m_rate(p.signalRate())
{
    setupUi(this);
    setModal(true);

    Q_ASSERT(pointbox);
    Q_ASSERT(pointslider);
    Q_ASSERT(windowtypebox);
    if (!pointbox) return;
    if (!pointslider) return;
    if (!windowtypebox) return;

    pointslider->setMaximum(Kwave::toInt(m_length / 16));

    Kwave::window_function_t wf = Kwave::WINDOW_FUNC_NONE;
    for (unsigned int i = 0; i < Kwave::WindowFunction::count(); i++) {
        windowtypebox->addItem(Kwave::WindowFunction::description(wf, true));
        ++wf;
    }

    setPoints(1);    // must set the minimum number of points to get
    setBoxPoints(0); // the largest windowlabel

    // Set a size hint:
    // try to make the image's aspect ratio (a) = sqrt(2)
    //
    // samples: s
    // fft_points: np
    // image_width: w = s / np
    // image_height: h = np / 2
    // a = w / h = 2*s / (np^2)
    // => np = sqrt( 2 * s / a) )
    const double aspect_ratio = sqrt(2);
    double np = sqrt(2.0 * static_cast<double>(m_length) / aspect_ratio);

    // round down to an exponent of 2, this makes the image more
    // wide than heigh and gives a fast calculation
    int bits = Kwave::toInt(floor(log(np) / log(2)));
    if (bits < 2) bits = 2;
    if (bits > 16) bits = 16;
    setPoints(1 << (bits-1));
    setBoxPoints(0);

    connect(
        buttonBox->button(QDialogButtonBox::Help), SIGNAL(clicked()),
        this,                                      SLOT(invokeHelp())
    );
    connect(pointslider, SIGNAL(valueChanged(int)), SLOT(setPoints(int)));
    connect(pointbox,    SIGNAL(activated(int)),    SLOT(setBoxPoints(int)));

    // set the focus onto the "OK" button
    buttonBox->button(QDialogButtonBox::Ok)->setFocus();
}

Here is the call graph for this function:

~SonagramDialog()

Kwave::SonagramDialog::~SonagramDialog ( )

virtual

Destructor

Definition at line 200 of file SonagramDialog.cpp.

{
}

Member Function Documentation

invokeHelp

void Kwave::SonagramDialog::invokeHelp ( )

privateslot

invoke the online help

Definition at line 205 of file SonagramDialog.cpp.

References _.

Referenced by SonagramDialog().

{
    KHelpClient::invokeHelp(_("plugin_sect_sonagram"));
}

Here is the caller graph for this function:

parameters()

void Kwave::SonagramDialog::parameters

(

QStringList &

list

)

Fills the current parameters into a parameter list. The list always is cleared before it gets filled. The first parameter will contain the number of fft points [1...n] The second parameter will contain the id of a window function or zero if no window function was selected ("<none>").

Definition at line 104 of file SonagramDialog.cpp.

References Kwave::WindowFunction::findFromIndex(), and Kwave::WindowFunction::name().

Referenced by Kwave::SonagramPlugin::setup().

{
    Q_ASSERT(pointbox);
    Q_ASSERT(windowtypebox);
    Q_ASSERT(rbColor);

    QString param;
    list.clear();

    // parameter #0: number of fft points
    param = pointbox ? pointbox->currentText() : QString();
    list.append(param);

    // parameter #1: index of the window function
    Kwave::window_function_t wf = Kwave::WindowFunction::findFromIndex(
        (windowtypebox) ? windowtypebox->currentIndex() : 0);
    param = Kwave::WindowFunction::name(wf);
    list.append(param);

    // parameter #2: flag: use color instead of greyscale
    param.setNum(rbColor ? (rbColor->isChecked() ? 1 : 0) : 0);
    list.append(param);

    // parameter #3: flag: track changes
    param.setNum((cbTrackChanges && cbTrackChanges->isChecked())
        ? 1 : 0);
    list.append(param);

    // parameter #4: flag: follow selection
    param.setNum((cbFollowSelection && cbFollowSelection->isChecked())
        ? 1 : 0);
    list.append(param);

}

Here is the call graph for this function:

Here is the caller graph for this function:

setBoxPoints

void Kwave::SonagramDialog::setBoxPoints ( int  num )

slot

Definition at line 192 of file SonagramDialog.cpp.

Referenced by SonagramDialog().

{
    Q_ASSERT(num >= 0);
    int points = pointbox->itemText(num).toInt();
    pointslider->setValue(points / 2);
}

Here is the caller graph for this function:

setColorMode

void Kwave::SonagramDialog::setColorMode ( int  color )

slot

sets the color mode. Currently only black/white (0) and rainbow color (1) are supported.

Definition at line 166 of file SonagramDialog.cpp.

Referenced by Kwave::SonagramPlugin::setup().

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

    rbColor->setChecked(color);
    rbGreyScale->setChecked(!color);
}

Here is the caller graph for this function:

setFollowSelection

void Kwave::SonagramDialog::setFollowSelection ( bool  follow_selection )

slot

enables/disables the "follow selection mode

Definition at line 184 of file SonagramDialog.cpp.

Referenced by Kwave::SonagramPlugin::setup().

{
    Q_ASSERT(cbFollowSelection);
    if (!cbFollowSelection) return;
    cbFollowSelection->setChecked(follow_selection);
}

Here is the caller graph for this function:

setPoints

void Kwave::SonagramDialog::setPoints ( int  points )

slot

sets the number of fft points

Definition at line 140 of file SonagramDialog.cpp.

References m_length, m_rate, and Kwave::ms2string().

Referenced by SonagramDialog().

{
    Q_ASSERT(points >= 0);
    QString text;
    points *= 2;

    text.setNum(points);
    pointbox->setEditText(text);

    windowlabel->setText(i18n("(resulting window size: %1)",
        Kwave::ms2string(points * 1.0E3 / m_rate)));

    bitmaplabel->setText(i18n("Size of bitmap: %1x%2",
        (m_length / points) + 1,
        points/2));
}

Here is the call graph for this function:

Here is the caller graph for this function:

setTrackChanges

void Kwave::SonagramDialog::setTrackChanges ( bool  track_changes )

slot

enables/disables the "track changes" mode

Definition at line 176 of file SonagramDialog.cpp.

Referenced by Kwave::SonagramPlugin::setup().

{
    Q_ASSERT(cbTrackChanges);
    if (!cbTrackChanges) return;
    cbTrackChanges->setChecked(track_changes);
}

Here is the caller graph for this function:

setWindowFunction

void Kwave::SonagramDialog::setWindowFunction ( Kwave::window_function_t  type )

slot

selects a window function

Definition at line 158 of file SonagramDialog.cpp.

References Kwave::WindowFunction::index().

Referenced by Kwave::SonagramPlugin::setup().

{
    Q_ASSERT(windowtypebox);
    if (!windowtypebox) return;
    windowtypebox->setCurrentIndex(Kwave::WindowFunction::index(type));
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

m_length

sample_index_t Kwave::SonagramDialog::m_length

private

length of the selection

Definition at line 86 of file SonagramDialog.h.

Referenced by setPoints(), and SonagramDialog().

m_rate

double Kwave::SonagramDialog::m_rate

private

sample rate of the signal

Definition at line 89 of file SonagramDialog.h.

Referenced by setPoints().

---

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

• plugins/sonagram/SonagramDialog.h
• plugins/sonagram/SonagramDialog.cpp