You can view PDF files with Viewing SDK in one of three ways:
View the PDF by using the Adobe Acrobat ActiveX control.
View the PDF by using the Microsoft WebBrowser ActiveX control.
View an image of each page of the PDF by using a graphic-based PDF reader (kppdfrdr
or kppdf2rdr
).
By default, Viewing SDK uses the Acrobat ActiveX control to view PDF documents. If you do not want to redistribute the Acrobat Reader with your application, you can use a graphic-based reader instead.
The Acrobat control is automatically installed with Adobe® Reader® 4.0 or later. To download the Adobe Reader, go to www.adobe.com.
You can use the Microsoft WebBrowser ActiveX control to view PDF documents. The Microsoft WebBrowser ActiveX control is installed automatically with Microsoft Internet Explorer 3.0 or later. To use the WebBrowser ActiveX control to view PDF documents, follow one of these procedures:
In the kvsdk.ini
file
Open the kvsdk.ini
file with a text editor. The file is installed in the root of the Windows directory.
In the [General]
section of the kvsdk.ini
file, set the UseHTMLPluginForPDF
parameter to True
.
Pass the highlight or search term in by using VAPIMWP_INIT_OPENDOCEX
(the extended version of VAPIMWP_INIT_OPEN_DOCUMENT
. Refer to ihademo.cpp
for details) with the OpenDocInfo.lpszHighlight
structure. For example:
OpenDocInfo.lpszHighLight="search_term";
where search_term
is the highlight or search term.
In the registry file
Open install.reg.txt
in a text editor. The file is installed in the
install
\redist
directory, where install
is the directory in which you installed Viewing SDK.
Under the [HKEY_LOCAL_MACHINE\Software\Autonomy\Viewing SDK\General]
key, set the following parameter:
"UseHTMLPluginForPDF"="true"
Save the file as install.reg
.
Import the file into your Windows system registry.
There are two graphic-based PDF readers available. The readers display PDFs by converting each page of the PDF to an image. If you do not want to redistribute the Acrobat Reader with your application, you can use a graphic-based reader instead.
The two readers support different features. Choose the appropriate reader depending on your requirements:
The kppdfrdr
reader supports highlighting, annotation, and several other features, but also has several graphical limitations.
The kppdf2rdr
reader produces high-fidelity raster images but is a viewer only, and does not support highlighting or other features.
The kppdfrdr
graphic-based reader has the following features:
supports vector images
supports rotation and scaling
supports multibyte and bidirectional text
The kppdfrdr
reader has the following limitations:
Embedded fonts in a PDF file are not translated correctly. They are usually displayed using the question mark (?) replacement character.
If an unsupported font is encountered during conversion, the default font, Times New Roman, is substituted.
Supports 180-degree rotation only for raster images.
Supports the following color spaces: DeviceRGB, DeviceGray, DeviceCMYK, CalGray, and CalRGB color spaces. Indexed color spaces are supported as long as they are used with a supported basic color space.
Does not support hyperlinks.
The kppdf2rdr
graphic-based reader produces high-fidelity raster images. However, it has the following limitations:
Does not support anything beyond viewing, such as highlighting or annotation.
Does not support PDFs containing XFA forms content.
By default, the Acrobat control is used to view PDF documents. To use one of the graphic-based readers to view PDF documents, follow one of these procedures:
In the kvsdk.ini
file
Open the kvsdk.ini
file with a text editor. The file is installed in the root of the Windows directory.
In the [VAPI]
section of the kvsdk.ini
file, change the 200=doc 0 kvaxcc.dll
parameter to 200=pic 0 kvpicve.dll
.
In the [KVPICVE]
section, set the following parameter to the graphic-based reader you want to use. Set one of the following values:
For the kppdfrdr
reader:
200=kppdfrdr.dll
This is the default setting.
For the kppdf2rdr
reader:
200=kppdf2rdr.dll
In the registry file
Open install.reg.txt
in a text editor. The file is installed in the
install
\redist
directory, where install
is the directory in which you installed Viewing SDK.
Under the [HKEY_LOCAL_MACHINE\Software\Autonomy\Viewing SDK\VAPI]
key, change the "200"="doc 0 kvaxcc.dll"
parameter to "200"="pic 0 kvpicve.dll"
.
Under the [HKEY_LOCAL_MACHINE\Software\Autonomy\Viewing SDK\KPICVE]
key, set the following parameter to the graphic-based reader you want to use. Set one of the following values:
For the kppdfrdr
reader:
"200"="kppdfrdr.dll"
This is the default setting.
For the kppdf2rdr
reader:
"200"="kppdf2rdr.dll"
Save the file as install.reg
.
Import the file into your Windows system registry.
|