Automatiser le rendu avec V-Ray App SDK : 6 étapes, de la scène à l’image

V-Ray App SDK fournit une API permettant de lancer et de gérer des rendus avec le moteur V-Ray, depuis une application ou dans un processus distinct. Selon la documentation officielle de Chaos, la scène peut être créée en mémoire à l’aide des plug-ins V-Ray ou chargée à partir d’un fichier .vrscene. Ce guide présente le cycle de rendu essentiel d’App SDK et explique dans quelles situations les différents modes de rendu sont utiles. Comme la documentation ne précise pas de version logicielle applicable à App SDK, les explications reposent sur le workflow général qui y est décrit.

1. Préparer l’environnement

1. Définissez l’emplacement des fichiers App SDK. La documentation demande de définir la variable d’environnement VRAY_SDK pour pouvoir utiliser le SDK. Pour utiliser la liaison Python, le dossier python doit être ajouté aux chemins de recherche des modules Python ; la documentation en donne un exemple avec PYTHONPATH. Cette préparation permet à l’application de trouver les composants du SDK.

2. Exécutez le script d’environnement fourni ou envisagez une autre méthode. La documentation montre l’utilisation de setenv.bat sous Windows et de source setenv.sh sous Linux et macOS. Ces scripts configurent les variables d’environnement correspondantes. Si les fichiers binaires du SDK ne se trouvent pas dans l’arborescence /bin du produit, la documentation indique qu’il est possible d’utiliser la variable VRAY_APPSDK_BIN. Si les variables d’environnement ne peuvent pas être utilisées, l’API permet également de définir le chemin de recherche.

À ce stade, vérifiez que l’arborescence des dossiers sur l’ordinateur correspond à l’emplacement où l’application recherche la bibliothèque SDK. La documentation ne répertorie ni configuration système ni exigences matérielles spécifiques ; pour les détails d’installation, il faut donc se référer à la documentation API de la liaison utilisée.

2. Créer ou charger la scène

1. Initialisez le contrôleur de rendu. La classe VRayRenderer d’App SDK lance et gère le processus de rendu. La scène peut être construite en mémoire en créant des objets plug-in V-Ray et en réglant leurs paramètres ; l’autre possibilité consiste à charger un fichier .vrscene, le format de scène de V-Ray. La documentation précise que les deux méthodes peuvent aussi être combinées.

La méthode de création de la scène dépend du pipeline de production existant. Une application peut, par exemple, convertir ses propres données de scène en plug-ins V-Ray ou ouvrir un fichier .vrscene exporté au préalable. App SDK n’impose pas l’utilisation d’un logiciel de modélisation spécifique : il sert à intégrer le moteur de rendu V-Ray à ce type de workflow.

1. Une fois la scène prête, choisissez le mode de rendu. La documentation décrit deux options principales :

Les deux modes prennent en charge les options CPU et GPU. La documentation précise que CUDA et OptiX sont réservés à NVIDIA, tandis que Metal et MetalRT sont réservés à Apple. Le type de rendu se choisit avec la propriété renderMode de l’objet VRayRenderer. Selon la documentation, le mode par défaut de la classe est Interactive (CPU) ; il convient donc de choisir explicitement le mode en fonction de l’objectif de l’application et de la prise en charge du système.

3. Lancer le rendu et récupérer le résultat

1. Lancez le rendu. La méthode start() exécute le rendu dans un thread distinct et renvoie la main sans attendre. L’application peut ainsi effectuer d’autres tâches pendant le rendu ou rester disponible pour récupérer des images d’aperçu. L’exemple Python de la documentation charge la scène, lance le rendu, attend sa fin et enregistre l’image obtenue au format PNG :

import vray

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

Dans cet exemple, la valeur 6000 est un argument fourni à l’appel waitForRenderEnd dans la documentation ; elle n’est pas présentée comme une durée recommandée ou obligatoire pour toutes les scènes. Dans le code de production, le comportement de l’attente doit être traité conformément à la documentation de la liaison API utilisée.

1. Évaluez l’image pendant le rendu et libérez les ressources. App SDK permet de récupérer les données d’image disponibles avant la fin du rendu. Cette fonctionnalité peut notamment servir à afficher un aperçu dans l’interface de l’application ou à suivre le processus en mode Interactive. Selon la documentation, le rendu est terminé lorsque le renderer atteint l’état IDLE_DONE. Une fois le travail achevé, le renderer doit être fermé ; dans l’exemple Python, le bloc with gère ce cycle de vie.

La documentation explique également qu’il est possible d’écouter des événements lorsque l’état du rendu change, lorsque V-Ray génère un message ou lorsqu’il transmet des informations sur les tâches et la progression. Ces notifications aident une intégration à gérer les comportements côté application pendant le chargement, le rendu et la finalisation. Toutefois, les fonctions de rappel s’exécutent dans un thread distinct ; du code utilisateur lent peut retarder l’exécution des autres fonctions de rappel.

Qu’est-ce que cela change pour l’architecture et la visualisation architecturale ?

App SDK est utile aux équipes qui souhaitent intégrer des étapes de rendu répétitives à une application ou gérer une scène V-Ray depuis un autre processus. Les agences d’architecture et les studios de visualisation architecturale peuvent utiliser le mode Interactive pour tester les scènes et leur contenu, puis le mode Production pour créer les images finales. Le workflow peut ainsi passer de l’aperçu à l’image finale avec le même renderer.

Cela dit, les sources ne fournissent ni matrice de compatibilité avec des logiciels 3D spécifiques, ni exigences matérielles, ni conditions de licence, ni informations tarifaires. Pour choisir entre CPU et GPU, on peut uniquement tenir compte des options de traitement indiquées dans la documentation et des limites de plateforme des technologies GPU concernées ; aucune conclusion sur les performances ne peut être tirée. Avant de mettre en place l’intégration à l’application, vérifiez la documentation API de la liaison utilisée et l’emplacement des bibliothèques SDK.

Erreurs fréquentes

• Lancer la liaison SDK sans avoir défini VRAY_SDK ou un chemin alternatif approprié peut empêcher la localisation des bibliothèques.

• Il ne faut pas interpréter l’appel start() comme la fin du rendu : la documentation le décrit comme un appel asynchrone qui rend la main sans attendre.

• Toute tentative de modification de la scène ou du renderer pendant le rendu, à l’état PREPARING, peut être refusée. La documentation signale ce problème dans le cas où start() est utilisé à la place de startSync().

• Des fonctions de rappel lentes associées aux événements V-Ray peuvent retarder l’exécution d’autres fonctions de rappel ; il faut donc examiner le travail effectué par les gestionnaires d’événements.

• Utiliser l’argument d’attente de l’exemple de code comme un réglage fixe applicable à chaque projet irait au-delà des informations fournies dans la documentation.

Cette documentation présente les principes de base du chargement d’une scène et de la gestion du rendu avec App SDK, et non le choix de réglages de rendu spécifiques dans l’interface utilisateur. Pour les détails des réglages au sein de l’application, consultez la référence API de la liaison concernée.