gint : un noyau pour développer des add-ins
Posté le 20/02/2015 17:30
Ce topic fait partie de la série de topics du fxSDK.
En plus des options de programmation intégrée comme le Basic Casio ou Python, la plupart des calculatrices Casio supportent des
add-ins, des programmes natifs très polyvalents avec d'excellentes performances. Les add-ins sont généralement programmés en C/C++ avec l'aide d'un ensemble d'outils appelé SDK.
Plusieurs SDK ont été utilisés par la communauté avec le temps. D'abord le
fx-9860G SDK de Casio avec fxlib pour Graph monochromes (plus maintenu depuis longtemps). Puis le
PrizmSDK avec libfxcg pour Prizm et Graph 90+E (encore un peu actif sur Cemetech). Et plus récemment celui que je maintiens, le
fxSDK, dont gint est le composant principal.
gint est un unikernel, ce qui veut dire qu'il embarque essentiellement un OS indépendant dans les add-ins au lieu d'utiliser les fonctions de l'OS de Casio. Ça lui permet beaucoup de finesse sur le contrôle du matériel, notamment la mémoire, le clavier, l'écran et les horloges ; mais aussi de meilleures performances sur le dessin, les drivers et la gestion des interruptions, plus des choses entièrement nouvelles comme le moteur de gris sur Graph monochromes.
Les sources de gint sont sur la forge de Planète Casio :
dépôt Gitea Lephenixnoir/gint
Aperçu des fonctionnalités
Les fonctionnalités phares de gint (avec le fxSDK) incluent :
- Toutes vos images et polices converties automatiquement depuis le PNG, sans code à copier (via fxconv)
- Un contrôle détaillé du clavier, avec un GetKey() personnalisable et un système d'événements à la SDL
- Une bibliothèque standard C plus fournie que celle de Casio (voir fxlibc), et la majorité de la bibliothèque C++
- Plein de raccourcis pratiques, comme pour afficher la valeur d'une variable : dprint(1,1,"x=%d",x)
- Des fonctions de dessin, d'images et de texte optimisées à la main et super rapides, surtout sur Graph 90+E
- Des timers très précis (60 ns / 30 µs selon les cas, au lieu des 25 ms de l'OS), indispensables pour les jeux
- Captures d'écran et capture vidéo des add-ins par USB, en temps réel (via fxlink)
Avec quelques mentions spéciales sur les Graph monochromes :
Un moteur de gris pour faire des jeux en 4 couleurs !
La compatibilité SH3, SH4 et Graph 35+E II, avec un seul fichier g1a
Une API Unix/POSIX et standard C pour accéder au système de fichiers (Graph 35+E II seulement)
Et quelques mentions spéciales sur les Graph 90+E :
Une nouvelle police de texte, plus lisible et économe en espace
Le dessin en plein écran, sans les bordures blanches et la barre de statut !
Un driver écran capable de triple-buffering
Une API Unix/POSIX et standard C pour accéder au système de fichiers
Galerie d'add-ins et de photos
Voici quelques photos et add-ins réalisés avec gint au cours des années !
Arena (2016) — Plague (2021)
Rogue Life (2021)
Momento (2021)
Communication avec le PC (cliquez pour agrandir)
Utiliser gint pour développer des add-ins
Les instructions pour installer et utiliser gint sont données dans les divers tutoriels recensés dans le
topic du fxSDK. Il y a différentes méthodes de la plus automatique (GiteaPC) à la plus manuelle (compilation/installation de chaque dépôt). Le fxSDK est compatible avec Linux, Mac OS, et marche aussi sous Windows avec l'aide de WSL, donc normalement tout le monde est couvert
Notez en particulier qu'il y a des
tutoriels de développement qui couvrent les bases ; tout le reste est expliqué dans les en-têtes (fichiers
.h) de la bibliothèque que vous pouvez
consulter en ligne, ou dans les ajouts aux changelogs ci-dessous.
Changelog et informations techniques
Pour tester les fonctionnalités et la compatibilité de gint, j'utilise un add-in de test appelé gintctl (
dépôt Gitea Lephenixnoir/gintctl). Il contient aussi une poignée d'utilitaires d'ordre général.
Ci-dessous se trouve la liste des posts indiquant les nouvelles versions de gint, et des liens vers des instructions/tutoriels supplémentaires qui accompagnent ces versions.
Anecdotes et bugs pétés
Ô amateurs de bas niveau, j'espère que vous ne tomberez pas dans les mêmes pièges que moi.
TODO list pour les prochaines versions (2023-04-03)
gint 2.11
- Changements de contextes CPU. À reprendre du prototype de threading de Yatis pour permettre l'implémentation d'un véritable ordonnanceur. Demandé par si pour faire du threading Java.
- Applications USB. Ajouter le support de descripteurs de fichiers USB. Potentiellement pousser jusqu'à avoir GDB pour debugger.
- Support de scanf() dans la fxlibc. Codé par SlyVTT, plus qu'à nettoyer et fusionner.
Non classé
- Regarder du côté serial (plus facile que l'USB) pour la communication inter-calculatrices (multijoueur) et ultimement l'audio (libsnd de TSWilliamson).
- Un système pour recompiler des add-ins mono sur la Graph 90+E avec une adaptation automatique.
- Support des fichiers en RAM pour pouvoir utiliser l'API haut-niveau sur tous les modèles et éviter la lenteur de BFile à l'écriture quand on a assez de RAM.
Citer : Posté le 22/07/2019 22:10 | #
Comment est-ce que les images sont encodées ?
Je vois qu'il y a un tableau data, mais si je veux acceder manuellement à la couleur d'un pixel, comment dois je faire ?
L'intérêt c'est de pouvoir encoder les textures dans des .png et de pouvoir les déformer
Citer : Posté le 22/07/2019 22:36 | # |
Fichier joint
Euh... je ne pense pas que le format de bopti soit le bon format pour ça. J'ai écrit de la doc là-dessus, je te la mets en pièce jointe pour que tu puisses voir. Tout sauf la structure à la fin est complètement à jour.
Pour résumer : l'image est découpée en calques qui sont dessinés les uns à la suite des autres. Chaque opération dessine les pixels par groupes de 32 donc gint ne manipule jamais un seul pixel à fois. Les couleurs sont réparties sur plusieurs calques donc gint ne manipule jamais une couleur à la fois. Et donc encore moins la couleur d'un seul pixel.
Si tu veux pouvoir faire du traitement d'images, il faut que tu te trouves un format approprié. Celui de bopti n'est clairement pas bien... il est fait pour que le dessin soit fulgurant et c'est tout.
Si jamais l'envie te prend de faire ça proprement, je l'intégrerai avec plaisir dans fxconv.
(Et merci encore pour ta contribution sur le DMA, je m'excuse de mettre longtemps à m'en occuper. Je suis sur ma dernière semaine de stage et c'est très intense !
Citer : Posté le 28/07/2019 01:59 | # |
Fichier joint
Après beaucoup d'efforts d'implémentation, le moteur de gris est maintenant complètement opérationnel et poussé sur le dépôt !
Les fonctions de contrôle principales sont gray_start(), gray_stop() et gupdate().
Les nouvelles fonctions de dessin sont gclear(), grect(), gpixel(), gline(). Auxquelles s'ajoutent gtext(), gimage() et gsubimage(). Les images en gris supportent également la transparence comme les autres (repérée sur la photo par le damier) !
Compilez la dernière version de la bibliothèque pour bénéficier de ces changements. Prochaine étape, les images sur la Graph 90+E. J'ai déjà des idées assez précises et j'attaquerai le code rapidement.
Le post principal de ce topic mérite une bonne mise à jour car la deuxième version de gint arrive à grands pas !
Citer : Posté le 28/07/2019 18:27 | #
Bravo à toi !! Donc gint est fini pour les monochromes ?
Vas-tu réécrire un driver pour la SMEM (et la carte SD) ? (
(ps: sur l'image le gris rend trop bien ! <3 )
Citer : Posté le 28/07/2019 18:38 | #
La classe !
Juste une question, est-ce que les fonctions comme gsubimage() supporte si l'on affiche du monochrome avec ?
Citer : Posté le 28/07/2019 18:56 | #
Merci à tous les deux !
Quasiment yep. Il me reste des détails à ajouter, comme un IsKeyDown() ou équivalent, le retour au menu dans getkey(), des messages d'erreurs pour les exceptions et le TLB, ce genre de choses. Rien de violent
Bon après y'a plein d'extensions possibles dans la TODO list !
Cassés sur Graph 35+E II plutôt.
Je le ferai bien en lecture seule pour la SMEM, peut-être. Une autre possibilité serait d'implémenter les opérations sur les fichiers dans la RAM et ensuite d'écrire au dernier moment avec Bfile pour me débarasser des limitations de Bfile. Cette possibilité me tente pas mal. Mais pouvoir lire la SMEM moi-même aiderait. La carte SD je m'en fous un peu parce qu'aucun modèle courant n'en a.
Attention en vrai ça clignote et même beaucoup ! Faut que je trouve de meilleures valeurs, le gris clair est trop pâle là aussi.
Juste une question, est-ce que les fonctions comme gsubimage() supporte si l'on affiche du monochrome avec ?
Bien sûr que oui !
Ajouté le 29/07/2019 à 18:18 :
J'ai modifié les paramètres du moteur de gris avec des valeurs que j'ai trouvées et qui sont bieeen meilleures que les précédentes.
Iconvénient : le gris clair est très clair, comme sur la photo.
Avantage : ça clignote quasiment plus, en particulier le clignotement dans les zones de gris foncé est quasiment imperceptible.
Je pense que le rendu est supérieur à l'ancien moteur. Même des aplats comme sur la photo plus haut sur cette page sont complètement décents !
Citer : Posté le 30/07/2019 15:51 | #
J'ai trouvé des super valeur de gris pour Gint : 920 pour le clair et 1740 pour le foncé !
Citer : Posté le 30/07/2019 15:56 | #
Ah, la tâche vient de se compliquer violemment d'un coup. Ces valeurs ne sont pas bonnes du tout sur la Graph 35+E II ! Il faudra donc détecter le modèle et sélectionner des bonnes valeurs en fonction...
Voici une vidéo de ce que ça donne chez moi, et la comparaison avec les paramètres que j'ai annoncés hier :
https://linx.breizh.me/selif/ghcumqof.mp4
Citer : Posté le 30/07/2019 18:12 | #
Désolé de poster ce message : comment on fait pour l'utiliser sur Windows ?
Passé ici il y a peu. ಥ‿ಥ
Jouez à Mario sans arrêt sur votre Casio !
City Heroes
Piano Casio
Micro GIMP
Citer : Posté le 30/07/2019 18:57 | #
On installe Linux.
Sinon y'a ça : https://www.planet-casio.com/Fr/forums/topic13665-1-%5BTutoriel%5DCompiler-sous-Windows-avec-GCC.html
Mais peu de monde s'en sert…
Citer : Posté le 30/07/2019 20:11 | #
Je me demandais si c'est possible d'afficher des images monochromes (avec dsubimage) avec le blanc en transparent ?
Citer : Posté le 30/07/2019 20:11 | #
Désolé de poster ce message : comment on fait pour l'utiliser sur Windows ?
Tu peux utiliser Cygwin pour avoir un environnement Linux disponible. Sinon et si tu es genre bien chaud, on peut réfléchir ensemble à porter le fxSDK pour Windows.
Ajouté le 30/07/2019 à 20:13 :
Je me demandais si c'est possible d'afficher des images monochromes (avec dsubimage) avec le blanc en transparent ?
Malheureusement non, la couleur est fixée.
J'ai un plan qui consiste à implémenter une nouvelle fonction (probablement dmask()) qui prendrait une image en noir et blanc uniquement, et une couleur. Cela dessinerait la couleur indiquée sur les pixels noirs et rien sur les blancs. Si j'ai bien suivi c'est ce dont tu as besoin...
Citer : Posté le 30/07/2019 20:13 | #
Tu peux utiliser Cygwin.
Ou si tu as Windows 10, utiliser le Windows Subsystem for Linux. C'est plus pratique.
Citer : Posté le 30/07/2019 20:14 | #
Je pense que c'est ça : j'aimerai que les pixels blanc soient transparents
Citer : Posté le 30/07/2019 20:15 | #
Il faut faire une version de l'image où le blanc est effectivement transparent... ou modifier un peu ton UI après.
Citer : Posté le 30/07/2019 20:17 | #
En fait j'affiche le fond de l'écran et en surimpression dessus d'autre dessins
Citer : Posté le 30/07/2019 20:18 | #
Si tu n'utilises jamais le blanc comme blanc, ce dont tu as besoin c'est de rendre le blanc transparent à l'intérieur de ton éditeur d'images (GIMP typiquement).
Citer : Posté le 30/07/2019 20:21 | #
Ok, je verrais ça alors !
Citer : Posté le 01/08/2019 13:54 | #
@Lephe : j'ai bien mis le blanc en couleurs transparente sur Gimp en mettant le blanc dans le canal Alpha, du coup le projet ne compile plus : il ne reconnait plus l'image avec le blanc transparent…
Citer : Posté le 01/08/2019 14:01 | #
Attends, tu avais juste a faire une selection par couleur non ?
Citer : Posté le 01/08/2019 14:04 | #
Ben j'ai ouvert l'image en question et j'ai fait Couleur vers Alpha, et j'ai pris Blanc…