Datasmith-Inhalte in Unreal Engine importieren und aktualisieren

Was erfahren Sie in dieser Anleitung?

Datasmith dient dazu, Inhalte aus unterstützten 3D-Designanwendungen oder Dateiformaten in Unreal Engine zu übertragen. Diese Anleitung erklärt, wie Sie Datasmith-Inhalte zu einem Projekt hinzufügen, Änderungen an der Quelldatei durch erneuten Import übernehmen und diese Aktualisierungen auf Actors im bestehenden Level anwenden. Außerdem erfahren Sie, wie Sie einzelne Static Mesh-, Material- und Texture-Assets aktualisieren, anstatt die gesamte Szene zu erneuern.

Im Workflow ist die Beziehung zwischen dem aus der Quelldatei erstellten Datasmith Scene-Asset und dem Datasmith Scene Actor im Level wichtig. Beim erneuten Import können Projekt-Assets aktualisiert werden; ob die Actors in der Szene die Änderungen übernehmen, hängt jedoch von den Synchronisierungseinstellungen ab, die Sie beim erneuten Import auswählen. Wenn Sie diese beiden Aspekte getrennt betrachten, können Sie den Umfang der Aktualisierung besser steuern.

Voraussetzungen

Öffnen Sie zunächst das gewünschte Projekt im Unreal Editor und prüfen Sie, ob das Datasmith Importer-Plugin aktiviert ist. Ist das Plugin nicht aktiviert, werden die Datasmith-Importoptionen nicht angezeigt. Bei Projekten, die mit einer der Vorlagen Architecture oder Automotive, Product Design, and Manufacturing erstellt wurden, können einige Datasmith-Plugins standardmäßig aktiviert sein. Prüfen Sie dennoch, ob die benötigte Option verfügbar ist.

Je nach Quelldateiformat können zusätzliche Plugins oder Software erforderlich sein. Ein Beispiel aus der Dokumentation von Epic Games sind .wire-Dateien: Dafür muss eine kompatible Version von Autodesk Alias AutoStudio installiert sein. Auch bei anderen Formaten und Anwendungen hängen die Voraussetzungen vom jeweiligen Quelltyp ab. Da die zugrunde liegenden Anleitungen keine bestimmten Anforderungen an die Unreal Engine-Version oder ein Konto nennen, werden hier keine solchen Voraussetzungen ergänzt.

Wenn Sie die Inhalte zu einem bestehenden Level hinzufügen möchten, öffnen Sie dieses Level vorab. Für eine separate Szene können Sie ein neues Level erstellen oder das Standard-Level verwenden.

Datasmith-Inhalte importieren

1. Öffnen Sie das Zielprojekt im Unreal Editor. Öffnen Sie das bestehende Level, in dem die Inhalte platziert werden sollen. Falls noch keines vorhanden ist, erstellen Sie ein neues Level oder verwenden Sie das Standard-Level.

2. Öffnen Sie im Haupt-Toolbar das Menü Create und wählen Sie Datasmith > File Import. Wählen Sie im Dateidialog die Quelldatei aus und klicken Sie auf Open.

3. Wählen Sie den Speicherort der Inhalte im Projekt und klicken Sie auf OK. Um einen neuen übergeordneten Ordner zu erstellen, klicken Sie im Dateidialog mit der rechten Maustaste auf eine freie Fläche. Einen Unterordner erstellen Sie, indem Sie mit der rechten Maustaste auf den entsprechenden Ordner klicken.

4. Legen Sie im Fenster Datasmith Import Options fest, welche Inhalte aus der Quelldatei übernommen werden sollen, und prüfen Sie die weiteren Importeinstellungen. Da sich die Optionen je nach Dateiformat unterscheiden können, sollten Sie nicht davon ausgehen, dass bei jeder Quelle dieselben Einstellungen verfügbar sind.

5. Wenn Sie alle Einstellungen vorgenommen haben, klicken Sie auf Import. Datasmith verarbeitet die Quelldatei, erstellt neue Assets im Projekt und platziert die Datasmith Scene im geöffneten Level.

Falls der Importprozess angepasst werden muss, können Sie Blueprints visual scripting oder Python-Skripte verwenden. Dataprep ermöglicht zusätzliche Verarbeitungsschritte beim Import; Rezepte lassen sich speichern und wiederverwenden. Diese Optionen sind nicht zwingend für die grundlegende Dateiübertragung erforderlich, sondern dienen der individuellen Anpassung des Prozesses.

Szene nach Änderungen an der Quelldatei aktualisieren

Wenn Sie Änderungen an der Quellszene unter derselben zuvor verwendeten Datei auf dem Datenträger gespeichert haben, klicken Sie im Content Browser mit der rechten Maustaste auf das Datasmith Scene-Asset und wählen Sie Reimport. Liegen die Änderungen in einer anderen Datei, wählen Sie Reimport With New File und geben Sie die neue Datei an.

Beim erneuten Import werden ähnliche Optionen wie beim ersten Import angezeigt. Zusätzlich legt der Bereich Sync Current Level Actors fest, ob Änderungen am aktualisierten Datasmith Scene-Asset auf die entsprechenden Datasmith Scene Actors im geöffneten Level angewendet werden. Klicken Sie nach der Auswahl der Optionen auf Import.

Beim erneuten Import können die Static Mesh-Geometrie, Parent Materials und Texture-Assets im Content Browser geändert werden. Betrachten Sie den Vorgang daher nicht nur als Aktualisierung der Szenenansicht: Auch Assets im Projekt können betroffen sein. Prüfen Sie vorab den Umfang der Änderungen an der Quelle und Ihre Synchronisierungseinstellungen.

Um Actors während des erneuten Imports zu synchronisieren, öffnen Sie das betreffende Level und importieren Sie das Datasmith Scene-Asset erneut. Aktivieren Sie im Fenster Import Options im Bereich Sync Current Level Actors das Kontrollkästchen Datasmith Scene Actors. Sollen zuvor gelöschte Actors ebenfalls wieder zum Level hinzugefügt werden, aktivieren Sie die Option Re-Spawn Deleted Actors.

Die Synchronisierung ist auch zu einem späteren Zeitpunkt möglich. Öffnen Sie das betreffende Level und wählen Sie im Outliner den Datasmith Scene Actor aus. Klicken Sie im Abschnitt Datasmith des Details-Panels auf Update actors from Scene. Sollen gelöschte Actors wiederhergestellt werden, aktivieren Sie zuvor die Option Respawn deleted actors.

Einzelne Assets aktualisieren

Anstatt das gesamte Datasmith Scene-Asset erneut zu importieren, können Sie auch einzelne Assets aktualisieren. Klicken Sie im Content Browser mit der rechten Maustaste auf das betreffende Static Mesh-, Material- oder Texture-Asset und wählen Sie Reimport. Bei Material-Assets wird die Option Datasmith > Reimport Material angezeigt, wenn Datasmith das Asset auf Basis der Materialdefinition in der Quelldatei von Grund auf erstellt hat. Laut Quellanleitung gilt dies in der Regel für aus 3ds Max importierte Parent Materials; bei Material-Instanzen, die auf den integrierten Materialien von Datasmith basieren, ist diese Option möglicherweise nicht verfügbar.

Beim erneuten Import eines einzelnen Assets wird ein Fenster mit Einstellungen geöffnet. Eine Option zur Synchronisierung von Level-Actors bietet dieser Vorgang jedoch nicht. Projektverweise verwenden dennoch automatisch die neue Version des aktualisierten Assets. Das bedeutet, dass der erneute Import eines einzelnen Assets keine Option zur Actor-Synchronisierung bietet; für die Aktualisierung der Asset-Verweise ist jedoch kein zusätzlicher Synchronisierungsschritt erforderlich.

Häufige Fehler und nächste Schritte

• Werden die Datasmith-Optionen nicht angezeigt, prüfen Sie zuerst, ob das Datasmith Importer-Plugin im Projekt aktiviert ist.

• Soll die Aktualisierung aus einer anderen Quelldatei erfolgen, verwenden Sie Reimport With New File statt Reimport.

• Verwechseln Sie den erneuten Import nicht mit der Synchronisierung der Level-Actors; prüfen Sie die Option Sync Current Level Actors.

• Berücksichtigen Sie, dass beim erneuten Import einzelner Assets keine Option zur Synchronisierung von Level-Actors verfügbar ist, Projektverweise aber automatisch die aktuelle Version verwenden.

• Beachten Sie, dass sich der erneute Import auf Static Mesh-Geometrie, Parent Materials und Texture-Assets auswirken kann.

In Workflows für Architektur, Innenarchitektur und Archviz kann Datasmith dazu dienen, Inhalte aus einer unterstützten Designquelle in ein Unreal Engine-Projekt zu importieren und Änderungen an der Quellszene in das Projekt zu übernehmen. Wichtig ist die Entscheidung, ob Änderungen auf die gesamte Szene oder nur auf bestimmte Assets angewendet werden sollen. Teams können gemeinsam festlegen, wann Szenen-Actors synchronisiert und ob gelöschte Actors wiederhergestellt werden sollen.

Da die Quelldokumentation keine Angaben zu Hardwareanforderungen oder Lizenzkosten enthält, sollten Sie hierzu keine Annahmen treffen. Prüfen Sie vor dem Import, ob das Dateiformat unterstützt wird, erforderliche Zusatzsoftware installiert ist und die Projekt-Plugins aktiviert sind. Als Nächstes können Sie die Beschreibungen der Datasmith Import Options für den verwendeten Dateityp prüfen und für wiederkehrende Abläufe Anpassungen mit Blueprints, Python oder Dataprep in Betracht ziehen.

Quelle und Lizenz

Diese Anleitung wurde anhand der Epic-Games-Dokumentationen „Importing Datasmith Content into Unreal Engine“ und „Reimporting Datasmith Content into Unreal Engine“ ins Deutsche übertragen. Für beide Quellen ist Lizenz=frei angegeben.