ExportToTIFF (arcpy.mapping)

Резюме

Экспортирует компоновку страницы или фрейм данных документа карты (.mxd) в формат Tagged Image File Format (TIFF).

Обсуждение

TIFF – это наиболее гибкий формат растровых данных. TIFF-файлы могут сохранять пиксельные данные с разной битовой разрядностью, а также осуществлять сжатие при помощи различных техник с большими или меньшими потерями в зависимости от размера файла и требований к четкости изображения. Они наилучшим образом подходят для импортирования в приложения для редактирования изображений во всех операционных системах. Но их невозможно просматривать в веб-браузерах. TIFFы, экспортированные из вида данных ArcMap, также поддерживают пространственную привязку в тегах GeoTIFF или в отдельном файле привязки (world file).

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

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

Файлы привязки не генерируются для компоновок страницы; если не был указан базовый фрейм данных, экспорт не состоится.

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

Синтаксис

ExportToTIFF (map_document, out_tiff, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {world_file}, {color_mode}, {tiff_compression}, {geoTIFF_tags})

Параметр	Объяснение	Тип данных
map_document	Переменная, которая ссылается на объект MapDocument.	MapDocument
out_tiff	Строка, представляющая путь и имя выходного файла для экспорта.	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_width используется только при экспорте фрейма данных. При экспорте компоновки страницы вместо df_export_width используется ширина страницы документа карты. (Значение по умолчанию — 480)	Integer
resolution	Число, определяющее разрешение файла для экспорта в DPI (точках на дюйм). (Значение по умолчанию — 96)	Integer
world_file	Если в этом поле установлено Истина, то создается файл пространственной привязки. Файл содержит информацию о масштабе в пикселах и о реальных пространственных координатах. (Значение по умолчанию — False)	Boolean
color_mode	Это значение определяет количество битов, используемых для описания цвета. 24-BIT_TRUE_COLOR —24-разрядный режим, реальный цвет. 8-BIT_PALETTE —8-разрядная палитра. 8-BIT_GRAYSCALE —8-разрядный режим, оттенки серого 1-BIT_MONOCHROME_MASK —1-разрядный режим, монохромная маска. 1-BIT_MONOCHROME_THRESHOLD —1-разрядный режим, монохромный порог. (Значение по умолчанию — 24-BIT_TRUE_COLOR)	String
tiff_compression	Это значение отображает схему сжатия. DEFLATE —Сжатие данных без потерь. JPEG —Сжатие JPEG. LZW —Lempel-Ziv-Welch, сжатие данных без потерь. Нет сжатия (NONE) —Нет сжатия данных. PACK_BITS —Сжатие PackBits. (Значение по умолчанию — LZW)	String
geoTIFF_tags	Если здесь стоит значение истина, в структуру файла для экспорта TIFF будут добавлены теги пространственной привязки. Теги содержат информацию о масштабе в пикселах и о реальных пространственных координатах. Эти теги читаются приложениями, которые поддерживают формат TIFF. (Значение по умолчанию — False)	Boolean

Пример кода

ExportToTIFF, пример 1

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

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

ExportToTIFF, пример 2

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

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "Transportation")[0]
arcpy.mapping.ExportToTIFF(mxd, r"C:\Project\Output\ProjectDataFrame.tif", df,
                           df_export_width=1600,
                           df_export_height=1200,
                           geoTIFF_tags=True)
del mxd