setColorMode

汇总

该 PNGFormat 对象表示可移植网络图形 (PNG) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 、 MapView 、 MapSeries 和 BookmarkMapSeries 对象的 export 方法来创建输出 PNG 文件。

讨论

PNG 属于通用型栅格格式，可在各种 Web 浏览器上显示并且还可插入其他文档。它支持高位深度颜色并使用无损压缩。对于地图而言，PNG 通常是最佳的栅格格式，因为无损压缩可防止产生 JPEG 格式中的那种压缩伪影，从而使文本和线作业始终清晰可辨。 PNG 文件还可用于定义透明颜色；在 Web 浏览器中图像的一部分可显示为透明，这样背景、图像或颜色便可以透过图像显示。 PNG 将与一个坐标文件一同生成，可用作地理配准栅格数据。

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

语法

setColorMode()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 `True` ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。此属性仅在导出 `Layout` 对象时适用。默认值为 `False` 。	Boolean
colorMode （读取和写入）	一个字符串常量，表示用于描述像素中颜色的位数。默认值为 `32-BIT_WITH_ALPHA` 。 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（透明度）通道。该选项对于具有透明度的地图或布局很有用。	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
transparentBackground （读取和写入）	如果设置为 `True` ，则将导出透明页面，而非白色页面。此属性仅在导出 `Layout` 对象时适用。默认值为 `False` 。注: 仅当 `colorMode` 设置为 `32-BIT_WITH_ALPHA` 时，系统才支持透明背景。此选项不适用于地图，但导出时会支持地图上的透明度。	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_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

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_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

代码示例

PNGFormat 示例

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

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

png = arcpy.mp.CreateExportFormat('PNG', r'C:\Temp\Output.png')

lyt.export(png)

setColorMode

汇总

讨论

语法

属性

注:

注:

方法

setColorMode(color_mode)

代码示例

`setColorMode(color_mode)`