最大再生毎カテゴリ参照数再生毎の最大カテゴリ参照数です。

参照:

CriAtomExCueInfo

カテゴリID

説明:

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

参照:

criAtomExCategory_SetVolumeById, criAtomExCategory_MuteById, criAtomExCategory_SoloById

カテゴリ情報取得用構造体

説明:

カテゴリ情報を取得するための構造体です。
criAtomExAcf_GetCategoryInfo 関数に引数として渡します。

参照:

criAtomExAcf_GetCategoryInfo

ID指定によるカテゴリに対するボリューム設定

引数:

[in]	id	カテゴリID
[in]	volume	ボリューム値

説明:

ID指定でカテゴリに対してボリュームを設定します。

注意:

本関数による設定値はACFによって設定されているカテゴリボリュームを上書き変更します。
本関数による設定値とACF設定値との乗算適用は行われないことに注意してください。

ID指定によるカテゴリボリューム取得

引数:

[in]

id

カテゴリID return CriFloat32 カテゴリボリューム

説明:

ID指定でカテゴリのボリュームを取得します。

ID指定による最終カテゴリボリューム取得

引数:

[in]

id

カテゴリID return CriFloat32 カテゴリボリューム

説明:

ID指定でREACT、AISACなどの影響を受けた最終的なカテゴリのボリューム値を取得します。

備考:

最終的なカテゴリのボリューム値を取得するためにパラメータの計算処理を行うので、 負荷が大きい関数です。

名前指定によるカテゴリに対するボリューム設定

引数:

[in]	name	カテゴリ名
[in]	volume	ボリューム値

説明:

名前指定でカテゴリに対してボリュームを設定します。

注意:

本関数による設定値はACFによって設定されているカテゴリボリュームを上書き変更します。
本関数による設定値とACF設定値との乗算適用は行われないことに注意してください。

名前指定によるカテゴリボリューム取得

引数:

[in]

name

カテゴリ名 return CriFloat32 カテゴリボリューム

説明:

名前指定でカテゴリのボリュームを取得します。

名前指定による最終カテゴリボリューム取得

引数:

[in]

name

カテゴリ名 return CriFloat32 カテゴリボリューム

説明:

名前指定でREACT、AISACなどの影響を受けた最終的なカテゴリのボリューム値を取得します。

備考:

最終的なカテゴリのボリューム値を取得するためにパラメータの計算処理を行うので、 負荷が大きい関数です。

ID指定によるカテゴリミュート状態設定

引数:

[in]	id	カテゴリID
[in]	mute	ミュート状態（CRI_TRUE = ミュート、CRI_FALSE = ミュート解除）

説明:

ID指定でカテゴリのミュート状態を設定します。

ID指定によるカテゴリミュート状態取得

引数:

[in]

id

カテゴリID return CriBool ミュート状態（CRI_TRUE = ミュート中、CRI_FALSE = ミュートされていない）

説明:

ID指定でカテゴリのミュート状態を取得します。

名前指定によるカテゴリミュート状態設定

引数:

[in]	name	カテゴリ名
[in]	mute	ミュート状態（CRI_TRUE = ミュート、CRI_FALSE = ミュート解除）

説明:

名前指定でカテゴリのミュート状態を設定します。

名前指定によるカテゴリミュート状態取得

引数:

[in]

name

カテゴリ名 return CriBool ミュート状態（CRI_TRUE = ミュート中、CRI_FALSE = ミュートされていない）

説明:

名前指定でカテゴリのミュート状態を取得します。

ID指定によるカテゴリソロ状態設定

引数:

[in]	id	カテゴリID
[in]	solo	ソロ状態（CRI_TRUE = ソロ、CRI_FALSE = ソロ解除）
[in]	mute_volume	他のカテゴリに適用するミュートボリューム値

説明:

ID指定でカテゴリのソロ状態を設定します。
mute_volumeで指定したボリュームは同一カテゴリグループに所属する カテゴリに対して適用されます。

ID指定によるカテゴリソロ状態取得

引数:

[in]

id

カテゴリID return CriBool ソロ状態（CRI_TRUE = ソロ中、CRI_FALSE = ソロではない）

説明:

ID指定でカテゴリのソロ状態を取得します。

名前指定によるカテゴリソロ状態設定

引数:

[in]	name	カテゴリ名
[in]	solo	ソロ状態（CRI_TRUE = ソロ、CRI_FALSE = ソロ解除）
[in]	mute_volume	他のカテゴリに適用するミュートボリューム値

説明:

名前指定でカテゴリのソロ状態を設定します。
mute_volumeで指定したボリュームは同一カテゴリグループに所属する カテゴリに対して適用されます。

名前指定によるカテゴリソロ状態取得

引数:

[in]

name

カテゴリ名 return CriBool ソロ状態（CRI_TRUE = ソロ中、CRI_FALSE = ソロではない）

説明:

名前指定でカテゴリのソロ状態を取得します。

ID指定によるカテゴリのポーズ／ポーズ解除

引数:

[in]	id	カテゴリID
[in]	sw	スイッチ（CRI_FALSE = ポーズ解除、CRI_TRUE = ポーズ）

説明:

ID指定でカテゴリのポーズ／ポーズ解除を行います。
criAtomExCategory_SetFadeOutTimeById 関数や::criAtomExCategory_SetFadeOutTimeByName 関数でフェードアウト時間が設定されている場合にポーズを行うと、設定された時間でフェードアウトした後に実際にポーズします。
criAtomExCategory_SetFadeInTimeById 関数や::criAtomExCategory_SetFadeInTimeByName 関数でフェードイン時間が設定されている場合にポーズ解除を行うと、ポーズ解除後、設定された時間でフェードインします。

備考:

カテゴリのポーズは、AtomExプレーヤ／再生音のポーズ （::criAtomExPlayer_Pause 関数や::criAtomExPlayback_Pause 関数でのポーズ）とは独立して扱われ、 音声の最終的なポーズ状態は、それぞれのポーズ状態を考慮して決まります。
すなわち、どちらかがポーズ状態ならポーズ、どちらもポーズ解除状態ならポーズ解除、となります。

ID指定によるカテゴリのポーズ状態取得

引数:

[in]

id

カテゴリID return CriBool ポーズ状態

説明:

ID指定でカテゴリのポーズ状態を取得します。

名前指定によるカテゴリのポーズ／ポーズ解除

引数:

[in]	name	カテゴリ名
[in]	sw	スイッチ（CRI_FALSE = ポーズ解除、CRI_TRUE = ポーズ）

説明:

名前指定でカテゴリのポーズ／ポーズ解除を行います。
カテゴリを名前で指定する以外は、::criAtomExCategory_PauseById 関数と仕様は同じです。

参照:

criAtomExCategory_PauseById

名前指定によるカテゴリのポーズ状態取得

引数:

[in]

name

カテゴリ名 return CriBool ポーズ状態

説明:

名前指定でカテゴリのポーズ状態を取得します。

フェードイン時間の設定（カテゴリID指定）

引数:

[in]	id	カテゴリID
[in]	ms	フェードイン時間（ミリ秒単位）

説明:

カテゴリにフェードイン時間を設定します。
フェードイン時間はポーズ解除を行った際に利用されます。

フェードイン時間の設定（カテゴリ名指定）

引数:

[in]	name	カテゴリ名
[in]	ms	フェードイン時間（ミリ秒単位）

説明:

カテゴリにフェードイン時間を設定します。
フェードイン時間はポーズ解除を行った際に利用されます。

フェードアウト時間の設定（カテゴリID指定）

引数:

[in]	id	カテゴリID
[in]	ms	フェードアウト時間（ミリ秒単位）

説明:

カテゴリにフェードアウト時間を設定します。
フェードアウト時間はポーズを行った際に利用されます。

フェードアウト時間の設定（カテゴリ名指定）

引数:

[in]	name	カテゴリ名
[in]	ms	フェードアウト時間（ミリ秒単位）

説明:

カテゴリにフェードアウト時間を設定します。
フェードアウト時間はポーズを行った際に利用されます。

ID指定によるカテゴリに対するAISACコントロール値設定

引数:

[in]	id	カテゴリID
[in]	control_id	AISACコントロールID
[in]	control_value	AISACコントロール値

説明:

ID指定でカテゴリに対してAISACコントロール値を設定します。

備考:

カテゴリをID、AISACコントロールを名前で指定したい場合、::criAtomExAcf_GetAisacControlIdByName 関数にて変換を行ってください。

注意:

キューやトラックに設定されているAISACに関しては、プレーヤでのAISACコントロール値設定よりも、カテゴリのAISACコントロール値を優先して参照します。
カテゴリにアタッチしたAISACについては、常にカテゴリに設定したAISACコントロール値のみ、参照されます。

参照:

criAtomExCategory_SetAisacControlByName, criAtomExCategory_AttachAisacById, criAtomExCategory_AttachAisacByName

名前指定によるカテゴリに対するAISACコントロール値設定

引数:

[in]	name	カテゴリ名
[in]	control_name	AISACコントロール名
[in]	control_value	AISACコントロール値

説明:

名前指定でカテゴリに対してAISACコントロール値を設定します。
カテゴリおよびAISACコントロールを名前で指定する以外は、::criAtomExCategory_SetAisacControlById 関数と仕様は同じです。

備考:

カテゴリを名前、AISACコントロールをIDで指定したい場合、::criAtomExAcf_GetAisacControlNameById 関数にて変換を行ってください。

参照:

criAtomExCategory_SetAisacControlById, criAtomExCategory_AttachAisacById, criAtomExCategory_AttachAisacByName

ID指定でカテゴリにアタッチされている全てのAISACコントロール値をデフォルト値に設定する

引数:

[in]

id

カテゴリID

戻り値:

CRI_TRUE	= 成功
CRI_FALSE	= 失敗

説明:

カテゴリにアタッチされている全てのAISACコントロール値をデフォルト値に設定します。
存在しないカテゴリを指定した場合、CRI_FALSEが返ります。

参照:

criAtomExCategory_GetNumAttachedAisacsById

名前指定でカテゴリにアタッチされている全てのAISACコントロール値をデフォルト値に設定する

引数:

[in]

name

カテゴリ名

戻り値:

CRI_TRUE	= 成功
CRI_FALSE	= 失敗

説明:

カテゴリにアタッチされている全てのAISACコントロール値をデフォルト値に設定します。
存在しないカテゴリを指定した場合、CRI_FALSEが返ります。

参照:

criAtomExCategory_GetNumAttachedAisacsById

ID指定でカテゴリにAISACを取り付ける

引数:

[in]	id	カテゴリID
[in]	global_aisac_name	取り付けるグローバルAISAC名

説明:

カテゴリにAISACをアタッチ（取り付け）します。 AISACをアタッチすることにより、キューやトラックにAISACを設定していなくても、AISACの効果を得ることができます。

AISACのアタッチに失敗した場合、関数内でエラーコールバックが発生します。
AISACのアタッチに失敗した理由については、エラーコールバックのメッセージを確認してください。

備考:

全体設定（ACFファイル）に含まれるグローバルAISACのみ、アタッチ可能です。
AISACの効果を得るには、キューやトラックに設定されているAISACと同様に、該当するAISACコントロール値を設定する必要があります。

注意:

キューやトラックに「AISACコントロール値を変更するAISAC」が設定されていたとしても、 その適用結果のAISACコントロール値は、カテゴリにアタッチしたAISACには影響しません。
カテゴリにアタッチしたAISACについては、常にカテゴリに設定したAISACコントロール値のみ、参照されます。
現在、「オートモジュレーション」や「ランダム」といったコントロールタイプのAISACのアタッチには対応しておりません。
現在、カテゴリにアタッチできるAISACの最大数は、8個固定です。

参照:

criAtomExCategory_DetachAisacById

名前指定でカテゴリにAISACを取り付ける

引数:

[in]	name	カテゴリ名
[in]	global_aisac_name	取り付けるグローバルAISAC名

説明:

カテゴリにAISACをアタッチ（取り付け）します。 カテゴリを名前で指定する以外は、::criAtomExCategory_AttachAisacById 関数と仕様は同じです。

参照:

criAtomExCategory_AttachAisacById, criAtomExCategory_DetachAisacByName

ID指定でカテゴリからAISACを取り外す

引数:

[in]	id	カテゴリID
[in]	global_aisac_name	取り外すグローバルAISAC名

説明:

カテゴリからAISACをデタッチ（取り外し）します。

AISACのデタッチに失敗した場合、関数内でエラーコールバックが発生します。
AISACのデタッチに失敗した理由については、エラーコールバックのメッセージを確認してください。

参照:

criAtomExCategory_AttachAisacById

名前指定でカテゴリからAISACを取り外す

引数:

[in]	name	カテゴリ名
[in]	global_aisac_name	取り外すグローバルAISAC名

説明:

カテゴリからAISACをデタッチ（取り外し）します。
カテゴリを名前で指定する以外は、::criAtomExCategory_DetachAisacById 関数と仕様は同じです。

参照:

criAtomExCategory_DetachAisacById, criAtomExCategory_AttachAisacByName

ID指定でカテゴリから全てのAISACを取り外す

引数:

[in]

id

カテゴリID

説明:

カテゴリから全てのAISACをデタッチ（取り外し）します。

名前指定でカテゴリから全てのAISACを取り外す

引数:

[in]

name

カテゴリ名

説明:

カテゴリから全てのAISACをデタッチ（取り外し）します。

ID指定でカテゴリにアタッチされているAISAC数を取得する

引数:

[in]

id

カテゴリID

戻り値:

カテゴリにアタッチされているAISAC数

説明:

カテゴリにアタッチされているAISAC数を取得します。
存在しないカテゴリを指定した場合、負値が返ります。

名前指定でカテゴリにアタッチされているAISAC数を取得する

引数:

[in]

name

カテゴリ名

戻り値:

カテゴリにアタッチされているAISAC数

説明:

カテゴリにアタッチされているAISAC数を取得します。 存在しないカテゴリを指定した場合、負値が返ります。

ID指定でカテゴリにアタッチされているAISACの情報を取得する

引数:

[in]	id	カテゴリID
[in]	aisac_attached_index	アタッチされているAISACのインデックス
[out]	aisac_info	AISAC情報

戻り値:

CRI_TRUE	= 情報が取得できた
CRI_FALSE	= 情報が取得できなかった

説明:

カテゴリにアタッチされているAISACの情報を取得します。
存在しないカテゴリを指定した場合や、無効なインデックスを指定した場合、CRI_FALSEが返ります。

参照:

criAtomExCategory_GetNumAttachedAisacsById

名前指定でカテゴリにアタッチされているAISACの情報を取得する

引数:

[in]	name	カテゴリ名
[in]	aisac_attached_index	アタッチされているAISACのインデックス
[out]	aisac_info	AISAC情報

戻り値:

CRI_TRUE	= 情報が取得できた
CRI_FALSE	= 情報が取得できなかった

説明:

カテゴリにアタッチされているAISACの情報を取得します。
存在しないカテゴリを指定した場合や、無効なインデックスを指定した場合、CRI_FALSEが返ります。

参照:

criAtomExCategory_GetNumAttachedAisacsByName

ID指定でカテゴリにアタッチされているAISACコントロールの現在値を取得する

引数:

[in]	id	カテゴリID
[in]	aisac_control_id	AISACコントロールID
[out]	control_value	AISACコントロールの現在値

戻り値:

CRI_TRUE	= 情報が取得できた
CRI_FALSE	= 情報が取得できなかった

説明:

カテゴリにアタッチされているAISACコントロールの現在値を取得します。
存在しないカテゴリやAISACコントロールを指定した場合、CRI_FALSEが返ります。

参照:

criAtomExCategory_GetNumAttachedAisacsById

名前指定でカテゴリにアタッチされているAISACコントロールの現在値を取得する

引数:

[in]	name	カテゴリ名
[in]	aisac_control_name	AISACコントロール名
[out]	control_value	AISACコントロールの現在値

戻り値:

CRI_TRUE	= 情報が取得できた
CRI_FALSE	= 情報が取得できなかった

説明:

カテゴリにアタッチされているAISACコントロールの現在値を取得します。
存在しないカテゴリを指定した場合や、無効なインデックスを指定した場合、CRI_FALSEが返ります。

参照:

criAtomExCategory_GetNumAttachedAisacsById

ID指定でカテゴリに所属する発音中のキュー数を取得する

引数:

[in]

id

カテゴリID

戻り値:

カテゴリに所属する発音中のキュー数

説明:

カテゴリに所属する発音中のキュー数を取得します。
存在しないカテゴリを指定した場合、負値が返ります。

名前指定でカテゴリに所属する発音中のキュー数を取得する

引数:

[in]

name

カテゴリ名

戻り値:

カテゴリに所属する発音中のキュー数

説明:

カテゴリに所属する発音中のキュー数を取得します。 存在しないカテゴリを指定した場合、負値が返ります。

ID指定でカテゴリに所属する発音中のキュー数を停止する

引数:

[in]

id

カテゴリID

説明:

指定したカテゴリに所属する発音中のキュー数を停止します。

名前指定でカテゴリに所属する発音中のキュー数を停止する

引数:

[in]

name

カテゴリ名

説明:

指定したカテゴリに所属する発音中のキュー数を停止します。

ID指定でカテゴリに所属する発音中のキュー数を即時停止する

引数:

[in]

id

カテゴリID

説明:

指定したカテゴリに所属する発音中のキュー数を即時停止します。

名前指定でカテゴリに所属する発音中のキュー数を即時停止する

引数:

[in]

name

カテゴリ名

説明:

指定したカテゴリに所属する発音中のキュー数を即時停止します。