153. JHCreateQRCodeProgIst(创建二维码节目指令)
JHZRESULT JHZAPI JHCreateQRCodeProgIst(
HANDLE phdl,
unsigned short index,
unsigned short wid,
unsigned short rev,
unsigned long style,
unsigned long format,
const JHTEXTPROG * ptextprog,
const JHQRCODE* pqrcode,
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:水平对齐 HALIGN00;左对齐。
01:水平居中对齐。
10:右对齐。
位 5- 4:垂直对齐方式
00:上对齐。
01:垂直居中对齐。
10:下对齐。
位 3:保留,始终为 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 表示除 非有新的节目过来, 否则一直循环播放。
Pqrcode [IN] 指向存储 JHQRCODE 结构数据的内存空间,结构成员如下:
typedef struct{
unsigned short rev;
unsigned short type;
unsigned short version;
}JHQRCODE;
rev :保留,始终为 0。
type : 类型, 二维码图片节目值为 2(位图图片节目值为 0)。 version: 保留,始终为 0。
pformatstring [IN] 指向存储待显示的二维码文本字符串的内存空间(1-128 字 节) 。文本字符编码,可包含有效的 ASCII 码(不能包含 0x00)。
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
IR_INVALID_OBJECT 无效的对象
IR_NOT_ENOUGH_CORE 内存不足
功能描述:
在批处理文件中索引为 index 的位置上添加创建二维码节目指令。将要创建的维码 在分区编号为 wid 的显示区域内显示。一个显示屏可以分为若干个区域,每个区域以一 个分区编号来标记。