摘要
该 JPEGFormat 对象表示联合图像专家组 (JPEG) 文件属性的集合，可以对这些属性进行配置，并使用 Layout、MapFrame 和 MapView 对象的 export 方法来创建输出 JPG 文件。
说明
JPEG 文件属于经过压缩的图像文件。 它支持 24 位颜色并且是 Web 上流行的使用格式，因为 JPEG 文件的大小通常要比许多其他图像格式小很多。 但是，JPEG 压缩算法会有损质量，许多地图图像中都不推荐使用，因为线绘图以及文本或图标图形会因压缩产生的伪影而变得模糊。 因此，通常 PNG 格式才是地图图像的首选。 JPEG 将与一个坐标文件一同生成，可用作地理配准栅格数据。
如果 format 参数设置为 JPEG，则可以使用 createExportFormat 方法创建 JPEGFormat 对象。 返回的 JPEGFormat 对象包含与生成 JPEG 文件相关的所有属性。 可以相应地修改这些属性以产生不同的输出结果。
属性
| 属性 | 说明 | 数据类型 |
| clipToElements (可读写) | 如果设置为 True，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False。 | Boolean |
| colorMode (可读写) | 一个字符串常量，表示用于描述像素中颜色的位数。 默认值为 24-BIT_TRUE_COLOR。
| 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) | 一个字符串常量，表示用于描述像素中颜色的位数。 |
方法
setColorMode (color_mode)
| 参数 | 说明 | 数据类型 |
color_mode | Below is a list of valid strings.
| String |
代码示例
以下脚本使用默认属性值将布局导出为 JPEG 格式。
p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts()[0]
jpg = arcpy.mp.CreateExportFormat('JPEG', r'C:\Temp\Output.jpg')
lyt.export(jpg)