Kwave::BandPassDialog Class Reference

#include <BandPassDialog.h>

Inheritance diagram for Kwave::BandPassDialog:

Collaboration diagram for Kwave::BandPassDialog:

Signals
void	freqChanged (double freq)
void	bwChanged (double bw)
void	startPreListen ()
void	stopPreListen ()

Public Member Functions
	BandPassDialog (QWidget *parent, double sample_rate)
virtual	~BandPassDialog () Q_DECL_OVERRIDE
virtual QStringList	params () Q_DECL_OVERRIDE
virtual void	setParams (QStringList &params) Q_DECL_OVERRIDE
virtual QDialog *	dialog () Q_DECL_OVERRIDE
Public Member Functions inherited from Kwave::PluginSetupDialog
virtual	~PluginSetupDialog ()

Protected Slots
void	freqValueChanged (int pos)
void	bwValueChanged (int pos)
void	listenToggled (bool listen)
void	listenStopped ()

Protected Member Functions
void	updateDisplay ()

Private Slots
void	invokeHelp ()

Private Attributes
double	m_frequency
double	m_bw
double	m_sample_rate
Kwave::BandPass *	m_filter

Detailed Description

Definition at line 39 of file BandPassDialog.h.

Constructor & Destructor Documentation

BandPassDialog()

Kwave::BandPassDialog::BandPassDialog	(	QWidget *	parent,
		double	sample_rate
	)

Constructor.

Parameters

parent	parent widget
sample_rate	sample rate of the audio data to be processed, needed for determining the allowed range of the cutoff frequency

Definition at line 41 of file BandPassDialog.cpp.

References bwValueChanged(), Kwave::connect(), freqValueChanged(), invokeHelp(), listenToggled(), m_bw, m_filter, m_frequency, Kwave::toInt(), and updateDisplay().

    :QDialog(parent), Kwave::PluginSetupDialog(), Ui::BandPassDlg(),
     m_frequency(3500),m_bw(100),
     m_sample_rate(sample_rate), m_filter(Q_NULLPTR)
{
    setupUi(this);
    setModal(true);

    // set maximum frequency to sample rate / 2
    double f_max = sample_rate / 2.0;

    slider->setMaximum(Kwave::toInt(f_max));
    slider_2->setMaximum(Kwave::toInt(f_max / 2.0));
    spinbox->setMaximum(Kwave::toInt(f_max));
    spinbox_2->setMaximum(Kwave::toInt(f_max / 2.0));

    // initialize the frequency scale widget
    scale_freq->setMinMax(0, Kwave::toInt(f_max));
    scale_freq->setLogMode(false);
    scale_freq->setUnit(i18n("Hz"));

    // initialize the attenuation scale widget
    scale_db->setMinMax(-24, +6);
    scale_db->setLogMode(false);
    scale_db->setUnit(i18n("dB"));

    // initialize the frequency response widget
    freq_response->init(f_max, -24, +6);

    // set up the low pass filter function
    m_filter = new Kwave::BandPass();
    freq_response->setFilter(m_filter);

    // initialize the controls and the curve display
    slider->setValue(Kwave::toInt(m_frequency));
    spinbox->setValue(Kwave::toInt(m_frequency));

    slider_2->setValue(Kwave::toInt(m_bw));
    spinbox_2->setValue(Kwave::toInt(m_bw));
    updateDisplay();

    // changes in the slider or spinbox
    connect(spinbox, SIGNAL(valueChanged(int)),
            this, SLOT(freqValueChanged(int)));
    connect(spinbox_2, SIGNAL(valueChanged(int)),
            this, SLOT(bwValueChanged(int)));
    // click to the "Listen" button
    connect(btListen, SIGNAL(toggled(bool)),
            this, SLOT(listenToggled(bool)));

    // expand the "Listen" button to it's maximum width
    listenToggled(true);
    if (btListen->width() > btListen->minimumWidth())
        btListen->setMinimumWidth(btListen->width());
    listenToggled(false);
    if (btListen->width() > btListen->minimumWidth())
        btListen->setMinimumWidth(btListen->width());

    // set the initial size of the dialog
    int h = (width() * 3) / 5;
    if (height() < h) resize(width(), h);
    int w = (height() * 5) / 3;
    if (width() < w) resize(w, height());

    connect(buttonBox_Help->button(QDialogButtonBox::Help), SIGNAL(clicked()),
            this,   SLOT(invokeHelp()));

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

Here is the call graph for this function:

~BandPassDialog()

Kwave::BandPassDialog::~BandPassDialog ( )

virtual

Destructor

Definition at line 113 of file BandPassDialog.cpp.

References listenToggled(), and m_filter.

{
    // better stop pre-listen now
    listenToggled(false);

    if (freq_response) freq_response->setFilter(Q_NULLPTR);
    if (m_filter) delete m_filter;
}

Here is the call graph for this function:

Member Function Documentation

bwChanged

void Kwave::BandPassDialog::bwChanged ( double  bw )

signal

emitted whenever the bandwidth setting has changed

Parameters

bw	bandwith parameter [0 .. 1.0]

Referenced by bwValueChanged(), and dialog().

Here is the caller graph for this function:

bwValueChanged

void Kwave::BandPassDialog::bwValueChanged ( int  pos )

protectedslot

called when the bw spinbox or slider value has changed

Definition at line 133 of file BandPassDialog.cpp.

References bwChanged(), m_bw, Kwave::toInt(), and updateDisplay().

Referenced by BandPassDialog(), and dialog().

{
    if (Kwave::toInt(m_bw) != pos) {
        m_bw = pos;
        updateDisplay();

        emit bwChanged(m_bw);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

dialog()

virtual QDialog* Kwave::BandPassDialog::dialog ( )

inlinevirtual

retruns a pointer to this as a QDialog

Implements Kwave::PluginSetupDialog.

Definition at line 65 of file BandPassDialog.h.

References bwChanged(), bwValueChanged(), freqChanged(), freqValueChanged(), invokeHelp(), listenStopped(), listenToggled(), startPreListen(), stopPreListen(), and updateDisplay().

{ return this; }

Here is the call graph for this function:

freqChanged

void Kwave::BandPassDialog::freqChanged ( double  freq )

signal

Emitted whenever the frequency changes

Parameters

freq	the frequency parameter in Hz

Referenced by dialog(), and freqValueChanged().

Here is the caller graph for this function:

freqValueChanged

void Kwave::BandPassDialog::freqValueChanged ( int  pos )

protectedslot

called when the freq spinbox or slider value has changed

Definition at line 123 of file BandPassDialog.cpp.

References freqChanged(), m_frequency, Kwave::toInt(), and updateDisplay().

Referenced by BandPassDialog(), and dialog().

{
    if (Kwave::toInt(m_frequency) != pos) {
        m_frequency = pos;
        updateDisplay();

        emit freqChanged(m_frequency);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

invokeHelp

void Kwave::BandPassDialog::invokeHelp ( )

privateslot

invoke the online help

Definition at line 209 of file BandPassDialog.cpp.

References _.

Referenced by BandPassDialog(), and dialog().

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

Here is the caller graph for this function:

listenStopped

void Kwave::BandPassDialog::listenStopped ( )

protectedslot

called when the pre-listen mode stopped/aborted

Definition at line 203 of file BandPassDialog.cpp.

Referenced by dialog().

{
    if (btListen) btListen->setChecked(false);
}

Here is the caller graph for this function:

listenToggled

void Kwave::BandPassDialog::listenToggled ( bool  listen )

protectedslot

called when the "Listen" button has been toggled, to start or stop the pre-listen mode

Definition at line 186 of file BandPassDialog.cpp.

References startPreListen(), and stopPreListen().

Referenced by BandPassDialog(), dialog(), and ~BandPassDialog().

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

    if (listen) {
        // start pre-listen mode
        emit startPreListen();
        btListen->setText(i18n("&Stop"));
    } else {
        // stop pre-listen mode
        emit stopPreListen();
        btListen->setText(i18n("&Listen"));
    }
}

Here is the caller graph for this function:

params()

QStringList Kwave::BandPassDialog::params ( )

virtual

Returns the parameters as string list

Implements Kwave::PluginSetupDialog.

Definition at line 143 of file BandPassDialog.cpp.

References m_bw, and m_frequency.

{
    QStringList list;
    list << QString::number(m_frequency);
    list << QString::number(m_bw);
    return list;
}

setParams()

void Kwave::BandPassDialog::setParams ( QStringList &  params )

virtual

Sets the from a list of parameters

Implements Kwave::PluginSetupDialog.

Definition at line 152 of file BandPassDialog.cpp.

References m_bw, m_frequency, Kwave::toInt(), and updateDisplay().

{
    // evaluate the parameter list
    bool ok;
    double frequency = params[0].toDouble(&ok);
    Q_ASSERT(ok);
    if (ok) m_frequency = frequency;

    double bw = params[1].toDouble(&ok);
    Q_ASSERT(ok);
    if (ok) m_bw = bw;

    slider->setValue(Kwave::toInt(m_frequency));
    spinbox->setValue(Kwave::toInt(m_frequency));

    slider_2->setValue(Kwave::toInt(m_bw));
    spinbox_2->setValue(Kwave::toInt(m_bw));

    updateDisplay();
}

Here is the call graph for this function:

startPreListen

void Kwave::BandPassDialog::startPreListen ( )

signal

Pre-listen mode has been started

Referenced by dialog(), and listenToggled().

Here is the caller graph for this function:

stopPreListen

void Kwave::BandPassDialog::stopPreListen ( )

signal

Pre-listen mode has been stopped

Referenced by dialog(), and listenToggled().

Here is the caller graph for this function:

updateDisplay()

void Kwave::BandPassDialog::updateDisplay ( )

protected

Update the graphic display

Definition at line 174 of file BandPassDialog.cpp.

References m_bw, m_filter, m_frequency, m_sample_rate, Kwave::BandPass::setBandwidth(), and Kwave::BandPass::setFrequency().

Referenced by BandPassDialog(), bwValueChanged(), dialog(), freqValueChanged(), and setParams().

{
    double fs = m_sample_rate;
    if (m_filter && (fs > 0.0))
    {
        m_filter->setFrequency(QVariant(2.0 * M_PI * m_frequency / fs));
        m_filter->setBandwidth(QVariant(2.0 * M_PI * m_bw / fs));
        if (freq_response) freq_response->repaint();
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

m_bw

double Kwave::BandPassDialog::m_bw

private

the bw in Hz

Definition at line 122 of file BandPassDialog.h.

Referenced by BandPassDialog(), bwValueChanged(), params(), setParams(), and updateDisplay().

m_filter

Kwave::BandPass* Kwave::BandPassDialog::m_filter

private

filter function for calculating the frequency response

Definition at line 128 of file BandPassDialog.h.

Referenced by BandPassDialog(), updateDisplay(), and ~BandPassDialog().

m_frequency

double Kwave::BandPassDialog::m_frequency

private

the cutoff frequency in Hz

Definition at line 119 of file BandPassDialog.h.

Referenced by BandPassDialog(), freqValueChanged(), params(), setParams(), and updateDisplay().

m_sample_rate

double Kwave::BandPassDialog::m_sample_rate

private

sample rate of the signal in samples/sec

Definition at line 125 of file BandPassDialog.h.

Referenced by updateDisplay().

---

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

• plugins/band_pass/BandPassDialog.h
• plugins/band_pass/BandPassDialog.cpp