Arguments de la Ligne de commande

Blender 2.81 Usage: blender [args …] [file] [args …]

Options de rendu

-b, --background
Se lancer en arrière-plan (souvent utilisé pour le rendu sans recours à l’interface graphique).
-a, --render-anim
Faire le rendu des trames du début à la fin (comprise).
-S, --scene <name>
Définir la scène active <name> pour le rendu.
-f, --render-frame <frame>

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

  • +<frame> par rapport à la trame de début, -<frame> 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 <frame>
Fixer le début à la trame <frame>, prend aussi en charge +/- les trames proches.
-e, --frame-end <frame>
Fixer la fin à la trame <frame>, prend aussi en charge +/- les trames proches.
-j, --frame-jump <frames>
Fixer le nombre de trames à avancer après chaque trame rendue.
-o, --render-output <path>

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

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 pour lister les moteurs disponibles.
-t, --threads <threads>
Utiliser le nombre de <threads> pour le rendu et les autres opérations (1-64), 0 pour le nombre de processeurs du système.

Options de format

-F, --render-format <format>

Définir le format de rendu. Les options valides sont : TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

Formats qui peuvent être compilés dans Blender, non disponibles dans tous les systèmes : HDR TIFF EXR MULTILAYER MPEG FRAMESERVER QUICKTIME CINEON DPX DDS JP2

-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> <file(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 à <frame>.
-s <frame>
Lire à partir de <frame>.
-e <frame>
Lire jusqu’à <frame>.

Options de fenêtre

-w, --window-border
Forcer l’ouverture avec bordures.
-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>.
-M, --window-maximized
Forcer l’ouverture maximisée.
-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-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 (par défaut).
-Y, --disable-autoexec
Désactiver l’exécution automatique des scripts Python (pydrivers & scripts de démarrage).
-P, --python <filename>
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.
--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.
--addons <addon(s)>
Liste d’add-ons séparés par des virgules (pas d’espaces).

Options de logging

--log <match>
Enable logging categories, taking a single comma separated argument. Multiple categories can be matched using a .* suffix, so --log "wm.*" logs every kind of window-manager message. Use « ^ » prefix to ignore, so --log "*,^wm.operator.*" logs all except for wm.operators.* Use « * » to log everything.
--log-level <level>
Set the logging verbosity level (higher for more details) defaults to 1, use -1 to log all levels.
--log-show-basename
Only show file name in output (not the leading path).
--log-show-backtrace
Show a back trace for each log message (debug builds only).
--log-show-timestamp
Show a timestamp for each log message in seconds since start.
--log-file <filename>
Set a file to output the log to.

Options de débogage

-d, --debug

Activer le débogage.

  • Active la détection d’erreur de mémoire
  • Désactive la saisie par 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-ffmpeg
Activer les messages de débogage de la bibliothèque FFmpeg.
--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-cycles
Activer les messages de débogage de Cycles.
--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
Switch dependency graph to a single threaded evaluation.
--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-gpu
Activer le contexte de débogage GPU et l’information pour OpenGL 4.3+.
--debug-gpumem
Activer GPU memory stats dans la barre d’état.
--debug-gpu-shaders
Activer GPU memory stats dans la barre d’état.
--debug-gpu-force-workarounds
Activer GPU memory stats dans la barre d’état.
--debug-wm
Enable debug messages for the window manager, shows all operators in search, shows keymap errors.
--debug-all
Activer tous les messages de débogage.
--debug-io
Activer les messages de débogage pour les entrées/sorties (collada, …).
--debug-fpe
Activer les exceptions des nombres flottants.
--disable-crash-handler
Désactiver le gestionnaire de plantage.
--disable-abort-handler
Désactiver le abort handler.

Options diverses

--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-library-override
Enable Library Override features in the UI.
--enable-event-simulate
Enable event simulation testing feature 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-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 : NULL SDL OPENAL JACK.
-h, --help
Afficher ce texte d’aide et quitter.
-R
Enregistrer l’extension du fichier blend, puis quitter (Windows uniquement).
-r
Enregistrer silencieusement l’extension du fichier blend, puis quitter (Windows uniquement).
-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

/?
Afficher ce texte d’aide et quitter (Windows uniquement).
--debug-freestyle
Activer les messages de débogage pour FreeStyle.
--verbose <verbose>
Définir le niveau de verbosité des logs.

Analyse des arguments

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

blender -ba test.blend

…will exit since -ba is an unknown argument.

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_CONFIG:
 Dossier pour les fichiers de configuration de l’utilisateur.
BLENDER_USER_SCRIPTS:
 Dossier pour les scripts de l’utilisateur.
BLENDER_SYSTEM_SCRIPTS:
 Dossier pour les scripts à l’échelle du système.
BLENDER_USER_DATAFILES:
 Dossier pour les fichiers de données utilisateur (icônes, traductions,…).
BLENDER_SYSTEM_DATAFILES:
 Dossier pour les fichiers de données à l’échelle du système.
BLENDER_SYSTEM_PYTHON:
 Dossier pour les bibliothèques systèmes de Python.
TEMP:Enregistre les fichiers temporaires ici.
TMP:ou $TMPDIR Enregistre les fichiers temporaires ici.
SDL_AUDIODRIVER:
 Pilote audio LibSDL - alsa, esd, dma.
PYTHONHOME:Chemin vers le dossier Python, ex. /usr/lib/python.