setImageCompression

汇总

该 AIXFormat 对象表示 Adobe Illustrator Exchange (AIX) 文件属性的集合，可以对这些属性进行配置，并使用 Layout 、 MapFrame 和 MapView 对象上的 export 方法来创建输出 AIX 文件。

讨论

AIX 文件可以与 ArcGIS Maps for Adobe Creative Cloud 扩展模块配合使用。 凭借此扩展模块，矢量地图和栅格地图内容将转换为可编辑的 Artwork 图层，以改善 Adobe Illustrator 中的编辑体验。 在 Illustrator 中打开 AIX 后，文件即可用于高端图形设计或地图最后处理工作流，并可在其他 Adobe Creative Cloud 应用程序之间进行迁移。

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

注:

有关 AIXFormat 的详细信息，请参阅 导出为 AIX 帮助主题。

语法

setImageCompression()

属性

名称	说明	数据类型
clipToElements （读取和写入）	如果设置为 True ，则仅包含具有地图或布局元素内容的页面区域，而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False 。	Boolean
convertMarkers （读取和写入）	对基于字体字符的标记符号是作为字体字符还是作为面导出进行控制。 当您由于许可或文件格式的限制而无法嵌入字体时，请将此选项设置为 True 以在尚未安装相应字体的计算机上查看输出。 这不适用于文本，仅适用于基于字体的标记符号。 默认值为 False 。	Boolean
embedColorProfile （读取和写入）	将为地图或布局设置的 颜色配置文件 包含在导出的文件中。 在不同的设备上查看文件时，此举有助于建立颜色的一致性。 如果未嵌入配置文件，或者使用了非颜色管理的查看器，则颜色可能与屏幕上显示的颜色明显不同。 默认值为 True 。 注: 此选项仅在启用 颜色管理 时可用。 如果未启用颜色管理，并且颜色空间设置为 CMYK，则 CMYK 颜色空间仍包含在导出中。 查看导出的文件时，这可能会导致某些颜色出现不同的颜色。	Boolean
embedFonts （读取和写入）	在导出的文件中包含可嵌入的字体，以在不同平台上保持字体的一致性。 将不会包含不支持嵌入的字体，无论此设置为何。 默认值为 True 。 注: 为了正确地将文本编辑为图形，Illustrator 要求安装字体并可以使用字体。 嵌入和共享字体前请检查共享权限。 对于高范围字符或连字，应使用字体嵌入以确保正确寻址这些高范围字符。 如果无法嵌入具有高范围字符或连字的字体，请检查文本符号上的“以几何形式绘制字形”属性。	Boolean
filePath （读取和写入）	一个字符串，表示已导出文件的系统路径和文件名（包含扩展名）。	String
height （读取和写入）	要导出的地图区域的高度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double
imageCompression （读取和写入）	一个字符串常量，用于表示在输出文件中压缩图像或栅格数据时使用的压缩方案。 默认值为 ADAPTIVE 。 ADAPTIVE—组合 JPEG 和 Deflate 压缩，具体取决于流的内容。 这在大多数情况下都有效。 DEFLATE—适用于大多数情况的无损压缩方法。 JPEG—一种有损压缩方法，适用于照相类型的图像。 JPEG2000—一种较高质量的压缩，其中文件大小小于 JPEG。 如果将 jpeg_compression_quality 设置为 100，则为无损压缩。 LZW—一种使用代码表的无损压缩方法。 NONE—不应用压缩。 RLE—游程编码压缩，一种无损压缩方法，如果存在大量相同颜色的区域，则效果很好。	String
imageCompressionQuality （读取和写入）	应用于导出的图像压缩量。 低质量的文件较小，但数据的清晰度较低；而最高质量的文件较大，但数据的清晰度较高。 仅当使用某些压缩类型时，此选项才适用。 默认值为 80 。	Integer
imageQuality （读取和写入）	图像重采样量。 该属性可用于确定输出时栅格内容的有效分辨率。 例如，如果 imageQuality 设置为 BETTER ，重采样比率为 1:2 ，并且输出 resolution 设置为 300 dpi，则栅格内容将以大约 150 dpi 的分辨率输出。 许多情况下，您能够以低于矢量数据的 dpi 来包含栅格数据，而不会明显影响质量，从而减小输出文件的大小。 默认值为 BEST 。 BEST—输出图像质量的重采样比为 1 BETTER—输出图像质量的重采样比为 2 NORMAL—输出图像质量的重采样比为 3 FASTER—输出图像质量的重采样比为 4 FASTEST—输出图像质量的重采样比为 5	String
removeLayoutBackground （读取和写入）	导出时，将页面背景作为图形移除。 此属性仅在导出 Layout 对象时适用。 默认值为 True 。	Boolean
resolution （读取和写入）	输出矢量数据的有效 dpi。 默认值为 96。 注: 当导出 MapView 时，将使用系统 dpi 缩放比例自动计算 dpi，因此将忽略该值。	Integer
showSelectionSymbology （读取和写入）	将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容，只会影响输出文件中的选择内容。 默认值为 False 。	Boolean
width （读取和写入）	要导出的地图区域的宽度（以像素为单位）。 此属性仅在导出 MapView 对象时适用。 默认值为 960 。	Double

方法

setImageCompression(image_compression)

一个字符串常量，用于表示在输出文件中压缩图像或栅格数据时使用的压缩方案。

名称	说明	数据类型
image_compression	Below is a list of valid strings. ADAPTIVE— JPEG and Deflate compression are combined, depending on the contents of the stream. This works well for most cases. DEFLATE— Lossless compression method that works well for most cases. JPEG— Lossy compression method that works well for photographic-type images. JPEG2000— Higher-quality compression with file sizes smaller than JPEG . This compression is lossless if imageQuality is set to 100. LZW—Lempel-Ziv-Welch, a lossless compression method using a code table. NONE—Compression is not applied. RLE— Run-length encoded compression, a lossless compression method that works well if there are large areas of the same color.	String

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

代码示例

AIXFormat 示例

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

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

aix = arcpy.mp.CreateExportFormat('AIX', r'C:\Temp\Output.aix')

lyt.export(aix)