Zusammenfassung
Erstellt Maskierungs-Polygone mit einem festgelegten Abstand und der angegebenen Form um die symbolisierten Features im Eingabe-Layer.
Verwendung
Dieses Werkzeug akzeptiert Punkt-, Linien- und Polygon-Feature-Layer sowie Geodatabase-Annotations-Layer als Eingabe.
Beim Erstellen von Maskierungen sollten Sie beachten, dass durch das Hinzufügen von Maskierungen die Komplexität von Karten zunimmt, wodurch Darstellung, Druck und Export der Karten verlangsamt werden. Im Allgemeinen sollten Sie beim Erstellen von Maskierungen für Karten drei Punkte berücksichtigen: 1) Die Anzahl der Maskierungen, 2) die Komplexität der Maskierungen und 3) ob die Maskierungen zum Maskieren von Polygon-Features verwendet werden, die mit Linien- oder Markersymbolen gefüllt sind. Wenn die Anzahl oder Komplexität der Maskierungen zunimmt und/oder Markersymbole oder Polygon-Schraffuren maskiert werden, verlangsamt dies die Darstellung auf dem Bildschirm. Darüber hinaus kann es zu einer verminderten Performance bei Druck- und Exportvorgängen oder sogar zu ungültigen Ausgaben kommen. Dies liegt zum einen am großen Verarbeitungsaufwand beim Drucken und Exportieren von Karten mit Maskierungen und zum anderen daran, dass Grafikdateiformate exportierte Karten mit vielen komplizierten Maskierungen nur mit Einschränkungen speichern können.
Zur Gewährleistung einer optimalen und zuverlässigen Darstellungs- sowie Druck- und Export-Performance sollten Sie als wichtigste Grundregel immer die einfachsten Maskierungen verwenden, die für den Verwendungszweck der Karte möglich sind. Insbesondere für Annotationstext sind Maskierungen vom Typ "CONVEX_HULL" für viele Kartenverwendungszwecke ausreichend. Wenn Sie detailliertere Textmasken benötigen, verwenden Sie den Maskierungstyp "EXACT_SIMPLIFIED". Im Allgemeinen sollten Sie für das Maskieren großer Textmengen auf relativ großen Karten auf den Maskierungstyp "EXACT" verzichten, da zu viele komplizierte Maskierungen angelegt werden, um gültige Ausgaben effizient zu erstellen.
Die Werte für Ränder werden in der Regel in Seiteneinheiten angegeben, Karteneinheiten werden jedoch auch akzeptiert.
Ränder sind in der Regel größer als 0. Bei einer Randgröße von 0 werden Masken erstellt, die die genaue Form der symbolisierten Features darstellen. Ein negativer Randwert erstellt Masken, die kleiner als die symbolisierten Features sind.
Wenn der Eingabe-Layer ein Annotation-Layer ist, wird der Bezugsmaßstab automatisch auf den Bezugsmaßstab der Feature-Class des Layers eingestellt, um eine genaue Berechnung der Maskierung sicherzustellen.
Beim Maskieren on-the-fly projizierter Annotationen sollten Maskierungen mit dem Raumbezug der Karte erstellt werden, indem der Raumbezug über den entsprechenden Parameter genau festgelegt wird. Die Lesbarkeit bleibt erhalten, wenn Text "on the fly" projiziert wird. Aus diesem Grund kann Text bei unterschiedlichen Projektionen unterschiedliche räumliche Bereiche belegen.
Bei Maskierungen von Annotations-Features wird die Schriftart beachtet. Beim Maskieren von Text müssen Sie unbedingt sicherstellen, dass auf dem Bildschirm dieselbe Schriftart verwendet wird wie in der Ausgabe. Dazu betten Sie Schriftarten in Vektorausgabe ein oder laden SoftFonts auf Drucker oder Plotter herunter.
Syntax
FeatureOutlineMasks_cartography (input_layer, output_fc, reference_scale, spatial_reference, margin, method, mask_for_non_placed_anno, {attributes})
Parameter | Erläuterung | Datentyp |
input_layer | Der symbolisierte Eingabe-Layer, aus dem die Maskierungen erstellt werden. | Layer |
output_fc | Die Feature-Class, die die Maskierungs-Features enthalten wird. | Feature Class |
reference_scale | Der Bezugsmaßstab für die Berechnung der Maskierungsgeometrie, wenn Maskierungen in Seiteneinheiten angegeben sind. Dies ist in der Regel der Bezugsmaßstab der Karte. | Double |
spatial_reference | Der Raumbezug, für den die Maskierungs-Polygone erstellt werden. Dies ist nicht der Raumbezug, der der Ausgabe-Feature-Class zugewiesen wird. Es ist der Raumbezug der Karte, in der die Maskierungs-Polygone verwendet werden, da sich die Position der Symbole beim Projizieren der Features ändern kann. | Spatial Reference |
margin | Der in Seiteneinheiten angegebene Bereich um die symbolisierten Eingabe-Features, die zum Erstellen des Maskierungs-Polygons verwendet werden. Maskierungs-Polygone werden in der Regel mit einem kleinen Rand um das Symbol erstellt, um das Erscheinungsbild zu verbessern. Die Werte für Ränder werden in Seiten- oder Karteneinheiten angegeben. In der Regel werden Sie die Werte für den Randabstand in Seiteneinheiten angeben. | Linear Unit |
method | Der Typ der erstellten Maskierungsgeometrie. Es gibt vier mögliche Typen:
| String |
mask_for_non_placed_anno | Gibt an, ob Maskierungen für nicht platzierte Annotationen erstellt werden sollen. Diese Option wird nur beim Maskieren von Geodatabase-Annotations-Layern verwendet.
| String |
attributes (optional) | Legt fest, welche Attribute von den Eingabe-Features auf die Ausgabe-Features übertragen werden.
| String |
Codebeispiel
Werkzeug "FeatureOutlineMasks" – Beispiel (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug "FeatureOutlineMasks" im unmittelbaren Modus verwenden.
import arcpy
from arcpy import env
env.workspace = "C:/data"
sr = arcpy.SpatialReference(4326)
arcpy.FeatureOutlineMasks_cartography("C:/data/cartography.gdb/transportation/roads",
"C:/data/cartography.gdb/transportation/fom_polys",
"25000", sr, "5 meters","EXACT_SIMPLIFIED", "ALL_FEATURES", "ALL")
Werkzeug "FeatureOutlineMasks" – Beispiel (eigenständiges Python-Skript)
Dieses eigenständige Skript stellt ein Beispiel für die Verwendung des Werkzeugs "FeatureOutlineMasks" dar.
# Name: FeatureOutlineMasks_standalone_script.py
# Description: Creates mask polygons at a specified distance and shape
# around symbolized features.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
input_layer = "C:/data/roads.lyr"
output_fc = "C:/data/cartography.gdb/transportation/fom_polys"
reference_scale = "25000"
spatial_reference = arcpy.SpatialReference(4326)
margin = "5 meters"
method = "EXACT_SIMPLIFIED"
mask_for_non_placed_anno = "ONLY_PLACED"
attributes = "ALL"
# Execute Feature Outline Masks
arcpy.FeatureOutlineMasks_cartography(input_layer,
output_fc,
reference_scale,
spatial_reference,
margin, method,
mask_for_non_placed_anno,
attributes)
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Nein
- ArcGIS Desktop Standard: Nein
- ArcGIS Desktop Advanced: Ja