savin101394a_cn

1、快速参考指南2011年9月图形快速参考指南/graphics显示控制器解决方案图形显示Microchip提供不同级别的解决方案，以驱动从简单的单色LCD到全彩WVGA用户界面等各种显示屏。图形支持包括以下方式：下表列出了一些常用分辨率和颜色深度所需的帧缓冲器大小的 示例。PIC24 DA系列最高支持片上96 KB PIC32 MCU最高支持片上128 KB 外部SRAM可用于较大的帧缓冲器对于高级图形显示，外部图形控制器可提供更多的帧缓冲器 存储空间PIC24F DA集成图形控制器PIC32无控制器图形显示支持PICMCU与外部图形控制器相结合芯片产品与功能强

2、大且易于使用的免费图形库、显示设计器GUI，以及可与各种尺寸显示屏灵活连接的硬件开发工具包相 辅相成。支持的屏幕尺寸和颜色 Microchip图形解决方案支持各种屏幕尺寸和颜色，从小尺寸单色OLED显示屏到色彩丰富的WVGA显示屏。下表列出了表示颜 色所需的每像素位数。PIC24 DA或PIC32 MCU上的内部SRAM外部SRAM目标应用 可通过吸引眼球且易于使用的图形显示获益的应用包括：消费电子：温控器、无绳电话和遥控器家用电器：咖啡机、洗衣机和烤箱工业：数字仪器仪表、存储控制和远程终端便携式医疗仪器：血糖仪、血压计和便携式ECG随着颜色深度和显示分辨率的升高，帧缓冲器的容量会随之增 长。

3、根据其大小，帧缓冲器可以存储在单片机RAM中、外部SRAM中或集成到外部图形控制器中。*16 bpp、60 Hz配置下的最大尺寸 2图形快速参考指南PIC24 DA集成 图形控制器 PIC32无控制器图形显示 外部Solomon Systech图形控制器SSD1926外部Epson图形控制器S1D13517显示屏*WQVGA 480x272WQVGA 480x272WQVGA 480x272WVGA 800x480图形 硬件加速：矩形、字符和图像PIC32上的DMA + 5 MIPS硬件加速、SD卡、I/F和JPEG引擎SDRAM、I/F、a混叠和画中画帧缓冲器 颜色查找表 + MCU上96

4、KB +外部SRAMMCU上128 KB + 外部SRAMSolomon Systech控制器上256 KB外部SDRAM内核MIPS1680功耗 较低低低低成本 $显示表示 颜色示例 颜色深度 （每像素位数） 单色黑白1灰度4级16级24彩色256色6.5万色1600万色81624显示屏分辨率典型尺寸 颜色深度/存储容量要求（字节） 1 bpp（单色）2 bpp（4级） 8 bpp（256色） 16 bpp（6.5万色） WVGA800x480748,00096,000384,000768,000VGA640x4805.738,40076,800307,200614,400WQVGA480x

5、2724.316,32032,640130,560261,120QVGA320x2403.29,60019,20076,800153,600OLED常用128x641-2.71,0242,0488,19216,384图形显示配置集成图形控制器的PIC24F： 成本低、易于使用 PIC32低成本无控制器图形显示： 32位性能、灵活性、集成 PIC24F DA系列使应用可以方便地添加高级图形显示功能，无需使用外部帧缓冲器或显示控制器，从而实现高成本效益。Microchip的32位单片机PIC32产品线提供了80 MIPS处理能力和高性能DMA，可直接向显示屏渲染图形。这使PIC32器件无 需外部图

6、形控制器即可驱动显示屏。专用的图形时钟，支持连续清晰的显示片上显示控制器，可直接与TFT、STN和OLED显示屏相连易于使用的图形处理单元，用于硬件加速使用5 MIPS的处理能力和DMA来渲染图形 可直接与STN和TFT显示屏相连集成128 KB帧缓冲器 使用内部帧缓冲器可支持QVGA 8 bpp显示 通过并行主端口（ PMP） 使用外部帧缓冲器可支持WQVGA 16 bpp显示可与任何PIC32 80 MIPS 32位单片机配合工作通过平滑、快速的存储器传输来移动和复制矩形解压缩图像时无需CPU干预渲染文本时无需CPU干预颜色查找表和96 KB帧缓冲器，支持多种颜色 使用内部帧缓冲器可支持Q

7、VGA 8 bpp显示 通过并行主端口（ PMP） 使用外部帧缓冲器可支持WQVGA 16 bpp显示器件最高具有512 KB闪存和128 KB RAM，这给开发人员在设计应用程序代码、通信协议栈和数据缓冲时提供了充足的空 间。除了图形功能之外，PIC32 MCU还集成了用于USB、CAN、以太网和电容触摸传感的外设。外部图形控制器： 带并行主端口（PMP）的PIC24或PIC32 MCUPIC24和PIC32 MCU还可以与外部图形控制器配合工作，以支持更大的屏幕尺寸或更高级的图形功能。利用硬件加速，该系列无需耗用任何MCU MIPS处理能力即可处理和渲染图形。专用的图形引擎能够持续驱动显示

8、屏，而不与任何其他功能共用。Solomon Systech SSD1926图形控制器具有硬件图形加速功能， 对PIC MCU的MIPS处理能力没有要求。该控制器包含SD卡接口和JPEG解码引擎，以及256 KB的RAM。图形PICtail Plus SSD1926电路板（AC164127-5）包含用于数据存储的串行闪存，以及用于Explorer 16或PIC32入门工具包的接口。EpsonS1D13517图形控制器包含a混叠、画中画功能，并且最高可 支持24 bpp配置下的WVGA（800x480）。该控制器具有SDRAM 接口，可用于连接低成本外部存储器。图形控制器PICtail Plus

9、Epson S1D13517电路板（AC164127-7）包含128 Mb SDRAM帧缓冲器和16 Mb串行闪存，以及用于Explorer 16或PIC32入门工具包的接口。图形快速参考指南 3128 KB RAM DMA图形库、设计器和应用笔记免费的Microchip图形库 免费的Microchip图形显示设计器 Microchip图形显示设计器（GDD）是一款可视设计工具，客户可使用该工具快速方便地为采用Microchip MCU 的图形界面应用创建图形用户界面（GUI） 屏幕。它为开发人员带来以下好处：Microchip图形库经过高度模块化，并且针对Microchip的16位和32位单

10、片机进行了优化。它易于使用并且具有一个开放源 代码和文件的接口来实现对驱动器或控制器的支持。该图形 库支持以下功能：能够绘制、缩放或删除屏幕对象，从而简化GUI屏幕的编码 无需手动计算屏幕上对象位置的X/Y坐标生成输出源文件能够导入各种图形资源，包括自定义字体和位图图像预先制作的图形对象多种字体和语言mTouch触摸传感用户界面包括按钮、图表、复选框、滚动条、列表框、图像和基本动 画有关图形显示的应用笔记如何使用Microchip图形库中的控件，AN1136Microchip图形库中的字体，AN1182如何在Microchip图形库中创建控件，AN1246Microchip图形库与键盘的配合使

11、用，AN1227 Developing Graphics Applications using MCU with Integrated Controller，AN1368使用PIC32 MCU开发低成本无控制器（LCC）图形解决方案，AN1387图形显示控制器的开发工具 注：这些建议均基于PIC MCU LCD控制器具有16 bpp、60 Hz性能。 4图形快速参考指南支持的显示电路板 系列 QVGA 3.2图形 显示Truly 240x320电路板（AC164127-4）WQVGA 4.3图形显示Powertip 480x272电路板（AC164127-6）VGA 5.7图形 显示Truly

12、 640x480电路板（AC164127-8）WVGA 7图形 显示Truly 800x480电路板（AC164127-9）原型板连接显示屏（AC164139）PIC24 DA系列 PIC24FJ256DA210电路板（DM240312）+ 显示电路板8 bpp或30 Hz是PIC32 LCC图形 PIC32入门工具包（DM320001或DM320003-2）+LCC图形板（AC164144）+ 显示电路板8 bpp或30 Hz是PIC24 + Solomon Systech SSD1926Explorer 16（DM240001）+ Solomon Systech GFX电路板（AC1641

13、27-5）+ 显示电路板是PIC32 + Solomon Systech SSD1926PIC32 入门工具包（ DM320001 或DM320003-2）+ 集成显示屏的多媒体扩展板（DM320005）否PIC32 + Solomon Systech SSD1926PIC32入门工具包（DM320001或DM320003-2）+Solomon Systech GFX电路板（AC164127-5）+ 显示电路板是PIC24 + Epson S1D13517Explorer 16（DM240001）+ Epson GFX电路板（AC164127-7）+ 显示电路板是PIC32 + Epson S

14、1D13517PIC32入门工具包（DM320001或DM320003-2或DM320004）+ Epson GFX电路板（AC164127-7）+显示电路板是用于设计图形显示的工具Microchip图形解决方案 下表列出了对以下开发板和工具包的即开即用支持。通过适当的软硬件配置，可以实现与一些硬件组合和其他PIC器件的兼容性。9 = 兼容（直接使用）9+ = 兼容（需修改固件）= 不兼容注： 1. SSD1926最高支持WQVGA（480x272）显示屏。2. 手动将所选显示面板组装为原型板。3. 使用外部存储器以8 bpp运行。4. 8 bpp或更低配置使用内部存储器，8bpp或16 bp

15、p使用外部存储器。5. 8 bpp或16 bpp使用外部存储器。图形快速参考指南 5基于PIC32入门工具包 PIC32入门工具包 （DM320001） PIC32 USB入门工具包II（DM320003-2） PIC32以太网入门工具包 （DM320004） PIC24E USB入门工具包 （DM240012） dsPIC33E USB入门工具包 （DM330012） 图形显示Truly 3.2 240x320电路板 （AC164127-4）图形显示Powertip 4.3 480x272电路板 （AC164127-6）图形显示Truly 5.7 640x480电路板 （AC164127-8

16、）图形显示Truly 7 800x480电路板 （AC164127-9） 图形显示原型板 （AC164139） 图形LCD控制器 PICtail PlusSSD1926电路板（AC164127-5）999+9+99 (1) (1)9(2)图形控制器PICtail Plus EpsonS1D13517电路板（AC164127-7）9999+9+99999(2)低成本无控制器（LCC） 图形PICtail Plus子板（AC164144）9999+9+999(3)9(2)多媒体扩展板（DM320005）99999开发板 Explorer 16开发板 （DM240001）+接插模块（PIM） 图形显

17、示Truly 3.2 240x320电路板 （AC164127-4） 图形显示Powertip 4.3 480x272电路板 （AC164127-6） 图形显示Truly 5.7 640x480电路板 （AC164127-8） 图形显示Truly 7 800x480电路板 （AC164127-9） 图形显示原型板 （AC164139） PIC24FJ256DA210开发板（DM240312）9(4)9(5)9(3)9(2)图形LCD控制器 PICtail PlusSSD1926电路板（AC164127-5）PIC24F PIM9999(2)PIC32MX PIM9999(2)PIC24EP和d

18、sPIC33EP PIM9+999(2)PIC24H和dsPIC33F PIM9999(2)图形控制器PICtail Plus EpsonS1D13517电路板（AC164127-7）PIC24F PIM99999(2)PIC32MX PIM999999(2)PIC24EP和dsPIC33EP PIM9+99999(2)PIC24H和dsPIC33F PIM9+9+9+9+9+9(2)低成本无控制器（LCC） 图形PICtail Plus子板（AC164144）PIC24F PIMPIC32MX PIM99(3)9(2)PIC24EP和dsPIC33EP PIM9+9+9+9+ (3)9+ (

19、2)PIC24H和dsPIC33F PIM独立开发板 用于PIC24H MCU的MPLAB入门工具包（DM240021）带内置显示屏的独立开发板。用于PIC24F MCU的MPLAB入门工具包（DM240011）带内置显示屏的独立开发板。PIC24F PIMPIC24FJ128GA010 PIM（MA240011） PIC24FJ256GA110 PIM（MA240015） PIC24FJ256GB110 PIM（MA240014） PIC24FJ256GB210 PIM（MA240021）PIC32MX PIMPIC32MX360F512L PIM（MA320001） PIC32MX460F

20、512L PIM（MA320002） PIC32MX795F512L PIM（MA320003）PIC24EP和dsPIC33EP PIMdsPIC33EP512MU810 PIM（MA330025-1） PIC24EP512GU810（MA240025-1）PIC24H和dsPIC33F PIMPIC24HJ128GP504 PIM（MA240016-2） dsPIC33FJ128GP804 PIM（MA330019-2）用于设计图形显示的工具 6图形快速参考指南开发工具 部件编号 工具图像 PIC32入门工具包 DM320001PIC32 USB入门工具包IIDM320003-2PIC32

21、以太网入门工具包 DM320004PIC24E USB入门工具包 DM240012dsPIC33E USB入门工具包 DM330012图形显示原型板 AC164139原型PICtail Plus子板 AC164126用于PIC24H MCU的MPLAB入门工具包 DM240021用于PIC24F MCU的MPLAB入门工具包 DM240011开发工具 部件编号 工具图像 PIC24FJ256DA210开发板 DM240312Explorer 16开发板 DM240001多媒体扩展板 DM320005图形LCD控制器PICtail Plus SSD1926电路板 AC164127-5图 形 控

22、制 器PICtail Plus Epson S1D13517电路板 AC164127-7低成本无控制器（LCC） 图形PICtail Plus子板 AC164144图形显示 Truly 3.2240x320电路板 AC164127-4图形显示 Powertip 4.3480x272电路板 AC164127-6图形显示 Truly 5.7640x480电路板 AC164127-8图形显示 Truly 7800x480电路板 AC164127-9Microchip图形库快速参考指南 Microchip图形库快速参考指南 2011年8月22日基于图形库V3.01该卡包含API的简短说明。关于API的

23、完整说明，请参见图形库帮助文件。注： 1. 只有显示控制器支持多个显示缓冲器（或页面）时，才会使能该API。 2. 这是一项可选功能，只有显示控制器支持像素数据块寻址时才会实现。 图形快速参考指南 7设备驱动程序层 设备驱动程序层 说明 设备驱动程序层 说明 void ResetDevice()初始化显示接口并复位显示屏。 void SetVisualPage(WORD page)设置可视页面。可视页面（显示缓冲器）是在显示屏上显示的页面。(1)void PutPixel(SHORT x, SHORT y)使用当前设置的颜色渲染位于给定x,y位置的像素。 WORD CopyWindow(DWO

24、RD srcAddr, DWORD dstAddr,WORD srcX, WORD srcY, WORDdstX, WORD dstY, WORD width,WORD height)将位于由srcAddr和srcX与srcY所设置像素偏移量定义的地址中的窗口内容复制到由dstAddr和dstX与dstY所设置像素偏移量定义的地址位置。所复制窗口的大小由给定的width和height设置。(2)GFX_COLOR GetPixel(SHORT x, SHORT y)返回位于给定x,y位置的像素颜色。 void DisplayBrightness(WORD level)设置显示屏的亮度（级别：0

25、-100）。 WORD IsDeviceBusy()如果显示控制器正忙于先前的渲染操作，则返回非零。如果空闲，则返回零。 WORD CopyPageWindow(BYTE srcPage, BYTE dstPage,WORD srcX, WORD srcY, WORDdstX, WORD dstY, WORD width,WORD height);将位于由srcPage和srcX与srcY所设置像素偏移量定义的页面中的窗口内容复制到由dstPage和dstX与dstY所 设置像素偏移量定义的另一个页面。所复制窗口的大小由给定的width和height设置。(1, 2)WORD GetMaxX(

26、)返回最大水平坐标。 WORD GetMaxY()返回最大垂直坐标。 void SetClip(BYTE control)使能/禁止裁剪。 控制定义CLIP_DISABLE 禁止裁剪CLIP_ENABLE 使能裁剪 WORD CopyBlock(DWORD srcAddr, DWORD dstAddr, DWORD srcOffset, DWORD dstOffset, WORD width, WORD height);将给定源地址srcAddr与偏移量srcOffset处的像素块复制到由dstAddr与给定偏移量dstOffset给出的目标地址。所复制块的大小由给定的width和height

27、设置。(2)void SetClipRgn(SHORT left, SHORT top, SHORT right, SHORT bottom)使用给定坐标设置裁剪区域。 WORD GetClipLeft()返回左裁剪边界。 void SwitchOnDoubleBuffering()开启双重缓冲的自动管理。所有渲染将对当前设置的绘制缓冲器执行。 图形配置：USE_DOUBLE_BUFFERINGWORD GetClipRight()返回右裁剪边界。 WORD GetClipTop()返回上裁剪边界。 void SwitchOffDoubleBuffering()关闭双重缓冲的自动管理。所有渲染

28、将对当前设置的显示缓冲器执行。 图形配置：USE_DOUBLE_BUFFERINGWORD GetClipBottom()返回下裁剪边界。 void SetColor(GFX_COLOR color)设置当前绘制颜返回由RequestDisplayUpdate()设置的显示更新的状态。 图形配置：USE_DOUBLE_BUFFERINGGFX_COLOR GetColor()返回当前绘制颜YTE IsDisplayUpdatePending()void TransparentColorEnable(GFX_COLOR color)设置透明色，并使能PutImage()的透明色功能。 图形配置：

29、USE_TRANSPARENT_COLORvoid RequestDisplayUpdate(void)安排绘制缓冲器和显示缓冲器的内容在下一次垂直消隐时进行同步。 图形配置：USE_DOUBLE_BUFFERINGvoid TransparentColorDisable()禁止PutImage()的透明色功能。 图形配置：USE_TRANSPARENT_COLORvoid InvalidateAll()将整个屏幕区域标记为失效。 图形配置：USE_DOUBLE_BUFFERINGWORD GetTransparentColorStatus()返回PutImage()的透明色功能的当前状态。返

30、回值定义 TRANSPARENT_COLOR_DISABLE 功能已禁止TRANSPARENT_COLOR_ENABLE 功能已使能图形配置：USE_TRANSPARENT_COLORvoid InvalidateRectangle(WORD left, WORD top, WORD right, WORD bottom);使显示缓冲器中的指定矩形区域失效。在下一次同步绘制和显示缓冲器时，将使用绘制缓冲器中的数据刷新失效的矩形。 图形配置：USE_DOUBLE_BUFFERINGGFX_COLOR GetTransparentColor()返回TransparentColorEnable()设

31、置的当前透明色。 void UpdateDisplayNow()立即同步绘制和显示缓冲器。 图形配置：USE_DOUBLE_BUFFERINGvoid SetActivePage(WORD page)设置活动页面。活动页面是用于渲染的缓冲器。(1)预定义类型 GFX_COLOR颜色数据的数据类型。取决于COLOR_DEPTH设置。 COLOR_DEPTH 数据类型 8typedef BYTE GFX_COLOR;16typedef WORD GFX_COLOR;24typedef DWORD GFX_COLOR;XCHAR字符的数据类型。通过GraphicsConfig.h中的宏设置 宏XCH

32、AR数据类型 #define USE_MULTIBYTECHARsigned int #define USE_UNSIGNED_XCHAR unsigned char 以上皆不是signed charMicrochip图形库快速参考指南 8图形快速参考指南原语层 原语层 说明 原语层 说明 void InitGraph()初始化显示控制器，将屏幕设置为BLACK，将当前颜色设置为WHITE，将光标设置在(0,0)，将线条类型设置为SOLID_LINE，以及将活动页面和可视页面设置为0。 WORD Circle(SHORT x, SHORT y, SHORT r)使用当前设置的线条类型、线条粗细

33、和颜色， 以x,y为中心、r为半径渲染一个圆圈。 void ClearDevice()使用当前颜色清屏，并将光标设置在(0,0)。 WORD FillCircle(SHORT x, SHORT y, SHORT r)使用当前设置的颜色，以x,y为中心、r为半径渲染一个实心圆。 SHORT GetX()返回图形光标x坐标。 SHORT GetY()返回图形光标y坐标。 WORD DrawPoly(SHORT numPoints, SHORT *polyPoints)使用当前设置的线条类型、线条粗细和颜色渲染一个多边形，多边形点的数量由numPoints 给出，多边形各点的位置由polyPoint

34、s指向的 数组给出。 PolyPointsn = x0,y0,x1,y1,xn,yn;n = numPointsvoid MoveTo(SHORT x, SHORT y)将图形光标移动到新的x,y位置。 void MovetoRel(SHORT x, SHORT y)相对于当前位置移动图形光标。 WORD Arc(SHORT xL, SHORT yR, SHORT xR, SHORT yB, SHORT r1, SHORT r2,BYTE octant)使用给定的中心、半径和八分圆掩码绘制斜角图的八分圆弧。 void SetFont(void *pFont)设置在渲染字符时使用的当前字体。 v

35、oid SetFontOrientation(WORD orient)将字体方向设置为垂直或水平方向。方向定义 ORIENT_HOR水平 ORIENT_VER垂直 BYTE GetFontOrientation()返回当前字体方向（垂直或水平）。请参见SetFontOrientation()。 WORD PutImage(SHORT left, SHORT top, void *pBitmap, BYTE stretch)从左上角开始，渲染pBitmap指向的图像。 WORD OutChar(XCHAR ch)使用当前设置的字体和颜色，在当前图形光标位置渲染由字符ID ch所代表的字符。 WO

36、RD OutText(XCHAR *pString)使用当前设置的字体和颜色，在当前图形光标位置渲染pString指向的字符串。 SHORT GetImageHeight(void *pBitmap)返回图像高度。 WORD OutTextXY(SHORT x, SHORT y,XCHAR *pString)使用当前设置的字体和颜色，在x,y指定的位置渲染pString指向的指定字符串。 SHORT GetImageWidth(void *pBitmap)返回图像宽度。 SHORT GetTextHeight(void *pFont)返回指定字体的高度。 SHORT GetSineCosine

37、(SHORT v,WORD type)返回给定角度v的正弦或余弦（类型 = GETSINE或GETCOSINE）值。返回值均归一化为256。 SHORT GetTextWidth(XCHAR pString, void *pFont)返回指定字符串对于指定字体的宽度。 SHORT Sine(SHORT v)返回给定角度v的正弦值。返回值均归一化为256。 void SetLineType(WORD lnType)设置要渲染的线条类型。 lnType定义 SOLID_LINE实线 DASHED_LINE 虚 线 SHORT Cosine(SHORT v)返回给定角度v的余弦值。返回值均归一化为2

38、56。 void SetLineThickness(WORD lnThickness)设置要渲染的线条粗细。lnThickness定义NORMAL_LINE 1个像素粗THICK_LINE3个像素粗 WORD AlphaBlendWindow(DWORD foregroundWindowAddr, DWORD backgroundWindowAddr, DWORD destinationWindowAddr, WORD width,WORD height,BYTE alphaPercentage)使用由width和height指定的尺寸对前景和背景图 像进行a混叠，并将结果写入到目标地址。图形

39、配置：USE_ALPHA_BLEND(1)WORD Line(SHORT x1, SHORT y1, SHORT x2, SHORT y2)使用当前设置的线条类型、线条粗细和颜色从 x1,y1至x2,y2渲染一条直线。 DWORD GFXGetPageXYAddress(SHORT pageNumber, WORD x,WORD y)计算位于x,y位置的像素在pageNumber指定的缓冲器内的地址。 图形配置：USE_ALPHA_BLEND(1)WORD LineRel(SHORT x, SHORT y)使用当前设置的线条类型、线条粗细和颜色从当前图形光标位置到由给定x和y位移指定的相对位置

40、渲染一条直线。 DWORD GFXGetPageOriginAddress( SHORT pageNumber)计算pageNumber指定的缓冲器的地址。图形配置：USE_ALPHA_BLEND(1)WORD LineTo(SHORT x, SHORT y)使用当前设置的线条类型、线条粗细和颜色从当前图形光标位置到给定x,y位置渲染一条直线。 WORD ExternalMemoryCallback(GFX_EXTDATA *memory, LONG offset,WORD nCount, void *buffer)当使用外部存储器时，必须在应用程序代码中实现该函数，并包含通过相应外部存储器驱

41、动程序访问外部存储器的代码。 图形配置：USE_FONT_EXTERNAL或 USE_BITMAP_EXTERNAL注： 1. 这是一项可选功能，只有显示控制器支持a混叠时才会实现。 Microchip图形库快速参考指南 图形快速参考指南 9GOL层 GOL层 说明 GOL层 说明 void GOLInit()该函数会初始化对象层、原语层和显示驱动程序层。使用默认设置创建默认的样式方案。 GOLPanelDraw(SHORT left, SHORT top, SHORT right, SHORT bottom, SHORT radius,GFX_COLOR faceClr, GFX_COLOR

42、 embossLtClr, GFX_COLOR embossDkClr, void *pBitmap,WORD embossSize)设置绘制面板的参数。使用该API设置 GOLPanelDrawTsk()和GOLTwoTonePanelDrawTask()。 WORD GOLDraw()渲染活动列表中需要渲染的所有控件。 WORD GOLDrawCallback()在应用程序中实现的函数。函数由GOLDraw() 调用，以支持应用程序定义的渲染。 void GOLRedraw(OBJ_HEADER pObj)设置要在下一次GOLDraw()重新绘制的控件的绘制状态。 void GOLRedr

43、awRec(SHORT left, SHORT top, SHORT right, SHORT bottom)对活动列表中与给定矩形区域相交的所有控件进行标记。 WORD GOLPanelDrawTsk()使用由GOLPanelDraw()设置的参数渲染面板。 WORD GOLTwoTonePanelDrawTsk()使用由GOLPanelDraw()设置的参数渲染双色调面板。 WORD GetState(OBJ_HEADER *pObj, WORD stateBits)返回控件的状态位的当前值。 WORD IsObjUpdated(OBJ_HEADER pObj)测试控件是否等待重新绘制。如

44、果待处 理，则返回非零；不然，则返回零。 void GOLDrawComplete(OBJ_HEADER pObj)复位控件的绘制状态。 void SetState(OBJ_HEADER *pObj, WORD stateBits)设置控件的状态位。 void GOLAddObject(OBJ_HEADER pObj)将控件添加到活动列表的末尾。 void ClrState(OBJ_HEADER *pObj, WORD stateBits)清零控件的状态位。 void GOLFree()释放由当前活动列表使用的存储空间。活动列表将变为空。 OBJ_HEADER *GOLFindObject(W

45、ORD ID)返回活动列表中具有给定ID的控件的指针。void GOLMsg(GOL_MSG *pMsg)处理GOL_MSG，并检查哪个控件受该消息影响。对于每个受影响的控件，将会调用GOLMsgCallback()， 这使应用程序可以定制对消息的反应，以及取消或调用对消息的默认反应。 BOOL GOLDeleteObject(OBJ_HEADER pObj)从当前活动列表中删除一个控件。 BOOL GOLDeleteObjectByID(WORD ID)从当前活动列表中删除一个控件。 WORD GOLMsgCallback(WORD objMsg, OBJ_HEADER * pObj, GO

46、L_MSG * pMsg)在应用程序中实现的函数。函数由GOLMsg()调用，使应用程序可以实现自己的消息解释方式，以及定制控件行为。 GOL_OBJ_TYPE GetObjType(OBJ_HEADER pObj)返回指定控件的控件类型。 WORD GetObjID(OBJ_HEADER pObj)返回指定控件的对象ID。 OBJ_HEADER *GetObjNext(OBJ_HEADER pObj)返回活动列表中紧接指定控件的下一个控件的指针。 GOL_SCHEME * GOLCreateScheme()使用应用程序定义的样式，或使用图形库指定的默认样式，创建样式方案对象。 void GO

47、LNewList()启动新的但为空的控件列表。 使用GOLAddObjects()来填充列表。 void GOLSetScheme(OBJ_HEADER *pObj, GOL_SCHEME *pScheme)设置要用于控件的GOL_SCHEME。 OBJ_HEADER *GOLGetList()返回指向当前活动列表的指针。 GOL_SCHEME *GOLSetScheme(OBJ_HEADER *pObj)获取控件所使用的GOL_SCHEME。 void GOLSetList(OBJ_HEADER pObjList)将活动列表设置为由pObjList指定的指针。 void GOLSetFocu

48、s(OBJ_HEADER pObj)设置要聚焦的控件pObj。 GOL_SCHEME *GOLGetSchemeDefault()返回调用GOLInit()时创建的默认方案的指针。 GFX_COLOR RGBConvert(WORD red, WORD green, WORD blue)将8-8-8 RGB颜色数据转换为由COLOR_DEPTH设置的颜色格式。 OBJ_HEADER *GOLGetFocus()返回活动列表中当前所聚焦的控件的指针。 WORD GOLCanBeFocused(OBJ_HEADER pObj)如果该控件可以聚焦，返回非零。 OBJ_HEADER *GOLGetFo

49、cusNext()返回活动列表中下一个可以聚焦的控件的指针。 OBJ_HEADER *GOLGetFocusPrev()返回活动列表中上一个可以聚焦的控件的指针。 Microchip图形库快速参考指南 10图形快速参考指南控件API模拟时钟 按钮 图表 图表2图表3图形配置：USE_ANALOGCLOCK图 形 配 置 ： USE_BUTTON USE_BUTTON_MULTI_LINE图形配置：USE_CHARTvoidChHideSeries( C HART *pObj,XCHAR*ChGetSampleLabel( CHA RT *pObj)ANALOGCLOCK *AcCreate(

50、WORD ID, SHORT left, SHORT top, SHORT right, SHORT bottom, SHORT hour, SHORT minute, SHORT radius, BOOL sechand, WORD state,void * pBitmap, GOL_SCHEME * pScheme)BUTTON *BtnCreate( WORD ID,SHORT left, SHORT top, SHORT right, SHORT bottom, SHORT radius, WORD state, void * pBitmap, XCHAR * pText,GOL_SC

51、HEME * pScheme)CHART *ChCreate( WOR D ID,SHORT left, SHORT top, SHORT right, SHORT bottom, WORD state,DATASERIES * pData,CHARTPARAM * pParam, GOL_SCHEME * pScheme)void ChGetShowSeriesCount(CHART * pObj)WORDChGetSampleStart( CH ART *pObj)WORD AcDraw(void * pObj)WORD BtnDraw(void * pObj)WORD ChDraw(void * pObj)WORDChGetShowSeriesStatus(CHART * pObj)WORDChGetSampleEnd( CHWORDAcHandsDraw( ANAL OGC