                                   MPEG FEVER
                                   ==========
                                 (version 1.07)

                    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 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 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 : chaussy@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)
          |
          |-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)
          |     |-ENGLISH.TXT (petite doc en anglais)
          |     |-MPEG.RSC    (le ressource 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 semaines de recherche j'avais enfin trouv plusieurs logiciels.
 Les 3 que j'ai mis en oeuvre dans MPEGFEVER sont les meilleurs parmi
 ceux que j'ai pu trouver. Je les ais compils 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 a 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 slectionns
       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 souris sur
   les fentres.

 * Dans le cadre "MPEG" se trouvent les paramtres 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'acceptent que les animations dites compatibles
   XING. Ces animations ne doivent comporter que des images de type I et
   aucune P et B.

 * Dans le cadre "Images sources" se trouve une 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).
   Petite remarque sur le champ "Nombre de Zros" : il permet de 
   charger des images dont le nom est de la forme TOTO0000.TGA, 
   TOTO0001.TGA... dans cet exemple il faut mettre 4.
   Pour charger des images du type TOTO0.TGA, TOTO1.TGA... il faut 
   mettre 0 et nom pas 1 (si vous mettez 1 vous ne verrez alors que 
   les images de 0 a 9...).

 * 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 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).
 3) 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. Voil, si toutes vos images ont
    la mme taille et si aucune n'est bousille, tous les autres 
    paramtres seront remplis.
 4) Choisissez MPEG I et N=M=1.
 5) Choisissez les paramtres de compression.
 6) Entrez une ligne de remarque (sans espaces)
 7) cliquez sur Applique.
 8) 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 apparat
    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
     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 peu 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 anim
       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
     intrieures 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 (seule 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 difficiles  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 peu 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.
     -> Ce dtail est maintenant rgl : On a des anims 100% 
     compatible XING.

     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 pro 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 concatns en un seul fichier *.YUV.

   - Le format PPM (Portable PixMap) issu 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) (notamment avec le
  dcodeur) vous risquez un plantage (du decodeur seulement).
  Si vous trouvez des bugs dites le moi.

XI Evolution
   ---------
   version 1.03:
   	-correction d'un sale bug de popup  qui  ne  voulait  pas  popuper
       comme tout bon popup  devrait  popuper...(merci  a  Frdric  FFX
      Faucheux) 
      -correction d'un bug de sauvegarde du fichier paramtre.
      -amlioration de la sauvegarde des  paramtre  :  dorenavant  plus
       besoin de cliquer sur l'icone MDB INSIDE (conseil de Frdric FFX
       Faucheux).
      -Fichier ressource en Anglais traduit par  Frdric  FFX  Faucheux
       (Email : faucheux@galaxie.int-evry.fr)
      -Les version 68030+82 du decodeur et de mpegutil ont t  enleve
       car inutiles.
   
   version 1.05:                                       
      -correction d'un bug de redraw des boutons ou se trouvent les noms
       des fichiers. Merci  Denis Meline pour m'avoir signal ce bug.
      -correction d'un bug de popup (encore !!!).
      -amelioration de l'encodeur : il est  dornavant  100% compatible
       XING. Il y a maintenant un seul GOP ferm ou se trouve toutes les
       images de type I. MPEGUTIL ne detecte plus  aucuns  defauts  dans
       les anims cres  maintenant.   Mais   il   y   a   toujours   des
       problmes avec le player de MPEG noir et blanc !!! Problme que 
       je n'arrive pas  comprendre car les anims cres marchent trs 
       bien avec le player couleur. Il semble que plus on compacte 
       l'anim, moins les dfauts apparaissent. Donc essayez de 
       diminuer bit/s jusqu' trouver une valeure pour laquelle tout va 
       bien si vous voulez utiliser le player NB...
      -la version 68030 de l'encodeur ne marchait pas a cause d'un bug 
       de la librairie de GNU C. C'est maintenant corrig.
  
   version 1.07:                                       
      -Amelioration du choix des images. Il est maintenant possible 
       d'encoder des images du type TOTO0000.TGA, TOTO0001.TGA...
       Cette amlioration m' t sugre par Herv Piedvache afin 
       d'utiliser des images en provenance de NEON 3D.
      -Supression du choix du chemin et du nom du fichier statistique, 
       c'tait inutil et tout le monde s'en fout ! Il est maintant 
       sauv avec le fichier MPEG mais avec l'extension .OUT
         
      					
                                            Have Fun with MPEG FEVER.
