La Console de Python

La console Python offre un moyen rapide de tester des extraits de code et d’explorer l’API de Blender. Elle exécute tout ce que vous tapez sur son invite >>> et dispose d’un historique des commandes et d’une saisie semi-automatique.

../_images/editors_python-console_default.png

La Console de Python.

Interface

Menus de l’entête

Menu View

Zoom In / Zoom Out

Augmente/diminue la taille de la police.

Move to Previous Word Ctrl-Gauche

Déplace le curseur au début du mot précédent. Si le curseur est au milieu d’un mot, le curseur est déplacé au début du mot courant.

Move to Next Word Ctrl-Droite

Déplace le curseur à la fin du mot suivant. Si le curseur est au milieu d’un mot, le curseur est déplacé à la fin du mot courant.

Move to Line Begin Début

Déplace le curseur au début de la ligne courante.

Shift-Début : Sélectionne tout le texte entre le curseur et le début de la ligne courante.

Move to Line End Fin

Déplace le curseur à la fin de la ligne courante.

Shift-Fin : Sélectionne tout le texte entre le curseur et la fin de la ligne courante.

Menu Console

Clear All

Réactualise la console en donnant un nouveau départ à la vue. Notez que l’historique de cette commande n’est pas effacé.

Clear Line Maj-Entrée.

Supprime tout dans la ligne d’invite.

Delete Previous Word Ctrl-Ret.Arr.

Supprime tout entre le curseur et le début du mot suivant (séparé par des points). Si le curseur est au milieu d’un mot, il supprime tout jusqu’au début du mot suivant.

Delete Next Word Ctrl-Suppr.

Supprime tout entre le curseur et la fin du mot suivant. Si le curseur est au milieu d’un mot, cela supprime tout jusqu’à la fin du mot courant.

Copy as Script Maj-Ctrl-C

Copie tout le tampon de l’historique dans le presse-papier. Cela peut être collé dans un fichier texte pour être utilisé comme un script Python.

Cut Ctrl-X

Copie le texte sélectionné dans le presse-papiers et le supprime.

Copy Ctrl-C

Copie le texte sélectionné dans le presse-papiers.

Paste Ctrl-V

Colle dans la ligne de commande.

Indent Tab

Insère un caractère tab au niveau du curseur.

Unindent Maj-Tab

Désindente la sélection.

Backward in History Haut

Change la commande actuelle par la commande précédente à partir de l’historique des commandes.

Forward in History Bas

Change la commande courante par la commande suivante à partir de l’historique des commandes.

Autocomplete Tab

Voir Auto Completion.

Vue principale

Raccourcis clavier

  • LMB – Déplace le curseur le long de la ligne de saisie.

  • Gauche, Droite – Déplacer le curseur d’un seul caractère.

  • Ctrl-Gauche, Ctrl-Droite – Déplacer le curseur d’un mot.

  • Maj-Gauche / Maj-Droite – Sélectionne les caractères à gauche/droite.

  • Ctrl-Maj-Gauche / Ctrl-Maj-Droite – Sélectionne les mots à gauche/droite.

  • Ctrl-A – Sélectionne tout le texte et l’historique du texte.

  • Ret.Arr. / Suppr. – Effacer des caractères.

  • Ctrl-Ret.Arr. / Ctrl-Suppr. – Effacer des mots.

  • Entrée – Exécuter la commande.

  • Maj-Entrée – Ajouter à l’historique des commandes sans l’exécuter.

Utilisation

Aliases

Certains variables et modules sont disponibles pour des raisons pratiques :

  • C : accès rapide à bpy.context.

  • D : accès rapide à bpy.data.

  • bpy : module Top Level de l’API Python de Blender.

Premier pas avec l’environnement de la Console

Pour voir la liste des fonctions et variables globales, tapez dir() et appuyez sur Entrée pour l’exécuter.

../_images/editors_python-console_dir.png

Complétion automatique

La console peut prévisualiser les membres disponibles d’un module ou d’une variable. À titre d’exemple, tapez bpy. et appuyez sur Tab :

../_images/editors_python-console_completion.png

Les sous-modules sont répertoriés en vert. Les attributs et les méthodes seront répertoriés de la même manière, les méthodes étant indiquées par un final de fichier (.

Exemples

bpy.context

Ce module vous donne accès à la scène actuelle, aux objets actuellement sélectionnés, au mode objet actuel, etc..

Note

Pour que les commandes ci-dessous affichent la sortie correcte, assurez-vous que vous avez sélectionné un ou des objets dans la Vue 3D.

../_images/editors_python-console_bpy-context.png

Affichera le mode Vue 3D courant (Object, Edit, Sculpt, etc.):

bpy.context.mode

Récupérer l’objet actif :

bpy.context.object
bpy.context.active_object

Changer la coordonnée X de l’objet actif en 1:

bpy.context.object.location.x = 1

Déplacer l’objet actif de 0,5 le long de l’axe X :

bpy.context.object.location.x += 0.5

Modifier les trois coordonnées de localisation en une seule fois :

bpy.context.object.location = (1, 2, 3)

Changer uniquement les coordonnées X et Y :

bpy.context.object.location.xy = (1, 2)

Récupérer les objets sélectionnés :

bpy.context.selected_objects

Récupèrer les objets sélectionnés en excluant celui qui est actif :

[obj for obj in bpy.context.selected_objects if obj != bpy.context.object]

bpy.data

Vous donne accès à toutes les données du fichier blend, qu’il soit actuellement actif ou sélectionné.

../_images/editors_python-console_bpy-data.png

bpy.ops

Les “opérateurs” sont des actions qui sont normalement déclenchées à partir d’un bouton ou d’un élément de menu, mais qui peuvent également être appelées par programme. Consultez la documentation de l’API bpy.ops pour une liste de tous les opérateurs.