setColorMode

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

Объект JPEGFormat представляет собой набор свойств файла Joint Photographic Experts Group (JPEG), которые можно настраивать и использовать с помощью метода export на объектах Layout, MapFrame, MapView, MapSeries и BookmarkMapSeries для создания выходного файла JPG.

Обсуждение

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

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

Синтаксис

setColorMode()

Свойства

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

Методы

setColorMode(color_mode)

Строковая константа, представляющая число битов для описания цвета в пикселе.

Имя	Объяснение	Тип данных
color_mode	Below is a list of valid strings. 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.	String

Пример кода

Пример JPEGFormat

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

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

jpg = arcpy.mp.CreateExportFormat('JPEG', r'C:\Temp\Output.jpg')

lyt.export(jpg)