【TCAX相关】TCC文件详细说明

# TCC文件版本

< tcc file version = 1.0 >
TCC文件版本信息, 保持不变即可

# 主要设置

< inherit ass header = false >
是否继承使用K值ASS文件的头部信息, 如果设为true, 则生成的ASS文件的头部信息将会和K值ASS文件相同, 如果设为false, 则生成的ASS文件的头部信息会由TCAX跟据下面部分的设置信息自动生成. 推荐设为false

< k mode = syllable >
可以设成word (normal) 或者 syl (syllable) 或者 adv (advanced), 关系到TCAX向特效脚本提供K值信息的方式, 设为word则会按照本来的K值方式提供 (或者说按K值切分文字), 设为syl则会按照字符方式提供 (或者说切割到单个字符, 如果制作K值ASS文件的时候, 没有对每个字符都指定一个K值, 则TCAX会自动为那些字符分配一个合理的K值, 并将字符以及它所对应的K值提供给特效脚本), 设成adv则会按照类似于syl, 不过切割方式改为最大不超过2个字符的方式处理. 推荐设为syl

< text layout = horizontal >
文字布局方式, 可以为水平布局, 设成hori (horizontal), 或者垂直布局, 设成vert (vertical). 推荐设为hori

< tcaxpy init = false >
是否启用特效脚本中的tcaxPy_Init函数, 如果启用, 则对应的, 需要在特效脚本中定义这个函数. tcaxPy_Init函数主要执行一些变量的初始化工作, 他会在其他函数之前执行, 且只执行一次. 如果要使用内置特效脚本, 则需要设置为true

< tcaxpy user = false >
设为true则表明你要使用自己定义的特效脚本编写模板, 即实现你自己的tcaxPy_User函数, 拓展性, 灵活性等更高, 但相对的对编程要求也更大. 设为false, 则表明要使用tcaxPy_Main函数, 也即, 预先定义好的特效脚本编写模板. tcaxPy_Main函数提供了必要的, 且方便利用的参数, 使特效编写更加轻松. 对于每个K值 (或者字符等, 具体由k mode的设置决定) tcaxPy_Main函数都会被调用一次. 推荐设为false

< tcaxpy fin = false >
是否启用特效脚本中的tcaxPy_Fin函数, 如果启用, 则对应的, 需要在特效脚本中定义这个函数. tcaxPy_Fin函数主要执行一些变量的销毁工作, 他会在最后执行, 且只执行一次. 如果要使用内置特效脚本, 则需要设置为true

# 特效脚本设置

< py file = test1.py >
特效脚本的文件名, 可以使用相对路径或者绝对路径. 推荐使用相对路径

< beg line = 1 >
该特效脚本所应用的起始行, 1表示从第一行开始生效, 0表示最后一行, -n表示倒数第n+1行

< end line = 0 >
该特效脚本所应用的结束行, 0表示到最后一行一直有效

< py file = test1.py > < beg line = 1 > < end line = 0 >
test1.py这个特效脚本从第一行开始直到最后一行都有效

< py file = test2.py > < beg line = 1 > < end line = 0 >

< py file = test3.py > < beg line = 1 > < end line = -1 >
到倒数第二行有效

< py file = test4.py > < beg line = -5 > < end line = -2 >
test4.py从倒数第6行开始到倒数第3行有效

< py file = !\test.py > < beg line = 5 > < end line = 0 >
‘!\’ 或者 ‘!/’ 表示 test.py 在TCAX程序的根目录下

< py file = !\script\test.py > < beg line = 3 > < end line = 7 >
test.py 在TCAX程序的根目录中的 script 文件夹下

< py file = !in_001.py > < beg line = 3 > < end line = 7 >
‘!’ 表示使用内置特效

# 特效相关设置

< k-timed ass file = test_k.ass >
指定K值ASS文件(SYL文件)的文件名, 为空则表明我们不需要SYL文件, 如做LOGO特效时.

< font file = simhei.ttf >
指定字体文件名, 可以使用TCAX自带的工具fontColor.exe方便地选择字体 (程序在TCAX程序根目录下tools文件夹中).

< font face id = 1 >
指定具体字体face, 对于ttf文件, 保持为1. 对于ttc文件, 推荐设为2. 说明, 一个ttc文件会包含多个字体face. 在fontColor.exe中可以清楚的看到多个face (中间会由 ‘&’ 符号隔开).

< font size = 40 >
字体大小

< fx width = 1280 >
目标视频水平分辨率

< fx height = 720 >
目标视频垂直分辨率

< fx fps = 23.976 >
目标视频帧率

< alignment = 7 >
特效在视频上的显示位置, 可取值1~9的整数, 显示位置对应数字键盘上数字键的位置.

< x offset = 30 >
相对于标准显示位置的水平偏移量

< y offset = 15 >
相对于标准显示位置的垂直偏移量

< spacing = 0 >
文字间隔

< space scale = 1.0 >
空格宽度的缩放比率. 推荐使用默认值1.0

# ASS全局风格设置

< font face name = “” >
字体名, 留空即可, TCAX会自动赋值

< bord = 1 >
边框厚度

< shad = 0 >
阴影厚度

< primary color = FFFFFF >
主要颜色, 格式为BBGGRR

< secondary color = 000000 >
辅助特效颜色, 不少内置特效中需要用到这个值

< outline color = FFFFFF >
文字边框颜色

< back color = 000000 >
文字阴影颜色

< primary alpha = 0 >
主要颜色透明度, 取值为0~255中的整数

< secondary alpha = 255 >
辅助颜色透明度

< outline alpha = 0 >
边框颜色透明度

< back alpha = 255 >
阴影颜色透明度

额外设置

< blur = 0 >
模糊度, 可以为小数