Импорт 3D-объектов (Инструменты Управление данными)

Краткая информация

Импортирует 3D-модели из одного или нескольких форматов 3D-файлов или обновляет векторный слой 3D-объектов.

Использование

Векторный класс 3D-объектов предоставляет способ хранить, назначать географическую привязку и визуализировать 3D-модели в ArcGIS Pro с помощью встроенных возможностей отображения, таких как световые эффекты, отражение и материалы.

Более подробно о векторном слое 3D-объектов
Геометрия векторного класса 3D-объектов может быть использована в любом инструменте геообработки, поддерживающем объекты-мультипатч. Например, векторный слой 3D-объектов может использоваться для анализа линий видимости в инструментах Линия видимости и Взаимная видимость или определения влияния теней в инструментах Частота затенения и Объемный теневой объект.
С помощью этого инструмента можно создавать векторные слои 3D-объектов напрямую, без необходимости импортировать 3D-модели в мультипатч или усовершенствовать мультипатч для расширения возможностей векторных слоев 3D-объектов. Этот инструмент также поддерживает больше форматов 3D-моделей, чем инструмент Импорт 3D-файлов. Можно импортировать следующие 3D-форматы:
- COLLADA (.dae)
- Drawing (.dwg)
- Autodesk Filmbox (.fbx)
- Передача графической библиотеки (Graphics Library Transmission) (.glb)
- Передача графической библиотеки JSON (JSON Graphics Library Transmission) (.gltf)
- Industry Foundation Classes (.ifc)
- Объектный файл Wavefront (.obj)
- Universal Scene Description (.usdc)
- Сжатые Universal Scene Description (.usdz)
- CityGML (.gml)
Если создается векторный класс 3D-объектов и импортируемые модели имеют пространственную привязку, то векторный класс 3D-объектов наследует систему координат моделей. Если импортируемые модели не имеют системы координат, то в качестве выходной системы координат будет использоваться WGS84 Web Mercator (WKID 3857), в которой используются линейные единицы измерения - метры. Если 3D-модели имеют линейные единицы измерения, то ее координаты будут автоматически преобразованы для соответствия выходной проекции. Когда у 3D-моделей нет заданных линейных единиц, параметр Коэффициент масштабирования может использоваться для применения соответствующего преобразования.
Папка Microsoft Windows 3D Objects (например, C:\Users\<username>\3D Objects) не поддерживается для импорта 3D-файлов. Если входной 3D-файл находится в папке 3D Objects, скопируйте его в другую папку.

Подпись	Объяснение	Тип данных
Входные 3D-файлы или 3D-папки	3D-файлы или папки, содержащие 3D-файлы, которые будут импортированы. При выборе папки будут импортированы все поддерживаемые 3D-модели, содержащиеся в ней и ее подкаталогах. Поддерживаются следующие модели: COLLADA (`.dae`) Drawing (`.dwg`) Autodesk Filmbox (`.fbx`) Graphics Library Transmission (`.glb`) Передача графической библиотеки (Graphics Library Transmission) (`.glb`) Industry Foundation Class (`.ifc`) Объектный файл Wavefront (`.obj`) Universal Scene Description (`.usdc`) Сжатые Universal Scene Description (`.usdz`) CityGML (`.gml`) Папка Microsoft Windows 3D Objects (например, `C:\Users\<username>\3D Objects`) не поддерживается для импорта 3D-файлов. Если входной 3D-файл находится в папке 3D Objects, скопируйте его в другую папку.	File; Folder
Выходной класс пространственных объектов 3D-объектов	Векторный слой 3D-объектов, который будет создан или обновлен.	Feature Layer
Стратегия обновления (Дополнительный)	Определяет, как будет обновляться существующий векторный класс 3D-объектов. Заменить все существующие модели–Все существующие объекты в векторном классе 3D-объектов будут удалены, и будут добавлены только те 3D-модели, которые указаны в качестве входных. Только обновить существующие модели–3D-модели, которые существуют в векторном классе 3D-объектов, будут обновлены. Новые модели будут пропущены. Обновить существующие модели и добавить новые–3D-модели, существующие в векторном классе 3D-объектов, будут обновлены, а новые модели - добавлены. Используется по умолчанию. Добавить все модели–Все 3D-модели будут добавлены без замены тех, которые уже существуют в векторном классе 3D-объектов.	String
XY смещение (Дополнительный)	Смещение x- и y-координаты, которое будет применяться к импортированным моделям.	Point
Смещение высоты (Дополнительный)	Смещение по высоте, которое будет применяться к импортированным моделям.	Double
Масштабный коэффициент (Дополнительный)	Коэффициент масштабирования, который будет использоваться для изменения размера импортируемых 3D-моделей.	Double
Угол поворота (Дополнительный)	Угол поворота в градусах, который будет применяться к импортированным моделям. Поворот применяется с учетом того, что ноль градусов (0°) обозначает север, а угловые значения увеличиваются по часовой стрелке.	Double
Y наверху, если не указано в данных	Указывает, будут ли координаты y интерпретироваться как высота или как горизонтальная плоскость. Этот параметр поддерживается только для файлов Wavefront Object (`.obj`). Отмечено–Координаты Y будут интерпретироваться как высота. Используется по умолчанию. Не отмечено–Координаты Z будут интерпретироваться как высота.	Boolean

arcpy.management.Import3DObjects(files_and_folders, updated_features, {update}, {translate}, {elevation}, {scale}, {rotate}, y_is_up)

Имя	Объяснение	Тип данных
files_and_folders [files_and_folders,...]	3D-файлы или папки, содержащие 3D-файлы, которые будут импортированы. При выборе папки будут импортированы все поддерживаемые 3D-модели, содержащиеся в ней и ее подкаталогах. Поддерживаются следующие модели: COLLADA (`.dae`) Drawing (`.dwg`) Autodesk Filmbox (`.fbx`) Graphics Library Transmission (`.glb`) Передача графической библиотеки (Graphics Library Transmission) (`.glb`) Industry Foundation Class (`.ifc`) Объектный файл Wavefront (`.obj`) Universal Scene Description (`.usdc`) Сжатые Universal Scene Description (`.usdz`) CityGML (`.gml`) Папка Microsoft Windows 3D Objects (например, `C:\Users\<username>\3D Objects`) не поддерживается для импорта 3D-файлов. Если входной 3D-файл находится в папке 3D Objects, скопируйте его в другую папку.	File; Folder
updated_features	Векторный слой 3D-объектов, который будет создан или обновлен.	Feature Layer
update (Дополнительный)	Определяет, как будет обновляться существующий векторный класс 3D-объектов. `REPLACE_ALL`–Все существующие объекты в векторном классе 3D-объектов будут удалены, и будут добавлены только те 3D-модели, которые указаны в качестве входных. `UPDATE_EXISTING`–3D-модели, которые существуют в векторном классе 3D-объектов, будут обновлены. Новые модели будут пропущены. `UPDATE_EXISTING_ADD_NEW`–3D-модели, существующие в векторном классе 3D-объектов, будут обновлены, а новые модели - добавлены. Используется по умолчанию. `ADD_ALL`–Все 3D-модели будут добавлены без замены тех, которые уже существуют в векторном классе 3D-объектов.	String
translate (Дополнительный)	Смещение x- и y-координаты, которое будет применяться к импортированным моделям.	Point
elevation (Дополнительный)	Смещение по высоте, которое будет применяться к импортированным моделям.	Double
scale (Дополнительный)	Коэффициент масштабирования, который будет использоваться для изменения размера импортируемых 3D-моделей.	Double
rotate (Дополнительный)	Угол поворота в градусах, который будет применяться к импортированным моделям. Поворот применяется с учетом того, что ноль градусов (0°) обозначает север, а угловые значения увеличиваются по часовой стрелке.	Double
y_is_up	Указывает, будут ли координаты y интерпретироваться как высота или как горизонтальная плоскость. Этот параметр поддерживается только для файлов Wavefront Object (`.obj`). `Y_IS_UP`–Координаты Y будут интерпретироваться как высота. Используется по умолчанию. `Z_IS_UP`–Координаты Z будут интерпретироваться как высота.	Boolean

Пример кода

Import3DObjectsпример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python.

import arcpy
arcpy.env.workspace = 'C:/project_directory'

arcpy.management.Import3DObjects("import_models",
                                 "city_models.gdb/Downtown_Buildings",
                                 update="ADD_ALL", translate="50 100.5",
                                 elevation=-52.73, scale=0.3048, rotate=15.25)

Import3DObjects, пример 2 (рабочий процесс)

В следующем примере показано использование этого инструмента в автономном скрипте Python.

import arcpy
arcpy.env.workspace = 'C:/project_directory'
arcpy.env.overwriteOutput = True

# Export the feature class or layer to model files on disk
arcpy.management.Export3DObjects("city_models.gdb/Downtown_Buildings",
                                 "exported_models", ["FMT3D_IFC"])

# Optionally, edit the exported model files in other software, or replace the
# files with a new version.
# Keep the file names the same to update existing features. New file names are
# interpreted as new features.

# The input folder and feature class or layer in Import 3D Objects are the same
# values used in Export 3D Objects.
arcpy.management.Import3DObjects("exported_models",
                                 "city_models.gdb/Downtown_Buildings",
                                 update="UPDATE_EXISTING_ADD_NEW",
                                 translate="350 150",
                                 elevation=100, scale=2.54, rotate=-90)

Параметры среды

Текущая рабочая область, Временная рабочая область

Информация о лицензировании