Краткая информация
Экспортирует компоновку страницы или фрейм данных документа карты (.mxd) в формат Portable Network Graphics (PNG).
Описание
PNG – растровый формат, разработанный для использования в Интернете в качестве альтернативы формату GIF. Он поддерживает 24-битовую глубину цвета и сжатие без потерь. PNG-файлы также позволяют задать прозрачность цвета; тогда часть рисунка отображается в браузере прозрачной, и сквозь нее может просвечивать цветной фон или рисунок. Для большинства изображений PNG позволяет улучшить степень сжатия (и таким образом уменьшить размер файлов) по сравнению с GIF. PNG из вида данных ArcMap можно сгенерировать с сопроводительным файлом привязки и использовать как пространственно привязанные растровые данные. Этот формат набирает популярность в сообществе веб-дизайнеров.
Для экспорта отдельного фрейма данных вместо целой компоновки страницы, укажите объект DataFrame для параметра data_frame. Поскольку экспорт из фрейма данных не имеет связанной страницы с информацией о высоте и ширине, необходимо указать эти значения с помощью параметров df_export_width и df_export_height.
Управление качеством графики сгенерированного изображения при экспорте компоновки страницы отличается от экспорта фрейма данных. При экспорте компоновки страницы детализация изображения управляется параметром resolution. При экспорте фрейма данных оставьте значение параметра resolution по умолчанию, и измените параметры df_export_width и df_export_height, чтобы изменить детализацию изображения. Параметры высоты и ширины напрямую управляют числом пикселей, генерирующихся в файле экспорта, и используются только при экспорте фрейма данных. Изображения с большим числом пикселей имеют большую детализацию. При экспорте большинства компоновок значения параметров, использующиеся по умолчанию, позволяют получить хорошие результаты и качественные изображения с первой попытки. При экспорте фрейма данных необходимо попробовать различные значения параметров df_export_width и df_export_height, чтобы получить подходящий вариант.
Файлы привязки не генерируются для компоновок страницы; если не был указан базовый фрейм данных, экспорт не состоится.
Подробное описание экспорта карт см. в разделе Экспорт карты в справке ArcGIS.
Синтаксис
ExportToPNG (map_document, out_png, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {world_file}, {color_mode}, {background_color}, {transparent_color}, {interlaced})| Параметр | Объяснение | Тип данных |
map_document | Переменная, которая ссылается на объект MapDocument. | MapDocument |
out_png | Строка, представляющая путь и имя выходного файла для экспорта. | 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). (Значение по умолчанию — 96) | Integer |
world_file | Если в этом поле установлено значение True, то создается файл пространственной привязки. Файл содержит информацию о масштабе в пикселах и о реальных пространственных координатах. (Значение по умолчанию — False) | Boolean |
color_mode | Это значение определяет количество битов, используемых для описания цвета.
(Значение по умолчанию — 24-BIT_TRUE_COLOR) | String |
background_color | Настроенный цвет используется в качестве фона для изображения или в качестве маски в случаях экспорта монохромной маски. (Значение по умолчанию — 255, 255, 255) | String |
transparent_color | Настроенный цвет будет отображаться на изображении прозрачным. | String |
interlaced | Если установлено значение True, то создается чересстрочное изображение. Чересстрочное изображение отображается как ряд отсканированных линий, а не все изображение целиком. (Значение по умолчанию — False) | Boolean |
Пример кода
ExportToPNG, пример 1
Этот скрипт открывает документ карты и экспортирует компоновку страницы в файл PNG, используя настройки по умолчанию для всех опций.
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
arcpy.mapping.ExportToPNG(mxd, r"C:\Project\Output\Project.png")
del mxd
ExportToPNG, пример 2
Этот скрипт экспортирует отдельный фрейм данных вместо целой компоновки страницы, аналогично тому, как выполняется экспорт из вида данных в приложение ArcMap. Значения по умолчанию для df_export_width и df_export_height составляют 640 и 480. Установив для этих параметров более высокие значения, можно получить выходное изображение с более высокой степенью детализации. Настройка world_file = True создает файл пространственной привязки в той же директории, что и выходной файл.
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "Transportation")[0]
arcpy.mapping.ExportToPNG(mxd, r"C:\Project\Output\ProjectDataFrame.png", df,
df_export_width=1600,
df_export_height=1200,
world_file=True)
del mxd