ArcMap

ExportToPDF

摘要

以便携文档格式 (PDF) 导出地图文档 (.mxd) 的页面布局或数据框。

讨论

PDF 文件可在不同的平台上实现一致的查看和打印效果。它们通常用于在 Web 上分发文档，并且此格式现在为内容传送的标准交换格式。ArcMap PDF 在许多图形应用程序中均可编辑，并且它还保留了 ArcMap 内容列表中地图图层的注记、标注和属性数据。从 ArcMap 中导出的 PDF 支持嵌入字体，因此即使用户尚未安装 Esri 字体也可以正确地显示符号。从 ArcMap 中导出的 PDF 可以通过 CMYK 值或 RGB 值定义颜色。

要导出单个数据框（而不是整个页面布局），可将 DataFrame 对象传给函数的 data_frame 参数。由于数据框导出不具有可提供高度和宽度信息的关联页面，所以必须通过 df_export_width 和 df_export_height 参数来提供此信息。

对于页面布局导出和数据框导出，控制生成图像图形质量的方式有所不同。导出页面布局时，通过更改 resolution 参数来控制图像细节。导出数据框时，保持 resolution 参数的默认值，更改 df_export_width 和 df_export_height 参数来更改图像细节。高度和宽度参数直接控制在导出文件中生成的像素数，且仅在导出数据框时使用。像素数较高的图像具有较高的图像细节。对于大多数页面布局导出，默认参数值应在第一次尝试时生成良好的结果和美观的导出图像。对于数据框导出，您可能需要对 df_export_width 和 df_export_height 值进行若干次试验，之后才能得到理想的结果。

有关导出地图的详细信息，请参阅 ArcGIS 帮助中的导出地图主题。

语法

ExportToPDF (map_document, out_pdf, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {image_quality}, {colorspace}, {compress_vectors}, {image_compression}, {picture_symbol}, {convert_markers}, {embed_fonts}, {layers_attributes}, {georef_info}, {jpeg_compression_quality})
参数说明数据类型
map_document

引用 MapDocument 对象的变量。

MapDocument
out_pdf

用于表示输出导出文件的路径和文件名的字符串。

String
data_frame

引用 DataFrame 对象的变量。使用字符串/常量“PAGE_LAYOUT”可以导出地图文档的页面布局，而非单个数据框。

(默认值为 PAGE_LAYOUT)

Object
df_export_width

用于定义数据框导出的导出图像宽度（以像素为单位）的数字。仅当导出数据框时，才能使用 df_export_width。导出页面布局将使用地图文档页面宽度，而非 df_export_width。

(默认值为 640)

Integer
df_export_height

用于定义数据框导出的导出图像高度（以像素为单位）的数字。仅当导出数据框时，才能使用 df_export_height。导出页面布局将使用地图文档页面高度，而非 df_export_height。

(默认值为 480)

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (DPI)。

(默认值为 300)

Integer
image_quality

用于定义输出图像质量、作为栅格绘制的地图图层的绘制分辨率的字符串。

  • BEST —输出图像质量的重采样比为 1。
  • BETTER —输出图像质量的重采样比为 2。
  • NORMAL —输出图像质量的重采样比为 3。
  • FASTER —输出图像质量的重采样比为 4。
  • FASTEST —输出图像质量的重采样比为 5。

(默认值为 BEST)

String
colorspace

用于定义导出文件颜色空间的字符串。有效值为 CYMK 和 RGB。

  • CMYK —青色、洋红色、黄色和黑色颜色模型。
  • RGB —红色、绿色和蓝色颜色模型。

(默认值为 RGB)

String
compress_vectors

用于控制输出文件的矢量和文本部分压缩的布尔值。图像压缩单独定义。

(默认值为 True)

Boolean
image_compression

用于定义在输出文件中压缩图像或栅格数据时使用的压缩方案的字符串。

  • ADAPTIVE —自动为页面中的每个图像选择最佳压缩类型。JPEG 适用于包含许多唯一颜色的较大图像。DEFLATE 适用于所有其它图像。
  • JPEG —有损数据压缩。
  • DEFLATE —无损数据压缩。
  • LZW —Lempel-Ziv-Welch 为无损数据压缩。
  • NONE —不应用压缩。
  • RLE —游程编码压缩。

(默认值为 ADAPTIVE)

String
picture_symbol

用于定义是否将图片标记和图片填充转换为输出上的矢量或栅格化对象的字符串。

  • RASTERIZE_BITMAP — 使用位图标记/填充对图层进行栅格化。
  • RASTERIZE_PICTURE —使用任何图片标记/填充对图层进行栅格化。
  • VECTORIZE_BITMAP —使用位图标记/填充对图层进行矢量化。

(默认值为 RASTERIZE_BITMAP)

String
convert_markers

用于控制将基于字符的标记符号转换为面的布尔值。如果符号字体不可用或无法嵌入，则可用于正确显示符号。但是，将此参数设置为 True 将禁用所有基于字符的标记符号的字体嵌入，由此会导致其外观发生变化。

(默认值为 False)

Boolean
embed_fonts

用于控制导出文件中的字体嵌入的布尔值。当在未安装所需字体的计算机上查看文档时，可通过字体嵌入正确显示文本和字符标记。

(默认值为 True)

Boolean
layers_attributes

用于控制导出文件中包含的 PDF 图层和 PDF 对象数据（属性）的字符串。

  • LAYERS_ONLY —仅导出 PDF 图层。
  • LAYERS_AND_ATTRIBUTES —导出 PDF 图层和要素属性。
  • NONE —无。

(默认值为 LAYERS_ONLY)

String
georef_info

用于将每个数据框的坐标系信息导出到输出 PDF 文件中的布尔值。

(默认值为 True)

Boolean
jpeg_compression_quality

当 image_compression 设置为 ADAPTIVE 或 JPEG 时，用于控制压缩质量值的数字。有效范围为 1 到 100。jpeg_compression_quality 为 100 时可提供最佳图像质量，但会创建较大的导出文件。推荐范围为 70 到 90。

(默认值为 80)

Integer

代码示例

ExportToPDF 示例 1

此脚本使用所有选项的默认值打开地图文档并将页面布局导出为 PDF 文件。

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
arcpy.mapping.ExportToPDF(mxd, r"C:\Project\Output\Project.pdf")
del mxd
ExportToPDF 示例 2

与从 ArcMap 应用程序的数据视图中导出类似，此脚本将导出单个数据框（而不是整个页面布局）。df_export_width 和 df_export_height 的默认值为 640 和 480。通过传递这些参数的较大值，可以生成具有更高细节的输出图像。

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "Transportation")[0]
arcpy.mapping.ExportToPDF(mxd, r"C:\Project\Output\ProjectDataFrame.pdf", df,
                          df_export_width=1600,
                          df_export_height=1200)
del mxd