Add 3D Formats To Multipatch (Data Management)

Summary

Converts a multipatch to a 3D object feature layer by linking the feature class with one or more 3D model formats.

Illustration

Usage

• This tool converts a multipatch feature class into a 3D object feature layer by creating additional tables associated with the multipatch.

• One or more 3D model formats can be associated with the multipatch to enable the lighting, reflectance, roughness, textures, materials and other visualization effects supported by those formats.

• The 3D object feature layer can be used without an associated 3D model. This will provide the texture optimization of the 3D object feature layer for the multipatch feature class. In a multipatch, the texture is stored for each feature independently, and the memory used for rendering the feature will require loading the geometry and the textures in one stream. The 3D object feature layer stores shared textures only once and can load the textures separately from the geometry, allowing the same data to be stored and processed more efficiently.

  Learn more about working with 3D object feature layers

Syntax

arcpy.management.Add3DFormats(in_features, {multipatch_materials}, {formats})

Parameter	Explanation	Data Type
in_features	The input geodatabase multipatch feature that will be converted to a 3D object feature layer.	Table View
multipatch_materials (Optional)	Specifies whether the multipatch geometry will be visualized using material information from the 3D models or the texture and color information stored with the multipatch. MULTIPATCH_WITH_MATERIALS —The multipatch geometry will be visualized using the textures, colors, effects, and materials associated with the 3D models. This is the default. MULTIPATCH_WITHOUT_MATERIALS —The multipatch geometry will be visualized using the textures and colors defined for the multipatch.	Boolean
formats [formats,...] (Optional)	Specifies the 3D formats that will be associated with the multipatch features. Each input feature will be duplicated for each selected format. The available options depend on the codecs installed on the computer. FMT3D_DAE —The COLLADA format will be added. FMT3D_FBX —The Autodesk FilmBox format will be added. FMT3D_GLTF —The JSON Graphics Library Transmission format will be added. FMT3D_GLB —The binary Graphics Library Transmission format will be added. FMT3D_OBJ —The Wavefront format will be added.	String

Derived Output

Name	Explanation	Data Type
updated_features	The updated input features.	Feature Layer

Code sample

Add3DFormats example (Python window)

The following Python window script demonstrates how to use the Add3DFormats tool in immediate mode.

import arcpy
arcpy.env.workspace = 'C:/data/city_models.gdb'
arcpy.management.Add3DFormats('Downtown_Buildings', 'MULTIPATCH_WITH_MATERIALS', 
                              ['FMT3D_DAE', 'FMT3D_OBJ'])

Environments

Current Workspace

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes