Kwave::MultiPlaybackSink Class Reference

#include <MultiPlaybackSink.h>

Inheritance diagram for Kwave::MultiPlaybackSink:

Collaboration diagram for Kwave::MultiPlaybackSink:

Public Member Functions
	MultiPlaybackSink (unsigned int tracks, Kwave::PlayBackDevice *device)
virtual	~MultiPlaybackSink ()
Public Member Functions inherited from Kwave::MultiTrackSink< Kwave::PlaybackSink, false >
	MultiTrackSink (unsigned int tracks, QObject *parent=Q_NULLPTR)
virtual	~MultiTrackSink () Q_DECL_OVERRIDE
virtual bool	done () const Q_DECL_OVERRIDE
virtual unsigned int	tracks () const Q_DECL_OVERRIDE
virtual Kwave::PlaybackSink *	at (unsigned int track) const
virtual Kwave::PlaybackSink *	operator[] (unsigned int track) Q_DECL_OVERRIDE
virtual bool	insert (unsigned int track, Kwave::PlaybackSink *sink)
virtual void	clear ()
Public Member Functions inherited from Kwave::SampleSink
	SampleSink (QObject *parent=Q_NULLPTR)
virtual	~SampleSink ()
Public Member Functions inherited from Kwave::StreamObject
	StreamObject (QObject *parent=Q_NULLPTR)
virtual	~StreamObject ()
virtual unsigned int	tracksOfPort (const char *port) const
virtual Kwave::StreamObject *	port (const char *port, unsigned int track)
virtual unsigned int	blockSize () const
void	setAttribute (const char *attribute, const QVariant &value)

Private Slots
void	input (unsigned int track, Kwave::SampleArray data)

Private Attributes
unsigned int	m_tracks
Kwave::PlayBackDevice *	m_device
QVector< Kwave::SampleArray >	m_in_buffer
QBitArray	m_in_buffer_filled
Kwave::SampleArray	m_out_buffer
QMutex	m_lock

Additional Inherited Members
Signals inherited from Kwave::StreamObject
void	attributeChanged (const QVariant value)
Static Public Member Functions inherited from Kwave::StreamObject
static void	setInteractive (bool interactive)

Detailed Description

Definition at line 36 of file MultiPlaybackSink.h.

Constructor & Destructor Documentation

MultiPlaybackSink()

Kwave::MultiPlaybackSink::MultiPlaybackSink	(	unsigned int	tracks,
		Kwave::PlayBackDevice *	device
	)

Constructor

Parameters

tracks	number of tracks for playback
device	a PlayBackDevice

Definition at line 31 of file MultiPlaybackSink.cpp.

References Kwave::connect(), input(), Kwave::MultiTrackSink< Kwave::PlaybackSink, false >::insert(), m_in_buffer, m_in_buffer_filled, and m_tracks.

    :Kwave::MultiTrackSink<Kwave::PlaybackSink, false>(0),
     m_tracks(tracks), m_device(device), m_in_buffer(tracks),
     m_in_buffer_filled(tracks),
     m_out_buffer(tracks), m_lock()
{
    m_in_buffer.fill(Kwave::SampleArray(0));
    m_in_buffer_filled.fill(false);

    for (unsigned int track = 0; track < m_tracks; track++) {
        // allocate a sink
        Kwave::PlaybackSink *sink =
            new(std::nothrow) Kwave::PlaybackSink(track);
        insert(track, sink);
        connect(sink, SIGNAL(output(uint,Kwave::SampleArray)),
                this, SLOT(input(uint,Kwave::SampleArray)),
                Qt::DirectConnection);
    }
}

Here is the call graph for this function:

~MultiPlaybackSink()

Kwave::MultiPlaybackSink::~MultiPlaybackSink ( )

virtual

Destructor

Definition at line 53 of file MultiPlaybackSink.cpp.

References Kwave::MultiTrackSink< Kwave::PlaybackSink, false >::clear(), Kwave::PlayBackDevice::close(), m_device, and m_in_buffer.

{
    // close all stream objects
    clear();

    // close the device
    if (m_device) {
        m_device->close();
        delete m_device;
    }
    m_device = Q_NULLPTR;

    // discard the buffers
    while (!m_in_buffer.isEmpty())
        m_in_buffer.erase(m_in_buffer.end() - 1);
    m_in_buffer.clear();
}

Here is the call graph for this function:

Member Function Documentation

input

void Kwave::MultiPlaybackSink::input ( unsigned int  track, Kwave::SampleArray  data  )

privateslot

receives data from one of the tracks

Parameters

track	index of the track [0...tracks-1]
data	sample data for the given track

Definition at line 72 of file MultiPlaybackSink.cpp.

References m_device, m_in_buffer, m_in_buffer_filled, m_lock, m_out_buffer, m_tracks, Kwave::SampleArray::size(), and Kwave::PlayBackDevice::write().

Referenced by MultiPlaybackSink().

{
    QMutexLocker lock(&m_lock);

    Q_ASSERT(m_device);
    Q_ASSERT(m_tracks);
    if (!m_device || !m_tracks) return;

    Q_ASSERT(!m_in_buffer_filled[track]);
    m_in_buffer_filled[track] = true;

    // copy the input data to the buffer
    unsigned int samples = data.size();
    m_in_buffer[track] = data;

    // check if all buffers are filled
    for (unsigned int t = 0; t < m_tracks; t++)
        if (!m_in_buffer_filled[t]) return;

    // all tracks have left their data, now we are ready
    // to convert the buffers into a big combined one
    Q_ASSERT(m_out_buffer.size() >= m_tracks);
    for (unsigned int sample = 0; sample < samples; sample++) {
        for (unsigned int t = 0; t < m_tracks; t++) {
            const Kwave::SampleArray &in = m_in_buffer[t];
            m_out_buffer[t] = in[sample];
        }

        // play the output buffer
        m_device->write(m_out_buffer);
    }

    m_in_buffer_filled.fill(false);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

m_device

Kwave::PlayBackDevice* Kwave::MultiPlaybackSink::m_device

private

device used for playback

Definition at line 66 of file MultiPlaybackSink.h.

Referenced by input(), and ~MultiPlaybackSink().

m_in_buffer

QVector< Kwave::SampleArray > Kwave::MultiPlaybackSink::m_in_buffer

private

list of input buffers

Definition at line 69 of file MultiPlaybackSink.h.

Referenced by input(), MultiPlaybackSink(), and ~MultiPlaybackSink().

m_in_buffer_filled

QBitArray Kwave::MultiPlaybackSink::m_in_buffer_filled

private

"filled"-flags for input buffers

Definition at line 72 of file MultiPlaybackSink.h.

Referenced by input(), and MultiPlaybackSink().

m_lock

QMutex Kwave::MultiPlaybackSink::m_lock

private

mutex for locking against reentrance

Definition at line 78 of file MultiPlaybackSink.h.

Referenced by input().

m_out_buffer

Kwave::SampleArray Kwave::MultiPlaybackSink::m_out_buffer

private

output buffer for all samples

Definition at line 75 of file MultiPlaybackSink.h.

Referenced by input().

m_tracks

unsigned int Kwave::MultiPlaybackSink::m_tracks

private

number of tracks

Definition at line 63 of file MultiPlaybackSink.h.

Referenced by input(), and MultiPlaybackSink().

---

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

• libkwave/MultiPlaybackSink.h
• libkwave/MultiPlaybackSink.cpp