The basic work unit of TCAX is a TCAX FX project (or simply called a project). It usually contains one TCC file, one SYL file, one Font file and several tcaxPy scripts. Two most common TCAX FX project types are the TCAX karaoke FX project and the TCAX LOGO FX project. You can refer to this thread for more information about these terms.
The Process
1.
TCC file --> TCAX --> + name of the SYL file
|
+ name of the Font file
|
+ name(s) of the tcaxPy script(s)
|
+ other information
2.
SYL file +
|
Font file +-> TCAX --> + timing information
|
+ positioning information
|
+ other information
3.
timing information +
|
positioning information +
|
other information +-> tcaxPy script(s) --> + ASS buffer
|
+ TCAS buffer
4.
ASS buffer +
|
TCAS buffer +-> TCAX --> + ASS file
|
+ TCAS file
Firstly, TCAX parses the TCC file of the project to get the file names of the SYL file, the Font file and the tcaxPy script(s), and gathers some other information about the project. Then, TCAX reads the SYL file according to the file name retrieved from the TCC file, and retrieves the timing information of the syllables as well as the texts. TCAX calculates the positioning metrics according to the Font specified by the TCC file. After the information gathering process, TCAX then sends the information to the tcaxPy script(s), the task remained for the script(s) is to make full use of these information and the APIs provided by TCAX and its components to create awesome FXs. The FXs are stored in ASS buffer and TCAS buffer, which will then be returned to TCAX and written into files. The products of TCAX are the ASS file and the TCAS file. Lastly, we can preview the FXs using filters named VSFilter (for ASS files) and TcasFilter (for TCAS files).
About tcaxPy scripts
TCAX can handle multiple scripts, and you can also specify the lines which the scripts will be applied. e.g.,
# in TCC file
< py file = test1.py > < beg line = 1 > < end line = 0 > # 1 means the first line
< py file = test2.py > < beg line = 1 > < end line = 0 > # 0 means the last line
< py file = test3.py > < beg line = 1 > < end line = -1 > # -1 means the second line from the bottom
< py file = test4.py > < beg line = 1 > < end line = -2 > # -2 means the third line from the bottom
< py file = !\test.py > < beg line = 5 > < end line = 0 > # ‘!\’ or ‘!/’ indicates that ‘test.py’ is in the TCAX’s root directory
< py file = !\script\test.py > < beg line = 3 > < end line = 7 > # ‘test.py’ is in the ‘script’ folder of the TCAX’s root directory
复制代码
The scripts will then be executed in the order of their appearance, on by one.
If the script cannot be found on the specified path, TCAX will check its program's root directory to see whether there is a script named just the same as you specified.
TCAX的基本工作单元是TCAX FX项目（或简称为项目）。它通常包含一个TCC 文件、一个SYL 文件、一个Font 文件和几个tcaxPy 脚本。两种最常见的 TCAX FX 项目类型是 TCAX 卡拉 OK FX 项目和 TCAX LOGO FX 项目。您可以参考此线程以获取有关这些术语的更多信息。
.gif)