ExportToAI (arcpy.mapping)

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

Экспортирует компоновку страницы или фрейм данных документа карты (.mxd) в формат Adobe Illustrator (AI).

Обсуждение

Формат Adobe Illustrator (AI) является превосходным форматом как для дальнейшей обработки в Adobe Illustrator, так и при передаче для публикации. Формат ArcMap AI сохраняет большинство слоев таблицы содержания ArcMap. Однако, при экспорте в файлы формата Adobe Illustrator из ArcMap встроенные шрифты не записываются, поэтому если у пользователей нет встроенных шрифтов Esri, возможно, символы в AI-файлах будут отображаться не совсем корректно. При экспорте в AI из ArcMap можно задавать цвета в значениях CMYK или RGB.

Для экспорта отдельного фрейма данных вместо целой компоновки страницы, укажите объект DataFrame для параметра data_frame. Поскольку экспорт из фрейма данных не имеет связанной страницы с информацией о высоте и ширине, необходимо указать эти значения с помощью параметров df_export_width и df_export_height.

Управление качеством графики сгенерированного изображения при экспорте компоновки страницы отличается от экспорта фрейма данных. При экспорте компоновки страницы детализация изображения управляется параметром resolution. При экспорте фрейма данных оставьте значение параметра resolution по умолчанию, и измените параметры df_export_width и df_export_height, чтобы изменить детализацию изображения. Параметры высоты и ширины напрямую управляют числом пикселей, генерирующихся в файле экспорта, и используются только при экспорте фрейма данных. Изображения с большим числом пикселей имеют большую детализацию. При экспорте большинства компоновок значения параметров, использующиеся по умолчанию, позволяют получить хорошие результаты и качественные изображения с первой попытки. При экспорте фрейма данных необходимо попробовать различные значения параметров df_export_width и df_export_height, чтобы получить подходящий вариант.

Подробное описание экспорта карт см. в разделе Экспорт карты в справке ArcGIS.

Синтаксис

ExportToAI (map_document, out_ai, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {image_quality}, {colorspace}, {picture_symbol}, {convert_markers})
ПараметрОбъяснениеТип данных
map_document

Переменная, которая ссылается на объект MapDocument.

MapDocument
out_ai

Строка, представляющая путь и имя выходного файла для экспорта.

String
data_frame

Переменная, которая ссылается на объект DataFrame. Используйте строковую константу "PAGE_LAYOUT", чтобы экспортировать компоновку страницы документа карты вместо отдельного фрейма данных.

(Значение по умолчанию — PAGE_LAYOUT)

Object
df_export_width

Число, определяющее ширину экспортируемого изображения в пикселах для экспорта фрейма данных. df_export_width используется только при экспорте фрейма данных. При экспорте компоновки страницы вместо df_export_width используется ширина страницы документа карты.

(Значение по умолчанию — 640)

Integer
df_export_height

Число, определяющее высоту экспортируемого изображения в пикселах для экспорта фрейма данных. df_export_height используется только при экспорте фрейма данных. При экспорте компоновки страницы вместо df_export_height используется высота страницы документа карты.

(Значение по умолчанию — 480)

Integer
resolution

Число, определяющее разрешение файла для экспорта в точках на дюйм (DPI).

(Значение по умолчанию — 300)

Integer
image_quality

Строка, определяющая качество выходного изображения, разрешение вывода слоев карты в растровом формате.

  • BESTКачество выходного изображения с коэффициентом сжатия 1.
  • BETTERКачество выходного изображения с коэффициентом сжатия 2.
  • NORMALКачество выходного изображения с коэффициентом сжатия 3.
  • FASTERКачество выходного изображения с коэффициентом сжатия 4.
  • FASTESTКачество выходного изображения с коэффициентом сжатия 5.

(Значение по умолчанию — BEST)

String
colorspace

Строка, определяющая, какое пространство цвета будет записано в файл для экспорта.

  • CMYKЦветовая модель голубой, пурпурный, желтый, черный (Cyan, Magenta,Yellow, and blacK – CMYK).
  • RGBЦветовая модель красный, зеленый, синий (Red, Green, and Blue – RGB).

(Значение по умолчанию — RGB)

String
picture_symbol

Строка, определяющая, будут ли маркеры-рисунки и заполнения рисунком преобразованы в векторные или растровые данные.

  • RASTERIZE_BITMAP Растеризовать слои с маркерами/заливками на основе рисунков .bmp.
  • RASTERIZE_PICTUREРастеризовать слои с маркерами/заливками на основе любых рисунков.
  • VECTORIZE_BITMAPВекторизовать слои с маркерами/заливками на основе рисунков .bmp.

(Значение по умолчанию — RASTERIZE_BITMAP)

String
convert_markers

Логический параметр, управляющий преобразованием символов маркеров на основе символов в полигоны. Позволяет правильно отображать символы, если шрифт символов недоступен или не может быть внедрен. Но если установить для этого параметра значение True, внедрение шрифта отключается для всех маркеров символов на основе текстовых символов, что может привести к изменению их внешнего вида.

(Значение по умолчанию — False)

Boolean

Пример кода

ExportToAI. Пример 1

Этот скрипт открывает документ карты и экспортирует компоновку страницы в файл Adobe Illustrator, используя для всех опций значения, установленные по умолчанию.

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
arcpy.mapping.ExportToAI(mxd, r"C:\Project\Output\Project.ai")
del mxd
ExportToAI. Пример 2

Этот скрипт экспортирует отдельный фрейм данных вместо целой компоновки страницы, аналогично тому, как выполняется экспорт из вида данных в приложение ArcMap. Значения по умолчанию для df_export_width и df_export_height составляют 640 и 480. Установив для этих параметров более высокие значения, можно получить выходное изображение с более высокой степенью детализации.

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "Transportation")[0]
arcpy.mapping.ExportToAI(mxd, r"C:\Project\Output\ProjectDataFrame.ai", df,
                         df_export_width=1600,
                         df_export_height=1200)
del mxd
5/10/2014