キュー作成情報CSVからキューの作成

「キュー作成情報CSVからキューの作成」とは、シンプルなCSVからキューを作成する機能です。
キュー作成情報が書かれたCSVを読み込み、キューを作成します。

CSVから作成するメリット

再生するマテリアルは異なるが、パラメータや構造が同じキューシートを大量に作成する時に
CSVをテンプレートのように利用することができます。
マテリアルの差し替えは、CSVの情報をエクセルやテキストツールで置換して変更します。

キューの細かな最終調整はCRI Atom Craft上で行いますが、
導入となるデータの作成はCRI Atom Craft外で行うことが可能となり、分業することも可能です。

操作の流れ

  1. CRI Atom Craftを起動
  2. プロジェクトを開く
  3. マテリアルを登録（例：波形の入ったフォルダをマテリアルルートへドロップ）
  4. キューシートの右クリックのメニューから、「キュー作成情報CSVからキューの作成」メニューを選ぶ
  5. ファイルを指定（このファイルで指定しているマテリアルはあらかじめ用意が必要です。詳細後述）
  6. キューが追加される

入出力

  • 入力: テキストファイル (拡張したCSV形式)
  • 出力: キュー

テキストフォーマット

基本

0,gun1.wav,銃声
1,bomb1.wav,爆発

「キューID,マテリアル名,テキスト」 の一行で1キューが作成可能

テキストは省略可能です。後述する拡張機能で利用可能です。

一つのキューに複数波形を指定する

連続して同じキューIDの場合は一つのキューにまとめます。

0,footstep1.wav
0,footstep2.wav
0,footstep3.wav

キュー名について

キュー名は、拡張子を除いた名前で生成されます。

コメントの記述

「//」で始まる行はコメントとして認識します。
この仕組みを知らない人向けにコメントを書いておくことが可能です。
コメント行は基本的に無視されますが、後述の拡張機能で解釈を変更することも可能です。

// この行はコメントです。下の3つは同じキュー「footstep1」として作成されます。
0,footstep1.wav,足音1
0,footstep2.wav,足音2
0,footstep3.wav,足音3
1,cancel.wav,システムキャンセル音
2,ok.wav,システム決定音

コメント、パース処理の詳細

カンマ、タブが区切り文字です。 スペースは区切り文字として認識しません。

テキストについて

#CopyTextTo CueComment
#CopyTextTo UserData

の拡張コマンドがある場合、テキストを指定の項目（キューコメントまたはユーザーデータ）へ書き込みます。
空欄の場合は書き込みません。

#CopyTextTo CueComment UseBlank
#CopyTextTo UserData UseBlank

とすると空欄も扱います。（キューコメントやユーザーデータに空文字を書き込む）
同じキューの場合、テキストは上書きされます。

サンプル

#MaterialPath voice/
//===================================================
// CSVのフォーマットテスト
//===================================================
#CopyTextTo CueComment
1, TEST_01_A.wav,これは上書きされる
1, TEST_01_B.wav,キューのコメントとして
#CopyTextTo UserData
2, TEST_02_C.wav,ユーザーデータ1として
3, TEST_03_D.wav,ユーザーデータ2として
4, sin.wav,これはサイン波形です
#CopyTextTo CueComment UseBlank
5, TEST_05_E.wav,空白で上書きされる
5, TEST_05_E.wav,

追加時には初期値を参照する

「ツール設定」の「初期値設定」を参照します。

列フォーマット

列名の解釈方法で、「キューID,マテリアル参照先」は固定です。

ビルド設定ダイアログの設定項目

項目 説明 補足
CueId キューID(数値) 同じ番号の場合同じキューとして設定される。（先頭のキュー名で作成される）
MaterialPath マテリアル名(パス名) マテリアルルートからパス名で全検索し、最初に見つけたものを使用します。
テキスト 任意のテキスト テキストを拡張コマンドで利用する。キューコメントやユーザーデータとして扱われる。

拡張コマンド

CSVの解釈の前に＃から始まる行を加えることで、その行以下の動作を拡張することができます。

項目 内容 説明
#CopyTextTo CueComment CSVのコメントをキューのコメント欄にコピーします。 (CopyTextTo指定が無い時のデフォルト)
UseBlankで複数トラックがある時に空白による上書きを利用する。
#CopyTextTo CueComment UseBlank
#CopyTextTo UserData CSVのコメントをキューのユーザーデータ欄にコピーします。 UseBlankで複数トラックがある時に空白による上書きを利用する。
#CopyTextTo UserData UseBlank
#MaterialPath マテリアルのパス指定 例：#MaterialPath system/
#GenerateCueNameBy CueID キュー名を「Cue番号(キューID)」としてキューを生成します。
#GenerateCueNameBy MaterialName キュー名を「マテリアル名から拡張子を省いたもの」で生成します。 (GenerateCueNameBy指定が無い時のデフォルト)

マテリアルパス

マテリアルの参照先パスの前方に文字列を追記して検索します。
未指定の場合はマテリアルルートから全検索します。

//マテリアルフォルダのパス system以下から検索
#MaterialPath system/
0,ok.wav
1,cancel.wav
//マテリアルフォルダのパス weapon以下から検索
#MaterialPath weapon/
1,gun1.wav
//マテリアルフォルダのパス bgm以下から検索
#MaterialPath bgm/
2,title.wav
3,game.wav
4,gameover.wav

GenerateCueNameBy CueID

キューIDで作成されます。例えば

#GenerateCueNameBy CueID
0,gun1.wav
0,gun1.wav

というCSVを読み込むと

Cue0

が作成されます。
キューIDでしか呼ばないようなプロジェクトの場合に利用します。

エラー処理

読み込みCSV内で、キューIDが同じものがある場合、マージしたことをログに出力します。
同名のキュー、同キューIDのキューが作成された場合もログに出力します。
エラー状態のCSVは読み込み後のビルド処理などでもエラーになるため、適宜修正が必要です。

項目 説明
キュー名が同じものがある場合 キュー名が重複したまま読み込まれ、再リンク時にエラー。
キューIDが同じものがある場合 キューIDが重複したまま読み込まれ、再リンク時にエラー。
リンク先マテリアルが見つからない場合 見つからないまま読み込まれ、再リンク時にエラー。

ドラッグ&ドロップによる操作

「キュー作成CSVフォーマット」のCSVファイルを、ワークユニットツリーのキューシートフォルダへドロップした時、CSVのファイル名でキューシートを作成します。
このとき、既に同名のキューシートが存在した時はエラーになります。