Arguments de la ligne de commande

Blender 3.6 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).

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

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

When the filename does not contain #, The suffix #### is added to the filename.

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>

Use amount of <threads> for rendering and other operations [1-1024], 0 for systems processor count.

Options de format

-F, --render-format <format>

Set the render format. Valid options are: TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

Formats that can be compiled into Blender, not available on all systems: HDR TIFF OPEN_EXR OPEN_EXR_MULTILAYER MPEG CINEON DPX DDS 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: Forcer l’ouverture avec bordures.
-W, --window-fullscreen: Force opening in fullscreen mode.
-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: Enable automatic Python script execution (default).
-Y, --disable-autoexec: Disable automatic Python script execution (pydrivers & startup scripts).
-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.
--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 de logging

--log <match>: Activer les catégories de journalisation, en prenant un seul argument séparé par des virgules. Plusieurs catégories peuvent être associées à l’aide d’un suffixe .*, donc --log 'wm.*' enregistre chaque type de message du gestionnaire de fenêtres. La sous-chaîne peut être mise en correspondance à l’aide d’un préfixe et d’un suffixe *, donc –log “undo” enregistre tous les types de messages liés à l’annulation. Utilisez le préfixe “^” pour ignorer, donc --log "*,^wm.operator.*" enregistre tout sauf wm.operators.*. Utilisez “*” pour tout enregistrer.
--log-level <level>: Définir le niveau de verbosité des logs (plus élevé pour plus de détails) par défaut à 1, utilisez -1 pour journaliser tous les niveaux.
--log-show-basename: N’afficher que le nom du fichier en sortie (pas le chemin d’accès principal).
--log-show-backtrace: Afficher une trace arrière (back trace) pour chaque message de log (uniquement les builds de débogage).
--log-show-timestamp: Afficher un horodatage pour chaque message de log en secondes depuis le début.
--log-file <filepath>: Définir un fichier pour la sortie du log.

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-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

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-uuid

Verify validness of session-wide identifiers assigned to ID datablocks.

--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-disable-ssbo

Disable usage of shader storage buffer objects.

--debug-gpu-renderdoc

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

--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 entrées/sorties (collada, …).

--debug-fpe

Activer les exceptions des nombres flottants.

--debug-exit-on-error

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

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

Options GPU

--gpu-backend: Force to use a specific GPU backend. Valid options: vulkan, metal, opengl.

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: Skip reading the startup.blend in the users home directory.
--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-python: Définir la variable d’environnement BLENDER_SYSTEM_PYTHON.
-noaudio: Forcer le son système à None.
-setaudio: Force sound system to a specific device. None SDL OpenAL CoreAudio JACK PulseAudio WASAPI.
-h, --help: Afficher ce texte d’aide et quitter.
/?: Afficher ce texte d’aide et quitter (Windows uniquement).
-R: Register blend-file extension, then exit (Windows only).
-r: Silently register blend-file extension, then exit (Windows only).
-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.

Other Options

--debug-freestyle: Activer les messages de débogage pour FreeStyle.

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:: Top level directory for user files. (other BLENDER_USER_* variables override when set).
BLENDER_USER_CONFIG:: Dossier pour les fichiers de configuration de l’utilisateur.
BLENDER_USER_SCRIPTS:: Dossier pour les scripts de l’utilisateur.
BLENDER_USER_DATAFILES:: Dossier pour les fichiers de données utilisateur (icônes, traductions,…).
BLENDER_SYSTEM_RESOURCES:: Top level directory for system files. (other BLENDER_SYSTEM_* variables override when set).
BLENDER_SYSTEM_SCRIPTS:: Directory for system wide scripts.
BLENDER_SYSTEM_DATAFILES:: Directory for system wide data files.
BLENDER_SYSTEM_PYTHON:: Directory for system Python libraries.
OCIO:: Path to override the OpenColorIO config file.
TEMP:: Store temporary files here.
TMP:: or $TMPDIR Store temporary files here.

Join the 2%