Convert Labels To Graphics (Cartography)

ArcGIS Pro 3.4 | | Help archive

Summary

Converts labels to graphics for a single layer or an entire map.

Usage

  • Labels can be converted to graphics for a single layer or the entire map. If the single layer option is chosen, the layer must be specified and it must be in the map.

  • Label class scale ranges are respected. When the tool generates graphics for a specific map scale, it will only convert label classes that are turned on and visible at that scale.

    Note:

    Label class scale ranges are set on the Labeling tab in ArcGIS Pro.

  • The format for the naming of the graphics layers is <layer name><graphics layer suffix>.

    Duplicate graphics layer names will not be overwritten.

  • One output of this tool is a group layer. You can use the Save To Layer File tool to write the output group layer to a layer file. When using the tool in ArcGIS Pro, the tool adds the group layer to the display. The group layer that is created is temporary and will not persist after the session ends unless the project is saved.

  • An existing group layer will be overwritten if the same layer name is specified and the Allow geoprocessing tools to overwrite existing datasets option is checked in the geoprocessing options.

  • The Convert labels from all layers to a single output graphics layer parameter can be used to create a single graphics layer for the entire map.

  • Some labels may not display on the map because there is no room. Check the Convert unplaced labels to graphics parameter check box to save the unplaced labels in the graphics layer, allowing you to make them visible and position them later.

Parameters

LabelExplanationData Type
Input Map

The input map name.

Map
Conversion Scale

The scale at which to convert labels. If a reference scale is set on the map, the reference scale will be used for symbol sizing and graphics layer creation, but conversion will happen at this scale.

Double
Convert
(Optional)

Specifies whether to convert graphics for all layers in the map or for a single layer.

  • All layers in mapLabels will be converted to graphics for all layers in the map. This is the default.
  • Single layerLabels will be converted to graphics for a single layer. The layer must be specified with the Feature Layer parameter.
String
Feature Layer
(Optional)

The layer with the labels to convert when the Convert parameter is set to Single layer. This layer must be in the map.

Feature Layer
Graphics Layer Suffix
(Optional)

The suffix that will be added to each new graphics layer. This suffix will be appended to the name of the source feature class for each new graphics layer.

String
Extent
(Optional)

Specifies the extent that contains the labels to convert to graphics.

  • Current Display Extent Map View—The extent will be based on the active map or scene.
  • Draw Extent Square and Finish—The extent will be based on a rectangle drawn on the map or scene.
  • Extent of a Layer Layer—The extent will be based on an active map layer. Choose an available layer or use the Extent of data in all layers option. Each map layer has the following options:

    • All Features Select All—The extent of all features.
    • Selected Features Area from Selected Features—The extent of the selected features.
    • Visible Features Extent Indicator—The extent of visible features.

  • Browse Browse—The extent will be based on a dataset.
  • Intersection of Inputs Intersect—The extent will be the intersecting extent of all inputs.
  • Union of Inputs Union—The extent will be the combined extent of all inputs.
  • Clipboard Paste—The extent can be copied to and from the clipboard.
    • Copy Extent Copy—Copies the extent and coordinate system to the clipboard.
    • Paste Extent Paste—Pastes the extent and coordinate system from the clipboard. If the clipboard does not include a coordinate system, the extent will use the map’s coordinate system.
  • Reset Extent Reset—The extent will be reset to the default value.

When coordinates are manually provided, the coordinates must be numeric values and in the active map's coordinate system. The map may use different display units than the provided coordinates. Use a negative value sign for south and west coordinates.

Extent
Convert labels from all layers to a single output graphics layer
(Optional)

Specifies whether labels will be converted to individual graphics layers or to a single graphics layer.

  • Checked—Labels from all layers will be converted to a single graphics layer.
  • Unchecked—Labels will be converted to individual graphics layers that correspond to their layers. This is the default.

Boolean
Convert unplaced labels to graphics
(Optional)

Specifies whether graphics will be created from unplaced labels.

  • Unchecked—Graphics will only be created for features that are currently labeled. This is the default.
  • Checked—Unplaced graphics are stored in the graphics layer with their visibility is turned off.

Boolean
Output Layer
(Optional)

The group layer that will contain the generated graphics. When working in the Catalog pane, you can use the Save To Layer File tool to write the output group layer to a layer file. When using ArcGIS Pro with a map open, the tool adds the group layer to the display if the Add output dataset to an open map option is checked in the geoprocessing options. The group layer that is created is temporary and will not persist after the session ends unless the project is saved.

Group Layer

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics