20110510 Brew工程师培训笔记——第九章 IDisplay使用简介

第九章 IDisplay使用简介

 

一、主要内容

（1）、介绍IDisplay的主要功能

（2）、介绍在IDisplayz中常用的一些接口

二、IDisplay概貌

（1）、利用IDisplay可以完成如下功能：

（a）、书写文字

（b）、画图

（c）、画直线

（d）、一些简单的几何图形

（2）、如果您要想画一些复杂的几何图形或线，您只好求助于IGraphics 接口了

（3）、允许对于设备的背光灯和Annunciators进行控制

三、IDisplay 用户手册

（1）、由于IDisplay会被所有的应用用到，在使用过程中无需我们再显式的去创建，系统会自动建立它

（a）、清除整个屏幕或一个特定的区域以为后续的操作服务

（b）、在屏幕上画出自己想画的内容

（c）、利用IDISPLAY_Update()或IDISPLAY_UpdateEx() 来刷新屏幕，以使得您刚才的操作为用户所见

（2）、当不再使用IDisplay接口时，调用IDISPLAY_Release() 来释放该接口。对于这个接口而言，系统会自动对其进行释放，故我们无需再显式对其进行释放

四、IDisplay函数列表

IDISPLAY_DrawText()

IDISPLAY_MeasureText()

IDISPLAY_MeasureTextEx()

IDISPLAY_GetFontMetrics

IDISPLAY_DrawRect()

IDISPLAY_FillRect() 

IDISPLAY_DrawHLine()

IDISPLAY_DrawVLine()

IDISPLAY_SetColor()

IDISPLAY_ClearScreen()

IDISPLAY_Backlight() 

IDISPLAY_SetAnnunciators() 

IDISPLAY_BitBlt() 

IDISPLAY_Update()

IDISPLAY_UpdateEx()

五、与写文字相关

（1）、IDISPLAY_DrawText()

Flags:  IDF_ALIGN_LEFT,IDF_ALIGN_RIGHT, IDF_ALIGN_CENTER

            IDF_ALIGN_TOP, IDF_ALIGN_BOTTOM, IDF_ALIGN_MIDDLE

            IDF_TEXT_UNDERLINE,IDF_TEXT_TRANSPARENT,   

            IDF_TEXT_INVERTED……

 

（2）、IDISPLAY_MeasureText()

给定一个字符串及其显示字体，获得显示它所需要的象素的数目

（3）、IDISPLAY_MeasureTextEx()

除了IDISLAY_MeasureText()能完成的功能外 , 给定宽度（如屏幕的尺寸）还能获得它可以显示的字符数

（4）、IDISPLAY_GetFontMetrics()

 获得指定字体在显示时的尺寸信息

六、Font Metrics

Int IDISPLAY_GetFontMetrics(IDisplay * pIDisplay, AEEFont Font,

int * pnAscent,int * pnDescent);

七、IDisplay例子

八、IDisplay使用中的常见错误

（1）、在使用字符串以前，一定要保证字符串是 “AECHAR”的形式

（2）、您需要调用IDISPLAY_Update()来刷新屏幕，否则您的文字和别的一些写画操作将不为用户所见

九、IDisplay使用注意事项

（1）、显示文字：不支持换行，需开发者手动设置

（2）、绘制线条：只能绘制水平或垂直的线，且仅能绘制黑色的线条

十、复习要点

（1）、IDisplay所能提供的功能

（2）、利用IDisplay如何来完成文字的显示

十一、问题回顾

（1）、为什么有时在使用一个字符串之前，需要将以 “char *” 形式表示的字符串转化成 以AECHAR 形式表示的？

（2）、为什么有时候所做的操作在屏幕上并没有显示出来？可能是什么原因？