QAudioBuffer Class

Dokumentation der Member-Funktionen

[noexcept] QAudioBuffer::QAudioBuffer()

Erstelle einen neuen, leeren, ungültigen Puffer.

QAudioBuffer::QAudioBuffer(const QByteArray &data, const QAudioFormat &format, qint64 startTime = -1)

Erstellt einen neuen Audio-Puffer aus dem übergebenen ` data` im angegebenen ` format`. Das Format bestimmt, wie die Anzahl und die Größe der Samples aus dem ` data` interpretiert werden.

Wenn die übergebene ` data ` kein ganzzahliges Vielfaches der berechneten Frame-Größe ist, werden die überschüssigen Daten nicht verwendet.

Dieser Audio-Puffer kopiert den Inhalt von data.

startTime (in Mikrosekunden) gibt an, an welcher Stelle im Stream dieser Puffer beginnt. Wenn dieser Puffer nicht Teil eines Streams ist, setzen Sie den Wert auf -1.

QAudioBuffer::QAudioBuffer(int numFrames, const QAudioFormat &format, qint64 startTime = -1)

Erstellt einen neuen Audiopuffer mit Platz für numFrames Frames des angegebenen Formats format. Die einzelnen Samples werden auf den Standardwert für das Format initialisiert.

startTime (in Mikrosekunden) gibt an, an welcher Stelle im Stream dieser Puffer beginnt. Wenn dieser Puffer nicht Teil eines Streams ist, setzen Sie diesen Wert auf -1.

[noexcept] QAudioBuffer::QAudioBuffer(const QAudioBuffer &other)

Erstellt einen neuen Audio-Puffer aus ` other`. Audio-Puffer werden explizit gemeinsam genutzt. Sie sollten die Funktion ` detach()` für den Puffer aufrufen, um eine Kopie zu erstellen, die anschließend geändert werden kann.

[constexpr noexcept default] QAudioBuffer::QAudioBuffer(QAudioBuffer &&other)

Erstellt einen QAudioBuffer, indem Daten aus „ other “ verschoben werden.

[noexcept] QAudioBuffer::~QAudioBuffer()

Löscht diesen Audio-Puffer.

[noexcept] qsizetype QAudioBuffer::byteCount() const

Gibt die Größe dieses Puffers in Byte zurück.

template <typename T> const T *QAudioBuffer::constData() const

Gibt einen Zeiger auf die Daten dieses Puffers zurück. Der Zugriff ist nur lesbar.

Diese Methode ist der const-Version von ` data()` vorzuziehen, um unnötiges Kopieren zu vermeiden.

Beachten Sie, dass das Format des Audio-Puffers nicht überprüft wird – es handelt sich hierbei lediglich um eine Komfortfunktion.

// With a 16bit sample buffer:
const quint16 *data = buffer->constData<quint16>();

template <typename T> T *QAudioBuffer::data()

Gibt einen Zeiger auf die Daten dieses Puffers zurück. Über den zurückgegebenen Zeiger können Sie die Daten ändern.

Da „ QAudioBuffer “-Objekte explizit gemeinsam genutzt werden, sollten Sie in der Regel „ detach()“ aufrufen, bevor Sie die Daten über diese Funktion ändern.

Beachten Sie, dass das Format des Audio-Puffers nicht überprüft wird – es handelt sich hierbei lediglich um eine Komfortfunktion.

// With a 16bit sample buffer:
quint16 *data = buffer->data<quint16>(); // May cause deep copy

template <typename T> const T *QAudioBuffer::data() const

Gibt einen Zeiger auf die Daten dieses Puffers zurück. Diese können nur gelesen werden.

Sie sollten stattdessen die Funktion ` constData()` verwenden, um ein versehentliches tiefes Kopieren zu vermeiden.

Beachten Sie, dass das Format des Audio-Puffers nicht überprüft wird – es handelt sich hierbei lediglich um eine Komfortfunktion.

// With a 16bit sample const buffer:
const quint16 *data = buffer->data<quint16>();

void QAudioBuffer::detach()

Trennt diesen Audiopuffer von anderen Kopien, die möglicherweise Daten mit ihm austauschen.

[noexcept] qint64 QAudioBuffer::duration() const

Gibt die Dauer der Audiodaten in diesem Puffer in Mikrosekunden zurück.

Dies hängt von den Funktionen ` format()` und ` frameCount()` ab.

[noexcept] QAudioFormat QAudioBuffer::format() const

Gibt den Wert „ format “ dieses Puffers zurück.

Mehrere Eigenschaften dieses Formats beeinflussen, wie die Werte „ duration()“ oder „ byteCount()“ aus „ frameCount()“ berechnet werden.

[noexcept] qsizetype QAudioBuffer::frameCount() const

Gibt die Anzahl der vollständigen Audio-Frames in diesem Puffer zurück.

Ein Audio-Frame ist eine verschachtelte Folge von jeweils einem Sample pro Kanal für denselben Zeitpunkt.

[noexcept] bool QAudioBuffer::isValid() const

Gibt „true“ zurück, wenn es sich um einen gültigen Puffer handelt. Ein gültiger Puffer enthält mehr als null Frames und hat ein gültiges Format.

[noexcept] qsizetype QAudioBuffer::sampleCount() const

Gibt die Anzahl der Samples in diesem Puffer zurück.

Wenn das Format dieses Puffers mehrere Kanäle umfasst, umfasst diese Anzahl alle Kanäle. Das bedeutet, dass ein Stereopuffer mit insgesamt 1000 Samples 500 linke und 500 rechte Samples (verschachtelt) enthält und diese Funktion den Wert 1000 zurückgibt.

Siehe auch „ frameCount“ ().

[noexcept] qint64 QAudioBuffer::startTime() const

Gibt den Zeitpunkt in einem Stream zurück, an dem dieser Puffer beginnt (in Mikrosekunden).

Wenn dieser Puffer nicht Teil eines Streams ist, wird -1 zurückgegeben.

[noexcept] void QAudioBuffer::swap(QAudioBuffer &other)

Tauscht den Audio-Puffer mit „ other “ aus.

[noexcept] QAudioBuffer &QAudioBuffer::operator=(QAudioBuffer &&other)

Verschiebt „ other “ in diesen Ordner: QAudioBuffer.

QAudioBuffer &QAudioBuffer::operator=(const QAudioBuffer &other)

Weist diesem den Puffer „ other “ zu.