利用Cue创建信息CSV创建Cue

“从Cue创建信息的CSV创建Cue”是从简单的CSV创建Cue的功能。
可读取写有Cue创建信息的CSV并创建Cue。

从CSV创建的好处

尽管要播放的素材不同，但参数和结构相同的Cue Sheet被大量创建时，
也可以像模板一样使用CSV。
要替换素材，可用EXCEL或文本工具替换并更改CSV信息。

虽然Cue的精细的最终调整是在CRI Atom Craft上执行，
但创建导入数据可以在CRI Atom Craft外执行，更可分工完成。

操作流程

1. 启动CRI Atom Craft
2. 打开项目
3. 注册素材（例：将波形文件夹拖放到素材根目录）
4. 准备要加载的Cue Sheet
5. 打开Cue创建信息CSV
   从Cue Sheet的右键点击菜单中选择“从Cue创建信息的CSV创建Cue”菜单。
   （此CSV文件中指定的素材（3.）必须预先准备。）
6. 添加Cue

拖放以打开Cue创建信息CSV

• 创建和加载Cue Sheet
  将“创建Cue的CSV格式”的CSV文件拖放到工作单元树的Cue Sheet文件夹时，将使用CSV文件名创建Cue Sheet。
  

输入输出

• 输入: 文本文件 (扩展CSV格式)
• 输出: Cue

文本格式

基本

输入csv

0,gun1.wav,枪声       
1,bomb1.wav,爆炸                                                              

結果

CueID	Cue名
0	gun1
1	bomb1

可以创建以上的Cue。

可以用一行“Cue ID,素材名,文本” 创建一个Cue。

文本可以省略。可以在后述的扩展功能中使用。

在一个Cue中指定多个波形

将连续且Cue ID相同的波形合并到一个Cue中。

输入csv

0，footstep1.wav
0，footstep2.wav
0，footstep3.wav

結果

CueID	Cue名
0	footstep1

Cue名

用不带扩展名的名称创建Cue名。

记述注释

以“//”开头的行将识别为注释。
可以为不了解该机制的人写注释。
注释行基本上会被忽略，但也可以通过后述的扩展功能更改注释。

// 本行是注释。创建以下三个相同的Cue“footstep1”。
#CopyTextTo CueComment
0，footstep1.wav，脚步声1
0，footstep2.wav，脚步声2
0，footstep3.wav，脚步声3
1，cancel.wav，系统取消声
2，ok.wav，系统确定声

結果

CueID	Cue名	注释
0	footstep1	脚步声3
1	cancel	系统取消声
2	ok	系统确定声

注释、解析处理的详细信息

逗号、制表符是分隔符。 空格不识别为分隔符。

文本

#CopyTextTo CueComment
#CopyTextTo UserData

如果有扩展命令，会将文本写入指定项目（Cue注释或用户数据）。
空白时不会写入。

#CopyTextTo CueComment UseBlank
#CopyTextTo UserData UseBlank

如上的空白也被处理。（向Cue注释和用户数据写入空字符）
如果是同一Cue，文本将被覆盖。

示例

#MaterialPath voice/                            
//===================================================
// CSV的格式测试                         
//===================================================
#CopyTextTo CueComment                      
1, TEST_01_A.wav,被覆盖                            
1, TEST_01_B.wav,作为Cue的注释                       
#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,                       

結果

CueID	Cue名	注释	用户数据
1	TEST_01_A	作为Cue的注释
2	TEST_02_C		作为用户数据1
3	TEST_03_D		作为用户数据2
4	sin		此为sin波形
5	TEST_05_E

添加时引用预设值

参照“工具设置”的“预设值设置”。

扩展命令

在解释CSV之前添加以＃开始的行，可以扩展该行下的动作。

项目	内容	说明
#CopyTextTo CueComment	将CSV的注释复制到Cue的注释列。	(未指定CopyTextTo时预设) UseBlank有多个音轨时，利用空白覆盖。 #CopyTextTo CueComment UseBlank
#CopyTextTo UserData	将CSV的注释复制到Cue的用户数据列。	UseBlank有多个音轨时，利用空白覆盖。 #CopyTextTo UserData UseBlank
#MaterialPath	指定Material路径	例：#MaterialPath system/

项目	内容	说明	列格式
#GenerateCueNameBy MaterialName	创建“Material名去掉扩展名”的Cue名	(未指定GenerateCueNameBy时的预设)	“Cue ID, 素材名, 文本”例：0,gun1.wav,枪声
#GenerateCueNameBy CueID	创建Cue名为Cue0“Cue(CueID的号码)”。		“Cue ID, 素材名, 文本”例：0,gun1.wav,枪声
#GenerateCueNameBy CueName	创建指定的Cue名。		“Cue名, 素材名, 文本”例：gun,gun1.wav,枪声

列格式的详细信息

项目	说明	补充
Cue名	Cue名	同一名名称的情况下，设置为同一个Cue。（以第一个Cue名创建）
CueId	Cue ID(数值)	同一编号的情况下，设置为同一个Cue。（以第一个Cue名创建）
Material名	素材名(路径名)	从素材根执行路径名的全部搜索，使用找到的第一个路径名。
文本	任意文本	用扩展命令使用文本。作为Cue注释和用户数据处理。

#GenerateCueNameBy CueName的例子

Cue名以第一个元素的字符串创建。

#GenerateCueNameBy CueName
#CopyTextTo CueComment
footsteps,footstep1.wav,脚步声1
footsteps,footstep2.wav,脚步声2
footsteps,footstep3.wav,脚步声3
cancel,cancel.wav,系统取消声
ok,ok.wav,系统确定声

結果

CueID	Cue名	注释
0	footsteps	脚步声
1	cancel	系统取消声
2	ok	系统确定声

CueID将自动分配。

#GenerateCueNameBy CueID的例子

Cue名称以诸如Cue0之类的名称创建。 用于仅可以调用CueID的项目。

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

读取如此的CSV时

Cue ID	Cue名
0	Cue0
1	Cue1

将被创建。

#MaterialPath的例子

在素材的引用目标路径前添加字符串进行搜索。
未指定时，从素材根目录开始全部搜索。

//素材文件夹的路径 从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

#SeqType的例子

#GenerateCueNameBy CueName
#CopyTextTo CueComment
#SeqType RandomNoRepeat
footsteps,footstep1.wav,脚步声1
footsteps,footstep2.wav,脚步声2
footsteps,footstep3.wav,脚步声3
#SeqType Polyphonic
cancel,cancel.wav,系统取消声
ok,ok.wav,系统确定声

結果

CueID	Cue名	注释
0	footsteps	脚步声
1	cancel	系统取消声
2	ok	系统确定声

footsteps的Cue是以序列类型的随机无重复创建。

项目	内容	说明
#SeqType	Cue的序列类型	未指定时为Polyphonic。
#SeqType Polyphonic	复音	序列类型将变为复音。
#SeqType Sequential	顺序	序列类型将变为顺序。
#SeqType Shuffle	乱序	序列类型将变为乱序。
#SeqType Random	随机	序列类型将变为随机。没有权重设置。
#SeqType RandomNoRepeat	随机无重复	序列类型将变为随机无重复。
#SeqType Switch	切换	序列类型将变为切换。
#SeqType ComboSequential	顺序连击	序列类型将变为顺序连击。

错误处理和日志输出

由于“从Cue创建信息的CSV创建Cue”而发生了错误时，则错误内容将输出到日志窗格。
错误出現时，请修复CSV并重新导入，或者修复已创建的Cue Sheet以解决问题。
（不解决此问题将在ACB在构建过程中也会发生错误，引致不能输出ACB数据。）
如果读取的CSV中存在具有相同Cue ID，则合并后输出到日志。此不是错误。
得到预期以外的结果时，请检查日志。
。

读取结果	错误因素
不能创建Cue Sheet	用拖放添加时，已经存在与csv名同名的Cue Sheet。
Cue Sheet中的Cue名重复	CSV中有相同Cue名的元素（Cue ID不相同），合并源中已经存在相同的Cue名。
Cue Sheet中的Cue ID重复	在CSV中有相同Cue ID的元素，合并源中已经存在相同的Cue ID。
未找到链接目标素材	指定的路径中沒有素材。