VintaSoft Twain .NET SDK - 常见问题

常见问题解答

本页面包含有关 VintaSoft TWAIN .NET SDK 的最常见问题的解答。如果您在此处找不到技术问题的答案，请访问技术支持页面。

VintaSoft Twain .NET SDK 允许您从 TWAIN、WIA、SANE 或 eSCL 扫描仪获取图像。扫描图像可以使用简单的图像处理命令（反转、旋转、调整大小等）进行处理。扫描图像还可以保存为文件（PDF、TIF、JPEG、PNG、GIF、BMP）或上传到 HTTP(S) 或 FTP 服务器。

SDK 提供了可供 .NET 开发人员在 Windows 和 Linux 应用程序中使用的 .NET API。

该 SDK 还提供了一个 JavaScript API，可供 Web (JavaScript) 开发人员在 Windows 和 Linux 的 Web 应用程序中使用。在 Web 应用程序中使用 SDK 不需要了解 .NET。

.NET 开发人员可以在 C#、VB.NET、C++ for .NET、F#、Delphi for .NET 以及与 .NET 技术兼容的任何其他编程语言中使用 VintaSoft Twain .NET SDK。

Web 开发人员可以在 JavaScript 和 TypeScript 中使用 VintaSoft Twain .NET SDK。

VintaSoft Twain .NET SDK 包括：
  • 针对 .NET 10、.NET 9、.NET 8、.NET 7、.NET 6、.NET Framework 4.7、.NET Framework 3.5 编译的 Vintasoft .DLL 文件位于"[installation_path]\Bin"文件夹中。
  • 针对 .NET 10、.NET 9、.NET 8、.NET 7、.NET 6、.NET Framework 4.8/4.7/4.6/4.5/4.0、.NET Framework 3.5 编译的 Vintasoft .DLL 文件仅供注册用户使用。
  • 用户指南和 API 参考 - 链接此处。
  • 带有C#源代码的Visual Studio .NET演示应用程序项目，VB.NET 在文件夹"[install_path]\Examples"中。
  • 编译的演示应用程序（。exe文件）在文件夹"[install_path]\Bin"中。

最终用户许可协议的第 4.6、4.7 和 4.8 条列出了允许分发的文件。

VintaSoft Twain .NET SDK 评估版在使用中有以下限制：
  • 评估版为每个扫描图像添加水印。
  • 评估版不允许您将扫描的彩色图像保存为 JPEG、TIFF 或 PDF 文件。
    如果您需要在评估过程中将扫描的彩色图像保存到文件中，请将彩色图像保存为 PNG 或 BMP 文件。
    如果您在评估过程中需要将扫描图像保存为 JPEG、TIFF 或 PDF 文件，请扫描黑白或灰色图像。

注册版本的SDK没有限制。
有关 VintaSoft Twain .NET SDK 文档的信息可以在 此处 获取。

是的，我们或我们的客户已成功测试了以下 TWAIN 图像扫描器：

  • Kodak图像扫描仪： Kodak i40, Kodak i55/i65, Kodak i60, Kodak i250, Kodak i260, Kodak i600, Kodak i810, Kodak i1120, Kodak i1320, Kodak i1420, Kodak i1440, Kodak i2400, Kodak DVC325, Kodak Ngenuity 9000, Kodak Alaris S2070, Kodak ScanStation 720EX, Kodak ScanStation 730EX, Kodak i4200, Kodak i2900, Kodak i5800, Kodak Alaris S2070
  • Canon图像扫描仪： Canon CanoScan LiDE 20, Canon CanoScan LiDE 30, Canon CanoScan LiDE 35, Canon CanoScan LiDE 50, Canon CanoScan LiDE 60, Canon CanoScan LiDE 110, Canon CanoScan LiDE 200, Canon CanoScan 3000, Canon DE-7550C, Canon DR-2010C, Canon DR-2050C, Canon DR-2080C, Canon DR-2580C, Canon DR-3060C, Canon DR-3080C, Canon DR-5020, Canon DR-5080C, Canon DR-6010C, Canon DR-6030C, Canon DR-6080, Canon DR-7550C, Canon DR-7580, Canon DR-9080C, Canon DR-G1100, Canon IR2870 (Network), Canon MP730, Canon P-150, Canon P-215, Canon PIXMA MG5640, Canon PIXMA MX885, Canon PIXMA MX870, Canon DR-X10C, Canon CanoScan 9000F Mark II, Canon LiDE 400
  • HP图像扫描仪： HP Color LaserJet CM1312, HP OfficeJet 6500, HP OfficeJet 6700 Premium, HP OfficeJet 7200, HP OfficeJet D125XI, HP OfficeJet T65XI, HP LaserJet Pro 500 color MFP M570dw, HP LaserJet Pro M1132, HP PSC 950, HP PSC 1310, HP PCS 1510, HP ScanJet 2200C, HP ScanJet 2400, HP ScanJet 3800, HP ScanJet 4600, HP ScanJet 5000, HP ScanJet 5470C, HP ScanJet 5550, HP ScanJet 5590, HP ScanJet 7400C, HP ScanJet 8250, HP ScanJet 8300, HP ScanJet Enterprise 7000 s2, HP ScanJet Enterprise 8500, HP ScanJet Enterprise 9000, HP ScanJet G2410, HP ScanJet G3010, HP ScanJet Flow N9120 fn2, HP Scanjet Pro 2000 s1, HP LaserJet Pro MFP M132fw
  • Fujitsu图像扫描仪： Fujitsu FI-60F, Fujitsu FI-4120Cdj, Fujitsu FI-4220Cdj, Fujitsu FI-4340C, Fujitsu FI-5120Cdj, Fujitsu FI-5220Cdj, Fujitsu FI-5750Cdj, Fujitsu FI-6130, Fujitsu fx-7300NX, Fujutsu Scan Partner 600C
  • Epson图像扫描仪： Epson DS-770 II, Epson GT-2500, Epson GT-8500, Epson GT-9000, Epson GT-15000, Epson GT-S50, Epson Perfection 1240, Epson Perfection 1660, Epson Perfection 1670, Epson Perfection 1680, Epson Perfection 2580, Epson Perfection 3170, Epson Perfection 4490, Epson Perfection 4870, Epson Perfection V10, Epson Perfection V700 Photo, Epson Stylus CX5200, Epson Stylus Office BX300F, Epson Stylus Office BX305, Epson WorkForce WF-2750, Epson XP312 Series
  • Xerox图像扫描仪： Xerox DocuMate 152, Xerox DocuMate 262, Xerox DocuMate 3220, Xerox WorkCentre 3615 (USB), Xerox WorkCentre 3615 (Network)
  • Brother图像扫描仪： Brother MFC-7220, Brother MFC-7320, Brother MFC-7820N, Brother MFC-8220, Brother MFC-8460N, Brother MFC-8480DN, Brother MFC-8710DW, Brother MFC-9120CN, Brother DCP-7040R, Brother DCP-7055R
  • Plustek图像扫描仪： Plustek OptiCard 820, Plustek OptiCard 821, Plustek OpticPro A360, Plustek OpticPro A380 Plus, Plustek SmartOffice PS286 Plus, Plustek SmartOffice PS406U, Plustek SmartOffice PS456U
  • Ricoh图像扫描仪： Ricoh IS450, Ricoh Aficio MP161spf, Ricoh MP 4000
  • Intotec图像扫描仪： InoTec SCAMAX 403, InoTec SCAMAX M03, InoTec SCAMAX M06
  • Kyocera图像扫描仪： Kyocera FS-1125MFP
  • Sceye图像扫描仪： sceyeX A4
  • Konica Minolta图像扫描仪： Konica Minolta MS6000 MK2
  • Lexmark图像扫描仪： Lexmark Pro915
  • Neat图像扫描仪： Neat ADF Scanner
  • Samsung图像扫描仪： Samsung SCX-3205
  • Microtek图像扫描仪： Microtek ScanMaker 4800
  • Panasonic图像扫描仪： Panasonic KV-S1025C, Panasonic KV-S202xC, Panasonic KV-S4085C
  • Array图像扫描仪： Array2905
  • Avision图像扫描仪： AV600G
  • Nashuatec图像扫描仪： MP 5500
  • Visioneer图像扫描仪： Visioneer RoadWarrior

如果您已使用 VintaSoft Twain .NET SDK 成功测试了 TWAIN 图像扫描器，并希望分享此信息，请将信息发送给我们，我们将更新此列表。

如果您的应用程序是 64 位的，您可以使用 32 位或 64 位的 TWAIN 设备管理器 2.x。
如果您的应用程序是 32 位的，您可以使用 32 位的 TWAIN 设备管理器 1.x 或 32 位的 TWAIN 设备管理器 2.x。
请查阅有关可用 TWAIN 设备管理器的信息这里，并确保您的系统上已安装 TWAIN 设备管理器。

Vintasoft.Twain 命名空间存在于 Vintasoft.Twain.dll 程序集中。 Vintasoft.WinTwain 命名空间存在于 Vintasoft.WinTwain.dll 程序集中。

Vintasoft.Twain.dll 是一个 .NET 程序集，可用于 Windows 和 Linux 平台的 .NET 应用程序。此程序集使用来自 Vintasoft.Shared 库的绘图图元。

Vintasoft.WinTwain.dll 是一个 .NET 程序集，可用于 Windows 平台的 .NET 应用程序。此程序集使用来自 System.Drawing.Common 库的绘图图元。

Vintasoft.WpfTwain.dll 是一个 .NET 程序集，可用于 Windows 平台的 WPF 应用程序。此程序集使用来自 WPF 库的绘图图元。

根据您的应用程序和当前任务，您需要使用 Vintasoft.Twain.dll、Vintasoft.WinTwain.dll 或 Vintasoft.WpfTwain.dll 文件。

不，您不能将 Vintasoft.XXX.dll 程序集嵌入到其他 DLL 文件中。这是不可能的，并且被许可协议禁止。

请阅读微软网站上"部署并作为单个可执行文件运行"文章中的"排除嵌入的文件"部分，了解如何将文件从 .NET 程序集中排除：https://learn.microsoft.com/zh-cn/dotnet/core/deploying/single-file/overview?tabs=cli#exclude-files-from-being-embedded

请打开"C:\Windows\twain_32"文件夹，检查您的扫描仪是否已安装32位TWAIN驱动程序。
请打开"C:\Windows\twain_64"文件夹，检查您的扫描仪是否已安装64位TWAIN驱动程序。

如果您的扫描仪没有 TWAIN 驱动程序，请在您的计算机上安装 TWAIN 驱动程序。

要使用扫描仪的 WIA 驱动程序，您需要使用 TWAIN 设备管理器 1.x 版本 - 这仅在 32 位应用程序中才有可能。
此错误消息表示 VintaSoft JavaScript TWAIN API 无法向"VintaSoft Web TWAIN"服务发送请求。

要诊断此问题，请按照以下步骤操作：
1. 在网页浏览器中打开 URL http://localhost:25319/api/VintasoftTwainApi/Status 并查看结果。如果您看到包含 VintaSoft Web TWAIN 服务信息的网页，则说明 VintaSoft Web TWAIN 服务已安装并运行在您的计算机上 - 请继续执行步骤 2；否则，请继续执行步骤 3。
2. 在 Web 浏览器中打开 Web 应用程序，打开 Web 浏览器中的开发者工具（按 Ctrl+I 或 F12），选择"网络"选项卡，在 Web 浏览器中重新加载网页（按 F5），分析"网络"选项卡中的信息，并尝试查找问题的原因。
3. 打开任务管理器（按 Ctrl+Shift+Esc），选择"服务"选项卡，并尝试查找"VintasoftWebTwainService"服务。如果找到该服务，请转到步骤 1。 4. 如果"VintasoftWebTwainService"服务未运行，请启动该服务，重启您的 Web 应用程序，并检查结果；否则，请转至步骤 6。
4. 如果"VintasoftWebTwainService"服务未运行，请启动该服务，重启您的 Web 应用程序，并检查结果；否则，请转至步骤 5。
5. 查看故障排除部分此处，并尝试找出问题的原因。
6. 打开VintaSoft JavaScript TWAIN 扫描演示应用程序。演示应用程序会提示您下载最新版本的 VintaSoft Web TWAIN 服务。请在您的计算机上下载并安装最新版本的 VintaSoft Web TWAIN 服务。重启 Web 应用程序并查看结果。
VintaSoft Web TWAIN 解决方案包含两部分：
1."VintaSoft Web TWAIN"服务，它提供对本地 TWAIN 扫描器的访问。
2. VintaSoft TWAIN JavaScript API 是 Web 应用程序用来访问"VintaSoft Web TWAIN"服务的。

这两个部分都有版本号，如果版本号相同，它们就可以协同工作。

要解决此问题，请将"VintaSoft Web TWAIN"服务更新到版本 15.1.0.1：
1. 从您的计算机卸载 VintaSoft Web TWAIN 服务版本 15.0.6.1。
2. 打开VintaSoft JavaScript TWAIN 扫描演示应用程序，系统会提示您下载最新版本的 VintaSoft TWAIN 服务。
3. 在您的计算机上下载并安装最新版本的"VintaSoft Web TWAIN"服务。
请打开"C:\Windows\twain_32"文件夹，检查您的扫描仪是否已安装32位TWAIN驱动程序。
请打开"C:\Windows\twain_64"文件夹，检查您的扫描仪是否已安装64位TWAIN驱动程序。

如果您的扫描仪没有 TWAIN 驱动程序，请在您的计算机上安装 TWAIN 驱动程序。

如果您想为扫描仪使用 32 位 TWAIN 驱动程序，则需要使用 32 位或 64 位版本的 VintaSoft Web TWAIN 服务和 TWAIN 设备管理器 1.x 或 2.x。
如果您想为扫描仪使用 64 位 TWAIN 驱动程序，则需要使用 64 位版本的 VintaSoft Web TWAIN 服务和 TWAIN 设备管理器 2.x。
要为扫描仪使用 WIA 驱动程序，则需要 32 位版本的 VintaSoft Web TWAIN 服务和 TWAIN 设备管理器 1.x。

请参阅"初始化 Vintasoft Web TWAIN 服务"部分中初始化 32 位或 64 位版本的 VintaSoft Web TWAIN 服务的说明此处。

您可以使用VintaSoft JavaScript TWAIN 扫描演示应用程序测试 TWAIN 设备管理器 1.x 和 2.x 版本的使用情况。为此，请打开演示应用程序，然后使用"兼容 TWAIN 2"复选框启用/禁用 TWAIN 设备管理器。

如果您想充分发挥高速 TWAIN 图像扫描仪的性能，请尝试使用VintaSoft TWAIN High Performance Demo并查看结果。
VintaSoft TWAIN High Performance Demo 是一个 WinForms 项目，它使用 VintaSoft Twain .NET SDK 和 VintaSoft Imaging .NET SDK，并演示如何：

  • 使用高速 TWAIN 图像扫描仪扫描图像以获得最高效率
  • 预览扫描的图像
  • 将扫描的图像保存为单个图像文件或多页 TIFF 或 PDF 文件。

有关大多数问题的信息可以在文档或此常见问题解答中找到。如果您没有找到问题的答案，请写一封电子邮件给客户支持。