Arguments de la Ligne de commande¶

Blender 2.82 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.