Workflow de rendu avec V-Ray App SDK : chargement, aperçu et export

Selon la documentation de Chaos, V-Ray App SDK fournit une interface permettant aux logiciels tiers de lancer et de gérer le moteur V-Ray. Ce guide présente les étapes pour charger une scène avec le SDK, lancer un rendu, suivre l’image intermédiaire et enregistrer le résultat dans un fichier. La documentation ne précisant pas de version particulière du SDK, les informations ci-dessous s’appuient sur le workflow général qui y est décrit.

À quoi peut servir V-Ray App SDK ?

Le SDK permet de créer et de rendre une scène V-Ray dans le processus d’une autre application ou indépendamment de celle-ci. Une scène peut être constituée en mémoire en convertissant un format de projet natif en plugins V-Ray, ou chargée depuis un fichier .vrscene, le format de scène de V-Ray. La prise en charge du rendu distribué figure également parmi les cas d’utilisation documentés.

Cette approche est pertinente pour les développeurs qui souhaitent intégrer le rendu à leurs propres outils ou à un flux d’automatisation. Le SDK n’est pas un guide d’utilisation de l’interface standard de 3ds Max ou d’un autre logiciel de modélisation : c’est une API destinée à développer des intégrations s’appuyant sur le moteur V-Ray. Dans les agences d’architecture, son utilité directe dépend donc de la présence d’une intégration reposant sur le SDK dans les logiciels utilisés.

De l’installation à l’image : les étapes

1. Préparez les chemins du SDK. La documentation demande de définir la variable d’environnement VRAY_SDK. Si la liaison Python est utilisée, le dossier python du SDK doit être ajouté au chemin de recherche des modules Python. Pour Windows, la documentation donne l’exemple de l’exécution de setenv.bat ; pour Linux et macOS, celui de source setenv.sh. Ces scripts définissent les variables d’environnement correspondantes.

2. Vérifiez l’emplacement des bibliothèques. Lorsque VRAY_SDK est défini, la liaison du SDK recherche les fichiers binaires nécessaires et leurs dépendances dans VRAY_SDK/bin. Si le dossier du produit ne contient pas de répertoire bin, il est possible d’utiliser VRAY_APPSDK_BIN ; dans ce cas, la recherche s’effectue dans le dossier indiqué. La documentation précise également qu’en l’absence de variable d’environnement, le chemin de recherche des bibliothèques peut être défini à l’exécution.

3. Créez le renderer et chargez la scène. VRayRenderer est la classe principale qui lance et contrôle le processus de rendu. Il est possible de créer une scène avec de nouveaux objets plugin et leurs paramètres, ou de charger un fichier .vrscene. Les deux approches peuvent aussi être combinées. Lors du développement d’une intégration, il convient de déterminer à cette étape comment les données de scène seront fournies.

4. Choisissez le mode de rendu et lancez le rendu. Le mode par défaut indiqué dans la documentation est Interactive (CPU). L’appel à start() est asynchrone : le rendu se poursuit dans un thread distinct pendant que l’application effectue d’autres opérations. La possibilité de récupérer une image intermédiaire pendant le rendu permet de suivre la progression dans le cadre d’un flux d’aperçu. Une fois le rendu terminé, l’image finale est prête.

5. Récupérez l’image et libérez les ressources. Le SDK fournit l’image rendue sous forme d’objet image, qui peut être affiché à l’écran ou enregistré dans les formats pris en charge. Lorsque le travail est terminé, il faut fermer le renderer et libérer les ressources mémoire utilisées : c’est la dernière étape du flux de base décrit dans la documentation.

Court exemple Python illustrant l’ordre des appels indiqué dans la documentation :

import vray

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

Les noms de fichiers utilisés ici sont ceux de l’exemple de la documentation. Ce code doit être intégré à une solution qui adapte le chemin du fichier de scène et l’emplacement d’enregistrement de l’image finale au projet concerné.

Aperçu ou rendu final ?

Le SDK définit deux modes de rendu. Le mode Interactive convient à l’aperçu rapide de l’image et permet d’obtenir un retour progressif lors des modifications des paramètres de scène. Le mode Production est destiné à générer l’image finale souhaitée une fois la scène soigneusement préparée ; l’obtention de l’image complète peut prendre plus de temps. Il est possible de changer de mode entre deux rendus sans recréer le renderer ni recharger la scène.

Pour le GPU, la documentation répertorie CUDA et OptiX comme options pour NVIDIA, ainsi que Metal et MetalRT pour Apple. Il convient donc de vérifier dès le début de l’intégration la compatibilité du matériel et de la technologie de rendu utilisée. La prise en charge des plugins varie également : dans la référence de l’API, certains composants sont indiqués comme entièrement pris en charge, d’autres comme partiellement pris en charge et d’autres encore comme dépourvus de prise en charge GPU. Cela signifie qu’une fonctionnalité de scène donnée ne fonctionnera pas nécessairement avec toutes les méthodes de rendu.

Conséquences pour les workflows d’architecture et de visualisation

Pour les équipes de visualisation architecturale, l’intérêt du SDK réside dans la possibilité de relier les étapes répétitives de rendu à une application. Un outil de projet peut charger un fichier .vrscene, proposer un aperçu, suivre l’état du rendu et enregistrer l’image. Le rendu distribué figure aussi dans la documentation du SDK, mais les logiciels et configurations matérielles avec lesquels les équipes pourront l’utiliser dépendront de leurs propres intégrations.

Le choix du mode de rendu peut simplifier le workflow : Interactive pour tester les matériaux, l’éclairage et le cadrage ; Production pour l’image finale d’une scène approuvée. La documentation du SDK ne fournit toutefois pas de comparaison chiffrée des temps de rendu, des exigences matérielles ou des conditions de licence. Les agences doivent donc tester la compatibilité et le matériel dans leur propre environnement, avec des scènes de projets réels.

Erreurs fréquentes

• Omettre les variables d’environnement : si VRAY_SDK n’est pas défini, la liaison risque de ne pas trouver les bibliothèques nécessaires. Le chemin des modules Python doit également être configuré.

• Négliger le fonctionnement asynchrone : start() lance le rendu en arrière-plan. La documentation indique qu’il ne faut modifier ni la scène ni le renderer lorsque celui-ci est à l’état PREPARING ; ces tentatives peuvent être rejetées.

• Confondre le mode aperçu et le mode final : Interactive est prévu pour obtenir rapidement un retour, tandis que Production sert à générer l’image préparée. Utiliser les deux modes à différentes étapes du travail permet de mettre en place un flux plus cohérent.

• Tenir la compatibilité des plugins pour acquise : dans la référence de l’API, la prise en charge du GPU varie selon les plugins. Il faut vérifier, lors des tests d’intégration, la compatibilité des composants de scène utilisés avec la méthode de rendu visée.

Le workflow présenté dans ce guide s’appuie sur l’utilisation générale décrite dans la documentation de Chaos pour V-Ray App SDK ; celle-ci ne précise pas de version logicielle particulière.