Introduction

C'est le grand retour de la saucisse qui se bidonne!!!

Blacky du groupe CCB (Cochonou Crack Band) s'est amusé à programmer avec l'outil de développement Delphi (de Borland) un utilitaire pour accéder au contenu des disk images 140 ko apple II sous Dos 3.3 et ProDOS sans passer par un émulateur.
Le résultat est très pratique et en plus, c'est 100 % free, 100 % ouvert.

Ce programme est vraiment le bienvenu pour traiter les productions underground françaises car nos hackers tricolores maitrisaient parfaitement l'aspect OS, et ils avaient la facheuse tendance à trafiquer pas mal de paramètres standards pour personnaliser leurs productions!

De ce fait les outils se contentant de gérer les règles standards (Ciderpress, Fishwings, ...) ne permettent pas de fouiner librement dans certaines de ces productions bidouillées à mort. Quand on obtient quelque chose, c'est le plus souvent des messages d'erreurs!!!

A noter qu'initialement, le programme a été conçu uniquement pour examiner les disques images DOS 3.3 (et compatibles).
L'examen des disks ProDOS a été ajouté ensuite et est encore en version béta (la présentation diffère du DOS et il faut faire un clic droit sur l'arborescence pour voir les nouvelles options).
De ce fait, toutes les caractéristiques mentionnées ci-dessous sont implémentées pour DOS 3.3 mais ce n'est pas systématiquement le cas pour ProDOS.

Screenshots & Download

Cliquer les images pour les agrandir:

	Visualisation d'une image HGR en monochrome puis d'un fichier TXT après avoir cliqué sur son nom dans le catalog d'un disk DOS 3.3.
	Cliquer sur la représentation du disk pour choisir les secteurs DOS 3.3 à charger pour obtenir une image absente du catalog.
	Désassemblage d'un programme binaire provenant d'un disk DOS3.3.
	Visualisation d'une image DHGR couleur tirée d'un disk DOS 3.3.
	Visualisation d'une image DHGR couleur tirée d'un disk ProDOS (.po).
	Visualisation d'une image DHGR monochrome tirée d'un disk ProDOS (.po).
	Test du programme (une beta de novembre 2005) en émulation Wine sous la distribution linux Ubuntu. Une réussite fêtée par Blacky avec une bonne bière ;-)))

Win

Download Tiny Apple II Image Disk Browser Beta 7.3 : 20051230 (gzipped)

Il s'agit d'une version beta. Si vous rencontrez un bug, merci de le signaler en prenant bien soin de préciser sous quel OS vous êtes, de donner le disque image qui a provoqué le plantage et de décrire le procédé par lequel il est possible de reproduire l'erreur. Je contacterai le "doctor" Blacky qui examinera votre cas!

Caractéristiques

Le programme permet de charger un disk image à la fois via le bouton Load

qui n'est pas réservé au DOS 3.3 contrairement à ce que laisse penser l'intitulé!
Pour chaque disk image, il utilise 3 éléments de fenêtre pour représenter la disquette 5 pouces 1/4:

A gauche : le catalogue des objets avec une présentation par ligne contenant un affichage similaire à celui obtenu par la commande CATALOG.
A droite, la partie haute affiche le contenu de l'objet sélectionné selon son type.
A droite, la partie basse affiche le résultat d'une demande particulière (écran d'apple II, désassemblage, ...)

Voici les caractéristiques de ce que peut faire ce programme en « ouvrant » un disque image .dsk ou .do (contenant un DOS type 3.3 ou compatible) ou encore .po (ProDOS) :

Manipulations.

Pour manipuler les disks images, le drag'n drop est accepté. Par exemple à partir de l'explorateur windows faire glisser un .dsk sur l'icone du programme sur le bureau permet d'ouvrir le programme (si ce n'est pas déjà le cas) et le voir le contenu du disk immédiatement.
Il y a 2 modes de sélection des objets : sélection objet par objet (on clique sur le nom d'un objet et le programme agit en fonction du type) ou sélection de masse pour les fonctions d'export. Avec un disk DOS 3.3, l'objet sélectionné apparait "stabylobossé" en jaune à côté du bouton "Load Disk".
Possibilité de rechercher en automatique la piste du catalogue DOS 3.3 (bouton ) et donc de traiter des disks images dont l'emplacement du catalog a été déplacé. (Le catalogue doit néanmoins avoir un format pas trop massacré).
Exemple de soft underground avec un catalog en piste non standard: The Kit Of Adventure Master 1 et 2.

Le programme cherche toute une liste de secteurs susceptibles de contenir une liste de TSL (track/sector list). Sur apple II, comme tout a été bidouillé dans tous les sens, il est difficile de se fixer sur une 1 solution pour reconnaître quelque chose. Possibilité de cliquer plusieurs fois sur le bouton 'FOUND - Clic here' pour voir à chaque fois si la recherche a donné un résultat correct ou pas. Ceci permet de faire défiler les couples piste/secteur trouvés. Si les premiers sont vides, parfois, les derniers contiennent le catalog. A chaque clic, on passe à une autre paire T/S (s'il y a des possibilités de catalog avant T$11 S$0F, elles seront affichées).
Accepte les CATALOG tournants (infinis : qui bouclent vers le secteur 1 du catalog). Encore une bidouille que l'on trouvait de temps en temps sur les productions underground. A noter que ceci fausse le nombre d'objets indiqués dans le catalog exporté.
Possibilité d'exporter le catalog (bouton ). Si vous sélectionnez cette option, un fichier CATALOG_<nom du disk image avec son extension>.TXT est créé dans le répertoire Export_AppleII\<nom du disk image>\ (à partir du répertoire où se trouve l'exécutable de Tiny). Le fichier contient le nom du disk image au début et le nombre d'objets à la fin (en précisant le nombre d'objets supprimés).
A noter que le catalog est automatiquement exporté quand un export de masse d'objets est demandé.
Possibilité de faire des exports d'un ou plusieurs objets en cliquant sur le bouton . Pour en faire plusieurs d'un coup, il faut cocher le bouton (pour choisir tous les objets, cliquez sur le bouton ). Dans un cas comme dans l'autre, le résultat sera placé dans le répertoire Export_AppleII\<nom du disk image>\ sous le nom : <type>_<nom de l'objet>.TXT. Le type est celui de l'objet Apple II sauf dans le cas d'un BIN qui se voit également sauvegardé sous forme desassemblé ASM (en plus du dump) et si c'est une image en .BMP. Très utile pour faire de la récupération de masse en vue de la création de pages web. A noter que pour chaque objet, on trouve les valeurs A$ et L$ en hex et numérique (cadrage à droite des nombres). On sait également si l'objet est locked/unlocked/deleted grâce à un caractère en début de ligne. Les espaces dans les noms sont remplacés par des underscores "_".
Prise en compte de la vraie taille d'un objet. Par exemple, dans certains cas, un fichier binaire est long (ex : 50 secteurs) mais les premiers octets qui déterminent sa taille et son adresse de chargement laissent croire qu'il ne fait que $200 octets. On ne se contente pas que de charger la taille indiquée ($200). On tient compte des 50 secteurs... même s'il y a du 'garbage' ensuite. (Avec un autre outil, si les premier octets valent 0, rien n'est chargé).

Switch permettant d'avoir en plus dans l'affichage du catalog l'adresse de début et la longueur des objets (en hexa : A$+L$ ). Utile si par exemple le développeur s'est amusé à forcer la valeur 0 dans le nombre de secteurs occupés. Par le biais de ce switch, on peut avoir l'information d'une longueur correspondant à plus d'un secteur.
Exemple: usage de A$+L$ pour forcer l'affichage HGR/DHGR d'une image:

	Dans STARFIX5.DSK si l'on regarde le fichier SF1, on a 000 secteurs, on pense donc que ce n'est pas intéressant.
	Avec l'option activée, on constate : A$4000 et L$1FF8. Résultat intéressant mais l'image n'est pas interprétée comme telle.... donc, il faut l'aider.
	C'est pourquoi il y a 2 boutons : 1 pour forcer l'affichage HGR et l'autre pour le DHGR . Pour n'importe quel fichier : même partiel. En cliquant dans le cas de STARFIX5, c'est bien une image qui apparait.

Pour les calculs de len des objets, il y a plusieurs formules :
a) Si l'objet est binaire, la longueur correspond à l'indication donnée par le soft (sur 2 octets).
b) Si l'objet est en BASIC, il utilise la longueur indiquée au début du fichier (idem sur 2 octets).
c) Si l'objet est en TXT, le descriptif du catalogue ne fournit pas d'indication de longueur, donc, à ce moment là, c'est simplement le nombre de secteurs multiplié par 256. Il est possible d'avoir des résultats différents avec CiderPress qui compte jusqu'à la 1ère valeur 00 trouvée.
Sélection possible d'un ensemble de secteurs pour constituer un objet affichable ensuite (grâce au bouton ). Une représentation de la disquette en Tracks/Sectors est affichée. Il faut mentionner l'adresse à laquelle désassembler, et ensuite cocher les secteurs qui doivent être désassemblés/dumpés les uns à la suite des autres. L'ordre des clics est important puisque de lui dépend la séquence du contenu affiché. Option utile par exemple, pour désassembler un boot ou reconstituer une image disséminée sur le disque mais sans réf au Catalog. Le résultat est alors dispo : un dump + du code désassemblé + une (éventuelle) image.
Il est possible de sauver la séquence (option Save Profile) et de la restaurer ensuite (option Load Profile) si on a le même chargement à effectuer pour plusieurs disks images.
A noter que la fenêtre de droite donnant la liste des T/S ne s'édite pas: elle rend simplement compte de ce qui va être chargé. Si vous cochez un mauvais secteur, et que vous le décochez ensuite, il sera quand même chargé... ses coordonnées restant dans la fenêtre de droite. Pour l'effacer, il faut pour le moment (beta oblige) cliquer sur "CLEAR ALL" et recommencer.
Sur l'affichage écran de la liste des objets, la couleur de background de la ligne est fonction du type de l'objet. Il n'y a pas de couleurs pour les objets supprimés qui apparaissent avec un couleur de police gris clair.
Sur l'affichage écran de la liste des objets, on peut voir dans le CATALOG quels sont les fichiers LOCKés et DELETED. Les DELETED apparaissent précédé d'un '-'. Les fichiers LOCKés sont précédés d'un '*'. A noter sous DOS 3.3 que lorsqu'un fichier est supprimé, il a un caractère en dernière position du nom. En effet, le DOS place ici le numéro de la piste où se trouvait la première TSL. Ne vous inquiétez pas de voir des caractères différents "bizarres" sur ces lignes de fichiers deleted.
Possibilité d'appliquer un EOR $valeur à tout le contenu du disque ou bien seulement au texte du CATALOG, ou bien seulement au contenu d'un objet examiné (leurs descripteurs et les TSL restant ‘normales'). Par exemple, c'est utile pour les images pseudo-cryptées ou pour les avoir en négatif (beaucoup d'images DHGR sont mieux rendus en négatif). A noter qu'il faut mettre en premier lieu une valeur puis en sélectionner ensuite l'objet.
Il y a 3 possibilités.
C : #$ XX -> effectue un EOR uniquement sur les NOMS du catalog (pas les T/S ni rien d'autre)
F : #$ XX - > effectue un EOR uniquement sur les FICHIERS (càd le fichier lui-même... son contenu, pas les descripteurs, les indications de taille, etc... )
DOS : #$ XX -> effectue un EOR sur TOUS LES OCTETS du DOS, c'est à dire sur les listes de TSL etc...
Précision : pour la version DOS, il faut d'abord renseigner la valeur, et ensuite, charger la disquette.

Exemple de soft underground protégé par un DOS EOR: Déplombage mode d'emploi 3 (cf le cours Godfather 4.2).
Traitement transparent des objets DOS 3.3 dont le nom a été protégé par insertion de caractères ctrl-?. Les noms d'objets sont 'forcés' dans une marge 'affichable' à grands coups d'opérations AND. (Voir le cours de déplombage numéro 4 de Godfather pour plus d'informations). A noter que cette transformation automatique remplace aussi le caractère "*" par un "_", ceci afin que lors d'un export il n'y ait pas de soucis (caractère générique).

Opérations sur les objets de type BIN (binaire).
- Affichage à l'écran du contenu sous forme de dump hexa/ascii.
- Reconnait les objets supprimés mais le traitement correct ne peut se faire qu'avec une TSL intact.
- En double cliquant sur un objet BIN, on force l'affichage dans le type TXT. Recliquer encore dessus pour revenir au type BIN d'origine. Ceci permet de lire plus facilement un texte sauvegarder en BIN. (Utile donc si quelqu'un a changé le type de l'objet).
  Autre usage : lire les sources sous Merlin avec l'extension .S (BIN) qui ne sont pourtant que des fichiers rempli de texte.
- Il est possible d'obtenir par défaut un désassemblage automatique d'un objet BIN sélectionné (à partir de l'adresse de sauvegarde de l'objet). Si cela ne vous intéresse pas, décochez l'option.
  Utilisation possible du bouton pour forcer le désassemblage à partir de l'adresse souhaitée par exemple si une partie du code au début ne vous intéresse pas (ici $FF4). Pour le moment, le désassemblage ne gère que le code 6502.
- Option supplémentaire sous forme de case à cocher () pour le désassemblage permettant d'afficher aussi les "faux opcodes" (ces instructions non documentées qui influaient sur le compteur ordinal et tant d'autres choses). Le rôle de chaque opcode bidon est indiqué en commentaire dans le désassembleur. Ces informations ont été trouvées sur une page web qui les recense. Il y a les infos pour le 6502 et le 65C02. Par recoupements, le résultat est fiable et a en plus été testé sur un vrai apple IIe (enfin, pas totalement, mais la grosse dizaine d'opcodes testés a paru faire ce qui était indiqué).
- L'affichage nécessite la police LUCIDA CONSOLE (à mettre dans c:\windows\Fonts\).
- Affichage à l'écran de snapshots monochromes des images HGR (BIN en 34 ou 33 secteurs avec résolution de 280 x 192 pixels). En cliquant sur le cliché, il est possible de l'afficher dans une taille supérieure. Une option permet de sauvegarder l'image N&B en .BMP avec un facteur multiplicateur allant jusqu'à 10 fois sa taille. Ceci se fait grâce au bouton .
- Prise en compte de même (affichage/sauvegarde) des images DHGR 66 secteurs (non compressées) en 560*192 monochrome (mode 1) ou dans les modes 2 (140*192 16 couleurs) et 3 (mixe des modes 1 et 2). Les images au format Extasie compressé sont aussi prises en compte. Cliquez sur l'option "Chat Mauve". Affichage windows avec GDI.
  En cliquant avec le bouton droit sur une image déjà affichée, le programme remet automatiquement le contexte à la taille de l'image (pas besoin de déplacer les curseurs à la main).
Opérations sur les objets de type BAS (BASIC Applesoft).
- Affichage à l'écran du contenu d'un source BASIC.
- Reconnait les objets supprimés mais le traitement correct ne peut se faire qu'avec une TSL intact.
- Affichage par défaut les caractères français dans les libellés (possibilité de passer en affichage US).
  Possibilité d'avoir un retour chariot supplémentaire entre chaque ligne du programme pour avoir une meilleure visibilité (option 'Add CR').
- Affichage en 40 ou 80 colonnes. Accepte aussi le mode Auto-CR (cf type TXT).
- En double cliquant sur un objet BAS, on force l'affichage dans un autre type (TXT/BIN). Recliquer encore dessus pour revenir au type BAS d'origine. Ceci permet de mieux lire les morceaux de code et de texte inclus volontairement après la dernière instruction valable d'un programme BAS. Utile si le type a été changé par bidouillage ou si par exemple un programme BAS ne contient qu'un CALL suivi d'un code en langage machine. Par défaut le programme BASIC s'affiche proprement mais on voit qu'à la fin il y a quelque chose en plus. En switchant l'affichage, on peut obtenir le code ASM inclus.
  Exemple de BIN placé à la fin d'un BAS : Canterbury Music.
Opération sur les objets de type TXT.
- Affichage à l'écran du contenu des fichiers texte.
- Reconnait les objets supprimés mais le traitement correct ne peut se faire qu'avec une TSL intact.
- Il y a plusieurs mode d'affichage : comme il vient (comme l'a tapé son créateur c'est à dire avec ou sans retour chariot), en forçant le mode 40 colonnes par retour chariot, en forçant le mode 80 colonnes par retour chariot, un mode spécial d'affichage 80 colonnes intelligent appelé "Auto-CR" qui ne coupe pas les mots : passage à la ligne si le mot ne tient pas en entier.
- Par défaut, l'affichage des caractères accentués est réalisé en automatique (option 'FR chars') mais il est possible d'avoir un affichage avec les caractères US.
  Exemple de substitution par des équivalents 'Français'.
  Un message vient d'{tre envoy{ @ votre quartier g{n{ral
  donne ceci avec l'option 'FR chars' cochée :
  Un message vient d'étre envoyé à votre quartier général.
- En double cliquant sur un objet TXT, on force l'affichage dans le type BIN. Recliquer encore dessus pour revenir au type TXT d'origine. Ceci permet de connaître le codage des caractères.

Reste à implémenter

21/01/2007 : Bug avec des fichiers TXT très gros. La fin ne s'affiche pas à l'export. Probable que tous les TSL ne sont pas pris en compte quand la liste des TSL fait plusieurs secteurs. Ex: le disk de docs en VF sur Ultima V (réalisé par le groupe The Warriors Of Destiny). Sur la face 2 (de la version 2.0), il y a un fichier de 182 secteurs.
01/05/2006 : Bug sur l'affichage des fichiers TXT avec le DOS EOR qui coince avec la gestion des retours chariots. Par exemple avec un DOS EOR #$78, il y a transformation des codes $F5 (caractère "u") en retour chariot et les retours chariot ne se font pas. En effet un retour chariot normal = $8D (%10001101) EOR $78 (%01111000) -> $F5 (%11110101). Bug constaté avec les fichiers contenant des caractères minuscules dans DEPME 3 (articles de Mister Z).
Intégration des intructions du 65c02 (apple IIe upgraded et apple //c) pour le désassemblage : assez long et fastidieux car de grosses tables à remplir.
Pas de contrôle de saisie des données (par exemple, les saisies d'adresses ou de valeurs en hexa ne sont pas vérifiées... on part du principe que l'utilisateur sait ce qu'il fait. Si à la place de l'adresse '0801' on entre 'toto' ou 'youpi', le soft n'appréciera pas vraiment le désassemblage.
Pour faciliter la récupération d'image, possibilité d'une sélection d'une piste entière (ordre secteurs croissants ou décroissants au choix du user) d'un seul coup sera appréciée plutôt que devoir se palucher les 16 secteurs par clic.
Récupération hors catalog. Visualisation de la diskette avec la sélection des T/S (comme pour la récup d'image) et sauvegarder le résultat de la sélection des secteurs (le contenu global des secteurs choisis) sous forme de BIN/BAS/TXT (choix à permettre).

Ex: tu cliques sur 3 secteurs de la présentation des T/S + clic sur TXT + clic sur OK -> ça affiche le résultat à l'écran comme si on avait choisi un objet du catalog (avec possibilité de le sauvegarder).
Option pour voir l'occupation du disk (visualisation idem copy 2+: track/sector map) en utilisant un caractère différent pour représenter chaque objet (avec export possible du résultat sous forme de fichier txt/rtf).
Objectif: renseignement sur l'occupation pour ne pas avoir à booter un utilitaire sous émulateur et aussi pour avoir éventuellement la puce à l'oreille pour des trucs cachés.
Option qui sort sous forme dump hexa + txt le contenu partiel d'un disk.
Quand je dis partiel, je pense aux secteurs qui ne sont définis dans aucune TSL - en enlevant aussi les secteurs de tsl eux même - (je sais, je complique en ne prenant pas ceux de la vtoc mais cette table peut très bien avoir été magouillée pour qu'il n'y ait plus de free sector).
Objectif: voir rapidement s'il y a des messages cachés.
Option pour voir la liste des tsl pour un objet du catalog. Pour les deleted, utiliser le dernier caractère du nom de l'objet qui code normalement la piste de la tsl.
Objectif: complément de la demande 5 pour avoir l'ordre des secteurs.
Affichage et sauvegarde des images HGR en couleur.