Beschriftungen in Grafik konvertieren (Cartography)

Zusammenfassung

Konvertiert Beschriftungen in Grafiken für einen einzelnen Layer oder eine gesamte Karte.

Verwendung

• Beschriftungen können für einen einzelnen Layer oder die gesamte Karte in Grafiken konvertiert werden. Findet die Konvertierung für einen einzelnen Layer statt, muss er angegeben werden und sich in der Karte befinden.

• Die Maßstabsbereiche der Beschriftungsklassen werden berücksichtigt. Wenn das Werkzeug Grafiken für einen bestimmten Kartenmaßstab generiert, konvertiert es nur die Beschriftungsklassen, die aktiviert und bei diesem Maßstab sichtbar sind.

  Hinweis:

  Die Maßstabsbereiche der Beschriftungsklasse werden auf der Registerkarte Beschriftung in ArcGIS Pro festgelegt.

• Das Format für die Namen der Grafik-Layer lautet <layer name><graphics layer suffix>.

  Doppelt vorhandene Grafik-Layer-Namen werden nicht überschrieben.

• Eine Ausgabe dieses Werkzeugs ist ein Gruppen-Layer. Sie können den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern. Bei der Verwendung in ArcGIS Pro fügt das Werkzeug den Gruppen-Layer der Anzeige hinzu. Der erstellte Gruppen-Layer ist temporär und nur für die Dauer der Sitzung vorhanden, es sei denn, das Projekt wird gespeichert.

• Ein vorhandener Gruppen-Layer wird überschrieben, wenn derselbe Layer-Name angegeben wurde und die Option Geoverarbeitungswerkzeugen das Überschreiben vorhandener Datasets erlauben in den Geoverarbeitungsoptionen aktiviert ist.

• Der Parameter Beschriftungen aller Layer in einen einzigen Ausgabe-Grafik-Layer konvertieren kann zum Erstellen eines Grafik-Layers für die gesamte Karte verwendet werden.

• Möglicherweise werden einige Beschriftungen nicht auf der Karte angezeigt, da kein Platz für sie vorhanden ist. Aktivieren Sie das Kontrollkästchen Nicht platzierte Beschriftungen in Grafik konvertieren, um die nicht platzierten Beschriftungen im Grafik-Layer zu speichern, sodass Sie diese später sichtbar machen und positionieren können.

Syntax

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

Parameter	Erklärung	Datentyp
input_map	Das Eingabekartenobjekt.	Map
conversion_scale	Der Maßstab, mit dem Beschriftungen konvertiert werden. Wenn ein Bezugsmaßstab für die Karte festgelegt ist, wird der Bezugsmaßstab zum Festlegen der Symbolgröße und zum Erstellen des Grafik-Layers verwendet, die Konvertierung erfolgt jedoch mit diesem Maßstab.	Double
which_layers (optional)	Gibt an, ob die Grafik für alle Layer in der Karte oder für einen einzelnen Layer konvertiert werden soll. ALL_LAYERS —Beschriftungen werden für alle Layer in der Karte in eine Grafik konvertiert. Dies ist die Standardeinstellung. SINGLE_LAYER —Beschriftungen werden für einen einzelnen Layer in eine Grafik konvertiert. Der Layer muss im Parameter Feature-Layer (single_layer in Python) angegeben werden.	String
single_layer (optional)	Der Layer mit den Beschriftungen, die konvertiert werden sollen, wenn der Parameter which_layers auf SINGLE_LAYER festgelegt ist. Dieser Layer muss sich in der Karte befinden.	Feature Layer
graphics_suffix (optional)	Das Suffix, das jedem neuen Grafik-Layer hinzugefügt werden soll. Dieses Suffix wird für jeden neuen Grafik-Layer an den Namen der Quell-Feature-Class angehängt.	String
extent (optional)	Gibt die Ausdehnung mit den Beschriftungen an, die in Grafiken konvertiert werden sollen. Dies kann die Ausdehnung der Karte, die Vereinigungsmenge der Eingabe-Layer, die Schnittmenge der Eingabe-Layer, die aktuelle Anzeigeausdehnung, dieselbe Ausdehnung wie die angegebene Layer-Ausdehnung sein; oder die Angabe kann durch einen Wert erfolgen. MAXOF: Vereinigungsmenge der Eingaben MINOF: Schnittmenge der Eingaben DISPLAY: Gleiche Ausdehnung wie die aktuelle Anzeige <Layer>: Gleiche Ausdehnung wie der angegebene Layer	Extent
multiple_graphics_layers (optional)	Gibt an, ob die Beschriftungen in einzelne Grafik-Layer oder nur in einen einzigen Grafik-Layer konvertiert werden sollen. SINGLE_GRAPHICS_LAYER —Beschriftungen aller Layer werden in einen einzigen Grafik-Layer konvertiert. GRAPHICS_LAYER_PER_FEATURE_LAYER —Beschriftungen werden in einzelne Grafik-Layer konvertiert, die dem jeweiligen Layer entsprechen. Dies ist die Standardeinstellung.	Boolean
generate_unplaced (optional)	Gibt an, ob aus nicht platzierten Beschriftungen Grafiken erstellt werden sollen. ONLY_PLACED —Grafiken werden nur für Features erstellt, die derzeit beschriftet sind. Dies ist die Standardeinstellung. GENERATE_UNPLACED —Nicht platzierte Grafiken werden mit deaktivierter Sichtbarkeit im Grafik-Layer gespeichert.	Boolean
output_group_layer (optional)	Der Gruppen-Layer, der die erstellten Grafiken enthält. Sie können den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern.	Group Layer

Codebeispiel

ConvertLabelsToGraphics – Beispiel (Python-Fenster)

Python-Beispiel für die ConvertLabelsToGraphics-Funktion, die Beschriftungen in Grafiken für einen einzelnen Layer konvertiert.

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

ConvertLabelsToGraphics – Beispiel 2 (eigenständiges Skript)

Eigenständiges Skript, das Beschriftungen mithilfe der Funktion ConvertLabelsToGraphics in Grafiken für die Karte konvertiert.

# 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)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja