setColorMode

汇总

该 JPEGFormat 对象表示联合图像专家组 (JPEG) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 、 MapView 、 MapSeries 和 BookmarkMapSeries 对象的 export 方法来创建输出 JPG 文件。

讨论

JPEG 文件属于经过压缩的图像文件。 它支持 24 位颜色并且是 Web 上流行的使用格式，因为 JPEG 文件的大小通常要比许多其他图像格式小很多。 但是，JPEG 压缩算法会有损质量，许多地图图像中都不推荐使用，因为线绘图以及文本或图标图形会因压缩产生的伪影而变得模糊。 因此，通常 PNG 格式才是地图图像的首选。 JPEG 将与一个坐标文件一同生成，可用作地理配准栅格数据。

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

语法

setColorMode()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 True ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。	Boolean
colorMode （读取和写入）	一个字符串常量，表示用于描述像素中颜色的位数。 默认值为 24-BIT_TRUE_COLOR 。 8-BIT_GRAYSCALE—256 种灰色色调。 所有颜色均转换为灰度。 24-BIT_TRUE_COLOR—16,777,216 种可能的颜色。 此选项有利于实现最大颜色保真度。	String
filePath （读取和写入）	一个字符串，表示已导出文件的系统路径和文件名（包含扩展名）。	String
geoReferenceMapFrame （读取和写入）	当 worldFile 属性设置为 True 时，用于控制坐标系的 MapFrame 。 默认值为 None 。	MapFrame
height （读取和写入）	要导出的地图区域的高度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
imageCompressionQuality （读取和写入）	应用于导出的图像压缩量。 低质量的文件较小，但数据的清晰度较低；而最高质量的文件较大，但数据的清晰度较高。 仅当使用某些压缩类型时，此选项才适用。 默认值为 80 。	Integer
resolution （读取和写入）	输出矢量数据的有效 dpi。 默认值为 96。 注: 当导出 MapView 时，将使用系统 dpi 缩放比例自动计算 dpi，因此将忽略该值。	Integer
showSelectionSymbology （读取和写入）	将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容，只会影响输出文件中的选择内容。 默认值为 False 。	Boolean
width （读取和写入）	要导出的地图区域的宽度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
worldFile （读取和写入）	如果设置为 True 并设置有效 georef_mapframe ，系统将基于地图框的坐标系生成坐标定位文件。 默认值为 False 。	Boolean

方法

setColorMode(color_mode)

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

名称	说明	数据类型
color_mode	Below is a list of valid strings. 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

代码示例

JPEGFormat 示例

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

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

jpg = arcpy.mp.CreateExportFormat('JPEG', r'C:\Temp\Output.jpg')

lyt.export(jpg)