QAudioBuffer Class

メンバー関数ドキュメント

[noexcept] QAudioBuffer::QAudioBuffer()

新しい、空の、無効なバッファを作成する。

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

与えられたformat で、与えられたdata から新しいオーディオバッファを作成する。フォーマットは、サンプルの数とサイズがdata からどのように解釈されるかを決定します。

与えられたdata が、計算されたフレームサイズの整数倍でない場合、余分なデータは使用されません。

このオーディオバッファはdata の内容をコピーします。

startTime (マイクロ秒単位) は、このバッファがストリーム内で開始するタイミングを示します。このバッファがストリームの一部でない場合は、-1 を設定します。

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

与えられたformat のnumFrames フレーム分のスペースを持つ新しいオーディオバッファを作成します。個々のサンプルは、そのフォーマットのデフォルト値に初期化されます。

startTime (マイクロ秒単位) は、このバッファがストリーム内で開始するタイミングを示します。このバッファがストリームの一部でない場合は、-1 を設定します。

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

other から新しいオーディオバッファを作成します。オーディオバッファは明示的に共有されるため、バッファに対してdetach() を呼び出してコピーを作成し、それを変更できるようにする必要があります。

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

other から移動して QAudioBuffer を構築します。

[noexcept] QAudioBuffer::~QAudioBuffer()

このオーディオバッファを破棄する。

[noexcept] qsizetype QAudioBuffer::byteCount() const

このバッファのサイズをバイト数で返します。

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

このバッファのデータへのポインタを返します。読み込むことしかできない。

このメソッドは、不要なコピーを防ぐために、data() の const バージョンよりも推奨されます。

オーディオバッファのフォーマットチェックは行われないことに注意してください - これは単に便利な関数です。

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

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

このバッファのデータへのポインタを返します。返されたポインタを通してデータを変更することができる。

QAudioBuffer オブジェクトは明示的に共有されるため、通常はこの関数を通してデータを変更する前にdetach() を呼び出す必要があります。

オーディオバッファのフォーマットはチェックされないことに注意してください - これは単に便利な関数です。

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

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

このバッファのデータへのポインタを返します。読み込むことしかできません。

偶発的なディープコピーを防ぐため、この関数ではなくconstData() 関数を使用する必要があります。

オーディオバッファのフォーマットチェックは行われないことに注意してください - これは単に便利な関数です。

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

void QAudioBuffer::detach()

このオーディオバッファとデータを共有する可能性のある他のコピーから、このオーディオバッファを切り離す。

[noexcept] qint64 QAudioBuffer::duration() const

このバッファ内のオーディオの継続時間をマイクロ秒単位で返す。

これはformat() とframeCount() に依存する。

[noexcept] QAudioFormat QAudioBuffer::format() const

このバッファのformat を返す。

このフォーマットのいくつかの特性は、frameCount() からduration() やbyteCount() がどのように計算されるかに影響する。

[noexcept] qsizetype QAudioBuffer::frameCount() const

このバッファ内の完全なオーディオフレームの数を返します。

オーディオフレームとは、各チャンネルごとに同じ瞬間のサンプルをインターリーブしたものです。

[noexcept] bool QAudioBuffer::isValid() const

これが有効なバッファであれば真を返す。有効なバッファは、その中に0フレーム以上あり、有効なフォーマットを持っています。

[noexcept] qsizetype QAudioBuffer::sampleCount() const

このバッファ内のサンプル数を返す。

このバッファのフォーマットが複数のチャンネルを持つ場合、このカウントはすべてのチャンネルを含みます。つまり、合計1000サンプルのステレオバッファは、（インターリーブされた）左500サンプルと右500サンプルを持ち、この関数は1000を返します。

frameCount()も参照 。

[noexcept] qint64 QAudioBuffer::startTime() const

このバッファがストリーム内で開始する時刻を（マイクロ秒単位で）返します。

このバッファがストリームの一部でない場合は -1 を返す。

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

オーディオバッファをother と交換する。

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

other をこのQAudioBuffer に移動する。

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

other バッファをこれに割り当てる。