Dernières actualités
TutorielsBlenderBlender Image API

Blender Python API : données d’image et réglages de texture

La Python API de Blender permet de créer des images sous forme de blocs de données, de modifier leur tampon de pixels et d’examiner les propriétés d’Image Texture. Ce guide présente les étapes de base pour la visualisation architecturale.

Intérieur contemporain et lumineux mettant en valeur un mur à la texture de pierre répétéeImage IA
Image d’illustration générée par IA.Image : 3dsınıfı / FCA AI

En bref

  1. Dans l’API Blender, un bloc de données Image peut provenir d’un fichier, de données empaquetées ou d’une image créée.
  2. La méthode `update()` permet d’actualiser l’affichage après une modification du tampon de pixels.
  3. Les propriétés d’Image Texture couvrent notamment le mode d’extension, l’utilisation de l’alpha et la répétition.
  4. La documentation source avertit que la copie d’un bloc de données d’image peut ne pas reprendre les modifications du tampon si celui-ci n’a pas été enregistré au préalable.

Ce que vous apprendrez dans ce guide

Vous apprendrez à manipuler une image à l’aide du bloc de données Image de la Python API de Blender, à modifier légèrement son tampon de pixels et à actualiser le résultat. Vous découvrirez également la signification des principaux réglages documentés pour ImageTexture et les points à vérifier lors de la préparation de textures pour des scènes d’architecture.

Ce guide n’explique pas comment relier une image à un matériau ni comment l’ajouter à une scène via un chemin de menu particulier. La documentation source décrit les propriétés des types de données Image et ImageTexture ; les étapes se limitent donc à ces propriétés.

Prérequis

  • Il faut pouvoir exécuter du code Python dans Blender et accéder à l’API bpy. L’exemple source crée une image via bpy.data.images.

  • Les sources sont la documentation actuelle de l’API Blender ; elles ne précisent pas de numéro de version particulier de Blender. Vérifiez également la compatibilité des propriétés de l’API avec la version utilisée.

  • La documentation ne fournit aucune information sur les conditions de compte, de licence ou de coût ; ce guide ne présente donc aucune exigence à ce sujet.

  • Dans l’exemple, l’image est créée dans le code. Aucun chemin de fichier externe ni fichier de texture existant n’est nécessaire.

Étape par étape : créer une image et actualiser son tampon de pixels

1. Créez un nouveau bloc de données d’image

Le bloc de données Image est un conteneur qui fait référence à une image, à un fichier vidéo, à des données empaquetées ou à du contenu généré. Les données de l’image, telles que son tampon de pixels et sa résolution, sont conservées dans le tampon d’image. L’exemple de la documentation crée une nouvelle image avec l’appel bpy.data.images.new().

Le code suivant crée une image d’exemple, affiche sa taille dans la console, modifie les quatre premières valeurs du tampon et actualise l’affichage :

python
import bpy

image = bpy.data.images.new("Facade_Test", 1024, 1024)
print(image.size)
print(image.pixels[0:4])

image.pixels[0:4] = (0.5, 0.5, 0.5, 0.5)
image.update()

print(image.pixels[0:4])

pixels est le tampon de pixels composé de valeurs en virgule flottante. Dans cet exemple, seules les quatre premières valeurs sont affectées ; cela ne signifie pas que toute la texture ou toute une surface architecturale est peinte. update() applique la modification du tampon à l’image affichée. La propriété size indique la largeur et la hauteur du tampon en pixels.

2. Redimensionnez le tampon de l’image

Le bloc de données d’image comprend la méthode scale(width, height). L’exemple de la documentation redimensionne le tampon à 1024 × 720. Dans votre travail, indiquez explicitement les dimensions cibles dans le code, puis vérifiez la valeur de size. Le redimensionnement modifie le tampon de l’image ; il ne permet pas, à lui seul, d’enregistrer un fichier.

Pour les images destinées aux revêtements de façade, aux motifs de sol ou aux matériaux d’intérieur, définir à l’avance les dimensions prévues dans la scène rend le flux de travail plus clair. Toutefois, la documentation ne fournit ni résolution de rendu particulière ni dimension de pixel recommandée pour les textures architecturales ; ces valeurs sont donc à choisir selon le projet.

3. Choisissez les réglages d’Image Texture en fonction de vos besoins

ImageTexture peut faire référence à un objet Image et possède la propriété extension, qui définit le comportement de l’image au-delà de ses limites. Les options documentées sont les suivantes :

  • REPEAT : répète l’image horizontalement et verticalement.

  • EXTEND : prolonge les pixels des bords de l’image vers l’extérieur.

  • CLIP : rend transparentes les zones situées au-delà des limites de l’image.

  • CLIP_CUBE : limite la zone située hors de l’image à une région en forme de cube et rend l’extérieur transparent.

  • CHECKER : répète l’image selon un motif en damier.

Parmi les propriétés de texture figurent les facteurs de répétition repeat_x et repeat_y, l’utilisation des informations alpha avec use_alpha, l’inversion des valeurs alpha avec invert_alpha et l’interpolation des pixels à l’aide du filtre sélectionné avec use_interpolation. La documentation indique une plage de 1 à 512 pour repeat_x et repeat_y. Avant d’utiliser ces réglages, déterminez si le résultat recherché est la répétition, le prolongement des bords ou le découpage aux limites.

Le canal alpha d’une image peut également être interprété de différentes façons. Les options de Image.alpha_mode comprennent STRAIGHT, PREMUL, CHANNEL_PACKED et NONE. La documentation source précise qu’elles correspondent à différents modes de représentation de l’alpha ; il ne faut donc pas interpréter systématiquement l’alpha d’un fichier à canaux empaquetés comme une transparence ordinaire.

4. Vérifiez le comportement de la copie et de l’enregistrement

La documentation de l’API comporte un avertissement important : la copie d’un bloc de données d’image ne garantit pas que le tampon d’image sera également copié. Si les modifications apportées au tampon n’ont pas encore été enregistrées sur le disque, le nouveau bloc de données créé avec copy() peut conserver l’état initial de l’image au lieu du tampon modifié. Dans l’exemple de la documentation, après l’actualisation de la copie, la taille et les couleurs reviennent également à l’état initial de l’image d’origine.

La méthode save() permet d’enregistrer l’image ; save_render() permet de l’enregistrer à un chemin donné en utilisant les paramètres de rendu de la scène. L’option save_copy de save() sert à enregistrer une copie sans modifier le chemin de fichier actuel de l’image. Par conséquent, si vous devez dupliquer un tampon modifié, testez d’abord l’ordre des opérations d’enregistrement et de copie : ne comptez pas uniquement sur la copie du bloc de données.

Erreurs fréquentes

  • Oublier d’appeler update() : même après la modification des valeurs du tampon, la documentation prévoit la méthode update() pour actualiser l’image affichée.

  • Supposer que la copie reprend automatiquement les modifications : les changements non enregistrés du tampon peuvent ne pas être transférés à la copie.

  • Considérer les options extension comme interchangeables : REPEAT répète l’image, tandis que CLIP rend transparentes les zones hors limites ; choisissez selon le comportement souhaité.

  • Ignorer le mode alpha : CHANNEL_PACKED est défini pour empaqueter les canaux RGB et alpha de différentes images ; l’alpha ne sert donc pas toujours de masque.

Pour aller plus loin : flux de travail de visualisation architecturale

Ces bases aideront les utilisateurs de Blender qui souhaitent comprendre comment les entrées d’image sont représentées dans une scène, ainsi que les étudiants en architecture et en architecture d’intérieur et les équipes de visualisation. Décider s’il faut répéter l’image utilisée pour une façade, un revêtement de sol ou un habillage intérieur, prolonger ses bords ou tenir compte de son alpha facilite l’analyse du comportement de la texture. Comme la documentation n’explique ni le résultat de ces réglages dans un moteur de rendu particulier ni leur impact sur les performances, des tests supplémentaires sont nécessaires dans le fichier du projet et avec la version utilisée.

Avant d’étendre le flux de travail, vérifiez séparément les valeurs du tampon, la taille, le mode d’extension et l’utilisation de l’alpha à l’aide d’une petite image de test. Les méthodes pack() et unpack() concernent également le choix entre conserver les images avec le fichier du projet ou les gérer à l’extérieur : la documentation indique qu’elles servent respectivement à intégrer l’image dans le fichier .blend et à extraire sur le disque une image empaquetée.

Sources et licence

Ce guide est adapté de la documentation de Blender Python API sur Image et ImageTexture. Les deux sources sont publiées sous licence CC BY-SA 4.0. Le contenu a été adapté en turc et les explications ont été reformulées ; l’exemple de code a été préparé pour ce guide.

Sources

2 sources
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.Image.html
Résumé
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.ImageTexture.html
Résumé

Les textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.

L’avis de 3dsınıfı
3dL’analyse de la rédaction

Cette approche de l’API est particulièrement utile aux bureaux et aux étudiants qui souhaitent examiner de manière cohérente de nombreuses images dans une même scène ou rendre répétables de petites modifications de données. Elle permet de contrôler les limites des textures, leur répétition et l’utilisation de l’alpha ; toutefois, les sources ne montrent pas qu’elle constitue à elle seule une solution pour la configuration des matériaux ou les performances du rendu.

Pour les équipes en Turquie, le plus pratique est de tester ces propriétés dans une copie d’une petite scène, sans modifier le matériel existant ni les coûts de licence. Il faut notamment vérifier la compatibilité des versions et le comportement de la copie avant l’enregistrement du tampon ; dans les fichiers de production, les chemins des images externes et les modalités d’empaquetage doivent être clairement définis au sein de l’équipe.

Questions fréquentes

Comment modifier la taille d’une image avec la Blender Python API ?

La méthode `Image.scale(width, height)` redimensionne le tampon de l’image selon la largeur et la hauteur indiquées. La propriété `size` donne les dimensions du tampon en pixels.

Comment une image Image Texture se comporte-t-elle au-delà de ses limites dans Blender ?

La propriété `extension` peut être définie sur `REPEAT`, `EXTEND`, `CLIP`, `CLIP_CUBE` ou `CHECKER`. Ces options produisent différents comportements, comme la répétition, le prolongement des bords ou la transparence au-delà des limites.

Les modifications de pixels sont-elles transférées à une image copiée dans Blender ?

Les modifications non enregistrées du tampon d’image peuvent ne pas être transférées lors de la copie du bloc de données `Image`. La documentation de l’API Blender recommande de tenir compte de ce comportement avant de copier.

Les commentaires et le forum sont en turc.Rejoindre la discussion
+

À lire aussi