BREW 初级开发者教程 笔记

 第九章 IImage

 

IImage 接口主要用于图片的显示和动画的播放

 

绘制图片：IIMAGE_Draw()、IIMAGE_DrawFrame()、IIMAGE_DrawOffscreen()

播放动画：IIMAGE_Start()、IIMAGE_Stop()

 

设置属性：IIMAGE_SetAnimationRate()、IIMAGE_SetDrawSize()、IIMAGE_SetFrameCount()

               IIMAGE_FrameSize()、IIMAGE_SetOffset()、IIMAGE_SetParm()、IIMAGE_SetStream()

获取属性：IIMAGE_GetInfo()

事件处理：IIMAGE)HandleEvent()

设置回调函数：

   void IIMAGE_Notify(IImage *pIImage, PFNIMAGEINFO pfn, void *pUser);

   与IIMAGE_SetStream()联合使用，通知图像数据解码完成

释放接口：IImage_Release()

 

IImage 使用手册

1. 获取IImage接口的实例

2. 设置文件显示的位置

     调用IIMAGE_GetInfo()获取所需显示的图片或动画的信息，然后根据手机屏幕的尺寸调整其在屏幕中的最终为显示位置

3. 设置显示属性

    调用IIMAGE_SetParm()设显示效果

4. 对于图片或动画需要不同的方式来完成显示和播放：

    若是图片，则需调用IIMAGE_Draw()完成显示

    若是动画，则需调用IIMAGE_Start()开始动画的播放

5. 当不再使用IImage接口时，调用IIMAGE_Release()对IImage接口进行释放

 

获取IImage接口实例的方法

1. 如果图片或动画文件放在资源文件中，则ISHELL_LoadResImage()可从资源文件中将其读出，同时返回一个IImage接口的实例指针

2. 如果图片或动画以文件的形式存在，则可用ISHELL_LoadImage()直接从图片或动画文件中将其读出，同时返回一个IImage接口的实例指针

3. 利用ISHELL_CreateInstance()首先创建一个IImage接口实例，然后用流方式将图片信息赋值给该接口，具体操作：

cls = ISHELL_GetHandler(pMe->a.m_pIShell, HTYPE_VIEWER, "image/bmp"); ISHELL_CreateInstance(pMe->a.m_pIShell, cls, (void **)(&pIImage)); ISHELL_CreateInstance(pMe->a.m_pIShell, AEECLSID_MEMASTREAM, ...); IIMAGE_Notify(pIImage, callback_function, pMe); // pImageStream 是所需进行操作的图像信息的数据流 IIMAGE_SetStream(pIImage, (IAStream *)pImageStream);

 

显示效果设置：

IPARM_SIZE：决定显示的bmp图片的高度和宽度

IPARM_OFFSET： 改变图片开始显示的位置，可将图片任一位置为参考点计算最终显示的图片信息

IPARM_CXFRAME：设置动画显示中一帧的宽度

IPARAM_NFRAMES：设置动画显示中共有多少帧。在完成bmp动画显示的时候，一定要设置IPARM_CXFRAME或IPARAM_NFRAMES

IPARAM_RATE：可用于控制动画显示的速度。默认情况下动画的显示速度是每150毫秒显示一帧

IPARAM_ROP：当屏幕上本身已有显示信息时，此参数可决定后续图片显示与本身已有显示信息的叠加后的效果