Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions _articles/extended-usage/dynamsoft-service-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,18 @@ Once the installation is done, the users can click the orange sentence 'click he

![Initialization](/assets/imgs/Initialization-2.png)

### Download Links for the Service Installers

Here is a table of links for the latest version.

| Platform | Download Link |
| ------------- | --------------- |
| Windows | [Dynamic-Web-TWAIN-Service-Setup.msi](https://demo.dynamsoft.com/DWT/DWTResources/dist/DynamicWebTWAINServiceSetup.msi) |
| macOS | [Dynamic-Web-TWAIN-Service-Setup.pkg](https://demo.dynamsoft.com/DWT/DWTResources/dist/DynamicWebTWAINServiceSetup.pkg) |
| Linux | [Dynamic-Web-TWAIN-Service-Setup.deb](https://demo.dynamsoft.com/DWT/DWTResources/dist/DynamicWebTWAINServiceSetup.deb) <br/> [Dynamic-Web-TWAIN-Service-Setup-arm64.deb](https://demo.dynamsoft.com/DWT/DWTResources/dist/DynamicWebTWAINServiceSetup-arm64.deb) <br/> [Dynamic-Web-TWAIN-Service-Setup-mips64el.deb](https://demo.dynamsoft.com/DWT/DWTResources/dist/DynamicWebTWAINServiceSetup-mips64el.deb) <br/> [Dynamic-Web-TWAIN-Service-Setup.rpm](https://demo.dynamsoft.com/DWT/DWTResources/dist/DynamicWebTWAINServiceSetup.rpm)|

You can find the download links for different versions of service installers on [unpkg](https://app.unpkg.com/dwt/files/dist/dist).

## Installation Folder

The service is installed in the following folders on different platforms by default.
Expand Down
10 changes: 8 additions & 2 deletions _articles/extended-usage/ocr.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,19 @@ Read on to learn about how to use it.
* A license with the OCR module ([30-day trial application](https://www.dynamsoft.com/customer/license/trialLicense?product=dwt))
* [DynamicWebTWAINOCRResources.zip](https://download2.dynamsoft.com/dwt/DynamicWebTWAINOCRResources.zip)

## Online Demo

You can visit the [online demo](https://demo.dynamsoft.com/Samples/dwt/OCR/index.html) to try it.

## How to Use

### Step One - Install the OCR Package

Download [DynamicWebTWAINOCRResources.zip](https://download2.dynamsoft.com/dwt/DynamicWebTWAINOCRResources.zip), unzip it and run `Install.cmd` inside the `DynamicWebTWAINOCRPack.zip` file as admin to install the OCR package. It will copy an `ocr` folder to the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder). (You need to install Dynamic Web TWAIN Service beforehand.)
Download [DynamicWebTWAINOCRResources.zip](https://download2.dynamsoft.com/dwt/DynamicWebTWAINOCRResources.zip), unzip it and run `Install.cmd` inside the `DynamicWebTWAINOCRPack.zip` file as admin to install the OCR package.

It will copy an `ocr` folder to Dynamic Web TWAIN Service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder). The `ocr` folder contains the runtime and model files that are required to perform on-device OCR.

The `ocr` folder contains the runtime and model files that are required to perform on-device OCR.
PS: You need to [install Dynamic Web TWAIN Service](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-of-dynamic-web-twain-service) beforehand.

### Step Two - Write a Basic Document Scanning Page

Expand Down
40 changes: 19 additions & 21 deletions _articles/faq/load-pdf-files.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,39 +7,43 @@ keywords: Dynamic Web TWAIN, Addon, load pdf/a
breadcrumbText: How can I load PDF/A files into the Dynamic Web TWAIN SDK?
description: How can I load PDF/A files into the Dynamic Web TWAIN SDK?
date: 2021-12-01 01:09:41 +0800
last_modified: 2025-12-10 15:53:54 +0800
last_modified: 2025-12-11 14:20:54 +0800
---

# Addon

## How can I load PDF/A files into the Dynamic Web TWAIN SDK?

Dynamic Web TWAIN can load PDF/A files, but whether the PDF Rasterizer add-on is required depends on the content of the PDF/A file:
Dynamic Web TWAIN can load PDF/A files. Whether you need the **[PDF Rasterizer Add-on (PDFR)](https://www.dynamsoft.com/web-twain/pdf-to-image-javascript/)** depends entirely on the contents of the PDF/A document:

- If the PDF/A contains text or vector graphics, it must be rasterized, and therefore requires the PDF Rasterizer add-on.
- If the PDF/A contains only raster images, it can be loaded without the PDF Rasterizer.
- If the PDF/A contains **text or vector graphics**, rasterization is required → **PDFR license needed**.
- If the PDF/A contains **only raster images**, the file can be loaded **without** the PDFR add-on.

You can programmatically check whether a file needs rasterization using [`IsRasterizationRequired()`](/_articles/info/api/Addon_PDF.html#israsterizationrequired):
> [!NOTE]
> **Looking for information about generating PDF/A files?**
>
> Starting from Dynamic Web TWAIN 19.3, PDF/A creation is supported.
>
> See: [How can I generate PDF/A files?](/_articles/faq/generate-pdf-files.md)

### How to check whether rasterization is required

You can programmatically detect whether a given PDF/A file requires rasterization before loading it:

```javascript
DWTObject.Addon.PDF.IsRasterizationRequired(path); // returns true or false
```

When enabled, the add-on automatically rasterizes PDF/A documents into images when they are loaded into the viewer.

> [!NOTE]
> **Looking for information about generating PDF/A files?**
> Starting from Dynamic Web TWAIN 19.3, PDF/A creation is supported.
> See: [How can I generate PDF/A files?](/_articles/faq/generate-pdf-files.md)
If this method returns **`true`**, the SDK will need the PDFR to process the file.

### When rasterization actually happens

### When is PDF Rasterizer used?
Dynamic Web TWAIN performs rasterization **only when necessary**. If [`IsRasterizationRequired()`](/_articles/info/api/Addon_PDF.md#israsterizationrequired) returns **`true`** and the PDF Rasterizer license is configured, the SDK automatically rasterizes the PDF into images using the reader settings you specify.

Once the PDF Rasterizer (`PDFR`) is configured, it automatically rasterizes the file *only when needed*.
If rasterization is required, the PDF is converted into one or more images at the specified resolution (default **200 DPI**).
The rasterization behavior—including resolution (default **200 DPI**) and other rendering parameters—can be customized through [`SetReaderOptions()`](/_articles/info/api/Addon_PDF.md#setreaderoptions).

Rasterization may occur when using any of the following APIs (including drag-and-drop):

Rasterization may occur when using any of these APIs (including drag-and-drop):
- [ `LoadImage()` ](/_articles/info/api/WebTwain_IO.md#loadimage)
- [ `LoadImageEx()` ](/_articles/info/api/WebTwain_IO.md#loadimageex)
- [ `LoadImageFromBase64Binary()` ](/_articles/info/api/WebTwain_IO.md#loadimagefrombase64binary)
Expand All @@ -50,9 +54,3 @@ Rasterization may occur when using any of the following APIs (including drag-and
- [ `HTTPDownloadEx()` ](/_articles/info/api/WebTwain_IO.md#httpdownloadex)
- [ `HTTPDownloadThroughPost()` ](/_articles/info/api/WebTwain_IO.md#httpdownloadthroughpost)
- [ `HTTPDownloadDirectly()` ](/_articles/info/api/WebTwain_IO.md#httpdownloaddirectly)

### Important Change in v19.3
Previous versions of Dynamic Web TWAIN did **not** support exporting PDF/A files.
As of **19.3**, you can now:
- Load PDF/A files (with or without the PDF Rasterizer, depending on content), and
- Generate PDF/A files.