setImageQuality

汇总

该 SVGFormat 对象表示可缩放矢量图形 (SVG) 文件属性的集合，可以对其进行配置，并使用 Layout 、 MapFrame 和 MapView 对象上的 export 方法来创建输出 SVG 或 SVGZ 文件。

讨论

SVG 是一种基于 XML 的文件格式，专门适用于在 Web 上进行查看。 SVG 可以同时包含矢量信息和栅格信息。 某些 Web 浏览器可能需要安装插件才能查看 SVG 文件；较早的浏览器可能根本无法查看 SVG 文件。 SVG 支持字体嵌入。 也可以通过将 compressToSVGZ 属性设置为 True 来选择生成压缩的 SVG 文件。 文件扩展名会变为 *.svgz。

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

语法

setImageQuality()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 True ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。	Boolean
compressToSVGZ （读取和写入）	如果设置为 True ，则将压缩文件，并且扩展名应设置为 *.svgz 。 默认值为 False 。	Boolean
convertMarkers （读取和写入）	对基于字体字符的标记符号是作为字体字符还是作为面导出进行控制。 当您由于许可或文件格式的限制而无法嵌入字体时，请将此选项设置为 True 以在尚未安装相应字体的计算机上查看输出。 这不适用于文本，仅适用于基于字体的标记符号。 默认值为 False 。	Boolean
embedFonts （读取和写入）	在导出的文件中包含可嵌入的字体，以在不同平台上保持字体的一致性。 将不会包含不支持嵌入的字体，无论此设置为何。 默认值为 True 。 注: 为了正确地将文本编辑为图形，Illustrator 要求安装字体并可以使用字体。 嵌入和共享字体前请检查共享权限。 对于高范围字符或连字，应使用字体嵌入以确保正确寻址这些高范围字符。 如果无法嵌入具有高范围字符或连字的字体，请检查文本符号上的“以几何形式绘制字形”属性。	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
includeNonVisibleMapLayers （读取和写入）	如果设置为 True ，则此属性将确保地图中的所有图层均包含在导出文件中，包括未选中可见性的图层。 所有图层的可见性状态均将保留在导出文件中。 使用此选项可以创建具有相同数据的多个视图的交付项。 当此属性设置为 False 时，导出文件中将仅包括地图中的可见图层。 不可见图层将被丢弃。 默认值为 False 。	Boolean
outputAsImage （读取和写入）	将矢量内容导出为图像。 如果地图或布局包含具有高密度折点的矢量图层，则此选项可极大减小输出文件的大小。 默认值为 False 。 注: 当 outputAsImage 设置为 True 时，特定于矢量数据的选项（例如 embedFonts ）将不可用。	Boolean
rasterAsSingleTile （读取和写入）	如果设置为 True ，则将栅格和栅格化图层导出为单个切片图像，以避免透明图层在某些 PDF 查看器中出现伪影。 默认值为 False 。 注: 如果无法分配足够的内存，则导出过程将失败。 要减少内存需求，请将 rasterAsSingleTile 设置为 False ，或者尝试减小 imageQuality 、 resolution ，或者将 antialiasing 值设置为 None 。 如果在应用程序外部运行脚本，则需要在 DisplayOptions 类上设置 antialiasing 值；如果在应用程序内部运行脚本，则需要在 工程选项 中的 “显示”选项卡 上设置该值。	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

代码示例

SVGFormat 示例 1

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

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

svg = arcpy.mp.CreateExportFormat('SVG', r'C:\Temp\Output.svg')

lyt.export(svg)

SVGFormat 示例 2

以下脚本通过将 compressToSVGZ 属性设置为 True 将布局导出为压缩 SVG 格式。

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

svg = arcpy.mp.CreateExportFormat('SVG', r'C:\Temp\Output.svgz')
svg.compressToSVGZ = True  #Change from default value of False

lyt.export(svg)