CL2005Ocx编程手册

CL2005Ocx编程手册(V1.2)第一章简介1.1调用顺序本控件中函数的调用顺序如下：步骤一：通讯初始化，调用ComInitial、NetInitial或ModemInitial；步骤二：控制卡特性设置，调用SetCardProperty；步骤三：数据收发，调用数据收发函数；步骤四：关闭通讯，调用Close。如果对联网控制的多个屏进行操作，则在步骤二和步骤三间进行循环。1.2控制卡的工作模式CL2005系列控制卡均提供两种工作模式：图片模式和文字模式。1.2.1图片模式在图片模式下，图片数据发送完后，必须调用发送节目表的函数(SendProgList)，显示屏才会播放节目。图片模式中，所有节目均具备移动展开特效。允许设计定时播放和安排计算安全天数计时等。1.2.2文字模式文字模式主要用于对实时显示要求比较高的场合。此时，显示屏的作用类似于一个写字板，不具备任何定时和移动展开特效，只可以通过函数在显示屏的某个位置输出文字或画水平、垂直线，且文字的输出宽度不能大于显示屏的宽度。控制卡上有两个显示缓冲区(Bank)，可以在这两个显示缓冲区之间切换，即在显示0区的同时可以将输出定到1区，待要显示的内容输出完毕后再将1区切换到显示屏上真正显示出来，此时又可以在0区进行输出。1.3语言说明本控件使用VC++语言开发，因此所有涉及的字符串都是指8位以0结尾的字符串。第二章数据结构本控件涉及三类数据结构，它们是图片、节目表以及亮度表。2.1图片的数据结构C语法：BYTEPictureBuff[512][256]Delphi语法：PictureBuff=Array[0..511]OfArray[0..255]OfBYTEBasic语法：DimPictureBuff[0..255,0..511]AsByte说明：CL2005系列通讯屏控制卡最大控制宽度达2048列，1个位表示屏上1个点，则宽度使用256个8位的字节；最大控制高度为512行。与显示屏对应的显示数据存储在数据缓冲区的左上角。若是双色屏，则先按照显示屏的实际高度先存储红色数据，然后紧接着存储绿色数据。例如，若显示屏的高度为128行，则PictureBuf[0]-PictureBuf[127]存储128行红色数据，PictureBuf[128]-PictureBuf[255]存储绿色数据。2.2节目表C语法：structProgStruct{BYTEPictIndex;BYTEEnter;BYTELeave;BYTESpeed;BYTEStayTime;BYTEbFollowPlay;BYTEbShowTimer;BYTEbTimerPlay;BYTETimerMode;BYTEWeekFlag;BYTEStartHour;BYTEStartMinute;BYTEEndHour;BYTEEndMinute;BYTENotUsed0;BYTENotUsed1;}Delphi语法：ProgStruct=RecordPictIndex:BYTE;Enter:BYTE;Leave:BYTE;Speed:BYTE;StayTime:BYTE;bFollowFlag:BYTE;bShowTimer:BYTE;bTimerPlay:BYTE;TimerMode:BYTE;WeekFlag:BYTE;StartHour:BYTE;StartMinute:BYTE;EndHour:BYTE;EndMinute:BYTE;NotUsed0:BYTE;NotUsed1:BYTE;End;Basic语法：TypeProgStructPictIndexAsByteEnterAsByteLeaveAsByteSpeedAsByteStayTimeAsBytebFollowFlagAsBytebShowTimerAsBytebTimerPlayAsByteTimerModeAsByteWeekFlagAsByteStartHourAsByteStartMinuteAsByteEndHourAsByteEndMinuteAsByteNotUsed0AsByteNotUsed1AsByteEndType说明：PictIndex：本节目项播出的图片索引；Enter：进入方式代码，参见第六章；Leave：退出方式代码，参见第六章；Speed：移动或展开、擦除的速度，0-15，15最快，0最慢；StayTime：停留时间，0-126。D7为单位，D7=0：单位为秒，D7=1:单位为分。数据127表示静止；bFollowFlag：紧随前页连续播放标志，0：不连续，1：连续；bShowTimer：显示时钟标志。0：不显示，1：显示；bTimerPlay：定时播出标志。0：常规播放，1：定时播放；TimerMode：时钟显示方式，0：不显示，1：单行居左，2：单行居中，3：单行居右4：双行居左，5：双行居中，6：双行居右WeekFlag：周定时标志，D1-D7代表周一到周日，对应位=0则当日不播出，否则播出。该属性级别高于下面的定时时间段；StartHour：定时播出的开始时间之小时；StartMinute：定时播出的开始时间之分；EndHour：定时播出的结束时间之小时；EndMinute：定时播出的结束时间之分；NotUsed0：保留；NotUsed1：保留2.3亮度表C语法：structBrightnessItem{BYTEStartHour;BYTEStartMinute;BYTEEndHour;BYTEEndMinute;BYTEBrightValue;}Delphi语法：BrightnessItem=RecordStartHour:BYTE;StartMinute:BYTE;EndHour:BYTE;EndMinute:BYTE;BrightValue:BYTE;End;Basic语法：TypePrightnessItemStartHourAsByteStartMinuteAsByteEndHourAsByteEndMinuteAsByteBrightValueAsByteEndType说明：每个亮度表项表明一个时间段内要设置的显示屏的亮度。StartHour：开始时间之小时；StartMinute：开始时间之分；EndHour：结束时间之小时；EndMinute：结束时间之分；BrightValue：上述时间段内的亮度第三章系统功能函数3.1初始化3.1.1串口通讯初始化C语法：BOOLComInitial(shortComPort,longBaudRate,shortWaitTime);Delphi语法：functionComInitial(ComPort:Smallint;BaudRate:Integer;WaitTime:Smallint):WordBool;Basic语法：FunctionComInitial(ComPortAsInteger,BaudRateAsLong,WaitTimeAsInteger)AsBoolean功能：初始化要的串行通讯口。在使用RS232或RS422通讯模式时必须调用本函数对串口进行初始化。入口：ComPort：16位有符号整型，串口号，有效范围1-8；BaudRate：32位有符号整型，速率，有效值9600、19200、38400或57600，与控制卡上硬件设置有关；WaitTime：16位有符号整型，通讯等待延时，发出数据包后在等待本规定设置的延时后若没有收到应答，则视为通讯失败。该延时从数据包开始发送即进行计时，一般至少设定为800以上。出口：布尔型，串口被占、串口号超出范围或波特率超出范围均返回假。成功返回真。3.1.2网络通讯初始化C语法：BOOLNetInitial(longRemoteIP,shortClientServerMode,shortWaitTime)Delphi语法：NetInitial(RemoteIP:Integer;ClientServerMode:Smallint;WaitTime:Smallint):WordBoolBasic语法：FunctionNetInitial(RemoteIPAsLong,ClientServerModeAsInteger,WaitTimeAsInteger)AsBoolean功能：初始化以太网通讯。入口：RemoteIP：32位有符号整型，控制卡的IP地址；ClientServerMode：16位有符号整型，控制卡的客户机/服务器模式，0:客户机,1:服务器；WaitTime：定义同3.1.1，在网络模式下一般给4000以上。出口：布尔型，与控制卡连接成功返回真，否则返回假。3.1.3调制解调器初始化C语法：BOOLModemInitial(shortModemPort,shortWaitTime)Delphi语法：functionModemInitial(ModemPort:Smallint;WaitTime:Smallint):WordBoolBasic语法：FunctionModemInitial(ModemPortAsInteger,WaitTimeAsInteger)AsBoolean功能：初始化使用调制解调器通讯。入口：ModemPort：16位有符号整型，Modem连接的串口号；WaitTime：定义同3.1.1，在使用调制解调器通讯时一般给2000以上。出口：布尔型，Modem确实存在并有响应则返回真，否则返回假。3.1.4设置控制卡属性C语法：BOOLSetLEDProperty(shortCardType,shortCardNum,shortWidth,shortHeight,shortColor,shortLockHZLibFlag)Delphi语法：functionSetLEDProperty(CardType:Smallint;CardNum:Smallint;Width:Smallint;Height:Smallint;Color:Smallint;LockHZLibFlag:Smallint):WordBoolBasic语法：FunctionSetLEDProperty(CardTypeAsInteger,CardNumAsInteger,WidthAsInteger,HeightAsInteger,ColorAsInteger,LockHZLibFlagAsInteger)AsBoolean功能：设置控制卡属性。这些属性将用于在本设定以后接收数据的控制卡编号、计算控制卡上存储每个图片画面需要的空间、控制卡上一共可存储的图片数量、计算单个图片的发送次数等。入口：CardType：16位有符号整型，控制卡类型编号，从1开始。1对应Ⅰ型卡、2对应Ⅱ型卡、3对应Ⅲ型卡、4对应Ⅳ型卡……，与实际的控制卡类型相关；CardNum：16位有符号整型，控制卡编号，从0开始，最大不超过30。与控制卡上的硬件设置有关；Width：16位有符号整型，显示屏的实际水平列点数；Height：16位有符号整型，显示屏的实际垂直行点数；Color：16位有符号整型，显示屏采用的模块。0：单色，1：双色LockHZLibFlag：16位有符号整型，保护控制卡上已上载的汉字库标记。0：不保护，1：保护。选择保护汉字库空间后，上传的图片数量将减少一部分，且汉字库空间无法写入其他内容。出口：布尔型，入口各参数有效时返回真，否则返回假。3．2关闭3.2.1关闭通讯C语法：voidCloseCL2005(void)Delphi语法：procedureCloseCL2005Basic语法：SubCloseCL2005()功能：关闭通讯资源。若此前使用ComInitial初始化，则释放串口；若是使用NetInitial初始化，则断开连接；若是使用ModemInitial初始化，则释放连接Modem的串口。入口：无出口：无3.3其他操作3.3.1发送调制解调器命令C语法：BOOLSendModemCmd(lon