setColorMode

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

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

Обсуждение

Файлы TGA исторически применялись для ресурсов, которые должны использоваться в других приложениях (например, скрываемое изображение для анимированных игр), и читаются и записываются множеством популярных приложений по работе с графикой. Они поддерживают многобитную глубину, включая 32-битную с alpha-поддержкой (прозрачность).

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

Синтаксис

setColorMode()

Свойства

Имя	Объяснение	Тип данных
clipToElements (Чтение / Запись)	Если установлено `True`, включите части страницы с содержанием только элементов компоновки или карты, а не всю страницу целиком. Это свойство применяется только при экспорте объекта `Layout`. Значение по умолчанию равно `False`.	Boolean
colorMode (Чтение / Запись)	Строковая константа, представляющая число битов для описания цвета в пикселе. Значение по умолчанию равно `32-BIT_WITH_ALPHA`. 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
height (Чтение / Запись)	Высота экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта `MapView`. Значение по умолчанию равно `960`.	Double
resolution (Чтение / Запись)	Эффективное разрешение dpi выходных векторных данных. Значение, предлагаемое по умолчанию, равно 96. Примечание: При экспорте `MapView` dpi рассчитывается автоматически с использованием системного масштабирования dpi, поэтому это значение будет проигнорировано.	Integer
showSelectionSymbology (Чтение / Запись)	Отображает выбранные объекты на карте или во фрейме карты, выбранные в выходном файле. Установка этого значения на `False` не влияет на выбор внутри вида, а только на выбор в выходном файле. Значение по умолчанию равно `False`.	Boolean
transparentBackground (Чтение / Запись)	Если параметр установлен на `True`, экспортирует прозрачную страницу вместо белой страницы. Это свойство применяется только при экспорте объекта `Layout`. Значение по умолчанию равно `False`. Примечание: Прозрачные фоны поддерживаются, только если `colorMode` имеет значение `32-BIT_WITH_ALPHA`. Эта опция недоступна для карт, но при экспорте учитывается прозрачность внутри карты.	Boolean
width (Чтение / Запись)	Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта `MapView`. Значение по умолчанию равно `960`.	Double

Методы

`setColorMode(color_mode)`

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

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

Имя

Объяснение

Тип данных

color_mode

Below is a list of valid strings.

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

Пример кода

Пример TGAFormat

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

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

tga = arcpy.mp.CreateExportFormat('TGA', r'C:\Temp\Output.tga')

lyt.export(tga)