152. JHCreateBitmapProgIst(创建图片节目指令)
JHZRESULT JHZAPI JHCreateBitmapProgIst(
HANDLE phdl,
unsigned short index,
unsigned short wid,
unsigned short rev,
unsigned long style,
unsigned long format,
const JHTEXTPROG * ptextprog,
unsigned short rev2,
const JHBMPSRC * pbmpsrc) ;
参数:
phdl [IN] 实例句柄,与控制卡对应。
index [IN] 指令在批处理文件中基于1开始的索引。
wid [IN] 分区编号,有效值为控制卡中已经创建的分区, 或 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-8:保留,为 0;
位 7- 6:水平对齐 HALIGN
00:左对齐;
01:水平居中对齐;
10:右对齐;
位 5- 4:
00:上对齐;
01:垂直居中对齐;
10:下对齐;
位 3-0:保留, 为 0;
ptextprog [IN]指向 JHTEXTPROG 类型的内存空间。JHTEXTPROG 结构体格式如下所示:
tpEntryMode:进入效果。
0x0001:立即显示。
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 表示除 非有新的节目过来, 否则一直循环播放。
rev2 [IN] 保留;始终为 0。
JHBMPSRC [IN] 图片源信息。
struct tagBitmapSource{
unsigned short type;
unsigned short version;
unsigned long size;
unsigned char *pdata;
}JHBMPSRC;
type:图片类型,始终为 0,表示为文件图片;
version: 版本,当前版本为 0;
size: 图片源数据大小;
pdata: 图片源数据;data 为动态数组, 大小由 size 决定;
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
IR_INVALID_OBJECT 无效的对象
IR_NOT_ENOUGH_CORE 内存不足
功能描述:
在批处理文件中索引为 index 的位置上添加创建图片节目指令。将要创建的图片节 目在分区编号为 wid 的显示区域内显示。一个显示屏可以分为若干个区域,每个区域以 一个分区编号来标记。