腳本語法


KBScripts函數說明:
(適應KBuilder 3.x版本)


把RGB合成為顏色值:
<color-integer> := RGB(r, g, b);
例如: karaoke.TransparentColor := RGB(0, 255, 0); // green
注意: r,g,b的取值范圍是0~255


創建卡拉OK對象:
<object-integer> := CreateKaraokeObject;
例如: karaoke := CreateKaraokeObject;
注意: 在將來的版本中,創建卡拉OK字幕對象將被TitleObject.Create代替﹔


設置變色邊框顏色:
<object-integer>.AnimateBorderColor := <color-integer>;
例如: karaoke.AnimateBorderColor := RGB(255, 255, 255); // white


設置變色邊框厚度:
<object-integer>.AnimateBorderThickness := <integer>;

例如: karaoke.AnimateBorderThickness := 1;


設置變色的顏色值:
<object-integer>.AnimateColor := <color-integer>;

例如: karaoke.AnimateColor := RGB(0, 0, 255); // blue


設置相應的音頻文件:
<object-integer>.AudioFileName := <string>;

例如: karaoke.AudioFileName := '*.wav'; // *表示與歌詞腳本同名的文件


設置顏色深度
<object-integer>.ColorDepth := <integer>;

例如: karaoke.ColorDepth := 24;
注意:顏色深度取值范圍: 16,24,32,在插件中該設置無效


設置當前位置(內部使用):
<object-integer>.Position := <integer>; // 單位:毫秒
<object-integer>.Position := <string>; // 格式:'mm:ss.mss'
例如: karaoke.Position := 35000; // 將指針移到35秒處
例如: karaoke.Position := '35:00.000'; // 將指針移到35秒處


設置播放的時間范圍:
<object-integer>.StartPos := <integer>; // 單位:毫秒
<object-integer>.EndPos := <integer>; // 同上
例如: karaoke.StartPos := 24000;
例如: karaoke.StartPos := '24:00.000';


第一行(上)對齊方式:
<object-integer>.FirstAlignment := <integer>; // 0, 1, 2:左右中對齊
例如: karaoke.FirstAlignment := 2; // 第一行歌詞右對齊
縮進像素: <object-integer>.FirstIndent := <integer>;
例如: karaoke.FirstIndent := 25; // 與右邊界保持25像素點距離< BR> 注意: 在單行模式中,只有第一行的設置有效,單行也就是第一行


第二行(下)對齊方式:
<object-integer>.NextAlignment := <integer>; // 0, 1, 2:左中右對齊

縮進像素: <object-integer>.NextIndent := <integer>;


字體設置:
<object-integer>.Font(<string>); // 字型, 如'楷體_GB2312', '宋體'
<ojbect-integer>.Font(<string>, <integer>); // 字型, 大小
<object-integer>.Font(<string>, <integer>, <boolean>); // 字型, 大小, 是否加粗
例如: 設置為“楷體”字, 大小為20, 字體加粗
karaoke.Font('楷體_GB2312', 20, true);


設置每秒幀數:
<object-integer>.FramesPerSec := <integer>;

例如: karaoke.FramesPerSec := 25;
注意: 設置幀率將影響字幕的平滑程度,一般情況下無需設置


圖象高度:
<object-integer>.Height := <integer>;

例如: karaoke.Height := 72;
注意: 當autosize設置為true時,圖象高度是自動設置的


設置是否以正常速度播放:
<object-integer>.KaraokeMode;

例如: karaoke.KaraokeMode := true;
注意: 內部使用,并且在輸出視頻時無效


上下兩行之間的像素數:
<object-integer>.LineSpace := <integer>;

例如: karaoke.LineSpace := 4;


設置常規邊框顏色:
<object-integer>.NormalBorderColor := <color-integer>;

例如: karaoke.NormalBorderColor := RGB(0, 0, 0); // black


設置常規邊框厚度:
<object-integer>.NormalBorderThickness := <integer>;

例如: karaoke.NormalBorderThickness := 1;


設置常規顏色:
<object-integer>.NormalColor;

例如: karaoke.NormalColor := RGB(255, 255, 255); // white


設置播放行數(1-2):
<object-integer>.Rows := <integer>;

例如: karaoke.Rows := 2;                              


設置頂部邊界值:
<object-integer>.TopMargin := <integer>;

例如: karaoke.TopMargin := 3;


讀取歌曲的時間長(內部使用):
<object-integer>.Duration;

例如: len := karaoke.Duration;


設置透明顏色:
<object-integer>.TransparentColor := <color-integer>;

例如: karaoke.TransparentColor := RGB(0, 255, 0);
注意: 插件中無效


設置圖象寬度:
<object-integer>.Width := <integer>;

例如: karaoke.Width := 352;


設置提示字顏色(特別適合對唱等場合):
<object-integer>.SetColor(<string>, <integer>);
例如,將女聲歌詞顏色設置為紅色:
karaoke.SetColor('女', RGB(255,0,0));
在歌詞中有"(女:)"標記的后面的所有歌詞顏色都設置為紅色,直到下一個提示字改變


增加歌詞行:
<object-integer>.Add(<string>, <string>, <string>, <string>);
參數說明:
1-開始時間, 格式是'mm:ss.mss';
2-結束時間, 同上
3-純歌詞文字
4-時值序列


清除所有歌詞描述(也就是Add增加的歌詞行):
<object-integer>.Clear;


設置歌詞行變色前