ループ情報を無視

強制ループ再生

不正なストリーミングキャッシュID値

説明:

criAtomStreamingCache_Create 関数に失敗した際に返る値です。

参照:

criAtomStreamingCache_Create, criAtomStreamingCache_Destroy

ストリーミングキャッシュにキャッシュするファイル数のデフォルト値

説明:

ストリーミングキャッシュ作成用のデフォルト初期化パラメータ値定義です。
キャッシュ可能なファイル数を指定します。
デフォルト値は10ファイル分です。

参照:

CriAtomStreamingCacheUnitConfig

ストリーミングキャッシュにキャッシュするファイルサイズのデフォルト値

説明:

ストリーミングキャッシュ作成用のデフォルト初期化パラメータ値定義です。
キャッシュ可能なファイルサイズを byte単位で指定します。
デフォルト値は 1 MB です。

参照:

CriAtomStreamingCacheUnitConfig

{\
    (p_config)->server_frequency = 60.0f;\
    (p_config)->num_mixers = 1;\
    (p_config)->max_players = 16;\
    (p_config)->max_input_channels = CRIATOM_DEFAULT_INPUT_MAX_CHANNELS;\
    (p_config)->max_sampling_rate = CRIATOM_DEFAULT_OUTPUT_SAMPLING_RATE;\
    (p_config)->output_channels = CRIATOM_DEFAULT_OUTPUT_CHANNELS;\
    (p_config)->output_sampling_rate = CRIATOM_DEFAULT_OUTPUT_SAMPLING_RATE;\
    (p_config)->sound_renderer_type = CRIATOM_SOUND_RENDERER_DEFAULT;\
}

HCA-MX初期化コンフィグ構造体にデフォルト値をセット

説明:

criAtomHcaMx_Initialize 関数に設定するコンフィグ構造体 （ CriAtomHcaMxConfig ）に、デフォルト値をセットします。

参照:

criAtomHcaMx_Initialize, CriAtomHcaMxConfig

{\
    (p_config)->max_files       = CRIATOM_STREAMING_CACHE_DEFAULT_NUM_FILES;\
    (p_config)->max_path        = CRIFS_CONFIG_DEFAULT_MAX_PATH;\
    (p_config)->cache_size      = CRIATOM_STREAMING_CACHE_DEFAULT_CACHE_SIZE;\
}

CriAtomStreamingCacheConfigへのデフォルトパラメータのセット

引数:

[out]

p_config

ストリーミングキャッシュ作成用コンフィグ構造体へのポインタ

説明:

criAtomStreamingCache_CalculateWorkSize 関数、 criAtomStreamingCache_Create 関数に設定するコンフィグ構造体 （ ::CriAtomStreamingCacheUnitConfig ）に対し、デフォルト値をセットします。

参照:

criAtomStreamingCache_CalculateWorkSize, criAtomStreamingCache_Create

{\
    (p_config)->interval = 50;\
    (p_config)->hold_time = 1000;\
}

レベルメータ機能コンフィグ構造体にデフォルト値をセット

説明:

::criAtomExAsr_AttachLevelMeter 関数に設定するコンフィグ構造体 （ CriAtomLevelMeterConfig ）に、デフォルト値をセットします。

参照:

criAtomExAsr_AttachLevelMeter, CriAtomLevelMeterConfig

{\
    (p_config)->short_term_time = 3;\
    (p_config)->integrated_time = 600;\
}

ラウドネスメータ機能コンフィグ構造体にデフォルト値をセット

説明:

criAtomMeter_AttachLoudnessMeter 関数に設定するコンフィグ構造体 （ CriAtomLoudnessMeterConfig ）に、デフォルト値をセットします。

参照:

criAtomMeter_AttachLoudnessMeter, CriAtomLoudnessMeterConfig

{\
    (p_config)->sample_clipping = CRI_TRUE;\
    (p_config)->interval = 50;\
    (p_config)->hold_time = 1000; \
}

トゥルーピークメータ機能コンフィグ構造体にデフォルト値をセット

説明:

criAtomMeter_AttachTruePeakMeter 関数に設定するコンフィグ構造体 （ CriAtomTruePeakMeterConfig ）に、デフォルト値をセットします。

参照:

criAtomMeter_AttachTruePeakMeter, CriAtomTruePeakMeterConfig

なし

ADX

HCA

HCA-MX

Wave

Raw PCM

AIFF

振動

AudioBuffer

ハードウェア固有

ハードウェア固有

HCA-MX初期化用コンフィグ構造体HCA-MXの動作仕様を指定するための構造体です。
criAtomHcaMx_Initialize 関数の引数に指定します。

備考:

デフォルト設定を使用する場合、 criAtomHcaMx_SetDefaultConfig マクロで 構造体にデフォルトパラメータをセットした後、 criAtomHcaMx_Initialize 関数 に構造体を指定してください。

注意:

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

参照:

criAtomHcaMx_Initialize, criAtomHcaMx_SetDefaultConfig

ストリーミングキャッシュID

説明:

CriAtomStreamingCacheId は、ストリーミングキャッシュ管理用IDです。
criAtomStreamingCache_Create 関数でストリーミングキャッシュを作成すると取得できます。

参照:

criAtomStreamingCache_Create

ピッチシフタアタッチ用パラメータ構造体

説明:

ピッチシフタDSPをアタッチする際に指定するパラメータです。
::criAtomExVoicePool_AttachPitchShifter 関数に CriAtomExDspPitchShifterConfig 構造体のメンバとして指定します。

参照:

criAtomExVoicePool_AttachPitchShifter

ピッチシフタ用パラメータ

説明:

ピッチシフタDSPに指定するパラメータです。
criAtomExPlayer_SetDspParameter 関数の param_id に指定します。

参照:

criAtomExPlayer_SetDspParameter

タイムストレッチ用パラメータ構造体

説明:

タイムストレッチDSPをアタッチする際に指定するパラメータです。
criAtomExVoicePool_AttachDspTimeStretch 関数に CriAtomExDspTimeStretchConfig 構造体のメンバとして指定します。

参照:

criAtomExVoicePool_AttachDspTimeStretch

タイムストレッチ用パラメータ

説明:

タイムストレッチDSPに指定するパラメータです。
criAtomExPlayer_SetDspParameter 関数の param_id に指定します。

参照:

criAtomExPlayer_SetDspParameter

スペクトラムアナライザ作成用パラメータ構造体

説明:

スペクトラムアナライザをアタッチする際に指定するパラメータです。
criAtomDspSpectra_Create 関数の引数に使用します。

参照:

criAtomDspSpectra_Create

レベル情報

説明:

レベル情報を取得するための構造体です。
criAtomMeter_GetLevelInfo 関数で利用します。

備考:

各レベル値の単位はdBです。

参照:

criAtomMeter_GetLevelInfo

ラウドネス情報

説明:

ラウドネス情報を取得するための構造体です。
criAtomMeter_GetLoudnessInfo 関数で利用します。

備考:

各レベル値の単位はLKFSです。

参照:

criAtomMeter_GetLoudnessInfo

トゥルーピーク情報

説明:

トゥルーピーク情報を取得するための構造体です。
criAtomMeter_GetTruePeakInfo 関数で利用します。

備考:

各レベル値の単位はdBです。

参照:

criAtomMeter_GetTruePeakInfo

ピッチシフタ用パラメータ

説明:

ピッチシフタDSPに指定するパラメータです。
criAtomExPlayer_SetDspParameter 関数の param_id に指定します。

参照:

criAtomExPlayer_SetDspParameter

列挙型の値:

CRIATOMDSP_PITCHSHIFTER_PARAM_PITCH	ピッチ 説明: ピッチシフタのピッチシフト量です。 単位はセントです。 設定可能な値の範囲は -2400 〜 2400 までです。 備考: 原音と比べて 1200 で 2倍、-1200 で 1/2倍 のピッチシフトになります。
CRIATOMDSP_PITCHSHIFTER_PARAM_FORMANT	フォルマント 説明: ピッチシフタのフォルマントシフト量です。 単位はセントです。 設定可能な値の範囲は -2400 〜 2400 までです。 備考: 原音と比べて 1200 で 2倍、-1200 で 1/2倍 のフォルマントシフトになります。 注意: フォルマントシフトが有効になるのはピッチシフトモードが Vocal か Speech の 場合のみです。
CRIATOMDSP_PITCHSHIFTER_PARAM_MODE	ピッチシフトモード 説明: ピッチシフトの処理方法（アルゴリズム）を指定します。 音声によって設定を変更すると音質が向上することがあります。 下記は指定可能な値と対応するモード名です。 0: Music 1: Vocal 2: SoundEffect 3: Speech

タイムストレッチ用パラメータ

説明:

タイムストレッチDSPに指定するパラメータです。
criAtomExPlayer_SetDspParameter 関数の param_id に指定します。

参照:

criAtomExPlayer_SetDspParameter

列挙型の値:

CRIATOMDSP_TIMESTRETCH_PARAM_RATIO	ストレッチ比率 説明: 再生時間の倍率です。 元データの再生時刻に ratio を掛けた値がストレッチ結果の再生時間となります。 設定可能な値の範囲は 0.5f 〜 2.0f までです。 注意: 設定する値は再生速度ではなく「再生時間」に対する倍率です。 ストレッチの割合を再生速度で指定する場合、再生速度の倍率の逆数を設定してください。
CRIATOMDSP_TIMESTRETCH_PARAM_FRAME_TIME	フレーム時間 説明: タイムストレッチする際のフレーム時間(単位:ミリ秒)です。 再生する音の種類によって調整することで品質を向上させられます。 設定可能な値の範囲は 10 〜 60 までです。 備考: ボイス音声は 20msec 辺り、音楽は 50msec 辺りで良好な品質になります。
CRIATOMDSP_TIMESTRETCH_PARAM_QUALITY	処理品質 説明: タイムストレッチ処理の品質です。 高いほど品質が上がりますが、CPU負荷とのトレードオフです。 設定可能な値の範囲は 0 〜 10 までです。 備考: 人の声は低めでも十分で、音楽をタイムストレッチする場合は、 高く設定するほど良好になります。

HCA-MX初期化用ワーク領域サイズの計算

引数:

[in]

config

HCA-MX初期化用コンフィグ構造体

戻り値:

CriSint32 ワーク領域サイズ

戻り値:

0以上	正常に処理が完了
-1	エラーが発生

説明:

HCA-MXの初期化に必要なワーク領域のサイズを取得します。
criAtom_SetUserAllocator マクロによるアロケータ登録を行わずに criAtomHcaMx_Initialize 関数でHCA-MXの初期化を行う場合、 本関数で計算したサイズ分のメモリをワーク領域として渡す必要があります。

ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。
ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。

備考:

HCA-MXの初期化に必要なワークメモリのサイズは、HCA-MX初期化用コンフィグ 構造体（ CriAtomHcaMxConfig ）の内容によって変化します。

引数にNULLを指定した場合、デフォルト設定 （ criAtomHcaMx_SetDefaultConfig 適用時と同じパラメータ）で ワーク領域サイズを計算します。
引数 config の情報は、関数内でのみ参照されます。
関数を抜けた後は参照されませんので、関数実行後に config の領域を解放しても 問題ありません。

参照:

criAtom_SetUserAllocator, criAtomHcaMx_Initialize

ワーク領域サイズ計算用コンフィグ構造体の設定

引数:

[in]

config

HCA-MX初期化用コンフィグ構造体

説明:

ワーク領域サイズの計算用に、HCA-MX初期化用コンフィグ構造体 （ CriAtomHcaMxConfig 構造体）を仮登録します。

HCA-MXプレーヤの作成に必要なワーク領域のサイズは、 HCA-MX初期化時（ criAtomHcaMx_Initialize 関数実行時） に設定する構造体のパラメータによって変化します。
そのため、通常はプレーヤの作成に必要なワーク領域サイズを計算する前に、 HCA-MXを初期化する必要があります。
本関数を使用してHCA-MX初期化用コンフィグ構造体を登録した場合、 criAtomPlayer_CalculateWorkSizeForHcaMxPlayer 関数が初期化処理なしに使用可能となります。

備考:

引数（ config ）に NULL を指定した場合、デフォルト設定 （ criAtomPlayer_SetDefaultConfigForHcaMxPlayer 適用時と同じパラメータ）でワーク領域サイズを計算します。

現状、本関数で一旦コンフィグ構造体を設定すると、 設定前の状態（未初期化状態でのワーク領域サイズ計算をエラーとする動作） に戻すことができなくなります。
（関数を再度実行してパラメータを上書きすることは可能です。）

注意:

本関数で登録した初期化用コンフィグ構造体は、 HCA-MX未初期化状態でのワーク領域サイズ計算にしか使用されません。
HCA-MX初期化後には本関数に設定したパラメータではなく、 初期化時に指定されたパラメータがワーク領域サイズの計算に使用されます。
（本関数で登録する構造体のパラメータと、 HCA-MX初期化時に使用する構造体のパラメータが異なる場合、 ワーク領域サイズが不足し、ハンドルの作成に失敗する恐れがあります。）

例:

    CriAtomHcaMxConfig hca_mx_config;

    // ワーク領域計算用にHCA-MX初期化設定を仮登録
    criAtomHcaMx_SetDefaultConfig(&hca_mx_config);
    criAtomHcaMx_SetConfigForWorkSizeCalculation(&hca_mx_config);

    // HCA-MXプレーヤ作成用ワーク領域サイズの計算
    hca_mx_vp_work_size = criAtomPlayer_CalculateWorkSizeForHcaMxPlayer(NULL);
        ：

参照:

criAtomPlayer_CalculateWorkSizeForHcaMxPlayer, criAtomPlayer_SetDefaultConfigForHcaMxPlayer

HCA-MXの初期化

引数:

[in]	config	HCA-MX初期化用コンフィグ構造体
[in]	work	ワーク領域
[in]	work_size	ワーク領域サイズ

説明:

HCA-MXの初期化を行います。
本関数を実行することで、HCA-MXデータの出力機能が起動されます。

備考:

HCA-MXの初期化に必要なワークメモリのサイズは、HCA-MX初期化用コンフィグ 構造体（ CriAtomHcaMxConfig ）の内容によって変化します。

引数にNULLを指定した場合、デフォルト設定 （ criAtomHcaMx_SetDefaultConfig 適用時と同じパラメータ）で初期化処理を行います。

引数 config の情報は、関数内でのみ参照されます。
関数を抜けた後は参照されませんので、関数実行後に config の領域を解放しても 問題ありません。

注意:

本関数を実行する前に、ライブラリを初期化しておく必要があります。

本関数は完了復帰型の関数です。
本関数を実行すると、しばらくの間Atomライブラリのサーバ処理がブロックされます。
音声再生中に本関数を実行すると、音途切れ等の不具合が発生する可能性があるため、 本関数の呼び出しはシーンの切り替わり等、負荷変動を許容できるタイミングで行ってください。
本関数を実行後、必ず対になる criAtomHcaMx_Finalize 関数を実行してください。
また、 criAtomHcaMx_Finalize 関数を実行するまでは、本関数を再度実行しないでください。

参照:

criAtom_SetUserAllocator, criAtomHcaMx_CalculateWorkSize

HCA-MXの終了

説明:

HCA-MXの終了処理を行います。
本関数を実行することで、HCA-MXデータの出力が停止されます。
criAtom_SetUserAllocator マクロを使用してアロケータを登録済みの場合、 HCA-MX初期化時に確保されたメモリ領域が解放されます。
（HCA-MX初期化時にワーク領域を渡した場合、本関数実行後であれば ワーク領域を解放可能です。）

注意:

本関数は完了復帰型の関数です。
本関数を実行すると、しばらくの間Atomライブラリのサーバ処理がブロックされます。
音声再生中に本関数を実行すると、音途切れ等の不具合が発生する可能性があるため、 本関数の呼び出しはシーンの切り替わり等、負荷変動を許容できるタイミングで行ってください。

参照:

criAtom_SetUserAllocator, criAtomHcaMx_Initialize

ミキサのバスセンドレベル設定

引数:

[in]	mixer_id	ミキサID
[in]	bus_name	バス名
[in]	level	センドレベル値（0.0f〜1.0f）

説明:

ミキサのバスセンドレベルを設定します。
デフォルト状態では、HCA-MXのデコード結果はミキサに格納された後、 バス0へ1.0fのレベルで送信されます。
本関数を使用することで、デコード結果を他のバスへもセンドすることが可能になります。
（ミキサごとに異なるバスエフェクトを適用可能になります。）

ミキサの出力周波数調整比の設定

引数:

[in]	mixer_id	ミキサID
[in]	ratio	センドレベル値（0.25f〜4.0f）

説明:

ミキサの出力周波数調整比を設定します。
周波数調整比は、音声データの周波数と再生周波数の比率で、再生速度の倍率と等価です。
周波数比が1.0fを超える場合、音声データは原音より高速に再生され、 1.0f未満の場合は、音声データは原音より低速で再生されます。
本関数を使用することで、対象のミキサを使用する全てのプレーヤの再生速度を 変更することができます（個々のプレーヤの再生速度は変更できません）。

ストリーミングキャッシュ作成に必要なワークサイズの計算

引数:

[in]

config

ストリーミングキャッシュ作成用構造体 return CriSint32 ストリーミングキャッシュ作成に必要なワークサイズ

戻り値:

0以上	正常に処理が完了
-1	エラーが発生

説明:

ストリーミングキャッシュ作成に必要なワークサイズを計算します。
configで与えられるパラメータに依存し、必要なワークサイズは増加します。

参照:

criAtomStreamingCache_Create

ストリーミングキャッシュの作成

引数:

[in]	config	ストリーミングキャッシュ作成用構造体
[in]	work	ストリーミングキャッシュ作成用ワーク
[in]	work_size	ストリーミングキャッシュ作成用ワークサイズ return CriAtomStreamingCacheId ストリーミングキャッシュID

説明:

ストリーミングキャッシュを作成します。
Atomプレーヤにストリーミングキャッシュを設定することで、 ストリーミング再生を行いつつメモリ上にファイル全体を保持（キャッシュ）します。
同じファイルの2回目以降の再生では、キャッシュを使ったメモリ再生に自動的に切り替わります。
また、再生データがループデータを持っていた場合、 ループ以降の再生は自動的にメモリ再生で行われるようになります。
本機能はAtomプレーヤがストリーミング再生を行う場合のみ機能します。
本関数に失敗した場合、CRIATOM_STREAMING_CACHE_ILLEGAL_IDが返ります。

注意:

ファイル全体をキャッシュする事が前提ですので、キャッシュ用に割り当てられたメモリサイズが ストリーミング再生対象とするどのファイルサイズよりも小さい場合、 一切キャッシュされません。

参照:

criAtomStreamingCache_CalculateWorkSize, criAtomStreamingCache_Destroy,

ストリーミングキャッシュの破棄

引数:

[in]

stm_cache_id

ストリーミングキャッシュID

説明:

指定したストリーミングキャッシュを破棄します。

注意:

指定したストリーミングキャッシュを利用しているプレーヤが存在しない状態で、 本関数を実行してください。

参照:

criAtomStreamingCache_Create

ストリーミングキャッシュのキャッシュ内容をクリア

引数:

[in]

cache_id

ストリーミングキャッシュID

説明:

指定したストリーミングキャッシュの内容をクリアします。
キャッシュは古い順にクリアされます。
指定したストリーミングキャッシュを使用中のプレーヤが存在する場合、 キャッシュのクリアは途中で中断されます。

注意:

一番古いキャッシュを使用中のプレーヤが存在する場合、本関数を実行しても キャッシュは一切クリアされません。

参照:

criAtomStreamingCache_Create

WaveID指定でキャッシュ済み検索

引数:

[in]	stm_cache_id	ストリーミングキャッシュID
[in]	awb	AWBハンドル
[in]	id	WaveID

戻り値:

CriBool キャッシュ済みであればCRI_TRUE、それ以外はCRI_FALSE

説明:

指定したストリーミングキャッシュ中に、指定の音声データがキャッシュされているかを検索します。
指定の音声データがキャッシュされている状態であればCRI_TRUEを、 キャッシュされていない状態であればCRI_FALSEを返します。

注意:

AWBハンドルがメモリ再生用の場合、本関数は音声データの有無にかかわらずCRI_TRUEを返します。

参照:

criAtomStreamingCache_Create

パス指定でキャッシュ済み検索

引数:

[in]	stm_cache_id	ストリーミングキャッシュID
[in]	src_binder	音声データファイル読み込み元のバインダーハンドル
[in]	path	音声データファイルのパス

戻り値:

CriBool キャッシュ済みであればCRI_TRUE、それ以外はCRI_FALSE

説明:

指定したストリーミングキャッシュ中に、指定の音声データがキャッシュされているかを検索します。
指定の音声データがキャッシュされている状態であればCRI_TRUEを、 キャッシュされていない状態であればCRI_FALSEを返します。

参照:

criAtomStreamingCache_Create

セント値からDSPパラメータへの変換

引数:

[in]

cent

セント値

戻り値:

CriFloat32 DSPパラメータ値

説明:

-1200〜1200の範囲を0.0f〜1.0fの範囲に正規化します。

スペクトラムアナライザ作成に必要なワーク領域サイズを計算

引数:

[in]

config

スペクトラムアナライザ作成パラメータ

戻り値:

CriSint32 必要なワーク領域のサイズ（単位はバイト）

説明:

スペクトラムアナライザの作成に必要なワークサイズを計算します。
configで与えられるパラメータに依存し、必要なワークサイズは変化します。

備考:

ワーク領域サイズの計算に失敗した場合、本関数は負値を返します。
（失敗の原因はエラーコールバックで通知されます。）

参照:

CriAtomDspSpectraConfig, criAtomDspSpectra_Create

スペクトラムアナライザの作成

引数:

[in]	config	スペクトラムアナライザ作成パラメータ
[in]	work	ワーク領域
[in]	work_size	ワーク領域サイズ

戻り値:

CriAtomDspSpectraHn スペクトラムアナライザハンドル

説明:

スペクトラムアナライザを作成します。
スペクトラムアナライザは、PCMデータを解析し、 帯域ごとの信号の強さを計測するモジュールです。

PCMデータの入力には、 criAtomDspSpectra_Process 関数を使用します。
解析結果の取得には、 criAtomDspSpectra_GetLevels 関数を使用します。

不要になったスペクトラムアナライザは、 criAtomDspSpectra_Destroy 関数で明示的に破棄する必要があります。

備考:

スペクトラムアナライザの作成に失敗した場合、本関数はNULLを返します。
（失敗の原因はエラーコールバックで通知されます。）
criAtom_SetUserAllocator によるアロケータ登録を行わずに本関数を実行する場合、 criAtomDspSpectra_CalculateWorkSize 関数で計算したサイズ分のメモリをワーク領域として渡す必要があります。

注意:

本関数を実行する前に、ライブラリを初期化しておく必要があります。

本関数にセットしたワーク領域は、 criAtomDspSpectra_Destroy 関数を実行するまでの間、アプリケーションで保持する必要があります。
（ criAtomDspSpectra_Destroy 関数実行前に、ワーク領域のメモリを解放しないでください。）

本関数は完了復帰型の関数です。
本関数を実行すると、しばらくの間Atomライブラリのサーバ処理がブロックされます。
音声再生中に本関数を実行すると、音途切れ等の不具合が発生する可能性があるため、 本関数の呼び出しはシーンの切り替わり等、負荷変動を許容できるタイミングで行ってください。

参照:

CriAtomDspSpectraConfig, criAtomDspSpectra_CalculateWorkSize, criAtomDspSpectra_Destroy

スペクトラムアナライザの破棄

説明:

スペクトラムアナライザを破棄します。
スペクトラムアナライザ作成時に確保されたメモリ領域が解放されます。
（スペクトラムアナライザ作成時にワーク領域を渡した場合、本関数実行後であれば ワーク領域を解放可能です。）

注意:

本関数は完了復帰型の関数です。
本関数を実行すると、しばらくの間Atomライブラリのサーバ処理がブロックされます。
音声再生中に本関数を実行すると、音途切れ等の不具合が発生する可能性があるため、 本関数の呼び出しはシーンの切り替わり等、負荷変動を許容できるタイミングで行ってください。

参照:

criAtomDspSpectra_Create

スペクトラムアナライザのリセット

説明:

スペクトラムアナライザをリセットします。
本関数を実行した時点で、 criAtomDspSpectra_Process 関数にセットしたPCMの情報がクリアされます。

備考:

criAtomDspSpectra_GetLevels 関数の戻り値をゼロクリアしたい場合、 本関数を実行してください。

参照:

criAtomDspSpectra_Process, criAtomDspSpectra_GetLevels

スペクトラム解析

説明:

PCMデータを解析します。
解析結果は criAtomDspSpectra_GetLevels 関数で取得可能です。

備考:

入力するデータ列（pcm）の値は -1.0f 〜 +1.0f の範囲を想定しています。
ただ、±1の範囲を超える値を入力した場合でも、criAtomDspSpectra_GetLevels 関数が返す値が大きくなるだけなので、 データ入力時点でクリッピングを行う必要はありません。
本関数は内部で1024点のサンプルが蓄積されるのを待ってからFFT処理を行う為、 スペクトラムは1024サンプル入力毎に更新されます。

参照:

criAtomDspSpectra_GetLevels

スペクトル解析結果の取得

説明:

criAtomDspSpectra_Process 関数でセットしたPCMデータの、解析結果を返します。

解析結果は CriFloat32 型の配列です。
配列の要素数は、 criAtomDspSpectra_Create 関数実行時に CriAtomDspSpectraConfig::num_bands で指定した数になります。
0 番目の要素が最低帯域の振幅値、 (num_bands - 1) 番目の要素が最高帯域の振幅値です。

備考:

複数チャンネルのPCMデータを解析した場合、 全てのチャンネルのPCMデータを一旦ミックスし、ミックス結果に対し解析を行います。
そのため、 criAtomDspSpectra_Process 関数に複数チャンネルの音声データをセットした場合でも、 本関数は長さは num_bands の1次元配列を返します。

注意:

criAtomDspSpectra_GetLevels 関数が返す値は、帯域ごとの振幅値です。
解析結果を市販のスペクトルアナライザのように表示させたい場合、 本関数が返す値をデシベル値に変換する必要があります。

参照:

criAtomDspSpectra_Process

レベルメータ機能用のワークサイズの計算

引数:

[in]

config

レベルメータ追加用のコンフィグ構造体

戻り値:

CriSint32 必要なワーク領域サイズ

説明:

レベルメータ追加に必要なワーク領域サイズを計算します。
config にNULLを指定するとデフォルト設定で計算されます。

参照:

criAtomMeter_AttachLevelMeter

レベルメータ機能の追加

引数:

[in]	config	レベルメータ追加用のコンフィグ構造体
[in]	work	ワーク領域
[in]	work_size	ワーク領域サイズ

説明:

ライブラリにレベルメータ機能を追加します。
config にNULLを指定するとデフォルト設定でレベルメータが追加されます。
work にNULL、work_size に0を指定すると、登録されたユーザアロケータによって ワーク領域が確保されます。

参照:

criAtomMeter_GetLevelInfo

レベルメータ機能の解除

説明:

ライブラリのレベルメータ機能を解除します。

参照:

criAtomMeter_AttachLevelMeter

レベル情報の取得

引数:

[out]

info

レベル情報の構造体

説明:

レベルメータの結果を取得します。
指定するバスには criAtomMeter_AttachLevelMeter 関数であらかじめ レベルメータ機能を追加しておく必要があります。

参照:

criAtomMeter_AttachLevelMeter

ラウドネスメータ機能用のワークサイズの計算

引数:

[in]

config

ラウドネスメータ追加用のコンフィグ構造体

戻り値:

CriSint32 必要なワーク領域サイズ

説明:

ITU-R BS.1770-3規格のラウドネスメータ追加に必要なワーク領域サイズを計算します。
config にNULLを指定するとデフォルト設定で計算されます。

参照:

criAtomMeter_AttachLoudnessMeter

ラウドネスメータ機能の追加

引数:

[in]	config	ラウドネスメータ追加用のコンフィグ構造体
[in]	work	ワーク領域
[in]	work_size	ワーク領域サイズ

説明:

ライブラリにITU-R BS.1770-3規格のラウドネスメータ機能を追加します。
config にNULLを指定するとデフォルト設定でラウドネスメータが追加されます。
work にNULL、work_size に0を指定すると、登録されたユーザアロケータによって ワーク領域が確保されます。

参照:

criAtomMeter_GetLoudnessInfo

ラウドネスメータ機能の解除

説明:

ライブラリのラウドネスメータ機能を解除します。

参照:

criAtomMeter_AttachLoudnessMeter

ラウドネス情報の取得

引数:

[out]

info

ラウドネス情報の構造体

説明:

ラウドネスメータの測定結果を取得します。 本関数を呼び出す前にライブラリへラウドネスメータを追加しておく必要があります。

参照:

criAtomMeter_AttachLoudnessMeter

ラウドネスメータのリセット

説明:

ラウドネスメータの蓄積データをリセットします。 本関数を呼び出す前にライブラリへラウドネスメータを追加しておく必要があります。

参照:

criAtomMeter_AttachLoudnessMeter

トゥルーピークメータ機能用のワークサイズの計算

引数:

[in]

config

トゥルーピークメータ追加用のコンフィグ構造体

戻り値:

CriSint32 必要なワーク領域サイズ

説明:

ITU-R BS.1770-3規格のトゥルーピークメータ追加に必要なワーク領域サイズを計算します。
config にNULLを指定するとデフォルト設定で計算されます。

参照:

criAtomMeter_AttachTruePeakMeter

トゥルーピークメータ機能の追加

引数:

[in]	config	トゥルーピークメータ追加用のコンフィグ構造体
[in]	work	ワーク領域
[in]	work_size	ワーク領域サイズ

説明:

ライブラリにITU-R BS.1770-3規格のトゥルーピークメータ機能を追加します。
config にNULLを指定するとデフォルト設定でトゥルーピークメータが追加されます。
work にNULL、work_size に0を指定すると、登録されたユーザアロケータによって ワーク領域が確保されます。

参照:

criAtomMeter_GetTruePeakInfo

トゥルーピークメータ機能の解除

説明:

ライブラリのトゥルーピークメータ機能を解除します。

参照:

criAtomMeter_AttachLoudnessMeter

トゥルーピーク情報の取得

引数:

[out]

info

トゥルーピーク情報の構造体

説明:

トゥルーピークメータの測定結果を取得します。 本関数を呼び出す前にライブラリへトゥルーピークメータを追加しておく必要があります。

参照:

criAtomMeter_AttachTruePeakMeter