v13update10.txt

AVE1000S系列卡SDK&Driver

                 SSAPI V13 Update10 说明(2002.11.11): 
1. 该版本SapiMutilDemo 的应用程序演示升级为1.2版，详见"Sapi多路演示程序说明.DOC"
2. 该版本少量修改了SSAPI.DLL,SurvAPI.dll使用户即使不更新Driver(surv.sys),也可使用
   新的DLL。(注意使用Update7-Update9的SSAPI时必须更新Driver为Driver40OSD,否则程序启动
   会锁死，而Update10则无此问题。TT3V6\SSAPI_LIB\win2000_NT\FastI2c下的SurvAPI.dll
   与Update7-Update9一致，它访问器件I2C稍快一些，如用它也必须使用Driver40OSD下的surv.sys
   对无OSD的1000，3000卡一般不用它）
3. 抓帧函数sapiSingleMemBmpCap更稳定，消除了以前偶尔漏帧(抓不到)的问题，最大速度
   12.5帧/s (PAL),15帧/s (NTSC)。
4. 解决某些1000卡，正常记录时随机变为抽帧记录，造成播放变快。
   (对该问题，用户不升级也可解决，只需在启动压缩前调用      sapiSetCompressFrameRate(CARDID,ENCODER1,0,0);一次，禁止抽帧即可。Update10已
   在内部完成。)

请替换SSAPI.dll,SurvAPI.DLL,较早版本还需替换SurvIONT.dll(WIN2000)或SurvIO.dll(win98)


                 
                 SSAPI V13 Update9 说明(2002.10.25):
该版本在V13 Update8A基础上加入了一个SapiMutilDemo 的应用程序演示使用SSAPI驱动
16路1000卡。
新增 BOOL sapiGetDispRegion(int MRgnID,int SRgnID,RECT * pct)函数
主要用于使用户可方便获得自己创建的显示子区域的大小信息。

修正了使用sapiStartOneCompressRec2MVDetect(仅用于AVE3000卡）记录数据不对的错误。
对AVE3000卡的报警部分有少量改动。
该版本在V13 Update8，或8A基础上更新替换SurvAPI.DLL和SSAPI.dll,SSAPI.H

                  SSAPI V13 Update8A 说明(2002.10.16):
该版本在V13 Update8基础上更新
修正了当无视频输入信号时调用sapiSingleMemBmpCap抓位图会死锁(sapiSingleMemBmpCap不返回)
问题。
在V13 Update8基础上替换SurvAPI.DLL即可。

                  SSAPI V13 Update6A 说明(2002.10.16):
该版本在V13 Update6基础上更新
修正了当无视频输入信号时调用sapiSingleMemBmpCap抓位图会死锁(sapiSingleMemBmpCap不返回)
问题。
在V13 Update6基础上替换SurvAPI.DLL即可。


                  SSAPI V13 Update8 说明(2002.10.16):
该版本在V13 Update7基础上更新
Driver:与Update7相同，早于Update7版WIN2000/NT4必须更新driver.
SurvioNT.dll,SurvAPI.dll,SSAPI.DLL,ssapi.h更新.
 
1. 更正了Update7版OSD模块一个潜在故障（仅在Update7才有）。
2. 报警区域加大为8(原为5)
3. 更正了报警接口函数使其返回值可反映报警区域
SAPI    BOOL  DLLCALL sapiMpgMoveDetect(...)
改为
SAPI    int   DLLCALL sapiMpgMoveDetect(...)
返回值:如设置了报警区域则bit0-bit7为1时分别表示该区域检测到运动目标。 
报警回掉类VOIDENCODERCALLBACK2参数state含义与sapiMpgMoveDetect返回值相同。
 
4. 更改定义 
SAPI    int sapiFindCompressHead(...);
改为
SAPI    int DLLCALL sapiFindCompressHead(...);
5. 支持WIN98(只更新SurvAPI.dll,SSAPI.DLL,ssapi.h)。


                  SSAPI V13 Update7 说明(2002.9.28):
该版本在V13 Update6基础上改变了硬件I2C访问方法，提高效率。特别适合带OSD的AVE1000，3000卡。
可大大减少OSD访问时CPU占用率。
使用OSD应注意：OSD访问对CPU占用较高，应尽量减少对OSD的频繁访问。
如发现压缩文件有马赛克，请加大压缩缓冲个数(tvcard.ini的BufNums).
更新：surv.sys(驱动);surviont.dll,survapi.dll,ssapi.dll
该版不支持WIN98。
驱动surv.sys更新：将surv.sys复制到系统目录的system32\drivers下替换surv.sys即可。

                  SSAPI V13 Update6 说明(2002.9.20):

1. 支持一种新减帧方式，连续切换变帧，该方式要求有AVE1000 -DF型卡支持，
   该方式允许在压缩工作期间在减帧和不减帧两种方式下平滑切换，无坏帧。
   配合报警可大幅压缩记录文件。
   （注意，非-DF卡也可以这样连续切换变帧记录，但不可靠，可能发生记录停止现象。另外
    非-DF卡，调用sapiSetCompressFrameRate时立即可改变帧率，-DF卡调用sapiSetCompressFrameRate时
    帧率仅被设置，但不立即改变，调用sapiSetCompressFrameRate时立即改变）

  工作方法：
  1)在启动压缩前：
     调用sapiEnableDecreaseFrameRate禁止减帧
     调用sapiSetCompressFrameRate设置减帧率。
  2)启动压缩后，可根据需要调用sapiEnableDecreaseFrameRate起动减帧，或禁止减帧
     一般可和运动报警函数配合使用。
  3)不固定减帧后，播放压缩文件，时间不对，可用两种方法解决：
    a. 使用带OSD的 1000 卡，时间由OSD决定。
    b. 程序跟踪调用sapiEnableDecreaseFrameRate的时刻，并记录，回读解码时间，
       比较记录，自己显示时间（较复杂）。

新增函数sapiEnableDecreaseFrameRate，使能，或禁止减帧。
新增tt3v6DF演示测试程序，演示测试该功能。其中菜单StartRec1,配合EnableDecreaseFrames，
DisableDecreaseFrames(手动)和CallBackStartRecDemo（自动）演示了该功能.

2. 1000卡仿MPEG4改进压缩方法，提高压缩率:
 *************AVE1000，AVE3000提高视频压缩率的方法：2002.9.13***************
你可用TT3V6.EXE 程序测试。
1)将tvcard.ini [ENCODER]节（AVE1000） 或[ENCODERAV]节（AVE3000）
M=3改为M=1，N=15改为N=50; BitRateMode=0改为BitRateMode=1; Quality 设为9
即可开始压缩测试，数据量一般为100MB-180MB/小时，与MPEG4相近。
2)也可程序修改上述参数（ENCODERPARM 结构）

3. 修改Audio stop,加快。
4. 更新Update4增加的几个函数定义，改为DLLCALL类型(PASICAL)。


                  SSAPI V13 Update5 说明:

更新 SurvAPI.DLL, SSAPI.DLL, ssavcode7.dll(仅用于AVE3000卡）
1.修改sapiSingleMemBmpCap函数，解决抓帧时，有时会有的“快速运动图象分裂”，“图象重复”，抓帧速  度慢等问题。建议用该函数抓帧。
2.修改sapiGetCompressData函数,使运动报警状态参数State可用。
3.修改出错对话框的一些BUGS。
4.更新AVE3000卡MODE=0x8010 工作方式。

 
                  SSAPI V13 Update4 说明:

在Update3基础上，请替换Survapi.dll,SSAPI.dll,SurvIONT.dll(SurvIO.dll for win98)
SSAPI.H,SSAPI.dll和TT3V6 Demo 有改动。

1.新增 SAPI BOOL sapiIsPal(UINT CardID);用于自动检测Video为PAL或NTSC。
2.新增 SAPI void sapiDispMessageBox(BOOL bDisp);用于禁止或允许出错对话框弹出。
  缺省为允许。
3.新增3个调试用函数。用于调试目的。
  SAPI    void sapiDbgSavTimeMsg(int i,char * buf);
  SAPI    void sapiDbgSavMsg(int i,char * buf);
  //Beware to use this function,it will destory the auto mangment of AVE1000
  //you can call this function only before sapiDeviceInit;
  SAPI    BOOL sapiDbgInitRegistry();
4. 修改了SSAPI，使启动，停止压缩响应变快。并解决了当视频信号源不良时有时造成压缩停止问题。
5. AVE3000 卡新增MODE=0x8010 工作方式，类似于0x800d工作方式,但MPEG Pack非定长2324。
   解决了3小时问题。
6. TT3V6 演示程序新增预录功能演示，预录时间3-5S。


                  SSAPI V13 Update3 说明:

在Update2基础上，请替换Survapi.dll,SSAPI.dll
Survio.dll，SSAPI.dll，tt3v6.exe 有改动。
1.新增3个外部报警IO函数
  SAPI    BOOL DLLCALL  sapiSetAlarmOut(UINT CardID,int value); 报警输出
  SAPI    int DLLCALL   sapiGetAlarmIn(UINT CardID); 报警输入
  SAPI    BOOL DLLCALL  sapiIsSupportAlarm(UINT CardID); 报警支持检测
报警IO函数需相应的报警硬件模块支持。
见SIMPAPI13.TXT说明

2. AVE3000卡新增压缩工作模式MODE=0x8010 (mode=16), 解决长时间记录问题。
3. tt3v6测试程序新增报警输入，输出，抽帧测试。 

                  SSAPI V13 Update2 说明:
请替换Surviont.dll(Survio.dll),Survapi.dll,SSAPI.dll
1.修改了新报警接口（SSAPI V12以后）一处错误，该错误在多路报警时产生，如突然使CPU占用增高(用Dephi),或
  各路相互影响。

2.全面修改了错误记录方式，出错请查看ave3.rec文本文件。
  死机后仍可查看。
  在技术支持时可将它EMAIL给我们。
  要产生更多记录，请将SSAPI工程重新编译，在“工程/设置/C,C++对话框，予处理器定义框中
  加入_USRDBG,后重新编译。反之，可取消_USRDBG重新编译。
3.Audio模块有少量修改。
4.sapiSingleMemBmpCapg改为开启显示或不开启显示预览均可抓图。
5.TT3V6.EXE测试程序修改，现在可在同一目录下启动多个TT3V6，测试多卡情况。
 （如测试时各路压缩参数需要不同，则仍需复制多目录测试）。
6.为减少代码传送大小，SSAPI源代码仅在用户请求时才发给用户。
  目录TT3V6\SSAPI_LIB下是S卡运行所需的公共库及TVCARD.INI配置文件和SSAPI.H头文件，W98下是
  Win9x系统需要的库，WI2000_NT下是Win2000，nt4系统需要的库,DEBUG下是已用_USRDBG编译的.  

                  SSAPI V13 Update1 说明:

                  2002.6.16
1. 新内存捕获接口由捕获16bit BMP 改为24 bit BMP.
2. 解决sapiSingleMemBmpCap新内存捕获接口，在捕获高速运动物体时，产生的画面分裂问题。
   在捕获高速运动物体时，请用sapiSingleMemBmpCap函数，且捕获BMP高度应小于或288（PAL）
   ，240（NTSC）效果才好。
   在捕获BMP高度大于288时用sapiSingleMemBmpCap捕获的第一，二幅图可能不对，以后的图
   就对了。
2. 解决AVE3000卡反复起停压缩多次后产生的不能起动压缩问题。
3. 修改sapiMpgSetMoveDetectArea一处错误（产生异常）。 
4. 出错信息显示更准确。

                  
                  SSAPI V13  说明:

                  2002-5-20

AVE3000(S3000) Mpeg-1 A/V 同步压缩卡是一种A/V全同步的mpeg-1系统流压缩卡，功能上类似AVE2000卡，但采用的是
新一代MPEG压缩芯片，功耗低，体积小，可靠性高。SSAPI从V12开始支持AVE3000卡.

该版改动较大:
新函数说明见SIMPAPI13.TXT

1.新增硬件OSD支持函数15个
SAPI    BOOL DLLCALL  sapiIsSupportOSD(UINT CardID,UINT VChannelID);
SAPI    BOOL DLLCALL  sapiOSDEnable(UINT CardID,UINT VChannelID);
SAPI    BOOL DLLCALL  sapiOSDDisable(UINT CardID,UINT VChannelID);
SAPI    BOOL DLLCALL  sapiOSDClearAll(UINT CardID,UINT VChannelID);
SAPI    BOOL DLLCALL  sapiOSDDoubleFontSize(UINT CardID,UINT VChannelID,BOOL Use);
SAPI    BOOL DLLCALL  sapiOSDOneRowFontSize(UINT CardID,UINT VChannelID,int row,int FontID);
SAPI    BOOL DLLCALL  sapiOSDSetStartOffset(UINT CardID,UINT VChannelID,UINT v_off,UINT h_off);
SAPI    BOOL DLLCALL  sapiOSDGetStartOffset(UINT CardID,UINT VChannelID,UINT * pv_off,UINT * ph_off);
SAPI    int  DLLCALL  sapiOSDSetChineseFont(UINT CardID,UINT VChannelID,char * HZCode);
SAPI    BOOL DLLCALL  sapiOSDClearChineseFont(UINT CardID,UINT VChannelID,int code);
SAPI    BOOL DLLCALL  sapiOSDPutChar(UINT CardID,UINT VChannelID,UINT row,UINT col,unsigned char c,BOOL IsBlink);
SAPI    BOOL DLLCALL  sapiOSDPutString(UINT CardID,UINT VChannelID,UINT row,UINT col,char * strbuf,BOOL IsBlink);
SAPI    BOOL DLLCALL  sapiOSDPutChineseString(UINT CardID,UINT VChannelID,UINT row,UINT col,char * BufHZCode,BOOL IsBlink);
SAPI    unsigned char DLLCALL sapiOSDSetBMPFont(UINT CardID,UINT VChannelID,BYTE * Bmpbuf);
SAPI    BOOL DLLCALL  sapiOSDClearBMPFont(UINT CardID,UINT VChannelID,unsigned char c);
2. SSAPI 新增一种压缩数据获得接口（消息接口）（以前只有回调函数一种接口）
   这种接口使用简单，不易出错，但开销比回调函数要大（增加一次复制操作）
SAPI    int  DLLCALL  sapiRegisterGetCompressDataWindow(UINT CardID,UINT EncoderID,HWND hWnd,UINT Msg,UINT Mode);
SAPI    int  DLLCALL  sapiUnRegisterGetCompressDataWindow(UINT CardID,UINT EncoderID);