Kwave::NewSignalDialog Class Reference

#include <NewSignalDialog.h>

Inheritance diagram for Kwave::NewSignalDialog:

Collaboration diagram for Kwave::NewSignalDialog:

Public Member Functions
	NewSignalDialog (QWidget *parent, sample_index_t samples, unsigned int rate, unsigned int bits, unsigned int tracks, bool by_time)
virtual	~NewSignalDialog ()
sample_index_t	samples ()
double	rate ()
unsigned int	bitsPerSample ()
unsigned int	tracks ()
bool	byTime ()

Private Slots
void	checkNewSampleEdit ()
void	checkTimeAndLengthInfo (int)
void	rbTimeToggled (bool)
void	timeChanged (int)
void	sampleRateChanged (const QString &)
void	tracksChanged (int)
void	samplesChanged (int)
void	updateFileSize ()
void	setLengthPercentage (int percent)
void	invokeHelp ()

Private Member Functions
sample_index_t	maxSamples ()
void	setHMS (sample_index_t &samples)

Private Attributes
QTimer	m_timer
bool	m_recursive

Detailed Description

Definition at line 35 of file NewSignalDialog.h.

Constructor & Destructor Documentation

NewSignalDialog()

Kwave::NewSignalDialog::NewSignalDialog	(	QWidget *	parent,
		sample_index_t	samples,
		unsigned int	rate,
		unsigned int	bits,
		unsigned int	tracks,
		bool	by_time
	)

Constructor.

Parameters

parent	the parent widget the dialog belongs to
samples	default resolution in bits per sample
rate	default sample rate
bits	default resolution
tracks	default tracks
by_time	if true: select by time, if false: select by samples

Definition at line 43 of file NewSignalDialog.cpp.

References checkNewSampleEdit(), checkTimeAndLengthInfo(), Kwave::connect(), invokeHelp(), m_timer, rbTimeToggled(), sampleRateChanged(), samplesChanged(), setHMS(), setLengthPercentage(), timeChanged(), Kwave::toInt(), and tracksChanged().

    :QDialog(parent), Ui::NewSigDlg(), m_timer(this), m_recursive(false)
{

    setupUi(this);
    setModal(true);

    edSamples->setRange(0, INT_MAX);
    edSamples->setSingleStep(1);

    // connect the timer for the sample edit
    connect(&m_timer, SIGNAL(timeout()), this, SLOT(checkNewSampleEdit()));
    connect(rbTime, SIGNAL(toggled(bool)),
            this, SLOT(rbTimeToggled(bool)));

    // connect the file format controls
    connect(cbSampleRate, SIGNAL(editTextChanged(QString)),
            this, SLOT(sampleRateChanged(QString)));
    connect(sbChannels, SIGNAL(valueChanged(int)),
            this, SLOT(tracksChanged(int)));
    connect(sbResolution, SIGNAL(valueChanged(int)),
            this, SLOT(checkTimeAndLengthInfo(int)));

    // connect the time controls
    connect(sbSeconds, SIGNAL(valueChanged(int)),
            this, SLOT(timeChanged(int)));
    connect(sbMinutes, SIGNAL(valueChanged(int)),
            this, SLOT(timeChanged(int)));
    connect(sbHours, SIGNAL(valueChanged(int)),
            this, SLOT(timeChanged(int)));

    // selection by number of samples
    connect(slideLength,SIGNAL(valueChanged(int)),
            this, SLOT(setLengthPercentage(int)));

    // selection by percentage of maximum possible length
    connect(edSamples, SIGNAL(valueChanged(int)),
            this, SLOT(samplesChanged(int)));

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

    // pre-initialize the size
    setMaximumHeight(sizeHint().height());
    setMaximumWidth(sizeHint().width());

    // initialize the controls
    cbSampleRate->setEditText(QString::number(rate));
    sbResolution->setValue(bits);
    sbChannels->setValue(tracks);
    if (by_time) {
        rbSamples->setChecked(false);
        rbTime->setChecked(true);
        setHMS(samples);
        edSamples->setEnabled(false);
        sbHours->setEnabled(true);
        sbMinutes->setEnabled(true);
        sbSeconds->setEnabled(true);
    } else {
        // by samples
        rbTime->setChecked(false);
        rbSamples->setChecked(true);
        edSamples->setValue(Kwave::toInt(samples));
        edSamples->setEnabled(true);
        sbHours->setEnabled(false);
        sbMinutes->setEnabled(false);
        sbSeconds->setEnabled(false);
    }

    tracksChanged(0);
    checkTimeAndLengthInfo(0);

    // that dialog is big enough, limit it to it's optimal size
    setFixedHeight(sizeHint().height());
    setFixedWidth(sizeHint().width());

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

Here is the call graph for this function:

~NewSignalDialog()

virtual Kwave::NewSignalDialog::~NewSignalDialog ( )

inlinevirtual

Destructor

Definition at line 54 of file NewSignalDialog.h.

References bitsPerSample(), byTime(), checkNewSampleEdit(), checkTimeAndLengthInfo(), invokeHelp(), maxSamples(), rate(), rbTimeToggled(), sampleRateChanged(), samples(), samplesChanged(), setHMS(), setLengthPercentage(), timeChanged(), tracks(), tracksChanged(), and updateFileSize().

{}

Here is the call graph for this function:

Member Function Documentation

bitsPerSample()

unsigned int Kwave::NewSignalDialog::bitsPerSample

(

)

Returns the selected resolution [bits per sample]

Definition at line 158 of file NewSignalDialog.cpp.

Referenced by maxSamples(), Kwave::NewSignalPlugin::setup(), timeChanged(), updateFileSize(), and ~NewSignalDialog().

{
    int res = sbResolution->value();
    if (res < 8) res = 8;
    return res;
}

Here is the caller graph for this function:

byTime()

bool Kwave::NewSignalDialog::byTime

(

)

Returns true if the selection was made by time

Definition at line 166 of file NewSignalDialog.cpp.

Referenced by Kwave::NewSignalPlugin::setup(), and ~NewSignalDialog().

{
    return rbTime->isChecked();
}

Here is the caller graph for this function:

checkNewSampleEdit

void Kwave::NewSignalDialog::checkNewSampleEdit ( )

privateslot

Checks for modifications of the sample number edit. That stupid QSpinBox doesn't notify us about changes :-[

Definition at line 142 of file NewSignalDialog.cpp.

References samplesChanged().

Referenced by NewSignalDialog(), and ~NewSignalDialog().

{
    static int last_samples = -1;
    if (edSamples->value() != last_samples) {
        last_samples = edSamples->value();
        samplesChanged(last_samples);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

checkTimeAndLengthInfo

void Kwave::NewSignalDialog::checkTimeAndLengthInfo ( int  )

privateslot

Checks for changes in the samples or time info

Definition at line 199 of file NewSignalDialog.cpp.

References samplesChanged(), and timeChanged().

Referenced by NewSignalDialog(), sampleRateChanged(), tracksChanged(), and ~NewSignalDialog().

{
    (rbTime->isChecked()) ? timeChanged(0) : samplesChanged(0);
}

Here is the call graph for this function:

Here is the caller graph for this function:

invokeHelp

void Kwave::NewSignalDialog::invokeHelp ( )

privateslot

invoke the online help

Definition at line 373 of file NewSignalDialog.cpp.

References _.

Referenced by NewSignalDialog(), and ~NewSignalDialog().

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

Here is the caller graph for this function:

maxSamples()

sample_index_t Kwave::NewSignalDialog::maxSamples ( )

private

Returns the maximum number of samples per track that can be created with the current settings, based on the maximum file size of a .wav file and the header sizes.

Definition at line 172 of file NewSignalDialog.cpp.

References bitsPerSample(), and tracks().

Referenced by samplesChanged(), setHMS(), setLengthPercentage(), timeChanged(), and ~NewSignalDialog().

{
    unsigned int bytes_per_sample = bitsPerSample() >> 3;

    /*
     * NOTE: this limitation to INT_MAX instead of UINT_MAX is
     *       only needed because some gui elements like
     *       QSpinBox cannot handle more :-(
     */
    const sample_index_t max_file_size = INT_MAX;

    return (max_file_size / tracks() / bytes_per_sample);
}

Here is the call graph for this function:

Here is the caller graph for this function:

rate()

double Kwave::NewSignalDialog::rate

(

)

Returns the selected sample rate [samples/second]

Definition at line 133 of file NewSignalDialog.cpp.

Referenced by setHMS(), setLengthPercentage(), Kwave::NewSignalPlugin::setup(), timeChanged(), and ~NewSignalDialog().

{
    bool ok;
    double r = cbSampleRate->currentText().toDouble(&ok);
    if (!ok) r = 0;
    return r;
}

Here is the caller graph for this function:

rbTimeToggled

void Kwave::NewSignalDialog::rbTimeToggled ( bool  )

privateslot

starts/stops the sample edit's timer if rbTime has been toggled

Definition at line 187 of file NewSignalDialog.cpp.

References m_timer.

Referenced by NewSignalDialog(), and ~NewSignalDialog().

{
    if (rbTime->isChecked()) {
        m_timer.stop();
    } else {
        // activate the sample edit timer
        m_timer.setSingleShot(false);
        m_timer.start(100);
    }
}

Here is the caller graph for this function:

sampleRateChanged

void Kwave::NewSignalDialog::sampleRateChanged ( const QString &  )

privateslot

called when the sample rate has been edited or changed

Definition at line 290 of file NewSignalDialog.cpp.

References checkTimeAndLengthInfo().

Referenced by NewSignalDialog(), and ~NewSignalDialog().

{
    checkTimeAndLengthInfo(0);
}

Here is the call graph for this function:

Here is the caller graph for this function:

samples()

sample_index_t Kwave::NewSignalDialog::samples

(

)

Returns the number of samples

Definition at line 127 of file NewSignalDialog.cpp.

Referenced by samplesChanged(), setLengthPercentage(), Kwave::NewSignalPlugin::setup(), timeChanged(), updateFileSize(), and ~NewSignalDialog().

{
    return static_cast<sample_index_t>(edSamples->value());
}

Here is the caller graph for this function:

samplesChanged

void Kwave::NewSignalDialog::samplesChanged ( int  )

privateslot

number of samples changed

Definition at line 266 of file NewSignalDialog.cpp.

References m_recursive, maxSamples(), samples(), setHMS(), Kwave::toInt(), and updateFileSize().

Referenced by checkNewSampleEdit(), checkTimeAndLengthInfo(), NewSignalDialog(), and ~NewSignalDialog().

{
    if (m_recursive) return; // don't do recursive processing
    if (!rbSamples->isChecked()) return;
    m_recursive = true;

    sample_index_t samples = edSamples->value();
    sample_index_t max_samples = maxSamples();

    if (samples > max_samples) {
        samples = max_samples;
        edSamples->setValue(Kwave::toInt(samples));
    }

    // update the other controls
    setHMS(samples);
    slideLength->setValue(Kwave::toInt(100.0 * samples / max_samples));
    updateFileSize();
    buttonBox->button(QDialogButtonBox::Ok)->setEnabled(samples > 0.0);

    m_recursive = false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

setHMS()

void Kwave::NewSignalDialog::setHMS ( sample_index_t &  samples )

private

Sets hours, minutes and seconds according to a given number of samples.

Definition at line 354 of file NewSignalDialog.cpp.

References maxSamples(), rate(), and Kwave::toInt().

Referenced by NewSignalDialog(), samplesChanged(), setLengthPercentage(), timeChanged(), and ~NewSignalDialog().

{
    double rate = this->rate();
    if (rate <= 0.0) return;

    // TODO: support for 64 bit
    if (samples > maxSamples()) samples = maxSamples();

    int total_sec = Kwave::toInt(ceil(samples / rate));
    int hours   = total_sec / (60*60);
    int minutes = (total_sec / 60) % 60;
    int seconds = total_sec % 60;

    sbHours->setValue(hours);
    sbMinutes->setValue(minutes);
    sbSeconds->setValue(seconds);
}

Here is the call graph for this function:

Here is the caller graph for this function:

setLengthPercentage

void Kwave::NewSignalDialog::setLengthPercentage ( int  percent )

privateslot

called if the slider for the length has been moved

Definition at line 335 of file NewSignalDialog.cpp.

References m_recursive, maxSamples(), rate(), samples(), setHMS(), Kwave::toInt(), and updateFileSize().

Referenced by NewSignalDialog(), and ~NewSignalDialog().

{
    if (m_recursive) return; // don't do recursive processing
    if (rate() <= 0) return;
    m_recursive = true;

    sample_index_t samples = static_cast<sample_index_t>(maxSamples() *
        static_cast<double>(percent) / 100.0);

    // update the other controls
    setHMS(samples);
    edSamples->setValue(Kwave::toInt(samples));
    updateFileSize();
    buttonBox->button(QDialogButtonBox::Ok)->setEnabled(samples > 0);

    m_recursive = false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

timeChanged

void Kwave::NewSignalDialog::timeChanged ( int  )

privateslot

updates the number of samples if the time changed

Definition at line 205 of file NewSignalDialog.cpp.

References bitsPerSample(), m_recursive, maxSamples(), rate(), samples(), setHMS(), Kwave::toInt(), tracks(), and updateFileSize().

Referenced by checkTimeAndLengthInfo(), NewSignalDialog(), and ~NewSignalDialog().

{
    if (m_recursive) return; // don't do recursive processing
    if (!rbTime->isChecked()) return;
    if ((rate() <= 0) || !tracks() || (bitsPerSample() < 8)) return;
    m_recursive = true;

    // get current time and correct wrap-overs
    int seconds = sbSeconds->value();
    int minutes = sbMinutes->value();
    int hours = sbHours->value();
    if ((seconds < 0) && ((minutes > 0) || (hours > 0)) ) {
        sbSeconds->setValue(59);
        sbMinutes->stepDown();
        minutes--;
    } else if (seconds < 0) {
        sbSeconds->setValue(0);
    } else if (seconds > 59) {
        sbSeconds->setValue(0);
        sbMinutes->stepUp();
        minutes++;
    }

    if ((minutes < 0) && (hours > 0)) {
        sbMinutes->setValue(59);
        sbHours->stepDown();
        hours--;
    } else if (minutes < 0) {
        sbMinutes->setValue(0);
    } else if (minutes > 59) {
        sbMinutes->setValue(0);
        sbHours->stepUp();
        hours++;
    }
    seconds = sbSeconds->value();
    minutes = sbMinutes->value();
    hours = sbHours->value();
    minutes += 60 * hours;
    seconds += 60 * minutes;

    // limit the current number of samples
    sample_index_t max_samples = maxSamples();
    sample_index_t samples     = static_cast<sample_index_t>(ceil(
        static_cast<double>(seconds) * rate()));

    if (samples > max_samples) {
        // wrap down to the maximum allowed number of samples
        samples =  max_samples;
        setHMS(samples);
    }

    // update the other controls
    edSamples->setValue(Kwave::toInt(samples));
    slideLength->setValue(Kwave::toInt(100.0 * samples / max_samples));
    updateFileSize();
    buttonBox->button(QDialogButtonBox::Ok)->setEnabled(samples > 0.0);

    m_recursive = false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

tracks()

unsigned int Kwave::NewSignalDialog::tracks

(

)

Returns the selected number of tracks

Definition at line 152 of file NewSignalDialog.cpp.

Referenced by maxSamples(), Kwave::NewSignalPlugin::setup(), timeChanged(), tracksChanged(), updateFileSize(), and ~NewSignalDialog().

{
    return sbChannels->value();
}

Here is the caller graph for this function:

tracksChanged

void Kwave::NewSignalDialog::tracksChanged ( int  )

privateslot

called when the sample rate has been changed

Definition at line 296 of file NewSignalDialog.cpp.

References _, checkTimeAndLengthInfo(), and tracks().

Referenced by NewSignalDialog(), and ~NewSignalDialog().

{
    switch (tracks()) {
        case 1:
            lblTracksVerbose->setText(i18n("(Mono)"));
            break;
        case 2:
            lblTracksVerbose->setText(i18n("(Stereo)"));
            break;
        case 4:
            lblTracksVerbose->setText(i18n("(Quadro)"));
            break;
        default:
            lblTracksVerbose->setText(_(""));
            break;
    }
    checkTimeAndLengthInfo(0);
}

Here is the call graph for this function:

Here is the caller graph for this function:

updateFileSize

void Kwave::NewSignalDialog::updateFileSize ( )

privateslot

updates the file size

Definition at line 316 of file NewSignalDialog.cpp.

References bitsPerSample(), samples(), and tracks().

Referenced by samplesChanged(), setLengthPercentage(), timeChanged(), and ~NewSignalDialog().

{
    double samples = static_cast<double>(edSamples->value());
    double mbytes = samples * static_cast<double>(tracks()) *
                    static_cast<double>(bitsPerSample() >> 3);
    mbytes /= 1024.0; // to kilobytes
    mbytes /= 1024.0; // to megabytes

    QString str_bytes;
    if (mbytes >= 10.0) {
        str_bytes.sprintf("%0.1f", mbytes);
    } else {
        str_bytes.sprintf("%0.3f", mbytes);
    }

    lblFileSize->setText(i18n("(Resulting file size: %1 MB)", str_bytes));
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

m_recursive

bool Kwave::NewSignalDialog::m_recursive

private

flag to avoid recursion

Definition at line 127 of file NewSignalDialog.h.

Referenced by samplesChanged(), setLengthPercentage(), and timeChanged().

m_timer

QTimer Kwave::NewSignalDialog::m_timer

private

Timer that checks for changes in the sample edit field

Definition at line 124 of file NewSignalDialog.h.

Referenced by NewSignalDialog(), and rbTimeToggled().

---

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

• plugins/newsignal/NewSignalDialog.h
• plugins/newsignal/NewSignalDialog.cpp