Qt 5.7 | Qt Multimedia | C++ Classes | StereoFrame

Qt 5.7.1 Reference Documentation

# StereoFrame Class

(QAudioBuffer::StereoFrame)

The StereoFrame class provides a simple wrapper for a stereo audio frame. More...

Header: | #include <StereoFrame>
qmake: | QT += multimedia

- List of all members, including inherited members

## Public Functions

| StereoFrame()
| StereoFrame(T leftSample, T rightSample)
T | average() const
void | clear()
StereoFrame & | operator=(const StereoFrame &other)

## Public Variables

T | left
T | right

## Related Non-Members

typedef | S16S
typedef | S16U
typedef | S32F
typedef | S8S
typedef | S8U

## Detailed Description

The StereoFrame class provides a simple wrapper for a stereo audio frame.

This templatized structure lets you treat a block of individual samples as an interleaved stereo stream frame. This is most useful when used with the templatized data() functions of QAudioBuffer. Generally the data is accessed as a pointer, so no copying should occur.

There are some predefined instantiations of this template for working with common stereo sample depths in a convenient way.

This frame structure has left and right members for accessing individual channel data.

For example:

      // Assuming 'buffer' is an unsigned 16 bit stereo buffer..
      QAudioBuffer::S16U *frames = buffer->data<QAudioBuffer::S16U>();
      for (int i=0; i < buffer->frameCount(); i++) {
          qSwap(frames[i].left, frames[i].right);
      }

See also QAudioBuffer::S8U, QAudioBuffer::S8S, QAudioBuffer::S16S, QAudioBuffer::S16U, and QAudioBuffer::S32F.

## Member Function Documentation

### StereoFrame::StereoFrame()

Constructs a new frame with the "silent" value for this sample format (0 for signed formats and floats, 0x8* for unsigned formats).

### StereoFrame::StereoFrame(T leftSample, T rightSample)

Constructs a new frame with the supplied leftSample and rightSample values.

### T StereoFrame::average() const

Returns the arithmetic average of the left and right samples.

### void StereoFrame::clear()

Sets the values of this frame to the "silent" value.

### StereoFrame &StereoFrame::operator=(const StereoFrame &other)

Assigns other to this frame.

## Member Variable Documentation

### T StereoFrame::left

This variable holds the left sample.

### T StereoFrame::right

This variable holds the right sample.

## Related Non-Members

### typedef QAudioBuffer::S16S

This is a predefined specialization for a signed stereo 16 bit sample. Each channel is a signed short.

### typedef QAudioBuffer::S16U

This is a predefined specialization for an unsigned stereo 16 bit sample. Each channel is an unsigned short.

### typedef QAudioBuffer::S32F

This is a predefined specialization for an 32 bit float sample. Each channel is a float.

### typedef QAudioBuffer::S8S

This is a predefined specialization for a signed stereo 8 bit sample. Each channel is a signed char.

### typedef QAudioBuffer::S8U

This is a predefined specialization for an unsigned stereo 8 bit sample. Each channel is an unsigned char.