Label | Explanation | Data Type |
Input PDF File
| The input .pdf file to be exported to TIFF. | File |
Output TIFF File
| The output .tif file. | Raster Dataset |
PDF Password (Optional) | This parameter is unavailable at ArcGIS 3.0. It will be supported in a future release. | Encrypted String |
PDF Page Number (Optional) | The page number of the PDF document to export to TIFF. | Long |
PDF Map (Optional) | The map that will be exported. In a .pdf file, a map is a defined container of graphics on the PDF page that has a spatial reference. A PDF map is equivalent to an ArcGIS Pro map in that it is the container for spatial data. A PDF document may have one or more maps. For example, a page may have a main map and an additional smaller overview or key map. If the Write GeoTIFF Tags parameter value is specified, it will be used to set the output spatial reference of the .tif file. If the Clip Output to Map parameter value is specified, it will be used to define the extent of the output .tif file. If the page contains more than one map, each unique map on the PDF page will be listed by name. You can also use the LARGEST option to use the largest map in the PDF. This is the default. For .pdf files that use the OGC GeoPDF standard, the only supported option is LARGEST. If the page contains only one map, this parameter will be blank. | String |
Clip Output to Map (Optional) | Specifies whether the entire page or only the map will be exported.
| Boolean |
Resolution in dpi (Optional) | The resolution of the output .tif file in dots per inch (DPI). The default is 250. | Long |
Color Mode (Optional) | Specifies the number of bits that will be used to describe color.
Note:Additional options will be supported in a future release. | String |
Compression (Optional) | Specifies the compression scheme for the output .tif file.
| String |
Write GeoTIFF Tags (Optional) | Specifies whether GeoTIFF tags will be added to the output. This parameter is only supported if the Input PDF File parameter value has a spatial reference.
| Boolean |
Summary
Exports a .pdf file to Tagged Image File Format (TIFF).
Usage
If the Input PDF File parameter value includes georeference information, the Output TIFF File parameter value can be a GeoTIFF. A GeoTIFF can be used as a source for digitizing and viewing in ArcGIS Pro.
The tool supports both GeoPDF and ISO standards of georeferenced PDF documents.
If the Input PDF File parameter value consists of more than one page, the PDF Page Number parameter will display the pages in the .pdf file.
If the Input PDF File parameter value does not have a spatial reference, the PDF Map and Write GeoTIFF Tags parameters will be unavailable.
A 3D GeoPDF will output a .tif file, but it will not be georeferenced.
Parameters
arcpy.conversion.PDFToTIFF(in_pdf_file, out_tiff_file, {pdf_password}, {pdf_page_number}, {pdf_map}, {clip_option}, {resolution}, {color_mode}, {tiff_compression}, {geotiff_tags})
Name | Explanation | Data Type |
in_pdf_file | The input .pdf file to be exported to TIFF. | File |
out_tiff_file | The output .tif file. | Raster Dataset |
pdf_password (Optional) | This parameter is unavailable at ArcGIS 3.0. It will be supported in a future release. | Encrypted String |
pdf_page_number (Optional) | The page number of the PDF document to export to TIFF. | Long |
pdf_map (Optional) | The map that will be exported. In a .pdf file, a map is a defined container of graphics on the PDF page that has a spatial reference. A PDF map is equivalent to an ArcGIS Pro map in that it is the container for spatial data. A PDF document may have one or more maps. For example, a page may have a main map and an additional smaller overview or key map. If the geotiff_tags parameter value is specified, it will be used to set the output spatial reference of the .tif file. If the clip_option parameter value is specified, it will be used to define the extent of the output .tif file. You can specify the map by name. You can also use the LARGEST option to use the largest map in the PDF. This is the default. For .pdf files that use the OGC GeoPDF standard, the only supported option is LARGEST. Note:When entering the map's name, replace any space with an underscore. For example, My Map becomes My_Map. | String |
clip_option (Optional) |
Specifies whether the entire page or only the map will be exported.
| Boolean |
resolution (Optional) | The resolution of the output .tif file in dots per inch (DPI). The default is 250. | Long |
color_mode (Optional) | Specifies the number of bits that will be used to describe color. Note:Additional options will be supported in a future release.
| String |
tiff_compression (Optional) | Specifies the compression scheme for the output .tif file.
| String |
geotiff_tags (Optional) | Specifies whether GeoTIFF tags will be added to the output. This parameter is only supported if the in_pdf_file parameter value has a spatial reference.
| Boolean |
Code sample
This sample runs the required parameters using ISO PDF.
import arcpy
inPDF = r'C:\Project\export.pdf'
outTIFF = r'C:\Project\export.tif'
arcpy.conversion.PDFToTIFF(inPDF, outTIFF)
This sample loops through each page of a multipage OGC PDF document, exports each page with some optional parameters set, and builds pyramids and calculates statistics on each TIFF.
import arcpy
import os
# Define variables
inPDF = r'C:\Project\OGC_DDP.pdf'
outTIFF = r'C:\Project\TIFFs'
# Create PDFDocument Object from inPDF
pdf = arcpy.mp.PDFDocumentOpen(inPDF)
# Loop through each page in the PDF and create a name based on the page number
for page in range(1, pdf.pageCount+1):
name = str(page) + ".tif"
outTIFFpath = os.path.join(outTIFF, name)
# Export each page to TIFF using 96 DPI, RGB color mode, and JPEG compression
arcpy.conversion.PDFToTIFF(inPDF, outTIFFpath, '#', str(page), '#', '#', 96,
'RGB_TRUE_COLOR', 'JPEG')
# Build pyramids and calculate statistics on each output TIFF
arcpy.management.BuildPyramidsandStatistics(outTIFF)
print("Exported " + outTIFFpath)
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes