Hovercards BASIC

Alooors, dans la foulée des cartes de survol du Firmware et suite à la suggestion de @Devlin, j’ai pris les devants et j’ai implémenté des cartes de survol similaires pour les mots-clés du BASIC !

En raison de leur ressemblance avec le langage naturel, j’ai dû les limiter uniquement aux blocs de code :

10 MODE 1: BORDER 0: CLS
20 INK 0, 0: INK 1, 26: INK 2, 6
30 ENV 1, 5, 1, 5: SOUND 1, 239, 50, 12, 1
40 ORIGIN 320, 200: DEG
50 FOR a = 0 TO 345 STEP 15
60   CALL &BD19: REM Sync to vertical flyback
70   DRAWR 100 * COS(a), 80 * SIN(a), 1
80   MOVER -100 * COS(a), -80 * SIN(a)
90 NEXT a
100 LOCATE 1, 24: PRINT "Press any key to reset palette...";
110 CALL &BB18: REM Wait for keypress
120 CALL &BC02: REM Reset inks to defaults

Ta-daaaan !

Pour que cela fonctionne, j’ai cependant dû m’assurer que cela ne s’applique que dans les blocs de code BASIC. Et même si j’ai essayé de configurer le système du forum pour qu’il identifie automatiquement le BASIC dans le texte préformaté, cela ne marche pas à tous les coups (il faudra que je m’en occupe un de ces quatre). Du coup, pensez bien à sélectionner BASIC lorsque vous entrez un programme en BASIC :

Et voilà le travail.

Vos retours sont toujours les bienvenus !

PS : C’était beaucoup plus facile à réaliser que ce que je pensais au départ, grâce au travail déjà effectué sur le parseur FW et les blocs de code BASIC. Cela dit, le plus gros obstacle a été de récupérer les commandes BASIC sur le wiki lui-même, à cause de la protection anti-bot :joy:

PS2 : Sources utilisées pour constituer le guide BASIC :

  1. Locomotive BASIC Reference Manual (utilisé pour la syntaxe exacte des instructions, les crochets de paramètres et les différences entre les versions (BASIC 1.0 vs 1.1).
  2. AMSDOS Firmware & Reference Manual (Soft 158) : utilisé pour les 13 commandes disque d’extension système résidente (|) natives, le changement de lecteur et les paramètres de syntaxe.
  3. Catégorie CPCWiki Locomotive BASIC : documentation et tables de jetons (tokens) ROM utilisées pour vérifier les commandes particulières (comme COPYCHR$ et WINDOW SWAP) et les interactions avec les registres matériels.

… le tout injecté dans Gemini, qui a pondu le JSON nécessaire pour le parseur.

Absolument génial !

Je me demandais simplement… est-il possible d’afficher d’une manière ou d’une autre la liste des paramètres des fonctions en BASIC lorsqu’on les survole ?

ENV est un bon exemple de commande avec plusieurs paramètres.

Oui, c’est faisable. Pas seulement ENV, mais aussi ENT et SOUND. Est-ce qu’il y a d’autres commandes qui prennent plusieurs sous-paramètres ?

J’ai l’intention d’ajouter une ventilation détaillée des paramètres dans les cartes d’information au survol (hovercards) pour celles-ci et pour toutes les autres si nécessaire.

Ok, je pense que c’est bon. J’ai développé les commandes suivantes :

  1. AFTER : Délai, indice de temporisateur (0–3) et numéro de ligne cible.
  2. BORDER : Couleur primaire et couleur clignotante alternative.
  3. ENT : Numéro d’enveloppe (1–15), nombre de pas de hauteur, taille du pas de variation de hauteur et durée de pause.
  4. ENV : Numéro d’enveloppe (1–15), nombre de pas de volume, taille du pas de variation de volume, durée de pause et forme/période du PSG matériel.
  5. EVERY : Intervalle de répétition, indice de temporisateur (0–3) et numéro de ligne cible.
  6. INK : Numéro de stylo logique, couleur physique 1 et couleur clignotante 2.
  7. KEY DEF : Numéro de touche (0–79), bascule de répétition et codes de caractères non-majuscule/majuscule/contrôle.
  8. ORIGIN : Décalages de coordonnées (x, y) et limites de découpage de la fenêtre d’affichage (gauche, droite, bas, haut).
  9. SOUND : Masque de bits de canal, période de hauteur, durée/rendez-vous, volume, enveloppe de volume, enveloppe de tonalité et période de bruit.
  10. SPEED INK : Durée de clignotement phase 1 et phase 2.
  11. SPEED KEY : Délai de démarrage et vitesse de répétition.
  12. SYMBOL : Code du caractère cible (240–255) et les 8 octets de la matrice de points par ligne.
  13. WINDOW : Numéro de flux (#0–#7) et coordonnées de la fenêtre rectangulaire (gauche, droite, haut, bas).

J’ai aussi limité la fonction du parser qui génère les fiches au survol pour l’empêcher d’en créer après les instructions REM, car celles-ci peuvent contenir du langage naturel. Testons cela :

10 MODE 1: BORDER 0, 1: SPEED INK 15, 15
20 INK 0, 0: INK 1, 26: INK 2, 6: INK 3, 15
30 REM Notice that MODE, BORDER, and SOUND inside this comment stay unlinked
40 SPEED KEY 30, 2: WINDOW #1, 2, 38, 2, 8: CLS #1
50 SYMBOL 240, 24, 60, 126, 255, 255, 126, 60, 24
60 ENV 1, 5, 1, 5: ENT 1, 10, -5, 2
70 SOUND 1, 239, 40, 12, 1, 1
80 ORIGIN 320, 200: DEG
90 EVERY 150, 1 GOSUB 200
100 PRINT #1, "Custom character: "; CHR$(240)
110 FOR a = 0 TO 360 STEP 45
120   DRAWR 60 * COS(a), 40 * SIN(a), 2
130 NEXT a
140 CALL &BB18: REM KEY and WAIT checks ignored here
150 END
200 PRINT #1, "*TICK* ";: RETURN

Qu’est-ce que tu en penses, @ervin ? :slight_smile:

C’est un truc franchement cool. Je devrai peut-être utiliser le wiki CPC pour écrire mon code la prochaine fois, ce sera plus rapide que de chercher dans le manuel.

Merci mec, c’est vraiment apprécié. Je suis moi-même plutôt content du résultat, c’est mieux que ce à quoi je m’attendais. J’ai reçu beaucoup d’aide de Gemini qui a tout organisé proprement, sinon ça m’aurait pris une éternité à compiler…

Est-ce que je devrais créer un éditeur BASIC sur cette base quelque part sur le forum ou le wiki ? Je pourrais peut-être même le concevoir en version autonome : il existe des éditeurs de code prêts à l’emploi que je pourrais utiliser au lieu de réinventer la roue, et la structure sous-jacente est déjà là ! Ça pourrait même prendre en charge la saisie semi-automatique, l’exportation vers un dsk ET son exécution sur le RVMPlayer intégré ?!

Peut-être que le créateur de ce site pourrait m’aider ?

Je suis sûr que ce serait vraiment super, mais ne te sens surtout pas obligé. Tu as fait un travail formidable pour tout remettre en ligne et toutes ces nouvelles fonctionnalités sont déjà une énorme amélioration. Tu mérites bien une autre petite pause très bientôt !

Fais attention à ce que ta protection anti-bot ne te verrouille pas l’accès à ton propre serveur un jour, avec l’IA qui te dirait « :robot: :smiling_face_with_sunglasses: Hasta la vista, baby ». :sweat_smile:

J’vais pas mentir, c’était un moment ultra gênant :joy: