Наверх

TIFFFormat

В этом разделе

  1. Краткая информация
  2. Обсуждение
  3. Свойства
  4. Обзор метода
  5. Методы
  6. Пример кода

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

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

Обсуждение

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

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

Свойства

СвойствоОписаниеТип данных
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)

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

setImageCompression (image_compression)

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

Методы

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

Параметры 32-BIT_CMYK_TRUE_COLOR и 40-BIT_CMYK_WITH_ALPHA доступны только в том случае, если компоновка или карта имеют цветовую модель CMYK. Аналогично параметры 24-BIT_TRUE_COLOR и 32-BIT_WITH_ALPHA доступны только в том случае, если компоновка или карта имеют цветовую модель RGB.

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

Пример кода

Пример TIFFFormat

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

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

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

lyt.export(tif)

Отзыв по этому разделу?

В этом разделе
  1. Краткая информация
  2. Обсуждение
  3. Свойства
  4. Обзор метода
  5. Методы
  6. Пример кода