Импорт файлов 3D (Инструменты 3D Analyst)

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

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

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

Сохраните текстуру 3D моделей, сохранив выходной мультипатч в базе геоданных. Шейп-файлы не поддерживают сохранение текстур.
Если верхняя сторона итоговых объектов-мультипатчей повернута вбок, попробуйте еще раз настроить ориентацию с помощью этого инструмента, включив параметр Y Вверх.
GeoVRML является единственным форматом с определенной системой координат. Многие 3D-модели создаются с помощью локальной системы координат с центром координат в точке 0, 0, 0. Для таких объектов можно выполнить геопривязку к реальным координатам одним из приведенных ниже способов:
- Если 3D модели необходимо повернуть и сдвинуть, рассмотрите возможность использования одного из методов векторной трансформации, чтобы правильно расположить объекты.
- Если 3D модели ориентированы в данной системе координат правильно, и их необходимо только сдвинуть, рассмотрите возможность настройки свойств Системы координат, чтобы получить необходимый сдвиг. Если точечные объекты, определяющие положение центроида каждой модели в координатах реального мира, доступны, рассмотрите возможность использования этих точек в качестве входных данных для инструмента, чтобы выполнить пространственную привязку моделей.
Точечные и линейные геометрии, которые могут существовать в 3D-файле, не поддерживаются в выходном классе объектов-мультипатчей, так как мультипатчи их не поддерживают.

Примечание:

Для файлов VRML не поддерживаются следующие типы геометрии: Box, Cone, Cylinder, Extrusion, PointSet, Sphere и Text.

Подпись	Объяснение	Тип данных
Входные файлы	Одна или несколько моделей 3D или папок, содержащих такие файлы в поддерживаемых форматах, включая 3D Studio Max (`.3ds`), VRML и GeoVRML (`.wrl`), OpenFlight (`.flt`), COLLADA (`.dae`), и модели Wavefront OBJ (*.obj).	File; Folder
Выходной класс объектов-мультипатчей	Мультипатч, который будет создан на основе входных файлов.	Feature Class
Один корень на объект (Дополнительный)	Показывает, требуется ли создавать один объект для каждого файла, либо один объект для каждого корневого узла в файле. Данная опция применяется только к моделям VRML. Отмечено–Создаваемый выходной набор данных будет содержать один файл для каждого объекта. Используется по умолчанию. Не отмечено–Создаваемый выходной набор данных будет содержать один объект для каждого корневого узла в файле.	Boolean
Система координат (Дополнительный)	Система координат входных данных. Для большинства форматов это неизвестная система координат. Только формат GeoVRML хранит свою систему координат, по умолчанию она будет получена из первого файла в списке, если не указана пространственная привязка.	Spatial Reference
Y Вверх (Дополнительный)	Определяет ось, которая задает вертикальную ориентацию входных файлов. Отмечено–Ось Y направлена вверх. Не отмечено–Ось Z направлена вверх. Используется по умолчанию.	Boolean
Суффикс	Разрешение файлов, импортируемых из входной папки. Этот параметр также необходим, если хотя бы одна папка указана в качестве входных данных. Все поддерживаемые файлы.–Все поддерживаемые файлы. Используется по умолчанию. *3D Studio Max (.3ds)–3D Studio Max VRML или GeoVRML (.wrl)–VRML или GeoVRML OpenFlight (.flt)–OpenFlight Collada (.dae)–Collada Формат Wavefront OBJ (.obj)**–Модель Wavefront OBJ	String
Размещение точек (Дополнительный)	Точечные объекты, чьи координаты определяют реальное положение входных файлов. Каждый входной файл будет соответствовать своей точке на основании имен файлов, хранящихся в Поле символов. Параметр Система координат должен быть задан, чтобы совпадать с пространственной привязкой точек.	Feature Layer
Поле символа (Дополнительный)	Поле в точечных объектах, содержащее имя файла 3D, связанного с каждой точкой.	Field

arcpy.3d.Import3DFiles(in_files, out_featureClass, {root_per_feature}, {spatial_reference}, {y_is_up}, file_suffix, {in_featureClass}, {symbol_field})

Имя	Объяснение	Тип данных
in_files [in_files,...]	Одна или несколько моделей 3D или папок, содержащих такие файлы в поддерживаемых форматах, включая 3D Studio Max (`.3ds`), VRML и GeoVRML (`.wrl`), OpenFlight (`.flt`), COLLADA (`.dae`), и модели Wavefront OBJ (*.obj).	File; Folder
out_featureClass	Мультипатч, который будет создан на основе входных файлов.	Feature Class
root_per_feature (Дополнительный)	Показывает, требуется ли создавать один объект для каждого файла, либо один объект для каждого корневого узла в файле. Данная опция применяется только к моделям VRML. `ONE_FILE_ONE_FEATURE`–Создаваемый выходной набор данных будет содержать один файл для каждого объекта. Используется по умолчанию. `ONE_ROOT_ONE_FEATURE`–Создаваемый выходной набор данных будет содержать один объект для каждого корневого узла в файле.	Boolean
spatial_reference (Дополнительный)	Система координат входных данных. Для большинства форматов это неизвестная система координат. Только формат GeoVRML хранит свою систему координат, по умолчанию она будет получена из первого файла в списке, если не указана пространственная привязка.	Spatial Reference
y_is_up (Дополнительный)	Определяет ось, которая задает вертикальную ориентацию входных файлов. `Y_IS_UP`–Ось Y направлена вверх. `Z_IS_UP`–Ось Z направлена вверх. Используется по умолчанию.	Boolean
file_suffix	Разрешение файлов, импортируемых из входной папки. Этот параметр также необходим, если хотя бы одна папка указана в качестве входных данных. `*`–Все поддерживаемые файлы. Используется по умолчанию. `3DS`–3D Studio Max `WRL`–VRML или GeoVRML `FLT`–OpenFlight `DAE`–Collada `OBJ`–Модель Wavefront OBJ	String
in_featureClass (Дополнительный)	Точечные объекты, чьи координаты определяют реальное положение входных файлов. Каждый входной файл будет соответствовать своей точке на основании имен файлов, хранящихся в Поле символов. Параметр Система координат должен быть задан, чтобы совпадать с пространственной привязкой точек.	Feature Layer
symbol_field (Дополнительный)	Поле в точечных объектах, содержащее имя файла 3D, связанного с каждой точкой.	Field

Пример кода

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.Import3DFiles("AddisSheraton.skp", "Test.gdb/AddisSheraton", False, "", False)

Import3DFiles пример 2 (автономный скрипт)

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

'''****************************************************************************
Name: Import3DFiles Example
Description: This script demonstrates how to use the
             ListFiles method to collect all OpenFlight (*.flt) models in a
             workspace as input for the Import3DFiles tool.
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
OpenFlightList = arcpy.ListFiles("*.flt")
CS = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
outputFC = "Test.gdb/OpenFlight_Models"

if len(OpenFlightList) > 0:
    # Run Import3DFiles
    arcpy.ddd.Import3DFiles(OpenFlightList, outputFC, False, CS, False)
else:
    # Returned if there are no flt files in the target workspace
    print("There are no OpenFlight files in the " + env.workspace + " directory.")

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

Текущая рабочая область, Выходная система координат, Выходной XY домен, Выходной Z домен, Автоподтверждение, Выходное ключевое слово конфигурации

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

Basic: Да
Standard: Да
Advanced: Да