RealityScan-Befehlszeilenleitfaden: Vom Foto zum 3D-Modell

Was erfahren Sie in diesem Leitfaden?

Mit der Befehlszeilenschnittstelle von RealityScan lassen sich bestimmte Vorgänge der Anwendung per Befehl aneinanderreihen und wiederkehrende Aufgaben über eine Batch-Datei ausführen. In diesem Leitfaden fügen Sie Fotos eines architektonischen Raums zu einem Projekt hinzu, richten sie aus, speichern das Projekt, führen in der Anwendung konfigurierte Verarbeitungsschritte aus und vereinfachen und exportieren ein Modell. Die Befehle verwenden beispielhafte Ordnernamen und müssen an die tatsächlichen Arbeitsverzeichnisse angepasst werden.

Diese Methode garantiert nicht, dass sich jeder Vorgang automatisieren lässt. Der Befehl -start führt beispielsweise die für die Start-Schaltfläche in RealityScan vorkonfigurierten Vorgänge aus. Daher müssen die Einstellungen in der Anwendung gemeinsam mit den Schritten über die Befehlszeile betrachtet werden.

Voraussetzungen

Die Beispiele in der offiziellen Dokumentation zur Befehlszeile basieren auf RealityScan.exe. Die folgenden Schritte sind für die Windows-Eingabeaufforderung und .bat-Dateien gedacht. Die Dokumentation nennt weder eine erforderliche Mindestversion noch bestimmte Hardware, einen Kontotyp oder Preise. Prüfen Sie daher vor dem Projektstart zusätzlich die verwendete Installation und die Lizenzbedingungen.

Als Pfade für den Fotoordner und die Projektdatei dienen im Beispiel C:\RS\Images und C:\RS\Interior.rsproj. Erstellen Sie diese Ordner auf Ihrem Computer und legen Sie die Bilder am passenden Speicherort ab. Wenn in den Befehlen Dateipfade mit Leerzeichen verwendet werden, prüfen Sie in Ihrer Installation, wie die Parameter interpretiert werden. Die Beispiele bevorzugen Pfade ohne Leerzeichen.

Wenn Sie den RealityScan-Ordner zur Systemvariablen PATH hinzufügen, müssen Sie in den Befehlen nicht wiederholt den vollständigen Anwendungspfad angeben. Laut offizieller Dokumentation gilt die folgende PATH-Zeile nur für die aktuell geöffnete Eingabeaufforderung.

Schritt-für-Schritt-Anleitung

1. Fotos im Entwurfsmodus ausrichten

Fügen Sie zunächst die Bilder hinzu und führen Sie eine schnelle Ausrichtung im Entwurfsmodus durch. In diesem Beispiel wird der Anwendungsordner zu PATH hinzugefügt; anschließend werden die Fotos aus dem Ordner geladen und das Projekt gespeichert:

set PATH=%PATH%;C:\Program Files\Epic Games\RealityScan\
RealityScan.exe -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

-draft führt die Ausrichtung im Entwurfsmodus aus. So lässt sich zunächst prüfen, ob der Fotosatz zusammengeführt werden kann. Sicherer ist es, das Projekt in der Anwendung zu öffnen und das Ergebnis zu kontrollieren, bevor Sie statt einer Prüfung direkt mit der vollständigen Ausrichtung fortfahren.

2. Bei Bedarf Unterordner einbeziehen

Wenn die Bilder auf Unterverzeichnisse des Hauptordners verteilt sind, aktivieren Sie vor dem Hinzufügen die Option zum Durchsuchen von Unterverzeichnissen:

RealityScan.exe -set "appIncSubdirs=true" -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

Mit dieser Einstellung berücksichtigt der Befehl -addFolder auch Unterordner. Liegen die Bilder bereits in einem einzigen Ordner, ist diese zusätzliche Einstellung nicht erforderlich. Führen Sie die beiden Beispiele nicht nacheinander im selben Projekt aus, sondern wählen Sie den Workflow, der zur Ordnerstruktur Ihrer Fotos passt.

3. Vollständige Ausrichtung durchführen

Prüfen Sie zunächst das Ergebnis im Entwurfsmodus. Laden Sie anschließend das gespeicherte Projekt erneut und starten Sie die vollständige Ausrichtung:

RealityScan.exe -load C:\RS\Interior.rsproj -align -save C:\RS\Interior.rsproj -quit

Die Befehle werden der Reihe nach ausgeführt: Das Projekt wird geöffnet, ausgerichtet und das Ergebnis in derselben Projektdatei gespeichert. Die Parameter der Befehlszeile funktionieren ähnlich wie die entsprechenden Vorgänge in der Anwendung. Die Anwendung kann normal geöffnet werden und während der Verarbeitung Benutzereingaben zulassen. Die Option -headless, mit der sich die Benutzeroberfläche ausblenden lässt, ist ebenfalls dokumentiert. Bei den ersten Versuchen kann es jedoch übersichtlicher sein, das Ergebnis sichtbar zu kontrollieren.

4. Einen in der Anwendung definierten Workflow ausführen

Richten Sie nach der Ausrichtung in RealityScan die für die Erstellung des Modells erforderlichen Vorgänge über die Start-Schaltfläche ein. Laut offizieller Dokumentation führt -start die für diese Schaltfläche konfigurierten Prozesse aus. Gehen Sie daher nicht davon aus, dass sich die gewünschten Modellierungsschritte allein durch das Hinzufügen eines Befehls bestimmen lassen.

RealityScan.exe -load C:\RS\Interior.rsproj -start -save C:\RS\Interior.rsproj -quit

Die während der Verarbeitung verwendeten Optionen sollten in der Anwendung anhand des Projekts und des Ziels überprüft werden. Über die Befehlszeile lässt sich dieser zuvor festgelegte Workflow leichter wiederholen; sie garantiert jedoch nicht automatisch, dass die Einstellungen geeignet sind.

5. Modell vereinfachen und exportieren

Wenn Sie den Namen des Modells im Projekt kennen, können Sie es mit -selectModel auswählen, mit -simplify die gewünschte Dreieckszahl festlegen und mit -exportSelectedModel exportieren. Das folgende Beispiel verwendet den Namen Model1 und eine Zieldreieckszahl von 1.000.000. Dieser Wert ist keine Qualitätsempfehlung, sondern dient lediglich dazu, die Verwendung des Befehls zu veranschaulichen.

RealityScan.exe -load C:\RS\Interior.rsproj -selectModel Model1 -simplify 1000000 -exportSelectedModel C:\RS\Interior.obj -save C:\RS\Interior.rsproj -quit

Ersetzen Sie den Modellnamen durch den tatsächlichen Namen im Projekt. Wenn Sie die Einstellungen für Vereinfachung und Export detaillierter steuern möchten, können Sie die über die entsprechenden Werkzeuge in der Anwendung exportierte Datei params.xml optional als Parameter an die Befehle übergeben. Welche Einstellungen zum Einsatz kommen, hängt davon ab, wie die Datei in der Anwendung erstellt wurde.

Häufige Fehler

• Wird RealityScan.exe aufgerufen, ohne den Befehl aus dem Installationsordner der Anwendung auszuführen, kann die ausführbare Datei möglicherweise nicht gefunden werden. Verwenden Sie den vollständigen Anwendungspfad oder ergänzen Sie die PATH-Zeile in der aktiven Eingabeaufforderung.

• Gehen Sie nicht davon aus, dass Bilder in Unterordnern automatisch hinzugefügt werden. Wenn dieses Verhalten gewünscht ist, verwenden Sie die Einstellung appIncSubdirs.

• Betrachten Sie eine Ausrichtung im Entwurfsmodus nicht als fertiges Ergebnis. -draft und -align sind unterschiedliche Ausrichtungsbefehle. Prüfen Sie das Projekt nach dem Entwurfsschritt.

• Raten Sie nicht, welche Vorgänge der Befehl -start ausführt. Konfigurieren Sie die Einstellungen der Start-Schaltfläche vorab in der Anwendung.

• Wird ein Modell unter dem falschen Namen ausgewählt oder der Projektpfad falsch eingegeben, kann der Befehlsablauf nicht mit der erwarteten Datei arbeiten. Stimmen Sie Projekt- und Modellnamen mit den Angaben in der Anwendung ab.

Auswirkungen auf Workflows in Architektur, Innenarchitektur und Archviz

Teams, die mit Modellen aus Fotos von Räumen oder Gebäuden arbeiten, können bei Projekten mit wiederkehrenden Schritten zum Hinzufügen und Ausrichten der Bilder von der Befehlszeile profitieren. Auch Vereinfachung und Export gehören zu den dokumentierten Werkzeugen. So lässt sich ein Workflow für die Aufbereitung des aus Fotos gewonnenen Modells in verschiedenen Arbeitsschritten einrichten. Das ersetzt keine architektonischen Entscheidungen, sondern ist ein Werkzeug, um fotobasierte Daten im Projekt zu organisieren und bestimmte Vorgänge zu wiederholen.

Bei Projekten, an denen mehrere Personen im Büro arbeiten, sind einheitliche Ordnerstrukturen, Projektnamen und Verarbeitungseinstellungen in der Anwendung wichtig. Die RealityScan-Dokumentation enthält keine Angaben zur Kompatibilität mit einer bestimmten Archviz-Software, zu erforderlicher Hardware oder Lizenzkosten. Prüfen Sie daher anhand realer Projektdaten, wie sich die exportierte Datei in der Zielanwendung verwenden lässt, wie sich die Hardware auf die Verarbeitungszeit auswirkt und welche Lizenzbedingungen gelten.

Nächste Schritte

Sobald der grundlegende Workflow funktioniert, können Sie weitere Projektbefehle in der Befehlszeile ausprobieren, etwa zum Hinzufügen von Bildern über eine Image-Liste sowie zum Laden und Speichern von Projekten. Für die Ausrichtung gibt es Optionen zum Exportieren und Wiederverwenden von XMP-Kamerametadaten. Bei den Modellwerkzeugen sind außerdem Bereinigen, Löcher schließen, Texturen berechnen und verschiedene Exportvorgänge dokumentiert. Wenn Sie jeden neuen Befehl zunächst an einer kleinen Projektkopie testen, verringern Sie das Risiko, vorhandene Arbeit zu überschreiben.

Quelle und Lizenz

Der Leitfaden basiert auf den Abschnitten zu Projekt- und Bildbefehlen, Ausrichtungsbefehlen und Modellwerkzeugen in der von Epic Games veröffentlichten RealityScan-Dokumentation zur Befehlszeile. Die Quellen sind als frei lizenziert gekennzeichnet. Die Inhalte wurden auf Türkisch aufbereitet und die Beispiele für diesen Leitfaden angepasst.