GIFFormat

摘要

GIFFormat 对象表示图形交换格式 (GIF) 文件属性的集合,可以对这些属性进行配置,并使用 LayoutMapFrameMapView 对象的 export 方法来创建输出 GIF 文件。

说明

GIF 文件属于 Web 中使用的旧的栅格格式。 GIF 无法显示 256 种以上的颜色(每像素 8 位),并且使用的是可选的无损 RLE 压缩或 LZW 压缩方法,因此此类文件的大小比其他格式的文件要小。 GIF 文件还可定义透明颜色。 GIF 在生成时,还将同时生成一个坐标文件,可用作地理配准栅格数据。

如果 format 参数设置为 GIF,则可以使用 createExportFormat 方法创建 GIFFormat 对象。 返回的 GIFFormat 对象包含与生成 GIF 文件相关的所有属性。 可以相应地修改这些属性以产生不同的输出结果。

属性

属性说明数据类型
clipToElements
(可读写)

如果设置为 True,则仅包含具有地图或布局元素内容的页面区域,而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False

Boolean
colorMode
(可读写)

一个字符串常量,表示用于描述像素中颜色的位数。 默认值为 8-BIT_ADAPTIVE_PALETTE

  • 1-BIT_MONOCHROME_THRESHOLD2 种可能的颜色:黑色和白色。 由 threshold 值确定白色和黑色区域。
  • 8-BIT_ADAPTIVE_PALETTE请使用图像调色板中最常用的 256 种像素颜色,从而最大程度地减少输出过程中颜色可能发生变化的像素数量。
  • 8-BIT_GRAYSCALE256 种灰色色调。 所有颜色均转换为灰度。
String
filePath
(可读写)

一个字符串,表示已导出文件的系统路径和文件名(包含扩展名)。

String
geoReferenceMapFrame
(可读写)

worldFile 属性设置为 True 时,用于控制坐标系的 MapFrame。 默认值为 None

MapFrame
height
(可读写)

要导出的地图区域的高度(以像素为单位)。 此属性仅在导出 MapView 对象时适用。 默认值为 960

Double
resolution
(可读写)

输出矢量数据的有效 dpi。 默认值为 96。

注:

当导出 MapView 时,将使用系统 dpi 缩放比例自动计算 dpi,因此将忽略该值。

Integer
showSelectionSymbology
(可读写)

将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容,只会影响输出文件中的选择内容。 默认值为 False

Boolean
threshold
(可读写)

将图像强度设置为高于此值将在输出文件中显示为白色,设置为所有其他值将显示为黑色。 仅当 colorMode 属性设置为 1-BIT_MONOCHROME_THRESHOLD 时,才会应用此属性。 默认值为 128

Boolean
width
(可读写)

要导出的地图区域的宽度(以像素为单位)。 此属性仅在导出 MapView 对象时适用。 默认值为 960

Double
worldFile
(可读写)

如果设置为 True 并设置有效 georef_mapframe,系统将基于地图框的坐标系生成坐标定位文件。 默认值为 False

Boolean

方法概述

方法说明
setColorMode (color_mode)

一个字符串常量,表示用于描述像素中颜色的位数。

方法

setColorMode (color_mode)
参数说明数据类型
color_mode

Below is a list of valid strings.

  • 1-BIT_MONOCHROME_THRESHOLD 2 possible colors, black and white. The areas which are white and black are determined by the threshold value.
  • 8-BIT_ADAPTIVE_PALETTEUses 256 of the most commonly-used pixel colors in the image’s palette, thereby minimizing the number of pixels whose color may change during output.
  • 8-BIT_GRAYSCALE 256 shades of gray. All colors are converted to grayscale.
String

代码示例

GIFFormat 示例

以下脚本使用默认属性值将布局导出为 GIF 格式。

p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts()[0]

gif = arcpy.mp.CreateExportFormat('GIF', r'C:\Temp\Output.gif')

lyt.export(gif)