添加各种对象 - LED显示屏二次开发接口的设计方案

　　（3）添加各种对象。

　　在页面的区域上，可添加单行文字、多行文字、内码文字、图片、视频动画、WORD 文档、Flash 动画、表格、数字时钟、模拟时钟、倒计时等各种显示对象，在实现时，每一种对象对应一个函数。这里列出常用的添加图片的函数：

　　函数格式：

　　DWORD Program_AddPicture（DWORD dwAreaNO/* 区域号*/，

　　HDC dc/* 图形dc*/，

　　DWORD dwWidth/* 图片宽*/，

　　DWORD dwHeight/* 图片高*/，

　　LPRECT rect/* 显示区域*/，

　　DWORD dwAction/* 特效号*/，

　　DWORD dwExitAction/* 退出特效号*/，

　　DWORD dwSpeed/* 显示速度*/，

　　DWORD dwTimecount/* 显示时间*/，

　　DWORD dwTransparent/* 透明与否*/）；

　　该函数在指定区域上添加一个图片，显示内容来自于dc.

　　（4）节目数据生成。

　　函数格式：DWORD Program_MakeData（）。

　　该函数生成节目数据， 以便使用LEDControl_SendToScreen 函数发送到不同的显示屏。

　　2.4 命令接口

　　命令接口主要为控制、监控和发送节目数据而设计，例如，火车站或街头的广告屏，在夜间人少时，广告效果不明显，同时也为了省电，可在指定夜间时间点关闭显示屏，然后到早晨指定时间点自动打开显示屏。经过总结，命令接口的命令包括：

　　（1）重启命令。

　　函数格式：DWORD LEDControl_Reboot（DWORD dwDev， BYTE byDstNo， char *chHost，WORD wPort）；

　　该函数用来重启指定的LED 显示屏。

　　（2）电源控制。

　　函数格式：DWORD LEDControl_SetPower（DWORD dwDev， BYTE byDstNo， char chHost，WORD wPort， DWORD dwPower/* 开或关标识*/）；

　　该函数打开或关闭显示屏。

　　（3）显示屏亮度调节。

　　函数格式：DWORD LEDControl_SetBrightness（DWORD dwDev， BYTE byDstNo， char *chHost，WORD wPort， BYTE byBrightness/* 亮度*/）；

　　该函数用于调节显示屏亮度。

　　（4）校时。

　　函数格式：DWORD LEDControl_AdjustTime（DWORD dwDev， BYTE byDstNo， char *chHost，WORD wPort）；

　　该函数用于计算机时钟校正显示屏时钟。

　　（5）节目发送接口。

　　函数格式：DWORD LEDControl_SendToScreen（DWORD dwDev， BYTE byDstNo， char *chHost，WORD wPort）；

　　该函数将Program_MakeData 生成的节目数据发送到显示屏，最后返回状态值，表示成功、失败及其它状态，用户根据状态再进行相应的处理。

　　（6）局部更新节目接口。

　　函数格式：DWORDLEDControl_UpdateCodeText （DWORD dwDev，BYTE byDstNo， char *chHost， WORD wPort，char *chCodeText/* 字符串缓冲区*/， int iLen/*字符串长度*/）；

　　该函数用来更新显示屏局部内容。对于一些信息发布，一般只需要更新局部的内容，例如车站大厅信息发布，显示屏划分很多的区域，有数字时钟、模拟时钟、图片、动画和文字等不同的区域，一般往往只更新文字部分内容，即可达到信息发布的目的，同时不用生成节目，节省了时间和提高了效率。

　　3 二次开发接口的应用

　　二次开发接口一般都是以动态链接库的形式提供给用户，并提供主流开发语言的接口和例程，例如VC、C#、Delphi 和VB 等。一般的调用流程是：

　　（1）载入动态链接库；（2）建立通信通道；（3）进行显示屏控制、监控操作；（4）进行节目制做、发送和更新；（5）关闭通信通道；（6）释放动态链接库，完成二次开发接口的调用。

　　4 结论

　　本文针对LED 显示屏工程应用中对二次开发接口的需求，提出了一种LED 显示屏二次开发接口的方法，将二次开发接口总结为通信通道、节目和命令三种接口，并在网络先锋控制卡系列产品中应用。实践证明，该方法可让用户在系统集成中，简单、快速地实现其二次开发功能，同时降低系统集成的周期和代价。