Skip to main content

setColorMode

汇总

该 BMPFormat 对象表示 Microsoft Windows 位图 (BMP) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 和 MapView 对象的 export 方法来创建输出 BMP 文件。

讨论

BMP 文件属于本地 Windows 栅格图像。 BMP 文件可以使用多个位深度存储像素数据，并且可以使用无损 RLE 方法进行压缩。 BMP 图像的大小通常比 JPEG 或 PNG 等格式的图像大很多。

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

语法

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 种可能的颜色。 此选项有利于实现最大颜色保真度。

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(bmp_color_mode)

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

名称 说明 数据类型

bmp_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.

String

代码示例

BMPFormat 示例

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

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

bmp = arcpy.mp.CreateExportFormat('BMP', r'C:\Temp\output.bmp')

lyt.export(bmp)