Introduction

Python est un langage de programmation interprété, interactif, orienté objet. Il intègre des modules, des exceptions, le typage dynamique, des types de données dynamiques de haut niveau et des classes. Python combine une puissance remarquable et une syntaxe très claire.

Les scripts Python sont un moyen puissant et polyvalent pour étendre la fonctionnalité de Blender. La plupart des domaines de Blender peuvent être l’objet de scripts, y compris l’animation et le rendu, l’import et export, la création d’objet et le des tâches répétitives.

Pour interagir avec Blender, les scripts peuvent faire l’usage des API (Application Programming Interface) intégrées.

Information générale

Liens utiles pour l’écriture des scripts :

  • Python.org - Information générale à propos de Python.

  • Blender Python API - Documentation officielle de l’API. Utilisez celle-ci comme référence pour l’écriture des scripts.

  • Introduction à l’API - Courte introduction pour débuter avec l’API. Contient des exemples.

  • CookBook - Section de bouts de code pratiques (encore à écrire)

Liens en rapport avec la distribution de vos scripts :

  • Partage de scripts - Information sur la manière de partager vos scripts et les faire inclure dans la distribution officielle de Blender.

  • Création d’Add-ons - Les add-ons sont utilisés pour encapsuler et distribuer des scripts.

  • Projet Add-ons - Projet pour maintenir un dépôt central d’extensions à Blender.

Prise en main

Liens du Manuel

Les liens suivants vous font passer des bases aux concepts plus avancés du scriptage Python pour Blender.

Liens externes

Ci-après des liens externes contenant beaucoup de bonnes informations pour commencer à apprendre à écrire des scripts pour Blender :

Extension de Blender

Add-ons

Les add-ons sont des scripts que vous pouvez activer pour disposer de fonctionnalités supplémentaires dans Blender, ils peuvent être activés depuis User Preferences.

En dehors de l’exécutable Blender, il y a littéralement des centaines d’add-ons écrits par beaucoup de personnes :

  • Les add-ons officiellement pris en charge sont empaquetés avec Blender.

  • D’autres add-ons en test sont inclus dans les versions de développement mais pas dans les versions officielles. Beaucoup d’entre eux fonctionnent correctement et sont très utiles mais ne sont pas garantis d’une stabilité suffisante pour une version officielle.

Pour un survol de tous les add-ons disponibles, voir le Catalogue des scripts.

Scripts

En dehors des add-ons, il y a aussi des scripts que vous pouvez utiliser pour étendre la fonctionnalité de Blender :

  • Modules : bibliothèques d’Utilitaires pour l’import dans d’autres scripts.

  • Préréglages : réglages pour les outils de Blender les configurations des touches.

  • Démarrage : ces fichiers sont importés au démarrage de Blender. Ils définissent la plus grande partie de l’interface utilisateur de Blender, ainsi que des opérateurs principaux supplémentaires.

  • Scripts personnalisés : contrairement aux add-ons, ils sont typiquement conçus pour une exécution unique via l’Éditeur texte

Sauvegarde de vos scripts

Emplacement des fichiers

Tous les scripts sont chargés depuis le sous-dossier scripts des dossiers local, system et user.

Vous pouvez assigner un chemin de recherche supplémentaire pour les scripts dans File Paths (Chemins d’accès des fichiers) User Preferences ‣ File Paths.

Installation

Dans Blender les add-ons sont installés de façon pratique dans les User Preferences. Cliquez sur le bouton Install from File... et sélectionnez les fichiers .py ou .zip.

Pour installer manuellement des scripts ou add-ons, placez-les dans le dossier add-ons, modules, presets or startup selon leur type. Voir la description ci-dessus.

Vous pouvez aussi lancer les scripts en les chargeant dans l’Éditeur texte.