« Pygame/Introduction au module Surfarray » : différence entre les versions

>>> '''c[8:1:-1]''' ''#slice 1 to 8, reversed''

array([8, 7, 6, 5, 4, 3, 2])

 

Voilà. Vous avez assez d'informations pour vous permettre de commencer à utiliser le module surfarray avec le module Numeric. Les propriétés du module Numeric sont certainement plus consistantes, mais il s'ait d'une introduction. Par ailleurs, on veut seulement faire les trucs marrants, pas vrai ?

Avec ces informations, nous sommes parés pour commencer à essayer quelque chose avec les tableaux de surface. Les petites démonstrations suivantes qui créent un tableau numpy et l'affichent dans pygame. Ces différents tests sont issus des exemples contenus dans le fichier arraydemo.py. Il y a une simple fonction nommée surfdemo_show qui affiche un tableau à l'écran.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/allblack.jpg]]

allblack = N.zeros((128, 128))

Dans notre premier exemple, nous créons un tableau tout noir de 128 lignes sur 128 colonnes. Pour créer un tableau numérique avec un taille déterminée, il est préférable d'utiliser la fonction zeros. Ici, le tableau de zéro forme une surface noire.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/striped.jpg]]

striped = N.zeros((128, 128, 3))

Ici nous manipulons un tableau à 3 dimensions. On commence par créer une image rouge. Alors on extrait un ligne sur trois et on lui donne la couleur bleu/vert. Comme vous pouvez le constater, nous pouvons traiter les tableaux à trois dimensions presque comme un tableau à deux dimensions, seulement on lui assigne des 3-uplets au lieu de valeurs uniques (scalaires).

 

[[Image:http://www.pygame.org/docs/tut/surfarray/imgarray.jpg]]

imgsurface = pygame.image.load('surfarray.jpg')

Ici nous chargeons une image avec le module image, qui la convertit en un tableau 2D d'entiers. Nous utiliserons cette image comme base dans le reste de nos exemple.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/flipped.jpg]]

flipped = imgarray[:,::-1]

Voici un retournement vertical de l'image, réalisé en utilisant la notation en ''slices'' à l'aide d'un incrément négatif pour l'indice des colonnes.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/scaledown.jpg]]

scaledown = imgarray[::2,::2]

Diminuer une image repose sur le même principe que l'exemple précédent. Ici, la notation en ''slices'' est utilisée pour conserver seulement un pixel sur deux à la fois verticalement et horizontalement.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/scaleup.jpg]]

size = N.array(imgarray.shape)*2

Augmenter la taille d'une image n'est pas aussi radicalement simple, mais s'inspire de la diminution que nous avons réalisé en utilisant la notation en tranches. D'abord, nous créons un tableau qui est de deux fois la taille de l'original. On réalise une copie du tableau original, pixel par pixel, en écrivant seulement sur les colonnes et les lignes de rang pair du tableau de destination, puis on réalise à nouveau l'opération en écrivant seulement sur les colonnes et les lignes de rang impair du tableau de destination. On obtient ainsi une image dont la taille a doublé.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/redimg.jpg]]

rgbarray = surfarray.array3d(imgsurface)

surfdemo_show(redimg, 'redimg')

 

 

 

[[Image:http://www.pygame.org/docs/tut/surfarray/soften.jpg]]

On réalise ici une convolution à l'aide d'un filtre 3x3 qui va adoucir les reliefs de l'image. Cela paraît lourd en calculs, mais ce qui est fait est en fait de décaler l'image de 1 pixel dans toutes les directions, et de sommer toutes ces images (en multipliant par un certain coefficient de poids). Alors, on moyenne toutes les valeurs obtenues. Ce n'est pas un filtre gaussien, mais c'est rapide.

 

[[Image:http://www.pygame.org/docs/tut/surfarray/xfade.jpg]]

src = N.array(rgbarray)

Enfin, Nous réalisons une décoloration croisée entre l'image originale et une fond entièrement en bleu. Ce n'est pas très folichon, mais l'image de destination peut être n'importe quoi, et en modifiant le coefficient multiplicateur (0.50 dans l'exemple), vous pouvez choisir l'intensité de la décoloration pour votre image.

 

J'espère qu'à ce stade, vous avez des idées d'utilisation pour le module surfarray, dans la réalisation d'effets spéciaux et de transformations d'image, seulement réalisables au niveau du pixel. Au minimum, vous pouvez utiliser surfarray pour faire quelques opérations rapides avec'''Surface.set_at()''' et '''Surface.get_at()'''. Mais ne pensez pas que vous en avez terminé, il vous reste encore beaucoup à apprendre.