setImageQuality

汇总

该 EMFFormat 对象表示增强型图元文件格式 (EMF) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 和 MapView 对象 export 的方法来创建输出 EMF 文件。

讨论

EMF 非常适合于嵌入 Windows 文档，因为 EMF 的矢量部分可以调整大小，而又不会降低质量。 但是，由于 EMF 不支持字体嵌入并且属于 Windows 专用格式，因此并不常用作用户之间的交换格式。

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

语法

setImageQuality()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 True ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。	Boolean
convertMarkers （读取和写入）	对基于字体字符的标记符号是作为字体字符还是作为面导出进行控制。 当您由于许可或文件格式的限制而无法嵌入字体时，请将此选项设置为 True 以在尚未安装相应字体的计算机上查看输出。 这不适用于文本，仅适用于基于字体的标记符号。 默认值为 False 。	Boolean
filePath （读取和写入）	一个字符串，表示已导出文件的系统路径和文件名（包含扩展名）。	String
height （读取和写入）	要导出的地图区域的高度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
imageQuality （读取和写入）	图像重采样量。 该属性可用于确定输出时栅格内容的有效分辨率。 例如，如果 imageQuality 设置为 BETTER ，重采样比率为 1:2 ，并且输出 resolution 设置为 300 dpi，则栅格内容将以大约 150 dpi 的分辨率输出。 许多情况下，您能够以低于矢量数据的 dpi 来包含栅格数据，而不会明显影响质量，从而减小输出文件的大小。 默认值为 BEST 。 BEST—输出图像质量的重采样比为 1 BETTER—输出图像质量的重采样比为 2 NORMAL—输出图像质量的重采样比为 3 FASTER—输出图像质量的重采样比为 4 FASTEST—输出图像质量的重采样比为 5	String
outputAsImage （读取和写入）	将矢量内容导出为图像。 如果地图或布局包含具有高密度折点的矢量图层，则此选项可极大减小输出文件的大小。 默认值为 False 。	Boolean
resolution （读取和写入）	输出矢量数据的有效 dpi。 默认值为 96。 注: 当导出 MapView 时，将使用系统 dpi 缩放比例自动计算 dpi，因此将忽略该值。	Integer
showSelectionSymbology （读取和写入）	将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容，只会影响输出文件中的选择内容。 默认值为 False 。	Boolean
width （读取和写入）	要导出的地图区域的宽度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double

方法

setImageQuality(image_quality)

一个字符串常量，用于设置图像重采样量。

名称	说明	数据类型
image_quality	Below is a list of valid strings. BEST—An output image quality resample ratio of 1 BETTER—An output image quality resample ratio of 2 NORMAL—An output image quality resample ratio of 3 FASTER—An output image quality resample ratio of 4 FASTEST—An output image quality resample ratio of 5	String

代码示例

EMFFormat 示例

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

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

emf = arcpy.mp.CreateExportFormat('EMF', r'C:\Temp\output.emf')

lyt.export(emf)