ExportToSVG (arcpy.mapping)
Резюме
Экспортирует компоновку страницы или фрейм данных документа карты (.mxd) в формат Scalable Vector Graphics (SVG).
Обсуждение
SVG – это файлы на базе XML, специально разработанные для просмотра веб-страниц. SVG могут содержать как векторную, так и растровую графику. Это – хороший выбор для отображения карт на веб-странице, поскольку можно изменять масштаб, и файлы этого формата легче редактировать, чем растровые файлы. SVG стал особенно популярен, когда был выбран консорциумом World Wide Web Consortium (W3C) в качестве стандарта векторных веб-форматов. Некоторые Интернет-браузеры могут потребовать подключаемую программу, чтобы просматривать файлы SVG, а старые версии браузеров могут вообще оказаться неспособны отображать SVG-файлы. Формат SVG поддерживает встроенные шрифты, поэтому даже если у пользователей не установлены шрифты Esri, символы все равно будут отображаться корректно. ArcMap может также создавать сжатые файлы SVG. При включении этой опции расширение файла изменяется на *.SVGZ.
Для экспорта отдельного фрейма данных вместо целой компоновки страницы, укажите объект DataFrame для параметра data_frame. Поскольку экспорт из фрейма данных не имеет связанной страницы с информацией о высоте и ширине, необходимо указать эти значения с помощью параметров df_export_width и df_export_height.
Управление качеством графики сгенерированного изображения при экспорте компоновки страницы отличается от экспорта фрейма данных. При экспорте компоновки страницы детализация изображения управляется параметром resolution. При экспорте фрейма данных оставьте значение параметра resolution по умолчанию, и измените параметры df_export_width и df_export_height, чтобы изменить детализацию изображения. Параметры высоты и ширины напрямую управляют числом пикселей, генерирующихся в файле экспорта, и используются только при экспорте фрейма данных. Изображения с большим числом пикселей имеют большую детализацию. При экспорте большинства компоновок значения параметров, использующиеся по умолчанию, позволяют получить хорошие результаты и качественные изображения с первой попытки. При экспорте фрейма данных необходимо попробовать различные значения параметров df_export_width и df_export_height, чтобы получить подходящий вариант.
Подробное описание экспорта карт см. в разделе Экспорт карты в справке ArcGIS.
Синтаксис
| Параметр | Объяснение | Тип данных |
map_document |
Переменная, которая ссылается на объект MapDocument. | MapDocument |
out_svg |
Строка, представляющая путь и имя выходного файла для экспорта. | 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) | String |
compress_document |
Если имеет значение True (истина), то будет создан сжатый файл экспорта. Для SVG, происходит сжатие всего документа, и расширение файла меняется на *.svgz. (Значение по умолчанию — False) | Boolean |
picture_symbol |
Строка, определяющая, будут ли маркеры-рисунки и заполнения рисунком преобразованы в векторные или растровые данные.
(Значение по умолчанию — RASTERIZE_BITMAP) | String |
convert_markers |
Логический параметр, управляющий преобразованием символов маркеров на основе символов в полигоны. Позволяет правильно отображать символы, если шрифт символов недоступен или не может быть внедрен. Но если установить для этого параметра значение True, внедрение шрифта отключается для всех маркеров символов на основе текстовых символов, что может привести к изменению их внешнего вида. (Значение по умолчанию — False) | Boolean |
embed_fonts |
Логический параметр, управляющий внедрением шрифтов в файлах для экспорта. Внедрение шрифтов позволяет правильно отображать текстовые и символьные маркеры при просмотре документа на компьютере без установленных шрифтов. (Значение по умолчанию — False) | Boolean |
Пример кода
Этот скрипт открывает документ карты и экспортирует компоновку страницы в файл SVG, используя настройки по умолчанию для всех опций.
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
arcpy.mapping.ExportToSVG(mxd, r"C:\Project\Output\Project.svg")
del mxd
Этот скрипт экспортирует отдельный фрейм данных вместо целой компоновки страницы, аналогично тому, как выполняется экспорт из вида данных в приложение 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.ExportToSVG(mxd, r"C:\Project\Output\ProjectDataFrame.svg", df,
df_export_width=1600,
df_export_height=1200)
del mxd