VintaSoft Twain .NET SDK - F.A.Q.

VintaSoft Twain .NET SDK allows to control and acquire images from TWAIN, WIA, SANE and eSCL scanner. Acquired images can be preprocessed with common image processing commands (invert, rotate, resize, etc) and saved to a file (PDF, TIF, JPEG, PNG, GIF, BMP) or uploaded onto HTTP(S) or FTP server.

The SDK provides a .NET API, which can be used by .NET developer in application for Windows and Linux.

The SDK provides also a JavaScript API, which can be used by Web (JavaScript) developer in web application for Windows and Linux. .NET skills are not necessary for SDK usage in a web application.

.NET developer can use the SDK in C#, VB.NET, C++ for .NET, F#, Delphi for .NET, any other programming language compatible with .NET.

Web developer can use the SDK in JavaScript and TypeScript.

The SDK consists from:

• .NET assemblies for .NET developer
  • .NET assemblies (.dll files) for .NET 10. Files are located in "[SDK_install_path]\Bin\DotNet10\" folder.
  • .NET assemblies (.dll files) for .NET 9. Files are located in "[SDK_install_path]\Bin\DotNet9\" folder.
  • .NET assemblies (.dll files) for .NET 8. Files are located in "[SDK_install_path]\Bin\DotNet8\" folder.
  • .NET assemblies (.dll files) for .NET 7. Files are located in "[SDK_install_path]\Bin\DotNet7\" folder.
  • .NET assemblies (.dll files) for .NET 6. Files are located in "[SDK_install_path]\Bin\DotNet6\" folder.
  • .NET assemblies (.dll files) for .NET Framework 4+. Files are located in "[SDK_install_path]\Bin\DotNet4\" folder.
  • .NET assemblies (.dll files) for .NET Framework 3.5. Files are located in "[SDK_install_path]\Bin\DotNet3_5\" folder.
• JavaScript API files for Web developer
  • JavaScript files (.js files) and TypeScript modules (.d.ts files). Files are located in "[SDK_install_path]\Bin\JavaScript\" folder.
  • VintaSoft Web TWAIN service. Installer for VintaSoft Web TWAIN service is located in "[SDK_install_path]\Bin\VintasoftWebTwainService\" folder.
• SDK documentation, which contains User Guide, .NET API Reference and JavaScript API Reference. Information about documentation can be found here.
• Source codes of demo applications for Visual Studio .NET 2010-2026 (C# and VB.NET). Files are located in "[install_path]\Examples\" folder.
• Compiled demo applications (.exe files) for .NET Framework 3.5/4+ and .NET 7/8/9. Files are located in "[SDK_install_path]\Bin\" folder.

The files allowed for distribution are listed in paragraph 4.6, 4.7 and 4.8 of the License agreement.

Please read the information about the evaluation version limitations of VintaSoft Twain .NET SDK at the bottom of this page: https://www.vintasoft.com/docs/vstwain-dotnet/Licensing-Twain-Evaluation.html

User Guide for .NET developer is available here: https://www.vintasoft.com/docs/vstwain-dotnet/
.NET API Reference is available here: https://www.vintasoft.com/docs/vstwain-dotnet/Vintasoft.Twain.html
User Guide for Web developer is available here: https://www.vintasoft.com/docs/vstwain-dotnet-web/
JavaScript API Reference for Web developer is available here: https://www.vintasoft.com/docs/vstwain-dotnet-web/Vintasoft.Twain.JS.html

Yes, we or our customers are successfully tested the following TWAIN image scanners:

• Kodak image scanners: 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 image scanners: 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 image scanners: 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
• Fuijtsu image scanners: 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 image scanners: 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 image scanners: Xerox DocuMate 152, Xerox DocuMate 262, Xerox DocuMate 3220, Xerox WorkCentre 3615 (USB), Xerox WorkCentre 3615 (Network)
• Brother image scanners: 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 image scanners: Plustek OptiCard 820, Plustek OptiCard 821, Plustek OpticPro A360, Plustek OpticPro A380 Plus, Plustek SmartOffice PS286 Plus, Plustek SmartOffice PS406U, Plustek SmartOffice PS456U
• Ricoh image scanners: Ricoh IS450, Ricoh Aficio MP161spf, Ricoh MP 4000
• Intotec image scanners: InoTec SCAMAX 403, InoTec SCAMAX M03, InoTec SCAMAX M06
• Kyocera image scanners: Kyocera FS-1125MFP
• Sceye image scanners: sceyeX A4
• Konica Minolta image scanners: Konica Minolta MS6000 MK2
• Lexmark image scanners: Lexmark Pro915
• Neat image scanners: Neat ADF Scanner
• Samsung image scanners: Samsung SCX-3205
• Microtek image scanners: Microtek ScanMaker 4800
• Panasonic image scanners: Panasonic KV-S1025C, Panasonic KV-S202xC, Panasonic KV-S4085C
• Array image scanners: Array2905
• Avision image scanners: AV600G
• Nashuatec image scanners: MP 5500
• Visioneer image scanners: Visioneer RoadWarrior

If you successfully tested TWAIN image scanner with VintaSoft TWAIN .NET SDK and want to share this information, please send us information and will we update this list.

If you have 64-bit application, you can use 32- or 64-bit TWAIN device manager 2.x.
If you have 32-bit application, you can use 32-bit TWAIN device manager 1.x or 32-bit TWAIN device manager 2.x.
Please read about TWAIN device managers here and make sure that TWAIN device manager is installed in your system.

Vintasoft.Twain namespace is present in Vintasoft.Twain.dll assembly. Vintasoft.WinTwain namespace is present in Vintasoft.WinTwain.dll assembly.

Vintasoft.Twain.dll - .NET assembly that can be used in .NET application for Windows and Linux. This assembly uses drawing primitives from Vintasoft.Shared library.

Vintasoft.WinTwain.dll - .NET assembly that can be used in .NET application for Windows. This assembly uses drawing primitives from System.Drawing.Common library.

Vintasoft.WpfTwain.dll - .NET assembly that can be used in WPF application for Windows. This assembly uses drawing primitives from WPF library.

You need to use Vintasoft.Twain.dll, Vintasoft.WinTwain.dll or Vintasoft.WpfTwain.dll depending from your application and your task.

No, you cannot embed Vintasoft.XXX.dll assembies into other DLL. This is not possible and prohibited by the license agreement.

Please read how to exclude files from being embedded in section "Exclude files from being embedded" in article "Single-file deployment" on Microsoft's web site: https://learn.microsoft.com/en-us/dotnet/core/deploying/single-file/overview?tabs=cli#exclude-files-from-being-embedded

Please open folder "C:\Windows\twain_32\" and check if you have 32-bit TWAIN driver for your scanner.
Please open folder "C:\Windows\twain_64\" and check if you have 64-bit TWAIN driver for your scanner.

If you do not have TWAIN driver for your scanner, please install TWAIN driver to your computer.

If you want to use WIA driver for your scanner, you need to use TWAIN device manager 1.x - this is possible in 32-bit application only.

Error message means that VintaSoft JavaScript TWAIN API cannot send request to the VintaSoft Web TWAIN service.

Please do the following steps to diagnose the problem:
1. Open URL http://localhost:25319/api/VintasoftTwainApi/Status in web browser and see the result. If you will see web page with information about VintaSoft Web TWAIN service, VintaSoft Web TWAIN service is installed and running on your computer - go to step 2; otherwise, go to step 3.
2. Open your web application in web browser, open the developer console in web browser (press Ctrl+I or F12 key), select "Network" tab, reload web page in web browser (press F5 key), analyze information in "Network" tab and try to find reason of problem.
3. Open task manager (press Ctrl+Shift+Esc keys), select "Services" tab and try to find "VintasoftWebTwainService" service. If you will find the service, go to step 4; otherwise, go to step 6.
4. If "VintasoftWebTwainService" is not running, run "VintasoftWebTwainService" service, reload your web application and see the result; otherwise, go to the step 5.
5. See "Troubleshooting" section here and try to find reason of problem.
6. Open VintaSoft JavaScript TWAIN Scanning Demo, demo will suggest to download the latest version of VintaSoft Web TWAIN service. Download and install the latest version of VintaSoft Web TWAIN service to your computer. Reload your web application and see the result.

VintaSoft Web TWAIN solution consists from 2 parts:
1. VintaSoft Web TWAIN service, which provides access to the local TWAIN scanners.
2. VintaSoft TWAIN JavaScript API, which is used by web application to access VintaSoft Web TWAIN service.

Both parts have version number and both parts can work together if they have the same version number.

For solving the problem please update VintaSoft Web TWAIN service to version 15.1.0.1:
1. Uninstall VintaSoft Web TWAIN service 15.0.6.1 from your computer.
2. Open VintaSoft JavaScript TWAIN Scanning Demo, demo will suggest to download the latest version of VintaSoft Web TWAIN service.
3. Download and install the latest version of VintaSoft Web TWAIN service to your computer.

Please open folder "C:\Windows\twain_32\" and check if you have 32-bit TWAIN driver for your scanner.
Please open folder "C:\Windows\twain_64\" and check if you have 64-bit TWAIN driver for your scanner.

If you do not have TWAIN driver for your scanner, please install TWAIN driver to your computer.

If you want to use 32-bit TWAIN driver for your scanner, you need to use 32- or 64-bit version of VintaSoft Web TWAIN service and use TWAIN device manager 1.x or 2.x.
If you want to use 64-bit TWAIN driver for your scanner, you need to use 64-bit version of VintaSoft Web TWAIN service and use TWAIN device manager 2.x.
If you want to use WIA driver for your scanner, you need to use 32-bit version of VintaSoft Web TWAIN service and use TWAIN device manager 1.x

Please read how to initialize 32- or 64-bit version of VintaSoft Web TWAIN service in the "Initialization of Vintasoft Web TWAIN service" section here.

You can check usage of TWAIN device manager 1.x and 2.x in VintaSoft JavaScript TWAIN Scanning Demo - open the demo and enable/disable TWAIN device manager using "TWAIN 2 compatible" checkbox.

If you want to get the maximum performance from high speed TWAIN image scanner, please try to use VintaSoft TWAIN High Performance Demo and see the result.
VintaSoft TWAIN High Performance Demo is a WinForms project that uses VintaSoft TWAIN .NET SDK and VintaSoft Imaging .NET SDK and demonstrates how to:

• Scan images from high-performance scanner with the maximum performance
• Preview the scanned images
• Save scanned images to the separate files or multipage TIFF or PDF file

Answers to the majority of questions can be found in the documentation or this web site. Please send a message to Customer Support Service to get more help.