用户文档

通用认证码识别(Captchio) 使用手册

使用步骤

训练：打开要训练的认证码图片，数量越多，效果越好。学习要求有原值对比，以帮助Captchio判断识别出来的是否真实的值；你还必须输入“色值”；
- 自动学习：如果认证码图片是规则的，如每个字符的宽度、之间的间距类似，则可以用这个方法自动训练；
- 手工学习：如果认证码图片是不规则的，如每个字符的宽度、之间的间距都不一样，甚至很多变形等，则可以勾掉“自动学习”，必须输入“左偏”(第一个字符距离图片左边的空白间距)、“长度”(字符数)、“宽度”(每个字符大约的宽度)，点击训练进行手工训练；
- 保存/打开测试包：你可以把当前多个的测试认证码图片保存为一个测试包文件(仅包括图片路径和原值)，下次测试便可方便地使用“打开测试包”重新加载，方便训练，默认扩展名是".ctp"；
识别：
- 点击“操作”->“识别”，你会发现Captchio识别出来的认证码会显示在“原值”的下面，如果识别出来的效果不理想，可以尝试改用手工学习，调整位移、宽度、色值等选项；
- 你可以打开一个认证码图片进行测试；
保存/打开识别数据(默认扩展名是".cdb")：
- 保存：训练完成，识别效果满意，你可以把当前的识别数据保存到一个文件；
- 打开：你可以打开原来保存的识别数据，这样就省却每次的训练测试；

第三方调用

说明：Captchio的最终应用是作为第三方组件提供给开发用户用以识别认证码，实现自动登录网站系统/提交数据，所以Captchio提供了一个ActiveX DLL功能库，任何支持ActiveX技术的开发工具都可以调用，包括VC/VB/Delphi/.NET/Java(JNI)等；
调用：
- 公开的接口
  - 最主要的接口是“Captchio.cCaptcha”，ClsID="{C9DEED67-5401-436B-A631-9092A5562869}"
- 公开的方法
  - 打开识别数据：bool OpenCharDB(string DBFilePath)，DBFilePath是识别数据文件；
  - 识别认证码
    - string GetStringFromFile(string ImageFilePath)：ImageFilePath是要识别的认证码图片文件；
    - string GetStringFromURL(string URL)：URL是要识别的认证码图片的网址；
    - string GetStringFromBytes(byte[] ImageBytes)：ImageBytes是要识别的认证码图片文件内容数组；
- 公开的属性
  - CharAmount：认证码图片里面的字符数；
  - CharWidth：认证码图片里面每个字符的宽度；
  - ItemOffsetX：参看识别->左偏；
  - BinaryColor：参看识别->色值；
  - TorrenceCount：参看识别->干扰；
  - BorderCount：参看识别->边框；