vrimport

(To be removed) Import 3D file into virtual world or node

vrimport will be removed in a future release. For more information, see Version History.

Syntax

node = vrimport(source)

node = vrimport(parent,source)

node = vrimport(___,format)

[node,virtualWorld] = vrimport(___)

Description

node = vrimport(source) creates an empty VRML virtual world and imports the source 3D file into it. The format of the 3D file is detected automatically. You can import these file formats:

• FBX (Autodesk^® FilmBoX format)

• DAE (Collada digital asset exchange)

• SDF (simulation description format)

• STL (Stereolithography)

• URDF (unified robot description file)

• XML (Physical Modeling XML files)

The function returns a handle to the newly created node.

node = vrimport(parent,source) specifies the existing virtual world or node to import the 3D source file into.

node = vrimport(___,format) explicitly specifies the file format of the 3D source file (for example, 'urdf'). If the format of the source file does not match the format specified in the format argument, the function returns an error.

[node,virtualWorld] = vrimport(___) returns the handle of the new node and the handle of the virtual world that contains that node.

Input Arguments

source — 3D source file

character vector

3D source file path, specified as a character vector. The 3D file can be in DAE, SDF, STL, or URDF format.

format — File format of source 3D file

'fbx' | 'dae' | 'sdf' | 'stl' | 'urdf' | 'xml'

File format of source 3D file, specified as a character vector. Use this argument to specify explicitly the required format for the source 3D file.

parent — Virtual world or node to import 3D source file to

vrworld object | vrnode object

Virtual world or node to import 3D source file into, specified as a virtual world handle or node handle.

• If the parent is a virtual world, the imported node is placed at the ROOT node of the parent.

• If the parent is a node in a virtual world, the imported node is placed in the children field of the node.

Output Arguments

node — New node

vrnode object

New node, returned as a vrnode object.

virtualWorld — Virtual world containing new node

vrworld object

Virtual world containing new node, returned as a vrworld object.

Version History

Introduced in R2016b

R2023b: To be removed

The vrimport will be removed in a future release. Instead, use sim3d classes and Simulation 3D blocks to interface MATLAB^® and Simulink^® with the Unreal Engine^® 3D simulation environment. To get started, see Create 3D Simulations in Unreal Engine Environment.