BREW TM Developer Training

第十三章 使用IImage接口 BREWTMDeveloper Training

主要内容 • IImage接口的主要功能 • IImage接口函数的分类 • IImage使用手册

IImage主要功能 • IImage接口主要用于图片的显示和动画的播放 • 在默认的情况下，BREW2.X中，IImage接口能支持如下格式的图片或动画文件： • PNG • BMP • JPEG • BCI（BREW Compressed Image）注：不同的终端，在实现过程中有所不同，具体支持的格式还需参照手机的详细参数信息。

IImage接口函数—绘图 • 绘制图片 • IIMAGE_Draw() • IIMAGE_DrawFrame() • IIMAGE_DrawOffscreen() • 播放动画 • IIMAGE_Start() • IIMAGE_Stop()

IImage接口函数—属性设定 • 设置属性 • IIMAGE_SetProperties() • IIMAGE_SetAnimationRate() • IIMAGE_SetDrawSize() • IIMAGE_SetFrameCount() • IIMAGE_SetFrameSize() • IIMAGE_SetOffset() • IIMAGE_SetParm() • IIMAGE_SetStream() • 获取属性 IIMAGE_GetProperties()

IImage接口函数—事件处理 • 事件处理 IIMAGE_HandleEvent() • 设置回调函数 IIMAGE_Notify() • 释放接口 IImage_Release()

IImage使用手册 • 获取IImage接口的实例 • 设置文件显示的位置调用IIMAGE_GetInfo()获取所需显示的图片或动画的信息，然后根据手机屏幕的尺寸调整其在屏幕中最终显示的位置。 • 设置显示属性调用IIMAGE_SetParm()设置显示效果。 • 对于图片或动画需用不同的方式来完成显示和播放： • 若是图片，则需调用IIMAGE_Draw()完成显示； • 若是动画，则需调用IIMAGE_Start()开始动画的播放。 • 当不再使用IImage接口时，调用IIMAGE_Release()对IImage接口进行释放

获取IImage接口实例的方法 如下的三种方式可以获得IImage接口实例： • 如果图片或动画文件放在资源文件中，则ISHELL_LoadResImage()可从资源文件中将其读出，同时返回一个IImage接口的实例指针。 • 如果图片或动画以文件的形式存在，则可用ISHELL_LoadImage()直接从图片或动画文件中将其读出，同时返回一个IImage接口的实例指针。 • 利用ISHELL_CreateInstance()首先创建一个IImage接口实例，然后用流方式将图片信息赋值给该接口，具体操作如下： ISHELL_CreateInstance(pMe->a.m_pIShell, cls, (void **)(&pIImage)); IIMAGE_SetStream(pIImage, (IAStream*)pImageStream); //pImageStream是所需进行操作的图像信息的数据流。

显示效果设置 • IPARM_SIZE：决定显示的bmp图片的高度和宽度。 • IPARM_OFFSET：改变图片开始显示的位置，可将图片中的任一位置为参考点计算最终显示的图片信息。 • IPARM_CXFRAME：设置动画显示中一帧的宽度。 • IPARAM_NFRAMES：设置动画显示中共有多少帧。在完成bmp动画显示的时候，一定要设置IPARM_CXFRAME或IPARAM_NFRAMES。 • IPARAM_RATE：可用于控制动画显示的速度。在默认情况下，动画的显示速度是每150毫秒显示一帧。 • IPARAM_ROP：当屏幕上本身已有显示信息时，此参数可决定后续的图片显示与本身已有显示信息的叠加后的效果。

本章关键 • IImage的使用范围 • IImage的使用方法和步骤

问题回顾 • IImage接口的主要功能是什么？ • 用IImage显示图片和播放动画时有什么不同？ • 用IImage接口显示图片和播放动画时，可控制哪些表现？

BREW TM Developer Training