Краткая информация
Объект EMFFormat представляет собой набор свойств файла формата Enhanced Metafile (EMF), которые можно настраивать и использовать с методом export объектов Layout, MapFrame и MapView для создания выходного файла EMF.
Обсуждение
EMF файлы удобны для включения в документы Windows, т.к. размер изображений, содержащихся в векторных частях EMF, изменяется без потери качества. Но так как EMF не поддерживает встроенные шрифты и является эксклюзивным форматом Windows, его редко используют в качестве обменного формата.
Метод createExportFormat можно использовать для создания объекта EMFFormat, если параметру format присвоено значение EMF. Возвращаемый объект EMFFormat содержит все свойства, связанные с созданием EMF-файла. Эти свойства можно соответствующим образом изменять для получения различных выходных результатов.
Свойства
| Свойство | Описание | Тип данных |
| 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.
| String |
| outputAsImage (чтение и запись) | Экспорт векторного содержимого как изображения. Для карт или компоновок, содержащих векторные слои с высокой плотностью вершин, может значительно уменьшить размер выходного файла. Значение по умолчанию False. | Boolean |
| resolution (чтение и запись) | Эффективное разрешение dpi выходных векторных данных. Значение, предлагаемое по умолчанию, равно 96. Примечание:При экспорте MapView dpi рассчитывается автоматически с использованием системного масштабирования dpi, поэтому это значение будет проигнорировано. | Integer |
| showSelectionSymbology (чтение и запись) | Отображает выбранные объекты на карте или во фрейме карты, выбранные в выходном файле. Установка этого значения на False не влияет на выбор внутри вида, а только на выбор в выходном файле. Значение по умолчанию равно False. | Boolean |
| width (чтение и запись) | Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960. | Double |
Обзор метода
| Метод | Описание |
| setImageQuality (image_quality) | Строковая константа, которая задает количество пересчета изображений. |
Методы
setImageQuality (image_quality)
| Параметр | Описание | Тип данных |
image_quality | Below is a list of valid strings.
| String |
Значение определяет эффективное разрешение растрового содержания выходных данных. Например, если качество выходного растра установлено как 1:2, image_quality значение как BETTER и выходное разрешение – 300 dpi, выходной растр будет иметь разрешение 150 dpi. Во многих случаях растровые данные могут быть включены в экспорт с более низким разрешением dpi, чем векторные данные, что не отразится заметно на их качестве, но приведет к уменьшению размера выходного файла.
Пример кода
Следующий скрипт экспортирует компоновку в формат EMF, используя значения свойств по умолчанию.
p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts()[0]
emf = arcpy.mp.CreateExportFormat('EMF', r'C:\Temp\output.emf')
lyt.export(emf)