-------------------------------------------------------------------------------
                             Le Virtual ColecoVision
                 Un mulateur ColecoVision pour Windows 95 et NT 4.0
          Copyright (C) 1996, 1997 par Neal Danner (neald@geocities.com)
                              Tous droits rservs.

                   ColecoVision (tm) est une marque dpose par Coleco.
               DirectX(tm) est une marque dpose par Microsoft Corporation.
       L'mulation du TMS9928A est base sur le travail originel de Marat Fayzullin.

                      Comso Fighter 2 (inclu la rom du jeu)
                     Copyright (C) 1996, 1997 Marcel de Kogel
                               Tous droits rservs.
                         http://www.komkon.org/~dekogel

        Tous les autres noms des produits mentionns ici, sont des marques dposes
                  ou sous copyright de leurs dtenteurs respectifs.
-------------------------------------------------------------------------------

Virtual ColecoVision est un mulateur  but non lucratif cre pour ceux qui taient et sont
encore des fans des jeux de la console Coleco et qui souhaiteraient pouvoir rejouer  leurs jeux
ColecoVision sous Windows 95 et NT 4.0.

Pour de plus amples informations sur la ColecoVision et son histoire, vous pouvez consulter les sites
webs suivant :

The Virtual ColecoVision Homepage:
http://www.geocities.com/SiliconValley/Vista/8640/VColeco.html

Norman G. Sippel's ColecoVision Homepage:
http://www.infinet.com/~ngsippel/cv.html

This History of Home Video Games Homepage:
http://www.sponsor.net/~gchance/

The ColecoVision FAQ:
http://www.infinet.com/~ngsippel/cv/cv-faq.html

Marcel de Kogel's Homepage (author of Comso Figher 2 and AdamEm):
http://www.komkon.org/~dekogel

Marat Fayzullin's ColEm Homepage:
http://www.komkon.org/fms/ColEm

-------------------------------------------------------------------------------
Les caractristiques de Virtual ColecoVision
-------------------------------------------------------------------------------
   o  Emulation total du hardware de la console de jeu ColecoVision incluant :
      o   Les 2 contrleurs.
      o   Le son.

   o  L'mulation vido du TMS9928A utilis par l'API DirectX de Microsoft pour les sprites
      et le rafrachissement de l'cran.

   o  Jeu en Plein Ecran ou en mode fentr. Un paramtre pour le mode en Plein Ecran (chelle)
      est aussi fourni.

   o  Personnalisation de la dfinition du clavier/joystick.

   o  Pause Automatique/Manuel de l'mulation.

   o  Un tas de paramtre de l'mulation du hardware de la ColecoVision pour contrler
      chaque partie de l'mulation du noyau de la ColecoVision.

   o  Multithreaded so that Z80 CPU emulation runs on one thread while
      Video/Input are ran from the primary thread.
   
   o  ColecoCheat! Provides a mechanism to cheat in *some* games.

-------------------------------------------------------------------------------
                             Liste du contenu
-------------------------------------------------------------------------------
1.0 - Introduction

1.1 - Configuration minimum

1.2 - Historique des versions

1.3 - Comment dmarrer

2.0 - Liste de souhait des nouvelles fonctions

2.1 - Problmes/Bugs connus

2.2 - Ou trouver les mises  jours du Virtual ColecoVision

2.3 - Questions/Rponses

4.0 - Remerciements spciaux

-------------------------------------------------------------------------------
1.0 - Introduction
-------------------------------------------------------------------------------
Merci d'utiliser Virtual ColecoVision.  Aprs avoir pass beaucoup de temps dans le
dveloppement de l'mulation du noyau, j'espre que vous aurez autant de plaisir de jouer
aux jeux ColecoVision sur Virtual ColecoVision que j'en ai eu  le dvelopper.


Un peu d'histoire...
Virtual ColecoVision avait le nom de ColEm 97 jusqu'au 10/06/97. La plupart d'entre vous
s'tonnent de la raison pour laquelle cela s'est produit, c'est une longue histoire, aussi je
vais essayer de la rsumer.

Virtual ColecoVision est le rsultat du projet de dveloppement dmarrer par moi en Octobre 94.
Le projet de base tait Virtual ColecoVision, mais a plus tard tait renomm en ColEm  cause d'une
utilisation partiel du code d'mulation du TMS9918A de Marat Fayzullin. J'ai fait ceci afin 
de rendre hommage  Marat pour avoir utilis son code TMS9918A. Le reste du code de l'mulation de
Virtual ColecoVision a t et fait encore partie de mon propre dveloppement. Aprs avoir discut avec
Marat, il tait devenu vident que depuis que ColEm 97 n'tait pas un port total de son code source
UNIX originel, il aurait donn un nouveau nom. Ainsi, aprs la lecture de nombreux e-mails venant 
des utilisateurs, un nouveau nom,"The Virtual ColecoVision", a t choisi.

D'un autre ct, la seule version windows de ColEm qui tait compltement bas sur les sources de
ColEmp de Marat tait ColEmWin 0.1.2, qui  la base  t port par moi mais n'est plus en
dveloppement.


Les contributions supplmentaires  cette documentation sont toujours les bienvenues. Veuillez 
m'adresser les informations, opinions, et/ou commentaires  :

Neal Danner
neald@geocities.com

Amusez vous!!

-------------------------------------------------------------------------------
1.1 - Configuration minimum
-------------------------------------------------------------------------------

Configuration minimum :

   486-DX100/Pentium 75 ou suprieur avec Windows 95/NT4.0 et directx d'install.
   8MB ram (16MB pour NT4.0)
   Carte vido VLB

   
Configuration recommande :

   Pentium 100Mhz ou suprieur avec Windows 95/NT4.0 et directx d'install.
   16MB ram
   Carte vido PCI
   Joystick

   
-------------------------------------------------------------------------------
1.2 - Historique des versions
-------------------------------------------------------------------------------

2.00a:
   - Premire version publique de ColEmWin 97.
   - Version initial avec le design de l'mulation du noyau OO.

2.00b:
   - Correction d'un bug dans le mode vido 2.

2.00c:
   - Correction d'un plantage "Fatal Exception" qui tait provoqu pendant le lancement de ColEmWin 97 
     dans les profondeurs de couleur suprieur  16 bits par pixel. Ce bug devrait vous montrer
     que vous ne devriez pas boire de bire et coder en mme temps ! =)

2.10a:
   - Support des opcodes non document Z80
   - Ajout de la fonction ColecoCheat! laquelle vous permet de tricher dans les jeux !
   - Ajout de la sauvegarde/restauration d'un jeu !
   - Ajout d'un onglet Affichage dans les proprits de ColEmWin 97 lequel fourni
     beaucoup de nouvelles fonctions :
      - Les modes vido  utiliser en mode Plein cran : peuvent maintenant tre choisi  partir d'une liste
        de modes supports par votre carte vido.
      - Une "Echelle" pour les modes en plein cran peut maintenant tre choisi, ce qui permet  la sortie de 
        l'affichage d'tre agrandi pour les modes vido en haute rsolution.
      - Il y a maintenant 2 paramtres indpendants pour le taux du saut d'image. L'un concerne le taux du saut 
        d'image en mode plein cran et l'autre pour celui en fentr.
   - Ajout d'un bouton pour activer le Joystick.
   - Ajout d'un bouton pour avoir les proprits d'affichage.
   - Ajout dans le menu d'aide d'une sous menu pour aller sur la page web de ColEm 97.

2.10b:
   - Renomm ColEm 97 en "The Virtual ColecoVision".
   - Correction d'un bug dans l'chelle en plein cran. Ce bug provoquait aucune sortie sous certaines 
     rsolutions vido.
   - Ajout du logo.
   - Modification de l'ordre des appels de DirectDraw's SetPalette() function.  Ceci corrige le bug 
     "SetPalette() a chou".
   - Ajout d'une option "Message(s)" dans le menu Emulation. Les utilisateurs peuvent regarder les messages
     les avertissements et les messages d'erreurs gnr par l'mulation du noyau. Un outil trs utile pour 
     dterminer les problmes d'mulations.

2.11a:
   - La rom du jeu de Marcel de Kogel's Comso Fighter 2 est maintenant incluse !

   - Correction d'un bug dans le mode vido 3 dans l'mulation du TMS9928A. Les jeux comme
     Smurf Paint'n Play fonctionne (et probablement d'autres).

   - Correction du gnrateur de modle dans le mode vid 2 du TMS9928A et les problmes avec
     la table de couleur (dans le VMode 2, les registres VDP 3 & 4 ont des fonctions diffrentes).
      
   - Rcriture de la synchronisation de la vitesse du noyau.

   - Ajout d'options dans la ligne de commande pour manipuler le registre systme :
      
     "/unregister" - Pass this argument to remove all references to
                     The Virtual ColecoVision from the system registry,
                     including setup information and file associations.

     "/register" - Pass this argument to register VColecoWin in the
                   system registry.  This also allows you to specify
                   other cartridge file extensions to associate with
                   The Virtual ColecoVision.

   - L'mulation du TMS9928A dumps le mode vido dans Message(s).

   - Correction d'un bug dans le prcdent mode d'affichage qui n'est pas restaur si
     l'utilisateur quitte VColecoWin avec ALT+F4 lorsqu'il est en mode plein cran.

   - Support du copier coller. 

   - Correction d'un problme avec la barre de menu.

   - Corrections d'erreurs de textes dans ColecoCheat! (Surtout pour BurgerTime).

-------------------------------------------------------------------------------
1.3 - Comment dmarrer
-------------------------------------------------------------------------------
Testez par vous mme jusqu' ce que je rdige cette section.  =)

-------------------------------------------------------------------------------
2.0 - Liste de souhait des nouvelles fonctions
-------------------------------------------------------------------------------
   - Dbuggueur/assembleur (incluant un diteur de ROM/tile).
   - Ajout du rseau en utilisant DirectPlay.

-------------------------------------------------------------------------------
2.1 - Problmes/Bugs connus
-------------------------------------------------------------------------------
2.10c:
   - BeamRider, Bump'n Jump, et The Heist ne se chargenet pas encore correctement.
     Bump'n Jump provoque un plantage de l'mulateur.  Probablement provoqu par un bug dans
     l'mulation du Z80CPU ou du TMS9928A.  

   - Pitfall, Dukes of Hazzard, et Frogger ne prennent pas le contrleur.
     Le problme vient probablement dans l'mulation du contrleur...

   - Le bouton "Ajouter/Enlever un Joystick(s).." ne fonctionne pas bien sous Windows NT 4.0,
     si aucun joystick n'est pas branch.

-------------------------------------------------------------------------------
2.2 - Ou trouver les mises  jours du Virtual ColecoVision
-------------------------------------------------------------------------------

Toutes les versions de Virtual ColecoVision peuvent tre trouv sur la page web Virtual ColecoVision :
http://www.geocities.com/SiliconValley/Vista/8640/VColeco.html

***********************************************************************
A NOTER : Aucune jeu ROM n'est inclus avec Virtual ColecoVision d au faite que 
les jeux ColecoVision sont encore sous copyright par leurs dtenteurs respectifs.
***********************************************************************

-------------------------------------------------------------------------------
2.3 - Questions et rponses
-------------------------------------------------------------------------------
Q1: Ou puis je avoir des ROMS de cartouches de jeux ?

    A1: Les images ROMS des cartouches sont encore sous copyright par leurs dtenteurs respectifs.
        La possession de cartouches au format ROM est illgale si vous ne possdez pas une copie
        original de la cartouche ColecoVision.  Il existent de nombreux sites Internet ou vous
        pouvez tlcharger des ROMS. 

        VEUILLEZ NE PAS me demander ou on peut trouver des images ROM !

Q2: J'obtiens des messages d'erreurs DDRAW.DLL ou DSOUND.DLL.
    Quel est le problme et comme le corriger ?

    A2: Installer la dernire version de DirectX 

Q3: J'arrive  lancer Virtual ColecoVision, mais lorsque je suis  l'cran de slection
    des jeux, je ne peux pas continuer.  On dirait que l'mulateur  des problmes 
    avec le clavier. Comment puis je corriger ce problme ?

    A3: Il y a 2 raisons. La premire, c'est que certains jeux ne fonctionnent pas
        bien  cause de l'mulation du contrleur dans Virtual ColecoVision.
        Consultez la section "Problmes/bugs connus" de ce fichier pour connatre la
        liste des jeux.

        Ensuite, sur certains ordinateurs, la dfinition des touches du clavier par dfaut
        ne fonctionne pas correctement. Aussi, redfinissez les touches une nouvelle fois.
        
        Comment avoir l'onglet des contrleurs :
        1.  Pressez Alt+I sur votre clavier OU cliquez sur"Emulation ->
            Contrleur...".

        2.  Ensuite, cliquez sur le bouton "Dfaut".

        3.  Ensuite choisissez "Touche ColecoVision" et "Dfini comme" pour choisir une touche.

            
-------------------------------------------------------------------------------
4.0 - Remerciements spciaux
-------------------------------------------------------------------------------
 - Ma femme, pour m'avoir soutenu pendant le dveloppement de Virtual
   ColecoVision!
 - Thomas Jacobs et John Maier (pour m'avoir fourni avec leurs ordinateurs Coleco-ADAM !)
 - Marat Fayzullin (pour ses sources pour l'mulation de TMS9918A)
 - Marcel de Kogel fpour m'avoir permis de distribuer son jeu Cosmo Fighter 2
   (http://www.komkon.org/~dekogel)

-------------------------------------------------------------------------------
Questions et/ou commentaires sans rponses
-------------------------------------------------------------------------------
Avez vous des questions qui n'ont pas trouv de rponse au dessus ? Envoyez vos question(s)  
Neal Danner  neald@geocities.com avec dans la rubrique "Objet","The Virtual ColecoVision".

