Краткая информация
Экспортирует слои пространственных объектов с 3D-свойствами отображения в 3D класс линейных объектов или объектов-мультипатчей.
Использование
Слои объектов со следующими свойствами символов будут экспортированы в объекты-мультипатч:
- Задано вытягивание или базовые высоты.
- Текстовые маркеры символы с глубиной.
- Символы-маркеры-3D модели.
- Все символы линий.
- Все символы полигонов. Если полигональный слой не содержит свойств 3D-отображения, он будет экспортирован как мультипатч, совпадающий с полигоном.
Слои драпировки из ArcGlobe не поддерживаются. По причине динамической природы драпированных поверхностей, их значения высот не будут сохранены.
Символы текстурной заливки не поддерживаются. Если какой-либо объект в слое применяет символ 3D-маркера с ограниченными свойствами, например с текстурами, то этот объект не будет присутствовать в результате.
Этот инструмент не поддерживает объекты с любыми из следующих свойств символов:
- Символы-маркеры в режиме рекламного щита. Положение этих 2D символов динамически меняется в соответствии с положением камеры в 3D сцене, поэтому у них нет точного положения, которое может быть экспортировано.
- Символ маркер-рисунок
- Растеризованные слои, которыми драпируется поверхность сцены.
- Символы маркера формы, которые берутся из файла на диске.
- Символы маркера формы, которые поступают из шрифта, но не имеют свойства глубины.
Параметры среды допуска по XYZ и разрешения поддерживаются только если выходными данными является линейный объект.
Синтаксис
Layer3DToFeatureClass_3d (in_feature_layer, out_feature_class, {group_field})
Параметр | Объяснение | Тип данных |
in_feature_layer | Входной слой пространственных объектов 3D-свойствами отображения. | Feature Layer |
out_feature_class | Вытянутые точки экспортируются как 3D линии. Точки с 3D символами, вытянутые линии и полигоны экспортируются как объекты-мультипатч. | Feature Class |
group_field (Дополнительный) | Текстовое поле входного объекта, которое будет использовано для слияния нескольких входных объектов в один выходной объект. Остальные атрибуты, полученные из исходных данных, будут наследовать одну из входных записей. | Field |
Пример кода
Layer3DToFeatureClass, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Layer3DToFeatureClass_3d("Points_3D.lyr", "Test.gdb/trees")
Layer3DToFeatureClass, пример 2 (автономный скрипт)
В следующем примере показано использование этого инструмента в автономном скрипте 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)
Параметры среды
- Текущая рабочая область (Current Workspace)
- Выходной XY домен (Output XY Domain)
- Выходной домен Z (Output Z Domain)
- Выходная система координат (Output Coordinate System)
- Географические преобразования (Geographic Transformations)
- Экстент (Extent)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Автоподтверждение (Auto Commit)
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
Информация о лицензиях
- ArcGIS Desktop Basic: Требует 3D Analyst
- ArcGIS Desktop Standard: Требует 3D Analyst
- ArcGIS Desktop Advanced: Требует 3D Analyst