setImageQuality

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

Объект SVGFormat представляет собой набор свойств файла масштабируемой векторной графики (SVG), которые можно настраивать и использовать с методом export на объектах Layout, MapFrame и MapView для создания выходного файла SVG или SVGZ.

Обсуждение

SVG – это формат файлов на базе XML, специально разработанный для просмотра веб-страниц. SVG могут содержать как векторную, так и растровую информацию. Некоторые браузеры могут потребовать встраиваемую функцию, чтобы просматривать SVG-файлы, а в старых версиях браузеров может вообще отсутствовать поддержка SVG-файлов. SVG поддерживает встраивание шрифтов. Вы также можете выбрать создание сжатых файлов SVG, задав для свойства compressToSVGZ значение True. Расширение у файла изменится на *.svgz.

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

Синтаксис

setImageQuality()

Свойства

Имя	Объяснение	Тип данных
clipToElements (Чтение / Запись)	Если установлено True, включите части страницы с содержанием только элементов компоновки или карты, а не всю страницу целиком. Это свойство применяется только при экспорте объекта Layout. Значение по умолчанию равно False.	Boolean
compressToSVGZ (Чтение / Запись)	Если установлено значение True, файл сжимается, а расширение должно быть установлено на *.svgz. Значение по умолчанию равно False.	Boolean
convertMarkers (Чтение / Запись)	Определяет, будут ли маркерные символы, основанные на символах шрифта, экспортироваться как символы шрифта или как полигоны. Установите эту опцию на True, чтобы просматривать выходные данные на компьютере, где не установлены соответствующие шрифты, а из-за ограничений лицензии или формата файла нет возможности встроить шрифты в файл. Не применяется к тексту, только к символам-маркерам основанным на шрифтах. Значение по умолчанию равно False.	Boolean
embedFonts (Чтение / Запись)	Включите в экспортируемый файл встраиваемые шрифты, чтобы поддерживать согласованность шрифтов на разных платформах. Шрифты, которые не поддерживают встраивание, не будут включены, независимо от данной настройки. Значение по умолчанию равно True. Примечание: Чтобы правильно редактировать текст в виде графики Illustrator необходим, чтобы шрифты были установлены и доступны. Проверьте разрешения на общий доступ перед вставкой и публикацией шрифтов. Для символов или лигатур с большим диапазоном следует использовать встраивание шрифта, чтобы обеспечить правильную адресацию этих символов с большим диапазоном. В случае, когда шрифт с большим диапазоном символов или лигатур не может быть встроен, отметьте свойство Отрисовать глифы как геометрическое для текстового символа.	Boolean
filePath (Чтение / Запись)	Строка, представляющая системный путь и имя файла, включая расширение, для экспортируемого файла.	String
height (Чтение / Запись)	Высота экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960.	Double
imageQuality (Чтение / Запись)	Качество пересчета изображений. Свойство определяет эффективное разрешение растрового содержания выходных данных. Например, если imageQuality установлено на BETTER, коэффициент сжатия - 1:2, а выходное разрешение resolution имеет значение 300 dpi, то выходной растр будет иметь разрешение 150 dpi. Во многих случаях растровые данные могут быть включены в экспорт с более низким разрешением dpi, чем векторные данные, что не отразится заметно на их качестве, но приведет к уменьшению размера выходного файла. Значение по умолчанию равно BEST. BEST—Качество выходного изображения с коэффициентом сжатия 1 BETTER—Качество выходного изображения с коэффициентом сжатия 2 NORMAL—Качество выходного изображения с коэффициентом сжатия 3 FASTER—Качество выходного изображения с коэффициентом сжатия 4 FASTEST—Качество выходного изображения с коэффициентом сжатия 5	String
includeNonVisibleMapLayers (Чтение / Запись)	Если установлено значение True, этот параметр гарантирует, что все слои на карте будут включены в экспортируемый файл, включая слои с отключенной видимостью. Статус видимости всех слоев сохраняется в экспортируемом файле. Используйте этот параметр для создания конечных результатов с несколькими представлениями одних и тех же данных. Если этот параметр установлен на False, в экспортируемый файл включаются только видимые слои на карте. Невидимые слои отбрасываются. Значение по умолчанию равно False.	Boolean
outputAsImage (Чтение / Запись)	Экспорт векторного содержимого как изображения. Для карт или компоновок, содержащих векторные слои с высокой плотностью вершин, может значительно уменьшить размер выходного файла. Значение по умолчанию False. Примечание: Параметры, относящиеся к векторным данным, такие как embedFonts недоступны, если для outputAsImage установлено значение True.	Boolean
rasterAsSingleTile (Чтение / Запись)	Если установлено True, экспортируйте растровые и растеризованные слои как изображение в виде одного листа, чтобы избежать артефактов в прозрачных слоях в некоторых программах просмотра PDF. Значение по умолчанию False. Примечание: Если не удастся выделить достаточно памяти, процесс экспорта завершится ошибкой. Чтобы уменьшить требования к памяти, установите для rasterAsSingleTile значение False, а вместо этого попробуйте уменьшить imageQuality, resolution, или установите значение antialiasing равным None. Значение antialiasing задается в классе DisplayOptions при запуске скриптов вне приложения или на вкладке Отображение в Параметрах проекта, если скрипты выполняются внутри приложения.	Boolean
resolution (Чтение / Запись)	Эффективное разрешение dpi выходных векторных данных. Значение, предлагаемое по умолчанию, равно 96. Примечание: При экспорте MapView dpi рассчитывается автоматически с использованием системного масштабирования dpi, поэтому это значение будет проигнорировано.	Integer
showSelectionSymbology (Чтение / Запись)	Отображает выбранные объекты на карте или во фрейме карты, выбранные в выходном файле. Установка этого значения на False не влияет на выбор внутри вида, а только на выбор в выходном файле. Значение по умолчанию равно False.	Boolean
width (Чтение / Запись)	Ширина экспортируемой области карты в пикселях. Это свойство применяется только при экспорте объекта MapView. Значение по умолчанию равно 960.	Double

Методы

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

Пример кода

Пример 1 SVGFormat

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

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

svg = arcpy.mp.CreateExportFormat('SVG', r'C:\Temp\Output.svg')

lyt.export(svg)

Пример 2 SVGFormat

Следующий скрипт экспортирует компоновку в сжатый формат SVG, задав для свойства compressToSVGZ значение True.

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

svg = arcpy.mp.CreateExportFormat('SVG', r'C:\Temp\Output.svgz')
svg.compressToSVGZ = True  #Change from default value of False

lyt.export(svg)