setColorMode

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

Объект TIFFFormat представляет собой набор свойств файла формата TIFF (Tagged Image File Format), которые можно настроить и использовать с помощью метода export на объектах Layout, MapFrame, MapView, MapSeries и BookmarkMapSeries для создания выходного файла TIF.

Обсуждение

Файлы TIFF наилучшим образом подходят для импорта в приложения для редактирования изображений и тоже считаются распространенным в ГИС растровым форматом данных. Но их невозможно просматривать в веб-браузерах. Файлы TIFF также поддерживают пространственную привязку в тегах GeoTIFF или в отдельном файле привязки, для использования в качестве растровых данных.

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

Синтаксис

setColorMode()

Свойства

Имя	Объяснение	Тип данных
clipToElements (Чтение / Запись)	Если установлено `True`, включите части страницы с содержанием только элементов компоновки или карты, а не всю страницу целиком. Это свойство применяется только при экспорте объекта `Layout`. Значение по умолчанию равно `False`.	Boolean
colorMode (Чтение / Запись)	Строковая константа, представляющая число битов для описания цвета в пикселе. Значение по умолчанию равно `24-BIT_TRUE_COLOR`. 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 значениями. Удобна для карт или компоновок с прозрачностью 32-BIT_CMYK_TRUE_COLOR—8 бит на пиксель для каждого канала: голубой, пурпурный, желтый, черный. 40-BIT_CMYK_WITH_ALPHA—8 бит на пиксель для каждого канала: голубой, пурпурный, желтый, черный, плюс дополнительный 8-разрядный канал для альфа. Используйте этот параметр, если карты или компоновки обладают прозрачностью. Примечание: Доступные значения `colorMode` зависят от указанной цветовой модели, заданной в свойствах управления цветом. Параметры `32-BIT_CMYK_TRUE_COLOR` и `40-BIT_CMYK_WITH_ALPHA` доступны только в том случае, если компоновка или карта имеют цветовую модель CMYK. Аналогично параметры `24-BIT_TRUE_COLOR` и `32-BIT_WITH_ALPHA` доступны только в том случае, если компоновка или карта имеют цветовую модель RGB.	String
embedColorProfile (Чтение / Запись)	Включить цветовой профиль, установленный для карты или компоновки, в экспортируемый файл. Это помогает добиться согласованности цветов, когда файл просматривается на разных устройствах. Если профиль не является встроенным, или используется вьюер без управления цветом, цвета могут значительно отличаться от отображаемых на экране. Значение по умолчанию равно `True`. Примечание: Опция доступна только при включенном управлении цветом. Если управление цветом не включено или выбрано цветовое пространство CMYK, пространство CMYK также входит в экспортируемые данные. Это может привести к изменению некоторых цветов при просмотре экспортированного файла.	Boolean
filePath (Чтение / Запись)	Строка, представляющая системный путь и имя файла, включая расширение, для экспортируемого файла.	String
geoReferenceMapFrame (Чтение / Запись)	MapFrame используется для управления системой координат, если свойство `worldFile` имеет значение True. Значение по умолчанию равно `None`.	MapFrame
geoTIFFTags (Чтение / Запись)	Если значение установлено на `True` и задан корректный `georef_mapframe`, теги geoTIFF будут встроены в результирующее изображение на основании системы координат фрейма данных карты. Это позволяет использовать экспортированное изображение в качестве растровых данных в ArcGIS Pro или других ГИС-приложениях. Значение по умолчанию равно `False`. Примечание: При экспорте компоновки информация GeoTIFF должна быть основана на 2D-карте, связанной со свойством `geoReferenceMapFrame`. Свойство `geoTIFFTags` не зависит от свойства `worldFile`. С помощью ГИС-совместимого ПО можно учитывать информацию GeoTIFF или файл привязки при экспорте.	Boolean
height (Чтение / Запись)	Высота экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта `MapView`. Значение по умолчанию равно `960`.	Double
imageCompression (Чтение / Запись)	Строковая константа, представляющая схему сжатия, используемую для сжатия изображения или растровых данных в выходном файле. Значение по умолчанию равно `LZW`. DEFLATE—Метод сжатия без потерь, подходящий для большинства случаев. JPEG—Метод сжатия с потерями, который хорошо подходит для фотографий. LZW—Метод сжатия без потерь с использованием таблицы кодов. NONE—Нет сжатия данных. PACK_BITS—Метод сжатия без потерь, который хорошо работает с большими областями одного цвета.	String
imageCompressionQuality (Чтение / Запись)	Степень сжатия изображения, применяемая к экспортируемому файлу. При низком качестве создается файл меньшего размера, но с менее четкими данными, при максимальном качестве создается файл большего размера, но с более четкими данными. Применяется, только когда используются несколько методов сжатия. Значение по умолчанию равно `100`.	Integer
resolution (Чтение / Запись)	Эффективное разрешение dpi выходных векторных данных. Значение, предлагаемое по умолчанию, равно 96. Примечание: При экспорте `MapView` dpi рассчитывается автоматически с использованием системного масштабирования dpi, поэтому это значение будет проигнорировано.	Integer
showSelectionSymbology (Чтение / Запись)	Отображает выбранные объекты на карте или во фрейме карты, выбранные в выходном файле. Установка этого значения на `False` не влияет на выбор внутри вида, а только на выбор в выходном файле. Значение по умолчанию равно `False`.	Boolean
threshold (Чтение / Запись)	Интенсивность изображения, установленная выше этого значения, будет отображаться в выходном файле белым цветом, а все остальные значения будут отображаться черным цветом. Это свойство применяется только в том случае, если для свойства `colorMode` установлено значение `1-BIT_MONOCHROME_THRESHOLD`. Значение по умолчанию равно `128`.	Boolean
transparentBackground (Чтение / Запись)	Если задано как `True`, то белый цвет фона будет настроен как прозрачный. Значение по умолчанию равно `False`.	Boolean
width (Чтение / Запись)	Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта `MapView`. Значение по умолчанию равно `960`.	Double
worldFile (Чтение / Запись)	Если параметр установлен на `True` и задан корректный `georef_mapframe`, создается файл привязки на основании системы координат фрейма данных карты. Значение по умолчанию равно `False`.	Boolean

Методы

`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_CMYK_TRUE_COLOR— 8 bits per pixel for each channel: cyan, magenta, yellow, black. 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. 40-BIT_CMYK_WITH_ALPHA— 8 bits per pixel for each channel: cyan, magenta, yellow, black, plus an additional 8-bit channel for alpha. Use this option if maps or layouts have transparency. Примечание: The available `colorMode` values are dependent on the specified color model set in color management properties.	String

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_CMYK_TRUE_COLOR— 8 bits per pixel for each channel: cyan, magenta, yellow, black.
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.
40-BIT_CMYK_WITH_ALPHA— 8 bits per pixel for each channel: cyan, magenta, yellow, black, plus an additional 8-bit channel for alpha. Use this option if maps or layouts have transparency.

Примечание:

The available colorMode values are dependent on the specified color model set in color management properties.

String

`setImageCompression(image_compression)`

Строковая константа, представляющая схему сжатия, используемую для сжатия изображения или растровых данных в выходном файле.

Имя	Объяснение	Тип данных
image_compression	Below is a list of valid strings. DEFLATE— Lossless compression method that works well for most cases. JPEG— Lossy compression method that works well for photographic-type images. LZW— Lossless compression method using a code table. NONE—Compression is not applied. PACK_BITS— Lossless compression method that works well if there are large areas of the same color.	String

Имя

Объяснение

Тип данных

image_compression

Below is a list of valid strings.

DEFLATE— Lossless compression method that works well for most cases.
JPEG— Lossy compression method that works well for photographic-type images.
LZW— Lossless compression method using a code table.
NONE—Compression is not applied.
PACK_BITS— Lossless compression method that works well if there are large areas of the same color.

String

Пример кода

Пример TIFFFormat

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

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

tif = arcpy.mp.CreateExportFormat('TIFF', r'C:\Temp\Output.tif')

lyt.export(tif)