Epic Games Unreal Datasmith (UDATASMITH) Writer
FME can write data in the Unreal Datasmith format.
The Datasmith version created by FME is supported in Unreal Studio version 4.21 and higher.
Unreal Datasmith Product and System Requirements
Format |
Platform |
Operating System |
||||
---|---|---|---|---|---|---|
Reader/Writer |
FME Desktop License |
FME Server |
FME Cloud |
Windows 64-bit |
Linux |
Mac |
Writer |
Available in FME Professional Edition and higher |
Yes |
Yes |
Yes |
Yes (Ubuntu only) 64-bit |
No |
Overview
Epic Games Unreal Datasmith (.udatasmith) is a file standard that is used to import 3D scenes into Unreal Engine projects. Datasmith folders contain Assets such as meshes and textures. These Assets are used to create a .udatasmith file, which contains a scene hierarchy of Unreal Engine Actors (instances). Multiple Actors can be associated with the same Assets, and each Actor can also contain a set of metadata keys and values.
UDATASMITH files are organized in a hierarchical structure:
Term |
FME Representation |
Description |
---|---|---|
Scene |
Writer Dataset |
A file that contains a group of Assets and Actors. |
Layer |
Feature Type |
A group of related Actors in a Scene. |
Actor |
Geometry Instance |
An instance of a game object, which may contain other Actors. An Actor usually references one or more Assets. |
Asset |
Appearance, Texture, Raster, or Geometry Definition |
A file that contains data used to render one or more Actors in a Scene. |
Property |
Attribute or Trait |
A key and value in an Actor's metadata dictionary. |
The writer dataset is a folder where FME will write asset files and a scene file.
Each FME Feature Type will be represented as a Layer in the scene. For each geometry on an FME feature, the writer will create an Actor in the scene. If the geometry can be represented as a surface, then the writer will create an associated mesh asset. If the geometry has one or more appearances, then the writer will create associated material and texture assets. Feature attributes and geometry traits are written as a metadata dictionary attached to each Actor.
Note: The Unreal Datasmith format is limited to 32-bit precision for its coordinates and, as a result, translations involving a greater level of precision (that is, using world coordinates instead of local coordinates) may produce data where different coordinates are collapsed into a single coordinate. You can resolve this issue by offsetting the x,y,z coordinates such that the model's origin is moved to (0,0,0) or another point close to this, which has the effect of moving the model into a local coordinate system.
Texture Formats
UDataSmith supports the following texture formats:
- BITMAP
- JPEG
- PNG
- TARGA