Adobe acrobat 7.0.5 sdk User Manual
Creating PDF Documents
Creating PDF Documents from an Authoring Application
4
42
Inserting PostScript Code into a Job
Acrobat Distiller contains a PostScript 3 interpreter with two Distiller-specific operators,
setdistillerparams and currentdistillerparams. An Adobe PDF settings file can be
thought of as a Postscript file that contains setdistillerparams key-value pairs, followed by
the PostScript setpagedevice operator with two key-value pairs. The Adobe PDF settings
file is the first file processed by Distiller, but parameters can subsequently be set or
changed within the PostScript job itself.
setdistillerparams and currentdistillerparams. An Adobe PDF settings file can be
thought of as a Postscript file that contains setdistillerparams key-value pairs, followed by
the PostScript setpagedevice operator with two key-value pairs. The Adobe PDF settings
file is the first file processed by Distiller, but parameters can subsequently be set or
changed within the PostScript job itself.
See Distiller Parameters for more information.
Attaching the Native Document to the PDF File
Another way that an authoring application can integrate with Acrobat or Adobe Reader is
to allow the user access to the original authoring document through the Acrobat user
interface. Through the use of private data in a PDF file, an authoring application can embed
the entire authoring document as part of the PDF file that represents it. This way, not only
can the resulting electronic document be viewed by anyone using Acrobat, it can also be
edited by users who have the authoring application. You must write a plug-in for Acrobat n
to allow users to embed and extract the authoring document. This plug-in would simply
add the authoring document as a private data stream when embedding, and, when
extracting, save the stream to a temporary file and invoke the authoring application.
to allow the user access to the original authoring document through the Acrobat user
interface. Through the use of private data in a PDF file, an authoring application can embed
the entire authoring document as part of the PDF file that represents it. This way, not only
can the resulting electronic document be viewed by anyone using Acrobat, it can also be
edited by users who have the authoring application. You must write a plug-in for Acrobat n
to allow users to embed and extract the authoring document. This plug-in would simply
add the authoring document as a private data stream when embedding, and, when
extracting, save the stream to a temporary file and invoke the authoring application.
N
O T E
:
Acrobat and Adobe Reader ignore private data. Embedding authoring documents in
PDF files greatly increases the size of the PDF file.
PDF files greatly increases the size of the PDF file.
Using Links to Associate a Native Document with the PDF File
An association between the PDF file and the authoring document can also be maintained
through the use of links in the PDF file. Links can be created that invoke files and their
associated applications. If a document management system places such a link in the PDF
file, users can invoke the original authoring document by executing the link.
through the use of links in the PDF file. Links can be created that invoke files and their
associated applications. If a document management system places such a link in the PDF
file, users can invoke the original authoring document by executing the link.
Batch Processing with Distiller
Due to the built-in functionality of Distiller, you do not need to use the Distiller API to
integrate it with your product. Distiller has the ability to watch directories over a network
and to convert any PostScript files saved to those directories to PDF. It is also possible to set
different job options for each directory so that one directory can be used, for example, for
high-end color output, while the other can generate a more compressed file suitable for
Web use. These features of Distiller are not supported by Acrobat Developer Support.
Check the help documentation packaged with the product or books by Adobe Press and
other publishers for using Distiller through the user interface.
integrate it with your product. Distiller has the ability to watch directories over a network
and to convert any PostScript files saved to those directories to PDF. It is also possible to set
different job options for each directory so that one directory can be used, for example, for
high-end color output, while the other can generate a more compressed file suitable for
Web use. These features of Distiller are not supported by Acrobat Developer Support.
Check the help documentation packaged with the product or books by Adobe Press and
other publishers for using Distiller through the user interface.
The Distiller API can be used to programmatically process files and set the output path and
file names. The API is documented in the Acrobat Distiller API Reference. Also, the Acrobat
Professional product can be used to set up watched folders.
file names. The API is documented in the Acrobat Distiller API Reference. Also, the Acrobat
Professional product can be used to set up watched folders.