Skip to content

Commit d6cc15f

Browse files
lyzhang0113Copilot
andauthored
Reworded load-pdf-files.md (#959)
* Update load-pdf-files.md to clarify PDF/A loading requirements and rasterization details * Update _articles/faq/load-pdf-files.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent 5b6f889 commit d6cc15f

File tree

1 file changed

+19
-21
lines changed

1 file changed

+19
-21
lines changed

_articles/faq/load-pdf-files.md

Lines changed: 19 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -7,39 +7,43 @@ keywords: Dynamic Web TWAIN, Addon, load pdf/a
77
breadcrumbText: How can I load PDF/A files into the Dynamic Web TWAIN SDK?
88
description: How can I load PDF/A files into the Dynamic Web TWAIN SDK?
99
date: 2021-12-01 01:09:41 +0800
10-
last_modified: 2025-12-10 15:53:54 +0800
10+
last_modified: 2025-12-11 14:20:54 +0800
1111
---
1212

1313
# Addon
1414

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

17-
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:
17+
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:
1818

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

22-
You can programmatically check whether a file needs rasterization using [`IsRasterizationRequired()`](/_articles/info/api/Addon_PDF.html#israsterizationrequired):
22+
> [!NOTE]
23+
> **Looking for information about generating PDF/A files?**
24+
>
25+
> Starting from Dynamic Web TWAIN 19.3, PDF/A creation is supported.
26+
>
27+
> See: [How can I generate PDF/A files?](/_articles/faq/generate-pdf-files.md)
28+
29+
### How to check whether rasterization is required
30+
31+
You can programmatically detect whether a given PDF/A file requires rasterization before loading it:
2332

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

28-
When enabled, the add-on automatically rasterizes PDF/A documents into images when they are loaded into the viewer.
29-
30-
> [!NOTE]
31-
> **Looking for information about generating PDF/A files?**
32-
> Starting from Dynamic Web TWAIN 19.3, PDF/A creation is supported.
33-
> See: [How can I generate PDF/A files?](/_articles/faq/generate-pdf-files.md)
37+
If this method returns **`true`**, the SDK will need the PDFR to process the file.
3438

39+
### When rasterization actually happens
3540

36-
### When is PDF Rasterizer used?
41+
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.
3742

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

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

46+
Rasterization may occur when using any of these APIs (including drag-and-drop):
4347
- [ `LoadImage()` ](/_articles/info/api/WebTwain_IO.md#loadimage)
4448
- [ `LoadImageEx()` ](/_articles/info/api/WebTwain_IO.md#loadimageex)
4549
- [ `LoadImageFromBase64Binary()` ](/_articles/info/api/WebTwain_IO.md#loadimagefrombase64binary)
@@ -50,9 +54,3 @@ Rasterization may occur when using any of the following APIs (including drag-and
5054
- [ `HTTPDownloadEx()` ](/_articles/info/api/WebTwain_IO.md#httpdownloadex)
5155
- [ `HTTPDownloadThroughPost()` ](/_articles/info/api/WebTwain_IO.md#httpdownloadthroughpost)
5256
- [ `HTTPDownloadDirectly()` ](/_articles/info/api/WebTwain_IO.md#httpdownloaddirectly)
53-
54-
### Important Change in v19.3
55-
Previous versions of Dynamic Web TWAIN did **not** support exporting PDF/A files.
56-
As of **19.3**, you can now:
57-
- Load PDF/A files (with or without the PDF Rasterizer, depending on content), and
58-
- Generate PDF/A files.

0 commit comments

Comments
 (0)