Atom サウンドレンダラ (ASR) とは

Atom サウンドレンダラ (ASR) は、以下の3つの役割を持つモジュールです。

1. 複数のボイスのミキシング
2. エフェクトの信号処理
3. 出力先への音声出力

覚え書き: マニュアルやライブラリ内では「ASRラック」という表現が使用される場合がありますが、「ASR」と「ASRラック」は基本的に同じ概念を指します。

CRI Atom ライブラリは、初期化時に メイン出力となるASR （デフォルトラック）を自動的に作成します。デフォルトラックの内部構成は、初期化時に指定された設定に基づいて決定されます。

プラットフォーム固有の初期化関数を使用する場合、機種固有の初期化構造体内の CriAtomExAsrConfig 構造体
プラットフォーム固有の初期化関数を使用しない場合、 criAtomExAsr_Initialize 関数に渡す CriAtomExAsrConfig 構造体

: ※ CriAtomExAsrConfig 構造体のデフォルト値は、 criAtomExAsr_SetDefaultConfig マクロにより設定されます。

: AtomCraft のミキサー Version2 では、出力バスを複数作成するなど、より高度なミキサー構成を設定できます。詳細は「ミキサーの運用方式について」をご確認ください。ミキサー Version2 で出力された ACF ファイルを登録すると、AtomCraft で設定したミキサー構成がデフォルトラックの内部構成に反映されます。

: Atomライブラリのボイスの発音は、特に指定がない限りデフォルトラックに送られます。ASRに送られた音声はPCM信号がミックスされるため、１音単位の制御はできなくなります。

ボイスのミキシング

: バスはそれぞれ、内部のレンダリングに使用するスピーカー構成を持っています。ボイスがASRに送られる時、ボイスのデータのチャンネル構成からバスのスピーカー構成への変換が行われます。
バスの信号が別のバスにセンドされるとき、センド元とセンド先のスピーカー構成が異なる場合は、センド元のスピーカー構成からセンド先のスピーカー構成への変換が行われます。

スピーカーマッピング

: スピーカーマッピング（ CriAtomSpeakerMapping ）は、音声のミキシング・レンダリングに使用されるスピーカー構成を示す値です。

: Atomライブラリは、入力された音声データをASRでミックスする際に、指定されたスピーカーマッピングに合致する形式に変換します。
音声にパンニングが設定されている場合、パンスピーカータイプを使用したパンニングにて変換が行われます。

: また、Atom サウンドレンダラ内の信号処理（エフェクトの信号処理）も指定されたスピーカー構成に基づいてに行われます。

: Atomライブラリーのメイン出力ASRのスピーカーマッピングは、Atomライブラリを初期化する際 CriAtomExAsrConfig::speaker_mapping で指定します。新しいASRラックを作成する際は、 CriAtomExAsrRackConfig::speaker_mapping に作成するミキサーのスピーカー構成を指定します。

覚え書き: デフォルト値は CRIATOM_SPEAKER_MAPPING_AUTO で、 CriAtomAsrConfig::output_channels の値に基づき自動的に決められます。
CriAtomExAsrConfig::speaker_mapping と CriAtomAsrConfig::output_channels の関係については、スピーカーマッピングと出力チャンネル数の関係を参照してください。

: 音声データのチャンネルコンフィグとミキサーのスピーカーマッピングが一致している場合、音声データの変換を行われません。
一致しない場合、Atomライブラリは入力された音声がミキサーの形式に合致するよう、適宜ダウンミックス（又はアップミックス）します。

注釈: スピーカーマッピングはあくまでソフトウェアミキシングに使用されるスピーカー構成です。
指定したスピーカー構成が実際にアプリケーションを使用する一般ユーザーの環境と異なる場合、指定されたスピーカー構成から当該ユーザー環境向けにAtomライブラリが再度変換を行います。
（詳細については、出力チャンネル数とプラットフォームを参照してください。）

パンスピーカータイプ

: パンスピーカータイプ（ CriAtomExPanSpeakerType ）は、パンニングされた音声データのレンダリング先を決定するパラメーターです。
音声をパンニングした際、当該音声がどのスピーカーから出力されるかはパンスピーカータイプによって決まります。

: 例えば、 criAtomExPlayer_SetPan3dAngle 関数でモノラル音声を背後（180°）に定位させた際、パンスピーカータイプが CRIATOMEX_PAN_SPEAKER_TYPE_4CH であれば、音声はLs・Rsチャンネルにパンニングされます。
これに対し、パンスピーカータイプを CRIATOMEX_PAN_SPEAKER_TYPE_6CH に設定して同様の操作を行った場合、音声はLb・Rbチャンネルにパンニングされます。

: パンスピーカータイプはデフォルト状態では、 CRIATOMEX_PAN_SPEAKER_TYPE_AUTO に設定されています。
そのため、パンニングした音声がどのスピーカーから出力されるかは、その音声の出力先に指定したスピーカーマッピングに応じて変化します。
スピーカーマッピングに応じた具体的なパンスピーカータイプは以下のとおりです。


スピーカーマッピング	パンスピーカータイプ
CRIATOM_SPEAKER_MAPPING_STEREO	CRIATOMEX_PAN_SPEAKER_TYPE_4CH
CRIATOM_SPEAKER_MAPPING_5_1	CRIATOMEX_PAN_SPEAKER_TYPE_4CH
CRIATOM_SPEAKER_MAPPING_7_1	CRIATOMEX_PAN_SPEAKER_TYPE_6CH
CRIATOM_SPEAKER_MAPPING_5_1_2	CRIATOMEX_PAN_SPEAKER_TYPE_4_0_2CH
CRIATOM_SPEAKER_MAPPING_7_1_2	CRIATOMEX_PAN_SPEAKER_TYPE_6_0_4CH
CRIATOM_SPEAKER_MAPPING_7_1_4	CRIATOMEX_PAN_SPEAKER_TYPE_6_0_4CH

パンスピーカータイプとASRのスピーカーマッピング

: 例えば、モノラル音声を CRIATOM_SPEAKER_MAPPING_5_1 を指定して作成したASRに出力すると、デフォルトの CRIATOMEX_PAN_SPEAKER_TYPE_AUTO は CRIATOMEX_PAN_SPEAKER_TYPE_4CH と解釈され、L・R・Ls・Rsを使用したパンニングが行われます。

: 一方、ASRのスピーカーマッピングよりパンスピーカータイプが大きい場合、一度パンニングしたあとASRのスピーカーマッピングに合わせてダウンミックスされます。以下の図は、 CRIATOMEX_PAN_SPEAKER_TYPE_4CH を指定した音声を CRIATOM_SPEAKER_MAPPING_STEREO のASRに入力する時の流れです。

: この時適用されるダウンミックス計算式はダウンミックス計算式を参照してください。

注釈: デフォルト設定では、センタースピーカーはパンニング結果の出力に使用されません。
パンニングされた音声をセンタースピーカーからも出力したい場合には、デフォルトのパンスピーカータイプを CRIATOMEX_PAN_SPEAKER_TYPE_AUTO_WITH_CENTER に変更してください。

// センタースピーカーをパンニング結果の出力に使用

criAtomExPlayer_ChangeDefaultPanSpeakerType(CRIATOMEX_PAN_SPEAKER_TYPE_AUTO_WITH_CENTER);

CRIATOMEX_PAN_SPEAKER_TYPE_AUTO_WITH_CENTER

@ CRIATOMEX_PAN_SPEAKER_TYPE_AUTO_WITH_CENTER

パンニング自動設定（センタースピーカーあり）

Definition: cri_le_atom_ex.h:2207

criAtomExPlayer_ChangeDefaultPanSpeakerType

void criAtomExPlayer_ChangeDefaultPanSpeakerType(CriAtomExPanSpeakerType pan_speaker_type)

パンニング時の出力スピーカータイプ設定のデフォルト値変更

エフェクトの信号処理

: ASRにはAtom Craftで作成したミキサーをアタッチすることが可能です。
ミキサーにはバスの構成やバス名、バス同士のセンド情報、各バスにあるバスエフェクトの情報が含まれています。

覚え書き: ASRラックを作成した直後などミキサーがアタッチされていない場合、ASRラックには8本のバスが設定されています。
（ criAtomExAsr_SetDefaultConfig マクロにより設定された CriAtomExAsrConfig 構造体のデフォルト値。）

: ASRに出力するボイスは指定されたバスセンドによってバスに送られ、出力バスからサウンドデバイスへ出力されます。

DSPバスとエフェクト

: ADXでは、ミキサーや様々なエフェクターを自由に組み合わせて高度なサウンド処理を行うことができます。

ミキサーの使用方法

CRI Atom Craftでミキサーを設定

: ミキサーの設定方法はミキサーを参照してください。

作成したミキサーをプログラム側でアタッチ

: デフォルトラックには、AtomCraftで設定したデフォルトミキサーが自動でアタッチされます。
別のミキサーをアタッチする場合などを除き、別途APIを呼び出す必要はありません。
デフォルトラックにミキサーをアタッチするコードを下記に示します。

/* ミキサーのアタッチ */
criAtomEx_AttachDspBusSetting("DspBusSetting_0", NULL, 0);
            :
            :
/* 再生開始 */
criAtomExPlayer_SetCueId(player, acb, 1);
criAtomExPlayer_Start(player);

: 追加で作成したASRラックにはデフォルトミキサーがアタッチされません。
追加で作成したASRラックにミキサーをアタッチするコードを下記に示します。

criAtomEx_RegisterAcfFile("proj.acf", NULL, 0);
/* ミキサーのアタッチ */
criAtomExAsrRack_AttachDspBusSetting(rack_id, "DspBusSetting_0", NULL, 0);
            :
            :
/* 使用するASRラックをセット */
criAtomExPlayer_SetAsrRackId(player, rack_id);
/* 再生開始 */
criAtomExPlayer_SetCueId(player, acb, 1);
criAtomExPlayer_Start(player);

カスタムエフェクトプラグイン

: ADXのオーディオエフェクトとしてCRI標準のエフェクトとは別に、ユーザーが作成したエフェクトやサードパーティー製のエフェクトをプラグインとして利用することができます。

: CRI ADX Audio Effect Plugin SDKで作成されたエフェクトプラグインをVSTとして作成することで、ツール上でのパラメーター調整が行いやすくなります。
CRI ADX Audio Effect Plugin SDK詳しくはカスタムエフェクトプラグインを参照ください。

ミキサーAISAC

ミキサーAISACは、 ミキサー に対して設定することができるAISACです。

通常のAISACと同じように、AISACコントロール値によってDSPバスのパラメーターを変化させることができます。
ミキサーAISACを介して、以下のバスパラメーターを操作できます。

ボリューム
パン角度
バスセンドレベル
パンスプレッド

ミキサーAISACは、通常のAISACと比べて以下の仕様が異なります。

他のAISACからAISACコントロール値を操作することはできません。
AISACコントロール値の操作は criAtomExAsrRack_SetAisacControlById または criAtomExAsrRack_SetAisacControlByName で行います。
AISACモジュレーションは使用できません。
ランタイムで新しいミキサーAISACをアタッチすることはできません。

: CRI Atom Craft上での設定方法などは、CRI Atom CraftマニュアルのミキサーAISAC を参照してください。

3rd Party製エフェクト

: ADXには、ADX組み込みのエフェクトだけでなく、3rd Party製のエフェクトと連携して動作する機能があります。

McDSP社の各種エフェクト

: McDSP社のエフェクトをADXに組み込み可能にしたADXの機能拡張 CRI ADX Audio Effect McDSP Expansion をハンドルしています。
CRI Atom Craftに組み込み可能なMcDSPエフェクトプラグインを1ヶ月無償評価可能です。

各エフェクトについての特徴は、ADX ポータルサイトをご参照下さい:
https://criware.info/mcdsp/

McDSPプラグインの組み込み方法については、ADX SDKの以下のディレクトリに配置されているドキュメントをご参照下さい。
/cri/expansion/cri_audio_effect/

出力先への音声出力

ASRのサウンド出力方式

ASRのMasterOutの出力は、ASRの作成時に指定した出力先に送られます。 ASRの出力先は CriAtomExAsrConfig::sound_renderer_type に以下の値を設定することで指定することができます。

CRIATOM_SOUND_RENDERER_NATIVE ( プラットフォームライブラリへ出力 )
CRIATOM_SOUND_RENDERER_ASR ( 他のASRへ出力 )
CRIATOM_SOUND_RENDERER_SPATIAL ( 立体音響出力 )

: CRIATOM_SOUND_RENDERER_ASR を指定した場合、 CriAtomExAsrRackConfig::output_rack_id に指定した他の ASR へサウンドを出力します。
そのため、Atom ライブラリ初期化時に作成される ASR に対しては指定できません。
CRIATOM_SOUND_RENDERER_SPATIAL を指定した場合は Atom 内部で立体音響の機能が有効化されます。
立体音響機能の詳細については「立体音響」を参照してください。

ASRの出力チャンネル数

ASR 作成時、スピーカーマッピングと出力チャンネルをそれぞれ指定することができます。この2つのパラメータは、それぞれ以下の意味合いを持ちます。

スピーカーマッピング( CriAtomExAsrConfig::speaker_mapping 、 CriAtomExAsrRackConfig::speaker_mapping)：ASR内部信号のソフトウェア処理のためのスピーカー構成
出力チャンネル数( CriAtomExAsrConfig::output_channels 、 CriAtomExAsrRackConfig::output_channels)：ASRから出力デバイスに送る信号のチャンネル数

スピーカーマッピングと出力チャンネル数の関係

: スピーカーマッピングのデフォルトは CRIATOM_SPEAKER_MAPPING_AUTO で、出力チャンネル数の値に基づき自動的に決められます。そのため多くのの場合 CriAtomExAsrConfig::output_channels のみを指定するだけでも正しい結果が得られます。
以下の図は、7.1 ch の音声素材を CriAtomExAsrConfig::output_channels に 8 を設定したASRで再生したときの流れです。
CriAtomExAsrConfig::speaker_mapping は自動的に CRIATOM_SPEAKER_MAPPING_7_1 に設定され、ASRは8chで動作し、プラットフォームにそのまま出力します。

出力チャンネル数とプラットフォーム

: ASRの出力チャンネル数には、プラットフォームが対応している出力チャンネル数を超えた値を指定することも可能です。
その時、Atomライブラリはプラットフォームが対応している最大のチャンネル数を把握し、ASRの出力に対して更にダウンミックスを行います。
以下の図は最大5.1chに対応したプラットフォームに対して CriAtomExAsrConfig::output_channels に 8 を設定したときの流れです。
ASRは8chで動作しますが、その出力をAtomのプラットフォーム固有モジュールが 6ch にダウンミックスしてプラットフォームに出力します。

注意: CriAtomExAsrConfig::output_channels の値がプラットフォームの最大チャンネル数以上の時、ASRはその最大チャンネル数の信号をプラットフォームに送ります。
この時一部のプラットフォームは受け取った最大のチャンネル数の信号から、実際のデバイスのチャンネル数に合わせて更に変換を行うことがあります。この処理はプラットフォーム固有のものであり、Atom内のダウンミックスとは関係ありません。

覚え書き: スマートフォン向けAtomライブラリのASRは、 CriAtomExAsrConfig::output_channels のデフォルト値が 2 です。
PC 環境で同じ出力を確認したい場合、PCの CriAtomExAsrConfig::output_channels に 2 を指定することで、各種プラットフォーム間で一致したステレオサウンド出力が得られます。

ダウンミックス計算式

以下の値が異なる時、Atomの中でダウンミックスが発生することがあります。

: Atom の中のダウンミックスは、下表の計算式に従います。


入力ch数	出力ch数	計算式 (出力スピーカ) = (入力スピーカ)
7.1.4.4ch	7.1.4ch	L(mix) = L + Lbf * (-3dB) R(mix) = R + Rbf * (-3dB) C(mix) = C LFE(mix) = LFE Ls(mix) = Ls Rs(mix) = Rs Lb(mix) = Lb + Lbb * (-3dB) Rb(mix) = Rb + Rbb * (-3dB) Ltf(mix) = Ltf Rtf(mix) = Rtf Ltb(mix) = Ltb Rtb(mix) = Rtb
7.1.4ch	7.1ch	L(mix) = L + Ltf * (-3dB) R(mix) = R + Rtf * (-3dB) C(mix) = C LFE(mix) = LFE Ls(mix) = Ls Rs(mix) = Rs Lb(mix) = Lb + Ltb * (-3dB) Rb(mix) = Rb + Rtb * (-3dB)
7.1ch	5.1ch	L(mix) = L R(mix) = R C(mix) = C LFE(mix) = LFE Ls(mix) = Ls + Lb * (-3dB) Rs(mix) = Rs + Rb * (-3dB)
5.1ch	4ch(L,R,Ls,Rs)	L(mix) = L + C * (-3dB) R(mix) = R + C * (-3dB) Ls(mix) = Ls Rs(mix) = Rs
4ch(L,R,Ls,Rs)	2ch	L(mix) = L + Ls * (-3dB) R(mix) = R + Rs * (-3dB)
2ch	1ch	MONO(mix) = L * (-3dB) + R * (-3dB)

: 上記の表にない組み合わせの場合、段階的にダウンミックスします。
例えば、入力7.1ch->出力2chの場合、7.1ch->5.1ch->4ch->2chの順にダウンミックスします。
結果として、ダウンミックス計算式は以下のようになります。

: L(mix) = L + C * (-3dB) + Ls * (-3dB) + Lb * (-6dB)

R(mix) = R + C * (-3dB) + Rs * (-3dB) + Rb * (-6dB)

Next:立体音響