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 les fonctionnalités de Blender. La plupart des domaines de Blender peuvent être l’objet de scripts, y compris l’animation et le rendu, l’import et l’export, la création d’objet et le scripting des tâches répétitives.

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.
Blender Python API – Official API documentation. Use this for referencing while writing scripts.
API Introduction – A short introduction to get you started with the API. Contains examples.

Liens en rapport avec la distribution de vos scripts :

Sharing scripts – Information on how to share your scripts and get them included in the official Blender distribution.
Creating Add-ons – Add-ons are used to encapsulate and distribute 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.

L”Éditeur texte
La Console Python
La Console Report de l’Éditeur Info

Liens externes

Voici des liens externes contenant beaucoup de bonnes informations pour commencer à apprendre à écrire des scripts pour Blender :

Le tutoriel d’introduction par Satish Goda vous prend en charge depuis le début et vous apprend à faire des manipulations basiques de l’API.
Les tutoriels vidéo d’Ira Krakow première vidéo d’une série de tutoriels vidéo.
Quickstart guide un guide de démarrage rapide pour les personnes qui ont déjà quelques notions de Python et de Blender.
Examples thread un forum contenant beaucoup d’exemples de petits scripts fonctionnels.
Introduction à Python un tutoriel vidéo d’une heure introduisant Python et l’API 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 User 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.

Pour un aperçu 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 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 (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 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.