BMPFormat

摘要

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

说明

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

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

属性

属性说明数据类型
clipToElements
(可读写)

如果设置为 True,则仅包含具有地图或布局元素内容的页面区域,而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False

Boolean
colorMode
(可读写)

一个字符串常量,表示用于描述像素中颜色的位数。 默认值为 24-BIT_TRUE_COLOR

  • 1-BIT_MONOCHROME_THRESHOLD2 种可能的颜色:黑色和白色。 由 threshold 值确定白色和黑色区域。
  • 8-BIT_ADAPTIVE_PALETTE请使用图像调色板中最常用的 256 种像素颜色,从而最大程度地减少输出过程中颜色可能发生变化的像素数量。
  • 8-BIT_GRAYSCALE256 种灰色色调。 所有颜色均转换为灰度。
  • 24-BIT_TRUE_COLOR16,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 (color_mode)

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

方法

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_PALETTEUses 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)