在线客服
  • 产品快速查询
    扫描控件接口

    文通 WTwain,是北京文通科技有限公司研制开发的扫描中间件,提供强大的扫描控制接口,帮助用户将扫描控制技术无缝内嵌到用户业务系统中,为影像资源的建立提供了方便,快捷,稳定的技术手段。WTwain 支持本地模式、文件模式、内存模式扫描,具有控制灵活、适应性强等突出的技术优势。

    奥普思凯 WTwain,是北京奥普思凯科技有限公司研制开发的扫描中间件,提供强大的 扫描控制接口,帮助用户将扫描控制技术无缝内嵌到用户业务系统中,为影像资源 的建立提供了方便,快捷,稳定的技术手段。

    WTwain 支持本地模式、文件模式、内存模式扫描,具有控制灵活、适应性强 等突出的技术优势。

    系统最小配置

    操作系统: Windows 2000、 Windows XP、 Windows 2003 操作系统 及以上版 本;
    CPU: 586 以上;
    内存: 256M 以上。

    系统文件概述

    1. sdk

    WTwain_OCX.dll 该文件是本 SDK 直接调用的 DLL, 供用户在程序中调用。

    WTwain_OCX.lib VC6.0 格式的库文件,如果使用静态连接 DLL,需要使用 该库。

    2. doc

    文通 WTwain 用户手册.doc 即本自述文件。

    3. sample

    包含 SDK 接口调用示例程序及源码。

    系统功能简介

    本系统具有 WTwain 扫描控制所有功能,包括

    • 支持显示 twain 界面和不显示 twain 界面扫描方式;
    • „
    • 可以不显示 twain 界面时设置扫描图像的分辨率、明亮度等参数;
    • „
    • 可以在待机和扫描时检查扫描仪是否有纸;
    • „
    • 可以检查扫描仪是否在线;
    • „
    • 可以选择三种扫描模式:本地模式、文件模式、内存模式。
    •  

      1 void WT_TwainScanStart(HWND hWnd)

      【功能】开始扫描,在扫描之前调用一次。
      【参数】 hWnd 父窗口的句柄。建议设置为空。
      【返回值】无

      2 WT_ERROR WT_TwainScanEnd()

      【功能】扫描结束,在扫描结束后调用此接口。
      【参数】 无
      【返回值】详细可以查看 WT_ERROR 定义

      3 WT_ERROR WT_SelectSource(HWND hWnd)

      【功能】 扫描结束,在扫描结束后调用此接口。
      【参数】 hWnd–扫描仪列表的父窗口,如果没有可以填写空值,如 NULL。
      【返回值】详细可以查看 WT_ERROR 定义

      4 WT_ERROR WT_SelectSourceEx(HWND pWnd, const char* lpScannerName)

      【功能】 用指定的 lpScannerName 扫描仪进行扫描。
      【参数】 pWnd -扫描仪列表的父窗口
                    lpScannerName-扫描仪名称。
      【返回值】详细可以查看 WT_ERROR 定义

      5 char* WT_GetSourceName()

      【功能】获取扫描仪的名称
      【参数】 无
      【返回值】扫描仪的名称

      6 WT_ERROR WT_SetShowTwainUI(BOOL bShowUI)

      【功能】 设置是否显示 Twain 界面
      【参数】 bShowUI–false 不显示 Twain 界面,-true 显示 Twain 界面
      【返回值】详细可以查看 WT_ERROR 定义

      7 BOOL WT_GetShowTwainUI()

      【功能】 获取是否弹出 Twain 界面。
      【参数】 无
      【返回值】ture-当前为弹出 twain 界面扫描,false-当前为非弹出 twain 界面扫描

      8 WT_ERROR WT_SetTwainUIINFO()

      【功能】 WT_ERROR WT_SetTwainUIINFO()
      【参数】 无
      【返回值】详细可以查看 WT_ERROR 定义

      9 WT_ERROR WT_SetTwainScanMode(int nMode)

      【功能】设置扫描模式,根据 Twain 标准的定义,共定义三种方式的扫 描:本地模式,文件模式,内存模式。
      【参数】 nMode:0-本地模式 1-文件模式 2-内存模式,默认是内存模式
      【返回值】详细可以查看 WT_ERROR 定义

      10 WT_ERROR WT_TwainScanImage(const char* lpImageName)

      【功能】获取扫描图像,开始扫描和扫描结束之间多次调用
      【参数】 lpImageName-图像路径+名称(如: D:\Image\001.jpg) 现在支持两种文件格式: jpg 和 pdf。
                    如果需要扫描存储成 pdf 则需这么传递: 例 D:\Image\001.pdf
      【返回值】详细可以查看 WT_ERROR 定义

      11 BOOL WT_IsHavePaper()

      【功能】扫描过程中判断扫描仪中是否有纸。
      【参数】 无
      【返回值】 TRUE 为有纸 FALSE 为无纸。

      12 BOOL WT_IsScanOnline(HWND hWnd, const char* lpScannerName)

      【功能】检查扫描仪是否在线
      【参数】 hWnd -扫描仪列表的父窗口,如果没有可以填写 NULL
                    lpScannerName-扫描仪的名称,如(AV2000)
      【返回值】TRUE 为在线 FALSE 不在线

      13 BOOL WT_IfHavePaper()

      【功能】 待机情况下判断扫描仪内是否有纸。
      【参数】 无
      【返回值】TRUE 为有纸 FALSE 为无纸。

      14 WT_ERROR WT_SetScanParam(WT_SCANPARAM ScanParam, int lpValue)

      【功能】设置扫仪扫描参数。
      【参数】 ScanParam:

      • 0:图像类型(二值、灰度、彩色图像)
      • 1:分辨率
      • 2:亮度
      • 3:对比度
      • 4:图片旋转
      • 5:反色
      • 6:双面扫描
      • 7:自动倾斜校正
      • 8:固定尺寸
      • 9:自动旋转
      • 10:自动虑过空白页
      • 11:扫描范围左上水平坐标
      • 12:扫描范围左上垂直坐标
      • 13:扫描范围水平长度
      • 14:扫描范围垂直长度
      • 15:滤色
      • 16:自动彩色侦测
      • 17:彩色背面扫描
      • 18:灰阶背面扫描
      • 19:黑白背面扫描

      nValue:

      • (1) 当 nType=0 时: 0:二值图像 1:灰度图像 2:彩色图像
      • (2) 当 nType=1 时: 最好选择 300DPI
      • (3) 当 nType=2 时:range : -1000 ~ 1000 PS:0 为标准值
      • (4) 当 nType=3 时:同上
      • (5) 当 nType=4 时:0: 正常角度 90: 顺时针旋转 90 度
                                    180: 顺时针旋转 180 度
                                    270: 逆时针旋转 90 度
      • (6) 当 nType=5 时:0:为白底黑字    1:为黑底白字
      • (7) 当 nType=6 时:0:不进行双面扫描    1: 启动双面扫描
      • (8) 当 nType=7 时:0:不进行自动倾斜校正    1:启动自动倾斜校正
      • (9) 当 nType=8 时: 参见尺寸定义表, 使用其中的“代号”作 为值
      • (10) 当 nType=9 时:0:不进行自动旋转     1:启动自动旋转
      • (11) 当 nType=10 时:0:不进行自动虑过空白页     1:启动自动虑过空白页
      • (12) 当 nType=11 时:扫描范围左上水平坐标,默认值为 0, 默认单位为英尺
      • (13) 当 nType=12 时:扫描范围左上垂直坐标,默认值为 0, 默认单位为英尺
      • (14) 当 nType=13 时:扫描范围水平长度,默认值为 850,默 认单位为英尺
      • (15) 当 nType=14 时:扫描范围垂直长度,默认值为 1100,默 认单位为英尺
      • (16) 当 nType=15 时:0:滤除红色, 1:滤除绿色, 2:滤除 蓝色, 3:无滤色
      • (17) 当 nType=16 时:0:不进行自动彩色侦测, 1:自动彩色 侦测
      • (18) 当 nType=17 时:0:不进行彩色背面扫描, 1:进行彩色 背面扫描
      • (19) 当 nType=18 时:0:不进行灰阶背面扫描, 1:进行灰阶 背面扫描
      • (20) 当 nType=19 时:0:不进行黑白背面扫描, 1:进行黑白 背面扫描

      【注】: 当设置扫描范围时(即 nType=11, nType=12, nType=13, nType=14) 不是适用于所有类型的扫描仪,对自动送纸扫描仪( ADF 扫描仪)和 HP 扫描仪 不可以设置这四个参数,只能对平板扫描仪可以设置扫描范围参数。 且如果同时 设置旋转(即 nType=4 时),需要先设置扫描范围后设置旋转度数。

      【返回值】详细可以查看 WT_ERROR 定义

      15 char* WT_GetSerialNumber ()

      【功能】获取设备序列号
      【参数】 无
      【返回值】设备序列号

      *特别说明:所有的接口需要 WT_TwainScanStart 和 WT_TwainScanEnd 之间调用。


      WT_ERROR: 

      • 0) 成功
      • 1) 初始化错误或指针、句柄为空
      • 2) DS 打开失败
      • 3) DSM 打开失败
      • 4) 使能 DS 失败
      • 5) 没有指定的扫描仪
      • 6) 数据源打开失败
      • 7) 创建窗口句柄失败
      • 8) 扫描取消
      • 9) 非指定的扫描仪
      • 10) 加密锁读取错误
      • 11) 扫描仪内没有纸
      • 12) 未知错误

      *尺寸定义

      代号  尺寸(mm* mm)  TWAIN 标准 
      0 自动适应纸张 TWSS_NONE
      1 210 x 297 TWSS_A4
      2 182 x257 TWSS_JISB5
      3 216 x 280 TWSS_USLETTER
      4 216 x 356 TWSS_USLEGAL
      5 148 x 210 TWSS_A5
      6 250 x 353 TWSS_ISOB4
      7 125 x 176 TWSS_ISOB6
      9 280 x 432 TWSS_USLEDGER
      10 184 x 267 TWSS_USEXECUTIVE
      11 297 x 420 TWSS_A3
      12 353 x 500 TWSS_ISOB3
      13 105 x 148 TWSS_A6
      14 229 x 324 TWSS_C4
      15 162 x 229 TWSS_C5
      16 114 x 162 TWSS_C6
      17 1682 x2378 TWSS_4A0
      18 1189 x 1682 TWSS_2A0
      19 841 x1189 TWSS_A0
      20 594 x 841 TWSS_A1
      21 420 x 594 TWSS_A2
      22 74 x 105 TWSS_A7
      23 52 x 74 TWSS_A8
      24 37 x 52 TWSS_A9
      25 26 x 37 TWSS_A10
      26 1000 x 1414 TWSS_ISOB0
      27 707 x 1000 TWSS_ISOB1
      28 500 x 707 TWSS_ISOB2
      29 176 x 250 TWSS_ISOB5
      30 88 x 125 TWSS_ISOB7
      31 62 x 88 TWSS_ISOB8
      32 44 x 62 TWSS_ISOB9
      33 31 x 44 TWSS_ISOB10
      34 1030 x 1456 TWSS_JISB0
      35 728 x 1030 TWSS_JISB1
      36 515 x 728 TWSS_JISB2
      37 364 x 515 TWSS_JISB3
      38 257 x 364 TWSS_JISB4
      39 182 x 182 TWSS_JISB6
      40 91 x 128 TWSS_JISB7
      41 64 x 91 TWSS_JISB8
      42 45 x 64 TWSS_JISB9
      43 32 x 45 TWSS_JISB10
      44 917 x 1297 TWSS_C0
      45 648 x 917 TWSS_C1
      46 458 x 648 TWSS_C2
      47 324 x 458 TWSS_C3
      48 81 x 114
      TWSS_C7
      49 57 x 81 TWSS_C8
      50 40 x 57 TWSS_C9
      51 28 x 40 TWSS_C10
      52 140 x 216 TWSS_USSTATEMENT
      53 90 x 55 TWSS_BUSINESSCARD
      54 设备区最大值 TWSS_MAXSIZE

       

     

    版权所有 © 北京奥普思凯科技有限公司
    2016 京ICP备14050634号-1 京公网安备 1101080213597

    首页 | 联系我们 | 服务支持 | 网站地图