Réaliser un rendu architectural en ligne de commande avec Blender 5.2 LTS

Ce que vous apprendrez dans ce guide

Il n’est pas toujours nécessaire d’utiliser l’interface de Blender pour chaque étape de la création d’images. Les options en ligne de commande permettent de rendre un fichier blend sans ouvrir l’interface, de choisir une image ou une animation et de définir le nom et l’emplacement des fichiers de sortie. Avec Cycles, ce flux de travail permet également de spécifier le périphérique de rendu, de sélectionner une plage d’images et d’exécuter un script Python.

Cette méthode peut aider à organiser le flux de travail, notamment pour produire plusieurs images d’une même scène ou automatiser des tâches répétitives. La ligne de commande ne remplace toutefois pas les réglages de la scène : le fichier blend à rendre et son contenu doivent être préparés au préalable. Ce guide ne porte pas sur la configuration de la scène, mais sur le lancement du rendu à l’aide des options de commande documentées de Blender.

Prérequis

La documentation de Blender sur la ligne de commande est présentée sous l’intitulé Blender 5.2 LTS. Il faut disposer du fichier blend et de la scène à rendre. Les sources ne mentionnent pas d’autre exigence de compte pour cette méthode. Blender doit être installé dans l’environnement utilisé et accessible depuis la ligne de commande.

Si vous utilisez l’option Cycles, le moteur de rendu de la scène doit être réglé sur Cycles et le périphérique approprié doit être sélectionné. La documentation répertorie les options de périphérique suivantes : CPU, CUDA, OPTIX, HIP, ONEAPI et METAL. Les options disponibles dépendent du système et de la configuration. La documentation ne garantit pas la compatibilité avec un matériel donné. Il est donc important de tester l’option dans votre environnement de travail avant de l’utiliser en production.

Rendu en ligne de commande, étape par étape

1. Lancez Blender sans interface

-b ou --background lance Blender sans interface. La commande s’organise généralement ainsi : la commande Blender, suivie des options, puis du nom de fichier et, le cas échéant, d’autres options. Remplacez le nom de fichier par celui de votre projet blend ; l’exemple ci-dessous est la commande de rendu d’animation fournie dans la documentation.

blender -b animation.blend -o //render_ -F PNG -x 1 -a

Dans cet exemple, -a rend l’animation entre les images de début et de fin. -o définit le chemin et le nom des fichiers de sortie ; -F, le format ; et -x, l’ajout ou non de l’extension de fichier. L’exemple utilise le format PNG et définit l’option d’ajout de l’extension sur 1.

2. Planifiez le chemin de sortie et la numérotation des images

Un chemin de sortie commençant par // est défini relativement au fichier blend. Pour générer les fichiers d’une animation avec une racine de nom unique, vous pouvez utiliser un chemin comme //render_ dans l’exemple. Lorsque le nom de fichier contient des caractères #, ceux-ci sont remplacés par le numéro de l’image ; leur nombre détermine la longueur du numéro avec des zéros de remplissage. La documentation montre, par exemple, que le nom animation_##_test.png est complété par le numéro de l’image. Si le nom de fichier ne contient pas de #, Blender ajoute #### à la fin.

Pour choisir les images à rendre, utilisez -f ou --render-frame. Vous pouvez spécifier un seul numéro d’image, une liste de numéros séparés par des virgules ou une plage écrite avec .. ; n’insérez pas d’espaces dans la liste. Les options -s et -e permettent également de définir séparément les images de début et de fin. Vous pouvez ainsi tester certaines images plutôt que de rendre l’animation entière.

3. Effectuez le rendu d’une seule image

Pour tester une image, utilisez l’option -f. Voici l’exemple de la documentation qui ouvre le fichier en arrière-plan, rend l’image 20 et spécifie le périphérique Cycles :

blender -b file.blend -f 20 -- --cycles-device OPTIX

Les deux tirets indiquent que les options qui suivent sont destinées à l’extension Cycles. OPTIX est le périphérique choisi dans cet exemple ; parmi les autres options susceptibles d’être utilisées selon le système figurent CPU, CUDA, HIP, ONEAPI et METAL. La présence d’un périphérique dans cette liste ne signifie pas qu’il fonctionnera sur tous les ordinateurs. Effectuer d’abord un court rendu de test et en vérifier le résultat permet de repérer d’éventuels problèmes avant de lancer une longue animation.

4. Rendez l’animation ou les images sélectionnées

Utilisez -a pour rendre l’animation entière, de la première à la dernière image. Si les valeurs de début et de fin diffèrent de celles définies dans la scène, spécifiez-les séparément avec -s et -e. L’option -j permet de régler le pas entre les images rendues. Par exemple, une liste d’images de contrôle sélectionnées facilite l’évaluation de l’apparence de la scène sans lancer le rendu de toute l’animation.

Sélectionnez le format de rendu avec -F. Outre des formats tels que PNG, JPEG, TIFF, HDR et BMP, la documentation répertorie d’autres formats disponibles sous réserve qu’ils soient compilés sur certains systèmes. Ne partez pas du principe que tous les formats sont disponibles dans chaque configuration ; tenez compte des exigences de livraison du flux de travail et de la disponibilité du format dans votre installation Blender.

5. Évaluez les options Cycles et les threads du processeur

Pour spécifier le périphérique Cycles, saisissez les options après les deux tirets. La documentation indique également qu’il est possible d’ajouter +CPU à un périphérique GPU pour utiliser le CPU et le GPU ensemble. Vérifiez si cette configuration convient à votre travail ; les sources ne promettent aucun gain de vitesse ou de performance pour une scène donnée.

L’option -t ou --threads définit le nombre de threads utilisés pour le rendu et les autres opérations. La plage documentée est de 1 à 1024 ; la valeur 0 utilise le nombre de processeurs du système. Ce réglage permet de contrôler le comportement de la station de travail pendant le rendu. Toutefois, les options de la ligne de commande ne vérifient pas à elles seules la compatibilité du matériel ou des pilotes.

6. Exécutez un script Python

Blender intègre un interpréteur Python ; des modules comme bpy peuvent servir à accéder aux données de Blender. L’option --python est documentée pour exécuter un fichier Python depuis la ligne de commande :

blender --python /home/me/my_script.py

Pour interagir avec les données de Blender, les scripts doivent importer les modules Blender nécessaires. Lors de l’appel des opérateurs bpy.ops, les propriétés sont transmises sous forme d’arguments nommés ; un appel effectué dans un contexte inapproprié peut générer une erreur. Pour réduire ce risque, la documentation illustre la vérification poll() de l’opérateur. Le réglage d’exécution automatique des scripts Python est désactivé par défaut ; -y l’active et -Y le désactive. Choisissez le réglage nécessaire en connaissance de cause, sans confondre l’exécution d’un script avec les options d’exécution automatique.

Qu’est-ce que cela change pour les flux de travail d’architecture et de visualisation ?

Le rendu en ligne de commande peut être pratique pour les agences d’architecture, les architectes d’intérieur et les artistes archviz qui souhaitent traiter des images répétitives dans un même fichier, produire les images d’une animation selon une convention de nommage cohérente ou éviter d’ouvrir l’interface pendant le rendu. Les étudiants peuvent également vérifier les réglages de la scène et de sortie avec quelques images avant de passer à l’animation. Définir le chemin de sortie relativement au fichier blend aide à clarifier le lien entre le fichier de projet et les rendus.

Les principaux points d’attention concernent le matériel, la compatibilité et l’organisation des fichiers. Choisissez parmi les options de périphérique réellement disponibles sur votre système et effectuez un rendu limité pour vérifier le résultat avant de lancer un travail portant sur de nombreuses images. Dans les projets auxquels participent plusieurs personnes, précisez clairement le nom des fichiers, la plage d’images, le format et l’emplacement de sortie. Les sources ne fournissent aucune information sur les licences ou les tarifs ; ce guide explique l’utilisation de la ligne de commande et la signification des options.

Erreurs fréquentes

• Placer l’option Cycles au mauvais endroit : l’option --cycles-device doit être indiquée après les deux tirets. Respectez la structure de commande de l’exemple.

• Laisser l’emplacement de sortie imprécis : définissez le chemin et la racine du nom de fichier avec l’option -o. Si vous utilisez //, n’oubliez pas que le chemin est relatif au fichier blend.

• Négliger le format du numéro d’image : les caractères # influent sur la numérotation et le remplissage par des zéros. Vérifiez le nom de fichier à l’avance.

• Lancer directement une longue animation : commencez par une seule image ou une sélection d’images, puis vérifiez le format et le chemin de sortie.

• Appeler un opérateur sans vérifier le contexte : dans un script Python, poll() permet de vérifier au préalable le contexte dans lequel l’opérateur peut être exécuté.

Étapes suivantes

Commencez par préparer une commande de test pour une seule image, puis vérifiez le chemin et le format de sortie. Si le résultat est créé au bon emplacement et sous le nom attendu, reprenez la même organisation pour le rendu de l’animation. Si vous utilisez un script Python, commencez par une petite opération ; vérifiez le contexte requis pour les appels d’opérateur ainsi que le résultat de poll(). Confirmez les options nécessaires dans la documentation de Blender sur la ligne de commande et l’API ; sans aller au-delà des options répertoriées dans les sources, testez le comportement de votre version et de votre système.

Sources et licence

Ce guide est une adaptation en turc de la documentation officielle de Blender sur les arguments de ligne de commande, les opérateurs bpy.ops et la présentation générale de l’API Python. Les trois sources sont sous licence CC BY-SA 4.0. Les exemples de commande et les explications techniques s’appuient sur les informations de ces documents sous licence libre.