CRI ADX  Last Updated: 2025-10-02 09:59 p
CriAtomExAcb API

データ構造

struct  CriAtomExAcbInfoTag
 ACB情報 [詳解]
 
struct  CriAtomExWaveformInfoTag
 音声波形情報 [詳解]
 
struct  CriAtomExCuePos3dInfoTag
 キュー3D情報 [詳解]
 
struct  CriAtomExCueInfoTag
 キュー情報 [詳解]
 

型定義

typedef CriAtomExAcbObj * CriAtomExAcbHn
 ACBハンドル [詳解]
 
typedef CriSint32 CriAtomExCueId
 キューID [詳解]
 
typedef CriSint32 CriAtomExCueIndex
 キューインデックス [詳解]
 
typedef struct CriAtomExAcbInfoTag CriAtomExAcbInfo
 ACB情報 [詳解]
 
typedef struct CriAtomExWaveformInfoTag CriAtomExWaveformInfo
 音声波形情報 [詳解]
 
typedef enum CriAtomExAcbCueTypeTag CriAtomExAcbCueType
 キュータイプ [詳解]
 
typedef struct CriAtomExCuePos3dInfoTag CriAtomExCuePos3dInfo
 キュー3D情報 [詳解]
 
typedef struct CriAtomExCueInfoTag CriAtomExCueInfo
 キュー情報 [詳解]
 
typedef CriBool(* CriAtomExAcbHandleCbFunc) (void *obj, CriAtomExAcbHn acb_hn)
 ACBハンドルコールバック関数型 [詳解]
 
typedef void(* CriAtomExAcbDetectionInGamePreviewDataCbFunc) (void *obj, const CriChar8 *acb_name)
 インゲームプレビュー用データのロード検知コールバック関数 [詳解]
 
typedef void(* CriAtomExMonitoringVoiceStopCbFunc) (void *obj, CriAtomExMonitoringVoiceStopInfo *voice_stop)
 ボイス停止を監視するコールバック関数型 [詳解]
 
typedef void(* CriAtomExMonitorDataUpdateNotificationCbFunc) (void *obj, const CriAtomExMonitorDataUpdateNotificationInfo *info)
 オーサリングツールによるデータ更新通知情報取得コールバック関数 [詳解]
 

列挙型

enum  CriAtomExAcbCueTypeTag {
  CRIATOMEXACB_CUE_TYPE_POLYPHONIC = (0) , CRIATOMEXACB_CUE_TYPE_SEQUENTIAL , CRIATOMEXACB_CUE_TYPE_SHUFFLE , CRIATOMEXACB_CUE_TYPE_RANDOM ,
  CRIATOMEXACB_CUE_TYPE_RANDOM_NO_REPEAT , CRIATOMEXACB_CUE_TYPE_SWITCH_GAME_VARIABLE , CRIATOMEXACB_CUE_TYPE_COMBO_SEQUENTIAL , CRIATOMEXACB_CUE_TYPE_SWITCH_SELECTOR ,
  CRIATOMEXACB_CUE_TYPE_TRACK_TRANSITION_BY_SELECTOR , CRIATOMEXACB_CUE_TYPE_ENUM_SIZE_IS_4BYTES = 0x7FFFFFFF
}
 キュータイプ [詳解]
 

関数

CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbData (void *acb_data, CriSint32 acb_data_size, CriFsBinderHn awb_binder, const CriChar8 *awb_path)
 オンメモリACBデータのロードに必要なワーク領域サイズの計算 [詳解]
 
CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbDataById (void *acb_data, CriSint32 acb_data_size, CriFsBinderHn awb_binder, CriUint16 awb_id)
 オンメモリACBデータのロードに必要なワーク領域サイズの計算(CPKコンテンツID指定) [詳解]
 
CriAtomExAcbHn criAtomExAcb_LoadAcbData (void *acb_data, CriSint32 acb_data_size, CriFsBinderHn awb_binder, const CriChar8 *awb_path, void *work, CriSint32 work_size)
 オンメモリACBデータのロード [詳解]
 
CriAtomExAcbHn criAtomExAcb_LoadAcbDataById (void *acb_data, CriSint32 acb_data_size, CriFsBinderHn awb_binder, CriUint16 awb_id, void *work, CriSint32 work_size)
 オンメモリACBデータのロード(CPKコンテンツID指定) [詳解]
 
CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbFile (CriFsBinderHn acb_binder, const CriChar8 *acb_path, CriFsBinderHn awb_binder, const CriChar8 *awb_path)
 ACBファイルのロードに必要なワーク領域サイズの計算 [詳解]
 
CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbFileById (CriFsBinderHn acb_binder, CriUint16 acb_id, CriFsBinderHn awb_binder, CriUint16 awb_id)
 ACBファイルのロードに必要なワーク領域サイズの計算(CPKコンテンツID指定) [詳解]
 
CriAtomExAcbHn criAtomExAcb_LoadAcbFile (CriFsBinderHn acb_binder, const CriChar8 *acb_path, CriFsBinderHn awb_binder, const CriChar8 *awb_path, void *work, CriSint32 work_size)
 ACBファイルのロード [詳解]
 
CriAtomExAcbHn criAtomExAcb_LoadAcbFileById (CriFsBinderHn acb_binder, CriUint16 acb_id, CriFsBinderHn awb_binder, CriUint16 awb_id, void *work, CriSint32 work_size)
 ACBファイルのロード(CPKコンテンツID指定) [詳解]
 
void criAtomExAcb_Release (CriAtomExAcbHn acb_hn)
 ACBハンドルのリリース [詳解]
 
void criAtomExAcb_ReleaseAll (void)
 全てのACBハンドルをリリース [詳解]
 
CriSint32 criAtomExAcb_EnumerateHandles (CriAtomExAcbHandleCbFunc func, void *obj)
 ACBハンドルの列挙 [詳解]
 
CriUint32 criAtomExAcb_GetVersion (void *acb_data, CriSint32 acb_data_size, void *flag)
 オンメモリACBのバージョン取得 [詳解]
 
CriUint32 criAtomExAcb_GetVersionFromFile (CriFsBinderHn acb_binder, const CriChar8 *acb_path, void *work, CriSint32 work_size, CriBool *flag)
 ACBファイルのバージョン取得 [詳解]
 
void criAtomExAcb_GetSupportedVersion (CriUint32 *version_low, CriUint32 *version_high)
 ロード可能バージョン情報取得 [詳解]
 
CriSint32 criAtomExAcb_GetNumCues (CriAtomExAcbHn acb_hn)
 キュー数の取得 [詳解]
 
CriBool criAtomExAcb_ExistsId (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キューの存在確認(キューID指定) [詳解]
 
CriBool criAtomExAcb_ExistsName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューの存在確認(キュー名指定) [詳解]
 
CriBool criAtomExAcb_ExistsIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index)
 キューの存在確認(キューインデックス指定) [詳解]
 
CriAtomExCueId criAtomExAcb_GetCueIdByIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index)
 キューIDの取得(キューインデックス指定) [詳解]
 
CriAtomExCueId criAtomExAcb_GetCueIdByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューIDの取得(キュー名指定) [詳解]
 
const CriChar8 * criAtomExAcb_GetCueNameByIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index)
 キュー名の取得(キューインデックス指定) [詳解]
 
const CriChar8 * criAtomExAcb_GetCueNameById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キュー名の取得(キューID指定) [詳解]
 
CriAtomExCueIndex criAtomExAcb_GetCueIndexById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キューインデックスの取得(キューID指定) [詳解]
 
CriAtomExCueIndex criAtomExAcb_GetCueIndexByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューインデックスの取得(キュー名指定) [詳解]
 
const CriChar8 * criAtomExAcb_GetUserDataById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 ユーザデータ文字列の取得(キューID指定) [詳解]
 
const CriChar8 * criAtomExAcb_GetUserDataByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 ユーザデータ文字列の取得(キュー名指定) [詳解]
 
CriSint64 criAtomExAcb_GetLengthById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キューの長さの取得(キューID指定) [詳解]
 
CriSint64 criAtomExAcb_GetLengthByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューの長さの取得(キュー名指定) [詳解]
 
CriSint32 criAtomExAcb_GetNumUsableAisacControlsById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キューでコントロール可能なAISAC Controlの個数の取得(キューID指定) [詳解]
 
CriSint32 criAtomExAcb_GetNumUsableAisacControlsByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューでコントロール可能なAISAC Controlの個数の取得(キュー名指定) [詳解]
 
CriBool criAtomExAcb_GetUsableAisacControlById (CriAtomExAcbHn acb_hn, CriAtomExCueId id, CriUint16 index, CriAtomExAisacControlInfo *info)
 キューでコントロール可能なAISAC Controlの取得(キューID指定) [詳解]
 
CriBool criAtomExAcb_GetUsableAisacControlByName (CriAtomExAcbHn acb_hn, const CriChar8 *name, CriUint16 index, CriAtomExAisacControlInfo *info)
 キューでコントロール可能なAISAC Controlの取得(キュー名指定) [詳解]
 
CriBool criAtomExAcb_IsUsingAisacControlById (CriAtomExAcbHn acb_hn, CriAtomExCueId id, CriAtomExAisacControlId aisac_control_id)
 キューがAISAC Controlでコントロール可能かどうかの取得(ID指定) [詳解]
 
CriBool criAtomExAcb_IsUsingAisacControlByName (CriAtomExAcbHn acb_hn, const CriChar8 *name, const CriChar8 *aisac_control_name)
 キューがAISAC Controlでコントロール可能かどうかの取得(名前指定) [詳解]
 
CriSint32 criAtomExAcb_GetCuePriorityById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キューに設定されているプライオリティの取得(キューID指定) [詳解]
 
CriSint32 criAtomExAcb_GetCuePriorityByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューに設定されているプライオリティの取得(キュー名指定) [詳解]
 
CriBool criAtomExAcb_GetWaveformInfoById (CriAtomExAcbHn acb_hn, CriAtomExCueId id, CriAtomExWaveformInfo *waveform_info)
 音声波形情報の取得(キューID指定) [詳解]
 
CriBool criAtomExAcb_GetWaveformInfoByName (CriAtomExAcbHn acb_hn, const CriChar8 *name, CriAtomExWaveformInfo *waveform_info)
 音声波形情報の取得(キュー名指定) [詳解]
 
CriAtomAwbHn criAtomExAcb_GetOnMemoryAwbHandle (CriAtomExAcbHn acb_hn)
 オンメモリ再生用 AWB ハンドルの取得 [詳解]
 
CriAtomAwbHn criAtomExAcb_GetStreamingAwbHandle (CriAtomExAcbHn acb_hn)
 ストリーム再生用 AWB ハンドルの取得 [詳解]
 
CriAtomAwbHn criAtomExAcb_GetStreamingAwbHandleBySlotName (CriAtomExAcbHn acb_hn, const CriChar8 *awb_slot_name)
 指定した AWB スロット名のストリーム再生用 AWB ハンドルの取得 [詳解]
 
CriAtomAwbHn criAtomExAcb_GetStreamingAwbHandleBySlotIndex (CriAtomExAcbHn acb_hn, CriUint16 awb_slot_index)
 指定した AWB スロットインデックスのストリーム再生用 AWB ハンドルの取得 [詳解]
 
CriBool criAtomExAcb_GetCueInfoByName (CriAtomExAcbHn acb_hn, const CriChar8 *name, CriAtomExCueInfo *info)
 キュー情報の取得(キュー名指定) [詳解]
 
CriBool criAtomExAcb_GetCueInfoById (CriAtomExAcbHn acb_hn, CriAtomExCueId id, CriAtomExCueInfo *info)
 キュー情報の取得(キューID指定) [詳解]
 
CriBool criAtomExAcb_GetCueInfoByIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index, CriAtomExCueInfo *info)
 キュー情報の取得(キューインデックス指定) [詳解]
 
CriSint32 criAtomExAcb_GetNumCuePlayingCountByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キューリミットが設定されているキューの発音数の取得(キュー名指定) [詳解]
 
CriSint32 criAtomExAcb_GetNumCuePlayingCountById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キューリミットが設定されているキューの発音数の取得(キューID指定) [詳解]
 
CriSint32 criAtomExAcb_GetNumCuePlayingCountByIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index)
 キューリミットが設定されているキューの発音数の取得(キューインデックス指定) [詳解]
 
CriAtomExBlockIndex criAtomExAcb_GetBlockIndexByIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index, const CriChar8 *block_name)
 ブロックインデックスの取得(キューインデックス指定) [詳解]
 
CriAtomExBlockIndex criAtomExAcb_GetBlockIndexById (CriAtomExAcbHn acb_hn, CriAtomExCueId id, const CriChar8 *block_name)
 ブロックインデックスの取得(キューID指定) [詳解]
 
CriAtomExBlockIndex criAtomExAcb_GetBlockIndexByName (CriAtomExAcbHn acb_hn, const CriChar8 *name, const CriChar8 *block_name)
 ブロックインデックスの取得(キュー名指定) [詳解]
 
void criAtomExAcb_SetDetectionInGamePreviewDataCallback (CriAtomExAcbDetectionInGamePreviewDataCbFunc func, void *obj)
 インゲームプレビュー用データのロード検知コールバック関数の登録 [詳解]
 
CriBool criAtomExAcb_GetAcbInfo (CriAtomExAcbHn acb_hn, CriAtomExAcbInfo *acb_info)
 ACB情報の取得 [詳解]
 
void criAtomExAcb_ResetCueTypeStateByName (CriAtomExAcbHn acb_hn, const CriChar8 *name)
 キュータイプステートのリセット(キュー名指定) [詳解]
 
void criAtomExAcb_ResetCueTypeStateById (CriAtomExAcbHn acb_hn, CriAtomExCueId id)
 キュータイプステートのリセット(キューID指定) [詳解]
 
void criAtomExAcb_ResetCueTypeStateByIndex (CriAtomExAcbHn acb_hn, CriAtomExCueIndex index)
 キュータイプステートのリセット(キューインデックス指定) [詳解]
 
void criAtomExAcb_AttachAwbFile (CriAtomExAcbHn acb_hn, CriFsBinderHn awb_binder, const CriChar8 *awb_path, const CriChar8 *awb_name, void *work, CriSint32 work_size)
 ストリーム用AWBファイルのアタッチ [詳解]
 
void criAtomExAcb_DetachAwbFile (CriAtomExAcbHn acb_hn, const CriChar8 *awb_name)
 ストリーム用AWBファイルのデタッチ [詳解]
 
CriSint32 criAtomExAcb_CalculateWorkSizeForAttachAwbFile (CriFsBinderHn awb_binder, const CriChar8 *awb_path)
 ストリーム用AWBファイルのアタッチに必要なワークサイズ取得 [詳解]
 
CriSint32 criAtomExAcb_GetNumAwbFileSlots (CriAtomExAcbHn acb_hn)
 ストリーム用AWBスロット数の取得 [詳解]
 
const CriChar8 * criAtomExAcb_GetAwbFileSlotName (CriAtomExAcbHn acb_hn, CriUint16 index)
 ストリーム用AWBスロットの取得 [詳解]
 
CriBool criAtomExAcb_IsAttachedAwbFile (CriAtomExAcbHn acb_hn, const CriChar8 *awb_name)
 ストリーム用AWBファイルのアタッチ状態取得 [詳解]
 

詳解

型定義詳解

◆ CriAtomExAcbHn

typedef CriAtomExAcbObj* CriAtomExAcbHn

ACBハンドル

説明:
キューシート情報を管理するハンドルです。
criAtomExAcb_LoadAcbFile 関数等で読み込んだキューシートファイル内の 音声を再生する場合、本ハンドルとキューIDをプレーヤーに対してセットします。
参照
criAtomExAcb_LoadAcbFile, criAtomExPlayer_SetCueId

◆ CriAtomExCueId

typedef CriSint32 CriAtomExCueId

キューID

説明:
キューIDは、ユーザがオーサリングツール上でキューに対して割り当てた一意のIDです。
キューIDをプログラム中で保持する際には、本変数型を用いて値を取り扱う必要があります。
参照
criAtomExPlayer_SetCueId

◆ CriAtomExCueIndex

typedef CriSint32 CriAtomExCueIndex

キューインデックス

説明:
キューインデックスは、ACBファイル内のコンテンツのオフセットを示す番号です。
(先頭のコンテンツが0番、その次のコンテンツが1番…というふうに、コンテンツに 順番に割り当てられる番号です。)
キューインデックスをプログラム中で保持する際には、本変数型を用いて値を取り扱う必要があります。
参照
criAtomExPlayer_SetCueIndex

◆ CriAtomExAcbInfo

ACB情報

説明:
ACBデータの各種情報です。
参照
criAtomExAcb_GetAcbInfo

◆ CriAtomExWaveformInfo

音声波形情報

説明:
波形情報は、各キューから再生される音声波形の詳細情報です。
参照
criAtomExAcb_GetWaveformInfoById, criAtomExAcb_GetWaveformInfoByName

◆ CriAtomExAcbCueType

キュータイプ

参照
CriAtomExCueInfo

◆ CriAtomExCuePos3dInfo

キュー3D情報

説明:
波形情報は、キューの3D詳細情報です。
参照
CriAtomExCueInfo

◆ CriAtomExCueInfo

キュー情報

説明:
キューの詳細情報です。
参照
criAtomExAcb_GetCueInfoByName, criAtomExAcb_GetCueInfoById, criAtomExAcb_GetCueInfoByIndex

◆ CriAtomExAcbHandleCbFunc

typedef CriBool( * CriAtomExAcbHandleCbFunc) (void *obj, CriAtomExAcbHn acb_hn)

ACBハンドルコールバック関数型

引数
[in]objユーザ指定オブジェクト
[in]acb_hnACBハンドル
戻り値
CriBool 列挙を続けるかどうか(CRI_TRUE:継続、CRI_FALSE:中止)
説明:
ACBハンドルの通知に使用される、コールバック関数の型です。
criAtomExAcb_EnumerateHandles 関数に本関数型のコールバック関数を登録することで、 ACBハンドルをコールバック経由で受け取ることが可能です。
注意
ACBハンドルをコールバック関数内で破棄してはいけません。
参照
criAtomExAcb_EnumerateHandles, CriAtomExAcbHn

◆ CriAtomExAcbDetectionInGamePreviewDataCbFunc

typedef void( * CriAtomExAcbDetectionInGamePreviewDataCbFunc) (void *obj, const CriChar8 *acb_name)

インゲームプレビュー用データのロード検知コールバック関数

説明:
引数
[in]objユーザ指定オブジェクト
[in]acb_nameACB名
戻り値
なし
説明:
インゲームプレビュー用データのロードを検知した場合に呼び出すコールバック関数です。
インゲームプレビュー用データを使用しているか調査する際に使用します。

コールバック関数の登録には criAtomExAcb_SetDetectionInGamePreviewDataCallback 関数を使用します。
登録したコールバック関数は、ACBロード関数内でACBの内容解析を行ったタイミングで実行されます。
注意
基本的に、コールバック関数内ではAtomライブラリAPIを使用しないでください。
本コールバック関数内で長時間処理をブロックすると、音切れ等の問題が発生しますので、 ご注意ください。
参照
criAtomExAcb_SetDetectionInGamePreviewDataCallback

◆ CriAtomExMonitoringVoiceStopCbFunc

typedef void( * CriAtomExMonitoringVoiceStopCbFunc) (void *obj, CriAtomExMonitoringVoiceStopInfo *voice_stop)

ボイス停止を監視するコールバック関数型

引数
[in]objユーザ指定オブジェクト
[in]voice_stopボイス停止内容
説明:
監視している再生ID内で発音しているボイスが停止した際に使用される、コールバック関数の型です。
注意
基本的に、コールバック関数内ではAtomライブラリAPIを使用しないでください。
本コールバック関数内で長時間処理をブロックすると、音切れ等の問題が発生しますので、 ご注意ください。
参照
criAtomEx_SetMonitoringVoiceStopCallback

◆ CriAtomExMonitorDataUpdateNotificationCbFunc

typedef void( * CriAtomExMonitorDataUpdateNotificationCbFunc) (void *obj, const CriAtomExMonitorDataUpdateNotificationInfo *info)

オーサリングツールによるデータ更新通知情報取得コールバック関数

説明:
引数
[in]objユーザ指定オブジェクト
[in]infoデータ更新通知情報取得
戻り値
なし
説明:
インゲームプレビュー時にオーサリングツールからのデータ更新処理が発生した場合に呼び出すコールバック関数です。
インゲームプレビュー時にアプリケーション側でデータ更新状態を取得したい場合に使用します。

コールバック関数の登録には criAtomExMonitor_SetDataUpdateNotificationCallback 関数を使用します。
登録したコールバック関数は、インゲームプレビュー中にオーサリングツールからのデータ更新前後のタイミングで実行されます。
注意
基本的に、コールバック関数内ではAtomライブラリAPIを使用しないでください。
本コールバック関数内で長時間処理をブロックすると、音切れ等の問題が発生しますので、 ご注意ください。
コールバック関数に引数として渡されるCriAtomExMonitorDataUpdateNotificationInfo構造体への参照はコールバック関数内だけで行ってください。
コールバック関数外で参照する場合は、別領域に内容を保存してから行ってください。
参照
criAtomExMonitor_SetDataUpdateNotificationCallback, CriAtomExMonitorDataUpdateNotificationInfo

列挙型詳解

◆ CriAtomExAcbCueTypeTag

キュータイプ

参照
CriAtomExCueInfo
列挙値
CRIATOMEXACB_CUE_TYPE_POLYPHONIC 

ポリフォニック

CRIATOMEXACB_CUE_TYPE_SEQUENTIAL 

シーケンシャル

CRIATOMEXACB_CUE_TYPE_SHUFFLE 

シャッフル再生

CRIATOMEXACB_CUE_TYPE_RANDOM 

ランダム

CRIATOMEXACB_CUE_TYPE_RANDOM_NO_REPEAT 

ランダム非連続(前回再生した音以外をランダムに鳴らす)

CRIATOMEXACB_CUE_TYPE_SWITCH_GAME_VARIABLE 

スイッチ再生(ゲーム変数を参照して再生トラックの切り替える)

CRIATOMEXACB_CUE_TYPE_COMBO_SEQUENTIAL 

コンボシーケンシャル(「コンボ時間」内に連続コンボが決まるとシーケンシャル、最後までいくと「コンボループバック」地点に戻る)

CRIATOMEXACB_CUE_TYPE_SWITCH_SELECTOR 

スイッチ再生(セレクターを参照して再生トラックを切り替える)

CRIATOMEXACB_CUE_TYPE_TRACK_TRANSITION_BY_SELECTOR 

トラックトランジション再生(セレクターを参照して再生トラックを切り替える)

関数詳解

◆ criAtomExAcb_CalculateWorkSizeForLoadAcbData()

CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbData ( void *  acb_data,
CriSint32  acb_data_size,
CriFsBinderHn  awb_binder,
const CriChar8 *  awb_path 
)

オンメモリACBデータのロードに必要なワーク領域サイズの計算

引数
[in]acb_dataACBデータアドレス
[in]acb_data_sizeACBデータサイズ
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_pathAWBファイルのパス
戻り値
CriSint32 ワーク領域サイズ
戻り値
0以上正常に処理が完了
-1エラーが発生
説明:
criAtomExAcb_LoadAcbData 関数の実行に必要なワーク領域サイズを計算します。 criAtomEx_SetUserAllocator マクロによるアロケーター登録を行わずに criAtomExAcb_LoadAcbData 関数でAWBデータをロードする際には、 本関数が返すサイズ分のメモリをワーク領域として渡す必要があります。

ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。
ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
注意
ワーク領域のサイズはライブラリ初期化時( criAtomEx_Initialize 関数実行時) に指定したパラメーターによって変化します。
そのため、本関数を実行する前に、ライブラリを初期化しておく必要があります。
参照
criAtomExAcb_LoadAcbData

◆ criAtomExAcb_CalculateWorkSizeForLoadAcbDataById()

CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbDataById ( void *  acb_data,
CriSint32  acb_data_size,
CriFsBinderHn  awb_binder,
CriUint16  awb_id 
)

オンメモリACBデータのロードに必要なワーク領域サイズの計算(CPKコンテンツID指定)

引数
[in]acb_dataACBデータアドレス
[in]acb_data_sizeACBデータサイズ
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_idCPKファイル内のAWBデータのID
戻り値
CriSint32 ワーク領域サイズ
戻り値
0以上正常に処理が完了
-1エラーが発生
説明:
criAtomExAcb_LoadAcbDataById 関数の実行に必要なワーク領域サイズを計算します。 ファイルパスの代わりにCPKコンテンツIDを指定する点を除けば、 criAtomExAcb_CalculateWorkSizeForLoadAcbData 関数と機能は同じです。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
参照
criAtomExAcb_CalculateWorkSizeForLoadAcbData, criAtomExAcb_LoadAcbDataById

◆ criAtomExAcb_LoadAcbData()

CriAtomExAcbHn criAtomExAcb_LoadAcbData ( void *  acb_data,
CriSint32  acb_data_size,
CriFsBinderHn  awb_binder,
const CriChar8 *  awb_path,
void *  work,
CriSint32  work_size 
)

オンメモリACBデータのロード

引数
[in]acb_dataACBデータアドレス
[in]acb_data_sizeACBデータサイズ
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_pathAWBファイルのパス
[in]workワーク領域
[in]work_sizeワーク領域サイズ
戻り値
CriAtomExAcbHn ACBハンドル
説明:
ACBデータをロードし、キュー再生に必要な情報を取り込みます。
ACBデータのロードに必要なワーク領域のサイズは、 criAtomExAcb_CalculateWorkSizeForLoadAcbData 関数で計算します。

第3引数の awb_binder 、および第4引数の awb_path には、ストリーム再生用 のAWBファイルを指定します。
(オンメモリ再生のみのACBデータをロードする場合、 awb_binder および awb_path にセットした値は無視されます。)

ACBデータをロードすると、ACBデータにアクセスするためのACBハンドル ( CriAtomExAcbHn )が返されます。
AtomExプレーヤーに対し、 criAtomExPlayer_SetCueId 関数でACBハンドル、および再生する キューのIDをセットすることで、ACBデータ内のキューを再生することが可能です。

ACBファイルのロードに成功すると、本関数は戻り値として ACB ハンドルを返します。
リードエラー等によりACBファイルのロードに失敗した場合、本関数は戻り値として CRI_NULL を返します。
備考:
criAtomEx_SetUserAllocator マクロを使用してアロケーターを登録済みの場合、 本関数にワーク領域を指定する必要はありません。
( work に NULL 、 work_size に 0 を指定することで、登録済みのアロケーター から必要なワーク領域サイズ分のメモリが動的に確保されます。)
本関数は即時復帰関数です。
ACBファイルを事前にメモリにロードしてから本関数を実行することで、 ACBハンドル作成時に処理がブロックされるのを回避可能です。
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
注意
本関数にてセットしたデータ領域やワーク領域のメモリ内容はACBハンドル破棄時 までアプリケーション中で保持し続ける必要があります。
(セット済みのワーク領域に値を書き込んだり、メモリ解放したりしてはいけません。)
また、データ領域の一部はワークとして使用されます。

ACBデータにはワーク領域も含まれています。
そのため、1つのACBデータ領域を複数回同時にロードすることはできません。
(作成されたACBハンドルを複数のAtomExプレーヤーで共有することは可能です。)

ACBハンドルは内部的にバインダー( CriFsBinderHn )を確保します。
ACBファイルをロードする場合、ACBハンドル数分のバインダーが確保できる設定で Atomライブラリ(またはCRI File Systemライブラリ)を初期化する必要があります。

ACBハンドルは内部的にバインダー( CriFsBinderHn )を確保します。
ACBファイルをロードする場合、ACBハンドル数分のバインダーが確保できる設定で Atomライブラリ(またはCRI File Systemライブラリ)を初期化する必要があります。

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

◆ criAtomExAcb_LoadAcbDataById()

CriAtomExAcbHn criAtomExAcb_LoadAcbDataById ( void *  acb_data,
CriSint32  acb_data_size,
CriFsBinderHn  awb_binder,
CriUint16  awb_id,
void *  work,
CriSint32  work_size 
)

オンメモリACBデータのロード(CPKコンテンツID指定)

引数
[in]acb_dataACBデータアドレス
[in]acb_data_sizeACBデータサイズ
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_idCPKファイル内のAWBデータのID
[in]workワーク領域
[in]work_sizeワーク領域サイズ
戻り値
CriAtomExAcbHn ACBハンドル
説明:
ACBデータをロードし、キュー再生に必要な情報を取り込みます。
ファイルパスの代わりにCPKコンテンツIDを指定する点を除けば、 criAtomExAcb_LoadAcbData 関数と機能は同じです。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
参照
criAtomExAcb_LoadAcbData

◆ criAtomExAcb_CalculateWorkSizeForLoadAcbFile()

CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbFile ( CriFsBinderHn  acb_binder,
const CriChar8 *  acb_path,
CriFsBinderHn  awb_binder,
const CriChar8 *  awb_path 
)

ACBファイルのロードに必要なワーク領域サイズの計算

引数
[in]acb_binderACBファイルを含むバインダーのハンドル
[in]acb_pathACBファイルのパス
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_pathAWBファイルのパス
戻り値
CriSint32 ワーク領域サイズ
戻り値
0以上正常に処理が完了
-1エラーが発生
説明:
criAtomExAcb_LoadAcbFile 関数の実行に必要なワーク領域サイズを計算します。 criAtomEx_SetUserAllocator マクロによるアロケーター登録を行わずに criAtomExAcb_LoadAcbFile 関数でACBファイルをロードする際には、 本関数が返すサイズ分のメモリをワーク領域として渡す必要があります。

ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。
ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。
注意
ワーク領域のサイズはライブラリ初期化時( criAtomEx_Initialize 関数実行時) に指定したパラメーターによって変化します。
そのため、本関数を実行する前に、ライブラリを初期化しておく必要があります。

本関数は完了復帰型の関数です。
ACBファイルのロードにかかる時間は、プラットフォームによって異なります。
ゲームループ等の画面更新が必要なタイミングで本関数を実行するとミリ秒単位で 処理がブロックされ、フレーム落ちが発生する恐れがあります。
ACBファイルのロードは、シーンの切り替わり等、負荷変動を許容できる タイミングで行うようお願いいたします。
参照
criAtomExAcb_LoadAcbFile

◆ criAtomExAcb_CalculateWorkSizeForLoadAcbFileById()

CriSint32 criAtomExAcb_CalculateWorkSizeForLoadAcbFileById ( CriFsBinderHn  acb_binder,
CriUint16  acb_id,
CriFsBinderHn  awb_binder,
CriUint16  awb_id 
)

ACBファイルのロードに必要なワーク領域サイズの計算(CPKコンテンツID指定)

引数
[in]acb_binderACBファイルを含むバインダーのハンドル
[in]acb_idCPKファイル内のACBデータのID
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_idCPKファイル内のAWBデータのID
戻り値
CriSint32 ワーク領域サイズ
戻り値
0以上正常に処理が完了
-1エラーが発生
説明:
criAtomExAcb_LoadAcbFileById 関数の実行に必要なワーク領域サイズを計算します。 ファイルパスの代わりにCPKコンテンツIDを指定する点を除けば、 criAtomExAcb_CalculateWorkSizeForLoadAcbFile 関数と機能は同じです。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
参照
criAtomExAcb_CalculateWorkSizeForLoadAcbFile, criAtomExAcb_LoadAcbFileById

◆ criAtomExAcb_LoadAcbFile()

CriAtomExAcbHn criAtomExAcb_LoadAcbFile ( CriFsBinderHn  acb_binder,
const CriChar8 *  acb_path,
CriFsBinderHn  awb_binder,
const CriChar8 *  awb_path,
void *  work,
CriSint32  work_size 
)

ACBファイルのロード

引数
[in]acb_binderACBファイルを含むバインダーのハンドル
[in]acb_pathACBファイルのパス
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_pathAWBファイルのパス
[in]workワーク領域
[in]work_sizeワーク領域サイズ
戻り値
CriAtomExAcbHn ACBハンドル
説明:
ACBファイルをロードし、キュー再生に必要な情報を取り込みます。
ACBファイルのロードに必要なワーク領域のサイズは、 criAtomExAcb_CalculateWorkSizeForLoadAcbFile 関数で計算します。

第3引数の awb_binder 、および第4引数の awb_path には、ストリーム再生用 のAWBファイルを指定します。
(オンメモリ再生のみのACBデータをロードする場合、 awb_binder および awb_path にセットした値は無視されます。)

ACBファイルをロードすると、ACBデータにアクセスするためのACBハンドル ( CriAtomExAcbHn )が返されます。
AtomExプレーヤーに対し、 criAtomExPlayer_SetCueId 関数でACBハンドル、および再生する キューのIDをセットすることで、ACBファイル内のキューを再生することが可能です。

ACBファイルのロードに成功すると、本関数は戻り値として ACB ハンドルを返します。
リードエラー等によりACBファイルのロードに失敗した場合、本関数は戻り値として CRI_NULL を返します。
備考:
criAtomEx_SetUserAllocator マクロを使用してアロケーターを登録済みの場合、 本関数にワーク領域を指定する必要はありません。
( work に NULL 、 work_size に 0 を指定することで、登録済みのアロケーター から必要なワーク領域サイズ分のメモリが動的に確保されます。)
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
注意
本関数を実行する前に、ライブラリを初期化しておく必要があります。

本関数にワーク領域をセットした場合、セットした領域のメモリをACBハンドル破棄時 までアプリケーション中で保持し続ける必要があります。
(セット済みのワーク領域に値を書き込んだり、メモリ解放したりしてはいけません。)

本関数は完了復帰型の関数です。
ACBファイルのロードにかかる時間は、プラットフォームによって異なります。
ゲームループ等の画面更新が必要なタイミングで本関数を実行するとミリ秒単位で 処理がブロックされ、フレーム落ちが発生する恐れがあります。
ACBファイルのロードは、シーンの切り替わり等、負荷変動を許容できる タイミングで行うようお願いいたします。
参照
criAtomExAcb_CalculateWorkSizeForLoadAcbFile, CriAtomExAcbHn, criAtomExPlayer_SetCueId

◆ criAtomExAcb_LoadAcbFileById()

CriAtomExAcbHn criAtomExAcb_LoadAcbFileById ( CriFsBinderHn  acb_binder,
CriUint16  acb_id,
CriFsBinderHn  awb_binder,
CriUint16  awb_id,
void *  work,
CriSint32  work_size 
)

ACBファイルのロード(CPKコンテンツID指定)

引数
[in]acb_binderACBファイルを含むバインダーのハンドル
[in]acb_idCPKファイル内のACBデータのID
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_idCPKファイル内のAWBデータのID
[in]workワーク領域
[in]work_sizeワーク領域サイズ
戻り値
CriAtomExAcbHn ACBハンドル
説明:
ACBファイルをロードし、キュー再生に必要な情報を取り込みます。
ファイルパスの代わりにCPKコンテンツIDを指定する点を除けば、 criAtomExAcb_LoadAcbFile 関数と機能は同じです。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
参照
criAtomExAcb_LoadAcbFile

◆ criAtomExAcb_Release()

void criAtomExAcb_Release ( CriAtomExAcbHn  acb_hn)

ACBハンドルのリリース

引数
[in]acb_hnACBハンドル
説明:
ACBハンドルを解放します。
criAtomEx_SetUserAllocator マクロを使用してアロケーターを登録済みの場合、 ACBハンドル作成時に確保されたメモリ領域が解放されます。
(ACBハンドル作成時にワーク領域を渡した場合、本関数実行後であれば ワーク領域を解放可能です。)
備考:
本関数でACBハンドルを破棄する際には、 当該ACBハンドルを参照しているキューは全て停止されます。
(本関数実行後に、ACBハンドルの作成に使用したワーク領域や、 ACBデータが配置されていた領域が参照されることはありません。)
注意
本関数を実行すると、破棄しようとしているACBデータを参照している Atomプレーヤーの存在を検索する処理が動作します。
そのため、本関数実行中に他スレッドでAtomプレーヤーの作成/破棄を行うと、 アクセス違反やデッドロック等の重大な不具合を誘発する恐れがあります。
本関数実行時にAtomプレーヤーの作成/破棄を他スレッドで行う必要がある場合、 Atomプレーヤーの作成/破棄を criAtomEx_Lock 関数でロックしてから実行ください。
参照
criAtomExAcb_LoadAcbData, criAtomExAcb_LoadAcbFile

◆ criAtomExAcb_ReleaseAll()

void criAtomExAcb_ReleaseAll ( void  )

全てのACBハンドルをリリース

説明:
ロード済みの全てのACBハンドルを解放します。
criAtomEx_SetUserAllocator マクロを使用してアロケーターを登録済みの場合、 ACBハンドル作成時に確保されたメモリ領域が解放されます。
(ACBハンドル作成時にワーク領域を渡した場合、本関数実行後であれば ワーク領域を解放可能です。)
備考:
本関数を実行すると、全てのキュー再生がその時点で停止します。
(本関数実行後に、ACBハンドルの作成に使用したワーク領域や、 ACBデータが配置されていた領域が参照されることはありません。)
注意
本関数を実行すると、指定したACBデータを参照しているAtomプレーヤーの存在を 検索する処理が動作します。
そのため、本関数実行中に他スレッドでAtomプレーヤーの作成/破棄を行うと、 アクセス違反やデッドロック等の重大な不具合を誘発する恐れがあります。
本関数実行時にAtomプレーヤーの作成/破棄を他スレッドで行う必要がある場合、 Atomプレーヤーの作成/破棄を criAtomEx_Lock 関数でロックしてから実行ください。
参照
criAtomExAcb_LoadAcbData, criAtomExAcb_LoadAcbFile

◆ criAtomExAcb_EnumerateHandles()

CriSint32 criAtomExAcb_EnumerateHandles ( CriAtomExAcbHandleCbFunc  func,
void *  obj 
)

ACBハンドルの列挙

引数
[in]funcACBハンドルコールバック関数
[in]objユーザ指定オブジェクト
戻り値
CriSint32 列挙されたACBハンドルの数
説明:
ACBハンドルを列挙します。

本関数を実行すると、第 1 引数( func ) でセットされたコールバック関数がACBハンドルの数分だけ呼び出されます。
コールバック関数には、ACBハンドルが引数として渡されます。
備考:
第 2 引数( obj )にセットした値は、コールバック関数の引数として渡されます。
コールバック関数のその他の引数については、 別途 CriAtomExAcbHandleCbFunc の説明をご参照ください。

戻り値は列挙されたACBハンドルの数(登録したコールバック関数が呼び出された回数)です。
(初回コールバック時に列挙を中止した場合でも 1 が返されます。)
ACBハンドルが存在しない場合、本関数は 0 を返します。
また、引数が不正な場合等、エラーが発生した際には -1 を返します。
注意
ACBハンドルをコールバック関数内で破棄してはいけません。
全てのACBハンドルを一括で破棄する場合には、本関数の代わりに、 criAtomExAcb_ReleaseAll 関数を使用してください。
参照
CriAtomExAcbHandleCbFunc, criAtomExAcb_ReleaseAll

◆ criAtomExAcb_GetVersion()

CriUint32 criAtomExAcb_GetVersion ( void *  acb_data,
CriSint32  acb_data_size,
void *  flag 
)

オンメモリACBのバージョン取得

引数
[in]acb_dataACBデータアドレス
[in]acb_data_sizeACBデータサイズ
[out]flagロード可能フラグ
戻り値
CriUint2 ACBフォーマットバージョン
説明:
メモリ上に配置されたACBデータのフォーマットバージョンを取得します。
また、flag引数にロード可能なバージョンかどうかをBool値で返します。

◆ criAtomExAcb_GetVersionFromFile()

CriUint32 criAtomExAcb_GetVersionFromFile ( CriFsBinderHn  acb_binder,
const CriChar8 *  acb_path,
void *  work,
CriSint32  work_size,
CriBool *  flag 
)

ACBファイルのバージョン取得

引数
[in]acb_binderACBファイルを含むバインダーのハンドル
[in]acb_pathACBファイルのパス
[in]workワーク領域
[in]work_sizeワーク領域サイズ
[out]flagロード可能フラグ
戻り値
CriUint2 ACBフォーマットバージョン
説明:
ACBファイルをメモリにロードしACBデータのフォーマットバージョンを取得します。
ACB情報の登録に必要なワーク領域のサイズは、 criAtomExAcb_CalculateWorkSizeForLoadAcbFile 関数で計算します。

ACBファイルフォーマットバージョンを元にflag引数にロード可能なバージョンかどうかをBool値で返します。
備考:
criAtomEx_SetUserAllocator マクロを使用してアロケーターを登録済みの場合、 本関数にワーク領域を指定する必要はありません。
( work に NULL 、 work_size に 0 を指定することで、登録済みのアロケーター から必要なワーク領域サイズ分のメモリが動的に確保されます。)
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
注意
本関数にセットしたワーク領域は、 アプリケーションで保持する必要はありません。
(メモリにロードしたデータは関数終了時に解放されます。)

◆ criAtomExAcb_GetSupportedVersion()

void criAtomExAcb_GetSupportedVersion ( CriUint32 *  version_low,
CriUint32 *  version_high 
)

ロード可能バージョン情報取得

引数
[out]version_lowロード可能下位バージョン
[out]version_highロード可能上位バージョン
説明:
ロード可能なACBのバージョン情報を取得します。
上位バージョンはライブラリビルド時点での情報のため、この値より上位のACBでも ロード可能な場合もあります。

◆ criAtomExAcb_GetNumCues()

CriSint32 criAtomExAcb_GetNumCues ( CriAtomExAcbHn  acb_hn)

キュー数の取得

引数
[in]acb_hnACBハンドル
戻り値
CriSint32 キュー数
説明:
ACBデータに含まれるキュー数を取得します。
備考:
引数( acb_hn )に NULL を指定した場合、最後にロードしたACBデータを処理対象とします。

◆ criAtomExAcb_ExistsId()

CriBool criAtomExAcb_ExistsId ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キューの存在確認(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
CriBool キューが存在するかどうか(存在する:CRI_TRUE/存在しない:CRI_FALSE)
説明:
指定したIDのキューが存在するかどうかを取得します。
存在した場合にはCRI_TRUEを返します。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータが検索対象となります。
(指定したIDを持つACBデータが1つでも存在すれば、本関数は CRI_TRUE を返します。)

◆ criAtomExAcb_ExistsName()

CriBool criAtomExAcb_ExistsName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューの存在確認(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriBool キューが存在するかどうか(存在する:CRI_TRUE/存在しない:CRI_FALSE)
説明:
指定した名前のキューが存在するかどうかを取得します。
存在した場合にはCRI_TRUEを返します。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータが検索対象となります。
(指定したキュー名を持つACBデータが1つでも存在すれば、本関数は CRI_TRUE を返します。)

◆ criAtomExAcb_ExistsIndex()

CriBool criAtomExAcb_ExistsIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index 
)

キューの存在確認(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
戻り値
CriBool キューが存在するかどうか(存在する:CRI_TRUE/存在しない:CRI_FALSE)
説明:
指定したインデックスのキューが存在するかどうかを取得します。
存在した場合にはCRI_TRUEを返します。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータが検索対象となります。
(指定したキューインデックスを持つACBデータが1つでも存在すれば、本関数は CRI_TRUE を返します。)

◆ criAtomExAcb_GetCueIdByIndex()

CriAtomExCueId criAtomExAcb_GetCueIdByIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index 
)

キューIDの取得(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
戻り値
CriAtomExCueId キューID
説明:
キューインデックスからキューIDを取得します。
指定したキューインデックスのキューが存在しない場合、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューインデックスに 合致するデータの存在を検索する処理が動作します。
(指定したキューインデックスを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのIDが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetCueIdByName()

CriAtomExCueId criAtomExAcb_GetCueIdByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューIDの取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriAtomExCueId キューID
説明:
キュー名からキューIDを取得します。
指定したキュー名のキューが存在しない場合、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのIDが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetCueNameByIndex()

const CriChar8* criAtomExAcb_GetCueNameByIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index 
)

キュー名の取得(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
戻り値
const CriChar8* キュー名
説明:
キューインデックスからキュー名を取得します。
指定したキューインデックスのキューが存在しない場合、NULLが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューインデックスに 合致するデータの存在を検索する処理が動作します。
(指定したキューインデックスを持つACBデータが見つかった時点で、 当該ACBデータ内のキューの名前が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetCueNameById()

const CriChar8* criAtomExAcb_GetCueNameById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キュー名の取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
const CriChar8* キュー名
説明:
キューIDからキュー名を取得します。
指定したキューIDのキューが存在しない場合、NULLが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューの名前が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetCueIndexById()

CriAtomExCueIndex criAtomExAcb_GetCueIndexById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キューインデックスの取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
CriAtomExCueIndex キューインデックス
説明:
キューIDからキューインデックスを取得します。
指定したキューIDのキューが存在しない場合、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのインデックスが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetCueIndexByName()

CriAtomExCueIndex criAtomExAcb_GetCueIndexByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューインデックスの取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriAtomExCueIndex キューインデックス
説明:
キュー名からキューインデックスを取得します。
指定したキュー名のキューが存在しない場合、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのインデックスが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetUserDataById()

const CriChar8* criAtomExAcb_GetUserDataById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

ユーザデータ文字列の取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
const CriChar8 * ユーザデータ文字列
説明:
キューIDを指定して、キューのユーザデータ文字列を取得します。
指定したキューIDのキューが存在しない場合、NULLが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのユーザデータが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetUserDataByName()

const CriChar8* criAtomExAcb_GetUserDataByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

ユーザデータ文字列の取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
const CriChar8 * ユーザデータ文字列
説明:
キュー名を指定して、キューのユーザデータ文字列を取得します。
指定したキュー名のキューが存在しない場合、NULLが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのユーザデータが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetLengthById()

CriSint64 criAtomExAcb_GetLengthById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キューの長さの取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
CriSint64 キューの長さ(ミリ秒単位)
説明:
キューIDを指定して、キューの長さを取得します。キューの長さはミリ秒単位です。
指定したキューIDのキューが存在しない場合や、無限ループするキューの場合、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューの長さが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetLengthByName()

CriSint64 criAtomExAcb_GetLengthByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューの長さの取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriSint64 キューの長さ(ミリ秒単位)
説明:
キュー名を指定して、キューの長さを取得します。キューの長さはミリ秒単位です。
指定したキュー名のキューが存在しない場合や、無限ループするキューの場合、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの長さが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetNumUsableAisacControlsById()

CriSint32 criAtomExAcb_GetNumUsableAisacControlsById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キューでコントロール可能なAISAC Controlの個数の取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
CriSint32 AISAC Controlの個数
説明:
キューIDを指定して、キューでコントロール可能なAISAC Controlの個数を取得します。
指定したキューIDのキューが存在しない場合は、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのコントロール可能なAISAC Controlの個数が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumUsableAisacControlsByName, criAtomExAcb_GetUsableAisacControlById, criAtomExAcb_GetUsableAisacControlByName

◆ criAtomExAcb_GetNumUsableAisacControlsByName()

CriSint32 criAtomExAcb_GetNumUsableAisacControlsByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューでコントロール可能なAISAC Controlの個数の取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriSint32 AISAC Controlの個数
説明:
キュー名を指定して、キューでコントロール可能なAISAC Controlの個数を取得します。
指定したキュー名のキューが存在しない場合は、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのコントロール可能なAISAC Controlの個数が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumUsableAisacControlsById, criAtomExAcb_GetUsableAisacControlById, criAtomExAcb_GetUsableAisacControlByName

◆ criAtomExAcb_GetUsableAisacControlById()

CriBool criAtomExAcb_GetUsableAisacControlById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id,
CriUint16  index,
CriAtomExAisacControlInfo info 
)

キューでコントロール可能なAISAC Controlの取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
[in]indexAISAC Controlインデックス
[out]infoAISAC Control情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キューIDとAISAC Controlインデックスを指定して、AISAC Control情報を取得します。
指定したキューIDのキューが存在しない場合は、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのAISAC Control情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumUsableAisacControlsById, criAtomExAcb_GetNumUsableAisacControlsByName, criAtomExAcb_GetUsableAisacControlByName

◆ criAtomExAcb_GetUsableAisacControlByName()

CriBool criAtomExAcb_GetUsableAisacControlByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name,
CriUint16  index,
CriAtomExAisacControlInfo info 
)

キューでコントロール可能なAISAC Controlの取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
[in]indexAISAC Controlインデックス
[out]infoAISAC Control情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キュー名とAISAC Controlインデックスを指定して、AISAC Control情報を取得します。
指定したキュー名のキューが存在しない場合は、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのAISAC Control情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumUsableAisacControlsById, criAtomExAcb_GetNumUsableAisacControlsByName, criAtomExAcb_GetUsableAisacControlById

◆ criAtomExAcb_IsUsingAisacControlById()

CriBool criAtomExAcb_IsUsingAisacControlById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id,
CriAtomExAisacControlId  aisac_control_id 
)

キューがAISAC Controlでコントロール可能かどうかの取得(ID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
[in]aisac_control_idAISAC Control id
戻り値
CriBool コントロール可能かどうか(可能:CRI_TRUE、不可能:CRI_FALSE)
説明:
キューIDとAISAC Control Idを指定して、キューがAISAC Controlでコントロール可能かどうかを取得します。
指定したキューIDのキューが存在しない場合は、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのAISAC Control情報を元に値を返します)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_IsUsingAisacControlByName

◆ criAtomExAcb_IsUsingAisacControlByName()

CriBool criAtomExAcb_IsUsingAisacControlByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name,
const CriChar8 *  aisac_control_name 
)

キューがAISAC Controlでコントロール可能かどうかの取得(名前指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
[in]aisac_control_nameAISAC Controlインデックス
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キュー名とAISAC Controlインデックスを指定して、AISAC Control情報を取得します。
指定したキュー名のキューが存在しない場合は、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのAISAC Control情報を元に値を返します)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_IsUsingAisacControlById

◆ criAtomExAcb_GetCuePriorityById()

CriSint32 criAtomExAcb_GetCuePriorityById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キューに設定されているプライオリティの取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
戻り値
CriSint32 プライオリティ(取得に失敗した場合-1が帰ります)
説明:
キューIDを指定して、キューに設定されているプライオリティを取得します。
指定したキューIDのキューが存在しない場合は、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューのプライオリティが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetCuePriorityByName

◆ criAtomExAcb_GetCuePriorityByName()

CriSint32 criAtomExAcb_GetCuePriorityByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューに設定されているプライオリティの取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriSint32 プライオリティ(取得に失敗した場合-1が帰ります)
説明:
キュー名を指定して、キューに設定されているプライオリティを取得します。
指定したキュー名のキューが存在しない場合は、-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューのプライオリティが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetCuePriorityById

◆ criAtomExAcb_GetWaveformInfoById()

CriBool criAtomExAcb_GetWaveformInfoById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id,
CriAtomExWaveformInfo waveform_info 
)

音声波形情報の取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
[out]waveform_info音声波形情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キューIDを指定して、そのキューで再生される音声波形の情報を取得します。
そのキューで再生される音声波形が複数ある場合、初めのトラックで最初に再生される音声波形の情報が取得されます。 指定したキューIDのキューが存在しない場合、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキューの音声波形情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetWaveformInfoByName()

CriBool criAtomExAcb_GetWaveformInfoByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name,
CriAtomExWaveformInfo waveform_info 
)

音声波形情報の取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
[out]waveform_info音声波形情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キュー名を指定して、そのキューで再生される音声波形の情報を取得します。
そのキューで再生される音声波形が複数ある場合、初めのトラックで最初に再生される音声波形の情報が取得されます。 指定したキュー名のキューが存在しない場合、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの音声波形情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetOnMemoryAwbHandle()

CriAtomAwbHn criAtomExAcb_GetOnMemoryAwbHandle ( CriAtomExAcbHn  acb_hn)

オンメモリ再生用 AWB ハンドルの取得

引数
[in]acb_hnACB ハンドル
戻り値
CriAtomAwbHn AWB ハンドル
説明:
ACB データからオンメモリ再生用の AWB ハンドルを取得します。
備考:
ACB データ内には、オンメモリ再生用の波形データが AWB フォーマットで格納されています。
ACB ハンドルを作成する際、 Atom ライブラリはオンメモリ再生用に AWB データを読み込み、再生用のハンドル( AWB ハンドル)を作成します。

本関数を使用することで、 Atom ライブラリが内部的に作成した AWB ハンドルを 取得することが可能です。
取得した AWB ハンドルを使用することで、 ACB ハンドル内のオンメモリ波形データを、 アプリケーション側から criAtomExPlayer_SetWaveId 関数を使用して再生することが可能になります。
(キューに含まれる波形データをシームレス連結再生する際や、 デバッグ用途で ACB データ内に含まれるオンメモリ波形データを再生する、 といった用途に利用可能です。)
注意
ACB ハンドルが保持する AWB ハンドルは、 ACB ハンドルリリース時に破棄されます。
本関数で取得した AWB ハンドルを個別に破棄したり、 取得済みの AWB ハンドルに ACB ハンドルリリース後にアクセスしたりすると、 アクセス違反等の重大な不具合が発生する可能性があります。
参照
criAtomExAcb_GetStreamingAwbHandle

◆ criAtomExAcb_GetStreamingAwbHandle()

CriAtomAwbHn criAtomExAcb_GetStreamingAwbHandle ( CriAtomExAcbHn  acb_hn)

ストリーム再生用 AWB ハンドルの取得

引数
[in]acb_hnACB ハンドル
戻り値
CriAtomAwbHn AWB ハンドル
説明:
ACB データからストリーム再生用の AWB ハンドルを取得します。
なお、本関数ではスロットの先頭の AWB ハンドルのみを取得可能です。
先頭以外のスロットにある AWB ハンドルを取得する際は以下の関数を使用してください。
備考:
ACB データ内には、ストリーム再生用の AWB ファイルが関連付けられています。
ACB ハンドルを作成する際、 Atom ライブラリはストリーム再生用に AWB データを読み込み、再生用のハンドル( AWB ハンドル)を作成します。

本関数を使用することで、 Atom ライブラリが内部的に作成した AWB ハンドルを 取得することが可能です。
取得した AWB ハンドルを使用することで、 ストリーム再生用の波形データを、 アプリケーション側から criAtomExPlayer_SetWaveId 関数を使用して再生することが可能になります。
(キューに含まれる波形データをシームレス連結再生する際や、 デバッグ用途で ACB データに関連付けられたストリーム再生用波形データを再生する、 といった用途に利用可能です。)
注意
ACB ハンドルが保持する AWB ハンドルは、 ACB ハンドルリリース時に破棄されます。
本関数で取得した AWB ハンドルを個別に破棄したり、 取得済みの AWB ハンドルに ACB ハンドルリリース後にアクセスしたりすると、 アクセス違反等の重大な不具合が発生する可能性があります。
参照
criAtomExAcb_GetOnMemoryAwbHandle

◆ criAtomExAcb_GetStreamingAwbHandleBySlotName()

CriAtomAwbHn criAtomExAcb_GetStreamingAwbHandleBySlotName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  awb_slot_name 
)

指定した AWB スロット名のストリーム再生用 AWB ハンドルの取得

引数
[in]acb_hnACB ハンドル
[in]awb_slot_nameAWB スロット名
戻り値
CriAtomAwbHn AWB ハンドル
説明:
ACB データから指定した AWB スロット名のストリーム再生用の AWB ハンドルを取得します。
備考:
ACB データ内には、ストリーム再生用の AWB ファイルが関連付けられています。
ACB ハンドルを作成する際、 Atom ライブラリはストリーム再生用に AWB データを読み込み、再生用のハンドル( AWB ハンドル)を作成します。

本関数を使用することで、 Atom ライブラリが内部的に作成した AWB ハンドルを 取得することが可能です。
取得した AWB ハンドルを使用することで、 ストリーム再生用の波形データを、 アプリケーション側から criAtomExPlayer_SetWaveId 関数を使用して再生することが可能になります。
(キューに含まれる波形データをシームレス連結再生する際や、 デバッグ用途で ACB データに関連付けられたストリーム再生用波形データを再生する、 といった用途に利用可能です。)
注意
ACB ハンドルが保持する AWB ハンドルは、 ACB ハンドルリリース時に破棄されます。
本関数で取得した AWB ハンドルを個別に破棄したり、 取得済みの AWB ハンドルに ACB ハンドルリリース後にアクセスしたりすると、 アクセス違反等の重大な不具合が発生する可能性があります。
参照
criAtomExAcb_GetOnMemoryAwbHandle

◆ criAtomExAcb_GetStreamingAwbHandleBySlotIndex()

CriAtomAwbHn criAtomExAcb_GetStreamingAwbHandleBySlotIndex ( CriAtomExAcbHn  acb_hn,
CriUint16  awb_slot_index 
)

指定した AWB スロットインデックスのストリーム再生用 AWB ハンドルの取得

引数
[in]acb_hnACB ハンドル
[in]awb_slot_indexAWB スロットインデックス
戻り値
CriAtomAwbHn AWB ハンドル
説明:
ACB データから指定した AWB スロットインデックスのストリーム再生用の AWB ハンドルを取得します。
備考:
ACB データ内には、ストリーム再生用の AWB ファイルが関連付けられています。
ACB ハンドルを作成する際、 Atom ライブラリはストリーム再生用に AWB データを読み込み、再生用のハンドル( AWB ハンドル)を作成します。

本関数を使用することで、 Atom ライブラリが内部的に作成した AWB ハンドルを 取得することが可能です。
取得した AWB ハンドルを使用することで、 ストリーム再生用の波形データを、 アプリケーション側から criAtomExPlayer_SetWaveId 関数を使用して再生することが可能になります。
(キューに含まれる波形データをシームレス連結再生する際や、 デバッグ用途で ACB データに関連付けられたストリーム再生用波形データを再生する、 といった用途に利用可能です。)
注意
ACB ハンドルが保持する AWB ハンドルは、 ACB ハンドルリリース時に破棄されます。
本関数で取得した AWB ハンドルを個別に破棄したり、 取得済みの AWB ハンドルに ACB ハンドルリリース後にアクセスしたりすると、 アクセス違反等の重大な不具合が発生する可能性があります。
参照
criAtomExAcb_GetOnMemoryAwbHandle

◆ criAtomExAcb_GetCueInfoByName()

CriBool criAtomExAcb_GetCueInfoByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name,
CriAtomExCueInfo info 
)

キュー情報の取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
[out]infoキュー情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キュー名を指定して、キュー情報を取得します。
指定したキュー名のキューが存在しない場合、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetCueInfoById, criAtomExAcb_GetCueInfoByIndex

◆ criAtomExAcb_GetCueInfoById()

CriBool criAtomExAcb_GetCueInfoById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id,
CriAtomExCueInfo info 
)

キュー情報の取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
[out]infoキュー情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キューIDを指定して、キュー情報を取得します。
指定したキューIDのキューが存在しない場合、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetCueInfoByName, criAtomExAcb_GetCueInfoByIndex

◆ criAtomExAcb_GetCueInfoByIndex()

CriBool criAtomExAcb_GetCueInfoByIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index,
CriAtomExCueInfo info 
)

キュー情報の取得(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
[out]infoキュー情報
戻り値
CriBool 取得に成功したかどうか(成功:CRI_TRUE、失敗:CRI_FALSE)
説明:
キューインデックスを指定して、キュー情報を取得します。
指定したキューインデックスのキューが存在しない場合、CRI_FALSEが返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの情報が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetCueInfoByName, criAtomExAcb_GetCueInfoById

◆ criAtomExAcb_GetNumCuePlayingCountByName()

CriSint32 criAtomExAcb_GetNumCuePlayingCountByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キューリミットが設定されているキューの発音数の取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
戻り値
CriSint32 発音数(キューリミットが設定されていないキューを指定した場合-1が帰ります)
説明:
キュー名を指定して、キューリミットが設定されているキューの発音数を取得します。
指定したキュー名のキューが存在しない場合や、キューリミットが設定されていないキューを指定した場合は-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの発音数が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumCuePlayingCountById, criAtomExAcb_GetNumCuePlayingCountByIndex

◆ criAtomExAcb_GetNumCuePlayingCountById()

CriSint32 criAtomExAcb_GetNumCuePlayingCountById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キューリミットが設定されているキューの発音数の取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID名
戻り値
CriSint32 発音数(キューリミットが設定されていないキューを指定した場合-1が帰ります)
説明:
キューIDを指定して、キューリミットが設定されているキューの発音数を取得します。
指定したキューIDのキューが存在しない場合や、キューリミットが設定されていないキューを指定した場合は-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの発音数が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumCuePlayingCountByName, criAtomExAcb_GetNumCuePlayingCountByIndex

◆ criAtomExAcb_GetNumCuePlayingCountByIndex()

CriSint32 criAtomExAcb_GetNumCuePlayingCountByIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index 
)

キューリミットが設定されているキューの発音数の取得(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
戻り値
CriSint32 発音数(キューリミットが設定されていないキューを指定した場合-1が帰ります)
説明:
キュー名を指定して、キューリミットが設定されているキューの発音数を取得します。
指定したキューインデックスのキューが存在しない場合や、キューリミットが設定されていないキューを指定した場合は-1が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキューの発音数が返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)
参照
criAtomExAcb_GetNumCuePlayingCountByName, criAtomExAcb_GetNumCuePlayingCountById

◆ criAtomExAcb_GetBlockIndexByIndex()

CriAtomExBlockIndex criAtomExAcb_GetBlockIndexByIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index,
const CriChar8 *  block_name 
)

ブロックインデックスの取得(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
[in]block_nameブロック名
戻り値
CriAtomExBlockIndex ブロックインデックス
説明:
キューインデックスとブロック名からブロックインデックスを取得します。
指定したキューインデックスのキューが存在しない場合やブロック名が存在しない場合は、 CRIATOMEX_INVALID_BLOCK_INDEX が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューインデックスに 合致するデータの存在を検索する処理が動作します。
(指定したキューインデックスを持つACBデータが見つかった時点で、 当該ACBデータ内のキュー内のブロックインデックスが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetBlockIndexById()

CriAtomExBlockIndex criAtomExAcb_GetBlockIndexById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id,
const CriChar8 *  block_name 
)

ブロックインデックスの取得(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
[in]block_nameブロック名
戻り値
CriAtomExBlockIndex ブロックインデックス
説明:
キューIDとブロック名からブロックインデックスを取得します。
指定したキューIDのキューが存在しない場合やブロック名が存在しない場合は、 CRIATOMEX_INVALID_BLOCK_INDEX が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキューIDに 合致するデータの存在を検索する処理が動作します。
(指定したキューIDを持つACBデータが見つかった時点で、 当該ACBデータ内のキュー内のブロックインデックスが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_GetBlockIndexByName()

CriAtomExBlockIndex criAtomExAcb_GetBlockIndexByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name,
const CriChar8 *  block_name 
)

ブロックインデックスの取得(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
[in]block_nameブロック名
戻り値
CriAtomExBlockIndex ブロックインデックス
説明:
キュー名とブロック名からブロックインデックスを取得します。
指定したキュー名のキューが存在しない場合やブロック名が存在しない場合は、 CRIATOMEX_INVALID_BLOCK_INDEX が返ります。
備考:
第1引数( ach_hn )に NULL を指定した場合、全てのACBデータを対象に、指定したキュー名に 合致するデータの存在を検索する処理が動作します。
(指定したキュー名を持つACBデータが見つかった時点で、 当該ACBデータ内のキュー内のブロックインデックスが返されます。)
この際、検索の順序は、ACBデータのロード順とは逆順で行われます。
(後からロードされたデータから優先的に検索が行われます。)

◆ criAtomExAcb_SetDetectionInGamePreviewDataCallback()

void criAtomExAcb_SetDetectionInGamePreviewDataCallback ( CriAtomExAcbDetectionInGamePreviewDataCbFunc  func,
void *  obj 
)

インゲームプレビュー用データのロード検知コールバック関数の登録

引数
[in]funcロード検知コールバック関数
[in]objユーザ指定オブジェクト
説明:
インゲームプレビュー用データのロードを検知した場合に呼び出すコールバック関数を登録します。
登録されたコールバック関数は、ACBロード関数内でACBの内容解析を行ったタイミングで実行されます。
注意
基本的に、コールバック関数内ではAtomライブラリAPIを使用しないでください。
本コールバック関数内で長時間処理をブロックすると、音切れ等の問題が発生しますので、 ご注意ください。

コールバック関数は1つしか登録できません。
登録操作を複数回行った場合、既に登録済みのコールバック関数が、 後から登録したコールバック関数により上書きされてしまいます。

funcにNULLを指定することで登録済み関数の登録解除が行えます。
参照
CriAtomExAcbDetectionInGamePreviewDataCbFunc

◆ criAtomExAcb_GetAcbInfo()

CriBool criAtomExAcb_GetAcbInfo ( CriAtomExAcbHn  acb_hn,
CriAtomExAcbInfo acb_info 
)

ACB情報の取得

引数
[in]acb_hnACBハンドル
[out]acb_infoACB情報
戻り値
CriBool 情報が取得できたかどうか?(取得できた:CRI_TRUE/取得できない:CRI_FALSE)
説明:
ACBデータの各種情報を取得します。
備考:
引数( acb_hn )に NULL を指定した場合、最後にロードしたACBデータを処理対象とします。
参照
CriAtomExAcbInfo

◆ criAtomExAcb_ResetCueTypeStateByName()

void criAtomExAcb_ResetCueTypeStateByName ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  name 
)

キュータイプステートのリセット(キュー名指定)

引数
[in]acb_hnACBハンドル
[in]nameキュー名
説明:
キュー名を指定して、キュータイプステートをリセットします。
注意
リセット対象は指定したキューのステートのみです。キューに含まれるサブシンセやキューリンク先の ステートはリセットされません。
備考:
キュータイプステートは、ポリフォニックタイプキュー以外のキュー再生時の前回再生トラックを ステートとして管理する仕組みです。
本関数は、ステート管理領域をリセットしACBロード直後の状態に戻します。
参照
criAtomExAcb_ResetCueTypeStateById, criAtomExAcb_ResetCueTypeStateByIndex

◆ criAtomExAcb_ResetCueTypeStateById()

void criAtomExAcb_ResetCueTypeStateById ( CriAtomExAcbHn  acb_hn,
CriAtomExCueId  id 
)

キュータイプステートのリセット(キューID指定)

引数
[in]acb_hnACBハンドル
[in]idキューID
説明:
キューIDを指定して、キュータイプステートをリセットします。
注意
リセット対象は指定したキューのステートのみです。キューに含まれるサブシンセやキューリンク先の ステートはリセットされません。
備考:
キュータイプステートは、ポリフォニックタイプキュー以外のキュー再生時の前回再生トラックを ステートとして管理する仕組みです。
本関数は、ステート管理領域をリセットしACBロード直後の状態に戻します。
参照
criAtomExAcb_ResetCueTypeStateByName, criAtomExAcb_ResetCueTypeStateByIndex

◆ criAtomExAcb_ResetCueTypeStateByIndex()

void criAtomExAcb_ResetCueTypeStateByIndex ( CriAtomExAcbHn  acb_hn,
CriAtomExCueIndex  index 
)

キュータイプステートのリセット(キューインデックス指定)

引数
[in]acb_hnACBハンドル
[in]indexキューインデックス
説明:
キューインデックスを指定して、キュータイプステートをリセットします。
注意
リセット対象は指定したキューのステートのみです。キューに含まれるサブシンセやキューリンク先の ステートはリセットされません。
備考:
キュータイプステートは、ポリフォニックタイプキュー以外のキュー再生時の前回再生トラックを ステートとして管理する仕組みです。
本関数は、ステート管理領域をリセットしACBロード直後の状態に戻します。
参照
criAtomExAcb_ResetCueTypeStateByName, criAtomExAcb_ResetCueTypeStateById

◆ criAtomExAcb_AttachAwbFile()

void criAtomExAcb_AttachAwbFile ( CriAtomExAcbHn  acb_hn,
CriFsBinderHn  awb_binder,
const CriChar8 *  awb_path,
const CriChar8 *  awb_name,
void *  work,
CriSint32  work_size 
)

ストリーム用AWBファイルのアタッチ

引数
[in]acb_hnACBハンドル
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_pathAWBファイルのパス
[in]awb_nameAWB名
[in]workアタッチで必要な追加ワーク
[in]work_size追加ワークサイズ
説明:
ACBハンドルに対してストリーム用のAWBファイルをアタッチします。 第2引数の awb_binder 、および第3引数の awb_path には、ストリーム再生用 のAWBファイルを指定します。
第5引数の awb_name はAWBをアタッチするスロットを指定するために使用します。 このため、AtomCraftが出力したAWB名(ファイル名から拡張子を取り除いた部分)を変更している場合 はオリジナルのAWB名を指定してください。
AWBファイルのアタッチを行うには、ライブラリが内部で利用するためのメモリ領域 (ワーク領域)を確保する必要があります。
AWBファイルのアタッチに失敗した場合、エラーコールバックが発生します。
失敗の理由については、エラーコールバックのメッセージで確認可能です。
備考:
ワーク領域を確保する方法には、以下の2通りの方法があります。
(a) User Allocator方式:メモリの確保/解放に、ユーザが用意した関数を使用する方法。
(b) Fixed Memory方式:必要なメモリ領域を直接ライブラリに渡す方法。

User Allocator方式を用いる場合、ユーザがワーク領域を用意する必要はありません。
workにNULL、work_sizeに0を指定するだけで、必要なメモリを登録済みのメモリ確保関数から確保します。
アタッチ時に確保されたメモリは、デタッチ時( criAtomExAcb_DetachAwbFile 関数実行時)か、ACBハンドルリリース時( criAtomExAcb_Release 関数実行時)に解放されます。

Fixed Memory方式を用いる場合、ワーク領域として別途確保済みのメモリ領域を本関数に 設定する必要があります。
ワーク領域のサイズは criAtomExAcb_CalculateWorkSizeForAttachAwbFile 関数で取得可能です。
本関数呼び出し時に criAtomExAcb_CalculateWorkSizeForAttachAwbFile 関数で取得した サイズ分のメモリを予め確保しておき、本関数に設定してください。
尚、Fixed Memory方式を用いた場合、ワーク領域はデタッチ処理( criAtomExAcb_DetachAwbFile 関数実行時)か、ACBハンドルリリース処理( criAtomExAcb_Release 関数実行時)を行うまでの間、 ライブラリ内で利用され続けます。
AWBファイルをアタッチするとライブラリ内部的にバインダー( CriFsBinderHn )とローダー( CriFsLoaderHn ) を確保します。
追加でAWBファイルをアタッチする場合、追加数分のバインダーとローダーが確保できる設定で Atomライブラリ(またはCRI File Systemライブラリ)を初期化する必要があります。
AWBファイルをアタッチするとライブラリ内部的にバインダー( CriFsBinderHn )とローダー( CriFsLoaderHn ) を確保します。
追加でAWBファイルをアタッチする場合、追加数分のバインダーとローダーが確保できる設定で Atomライブラリ(またはCRI File Systemライブラリ)を初期化する必要があります。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
参照
criAtomExAcb_DetachAwbFile, criAtomExAcb_Release, criAtomExAcb_CalculateWorkSizeForAttachAwbFile

◆ criAtomExAcb_DetachAwbFile()

void criAtomExAcb_DetachAwbFile ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  awb_name 
)

ストリーム用AWBファイルのデタッチ

引数
[in]acb_hnACBハンドル
[in]awb_nameAWB名
説明:
ACBハンドルにアタッチされているストリーム用のAWBファイルをデタッチします。 第2引数の awb_name はAWBをアタッチ時に指定したものと同じAWB名を指定指定ください。
アタッチ時のワーク領域確保にUser Allocator方式を用いた場合は、アタッチ時に確保したメモリ領域が 本関数処理時に開放されます。
参照
criAtomExAcb_AttachAwbFile

◆ criAtomExAcb_CalculateWorkSizeForAttachAwbFile()

CriSint32 criAtomExAcb_CalculateWorkSizeForAttachAwbFile ( CriFsBinderHn  awb_binder,
const CriChar8 *  awb_path 
)

ストリーム用AWBファイルのアタッチに必要なワークサイズ取得

引数
[in]awb_binderAWBファイルを含むバインダーのハンドル
[in]awb_pathAWBファイルのパス
戻り値
CriSint32 ワーク領域サイズ
戻り値
0以上正常に処理が完了
-1エラーが発生
説明:
criAtomExAcb_LoadAcbFileById 関数の実行に必要なワーク領域サイズを計算します。
備考:
データがCPKにパックされていない場合、引数binderにはNULLを指定してください。
参照
criAtomExAcb_AttachAwbFile

◆ criAtomExAcb_GetNumAwbFileSlots()

CriSint32 criAtomExAcb_GetNumAwbFileSlots ( CriAtomExAcbHn  acb_hn)

ストリーム用AWBスロット数の取得

引数
[in]acb_hnACBハンドル
戻り値
CriSint32 ストリームAWBスロット数
説明:
ACBハンドルが必要とするストリームAWBの数を取得します。

◆ criAtomExAcb_GetAwbFileSlotName()

const CriChar8* criAtomExAcb_GetAwbFileSlotName ( CriAtomExAcbHn  acb_hn,
CriUint16  index 
)

ストリーム用AWBスロットの取得

引数
[in]acb_hnACBハンドル
[in]indexスロットインデックス
戻り値
const CriChar8* ストリームAWBポート名
説明:
インデックスを指定してACBハンドル内のストリームAWBスロット名を取得します。
取得したスロット名は criAtomExAcb_AttachAwbFile 関数の第4引数や、 criAtomExAcb_DetachAwbFile 関数の第2引数のスロット指定に使用します。

◆ criAtomExAcb_IsAttachedAwbFile()

CriBool criAtomExAcb_IsAttachedAwbFile ( CriAtomExAcbHn  acb_hn,
const CriChar8 *  awb_name 
)

ストリーム用AWBファイルのアタッチ状態取得

引数
[in]acb_hnACBハンドル
[in]awb_nameAWB名
説明:
ACBハンドルにAWBファイルがアタッチされているかを取得します。 第2引数の awb_name はAWBをアタッチするスロット名です。状態を取得したいスロットのAWB名を指定してください。