CriAtomDbasConfigTag 構造体

D-BAS作成パラメーター構造体 [詳解]

#include <cri_atom.h>

フィールド
CriUint32	identifier
	D-BAS 識別子 [詳解]
CriSint32	max_streams
	最大ストリーミング数 [詳解]
CriSint32	max_bps
	最大ビットレート [詳解]
CriSint32	max_mana_streams
	CRI Mana側で再生する最大ストリーミング数 [詳解]
CriSint32	max_mana_bps
	CRI Mana側で再生する最大ビットレート [詳解]
CriSint32	num_securement_buffers
	１ストリームに割り当てる最低保証バッファー数 [詳解]

詳解

D-BAS作成パラメーター構造体

説明:

criAtomDbas_Create 関数の引数に指定する、D-BASの作成パラメーター構造体です。

注意

将来的にメンバが増える可能性があるため、 criAtomDbas_SetDefaultConfig マクロを使用しない場合には、使用前に必ず構造体をゼロクリアしてください。
（構造体のメンバに不定値が入らないようご注意ください。）

参照

criAtomDbas_Create, criAtomDbas_CalculateWorkSize, criAtomDbas_SetDefaultConfig

フィールド詳解

identifier

CriUint32 identifier

D-BAS 識別子

説明:

アプリケーション側がD-BASを作成する際に指定する識別子です。
アプリケーション側がどのD-BASを使うか明示的に指定する際に使用します。
D-BAS 識別子

max_streams

CriSint32 max_streams

最大ストリーミング数

説明:

D-BASで管理する瞬間最大ストリーミング本数を指定します。
オーディオだけでなく、Sofdec2で再生するムービーデータのストリーミング本数も加味する必要があります。
例えば、シーンAではオーディオデータを２本、 シーンBではオーディオデータを１本とムービーデータを２本、ストリーミング再生するとします。
この場合、瞬間最大ストリーミング本数はシーンBの３本を設定してください。
つまり、アプリケーション全体を通して、最悪状態のストリーミング本数を想定した値を設定してください。

max_bps

CriSint32 max_bps

最大ビットレート

説明:

ストリーミング全体における瞬間最大ビットレートを指定します。
この値には、アプリケーション全体を通して、 ストリーミング再生するデータの消費ビットレートのピーク値を設定してください。
オーディオだけでなく、Sofdec2で再生するムービーデータの消費ビットレートも加味する必要があります。
例えば、シーンAではオーディオデータを４本、シーンBではムービーデータを１本、ストリーミング再生するとします。
この時、オーディオデータ４本分の消費ビットレートよりもムービーデータ１本の消費ビットレートが大きい場合、
ムービーデータの消費ビットレートを設定してください。
つまり、アプリケーション全体を通して、最悪状態の消費ビットレートを想定した値を設定してください。

max_mana_streams

CriSint32 max_mana_streams

CRI Mana側で再生する最大ストリーミング数

説明:

CRI Mana側で再生する瞬間最大ストリーミング本数を指定します。
D-BASのメモリ使用量の計算では、max_streams からこの値を減じたストリーミング本数を、
CRI Atomの最大ストリーミング本数として扱います。
CRI Mana側でストリーミング再生を行わない場合は 0 に設定してください。

max_mana_bps

CriSint32 max_mana_bps

CRI Mana側で再生する最大ビットレート

説明:

CRI Mana側で再生する瞬間最大ビットレートを指定します。
D-BASのメモリ使用量の計算では、max_bps からこの値を減じたビットレートを、
CRI Atomの最大ビットレートとして扱います。
CRI Mana側でストリーミング再生を行わない場合は 0 に設定してください。

num_securement_buffers

CriSint32 num_securement_buffers

１ストリームに割り当てる最低保証バッファー数

説明:

１ストリームに割り当てる最低保証バッファー数を指定します。単位は[個]です。
ADX内部ではバッファーをブロック単位で管理しているため、 ファイル終端やループ先頭等の半端なデータサイズに対しても、 バッファーブロックを１つ分割り当てます。
ワンショットのストリーミング再生では、 ダブルバッファリングでデータを読むだけの単純な処理であっても、 ストリームが途切れる事はありません。
一方、ループ付きデータの場合では、ループ終端のわずかなデータに１ブロック、 ループ先頭のわずかなデータにも１ブロックを使ってしまうと、
バッファリング済みのデータが極端に少ないにもかかわらず、 次のデータを読み込むバッファーが空かないためストリームが途切れてしまいます。
本パラメーターは、D-BASが確保するストリーミングバッファーサイズに影響を与えます。
音が途切れない事を十分に確認できていれば、 本パラメーターの下限値は CRIATOMDBAS_MINIMUM_NUM_SECUREMENT_BUFFERS です。

---

この構造体詳解は次のファイルから抽出されました:

• cri_atom.h