ExportToPDF

Сводка

Экспортирует компоновку страницы или фрейм данных документа карты (.mxd) в формат Portable Document Format (PDF).

Описание

PDF формат создан с учетом возможности работы на разных платформах. Эти файлы часто используются для распространения документов через Интернет и становятся стандартным форматом для обмена документацией. Файлы ArcMap PDF можно редактировать во многих графических приложениях, здесь сохраняются аннотации, надписи и данные атрибутов слоев карты из таблицы содержания ArcMap. Экспорт PDF из ArcMap поддерживает встроенные шрифты, поэтому даже если у пользователей не установлены шрифты Esri, символы все равно будут отображаться корректно. При экспорте из ArcMap в PDF можно задавать цвета в значениях 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.

Синтаксис

ExportToPDF (map_document, out_pdf, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {image_quality}, {colorspace}, {compress_vectors}, {image_compression}, {picture_symbol}, {convert_markers}, {embed_fonts}, {layers_attributes}, {georef_info}, {jpeg_compression_quality})

Параметр	Объяснение	Тип данных
map_document	Переменная, которая ссылается на объект MapDocument.	MapDocument
out_pdf	Строка, представляющая путь и имя выходного файла для экспорта.	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	Строка, определяющая цветовую модель файла для экспорта. Допустимыми значениями являются CYMK и RGB. CMYK —Цветовая модель голубой, пурпурный, желтый, черный (Cyan, Magenta,Yellow, and blacK – CMYK). RGB —Цветовая модель красный, зеленый, синий (Red, Green, and Blue – RGB). (Значение по умолчанию — RGB)	String
compress_vectors	Логический параметр, управляющий сжатием векторных и текстовых частей выходного файла. Сжатие изображения определяется отдельно. (Значение по умолчанию — True)	Boolean
image_compression	Строка, которая определяет схему сжатия, используемую для сжатия изображения или растровых данных в выходном файле. Адаптивное —Автоматически выбирает лучший тип сжатия для каждого изображения на странице. JPEG используется для крупных изображений со множеством уникальных цветов. DEFLATE используется для всех других изображений. JPEG —Сжатие данных с потерями. DEFLATE —Сжатие данных без потерь. LZW —Lempel-Ziv-Welch, сжатие данных без потерь. Нет сжатия (NONE) —Нет сжатия данных. RLE —Сжатие с кодированием по длинам серий. (Значение по умолчанию — ADAPTIVE)	String
picture_symbol	Строка, определяющая, будут ли маркеры-рисунки и заполнения рисунком преобразованы в векторные или растровые данные. RASTERIZE_BITMAP — Растеризовать слои с маркерами/заливками на основе рисунков .bmp. RASTERIZE_PICTURE —Растеризовать слои с маркерами/заливками на основе любых рисунков. VECTORIZE_BITMAP —Векторизовать слои с маркерами/заливками на основе рисунков .bmp. (Значение по умолчанию — RASTERIZE_BITMAP)	String
convert_markers	Логический параметр, управляющий преобразованием символов маркеров на основе символов в полигоны. Позволяет правильно отображать символы, если шрифт символов недоступен или не может быть внедрен. Но если установить для этого параметра значение True, внедрение шрифта отключается для всех маркеров символов на основе текстовых символов, что может привести к изменению их внешнего вида. (Значение по умолчанию — False)	Boolean
embed_fonts	Логический параметр, управляющий внедрением шрифтов в файле для экспорта. Внедрение шрифтов позволяет правильно отображать текстовые и символьные маркеры при просмотре документа на компьютере без установленных шрифтов. (Значение по умолчанию — True)	Boolean
layers_attributes	Строка, управляющая включением слоя PDF и данных объектов PDF (атрибутов) в файл для экспорта. LAYERS_ONLY —Экспорт только слоев PDF. LAYERS_AND_ATTRIBUTES —Экспорт слоев и атрибутов объектов PDF. Нет сжатия (NONE) —Нет. (Значение по умолчанию — LAYERS_ONLY)	String
georef_info	Логический параметр, позволяющий экспортировать информацию о системе координат каждого фрейма данных в выходной файл PDF. (Значение по умолчанию — True)	Boolean
jpeg_compression_quality	Число, управляющее качеством сжатия, если для параметра image_compression задано значение ADAPTIVE или JPEG. Допустимый диапазон: от 1 до 100. Если значение jpeg_compression_quality равно 100, это обеспечивает наилучшее качество изображений, но при экспорте создаются крупные файлы. Рекомендованный диапазон находится между 70 и 90. (Значение по умолчанию — 80)	Integer

Пример кода

ExportToPDF. Пример 1

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

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
arcpy.mapping.ExportToPDF(mxd, r"C:\Project\Output\Project.pdf")
del mxd

ExportToPDF. Пример 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.ExportToPDF(mxd, r"C:\Project\Output\ProjectDataFrame.pdf", df,
                          df_export_width=1600,
                          df_export_height=1200)
del mxd