EPSFormat

摘要

EPSFormat 对象表示 Encapsulated PostScript (EPS) 文件属性的集合,可以对这些属性进行配置,并使用 LayoutMapFrameMapView 对象的 export 方法来创建输出 EPS 文件。

说明

EPS 格式文件使用 PostScript 页面描述语言描述矢量对象和栅格对象。 PostScript 是高端图形文件、制图和打印的出版行业标准。 许多绘图应用程序中都可编辑 EPS 文件,也可将此类文件作为图形置于大多数页面布局应用程序中。 EPS 格式支持字体嵌入,并且可以使用 CMYK 或 RGB 值定义颜色。

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

属性

属性说明数据类型
clipToElements
(可读写)

如果设置为 True,则仅包含具有地图或布局元素内容的页面区域,而非导出整个页面。 此属性仅在导出 Layout 对象时适用。 默认值为 False

Boolean
convertMarkers
(可读写)

对基于字体字符的标记符号是作为字体字符还是作为面导出进行控制。 当您由于许可或文件格式的限制而无法嵌入字体时,请将此选项设置为 True 以在尚未安装相应字体的计算机上查看输出。 这不适用于文本,仅适用于基于字体的标记符号。 默认值为 False

Boolean
embedFonts
(可读写)

在导出的文件中包含可嵌入的字体,以在不同平台上保持字体的一致性。 将不会包含不支持嵌入的字体,无论此设置为何。 默认值为 True

注:

为了正确地将文本编辑为图形,Illustrator 要求安装字体并可以使用字体。 嵌入和共享字体前请检查共享权限。

Boolean
filePath
(可读写)

一个字符串,表示已导出文件的系统路径和文件名(包含扩展名)。

String
height
(可读写)

要导出的地图区域的高度(以像素为单位)。 此属性仅在导出 MapView 对象时适用。 默认值为 960

Double
imageCompression
(可读写)

在输出文件中压缩图像或栅格数据时使用的压缩方案。 默认值为 DEFLATE

  • DEFLATE适用于大多数情况的无损压缩方法。
  • LZW一种使用代码表的无损压缩方法。
  • NONE不应用压缩。
  • RLE游程编码压缩,一种无损压缩方法,如果存在大量相同颜色的区域,则效果很好。
String
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

注:

outputAsImage 设置为 True 时,特定于矢量数据的选项(例如 embedFonts)将不可用。

Boolean
resolution
(可读写)

输出矢量数据的有效 dpi。 默认值为 96。

注:

当导出 MapView 时,将使用系统 dpi 缩放比例自动计算 dpi,因此将忽略该值。

Integer
showSelectionSymbology
(可读写)

将地图或地图框中的已选要素在输出文件中显示为选中状态。 将此值设置为 False 不会影响视图内的选择内容,只会影响输出文件中的选择内容。 默认值为 False

Boolean
width
(可读写)

要导出的地图区域的宽度(以像素为单位)。 此属性仅在导出 MapView 对象时适用。 默认值为 960

Double

方法概述

方法说明
setImageCompression (image_compression)

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

setImageQuality (image_quality)

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

方法

setImageCompression (image_compression)
参数说明数据类型
image_compression

Below is a list of valid strings.

  • DEFLATE Lossless compression method that works well for most cases.
  • LZW Lossless compression method using a code table.
  • NONECompression 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.

  • BESTAn output image quality resample ratio of 1
  • BETTERAn output image quality resample ratio of 2
  • NORMALAn output image quality resample ratio of 3
  • FASTERAn output image quality resample ratio of 4
  • FASTESTAn output image quality resample ratio of 5
String

该值可用于确定输出时栅格内容的有效分辨率。 例如,如果输出图像质量比率设置为 1:2,image_quality 值为 BETTER,并且输出分辨率设置为 300 dpi,则栅格内容将以大约 150 dpi 的分辨率输出。 许多情况下,您能够以低于矢量数据的 dpi 来包含栅格数据,而不会明显影响质量,从而减小输出文件的大小。

代码示例

EPSFormat 示例

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

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

eps = arcpy.mp.CreateExportFormat('EPS', r'C:\Temp\output.eps')

lyt.export(eps)