CRI ADX  Last Updated: 2024-07-17 10:47 p
CriAtomDbasConfigTag Struct Reference

D-BAS creation parameter structure. More...

#include <cri_le_atom.h>

Data Fields

CriUint32 identifier
 D-BAS identifier. More...
 
CriSint32 max_streams
 Maximum number of streaming. More...
 
CriSint32 max_bps
 Maximum bit rate. More...
 
CriSint32 max_mana_streams
 Maximum number of streams played back by CRI Mana. More...
 
CriSint32 max_mana_bps
 Maximum bit rate for CRI Mana playback. More...
 
CriSint32 num_securement_buffers
 Minimum number of guaranteed buffers assigned to one stream. More...
 

Detailed Description

D-BAS creation parameter structure.

Description:
D-BAS creation parameter structure specified as argument of the criAtomDbas_Create function.

Attention
More members will be added in the future. So, when not using the criAtomDbas_SetDefaultConfig macro, make sure to initialize the structure to zero before using it.
(Make sure that no indefinite value is set to any member of the structure.)
See also
criAtomDbas_Create, criAtomDbas_CalculateWorkSize, criAtomDbas_SetDefaultConfig

Field Documentation

◆ identifier

CriUint32 identifier

D-BAS identifier.

Description:
Identifier specified by the application when creating a D-BAS.
It is used to explicitly specify the D-BAS used by the application.
D-BAS identifier

◆ max_streams

CriSint32 max_streams

Maximum number of streaming.

Description:
Specifies the instantaneous maximum number of streamings managed by D-BAS.
The number of movie data streams played back by Sofdec2 must also be considered in addition to audio.
For example, assume that scene A has two sources of audio data and scene B has one source of audio data and two sources of movie data for streaming playback.
In this case, set the instantaneous maximum number of streams to 3 as in scene B.
In other words, you must set the value that anticipates the worst possible state for the number of streams throughout the entire application.

◆ max_bps

CriSint32 max_bps

Maximum bit rate.

Description:
Specifies the instantaneous maximum bit rate for the entire streaming.
For this value, set the consumed bit rate peak value for streaming playback throughout the entire application.
The consumed bit rate for movie data played back by Sofdec2 must also be considered in addition to audio.
For example, assume that scene A has four sources of audio data and scene B has one source of movie data for streaming playback.
In this case, if the consumed bit rate for the one source of movie data is greater than that of the four sources of audio data,
you should set the consumed bit rate for the movie data.
In other words, you must set the value that anticipates the worst possible state for the consumed bit rate throughout the entire application.

◆ max_mana_streams

CriSint32 max_mana_streams

Maximum number of streams played back by CRI Mana.

Description:
Specifies the instantaneous maximum number of streams played back by CRI Mana.
In the memory usage calculations for D-BAS, this value is subtracted from max_streams
and the resulting value is considered the maximum number of CRI Atom streams.
Set this value to 0 if not performing any CRI Mana streaming playback.

◆ max_mana_bps

CriSint32 max_mana_bps

Maximum bit rate for CRI Mana playback.

Description:
Specifies the instantaneous maximum bit rate for CRI Mana playback.
In the memory usage calculations for D-BAS, this value is subtracted from max_bps
and the resulting value is considered the maximum bit rate for CRI Atom.
Set this value to 0 if not performing any CRI Mana streaming playback.

◆ num_securement_buffers

CriSint32 num_securement_buffers

Minimum number of guaranteed buffers assigned to one stream.

Description:
Specifies the minimum number of guaranteed buffers assigned to one stream. Specify the number of buffers.
Because buffers are managed per block inside ADX2, one buffer block is assigned even to an odd data size, such as the end of a file and the beginning of a loop.
During one-shot streaming playback, streaming is not interrupted, even for a simple process of loading data with double buffering.
On the other hand, for data with loops, if one block is used for small data both at the end and the beginning of a loop,
streaming is interrupted in spite of very small buffered data, because no buffer is available for reading the next data.
This parameter affects the size of the streaming buffer allocated by D-BAS.
If it is sufficiently verified that no interruptions occur, the lower limit of this parameter is CRIATOMDBAS_MINIMUM_NUM_SECUREMENT_BUFFERS .

The documentation for this struct was generated from the following file: