En bref
- La plage de la scène, l’image courante et la plage de simulation se règlent à l’aide des propriétés Scene.
- La caméra active, la valeur de focale et les guides de composition figurent parmi les propriétés de Camera.
- La résolution du rendu, la fréquence d’images et le comportement de sortie se règlent via RenderSettings.
- Certaines anciennes propriétés de compositing sont signalées comme devant être abandonnées dans la documentation actuelle de l’API.
Ce que vous allez apprendre dans ce guide
L’API Python de Blender permet de modifier par code des données telles que la plage temporelle d’une scène et sa caméra active. Les paramètres de rendu peuvent également être contrôlés à partir des données de rendu de cette même scène. Ce guide aborde des réglages essentiels réutilisables en visualisation architecturale et pour les présentations d’intérieurs : images de la scène et de la simulation, focale de la caméra et guides de cadrage, résolution de sortie et fréquence d’images.
Les exemples supposent qu’un bloc de données Scene existant se trouve dans la variable scene et qu’un bloc de données Camera existant se trouve dans la variable camera. Les extraits de code sont des affectations à appliquer aux propriétés indiquées, et non un script de configuration qui prépare ces variables. La documentation de l’API décrit les noms des propriétés et les plages de valeurs acceptées. Il est donc plus facile de comparer les résultats de réglages adaptés ou non à la scène en testant les modifications sur une copie du fichier de projet.
Prérequis
Il faut disposer de Blender et des propriétés Scene, RenderSettings et Camera décrites dans la documentation de l’API Python. Les sources ne précisent aucune version particulière de Blender, aucun type de compte ni aucune condition tarifaire. Les exemples de code doivent être exécutés dans un contexte Python où les références Scene et Camera sont accessibles ; ce guide ne suppose aucun chemin de menu ni aucune étape d’installation non documentée pour obtenir ces références.
Chaque réglage a un rôle différent. Les propriétés Scene définissent la plage d’images de la scène et sa caméra active, tandis que RenderSettings gère le comportement du rendu et de la sortie. Les propriétés Camera, quant à elles, stockent des données de caméra telles que la focale et les guides de cadrage. Déterminer d’abord quel bloc de données modifier permet de réduire le risque d’intervenir sur la mauvaise propriété.
Étape 1 : régler la plage d’images de la scène
Dans le bloc de données Scene, frame_start et frame_end indiquent respectivement le début et la fin de la plage de lecture et de rendu. frame_current correspond à l’image courante. Définir explicitement ces valeurs pour une animation ou une présentation architecturale par étapes permet de rendre le minutage de la scène visible dans le script.
L’exemple ci-dessous définit une plage de scène allant de 1 à 120. Ces valeurs sont des réglages d’exemple compris dans la plage autorisée indiquée dans la documentation ; elles ne constituent pas un nombre d’images obligatoire pour un projet donné.
scene.frame_start = 1
scene.frame_end = 120
scene.frame_current = 1La plage temporelle des simulations peut être indépendante de la plage générale de la scène. simulation_frame_start et simulation_frame_end déterminent le début et la fin de la simulation. use_custom_simulation_range permet de choisir si la simulation doit utiliser une plage différente de celle de la scène. Cette option est importante lorsqu’il faut distinguer des plages de scène et de simulation de durées différentes.
scene.use_custom_simulation_range = True
scene.simulation_frame_start = 1
scene.simulation_frame_end = 120La modification de ces valeurs ne garantit pas à elle seule le résultat visuel de la simulation. Il faut également vérifier si les nœuds de simulation du projet remplacent leur propre plage d’images ; la documentation de l’API indique que la plage personnalisée sert lorsque ces nœuds ne modifient pas eux-mêmes leur plage.
Étape 2 : contrôler la caméra active et la composition
La propriété camera de la scène contient la caméra active utilisée pour le rendu. Dans le bloc de données de la caméra, lens définit la focale d’une caméra en perspective, en millimètres. lens_unit permet de choisir si la focale est réglée en millimètres ou selon l’angle de champ dans l’interface. L’exemple suivant suppose que les données de la caméra sont déjà disponibles dans une variable.
camera.lens_unit = 'MILLIMETERS'
camera.lens = 35.0Des guides de composition peuvent être affichés dans la vue caméra. Par exemple, le guide des tiers s’active ou se désactive avec show_composition_thirds, tandis que celui du nombre d’or utilise la propriété show_composition_golden. Ces guides aident à évaluer le cadrage ; ils ne modifient pas automatiquement la géométrie de la scène ni la position de la caméra.
camera.show_composition_thirds = TruePour évaluer un cadrage en intérieur architectural, il convient d’examiner ensemble le rapport d’image et le champ de vision de la caméra. L’API Camera comporte également des propriétés d’angle de champ horizontal et vertical. D’autres options, comme l’échelle orthographique et les types de panorama, sont disponibles ; toutefois, elles sont liées à d’autres types de caméras et usages, et ne doivent pas être considérées comme des réglages par défaut pour une caméra d’intérieur en perspective.
Étape 3 : régler la sortie du rendu et les paramètres liés aux performances
RenderSettings comprend la résolution horizontale et verticale ainsi que le pourcentage de résolution. La fréquence d’images se définit avec la propriété fps. L’exemple ci-dessous renseigne explicitement les valeurs de résolution et de fréquence d’images données comme valeurs par défaut dans la documentation. Si la taille d’image ou les paramètres d’animation attendus pour la livraison du projet sont différents, il faut adapter ces valeurs.
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100
scene.render.fps = 24Pour obtenir un aperçu plus rapide, il est possible de réduire resolution_percentage ; il faudra toutefois vérifier ce paramètre à nouveau avant le rendu final. La documentation définit cette propriété comme le pourcentage de la résolution de rendu. Pour utiliser une région de rendu, on dispose de use_border et des coordonnées de la bordure ; use_crop_to_border contrôle le recadrage de la sortie selon la région définie.
Le compositing doit également être vérifié dans le flux de rendu. Dans RenderSettings, use_compositing indique si le résultat du rendu passe par un groupe de nœuds de compositing assigné à la scène. La documentation précise que l’ancienne propriété Scene.use_nodes n’a plus d’effet et qu’il faut utiliser scene.render.use_compositing pour activer ou désactiver le compositing. La propriété compositing_node_group est également signalée comme devant être abandonnée à partir de la version 5.0 ; la documentation indique que sa suppression est prévue pour la version 6.0. Il convient donc de comparer les noms de propriétés utilisés dans les anciens scripts avec la description actuelle de l’API.
Erreurs fréquentes et étapes suivantes
L’une des erreurs les plus fréquentes consiste à confondre la plage de la scène et la plage de simulation. Une autre est de modifier les propriétés d’un autre bloc de données Camera au lieu de celles de la caméra active. Avant la sortie finale, il faut également contrôler ensemble le pourcentage de résolution, les dimensions et la fréquence d’images. use_persistent_data peut conserver les données en mémoire pour accélérer les rendus suivants et les rendus d’animation ; toutefois, selon la documentation de l’API, cela augmente la consommation de mémoire.
Pour la suite, testez chaque groupe de réglages dans un extrait de script distinct : d’abord la plage d’images, puis le cadrage de la caméra, et enfin les paramètres de sortie. Après chaque modification, lancez un bref aperçu et comparez les résultats. Si les mêmes valeurs doivent être utilisées dans plusieurs projets, regrouper les affectations dans un script bien organisé peut améliorer la reproductibilité ; vérifiez toutefois que les références à la scène et à la caméra actives sont correctes. Même si une option GPU apparaît dans les paramètres de rendu, les sources ne promettent ni compatibilité matérielle particulière ni résultat de performance ; il faut effectuer des tests sur le système utilisé.
Sources et licence
Ce guide a été traduit et adapté à partir des descriptions de Scene, RenderSettings et Camera dans la documentation de l’API Blender. Les documents sources sont publiés sous licence CC BY-SA 4.0 : pages Scene, RenderSettings et Camera de l’API Blender.
Sources
3 sourcesLes textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.
Pour les agences d’architecture et les équipes de visualisation en Turquie, l’intérêt pratique de ces fonctionnalités tient à leur capacité à rendre plus cohérents les réglages de scène et de sortie fréquemment répétés. Gérer par script la plage d’animation, la résolution et le cadrage de la caméra peut notamment faciliter le suivi des paramètres lors du transfert d’un projet.
L’utilisation de l’API ne réduit toutefois pas à elle seule le temps de rendu ; les données de rendu persistantes peuvent augmenter la consommation de mémoire, et l’intérêt de l’option GPU dépend du système utilisé. Les agences doivent tester leurs scripts avec leur propre structure de scène et comparer également l’ancien usage de `use_nodes` avec les propriétés actuelles. Les sources ne précisant ni prix des produits ni compatibilité matérielle, ce guide ne suffit pas à lui seul pour prendre une décision d’achat ou de performance.
Questions fréquentes
Comment modifier la plage d’images d’une scène avec l’API Python de Blender ?
Les propriétés `frame_start` et `frame_end` du bloc de données Scene définissent respectivement le début et la fin. L’image courante peut être réglée avec `frame_current`.
Peut-on régler la résolution du rendu dans Blender avec Python ?
Oui. Les propriétés `resolution_x`, `resolution_y` et `resolution_percentage` de RenderSettings contrôlent la résolution et son échelle.
Faut-il utiliser `Scene.use_nodes` dans l’API Blender ?
Selon la documentation actuelle de l’API, cette propriété est signalée comme devant être abandonnée à partir de la version 5.0 et sa modification n’a aucun effet. La propriété indiquée pour contrôler le compositing est `scene.render.use_compositing`.



