QAudioFormat Class

Dokumentation der Member-Funktionen

[implicit] QAudioFormat::QAudioFormat()

Erstellt ein neues Audioformat.

Die Werte werden wie folgt initialisiert:

• sampleRate() = 0
• channelCount() = 0
• sampleFormat() = QAudioFormat::Unknown

[implicit] QAudioFormat::QAudioFormat(const QAudioFormat &other)

Erstellen Sie ein neues Audioformat mithilfe von „ other “.

[noexcept implicit] QAudioFormat::~QAudioFormat()

Lösche dieses Audioformat.

qint32 QAudioFormat::bytesForDuration(qint64 microseconds) const

Gibt die Anzahl der Bytes zurück, die für dieses Audioformat für „ microseconds “ benötigt werden.

Gibt 0 zurück, wenn dieses Format ungültig ist.

Beachten Sie, dass es zu Rundungen kommen kann, wenn „ microseconds “ kein exakter Bruchteil von „ sampleRate()“ ist.

Siehe auch durationForBytes().

qint32 QAudioFormat::bytesForFrames(qint32 frameCount) const

Gibt die Anzahl der Bytes zurück, die für „ frameCount “-Frames dieses Formats benötigt werden.

Gibt 0 zurück, wenn dieses Format ungültig ist.

Siehe auch ` bytesForDuration()`.

[constexpr] int QAudioFormat::bytesPerFrame() const

Gibt die Anzahl der Bytes zurück, die zur Darstellung eines Frames (eines Samples in jedem Kanal) in diesem Format erforderlich sind.

Gibt 0 zurück, wenn dieses Format ungültig ist.

[constexpr noexcept] int QAudioFormat::bytesPerSample() const

Gibt die Anzahl der Bytes zurück, die zur Darstellung eines Samples in diesem Format erforderlich sind.

Gibt 0 zurück, wenn dieses Format ungültig ist.

[constexpr noexcept] QAudioFormat::ChannelConfig QAudioFormat::channelConfig() const

Gibt die aktuelle Kanalkonfiguration zurück.

Siehe auch „ setChannelConfig()“.

[static constexpr] template <typename... Args> QAudioFormat::ChannelConfig QAudioFormat::channelConfig(Args... channels)

Gibt die aktuelle Kanalkonfiguration für die angegebene „ channels “ zurück.

[constexpr noexcept] int QAudioFormat::channelCount() const

Gibt den aktuellen Wert für die Kanalanzahl zurück.

Siehe auch „ setChannelCount()“.

[noexcept] int QAudioFormat::channelOffset(QAudioFormat::AudioChannelPosition channel) const

Gibt die Position eines bestimmten Audio channel s innerhalb eines Audioframes für das angegebene Format zurück. Gibt -1 zurück, wenn der Kanal für dieses Format nicht vorhanden ist oder die Kanalkonfiguration unbekannt ist.

[static] QAudioFormat::ChannelConfig QAudioFormat::defaultChannelConfigForChannelCount(int channelCount)

Gibt eine Standard-Kanalkonfiguration für „ channelCount “ zurück.

Standardkonfigurationen sind für bis zu 8 Kanäle definiert und entsprechen den Standardkonfigurationen für Mono, Stereo und Surround. Bei einer höheren Kanalanzahl werden einfach die ersten in „ QAudioFormat::AudioChannelPosition “ definierten „ channelCount “-Audiokanäle verwendet.

qint64 QAudioFormat::durationForBytes(qint32 bytes) const

Gibt die Anzahl der Mikrosekunden zurück, die durch „ bytes “ in diesem Format dargestellt werden.

Gibt 0 zurück, wenn dieses Format ungültig ist.

Beachten Sie, dass es zu Rundungen kommen kann, wenn „ bytes “ kein exaktes Vielfaches der Anzahl der Bytes pro Frame ist.

Siehe auch bytesForDuration().

qint64 QAudioFormat::durationForFrames(qint32 frameCount) const

Gibt die Anzahl der Mikrosekunden zurück, die durch „ frameCount “-Frames in diesem Format dargestellt werden.

qint32 QAudioFormat::framesForBytes(qint32 byteCount) const

Gibt die Anzahl der Frames zurück, die durch „ byteCount “ in diesem Format dargestellt werden.

Beachten Sie, dass es zu Rundungsabweichungen kommen kann, wenn „ byteCount “ kein exaktes Vielfaches der Anzahl der Bytes pro Frame ist.

Jeder Frame enthält einen Sample pro Kanal.

Siehe auch framesForDuration().

qint32 QAudioFormat::framesForDuration(qint64 microseconds) const

Gibt die Anzahl der Frames zurück, die zur Darstellung von microseconds in diesem Format erforderlich sind.

Beachten Sie, dass es zu Rundungen kommen kann, wenn „ microseconds “ kein exakter Bruchteil von „ sampleRate “ () ist.

[constexpr noexcept] bool QAudioFormat::isValid() const

Gibt „ true “ zurück, wenn alle Parameter gültig sind.

float QAudioFormat::normalizedSampleValue(const void *sample) const

Normalisiert den Wert von „ sample “ auf einen Wert zwischen -1 und 1. Die Vorgehensweise hängt vom jeweiligen QaudioFormat ab.

[constexpr noexcept] QAudioFormat::SampleFormat QAudioFormat::sampleFormat() const

Gibt das aktuelle Sample-Format zurück.

Siehe auch „ setSampleFormat()“.

[constexpr noexcept] int QAudioFormat::sampleRate() const

Gibt die aktuelle Abtastrate in Hertz zurück.

Siehe auch „ setSampleRate()“.

[noexcept] void QAudioFormat::setChannelConfig(QAudioFormat::ChannelConfig config)

Stellt die Kanalkonfiguration auf „ config “ ein.

Stellt die Kanalkonfiguration des Audioformats auf eine der Standard-Audiokanalkonfigurationen ein.

Siehe auch „ channelConfig()“.

[constexpr noexcept] void QAudioFormat::setChannelCount(int channels)

Legt die Anzahl der Kanäle auf channels fest. Durch diese Einstellung wird auch die Kanalkonfiguration auf ChannelConfigUnknown festgelegt.

Siehe auch channelCount().

[constexpr noexcept] void QAudioFormat::setSampleFormat(QAudioFormat::SampleFormat format)

Legt das Sample-Format auf „ format “ fest.

Siehe auch „ sampleFormat()“ und „ QAudioFormat::SampleFormat “.

[constexpr noexcept] void QAudioFormat::setSampleRate(int samplerate)

Stellt die Abtastrate auf samplerate in Hertz ein.

Siehe auch sampleRate().