Introduction¶

Python est un langage de programmation interprété, interactif et 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 une manière versatile d’étendre les fonctionnalités de Blender. La plupart des zones de Blender peuvent être scriptées, y compris l’animation, le rendu, l’import et l’export, la création d’objet et des tâches répétitives automatisées.

Pour interagir avec Blender, les scripts peuvent faire l’usage de l”API fortement intégrée.

Informations générales¶

Liens utiles pour l’écriture des scripts :

Python.org – Information générale à propos de Python.
API Python Blender – documentation officielle de l’API. Utilisez celle-ci comme référence pour l’écriture de scripts.
Introduction à l’API – une courte introduction pour débuter avec l’API. Contient des exemples.

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 scripting Python pour Blender.

Liens externes

Voici 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 fonctions supplémentaires dans Blender, ils peuvent être activés depuis les Preferences.

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

Les add-ons officiellement pris en charge sont empaquetés avec Blender.
D’autres add-ons Testing (en test) sont intégrés dans les versions de développement mais pas dans les versions officielles. Beaucoup d’entre eux fonctionnent correctement et sont très utiles mais n’ont pas de garantie d’une stabilité suffisante pour une version officielle.

Voir Add-ons pour la documentation sur les add-ons compris dans Blender.

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 et 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 principaux opérateurs supplémentaires.
Scripts personnalisés : contrairement aux add-ons, ils sont typiquement conçus pour une exécution unique via l”Éditeur de texte.

Enregistrement de vos scripts personnels¶

Emplacement des fichiers¶

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

Vous pouvez assigner un chemin de recherche supplémentaire pour les scripts dans File Paths Preferences ‣ File Paths.

Installation¶

Les add-ons sont installés aisément dans Blender dans les Preferences. Cliquez sur le bouton Install… et sélectionnez le fichier .py ou .zip.

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

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