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

3D object feature layer visualization effects

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

Parameters

LabelExplanationData Type
Input Features

The input geodatabase multipatch feature that will be converted to a 3D object feature layer.

Table View
Use multipatch materials
(Optional)

Specifies whether the multipatch geometry will be visualized using material information from the associated 3D models or the texture and color information stored with the multipatch.

  • Checked—The multipatch geometry will be visualized using the textures, colors, effects, and materials associated with the 3D models. This is the default.
  • Unchecked—The multipatch geometry will be visualized using the textures and colors defined for the multipatch.
Boolean
3D Formats to Add
(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.

  • Collada (.dae)The COLLADA format will be added.
  • Autodesk (.fbx)The Autodesk FilmBox format will be added.
  • Khronos Group glTF json (.gltf)The JSON Graphics Library Transmission format will be added.
  • Khronos Group glTF binary (.glb)The binary Graphics Library Transmission format will be added.
  • Wavefront (.obj)The Wavefront format will be added.
String

Derived Output

LabelExplanationData Type
Updated Input Features

The updated input features.

Feature Layer

arcpy.management.Add3DFormats(in_features, {multipatch_materials}, {formats})
NameExplanationData 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_MATERIALSThe multipatch geometry will be visualized using the textures, colors, effects, and materials associated with the 3D models. This is the default.
  • MULTIPATCH_WITHOUT_MATERIALSThe 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_DAEThe COLLADA format will be added.
  • FMT3D_FBXThe Autodesk FilmBox format will be added.
  • FMT3D_GLTFThe JSON Graphics Library Transmission format will be added.
  • FMT3D_GLBThe binary Graphics Library Transmission format will be added.
  • FMT3D_OBJThe Wavefront format will be added.
String

Derived Output

NameExplanationData 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

Licensing information

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

Related topics