PDF 转 TIFF (转换)

摘要

用于将 .pdf 导出为标记图像文件格式 (TIFF)。

使用情况

  • 如果输入 PDF 文件参数值包含地理配准信息,则输出 TIFF 文件参数值可以是 GeoTIFF。 GeoTIFF 可用作在 ArcGIS AllSource 中进行数字化和查看的源。

  • 该工具同时支持已地理配准 PDF 文档的 GeoPDF 和 ISO 标准。

  • 如果输入 PDF 文件参数值包含多个页面,则 PDF 页码参数将显示 .pdf 文件中的页面。

  • 如果输入 PDF 文件参数值没有空间参考,则 PDF 地图写入 GeoTIFF 标签参数将不可用。

  • 不支持 3D GeoPDF。

参数

标注说明数据类型
输入 PDF 文件

要导出为 TIFF 的输入 .pdf 文件。

File
输出 TIFF 文件

输出 .tif 文件。

Raster Dataset
PDF 密码
(可选)

此参数在 ArcGIS 3.3 中不可用。 未来的版本中将支持此参数。

Encrypted String
PDF 页码
(可选)

要导出为 TIFF 的 PDF 文档的页码。

Long
PDF 地图
(可选)

将要导出的地图。

.pdf 文件中,地图是在 PDF 页面上定义的具有空间参考图形的容器。 PDF 地图等同于 ArcGIS AllSource 地图,它是空间数据的容器。 PDF 文档可能包含一个或多个地图。 例如,一个页面可能包含一个主要地图和一个额外的较小的概览或注记地图。

如果指定了写入 GeoTIFF 标签参数值,它将用于设置输出 .tif 文件的空间参考。

如果指定了裁剪输出到地图参数值,它将用于定义输出 .tif 文件的范围。

如果页面包含多个地图,则 PDF 页面上的每个唯一地图将以名称列出。 您还可以通过 LARGEST 选项来使用 PDF 中的最大地图。 这是默认设置。

对于使用 OGC GeoPDF 标准的 .pdf 文件,仅支持 LARGEST 选项。

如果页面只包含一个地图,则此参数将为空。

String
裁剪输出到地图
(可选)

指定是仅导出地图还是导出整个页面。

  • 选中 - 仅将 PDF 地图参数中指定的地图导出到 TIFF。
  • 未选中 - 将整个页面导出到 TIFF。 这是默认设置。
Boolean
分辨率 (DPI)
(可选)

输出 .tif 文件的分辨率,以每英寸点数 (DPI) 表示。 默认值为 250。

Long
颜色模式
(可选)

指定用于描述颜色的位数。

  • RGB 真彩色将使用 32 位 RGBA 颜色。 如果压缩参数设置为 JPEG,则将使用 24 位 RGB 颜色。 这是默认设置。
注:

未来的版本中将支持其他选项。

String
压缩
(可选)

指定输出 .tif 文件的压缩方案。

  • LZW将使用 Lempel-Ziv-Welch 无损数据压缩。 这是默认设置。
  • 压缩将使用无损数据压缩。
  • Jpeg将使用 JPEG 有损压缩。 压缩质量将自动设置为 100,无法更改。
  • 不应用压缩。
  • PackBits将使用 PackBits 无损压缩。
String
写入 GeoTIFF 标签
(可选)

指定是否向输出添加 GeoTIFF 标签。 仅当输入 PDF 文件参数值具有空间参考时,才支持此参数。

  • 选中 - 将向输出添加 GeoTIFF 标签。 这是默认设置。
  • 未选中 - 不会向输出添加 GeoTIFF 标签。
Boolean

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})
名称说明数据类型
in_pdf_file

要导出为 TIFF 的输入 .pdf 文件。

File
out_tiff_file

输出 .tif 文件。

Raster Dataset
pdf_password
(可选)

此参数在 ArcGIS 3.3 中不可用。 未来的版本中将支持此参数。

Encrypted String
pdf_page_number
(可选)

要导出为 TIFF 的 PDF 文档的页码。

Long
pdf_map
(可选)

将要导出的地图。

.pdf 文件中,地图是在 PDF 页面上定义的具有空间参考图形的容器。 PDF 地图等同于 ArcGIS AllSource 地图,它是空间数据的容器。 PDF 文档可能包含一个或多个地图。 例如,一个页面可能包含一个主要地图和一个额外的较小的概览或注记地图。

如果指定了 geotiff_tags 参数值,它将用于设置输出 .tif 文件的空间参考。

如果指定了 clip_option 参数值,它将用于定义输出 .tif 文件的范围。

可以指定地图的名称。 您还可以通过 LARGEST 选项来使用 PDF 中的最大地图。 这是默认设置。

对于使用 OGC GeoPDF 标准的 .pdf 文件,仅支持 LARGEST 选项。

注:

输入地图的名称时,需使用用下划线替换所有空格。 例如,My Map 变为 My_Map。

String
clip_option
(可选)

指定是仅导出地图还是导出整个页面。

  • CLIP_TO_MAP仅将 pdf_map 参数中指定的地图导出到 TIFF。
  • NO_CLIP将整个页面导出到 TIFF。 这是默认设置。
Boolean
resolution
(可选)

输出 .tif 文件的分辨率,以每英寸点数 (DPI) 表示。 默认值为 250。

Long
color_mode
(可选)

指定用于描述颜色的位数。

注:

未来的版本中将支持其他选项。

  • RGB_TRUE_COLOR将使用 32 位 RGBA 颜色。 如果 tiff_compression 参数设置为 JPEG,则将使用 24 位 RGB 颜色。 这是默认设置。
String
tiff_compression
(可选)

指定输出 .tif 文件的压缩方案。

  • LZW将使用 Lempel-Ziv-Welch 无损数据压缩。 这是默认设置。
  • DEFLATE将使用无损数据压缩。
  • JPEG将使用 JPEG 有损压缩。 压缩质量将自动设置为 100,无法更改。
  • NONE不应用压缩。
  • PACK_BITS将使用 PackBits 无损压缩。
String
geotiff_tags
(可选)

指定是否向输出添加 GeoTIFF 标签。 仅当 in_pdf_file 参数值具有空间参考时,才支持此参数。

  • GEOTIFF_TAGS将向输出添加 GeoTIFF 标签。 这是默认设置。
  • NO_GEOTIFF_TAGS不会向输出添加 GeoTIFF 标签。
Boolean

代码示例

PDFToTIFF 示例 1(Python 窗口)

此示例使用 ISO PDF 运行所需的参数。

import arcpy
inPDF = r'C:\Project\export.pdf'
outTIFF = r'C:\Project\export.tif'
arcpy.conversion.PDFToTIFF(inPDF, outTIFF)
PDFToTIFF 示例 2(独立脚本)

此示例循环遍历多页 OGC PDF 文档的每个页面,导出每个页面并设置一些可选参数,并在每个 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)

相关主题