EPSFormat

Краткая информация

Объект EPSFormat представляет собой набор свойств файла Encapsulated PostScript (EPS), которые можно настроить и использовать с методом export объектов Layout, MapFrame и MapView для создания выходного файла EPS.

Обсуждение

Файлы формата EPS используют страницы описательного языка PostScript для описания векторных и растровых объектов. PostScript является стандартом печатной промышленности для графических файлов, картографии и вывода на печать. Файлы EPS могут редактироваться во многих графических приложениях или размещаться как графические элементы в большинстве приложений для компоновки. Формат EPS поддерживает встраивание шрифтов и может задавать цвета в значениях CMYK или RGB.

Метод createExportFormat можно использовать для создания объекта EPSFormat, если параметру format присвоено значение EPS. Возвращаемый объект 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.

Примечание:

Параметры, относящиеся к векторным данным, такие как embedFonts недоступны, если для outputAsImage установлено значение True.

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)