摘要
该 BMPFormat 对象表示 Microsoft Windows 位图 (BMP) 文件属性的集合,可以对这些属性进行配置,并使用 Layout、MapFrame 和 MapView 对象的 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。
| 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.
| String |
代码示例
以下脚本使用默认属性值将布局导出为 BMP 格式。
p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts()[0]
bmp = arcpy.mp.CreateExportFormat('BMP', r'C:\Temp\output.bmp')
lyt.export(bmp)