Arguments de la ligne de commande¶

Blender 5.2 LTS

Usage: blender [args ...] [file] [args ...]

Options de rendu¶

-b, --background

Lancer en arrière-plan (souvent utilisé pour le rendu sans recours à l’interface graphique).

Le périphérique audio est désactivé en mode arrière-plan par défaut et peut être réactivé en passant ensuite en -setaudio Default.

-a, --render-anim

Faire le rendu des trames du début à la fin (comprise).

-S, --scene <nom>

Définir la scène active <nom> pour le rendu.

-f, --render-frame <trame>

Faire le rendu de la trame <trame> et l’enregistrer.

+<trame> par rapport à la trame de début, -<trame> par rapport à la trame de fin.
Une liste de trames séparées par des virgules peut aussi être utilisée (pas d’espaces).
Une plage de trames peut être désignée en utilisant le séparateur .. entre la première et la dernière trame (comprise).

-s, --frame-start <trame>

Fixer le début à la trame <trame>, prend aussi en charge +/- les trames proches.

-e, --frame-end <trame>

Fixer la fin à la trame <trame>, prend aussi en charge +/- les trames proches.

-j, --frame-jump <trames>

Fixer le nombre de trames à avancer après chaque trame rendue.

-o, --render-output <chemin>

Définir le chemin et le nom de fichier du rendu. Utiliser // au début du chemin pour rendre relatif au fichier blend.

Vous pouvez utiliser des fonctionnalités de modèle de chemin telles que {blend_name} dans le chemin. Voir la documentation de Blender sur les modèles de chemin pour plus de détails.

Les caractères # sont remplacés par le numéro de trame, et servent à définir le zero padding.

animation_##_test.png devient animation_01_test.png
test-######.png devient test-000001.png

Si le nom de fichier ne contient pas de #, le suffixe #### est ajouté au nom de fichier.

Le numéro de trame sera ajouté à la fin du nom de fichier, ex. :

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

//render_ devient //render_####, en écrivant les trames comme //render_0001.png

-E, --engine <engine>

Spécifier le moteur de rendu. Utilisez -E help pour lister les moteurs disponibles.

-t, --threads <threads>

Utiliser le nombre de <threads> pour le rendu et les autres opérations [1-1024], 0 pour utiliser le nombre de processeurs du système.

Options de rendu de Cycles¶

Les options du module complémentaire Cycles doivent être spécifiées après un double tiret.

--cycles-device <device>

Définit le périphérique utilisé pour le rendu. Les options valides sont : CPU CUDA OPTIX HIP ONEAPI METAL.

Ajouter +CPU à un périphérique GPU pour effectuer le rendu sur le CPU et le GPU.

Exemples :

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

--cycles-print-stats

Enregistre les statistiques sur la mémoire de rendu et l’utilisation du temps.

Options de format¶

-F, --render-format <format>

Définir le format de rendu. Les options valides sont : TGA RAWTGA JPEG IRIS PNG BMP HDR TIFF.

Formats qui peuvent être compilés dans Blender, non disponibles sur tous les systèmes : OPEN_EXR OPEN_EXR_MULTILAYER FFMPEG CINEON DPX JP2 WEBP.

-x, --use-extension <bool>

Définir l’option d’ajout de l’extension de fichier à la fin du fichier.

Options de lecture d’animation¶

-a <options> <fichier(s)>

Au lieu d’afficher l’interface utilisateur de Blender, ceci lance Blender comme un lecteur d’animation, pour visionner des films et des séquences d’images rendues dans Blender (ignoré si -b est mis).

Arguments de lecture :

-p <sx> <sy>: Ouvrir avec le coin inférieur gauche à <sx>, <sy>.
-m: Lire depuis le disque (sans mise en tampon).
-f <fps> <fps_base>: Spécifier le FPS de départ.
-j <frame>: Fixer le pas des trames à <trame>.
-s <trame>: Lire à partir de <trame>.
-e <frame>: Lire jusqu’à <trame>.
-c <cache_memory>: Quantité de mémoire en mégaoctets pour permettre la mise en cache des images pendant la lecture. Zéro désactive (le clampage à un nombre fixe d’images à la place).

Options de fenêtre¶

-w, --window-border: Ouverture forcée avec les bordures, dans un état normal (non maximisé).
-M, --window-maximized: Forcer l’ouverture maximisée.
-W, --window-fullscreen: Forcer l’ouverture en mode plein écran.
-p, --window-geometry <sx> <sy> <w> <h>: Ouvrir avec le coin inférieur gauche à <sx>, <sy> et la largeur et la hauteur à <w>, <h>.
-con, --start-console: Démarrer avec la Console ouverte (ignoré si -b est mis) (Uniquement Windows).
--no-native-pixels: Ne pas utiliser la taille de pixel d’origine, pour les affichages en haute résolution (MacBook Retina).
--no-window-frame: Désactiver toutes les décorations de fenêtre (Linux uniquement).
--no-window-focus: Ouvrir derrière d’autres fenêtres et sans fixer le focus.

Options Python¶

-y, --enable-autoexec

Activer l’exécution automatique des scripts Python.

-Y, --disable-autoexec

Désactiver l’exécution automatique des scripts Python (Python-drivers & startup scripts), (default).

-P, --python <filepath>

Lancer le script Python donné.

--python-text <name>

Lancer le bloc de texte script Python donné.

--python-expr <expression>

Exécuter l’expression donnée comme un script Python.

L’expression peut être un script complet à plusieurs lignes; limité uniquement par la longueur maximale des arguments de la plateforme.

--python-console

Lancer Blender avec une console interactive.

--python-exit-code <code>

Fixer le code de sortie dans l’intervalle [0..255] pour quitter si une exception Python est levée (uniquement pour les scripts exécutés depuis la ligne de commande) ; zéro désactive.

--python-use-system-env

Permettre à Python d’utiliser des variables d’environnement système telles que PYTHONPATH et le dossier site-packages de l’utilisateur.

--addons <addon(s)>

Liste séparée par des virgules (sans espaces) des modules complémentaires à activer en plus des modules complémentaires par défaut.

Options réseau¶

--online-mode: Autoriser l’accès à Internet, en remplaçant la préférence.
--offline-mode: Interdire l’accès à Internet, en annulant la préférence.

Options de logging¶

--log <match>

Activer les catégories de journalisation, en prenant un seul argument séparé par une virgule.

--log "*": everything --log "event": every category starting with event. --log "render,cycles": both render and cycles messages. --log "*mesh*": every category containing mesh sub-string. --log "*,^operator": everything except operators, with ^prefix to exclude.

--log-level <level>

Définir le niveau de verbosité de la journalisation.

fatal : Erreurs fatales uniquement: Erreurs avertissement uniquement: Avertissements infos: Informations sur les appareils, les fichiers, la configuration, les opérations débogage: Messages verbeux pour les développeurs trace: Traçage d’exécution de code très verbeux

--log-show-memory

Affichez l’utilisation de la mémoire pour chaque message de journal.

--log-show-source

Afficher le fichier source et le nom de la fonction en sortie.

--log-show-backtrace

Afficher une trace arrière (back trace) pour chaque message de log (uniquement les builds de débogage).

--log-file <filepath>

Définir un fichier pour la sortie du log.

--log-list-categories

Répertorier toutes les catégories de journalisation disponibles pour --log et quitter.

Options de débogage¶

-d, --debug

Activer le débogage.

Active la détection d’erreur de mémoire
Désactive la saisie par la souris (pour interagir avec un débogueur dans certains cas)
Garde le sys.stdin de Python plutôt que le fixer à None

--debug-value <value>

Fixer la valeur de débogage de <value> au démarrage.

--debug-events

Activer les messages de débogage pour les évènements système.

--debug-handlers

Activer les messages de débogage pour la gestion d’évènements.

--debug-libmv

Activer les messages de débogage de la bibliothèque libmv.

--debug-memory

Activer l’allocation de mémoire pleinement protégée et le débogage.

--debug-jobs

Activer le profilage en temps des tâches en arrière-plan.

--debug-python

Activer les messages de débogage pour Python.

--debug-depsgraph

Activer les messages de débogage du dependency graph.

--debug-depsgraph-eval

Activer les messages de débogage du dependency graph en relation avec l’évaluation.

--debug-depsgraph-build

Activer les messages de débogage du dependency graph en relation avec la construction de graphe.

--debug-depsgraph-tag

Activer les messages de débogage du dependency graph en relation avec le tagging.

--debug-depsgraph-no-threads

Basculer le graphique de dépendance vers une évaluation à thread unique.

--debug-depsgraph-time

Activer les messages de débogage du dependency graph en relation avec le minutage.

--debug-depsgraph-pretty

Activer les couleurs pour les messages de débogage du dependency graph.

--debug-depsgraph-uid

Vérifier la validité des identifiants à l’échelle de la session attribués aux blocs de données d’identification (ID data-blocks).

--debug-ghost

Activer les messages de débogage pour Ghost (Linux uniquement).

--debug-wintab

Activer les messages de débogage pour Wintab.

--debug-gpu

Activer le contexte et les informations de débogage GPU pour OpenGL 4.3+.

--debug-gpu-force-workarounds

Activer les solutions de rechange pour les problèmes typiques du GPU et désactiver toutes les extensions du GPU.

--debug-gpu-compile-shaders

Compiler tous les shaders définis statiquement pour tester la compatibilité de la plateforme.

--debug-gpu-shader-debug-info

Activer la génération d’informations de débogage de shader (Vulkan uniquement).

--debug-gpu-scope-capture

Capturer les commandes GPU émises dans le nom de portée donné.

--debug-gpu-shader-source

Enregistrer le code source du shader GPU compilé pour le nom du shader donné. Le nom donné peut contenir un joker “*” en tête ou à la fin pour correspondre à plusieurs shaders. Les fichiers sont sauvegardés dans le répertoire de travail actuel à l’intérieur d’un répertoire nommé “Shaders”.

--debug-gpu-shader-no-preprocessor

Passer le préprocesseur et compter plutôt sur le préprocesseur du pilote ou du compilateur shader. Désactive aussi l’élimination du code mort.

--debug-gpu-shader-no-dce

Passer la passe d’élimination du code mort.

--debug-gpu-no-texture-pool

Désactiver les optimisations d’aliasing mémoire dans le pool de textures GPU.

--debug-gpu-renderdoc

Activer l’intégration de Renderdoc pour la capture d’images et le débogage GPU.

--debug-gpu-vulkan-local-read

Force le rendu dynamique Vulkan en lecture locale lorsqu’il est pris en charge par l’appareil.

--debug-wm

Activer les messages de débogage pour le gestionnaire de fenêtre, affiche tous les opérateurs en recherche, affiche les erreurs de configuration de clavier.

--debug-xr

Activer les messages de débogage pour les contextes de réalité virtuelle. Active la couche de validation de l’API OpenXR, l’affichage des messages de débogage (OpenXR) et d’informations générales.

--debug-xr-time

Activer les messages de débogage pour les temps de rendu en réalité virtuelle.

--debug-all

Activer tous les messages de débogage.

--debug-io

Activer les messages de débogage pour les E/S.

--debug-fpe

Activer les exceptions des nombres flottants.

--debug-exit-on-error

Sortir immédiatement lorsque des erreurs internes sont détectées.

--debug-freestyle

Activer les messages de débogage pour FreeStyle.

--disable-crash-handler

Désactiver le gestionnaire de plantage.

--disable-abort-handler

Désactiver le gestionnaire de plantage.

--verbose <verbose>

Définir le niveau de verbosité des logs pour les messages de débogage qui le prennent en charge.

-q, --quiet

Supprimer l’affichage de l’état (les avertissements et les erreurs sont toujours affichés).

Options GPU¶

--gpu-backend

Forcer l’utilisation d’un backend GPU spécifique. Options valides : vulkan`, metal, opengl.

--gpu-vsync

Régler VSync. Les options valides sont : on, off & auto pour la synchronisation adaptative.

Les paramètres par défaut dépendent du pilote GPU.
La désactivation de VSync peut être utile pour tester les performances.
auto n’est pris en charge que par le backend OpenGL.

--gpu-compilation-subprocesses

Remplacer le paramètre Max Compilation Subprocesses (OpenGL uniquement).

--profile-gpu

Activer le profilage des performances CPU et GPU pour les groupes de débogage GPU (génère un fichier profile.json au Trace Event Format dans le répertoire actuel)

Options diverses¶

--open-last

Ouvrir le fichier blend le plus récemment ouvert, au lieu du fichier de démarrage par défaut.

--app-template <template>

Définir le modèle d’application (correspondant au nom du dossier), utiliser default pour none.

--factory-startup

Sauter la lecture du fichier startup.blend dans le dossier personnel de l’utilisateur.

--enable-event-simulate

Activer la fonction de test de simulation d’événement bpy.types.Window.event_simulate.

--env-system-datafiles

Définir la variable d’environnement BLENDER_SYSTEM_DATAFILES.

--env-system-scripts

Définir la variable d’environnement BLENDER_SYSTEM_SCRIPTS.

--env-system-extensions

Définir la variable d’environnement BLENDER_SYSTEM_EXTENSIONS.

--env-system-python

Définir la variable d’environnement BLENDER_SYSTEM_PYTHON.

-noaudio

Forcer le son système à None.

-setaudio

Forcer le système audio vers un dispositif spécifique : None Default SDL OpenAL CoreAudio JACK PulseAudio WASAPI.

-c, --command <command>

Exécuter une commande qui consomme tous les arguments restants. Utiliser -c help pour lister toutes les autres commandes. Passer --help après la commande pour voir son texte d’aide.

Cela implique le mode –background`.

-h, --help

Afficher ce texte d’aide et quitter.

/?

Afficher ce texte d’aide et quitter (Windows uniquement).

-r, --register

Enregistrer l’extension du fichier blend pour l’utilisateur actuel, puis quitter (Windows uniquement)).

--register-allusers

Enregistrer l’extension de fichier blend pour tous les utilisateurs, puis quitter (Windows et Linux uniquement)).

--unregister

Désenregistrer l’extension du fichier blend pour l’utilisateur actuel, puis quitter (Windows et Linux uniquement).

--unregister-allusers

Désenregistrer l’extension de fichier blend pour tous les utilisateurs, puis quitter (Windows et Linux uniquement).

--qos <level>

Définir le mode Qualité de service (QoS = Quality of Service ) pour les architectures de processeur hybride (Windows uniquement).

default : Utilise le comportement par défaut du système d’exploitation. high : Utilise toujours les performances des cœurs. eco : Planifie les threads Blender exclusivement vers les noyaux efficaces.

-v, --version

Afficher la version de Blender et quitter.

--

Terminer le traitement des options, les arguments suivants sont passés sans changement. Accès via sys.argv de Python.

Autres options¶

--disable-depsgraph-on-file-load

Mode Backround (arrière-plan) : Ne pas construire et ne pas évaluer systématiquement les graphiques de dépendances ViewLayers lors du chargement d’un fichier blend en mode arrière-plan (options -b ou -c).

Les scripts nécessitant des données évaluées doivent alors s’assurer explicitement qu’un depsgraph évalué est disponible (par exemple en appelant depsgraph = context.evaluated_depsgraph_get()).

NOTE : il s’agit d’une option temporaire, à l’avenir, depsgraph ne sera plus jamais généré automatiquement lors du chargement du fichier en mode arrière-plan.

--disable-liboverride-auto-resync

Ne pas effectuer pas de remplacement de bibliothèque lors de la resynchronisation automatique lors du chargement d’un nouveau fichier blend.

NOTE : il s’agit d’une autre méthode pour obtenir le même effet que lors de la définition de l’option User Preferences Debug No Override Auto Resync

--debug-ffmpeg

Activer les messages de débogage à partir de l’entrée et de la sortie vidéo FFmpeg.

--debug-cycles

Activer les messages de débogage de Cycles.

Analyse des arguments¶

Les arguments doivent être séparés par des virgules, ex. :

blender -ba test.blend

… va quitter puisque -ba est un argument inconnu.

Ordre des arguments¶

Les arguments sont exécutés dans l’ordre de leur présentation. ex. :

blender --background test.blend --render-frame 1 --render-output "/tmp"

… ne va pas faire le rendu dans /tmp parce que --render-frame 1 fait le rendu avant que le chemin de sortie soit défini.

blender --background --render-output /tmp test.blend --render-frame 1

… ne va pas faire le rendu dans /tmp parce que le chargement du fichier blend écrase la sortie de rendu qui a été définie.

blender --background test.blend --render-output /tmp --render-frame 1

… fonctionne comme prévu.

Variables d’environnement¶

BLENDER_USER_RESOURCES:: Remplace le répertoire par défaut de tous les fichiers utilisateur. Les autres variables BLENDER_USER_* sont remplacées lorsqu’elles sont définies.
BLENDER_USER_CONFIG:: Dossier pour les fichiers de configuration de l’utilisateur.
BLENDER_USER_SCRIPTS:: Dossier pour les scripts de l’utilisateur.
BLENDER_USER_EXTENSIONS:: Dossier pour les scripts de l’utilisateur.
BLENDER_USER_DATAFILES:: Dossier pour les fichiers de données utilisateur (icônes, traductions,…).
BLENDER_SYSTEM_RESOURCES:: Remplacer le répertoire par défaut de tous les fichiers de ressources regroupés.
BLENDER_SYSTEM_SCRIPTS:: Répertoires pour ajouter des scripts supplémentaires.
BLENDER_SYSTEM_EXTENSIONS:: Répertoire du dépôt d’extensions système.
BLENDER_SYSTEM_DATAFILES:: Répertoire pour remplacer les fichiers de données groupés.
BLENDER_SYSTEM_PYTHON:: Répertoire pour remplacer les bibliothèques Python groupées.
BLENDER_CUSTOM_SPLASH:: Chemin complet vers une image qui remplace l’écran de démarrage.
BLENDER_CUSTOM_SPLASH_BANNER:: Chemin complet vers une image à superposer sur l’écran de démarrage.
BLENDER_OCIO:: Chemin pour remplacer le fichier de configuration OpenColorIO. Si non définie, la variable d’environnement OCIO est utilisée.
SPNAV_SOCKET:: Le chemin du socket pour se connecter au démon souris-3D (Unix seulement
TEMP:: Enregistrer les fichiers temporaires ici.
TMPDIR:: Stocker les fichiers temporaires ici (systèmes UNIX). Le chemin doit référencer un répertoire existant sinon il sera ignoré.