Les membres ayant 30 points peuvent parler sur les canaux annonces, projets et hs du chat.
La shoutbox n'est pas chargée par défaut pour des raisons de performances. Cliquez pour charger.

Forum Casio - Actualités


Index du Forum » Actualités » L'Atelier de Papy Sly - Part #1 - Présentation du fxSDK et du wording associé
Slyvtt Hors ligne Maître du Puzzle Points: 2316 Défis: 17 Message

L'Atelier de Papy Sly - Part #1 - Présentation du fxSDK et du wording associé

Posté le 24/01/2024 22:45

Bonjour mes Petits

Nous nous retrouvons donc réunis comme prévu dans mon atelier pour mener à bien ce tout premier épisode de notre série de tutos.

Liens vers l'ensemble des articles de la série
Cliquer pour enrouler
Pour rappel, les liens qui vont bien pour la série [c'est du WIP donc ce sera complété au fur et à mesure]:
- Introduction de la série
- Tuto #1 - Présentation du fxSDK et du wording associé
- Tuto #2 - Présentation en détail du jeu et premier prototype
- Tuto #3 - On entre dans le vif du sujet, un premier truc qui ressemble à un jeu
- Tuto #4 - Quand ça va mal, qu'est ce qu'on fait ? Car ça arrive toujours à un moment ou à un autre
- Tuto #5 - On ajoute quelques notions avancées

Le but sera aujourd'hui dans un premier temps de bien comprendre ce que contient le fxSDK en termes d'outils et d'expliquer le rôle de chacun. Cela pouvant être un peu difficile de s'y retrouver pour les nouveaux arrivants, il est donc intéressant de s'attarder un peu sur cette description et de bien poser les bases.
Le projet de jeu de Tower Defense sera codé en C++ (pas en C), il nous faudra donc spécifiquement modifier les paramétrages du projet pour autoriser l'utilisation du langage C++. Nous passerons donc du temps pour opérer ces changements et expliciter le rôle de chacune des modifications apportée. Là encore, le temps passé aujourd'hui sur cet aspect sera très certainement une aide pour vos projets futurs.

Autant être honnête dès à présent, ce ne sera certainement pas aujourd'hui l'épisode le plus sexy de la série, mais il aura au moins le mérite de poser de bonnes bases pour la suite. J'espère qu'il répondra aussi à de nombreuses questions que beaucoup se sont posées sans jamais oser demander

Bon donc c'est parti, soyez les bienvenus dans ce premier volet de la série intitulé :

Présentation du fxSDK et du wording associé


Tout d'abord pour introduire le sujet sans plagier la description ce qui a été dit par Lephenixnoir dans de précédents tutos, il faut rappeler ce qu'est un SDK et en particulier celui qui nous intéresse présentement. Un SDK, ou Software Development Kit (ie. Kit de Développement Logiciel dans la langue de Molière), est comme son nom l'indique, une collection d'outils dédiés à la création de logiciels pour une machine ou une architecture donnée. Avec ce dit kit, on sera en mesure de créer un logiciel (un jeu, un utilitaire, ...) qui fonctionnera sur la machine cible. Il contient donc divers logiciels permettant de convertir, programmer, compiler, transférer, ... des ressources en un programme capable de fonctionner sur la machine cible.

En l'occurrence, le fxSDK vise à proposer les outils nécessaires pour les calculatrices Casio basées sur des processeurs Renesas SuperH (SH3 et SH4). Cela fait une longue liste de machines supportées, tant à écrans couleurs comme les Prizm (fx-CG10, fx-CG20 et fxCG-50 / Graph 90+E) que les machines à écrans monochromes (fx9860GI/II/III ou Graph 35/35+/35+E/35+EII ainsi que Graph75/85/95 SD ou non). Bref, un large spectre pour vous faire plaisir. Un joli exemple de réalisation de projet transverse multi-machine est le projet collaboratif de l'été 2023 illustré par cette image:



Nous verrons donc dans une première section de ce tuto quels sont les outils disponibles dans fxSDK et quel est le rôle de chacun des composants. Nous en profiterons aussi pour détailler (un peu) les deux projets compagnons que sont gint et FxLibc qui constituent la fondation de vos programmes.

Nous regarderons alors plus dans le détail 2 fichiers très importants dans tout projet fxSDK et qui seront les chefs d'orchestre de la compilation de vos futurs programmes, à savoir les fichiers CMakeLists.txt et fxconv-metadata.txt.

Nous verrons enfin comment créer notre premier projet et nous le configurerons ensemble pour répondre à nos besoins spécifiques avant de compiler cet add-in "à blanc" et vérifier que tout fonctionne comme prévu.

Allez, c'est parti alors. Après ce blah-blah introductif, entrons dans le vif du sujet ...


a. Les différents outils du SDK (fxsdk, fxconv, fxgxa/fxg1a, fxlink ) qui fait quoi ?

Partons sur l'hypothèse que vous avez bien installé le fxSDK tel que préconisé dans le fil dédié ici en utilisant la méthode basée sur GiteaPC. Vous devriez vous retrouver avec dans votre répertoire /home/xxxxx/.local/bin (xxxxx étant votre nom d'utilisateur, il va sans dire) avec un certain nombre d'exécutables et ou de liens symboliques reliés aux outils du fxSDK. Voici dans mon cas ce que je peux trouver dans ce dit répertoire (commande ls -la pour information):



On peut voir entre autres toute une série de liens symboliques dont le nom est sh-elf-xxx et pointant vers le compilateur de GCC (mais si vous savez, le truc qui a compilé durant une plombe lors de l'installation du SDK ), ainsi que divers exécutables dont le nom commence par "fx". Ces derniers sont les outils proposés par fxSDK et pour lesquels nous allons apporter une explication détaillée.
En lisant ce paragraphe, une information importante est apparue, à savoir que le fxSDK repose sur le compilateur GCC. J'ouvre donc une rapide parenthèse : en effet, lors de l'installation du fxSDK et de ses dépendances, une version spécifique du compilateur GCC a été installée et configurée sur votre machine de manière à être en capacité de compiler du code machine pour l'architecture SuperH. Si vous aviez déjà GCC d'installé sur votre PC, sachez que ce sont deux installations complètement indépendantes. On parle alors de "Toolchain" et le système ne mélangera pas les installations (du moins en théorie).


Tout d'abord, fxsdk est un script qui permet de créer et de compiler les projets.

Pour créer un nouveau projet, il suffit de lancer la commande fxsdk new nom_du_projet dans un répertoire qui vous est accessible en écriture et fxsdk va créer un sous-répertoire intitulé nom_du_projet dans lequel seront placés tous les éléments de base pour débuter un projet. Il s'agit donc de la toute première opération à faire lorsque l'on désire débuter un nouveau projet. L'image suivante vous montre la capture de la commande
fxsdk new TowerDefense
et le détail des fichiers créés par fxSDK dans le sous-répertoire du projet.



Il est intéressant de lire les lignes retournées par fxSDK lors de la création du projet. En effet, fxSDK nous indique que le projet sera "buildé" via CMake. Ceci est désormais le fonctionnement par défaut, mais pour les plus velus d'entre vous, sachez qu'il est possible de générer un build via un Makefile.

Un coup de commande tree permet de lister les sous-répertoires et les fichiers dans ce projet minimal (qui est grosso modo un "hello world"). Mais nous y reviendrons un peu plus tard.

A ce stade, tout est disponible pour démarrer un projet soit destiné aux Graph couleurs, soit aux Graph monochromes. Afin de faciliter l'écriture de cette série de tutos, j'utiliserai à partir de maintenant l'abréviation "fxCG" pour les Graphs couleurs et "fx9860G" pour les Graphs monochromes.

Le projet en l'état est donc tout à fait buildable et on peut donc lancer une compilation telle quelle afin de tester que tout va bien via les commandes suivantes (qui sont précisées par le message de fxsdk à la création du projet) :
- fxsdk build-fx afin de générer un add-in au format g1a utilisable sur les fx9860G
- fxsdk build-cg afin de générer un add-in au format g3a utilisable sur les fxCG

Par défaut, les fichiers source compilés (fichier.c --> fichier.o) qui n'ont pas été modifiés ne sont pas recompilés. Cela permet de gagner pas mal de temps, mais crée parfois quelques couacs. On peut donc être amenés à devoir forcer la main au système. Pour ce faire, il suffit de rajouter une option -B pour forcer le rebuild intégral (par exemple fxsdk build-cg -B). Pour faire apparaître tous les détails durant la compilation (on dit passer en mode verbeux), on peut aussi rajouter l'option VERBOSE=1 afin d'avoir les lignes de compilations détaillées (cela sert souvent quand on cherche à comprendre un problème).

Voici une capture de la sortie de compilation en mode normal :


et la même chose en mode verbeux :


On retrouve toutes les infos du mode normal, mais noyées au milieu de très nombreuses lignes supplémentaires indiquant tout le détail du processus de compilation.

Il existe quelques autres options pour le script fxsdk, mais elles sont de moindre importance, nous ne les traiterons donc pas ici.


Le second outil présent dans le kit est fxconv dont le but, comme son nom l'indique, est d'opérer des conversions.

fxconv dispose d'un certain nombre de modules permettant par exemple de récupérer des images et de les convertir vers les formats utilisables dans votre code source, ou d'importer des polices de caractères personnelles afin de customiser vos projets. Mais fxconv est surtout capable, via l'ajout de convertisseurs ad-hoc personnels écrits en Python, de convertir à peu près n'importe quoi pour le rendre utilisable dans vos programmes sur calculatrice. Parmi les trucs cools vus passer, on peut citer :
- l'importation de fichiers issus de l'éditeur de niveaux Tiled avec support de multiples couches (ie. layers),
- l'importation de fichiers issus de Aseprite/Libresprite avec support des animations,
- l'importation de fichiers de niveaux, de fichiers obj issus de Blender par exemple, ...
Bref, un outil très utile une fois qu'on a bien pris le temps de l'étudier. Seule votre imagination vous limitera avec cet outil dans les mains et un peu de pratique.

Pour un premier projet, on considérera fxconv comme une boîte noire, mais si le besoin s'en fait sentir, nous pourrons parler plus spécifiquement de cet outil dans un tuto dédié dans le futur, quand nous aurons plus avancé dans les tutos.


fxgxa crée les fichiers g1a (format des add-ins fx9860G) et g3a (format des add-ins fxCG) à partir des programmes compilés.

fxgxa (et le lien symbolique fxg1a) ont pour rôle de récupérer le code exécutable généré par le compilateur et le linkeur (le "binaire" ou .bin) et de le rendre compatible et utilisable sur les machines Casio. Pour ce faire, le binaire doit être "habillé" de tout un tas de data (entête, calcul de checksum de validité, données représentant les icônes visibles dans le menu principal de vos machines, ...). Cette conversion est réalisée par fxgxa. Les interactions avec fxgxadu point de vue du programmeur sont assez limitées, mais on peut néanmoins préciser quelques données qui seront passées à fxgxa et qui de fait permettrons de finement ajuster nos add-ins (images représentant les icônes dans le menu, nom du programme, nom à afficher, numéro de version). Nous verrons cela en temps et en heure.

Si vous remontez quelques années en arrière dans le forum, vous trouverez peut-être des références à l'outil mkg3a, qui est le programme précédent qui faisait cette conversion pour les fxCG ou a fxg1a qui faisait la conversion pour fx9860G. Désormais fxgxa permet d'avoir un seul utilitaire pour les 2 cibles. Le lien symbolique fxg1a dont nous parlions précédemment point vers fxgxa et est présent pour des questions de rétrocompatibilité.


Enfin, dernier de la liste, mais pas le moindre en terme d'importance, fxlink est un outil permettant de communiquer entre votre PC et votre calculatrice et qui peut par exemple transférer des fichiers vers les Graph 35+E II et Graph 90+E en ligne de commande, mais aussi permettre à un add-in d'interagir avec votre PC. On peut par exemple envoyer des captures d'écran ou faire de la capture vidéo via gint avec un câble USB connecté au PC.

Historiquement, seule la communication dans le sens Calculatrice --> PC était possible, mais récemment, Lephenixnoir a repris complètement le driver USB et permis la mise en place la communication bidirectionnelle. Une démonstration très impressionnante de ce que l'on peut faire avec cet outil est donnée par la vidéo suivante:



Même si les outils qui vont suivre ne font pas explicitement partie du fxSDK, il est important de les citer car ils sont plus ou moins nécessaires au fonctionnement de vos projets ou vous faciliterons énormément la vie:

- giteapc est un script python permettant d'automatiser l'installation des programmes et des librairies depuis la forge Gitea de Planète Casio. Cet outil permet notamment d'installer des versions spécifiques (par exemple les versions de développement) de vos librairies ou de vos programmes et de maintenir à jour de manière simple votre toolchain de développement Casio.

- FxLibc est une librairie dont le rôle est de donner accès aux fonctions standards du C. On appelle d'ailleurs cette librairie la "librairie standard du C". Il s'agit de la retranscription la plus fidèle possible pour les machines Casio, des fonctions de base offertes par le langage C (printf(), scanf(), malloc(), ...). Il s'agit donc du socle premier sur lequel repose la plupart des programmes.

- gint est un micro-noyau monolithique (micro unikernel) permettant de faire la liaison entre les programmes et le matériel en apportant les drivers nécessaires au système. Cela permet par exemple de dessiner à l'écran, d'ouvrir le port USB, de récupérer les touches enfoncées ... Bref dès que l'on veut une interaction avec le matériel, il y a gint qui opère en arrière-plan.

Nous voici donc au bout de cette longue description, nous allons donc pouvoir attaquer les choses un peu plus concrètes et sérieuses.


b. Une explication du rôle des répertoires et des fichiers CMakeLists.txt et fxconv-metadata.txt

Maintenant que nous avons fait le tour des outils, passons à l'analyse des dossiers et fichiers présents dans un projet. Prenons l'exemple du projet de base :



A la racine de celui-ci, on trouve un seul fichier nommé CMakeLists.txt qui comme son nom l'indique est un fichier destiné à CMake. Il s'agit du fichier dans lequel vous pourrez piloter la gestion des fichiers source, des fichiers de ressources (ou assets) ainsi que les diverses options de compilation, de linkage, le nom de votre add-in, etc.

C'est donc un fichier central sur lequel vous aurez à intervenir extrêmement souvent. Il s'agit du pendant du fichier Makefile pour l'outil make.

On retrouve de base 3 répertoires dans la structure :
- src : qui contient les fichiers source, c'est-à-dire le code que vous allez écrire dans le cadre de votre programme,
- asset-cg: qui contient les ressources (assets) pour la fxCG (les images, les polices de caractère, les icônes ...) associées à un fichier fxconv-metadata.txt
- asset-fx: qui contient les ressources (assets) pour la fx9860G (les images, les polices de caractère, les icônes ...) elles aussi associées à un fichier fxconv-metadata.txt

Les fichiers fxconv-metadata.txt permettent de faire la liaison entre le fichier CMakeLists.txt vu précédemment, les ressources contenues dans le répertoire courant et l'outil fxconv. Il est destiné à préciser à fxconv divers paramètres pour mener à bien la conversion de chacune des ressources. Cela peut paraître un peu obscur, mais nous allons expliciter par un exemple rapidement par la suite.

Il est tout à fait possible d'organiser un projet différemment, ou de rajouter des sous-répertoires, notamment lorsque les projets deviennent importants en taille. L'important étant pour vous de vous y retrouver et surtout de bien indiquer à travers les fichiers CMakeLists.txt et fxconv-metadata.txt où se trouvent tous les éléments nécessaires à la bonne conduite du processus de compilation. Voici par exemple la structure d'un projet moyen en taille, mon jeu de Pinball. On retrouve globalement cette structure (sans assets-fx car le jeu est exclusif à la fxCG) et un détail dans le répertoire src :



Après compilation de notre exemple de projet Tower Defense, par exemple pour la Graph 90+E, donc en lançant la commande fxsdk build-cg on obtient l'arborescence suivante :



On note d'une part l'apparition d'un nouveau répertoire build-cg avec de très nombreux sous-répertoires et fichiers (j'ai volontairement limité la portée de la commande tree afin de ne pas surcharger l'image). Ce sous-répertoire contient l'ensemble des fichiers créés durant le processus de compilation et de linkage. On y trouve notamment le fichier binaire contenant le code machine compréhensible par le processeur SuperH (mais attention, pas par l'OS).

Et à la racine, on trouve le fichier g3a correspondant à notre add-in qui lui est reconnu par l'OS de nos machines. Il s'agit du fichier final généré par l'outil fxgxa à partir du fichier binaire et avec l'habillage attendu par l'OS pour être géré correctement.

Voilà qui en termine avec le tour d'horizon de la structure des fichiers et répertoires d'un projet type fxSDK. Passons donc désormais au paramétrage concret de ce projet.


c. Création d'un premier projet et mise en place du paramétrage de base

Notre projet vise à être écrit en C++, il nous faut donc configurer les paramètres adéquats dans CMakeLists.txt, car le langage par défaut des projets fxSDK est le C. On va donc profiter de l'occasion pour ajuster ce fichier, en y apportant les modifications nécessaires. Voici ci-après le fichier original que nous allons modifier

# Configure with [fxsdk build-fx] or [fxsdk build-cg], which provide the
# toolchain file and module path of the fxSDK

cmake_minimum_required(VERSION 3.15)
project(MyAddin)

include(GenerateG1A)
include(GenerateG3A)
include(Fxconv)
find_package(Gint 2.9 REQUIRED)

set(SOURCES
  src/main.c
  # ...
)
# Shared assets, fx-9860G-only assets and fx-CG-50-only assets
set(ASSETS
  # ...
)
set(ASSETS_fx
  assets-fx/example.png
  # ...
)
set(ASSETS_cg
  assets-cg/example.png
  # ...
)

fxconv_declare_assets(${ASSETS} ${ASSETS_fx} ${ASSETS_cg} WITH_METADATA)

add_executable(myaddin ${SOURCES} ${ASSETS} ${ASSETS_${FXSDK_PLATFORM}})
target_compile_options(myaddin PRIVATE -Wall -Wextra -Os)
target_link_libraries(myaddin Gint::Gint)

if("${FXSDK_PLATFORM_LONG}" STREQUAL fx9860G)
  generate_g1a(TARGET myaddin OUTPUT "MyAddin.g1a"
    NAME "MyAddin" ICON assets-fx/icon.png)
elseif("${FXSDK_PLATFORM_LONG}" STREQUAL fxCG50)
  generate_g3a(TARGET myaddin OUTPUT "MyAddin.g3a"
    NAME "MyAddin" ICONS assets-cg/icon-uns.png assets-cg/icon-sel.png)
endif()

La première chose à intégrer est la mise en place de la possibilité d'utiliser le C++. Il y a plusieurs lignes à modifier :

Indiquer le langage dans le projet via la ligne
Project(MyAddin)
qu'il faut changer en
project(TowerDefense VERSION 1.0 LANGUAGES CXX C ASM)

D'une part on met un nom de projet plus adéquat, mais on profite pour ajouter les langages pouvant être présents (ici C, C++ (attention il faut écrire CXX) et potentiellement ASM)

Attention, il faut aussi ajouter un paramètre sur la ligne
target_compile_options(myaddin PRIVATE -Wall -Wextra -Os)
pour définir quelle version du langage C++ on va retenir
target_compile_options(myaddin PRIVATE -Wall -Wextra -Os -std=c++20)
ici on va se baser sur le standard C++20 qui est l'un des plus récents et offre énormément de fonctionnalités.

Il faut aussi pouvoir utiliser la librairie standard du C++ qui apporte beaucoup d'améliorations (les std::string, les différents conteneurs (std::vector, std::list, std::map, etc. ) et plein d'algorithmes utiles, comme par exemple des algorithme de tri, de générations de nombres aléatoires, etc.). Pour ce faire il faut changer la ligne
target_link_libraries(myaddin Gint::Gint)
et la remplacer par
target_link_libraries(myaddin Gint::Gint -lstdc++)


Enfin, profitons de l'occasion pour ajuster le nom des fichiers g1a et g3a et des titres des add-ins pour les deux machines (fx9860G et fxCG respectivement) dans la toute dernière section du fichier.
if("${FXSDK_PLATFORM_LONG}" STREQUAL fx9860G)
  generate_g1a(TARGET myaddin OUTPUT "MyAddin.g1a"
    NAME "MyAddin" ICON assets-fx/icon.png)
elseif("${FXSDK_PLATFORM_LONG}" STREQUAL fxCG50)
  generate_g3a(TARGET myaddin OUTPUT "MyAddin.g3a"
    NAME "MyAddin" ICONS assets-cg/icon-uns.png assets-cg/icon-sel.png)
endif()
à remplacer par :
if("${FXSDK_PLATFORM_LONG}" STREQUAL fx9860G)
  generate_g1a(TARGET myaddin OUTPUT "TDefense.g1a"
    NAME "TowerDefense" ICON assets-fx/icon.png)
elseif("${FXSDK_PLATFORM_LONG}" STREQUAL fxCG50)
  generate_g3a(TARGET myaddin OUTPUT "Tdefense.g3a"
    NAME "TowerDefense" ICONS assets-cg/icon-uns.png assets-cg/icon-sel.png)
endif()


A ce stade, on a tout bien configuré et on est OK pour faire du C++. Mais comme je suis un vieux Papy, j'ai mes petites habitudes et personnellement, j'aime reconnaître avec l'extension des fichiers source si je travaille en C ou en C++. Je procède donc avec la convention suivante :
- les fichiers source en C portent l'extension ".c" et les fichiers headers en C portent l'extension ".h"
- les fichiers source en C++ portent l'extension ".cpp" et les fichiers headers en C++ portent l'extension ".hpp"

Je vais donc renommer le fichier main.c en main.cpp, en changeant bien la ligne correspondante dans le fichier CMakeLists.txt:
set(SOURCES
  src/main.c
  # ...
)
devient :
set(SOURCES
  src/main.cpp
  # ...
)


Au final, on se retrouve donc avec le fichier CMakeLists.txt suivant :
# Configure with [fxsdk build-fx] or [fxsdk build-cg], which provide the
# toolchain file and module path of the fxSDK

cmake_minimum_required(VERSION 3.15)
project(TowerDefense VERSION 1.0 LANGUAGES CXX C ASM)

include(GenerateG1A)
include(GenerateG3A)
include(Fxconv)
find_package(Gint 2.9 REQUIRED)

set(SOURCES
  src/main.cpp
  # ...
)
# Shared assets, fx-9860G-only assets and fx-CG-50-only assets
set(ASSETS
  # ...
)
set(ASSETS_fx
  assets-fx/example.png
  # ...
)
set(ASSETS_cg
  assets-cg/example.png
  # ...
)

fxconv_declare_assets(${ASSETS} ${ASSETS_fx} ${ASSETS_cg} WITH_METADATA)

add_executable(myaddin ${SOURCES} ${ASSETS} ${ASSETS_${FXSDK_PLATFORM}})
target_compile_options(myaddin PRIVATE -Wall -Wextra -Os -std=c++20)
target_link_libraries(myaddin Gint::Gint -lstdc++)

if("${FXSDK_PLATFORM_LONG}" STREQUAL fx9860G)
  generate_g1a(TARGET myaddin OUTPUT "TDefense.g1a"
    NAME "TowerDefense" ICON assets-fx/icon.png)
elseif("${FXSDK_PLATFORM_LONG}" STREQUAL fxCG50)
  generate_g3a(TARGET myaddin OUTPUT "Tdefense.g3a"
    NAME "TowerDefense" ICONS assets-cg/icon-uns.png assets-cg/icon-sel.png)
endif()


Afin de tester un code C++, je vous propose de coller le code suivant dans votre fichier main.cpp en lieu et place du code existant :
#include <gint/display.h>
#include <gint/keyboard.h>

#include <vector>
#include <algorithm>

int main(void)
{
    dclear(C_WHITE);
    
    dtext(1, 1, C_BLACK, "fxSDK with C++");
    
    std::vector <int> v{ 1, 5, 8, 9, 6, 7, 3, 4, 2, 0 };
  
    dtext(1, 12, C_BLACK, "Unsorted" );
  
    for( int i=0; i<v.size(); i++ )
      dprint( 1, 24+12*i, C_BLACK, "%i", v[i] );
  
    sort(v.begin(), v.end(), std::less<int>());

    dtext(100, 12, C_BLACK, "Sorted" );
  
    for( int i=0; i<v.size(); i++ )
      dprint( 100, 24+12*i, C_BLACK, "%i", v[i] );
    
    dupdate();

    getkey();
    return 1;
}


De sauvegarder les modifications, puis de compiler depuis la racine de votre projet en faisant un fxsdk build-cg ou fxsdk build-fx

Vous pouvez ensuite tranférer l'add-in obtenu sur votre machine et le lancer.

Oh miracle, vous avez programmé votre premier add-in en C++ fonctionnel.

Voici sur Graph 90+E ce que cela donne (ma version contient des couleurs pour illustrer, mais le code fournit sortira en noir pour être compatible avec la fx9860G, donc pas de panique ).



Voilà qui en termine avec ce très long tuto, pas forcément le plus fun, mais qui j'espère vous aura permis de mieux comprendre comment fonctionne le fxSDK. Notre architecture de projet est désormais en place, dûment configurée, on va donc pouvoir commencer à s'amuser dès le prochain épisode et attaquer le développement de notre petit jeu.

Vous trouverez dans le fichier ZIP attaché une copie du projet dûment configuré et fonctionnel. N'hésitez pas à poster vos questions et/ou vos commentaires. Je tâcherai de répondre à tous vos posts.

On se retrouve donc très rapidement pour le prochain épisode de cette série de tutos, gardez un œil bien ouvert sur la page d'accueil et guettez bien le retour de Papy Sly.

C'est pas tout ça, je vais aller me faire une camomille ...

A très bientôt mes Petiots

Papy Sly


Edit 25/01/2023 : corrigé quelques typos qui étaient passées entre les mailles du filet

Fichier joint


Tuper4 Hors ligne Membre Points: 847 Défis: 19 Message

Citer : Posté le 25/01/2024 23:38 | #


Désolé pour le hors sujet mais la cg 20, peut elle lire des g3a comme la 90+e? Et il me semble qu'elle n'as pas plusieurs couleurs(l'écran), est ce vrai? Je supprime le message quand j'aurais une réponse pour éviter la dégradation du sujet
Ne vous arrêtez pas quand vous êtes fatigé(e), arrêtez vous quand vous avez terminez.
Tituya Hors ligne Administrateur Points: 2141 Défis: 26 Message

Citer : Posté le 26/01/2024 00:00 | #


https://www.planet-casio.com/Fr/infos/prizm : "Assembleur/C/C++ : transfère les fichiers .g3a à la racine de la mémoire de stockage. Les add-ins sont dans la catégorie Prizm (utilitaires, jeux, cours). Les add-ins pour Graph 90+E (utilitaires, jeux, cours) peuvent être compatibles ; s'ils ne le sont pas, un portage est souvent possible avec un peu d'effort, dans le sens inverse du portage Prizm → Graph 90+E mentionné sur ce topic. Utilise le fxSDK ou le Prizm SDK pour programmer des add-ins."

En gros oui.
Bretagne > Reste du globe
(Et de toute façon, vous pouvez pas dire le contraire)
Projet en cours : Adoranda

Mes programmes
Hésite pas à faire un test !


Slyvtt Hors ligne Maître du Puzzle Points: 2316 Défis: 17 Message

Citer : Posté le 26/01/2024 08:58 | #


Les add-ins pour fxCG10 et fxCG20 sont au format g3a. L'immense majorité des add-ins sont compatibles fxCG10/20 et Graph 90+E (qui s'appelle fxCG50 à l'international), mais certains avec des fonctionnalités exotiques ne sont pas compatibles).

Les différences principales entre les fxCG10/20 et fxCG50 sont:
plus de mémoire pour la fxCG50 (on passe d'une puce RAM de 2Mo à une puce RAM de 8Mo. Ce qui fait que certains add-ins peuvent récupérer jusqu'à 3Mo de RAM supplémentaires sur la fxCG50 (et donc pas dispo sur fxCG10/20)
le processeur, bien qu'identique (une base de SH4 modèle SH7305) est cadencé avec une fréquence plus élevée sur la fxCG50 (116MHz en fréquence de base) contre 56MHz pour les fxCG10/20. A noter qu'avec PTune on sait gommer cette différence en overclockant le processeur, de même les addins gint peuvent désormais très facilement "recaler" les fréquence pour mettre les fxCG10/20 et 50 au même niveau de performance (on a l'overclock sur toutes les machines supportées par fxSDK/gint).
pour le reste tout est identique, ou est perçu comme étant identique.

Donc in fine, il n'y a vraiment que la RAM qui diffère. Pour les add-ins peu gourmand c'est donc transparent, pour les autres, par exemple Doom, PythonExtra, Khicas, ..., il faut soit faire des versions dédiées soit accepter que ça ne fonctionne pas sur cet ancien matériel. Il est à noter que l'on peut tester le modèle dans gint et avoir un add-in qui fonctionne sur les deux machines en ajustant la mémoire dispo et en overclockant le processeur de la fxCG10, c'est par exemple ce que je fais en Outrun et Shmup qui demandent beaucoup de ressources.

A noter que même Azur, le moteur de rendu hautes performances écrit par Lephé, fonctionne sur fxCG10/20.

Pour terminer, la fxCG10 et 20 étaient la même machine physique, mais le marché US demandait des spécifications particulières au niveau de la partie logicielle. On a donc créé la version fxCG10 pour les USA et fxCG20 pour les autres pays (je rentrerai pas dans le détail de la version fxCG20AU spécifique à l'Australie qui limite la mémoire). Vous trouverez aussi le nom Prizm qui recoupe tout ce petit monde.

Voili voilà ...
There are only 10 types of people in the world: Those who understand binary, and those who don't ...
Tuper4 Hors ligne Membre Points: 847 Défis: 19 Message

Citer : Posté le 26/01/2024 09:14 | #


Merci Papy Sly . Je voulais juste savoir car j'hésite si j'en achète une et donc je voulais juste avoir des infos. Merci
Ne vous arrêtez pas quand vous êtes fatigé(e), arrêtez vous quand vous avez terminez.
Slyvtt Hors ligne Maître du Puzzle Points: 2316 Défis: 17 Message

Citer : Posté le 26/01/2024 09:19 | #


Juste point important, pas de Python Officiel sur fxCG10/20. Et PythonExtra aura des limitations, peut être moins que sur G35+EII, mais sera bridé par rapport à une G90+E/fxCG50 par le manque de RAM.
There are only 10 types of people in the world: Those who understand binary, and those who don't ...
Slyvtt Hors ligne Maître du Puzzle Points: 2316 Défis: 17 Message

Citer : Posté le 26/01/2024 11:53 | #


Pour être honnête, acheter une fxCG20 aujourd'hui est intéressant pour les codeurs (dont je fais partie) pour tester les addins et vérifier leur compatibilité, mais pour un utilisateur autre, il vaut mieux chercher une Graph 90+E ou fxCG50, quitte à regarder du côté de l'occasion où on peut tombersur d'excellentes affaires. Tu risques de ronger ton frein à cause des limitations si tu veux vraiment t'en servir par la suite (sachant en plus que le mode examen n'existe pas sur la fxCG10/20, mais je sais pas si tu es concerné par ce point).

Pour comparer le plus et le moins : https://www.planet-casio.com/Fr/infos/comparateur?cg20,g90+e
There are only 10 types of people in the world: Those who understand binary, and those who don't ...
Tuper4 Hors ligne Membre Points: 847 Défis: 19 Message

Citer : Posté le 26/01/2024 11:56 | #


Slyvtt a écrit :
Pour être honnête, acheter une fxCG20 aujourd'hui est intéressant pour les codeurs (dont je fais partie) pour tester les addins et vérifier leur compatibilité, mais pour un utilisateur autre, il vaut mieux chercher une Graph 90+E ou fxCG50, quitte à regarder du côté de l'occasion où on peut tombersur d'excellentes affaires. Tu risques de ronger ton frein à cause des limitations si tu veux vraiment t'en servir par la suite (sachant en plus que le mode examen n'existe pas sur la fxCG10/20, mais je sais pas si tu es concerné par ce point).

Pour comparer le plus et le moins : https://www.planet-casio.com/Fr/infos/comparateur?cg20,g90+e
Merci beaucoup pour ta réponse détaillé alors je ne crois pas que je vais en prendre une .
Ne vous arrêtez pas quand vous êtes fatigé(e), arrêtez vous quand vous avez terminez.
Fastgeek Hors ligne Membre Points: 152 Défis: 0 Message

Citer : Posté le 27/01/2024 07:07 | #


Ooooouh, une série de tutos sur le fx-SDK, coooool.
Au moins j'ai plus de raisons pour ne pas apprendre à l'utiliser

Super concept, et super "cours" papy Sly
"Always believe in your dreams, and work hard to achieve them"
FastGeek, a very simple guy

Projet(s) terminé(s) : CRL
Projet(s) en cours :CRLII
Ptitjoz Hors ligne Membre Points: 250 Défis: 10 Message

Citer : Posté le 06/02/2024 13:48 | #


bon, Papy, ça commençait bien puis j'ai dû faire une bêtise...
et là le fxsdk build-fx ne dit plus grand chose...
je te raconte ce que j'ai fait...

joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ fxsdk build-fx
-- The ASM compiler identification is GNU
-- Found assembler: /home/joz/.local/bin/sh-elf-gcc
-- Configuring done
-- Generating done
-- Build files have been written to: /home/joz/Developpement/Casio/TutoPapySly/TowerDefense/build-fx
[ 33%] Building CXX object CMakeFiles/myaddin.dir/src/main.cpp.obj
/home/joz/Developpement/Casio/TutoPapySly/TowerDefense/src/main.cpp: Dans la fonction « int main() »:
/home/joz/Developpement/Casio/TutoPapySly/TowerDefense/src/main.cpp:17:20: attention: comparaison d'expressions entières de types signés différents: « int » et « std::vector<int>::size_type » {aka « unsigned int »} [-Wsign-compare]
   17 |     for( int i=0; i<v.size(); i++ )
      |                   ~^~~~~~~~~
/home/joz/Developpement/Casio/TutoPapySly/TowerDefense/src/main.cpp:24:20: attention: comparaison d'expressions entières de types signés différents: « int » et « std::vector<int>::size_type » {aka « unsigned int »} [-Wsign-compare]
   24 |     for( int i=0; i<v.size(); i++ )
      |                   ~^~~~~~~~~
[ 66%] Building FXCONV object CMakeFiles/myaddin.dir/assets-fx/example.png.o
[100%] Linking CXX executable myaddin
[100%] Built target myaddin
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls
assets-cg  build-fx        CMakeLists.txt.old  src
assets-fx  CMakeLists.txt  MyAddin.g1a         TDefense.g1a
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ rm TDefense.g1a
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ fxsdk build-fx
[100%] Built target myaddin
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls
assets-cg  build-fx        CMakeLists.txt.old  src
assets-fx  CMakeLists.txt  MyAddin.g1a
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ rm MyAddin.g1a
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ fxsdk build-fx
[100%] Built target myaddin
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls
assets-cg  assets-fx  build-fx  CMakeLists.txt  CMakeLists.txt.old  src
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls
assets-cg  assets-fx  build-fx  CMakeLists.txt  CMakeLists.txt.old  src
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls -a
.   assets-cg  build-fx        CMakeLists.txt.old  src
..  assets-fx  CMakeLists.txt  .gitignore
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ fxsdk build-fx
[100%] Built target myaddin
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls
assets-cg  assets-fx  build-fx  CMakeLists.txt  CMakeLists.txt.old  src
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ fxsdk build-fx
[100%] Built target myaddin
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$ ls
assets-cg  assets-fx  build-fx  CMakeLists.txt  CMakeLists.txt.old  src
joz@emachines:~/Developpement/Casio/TutoPapySly/TowerDefense$


merci de tes conseils (je ne te réveille pas j'espère ? )
Un peu poète, un peu geek, un peu rêveur, un peu écolo.
https://joz.alwaysdata.net/info/

Lephenixnoir Hors ligne Administrateur Points: 24288 Défis: 170 Message

Citer : Posté le 06/02/2024 14:03 | #


Il n'y a pas de problème avec ça. Les deux messages commencent par "attention" et sont en jaune. Ce ne sont pas des erreurs, juste des avertissements (warnings) qui te signalent des trucs louches.

En l'occurrence le truc louche est une comparaison directe entre un nombre signé (un type d'entier qui peut être à la fois positif ou négatif) et un nombre non signé (un type d'entier qui ne peut être que positif). Ces deux types diffèrent sur les valeurs négatives et les très grandes valeurs positives ce qui peut parfois cacher un bug. Mais ce n'est pas le cas ici.

Corriger les warnings est vu comme une marque de bon goût et bonne pratique mais ce n'est pas indispensable, et dans ce cas le programme va marcher quand même.

Le fait que supprimer le g1a ne produise aucun effet est également normal. La compilation prend plusieurs étapes (discutées dans ce TDM) et le fichier g1a n'est que le résultat final. Il y a plein de fichiers intermédiaires cachés dans build-fx. Tant que ces fichiers existent encore la compilation n'est pas refaite et donc les messages ne réapparaissent pas. Si tu veux forcer une recompilation complète tu peux compiler avec "fxsdk build-fx -B" ou supprimer build-fx.
Mon graphe (11 Avril): ((Rogue Life || HH2) ; PythonExtra ; serial gint ; Boson X ; passe gint 3 ; ...) || (shoutbox v5 ; v5)
Ptitjoz Hors ligne Membre Points: 250 Défis: 10 Message

Citer : Posté le 06/02/2024 14:12 | #


Merci Lephe pour tes explications.
comme j'avais supprimé le g1a j'ai pu le recréer en recompilant avec une option par fxsdk build-fx -B

Alors voilà, Papy, mon premier cours dans ton atelier touche à sa fin et je pense avoir à peu près compris (dans les grandes lignes !!)

voici le résultat de ce travail (en fait, je n'ai fait que du recopiage...) :


Bien à vous
Un peu poète, un peu geek, un peu rêveur, un peu écolo.
https://joz.alwaysdata.net/info/

Slyvtt Hors ligne Maître du Puzzle Points: 2316 Défis: 17 Message

Citer : Posté le 06/02/2024 15:01 | #


Super, je suis content que ça marche.

Alors effectivement c'est un warning donc rien de grave. Néanmoins, si tu veux faire les choses proprement et virer les warnings, tu peux juste remplacer les lignes 17 et 24 qui sont actuellement :
for( int i=0; i<v.size(); i++ )

par
for( unsigned int i=0; i<v.size(); i++ )

et logiquement ça devrait plus te crier dessus lors de la compilation.
There are only 10 types of people in the world: Those who understand binary, and those who don't ...

LienAjouter une imageAjouter une vidéoAjouter un lien vers un profilAjouter du codeCiterAjouter un spoiler(texte affichable/masquable par un clic)Ajouter une barre de progressionItaliqueGrasSoulignéAfficher du texte barréCentréJustifiéPlus petitPlus grandPlus de smileys !
Cliquez pour épingler Cliquez pour détacher Cliquez pour fermer
Alignement de l'image: Redimensionnement de l'image (en pixel):
Afficher la liste des membres
:bow: :cool: :good: :love: ^^
:omg: :fusil: :aie: :argh: :mdr:
:boulet2: :thx: :champ: :whistle: :bounce:
valider
 :)  ;)  :D  :p
 :lol:  8)  :(  :@
 0_0  :oops:  :grr:  :E
 :O  :sry:  :mmm:  :waza:
 :'(  :here:  ^^  >:)

Σ π θ ± α β γ δ Δ σ λ
Veuillez donner la réponse en chiffre
Vous devez activer le Javascript dans votre navigateur pour pouvoir valider ce formulaire.

Si vous n'avez pas volontairement désactivé cette fonctionnalité de votre navigateur, il s'agit probablement d'un bug : contactez l'équipe de Planète Casio.

Planète Casio v4.3 © créé par Neuronix et Muelsaco 2004 - 2024 | Il y a 33 connectés | Nous contacter | Qui sommes-nous ? | Licences et remerciements

Planète Casio est un site communautaire non affilié à Casio. Toute reproduction de Planète Casio, même partielle, est interdite.
Les programmes et autres publications présentes sur Planète Casio restent la propriété de leurs auteurs et peuvent être soumis à des licences ou copyrights.
CASIO est une marque déposée par CASIO Computer Co., Ltd