diff --git a/faq/difference-between-Twain-and-wia.md b/faq/difference-between-Twain-and-wia.md index e065fede..7e77b30a 100644 --- a/faq/difference-between-Twain-and-wia.md +++ b/faq/difference-between-Twain-and-wia.md @@ -11,12 +11,15 @@ permalink: /faq/difference-between-Twain-and-wia.html # Capture/Image Source -## What are the differences between TWAIN and WIA? +## What are the differences between TWAIN and WIA drivers? TWAIN driver TWAIN is the most widely used protocol for physical document scanners. Almost all scanners in the market come with a TWAIN driver and are supported by TWAIN applications like the Dynamic Web TWAIN SDK. -`WIA` refers to Windows Image Acquisition, which is the still image acquisition platform in the Windows family that enables imaging/graphics applications to interact with imaging hardware and standardizes the interaction between different applications and scanners. +`WIA` stands for Windows Image Acquisition, which is a Microsoft driver model for capturing digital images from various devices, such as scanners, cameras and other imaging devices. The WIA protocol is built-in and supported by Windows OS, so no extra driver installation is required. WIA offers standardized hardware compatibility and a stable driver environment, making it easier to integrate imaging capabilities into web scanning applications. + +Prior to Dynamic Web TWAIN version 18.2, WIA drivers are not officially supported. But `WIA` devices can be used by `TWAIN` applications like `Dynamic Web TWAIN` through a `TWAIN compatibility layer`. This means `WIA` is not supported natively; therefore, when a device supports both `TWAIN` and `WIA`, `TWAIN` is the better option. + +As of Dynamic Web TWAIN version 18.2, we officially support WIA 2.0 drivers. To make sure your web application works with WIA scanner drivers, please refer to the article: How do I support WIA scanner drivers in my application? + -`WIA` devices can be used by `TWAIN` applications like `Dynamic Web TWAIN` through a `TWAIN compatibility layer`. This means `WIA` is not supported natively; therefore, when a device supports both `TWAIN` and `WIA`, `TWAIN` is the better option. -By comparison, `WIA` can only control a very limited set of general capabilities of the device while `TWAIN` can control all standard and even custom capabilities of the device. Another thing is that `TWAIN` has three transfer modes (Native, Memory, File), while `WIA` only has two (Memory, File). diff --git a/faq/support-wia-scanner-drivers.md b/faq/support-wia-scanner-drivers.md new file mode 100644 index 00000000..aa28c90d --- /dev/null +++ b/faq/support-wia-scanner-drivers.md @@ -0,0 +1,33 @@ +--- +layout: default-layout +noTitleIndex: true +needAutoGenerateSidebar: true +title: How do I support WIA scanner drivers in my application? +keywords: Dynamic Web TWAIN, Capture/ Image Source, WIA +breadcrumbText: How do I support WIA scanner drivers in my application? +description: How do I support WIA scanner drivers in my application? +permalink: /faq/support-wia-scanner-drivers.html +--- + +# Capture/Image Source + +## How do I support WIA scanner drivers in my application? + +Prior to Dynamic Web TWAIN version 18.2, WIA drivers are not supported and TWAIN drivers are recommended. Please refer to this article for the differences between WIA and TWAIN drivers. + +As of Dynamic Web TWAIN version 18.2, we officially support WIA 2.0. By comparison, `WIA` can only control a very limited set of general capabilities of the device, while `TWAIN` can control all standard and even custom capabilities of the device. In addition, `WIA` has only two transfer modes (Memory, File), while `TWAIN` has three (Native, Memory, File). + +Since Dynamic Web TWAIN v18.0, we introduced a new set of scanner related APIs. +To support WIA 2.0, +- If your application is already using the new set of APIs below, no application change is required. +- If not, replace the old APIs with the matching new APIs. + +| New APIs (supports WIA) | Old APIs | +|:-|:-| +| [GetDeviceAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#getdevicesasync) | [GetSourceNames()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#getsourcenames), [GetSourceNamesAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#getsourcenamesasync)| +| [SelectDeviceAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectdeviceasync) | [SelectSourceByIndex()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsourcebyindex), [SelectSourceByIndexAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsourcebyindexasync) | +| [SelectSourceAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsourceasync) | [SelectSource()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsource) | +| [AcquireImageAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#acquireimageasync) | [AcquireImage()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#acquireimage) | + +### Difference between the WIASCANNER and WIATWAINSCANNER DeviceType +To support the WIA protocol in v18.2+, we added a new Enumaration `WIASCANNER` to [Dynamsoft.DWT.EnumDWT_DeviceType](https://www.dynamsoft.com/web-twain/docs/info/api/Dynamsoft_Enum.html?ver=latest&&cVer=true#dynamsoftdwtenumdwt_devicetype) . The enumaration named `WIATWAINSCANNER` represents WIA source mapped through the TWAIN protocol after packaging by Microsoft. It was used in previous versions of Dynamic Web TWAIN and it will continue to be supported. \ No newline at end of file diff --git a/faq/use-wia-insteadof-wiatwain.md b/faq/use-wia-insteadof-wiatwain.md deleted file mode 100644 index f14ff808..00000000 --- a/faq/use-wia-insteadof-wiatwain.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -layout: default-layout -noTitleIndex: true -needAutoGenerateSidebar: true -title: How to use pure WIA source instead of WIATWAIN source from version 18.2? -keywords: Dynamic Web TWAIN, Capture/ Image Source, WIA -breadcrumbText: How to use pure WIA source instead of WIATWAIN source? -description: How to use pure WIA source instead of WIATWAIN source? -permalink: /faq/use-wia-insteadof-wiatwain.html ---- - -# Capture/Image Source - -## How to use pure WIA source instead of WIATWAIN source from version 18.2? - -As of Dynamic Web TWAIN version 18.2, we start to support WIA protocol officially. - -### WIA - -WIA stands for Windows Image Acquisition which is a Microsoft driver model for capturing digital images from various devices, such as scanners, cameras and other imaging devices. - -Compared with TWAIN, the WIA protocol is built-in supported by Windows OS. No extra drivers needed for WIA-supported devices. - -WIA offers standardized hardware compatibility and a stable driver environment, making it easier to integrate imaging capabilities into the web scanning applications. - - -### Difference between WIASCANNER and WIATWAINSCANNER - - -We add a new Enumaration `WIASCANNER` to [Dynamsoft.DWT.EnumDWT_DeviceType](https://www.dynamsoft.com/web-twain/docs/info/api/Dynamsoft_Enum.html?ver=latest&&cVer=true#dynamsoftdwtenumdwt_devicetype) to support WIA protocol. There is another Enumaration named `WIATWAINSCANNER` which represents WIA source mapped through the TWAIN protocol after packaging by Microsoft and it was used to support WIA sources in the previous version. - -If you are using `WIATWAINSCANNER` before and would like to use `WIASCANNER` from version 18.2 instead, you need to modify the APIs used in your code accordingly. - -| WIASCANNER | WIATWAINSCANNER | -|:-|:-| -| [GetDeviceAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#getdevicesasync) | [GetSourceNames()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#getsourcenames), [GetSourceNamesAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#getsourcenamesasync)| -| [SelectDeviceAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectdeviceasync) | [SelectSourceByIndex()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsourcebyindex), [SelectSourceByIndexAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsourcebyindexasync) | -| [SelectSourceAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsourceasync) | [SelectSource()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#selectsource) | -| [AcquireImageAsync()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#acquireimageasync) | [AcquireImage()](https://www.dynamsoft.com/web-twain/docs/info/api/WebTwain_Acquire.html#acquireimage) | - -*`WIATWAINSCANNER` is still available in version 18.2.* \ No newline at end of file diff --git a/getstarted/vue3.md b/getstarted/vue3.md index 1924b337..d6ad4c75 100644 --- a/getstarted/vue3.md +++ b/getstarted/vue3.md @@ -190,7 +190,7 @@ npm run dev #### On desktop -If you have installed `DWT` and have configured a valid `ProductKey`, you should now have a working page to scan documents from your scanner. Otherwise, please refer to [this page]({{site.indepth}}features/initialize.html#installation-of-the-dynamsoft-service) which explains how the library is initialized or contact us for further assistance. +If you have installed `DWT` and have configured a valid `ProductKey`, you should now have a working page to scan documents from your scanner. If not, please refer to [this page]({{site.indepth}}features/initialize.html#installation-of-the-dynamsoft-service) which explains how the library is initialized or contact us for further assistance. #### On mobile diff --git a/info/schedule/Stable.md b/info/schedule/Stable.md index f9b3864c..2ee3c09f 100644 --- a/info/schedule/Stable.md +++ b/info/schedule/Stable.md @@ -14,8 +14,8 @@ permalink: /info/schedule/Stable.html ## 18.2 (05/09/2023) ### New Features -#### WIA Scanner Support - - Added support for direct control of WIA drivers in [EnumDWT_DeviceType]({{site.info}}api/Dynamsoft_Enum.html#dynamsoftdwtenumdwt_devicetype). +#### WIA 2.0 Scanner Support + - Added support for direct control of WIA 2.0 drivers in [EnumDWT_DeviceType]({{site.info}}api/Dynamsoft_Enum.html#dynamsoftdwtenumdwt_devicetype).