Blender
API Python: index

Attention!
Blender 1.80
Blender 2.10
Blender 2.28
Blender 2.44

L'API python qui accompagne blender a subi un certain nombre de modifications depuis son intégration au  logiciel. On en compte au moins 4 versions différentes. Chacune possède des modules et des fonctions que les autres n'ont pas. 

Dans l'état actuel des choses, depuis Blender 2.28 et suivants, l'API a été entièrement revue et corrigée de certains problèmes mais la compatibilité avec les versions antérieures reste relativement bonne. Cependant, des mofifications, quelquefois importantes, doivent être apportées pour obtenir l'effet désiré . 

Dans certains cas, les scripts peuvent être lancés mais ne donnent pas le résultats attendu ou gèlent le logiciel d'accueil . C'est le cas en particulier du script Mandelbrot dont il existe une version alternative compatible avec l'api 2.28 et une autre compatible avec les modifications opérées dans Blender 2.37 . Ce script est utilisé dans les fichiers de test de Blender .

Pour résumer le problème:  le plus souvent, il est  encore possible d'utiliser les anciens scripts compatibles avec la version 1.80 de blender mais plus du tout ceux qui l'étaient avec les versions 2.10 à 2.12. Si malgré tout on souhaite les essayer, ils sont encore utilisables avec blender  version 2.27  en indiquant simplement:

import Blender210

Ce module ayant été définitivement supprimé dans Blender2.28. 
A Noter : le module IPO qui permettait d'intervenir sur les courbes de contrôle d'animation est encore loin d'être vraiment utilisable. 

Avec Blender 2.44, l'API se dédouble. L'ancien module Blender qu'il fallait importer est maintenant accompagné d'un module expérimental  Bpy. 
 
English Version
 Index Principal
précédent  Index Animation
 Python: une introduction Next

 
Adresse  Modules Blender Contenu Python Description Exemples
&Version		 Niveau
Programmation 
par script Python		 NMesh Traitement du texte, print, len(), module sys, flush() Quelques informations de bases indispensables. Lien vers "Comment faire..." pour apprendre à configurer un clavier azerty. non
Français
English
1.80,2.14
API228		 Aucun
a/-Avertissement. sur les numéros de versions
b/- Présentation
c/-Differences entre Fenêtre de texte, de script et fenêtre de "link" (reliure). d/ -Charger un script.
e/- Comment Cela marche-t'il? f/- Bibliothèques d'Extension.(à lire impérativement si on veut utiliser un script d'import/export) g/- Nouvelle interface de lancement de script : Script Window
h/- Conclusion
Script python  : NMesh liste, objet, append. Créer un mesh carré. oui
Français
English
1.80, 2.14
API228		 Débutant
Script python  :     NMesh liste, objet, append, sous-programme. Les boucles itératives en python.  non
Français
English
1.80, 2.14
API228		 Débutant
Script python NMesh liste, objet, append(), range(), sous-programme. Utiliser les boucles pour créer automatiquement des points.  oui
Français
English
1.80, 2.14
API228		 Débutant
Script python NMesh liste, objet, append(), range(),  int(), sous-programme  Utiliser les boucles pour créer automatiquement des facettes. oui
Français
English
1.80, 2.14
API228		 Débutant
Script python   (bis)  NMesh  Page bis, même fonctions Utiliser des facettes "altérées", en fait des facettes ayant seulement 2 sommets,  pour créer des lignes. oui, 2,
Français
1.80, 2.14
API228		  Débutant
modeliser un cube NMesh Même fonctions Utiliser les listes pour définir une forme oui, 2,
Français
1.80, 2.14
API228		 Débutant
Script python NMesh module math Utiliser les fonctions mathématiques pour construire des patatoïdes. oui
Français
English
1.80, 2.14
API228		 Débutant
Script python NMesh
BGL		 Définition de fonction, création de variable globale Créer des menus  et  lier un script à une animation.  oui,
Français
1.80a		 Moyen,
maîtrise des niveaux 1 à 5 obligatoire.
Developpement (5ter)  :  NMesh, Draw,BGL, Object Creation de cellule Lecture de données, jeu avec les vertex colors Interface graphique de creation de plans ayant x colonnes sur y lignes oui,
Français
API228		 .Moyen,
maîtrise des niveaux 1 à 5 obligatoire.
Objectif:Créer une trame de facettes
Variation sur le thème de l'ensemble de mandelbrot
Topologie : fichier structuré en tableau, colonnes par lignes
Macro tesselate.py NMesh Définition de fonction, création de variable globale, appels recursifs... Ombres portées de structures fil de fer.  oui,
Français
1.80, 2.14
API228		 Confirmé
La dernière version en date permet d'extruder les faces sélectionnées avec un certain nombre de parametres variables, ainsi que d'effectuer un chanfreinage (sur l'ensemble de l'objet), le creusement de sillons  ou la création d'une enveloppe autour des arêtes appartants à des faces correctement définies. 
Pour creuser, DIG
Diviser, DIV hache l'extrusion en plusieurs fragments
Fractionner, donner l'apparence de SEGMENT à chaque nouvel élément d'extrusion
Exploser (SPLIT)
Extruder (EXTRUSION),
Envelopper la structure
Biseauter (BEVEL)
Developper (MATRIX) en déplaçant ou en enroulant en suivant des courbes ou des coordonnées variables
 Itérations possibles de ces opérations ( Script python original  : version 8.8j) .
Bibliothèque de fonction dynamique:
subsurf		 Subsurf.dll
subsurfGUI.py		 Compilation de bib. externe Division de surface assistée par python
non
 Tout utilisateur
obsolète, remplacée par une fonction intégrée.
Macro Script python Blender, Object . Renommer tout, ou partie, de l'ensemble des objets d'un fichier.  oui,
Français
1.80 et 2.14		 Tout utilisateur.
Astuce Script python Blender, sys path, système d'exploitation Faire cohabiter deux versions de python.  oui,
Français
1.80 et 2.14		 Tout utilisateur.
Macro 1/4 Script python Blender, NMesh Utiliser les cordonnées d'un plan pour placer le point de réflexion de l'environnement map d'un miroir plan. Lier un script python pour déterminer automatiquement la position relative de la camera à un plan: les bases oui,
Français
1.80, 2.14
et 2.11/2.12		 Tout utilisateur.
Macro 2/4 Script python . . Lier un script python pour déterminer automatiquement la position relative de la camera à un plan: si l'objet n'est pas un mesh... . .
Macro 3/4 Script python . La macro ne donne pas de résultat avec les chemins mais fonctionne bien avec les courbes IPO. Lier un script python pour déterminer automatiquement  la position relative de la camera à un plan. Limites de l'animation oui,
Français
1.80, 2.14
et 2.11/2.12		 Tout utilisateur.
Macro 4/4 Script python Blender, NMesh Utilisation de la matrice Lier un script python pour déterminer automatiquement  la position relative de la camera à un plan: un peu de géométrie. oui,
Français
1.80, 2.14
et 2.11/2.12		 Tout utilisateur.
Macro Script python . Comment regrouper toutes les faces qui ont au moins un point commun Dispatcher un mesh en ses différents fragments. Utilisable pour séparer les morceaux résultants d'une intersection. Peut-être utilisable dans quelques temps sur les meshes résultants d'un calcul de radiosité si le bug de l'attribution de couleur aux sommets est corrigé. .oui,
Français
1.80, 2.14		 Tout utilisateur
Fonction Python  Draw,BGL  Comment utiliser BGL et comment définir une fonction,
utilisation de return multiple		 Comment afficher une image TGA non compressée dans une fenêtre d'Interface Graphique définie en blender python avec le module BGL. Français
1.80, 2.14 et suivant		 Tout utilisateur
Modelage en python NMesh, math fonctions circulaires Comment faire tourner un point par rapport à un axe. Français
1.80, 2.14 et suivant		 Tout utilisateur
Trucs et astuces en python (4) NMesh, math Les propriétés "faces",
faces.v[x].no et faces.v[x].co des objets meshes		 Utiliser les normales pour effectuer une modification de la forme en peignant les sommets du mesh. Français
1.80,2.14 jusqu'à 2.25		 Utilisateur averti, ou confirmé
Trucs et astuces en python (5) NMesh Les propriétés "faces",
faces.v[x].co des objets meshes		 Utiliser les vertex colors pour effacer certaines facettes d'un volume(en construction) Français
1.80,2.14 jusqu'à 2.25		 Utilisateur averti, ou confirmé
Projet:
Où trouver les scripts python  Global Global Page de référencement des sites offrant des macros blender-python intéressantes.  non
Français		 Confirmé
un catalogue non exaustif des scripts actuellement disponibles.
    Annuaires
    Répertoires de téléchargement
    Exportation
    Modélisation
    Animation
    Illumination
    Programmation
Projets en Blender Python ne faisant pas partie du didacticiel:
    • Povanim: ce fichier est destiné à l'exportation des fichiers blender vers le logiciel de rendu gratuit Povray  (le texte du script n'est pas lisible mais utilisable).  (version 233.01)
    • Shell Factory , modeleur de coquillages avec une interface à fenêtres multiples (la partie la plus originale). Script réalisé en juillet 2000.
    • Lsystem :  une modification du script de création de végétaux permettant d'ajouter des fruits et d'obtenir exactement le même modèle avec les mêmes paramètres (téléchargeable sous la forme d'un fichier blender le texte du script modifié est disponible).
    • Labyrinthe : Pour produire des labyrinthes utilisables dans la partie interactive de Blender
    • du script d'importation de  Chris Lynch : Wavefront OBJ Importer/Exporter v1.2, dans l'état actuel ce script est le plus fiable et le plus efficace pour importer les fichiers .OBJ :
        1. corrections et transformations pour importer correctement les matériaux
        2. corrections et transformations pour fonctionner avec l'API python Blender 228 et suivant 
        3. correction pour uvmapper automatiquement les objets importés de Zbrush 
        4. transformation pour utiliser le selecteur de fichier  en importation
        5. modifications et ajout pour importer les fichiers obj de Forester/Arboretum 
        6. correction pour uvmapper automatiquement les objets importés de Wings3D
    • participation à YABLEX, le script d'exportation pour Yafray, corrections et transformations pour fonctionner avec l'API python Blender 228 et suivant, nettoyage de nombreux warnings et de la déclaration de caméra par défaut. Ce script a été largement  augmenté depuis par sont auteur original mais avec les même défauts d'utilisation des variables globales. On peut le trouver sur Kino3D, le site italien.
    • mise à jour de l'interface graphique de l'exporter pour Lightflow écrit par Alfredo de Greef. L'installation des fichiers originaux est toujours nécessaire. Ce script est incompatible avec blender 2.33/2.34 et suivants car il ne peut fonctionner qu'avec des extensions python2.2

      • BVH_import py    Version modifiée du script développée par Barton Campbel à partir d'une premiere version  que l'on devait à Reevan McCay. ce fichier permet aux utilisateurs français qui disposent de la version gratuite de Poser 3.01  de lire les animations dans le format BVH  .
précédent  Index Animation
 Python: une introduction Next
Vers le haut de la page


 

 

Les questions concernant cette page  peuvent être posées sur  :
news://news.zoo-logique.org/3D.Blender

Livre en français
Blender : apprenez, pratiquez, Créez, livre, Ed. Campus Press, coll. Starter Kit
Blender Starter Kit
Forum
FAQ
Lexique
Didacticiels
Compilations
Blender2KT
Débuter
Modelage
Blender python
Materiaux
Lumière
Animation
API python (eng)
Archives nzn
Statistiques
Doc flash Sculptris
Galerie Sculptris