阅读( 221 ) 我要纠错

148.   JHCreateTextProgIst(创建文本节目指令)

 

JHZRESULT JHZAPI JHCreateTextProgIst(

HANDLE phdl,

unsigned short index,

unsigned short wid,

unsigned short rev,

unsigned long style,

unsigned long format,

 

        const JHTEXTPROG * ptextprog,

        const char * pformatstring)


 

参数:

phdl   [IN] 实例句柄,与控制卡对应。 

Index  [IN] 指令在批处理文件中基于1开始的索引。

wid    [IN] 分区编号, 有效值为 0x0001-0x0003,或 0xFFFF;为 0xFFFF 时为向所有分区发送同一个节目。

       rev    [IN] 节目标识,用于单分区多节目。

 位 15-8:节目编号,同分区中具有唯一性,值越小播放顺序越靠 前,有效范围 0~63;

 位 7-0:保留, 始终为 0。

style   [IN] 节目样式。

 位 31-4:保留,始终为 0;

 位 3:是否按队列加载, 仅永久节目有效,为 0 表示立即,为 1 表示按队列顺序加载;

 位 2:加载时是否擦除分区,为 0 表示不擦除,为 1 表示擦除;  1:节目属性,为 0 表示临时节目(即掉电易失),为 1 表示 永久节目(掉电不易失) 

 位 0:保留,始终为 0;


format   [IN] 文本显示格式。

   位 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。


      ptextprog     [IN] 指向 JHTEXTPROG 类型的内存空间。 JHTEXTPROG 结构的格式如 下所示:

     tpEntryMode:进入效果;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:随机进入

tpEntrySpeed:进入效果速度 该值越大,运动速度越慢。 tpEntryStaytime:进入效果停留时间;单位 10 毫秒。

tpHighLightMode:0x0000 无强调效果,0x0001 时闪烁; tpHighLightSpeed: 有强调效果时生效, 闪烁的速度。

tpHighLightStaytime:强调效果停留时间;单位 10 毫秒。

tpExitMode:退出效果。

0x0000:无退出效果

0x0001:立即清屏

0x0002:向左移出

0x0003:向右移出

0x0004:向上移出

0x0005:向下移出

0x0006:左右合并

0x0007:左右展开

0x0008:上下合并

0xFFFF:随机退出

tpExitSpeed:退出效果速度;该值越大, 运动速度越慢。

tpRepeatTimes:重复次数,有效值为 0x001-0xFFFF;0xFFFF 表示除 非有新的节目过来, 否则一直循环播放。


pformatstring   [IN] 指向存储待显示的文本字符串的内存空间。 文本字符编码,可包含有效的 ASCII 码(不能包含 0x00)和 GB2312 编码,可混用。换行

符为 ’\n ’,即 0x0A;水平制表符 ’\t ’,即 0x09,显示为 4  ASCII 空格符。



注: FORMAT 属性说明, 主要注意两类,单行文本和多行文本

1. 单行文本时:

忽略 wordbreak 自动换行设置, 无论是自动换行或是手动在命令中添加换行符 ’\n ’,均忽

略,不作换行处理,

2. 多行文本时:

根据设置不作限制, 自动换行和手动换行可同时支持;

 

但是若文本显示所需区域超过当前限制区域, 建议做如下处理:

1. 若为单行文本, 建议不要设置水平居中;其他可任意搭配;

2. 若为多行文本, 若使用了自动换行, 建议不要使用垂直居中对齐;若无自动换行, 建议 不要使用任何居中对齐方式;

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

 


返回值:

JR_OK            成功

JR_INVALID_PARAMETER  参数错误

IR_INVALID_OBJECT    无效的对象

IR_NOT_ENOUGH_CORE   内存不足


功能描述:

在批处理文件中索引为 index 的位置上添加创建文本节目指令。将要创建的文本在 分区编号为 wid 的显示区域内显示。一个显示屏可以分为若干个区域,每个区域以一个分区编号来标记。


×