setColorMode

汇总

该 TIFFFormat 对象表示标记图像文件格式 (TIFF) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 、 MapView 、 MapSeries 和 BookmarkMapSeries 对象的 export 方法来创建输出 TIF 文件。

讨论

TIFF 文件最适合导入图像编辑应用程序，同时它也属于一种常用的 GIS 栅格数据格式。 但是却无法通过 Web 浏览器在本地查看这些文件。 TIFF 也支持在 GeoTIFF 标记中或在独立的坐标文件中存储地理配准信息，以便用作栅格数据。

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

语法

setColorMode()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 True ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。	Boolean
colorMode （读取和写入）	一个字符串常量，表示用于描述像素中颜色的位数。 默认值为 24-BIT_TRUE_COLOR 。 1-BIT_MONOCHROME_THRESHOLD—2 种可能的颜色：黑色和白色。 由 threshold 值确定白色和黑色区域。 8-BIT_ADAPTIVE_PALETTE—请使用图像调色板中最常用的 256 种像素颜色，从而最大程度地减少输出过程中颜色可能发生变化的像素数量。 8-BIT_GRAYSCALE—256 种灰色色调。 所有颜色均转换为灰度。 24-BIT_TRUE_COLOR—16,777,216 种可能的颜色。 此选项有利于实现最大颜色保真度。 32-BIT_WITH_ALPHA—16,777,216 种可能的颜色和具有 255 个值的 alpha（透明度）通道。 该选项对于具有透明度的地图或布局很有用。 32-BIT_CMYK_TRUE_COLOR—每个通道 8 位像素：青色、品红色、黄色、黑色。 40-BIT_CMYK_WITH_ALPHA—每个通道 8 位像素：青色、品红色、黄色、黑色，加上一个附加 8 位 alpha 通道。 如果地图或布局有透明度，请使用此选项。 注: 可用 colorMode 值取决于在 颜色管理 属性中设置的指定颜色模型。 32-BIT_CMYK_TRUE_COLOR 和 40-BIT_CMYK_WITH_ALPHA 选项仅在布局或地图具有 CMYK 颜色模型时可用。 同样， 24-BIT_TRUE_COLOR 和 32-BIT_WITH_ALPHA 选项仅在布局或地图具有 RGB 颜色模型时可用。	String
embedColorProfile （读取和写入）	将为地图或布局设置的 颜色配置文件 包含在导出的文件中。 在不同的设备上查看文件时，此举有助于建立颜色的一致性。 如果未嵌入配置文件，或者使用了非颜色管理的查看器，则颜色可能与屏幕上显示的颜色明显不同。 默认值为 True 。 注: 此选项仅在启用 颜色管理 时可用。 如果未启用颜色管理，并且颜色空间设置为 CMYK，则 CMYK 颜色空间仍包含在导出中。 查看导出的文件时，这可能会导致某些颜色出现不同的颜色。	Boolean
filePath （读取和写入）	一个字符串，表示已导出文件的系统路径和文件名（包含扩展名）。	String
geoReferenceMapFrame （读取和写入）	当 worldFile 属性设置为 True 时，用于控制坐标系的 MapFrame 。 默认值为 None 。	MapFrame
geoTIFFTags （读取和写入）	如果设置为 True 并设置有效 georef_mapframe ，geoTIFF 标签将基于地图框的坐标系嵌入在生成的图像中。 这样可以将导出的影像用作 ArcGIS Pro 或其他 GIS 应用程序中的栅格数据。 默认值为 False 。 注: 当导出布局时，GeoTIFF 信息需要基于与 geoReferenceMapFrame 属性相关联的 2D 地图。 geoTIFFTags 属性独立于 worldFile 属性。 利用支持 GIS 的软件，可以遵循这些导出内容的 GeoTIFF 信息或坐标文件。	Boolean
height （读取和写入）	要导出的地图区域的高度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
imageCompression （读取和写入）	一个字符串常量，用于表示在输出文件中压缩图像或栅格数据时使用的压缩方案。 默认值为 LZW 。 DEFLATE—适用于大多数情况的无损压缩方法。 JPEG—一种有损压缩方法，适用于照相类型的图像。 LZW—一种使用代码表的无损压缩方法。 NONE—不应用压缩。 PACK_BITS—如果存在大面积相同颜色的情况，则无损压缩方法效果很好。	String
imageCompressionQuality （读取和写入）	应用于导出的图像压缩量。 低质量的文件较小，但数据的清晰度较低；而最高质量的文件较大，但数据的清晰度较高。 仅当使用某些压缩类型时，此选项才适用。 默认值为 100 。	Integer
resolution （读取和写入）	输出矢量数据的有效 dpi。 默认值为 96。 注: 当导出 MapView 时，将使用系统 dpi 缩放比例自动计算 dpi，因此将忽略该值。	Integer
showSelectionSymbology （读取和写入）	将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容，只会影响输出文件中的选择内容。 默认值为 False 。	Boolean
threshold （读取和写入）	将图像强度设置为高于此值将在输出文件中显示为白色，设置为所有其他值将显示为黑色。 仅当 colorMode 属性设置为 1-BIT_MONOCHROME_THRESHOLD 时，才会应用此属性。 默认值为 128 。	Boolean
transparentBackground （读取和写入）	如果设置为 True ，则白色页面背景将设置为透明。 默认值为 False 。	Boolean
width （读取和写入）	要导出的地图区域的宽度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
worldFile （读取和写入）	如果设置为 True 并设置有效 georef_mapframe ，系统将基于地图框的坐标系生成坐标定位文件。 默认值为 False 。	Boolean

方法

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_PALETTE—Uses 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. 24-BIT_TRUE_COLOR— 16,777,216 possible colors. This option is good for maximum color fidelity. 32-BIT_CMYK_TRUE_COLOR— 8 bits per pixel for each channel: cyan, magenta, yellow, black. 32-BIT_WITH_ALPHA— 16,777,216 possible colors and an alpha (transparency) channel of 255 values. This option is useful for maps or layouts with transparency. 40-BIT_CMYK_WITH_ALPHA— 8 bits per pixel for each channel: cyan, magenta, yellow, black, plus an additional 8-bit channel for alpha. Use this option if maps or layouts have transparency. 注: The available colorMode values are dependent on the specified color model set in color management properties.	String

setImageCompression(image_compression)

一个字符串常量，用于表示在输出文件中压缩图像或栅格数据时使用的压缩方案。

名称	说明	数据类型
image_compression	Below is a list of valid strings. DEFLATE— Lossless compression method that works well for most cases. JPEG— Lossy compression method that works well for photographic-type images. LZW— Lossless compression method using a code table. NONE—Compression is not applied. PACK_BITS— Lossless compression method that works well if there are large areas of the same color.	String

代码示例

TIFFFormat 示例

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

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

tif = arcpy.mp.CreateExportFormat('TIFF', r'C:\Temp\Output.tif')

lyt.export(tif)