Render-Workflow mit dem V-Ray App SDK: Szene laden, Vorschau und Ausgabe

Das V-Ray App SDK bietet laut Dokumentation von Chaos eine Schnittstelle, über die Drittanbieter-Software die V-Ray-Engine starten und steuern kann. Dieser Leitfaden behandelt das Laden einer Szene, das Rendern, die Anzeige eines Zwischenbilds und das Speichern des Ergebnisses über das SDK. Da die Dokumentation keine bestimmte SDK-Version nennt, beruhen die folgenden Informationen auf dem dort beschriebenen allgemeinen Workflow.

Wofür lässt sich das V-Ray App SDK einsetzen?

Mit dem SDK kann eine V-Ray-Szene innerhalb des Prozesses einer anderen Anwendung oder unabhängig davon erstellt und gerendert werden. Eine Szene lässt sich aus einem nativen Projektformat in V-Ray-Plug-ins umwandeln und im Speicher aufbauen oder aus einer .vrscene-Datei laden, dem Szenenformat von V-Ray. Auch die Unterstützung für Distributed Rendering gehört zu den dokumentierten Einsatzmöglichkeiten.

Dieser Ansatz ist für Softwareentwickler interessant, die den Renderprozess in eigene Tools oder Automatisierungsabläufe integrieren möchten. Das SDK ist keine Anleitung für die übliche Benutzeroberfläche von 3ds Max oder einer anderen Modellierungssoftware, sondern eine API zur Entwicklung von Integrationen mit der V-Ray-Engine. Der unmittelbare Nutzen für Architekturbüros hängt daher davon ab, ob die eingesetzte Software über das SDK integriert wurde.

Von der Einrichtung bis zum Bild: Schritt für Schritt

1. SDK-Pfade einrichten. Laut Dokumentation muss die Umgebungsvariable VRAY_SDK gesetzt werden. Bei Verwendung der Python-Bindings muss außerdem der Ordner python im SDK zum Python-Modulsuchpfad hinzugefügt werden. Als Beispiele nennt die Dokumentation das Ausführen von setenv.bat unter Windows sowie source setenv.sh unter Linux und macOS. Diese Skripte setzen die entsprechenden Umgebungsvariablen.

2. Bibliothekspfad überprüfen. Wenn VRAY_SDK gesetzt ist, sucht die SDK-Bindung die benötigten Binärdateien und Abhängigkeiten unter VRAY_SDK/bin. Gibt es in der Ordnerstruktur des Produkts kein Verzeichnis bin, kann VRAY_APPSDK_BIN verwendet werden; in diesem Fall wird im angegebenen Ordner gesucht. Falls sich keine Umgebungsvariable verwenden lässt, kann laut Dokumentation der Bibliothekssuchpfad auch zur Laufzeit festgelegt werden.

3. Renderer erstellen und Szene laden. VRayRenderer ist die zentrale Klasse zum Starten und Steuern des Renderprozesses. Eine Szene lässt sich mit neuen Plug-in-Objekten und Parametern erstellen oder aus einer .vrscene-Datei laden. Beide Ansätze können auch kombiniert werden. Bei der Entwicklung einer Integration sollte an dieser Stelle geklärt werden, wie die Szenendaten bereitgestellt werden.

4. Render-Modus wählen und Rendering starten. Standardmäßig ist laut Dokumentation Interactive (CPU) eingestellt. Der Aufruf von start() erfolgt asynchron: Das Rendering läuft in einem separaten Thread weiter, während die Anwendung andere Aufgaben ausführen kann. Zwischenbilder lassen sich auch während des Renderings abrufen, um den Fortschritt in der Vorschau zu verfolgen. Nach Abschluss des Renderings steht das finale Bild bereit.

5. Bild abrufen und Ressourcen freigeben. Das SDK stellt das aktuelle Renderbild als Bildobjekt bereit. Dieses kann angezeigt oder in unterstützten Formaten gespeichert werden. Am Ende des Ablaufs wird der Renderer geschlossen und der belegte Speicher freigegeben.

Ein kurzes Beispiel aus der Python-Dokumentation, das die Reihenfolge der Aufrufe zeigt:

import vray

with vray.VRayRenderer() as renderer:
    renderer.load('./intro.vrscene')
    renderer.start()
    renderer.waitForRenderEnd(6000)
    image = renderer.getImage()
    image.save('intro.png')

Die Dateinamen stammen aus dem Beispiel in der Dokumentation. Der Code sollte in einer Integration verwendet werden, die den Pfad zur Szenendatei und den Speicherort des Ergebnisbilds an das jeweilige Projekt anpasst.

Vorschau oder finales Rendering?

Das SDK definiert zwei Render-Modi. Interactive eignet sich für schnelle Bildvorschauen und schrittweises Feedback beim Ändern von Szeneneinstellungen. Production ist für das gewünschte finale Bild vorgesehen, sobald die Szene sorgfältig vorbereitet wurde; die vollständige Ausgabe kann länger dauern. Der Modus lässt sich zwischen Renderdurchläufen ändern, ohne den Renderer neu zu erstellen oder die Szene erneut zu laden.

Für GPU-Rendering führt die Dokumentation CUDA und OptiX als Optionen für NVIDIA sowie Metal und MetalRT für Apple auf. Daher sollten die Kompatibilität der Hardware und die verwendete Rendering-Technologie zu Beginn der Integration überprüft werden. Auch die Plug-in-Unterstützung ist unterschiedlich: In der API-Referenz sind manche Komponenten als vollständig, manche als teilweise und andere als ohne GPU-Unterstützung gekennzeichnet. Daraus folgt, dass eine bestimmte Szenenfunktion nicht zwangsläufig mit jedem Renderpfad funktioniert.

Auswirkungen auf Architektur- und Visualisierungs-Workflows

Für Teams in der Architekturvisualisierung liegt der Nutzen des SDK darin, wiederkehrende Render-Schritte in eine Anwendung integrieren zu können. Ein Projekttool könnte eine .vrscene-Datei laden, eine Vorschau anzeigen, den Renderstatus verfolgen und das Bild speichern. Auch Distributed Rendering wird in der SDK-Dokumentation behandelt; welche Software- und Hardwarekonfiguration ein Team dafür nutzt, hängt jedoch von der eigenen Integration ab.

Die Wahl des Render-Modus kann den Workflow vereinfachen: Interactive für Material-, Licht- und Kameraversuche, Production für die finale Ausgabe einer freigegebenen Szene. Die SDK-Dokumentation enthält allerdings keine Zahlenvergleiche zu Renderzeiten, Hardwareanforderungen oder Lizenzbedingungen. Büros sollten deshalb die Kompatibilität und Hardware mit realen Projektszenen in ihrer eigenen Umgebung testen.

Häufige Fehler

• Umgebungsvariablen überspringen: Ist VRAY_SDK nicht gesetzt, kann die Bindung die benötigten Bibliotheken möglicherweise nicht finden. Auch der Python-Modulpfad muss eingerichtet werden.

• Den asynchronen Ablauf außer Acht lassen: start() startet das Rendering im Hintergrund. Laut Dokumentation sollten Szene oder Renderer nicht verändert werden, solange sich der Renderer im Status PREPARING befindet; solche Änderungen können abgewiesen werden.

• Vorschau- und Final-Modus verwechseln: Interactive ist für schnelles Feedback, Production für das vorbereitete finale Bild vorgesehen. Werden die beiden Modi in unterschiedlichen Arbeitsphasen eingesetzt, lässt sich ein konsistenterer Workflow aufbauen.

• Plug-in-Kompatibilität voraussetzen: Die GPU-Unterstützung in der API-Referenz kann je nach Plug-in variieren. Im Integrationstest sollte geprüft werden, ob die verwendeten Szenenkomponenten mit dem vorgesehenen Renderpfad kompatibel sind.

Der in diesem Leitfaden beschriebene Workflow basiert auf der allgemeinen Verwendung, die in der Dokumentation zum V-Ray App SDK von Chaos erläutert wird. Die Dokumentation nennt keine bestimmte Softwareversion.