Rendu en ligne de commande et automatisation Python dans Blender 5.2 LTS

Ce que vous allez apprendre dans ce guide

Il n’est pas nécessaire de tout faire dans Blender par l’intermédiaire de l’interface. La ligne de commande permet de lancer des rendus en arrière-plan et de répéter une opération à l’aide de la même commande. L’API Python de Blender donne accès aux objets et autres données du fichier ouvert, ce qui permet notamment de générer des rapports simples.

Dans ce guide, nous utiliserons les options de rendu documentées pour la ligne de commande de Blender 5.2 LTS afin de produire une image et une animation. Nous créerons ensuite un rapport de scène simple avec l’environnement Python intégré à Blender, puis lancerons le script depuis la ligne de commande. Les exemples ne présument ni des réglages d’un fichier de scène réel ni de la compatibilité du matériel : adaptez les commandes à vos fichiers et à vos besoins de rendu.

Prérequis

• Blender doit être installé. Les exemples de commandes s’appuient sur la documentation de la ligne de commande de Blender 5.2 LTS.

• Il vous faut un fichier .blend à rendre et un accès à son emplacement.

• Pour utiliser la ligne de commande, vous aurez besoin du terminal de votre système d’exploitation. Pour l’exemple Python, vous pouvez utiliser l’espace de travail Scripting de Blender, l’éditeur de texte ou la Python Console.

• La documentation de la ligne de commande ne mentionne aucune exigence de compte utilisateur. La documentation de l’API Python de Blender précise que l’API est globalement stable, mais que certains domaines sont encore en cours de développement.

Étape par étape : lancer un rendu en arrière-plan

1. Effectuer le rendu d’une seule image

-b ou --background lance Blender sans interface utilisateur. -f indique le numéro de l’image à rendre ; -o définit le chemin de sortie et le nom du fichier ; -F spécifie le format de sortie. L’exemple ci-dessous rend l’image 20 du fichier sahne.blend au format PNG :

blender -b sahne.blend -o //render_ -F PNG -f 20

Un chemin de sortie commençant par // indique un emplacement relatif au fichier .blend. Si le nom de fichier ne contient pas de #, Blender ajoute automatiquement un suffixe de numérotation au nom pour indiquer le numéro de l’image. Pour produire plusieurs images, vous pouvez utiliser des caractères # dans le nom de fichier afin de définir l’emplacement du numéro d’image et son remplissage par des zéros.

2. Rendre l’animation sur la plage d’images de la scène

-a ou --render-anim effectue le rendu de l’animation entre les images de début et de fin, ces deux images étant incluses. Dans l’exemple ci-dessous, le chemin de sortie est relatif et le format choisi est PNG :

blender -b sahne.blend -o //animasyon_## -F PNG -a

Les options -s et -e permettent également de préciser les images de début et de fin. -j définit le nombre d’images à sauter entre les images rendues. Lorsque vous utilisez ces options, vérifiez la plage de la scène et l’échantillonnage des images souhaité ; ne rendre que les images nécessaires facilite le suivi du dossier de sortie.

-x ou --use-extension indique si l’extension doit être ajoutée aux fichiers de sortie. Pour demander explicitement l’ajout de l’extension, vous pouvez utiliser -x 1, comme dans l’exemple de la documentation. JPEG, PNG, TIFF et HDR font partie des formats répertoriés ; la disponibilité de certains formats peut dépendre de la version compilée de Blender.

3. Choisir le moteur de rendu, le nombre de threads et le périphérique Cycles

L’option -E permet de choisir le moteur de rendu ; -E help affiche la liste des moteurs disponibles. -t définit le nombre de threads utilisés pour le rendu et les autres opérations. La valeur 0 demande au système d’utiliser le nombre de processeurs disponibles.

L’option de périphérique Cycles s’ajoute après les options standard de la ligne de commande de Blender, en la séparant par un double tiret. La documentation répertorie CPU, CUDA, OPTIX, HIP, ONEAPI et METAL. Ne partez pas du principe que ces options fonctionneront sur l’ordinateur cible : vérifiez votre choix sur le système utilisé et avec votre installation de Blender.

blender -b sahne.blend -f 20 -- --cycles-device OPTIX --cycles-print-stats

Cet exemple sélectionne le périphérique OPTIX pour Cycles et demande l’enregistrement de statistiques sur l’utilisation de la mémoire et la durée du rendu. Ajouter +CPU au nom du périphérique GPU indique que le GPU et le CPU doivent être utilisés ensemble. Si le moteur de rendu n’est pas Cycles, consultez les options propres à ce moteur au lieu d’ajouter une option de périphérique spécifique à Cycles.

4. Lire les données de scène avec Python dans Blender

L’API Python de Blender permet de travailler avec les données de la scène et des objets accessibles depuis l’interface. Pour un premier essai, un petit script qui affiche les noms des objets de la scène suffit :

import bpy

for obj in bpy.data.objects:
    print(obj.name)

Pour exécuter ce script dans Blender, passez à l’espace de travail Scripting et ouvrez un nouveau bloc de texte dans l’éditeur de texte. Collez-y le code, puis exécutez-le avec Run Script. La Python Console permet aussi de tester de courtes commandes et d’explorer l’API avec la complétion automatique.

Le même fichier de script peut être exécuté en ligne de commande avec l’option --python :

blender -b sahne.blend --python rapor.py

Cette méthode permet d’exécuter de façon reproductible des rapports qui inspectent les données d’un fichier sans ouvrir l’interface. Pour les scripts lancés depuis la ligne de commande, la documentation mentionne également l’option --python-exit-code, qui permet de terminer avec un code de sortie spécifique en cas d’erreur Python. Définir un code de sortie peut aider les personnes qui intègrent le script à un flux de travail automatisé à repérer les échecs.

Erreurs courantes

• Mal interpréter le chemin de sortie : le chemin relatif // est associé au fichier .blend. Chercher le rendu dans un autre dossier en supposant qu’il s’y trouve peut donner l’impression qu’il a disparu.

• Confondre le numéro d’image et la plage : -f rend une seule image ; -a traite l’animation entre les images de début et de fin de la scène. Vérifiez les valeurs de -s et -e pour obtenir la plage souhaitée.

• Placer une option Cycles au mauvais endroit : les options Cycles telles que --cycles-device doivent apparaître après le séparateur -- dans la ligne de commande.

• Sélectionner un périphérique indisponible sur le matériel : la présence d’un nom de périphérique dans la documentation ne signifie pas que toutes les installations le prennent en charge. Commencez par effectuer un court rendu de test sur l’ordinateur cible.

• Chercher au mauvais endroit la sortie d’un script Python : selon la documentation de l’API Blender, la sortie de certains exemples s’affiche dans le terminal. Si le script s’est terminé mais que sa sortie n’apparaît pas, vérifiez le terminal depuis lequel Blender a été lancé.

Incidence sur les flux de travail en architecture et en visualisation

Le rendu en arrière-plan peut être utile aux équipes de visualisation qui souhaitent lancer par commande des images répétées ou des animations. Les scripts Python permettent aussi d’inspecter les données d’une scène et de produire des rapports simples. Cette approche ne remplace pas les décisions de modélisation ou de conception : elle standardise certaines opérations du processus de production.

Avant de commencer, vérifiez la version de Blender, le moteur de rendu utilisé, le format de sortie et la prise en charge du périphérique Cycles sur l’ordinateur cible. Les options de la ligne de commande facilitent le lancement du rendu, mais ne garantissent pas à elles seules que la scène produira le résultat attendu. Tester d’abord une image pour vérifier le chemin, le format et le périphérique, puis passer à l’animation, est une méthode plus contrôlée. Ces documents ne précisent pas les conditions de licence ou de compte ; les exigences d’installation et d’utilisation doivent être vérifiées séparément dans un contexte d’équipe.

Étapes suivantes

Après avoir vérifié l’exemple d’image unique avec votre propre fichier, passez à l’option d’animation et au nommage des fichiers de sortie. Côté Python, commencez par un script de rapport en lecture seule ; lister les noms des objets est un bon moyen de vérifier simplement l’accès à la scène. Vous pourrez ensuite ajouter les opérations nécessaires en consultant les options de commande et la référence de l’API. La documentation de l’API Python avertit que le contexte peut varier selon l’espace dans lequel il est utilisé et que certains opérateurs nécessitent un contexte valide. Il est donc important de tester le script avec la version de Blender et le contexte de scène où il sera exécuté.

Sources et licence

Ce guide s’appuie sur la page « Command Line Arguments » du Blender Manual et sur les pages « Quickstart » et « API Overview » de l’API Python de Blender. Les trois sources sont sous licence CC BY-SA 4.0 ; leur contenu a été adapté et reformulé en turc. Les exemples de commandes et le court script Python ont été préparés pour ce guide à partir des options documentées et de l’utilisation de l’API.