摘要
该 GIFFormat 对象表示图形交换格式 (GIF) 文件属性的集合,可以对这些属性进行配置,并使用 Layout、MapFrame 和 MapView 对象的 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。
| 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.
| String |
代码示例
以下脚本使用默认属性值将布局导出为 GIF 格式。
p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts()[0]
gif = arcpy.mp.CreateExportFormat('GIF', r'C:\Temp\Output.gif')
lyt.export(gif)