LG

Outils pour utilisateurs

Outils du site

Piste : • prototypeihm • c • poo • smartptr • librairie • modbus • swig
lang:c:gfx_mgl

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision		Révision précédente
lang:c:gfx_mgl [2017/11/01 09:35] – Brouillon rootlang:c:gfx_mgl [2020/05/11 00:04] (Version actuelle) – Suppression de la taille par défaut pour les images root
Ligne 1: Ligne 1:
 L'étude est basée sur [[http://www.microchip.com/mplab/microchip-libraries-for-applications|Microchip Libraries for Applications]] {{ :lang:c:gfx_mgl:gfx-mla-v2017_03_06.zip |v2017_03_06}}. L'étude est basée sur [[http://www.microchip.com/mplab/microchip-libraries-for-applications|Microchip Libraries for Applications]] {{ :lang:c:gfx_mgl:gfx-mla-v2017_03_06.zip |v2017_03_06}}.
  
 +L'objectif est de faire marcher la librairie sur un PC.
  
 +===Documentation===
 +[[http://microchipdeveloper.com/hif2131:start|Tutorial de Microchip]]
 +
 +  - {{ :lang:c:gfx_mgl:designing_with_the_mla_graphics_library_-_developer_help_2020-04-26_10_08_14_pm_.html |MLA Graphics Library Self-Paced Training}}
 +  - {{ :lang:c:gfx_mgl:requirements_to_create_graphics_applications_using_the_mla_-_developer_help_2020-04-26_10_08_24_pm_.html |Application Development Requirements}}
 +  - {{ :lang:c:gfx_mgl:structure_of_an_mla_graphics_project_-_developer_help_2020-04-26_10_08_33_pm_.html |Structure of an MLA Graphics Project}}
 +  - {{ :lang:c:gfx_mgl:creating_a_new_graphics_project_-_developer_help_2020-04-26_10_08_42_pm_.html |Creating a New Graphics Project}}
 +  - {{ :lang:c:gfx_mgl:overview_of_a_typical_graphics_application_s_software_-_developer_help_2020-04-26_10_08_51_pm_.html |Overview of a typical Graphics Application's Software}}
 +  - {{ :lang:c:gfx_mgl:graphics_primitives_-_developer_help_2020-04-26_10_09_03_pm_.html |Graphic Primitives}}
 +  - {{ :lang:c:gfx_mgl:using_fonts_in_a_graphics_application_-_developer_help_2020-04-26_10_09_11_pm_.html |Using Fonts in a Graphics Application}}
 +  - {{ :lang:c:gfx_mgl:importing_fonts_into_an_mla_graphics_project_-_developer_help_2020-04-26_10_09_20_pm_.html |Importing Fonts Into an MLA Project}}
 +  - {{ :lang:c:gfx_mgl:importing_images_into_an_mla_graphics_project_-_developer_help_2020-04-26_10_09_29_pm_.html |Importing Images Into an MLA Project}}
 +  - {{ :lang:c:gfx_mgl:memory_requirements_for_a_bitmap_image_-_developer_help_2020-04-26_10_09_37_pm_.html |Bitmap Image Memory Requirements}}
 +  - {{ :lang:c:gfx_mgl:using_bitmap_images_in_a_graphics_application_-_developer_help_2020-04-26_10_09_49_pm_.html |Using Bitmap Images}}
 +  - {{ :lang:c:gfx_mgl:heap_requirements_for_graphics_objects_-_developer_help_2020-04-26_10_09_57_pm_.html |Graphics Objects Heap Requirements}}
 +  - {{ :lang:c:gfx_mgl:examples_of_graphics_objects_-_developer_help_2020-04-26_10_10_09_pm_.html |Graphics Objects Examples}}
 +  - {{ :lang:c:gfx_mgl:creating_graphics_objects_-_developer_help_2020-04-26_10_10_20_pm_.html |Creating Graphics Objects}}
 +  - {{ :lang:c:gfx_mgl:style_schemes_of_graphics_objects_-_developer_help_2020-04-26_10_10_32_pm_.html |Style Schemes of Graphics Objects}}
 +  - {{ :lang:c:gfx_mgl:state_bits_of_graphic_objects_-_developer_help_2020-04-26_10_10_40_pm_.html |State Bits of Graphic Objects}}
 +  - {{ :lang:c:gfx_mgl:drawing_graphics_objects_-_developer_help_2020-04-26_10_10_49_pm_.html |Drawing Graphics Objects}}
 +  - {{ :lang:c:gfx_mgl:changing_the_state_of_a_graphics_object_-_developer_help_2020-04-26_10_10_57_pm_.html |Changing the State of a Graphics Object}}
 +  - {{ :lang:c:gfx_mgl:getting_touch_input_from_a_graphics_screen_-_developer_help_2020-04-26_10_11_11_pm_.html |Getting Touch Input from a Screen}}
 +  - {{ :lang:c:gfx_mgl:processing_user_input_in_a_graphics_application_-_developer_help_2020-04-26_10_11_19_pm_.html |Processing User Input}}
 +  - {{ :lang:c:gfx_mgl:messaging_structure_for_graphics_applications_-_developer_help_2020-04-26_10_11_27_pm_.html |Messaging Structure}}
 +  - {{ :lang:c:gfx_mgl:timing_touch_events_in_graphics_applications_-_developer_help_2020-04-26_10_11_34_pm_.html |Timing Touch Events}}
 +
 +===Programme de base===
 +Sur la base de (5), on a comme application de départ :
 +<file c main.c>
 +#include <gfx/gfx.h>
 +
 +bool APP_ObjectMessageCallback(GFX_GOL_TRANSLATED_ACTION action, GFX_GOL_OBJ_HEADER *header, GFX_GOL_MESSAGE *msg)
 +{
 +  return true;
 +}
 +
 +bool APP_ObjectDrawCallback(void)
 +{
 +}
 +
 +void APP_CreateScreens()
 +{
 +  GFX_ColorSet(WHITE);
 +  GFX_ScreenClear();
 +}
 +
 +void TouchGetMsg(GFX_GOL_MESSAGE *msg) {
 +}
 +
 +int main()
 +{
 +  GFX_GOL_MESSAGE msg;
 +  GFX_Initialize();
 +  GFX_GOL_MessageCallbackSet(APP_ObjectMessageCallback);
 +  GFX_GOL_DrawCallbackSet(APP_ObjectDrawCallback);
 +  APP_CreateScreens();
 +
 +  while(1)
 +  {
 +    if (GFX_GOL_ObjectListDraw() == GFX_STATUS_SUCCESS)
 +    {
 +      TouchGetMsg(&msg)
 +      GFX_GOL_ObjectMessage(&msg);
 +    }
 +  }
 +}
 +</file>
 +
 +Pour compiler :
 +  gcc main.c  -Iframework -I.
 +
 +Il est à noter qu'il faut maintenant définir le fichier ''system_config.h'' et implémenter les fonctions définies dans le fichier ''driver/gfx/drv_gfx_display.h'' qui ne contient que l'interface.
 +
 +<WRAP center round tip 60%>
 +N'implémenter au départ aucune des fonctions de ''drv_gfx_display.h'' et attendre que le lieur échoue.
 +</WRAP>
 +
 +===system_config.h===
 +<file c system_config.h>
 +#ifndef system_config_h_
 +#define system_config_h_
 +
 +#include "gxf_config.h"
 +
 +#endif  // system_config_h_
 +</file>
 +
 +===gfx_config.h===
 +La librairie est plutôt bien faite avec des warnings en cas de ''#define'' non définis.
 +
 +Il faut définir :
 +
 +  * ''#define GFX_CONFIG_COLOR_DEPTH'' avec 1, 4, 8, 16 ou 24
 +
 +  * ''#define GFX_EXTERNAL_FONT_RASTER_BUFFER_SIZE'' : buffer of the character bitmap when sourced from external memory
 +Utilisé par la fonction utilisateur ''GFX_ExternalResourceCallback''. Le buffer doit au moins être aussi grand que le paramètre ''uint16_t nCount''.
 +
 +<file c gfx_config.h>
 +#ifndef GFX_CONFIG_H_
 +#define GFX_CONFIG_H_
 +
 +#define GFX_CONFIG_COLOR_DEPTH 24
 +
 +#define GFX_EXTERNAL_FONT_RASTER_BUFFER_SIZE 100
 +
 +// Sinon la couleur WHITE n'existe pas.
 +#define GFX_CONFIG_PALETTE_DISABLE
 +
 +// Parce qu'on n'utilise par le compilateur Microchip.
 +#define __prog__ 
 +
 +#endif  // GFX_CONFIG_H_
 +</file>
 +
 +===Ajouter les fonctions manquantes===
 +  /tmp/ccYnfXb4.o : Dans la fonction « APP_CreateScreens » :
 +  main.c:(.text+0x429) : référence indéfinie vers « GFX_ColorSet »
 +  main.c:(.text+0x42e) : référence indéfinie vers « GFX_ScreenClear »
 +  /tmp/ccYnfXb4.o : Dans la fonction « main » :
 +  main.c:(.text+0x458) : référence indéfinie vers « DRV_GFX_Initialize »
 +  main.c:(.text+0x45d) : référence indéfinie vers « GFX_Initialize »
 +  main.c:(.text+0x467) : référence indéfinie vers « GFX_GOL_MessageCallbackSet »
 +  main.c:(.text+0x471) : référence indéfinie vers « GFX_GOL_DrawCallbackSet »
 +  main.c:(.text+0x480) : référence indéfinie vers « GFX_GOL_ObjectListDraw »
 +  main.c:(.text+0x49d) : référence indéfinie vers « GFX_GOL_ObjectMessage »
 +  collect2: error: ld a retourné le statut de sortie 1
 +
 +  gcc main.c -Iframework -I. framework/gfx/src/gfx_primitive.c
 +
 +Il manque encore dans ''gfx_config.h'' :
 +<code c>
 +#define DISP_HOR_RESOLUTION XXX
 +#define DISP_VER_RESOLUTION XXX
 +</code>
 +
 +Et le message d'erreur suivant :
 +  framework/gfx/src/gfx_primitive.c:4506:37: error: « FONT_RAM » non déclaré
 +<code c>#define GFX_CONFIG_FONT_RAM_DISABLE</code>
 +
 +  gcc main.c -Iframework -I. framework/gfx/src/gfx_primitive.c
 +
 +Il manque encore
 +<code c>
 +#define GFX_malloc(pObj) malloc(pObj);
 +#define GFX_free(pObj) free(pObj)
 +</code>
 +
 +Dans le fichier ''gfx_types_macros.h'' il y a une erreur (je pense). Il faut remplacer les ''ConvertColorXX'' par ''GFX_ColorXXConvert''.
 +
 +===Supprimer les inline===
 +Le compilateur de Microchip a l'air d'accepter les ''extern inline'' ce qui n'est pas le cas de gcc/clang.
 +
 +Il faut remplacer les ''extern inline'' par ''inline'' dans les fichiers header.
 +  sed -i "s/extern inline/inline/g" *.h
 +
 +===Ajouter les fonctions manquantes===
 +  * ''GFX_PixelGet'' et ''GFX_PixelPut'' : Lecture et écriture d'un pixel. Dans notre cas, on va se contenter d'un buffer interne à l'applicaten.
 +
 +<code c>
 +static GFX_COLOR buff[DISP_VER_RESOLUTION][DISP_HOR_RESOLUTION];
 +
 +GFX_COLOR GFX_PixelGet(uint16_t x, uint16_t y)
 +{
 +  if ((x >= DISP_HOR_RESOLUTION) || (y >= DISP_VER_RESOLUTION))
 +  {
 +    return BLACK;
 +  }
 +  return buff[y][x];
 +}
 +
 +GFX_STATUS GFX_PixelPut(uint16_t x, uint16_t y)
 +{
 +  if ((x >= DISP_HOR_RESOLUTION) || (y >= DISP_VER_RESOLUTION))
 +  {
 +    return GFX_STATUS_FAILURE;
 +  }
 +  buff[y][x] = GFX_ColorGet();
 +  return GFX_STATUS_SUCCESS;
 +}
 +</code>
 +
 +  * ''GFX_RenderStatusGet'' : on ne gère pas de temps de latence ou autre du matériel.
 +<code c>
 +GFX_STATUS_BIT GFX_RenderStatusGet()
 +{
 +  return GFX_STATUS_SUCCESS_BIT;
 +}
 +</code>
 +
 +  * ''DRV_GFX_Initialize'' : initialisation du driver graphique.
 +<code c>
 +void DRV_GFX_Initialize()
 +{
 +}
 +</code>
 +
 +  * Fonction faussement manquante
 +
 +  /tmp/cc5voYLX.o : Dans la fonction « GFX_Initialize » :
 +  gfx_gol.c:(.text+0x998) : référence indéfinie vers « GFX_Primitive_Initialize »
 +  /tmp/cctgOBFP.o : Dans la fonction « GFX_Initialize » :
 +  gfx_primitive.c:(.text+0x184d) : référence indéfinie vers « GFX_Primitive_Initialize »
 +
 +Il faut enlever le ''inline'' dans le fichier ''gfx_primitive.h'' de pour la fonction ''void GFX_Primitive_Initialize''.
 +
 +  * ''GFX_ExternalResourceCallback'' : si les fonctions externes ont terminé leur travail. Toujours oui dans le cas d'un PC.
 +<code c>
 +GFX_STATUS GFX_ExternalResourceCallback(GFX_RESOURCE_HDR * pResource, uint32_t offset, uint16_t nCount, void * pBuffer)
 +{
 +  return GFX_STATUS_SUCCESS;
 +}
 +</code>
 +
 +A ce stade là, tout marche. Une archive complète est mise à disposition en bas de la page.
 +
 +====Dessins====
 +===Ajout de quelques dessins===
 +<code c>
 +  GFX_ColorSet(WHITE);
 +  GFX_ScreenClear();
 +  GFX_LineStyleSet(GFX_LINE_STYLE_THICK_SOLID);
 +  GFX_ColorSet(RED);
 +  GFX_LineDraw(0,120,60,120);
 +  GFX_ColorSet(GREEN);
 +  GFX_LineDraw(160,0,160,60);
 +  GFX_ColorSet(BLUE);
 +  GFX_LineDraw(260,120,320,120);
 +  GFX_ColorSet(BLACK);
 +  GFX_LineDraw(160,240,160,180);
 +</code>
 +
 +Et enregistrement du résultat dans un fichier qui sera converti en image via un programme externe.
 +
 +<code c>
 +    if (GFX_GOL_ObjectListDraw() == GFX_STATUS_SUCCESS)
 +    {
 +      TouchGetMsg(&msg);
 +      GFX_GOL_ObjectMessage(&msg);
 +
 +      FILE *fp = fopen("/tmp/screen.ppm", "wb");
 +      (void) fprintf(fp, "P6\n%d %d\n255\n", DISP_HOR_RESOLUTION, DISP_VER_RESOLUTION);
 +      for (int j = 0; j < DISP_VER_RESOLUTION; ++j)
 +      {
 +        for (int i = 0; i < DISP_HOR_RESOLUTION; ++i)
 +        {
 +          static unsigned char color[3];
 +          color[0] = (buff[j][i] >> 16) % 256;  /* red */
 +          color[1] = (buff[j][i] >> 8) % 256;  /* green */
 +          color[2] = (buff[j][i] >> 0) % 256;  /* blue */
 +          (void) fwrite(color, 1, 3, fp);
 +        }
 +      }
 +      (void) fclose(fp);
 +
 +      return 0;
 +    }
 +</code>
 +
 +  gcc -Iframework -I. framework/gfx/src/gfx_gol.c framework/gfx/src/gfx_primitive.c main.c
 +
 +{{:lang:c:gfx_mgl:screen1.png|Screenshot}}
 +
 +===Ajout d'un bouton===
 +Il faut ajouter un ''Scheme'' pour le thème en variable globale.
 +
 +<code c>
 +  GFX_GOL_OBJ_SCHEME GOLSchemeDefault;
 +</code>
 +
 +Définir le thème
 +<code c>
 +  GOLSchemeDefault.TextColor0 = WHITE;
 +  GOLSchemeDefault.Color0 = BLACK;
 +  GOLSchemeDefault.Color1 = GFX_RGBConvert(0x7F, 0x81, 0x7E);
 +  GOLSchemeDefault.EmbossDkColor = RED;
 +  GOLSchemeDefault.EmbossLtColor = BLUE;
 +  GOLSchemeDefault.EmbossSize = 3;
 +  GOLSchemeDefault.CommonBkColor = BLACK;
 +  GOLSchemeDefault.pFont = NULL;
 +</code>
 +
 +et le bouton
 +<code c>
 +  GFX_XCHAR UP_Msg[]={'U','p', 0};
 +
 +  if (GFX_GOL_ButtonCreate(11, 60, 190, 125, 255, 0, GFX_GOL_BUTTON_DRAW_STATE, NULL, NULL, &UP_Msg[0], GFX_ALIGN_CENTER, &GOLSchemeDefault) == NULL)
 +  {
 +    printf("Oups...\n");
 +  }
 +</code>
 +
 +  gcc -Iframework -I. framework/gfx/src/gfx_gol.c framework/gfx/src/gfx_primitive.c main.c framework/gfx/src/gfx_gol_button.c
 +
 +{{:lang:c:gfx_mgl:screen2.png|Screenshot}}
 +
 +Il manque le texte mais c'est normal car ''GOLSchemeDefault.pFont = NULL''. Cependant, l'objectif de la page n'est pas de faire une IHM qui marche mais seulement de montrer comment on peut adapter la ''Microchip Libraries for Applications'' pour n'importe quel usage.
 +
 +<WRAP center round important 60%>
 +Microchip licenses to you the right to use, modify, copy and distribute
 +Software only when embedded on a Microchip microcontroller or digital signal
 +controller that is integrated into your product or third party product
 +(pursuant to the sublicense terms in the accompanying license agreement).
 +
 +Donc la librairie n'est utilisable que sur du matériel Microchip.
 +
 +</WRAP>
 +
 +{{ :lang:c:gfx_mgl:mla_modif.zip |Source du travail}}
lang/c/gfx_mgl.1509525332.txt.gz · Dernière modification : 2017/11/01 09:35 de root