Конвертировать надписи в графику (Картография)

Сводка

Конвертирует надписи в графику для одного слоя или всей карты.

Использование

• Надписи можно конвертировать в графику для одного слоя или для целой карты. Если выбрана конвертация для одного слоя, этот слой должен быть указан и должен находиться на карте.

• Поддерживаются диапазоны масштабов класса надписей. Когда инструмент создает графику для определенного масштаба карты, конвертируются только классы надписей, которые включены и видимы в данном масштабе.

  Примечание:

  В ArcGIS Pro диапазоны масштабов классов надписей устанавливаются на вкладке Надписи.

• Формат присвоения имен графическим слоям будет следующим <layer name><graphics layer suffix>.

  Повторяющиеся имена графических слоев не будут перезаписаны.

• Выходными данными для этого инструмента является составной слой. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании инструмента в ArcGIS Pro, инструмент добавляет составной слой на экран. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если проект не будет сохранен.

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

• Можно использовать параметр Конвертировать надписи из всех слоев в один выходной графический слой, чтобы создать один слой графики для всей карты.

• Некоторые надписи могут не отображаться на карте, т.к. для них не хватает места. Поставьте отметку для параметр Конвертировать неразмещенные надписи в графику, чтобы сохранить неразмещенные надписи в графический слой, это позволит позднее сделать их видимыми и разместить надлежащим образом.

Синтаксис

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})

Parameter	Объяснение	Тип данных
input_map	Входной объект карты.	Map
conversion_scale	Масштаб, для которого конвертируются надписи. Если на карте задан базовый масштаб, он будет использоваться для изменения размеров символов и создания слоя графики, и конвертация будет происходить в этом масштабе.	Double
which_layers (Дополнительный)	Задает возможность конвертации в графику всех слоев карты либо одного слоя. ALL_LAYERS —Подписи будут конвертированы в графику для всех слоев карты. Это значение по умолчанию. SINGLE_LAYER —Надписи будут конвертированы в графику для одного слоя. Слой должен быть указан в параметр Векторный слой (single_layer в Python).	String
single_layer (Дополнительный)	Слой с конвертируемыми надписями, если задано для параметра which_layers задано значение SINGLE_LAYER. Этот слой должен быть на карте.	Feature Layer
graphics_suffix (Дополнительный)	Суффикс, который добавляется к каждому слою графики. Суффикс будет добавлен к имени исходного класса пространственных объектов для каждого нового слоя графики.	String
extent (Дополнительный)	Задает экстент, который содержит надписи, конвертируемые в графику. MAXOF - будет использоваться максимальный экстент всех входных данных. MINOF - будет использоваться минимальная область, общая для всех входных данных. DISPLAY– экстент будет равен видимому отображению. Имя слоя - будет использоваться тот же экстент, что и в указанном слое. Объект Extent - будет использоваться тот же экстент, что и в указанном объекте. Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.	Extent
multiple_graphics_layers (Дополнительный)	Определяет, будут ли конвертированы подписи в отдельные слой графики либо в один такой слой. SINGLE_GRAPHICS_LAYER —Подписи из всех слоев будут преобразованы в один слой графики. GRAPHICS_LAYER_PER_FEATURE_LAYER —Подписи будут преобразованы в отдельные слои графики, соответствующие исходным слоям. Это значение по умолчанию.	Boolean
generate_unplaced (Дополнительный)	Указывает, будет ли создаваться графика из неразмещенных надписей. ONLY_PLACED —Графика будет создаваться только для надписанных объектов. Это значение по умолчанию. GENERATE_UNPLACED —Неразмещенная графика будет храниться в слое графики, только их видимость будет отключена.	Boolean
output_group_layer (Дополнительный)	Составной слой, содержащий созданные графические объекты. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя.	Group Layer

Пример кода

ConvertLabelsToGraphics пример (окно Python)

Пример Python для функции ConvertLabelsToGraphics, которая конвертирует надписи в графику для одного слоя карты.

import arcpy
arcpy.cartography.ConvertLabelsToGraphics(
    'Map1', 10000, 'SINGLE_LAYER', 'Schools', 'Graphics', 'MAXOF', 
    'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED', 'GroupGraphics')

ConvertLabelsToGraphics пример 2 (автономный скрипт)

Автономный скрипт, который конвертирует надписи в графику для карты при помощи функции ConvertLabelsToGraphics.

# Name: ConvertLabelsToGraphics.py
# Description: Find all the maps in the project and
#              convert labels to graphics for each map
# import system modules
import arcpy
# Loop through the project, find all the maps, and
#   convert labels to graphics for each map,
#   using the name of the map as part of the graphics layer suffix 
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to graphics for: " + mp.name)
    arcpy.cartography.ConvertLabelsToGraphics(
            mp, 10000, 'ALL_LAYERS', '', 'Graphics_' + mp.name, 'MAXOF', 
            'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED',  
            'GraphicsLayers_' + mp.name)

Environments

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да