| Etiqueta | Explicación | Tipo de datos |
Capa de entrada | Capa de entrada simbolizada desde la que se crean las máscaras. | Layer |
Clase de entidad de salida | La clase de entidad que contendrá las entidades de máscara. | Feature Class |
Escala de referencia | La escala de referencia que se utilizará para calcular la geometría de máscara cuando las máscaras se especifican en unidades de página. Esto es generalmente la escala de referencia del mapa. | Double |
Sistema de coordenadas del cálculo | La referencia espacial del mapa en el que se crearán los polígonos de máscara. No es la referencia espacial que se asignará a la clase de entidad de salida. Es la referencia espacial del mapa en el que se utilizarán los polígonos de máscara, ya que la posición de la simbología puede cambiar cuando se proyectan las entidades. | Spatial Reference |
Margen | El espacio en unidades de página que rodea a las entidades de entrada simbolizadas utilizadas para crear los polígonos de máscara. Generalmente, los polígonos de máscara se crean con un margen pequeño alrededor del símbolo para mejorar la apariencia visual. Los valores de margen se pueden especificar en unidades de página o en unidades de mapa. El margen no puede ser negativo. | Linear Unit |
Tipo de máscara | Especifica el tipo de geometría de máscara que se va a crear.
| String |
Crear máscaras para anotación no colocada | Especifica si se van a crear máscaras para anotaciones no colocadas. Este parámetro solo se utiliza al crear máscaras de capas de anotación de geodatabase.
| String |
Transferir atributos (Opcional) | Especifica los atributos que se van a transferir desde las entidades de entrada a las entidades de salida.
| String |
Conservar entidades de pequeño tamaño seleccionadas (Opcional) | Especifica si se incluirán pequeñas entidades de máscara en la clase de entidad de salida.
| Boolean |
Resumen
Crea polígonos de máscara con una distancia y forma especificadas alrededor de las entidades simbolizadas en la capa de entrada.
Uso
Esta herramienta acepta como entrada capas de entidades de punto, línea y polígono, así como capas de anotaciones de geodatabase.
Al agregar máscaras a los mapas, se aumenta la complejidad, lo que lentifica el dibujo de los mapas y afecta su impresión y exportación. Generalmente, hay tres factores que se deben tener en cuenta al crear máscaras para un mapa: la cantidad de máscaras, la complejidad de las máscaras y si las máscaras se van a utilizar para enmascarar entidades poligonales rellenas con símbolos de línea o marcador. Todas estas cosas dan como resultado un dibujo más lento en la pantalla. Además, el rendimiento de impresión y exportación puede ser bajo o no producir una salida válida. Esto se debe al procesamiento necesario para imprimir y exportar mapas con máscaras, y las limitaciones conocidas sobre cómo los formatos de archivos gráficos almacenan los resultados de exportación de mapas que tienen muchas máscaras complicadas.
Para mejorar el rendimiento del dibujo, así como el rendimiento y la fiabilidad de la impresión y exportación, use las máscaras más simples necesarias para los propósitos del mapa. En particular, cuando se usa el parámetro Tipo de máscara para enmascarar texto de anotación, la opción de Casco convexo es suficiente para muchos objetivos del mapa. Para máscaras de texto más detalladas, utilice la opción Exacto simplificado. Al crear máscaras con una gran cantidad de texto en un mapa relativamente grande, evite utilizar la opción Exacta, ya que creará demasiadas máscaras complicadas como para producir una salida válida de manera eficaz.
Esta herramienta filtra de forma predeterminada entidades de máscara muy pequeñas desde la salida. Las máscaras pequeñas que pueden no ser visibles en la escala de referencia del mapa se eliminan para crear una clase de entidad de salida manejable y eficiente. Si su flujo de trabajo necesita máscaras muy pequeñas, marque el parámetro Conservar entidades de pequeño tamaño para conservar todas las máscaras en la clase de entidad de salida, independientemente del tamaño. Muchas máscaras pequeñas pueden agregar complejidad al mapa y a su resultado.
Aunque los valores de margen se suelen especificar en unidades de página, también se aceptan unidades de mapa.
Normalmente, los márgenes son superiores a 0. Un tamaño de margen de 0 crea máscaras que representan la forma exacta de las entidades simbolizadas.
Si la capa de entrada es un capa de anotación, la escala de referencia se establecerá automáticamente en la escala de referencia de la clase de entidad de la capa para garantizar un cálculo preciso de la máscara.
Al enmascarar una anotación proyectada al vuelo, cree máscaras utilizando la referencia espacial del mapa al establecerla adecuadamente en el parámetro Sistema de coordenadas del cálculo. La legibilidad se mantiene cuando el texto se proyecta al vuelo, que es la razón por la que pueden existir diferencias en el área espacial que ocupa el texto en distintas proyecciones.
Las máscaras de entidades de anotación son específicas de la fuente. Al utilizar máscaras con texto, asegúrese de utilizar la misma fuente en la pantalla y en la salida. Para ello, integre fuentes en la salida vectorial o descargue SoftFonts para impresoras o graficadores.
Las máscaras se crearán en función de la rotación del mapa actual y es posible que no sean válidas si el mapa se establece en una rotación diferente después de la creación de la máscara.
Parámetros
arcpy.cartography.FeatureOutlineMasks(input_layer, output_fc, reference_scale, spatial_reference, margin, method, mask_for_non_placed_anno, {attributes}, {preserve_small_sized_features})| Nombre | Explicación | Tipo de datos |
input_layer | Capa de entrada simbolizada desde la que se crean las máscaras. | Layer |
output_fc | La clase de entidad que contendrá las entidades de máscara. | Feature Class |
reference_scale | La escala de referencia que se utilizará para calcular la geometría de máscara cuando las máscaras se especifican en unidades de página. Esto es generalmente la escala de referencia del mapa. | Double |
spatial_reference | La referencia espacial del mapa en el que se crearán los polígonos de máscara. No es la referencia espacial que se asignará a la clase de entidad de salida. Es la referencia espacial del mapa en el que se utilizarán los polígonos de máscara, ya que la posición de la simbología puede cambiar cuando se proyectan las entidades. | Spatial Reference |
margin | El espacio en unidades de página que rodea a las entidades de entrada simbolizadas utilizadas para crear los polígonos de máscara. Generalmente, los polígonos de máscara se crean con un margen pequeño alrededor del símbolo para mejorar la apariencia visual. Los valores de margen se pueden especificar en unidades de página o en unidades de mapa. El margen no puede ser negativo. | Linear Unit |
method | Especifica el tipo de geometría de máscara que se va a crear.
| String |
mask_for_non_placed_anno | Especifica si se van a crear máscaras para anotaciones no colocadas. Este parámetro solo se utiliza al crear máscaras de capas de anotación de geodatabase.
| String |
attributes (Opcional) | Especifica los atributos que se van a transferir desde las entidades de entrada a las entidades de salida.
| String |
preserve_small_sized_features (Opcional) | Especifica si se incluirán pequeñas entidades de máscara en la clase de entidad de salida.
| Boolean |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función FeatureOutlineMasks de modo inmediato.
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")Esta secuencia de comandos independiente muestra un ejemplo de uso de la función 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)Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí