全局变量
tcaxPy_Version = '0.7.9.0'
Main_Style = 'TCMS' # 主Style名称 SubL函数默认使用的Style
Pix_Style = 'TCPS' # 粒子特效的Style名称
val_AssHeader = 0 # Ass文件头部信息 用于tcaxPy_User函数
val_OutFile = 1 # 输出的文件名 不含拓展名 用于tcaxPy_User函数
# tcc info
val_FontFileName = 2 # 特效使用的字体
val_FaceID = 3 # 字体名称ID
val_FontSize = 4 # 字体大小
val_ResolutionX = 5 # 水平分辨率
val_ResolutionY = 6 # 垂直分辨率
val_FXFPS = 7 # 特效的帧率
val_Alignment = 8 # 对齐方式
val_OffsetX = 9 # 水平偏移量
val_OffsetY = 10 # 垂直偏移量
val_Spacing = 11 # 字体间距
val_SpaceScale = 12 # 空格跨度百分比
val_Bord = 13 # 字体边框厚度
val_Shad = 14 # 字体阴影宽度
val_1C = 15 # 字体主颜色
val_2C = 16 # 字体辅助颜色
val_3C = 17 # 字体边框颜色
val_4C = 18 # 字体阴影颜色
val_1A = 19 # 字体主透明度
val_2A = 20 # 字体辅助透明度
val_3A = 21 # 字体边框透明度
val_4A = 22 # 字体阴影透明度
val_Blur = 23 # 模糊值
# syl info
val_nLines = 24 # SYL文件的卡拉OK歌词句子总数
val_SylLine = 25 # 第i句卡拉OK歌词
val_BegTime = 26 # 第i句卡拉OK歌词的起始时间
val_EndTime = 27 # 第i句卡拉OK歌词的结束时间
val_nTexts = 28 # 第i句卡拉OK歌词包含的字符数
val_KarTime = 29 # 第i句卡拉OK歌词的第j个字符的Karaoke时间
val_KarTimeDiff = 30 # 到第i句卡拉OK歌词的第j个字符之前的Karaoke时间总和
val_Text = 31 # 第i句卡拉OK歌词的第j个字符
# tm info (horizontal)
val_Ascender = 32 # 字体上行高度
val_Descender = 33 # 字体下行高度 通常为负数
val_TextWidth = 34 # 第i句卡拉OK歌词的j个字符的宽度
val_TextHeight = 35 # 第i句卡拉OK歌词的j个字符的高度
val_TextKerning = 36 # 第i句卡拉OK歌词的j个字符与之前一个字符的kerning 一句歌词第一个字符的kerning为0
val_TextAdvance = 37 # 第i句卡拉OK歌词的j个字符的水平步距
val_TextAdvanceDiff = 38 # 从初始位置到第i句卡拉OK歌词的j个字符的水平步距
val_TextLength = 39 # 第i句卡拉OK歌词的文字总长度
val_TextInitX = 40 # 第i句卡拉OK歌词的j个字符的左上角X轴坐标
val_TextInitY = 41 # 第i句卡拉OK歌词的j个字符的左上角Y轴坐标
val_TextBearingY = 42 # 第i句卡拉OK歌词的j个字符的Y轴bearing
# tm info horizontal
val_TextWidthH = 34 # 第i句卡拉OK歌词的j个字符的宽度
val_TextHeightH = 35 # 第i句卡拉OK歌词的j个字符的高度
val_TextKerningH = 36 # 第i句卡拉OK歌词的j个字符与之前一个字符的kerning 一句歌词第一个字符的kerning为0
val_TextAdvanceH = 37 # 第i句卡拉OK歌词的j个字符的水平步距
val_TextAdvanceDiffH = 38 # 从初始位置到第i句卡拉OK歌词的j个字符的水平步距
val_TextLengthH = 39 # 第i句卡拉OK歌词的文字总长度
val_TextInitXH = 40 # 第i句卡拉OK歌词的j个字符的左上角X轴坐标
val_TextInitYH = 41 # 第i句卡拉OK歌词的j个字符的左上角Y轴坐标
val_TextBearingYH = 42 # 第i句卡拉OK歌词的j个字符的Y轴bearing
# tm info vertical
val_TextWidthV = 43 # 第i句卡拉OK歌词的j个字符的宽度
val_TextHeightV = 44 # 第i句卡拉OK歌词的j个字符的高度
val_TextKerningV = 45 # 第i句卡拉OK歌词的j个字符与之前一个字符的kerning 一句歌词第一个字符的kerning为0 (暂时不支持vertical版本的kerning，其值全部为0)
val_TextAdvanceV = 46 # 第i句卡拉OK歌词的j个字符的水平步距
val_TextAdvanceDiffV = 47 # 从初始位置到第i句卡拉OK歌词的j个字符的水平步距
val_TextLengthV = 48 # 第i句卡拉OK歌词的文字总长度
val_TextInitXV = 49 # 第i句卡拉OK歌词的j个字符的左上角X轴坐标
val_TextInitYV = 50 # 第i句卡拉OK歌词的j个字符的左上角Y轴坐标
val_TextBearingXV = 51 # 第i句卡拉OK歌词的j个字符的X轴bearing
数据操纵函数
def GetValueIDsInfo(): # 返回全局变量说明
def GetVal(item): # 获取内置特效变量的值, 由全局变量指定
主要特效函数
def SubL(Start = 0, End = 0, Layer = 0, Style = 'TCMS'): # 返回特效Line的头部信息
def ass_main(ASS_BUF, SubDlg = '', Event = '', Text = ''): # 往ASS_BUF列表增加一行特效Line
基本特效函数
# 格式化相关的函数
def FmtHex(n): # dec to hex FormatHex
def HexToDec(a): # hex to dec
def FmtFloat(f):
def FmtRGB(r, g, b): # return a formated RGB string
def DeFmtRGB(CLR): # convert RGB string to RGB tuple
def DecRGB(RGB): # convert RGB string to RGB dec value
def clip_0_255(a): # 把a限制为 [0, 255] 中的整数
def MakeRGB(r, g, b):
def MakeRGBA(r, g, b, a):
特效代码函数
def an(a):
def K(a):
def k(a):
def ko(a):
def t(code): # t代码, 推荐使用等价的animation函数
def animation(code): # 同t函数
def t1(t1, t2, code): # t代码, 推荐使用等价的animation1函数
def animation1(t1, t2, code): # 同t1函数
def t2(t1, t2, a, code): # t代码, 推荐使用等价的animation2函数
def animation2(t1, t2, a, code): # 同t2函数
def fscx(x):
def fscy(y):
def fsc(x, y):
def fs(x):
def fad(t1, t2):
def bord(x):
def shad(x):
def blur(x):
def be(x):
def xbord(x):
def ybord(y):
def xshad(x):
def yshad(y):
def fax(x):
def fay(y):
def frx(a):
def fry(a):
def frz(a):
def pos(x, y):
def org(x, y):
def alpha(a): # note that a is a dec value
def alpha1(a):
def alpha2(a):
def alpha3(a):
def alpha4(a):
def color(c): # note that c is a RGB string
def color1(c):
def color2(c):
def color3(c):
def color4(c):
def mov(x1, y1, x2, y2):
def move(x1, y1, x2, y2, t1, t2):
def clip(x1, y1, x2, y2):
def clip1(Draw):
def clip2(Scale, Draw):
def iclip(x1, y1, x2, y2):
def iclip1(Draw):
def iclip2(Scale, Draw):
高级特效函数
def GetVersion(): # 获取tcaxLib.pyd和tcaxPy.pyc模块的版本信息
def GetHelp(): # 获取帮助信息
def Pause(): # 暂停脚本执行
def GetWorkingDir(): # 获取当前脚本的工作路径
def abspath(filename): # 通过相对路径获取绝对路径
def MakePath(FolderIndex = 0, ImageIndex = 0, MainFolder = 'src', SubFolder = 'list', ImageName = 'img', ImageType = '.png', PathType = 'pi'):
def tcaxLog(info): # 把信息写入到log文件当中
def Progress(i, j, file_id = 1, file_num = 1): # 进度显示, 用于tcaxPy_User函数
def Sum(LIS, I, diff = 0): # 高级加法函数 在数列LIS里 从第一项累加到第I项
def AdvInt(a): # 高级取整函数 AdvancedIntegrate
def DeFmtTime(TIME): # 重新数字化已被格式化的时间 TIME = '0:00:00.00'
def FmtTime(t): # 格式化时间
def PixPt(): # 返回一个像素点 PixelPoint
def MovPxl(): # 移动单位个像素 MovePixel
def RandCir(a, b, r): # 随机圆分布函数 RandomCircle1
def RandCir2(a, b, r1, r2): # 随机环分布函数 RandomCircle2
def RandCir3(a, b, r1, r2, theta1, theta2): # 带缺口的随机环分布函数 RandomCircle3
def Cir(n, a, b, r): # 圆函数
def RandomGauss(l, h, g):
def RandomDouble(l, h):
def RandGauss(l, h):
def RandRGB(): # 返回一个随机的RGB值 RandomRGB
def RandA(): # 返回一个随机的Alpha值 RandomAlpha
def RandImg(n, IMG_WD, IMG_HT): # 随机图形 RandomImage
def DevImg(IMG, DEVX, DEVY): # 图形偏移 DeviateIamge
def RevImgX(IMG): # 图形按照x轴对换 ReverseIamgeX
def RevImgY(IMG): # 图形按照y轴对换 ReverseIamgeY
def DivClr(COLOR1, COLOR2, n): # 拆分颜色 DivideColor
def MovToPos(x1, y1, x2, y2, t1, t2): # 把一个点的移动分解成一系列点的出现、消失 MoveToPos
def RectClip(InitPosX, InitPosY, WD, HT, AN = 7, DENS = 1.0, SIZE = 1): # 用点或方格的形式切割文字
def CirClip(a, b, r, d): # 将字体以圆形形式切割
def RandClip(Scale, n, IMG_WD, IMG_HT): # 任意形状切割
def Jump(P_START, P_END, P_TOP, T): # 跳跃特效函数