Outils et Ressources

Ce chapitre présente l'ensemble des outils et ressources utlisés dans le projet de portage de Flashback sur Apple IIgs. L'ensemble du projet est réalisé sous Windows 10 et utilise des logiciels compatibles avec ce système d'exploitation.

Logiciels

 → DosBox-X : émulateur DOS qui fait tourner Flashback version PC.
 → Flashback PC : jouer à Flashback en ligne.
 → Sublime Text 4 : édition du code source assembleur 65816.
 → Merlin 32 : assembler, linker, produire l'executable au format S16 (fonctionnant sous GSOS).
 → GSBug v1.7d9 : outil de déboggage live du code assembleur.
 → Super Convert 4 : gestion des graphiques sur l'Apple IIgs.
 → Fireworks CS6 : gestion des graphiques sous Windows.
 → NTP Player Plus : lecture des sons Amiga (format MOD) d'origine du jeu et création au format NTP (lisible sur Apple IIgs).
 → CiderPress : création, modification des supports disquettes ou disques des Apple II.
 → CiderPress II : version 2, création, modification des supports disquettes ou disques des Apple II.
 → AppleCommander : outil de manipulation des images disques Apple II.
 → Cyrene : débogue, trace et analyse tout code Apple II ou Apple IIgs exécuté sur un émulateur (nécessite KegsCyrene).
 → ConEmu : terminal Windows (utrilisé pour les batchs).
 → HxD Hex Editor : éditeur hexadecimal de tous fichiers < 8Go.

Chacun de ces outils sera proposé dans le cadre de l'usage qui en a été fait pour développer Flashback IIgs.

Le jeu Flashback version Apple IIgs est testé sous Kegs pour Windows version 1.34 ainsi que sur des Apple IIgs réels (Rom 1 et Rom 3).
Toutes les séquences vidéos proposées ont été réalisées sous Windows 10.

Livres

Impossible de ne pas proposer les livres et sites web essentiels (quasiment tous en anglais) pour mener à bien ce projet. Vous trouverez un lien de téléchargement PDF associé à chaque titre.
Indispensables sont les manuels de référence de l'Apple IIgs, qui regorgent d'informations (tout s'y trouve) indispensables à une compréhension fine et détaillée de la stucture logicielle et matérielle de la machine :
 → Apple IIgs Firmware Reference, © 1987 Addison-Wesley Publishing
 → Apple IIgs GS/OS Reference, © 1990 Addison-Wesley Publishing
 → Apple IIgs Hardware Reference, 2nd Edition © 1989 Addison-Wesley Publishing
 → Apple IIgs Toolbox Reference volume 1, © 1988 Addison-Wesley Publishing
 → Apple IIgs Toolbox Reference volume 2, © 1988 Addison-Wesley Publishing
 → Apple IIgs Toolbox Reference volume 3, © 1990 Addison-Wesley Publishing
 → Apple IIgs Toolbox Changes for System Software 6.0, 1992 David A. Lyons
 → Programmer's Reference for System 6.0.1, © 1993 Byte Works Inc.
 → Apple IIgs Prodos 16 Reference, © 1986 Addison-Wesley Publishing
 → Programmer's Introduction to the Apple IIgs, © 1988 Addison-Wesley Publishing

 → Programming the 65816 - Including the 6502, 65C02 and 65802, © 2007 Western Design Center, Inc
Absolument nécessaire, le fonctionnement du 65816 y est présenté dans tous les détails avec des exemples de code. Les finesses des modes d'adressages y sont décrites de manière très claires. Simplement fantastique. Je n'ai jamais refermé ce livre sans avoir compris ce que je lisais et y ai trouvé toutes les réponses à mes questions !

 → Apple IIGS Machine Language for Beginners, © 1987 Roger Wagner, Compute! Publications Inc
La simplicité narrative de Roger Wagner, des explications et exemples clairs, préçis. Un régal à lire.

 → Programming the Apple IIgs in C and Assembly Language, © 1987 Howard W.Sams & Company
Direct, simple et préçis. Très utile.

 → Le IIgs épluché, © 1990 Toolbox.
La bible française de l'Apple IIgs.

 → Apple IIgs GS/OS Internals, © Brutaldeluxe
Ce document de synthèse est destiné aux programmeurs avancés d'Apple IIgs et aux curieux, résultat de plusieurs années de compréhension des entrailles de GS/OS. Il peut être considéré comme le volume 2 de référence de GS/OS. Il contient les informations décrites dans le premier volume, rassemble des données provenant de spécifications de référence externes et de notes techniques.

 → Code Secrets of Wolfenstein 3D, © 2004 Eric Sheperd.
Une explication technique hyper détaillée des animations de Wolfenstein 3D. Flashback IIgs s'en inspire pour les séquences d'animations et d'affichage (Introduction, Téléportation...)

 → Fabien Sanglard : 3 livres sont à lire absolument : DOOM: Game Engine Black Book v1.2, WOLFENSTEIN 3D: Game Engine Black Book v2.2, The Book of CP-System. (ps: je ne gagne rien sur leur vente)

Pour des questions de droits, vous ne pouvez ouvrir et télécharger que les livres et documentations dont vous possédez un exemplaire à votre domicile.
Warning : Regarding copyright law, you could only open and download books that you personally own at home.

Sites web

Brutaldeluxe Une véritable mine d'or autour de l'Apple IIgs. Tout y est pour qui cherche un peu. A commencer par Merlin 32 l'assembleur 65816, Cyrene qui est le debugger moderne hyper complet pour l'Apple IIgs. Et tant d'autres choses nécessaires à tout développeur. De plus tous les logiciels (jeux y compris) sont fournis avec les sources. Autant de ressources techniques totalement indispensable.

KansasFest (Apple II forever) et ses archives Powerpoint, texte, PDF ou Vidéos, ou les membres de la communauté Apple II proposent des présentations techniques dans des domaines très variés (matériels, logiciels, techniques...). A chaque convention anuelle ces sont des interventions très qualitatives et techniquement abouties (possibilité de participer en distanciel).

Fabien Sanglard Pas de contenus en liens direct avec L'Apple IIgs (pour le moment ;-) mais des articles hyper intéressants autour de logiciels (jeux ou autres) et matériels analysés très finement et en profondeur. Passionnant.