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

Сводка

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

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

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

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

    Примечание:

    В 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
(Дополнительный)

Задает возможность конвертации в графику всех слоев карты либо одного слоя.

  • ALL_LAYERSПодписи будут конвертированы в графику для всех слоев карты. Это значение по умолчанию.
  • SINGLE_LAYERНадписи будут конвертированы в графику для одного слоя. Слой должен быть указан в параметр Векторный слой (single_layer в Python).
String
single_layer
(Дополнительный)

Слой с конвертируемыми надписями, если задано для параметра which_layers задано значение SINGLE_LAYER. Этот слой должен быть на карте.

Feature Layer
graphics_suffix
(Дополнительный)

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

String
extent
(Дополнительный)

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

  • MAXOF – объединение входных данных
  • MINOF – пересечение входных данных
  • DISPLAY – экстент, как у текущего отображения
  • <Layer> – экстент, как у указанного слоя
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: Да

Связанные разделы