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

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

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

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

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

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

    Примечание:

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная карта

Имя входной карты.

Map
Масштаб конвертации

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

Double
Конвертировать
(Дополнительный)

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

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

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

Feature Layer
Суффикс слоя графики
(Дополнительный)

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

String
Экстент
(Дополнительный)

Задает экстент, который содержит надписи, конвертируемые в графику.

  • Текущий экстент отображения Вид карты — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты.
  • Нарисовать экстент Закончить прямым углом - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта.
    Примечание:

    Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Параметры среды диалогового окна инструмента.

    Примечание:

    Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент.

  • Экстент слоя Слой — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями.

    У каждого слоя карте есть следующие опции:

    • Все объекты Выбрать все - экстент всех объектов слоя.
    • Выбранные объектыОбласть из выбранных объектов - экстент всех выбранных объектов слоя.
    • Отображаемые объекты Extent Indicator - экстент всех отображаемых объектов слоя.
      Примечание:

      Экстенты опций Выбранные объекты Область из выбранных объектов и Отображаемые объекты Extent Indicator доступны только для векторных слоев.

  • Обзор Обзор — Экстент будет основан на существующем наборе данных.
  • Пересечение входных данных Пересечение — Экстент будет основан на минимальном или пересекающемся экстенте всех входных данных. Если никакие входные данные не перекрываются, получится пустой экстент со всеми нулями.
  • Объединение входных данных Объединить — Экстент будет основан на максимальном или объединенном экстенте всех входных данных.
  • Буфер обмена Вставить - экстент может быть скопирован в буфер обмена и из него.
    • Копировать экстент Копировать - копирует координаты экстента и систему координат в буфер обмена.
    • Вставить экстент Вставить - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты.
    Примечание:

    Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка.

  • Сбросить экстент Сбросить — Экстент будет сброшен до значения по умолчанию.
  • Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты.
    Внимание:

    На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.

Extent
Конвертировать надписи из всех слоев в один слой графики
(Дополнительный)

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

  • Отмечено – подписи из всех слоев будут преобразованы в один слой графики.
  • Не отмечено - подписи будут преобразованы в отдельные слои графики, соответствующие исходным слоям. Это значение по умолчанию.

Boolean
Конвертировать неразмещенные надписи в графику
(Дополнительный)

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

  • Не отмечено – графика будет создаваться только для надписанных объектов. Это значение по умолчанию.
  • Отмечено – неразмещенная графика будет храниться в слое графики, только их видимость будет отключена.

Boolean
Выходной слой
(Дополнительный)

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

Group Layer

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})
ИмяОписаниеТип данных
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)

Параметры среды

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

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

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

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