home *** CD-ROM | disk | FTP | other *** search
/ Supremacy 2 / Supremacy-2.iso / Tools / PC / Pacifist / PCST047.ZIP / PCST047 / DOCS / PACIFIST.FRA < prev    next >
Text File  |  1997-10-11  |  59KB  |  1,347 lines
  1. Il s'agit de la première version de cette documentation en français, ce qui
  2. devrait faire plaisir aux francophones, même si l'ensemble reste assez
  3. technique.
  4.  
  5.  
  6.                                         ץ³∞∞∞∞³ץ
  7.                                        ף§   õ  ∧ף
  8.                                        ף    Ø   ף
  9.        ץ³∞∞∞∞³ץ ץ³∞∞∞∞³ץ ץ³∞∞∞∞³ץ ץ³∞³ץף    ף   ףץ³∞³ץ ץ³∞∞∞∞³ץף∞∞∞∞ף
  10.       ף§   õ  ∧ا   õ  ∧ا   õ  ∧ا   ∧ף    ף   ף§   ∧ا   Ø  ∧ף    ףץץ
  11.       ף    Ø   ף    Ø   ף    Ø   ף     ף    ף   ף     ף    ∞∞∞∞ף    ף
  12.       ף    ף   ף∞∞∞∞∞   ף    ף∞∞∞ף∞∞∞∞∞ף    ף∞∞∞ף∞∞∞∞∞ף∞∞∞∞ף   ף    ף∞∞∞ף
  13.       ף    ף   ף    ף   ף    ף   ף     ף    ף∞∞ ף     ף    ף   ף    ף   ף
  14.       ף    ף   ף    ף   ף    ף   ף     ף    ף   ף     ף    ף   ף    ף   ף
  15.       ף    ף  ∧ا   ף  ∧ا   ף  ∧Ø     ף    ף   ף     Ø§   ף  ∧Ø    ף   ף
  16.       ף    ץץ³∞ ∞³ץץץץ³∞ ∞³ץץץץ³∞ףץץץץץØץץץץØ   ףץץץץץף∞³ץץץץ³∞ף    ף   ף
  17. ------ף    ף -------------------------------------------- sns -ף§   ף  ∧Ø-----
  18. õ õõõ ףץץץץØ õõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõ  ∞³ץץץץ³∞  õõõ
  19.  
  20.  
  21.  
  22.                            PaCifiST v0.47 release 4
  23.                            ~~~~~~~~~~~~~~~~~~~~~~~~
  24.  
  25.                         programmé par Frederic Gidouin
  26.                            (frederic.gidouin@hol.fr)
  27.  
  28.                            Emulation YM2149 & driver
  29.                          Soundblaster par Arnaud Carré
  30.                             (leonard@mygale.org)
  31.  
  32.                                (c) 1996-1997
  33.  
  34.  
  35. Dernière Mise à jour: 11 Octobre 1997
  36. -------------------------------------------------------------------------------
  37.  
  38.                             TABLE DES MATIERES
  39.  
  40.                 0. Changements dans ce document
  41.  
  42.                 1. Introduction
  43.                     1.1 Qu'est-ce que PaCifiST?
  44.                     1.2 Pourquoi devrais-je l'utiliser?
  45.                     1.3 Caractéristiques
  46.                     1.4 Développements futures
  47.                     1.5 Combien ça coûte?
  48.  
  49.                 2. Installation
  50.                     2.1 Matériel Requis
  51.                     2.2 Quelques concepts utilisés dans PaCifiST
  52.                          2.2.1 Un mot sur le Moniteur
  53.                          2.2.2 L'émulation Vidéo
  54.                          2.2.3 Les modes de vitesse ("Speed Modes")
  55.                          2.2.4 L'émulation des lecteurs
  56.                          2.2.5 Le son
  57.                     2.3 Avant de démarrer l'émulateur...
  58.  
  59.                 3. Configuration
  60.                     3.1 Référence des directives du fichier INI
  61.                          3.1.1 Section "System" (Système)
  62.                          3.1.2 Section "Screen" (Ecran)
  63.                          3.1.3 Section "Debug" (Debogage)
  64.                          3.1.4 Exemple de fichier PACIFIST.INI
  65.                     3.2 Paramètres de la ligne de commande
  66.                     3.3 Configuration depuis le Moniteur
  67.                     3.4 L'écran de sélection de disquette
  68.                     3.5 L'écran des ports joysticks
  69.  
  70.                 4. Divers
  71.                     4.1 Quelques Conseils
  72.                     4.2 Le VBE 2.0
  73.                     4.3 Images de disquettes
  74.                     4.4 Correspondances pour le clavier
  75.                     4.5 Captures d'écran
  76.                     4.6 Sauvegarde de jeux
  77.                     4.7 Enregistrement de musiques .YM      (PARTIE NON ENCORE
  78.                          4.7.1 Utilisation                      TRADUITE EN
  79.                          4.7.2 Informations Techniques          FRANCAIS)
  80.                     4.8 Detection & Utilisation de PaCifiST
  81.  
  82.                 5. Le Moniteur
  83.                     5.1 L'écran du moniteur
  84.                     5.2 Les Commandes du moniteur
  85.  
  86.                 6. Ressources & Remerciements
  87.                     6.1 Programmes connexes
  88.                          6.1.1 Autres Pages Web
  89.                          6.1.2 Utilitaires
  90.                     6.2 Ressources
  91.                     6.3 Remerciements
  92.                     6.4 Pour me contacter
  93.  
  94.  
  95. -------------------------------------------------------------------------------
  96.  
  97. 0. Changements dans ce document (depuis la version 0.46)
  98. ========================================================
  99.  
  100.  
  101. Directives INI nouvelles ou modifiées: Ramsize, Laptop, image, ste.
  102. Port parallèle
  103. L'écran d'émulation joystick.
  104. Non prise en compte des bootsecteurs exécutables.
  105. Overscan bas
  106.  
  107. Les changements importants dans cette documentation seront soulignés
  108. par [*NOUVEAU*].
  109.  
  110. 1. Introduction
  111. ===============
  112.  
  113.  
  114.  1.1 Qu'est-ce que PaCifiST?
  115.  ---------------------------
  116.  
  117. PaCifiST est un émulateur Atari ST pour PC. Il s'agit d'un
  118. émulateur logiciel, ce qui veut dire qu'il ne requiert aucune carte
  119. d'extension avec des composants du ST, votre PC suffit.
  120.  
  121. Il vous permettra d'utiliser de nombreux logiciels Atari ST sur votre PC.
  122.  
  123.  
  124.  1.2 Pourquoi devrais-je l'utiliser?
  125.  -----------------------------------
  126.  
  127. Si vous avez été un possesseur d'Atari ST, la réponse c'est: LA NOSTALGIE!
  128. C'est vraiment sympa de pouvoir ré-utiliser ses vieux programmes.
  129.  
  130. De nos jours, il y a des jeux pour PC d'une taille gigantesques, avec des
  131. graphismes & des sons incroyables. Mais à part quelques uns, ils sont
  132. généralement vite lassants et n'ont pas "d'âme".
  133.  
  134. L'Atari ST n'est pas le seul ordinateur possédant de bons jeux (j'apprécie
  135. également le C64 et l'Amiga) mais si vous avez déjà joué à Super Sprint,
  136. Stunt Car Racer, Dungeon Master ou Colonial Conquest... Alors vous avez une
  137. idée de ce qu'est un BON JEU.
  138.  
  139. Bien sur, il n'y a pas que des jeux sur Atari ST! Cette machine était par
  140. exemple largement utilisée par les professionnels de la musique, et on peut
  141. trouver à peu près tous les types de logiciels
  142.  
  143.  
  144.  1.3 Caractéristiques
  145.  --------------------
  146.  
  147. PaCifiST émules les composantes suivantes d'un Atari ST normal:
  148.  
  149.        Motorola 68000   L'émulation du 68000 est écrite entièrement en
  150.                         assembleur Intel. Tous les aspects du processeurs sont
  151.                         respectés, à l'exception des instructions en BCD
  152.                         (incorrectes). Le prefetch est émulé, pour peu qu'on
  153.                         utilise l'option "pref" du moniteur. Dans la mesure
  154.                         où cela ralentit considérablement la vitesse globale
  155.                         de l'émulateur, il est conseillé de n'activer cette
  156.                         option uniquement pour passer certaines routines
  157.                         foireuses. L'émulation du 68030 arrivera dans un
  158.                         futur plus ou moins lointain.
  159.  
  160.        Shifter (Vidéo)  Les 3 modes graphiques standards du ST sont supportés.
  161.                         Vous pouvez choisir entre une émulation monochrome
  162.                         (haute résolution) ou couleur (basse et moyenne
  163.                         résolutions. Toute l'émulation vidéo est réalisée 100%
  164.                         en assembleur.
  165.                         Certains effets spéciaux (changement de palette,
  166.                         "rasters" sont possibles, à partir du moment où vous
  167.                         utiliser un driver VBE2.0 et que vous passiez en mode
  168.                         LINE (ligne) d'émulation vidéo. Un autre mode possible
  169.                         (depuis la version 0.44) est le mode MIXED: Il permet
  170.                         en plus le changement de résolution en plein milieu
  171.                         d'un écran.
  172.                         Depuis la version 0.45, PaCifiST est aussi capable
  173.                         d'émuler des résolutions étendues, mais cela ne
  174.                         marchera, sous certaines conditions, qu'avec des
  175.                         applications systèmes.
  176.                         Pour le moment, seuls les overscans bas sont rendus.
  177.                         Avec la version 0.47, PaCifiST commence à émuler le
  178.                         shifter du STE. [*NOUVEAU*]
  179.  
  180.        6301 (Clavier)   Ce processeur est utilisé pour la gestion du clavier,
  181.                         de la souris, du joystick et de l'horloge interne dans
  182.                         un ST réel. Le comportement exact de cette puce n'est
  183.                         pas émulé (cela prendrait trop de temps), une simple
  184.                         simulation est suffisante et se précise à chaque
  185.                         nouvelle version de l'émulateur. Une souris PC est
  186.                         nécessaire. Si aucun joystick PC n'est détecté au
  187.                         démarrage (ou si vous l'avez inhibé dans PACIFIST.INI),
  188.                         une émulation du joystick ST au clavier est proposée.
  189.  
  190.        YM-2149 (Son)    Cette puce sonore est émulée si une carte son supportée
  191.                         est reconnue (SB & GUS). L'émulation YM est réalisé
  192.                         par Arnaud Carré, également auteur de STSound. Les
  193.                         samples STF sont également + ou - bien restitués.
  194.  
  195.        MFP              Les interruptions VBL, FDC, ACIA, TIMER C sont
  196.                         correctes ainsi que les timers A, B & D en "events
  197.                         count mode" (mode de comptage d'évenements). La HBL
  198.                         n'est pas bien précise, mais c'est aussi le cas sur
  199.                         un vrai ST.
  200.  
  201.        FDC / HDC        PaCifiST utilise 3 niveaux pour l'émulation disque:
  202.                         Gemdos, Bios et matérielle. Le niveau Gemdos permet
  203.                         l'utilisation de vos disques durs/CD-ROM PC sous
  204.                         Atari. Pour les émulations Bios et matérielle, des
  205.                         "images" de disquettes sont utilisées pour simuler
  206.                         de vraies disquettes. Vous pouvez également utiliser
  207.                         votre lecteur de disquette PC (CE N'EST PAS DU TOUT
  208.                         RECOMMANDé!!!)
  209.                         Depuis la v0.45, le formatage est possible, mais il
  210.                         est simulé et nécessite que l'image de disquette ait
  211.                         la même géométrie (paramètres logiques) que le format
  212.                         voulu par l'application.
  213.  
  214.        I/O              Ce qui est envoyé vers le port parallèle est écrit
  215.                         dans le fichier PARALLEL.OUT.
  216.                         Le port série n'est pas encore fonctionnel, pas plus
  217.                         que le MIDI.
  218.  
  219.        Blitter          Le blitter du STE est à présent émulé
  220.  
  221.  1.4 Développements Futurs
  222.  -------------------------
  223.  
  224. Il reste de nombreuses choses à faire, ainsi que d'autres à corriger.
  225. La liste des choses à faire est comme suit, sans ordre précis:
  226.  
  227.         - meilleurs sons digitalisés STF
  228.         - corriger les monceaux de bogues restants
  229.         - Son DMA STE
  230.         - Accélérer l'émulation du 68000 encore un peu
  231.         - Overscans & Syncscrolls
  232.         - Meilleur moniteur (évaluateur d'expression, points d'arrêt
  233.           conditionnels...)
  234.         - Port Série qui marche
  235.         - Sélection couleur/monochrome intégrée
  236.         - Programme de transfert Atari<->PC
  237.         - Une option pour enregistrer/restaurer l'état du ST émulé
  238.         - Emulation 68030
  239.  
  240. Ecrivez-moi si vous avez d'autres idées réalisables.
  241. D'autres améliorations sympa sont possibles:
  242.  
  243.         - Emulation native du processeur 6301
  244.         - Support Midi
  245.         - Emulation du FDC avec les lecteurs de disquettes PC (bof!!!)
  246.  
  247. Mais je n'ai ni les docs, ni le courage de le faire pour le moment.
  248.  
  249.  
  250.  1.5 Combien ça coûte?
  251.  ---------------------
  252.  
  253. Avant, ce programme était Shareware (partagiciel). A présent il est
  254. Giftware (On peut traduire par doniciel).
  255. ========
  256.  
  257. Vous êtes libres et encouragés de le diffuser autour de vous, à partir du
  258. moment où vous ne gagnez pas d'argent se faisant.
  259.  
  260. ...MAIS vous êtes hautement encouragés ^_^; de contribuer... Je passe
  261. beaucoup de temps sur ce projet et aimerai beaucoup recevoir quels que type
  262. de remerciements que se soient. M'envoyer une certaines sommes d'argent
  263. serait fantastique, et me permettrait de payer ma note de téléphone. Sinon,
  264. vous pouvez m'envoyer une simple carte postale, un *vieux* film de SF,
  265. un CD fait maison ou... Un bière locale!
  266.  
  267. Je déteste les programmes sharewares bridés, je ne veux pas en arriver la. En
  268. retour j'espère juste que ceux qui en ont les moyens voudront bien contribuer
  269. d'eux mêmes.
  270.  
  271. Merci a tous ceux qui l'ont d'ors et déjà fait.
  272.  
  273. 2. Installation
  274. ===============
  275.  
  276.  
  277.  2.1 Matériel Requis
  278.  -------------------
  279.  
  280. PaCifiST est conçu pour un environnement DOS. Il marchera à priori mieux depuis
  281. le DOS, mais se satisfera d'une sessions DOS sous Windows 3.11, 95 ou NT. On
  282. m'a dit qu'il fonctionnait également sous OS/2 (assurez-vous juste que l'option
  283. MOUSE_EXCLUSIVE_ACCESS soit OFF), mais pas sous DosEmu depuis Linux.
  284.  
  285. La configuration MINIMALE sur laquelle vous devriez utiliser ce programme est
  286. un 486DX-100. Il marchera avec moins que ça, mais ne vous attendez pas alors
  287. à des prouesses. Je développe PaCifiST sur un AMD 586-133 (environ un P75),
  288. et la vitesse est généralement supérieure à celle d'un ST de base à 50
  289. images/secondes, le son émulé à 22Khz, avec la plupart des jeux. Bien sur
  290. certaines routines (plasma) ralentissent plus que d'autres l'émulation.
  291.  
  292. PaCifiST nécessite environ 1.5 Mo de mémoire lui même, à quoi il faut
  293. ajouter la taille de mémoire vive ST que vous voulez. Avec 8Mo de mémoire,
  294. vous aurez au mieux un Atari ST avec 6Mo.
  295.  
  296. Une souris est NECESSAIRE. Vous pouvez choisir entre un driver intégré (souris
  297. branchée sur le port série seulement) ou un driver standard que vous aurez
  298. pris soin de démarrer. Le driver intégré ne fonctionne pas sous Win95, je
  299. ne l'ai fait que pour corriger un bug rencontré par quelques personnes.
  300. Si PaCifiST ne détecte pas de joystick, il utilisera les touches flèches
  301. de votre clavier (quand la diode NumLock/VerrNum (Pavé Numérique) est
  302. éteinte seulement) pour en simuler un. Vous pouvez afficher l'écran de
  303. l'émulation joystick avec F4 depuis le moniteur. [*NOUVEAU*]
  304.  
  305. Une carte son compatible soundblaster ou GUS est nécessaire si vous désirez
  306. entendre quelque chose.
  307.  
  308. En plus de tout ça, vous devez impérativement posséder un fichier "dump"
  309. d'un TOS (le système d'exploitation en ROM) ST. Lancez le programme ST
  310. joint DUMP_TOS.PRG (dans le répertoire STFILES) pour sauver son TOS sur
  311. disquette.
  312.  
  313. PaCifiST doit absolument être exécuté depuis son répertoire, qui devra
  314. contenir le fichier PACIFIST.INI (fichier texte de configuration) et PATCH.H68
  315. (qui contient un peu de code 68000 nécessaire à l'émulation Gemdos).
  316.  
  317.  
  318.  2.2 Quelques concepts utilisés par PaCifiST
  319.  -------------------------------------------
  320.  
  321. Cette section donne quelques explications sur des concepts qu'il est
  322. souhaitable de comprendre pour exploiter au maximum l'émulateur.
  323.  
  324.    2.2.1 Un mot sur le Moniteur
  325.    ----------------------------
  326.  
  327. Par defaut, quand vous démarrer PaCifiST, vous atterrissez sur l'écran du
  328. moniteur. Pour lancer l'émulation proprement dite, vous devez taper "g" (go)
  329. et appuyer sur ENTREE. Vous pouvez rappller cet écran à tout moment en
  330. appuyant sur la touche qui est entre ECHAP et TAB (souvent un petit 2). Vous
  331. aurez besoin de passer par là pour quitter l'émulateur, réinitiliser l'Atari,
  332. choisir un mode vidéo de restitution ou d'autres options.
  333.  
  334. IMPORTANT: Parfois, quand vous rappelez l'écran du Moniteur, il se peut que
  335. le clavier ne réponde pas bien. En ce cas, pressez simultanément sur les
  336. touches SHIFT, ALT & CTRL.
  337.  
  338. La commande "x" permet de revenir au DOS.
  339.  
  340. Reportez-vous à la section qui résume les commandes du Moniteur pour plus
  341. d'explications.
  342.  
  343.  
  344.    2.2 L'émulation Vidéo
  345.    ---------------------
  346.  
  347. Il existe 4 différentes façons d'émuler la vidéo. Néanmoins, seul la
  348. basse résolution est affecté.
  349.  
  350. Le premier mode (utilisé par défaut) est appelé le "Screen-Oriented" (orienté
  351. écran), car tout l'écran de l'Atari ST est affiché d'un seul coup. De ce fait,
  352. une seule palette (16 couleurs) est utilisable et aucun effet spécial n'est
  353. possible. C'est le mode idéal pour se servir d'applications GEM, il est aussi
  354. le plus rapide.
  355.  
  356. Le second mode est appelé "Line-Oriented" (orienté ligne), et cette fois-ci
  357. chaque ligne de l'écran Atari est construite à la fois. C'est le mode idéal
  358. pour les jeux et les démos car il autorise de nombreux effets spéciaux.
  359.  
  360. Le troisième mode est le "Mixed mode" (mode mixte) et requiert un driver VBE
  361. proposant une résolution de 640x400x256 en mode linéaire. Identique au mode
  362. "orienté ligne" mais il autorise en plus le changement dynamique de résolution
  363. en plein milieu d'une image (comme dans les jeux d'aventures de Magnetic
  364. Scroll & de Level 9, et dans la Calimero Demo par exemple).
  365.  
  366. Le dernier mode (nouveau dans la version 0.45) est le "custom mode" (mode
  367. personnel) et lui aussi nécessite une résolution VBE de 640x480x256. TOUT CELA
  368. EST EXPERIMENTAL, ne l'utilisez que depuis le bureau du GEM et avec le TOS2.06.
  369. Vous ne pouvez pas choisir ce mode une fois l'émulateur lancé, il faut le faire
  370. au démarrage (option RENDER (rendu) du fichier INI ou en paramètre de la ligne
  371. de commande).
  372.  
  373.         Mode orienté écran (Screen-Oriented mode)
  374.                 - ne permet pas d'effet spécial
  375.                 + fonctionne très bien sous Windows même fenêtré)
  376.                 + rapide
  377.                 + marche sur toute les configurations
  378.  
  379.         Mode orienté écran (Line-Oriented mode)
  380.                 - plus lent
  381.                 - driver VBE2.0 recommandé
  382.                 - fonctionne SEULEMENT en plein écran sous Windows
  383.                 + différentes résolution PC (320x200, 640x480...)
  384.                 + capable de gérer les changements de palette (rasters),
  385.                   overscan bas (avec plus de 200 lignes).
  386.  
  387.         Mode mixte (Mixed-Mode)
  388.                 - bien plus lent
  389.                 - nécessite un driver VBE2.0 avec une résolution de 640x480x256
  390.                   ou 640x400x256.
  391.                 - ne marche qu'en plein écran sous Windows
  392.                 + capable d'émuler plus ou moins bien les changement de palette
  393.                   et de résolution dans l'image.
  394.  
  395. Vous pouvez passer d'un de ces modes d'émulation vidéo à un autre facilement
  396. (touche F1 sous le moniteur).
  397. IMPORTANT: le mode "orienté ligne" est désactivé en haute et moyenne
  398. résolution. Le mode Mixte est désactivé en haute résolution.
  399.  
  400.         Mode personnel (Custom-Mode):
  401.                 - *très* lent
  402.                 - nécessite un driver VBE2.0 avec une résolution de 640x480x256.
  403.                 - ne marche qu'en plein écran sous Windows
  404.                 - une fois choisi ce mode, vous ne pouvez plus changer de
  405.                   mode sans quitter l'émulateur.
  406.                 + extension de la résolution ST à 640x480 en 16 couleurs.
  407.                   d'autres résolutions seront peut-être ajoutées dans le futur.
  408.  
  409.  
  410.  
  411.    2.2.3 Les Modes de Vitesse (Speed Modes)
  412.    ----------------------------------------
  413.  
  414. La version 0.4 a vu l'arrivée de 2 modes de vitesse d'émulation: ST et MAX. Le
  415. mode par défaut est le ST-speed (vitesse ST): Meme avec le plus rapide des
  416. Pntium, la vitesse n'excédera jamais celle d'un ST à 8Mhz. C'est absolument
  417. nécessaire pour certains programmes. L'autre mode, MAX-speed (vitesse maxi)
  418. fait que l'émulateur se synchronise avec la vitesse du PC. Néanmoins ce mode
  419. n'est compatible qu'avec des applications systèmes.
  420.  
  421. Passer d'un mode de vitesse à l'autre en cours d'émulation n'est PAS RECOMMANDE,
  422. mieux vaut le faire avant.
  423.  
  424.  
  425.    2.2.4 L'émulation des lecteurs
  426.    ------------------------------
  427.  
  428. PaCifiST propose 3 façons d'émuler les unité de stockage.
  429.  
  430.     - LECTEUR DE DISQUETTES PC (A:)
  431.  
  432.         J'ai ajouté ce mode quasi-contraint par bon nombre de demandes.
  433.         Ce n'est PAS RECOMMANDE!!! Il subsiste de nombreux problèmes, notamment
  434.         la détection de changement de disquette & la protection. Si la
  435.         directive <pcdrive> (lecteur PC) est utilisée au démarrage et qu'aucune
  436.         image de disquette n'est choisie pour le lecteur ST A:, alors PaCifiST
  437.         bootera sur le lecteur physique du PC. Toutefois, j'insiste: Utilisez
  438.         plutôt des images de disquettes... ^_^;
  439.         La clause PCDRIVE semble donner de meilleur résultat sous Windows 95
  440.         que sous DOS.
  441.  
  442.     - IMAGES DE DISQUETTE (Disk Images):
  443.  
  444.         Il s'agit d'un fichier qui contient à la suite tous les secteurs d'une
  445.         disquette. Pour les programmes émulés, il est similaire à une vraie
  446.         disquette insérée dans un lecteur. Les images de disquette fonctionnent
  447.         avec tous les programmes, même ceux qui utilise directement le
  448.         contrôleur de disque (FDC). PaCifiST reconnaît les images de disquette
  449.         à leur extension ".ST".
  450.         Vous pouvez choisir 2 images au démarrage de l'émulateur avec la
  451.         directive "IMAGE=", ou en cours d'émulation depuis l'écran de Sélection
  452.         de disquette (DISK SELECTION SCREEN).
  453.         Depuis la version 0.41, PaCifiST peut aussi utiliser des fichiers MSA.
  454.  
  455.     - REPERTOIRES MONTéS (Mounted Directories):
  456.  
  457.         Cela ne marchera que pour les programmes utilisant le GEMDOS pour leur
  458.         accès aux fichiers. Cette méthode vous permet de "monter" des
  459.         répertoires de votre PC comme des unités Atari. Par exemple, si vous
  460.         montez "D:\ATARI" sur le lecteur C: de l'Atari au démarrage, les
  461.         programmes lancés depuis l'émulateur verront le répertoire D:\ATARI
  462.         et tous ses sous-répertoires comme étant sur un lecteur C:.
  463.         Vous pouvez très bien monter des partitions entières, mais ce n'est
  464.         pas conseillé: Vous avez plutôt intérêt à n'utiliser qu'un répertoire
  465.         ou deux. De cette façon, même en cas de gros plantage, aucun de
  466.         vos fichiers PC ne seront affectés.
  467.         Vous ne pouvez pas changer l'affectation de répertoire montés une
  468.         fois PaCifiST lancé, ce n'est possible qu'au démarrage.
  469.  
  470.  
  471.    2.2.5 Le Son
  472.    ------------
  473.  
  474. Les sons digitalisés du STF sont très mal rendu pour l'instant (mais ça
  475. dépend beaucoup de la routine qui les joue). Vous pouvez supprimer cette
  476. émulation dans le fichier INI ou avec la touche F5 sous le moniteur.
  477.  
  478. Les cartes sons supportés sont la Soundblaster et la Gravis Ultrasound. Des
  479. drivers pour d'autres cartes ne sont pas prévus.
  480.  
  481. L'émulateur tentera d'abord de détecter une GUS, puis une Soundblaster...
  482.  
  483.         SOUNDBLASTER
  484.         ============
  485.  
  486. PaCifiST n'essayera pas de la trouver tout seul, mais se basera sur la
  487. variable d'environnement BLASTER. Avant de démarrer l'émulateur, assurez-vous
  488. qu'elle est bien définie. Reportez-vous à la documentation de votre carte
  489. sonore si vous n'y parvenez pas. Si vous connaissez les paramètres, sous
  490. DOS tapez:
  491.  
  492. SET BLASTER= Axxx Ix Dx
  493.  
  494.         Axxx étant la valeur du Port. Par exemple A220
  495.         Ix étant le numéro d'interruption. Par exemple I7
  496.         Dx étant le canal DMA. Par exemple D1
  497.  
  498.  
  499.         GRAVIS ULTRASOUND
  500.         =================
  501.  
  502. Comme pour la SB, la variable d'environnement ULTRASND doit être définie.
  503.  
  504. SET ULTRASND= ppp,d,d',i,i'
  505.  
  506.         Où ppp est la valeur du port (220,240...)
  507.         Où d est le canal DMA
  508.         Où i est le numéro d'interruption
  509.  
  510.  
  511.  2.3 Avant de démarrer l'émulateur
  512.  ---------------------------------
  513.  
  514. PaCifiST est configuré par l'intermédiaire d'un fichier texte: "PACIFIST.INI".
  515. Vous pouvez l'éditer avec n'importe quel éditeur (l'EDIT du DOS, le NOTEPAD de
  516. Windows) pour modifier le comportement de l'émulateur. Certaines options
  517. peuvent aussi être spécifiées en paramètre sur la ligne de commande.
  518. Ce document contient une section détaillant toutes les options. Gardez tout
  519. de même une copie du fichier INI original, en cas de problème. Avec
  520. le paramètre de ligne de commande /ini vous pouvez précisez un autre fichier
  521. de configuration que PACIFIST.INI.
  522.  
  523. La première fois que vous allez utiliser PaCifiST, il y a quelques trucs
  524. à changer dans la configuration selon votre système.
  525.  
  526. La chose la plus importante est d'indiquer à PaCifiST où trouver votre fichier
  527. TOS. Charger le fichier INI avec un éditeur de texte and allez dans la section
  528. [system]. Vous pouvez mettre des lignes en commentaires en plaçant un ";" en
  529. début de ligne. Ensuite, indiquez le nom de votre fichier TOS (TOS image):
  530.  
  531.  
  532. tos= tos162.img    ;vous devez spécifier le chemin d'accès complet au fichier
  533.                    ;si il n'est pas dans le répertoire de PaCifiST.
  534.  
  535.  
  536. Placez autant de clauses "TOS=" que vous avez de fichiers TOS, de façon à
  537. pouvoir passer de l'un à l'autre pendant l'émulation. Le dernier spécifié
  538. sera celui par défaut. Il est conseillé pour chaque clause TOS= de placer
  539. aussi un court commentaire pour décrire le fichier, par exemple en donnant
  540. la version du TOS, le pays d'origine, etc... par exemple:
  541.  
  542. tos= tos162.img, "TOS 1.62 (fr)"
  543.  
  544.  
  545. Le fichier INI livré avec PaCifiST contient un exemple de configuration de TOS.
  546.  
  547. Assurez-vous aussi la première fois que tous les chemins dans les clauses
  548. IMAGE et MOUNT sont valides.
  549.  
  550. 3. Configuration
  551. ================
  552.  
  553. Il y a 3 niveaux de configuration. Le fichier INI contient les options
  554. globales, tandis que les paramètres de ligne de commande n'affecte que la
  555. session en cours. Enfin, certaines options peuvent être changées en cours
  556. de route depuis le moniteur.
  557.  
  558. Un fichier appelé JOY.CFG sera aussi créé dans le répertoire de PaCifiST dès
  559. que vous calibrerez un éventuel joystick.
  560.  
  561.  
  562.  3.1 Réferences des directives du fichier INI
  563.  --------------------------------------------
  564.  
  565.  
  566. Les tabulations, espaces et le texte après ";" sont ignorés.
  567.  
  568.  
  569.     3.1.1 Section "System" (Système)
  570.     --------------------------------
  571.  
  572.         TOS = <fichier>,"comnt" Nom du fichier TOS. Si plusieurs sont déclarés,
  573.                                 le dernier sera utilisé par défaut. Vous pouvez
  574.                                 passer d'un TOS à l'autre depuis le moniteur.
  575.  
  576.         AUTORUN = [yes|no]      Si YES (Oui), PaCifiST démarrera de suite
  577.                                 l'émulation, sans passer par le moniteur.
  578.  
  579.         RAMSIZE = [n|512k]      Spécifie la taille de la RAM (mémoire vive)
  580.                                 affectée à l'Atari ST émulé. Les valeurs
  581.                                 possibles sont de 1 à 14 Mo et 512k. Depuis
  582.                                 la version 0.47, vous pouvez également indiquer
  583.                                 des multiples de 0.5 (0.5, 2.5, etc...)
  584.                                 [*NOUVEAU*]
  585.  
  586.         SOUND = [yes|no]        Indique si vous voulez une émulation du son
  587.                                 ou non.
  588.  
  589.         SAMPLES = [yes|no]      Indique si vous voulez une (mauvaise) émulation
  590.                                 des sons digitalisés (logiciels) du STF
  591.  
  592.         VOLUME = <n>            Indique le volume sonore. Le maxi est 255, et
  593.                                 c'est également la valeur par défaut (il est
  594.                                 préférable de régler le son de manière externe).
  595.  
  596.         INTERNALMOUSE=[yes|no]  Le défaut est non. Mettez cette directive à
  597.                                 yes si vous rencontrez des problèmes de souris.
  598.                                 Cela ne marche *que* sous DOS.
  599.  
  600.         SENSITIVITY=[1-10]      Sensibilité de la souris (incompatible avec la
  601.                                 clause INTERNALMOUSE) de 1 à 10 (défaut 5).
  602.  
  603.         MOUSECOM = [1|2]        Dans le cas ou INTERNALMOUSE est mis à yes,
  604.                                 désigne le port série de votre souris.
  605.  
  606.         SERIAL = [yes|no]       Autorise/Supprime l'émulation du port série.
  607.                                 mieux vaut mettre à non: De toute façon ce
  608.                                 n'est pas encore près.
  609.  
  610.         JOYSTICK = [yes|no]     Demande à PaCifiST de ne pas utiliser de
  611.                                 joystick PC. Une émulation clavier est de
  612.                                 toute façon possible.
  613.  
  614.         LAPTOP = [yes|no]       Si à "yes", c'est l'autre touche CTRL qui sera
  615.                                 utilisée pour émuler le bouton de feu du
  616.                                 joystick. (option pour ordinateurs portables)
  617.                                 [*NOUVEAU*]
  618.  
  619.         LEDS = [yes|no]         Si à "yes" (défaut), la LED "scroll lock"
  620.                                 clignotera pour indiquer une activité du
  621.                                 lecteur de disquette du ST émulé.
  622.  
  623.         KBDELAY = n             Délai de réponse du clavier de 1 à 10 (défaut
  624.                                 3). Vous pouvez aussi changer cette valeur
  625.                                 depuis le moniteur. Le processeur clavier du
  626.                                 ST (6301) envoie des paquets d'information
  627.                                 au 68000. Ce paramètre permet de simuler un
  628.                                 délai entre chaque information des paquets.
  629.  
  630.         IMAGE = <fichier>,drv   Cette directive donne le nom d'un fichier
  631.                                 image de disquette devant être "insérée"
  632.                                 dans le lecteur A: ou B:
  633.                                 2 clauses IMAGE peuvent être utilisées
  634.                                 conjointement dans le fichier INI. Vous pouvez
  635.                                 également préciser un lecteur (A ou B) pour
  636.                                 forcer l'image dans un lecteur particulier.
  637.                                 [*NOUVEAU*]
  638.  
  639.         MOUNT = <chemin absolu> Demande à l'émulateur de "monter" un répertoire
  640.                                 PC comme unité Atari. Le chemin précisé doit
  641.                                 être donné de façon absolue (depuis la racine,
  642.                                 par exemple MOUNT=C:\PACIFIST\STFILES).
  643.  
  644.         PCDRIVE = [yes|no]      PaCifiST doit-il utiliser le lecteur de
  645.                                 disquette du PC. Le Défaut (et la valeur
  646.                                 conseillé) est "no".
  647.  
  648.         PARALLEL = [yes|no]     Emulation du port parallèle ou non
  649.  
  650.         STE = [yes|no]          Emulation (partielle) du shifter STE [*NOUVEAU*]
  651.  
  652.  
  653.     3.1.2 Section "Screen" (Ecran)
  654.     ------------------------------
  655.  
  656.         MONOCHROME = [yes|no]   Comme vous le devinez, PaCifiST doit-il émuler
  657.                                 un moniteur couleur ou monochrome.
  658.  
  659.         FASTVIDEO = [yes|no]    Mettre à "yes", surtout si votre carte vidéo
  660.                                 est lente. Cela n'est utile qu'en mode
  661.                                 d'émulation vidéo orientée-écran.
  662.  
  663.         REFRESHRATE = <n>       Le défaut est 1, ce qui veut dire que *tous*
  664.                                 les écran Atari sont converti en écran PC
  665.                                 (50 fois par seconde). Si votre PC est un lent,
  666.                                 vous pouvez mettre une autre valeur.
  667.  
  668.         RENDER = [screen|line|mixed|custom]
  669.  
  670.                                 Démarre PaCifiST dans un mode d'émulation
  671.                                 vidéo précis.
  672.  
  673.     3.1.3 Section "Debug" (Déboggage)
  674.     ---------------------------------
  675.  
  676. Ces paramètres ne sont guères utiles que pour moi, et ceux qui veulent un
  677. peu "bidouiller": examiner les interruptions, les évenements clavier,
  678. désassembler du code...
  679. Vous devez impérativement posséder une version compilée "DEBUG" de l'émulateur
  680. pour en tirer profit.
  681.  
  682.         LOGFILE = <fichier>     Nom d'un fichier de LOG où enregistrer
  683.                                 certaines informations plus ou moins
  684.                                 techniques.
  685.  
  686.         TRAPIRQ = [all|none|v]  Demande à PaCifiST de stopper l'exécution des
  687.                                 programmes quant une interruption se produit.
  688.                                 Le défaut est de n'en intercepter aucune.
  689.                                 "all" signifie toute ("none" aucune). Si le
  690.                                 nombre v est positif, cette exception est
  691.                                 rajoutée à la liste, s'il est négatif elle est
  692.                                 retirée. Vous pouvez spécifier une liste de
  693.                                 valeurs séparées par des virgules.
  694.  
  695.         LOGIRQ = [all|none|v]   Comme ci-dessus, mais PaCifiST se contentera
  696.                                 d'écrire un bloc d'information dans le fichier
  697.                                 de LOG sans interrompre l'exécution.
  698.  
  699.  
  700.     3.1.4 Exemple de fichier PACIFIST.INI
  701.     -------------------------------------
  702.  
  703.  
  704. [system]
  705.  
  706. tos = c:\pacifist\tos.rom, "Mon TOS"    ; donne le chemin d'accès au TOS
  707.  
  708. image=c:\pacifist\disks\boot.st ; nom d'un fichier image pour le lecteur ST A:
  709. mount=c:\pacifist\stfiles       ; C:\PACIFIST\STFILES deviendra C: pour le ST
  710. mount=c:\pacifist\games         ; C:\PACIFIST\GAMES deviendra D: pour le ST
  711. autorun = no                    ; afficher le moniteur
  712.  
  713. pcdrive=no                      ; :) pas d'émulation dans le lecteur du PC
  714.  
  715. [video]
  716.  
  717. refreshrate = 2                 ; n'émule qu'un écran de l'Atari sur deux
  718. monochrome = no                 ; émulation d'un moniteur COULEUR
  719. render=screen                   ; utiliser le rendu vidéo par écran
  720.  
  721. [debug]                         ; seulement si PaCifiST est compilé par DEBUG
  722.                                 ; ignorez cette section
  723.  
  724. logfile = f:\debug.out          ; le fichier de log où mettre les infos
  725. logirq = none                   ; liste des exceptions vide
  726. logirq = 0x21                   ; logguer les appels à GEMDOS
  727. logirq = 0x1c,69                ; logguer aussi les VBL & les TIMERS C
  728. trapirq = 5                     ; monitorer les divisions par zéros
  729.  
  730.  
  731.  3.2 Paramètres de la ligne de commande
  732.  --------------------------------------
  733.  
  734. PACIFIST [/option1] [/option2] [....]
  735.  
  736. Certaines directives du fichier INI peuvent être outrepassées sur la ligne
  737. de commande. Les options valides sont:
  738.  
  739.  
  740.         /[h(elp)|?]             liste des options
  741.         /ini <fichier>          utilise le nom précisé plutot que PACIFIST.INI
  742.         /refreshrate n          comme la directive REFRESHRATE
  743.         /mono [yes|no]          comme la directive MONOCHROME
  744.         /autorun [yes|no]       comme la directive AUTORUN
  745.         /ramsize [n|512k]       comme la directive RAMSIZE
  746.         /sound [yes|no]         comme la directive SOUND
  747.         /image <filename>       désigne une image de disquette prioritaire
  748.         /mount <path>           désigne un chemin à monter prioritairement
  749.         /maxspeed               comment en mode "maxspeed" (vitesse maxi)
  750.         /pcdrive [yes|no]       comme la directive  PCDRIVE directive
  751.         /render [screen|line|mixed|custom] comme la directive RENDER
  752.         /ymrecord               allocation mémoire pour l'enregistrement des YM
  753.  
  754.  
  755.  3.3 Configuration depuis le Moniteur
  756.  ------------------------------------
  757.  
  758. Lisez la section de référence du Moniteur pour une description complète de
  759. toutes les commandes. Si vous ne connaissez pas l'assembleur 68000, seules
  760. les commandes suivantes vous serons directement utiles:
  761.  
  762.         g       "go", lancer l'émulation
  763.         x       "eXit" quitter l'émulateur et revenir au DOS
  764.         vol <n> définie le volume (0-255)
  765.         help    aide rapide
  766.  
  767. Touches utiles:
  768.  
  769. [F1]    Changer entre les modes de rendu vidéo SCREEN (écran), LINE (lignes),
  770.         MIXED (mixte).
  771.  
  772. [F2]    Choisir un mode vidéo utilisé en mode LINE (lignes). Disponible
  773.         seulement si un driver VBE2.0 avec mémoire vidéo linéaire est détecté
  774.         au démarrage. Les modes 256 couleurs sont les plus rapides, mais les
  775.         32k & 64k donnent de meilleurs résultat.
  776.  
  777. [F3]    Change le mode de vitesse (MAX/ST). Peu stable.
  778.  
  779. [F4]    Affiche l'écran d'émulation joystick. [*NOUVEAU*]
  780.  
  781. [F5]    Emulation des sons digitalisés logiciels du STF
  782.  
  783. [F12]   Affiche l'écran de sélection de disquette. On peut aussi utiliser
  784.         F12 *pendant* l'émulation.
  785.  
  786.  
  787.  3.4 L'écran de sélection de disquette
  788.  -------------------------------------
  789.  
  790. Utilisez F12 à tout moment pour afficher cet écran. Il est utilisé pour
  791. changer les disquettes insérées dans les lecteurs A: & B: du ST émulé.
  792.  
  793. Le sélecteur n'affiche pas tous les fichiers, mais seulement ceux dont
  794. l'extension est .ST, .MSA, .ZIP et .RAR ainsi que les répertoires
  795. et les unités valides.
  796.  
  797. Utilisez ESC pour quitter l'écran. <HAUT>, <BAS>, <PAGE PREC.>, <PAGE SUIV.>,
  798. <HOME>, <FIN> pour naviguer dans la liste de gauche. <TAB>, <DROITE>, <GAUCHE>
  799. choisissent entre le lecteur de disquette A: & B. <ENTREE> insérera l'image
  800. sélectionné dans le lecteur courant. Il y a également une option pour
  801. virtuellement "l'enlever".
  802.  
  803. La touche <*> vous permet de forcer la non-exécution des bootsecteurs qui
  804. sont normalement exécutables. Par défaut, PaCifiST est en mode 'KEEP BOOT'
  805. (conserver le boot) mais en mode 'SKIP BOOT' (outrepasser le boot) il fera
  806. croire a l'Atari qu'aucun boot n'est exécutable. [*NOUVEAU*]
  807. Pratique si une image de disquette contient un virus ST (inoffensif pour
  808. votre PC!).
  809.  
  810. Bien sur, si la disquette insérée doit être bootée (pour qu'un jeu démarre),
  811. il faut également effectuer un reset de l'Atari ST (CTRL-BREAK sous émulation,
  812. ou commande 'reset' sous le Moniteur).
  813.  
  814. Le sélecteur de disquettes considère les archives ZIP & RAR comme des
  815. répertoires conventionnels, vous pouvez dont grouper vos images de disquette
  816. dans de tels archives. Les désarchiveurs PKUNZIP.EXE & RAR.EXE doivent se
  817. trouver dans le chemin du DOS (ou le répertoire de PaCifiST) pour que cette
  818. possibilité vous soit présentée. PaCifiST utilisera le répertoire temporaire
  819. précisé dans la variable d'environnement TEMP pour ces extractions.
  820.  
  821. IMPORTANT: Aucune écriture effectuée sur une image MSA ou dans une archive
  822. ne sera répercutée dans l'image originale.
  823.  
  824.  3.5 L'écran des ports joysticks [*NOUVEAU*]
  825.  -------------------------------
  826.  
  827. Cet écran vous permet de choisir entre différents types d'émulations pour
  828. chacun des 2 ports joystick de l'Atari. Pour l'instant, seuls 3 choix sont
  829. possibles: "none" (pas d'émulation), "PC Joystick #1" et "Numeric Pad" (pavé
  830. numérique).
  831.  
  832.       - PC Joystick #1 n'est disponible que si un joystick analogique a
  833.         été détecté au démarrage de l'émulateur. Vous devez également calibrer
  834.         cette manette: Tapez "c" depuis cet écran, ou "calib" sous le Moniteur.
  835.  
  836.       - Le pavé numérique peut donc être utilisé pour simuler un joystick ST,
  837.         le voyant NumLock (VerrNum) doit alors être désactivé.
  838.         la touche CTRL de droite (ou gauche si laptop=yes dans le fichier INI)
  839.         sert de bouton de feu.
  840.  
  841.  
  842. 4. Divers
  843. =========
  844.  
  845.  4.1 Quelques Conseils
  846.  ---------------------
  847.  
  848.         - MIEUX VAUT NE PAS UTILISER DE CACHE DISQUE AVEC ECRITURE DIFFEREE
  849.           (genre SMARTDRV C+)
  850.  
  851.         - Quelques fonctions du GEMDOS ne sont pas super bien émulées. Par
  852.           exemple sur les unités "mountées", le sélecteur de fichiers du
  853.           GFA BASIC ne marche pas bien.
  854.  
  855.         - Si vous avez des difficultés à configurer PaCifiST, vous avez tout
  856.           intérêt à utiliser une "front-end interface" (interface de config),
  857.           un utilitaire spécialement créé dans ce but. Il en existe une
  858.           dizaine, dont AssiST sous DOS (Par Aengus Jankowsky) & PaCiLOAD
  859.           sous Windows 95 (par Andrew Knipe).
  860.  
  861.         - Si vous utiliser une version "DEBUG" de PaCifiST et que vous avez
  862.           beaucoup de mémoire, placer le fichier de LOG dans un ramdisque.
  863.  
  864.         - Eviter d'utiliser PCDRIVE. C'est lent, peu stable et bien moins
  865.           pratique qu'une image de disquette.
  866.  
  867.  
  868.  4.2 Le VBE 2.0
  869.  --------------
  870.  
  871. Pour que le mode de rendu vidéo par ligne (LINE MODE) donne toute sa mesure,
  872. mieux vaut disposer d'un driver VBE 2.0, comme par exemple Scitech's
  873. Display Doctor (http://www.scitechsoft.com), un shareware.
  874.  
  875. Si vous posséder une carte graphique basée sur une puce de la famille S3,
  876. il existe également S3VBE par D.Meschede qui lui est gratuit.
  877.  
  878.  
  879.  4.3 Images de disquettes
  880.  ------------------------
  881.  
  882. Ces fichiers ne contiennent juste que les secteurs d'une vraie disquette
  883. mis les uns à la suite des autres dans l'ordre logique.
  884.  
  885. PaCifiST n'a pas besoin d'informations particulières, parce que les paramètres
  886. de la disquette (nombre de secteurs, pistes...) sont contenus dans le premier
  887. secteur. Si ces valeurs semblent erronées, PaCifiST tentera de les deviner
  888. au mieux.
  889.  
  890. Vous pouvez créer vos propres fichiers images à partir de vos disquettes
  891. ST par le programme IMGBUILD. Il vous permet également de créer des images
  892. vierges de tailles diverses. Reportez-vous à la section RESSOURCES pour
  893. plus d'informations.
  894.  
  895. PaCifiST est également capable d'utiliser directement des fichiers au
  896. format MSA.
  897.  
  898.  
  899.  4.4 Correspondances pour le clavier
  900.  -----------------------------------
  901.  
  902.  
  903. Le clavier pendant l'émulation correspond à celui d'un Atari réel, excepté:
  904.  
  905.         - HELP est mappé sur PagePrec
  906.         - UNDO est mappé sur PageSuiv
  907.  
  908.         - CTRL+Break fait un reset (+SHIFT pour un reset à froid)
  909.  
  910.         - En émulation joystick, si NumLock est on, les touches flechées
  911.           correspondent aux directions de la manette de jeux (CTRL = feu),
  912.  
  913. F12 ramène au premier plan l'écran de sélection de disquette.
  914. La touche en dessous ECHAPE ramène le Moniteur.
  915.  
  916.  
  917.  4.5 Captures d'écran
  918.  --------------------
  919.  
  920.  
  921. Cette possibilité est apparue dans la version 0.44 de PaCifiST. Elle vous
  922. permet d'enregistrer l'image actuellement à écran dans un fichier PCX
  923. créé dans le répertoire de PaCifiST. Tous les fichiers seront appelés
  924. "PCST_xxx.PCX"
  925.  
  926. Vous avez juste à presser la touche "Arrêt Défil" (ScrollLock), mais ce n'est
  927. pas possible dans tous les modes vidéos.
  928.  
  929. * modes suppportés:
  930.  
  931.         - Haute résolution du ST
  932.         - Basse résolution en SCREEN MODE
  933.         - Basse résolution en LINE MODE (256 & Hicolor)
  934.         - MIXED MODE (depuis PaCifiST v0.45)
  935.  
  936. * non supportés:
  937.  
  938.         - Moyenne résolution du ST
  939.  
  940.  
  941.  4.6 Sauvegarde de jeux
  942.  ----------------------
  943.  
  944. Le formatage dans PaCifiST est feint puisqu'il ne modifie pas la structure
  945. des images de disquettes. Vous pouvez donc formater des disques de sauvegarde
  946. pour certains jeux (voir ci-dessous), a condition que vous utilisiez des
  947. images prévues pour: Même nombre de faces, de pistes et de secteurs par piste.
  948.  
  949. Exemples:
  950.  
  951.         CARRIER COMMAND - Disquette double face, 10 secteurs
  952.                           [imgbuild /blank /name SAVE.ST /sector 10]
  953.  
  954.         DEUTEROS -        Disquette standard (double face, 9 secteurs)
  955.                           [imgbuild /blank /name SAVE.ST)
  956.  
  957.  
  958.  4.7 Enregistrement de musiques .YM
  959.  ----------------------------------
  960.  
  961. If you know PaCifiST, then you're likely to know STSound as well.
  962.  
  963. STSound (DOS & Win95 version exist) is a software YM2149 emulator. Virtually
  964. all ST soundchips (as well as Spectrum & Amstrad CPC ones) can be replayed.
  965. This program is written by Arnaud Carre, and you can download the latest
  966. version at: http://www.mygale.org/09/leonard/.
  967.  
  968. PaCifiST can now record such soundfiles. You must start the emulator with the
  969. /ymrecord switch to allocate the needed extra memory (20 minutes of sound).
  970. Use the "record" option under the monitor to start/stop the recording.
  971. Files starting from YM_001.BIN will be created. BEWARE: Existing files are
  972. overwritten without any warning.
  973.  
  974. Those files are "raw recorded" and huge. You should then use the LHA
  975. archiver with a commandline like: lha a -h0 -m <ym file.ym> <raw file.bin>
  976. to generate the final YM files
  977.  
  978.         - PaCifiST can only record plain soundchips. Not Sampled ones.
  979.           The YM5! format is now used.
  980.  
  981.         - Record only in ST speed. Don't worry if PaCifiST is under the 8Mhz,
  982.           it doesn't affect the replaying speed of the tune later on.
  983.  
  984.         - Don't spread widely unperfect/uncomplete .YM files. Starting the
  985.           recording exactly when the music starts is not always easy and
  986.           some knowledge in music ripping may help.
  987.           With v0.46, you can use the <play> monitor command in order to
  988.           locate the exact start/end point in the music. A loop point can
  989.           also be specified.
  990.  
  991.         - Read the DOC that comes with STSOUND.
  992.  
  993.  
  994.    4.7.1 Utilisation
  995.    -----------------
  996.  
  997.  
  998. You start/stop the recording under the monitor:
  999.  
  1000. record     : display status
  1001. record on  : start/resume recording
  1002. record off : stop/pause record. You then choose between:
  1003.  
  1004.                 (F)ree - free the recording memory, abort current record.
  1005.                 (P)ause - pause the recording.
  1006.                 (S)ave - save to a file called YM_xxxx.BIN.
  1007.  
  1008.  
  1009.    4.7.2 Informations Techniques
  1010.    -----------------------------
  1011.  
  1012. Use a DEBUG build of PaCifiST, to have the ability to set breakpoints,...
  1013. The best method is to locate the installation & replay routines. Look the
  1014. VBL & the MFP Timer vectors (command "status"), set a breakaccess at
  1015. "ff8802", etc...
  1016.  
  1017. The YM registers are recorded during the first rasterline. You must start
  1018. the recording just after the replay routines is called for the first time.
  1019. This will work most of the time:
  1020.  
  1021.         1) find the installation routine
  1022.         2) set a breakpoint at its end
  1023.         3) go till then, remove the breakpoint.
  1024.         4) use the command "trap 1c" (stop emulation on VBL)
  1025.         5) "g" - go till the first VBL IRQ since music is installed
  1026.            (repeat this twice in some cases)
  1027.         6) "trap 1c", remove VBL trapping
  1028.            "record on", start recording
  1029.         7) if the music ends itself, stop recording, it's done. The end.
  1030.            If it loops, you'd better wait the second complete rolling before
  1031.            stopping. Then use YMTOOL in order to create an *exact* looped YM,
  1032.            but it's not always possible.
  1033.  
  1034.  
  1035.  
  1036.  4.8 Detection & Utilisation de PaCifiST
  1037.  ---------------------------------------
  1038.  
  1039. Il est maintenant possible aux programmes ST de détecter la présence de
  1040. PaCifiST. Dans le future des registres "hardware" supplémentaires sont
  1041. susceptibles d'être ajoutés. ;-)
  1042.  
  1043. Vous avez juste à appeler la fonction XBIOS Vsync() avec les registres
  1044. D6 & D7 étant "Emu?". Si votre programme est exécuté depuis PaCifiST, alors
  1045. D6 deviendra "PaCi" et D7 "fiST", A0 pointera vers le début d'une zone
  1046. mémoire spéciale (probablement $FFFF8100). Vous avez intérêt à être en
  1047. mode superviseur pour accéder à cette zone, même si ce n'est pas nécessaire
  1048. POUR LE MOMMENT.
  1049. L'émulateur TOSBOX de Mark Slagell utilise la même méthode de détection.
  1050.  
  1051. Reportez-vous au fichier EMUDTECT.TXT pour davantage d'information et
  1052. un exemple de source assembleur.
  1053.  
  1054.  
  1055.  
  1056. 5. Le Moniteur
  1057. ==============
  1058.  
  1059.  
  1060.  5.1 L'écran du Moniteur
  1061.  -----------------------
  1062.  
  1063. La barre bleu tout en haut de l'écran contient un mini rappel des touches de
  1064. fonctions les plus utiles, ainsi que les modes d'émulation vidéo et de vitesse
  1065. en cours.
  1066.  
  1067. En dessous se trouve le contenu des registres du 68000, une estimation de la
  1068. vitesse relative de l'émulation ainsi que la ligne raster actuelle.
  1069.  
  1070. Sur la droite: Le contenu de la pile courante (USP ou SSP), une liste des
  1071. breakpoints (points d'arrêts), breakaccesses (accès d'arrêts), breakopcode
  1072. (opcode d'arrêt).
  1073.  
  1074. La fenêtre du haut montre en permanence un désassemblage des instructions
  1075. 68000 autour du PC. Un "*" placé devant une instruction indique un breakpoint
  1076. à cet adresse.
  1077.  
  1078. Vous pouvez utiliser CTRL-Z pour tracer une instruction (step into), CTRL-T
  1079. faisant la même chose sans entrer dans les sous-programmes (trace over).
  1080. CTRL-U peut être utilisé quand le mode trace du 68000 est actif, pour passer
  1081. chaque instruction. PaCifiST permet en effet de "tracer le mode trace".
  1082. CTRL-G est une alternative à la commande <go>.
  1083.  
  1084.  
  1085.  5.2 Les commandes du Moniteur
  1086.  -----------------------------
  1087.  
  1088. Certaines commandes nécessitent une version "DEBUG" de PaCifiST. Parce que
  1089. cela ralentit l'émulation, elle n'est pas inclus dans les distributions
  1090. normales de l'émulateur.
  1091.  
  1092. Les paramètres entre parenthèses sont optionnels.
  1093. La plupart des nombres utilisés dans le Moniteur sont hexadécimaux.
  1094.  
  1095.  
  1096. h,help,?        Rapide résumé des commandes
  1097. t               Trace une instruction à la fois, exceptés les BSR, JSR & TRAP
  1098.                 qui sont exécutés complètement (appuyez sur une touche pour
  1099.                 interrompre cette exécution).
  1100. z (n)           Trace une seule instruction. Si une interruption se produit,
  1101.                 elle sera déclenchée immédiatement. Le mode trace peut
  1102.                 également être tracé.
  1103. d (adr)         désassemblage sur quelques lignes
  1104. g (n)           "go". Exécution, lancer l'émulation.
  1105. m (adr)         affiche un dump de la mémoire (hexa & ascii).
  1106. bp (adr)        ajoute ou enlève un point d'arrêt. Cela ne modifie pas du tout
  1107.                 la mémoire, vous pouvez placer un breakpoint AVANT même qu'une
  1108.                 routine ne soit chargée à cette adresse. Evitez d'utiliser
  1109.                 des points d'accès comme première instruction d'une routine
  1110.                 d'exception (mieux vaut alors se servir de la commande TRAP).
  1111. ba (adr)        ajoute ou enlève un breakaccess (accès d'arrêt). Toute lecture
  1112.                 ou écriture à cette adresse particulière interrompra
  1113.                 l'émulation. Attention: un accès d'un mot à $10000 ne
  1114.                 déclenchera pas un accès d'arrêt à $10001.
  1115. bo <msk> <cmp>  définit un opcode d'arrêt (break opcode). Un seul utilisable.
  1116.                 Tous les opcodes sont ANDés avec le premier paramètre puis
  1117.                 comparés avec le second. Par exemple <bo ffff 4e75> stoppera
  1118.                 l'émulation à chaque instruction RTS rencontrées. Pour supprimer
  1119.                 le breakopcode, utilisez <bo 0 1>.
  1120. s reg=<value>   Change la valeur d'un registre 68000.
  1121. s [adr]=<octet> change la mémoire (même la ROM). Par exemple "s [1230] = 4e 71"
  1122.                 mettra un $4e en $1230 et un $71 en $1231.
  1123. nop <adr> <n>   Remplit la mémoire à <adr> avec <n> instructions NOP.
  1124. lb <nom> <adr> (taille) charge un fichier en mémoire.
  1125. sb <nom> <adr> <taille> sauve une partie de la mémoire sur disque.
  1126. reset (hard)    Effectue un RESET du ST émulé. (+hard pour reset à froid)
  1127. trap (vecteur)  Cette commande vous permet de stopper l'émulation 68000 quand
  1128.                 se produit une exception de numéro donné. TRAP seul donne
  1129.                 une liste des vecteurs importants de l'Atari ST.
  1130. animate <n>     Cette commande trace <n> instructions, en écrivant dans le
  1131.                 fichier de LOG défini dans PACIFIST.INI le contenu des
  1132.                 registres 68000 à chaque pas.
  1133. status          Affiche des informations sur le MFP & les lecteurs ST.
  1134. disa <debut> <fin> Désassemble une partie de la mémoire.
  1135. kbd (octets)    Affiche ou ajoute des octets dans le buffer interne du 6301.
  1136. kbdelay [n]     Examine ou change la valeur de la variable KBDVALUE
  1137. vol (volume)    définit le volume (de 0 à 255), ou affiche le volume actuel.
  1138. x               eXit. Retour au DOS.
  1139. pref [on|off]   Si "on" (activé), le prefetch du 68000 sera émulé. Cela ralenti
  1140.                 beaucoup l'émulation, aussi mieux vaut n'entrer dans ce mode
  1141.                 que temporairement, quand nécessaire (pour passer le boot de
  1142.                 la BIG DEMO par exemple)
  1143. patch [off|...] Change le comportement normal de PaCifiST pour passer certains
  1144.                 programmes. Le seul patch actif actuellement est "joy". Essayez
  1145.                 le quand le bouton du joystick ne semble pas marcher.
  1146. calib           Entrer dans le monde de calibration du joystick PC.
  1147. tos             changer le TOS actuel, si plusieurs ont été listés dans le
  1148.                 fichier INI. Bien sur le ST est reseté.
  1149. record [on|off] Enregistrement de musique YM. PaCifiST doit avoir été lancé
  1150.                 avec le switch /ymrecord. Si aucun argument n'est donné,
  1151.                 le statut actuel de l'enregistrement est affiché.
  1152.                 Si la commande <play> a été utilisé avant, les paramètres
  1153.                 éventuellement spécifiés alors sont utilisés.
  1154. play <start> <end> <loop> rejoue le buffer YM.
  1155.  
  1156.  
  1157. Les commandes suivantes nécessitent une version "DEBUG" de PaCifiST:
  1158. bp, ba, bo, trap
  1159.  
  1160.  
  1161. 6. Ressources & Remerciements
  1162. ===============================
  1163.  
  1164.  6.1 Programmes connexes
  1165.  -----------------------
  1166.  
  1167.    6.1.1 Autres émulateurs
  1168.    -----------------------
  1169.  
  1170.  
  1171.         - STonX         Ecrit par Marinos Yannikos(nino@complang.tuwien.ac.at)
  1172.                         et Martin Griffiths (mgriffiths@ea.com).
  1173.                         Il s'agit d'un émulateur freeware pour Unix livré sous
  1174.                         forme de sources. Une version DOS existe également,
  1175.                         portage réalisé par Dirk Jansen. Le site officiel est:
  1176.                         http://www.complang.tuwien.ac.at/nino/home.html
  1177.  
  1178.         - Gemulator 96  Il s'agit d'un émulateur commercial. Il est rapide mais
  1179.                         ne peut utiliser que des applications Atari ST 100%
  1180.                         systèmes. Gemulator Classic, plus vieux et sous DOS
  1181.                         est quant à lui gratuit. Site officiel:
  1182.                         http://www.emulators.com
  1183.  
  1184.         - NoSTalgia     C'est un émulateur très récent, écrit par Philippe
  1185.                         Gerin (philippe.gerin@advalvas.be). Il est conçu pour
  1186.                         MAC et semble particulièrement bon.
  1187.  
  1188.         - TOSBOX        Un émulateur ST tout nouveau, utilisable sous DOS.
  1189.                         Son auteur, Mark Slagell (bald_soprano@usa.net), a
  1190.                         bien travaillé: TOSBOX est basée sur une émulation
  1191.                         du système. De ce fait, lui et PaCifiST sont tout
  1192.                         à fait complementaires.
  1193.  
  1194.    6.1.2 Utilitaires
  1195.    -----------------
  1196.  
  1197. AssiST - Aengus Jankowsky (ajankows@iol.ie)
  1198.          http://homepages.iol.ie/~ajankows/st/assist/assist.html
  1199.  
  1200.         Un utilitaire qui configure PaCifiST pour vous par l'intermediaire
  1201.         d'un menu très clair. Ce programme est recommandé aussi bien pour les
  1202.         novices que les habitués de la scène de l'émulation.
  1203.         Une version Windows95 remplace AssiST à présent: AssiST97! Réalisée
  1204.         par Aengus et Gerard Butterly.
  1205.  
  1206. PaCiLOAD - Andrew Knipe (alk@bluesky.net.au)
  1207.            http://www.labyrinth.net.au/~contact/paciload.zip
  1208.  
  1209.         Une interface de configuration sous Windows. Facile à utiliser,
  1210.         elle peut également convertir des fichiers .MSA vers .ST avant de
  1211.         démarrer de l'émulateur.
  1212.  
  1213. MSAtoST - Damien Burke (st@jetman.demon.co.uk)
  1214. STtoMSA   http://www.jetman.demon.co.uk/st/index.html
  1215.  
  1216.         deux convertisseurs pour faire passer les fichiers MSA en ST et
  1217.         vice-versa. De nombreux programmes Atari ST sur Internet sont
  1218.         sous forme d'archives MSA.
  1219.  
  1220. IMGBUILD - Frederic Gidouin (frederic.gidouin@hol.fr)
  1221.            http://www.pacifist.fatal-design.com/
  1222.  
  1223.         Un petit utilitaire pour créer des fichiers images .ST à partir
  1224.         de vraies disquettes. Il ne peut pas lire les disquettes 11 secteurs
  1225.         ni les formats exotiques.
  1226.         ImgBuild peut aussi créer des images "vierges".
  1227.  
  1228. Désolé, par manque de courage, de temps et de place cette liste est très
  1229. incomplète. D'autres utilitaires existent:Fuji Bar, PaCifiGUI, PaCigo 97,
  1230. MSA2ST, MakeDisk, ParaLink, PaCifiST Dragon. Reportez-vous à la page Internet
  1231. de PaCifiST pour Plus d'infos.
  1232.  
  1233.  
  1234.  6.2 Ressources
  1235.  --------------
  1236.  
  1237.         PaCifiST-Support Sites:
  1238.         =======================
  1239.  
  1240.  
  1241. - http://www.pacifist.fatal-design.com/
  1242.  
  1243.         La page officielle de PaCifiST. Vous y trouverez les dernières
  1244.         infos, version de l'émulateur & plein de liens.
  1245.         programmation HTML & design du site faits par Rich!!
  1246.  
  1247. - http://ireland.iol.ie/~ajankows/st/pacifist.html
  1248.  
  1249.         Contient plusieurs versions de PaCifiST et de AssiST. Quelques
  1250.         images de disquettes (jeux), des TOS et des liens.
  1251.  
  1252. - http://www.fatal-design.com/desktop/
  1253.  
  1254.         Un incroyable site, plein de bonnes idées. Il est maintenu par
  1255.         Rich(ard) Davey a qui la communauté de l'émulation ST doit une
  1256.         fière chandelle: FujiBBS, archives de centaines d'images de
  1257.         disquettes, liste de diffusion sur PaCifiST...
  1258.  
  1259. - http://www.geocities.com/SiliconValley/Park/9967/
  1260. - http://www.jetman.demon.co.uk/st/index.html
  1261. - http://www.geocities.com/SiliconValley/Park/5000/index.html
  1262. - http://www.geocities.com/SiliconValley/Lakes/8711/
  1263. - http://users.iol.it/mamo7
  1264. - http://home.pages.de/~stefansworld/pacifist/st_page.htm
  1265. - http://www.geocities.com/area51/corridor/8458/
  1266. - http://www.geocities.com/SiliconValley/Way/8264/index.html
  1267. - http://users.powernet.co.uk/sterling/pacifist/
  1268. - http://dspace.dial.pipex.com/chriscox/home.htm
  1269. - http://hem.passagen.se/win95/index.htm
  1270. - http://www.ohz.north.de/user/ruediger/home.htm
  1271.  
  1272.  
  1273.         Autres Pages Web
  1274.         ================
  1275.  
  1276. - http://www.mygale.org/09/leonard/
  1277.  
  1278.         La page de Arnaud Carré, présentant notamment son incroyable STSOUND,
  1279.         un player capable entre autre d'émuler à la perfection la puce sonore
  1280.         YM2149. Des centaines de musiques au format .YM sont disponibles.
  1281.  
  1282. - http://www.why.net/home/adam/cem/toc.html
  1283.  
  1284.         La FAQ de comp.emulators.misc, maintenue par Adam Roach.
  1285.  
  1286.  
  1287.  6.3 REMERCIEMENTS
  1288.  -----------------
  1289.  
  1290. Je voudrais remercier tout particulièrement les personnes suivantes pour leur
  1291. soutien & leur feedback.
  1292.  
  1293.         Darren Birks
  1294.         Damien Burke
  1295.         Arnaud Carre
  1296.         Stuart Campbell
  1297.         Jan Alexander Corsini
  1298.         Chris Cox
  1299.         Richard Davey
  1300.         Ulrich Doewich
  1301.         Laurent Fargues
  1302.         Flix
  1303.         Ben Fozard
  1304.         Peter Fransson
  1305.         Philippe Gerin
  1306.         Carolyn Horn
  1307.         Aengus Jankowsky
  1308.         Johan Klockars
  1309.         Andrew Knipe
  1310.         Patrice Lindivat
  1311.         Bruno Mathieu
  1312.         Jonathan McHugh
  1313.         Mike Mee
  1314.         Stefan Meier
  1315.         Andreas Muegge
  1316.         Ludovic Olivencia
  1317.         Ed Olmos
  1318.         Jamison Pitcher
  1319.         Matthew Prest
  1320.         Alan Reeve
  1321.         Mauro Rossetti
  1322.         Mark Slagell
  1323.         Simone Voltolini
  1324.         Arsene Von Wyss
  1325.         Zoop
  1326.  
  1327. Et bien sûr un GRAND MERCI à toutes les personnes qui m'ont encouragé par des
  1328. contributions matérielles.
  1329. Enfin, le logo utilisé en en-tête de cette doc a été dessiné par Senser de
  1330. Nitrophusion (merci!).
  1331.  
  1332.  
  1333.  6.4 POUR ME CONTACTER
  1334.  ---------------------
  1335.  
  1336. N'hesitez pas à me contacter pour si vous avez des suggestions, des
  1337. remarques ou...des dons à faire!
  1338.  
  1339. adresse électronique:
  1340.                         frederic.gidouin@hol.fr
  1341. adresse postal:
  1342.                         Frederic Gidouin
  1343.                         9, Allee du Chevrefeuille
  1344.                         29280 Plouzane
  1345.                         FRANCE
  1346.  
  1347.