PNGFormat

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

Объект PNGFormat представляет собой набор свойств файла Portable Network Graphics (PNG), которые можно настроить и использовать с методом export объектов Layout, MapFrame и MapView для создания выходного файла PNG.

Обсуждение

PNG – это универсальный растровый формат, который может отображаться в веб-браузерах и поддерживает вставку в другие документы. Он поддерживает большую битовую глубину цвета и использует сжатие без потерь. Для карт часто лучше всего подходит формат PNG, так как сжатие без потерь обеспечивает читаемость текста и линий, препятствуя возникновению артефактов сжатия, которые могут возникать в формате JPEG. Для файла PNG можно задать прозрачность цвета; благодаря этому часть рисунка можно сделать прозрачной при отображении в браузере, и тогда на заднем плане можно будет отобразить цветной фон или рисунок. Файлы PNG могут быть сгенерированы с сопроводительным файлом привязки для использования в качестве пространственно привязанных растровых данных.

Метод createExportFormat можно использовать для создания объекта PNGFormat, если параметру format присвоено значение PNG. Возвращаемый объект PNGFormat содержит все свойства, связанные с созданием PNG-файла. Эти свойства можно соответствующим образом изменять для получения различных выходных результатов.

Свойства

Свойство	Описание	Тип данных
clipToElements (чтение и запись)	Если установлено True, включите части страницы с содержанием только элементов компоновки или карты, а не всю страницу целиком. Это свойство применяется только при экспорте объекта Layout. Значение по умолчанию равно False.	Boolean
colorMode (чтение и запись)	Строковая константа, представляющая число битов для описания цвета в пикселе. Значение по умолчанию равно 32-BIT_WITH_ALPHA. 1-BIT_MONOCHROME_THRESHOLD—2 возможных цвета, черный и белый. Области, которые являются белыми и черными, определяются значением threshold. 8-BIT_ADAPTIVE_PALETTE—Использует 256 наиболее часто используемых цветов пикселей в палитре изображения, тем самым минимизируя количество пикселей, цвет которых может измениться во время вывода. 8-BIT_GRAYSCALE—256 оттенков серого. Все цвета конвертируются в шкалу оттенков серого. 24-BIT_TRUE_COLOR—16 777 216 возможных цветов. Этот вариант хорош для максимальной точности цветопередачи. 32-BIT_WITH_ALPHA—16 777 216 возможных цветов и альфа-канал (прозрачность) с 255 значениями. Удобна для карт или компоновок с прозрачностью	String
filePath (чтение и запись)	Строка, представляющая системный путь и имя файла, включая расширение, для экспортируемого файла.	String
geoReferenceMapFrame (чтение и запись)	MapFrame используется для управления системой координат, если свойство worldFile имеет значение True. Значение по умолчанию равно None.	MapFrame
height (чтение и запись)	Высота экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960.	Double
resolution (чтение и запись)	Эффективное разрешение dpi выходных векторных данных. Значение, предлагаемое по умолчанию, равно 96. Примечание: При экспорте MapView dpi рассчитывается автоматически с использованием системного масштабирования dpi, поэтому это значение будет проигнорировано.	Integer
showSelectionSymbology (чтение и запись)	Отображает выбранные объекты на карте или во фрейме карты, выбранные в выходном файле. Установка этого значения на False не влияет на выбор внутри вида, а только на выбор в выходном файле. Значение по умолчанию равно False.	Boolean
threshold (чтение и запись)	Интенсивность изображения, установленная выше этого значения, будет отображаться в выходном файле белым цветом, а все остальные значения будут отображаться черным цветом. Это свойство применяется только в том случае, если для свойства colorMode установлено значение 1-BIT_MONOCHROME_THRESHOLD. Значение по умолчанию равно 128.	Boolean
transparentBackground (чтение и запись)	Если параметр установлен на True, экспортирует прозрачную страницу вместо белой страницы. Это свойство применяется только при экспорте объекта Layout. Значение по умолчанию равно False. Примечание: Прозрачные фоны поддерживаются только если colorMode имеет значение 32-BIT_WITH_ALPHA. Эта опция недоступна для карт, но при экспорте учитывается прозрачность внутри карты.	Boolean
width (чтение и запись)	Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960.	Double
worldFile (чтение и запись)	Если параметр установлен на True и задан корректный georef_mapframe, создается файл привязки на основании системы координат фрейма данных карты. Значение по умолчанию равно False.	Boolean

Обзор метода

Метод	Описание
setColorMode (color_mode)	Строковая константа, представляющая число битов для описания цвета в пикселе.

Методы

setColorMode (color_mode)

Параметр	Описание	Тип данных
color_mode	Below is a list of valid strings. 1-BIT_MONOCHROME_THRESHOLD— 2 possible colors, black and white. The areas which are white and black are determined by the threshold value. 8-BIT_ADAPTIVE_PALETTE—Uses 256 of the most commonly-used pixel colors in the image’s palette, thereby minimizing the number of pixels whose color may change during output. 8-BIT_GRAYSCALE— 256 shades of gray. All colors are converted to grayscale. 24-BIT_TRUE_COLOR— 16,777,216 possible colors. This option is good for maximum color fidelity. 32-BIT_WITH_ALPHA— 16,777,216 possible colors and an alpha (transparency) channel of 255 values. This option is useful for maps or layouts with transparency.	String

Пример кода

Пример PNGFormat

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

p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts()[0]

png = arcpy.mp.CreateExportFormat('PNG', r'C:\Temp\Output.png')

lyt.export(png)