Préambule

La librairie est accompagnée de 31 exemples d'utilisation. Ces exemples sont les plus simples possibles afin de ne pas trop encombrer le code avec trop de lignes qui ne concerneraient pas les widgets de la librairie. Cette rubrique donne les directives pour pouvoir charger, compiler et exécuter ces exemples.

Version Linux

Si vous avez suivi la procédure d'installation conseillée en page Installation Librairie TXSLib, la compilation et l'exécution devraient fonctionner sans modifications. Pour cela, lancez QtCreator et ouvrez le fichier projet "Demos.pro" situé dans le répertoire "/home/pi/TXSLib/Demos". Lancez une compilation globale. Une fois la compilation terminée vous pouvez exécuter tous les exemples. Il y a toutefois 2 exceptions.

Les exemples "Image" et "ImageList" utilisent des fichiers image pour fonctionner. Ces images se situent dans le répertoire "/home/pi/TXSLib/Demos". Il est nécessaire de copier ces fichiers dans les répertoires d'exécution de ces exemples. Selon la compilation en version "Debug" ou "Release" que vous avez effectuée, vous devrez copier les fichiers suivants :

  - En version Debug :
    - Copier le fichier "/home/pi/TXSLib/Demos/lac.jpg" vers le répertoire ""/home/pi/TXSLib/Demos/build-Demos-Desktop-Debug/Image"
    - Copier les fichiers "/home/pi/TXSLib/Demos/engine*.jpg" vers le répertoire ""/home/pi/TXSLib/Demos/build-Demos-Desktop-Debug/ImageList"

  - En version Release :
    - Copier le fichier "/home/pi/TXSLib/Demos/lac.jpg" vers le répertoire ""/home/pi/TXSLib/Demos/build-Demos-Desktop-Release/Image"
    - Copier les fichiers "/home/pi/TXSLib/Demos/engine*.jpg" vers le répertoire ""/home/pi/TXSLib/Demos/build-Demos-Desktop-Release/ImageList"

Cas ou TXSLib n'est pas installée dans les répertoires "standard" de l'installation par défaut :

Dans ce cas, si vous lancez une compilation, vous aurez des erreurs. Ces erreurs sont dues au fait que Qt ne trouve pas les fichiers de la librairie ou il sont indiqués par les fichiers projet ".PRO" des exemples. Dans ce cas, le meilleur moyen de corriger le problème est le suivant :

 - Ouvrez le fichier "AnalogLed.pro"
 - En fin de fichier vous trouverez les lignes suivantes :

 - Supprimez ces lignes
 - Sauvez le fichier
 - Cliquez avec le bouton droit de la souris sur le répertoire "AnalogLed" de l'arbre de projets de Qt comme indiqué ci-dessous :


 - Dans le menu déroulant, choisissez l'option "AddLibrary" (En français : "Ajouter une librairie"). La fenêtre suivante doit s'ouvrir :


 - Dans cette fenêtre, choisissez l'option "External Library" comme le montre l'image. Cliquez sur "Next"". Une nouvelle fenêtre s'ouvre :


 - Cliquez sur le bouton "Browse" de la ligne "Library File". Cherchez sur votre disque et sélectionnez le fichier "libTXSLib.so"
 - Cliquez sur le bouton "Browse" de la ligne "Include Path". Cherchez sur votre disque et sélectionnez le répertoire ou se situent les fichiers ".h de la librairie.
 - Décochez les cases "Mac" et "Windows"
 - Cliquez sur "Next", puis dans le fenêtre suivante cliquez sur "Finish"
 - Les lignes que nous avons supprimées en début de procédure ont été remplacées par des lignes adaptées à votre installation.
 - Dans tous les autres fichiers ".pro" de tous les exemples, rempacez les 3 lignes qui nous avons supprimées en début de procédure par les 3 nouvelles lignes ajoutées dans le fichier "AnalogLed.pro". C'est fastidieux, mais c'est le plus rapide.
 - Vous devriez pouvoir recompiler tous les exemples sans erreurs.
 - N'oubliez pas de copier les fichiers image tel que décrit en haut de cette page.

Version Windows

Si vous avez suivi la procédure d'installation conseillée en page Installation Librairie TXSLib, la compilation et l'exécution devraient fonctionner sans modifications. Etant donné que vous pouvez dézipper dans n'importe quel répertoire de votre PC, nous prenons ici pour exemple une opération de dézip effectuée dans le répertoire de base de C:. Vous disposez donc d'un répertoire nommé "C:\TXSLib". Pour ouvrir les exemples, lancez QtCreator et ouvrez le fichier projet "Demos.pro" situé dans le répertoire "C:\TXSLib\Demos". Lancez une compilation globale. Une fois la compilation terminée vous pouvez exécuter tous les exemples. Il y a toutefois 2 exceptions.

Les exemples "Image" et "ImageList" utilisent des fichiers image pour fonctionner. Ces images se situent dans le répertoire "C:\TXSLib\Demos". Il est nécessaire de copier ces fichiers dans les répertoires d'exécution de ces exemples. Selon la compilation en version "Debug" ou "Release" que vous avez effectuée, vous devrez copier les fichiers suivants :

  - En version Debug :
    - Copier le fichier "C:\TXSLib\Demos\lac.jpg" vers le répertoire ""C:\TXSLib\Demos\build-Demos-Desktop_Qt_6_4_2_MinGW_64_bit-debug\Image\debug"
    - Copier les fichiers "C:\TXSLib\Demos\engine*.jpg" vers le répertoire ""C:\TXSLib\Demos\build-Demos-Desktop_Qt_6_4_2_MinGW_64_bit-debug\ImageList\debug"

  - En version Release :
    - Copier le fichier "C:\TXSLib\Demos\lac.jpg" vers le répertoire ""C:\TXSLib\Demos\build-Demos-Desktop_Qt_6_4_2_MinGW_64_bit-release\Image\release"
    - Copier les fichiers "C:\TXSLib\Demos\engine*.jpg" vers le répertoire ""C:\TXSLib\Demos\build-Demos-Desktop_Qt_6_4_2_MinGW_64_bit-release\ImageList\release"