Du pixelart sur vos écrans OLED : Différence entre versions

(update property name)
 
(11 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{ {{tntn|Tuto Details}}
+
{{Tuto Details
|Main_Picture=Du_pixelart_sur_vos_écrans_OLED_P1120656.JPG
+
|Main_Picture=Du_pixelart_sur_vos_écrans_OLED_pixelart_wiki.jpg
 
|Licences=Attribution (CC BY)
 
|Licences=Attribution (CC BY)
|Description=Le pixel art c'est cool ! si vous voulez le rendre encore plus retro quoi de mieux qu'un petit écran OLED.
+
|Description=<translate><!--T:1-->
Nous allons voir comment créer nos propres images et les animer.
+
Le pixel art c'est cool ! si vous voulez le rendre encore plus rétro quoi de mieux qu'un petit écran OLED.
 +
Nous allons voir comment créer nos propres images et les animer.</translate>
 
|Area=Art, Electronics, Play and Hobbies
 
|Area=Art, Electronics, Play and Hobbies
 
|Type=Technique
 
|Type=Technique
Ligne 16 : Ligne 17 :
 
|IsTranslation=0
 
|IsTranslation=0
 
}}
 
}}
{{ {{tntn|Introduction}}
+
{{Introduction
|Introduction=Dessiner sur des écrans OLED ? Ca peut paraitre compliquer, mais avec un peu d'entrainement, on peut faire un paquet de choses comme son propre logo, voir de l'animation ou même des jeux vidéos !
+
|Introduction=<translate><!--T:2--> Dessiner sur des écrans OLED ? Ça peut paraitre compliqué, mais avec un peu d'entrainement, on peut faire un paquet de choses comme son propre logo, voir de l'animation ou même des jeux vidéos !</translate>
 
}}
 
}}
{{ {{tntn|TutoVideo}}
+
{{TutoVideo
 
|VideoType=Youtube
 
|VideoType=Youtube
 
|VideoURLYoutube=https://www.youtube.com/watch?v=JfFld6lq_7o
 
|VideoURLYoutube=https://www.youtube.com/watch?v=JfFld6lq_7o
 
}}
 
}}
{{ {{tntn|Materials}}
+
{{Materials
 
|Step_Picture_00=Filtration_sur_sable_par_arduino_3.jpg
 
|Step_Picture_00=Filtration_sur_sable_par_arduino_3.jpg
 
|Step_Picture_01=Du_pixelart_sur_vos_écrans_OLED_0.91_I2C_OLED_128x32-_Blue_4-1000x750.png
 
|Step_Picture_01=Du_pixelart_sur_vos_écrans_OLED_0.91_I2C_OLED_128x32-_Blue_4-1000x750.png
|Material=- Microcontrôleur compatible avec u8g2 (arduino / esp8266 / esp32 etc...)
+
|Material=<translate><!--T:3-->
 +
- Microcontrôleur compatible avec u8g2 (arduino / esp8266 / esp32 etc...)
  
- Ecran OLED monochrome
+
<!--T:4-->
|Tools=
+
- Écran  OLED monochrome</translate>
 +
|Tools=<translate></translate>
 +
|ExternalAttachmentsLinks={{ExternalAttachmentsLinks
 +
|ExternalAttachmentsLinks=https://github.com/maditnerd/oled_xbm
 +
}}{{ExternalAttachmentsLinks
 +
|ExternalAttachmentsLinks=https://create.arduino.cc/editor/madnerd/0a94bf35-ada8-4695-9f56-d62ea2ed4cff/preview
 +
}}{{ExternalAttachmentsLinks
 +
|ExternalAttachmentsLinks=https://create.arduino.cc/editor/madnerd/f616433a-3f8a-483c-8ca2-6447dac0314c/preview
 +
}}{{ExternalAttachmentsLinks
 +
|ExternalAttachmentsLinks=https://create.arduino.cc/editor/madnerd/b4c53d85-5579-4953-89d4-29e0a3b4228c/preview
 +
}}{{ExternalAttachmentsLinks
 +
|ExternalAttachmentsLinks=https://create.arduino.cc/editor/madnerd/7deed5b1-6f4d-4cd6-b662-0e2a88a93974/preview
 
}}
 
}}
{{ {{tntn|Separator}}}}
+
}}
{{ {{tntn|Tuto Step}}
+
{{Separator}}
|Step_Title=Choisir son image
+
{{Tuto Step
|Step_Content=Nous allons utiliser un écran 128x32 (les écrans en 128x64 sont aussi très répandu si vous voulez plus d'espace), il nous faut donc choisir une '''petite image'''
+
|Step_Title=<translate><!--T:5--> Choisir son image</translate>
 +
|Step_Content=<translate><!--T:6-->
 +
Nous allons utiliser un écran 128x32 (les écrans en 128x64 sont aussi très répandus si vous voulez plus d'espace), il nous faut donc choisir une '''petite image.'''
  
Les sprites de la GameBoy sont très facile à convertir, mais gardez à l'esprit que nous sommes limités au noir et blanc, là ou la gameboy est capable d'afficher 4 nuances de gris.
+
<!--T:7-->
 +
Les sprites de la GameBoy sont très faciles à convertir, mais gardez à l'esprit que nous sommes limités au noir et blanc, là ou la gameboy est capable d'afficher 4 nuances de gris.
  
Vous pouvez télécharger des sprites sur https://www.spriters-resource.com/ comme point de départ.
+
<!--T:8-->
 +
Vous pouvez télécharger des sprites sur https://www.spriters-resource.com/ comme point de départ.</translate>
 +
|Step_Picture_00=Du_pixelart_sur_vos_écrans_OLED_112885.png
 
}}
 
}}
{{ {{tntn|Tuto Step}}
+
{{Tuto Step
|Step_Title=Convertir des images en pixel art
+
|Step_Title=<translate><!--T:9--> Convertir son image en pixel art</translate>
|Step_Content=Sauvegarder votre image au format XBM
+
|Step_Content=<translate><!--T:10-->
 +
{{Info|Tout le code est disponible sur github à cette adresse : https://github.com/maditnerd/oled_xbm}}
 +
 
 +
<!--T:37-->
 +
Pour notre premier exemple, nous allons utiliser le logo d'hackster.io
 +
 
 +
<!--T:11-->
 +
Nous allons
 +
* Redimensionner l'image en 128x32
 +
* Redessiner l'image avec deux couleurs
 +
* La convertir en XBM (code arduino)
 +
{{Idea|N'importe quel logiciel peut faire l'affaire, mais je recommande chaudement Krita : https://krita.org/en/}}
  
 +
<!--T:12-->
 +
Redimensionner l'image à la taille la plus proche de votre écran (128x32) : Image --> '''Redimensionner l'image à une nouvelle taille'''
 +
 +
<!--T:13-->
 +
Puis augmenter la taille de votre canvas à 128x32 : Image --> '''Redimensionner le tableau'''
 +
 +
<!--T:14-->
 +
Dans les préréglages des brosses, choisissez Pixel Art
 +
 +
<!--T:15-->
 +
Puis redessiner l'image.
 +
 +
<!--T:16-->
 +
{{Idea|Appuyer sur X pour passer d'une couleur à l'autre.}}</translate>
 +
|Step_Picture_00=Du_pixelart_sur_vos_écrans_OLED_hacksterio_logo_pixel.png
 +
|Step_Picture_01=Du_pixelart_sur_vos_écrans_OLED_hackster.png
 +
|Step_Picture_02=Du_pixelart_sur_vos_écrans_OLED_brush.png
 +
}}
 +
{{Tuto Step
 +
|Step_Title=<translate><!--T:17--> Convertir son pixel art en code arduino</translate>
 +
|Step_Content=<translate><!--T:18-->
 +
Sauvegarder votre image au format XBM
 +
 +
<!--T:19-->
 
{{Warning|Sauvegarder le aussi au format PNG, vous ne pourrez pas modifier votre fichier XBM avec Krita !}}
 
{{Warning|Sauvegarder le aussi au format PNG, vous ne pourrez pas modifier votre fichier XBM avec Krita !}}
  
Ouvrez le fichier XBM avec un éditeur de texte et changer le nom des variables
+
<!--T:20-->
 +
Ouvrez le fichier XBM avec un éditeur de texte et changez le nom des variables
  
 +
<!--T:21-->
 
Fichier XBM
 
Fichier XBM
 
  #define _width 128
 
  #define _width 128
Ligne 59 : Ligne 114 :
 
  static const unsigned char logo[] U8X8_PROGMEM = {
 
  static const unsigned char logo[] U8X8_PROGMEM = {
 
  0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00...  
 
  0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00...  
  };
+
  };</translate>
 
}}
 
}}
{{ {{tntn|Tuto Step}}
+
{{Tuto Step
|Step_Title=Afficher votre image
+
|Step_Title=<translate><!--T:22--> Afficher votre image</translate>
|Step_Content={{Idea|Je vous conseille de garder le code du logo dans un fichier .h, ainsi il sera plus simple de lire votre code}}
+
|Step_Content=<translate><!--T:23-->
 +
{{Idea|Je vous conseille de garder le code du logo dans un fichier .h, ainsi il sera plus simple de lire votre code}}
  
 +
<!--T:24-->
 
Nous allons utiliser la bibliothèque U8g2 (elle est compatible avec beaucoup d'écrans)
 
Nous allons utiliser la bibliothèque U8g2 (elle est compatible avec beaucoup d'écrans)
 
  #include <Wire.h> //I2C
 
  #include <Wire.h> //I2C
Ligne 89 : Ligne 146 :
 
J'ai aussi mis les fichiers PNG et XBM dans un dossier res/ dans mon code afin de savoir ce qu'il y a dans logo.h et de pouvoir le modifier ultérieurement.
 
J'ai aussi mis les fichiers PNG et XBM dans un dossier res/ dans mon code afin de savoir ce qu'il y a dans logo.h et de pouvoir le modifier ultérieurement.
  
Téléverser votre code et voilà !
+
<!--T:25-->
 +
Téléversez votre code et voilà !</translate>
 +
|Step_Picture_00=Du_pixelart_sur_vos_écrans_OLED_res.png
 +
|Step_Picture_01=Du_pixelart_sur_vos_écrans_OLED_hackter_logo.jpg
 +
}}
 +
{{Tuto Step
 +
|Step_Title=<translate><!--T:26--> Animation - Position</translate>
 +
|Step_Content=<translate><!--T:27-->
 +
Pour cette partie nous allons utiliser le boulet de cannon de Super Mario Bros.
 +
 
 +
<!--T:28-->
 +
Il est possible d'animer votre pixel art de deux façons :
 +
* Changer sa position
 +
* Utiliser plusieurs images
 +
Donc si nous voulons déplacer une image de gauche à droite, il suffit juste de changer la position X non ?
 +
 
 +
<!--T:29-->
 +
Si vous utilisez un Arduino Uno, ça va marcher, mais avec des cartes plus puissantes (comme l'ESP8266) votre animation '''va aller beaucoup trop vite!'''
 +
 
 +
<!--T:30-->
 +
Nous avons besoin de limiter le taux de rafraichissement de notre animation, nous pourrions utiliser un delay mais nous ne pourrions plus faire d'autres choses en même temps.
 +
 
 +
<!--T:31-->
 +
Nous allons donc utiliser la bibliothèque '''AsyncDelay''' pour gérer cela plus efficacement.
 +
#include <AsyncDelay.h>
 +
const int FPS = 1000 / 30; //30 FPS
 +
 +
AsyncDelay tick; void setup(){
 +
  tick.start(FPS, AsyncDelay::MILLIS);
 +
}
 +
void loop(){
 +
    if(tick.isExpired()){
 +
        //ANIMATION ICI
 +
        tick.repeat();
 +
    }
 +
}
 +
Un dernier point, si nous voulons que notre image sorte de l'écran à droite et apparaisse lentement à gauche, nous devons aller plus loin que la largeur maximale de l'écran (128) , plus exactement (128+36), 36 étant la largeur de notre image.
 +
 
 +
<!--T:32-->
 +
Une fois l'image sortie de l'écran à droite, nous la faisons apparaitre à -36 afin de donner l'impression qu'elle apparait à gauche.
 +
void loop() {
 +
  if (tick.isExpired()) {
 +
    drawAnimation();
 +
    pos_x = pos_x + X;
 +
    if (pos_x > OLED_WIDTH + cannon_width) {
 +
      pos_x = -cannon_width;
 +
    }
 +
    tick.repeat();
 +
  }
 +
}</translate>
 +
|Step_Picture_00=Du_pixelart_sur_vos_écrans_OLED_grid_cannon.png
 +
|Step_Picture_01=Du_pixelart_sur_vos_écrans_OLED_P1120658.JPG
 +
|Step_Picture_02=Du_pixelart_sur_vos_écrans_OLED_P1120654.JPG
 +
|Step_Picture_03=Du_pixelart_sur_vos_écrans_OLED_mariocann.jpg
 +
}}
 +
{{Tuto Step
 +
|Step_Title=<translate><!--T:33--> Animation - Images multiples</translate>
 +
|Step_Content=<translate><!--T:34-->
 +
Une autre façon d'animer une image et d'utiliser plusieurs images.
 +
 
 +
<!--T:35-->
 +
Au lieu de changer la position X, nous allons utiliser une '''condition SWITCH''' et augmenter la valeur '''animation_state.'''
 +
void drawAnimation() {
 +
  u8g2.firstPage();
 +
  do {
 +
    switch (animation_state) {
 +
      case 0:
 +
        u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_1);
 +
        break;
 +
      case 1:
 +
        u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_2);
 +
        break;
 +
      case 2:
 +
        u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_3);
 +
        break;
 +
      case 3:
 +
        u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_4);
 +
        break;
 +
      case 4:
 +
        u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_5);
 +
        break;
 +
      case 5:
 +
        u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_6);
 +
        break;
 +
    }
 +
  } while ( u8g2.nextPage() );
 +
}
 +
Afin que notre animation soit complète, il nous faut l'inverser, pour cela, nous allons utiliser le booléen (vrai/faux) '''animation_direction''' afin que l'animation aille dans le sens inverse.
 +
drawAnimation();
 +
    if (animation_direction) {
 +
      animation_state--;
 +
    } else {
 +
      animation_state++;
 +
    }
 +
    if (animation_state == 5) {
 +
      animation_direction = true;
 +
    }
 +
    if (animation_state == 0) {
 +
      animation_direction = false;
 +
    }
 +
Si on combine les deux techniques, on peut créer des animations plus complexe : https://www.youtube.com/watch?v=iB52FujIK-A</translate>
 +
|Step_Picture_00=Du_pixelart_sur_vos_écrans_OLED_hackster_anim.png
 
}}
 
}}
{{ {{tntn|Notes}}
+
{{Notes
|Notes=
+
|Notes=<translate><!--T:36--> Si vous voulez être informés des prochains tutoriels suivez moi sur twitter : https://twitter.com/m4dnerd</translate>
 
}}
 
}}
{{ {{tntn|Tuto Status}}
+
{{Tuto Status
|Complete=Draft
+
|Complete=Published
 
}}
 
}}

Version actuelle datée du 9 décembre 2019 à 11:31

Auteur avatarRémi Sarrailh (µsini) | Dernière modification 9/12/2019 par Clementflipo

Du pixelart sur vos écrans OLED pixelart wiki.jpg
Le pixel art c'est cool ! si vous voulez le rendre encore plus rétro quoi de mieux qu'un petit écran OLED. Nous allons voir comment créer nos propres images et les animer.

Introduction

Dessiner sur des écrans OLED ? Ça peut paraitre compliqué, mais avec un peu d'entrainement, on peut faire un paquet de choses comme son propre logo, voir de l'animation ou même des jeux vidéos !

Video d'introduction

Étape 1 - Choisir son image

Nous allons utiliser un écran 128x32 (les écrans en 128x64 sont aussi très répandus si vous voulez plus d'espace), il nous faut donc choisir une petite image.

Les sprites de la GameBoy sont très faciles à convertir, mais gardez à l'esprit que nous sommes limités au noir et blanc, là ou la gameboy est capable d'afficher 4 nuances de gris.

Vous pouvez télécharger des sprites sur https://www.spriters-resource.com/ comme point de départ.




Étape 2 - Convertir son image en pixel art

Tout le code est disponible sur github à cette adresse : https://github.com/maditnerd/oled_xbm

Pour notre premier exemple, nous allons utiliser le logo d'hackster.io

Nous allons

  • Redimensionner l'image en 128x32
  • Redessiner l'image avec deux couleurs
  • La convertir en XBM (code arduino)
N'importe quel logiciel peut faire l'affaire, mais je recommande chaudement Krita : https://krita.org/en/

Redimensionner l'image à la taille la plus proche de votre écran (128x32) : Image --> Redimensionner l'image à une nouvelle taille

Puis augmenter la taille de votre canvas à 128x32 : Image --> Redimensionner le tableau

Dans les préréglages des brosses, choisissez Pixel Art

Puis redessiner l'image.

Appuyer sur X pour passer d'une couleur à l'autre.


Étape 3 - Convertir son pixel art en code arduino

Sauvegarder votre image au format XBM

Sauvegarder le aussi au format PNG, vous ne pourrez pas modifier votre fichier XBM avec Krita !

Ouvrez le fichier XBM avec un éditeur de texte et changez le nom des variables

Fichier XBM

#define _width 128
#define _height 32
static char _bits[] = {
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00... 
};

Fichier logo.h

#define logo_width 128
#define logo_height 32
static const unsigned char logo[] U8X8_PROGMEM = {
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00... 
};

Étape 4 - Afficher votre image

Je vous conseille de garder le code du logo dans un fichier .h, ainsi il sera plus simple de lire votre code

Nous allons utiliser la bibliothèque U8g2 (elle est compatible avec beaucoup d'écrans)

#include <Wire.h> //I2C
#include <U8g2lib.h>
#include "logo.h"

//I2C SSD1306 128x32 (search U8g2 examples for other display)
U8G2_SSD1306_128X32_UNIVISION_F_HW_I2C u8g2(U8G2_R0, U8X8_PIN_NONE);

void setup() {
 u8g2.begin(); //Start Screen
 drawLogo();
}

void loop() {
}

void drawLogo() {
 u8g2.firstPage();
 do {
   u8g2.drawXBMP(0, 0, logo_width, logo_height, logo);
 } while ( u8g2.nextPage() );
}

J'ai aussi mis les fichiers PNG et XBM dans un dossier res/ dans mon code afin de savoir ce qu'il y a dans logo.h et de pouvoir le modifier ultérieurement.

Téléversez votre code et voilà !



Étape 5 - Animation - Position


Étape 6 - Animation - Images multiples

Une autre façon d'animer une image et d'utiliser plusieurs images.

Au lieu de changer la position X, nous allons utiliser une condition SWITCH et augmenter la valeur animation_state.

void drawAnimation() {
 u8g2.firstPage();
 do {
   switch (animation_state) {
     case 0:
       u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_1);
       break;
     case 1:
       u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_2);
       break;
     case 2:
       u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_3);
       break;
     case 3:
       u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_4);
       break;
     case 4:
       u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_5);
       break;
     case 5:
       u8g2.drawXBMP(0, 0, logo_width, logo_height, logo_6);
       break;
   }
 } while ( u8g2.nextPage() );
}

Afin que notre animation soit complète, il nous faut l'inverser, pour cela, nous allons utiliser le booléen (vrai/faux) animation_direction afin que l'animation aille dans le sens inverse.

drawAnimation();
   if (animation_direction) {
     animation_state--;
   } else {
     animation_state++;
   }
   if (animation_state == 5) {
     animation_direction = true;
   }
   if (animation_state == 0) {
     animation_direction = false;
   }

Si on combine les deux techniques, on peut créer des animations plus complexe : https://www.youtube.com/watch?v=iB52FujIK-A




Notes et références

Si vous voulez être informés des prochains tutoriels suivez moi sur twitter : https://twitter.com/m4dnerd

Commentaires

Published