Resumen
Exporta capas de entidades con propiedades de visualización en 3D a líneas 3D o a entidades multiparche.
Uso
Las capas de entidades con simbología que tenga las propiedades siguientes se exportarán a un multiparche:
- Configuración de extrusión o de altura base.
- Símbolos de marcador de caracteres con profundidad.
- Símbolos de marcador de modelo 3D cuyo tamaño se denote en unidades lineales reales, tales como pies, pulgadas, metros o centímetros.
- Toda la simbología de línea.
- Toda la simbología de polígono. Si se proporciona una capa de polígono sin ninguna propiedad de visualización 3D, se exportará a un multiparche parecido al polígono.
Las capas desplegadas no se admiten en ArcGlobe. Dada la naturaleza dinámica de las superficies desplegadas, no se mantendrán los valores de altura.
No se admiten símbolos de relleno con textura. Si una entidad de la capa utiliza símbolos de marcador 3D con propiedades restringidas, como texturas, la entidad no se agregará a la salida.
Esta herramienta no admite entidades simbolizadas con cualquiera de las propiedades siguientes:
- Símbolos de marcador de forma que proceden de un archivo del disco.
- Capas rasterizadas que se despliegan en la superficie de la escena.
- Símbolos de marcador de forma que proceden de una fuente pero que no tienen una propiedad de profundidad.
- Los símbolos de marcador 3D cuyo tamaño no se especifique en unidades lineales reales, tales como pies, pulgadas, metros o centímetros.
- Todos los símbolos de marcador que se muestran en carteles. La posición de estos símbolos 2D se orientan dinámicamente frente a la posición de la cámara en una escena 3D, por lo que no tienen una orientación fija que se pueda utilizar para la exportación.
La configuración del entorno para la tolerancia XYZ y la resolución solo se admiten cuando la salida es una entidad de línea.
Sintaxis
arcpy.ddd.Layer3DToFeatureClass(in_feature_layer, out_feature_class, {group_field})
Parámetro | Explicación | Tipo de datos |
in_feature_layer | Capa de entidad de entrada que tiene definidas propiedades de visualización en 3D. | Feature Layer |
out_feature_class | La clase de entidad de salida con entidades 3D. Los puntos extruidos se exportarán como líneas 3D. Los puntos con símbolos 3D, líneas extruidas y polígonos se exportarán como entidades multiparche. | Feature Class |
group_field (Opcional) | Campo de texto de la entidad de entrada que se utilizará para fundir varias entidades de entrada en la misma entidad de salida. Los atributos restantes de la salida resultante se heredarán de uno de los registros de entrada. | Field |
Muestra de código
Ejemplo 1 de Layer3DToFeatureClass (ventana de Python)
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Layer3DToFeatureClass_3d("Points_3D.lyr", "Test.gdb/trees")
Ejemplo 2 de Layer3DToFeatureClass (secuencia de comandos independiente)
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''****************************************************************************
Name: Layer3DToFeatureClass Example
Description: This script demonstrates how to use the
Layer3DToFeatureClass tool to create multipatches from all
layers in a target workspace. The layer files are assumed to have
been saved wtih 3D rendering from ArcScene.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Use the ListFiles method to identify all layer files in workspace
if arcpy.ListFiles("*.lyr"):
for lyrFile in arcpy.ListFiles("*.lyr"):
# Set Local Variables
outFC = "Test.gdb/{0}".format(lyrFile[:-4]) #Strips '.lyr' from name
#Execute Layer3DToFeatureClass
arcpy.Layer3DToFeatureClass_3d(file, outFC)
else:
"There are no layer files in {0}.".format(env.workspace)
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)
Entornos
- Espacio de trabajo actual
- Dominio XY de salida
- Dominio Z de salida
- Sistema de coordenadas de salida
- Transformaciones geográficas
- Extensión
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
- Palabra clave CONFIG de salida
- Auto ejecución
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst