ArcMap

ExportToPNG

描述

以可移植网络图形 (PNG) 格式导出地图文档 (.mxd) 的页面布局或数据框。

讨论

PNG 是一种栅格格式，在 Web 上用作 GIF 的替代。它支持 24 位颜色并使用无损压缩方法进行压缩。PNG 文件还具有定义透明颜色的功能；在 Web 浏览器中图像的一部分可显示为透明，这样背景、图像或颜色便可以透过图像显示。在大多数图像上，PNG 可以实现比 GIF 更高的压缩比（因此文件大小更小）。从 ArcMap 的数据视图中导出的 PNG 在生成时，还将同时生成一个坐标文件，可用作地理配准栅格数据。这种格式在 Web 设计界得到了广泛应用。

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

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

不会为页面布局生成坐标文件；必须提供引用的数据框，否则导出将失败。

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

语法

ExportToPNG (map_document, out_png, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {world_file}, {color_mode}, {background_color}, {transparent_color}, {interlaced})
参数说明数据类型
map_document

引用 MapDocument 对象的变量。

MapDocument
out_png

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

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)。

(默认值为 96)

Integer
world_file

如果设置为 True，则将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。

(默认值为 False)

Boolean
color_mode

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

  • 24-BIT_TRUE_COLOR —24 位真彩色
  • 8-BIT_PALETTE —8 位调色板
  • 8-BIT_GRAYSCALE —8 位灰度
  • 1-BIT_MONOCHROME_MASK —1 位单色掩膜
  • 1-BIT_MONOCHROME_THRESHOLD —1 位单色阈值

(默认值为 24-BIT_TRUE_COLOR)

String
background_color

定义颜色将用作图像的背景，或者在单色掩膜输出的情况下用作掩膜。

(默认值为 255, 255, 255)

String
transparent_color

要在图像中显示为透明的定义颜色。

String
interlaced

如果设置为 True，则将创建隔行扫描图像。隔行扫描图像将显示为一系列扫描线，而不是一次显示整个图像。

(默认值为 False)

Boolean

代码示例

ExportToPNG 示例 1

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

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

与从 ArcMap 应用程序的数据视图中导出类似，此脚本将导出单个数据框（而不是整个页面布局）。df_export_width 和 df_export_height 的默认值为 640 和 480。通过传递这些参数的较大值，可以生成具有更高细节的输出图像。设置 world_file = True 将在与输出文件相同的目录中生成地理配准坐标文件。

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