From BlenderWiki

Jump to: navigation, search
Blender3D FreeTip.gif
IMPORTANT! Do not update this page!
We have moved the Blender User Manual to a new location. Please do not update this page, as it will be locked soon.

Introduction

Dans certaines situations nous voulons améliorer la vitesse du rendu, accéder à Blender à distance pour effectuer un rendu, ou créer des scripts qui utilisent la ligne de commande de Blender.

Un des avantages de l’utilisation de la ligne de commande est que nous pouvons nous passer du serveur graphique X (dans le cas de GNU/Linux), et rendre à distance via SSH ou TelNet.

Note
Les arguments sont exécutés dans l’ordre donné !
blender -b file.blend -a -x 1 -o //render
…ne marchera pas, puisque la sortie et l’extension sont activés après que vous ayez dit à Blender de rendre.
Placez toujours -f ou -a en dernier.


Description

Utilisation : blender [-b <dir><fichier> [-o <dir><fichier>] [-F <format>] [-x [0|1]] [-t <threads>] [-S <nom>] [[-f <image>]|[-j <number> -s <image> -e <image> -a]] [-P <scriptname> [-- <parameter>]]]

Options de rendu

-b <dir><fichier>
Rend le fichier <fichier> situé dans le répertoire <dir>, en arrière plan (sans charger l’interface graphique).
-o <dir><fichier>
Chemin et nom du fichier où enregistrer le rendu. Utilisez // pour vous placer dans le dossier du fichier .blend ; # sera remplacé par le numéro d’image. Par exemple : blender -b foobar.blend -o //render_# -F PNG -x 1.
-F <format>
Règle le format d’enregistrement. Les options valides sont : TGA IRIS HAMX FTYPE JPEG MOVIE IRIZ RAWTGA AVIRAW AVIJPEG PNG BMP FRAMESERVER et (non disponibles sur tous les systèmes) : HDR TIFF EXR MPEG AVICODEC QUICKTIME CINEON DPX.
-x [0|1]
Option pour ajouter automatiquement l’extension appropriée aux fichiers, 0 pour NON et 1 pour OUI.
-t <threads>
Utiliser <threads> threads pour le rendu.
-P <fichier>
Exécuter le script Python indiqué (nom de fichier ou texte dans Blender).
-S <nom>
Rendre la scène <nom>.
-f <image>
Rendre l’image (frame) numéro <image>, et l’enregistrer (à ne pas utiliser en même temps que -a).
-j <number>
Rendre une frame toutes les <number> images.
-s <image> -e <image> -a
Règle l’image de départ (-start) et de fin (-end) et rend l’animation ainsi formée (-anim). L’ordre de -s et -e est important, mais vous pouvez n’en utiliser qu’un, voir seulement -a pour tout rendre.


Options de lecture d’animation

Utilisées quand vous pressez le bouton PLAY, Blender se comporte alors comme un lecteur vidéo.

-a <fichier(s)>
Lire le(s) fichier(s) <fichier(s)> (Ne pas utiliser avec -b !).
-p <sx> <sy>
Ouvrir la fenêtre “vidéo” avec le coin inférieur gauche situé en (<sx>,<sy>) (ne fonctionne pas sous Windows).
-m
Lire directement le(s) fichier(s) depuis le disque, sans le(s) mettre en cache.


Options de l’UI

-w
Force l’ouverture de la fenêtre principale avec des bords (comportement par défaut).
-W
Force l’ouverture de la fenêtre principale sans bordure (plein écran, GNU/Linux et autres Unix uniquement).
-p <sx> <sy> <w> <h>
Ouvre la fenêtre principale avec le coin inférieur gauche en (<sx>,<sy>), avec une largeur de <w> et une hauteur de <h>.


Options du moteur de jeu

-g fixedtime
Affichage à vitesse constante de 50Hz.
-g vertexarrays
Utiliser les tableaux de vertices pour le rendu (généralement plus rapide).
-g noaudio
Ne pas jouer de son dans le moteur de jeu.
-g nomipmap
Pas de filtrage “mipmap” pour les textures.
-g linearmipmap
filtrage “mipmap” linéaire des textures, au lieu de celui par défaut (“plus proche”, Nearest).


Options diverses

-d
Active le mode debugging.
-noaudio
Désactive l’audio pour les systèmes qui le supporte.
-h
Affiche (plus ou moins) cette aide en anglais.
-y
Désactive les liens de script, utilisez -Y pour comprendre pourquoi c’est -y (NdT : ??? Version anglaise : “Disable script links, use -Y to find out why its -y”).
-P <fichier>
Exécute le script Python indiqué (nom de fichier ou texte dans Blender).
-R
Enregistre l’extension de fichier .blend.
-v
Affiche la version de Blender et s’arrête.


Exemples

Rendre une image

$ blender -b file.blend -o //file -F JPEG -x 1 -f 1

  • -b file.blend : Fichier .blend à rendre.
  • -o //file : Chemin + nom du fichier où enregistrer l’image.
  • -F JPEG : Format d’image JPEG.
  • -x 1 : Ajouter l’extension (.jpg) au nom de fichier.
  • -f 1 : Rendre l’image 1.


Rendre une animation

$ blender -b file.blend -o //file -F MOVIE -x 1 -s 003 -e 005 -a

  • -b file.blend : Fichier .blend à rendre.
  • -o //file : Chemin + nom du fichier où enregistrer la vidéo.
  • -F MOVIE : Enregistrer la vidéo dans un fichier .avi faiblement compressé.
  • -x 1 : Ajouter l’extension (.avi) au nom de fichier.
  • -s 003 -e 005 -a : Image de départ : 003, de fin : 005.
Important : Vous pouvez n’utiliser que -s ou -e, mais s’ils ne sont pas dans le bon ordre, ça ne marchera pas !