KITAQ SERIES

Bienvenue

KITAQGB est issu d'un fork de NORCAL, le compilateur C pour NES associé à Zachtronics. Le projet prolonge cette base pour proposer un compilateur de la famille C destiné à la Game Boy et à la Game Boy Color : génération de code, mémoire, affichage, son et commutation des banques de ROM sont adaptés à ces machines. Nous rendons crédit au projet d'origine et à son auteur, Keith Holman.

NORCAL tire son nom du nord de la Californie (Northern California). S’inspirant de cette référence géographique, l’auteur a choisi le nom KITAQGB d’après Kitakyushu, la ville où il est né et a grandi. KITAQ + GB associe Game Boy à 北九 (キタキュー, Kitakyū), le surnom de Kitakyushu, dans la préfecture de Fukuoka, au Japon. KITAQ se prononce comme le japonais « キタキュー » ; la notation indicative en anglais est kee-tah-KYOO, soit /ˌkiːtɑːˈkjuː/ en alphabet phonétique international. Le Q final se prononce comme le nom anglais de la lettre Q. En anglais, KITAQGB se lit kee-tah-KYOO jee bee, en prononçant G et B séparément.

Le nom KITAQGB a deux sens. Kernel-Informed Toolchain for AI-Quality Game Boy Development exprime l’objectif d’une chaîne de développement qui comprend la machine cible et accompagne aussi bien les personnes qui programment que l’IA générative.

L’autre sens est Kids' Imagination Transformed into Actual Quests in Game Boy Forests : un outil qui transforme l’imagination des enfants en véritables aventures dans les forêts du Game Boy. Il traduit le souhait de faire de petites idées, de croquis et de prototypes créés avec l’aide de l’IA des aventures auxquelles on peut réellement jouer.

NORCAL a été développé dans le cadre de la version NES de HACK*MATCH. Consultez les présentations de l'auteur : NORCAL: A C Compiler for the NES et HACK*MATCH pour NES. L'historique du projet et l'explication de son nom reprennent le README fourni par l'auteur.

Comment utiliser ces manuels

À la manière des manuels des premiers micro-ordinateurs, cette collection commence par de petits programmes que vous pouvez saisir, compiler et exécuter. Observez d'abord le résultat, puis découvrez le fonctionnement de la machine. Il n'est pas nécessaire d'apprendre tout le vocabulaire avant de commencer.

1. Commencez par le premier programme du volume 1 pour la GB, ou du volume 4 pour la FC.
2. Appuyez-vous sur le volume 2 ou le volume 5 pour ajouter les commandes, les graphismes et le son.
3. Observez l'exécution avec KOKURA ou KUROSAKI, puis regroupez les diagnostics avec SARAKURA.
4. Si vous connaissez déjà le nom d'une fonction, utilisez la recherche du volume ou le dictionnaire de l'API.

La syntaxe du langage, les fonctions intrinsèques du compilateur, les fonctions de bibliothèque et les commandes du terminal font l'objet de rubriques distinctes. Les volumes consacrés aux compilateurs comportent aussi un index des instructions du processeur. Des noms proches sur GB et FC ne garantissent ni les mêmes arguments ni le même comportement.

Les sept volumes

La police fournie

Les exemples utilisent la police ascii.c, dessinée par l’auteur : 26 majuscules, 10 chiffres, 26 minuscules et 30 symboles, soit 92 glyphes. La planche des tuiles les présente tous. L’espace utilise une tuile vide ; la barre oblique inverse et la barre verticale, absentes de cette police, s’affichent aussi comme des espaces. Les programmes gb_font.c et fc_font.c affichent tous les glyphes.

Édition et vérifications

Ce manuel décrit les sources du 14 septembre 2026. L’inventaire de référence consigne les empreintes des sources et des exécutables. Les comptes rendus de vérification précisent les données d’entrée, les conditions et la portée de chaque test.

Une compilation réussie indique qu'une ROM a été produite. Un test d'exécution indique qu'un émulateur a avancé du nombre d'images prévu. Les comparaisons de pixels, les réactions aux commandes et les tests audio sont consignés séparément. Ces résultats ne garantissent pas la compatibilité avec tous les périphériques ou toutes les consoles physiques ; les avertissements restent visibles dans les journaux.

Préparer un dossier de travail

Les exemples utilisent Windows PowerShell. Enregistrez les fichiers C en texte UTF-8. Le dossier courant est celui depuis lequel vous lancez une commande. Entourez de guillemets les chemins contenant des espaces et utilisez au besoin & "chemin" pour appeler un exécutable. Pour les exemples faisant intervenir plusieurs outils, placez leurs dépôts et le projet de jeu dans le même dossier parent, puis exécutez les commandes depuis ce dossier.

# リポジトリのルートで実行します。
New-Item -ItemType Directory -Force out | Out-Null
.\kitaqgb\kitaqgb.exe --help
.\kitaqfc\kitaqfc.exe --help

Remplacez game.c, game.gb et game.nes par vos noms de fichiers. Les indications telles que <ROM> sont des paramètres à remplacer : ne saisissez pas les chevrons. Les commandes sont généralement présentées sur une seule ligne. La continuation de ligne par barre oblique inverse de Bash ne s'applique pas à PowerShell.

Lire et imprimer les manuels HTML

Ouvrez index.html dans le dossier téléchargé pour lire les manuels hors connexion. Les styles, la recherche, les exemples et les images de vérification utilisent des fichiers locaux ; aucun CDN externe n'est nécessaire. Conservez l'ensemble du dossier plutôt que de copier des fichiers HTML isolés. Le bouton d'impression prépare une mise en page sans colonne de navigation.

Les extraits de code et les sorties réelles des outils conservent leur texte d’origine pour permettre une comparaison directe avec les fichiers et les résultats des commandes.