Arguments de la Ligne de commande

Blender 2.78 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 frames 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 frame``<frame>`` et l’enregistrer.

  • +<frame> start frame relative, -<frame> end frame relative.
  • Une liste de frames séparées par des virgules peut aussi être utilisée (pas d’espaces).

  • Une plage de frames peut être désignée en utilisant le séparateur .. entre la première et la dernière frame (comprise).

-s, --frame-start <frame>

Fixer le début à la frame <frame>, prend aussi en charge +/- les frames relatives.

-e, --frame-end <frame>

Fixer la fin à la frame <frame>, prend aussi en charge +/- les frames relatives

-j, --frame-jump <frames>

Fixer le nombre de frames à avancer après chaque frame rendue.

-o, --render-output <path>

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

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

  • ani_##_test.png devient ani_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 frame sera ajouté à la fin du nom de fichier, ex.:

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

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

-E, --engine <engine>

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

-t, --threads <threads>

Utilise le nombre de <threads> pour le rendu et autres opérations (1-64), 0 pour le nombre de processeurs du système.

Options de format

-F, --render-format <format>

Fixe 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 sur tous les systèmes : HDR TIFF EXR MULTILAYER MPEG FRAMESERVER QUICKTIME CINEON DPX DDS JP2

-x, --use-extension <bool>

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

Options de lecture d’animation

-a <options> <file(s)>

Lecture de <file(s)>, fonctionne uniquement de cette manière quand il ne s’exécute pas en arrière-plan.

-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 frames à <frame>.

-s <frame>

Lire à partir de <frame>.

-e <frame>

Lire jusqu’à <frame>.

Options de fenêtre

-w, --window-border

Forcer l’ouverture sans bordures.

-W, --window-borderless

Forcer l’ouverture sans bordures.

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

Options spécifiques du moteur de jeu

-g options spécifiques du Moteur de jeu

fixedtime

S’exécutee en 50 hertz sans sauter de frames.

vertexarrays

Utiliser les Vertex Arrays pour le rendu (habituellement plus rapide).

nomipmap
No Texture Mipmapping.
linearmipmap

Linear Texture Mipmapping au lieu de Nearest (par défaut).

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

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

liste d’add-ons séparés par des virgules (pas d’espaces).

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-no-threads
Switch dependency graph to a single threaded evaluation.
--debug-gpumem

Activer les stats de mémoire GPU dans la barre d’état.

--debug-wm

Activer les messages de débogage pour le gestionnaire de fenêtre, affiche aussi chaque appel d’opérateur.

--debug-all

Activer tous les messages de débogage.

--debug-fpe

Activer les exceptions des nombres flottants.

--disable-crash-handler

Désactiver le gestionnaire de plantage.

Options diverses

--factory-startup

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

--env-system-datafiles

Définir la variable d’environnement BLENDER_SYSTEM_PYTHON.

--env-system-scripts

Définir la variable d’environnement BLENDER_SYSTEM_PYTHON.

--env-system-python

Définir la variable d’environnement BLENDER_SYSTEM_PYTHON.

-nojoystick

Désactiver la prise en charge du joystick.

-noglsl

Désactiver le GLSL shading.

-noaudio

Forcer le son système à None.

-setaudio

Forcer le son système vers un dispositif spécifique : NULL SDL OPENAL JACK.

-h, --help

Afficher le texte d’aide et quitte.

-R

Inscrire l’extension du fichier blend, puis quitter (Windows uniquement).

-r

Inscrire silencieusement l’extension du fichier blend, puis quitte (Windows uniquement).

-v, --version

Afficher la version de Blender et quitte.

--
End option processing, following arguments passed unchanged. Access via Python’s sys.argv.

Fonctionnalités expérimentales

--enable-new-depsgraph

Utiliser un nouveau dependency graph.

--enable-new-basic-shader-glsl

Utiliser le nouveau GLSL basic shader.

Autres options

/?

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

--debug-freestyle

Activer les messages de débogage pour FreeStyle.

--debug-gpu

Active le contexte de débogage GPU et l’information pour OpenGL 4.3+.

--disable-abort-handler

Désactiver le abort handler.

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

... va ignorer le a.

blender -b test.blend -f8

... va ignorer 8 parce qu’il n’y a pas d’espace entre le -f et la valeur de frame.

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 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 système.

BLENDER_SYSTEM_PYTHON:
 

Dossier pour les bibliothèques système 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.