Adobe Acrobat SDK
Version 8.1
|
Readme File Edition 1.1 |
June 2007 |
Copyright 2007 Adobe Systems Incorporated. All rights reserved.
This file contains important information that was not available when the product documentation was written. Review this information before using this version of the Adobe® Acrobat® SDK.
The What's New document (Acrobat_SDK_whats_new.pdf)
in the Documentation folder of the Acrobat SDK installation
contains details on the new and changed features in this release.
Windows Vista is now a supported
operating system for Acrobat SDK development. Note that the
Windows Media movie player requires a codec that does not ship with Windows
Vista. For more information, see http://support.microsoft.com/kb/894642.
Acrobat Distiller restriction on directory access
Beginning with Acrobat 8.1, Distiller® restricts the directories that PostScript® file operators can access. The new default behavior limits directory access to the temp and font cache directories. Earlier versions of Distiller allowed PostScript file operators to have unlimited directory access.
The following Distiller
settings enable unlimited directory access. Such unlimited access can pose
security problems.
Acrobat Distiller API Reference
In its description of
Distiller command line options for use on Windows, the Distiller API Reference
erroneously describes the -F as
restricting directory access. In fact, that option enables unlimited directory
access.
Acrobat and PDF Library API Reference: PDFL enumeration
The enumerations section for the PDFL object has an error in the value it associates with the TextServer enumerated name kPDPageDrawSmoothImage. This name has the value 0x00000010, as shown in the following declaration.
enum TextServer{ kPDPrefAASmoothText = 0x00000001, kPDPrefAASmoothLineArt = 0x00000002, kPDPrefAASmoothImage = 0x00000010 }
Acrobat and PDF Library API Reference: PDDocSetMinorVersion version
The "Since" entry for the PD Layer object PDDocSetMinorVersion should be changed to PI_PDMODEL_VERSION >= 0x00080000.
Acrobat and PDF Library API Reference: PDWordFinderAcquireWordList sort
The description of the function PDWordFinderAcquireWordList contains an over-simplification of the sorted results returned through the parameter xySortTable. That is, this description fails to mention how reading order affects sort order. When the functions PDDocCreateWordFinder or PDDocCreateWordFinderUCS are called with the WXE_XY_SORT flag set, these functions return an array of PDWords, sorted in x-y order.
The API determines sort
order by splitting the input PDF text content into multiple regions (which are
basically vertical bounded areas in the input PDF text content) based on the
text-blocks present and then determining the sort order within those regions.
The order in which the different regions will actually be processed in the reading
order depends on the kind of script being used because that determines whether
to read from right to left (for example Arabic) or from top to bottom or any
other order.
Acrobat and PDF Library API Reference: PDBookmarkGetIndent
The PDBookmarkGetIndent method should return the indentation level of aBookmark in its containing tree. The root and its direct children have an indentation level of 0.
Interapplication Communication API Reference
The descriptions for the OLE automation methods AcroExch.AVDoc.PrintPages and AcroExch.AVDoc.PrintPagesEx erroneously indicate these methods display a print dialog box. In fact, they display a print progress dialog box.
It is possible to create custom dialog boxes as shown in the ActiveViewVB sample. Such custom dialog boxes could be used in place of the print progress dialog box or any other dialog box.
JavaScript for Acrobat API Reference: SecurityHandler
The quick bars for the following methods indicate the methods are unavailable in Acrobat Reader. In fact, they are available in Acrobat Reader.
The description of the SecurityHandler.newUser method's parameter oRDN parameter erroneously indicates the
parameter is optional. In fact, it is required.
JavaScript for Acrobat API Reference: app and Doc URLs
The descriptions of the methods app.launchURL and Doc.getURL include notes that indicate these methods do not support File or JavaScript™ URLs. This is true only when operating in a non-privileged context. These notes should be removed and a new note (below) should be added to the respective URL arguments for each method.
Note: Beginning with Acrobat 8.1, File and
JavaScript URLs can be executed only when operating in a privileged context,
such as during a batch or console event. File and JavaScript URLs begin with
the scheme names javascript or file.
Windows
If you intend to use Visual Studio App Wizard to create a plug-in that uses privileged operations and you are running on Windows Vista™, you must establish yourself as an administrator. This is required even if your user ID has Admin privileges.
To establish yourself as an administrator, perform these tasks:
BatchCommand sample usage (Guide to SDK Samples)
The usage instructions for the BatchCommand sample provide an obsolete menu item location in the first testing step. The first step for testing the functionality of the sample should be rewritten as follows:
SnippetRunner on Mac OS X and Windows
The SnippetRunner Common Interface (based on Adobe Flash® technology) will not function as intended with the Safari browser in Mac OS X 10.4.8. It is recommended that you use the FireFox browser freely available from the Mozilla Foundation (http://www.mozilla.org) if you want to exercise this sample.
If you are using SnippetRunner on Windows Vista, the directory in which you place the Trust Policy file differs from the corresponding directory on Windows XP. Specifically, if you are using Windows Vista, use these instructions to place the Trust Policy file:
PDF Support for U3D
U3D supports only the latest IETF Unicode, specified at http://tools.ietf.org/html/rfc3629. Therefore, PDF support for U3D is also restricted to that version of Unicode.
Change to ASFileSysPathFromDIPathProc Function
If you implement a file system, you should change the signature of the pathFromDIPath callback to add the const keyword to the diPath parameter, as in the following code:
typedef ACCBPROTO1 ASPathName (ACCBPROTO2 *ASFileSysPathFromDIPathProc) (
const char * diPath, //Add const here
ASPathName relativeToThisPath
);
Deprecated Help APIs
The following APIs related to help
have been deprecated: AVAppHelpSearch, AVAppHelpShowContents, and AVAppHelpShowIndex. The corresponding parameters for
opening PDF files (help=index|contents|search) are also no longer available.
Acrobat 8.0 Plug-in Modeless Dialog Box Does Not Receive Focus
If you have created an Acrobat or
Reader plug-in that pops open a dialog box with which your users will interact,
the dialog box may not receive focus and may require a double click to get
focus. You can work around this issue by modifying the plug-in code with an
appropriate call to AVAppBeginModal before the dialog
box pops up. Then call AVAppEndModal immediately
thereafter.
Unable to Reader-enable a Plug-in Using the Acrobat 8.x SDK
If you are attempting to
Reader-enable a plug-in for use with Adobe Reader 8.x and the plug-in fails to
load without an error message, the #define directives are incorrect in the following two SDK header files:
PIHeaders.h and PIHeaders++.pch.
For replacement headers containing the correct #define directives for Reader-enabling, see the SDK zip folder
located within …/PluginSupport/Tools/Reader-enabling Tools/.
Using AVDoc.OpenInWindowEx Causes Search Functions
To Stop Working
If you are using OLE automation and
invoke the AVDoc.OpenInWindowEx method specifying AV_DOC_VIEW for the openFlags parameter, the search function may
stop working. If this occurs, specify AV_EXTERNAL_VIEW for the openFlags parameter and use code such as the
following to hide the toolbar:
myPDDoc = AcroExchAVDoc(fIndex).GetPDDoc();
jso = myPDDoc.GetJSObject();
jso.app.toolbar = false;
MakeKey Reader-enabling Tool
At this time, the MakeKey tool for Reader-enabling does not generate keys if
you are using Mac OS 10.x on MacIntel or Windows
Vista on 64-bit machines. Please check www.adobe.com/go/acrobat_developer
periodically for future updates to this tool.
The Acrobat SDK includes a complete
set of documentation in the Documentation folder of the Acrobat SDK
installation. The Documentation Roadmap
(Acrobat_SDK_doc_map.pdf) provides access to
this documentation set. To view the documentation, you must have Adobe Reader®
installed on your computer. You can download Adobe Reader from the Adobe web
site, at www.adobe.com.
Acrobat and PDF Library API Reference: kPDPageDrawSmoothImage
The Acrobat and PDF Library API Reference incorrectly lists the value
for kPDPageDrawSmoothImage as 0x00000004, but the correct value is actually 0x00000010.
JavaScript for Acrobat 3D Annotations API Reference: SceneObjectList.removeItem()
The JavaScript for Acrobat 3D Annotations API Reference does not
specify that the scene_object parameter for the SceneObjectList.removeItem() method is of type SceneObject.
Adobe,
Acrobat, Distiller, Flash, PostScript and Reader are either registered
trademarks or trademarks of Adobe Systems Incorporated in the
JavaScript is a trademark or registered trademark of Sun Microsystems, Inc. in
the
Mac OS is a trademark of Apple Inc., registered in the
Microsoft and Windows are either registered trademarks or trademarks of
Microsoft Corporation in the
UNIX is a registered trademark of The Open Group in the
All other trademarks are the property of their respective owners.
Readme File -- Adobe Acrobat SDK,
Version 8.1 --