Embedded PDF Pages
You can import a page/pages from a PDF into an PTC ALD document, and have the pages included in PDF output. You can choose any quantity of pages from a single PDF. PDF pages are imported individually. If you want to import multiple pages, import one for each frame in the required sequence. If you want to import a particular page from the PDF, specify the page number during the import process. See the following instructions for importing PDF:
• Import PDF Page Using the Raster Graphic (Load) Dialog Box
• Import PDF page with the tfr Macro
• Import PDF Page with an Inline Import Command
Select pages that should be imported into frames in the host document either through the Raster Graphic (LOAD) dialog box, with the tfr macro, or using the inline import method. The selected PDF pages are treated as raster graphics and can be imported or linked to an PTC ALD document in the same way as other raster graphics.
|
|
The PDF pages are imported as raster graphics, but they retain their configuration as a PDF file. You can perform actions such as edit and search on the embedded page, as for a standalone PDF file.
|
Any trim box settings for the PDF page are observed when the page is imported.
You can perform these actions on imported PDF pages. Use the standard methods for manipulating raster graphics:
• Scaling the embedded PDF page
• Rotating the frame
• Cropping the embedded PDF page
• Selecting a section of the embedded PDF page only for view
When you have imported PDF pages into an PTC ALD document, they will be included in PDF output from that document. A PDF page embedded in the PDF document created from PTC ALD can be edited and searched. Output PDFs correctly represent any crop, rotation, or scaling settings made for the embedded PDF in the source.
Preview of the file in the PTC ALD WYSIWYG view will show the embedded PDF as a gray box. Support for preview of the imported PDF graphic will be implemented in a later release.
PTC ALD will generate an error message if the requested PDF page could not be loaded.
There are some points to bear in mind when importing PDF pages:
• The version compatibility of the embedded PDF must be equivalent to that of the host document. PTC ALD will flag an error message if you attempt to import a PDF page of a lower version specification than the host document.
• Imported PDF pages can only be used in documents printed to PDF.
Import PDF Page Using the Raster Graphic (Load) Dialog Box
From the Raster Graphic (LOAD) dialog box, select the PDF you want to import in the File name field as usual. Set the Format field to one of the following options:
• AUTO: PTC ALD will detect the target file as a PDF from its file extension, and process it accordingly. This method is useful if you’re importing a single page PDF.
If you use this method and the target PDF has multiple pages, PTC ALD will import the first page only.
• PDF: a Page Number field will appear. Add the number of the page of the target PDF you want to import. This method is useful if you’re importing a single page from a multi-page PDF.
Continue with the load raster graphic action as usual.
Import PDF page with the tfr Macro
Use the syntax for importing a raster graphic to import a PDF page, for example:
tfr 0,"pdf",-1,"Path\PDFFile.pdf"
Add a number parameter to request a specific page from the target PDF file. For example, to import page 2 of the target PDF:
tfr 0,"pdf",-1,"Path\PDFFile.pdf#2"
Import PDF Page with an Inline Import Command
Use the syntax for importing a raster graphic to import a PDF page, for example:
<$$>\raster(f,p)=":1::{.}filename.pdf<$$>
Add a number parameter to request a specific page from the target PDF file. For example, to import page 2 of the target PDF:
<$$>\raster(f,p)=":1::{.}filename.pdf#2<$$>
FOM Objects Supporting Embedding of PDF Pages
• page property for fRaster — confirms the number of the page from which the raster was imported (if type is fRaster.FT_PDF)
• FT_PDF constant in RasterFileType group for fRaster — specifies that the file to be imported is a PDF page.
• page parameter for importRaster() method for fStream — defines the number of the page to import from a PDF file.
