setColorMode

汇总

该 TGAFormat 对象代表 Truevision 图形适配器 (TGA) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 和 MapView 对象的 export 方法来创建输出 TGA 文件。

讨论

TGA 文件以往用于其他应用程序中的内容（例如，动画游戏的 Image Sprites），许多受欢迎的图形艺术应用程序均可对该文件进行读取和写入。 它支持多位深度，包括支持 alpha（透明）的 32 位。

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

语法

setColorMode()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 True ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。	Boolean
colorMode （读取和写入）	一个字符串常量，表示用于描述像素中颜色的位数。 默认值为 32-BIT_WITH_ALPHA 。 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（透明度）通道。 该选项对于具有透明度的地图或布局很有用。	String
filePath （读取和写入）	一个字符串，表示已导出文件的系统路径和文件名（包含扩展名）。	String
height （读取和写入）	要导出的地图区域的高度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
resolution （读取和写入）	输出矢量数据的有效 dpi。 默认值为 96。 注: 当导出 MapView 时，将使用系统 dpi 缩放比例自动计算 dpi，因此将忽略该值。	Integer
showSelectionSymbology （读取和写入）	将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容，只会影响输出文件中的选择内容。 默认值为 False 。	Boolean
transparentBackground （读取和写入）	如果设置为 True ，则将导出透明页面，而非白色页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。 注: 仅当 colorMode 设置为 32-BIT_WITH_ALPHA 时，系统才支持透明背景。 此选项不适用于地图，但导出时会支持地图上的透明度。	Boolean
width （读取和写入）	要导出的地图区域的宽度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double

方法

setColorMode(color_mode)

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

名称	说明	数据类型
color_mode	Below is a list of valid strings. 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—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. 24-BIT_TRUE_COLOR— 16,777,216 possible colors. This option is good for maximum color fidelity. 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.	String

代码示例

TGAFormat 示例

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

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

tga = arcpy.mp.CreateExportFormat('TGA', r'C:\Temp\Output.tga')

lyt.export(tga)