CRIWARE for C#
Search Results for

    Show / Hide Table of Contents

    Class CriAtomExAsrRack

    ASRラックID.

    Inheritance
    object
    CriAtomExAsrRack
    Implements
    IDisposable
    Inherited Members
    object.Equals(object)
    object.Equals(object, object)
    object.GetHashCode()
    object.GetType()
    object.MemberwiseClone()
    object.ReferenceEquals(object, object)
    object.ToString()
    Namespace: CriWare
    Assembly: CriWare.CriAtom.dll
    Syntax
    public class CriAtomExAsrRack : IDisposable
    Remarks

    説明: ASRラック管理用のID型です。 CriAtomExAsrRack(in Config) 関数でASRラックを作成すると取得できます。

    Constructors

    CriAtomExAsrRack()

    デフォルト設定でのインスタンス作成

    Declaration
    public CriAtomExAsrRack()

    CriAtomExAsrRack(in Config)

    ASRラックの作成

    Declaration
    • C#
    • C
    public CriAtomExAsrRack(in CriAtomExAsrRack.Config config)
    CriAtomExAsrRackId CRIAPI criAtomExAsrRack_Create(const CriAtomExAsrRackConfig *config, void *work, CriSint32 work_size)
    Parameters
    Type Name Description
    CriAtomExAsrRack.Config config

    ASR初期化用コンフィグ構造体

    Remarks

    説明: ASRラックの作成を行います。 ASRラックとはバスの集合体のことで、DSPバス設定をアタッチすることができます。 本関数を実行することでASRにASRラックが追加され、レンダリング結果の出力を開始します。 この関数で追加したASRラックは出力先を選択することができ、プラットフォームネイティブの サウンドレンダラか、ASRを選択することで他のASRラックに出力することも可能です。

    備考: Initialize(in Config) 関数を実行すると、デフォルトのASRラックが追加されます。 criAtomExAsr_*** 関数はデフォルトのASRラックを操作するAPIになります。 ASRの初期化に必要なワークメモリのサイズは、ASR初期化用コンフィグ 構造体( CriAtomExAsr.Config )の内容によって変化します。 引数にnullを指定した場合、デフォルト設定 ( SetDefaultConfig(out Config) 適用時と同じパラメーター)で初期化処理を行います。 引数 config の情報は、関数内でのみ参照されます。 関数を抜けた後は参照されませんので、関数実行後に config の領域を解放しても 問題ありません。 ASRラックの生成に成功した場合は、本関数は生成したASRラックIDを返します。 生成に失敗した場合は -1 を返します。

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

    See Also
    SetUserAllocator(delegate* unmanaged[Cdecl]<IntPtr, uint, IntPtr>, delegate* unmanaged[Cdecl]<IntPtr, IntPtr, void>, IntPtr)
    Dispose()
    AttachDspBusSetting(ArgString)

    Properties

    BusFilterCallbackByName

    バスフィルターコールバック登録用のオブジェクト

    Declaration
    public CriAtomExAsr.BusFilterCbList BusFilterCallbackByName { get; }
    Property Value
    Type Description
    CriAtomExAsr.BusFilterCbList
    Remarks

    バスフィルターコールバックにはバス毎に異なるコールバック関数を指定できます。 また、エフェクト処理の前後それぞれに異なる関数を指定可能です。 本プロパティで取得できるオブジェクトは、各コールバックオブジェクトを取得可能なリストとして振る舞います。 例として、バス名"MasterOut"のバスのエフェクト処理後のコールバックを登録する場合、次のようになります。

    CriWare.CriAtomExAsr.BusFilterCallbackByName["MasterOut"].Post.Event += CallbackMethod;

    Default

    デフォルトASRラック

    Declaration
    public static CriAtomExAsrRack Default { get; }
    Property Value
    Type Description
    CriAtomExAsrRack

    NativeHandle

    ネイティブハンドル

    Declaration
    public int NativeHandle { get; }
    Property Value
    Type Description
    int

    Methods

    ApplyDspBusSnapshot(ArgString, int)

    LE Pro

    DSPバススナップショットの適用

    Declaration
    • C#
    • C
    public void ApplyDspBusSnapshot(ArgString snapshotName, int timeMs)
    void CRIAPI criAtomExAsrRack_ApplyDspBusSnapshot(CriAtomExAsrRackId rack_id, const CriChar8 *snapshot_name, CriSint32 time_ms)
    Parameters
    Type Name Description
    ArgString snapshotName

    スナップショット名

    int timeMs

    時間(ミリ秒)

    Remarks

    説明: DSPバススナップショットを適用します。 本関数を呼び出すと、スナップショットで設定したパラメーターに time_ms 掛けて変化します。 引数 snapshot_name に CRI_NULL を指定すると、元のDSPバス設定の状態(スナップショットが適用されていない状態)に戻ります。

    See Also
    AttachDspBusSetting(ArgString)

    AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig)

    LE Pro

    レベル測定機能の追加

    Declaration
    • C#
    • C
    public void AttachBusAnalyzerByName(ArgString busName, in CriAtomExAsr.BusAnalyzerConfig config)
    void CRIAPI criAtomExAsrRack_AttachBusAnalyzerByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriAtomExAsrBusAnalyzerConfig *config)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    CriAtomExAsr.BusAnalyzerConfig config

    レベル測定機能のコンフィグ構造体

    Remarks

    説明: バスにレベル測定機能を追加し、レベル測定処理を開始します。 本関数を実行後、 criAtomExAsrRack_GetBusAnalyzerInfo 関数を実行することで、 RMSレベル(音圧)、ピークレベル(最大振幅)、ピークホールドレベルを 取得することが可能です。 複数バスのレベルを計測するには、バスごとに本関数を呼び出す必要があります。

    注意: 本関数は AttachDspBusSetting(ArgString) 関数と同一のリソースを操作します。 そのため、現状は AttachDspBusSetting(ArgString) 関数を実行すると、 criAtomExAsrRack_GetBusAnalyzerInfo 関数による情報取得ができなくなります。 本関数と AttachDspBusSetting(ArgString) 関数を併用する際には、 AttachDspBusSetting(ArgString) 関数を実行する前に一旦 criAtomExAsrRack_DetachBusAnalyzer 関数でレベル測定機能を無効化し、 AttachDspBusSetting(ArgString) 関数実行後に再度本関数を実行してください。

    AttachDspBusSetting(ArgString)

    LE Pro

    DSPバス設定のアタッチ

    Declaration
    • C#
    • C
    public void AttachDspBusSetting(ArgString setting)
    void CRIAPI criAtomExAsrRack_AttachDspBusSetting(CriAtomExAsrRackId rack_id, const CriChar8 *setting, void *work, CriSint32 work_size)
    Parameters
    Type Name Description
    ArgString setting

    DSPバス設定の名前

    Remarks

    説明: DSPバス設定からバスを構築してASRラックにアタッチします。 本関数を実行するには、あらかじめ::criAtomEx_RegisterAcfConfig 関数でACF情報を 登録しておく必要があります

    備考: DSPバス設定のアタッチに必要なワークメモリのサイズは、 CRI Atom Craftで作成したDSPバス設定の内容によって変化します。

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

    See Also
    DetachDspBusSetting()

    AttachLevelMeter(in LevelMeterConfig)

    LE Pro

    ASRラック指定レベルメーター機能の追加

    Declaration
    • C#
    • C
    public void AttachLevelMeter(in CriAtom.LevelMeterConfig config)
    void CRIAPI criAtomExAsrRack_AttachLevelMeter(CriAtomExAsrRackId rack_id, const CriAtomLevelMeterConfig *config, void *work, CriSint32 work_size)
    Parameters
    Type Name Description
    CriAtom.LevelMeterConfig config

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

    Remarks

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

    See Also
    GetLevelInfo(out LevelInfo)

    AttachLoudnessMeter(in LoudnessMeterConfig)

    LE Pro

    ASRラック指定ラウドネスメーター機能の追加

    Declaration
    • C#
    • C
    public void AttachLoudnessMeter(in CriAtom.LoudnessMeterConfig config)
    void CRIAPI criAtomExAsrRack_AttachLoudnessMeter(CriAtomExAsrRackId rack_id, const CriAtomLoudnessMeterConfig *config, void *work, CriSint32 work_size)
    Parameters
    Type Name Description
    CriAtom.LoudnessMeterConfig config

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

    Remarks

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

    See Also
    GetLoudnessInfo(out LoudnessInfo)

    AttachTruePeakMeter(in TruePeakMeterConfig)

    LE Pro

    ASRラック指定トゥルーピークメーター機能の追加

    Declaration
    • C#
    • C
    public void AttachTruePeakMeter(in CriAtom.TruePeakMeterConfig config)
    void CRIAPI criAtomExAsrRack_AttachTruePeakMeter(CriAtomExAsrRackId rack_id, const CriAtomTruePeakMeterConfig *config, void *work, CriSint32 work_size)
    Parameters
    Type Name Description
    CriAtom.TruePeakMeterConfig config

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

    Remarks

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

    See Also
    GetTruePeakInfo(out TruePeakInfo)

    CalculateWorkSize(in Config)

    LE Pro

    ASRラック作成用ワーク領域サイズの計算

    Declaration
    • C#
    • C
    public static int CalculateWorkSize(in CriAtomExAsrRack.Config config)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSize(const CriAtomExAsrRackConfig *config)
    Parameters
    Type Name Description
    CriAtomExAsrRack.Config config

    ASR初期化用コンフィグ構造体

    Returns
    Type Description
    int
    Remarks

    説明: ASRラックの作成に必要なワーク領域のサイズを取得します。 SetUserAllocator(delegate* unmanaged[Cdecl]<IntPtr, uint, IntPtr>, delegate* unmanaged[Cdecl]<IntPtr, IntPtr, void>, IntPtr) メソッドによるアロケーター登録を行わずに CriAtomExAsrRack(in Config) 関数でASRの初期化を行う場合、 本関数で計算したサイズ分のメモリをワーク領域として渡す必要があります。 ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。 ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。

    備考: ASRラックの初期化に必要なワークメモリのサイズは、ASRラック初期化用コンフィグ 構造体( CriAtomExAsrRack.Config )の内容によって変化します。 引数にnullを指定した場合、デフォルト設定 ( SetDefaultConfig(out Config) 適用時と同じパラメーター)で ワーク領域サイズを計算します。 引数 config の情報は、関数内でのみ参照されます。 関数を抜けた後は参照されませんので、関数実行後に config の領域を解放しても 問題ありません。

    See Also
    SetUserAllocator(delegate* unmanaged[Cdecl]<IntPtr, uint, IntPtr>, delegate* unmanaged[Cdecl]<IntPtr, IntPtr, void>, IntPtr)
    CriAtomExAsrRack(in Config)

    CalculateWorkSizeForDspBusSetting(ArgString)

    LE Pro

    DSPバス設定のアタッチ用ワークサイズの計算

    Declaration
    • C#
    • C
    public int CalculateWorkSizeForDspBusSetting(ArgString setting)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSizeForDspBusSetting(CriAtomExAsrRackId rack_id, const CriChar8 *setting)
    Parameters
    Type Name Description
    ArgString setting

    DSPバス設定の名前

    Returns
    Type Description
    int

    CriSint32 必要ワーク領域サイズ

    Remarks

    説明: DSPバス設定からバスを構築するのに必要なワーク領域サイズを計算します。 本関数を実行するには、あらかじめ::criAtomEx_RegisterAcfConfig 関数でACF情報を 登録しておく必要があります ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。 ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。

    備考: DSPバス設定のアタッチに必要なワークメモリのサイズは、CRI Atom Craftで作成した DSPバス設定の内容によって変化します。

    See Also
    AttachDspBusSetting(ArgString)

    CalculateWorkSizeForDspBusSettingFromAcfDataAndConfig(IntPtr, int, in Config, ArgString)

    LE Pro

    DSPバス設定のアタッチ用ワークサイズの計算

    Declaration
    • C#
    • C
    public static int CalculateWorkSizeForDspBusSettingFromAcfDataAndConfig(IntPtr acfData, int acfDataSize, in CriAtomExAsrRack.Config rackConfig, ArgString setting)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSizeForDspBusSettingFromAcfDataAndConfig(void *acf_data, CriSint32 acf_data_size, const CriAtomExAsrRackConfig *rack_config, const CriChar8 *setting)
    Parameters
    Type Name Description
    IntPtr acfData

    ACFデータ

    int acfDataSize

    ACFデータサイズ

    CriAtomExAsrRack.Config rackConfig

    ASRラック作成用コンフィグ構造体

    ArgString setting

    DSPバス設定の名前

    Returns
    Type Description
    int

    CriSint32 必要ワーク領域サイズ

    Remarks

    説明: DSPバス設定からバスを構築するのに必要なワーク領域サイズを計算します。 CalculateWorkSizeForDspBusSettingFromConfig(in Config, ArgString) 関数と違い、 メモリ上にロード済みのACFデータを使用してワークメモリサイズの計算が可能です。 ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。 ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。

    備考: DSPバス設定のアタッチに必要なワークメモリのサイズは、CRI Atom Craftで作成した DSPバス設定の内容によって変化します。

    See Also
    AttachDspBusSetting(ArgString)

    CalculateWorkSizeForDspBusSettingFromConfig(in Config, ArgString)

    LE Pro

    DSPバス設定のアタッチ用ワークサイズの計算

    Declaration
    • C#
    • C
    public static int CalculateWorkSizeForDspBusSettingFromConfig(in CriAtomExAsrRack.Config config, ArgString setting)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSizeForDspBusSettingFromConfig(const CriAtomExAsrRackConfig *config, const CriChar8 *setting)
    Parameters
    Type Name Description
    CriAtomExAsrRack.Config config

    ASRラック作成用コンフィグ構造体

    ArgString setting

    DSPバス設定の名前

    Returns
    Type Description
    int

    CriSint32 必要ワーク領域サイズ

    Remarks

    説明: DSPバス設定からバスを構築するのに必要なワーク領域サイズを計算します。 本関数を実行するには、あらかじめ::criAtomEx_RegisterAcfConfig 関数でACF情報を 登録しておく必要があります configには CriAtomExAsrRack(in Config) 関数に指定するものと同じ構造体を指定してください。 ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。 ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。

    備考: DSPバス設定のアタッチに必要なワークメモリのサイズは、CRI Atom Craftで作成した DSPバス設定の内容によって変化します。

    See Also
    AttachDspBusSetting(ArgString)

    CalculateWorkSizeForLevelMeter(in LevelMeterConfig)

    LE Pro

    ASRラック指定レベルメーター機能用のワークサイズの計算

    Declaration
    • C#
    • C
    public int CalculateWorkSizeForLevelMeter(in CriAtom.LevelMeterConfig config)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSizeForLevelMeter(CriAtomExAsrRackId rack_id, const CriAtomLevelMeterConfig *config)
    Parameters
    Type Name Description
    CriAtom.LevelMeterConfig config

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

    Returns
    Type Description
    int

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

    Remarks

    説明: rack_idで指定したASRラックへのレベルメーター追加に必要なワーク領域サイズを計算します。 config にnullを指定するとデフォルト設定で計算されます。

    See Also
    AttachLevelMeter(in LevelMeterConfig)

    CalculateWorkSizeForLoudnessMeter(in LoudnessMeterConfig)

    LE Pro

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

    Declaration
    • C#
    • C
    public int CalculateWorkSizeForLoudnessMeter(in CriAtom.LoudnessMeterConfig config)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSizeForLoudnessMeter(CriAtomExAsrRackId rack_id, const CriAtomLoudnessMeterConfig *config)
    Parameters
    Type Name Description
    CriAtom.LoudnessMeterConfig config

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

    Returns
    Type Description
    int

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

    Remarks

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

    See Also
    AttachLoudnessMeter(in LoudnessMeterConfig)

    CalculateWorkSizeForTruePeakMeter(in TruePeakMeterConfig)

    LE Pro

    ASRラック指定トゥルーピークメーター機能用のワークサイズの計算

    Declaration
    • C#
    • C
    public int CalculateWorkSizeForTruePeakMeter(in CriAtom.TruePeakMeterConfig config)
    CriSint32 CRIAPI criAtomExAsrRack_CalculateWorkSizeForTruePeakMeter(CriAtomExAsrRackId rack_id, const CriAtomTruePeakMeterConfig *config)
    Parameters
    Type Name Description
    CriAtom.TruePeakMeterConfig config

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

    Returns
    Type Description
    int

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

    Remarks

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

    See Also
    AttachTruePeakMeter(in TruePeakMeterConfig)

    DetachBusAnalyzerByName(ArgString)

    LE Pro

    レベル測定機能の削除

    Declaration
    • C#
    • C
    public void DetachBusAnalyzerByName(ArgString busName)
    void CRIAPI criAtomExAsrRack_DetachBusAnalyzerByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    Remarks

    説明: バスからレベル測定機能を削除します。

    DetachDspBusSetting()

    LE Pro

    DSPバス設定のデタッチ

    Declaration
    • C#
    • C
    public void DetachDspBusSetting()
    void CRIAPI criAtomExAsrRack_DetachDspBusSetting(CriAtomExAsrRackId rack_id)
    Remarks

    説明: DSPバス設定をASRラックからデタッチします。 SetUserAllocator(delegate* unmanaged[Cdecl]<IntPtr, uint, IntPtr>, delegate* unmanaged[Cdecl]<IntPtr, IntPtr, void>, IntPtr) メソッドを使用してアロケーターを登録済みの場合、 DSPバス設定アタッチ時に確保されたメモリ領域が解放されます。 (DSPバス設定アタッチ時にワーク領域を渡した場合、本関数実行後であれば ワーク領域を解放可能です。)

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

    See Also
    AttachDspBusSetting(ArgString)

    DetachLevelMeter()

    LE Pro

    ASRラック指定レベルメーター機能の解除

    Declaration
    • C#
    • C
    public void DetachLevelMeter()
    void CRIAPI criAtomExAsrRack_DetachLevelMeter(CriAtomExAsrRackId rack_id)
    Remarks

    説明: rack_idで指定したASRラックに追加されたレベルメーター機能を解除します。

    See Also
    AttachLevelMeter(in LevelMeterConfig)

    DetachLoudnessMeter()

    LE Pro

    ASRラック指定ラウドネスメーター機能の解除

    Declaration
    • C#
    • C
    public void DetachLoudnessMeter()
    void CRIAPI criAtomExAsrRack_DetachLoudnessMeter(CriAtomExAsrRackId rack_id)
    Remarks

    説明: rack_idで指定したASRラックのラウドネスメーター機能を解除します。

    See Also
    DetachLoudnessMeter()

    DetachTruePeakMeter()

    LE Pro

    ASRラック指定トゥルーピークメーター機能の解除

    Declaration
    • C#
    • C
    public void DetachTruePeakMeter()
    void CRIAPI criAtomExAsrRack_DetachTruePeakMeter(CriAtomExAsrRackId rack_id)
    Remarks

    説明: rack_idで指定したASRラックに追加したトゥルーピークメーター機能を解除します。

    See Also
    AttachTruePeakMeter(in TruePeakMeterConfig)

    Dispose()

    LE Pro

    ASRラックの破棄

    Declaration
    • C#
    • C
    public void Dispose()
    void CRIAPI criAtomExAsrRack_Destroy(CriAtomExAsrRackId rack_id)
    Remarks

    説明: ASRラックの破棄を行います。 本関数を実行することで、レンダリング結果の出力が停止されます。 SetUserAllocator(delegate* unmanaged[Cdecl]<IntPtr, uint, IntPtr>, delegate* unmanaged[Cdecl]<IntPtr, IntPtr, void>, IntPtr) メソッドを使用してアロケーターを登録済みの場合、 ASRラック作成時に確保されたメモリ領域が解放されます。 (ASRラック作成時にワーク領域を渡した場合、本関数実行後であれば ワーク領域を解放可能です。)

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

    See Also
    SetUserAllocator(delegate* unmanaged[Cdecl]<IntPtr, uint, IntPtr>, delegate* unmanaged[Cdecl]<IntPtr, IntPtr, void>, IntPtr)
    CriAtomExAsrRack(in Config)

    GetAisacControlById(uint, out float)

    LE Pro

    指定したASRラックのAISACコントロールに値を取得(コントロールID指定)

    Declaration
    • C#
    • C
    public bool GetAisacControlById(uint controlId, out float controlValue)
    CriBool CRIAPI criAtomExAsrRack_GetAisacControlById(CriAtomExAsrRackId rack_id, CriAtomExAisacControlId control_id, CriFloat32 *control_value)
    Parameters
    Type Name Description
    uint controlId

    AISACコントロールID

    float controlValue

    AISACコントロール値

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: 指定したASRラックにアタッチされているDSPバス設定のAISACコントロールに値を取得します。 失敗した場合、エラーコールバックが返されます。

    GetAisacControlByName(ArgString, out float)

    LE Pro

    指定したASRラックのAISACコントロールに値を取得(コントロール名指定)

    Declaration
    • C#
    • C
    public bool GetAisacControlByName(ArgString controlName, out float controlValue)
    CriBool CRIAPI criAtomExAsrRack_GetAisacControlByName(CriAtomExAsrRackId rack_id, const CriChar8 *control_name, CriFloat32 *control_value)
    Parameters
    Type Name Description
    ArgString controlName

    AISACコントロール名

    float controlValue

    AISACコントロール値

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: 指定したASRラックにアタッチされているDSPバス設定のAISACコントロールに値を取得します。 失敗した場合、エラーコールバックが返されます。

    GetAmbisonicRackId()

    LE Pro

    Ambisonics再生用ASRラックIDを取得

    Declaration
    • C#
    • C
    public static CriAtomExAsrRack GetAmbisonicRackId()
    CriAtomExAsrRackId CRIAPI criAtomExAsrRack_GetAmbisonicRackId(void)
    Returns
    Type Description
    CriAtomExAsrRack

    CriAtomExAsrRack ASRラックID

    Remarks

    説明: Ambisonics再生に使用するASRラックIDを取得します。 Ambisonics再生用ASRラックは、出力ポート「_ambisonics」の設定があるACFの登録により自動で作成されます。 取得したASRラックIDはACF登録中のみ有効です。 ACFの登録を解除すると、Ambisonics再生用ASRラックも削除されるため取得したASRラックIDは無効になります。 Ambisonics再生用ASRラックが作成されていない場合、RackIllegalIdを返します。

    GetAmplitudeAnalyzerRms(int, out float, uint)

    LE Pro

    指定したバスの振幅解析器の解析結果取得

    Declaration
    • C#
    • C
    public bool GetAmplitudeAnalyzerRms(int busNo, out float rms, uint numChannels)
    CriBool CRIAPI criAtomExAsrRack_GetAmplitudeAnalyzerRms(CriAtomExAsrRackId rack_id, CriSint32 bus_no, CriFloat32 *rms, CriUint32 num_channels)
    Parameters
    Type Name Description
    int busNo

    バス番号

    float rms

    振幅結果出力バッファー

    uint numChannels

    振幅結果出力バッファーのチャンネル数

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: 振幅解析器の現在の解析結果(RMS値)を取得します。 指定したバスに振幅解析器がない場合や、指定したチャンネル数がASRバスよりも多い場合、取得に失敗します。

    GetAmplitudeAnalyzerRmsByName(ArgString, out float, uint)

    LE Pro

    指定したバスの振幅解析器の解析結果取得

    Declaration
    • C#
    • C
    public bool GetAmplitudeAnalyzerRmsByName(ArgString busName, out float rms, uint numChannels)
    CriBool CRIAPI criAtomExAsrRack_GetAmplitudeAnalyzerRmsByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *rms, CriUint32 num_channels)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float rms

    振幅結果出力バッファー

    uint numChannels

    振幅結果出力バッファーのチャンネル数

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: 振幅解析器の現在の解析結果(RMS値)を取得します。 指定したバスに振幅解析器がない場合や、指定したチャンネル数がASRバスよりも多い場合、取得に失敗します。

    GetAppliedDspBusSnapshotName()

    LE Pro

    適用中のDSPバススナップショット名の取得

    Declaration
    • C#
    • C
    public NativeString GetAppliedDspBusSnapshotName()
    const CriChar8* CRIAPI criAtomExAsrRack_GetAppliedDspBusSnapshotName(CriAtomExAsrRackId rack_id)
    Returns
    Type Description
    NativeString
    Remarks

    説明: ASRラックIDを指定して適用中のDSPバススナップショット名を取得します。 スナップショットが適用されていない場合はCRI_NULLが返ります。

    See Also
    ApplyDspBusSnapshot(ArgString, int)

    GetAttachedDspBusSettingName()

    LE Pro

    アタッチ済みのDSPバス設定の名前取得

    Declaration
    • C#
    • C
    public NativeString GetAttachedDspBusSettingName()
    const CriChar8* CRIAPI criAtomExAsrRack_GetAttachedDspBusSettingName(CriAtomExAsrRackId rack_id)
    Returns
    Type Description
    NativeString

    アタッチ済み DSP バス設定の名前

    Remarks

    説明: ASRラックにアタッチされている DSP バス設定の名前が取得できます。 本関数を実行するには、あらかじめ::criAtomEx_RegisterAcfConfig 関数でACF情報を 登録しておく必要があります

    See Also
    AttachDspBusSetting(ArgString)
    DetachDspBusSetting()

    GetBusAnalyzerInfoByName(ArgString, out BusAnalyzerInfo)

    LE Pro

    レベル測定結果の取得

    Declaration
    • C#
    • C
    public void GetBusAnalyzerInfoByName(ArgString busName, out CriAtomExAsr.BusAnalyzerInfo info)
    void CRIAPI criAtomExAsrRack_GetBusAnalyzerInfoByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriAtomExAsrBusAnalyzerInfo *info)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    CriAtomExAsr.BusAnalyzerInfo info

    レベル測定結果の構造体

    Remarks

    説明: バスからレベル測定機能の結果を取得します。 本関数でRMSレベルを取得するには、事前に AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig) 該当バスにレベル測定機能を追加しておく必要があります。

    備考: 本関数でレベルを計測可能なチャンネル数は最大で16chです。 4次以上のAmbisonicsを再生する場合等、 17ch以上の信号のレベルを測定する際には以下の関数を使用してください。

    • GetBusRmsLevelByName(ArgString, out float, int)
    • GetBusPeakLevelByName(ArgString, out float, int)
    • GetBusPeakHoldLevelByName(ArgString, out float, int)
    See Also
    AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig)
    GetBusRmsLevelByName(ArgString, out float, int)
    GetBusPeakLevelByName(ArgString, out float, int)
    GetBusPeakHoldLevelByName(ArgString, out float, int)

    GetBusPanInfoByName(ArgString, out BusPanInfo)

    LE Pro

    バスのパン情報の取得

    Declaration
    • C#
    • C
    public void GetBusPanInfoByName(ArgString busName, out CriAtomExAsr.BusPanInfo panInfo)
    void CRIAPI criAtomExAsrRack_GetBusPanInfoByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriAtomExAsrBusPanInfo *pan_info)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    CriAtomExAsr.BusPanInfo panInfo

    パン情報

    Remarks

    説明: バスのパン情報を取得します。

    GetBusPeakHoldLevelByName(ArgString, out float, int)

    LE Pro

    バスのピークホールドレベルの取得

    Declaration
    • C#
    • C
    public void GetBusPeakHoldLevelByName(ArgString busName, out float level, int maxChannels)
    void CRIAPI criAtomExAsrRack_GetBusPeakHoldLevelByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *level, CriSint32 max_channels)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float level

    レベル格納配列

    int maxChannels

    最大チャンネル数

    Remarks

    説明: バスのピークホールドレベルを取得します。 本関数でピークホールドレベルを取得するには、事前に AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig) 該当バスにレベル測定機能を追加しておく必要があります。 レベル値は第3引数(level)で指定した領域に第4引数(max_channels)で指定したチャンネル数分格納されます。 一部のチャンネルについてのみレベルを取得したい等の事情がない限り、 第4引数(max_channels)にはバスのチャンネル数以上の値を指定してください。 (バスのチャンネル数は GetNumBusChannelsByName(ArgString) 関数で取得可能です。)

    See Also
    AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig)
    GetNumBusChannelsByName(ArgString)

    GetBusPeakLevelByName(ArgString, out float, int)

    LE Pro

    バスのピークレベルの取得

    Declaration
    • C#
    • C
    public void GetBusPeakLevelByName(ArgString busName, out float level, int maxChannels)
    void CRIAPI criAtomExAsrRack_GetBusPeakLevelByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *level, CriSint32 max_channels)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float level

    レベル格納配列

    int maxChannels

    最大チャンネル数

    Remarks

    説明: バスのピークレベルを取得します。 本関数でピークレベルを取得するには、事前に AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig) 該当バスにレベル測定機能を追加しておく必要があります。 レベル値は第3引数(level)で指定した領域に第4引数(max_channels)で指定したチャンネル数分格納されます。 一部のチャンネルについてのみレベルを取得したい等の事情がない限り、 第4引数(max_channels)にはバスのチャンネル数以上の値を指定してください。 (バスのチャンネル数は GetNumBusChannelsByName(ArgString) 関数で取得可能です。)

    See Also
    AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig)
    GetNumBusChannelsByName(ArgString)

    GetBusRmsLevelByName(ArgString, out float, int)

    LE Pro

    バスのRMSレベルの取得

    Declaration
    • C#
    • C
    public void GetBusRmsLevelByName(ArgString busName, out float level, int maxChannels)
    void CRIAPI criAtomExAsrRack_GetBusRmsLevelByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *level, CriSint32 max_channels)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float level

    レベル格納配列

    int maxChannels

    最大チャンネル数

    Remarks

    説明: バスのRMSレベルを取得します。 本関数でRMSレベルを取得するには、事前に AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig) 該当バスにレベル測定機能を追加しておく必要があります。 レベル値は第3引数(level)で指定した領域に第4引数(max_channels)で指定したチャンネル数分格納されます。 一部のチャンネルについてのみレベルを取得したい等の事情がない限り、 第4引数(max_channels)にはバスのチャンネル数以上の値を指定してください。 (バスのチャンネル数は GetNumBusChannelsByName(ArgString) 関数で取得可能です。)

    See Also
    AttachBusAnalyzerByName(ArgString, in BusAnalyzerConfig)
    GetNumBusChannelsByName(ArgString)

    GetBusVolumeByName(ArgString, in float)

    LE Pro

    バスのボリュームの取得

    Declaration
    • C#
    • C
    public void GetBusVolumeByName(ArgString busName, in float volume)
    void CRIAPI criAtomExAsrRack_GetBusVolumeByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *volume)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float volume

    ボリューム値

    Remarks

    説明: バスのボリュームを設定します。 センドタイプがポストボリューム、ポストパンのセンド先に有効です。 ボリューム値は実数値で得られます。 ボリュームのデフォルト値はCRI Atom Craftで設定した値です。

    GetChannelBasedAudioRackId()

    LE Pro

    チャンネルベース 再生用 ASR ラックIDを取得

    Declaration
    • C#
    • C
    public static CriAtomExAsrRack GetChannelBasedAudioRackId()
    CriAtomExAsrRackId CRIAPI criAtomExAsrRack_GetChannelBasedAudioRackId(void)
    Returns
    Type Description
    CriAtomExAsrRack

    CriAtomExAsrRack ASRラックID

    Remarks

    説明: チャンネルベース再生用ASRラックは、出力ポート「_7_1_4」の設定で 「専用のミキサーを使用する」にTrueを指定しているACFの登録により自動で作成されます。 取得したASRラックIDはACF登録中のみ有効です。 ACFの登録を解除すると、チャンネルベース再生用ASRラックも削除されるため取得したASRラックIDは無効になります。 チャンネルベース再生用ASRラックが作成されていない場合、RackIllegalIdを返します。

    GetCompressorGain(int, out float, uint)

    LE Pro

    指定したバスのコンプレッサーの振幅乗算値取得

    Declaration
    • C#
    • C
    public bool GetCompressorGain(int busNo, out float gain, uint numChannels)
    CriBool CRIAPI criAtomExAsrRack_GetCompressorGain(CriAtomExAsrRackId rack_id, CriSint32 bus_no, CriFloat32 *gain, CriUint32 num_channels)
    Parameters
    Type Name Description
    int busNo

    バス番号

    float gain

    振幅乗算値出力バッファー

    uint numChannels

    振幅乗算値出力バッファーのチャンネル数

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: コンプレッサーが入力波形に乗算する値を取得します。 指定したバスにコンプレッサーがない場合や、指定したチャンネル数がASRバスよりも多い場合、取得に失敗します。

    GetCompressorGainByName(ArgString, out float, uint)

    LE Pro

    指定したバスのコンプレッサーの振幅乗算値取得

    Declaration
    • C#
    • C
    public bool GetCompressorGainByName(ArgString busName, out float gain, uint numChannels)
    CriBool CRIAPI criAtomExAsrRack_GetCompressorGainByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *gain, CriUint32 num_channels)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float gain

    振幅乗算値出力バッファー

    uint numChannels

    振幅乗算値出力バッファーのチャンネル数

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: コンプレッサーが入力波形に乗算する値を取得します。 指定したバスにコンプレッサーがない場合や、指定したチャンネル数がASRバスよりも多い場合、取得に失敗します。

    GetCompressorRms(int, out float, uint)

    LE Pro

    指定したバスのコンプレッサーの振幅値取得

    Declaration
    • C#
    • C
    public bool GetCompressorRms(int busNo, out float rms, uint numChannels)
    CriBool CRIAPI criAtomExAsrRack_GetCompressorRms(CriAtomExAsrRackId rack_id, CriSint32 bus_no, CriFloat32 *rms, CriUint32 num_channels)
    Parameters
    Type Name Description
    int busNo

    バス番号

    float rms

    振幅乗算値出力バッファー

    uint numChannels

    振幅乗算値出力バッファーのチャンネル数

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: コンプレッサーに適用されている振幅値を取得します。 指定したバスにコンプレッサーがない場合や、指定したチャンネル数がASRバスよりも多い場合、取得に失敗します。

    GetCompressorRmsByName(ArgString, out float, uint)

    LE Pro

    指定したバスのコンプレッサーの振幅値取得

    Declaration
    • C#
    • C
    public bool GetCompressorRmsByName(ArgString busName, out float rms, uint numChannels)
    CriBool CRIAPI criAtomExAsrRack_GetCompressorRmsByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 *rms, CriUint32 num_channels)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float rms

    振幅値出力バッファー

    uint numChannels

    振幅値出力バッファーのチャンネル数

    Returns
    Type Description
    bool

    CriBool 取得に成功したか?(true:取得に成功した, false:取得に失敗した)

    Remarks

    説明: コンプレッサーに適用されている振幅値を取得します。 指定したバスにコンプレッサーがない場合や、指定したチャンネル数がASRバスよりも多い場合、取得に失敗します。

    GetDeviceType()

    LE Pro

    指定したASRラックの出力デバイスタイプを取得

    Declaration
    • C#
    • C
    public CriAtom.DeviceType GetDeviceType()
    CriAtomDeviceType CRIAPI criAtomExAsrRack_GetDeviceType(CriAtomExAsrRackId rack_id)
    Returns
    Type Description
    CriAtom.DeviceType

    CriAtom.DeviceType 出力デバイスのタイプ

    Remarks

    説明: 指定したASRラックが出力しているデバイスのタイプを取得します。

    備考: デバイスタイプが取得できないプラットフォームでは常に Unknown が返されます。 また、プラットフォームによっては取得に時間がかかる場合があるため、 SetDeviceUpdateCallback(delegate* unmanaged[Cdecl]<IntPtr, void>, IntPtr) で登録したコールバック関数の中で使用することが推奨されます。

    See Also
    SetDeviceUpdateCallback(delegate* unmanaged[Cdecl]<IntPtr, void>, IntPtr)

    GetEffectBypass(ArgString, ArgString)

    LE Pro

    エフェクトのバイパス設定の取得

    Declaration
    • C#
    • C
    public bool GetEffectBypass(ArgString busName, ArgString effectName)
    CriBool CRIAPI criAtomExAsrRack_GetEffectBypass(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriChar8 *effect_name)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    ArgString effectName

    エフェクト名

    Returns
    Type Description
    bool

    CriBool バイパス設定されているか?(true:バイパスを行う, false:バイパスを行わない)

    Remarks

    説明: エフェクトのバイパス設定を取得します。 バイパス設定されたエフェクトは音声処理の際、スルーされるようになります。 エフェクトのバイパス設定をする際は、本関数呼び出し前にあらかじめ AttachDspBusSetting(ArgString) 関数でバスが構築されている必要があります。 どのバスにどのエフェクトが存在するかは、アタッチしたDSPバス設定に依存します。指定したバスに指定した名前のエフェクトが存在しない場合、関数はfalseを返却します。

    See Also
    SetEffectBypass(ArgString, ArgString, NativeBool)

    GetEffectParameter(ArgString, ArgString, uint)

    LE Pro

    エフェクトの動作時パラメーターの取得

    Declaration
    • C#
    • C
    public float GetEffectParameter(ArgString busName, ArgString effectName, uint parameterIndex)
    CriFloat32 CRIAPI criAtomExAsrRack_GetEffectParameter(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriChar8 *effect_name, const CriUint32 parameter_index)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    ArgString effectName

    エフェクト名

    uint parameterIndex

    エフェクトの動作時パラメーターインデックス

    Returns
    Type Description
    float

    指定したパラメーターインデックス値のエフェクトパラメーター値を返します。

    Remarks

    説明: エフェクトの動作時パラメーターを取得します。 動作時パラメーターを取得する際は、本関数呼び出し前にあらかじめ AttachDspBusSetting(ArgString) 関数でバスが構築されている必要があります。 どのバスにどのエフェクトが存在するかは、アタッチしたDSPバス設定に依存します。指定したバスに指定した名前のエフェクトが存在しない場合、関数は失敗します。 エフェクトの動作時パラメーターの詳細は、各エフェクトのパラメーターインデックス( ASRバスエフェクトのパラメーター )をご参照下さい。

    See Also
    AttachDspBusSetting(ArgString)

    GetLevelInfo(out LevelInfo)

    LE Pro

    ASRラック指定レベル情報の取得

    Declaration
    • C#
    • C
    public void GetLevelInfo(out CriAtom.LevelInfo info)
    void CRIAPI criAtomExAsrRack_GetLevelInfo(CriAtomExAsrRackId rack_id, CriAtomLevelInfo *info)
    Parameters
    Type Name Description
    CriAtom.LevelInfo info

    レベル情報の構造体

    Remarks

    説明: rack_idで指定したASRラックのレベルメーターの結果を取得します。 指定するラックには AttachLevelMeter(in LevelMeterConfig) 関数であらかじめ レベルメーター機能を追加しておく必要があります。

    See Also
    AttachLevelMeter(in LevelMeterConfig)

    GetLoudnessInfo(out LoudnessInfo)

    LE Pro

    ASRラック指定ラウドネスメーター情報の取得

    Declaration
    • C#
    • C
    public void GetLoudnessInfo(out CriAtom.LoudnessInfo info)
    void CRIAPI criAtomExAsrRack_GetLoudnessInfo(CriAtomExAsrRackId rack_id, CriAtomLoudnessInfo *info)
    Parameters
    Type Name Description
    CriAtom.LoudnessInfo info

    ラウドネス情報の構造体

    Remarks

    説明: rack_idで指定したASRラックのラウドネスメーターの結果を取得します。 指定するラックには AttachLoudnessMeter(in LoudnessMeterConfig) 関数であらかじめ ラウドネスメーター機能を追加しておく必要があります。

    See Also
    AttachLoudnessMeter(in LoudnessMeterConfig)

    GetNumBufferedSamples()

    LE Pro

    ASRラックのPCMデータ残量の取得

    Declaration
    • C#
    • C
    public int GetNumBufferedSamples()
    CriSint32 CRIAPI criAtomExAsrRack_GetNumBufferedSamples(CriAtomExAsrRackId rack_id)
    Returns
    Type Description
    int

    CriSint32 PCMデータ残量(サンプル数単位)

    Remarks

    説明: GetPcmDataFloat32(int, int, float[][]) 関数で取得可能なサンプル数を返します。

    See Also
    GetPcmDataFloat32(int, int, float[][])

    GetNumBusChannelsByName(ArgString)

    LE Pro

    バスのチャンネル数取得

    Declaration
    • C#
    • C
    public int GetNumBusChannelsByName(ArgString busName)
    CriSint32 CRIAPI criAtomExAsrRack_GetNumBusChannelsByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    Returns
    Type Description
    int

    CriSint32 バスのチャンネル数

    Remarks

    説明: バスのチャンネル数を取得します。

    GetNumBuses()

    LE Pro

    最大バス数を取得

    Declaration
    • C#
    • C
    public int GetNumBuses()
    CriSint32 CRIAPI criAtomExAsrRack_GetNumBuses(CriAtomExAsrRackId rack_id)
    Returns
    Type Description
    int

    最大バス数

    Remarks

    説明: 指定したIDのASRラックで利用可能な最大バス数を取得します。 デフォルト設定では DefaultNumBuses を返します。 最大バス数を変更するには、CriAtomExAsrRack.Config::num_buses を変更して ASRラックを作成してください。

    See Also
    CriAtomExAsrRack.Config
    CriAtomExAsrRack(in Config)
    SetDefaultConfig(out Config)

    GetNumRenderedSamples(out long, out int)

    LE Pro

    ASRラックの総レンダリング量の取得

    Declaration
    • C#
    • C
    public void GetNumRenderedSamples(out long numSamples, out int samplingRate)
    void CRIAPI criAtomExAsrRack_GetNumRenderedSamples(CriAtomExAsrRackId rack_id, CriSint64 *num_samples, CriSint32 *sampling_rate)
    Parameters
    Type Name Description
    long numSamples

    総レンダリング量(サンプル数)

    int samplingRate

    サンプリングレート

    Remarks

    説明: ASRラックのレンダリング済みサンプル数とサンプリングレートを取得します。

    注意: 本関数のレンダリング済みサンプル数の増加パターンは実行中のプラットフォームや出力デバイスによって変化する可能性があります。

    GetObjectBasedAudioRackId()

    LE Pro

    ObjectBasedAudio 再生用ASRラックIDを取得

    Declaration
    • C#
    • C
    public static CriAtomExAsrRack GetObjectBasedAudioRackId()
    CriAtomExAsrRackId CRIAPI criAtomExAsrRack_GetObjectBasedAudioRackId(void)
    Returns
    Type Description
    CriAtomExAsrRack

    CriAtomExAsrRack ASRラックID

    Remarks

    説明: ObjectBasedAudio再生に使用するASRラックIDを取得します。 ObjectBasedAudio再生用ASRラックは、出力ポート「_object_based_audio」の設定があるACFの登録により自動で作成されます。 取得したASRラックIDはACF登録中のみ有効です。 ACFの登録を解除すると、ObjectBasedAudio再生用ASRラックも削除されるため取得したASRラックIDは無効になります。 ObjectBasedAudio再生用ASRラックが作成されていない場合、RackIllegalIdを返します。

    GetPassThroughRackId()

    LE Pro

    パススルー再生用ASRラックIDを取得

    Declaration
    • C#
    • C
    public static CriAtomExAsrRack GetPassThroughRackId()
    CriAtomExAsrRackId CRIAPI criAtomExAsrRack_GetPassThroughRackId(void)
    Returns
    Type Description
    CriAtomExAsrRack

    CriAtomExAsrRack ASRラックID

    Remarks

    説明: パススルー再生に使用するASRラックIDを取得します。 パススルー再生用ASRラックは、出力ポート「_pass_through」の設定があるACFの登録により自動で作成されます。 取得したASRラックIDはACF登録中のみ有効です。 ACFの登録を解除すると、パススルー再生用ASRラックも削除されるため取得したASRラックIDは無効になります。 パススルー再生用ASRラックが作成されていない場合、RackIllegalIdを返します。

    GetPcmDataFloat32(int, int, float[][])

    LE Pro

    ASRラックのPCMデータの取得

    Declaration
    • C#
    • C
    public int GetPcmDataFloat32(int outputChannels, int outputSamples, float[][] outputBuffer)
    CriSint32 CRIAPI criAtomExAsrRack_GetPcmDataFloat32(CriAtomExAsrRackId rack_id, CriSint32 output_channels, CriSint32 output_samples, CriFloat32 *output_buffer[])
    Parameters
    Type Name Description
    int outputChannels

    出力バッファーのチャンネル数

    int outputSamples

    出力バッファーに格納可能なサンプル数

    float[][] outputBuffer

    出力バッファー

    Returns
    Type Description
    int

    CriSint32 取得できたサンプル数

    Remarks

    説明: ASRラックの出力PCMデータを取得します。 本関数を使用するには、事前に InitializeForUserPcmOutput(in ConfigForUserPcmOutput) 関数を使用してライブラリを初期化しておく必要があります。

    注意: 本関数の呼び出しは、独立したスレッド上で定期的に行う必要があります。 現状、AtomライブラリのAPIには、 PCMデータが出力されるまで処理を返さないものがいくつか存在します。 (ボイスプールの破棄処理等。) こういった関数と本関数とを同一スレッド上で順番に呼び出すと、 当該APIがPCMデータの出力を永遠に待ち続ける形になり、 処理が復帰しなくなる可能性があります。

    See Also
    InitializeForUserPcmOutput(in ConfigForUserPcmOutput)

    GetPerformanceInfo(out PerformanceInfo)

    LE Pro

    パフォーマンス情報の取得

    Declaration
    • C#
    • C
    public void GetPerformanceInfo(out CriAtomExAsrRack.PerformanceInfo info)
    void CRIAPI criAtomExAsrRack_GetPerformanceInfo(CriAtomExAsrRackId rack_id, CriAtomExAsrRackPerformanceInfo *info)
    Parameters
    Type Name Description
    CriAtomExAsrRack.PerformanceInfo info

    パフォーマンス情報

    Remarks

    説明: パフォーマンス情報を取得します。 本関数は、指定されたASRラックのレンダリング負荷のみを計測します。

    備考: スレッドモデルにMultiWithSonicsyncを指定しない場合、 本関数を使用する必要はありません。 (MultiWithSonicsync以外のスレッドモデルを使用している場合、 本関数の処理負荷は、 CriAtomExPerformanceInfo に包含されています。)

    See Also
    CriAtomExAsrRack.PerformanceInfo

    GetTruePeakInfo(out TruePeakInfo)

    LE Pro

    ASRラック指定トゥルーピーク情報の取得

    Declaration
    • C#
    • C
    public void GetTruePeakInfo(out CriAtom.TruePeakInfo info)
    void CRIAPI criAtomExAsrRack_GetTruePeakInfo(CriAtomExAsrRackId rack_id, CriAtomTruePeakInfo *info)
    Parameters
    Type Name Description
    CriAtom.TruePeakInfo info

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

    Remarks

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

    See Also
    AttachTruePeakMeter(in TruePeakMeterConfig)

    IsBusMutedByName(ArgString)

    LE Pro

    バスのミュート状態の取得

    Declaration
    • C#
    • C
    public bool IsBusMutedByName(ArgString busName)
    CriBool CRIAPI criAtomExAsrRack_IsBusMutedByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    Returns
    Type Description
    bool

    バスのミュート状態

    Remarks

    説明: バスのミュート状態を取得します。 ミュート状態のデフォルト値はCRI Atom Craftで設定した値です。

    See Also
    SetBusMuteByName(ArgString, NativeBool)

    ResetLoudnessMeter()

    LE Pro

    ASRラック指定ラウドネスメーターのリセット

    Declaration
    • C#
    • C
    public void ResetLoudnessMeter()
    void CRIAPI criAtomExAsrRack_ResetLoudnessMeter(CriAtomExAsrRackId rack_id)
    Remarks

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

    See Also
    AttachLoudnessMeter(in LoudnessMeterConfig)

    ResetPerformanceMonitor()

    LE Pro

    パフォーマンスモニターのリセット

    Declaration
    • C#
    • C
    public void ResetPerformanceMonitor()
    void CRIAPI criAtomExAsrRack_ResetPerformanceMonitor(CriAtomExAsrRackId rack_id)
    Remarks

    説明: 現在までの計測結果を破棄します。 パフォーマンスモニターは、 ASRラック作成直後からパフォーマンス情報の取得を開始し、計測結果を累積します。 以前の計測結果を以降の計測結果に含めたくない場合には、 本関数を実行し、累積された計測結果を一旦破棄する必要があります。

    SetAisacControlById(uint, float)

    LE Pro

    指定したASRラックのAISACコントロールに値を適用(コントロールID指定)

    Declaration
    • C#
    • C
    public bool SetAisacControlById(uint controlId, float controlValue)
    CriBool CRIAPI criAtomExAsrRack_SetAisacControlById(CriAtomExAsrRackId rack_id, CriAtomExAisacControlId control_id, CriFloat32 control_value)
    Parameters
    Type Name Description
    uint controlId

    AISACコントロールID

    float controlValue

    AISACコントロール値

    Returns
    Type Description
    bool

    CriBool 適用に成功したか?(true:適用に成功した, false:適用に失敗した)

    Remarks

    説明: 指定したASRラックにアタッチされているDSPバス設定のAISACコントロールに値をセットします。 失敗した場合、エラーコールバックが返されます。

    SetAisacControlByName(ArgString, float)

    LE Pro

    指定したASRラックのAISACコントロールに値を適用(コントロール名指定)

    Declaration
    • C#
    • C
    public bool SetAisacControlByName(ArgString controlName, float controlValue)
    CriBool CRIAPI criAtomExAsrRack_SetAisacControlByName(CriAtomExAsrRackId rack_id, const CriChar8 *control_name, CriFloat32 control_value)
    Parameters
    Type Name Description
    ArgString controlName

    AISACコントロール名

    float controlValue

    AISACコントロール値

    Returns
    Type Description
    bool

    CriBool 適用に成功したか?(true:適用に成功した, false:適用に失敗した)

    Remarks

    説明: 指定したASRラックにアタッチされているDSPバス設定のAISACコントロールに値をセットします。 失敗した場合、エラーコールバックが返されます。

    SetAlternateRackId(CriAtomExAsrRack)

    LE Pro

    代替ASRラックIDの設定

    Declaration
    • C#
    • C
    public void SetAlternateRackId(CriAtomExAsrRack altRackId)
    void CRIAPI criAtomExAsrRack_SetAlternateRackId(CriAtomExAsrRackId rack_id, CriAtomExAsrRackId alt_rack_id)
    Parameters
    Type Name Description
    CriAtomExAsrRack altRackId

    代替ASRラックID

    Remarks

    説明: 指定したIDのASRラックが存在しない場合に、代わりになるASRラックのIDを設定します。 ( rack_id のASRラックが存在しない場合に、その音声を alt_rack_id のASRラック経由で出力します。) デフォルト設定は RackDefaultId (指定したIDのASRラックがなければデフォルトASRから出力する)です。

    備考: 存在しないASRラックへの出力をエラーとして扱いたい場合、 alt_rack_id に rack_id と同じ値を設定してください。

    SetBusFilterCallbackByName(ArgString, delegate* unmanaged[Cdecl]<IntPtr, PcmFormat, int, int, IntPtr*, void>, delegate* unmanaged[Cdecl]<IntPtr, PcmFormat, int, int, IntPtr*, void>, IntPtr)

    LE Pro

    波形フィルターコールバック関数の登録

    Declaration
    • C#
    • C
    public void SetBusFilterCallbackByName(ArgString busName, delegate* unmanaged[Cdecl]<IntPtr, CriAtom.PcmFormat, int, int, IntPtr*, void> preFunc, delegate* unmanaged[Cdecl]<IntPtr, CriAtom.PcmFormat, int, int, IntPtr*, void> postFunc, IntPtr obj)
    void CRIAPI criAtomExAsrRack_SetBusFilterCallbackByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriAtomExAsrBusFilterCbFunc pre_func, CriAtomExAsrBusFilterCbFunc post_func, void *obj)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    delegate* unmanaged[Cdecl]<IntPtr, PcmFormat, int, int, IntPtr*, void> preFunc

    エフェクト処理前のフィルターコールバック関数

    delegate* unmanaged[Cdecl]<IntPtr, PcmFormat, int, int, IntPtr*, void> postFunc

    エフェクト処理後のフィルターコールバック関数

    IntPtr obj

    ユーザ指定オブジェクト

    Remarks

    説明: バスに流れている PCM データを受け取るコールバック関数を登録します。 登録されたコールバック関数は、サウンドレンダラが音声処理を行ったタイミングで呼び出されます。 エフェクト処理前とエフェクト処理後の2種類の使用しないほうはnull指定が可能です。

    注意: コールバック関数内で、AtomライブラリのAPIを実行しないでください。 コールバック関数はAtomライブラリ内のサーバー処理から実行されます。 そのため、サーバー処理への割り込みを考慮しないAPIを実行した場合、 エラーが発生したり、デッドロックが発生する可能性があります。 波形フィルターコールバック関数内で長時間処理をブロックすると、音切れ等の問題 が発生しますので、ご注意ください。

    See Also
    CriAtomExPlayer.FilterCbFunc

    SetBusMatrixByName(ArgString, int, int, Span<float>)

    LE Pro

    バスのレベル行列の設定

    Declaration
    • C#
    • C
    public void SetBusMatrixByName(ArgString busName, int inputChannels, int outputChannels, Span<float> matrix)
    void CRIAPI criAtomExAsrRack_SetBusMatrixByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriSint32 input_channels, CriSint32 output_channels, const CriFloat32 matrix[])
    Parameters
    Type Name Description
    ArgString busName

    バス名

    int inputChannels

    入力チャンネル数

    int outputChannels

    出力チャンネル数

    Span<float> matrix

    レベル行列を1次元に表したレベル値の配列

    Remarks

    説明: バスのレベル行列を設定します。 センドタイプがポストパンのセンド先に有効です。 レベルマトリックスは、音声データの各チャンネルの音声を、どのスピーカーから どの程度の音量で出力するかを指定するための仕組みです。 matrixは[input_channels * output_channels]の配列です。 入力チャンネルch_inから出力チャンネルch_outにセンドされるレベルは matrix[ch_in * output_channels + ch_out]にセットします。 レベル行列のデフォルト値は単位行列です。 レベル値には、0.0f~1.0fの範囲で実数値を指定します。 レベル値は音声データの振幅に対する倍率です(単位はデシベルではありません)。 例えば、1.0fを指定した場合、原音はそのままのレベルで出力されます。 0.5fを指定した場合、原音波形の振幅を半分にしたデータと同じ音量(-6dB)で 音声が出力されます。 0.0fを指定した場合、音声はミュートされます(無音になります)。

    SetBusMuteByName(ArgString, NativeBool)

    LE Pro

    バスのミュートの設定

    Declaration
    • C#
    • C
    public void SetBusMuteByName(ArgString busName, NativeBool mute)
    void CRIAPI criAtomExAsrRack_SetBusMuteByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriBool mute)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    NativeBool mute

    ミュート状態

    Remarks

    説明: バスのミュート状態を設定します。 ミュート状態のデフォルト値はCRI Atom Craftで設定した値です。

    See Also
    IsBusMutedByName(ArgString)

    SetBusPanInfoByName(ArgString, in BusPanInfo)

    LE Pro

    バスのパン情報の設定

    Declaration
    • C#
    • C
    public void SetBusPanInfoByName(ArgString busName, in CriAtomExAsr.BusPanInfo panInfo)
    void CRIAPI criAtomExAsrRack_SetBusPanInfoByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriAtomExAsrBusPanInfo *pan_info)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    CriAtomExAsr.BusPanInfo panInfo

    パン情報

    Remarks

    説明: バスのパン情報を設定します。 センドタイプがポストパンのセンド先に有効です。 パン情報のデフォルト値は CRI Atom Craft で設定した値です。

    SetBusSendLevelByName(ArgString, ArgString, float)

    LE Pro

    バスのセンドレベルの設定

    Declaration
    • C#
    • C
    public void SetBusSendLevelByName(ArgString busName, ArgString sendtoBusName, float level)
    void CRIAPI criAtomExAsrRack_SetBusSendLevelByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriChar8 *sendto_bus_name, CriFloat32 level)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    ArgString sendtoBusName

    センド先のバス名

    float level

    レベル値

    Remarks

    説明: センド先バスに音声データを送る際のレベルを設定します。 レベル値には、0.0f~1.0fの範囲で実数値を指定します。 レベル値は音声データの振幅に対する倍率です(単位はデシベルではありません)。 例えば、1.0fを指定した場合、原音はそのままのレベルで出力されます。 0.5fを指定した場合、原音波形の振幅を半分にしたデータと同じ音量(-6dB)で 音声が出力されます。 0.0fを指定した場合、音声はミュートされます(無音になります)。 レベルのデフォルト値はCRI Atom Craftで設定した値です。

    SetBusVolumeByName(ArgString, float)

    LE Pro

    バスのボリュームの設定

    Declaration
    • C#
    • C
    public void SetBusVolumeByName(ArgString busName, float volume)
    void CRIAPI criAtomExAsrRack_SetBusVolumeByName(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, CriFloat32 volume)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    float volume

    ボリューム値

    Remarks

    説明: バスのボリュームを設定します。 センドタイプがポストボリューム、ポストパンのセンド先に有効です。 ボリューム値には、0.0f~1.0fの範囲で実数値を指定します。 ボリューム値は音声データの振幅に対する倍率です(単位はデシベルではありません)。 例えば、1.0fを指定した場合、原音はそのままのボリュームで出力されます。 0.5fを指定した場合、原音波形の振幅を半分にしたデータと同じ音量(-6dB)で 音声が出力されます。 0.0fを指定した場合、音声はミュートされます(無音になります)。 ボリュームのデフォルト値はCRI Atom Craftで設定した値です。

    SetDefaultConfig(out Config)

    LE Pro

    CriAtomAsr.Configへのデフォルトパラメーターをセット

    Declaration
    • C#
    • C
    public static void SetDefaultConfig(out CriAtomExAsrRack.Config pConfig)
    void criAtomExAsrRack_SetDefaultConfig_(CriAtomExAsrRackConfig *p_config)
    Parameters
    Type Name Description
    CriAtomExAsrRack.Config pConfig

    初期化用コンフィグ構造体へのポインタ

    Remarks

    説明: Initialize(in Config) 関数に設定するコンフィグ構造体( CriAtomAsr.Config )に、 デフォルトの値をセットします。

    See Also
    CriAtomAsr.Config

    SetEffectBypass(ArgString, ArgString, NativeBool)

    LE Pro

    エフェクトのバイパス設定

    Declaration
    • C#
    • C
    public void SetEffectBypass(ArgString busName, ArgString effectName, NativeBool bypass)
    void CRIAPI criAtomExAsrRack_SetEffectBypass(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriChar8 *effect_name, const CriBool bypass)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    ArgString effectName

    エフェクト名

    NativeBool bypass

    バイパス設定(CRI_TRUE:バイパスを行う, CRI_FALSE:バイパスを行わない)

    Remarks

    説明: エフェクトのバイパス設定を行います。 バイパス設定されたエフェクトは音声処理の際、スルーされるようになります。 エフェクトのバイパス設定をする際は、本関数呼び出し前にあらかじめ AttachDspBusSetting(ArgString) 関数でバスが構築されている必要があります。 どのバスにどのエフェクトが存在するかは、アタッチしたDSPバス設定に依存します。指定したバスに指定した名前のエフェクトが存在しない場合、関数は失敗します。

    注意: 音声再生中にバイパス設定を行うとノイズが発生することがあります。

    See Also
    AttachDspBusSetting(ArgString)

    SetEffectParameter(ArgString, ArgString, uint, float)

    LE Pro

    エフェクト動作時パラメーターの設定

    Declaration
    • C#
    • C
    public void SetEffectParameter(ArgString busName, ArgString effectName, uint parameterIndex, float parameterValue)
    void CRIAPI criAtomExAsrRack_SetEffectParameter(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriChar8 *effect_name, const CriUint32 parameter_index, const CriFloat32 parameter_value)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    ArgString effectName

    エフェクト名

    uint parameterIndex

    エフェクト動作時パラメーターインデックス

    float parameterValue

    エフェクトパラメーター設定値

    Remarks

    説明: エフェクトの動作時パラメーターを設定します。 エフェクトパラメーターを設定する際は、本関数呼び出し前にあらかじめ AttachDspBusSetting(ArgString) 関数でバスが構築されている必要があります。 どのバスにどのエフェクトが存在するかは、アタッチしたDSPバス設定に依存します。指定したバスに指定した名前のエフェクトが存在しない場合、関数は失敗します。 また、 エフェクトのパラメーターは、各エフェクトのパラメーターインデックス( ASRバスエフェクトのパラメーター )をご参照下さい。

    See Also
    AttachDspBusSetting(ArgString)
    UpdateEffectParameters(ArgString, ArgString)

    UpdateEffectParameters(ArgString, ArgString)

    LE Pro

    エフェクトの動作時パラメーターの反映

    Declaration
    • C#
    • C
    public void UpdateEffectParameters(ArgString busName, ArgString effectName)
    void CRIAPI criAtomExAsrRack_UpdateEffectParameters(CriAtomExAsrRackId rack_id, const CriChar8 *bus_name, const CriChar8 *effect_name)
    Parameters
    Type Name Description
    ArgString busName

    バス名

    ArgString effectName

    エフェクト名

    Remarks

    説明: エフェクトの動作時パラメーターを反映します。 動作時パラメーターを実際に反映するには、SetEffectParameter(ArgString, ArgString, uint, float) の他にも本関数を呼び出して下さい。

    See Also
    AttachDspBusSetting(ArgString)
    SetEffectParameter(ArgString, ArgString, uint, float)

    Implements

    IDisposable

    See Also

    CriAtomExAsrRack(in Config)
    AttachDspBusSetting(ArgString)
    In this article
    Back to top Generated by DocFX