鼎恩光彩

4.20、高级数字时钟

以给定sFORMAT形式显示数字时钟，支持多时区操作，支持移动操作；

请求：

CMD：请求命令，0x0327；

WID：分区编号，有效值为0x0001-0x0003，或0xFF；为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、 若为多行文本，若使用了自动换行，建议不要使用垂直居中对齐；若无自动换行，建议不要使用任何居中对齐方式；

使用时若遇到上面情况，可参照上面说明使用，否则为了整体显示效果，系统会自行裁剪部分数据；

OFFSET：时间偏移，单位秒，可用于实现多时区时间显示，有符号数值。

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：sFORMAT所占字节数；

sFORMAT：时间格式化字符串；不能包含0x00；(注意，下面描述中注意大小写的形式)

注：若须要显示“%”，则在sFORMAT中需要填补两个百分号，即“%%”；换行符为’\n’，即0x0A；水平制表符’\t’，即0x09，显示为4个ASCII空格符；

回应：

CMD：回应命令，0x8317；

RES：操作结果，0表示操作成功，其他表示错误，可查看附件1中错误代码。

例：

请求命令：(显示格式“yyyy-MM-dd HH:mm:ss 星期w 上/下午”；注意屏和分区的大小，左右 居中显示)

AA A5 4F 00 FF FF 00 00 08 00 27 03 01 00 00 00 02 00 00 00 00 00 01 00 00 00 00 00 02 00 01 00 00 00 00 00 01 00 00 00 00 00 01 00 FF FF 23 00 CF D6 D4 DA CA B1 BC E4 CA C7 25 79 79 79 79 2D 25 4D 4D 2D 25 64 64 20 25 48 48 3A 25 6D 6D 3A 25 73 73 D8 6B 5A 55

回应命令：

AA A5 0A 08 00 00 01 01 08 00 27 83 00 00 EB D0 5A 55