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 を返す。

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

[noexcept] qsizetype QAudioBuffer::frameCount() const

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

オーディオフレームとは、各チャンネルに1サンプルずつ、同じ時刻にインターリーブされたセットのことである。

[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 バッファをこのバッファに割り当てます。