setColorMode

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

Объект BMPFormat представляет собой набор свойств файла растрового изображения Microsoft Windows (BMP), которые можно настроить и использовать с методом export объектов Layout, MapFrame и MapView для создания выходного файла BMP.

Обсуждение

Формат BMP является "родным" форматом растровых изображений Windows. В файлах BMP можно хранить данные о пикселах с разной битовой глубиной и без потерь сжимать их с помощью метода RLE. Обычно файлы в формате BMP получаются гораздо больше, чем JPEG или PNG.

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

Синтаксис

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 возможных цветов. Этот вариант хорош для максимальной точности цветопередачи.	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
width (Чтение / Запись)	Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта `MapView`. Значение по умолчанию равно `960`.	Double
worldFile (Чтение / Запись)	Если параметр установлен на `True` и задан корректный `georef_mapframe`, создается файл привязки на основании системы координат фрейма данных карты. Значение по умолчанию равно `False`.	Boolean

Методы

`setColorMode(bmp_color_mode)`

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

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
bmp_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.	String

bmp_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.

String

Пример кода

Пример BMPFormat

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

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

bmp = arcpy.mp.CreateExportFormat('BMP', r'C:\Temp\output.bmp')

lyt.export(bmp)