Un des meilleurs atouts que possède la programmation d'addins en C/C++, c'est de bénéficier du système Real Time Clock (RTC), et surtout du syscall RTC_getTicks(). Dans ce tutoriel, nous verrons en détail les différentes façon d'utiliser RTC_getTicks(), comme régulateur de FPS, compte à rebours, etc.

Sommaire
1. Rappels sur les sycalls
2. Appeler RTC_getTicks()
3. Réguler ses FPS
4. Afficher les FPS
5. Chronométrer du temps
6. Régulariser des opérations avec les timers (n'utilise pas RTC_getTicks)
7. Générer des nombres aléatoires
Conclusion


1. Rappels sur les syscalls

RTC_getTicks() est un syscall ("System Call" ou "Appel système"), c'est à dire une fonction déjà présente dans l'OS de la calculatrice. Il suffit donc de sauter à l'endroit où elle est stockée pour l'exécuter.

Pour cela, la meilleure méthode est de créer un fichier contenant les instructions en assembleur (ASM), puis de compiler le tout. Toutefois, cette méthode est lourde, et pas forcément très compréhensible par un programmeur lambda, d'autant plus que l'assembleur est un langage de bas niveau, c'est à dire très abstrait. Nous utiliserons donc une astuce plus ou moins correcte et valide, mais qui reste intégralement fonctionnelle.

Voici le code commenté pour appeler un syscall (ici RTC_getTicks()) :


Vous pouvez placer ces fonctions n'importe où tant que vous avez mis un prototype avant le main().


2. Appeler RTC_getTicks()

Maintenant que nous avons défini RTC_getTicks(), nous allons l'utiliser. La fonction retourne le nombre de "ticks", des périodes durant 1/128ème de seconde, mesurées par l'horloge interne de la calculatrice depuis sa mise en service (ou une autre date, Casio n'ayant jamais fourni de renseignements sur ce point).

Pour cela, prévoyez un int pour récupérer la valeur :




3. Réguler ses FPS

Les Frames Per Second (FPS), en français "images par seconde", sont un élément important d'un jeu. En effet, si ceux-ci ne sont pas régulés, il peut et y aura des différences d'exécution entre différents modèles, particulièrement entre les SH3 et les SH4. De plus, certaines fonctions comme IsKeyDown() provoquent des ralentissements lorsque des touches sont enfoncées, et peuvent fortement modifier la vitesse d'exécution du jeu, le rendant moins agréable à utiliser.

Heureusement, nous avons à notre disposition en C/C++ la fonction RTC_getTicks(). Grace à celle-ci, nous allons réguler de manière dynamique le nombre de FPS de notre jeu.

Nous allons donc créer une fonction qui retiendra le nombre de ticks écoulés depuis le dernier appel de la fonction. Du coup, si le programme est en avance, nous le mettons en pause jusqu'à ce qu'il soit à l'heure. Nous définissons donc un nombre précis de ticks qu'il faudra laisser écouler par frame.

Sachant que 1 tick = 1/128 seconde, nous pouvons en déduire que laisser 1 tick s'écouler équivaut à 128 / 1 = 128 FPS, 2 ticks = 128 / 2 = 64 FPS, 3 ticks = 128 / 3 = 42 FPS, etc. Nous donnerons donc en argument à la fonction le nombre de ticks à laisser tourner. Voici un récapitulatif des valeurs les plus utilisées :



Voici la fonction complète :


Pour l'utiliser, rien de plus simple :




4. Afficher les FPS

Réguler les FPS, c'est cool, mais dans le cas d'un jeu qui demande beaucoup de ressources, il est intéressant de connaitre le nombre maximal de FPS que l'on peut avoir. Pour cela, nous allons une fois de plus utiliser RTC_getTicks(). La fonction que nous allons créer retournera un int, le nombre de FPS de la dernière seconde écoulée.


Vous n'avez plus qu'à appeler la fonction dans votre boucle principale pour récupérer le nombre de FPS :



NB 1 : La fonction PrintVariable(int variable) est supposée afficher une variable à l'écran. Vous devez adapter en fonction de vos besoins.
NB 2 : Vous trouverez dans les commentaires de ce tutoriel une autre méthode, tout aussi valable. A vous de choisir


5. Chronométrer du temps

Dans le cas d'un jeu qui a besoin de savoir combien de temps s'est écoulé depuis une action, vous pouvez enregistrer un temps de référence, puis calculer le temps écoulé en ticks en faisant une simple soustraction, puis convertir le résultat en secondes, minutes et autres unités de temps.

Par exemple, pour indiquer le temps écoulé depuis le lancement de la boucle :




6. Régulariser des opérations avec les timers (sans RTC_getTicks())

En construction...
Vous pouvez déjà aller voir la documentation française de fxlib.
Je pense créer un tutoriel entier sur les timers, puisque nombreuses sont les astuces et utilisations que l'on peut en faire.


7. Générer des nombres aléatoires

Un tutoriel à déjà été écrit sur ce sujet, vous trouverez ici des explicitons sur l'utilisation de RTC_getTicks() dans la création de nombres aléatoires.


Conclusion

Avec ces quelques explications, vous devriez pouvoir maîtriser le temps sur votre calculatrice, même si, bien entendu, ces quelques exemples ne sont pas représentatifs de toutes les possibilités offertes par le système RTC. Vous pouvez par exemple créer un jeu qui lance des quêtes qu'à des horaires réguliers, des succès à débloquer si on a joué plus de 1 heure, etc.

Si toutefois vous avez encore des questions, n'hésitez pas à les poser-ci dessous, dans ce topic dédié.


A bientôt sur Planète Casio !