Мультипатч в COLLADA (Инструменты Конвертация)

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

Конвертирует один или несколько объектов-мультипатч в набор файлов COLLADA (.dae) и ссылается на текстурированные файлы изображений в выходной папке.

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

A COLLADA file is an XML representation of a 3D object that can reference additional image files that act as textures draped onto the 3D geometry. This means that exporting a multipatch feature to COLLADA can result in the creation of several files—Файл .dae, который содержит XML-представление трехмерного объекта, и одного или нескольких файлов изображений (например, файла .jpg или .png), содержащих текстуры.
This tool creates one COLLADA representation for each multipatch feature that it exports. The tool uses a field value from each feature—по умолчанию это поле Object ID, чтобы определить выходные имена полей. Это позволяет идентифицировать, какие объекты были экспортированы в конкретный файл COLLADA, а также включает методологию для определения уникальных имен при экспорте нескольких объектов в одну и ту же папку. Файлы текстур хранятся в той же папке, что и файл COLLADA. Чтобы минимизировать общий размер экспортируемого файла, текстуры, которые используются в нескольких файлах COLLADA, такие, как текстуры кирпичной кладки или окон, экспортируются только один раз, ссылка на них идет через соответствующий файл .dae.
This tool automatically overwrites existing COLLADA files with the same file name. When this occurs, a warning message appears stating the files that were overwritten with a new file during the export process. A geoprocessing message is also generated for features that fail to export—например, если выходное местоположение доступно только для чтения или диск переполнен.
Чтобы убедиться, что новые файлы COLLADA создаются для всех экспортируемых объектов мультипатч, задайте пустую или новую папку назначения и выберите поля имени файла, которое является уникальным для каждого объекта. При экспорте двух объектов с одинаковыми значениями атрибутов вы получите результат, когда второй экспортируемый объект перезапишет первый созданный файл COLLADA.
При итеративном обновлении объекта-мультипатч путем его экспорта в COLLADA и внесении правок не в ArcGIS, каждый раз нужно будет экспортировать объект в то же место. Это сохранит для этого объекта единый файл на диске, где будет представлена самая последняя трехмерная версия этого объекта.
Если экспортированный мультипатч представлен в системе координат проекции, например, здание в UTM-зоне, то в выходной папке также будет создан файл .kml, содержащий координаты, как WGS84. Этот процесс не использует преобразование датума, которое может привести к позиционным расхождениям при просмотре KML.

Подсказка:

При конвертации мультипатчей из слоя инструмент будет автоматически встраивать цвета, заданные в механизме отрисовки слоя. Например, если слой отрисовывает объекты на основе пользовательских атрибутов, например, красные для коммерческой застройки, а синие - для жилой и т.п., то эти цвета будут включены в выходные файлы COLLADA. Отображенный цвет применяется как к текстурированным, так и к не текстурированным объектам-мультипатч, при этом для первого требуется обновление базовых файлов текстур объекта. Вы можете использовать единственный белый цвет отображения для экспорта текстурированных мультипатчей с неизмененными изображениями.

Подпись	Объяснение	Тип данных
Входные пространственные объекты-мультипатчи	Объекты-мультипатч, которые нужно экспортировать.	Feature Layer
Выходная папка COLLADA	Папка назначения, куда будут помещаться выходные файлы COLLADA и файлы изображений текстур.	Folder
Предварительно указать имя источника (Дополнительный)	Указывает, будут ли имена выходных файлов COLLADA предваряться именем исходного векторного слоя. Отмечено–Имена файлов будут начинаться с имени исходного векторного слоя. Не отмечено–Имена файлов не будут начинаться с имени исходного векторного слоя. Используется по умолчанию.	Boolean
Использовать имя поля (Дополнительный)	Атрибут объекта, который будет использоваться в качестве выходного имени файла COLLADA для каждого экспортируемого объекта. Если поле не указано, то будет использоваться Object ID объекта.	Field
Версия COLLADA	Определяет версию COLLADA, в которую будут экспортированы файлы. 1.5–Файлы будут экспортированы в COLLADA версии 1.5. Версия 1.5 поддерживает включение геопривязанной информации и улучшенные возможности отрисовки. Используется по умолчанию. 1.4–Файлы будут экспортированы в COLLADA версии 1.4. Версия 1.4 является широко распространенным стандартом, который используется во многих платформах приложений, связанных с дизайном. Выберите эту версию, если файл COLLADA будет использоваться в системах, где не поддерживается версия 1.5.	String

arcpy.conversion.MultipatchToCollada(in_features, output_folder, {prepend_source}, {field_name}, collada_version)

Имя	Объяснение	Тип данных
in_features	Объекты-мультипатч, которые нужно экспортировать.	Feature Layer
output_folder	Папка назначения, куда будут помещаться выходные файлы COLLADA и файлы изображений текстур.	Folder
prepend_source (Дополнительный)	Указывает, будут ли имена выходных файлов COLLADA предваряться именем исходного векторного слоя. `PREPEND_SOURCE_NAME`–Имена файлов будут начинаться с имени исходного векторного слоя. `PREPEND_NONE`–Имена файлов не будут начинаться с имени исходного векторного слоя. Используется по умолчанию.	Boolean
field_name (Дополнительный)	Атрибут объекта, который будет использоваться в качестве выходного имени файла COLLADA для каждого экспортируемого объекта. Если поле не указано, то будет использоваться Object ID объекта.	Field
collada_version	Определяет версию COLLADA, в которую будут экспортированы файлы. `1.5`–Файлы будут экспортированы в COLLADA версии 1.5. Версия 1.5 поддерживает включение геопривязанной информации и улучшенные возможности отрисовки. Используется по умолчанию. `1.4`–Файлы будут экспортированы в COLLADA версии 1.4. Версия 1.4 является широко распространенным стандартом, который используется во многих платформах приложений, связанных с дизайном. Выберите эту версию, если файл COLLADA будет использоваться в системах, где не поддерживается версия 1.5.	String

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.MultipatchToCollada("Sample.gdb/Buildings", "C:/COLLADA",
                                     "PREPEND_SOURCE_NAME", "BldName")

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

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

'''*********************************************************************
Name: Convert Multipatch To Collada
Description: Converts multipatch features in an input workspace
             to a Collada model.
*********************************************************************'''
# Import system modules
import arcpy

# Script variables
inWorkspace = arcpy.GetParameterAsText(0)

# Set environment settings
arcpy.env.workspace = inWorkspace
# Create list of feature classes in workspace
fcList = arcpy.ListFeatureClasses()

# Determine if the list contained any feature classes
if fcList:
    # Iterate through each feature class
    for fc in fcList:
        # Describe the feature class
        desc = arcpy.Describe(fc)
        # Determine if feature class is a multipatch
        if desc.shapeType is 'MultiPatch':
           # Ensure unique name for output folder
           outDir = arcpy.CreateUniqueName('collada_dir')
           # Specify that collada file is prefixed by source name
           prepend = 'PREPEND_SOURCE_NAME'
           # Specify the feature attribute used to name Collada files
           fldName = 'OID'
           # Run MultipatchToCollada
           arcpy.conversion.MultipatchToCollada(fc, outDir, prepend, fldName)
else:
    print('There are no feature classes in {0}.'.format(inWorkspace))

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

Этот инструмент не использует параметры среды геообработки.

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

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