2014-04-04 06:52:11 +08:00
|
|
|
TWAIN Application-Side Library
|
2014-04-03 07:01:21 +08:00
|
|
|
==============================
|
|
|
|
|
|
2014-04-04 06:52:11 +08:00
|
|
|
Info
|
2014-04-03 07:01:21 +08:00
|
|
|
--------------------------------------
|
2014-04-06 08:14:19 +08:00
|
|
|
This is a dotnet library created to work with [TWAIN](http://twain.org/) interface.
|
2014-04-15 07:51:36 +08:00
|
|
|
This project has these features:
|
2014-04-03 07:01:21 +08:00
|
|
|
|
2014-04-04 06:52:11 +08:00
|
|
|
* Targets latest TWAIN version (2.3 at the moment)
|
2014-04-13 21:30:39 +08:00
|
|
|
* Supports all the TWAIN functions in the spec
|
2014-04-15 07:51:36 +08:00
|
|
|
* Hosts internal message loop so no need to hook into application UI thread
|
2014-04-04 06:52:11 +08:00
|
|
|
|
2014-04-15 07:51:36 +08:00
|
|
|
The solution contains tester projects in winform, wpf, and even (gasp!) console.
|
2014-04-08 10:50:09 +08:00
|
|
|
A nuget package is also [available here](https://www.nuget.org/packages/ntwain)
|
|
|
|
|
|
|
|
|
|
Using the lib
|
|
|
|
|
--------------------------------------
|
|
|
|
|
To properly use this lib you will need to be reasonably familiar with the TWAIN spec
|
|
|
|
|
and how it works in general. Except for certain "important" calls that drive the
|
2014-04-13 21:30:39 +08:00
|
|
|
TWAIN state change, most triplet operations are only availble as-is so you will need to know
|
|
|
|
|
when and how to use them. There are no high-level, single-line scan-a-page-for-me-now functions.
|
|
|
|
|
|
2014-04-17 08:39:30 +08:00
|
|
|
The main class to use is TwainSession. New it up, hook into the events, and start calling
|
|
|
|
|
all the TWAIN functions provided through it.
|
|
|
|
|
|
|
|
|
|
Caveats
|
|
|
|
|
--------------------------------------
|
2014-04-13 21:30:39 +08:00
|
|
|
At the moment this lib does not provide ways to parse transferred image data and require
|
2014-04-17 08:39:30 +08:00
|
|
|
consumers to do the conversion themselves. The winform project contains one such
|
|
|
|
|
example for handling DIB image in native transfer using the CommonWin32 lib.
|
2014-04-15 07:51:36 +08:00
|
|
|
|
2014-04-17 08:39:30 +08:00
|
|
|
Because it hosts its own message thread, the event callbacks will likely be from another thread.
|
|
|
|
|
If you would like things marshalled to a "UI" thread then set the SynchronizationContext property
|
2014-04-19 21:10:15 +08:00
|
|
|
to the one from the UI thread. This part is highly experimental.
|
|
|
|
|
|
|
|
|
|
64-bit OS
|
|
|
|
|
--------------------------------------
|
|
|
|
|
If the application process is running in 64-bit then you will need to make sure you have the
|
|
|
|
|
newer data source manager (twaindsm.dll) installed.
|
|
|
|
|
[DSM from TWAIN.org](http://sourceforge.net/projects/twain-dsm/files/TWAIN%20DSM%202%20Win/)
|
|
|
|
|
|
|
|
|
|
Otherwise just compile and run the app as x86 and it'll use the 32-bit version (twain_32.dll) that comes with Windows.
|
|
|
|
|
|
|
|
|
|
If you really want to test 64-bit drivers for whatever reason, you most likely will have to use
|
|
|
|
|
the test one from TWAIN.org since there are no known 64-bit TWAIN DS drivers at the time of writing.
|
|
|
|
|
[Sample DS from TWAIN.org](http://sourceforge.net/projects/twain-samples/files/TWAIN%202%20Sample%20Data%20Source/TWAIN%20DS%202.1.3/)
|
