LED动态链接库函数说明

1、LED动态链接库函数说明VER 2.0void LEDAPI LED_Startup(void);该函数初始化LEDSender动态链接库void LEDAPI LED_Cleanup(void);该函数终止LEDSender动态链接库long LEDAPI LED_Open(const PDeviceParam param, long Notify, long Window, long Message);该函数打开一个指定的通讯设备参数：param: 一个设备参数指针，该结构如下定义：typedef struct DEVICEPARAM long devType; /device type

2、long speed; /speed only use for rs232 long locPort; /rs232: COM port UDP: local port long rmtPort; /remote port only use for UDP long reserved8;TDeviceParam; typedef TDeviceParam * PDeviceParam; devType: DEV_COM: 通讯设备为RS-232 DEV_UDP: 通讯设备为UDP Speed: 仅对RS-232有效，一般情况下主板的速度为 SBR_115200 locPort: 对RS-232

3、设备，该参数为串口号 对UDP设备，该参数为本地端口号，一般该值为大于1024的数字 Remote: 仅对UDP方式有效，主板的固定端口为: 6666 reserved: 系统保留Notify: 是否产生通知消息 1=产生通知消息 0=不产生通知消息window: 接收通知消息的窗口句柄Message: 消息标识返回值：如果设备打开正常，该函数返回一个大于等于0的数字备注：LED通讯是异步通讯模式，只能通过Window操作系统的消息机制来传递通讯状态，因此在用户程序中应该有一个消息处理模块，专门处理通讯消息该函数能构反复打开同一设备void LEDAPI LED_Close(long dev)

4、;该函数关闭已打开的通讯设备参数： dev: 该参数是LED_Open函数的返回值void LEDAPI LED_Query(long dev, BYTE Group,BYTE ScrNo, char *Host, WORD port);该函数查询显示屏是否能够通讯参数：dev:该参数是LED_Open函数的返回值Group: 显示屏组号 ScrNo:显示屏屏号Host:显示屏IP地址 (仅对UDP有效) port:显示屏端口号(如果是UDP通讯，该端口为6666)备注：如果在LED_Open调用中Notify=1，那么该函数会产生一个消息通知，向LED_Open中指定的Window发送一个M

5、essage消息，通过分析该消息可得知该函数的执行结果void LEDAPI LED_AdjustTime(long dev, BYTE Group, BYTE ScrNo, char *Host, WORD port);该函数用计算机时钟校正显示屏内时钟void LEDAPI LED_SendToScreen(long dev, BYTE Group, BYTE ScrNo, char *Host, WORD port);该函数将形成的节目数据发送到显示屏void LEDAPI LED_SetPower(long dev, BYTE Group, BYTE ScrNo, char *Host

6、, WORD port, DWORD Power);该函数打开或关闭显示屏电源参数： Power:1 = 打开电源0 = 关闭电源void LEDAPI LED_GetPower(long dev, BYTE Group, BYTE ScrNo, char *Host, WORD port);该函数获取电源状态备注：如果在LED_Open调用中Notify=1，那么该函数会产生一个消息通知，向LED_Open中指定的Window发送一个Message消息，通过分析该消息可得知该函数的执行结果void LEDAPI LED_SetBrightness(long dev, BYTE Group,

7、BYTE ScrNo, char *Host, WORD port, BYTE Brightness);该函数用于调节显示屏亮度参数： Brightness: 0-7 0=最暗 7=最亮void LEDAPI LED_SetIPAddress(long dev, BYTE Group, BYTE ScrNo, char *Host, WORD port, char *NewIP);该函数用于修改显示屏IP地址参数： NewIP: IP地址格式必须如下：“备注： 执行该函数后，显示屏会自动重新启动long LEDAPI LED_DownLoadFontSet(long dev, BYTE Gro

8、up, BYTE ScrNo, char *Host, WORD port, char *filename);该函数下载字库文件到显示屏参数：filename: 字库文件名路径备注：字库文件有特殊的格式，目前只能支持16点阵和24点阵两种字库，可支持ASCII码和汉字内码long LEDAPI MakeRoot(long RootType, long ScreenType);该函数用于开始形成显示屏数据参数：RootType: 可有ROOT_PLAY和ROOT_DOWNLOAD两种选择ROOT_PLAY: 仅用于播放ROOT_DOWNLOAD: 保存并播放，由于主板上有Flash芯片，因此可将

9、显示内容保存在主板上，当断电重新启动时，显示屏可显示上次发送的数据（由于Flash有一定的写入次数限制，因此如果没有必要请不要用ROOT_DOWNLOAD）ScreenType: 由于显示屏类型众多，每种显示屏的显示数据都不一样，因此必须指定相应的显示屏类型SCREEN_UNICOLOR: 单色显示屏SCREEN_COLOR: 双色显示屏SCREEN_FULLCOLOR: 全彩色显示屏SCREEN_GRAY: 256级灰度显示屏请与相应控制卡对应。备注：调用该函数将会清除上次形成的数据，创建新的显示数据long LEDAPI AddLeaf(long DisplayTime);该函数用于增加一

10、个新的显示页面参数： DisplayTime: 页面显示时间，单位为毫秒(ms)long LEDAPI AddWindow(HDC dc,short width, short height, LPRECT rect, long method, long speed, long transparent);该函数在当前显示页面上创建一个显示区域，显示内容来自于dc参数：dc: 设备句柄（关于设备句柄的概念，可参见Windows API的介绍）width: 截取的宽度height: 截取图片的高度rect: 显示区域(left, top, right, bottom)method: 显示方式 1.

11、立即显示 2. 左滚显示 3. 连续上滚 4. 中间向上下展开 5. 中间向两边展开 6. 中间向四周展开 7. 向左移入 8. 向右移入 9. 从左向右展开 10. 从右向左展开 11. 右上角移入 12. 右下角移入 13. 左上角移入 14. 左下角移入 15. 从上向下移入 16. 从下向上移入 17. 闪 烁speed: 显示速度（1-8）越大越快transparent: 是否透明 0=不透明 1=透明返回值：如果创建成功，返回1，其它值为失败失败的原因一般为：1. 没有初始化动态链接库（没有调用LED_Startup）2. 没有开始形成数据（没有调用MakeRoot）3. 不存在当

12、前页面（没有调用AddLeaf）long LEDAPI AddDateTime(LPRECT rect, long transparent, char *fontname, long fontsize, long fontcolor, long format);该函数在当前页面创建一个数字时钟参数：rect: 显示区域transparent: 是否透明fontname: 字体名（用哪种字体显示）fontsize: 字体大小fontcolor: 字体颜色(如： RGB(255,0,0)format: 时钟格式DF_YMD: YYYY年MM月DD日 (2004年01月01日)DF_HN: HH:N

13、N (19:20)DF_HNS: HH:NN:SS (19:20:30)DF_Y: YYYY (2004)DF_M: MM (01)DF_D: DD (01)DF_H: HH (19)DF_N: NN (20)DF_S: SS (30)DF_W: 星期 (星期三)long LEDAPI AddString(char *str, LPRECT rect, long method, long speed, long transparent, long fontset, long fontcolor);该函数在当前页面创建一个字符串参数：str:要显示的字符串rect: 同上method: 同上sp

14、eed: 同上transparent: 同上fontset: 0=16点阵 1=24点阵fontcolor: 字体颜色备注：该函数只支持ASCII和汉字，而且主板必须存有字库，否则将不显示任何内容long LEDAPI AddText(char *str, LPRECT rect, long method, long speed, long transparent, char *fontname, long fontsize, long fontcolor);该函数在当前页面创建一个字符显示区域参数：str: 要显示的字符串rect: 同上method: 同上speed: 同上transpar

15、ent: 同上fontname: 当前操作系统支持的字体名称fontsize: 字体大小fontcolor: 字体颜色，例如RGB(255,0,0)备注：该函数和AddString的区别在于：AddString只发送ASCII和汉字内码到主板，因此要求主板必须存在字库，否则将不能显示; AddText将字符串在计算机上形成显示屏显示所需的点阵格式然后发送到显示屏，因此对主板没有任何要求。long LEDAPI AddMovie(char *filename, LPRECT rect, long stretch);该函数在当前显示页面上创建一个动画显示区域参数：filename: 动画文件名re

16、ct: 同上stretch: 是否缩放备注：动画文件必须是Windows支持的AVI格式返回值：如果创建成功，返回1，其它值为失败, 除了上面提到的失败原因外，AVI文件不存在、AVI文件格式不对、AVI文件太大都有可能引起该函数调用失败long LEDAPI AddCountUp(LPRECT rect, long transparent, char *fontname, long fontsize, long fontcolor, long format, LPSYSTEMTIME starttime);该函数在当前页面创建一个正计时显示区域参数：rect: 同上transparent: 同上fontname: 字体名fontsize: 字体大小fontcolor: 字体颜色format: 正计时格式CF_DAY: 从开始时间以来的天数 CF_HOUR: 从开始时间以来的小时数CF_HMS: 时分秒CF_HM:时分CF_MS: 分秒CF_S: 秒starttime: 开始时间时间的数据结构为：typdef struct _SYSTEMTIMEWORD wYear;WORD wMonth; WORD wDayOfWeek; WORD wDay; WORD wHou