                                   MPEG FEVER
                                   ==========
                                  (version 1.0)

                    Shell permettant de crer et de bidouiller 
                               les animations MPEG

                                  MDB Software


0  MPEG FEVER est POSTCARDWARE
   ---------------------------

  Si vous l'utilisez vous devez m'envoyer une carte postale.
  Profitez-en pour me dire si il y a quelque chose que vous voudriez voir
  dans MPEGFEVER ou si il y a des BUGs.
  Si vous voulez une version 68000+copro alors envoyez moi une disquette 
  avec une enveloppe timbre pour le retour. 
  Si une personne veut le traduire en Anglais il peut le faire (tout le
  texte est dans MPEG.RSC). Je lui demande juste de me faire parvenir le
  fichier ressource traduit afin que tout le monde en profite.
  If you want to translate MPEGFEVER into ENGLISH you can do it. (All the
  text is in MPEG.RSC). I just want you to send me your translation.

  CHAUSSY Laurent
  50 rue du bout d'en haut
  77570 Mondreville
  FRANCE
  Email : bidouill@ibm580.ensicaen.ismra.fr


I  Contenue de l'archive FEVER.ZIP et INSTALLATION
   -----------------------------------------------

 MPGFEVER-|
          |-68000-|
          |       |-ENCODE.TTP   (version 68000 de l'encodeur)
          |       |-DECODE.TTP   (version 68000 du dcodeur)
          |       |-MPEGUTI.TTP  (version 68000 de MPEGUTILS)
          |
          |-68030-|
          |       |-ENCODE.TTP   (version 68030 de l'encodeur)
          |       |-DECODE.TTP   (version 68030 du dcodeur)
          |       |-MPEGUTI.TTP  (version 68030 de MPEGUTILS)
          |
          |-68030+82-|
          |          |-ENCODE.TTP   (version 68030+copro de l'encodeur)
          |          |-DECODE.TTP   (version 68030+copro du dcodeur)
          |          |-MPEGUTI.TTP  (version 68030+copro de MPEGUTILS)
          |
          |-VISU-|
          |      |-MPEGDSP.TTP   (visualiseur couleur pour falcon)
          |      |-PLAYMPEG.TOS  (visualiseur NB pour falcon)
          |      |-MPEGPLAY.TTP  (visualiseur couleur trs lent)
          |
          |-DOC-|
          |     |-ENCODE.TXT  (manuel de l'encodeur en anglais)
          |     |-DECODE.TXT  (manuel du dcodeur en anglais)
          |     |-MPEGUTI.TXT (manuel de MPEGUTILS en anglais)
          |     |-FEVER.TXT   (ce fichier)
          |     |-FAQ.TXT     (rponses au questions les plus frquentes
          |                     propos des animations MPEG en anglais)
          |
          |-INFOMPEG-|
          |          |-INFOMPEG.TTP  (petit utilitaire en anglais)
          |          |-INFOMPEG.DOC  (la doc)
          |
          |-ESSAI-|
          |       |-CINDY.MPG   (une anim MPEG avec CINDY !!!)

  Un disque Dur est conseill (indispensable). Pour les possesseur de ST
  je vous conseille de vous mettre en ST haute pour utiliser le programme
  et pour les autres une rsolution de 640*400 au minimum.
  MPEG FEVER marche avec MINT mais ce n'est pas encore trs propre a le sera
  dans une prochaine version.

  Une fois l'archive dcompacte lancez le programme, allez dans le menu 
  "Config" et slectionnez "chemins".
  - Cliquez sur l'icne disquette situ en face de "Encodeur :" et
    allez chercher le programme ENCODE.TTP qui correspond  votre
    processeur.
  - idem avec "Dcodeur :" et DECODE.TTP
  - itou avec "MpegUtils :" et MPEGUTI.TTP
  - Avec "Visualiseur :" allez chercher un visualiseur dans le dossier
    VISU (MPEGDSP.TTP est un bon choix sur FALCON).
  - Sauvez la configuration en cliquant sur "Sauver" dans le menu "Config".

  Voila c'est configur!
  Pour voir les possibilit de MPEG FEVER essayer de dcoder 
  l'animation CINDY.MPG puis de la rencoder.

II Pourquoi un tel programme ?
   ---------------------------

 Il y a de a quelques temps lorsque les premiers players MPEG au DSP
 sont apparus j'ai ralis qu'il n'existait rien sur Atari pour faire
 ces fameuses animations. Ayant accs  INTERNET je me suis mis  la
 recherche de sources de programmes faisant des animations MPEG. Aprs
 quelques semaine de recherche j'avais enfin trouv plusieurs logiciel.
 Les 3 que j'ai mis en oeuvre dans MPEGFEVER sont les meilleurs parmi
 ceux que j'ai put trouver. Je les ait compil et dbugus mais je 
 n'tait pas satisfait de la faon dont il fallait les utiliser. J'ai
 donc cr MPEG FEVER qui est un shell qui permet, comme le fait
 POVSHELL avec POVRAY, d'utiliser les 3 programmes de faon
 conviviale.

 MPEG FEVER  t dvelopp sur FALCON 030 40Mhz avec Pure C 1.1 et
 le merveilleux BIG 1.93 (merci  Claude Attard).


III Pourquoi plusieurs versions ?
    -----------------------------

    Pour voir si l'intrt de plusieurs version tait fond j'ai fait
    un test avec un FALCON  32 Mhz en rsolution VGA 16 couleurs sur
    l'animation CINDY.MPG qui comporte 30 images. Le test a t fait
    avec le format TGA.

             |-------------|-------------|    
             |  Dcodeur   |  Encodeur   |    
             |-------------|-------------|    
    68030+82 |  2 min 33 s |  7 min 54 s |
    ---------|-------------|-------------|
    68030    |  2 min 33 s | 28 min 20 s |
    ---------|-------------|-------------|    
    68000    |  3 min 23 s |  1 h 13 min |
    ---------|-------------|-------------|

IV  Les menus
    ---------

    Peu de remarques sur les menus :

     * "Chemins" permet de configurer les chemins ou se trouvent les
       diffrents programmes.

     * "Sauver" permet de sauver tous les chemins qui ont t slectionn
       dans MPEG FEVER.

V  L'encodeur
   ----------

 * L'icne Super Disquette permet de choisir un chemin et un nom de
   fichier. Ce nom apparatra ensuite dans le bouton qui se trouve 
   droite de la disquette.

 * L'icne Film permet de visualiser l'animation MPEG grce  un des
   viewer choisis.

 * Le programme comporte des bulles d'aides : pour les faire apparatre
   il suffit de presser la touche Control et de promener la sourie sur
   les fentres.

 * L'icne "MDB inside" permet de sauver le fichier contenant tous les
   paramtres ncessaire  l'encodeur.

 * Dans le cadre "MPEG" se trouve les paramtre permettant de choisir
   le type de MPEG que l'on souhaite crer.
   Pour les players actuels sur Falcon vous devez obligatoirement
   choisir : MPEG I avec N=1 et M=1
   En effet les players n'acceptes que les animations dites compatible
   XING. Ces animations ne doivent comporter que des images de type I et
   aucune P et B.

 * Dans le cadre "Images sources" se trouve un icne "chane" qui permet
   une fois que l'on a choisi le chemin, le nom et le format des images
   de complter automatiquement le reste des paramtres. Ceci ne 
   fonctionne qu'avec les images TGA et GIF (je doute fortement que vous
   utilisiez les autres formats).

 * Dans le cadre "Compression" se trouve les paramtres qui vont
   dterminer la qualit de l'animation cre.
   Faite le calcul suivant 3*(X display)*(Y display)*(Images/s) et
   divisez ce nombre par un facteur compris entre 5 et 10 (en gros) et
   vous aurez le nombre de Bits/s. En gnral on laisse le "vbv buffer"
    20. Il se peut que le player NB pour falcon vous sorte des sales
   Cacas pas bo si vous avez choisi un nombre trop grand pour "Bits/s".
   Je ne sais pas pourquoi il fait a alors que le player couleur ne
   le fait pas. De plus n'essayez pas de faire des anims trop petites
   (animations trop rapide) ou trop grandes (animation trop lente).
   Une taille de l'ordre de 160 par 120 semble tre un bon compromis.

 * La ligne remarque sera sauve dans l'entte de l'animation MPEG. Vous
   pouvez y mettre tout ce que vous voulez sauf des espaces.


EXEMPLE :
---------

 Vous venez de terminer une super anim faite avec POV et vous avez 50
 images TGA :
      TOTO1.TGA   (ou TOTO0001.TGA)   (le nom gnrique ne doit pas
      TOTO2.TGA   (ou TOTO0002.TGA)    dpasser 5 lettres)
         .
         .
      TOTO50.TGA  (ou TOTO0050.TGA)

 1) Choisissez le chemin et le nom de l'anim.
 2) Choisissez le chemin et le nom du fichier ou seront sauve les
    statistiques de compression concernant votre anim.
 3) Choisissez le chemin et le nom du fichier ou se trouveront les
    paramtres qui vont tre utiliss par l'encodeur (si vous
    slectionnez un fichier paramtre qui existe dj, toutes les
    options seront mises  jour).
 4) Choisissez le chemin ou se trouve les images, rentrez le nom
    gnrique TOTO  droite de la disquette, slectionnez le format
    TGA et cliquez sur l'icne chane. Voila si toutes vos images ont
    la mme taille et si aucune n'est bousille tous les autres 
    paramtres seront remplis.
 5) Choisissez MPEG I et N=M=1.
 6) Choisissez les paramtres de compression.
 7) Entrez une ligne de remarque (sans espaces)
 8) cliquez sur Applique.
 9) Une fois l'anim cre vous n'avez plus qu'a cliquer sur l'icne film
    pour la voir. 

    Si l'encodeur vous sort le message "vbv delay overflow", n'en 
    tenez pas compte, essayez juste de rgler au mieux les paramtres
    de compression afin que cela n'apparaisse pas. Ce message apparait
    systmatiquement quand l'animation est trop petite.
    
VI  Le dcodeur
    -----------

    Si vous avez lu ce qui prcde je ne devrais pas avoir beaucoup de
    chose  expliquer.

    Le "Niveau de dtail" permet de choisir si les informations sur 
     l'cran devront tre brves ou trs dtailles. (1 est une bonne
    valeur)

    Le reste est bien expliqu dans les bulles d'aides et n'a de toute faon
    que peut d'intrt.

    EXEMPLE :
    ---------
    Vous avez une super anim MPEG rcupre sur INTERNET mais hlas elle
    est incompatible avec les players Falcon.

    1) Choisissez l'anim en question.
    2) Choisissez un chemin ou seront stocke les images (prvoyez beaucoup
       de place), un nom gnrique (genre TOTO) et un format d'image (si
       vous dsirez rcuprer certaine des images il est bon de choisir
       le format TGA mais si vous voulez seulement la rencoder ensuite
       je vous conseille le format "yuv" qui est plus rapide.)	
    3) Choisissez un niveau de dtail de 1.
    4) Le reste on s'en moque dans le cas gnral.
    5) Cliquez sur Applique. Vous voila maintenant avec un gros paquet
       d'images.

    6) Vous n'avez plus qu' utiliser l'encodeur pour refaire une amim
       compatible avec les players sur Falcon.


VII  MPEGUTILS
     ---------

     MPEGUTILS permet 3 choses :
      - voir le contenu d'une anim MPEG (NB d'images, les diffrents types
        d'images, dans quelle ordre elle sont affiches...).
      - concatner deux animations MPEG.
      - extraire un morceau d'une animation (le clipping quoi!).

     Tout est expliqu dans les bulles d'aide et dans le panneau accessible
     avec la touche HELP.

IIX  Quelques dtails sur les animations MPEG.
     -----------------------------------------
     Une animation MPEG est compose de GoP (Group of Picture) qui comportent
     en gnral une quinzaine d'images (32 maximum). a commence toujours par
     une images de type I (Intra frame) qui ne dpend que d'elle mme et 
     a finit obligatoirement par une image de type I ou P. Les images
     intrieur sont de type P ou B et il n'y a pas plus de 8 images
     B conscutives.
     Une image de type P (predicted frame) dpend de l'image de type I ou P
     qui la prcde (seul la diffrence entre ces deux images est sauve).
     Une image de type B (bidirectionally predicted frame or interpolated frame)
     dpend  la fois de l'image qui la prcde et de celle qui la suit.

     Les animations MPEG de ce type sont difficile  dcoder rapidement, c'est
     pour cela qu'est apparu le format dit compatible XING. Les animations
     MPEG de ce type ont les caractristiques suivantes :
          - Que des images de type I.
          - Un seul GoP.

     C'est pour cela que les paramtres N et M doivent tre  1 dans l'encodeur.
     Pour le moment l'encodeur fait autant de GoP qu'il y a d'images ce qui
     se traduit par une anim un peut plus grosse. Ce petit dtail devrait tre
     rapidement rgl dans une prochaine version  moins qu'un nouveau player
     acceptant les images P et B ne voit le jour.

     MPEG FEVER ne permet pas de contrler toutes les options possibles de
     l'encodeur (car il y en a trop) pour plus de dtails et si vous tes
     un pros de la DCT reportez vous  la DOC. 

IX Les formats d'image
   -------------------
   - Le format yuv est un format crer spcialement pour les anims
     MPEG. Ce format comporte 3 fichier :
          *.Y pour la luminance et
          *.U et *.V pour la chrominance
     L'encodage et le dcodage avec ces images est le plus rapide et
     en plus a prend moins de place que les images TGA. C'est le format
     que je vous conseille d'utiliser pour rendre compatible XING une
     anim qui ne l'est pas.

   - Le format YUV est le mme que ci dessus sauf que les trois fichiers
     ont t concatn en un seul fichier *.YUV.

   - Le format PPM (Portable PixMap) issus de l'univers UNIX dans sa version
     P6 ressemble beaucoup au TGA.

   - Le format SIF (Abekas CCIR rec 656) est un driv btard du format yuv.

   A mon avis les formats que vous utiliserez le plus seront le TGA, le GIF
   et ventuellement le yuv pour rendre compatible XING une anim qui ne 
   l'est pas.

X Les Bugs
  --------
  
  Si les chemin sont trop long (genre
  e:\toto\raoul\marcel\68000\decodeur\cindy0.mpg) (nottament avec le
  dcodeur) vous risquez un plantage (du decodeur seulement).
  Si vous trouvez des bugs dites le moi.

                                           Have Fun with MPEG FEVER.
