Étiquette | Explication | Type de données |
Couche en entrée | Couche symbolisée en entrée à partir de laquelle les masques sont créés. | Layer |
Classe d’entités en sortie | Classe d’entités contenant les entités masques. | Feature Class |
Échelle de référence | Échelle de référence à utiliser pour calculer la géométrie de masquage lorsque les masques sont spécifiés en unités de page. Il s’agit en général de l’échelle de référence de la carte. | Double |
Système de coordonnées de calcul | Référence spatiale de la carte dans laquelle les polygones de masquage sont créés. Il ne s’agit pas de la référence spatiale attribuée à la classe d’entités en sortie. Il s’agit de la référence spatiale de la carte dans laquelle les polygones de masquage seront utilisés, étant donné que la position de la symbologie est susceptible de varier lorsque les entités sont projetées. | Spatial Reference |
Marge | Espace en unités de page entourant les entités symbolisées en entrée permettant de créer les polygones de masquage. En général, les polygones de masquage sont créés avec une petite marge autour du symbole afin d’améliorer l’apparence visuelle. Les valeurs de marge peuvent être exprimées en unités de page ou en unités de carte. La marge ne peut pas être négative. | Linear Unit |
Type de masque | Spécifie le type de géométrie de masquage qui sera créé.
| String |
Créer des masques pour les annotations non placées | Spécifie si des masques pour l’annotation non placée seront créés. Ce paramètre ne s’applique que lors du masquage de couches d’annotations de géodatabase.
| String |
Transférer des attributs (Facultatif) | Détermine les attributs qui seront transférés à partir des entités en entrée vers les entités en sortie.
| String |
Préserver les entités de petite taille (Facultatif) | Indique si les entités masques de petite taille sont incluses dans la classe d’entités en sortie.
| Boolean |
Synthèse
Crée des polygones de masquage à une distance donnée, avec une forme entourant les entités symbolisées dans la couche en entrée.
Utilisation
Cet outil accepte les couches d’entités ponctuelles, linéaires et surfaciques, ainsi que les couches d’annotations de géodatabase, comme entrées.
Ajouter des masques aux cartes apporte un surcroît de complexité qui ralentit leur affichage et a une incidence sur leur impression et leur exportation. En général, trois points sont à prendre en compte lors de la création de masques pour une carte : le nombre de masques, la complexité des masques et l’utilisation des masques, à savoir s’ils doivent masquer des entités surfaciques remplies de symboles ponctuels ou linéaires. Tous ces aspects se traduisent par un ralentissement du tracé à l’écran. En outre, les performances d’impression et d’exportation risquent d’être médiocres, voire d’échouer à produire une sortie valide. Ceci est dû au traitement nécessaire pour imprimer et exporter des cartes avec des masques et aux limitations connues sur la manière dont les formats de fichiers graphiques stockent les résultats des exportations des cartes dotées d’un grand nombre de masques complexes.
Afin d’améliorer les performances de dessin, d’impression, d’exportation et de fiabilité, utilisez les masques les plus simples nécessaires à la finalité de la carte. En particulier, lorsque vous utilisez le paramètre Type de masque pour masquer le texte des annotations, l’option Enveloppe convexe suffit à de nombreux objectifs de la carte. Pour les masques de texte plus détaillés, utilisez le type Exact simplifié. Si vous masquez une quantité importante de texte sur une carte relativement grande, évitez d’utiliser l’option Exact, car elle crée un trop grand nombre de masques complexes pour espérer produire des résultats exploitables.
Cet outil filtre les très petites entités de masque de la sortie par défaut. Les masques de petite taille qui ne sont pas nécessairement visibles à l’échelle de référence de la carte sont supprimés pour créer une classe d’entités en sortie gérable et efficace. Si votre processus nécessite des masques de très petite taille, cochez le paramètre Préserver les entités de petite taille afin de préserver tous les masques dans la classe d’entités en sortie quelle que soit leur taille. De nombreux masques de petite taille peuvent ajouter de la complexité à la carte et à la carte en sortie.
Les valeurs de marge sont généralement exprimées en unités de page, mais les unités de carte sont également acceptées.
En règle générale, les marges sont supérieures à 0. Une taille de marge nulle crée des masques qui représentent la forme exacte des entités symbolisées.
Si la couche en entrée est une couche d’annotations, l’échelle de référence sera définie automatiquement sur celle de la classe d’entités de la couche pour garantir la précision du calcul du masque.
Si vous masquez une annotation projetée à la volée, créez des masques à l’aide de la référence spatiale de la carte en la définissant correctement dans le paramètre Système de coordonnées de calcul. La lisibilité est conservée lorsque le texte est projeté à la volée, ce qui explique pourquoi des différences peuvent exister dans la surface spatiale que le texte occupe dans les différentes projections.
Les masques d’entités annotations sont spécifiques à la police. Si vous utilisez des masques avec le texte, assurez-vous que la même police est utilisée à l’écran comme dans la sortie. Pour ce faire, incorporez des polices dans la sortie vectorielle ou téléchargez SoftFonts sur les imprimantes ou les traceurs.
Les masques sont créés selon la rotation actuelle de la carte et peuvent ne pas être valides si la carte est définie sur une rotation différente après la création du masque.
Paramètres
arcpy.cartography.FeatureOutlineMasks(input_layer, output_fc, reference_scale, spatial_reference, margin, method, mask_for_non_placed_anno, {attributes}, {preserve_small_sized_features})
Nom | Explication | Type de données |
input_layer | Couche symbolisée en entrée à partir de laquelle les masques sont créés. | Layer |
output_fc | Classe d’entités contenant les entités masques. | Feature Class |
reference_scale | Échelle de référence à utiliser pour calculer la géométrie de masquage lorsque les masques sont spécifiés en unités de page. Il s’agit en général de l’échelle de référence de la carte. | Double |
spatial_reference | Référence spatiale de la carte dans laquelle les polygones de masquage sont créés. Il ne s’agit pas de la référence spatiale attribuée à la classe d’entités en sortie. Il s’agit de la référence spatiale de la carte dans laquelle les polygones de masquage seront utilisés, étant donné que la position de la symbologie est susceptible de varier lorsque les entités sont projetées. | Spatial Reference |
margin | Espace en unités de page entourant les entités symbolisées en entrée permettant de créer les polygones de masquage. En général, les polygones de masquage sont créés avec une petite marge autour du symbole afin d’améliorer l’apparence visuelle. Les valeurs de marge peuvent être exprimées en unités de page ou en unités de carte. La marge ne peut pas être négative. | Linear Unit |
method | Spécifie le type de géométrie de masquage qui sera créé.
| String |
mask_for_non_placed_anno | Spécifie si des masques pour l’annotation non placée seront créés. Ce paramètre ne s’applique que lors du masquage de couches d’annotations de géodatabase.
| String |
attributes (Facultatif) | Détermine les attributs qui seront transférés à partir des entités en entrée vers les entités en sortie.
| String |
preserve_small_sized_features (Facultatif) | Indique si les entités masques de petite taille sont incluses dans la classe d’entités en sortie.
| Boolean |
Exemple de code
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction FeatureOutlineMasks en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
sr = arcpy.SpatialReference(4326)
arcpy.cartography.FeatureOutlineMasks("C:/data/cartography.gdb/transportation/roads",
"C:/data/cartography.gdb/transportation/fom_polys",
"25000", sr, "5 meters","EXACT_SIMPLIFIED",
"ALL_FEATURES", "ALL")
Ce script autonome montre un exemple d’utilisation de la fonction FeatureOutlineMasks.
# Name: FeatureOutlineMasks_standalone_script.py
# Description: Creates mask polygons at a specified distance and shape
# around symbolized features.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
input_layer = "roads.lyrx"
output_fc = "cartography.gdb/transportation/roads_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)
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?