ArcMap

ExportToGIF

摘要

以图形交换 (GIF) 格式导出地图文档 (.mxd) 的页面布局或数据框。

讨论

GIF 文件属于 Web 中使用的标准栅格格式。GIF 无法显示 256 种以上的颜色（每像素 8 位），并且使用的是可选的无损 RLE 压缩或 LZW 压缩方法，因此此类文件的大小比其他格式的文件要小。对于包含有限数量颜色的地图，GIF 文件是一个不错的选择，但是由于颜色限制，可能无法正确显示连续的栅格数据。GIF 文件还具有定义透明颜色的功能；在 Web 浏览器中图像的一部分可显示为透明，这样背景、图像或颜色便可以透过图像显示。从 ArcMap 的数据视图中导出的 GIF 在生成时，还将同时生成一个坐标文件，可用作地理配准栅格数据。

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

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

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

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

语法

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

引用 MapDocument 对象的变量。

MapDocument
out_gif

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

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 位单色阈值。

(默认值为 8-BIT_PALETTE)

String
gif_compression

此值表示压缩方案。

  • LZW —Lempel-Ziv-Welch 为无损数据压缩。
  • NONE —不应用压缩。
  • RLE —游程编码压缩。

(默认值为 NONE)

String
background_color

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

(默认值为 255, 255, 255)

String
transparent_color

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

String
interlaced

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

(默认值为 False)

Boolean

代码示例

ExportToGIF 示例 1

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

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
arcpy.mapping.ExportToGIF(mxd, r"C:\Project\Output\Project.gif")
del mxd
ExportToGIF 示例 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.ExportToGIF(mxd, r"C:\Project\Output\ProjectDataFrame.gif", df,
                          df_export_width=1600,
                          df_export_height=1200,
                          world_file=True)
del mxd