Сводка
Конвертирует надписи в графику для одного слоя или всей карты.
Использование
Надписи можно конвертировать в графику для одного слоя или для целой карты. Если выбрана конвертация для одного слоя, этот слой должен быть указан и должен находиться на карте.
Поддерживаются диапазоны масштабов класса надписей. Когда инструмент создает графику для определенного масштаба карты, конвертируются только классы надписей, которые включены и видимы в данном масштабе.
Примечание:
В ArcGIS Pro диапазоны масштабов классов надписей устанавливаются на вкладке Надписи.
Формат присвоения имен графическим слоям будет следующим <layer name><graphics layer suffix>.
Повторяющиеся имена графических слоев не будут перезаписаны.
Выходными данными для этого инструмента является составной слой. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании инструмента в ArcGIS Pro, инструмент добавляет составной слой на экран. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если проект не будет сохранен.
Существующий составной слой будет перезаписан, если будет указано такое же имя слоя и в опциях геообработки будет отмечена опция Разрешить инструментам геообработки перезаписывать существующие наборы данных.
Можно использовать параметр Конвертировать надписи из всех слоев в один выходной графический слой, чтобы создать один слой графики для всей карты.
Некоторые надписи могут не отображаться на карте, т.к. для них не хватает места. Поставьте отметку для параметр Конвертировать неразмещенные надписи в графику, чтобы сохранить неразмещенные надписи в графический слой, это позволит позднее сделать их видимыми и разместить надлежащим образом.
Синтаксис
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 (Дополнительный) | Задает возможность конвертации в графику всех слоев карты либо одного слоя.
| String |
single_layer (Дополнительный) | Слой с конвертируемыми надписями, если задано для параметра which_layers задано значение SINGLE_LAYER. Этот слой должен быть на карте. | Feature Layer |
graphics_suffix (Дополнительный) | Суффикс, который добавляется к каждому слою графики. Суффикс будет добавлен к имени исходного класса пространственных объектов для каждого нового слоя графики. | String |
extent (Дополнительный) | Задает экстент, который содержит надписи, конвертируемые в графику. Это может быть экстент карты, объединения входных слоев, пересечения входных слоев, текущий экстент изображения, такой же, как у указанного слоя, или его можно задать значениями.
| Extent |
multiple_graphics_layers (Дополнительный) | Определяет, будут ли конвертированы подписи в отдельные слой графики либо в один такой слой.
| Boolean |
generate_unplaced (Дополнительный) | Указывает, будет ли создаваться графика из неразмещенных надписей.
| Boolean |
output_group_layer (Дополнительный) | Составной слой, содержащий созданные графические объекты. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. | Group Layer |
Пример кода
Пример Python для функции ConvertLabelsToGraphics, которая конвертирует надписи в графику для одного слоя карты.
import arcpy
arcpy.cartography.ConvertLabelsToGraphics(
'Map1', 10000, 'SINGLE_LAYER', 'Schools', 'Graphics', 'MAXOF',
'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED', 'GroupGraphics')
Автономный скрипт, который конвертирует надписи в графику для карты при помощи функции 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: Да