setImageCompression

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

Объект PDFFormat представляет собой набор свойств файла формата Portable Document Format (PDF), которые можно настроить и использовать с помощью метода export на объектах Layout, MapFrame, MapView, MapSeries, BookmarkMapSeries и Report для создания выходного PDF-файла.

Обсуждение

PDF формат создан с учетом возможности работы на разных платформах. Эти файлы часто используются для распространения документов через Интернет. Теперь этот формат стал официальным стандартом ISO для обмена документацией. Файлы PDF можно редактировать во многих графических приложениях. Эти файлы могут сохранять информацию о привязке, аннотации, надписи и атрибутивные данные объектов. Кроме того, весь документ или отдельные слои можно растрировать, чтобы упростить документ и уменьшить размер файла.

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

Синтаксис

setImageCompression()

Свойства

Имя	Объяснение	Тип данных
clipToElements (Чтение / Запись)	Если установлено True, включите части страницы с содержанием только элементов компоновки или карты, а не всю страницу целиком. Это свойство применяется только при экспорте объекта Layout. Значение по умолчанию равно False.	Boolean
compressVectorGraphics (Чтение / Запись)	Сжимать потоки векторного содержания. Эту опцию следует оставить True, кроме случаев, когда необходим четкий текст во избежание проблем. Значение по умолчанию равно True.	Boolean
convertMarkers (Чтение / Запись)	Определяет, будут ли маркерные символы, основанные на символах шрифта, экспортироваться как символы шрифта или как полигоны. Установите эту опцию на True, чтобы просматривать выходные данные на компьютере, где не установлены соответствующие шрифты, а из-за ограничений лицензии или формата файла нет возможности встроить шрифты в файл. Не применяется к тексту, только к символам-маркерам основанным на шрифтах. Значение по умолчанию равно False.	Boolean
embedColorProfile (Чтение / Запись)	Включить цветовой профиль, установленный для карты или компоновки, в экспортируемый файл. Это помогает добиться согласованности цветов, когда файл просматривается на разных устройствах. Если профиль не является встроенным, или используется вьюер без управления цветом, цвета могут значительно отличаться от отображаемых на экране. Значение по умолчанию равно True. Примечание: Опция доступна только при включенном управлении цветом. Если управление цветом не включено или выбрано цветовое пространство CMYK, пространство CMYK также входит в экспортируемые данные. Это может привести к изменению некоторых цветов при просмотре экспортированного файла.	Boolean
embedFonts (Чтение / Запись)	Включите в экспортируемый файл встраиваемые шрифты, чтобы поддерживать согласованность шрифтов на разных платформах. Шрифты, которые не поддерживают встраивание, не будут включены, независимо от данной настройки. Значение по умолчанию равно True. Примечание: Чтобы правильно редактировать текст в виде графики Illustrator необходим, чтобы шрифты были установлены и доступны. Проверьте разрешения на общий доступ перед вставкой и публикацией шрифтов. Для символов с большим диапазоном или лигатур следует использовать встраивание шрифта, чтобы обеспечить правильную адресацию этих символов с большим диапазоном. В случае, когда шрифт с большим диапазоном символов или лигатурами не может быть встроен, отметьте свойство Отрисовать глифы как геометрическое для текстового символа.	Boolean
filePath (Чтение / Запись)	Строка, представляющая системный путь и имя файла, включая расширение, для экспортируемого файла.	String
georefInfo (Чтение / Запись)	Включите геопространственную информацию из карты, или одного или нескольких фреймов карты. Если эта информация включена, вы можете извлекать данные координат x, y и выполнять географические измерения в поддерживаемых программах для чтения PDF-файлов. Значение по умолчанию равно True.	Boolean
height (Чтение / Запись)	Высота экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960.	Double
imageCompression (Чтение / Запись)	Схема сжатия, используемая для сжатия изображения или растровых данных в выходном файле. Выберите одну из следующих опций ниже. Значение по умолчанию равно ADAPTIVE. ADAPTIVE—Сжатие JPEG и Deflate комбинируется в зависимости от содержания потока. Подходит для большинства случаев. DEFLATE—Метод сжатия без потерь, подходящий для большинства случаев. JPEG—Метод сжатия с потерями, который хорошо подходит для фотографий. JPEG2000—Сжатие, обеспечивающее более высокое качество, с размерами файлов, меньшими, чем JPEG. Это сжатие будет выполняться без потерь, если jpeg_compression_quality будет установлено на 100. LZW—Метод сжатия без потерь с использованием таблицы кодов. NONE—Нет сжатия данных. RLE—Метод сжатия без потерь, который хорошо работает с большими областями одного цвета.	String
imageCompressionQuality (Чтение / Запись)	Степень сжатия изображения, применяемая к экспортируемому файлу. При низком качестве создается файл меньшего размера, но с менее четкими данными, при максимальном качестве создается файл большего размера, но с более четкими данными. Применяется, только когда используются несколько методов сжатия. Значение по умолчанию равно 80.	Integer
imageQuality (Чтение / Запись)	Качество пересчета изображений. Свойство определяет эффективное разрешение растрового содержания выходных данных. Например, если imageQuality установлено на BETTER, коэффициент сжатия - 1:2, а выходное разрешение resolution имеет значение 300 dpi, то выходной растр будет иметь разрешение 150 dpi. Во многих случаях растровые данные могут быть включены в экспорт с более низким разрешением dpi, чем векторные данные, что не отразится заметно на их качестве, но приведет к уменьшению размера выходного файла. Значение по умолчанию равно BEST. BEST—Качество выходного изображения с коэффициентом сжатия 1 BETTER—Качество выходного изображения с коэффициентом сжатия 2 NORMAL—Качество выходного изображения с коэффициентом сжатия 3 FASTER—Качество выходного изображения с коэффициентом сжатия 4 FASTEST—Качество выходного изображения с коэффициентом сжатия 5	String
includeAccessibilityTags (Чтение / Запись)	Выведите файл PDF с тегами, в котором текст может быть прочитан программами чтения с экрана или другими вспомогательными технологиями. Файл PDF с тегами может включать альтернативный текст - текстовое описание графического элемента, который программа чтения с экрана использует для описания элемента - для фреймов карты, изображений и фреймов диаграммы. Альтернативный текст добавляется на Панель элементов для каждого элемента. Значение по умолчанию равно True.	Boolean
includeNonVisibleMapLayers (Чтение / Запись)	Если установлено значение True, этот параметр гарантирует, что все слои на карте будут включены в экспортируемый файл, включая слои с отключенной видимостью. Статус видимости всех слоев сохраняется в экспортируемом файле. Используйте этот параметр для создания конечных результатов с несколькими представлениями одних и тех же данных. Если этот параметр установлен на False, в экспортируемый файл включаются только видимые слои на карте. Невидимые слои отбрасываются. Значение по умолчанию равно False.	Boolean
layersAndAttributes (Чтение / Запись)	Включите в карту или компоновку слои, которые можно просматривать и обрабатывать в поддерживающихся программах чтения PDF. Кроме того, вы можете включить атрибутивные данные из объектов. Включение атрибутов для большого числа слоев может повлиять на производительность и увеличить объем выходных данных. Значение по умолчанию LAYERS_ONLY	String
outputAsImage (Чтение / Запись)	Экспорт векторного содержимого как изображения. Для карт или компоновок, содержащих векторные слои с высокой плотностью вершин, может значительно уменьшить размер выходного файла. Значение по умолчанию False. Примечание: Параметры, относящиеся к векторным данным, такие как embedFonts, georefInfo и layersAttributes, недоступны, если для outputAsImage установлено значение True.	Boolean
rasterAsSingleTile (Чтение / Запись)	Если установлено True, экспортируйте растровые и растеризованные слои как изображение в виде одного листа, чтобы избежать артефактов в прозрачных слоях в некоторых программах просмотра PDF. Значение по умолчанию False. Примечание: Если не удастся выделить достаточно памяти, процесс экспорта завершится ошибкой. Чтобы уменьшить требования к памяти, установите для rasterAsSingleTile значение False и вместо этого попробуйте уменьшить imageQuality, resolution, или установите значение antialiasing равным None. Значение antialiasing задается в классе DisplayOptions при запуске скриптов вне приложения или на вкладке Отображение в параметрах проекта, если скрипты выполняются внутри приложения.	Boolean
removeLayoutBackground (Чтение / Запись)	При экспорте удаляйте фон страницы в виде графики. Это свойство применяется только при экспорте объекта Layout. Значение по умолчанию равно False.	Boolean
resolution (Чтение / Запись)	Эффективное разрешение dpi выходных векторных данных. Значение, предлагаемое по умолчанию, равно 96. Примечание: При экспорте MapView dpi рассчитывается автоматически с использованием системного масштабирования dpi, поэтому это значение будет проигнорировано.	Integer
showSelectionSymbology (Чтение / Запись)	Отображает выбранные объекты на карте или во фрейме карты, выбранные в выходном файле. Установка этого значения на False не влияет на выбор внутри вида, а только на выбор в выходном файле. Значение по умолчанию равно False.	Boolean
simulateOverprint (Чтение / Запись)	Иногда называемая мягкой пробной печатью, имитация впечатывания показывает, как будут выглядеть перекрывающиеся области краски при печати на странице. Вы можете настроить впечатывание в слоях символов для символов или графики. Применяется только в случае, если цветовая модель установлена на CMYK. Значение по умолчанию равно False. Примечание: Когда вы симулируете впечатывание при экспорте, векторные объекты растеризуются в изображения. Они больше не поддерживаются как отдельные векторные слои в выходном документе PDF. Это приводит к тому, что опции, специфичные для векторных данных, такие как embedFonts, georefInfo и layersAttributes становятся недоступными. Более подробно о впечатывании В результате, если для simulateOverprint задано True, оно игнорирует значение outputAsImage, даже если задано False.	Boolean
width (Чтение / Запись)	Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960.	Double

Методы

setImageCompression(image_compression)

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

Имя	Объяснение	Тип данных
image_compression	Below is a list of valid strings. ADAPTIVE— JPEG and Deflate compression are combined, depending on the contents of the stream. This works well for most cases. DEFLATE— Lossless compression method that works well for most cases. JPEG— Lossy compression method that works well for photographic-type images. JPEG2000— Higher-quality compression with file sizes smaller than JPEG . This compression is lossless if imageQuality is set to 100. LZW—Lempel-Ziv-Welch, a lossless compression method using a code table. NONE—Compression is not applied. RLE— Run-length encoded compression, a lossless compression method that works well if there are large areas of the same color.	String

setImageQuality(image_quality)

Строковая константа, которая задает количество пересчета изображений.

Имя	Объяснение	Тип данных
image_quality	Below is a list of valid strings. BEST—An output image quality resample ratio of 1 BETTER—An output image quality resample ratio of 2 NORMAL—An output image quality resample ratio of 3 FASTER—An output image quality resample ratio of 4 FASTEST—An output image quality resample ratio of 5	String

setLayersAndAttributes(layers_attributes)

Строковая константа, управляющая включением слоя PDF и данных объектов PDF (атрибутов) в файл для экспорта.

Имя	Объяснение	Тип данных
layers_attributes	Below is a list of valid strings. LAYERS_AND_ATTRIBUTES— Export PDF layers only LAYERS_ONLY— Export PDF layers and feature attributes NONE—Do not export any PDF information	String

Пример кода

PDFFormat, пример 1

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

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

pdf = arcpy.mp.CreateExportFormat('PDF', r'C:\Temp\Output.pdf')

lyt.export(pdf)

PDFFormat, пример 2

Следующий скрипт выполняет тот же экспорт, что и в предыдущем пример, но затем настраивает свойства PDFFormat, чтобы создать PDF-файл меньшего размера. Перед повторным экспортом скрипт изменяет исходный выходной filePath, чтобы вы могли сравнить размеры файлов создаваемых PDF-файлов.

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

pdf = arcpy.mp.CreateExportFormat('PDF', r'C:\Temp\PDF_output1.pdf')
lyt.export(pdf)                            #Export using default value

pdf.clipToElements = True                  #Default is False
pdf.embedColorProfile = False              #Default is True
pdf.embedFonts = False                     #Default is True
pdf.georefInfo = False                     #Default is True
pdf.outputAsImage = True                   #Default is False
pdf.imageCompressionQuality = 10           #Default is 80
pdf.resolution = 50                        #Default is 96
pdf.setImageQuality('FASTEST')             #Default os BEST
pdf.setLayersAndAttributes('NONE')         #Default is LAYERS_ONLY
pdf.filePath = r'C:\Temp\PDF_output2.pdf'  #Override filePath from original

lyt.export(pdf)                            #Export to smaller PDF