阅读( 210 ) 我要纠错

92.  JHCreateBitmapProg(创建图片节目)

  

JHZRESULT JHZAPI JHCreateBitmapProg(

HANDLE hdl,

unsigned short wid,

unsigned short rev,

unsigned long style,

unsigned long format,

const JHTEXTPROG * ptextprog,

unsigned short rev2,

const JHBMPSRC * pbmpsrc);

参数:

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

wid     [IN] 分区编号,有效值为控制卡中已经创建的分区,或 0xFFFF;为 0xFFFF时为向所有分区发送同一个节目。

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

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

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    内存不足



功能描述:

   在实例句柄对应控制卡中根据指定的参数在分区编号为 wid 的分区上创建图片节目。


注:如果位图数据大小超过1200字节,可建立多个分区显示图片。


×