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
devientanimation_01_test.png
test-######.png
devienttest-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 forwm.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. |