4.12、文本节目
(注:临时节目可以在临时分区或永久分区播放;永久节目添加到永久分区会保存后立即播放,若添加到临时分区,会自动转换成临时节目,不会保存)。
设置指定分区的默认播放节目,可指定播放次数;
请求:
SF | CTRL | DES | SRC | TID | CMD | WID | REV | STYLE | FORMAT |
2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 4字节 | 4字节 |
ENTRY | SPENTRY | DUENTRY | HIGHLIGHT | SPHL | DUHL | EXIT | SPEXIT | TIMES |
2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 |
CNT | TEXT | CRC | EF |
2字节 | 1~1200字节 | 2字节 | 2字节 |
CMD:请求命令,0x0310;
WID:分区编号,有效值为0x0001-0x0003,或0xFFFF;为0xFFFF时为向所有分区发送同一个节目;
REV:节目标识,用于单分区多节目。
位15-8:节目编号,同分区中具有唯一性,值越小播放顺序越靠前,有效范围0~63;
位 7-0:保留,始终为0;
STYLE:节目样式;
位31-4:保留,始终为0;
位 3:是否按队列加载,仅永久节目有效,为0表示立即,为1表示按队列顺序加载;
位 2:加载时是否擦除分区,为0表示不擦除,为1表示擦除;
位 1:节目属性,为0表示临时节目,为1表示永久节目;
位 0:保留,始终为0;
FORMAT:文本显示格式;仅在RES为0时存在;
位31-20:保留,始终为0;
位19-16:颜色(注:0000表示使用系统当前颜色;1000为黑色)
位18:蓝色;
位17:绿色;
位16:红色;
位15- 8:字体ID;有效值为0-254;为0时使用当前字体ID;
位 7- 6:水平对齐HALIGN
00;左对齐;
01:水平居中对齐;
10:右对齐;
位 5- 4:
00:上对齐;
01:垂直居中对齐;
10:下对齐;
位 3:保留,始终为0;
位 2:wordbreak,自动换行,为0,不自动换行,为1,自动换行;
位 1:单行文本; 0表示多行文本,1表示单行文本;
位 0:高级文本,0表示普通文本,1表示高级文本;保留,始终为0;
(注:分区属性说明,主要注意两类,单行文本和多行文本
1、单行文本时:
忽略wordbreak自动换行设置,无论是自动换行或是手动在命令中添加换行符’\n’,均忽略,不作换行处理,
2、 多行文本时:
根据设置不作限制,自动换行和手动换行可同时支持;
但是若文本显示所需区域超过当前限制区域,建议做如下处理:
1、 若为单行文本,建议不要设置水平居中;其他可任意搭配;
2、 若为多行文本,若使用了自动换行,建议不要使用垂直居中对齐;若无自动换行,建议不要使用任何居中对齐方式;
使用时若遇到上面情况,可参照上面说明使用,否则为了整体显示效果,系统会自行裁剪部分数据;
ENTRY:进入效果;0x0000不合法,强制转为0x0001。
0x0001:立即显示
0x0002:向左移入
0x0003:向右移入
0x0004:向上移入
0x0005:向下移入
0x0006:向右展开
0x0007:向左展开
0x0008:向上展开
0x0009:向下展开
0x000A:左右合并
0x000B:左右展开
0x000C:上下合并
0x000D:画卷右展开
0x000E:画卷左展开
0x000F:画卷左右展开
0x0010:画卷左右合并
0x0011:画卷上下合并
0x0012:拉开窗帘
0x0013:中间溢出
0x0014:左右移动
0x0015:右下抽出
0x0016:右上抽出
0x0017:左下抽出
0x0018:左上抽出
0x0019:水平百叶窗
0x001A:垂直百叶窗
0x001B:矩形扩散
0x001C:矩形收缩
0x001D:菱形扩散
0x001E:菱形收缩
0x001F:十字扩散
0x0020:顺时针1根轮辐
0x0021:顺时针2根轮辐
0x0022:顺时针4根轮辐
0x0023:顶端画扇形
0x0024:底端画扇形
0x0025:中间画扇形
0x0026:四顶点画扇形
0x0027:水平梳理
0x0028:垂直梳理
0x0029:左右穿插
0x002A:飘雪
0x002B:冒泡
0x002C:左镭射
0x002D:右镭射
0x002E:上下生长
0x002F:左开始波形
0x0030:右开始波形
0xFFFF:随机进入
SPENTRY:进入效果速度;该值越大,运动速度越慢;
DUENTRY:进入效果停留时间;单位10毫秒;
HIGHLIGHT:强调;保留值,始终为0;
SPHL:强调效果速度;保留值,始终为0;
DUHL:强调效果停留时间;预留0x0000表示无退出效果。保留值,始终为0;
EXIT:退出效果;
0x0000:无退出效果
0x0001:立即清屏
0x0002:从右向左移出
0x0003:从左向右移出
0x0004:从下向上移出
0x0005:从上向下移出
0xFFFF:随机退出
SPEXIT:退出效果速度;该值越大,运动速度越慢;
TIMES:重复次数,有效值为0x0001-0xFFFF;0xFFFF表示除非有新的节目过来,否则一直循环播放。
CNT:TEXT字节数。
TEXT:文本字符编码,可包含有效的ASCII码(不能包含0x00)和GB2312编码,可混用。换行符为’\n’,即0x0A;水平制表符’\t’,即0x09,显示为4个ASCII空格符;
回应:
SF | CTRL | DES | SRC | TID | CMD | RES | CRC | EF |
2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 |
CMD:回应命令,0x8310;
RES:操作结果,0表示操作成功,其他表示错误,可查看附件1中错误代码。
例1:(如需自动换行,或对齐功能,请参看FORMAT参数说明)
请求命令:(文本“啊齄”在分区0x0001中静止显示,REV=0x0000,为00号节目STYLE=0x00000002,为永久节目,字体使用ID为1的字体,颜色使用系统默认颜色。)
AA A5 2C 00 FF FF 00 00 B0 A1 10 03 01 00 00 00 02 00 00 00 00 01 00 00 01 00 14 00 E8 03 00 00 00 00 00 00 00 00 14 00 FF FF 04 00 B0 A1 F7 FE 00 00 5A 55
回应命令:
AA A5 0A 08 00 00 01 01 B0 A1 10 83 00 00 92 C9 5A 55
例2:
请求命令:(文本“合肥市金涵电子有限责任公司”在分区0x0001中从右向左移入显示)
AA A5 42 00 FF FF 00 00 B0 A1 10 03 01 00 00 00 02 00 00 00 00 01 00 00 02 00 02 00 C8 00 00 00 00 00 00 00 01 00 14 00 FF FF 1A 00 BA CF B7 CA CA D0 BD F0 BA AD B5 E7 D7 D3 D3 D0 CF DE D4 F0 C8 CE B9 AB CB BE 00 00 5A 55
回应命令:
AA A5 0A 08 00 00 01 01 B0 A1 10 83 00 00 92 C9 5A 55