#########################
#                       #
# AVI-OGM Info : README #
#                       #
#########################

    Version : 2.0.0
    Auteur : Guillaume CASTAGNINO
    HomePage : http://avi-ogminfo.sf.net
    E-Mail : <guilc@fr.st>, <casta@xwing.info>
    Licence : GNU General Public License (voir le fichier LICENSE joint ou www.fsf.org)

##############
Je recherche actuellement quelqu'un disponible pour faire le portage GTK2.4 sous windows et autre plateforme.
##############

##############
# I) General #
##############

    AVI-OGM Info est un logiciel permettant de rcuprer des informations utiles sur les fichiers *.avi, *.ogm et *.ogg, telles que la longueur, les bitrates, les frquences des bandes audio et vido, etc...
    Il est possible d'utiliser le programme avec son interface graphique, ou bien de l'utiliser directement en ligne de commande.

#################
# II) Prrequis #
#################

- Compilation des sources :
    - Prrequis :
        - Outils GNU standards
        - gtk+ 2.4 ou plus
        - gtkmm 2.6 ou plus
        - libogg 1.1 ou plus
        - libvorbis 1.0 ou plus
        - libxml 2.0 ou plus
        - ffmpeg
        
    - Compilation :
        './configure' (Aide : './configure --help')
        'make'
        'make install'

####################
# III) Utilisation #
####################

1) Mode Graphique :

    Pour lancer le programme en mode graphique, il suffit de l'excuter sans arguments.
    L'utilisation du programme est intuitive : ouverture d'un fichier avec le premier icone de la barre d'outils. Ceci lance l'analyse du fichier.
    L'analyse du fichier est quasi instantane pour les fichiers *.avi, mais se rvle plus longue pour les fichiers *.ogm ou *.ogg. En effet : il faut parcourir tout le fichier *.ogm ou *.ogg pour pouvoir extraire les dures ainsi que le bitrate vido du film. Si vous annulez l'analyse en cours d'opration, toutes les informations a l'exception des dures et du bitrate vido du film seront disponibles. Ces 2 valeurs en question auront la valeur au moment ou l'analyse a t arret : temps gal a la portion de fichier analys, bitrate vido moyen de la portion de fichier analys. Un fichier *.ogm ou *.ogg peut en thorie contenir plusieurs flux vido. Cette situation ne semblant pas trs courante, et plutot inutile, seul le premier flux vido sera trait. Si il y en a d'autres, ils seront ignors.
    L'icone de la disquette (deuxime icone de la barre d'outils) permet d'enregistrer les informations de la vido dans un fichier texte.

2) Mode ligne de commande :

    Vous avez la possibilit de lancer le programme en ligne de commande uniquement. Pour cela, il suffit de donner des arguments au programme.
    Pour avoir un dtail de la syntaxe : 'avi-ogminfo -h' ou 'avi-ogminfo --help'
    Le principe est de lancer le programme en donnant en argument un ou des fichiers a analyser. l'option '-r' permet de parcourir les rpertoires rcursivement.
    Le rsultat est donn dans la console, ce qui permet de rediriger facilement les donnes dans un fichier au moyen de '>' dans un interprteur de type bash.

############
# IV) TODO #
############

- Drag'n'Drop
- Support matroska (libebml and co)
- Toute suggestion est bienvenue.

#################
# V) Historique #
#################

- Suite changelog dans le ficheir Changelog

- Version 2.0.0-alpha1 :
    - Portage gtk 2.4 avec gtkmm. Actuellement meme fonctionnalits que l'ancienne version wxWin ou presque.
    - Internationalisation avec gettext
    - Cette versino est release pour tests seulement

- Version 1.3.2 :
    - Assouplissement de la dtection des 4CC (case insensitive).
    - Fonctionne uniquement en fonction du contenu des fichiers, et plus de leurs extensions.
    - Par consquent, ajout du type dans l'interface.

- Version 1.3.1 :
    - Correction d'un bug avec certains fichiers mp3 sans id3 tag.
    - Correction d'un bug dnas la vrification de validit des headers MPEG Audio (framerate).
    - Modification du script configure maintenant compatible avec l'unicode et le GTK2 sous Linux.

- Version 1.3.0 :
    - Ajout du support des ficheirs MP3 (et MPEG AUdio en gnral).
    - Nouvelles icones.
    - Support de wxWindows Unicode et GTK-2 sous Linux.

- Version 1.2.3 :
    - Compilation des binaires avec la nouvelle version de wxWindows/gcc.
    - Ajout de l'en-tete xml dans les sorties xml (amliore la compatibilit).
    - Modification du script d'autoconfiguration, compatible uniquement avec les version de wxWindows avec "make install" (non fait au dpart car le make install est dclar "facultatif", mais s'avre indispensable) : Utilisation partielle du script 'wx-config'.
    - Makefile et configure comments en anglais (facilite sans doute la portabilit).
    - La version ligne de commande marche en console non X et en console DOS.
    - Aide de la ligne de commande internationnalise.
    - Nouveau Makfile avec dpendances automatiques (mthode "moderne").

- Version 1.2.2 :
    - Amlioration et correction du script d'autoconfiguration.
    - Binaires windows compils avec gcc 3.3.1 au lieu de 3.2.3.
    - Version entirement compatible avec Linux (GTK). Version MacOSX en cours d'amlioration.

- Version 1.2.1 :
    - Possibilit de gnrer les sorties en XML.

- Version 1.2.0 :
    - Restructuration de certaines parties pour adapter un mode ligne de commande.
    - Ajout du mode ligne de commande.

- Version 1.1.0 :
    - Sous windows : Intgration du fichier manifest a l'excutable.
    - Rorganisation de certaines parties du code.
    - Amliorations du Makefile et ./configure
    - Version de production stabe (Fin de la priode de dveloppement intense).

-------------
Fin de la priode de dvellopement initial.
Changement de numrotation des versions => Phase de maturation du programme.
-------------

- Version 1.04 :
    - Finition des destructeurs (sortie du programme plus propre, meme si le garbage libre la mmoire tout seul).
    - Changement des ids des lments de wxWindows utiliss, pour plus de scurit (risque de collision d'ids en cas d'ajout de fonctions).
    - Ajout de la possibilit de "fermer" un fichier (ie remettre dans l'tat initial du programme).
    - Amlioration de la robustesse de certaines fonctions.
    - Optimisation de l'utilisation de la jauge dans l'analyse des fichiers ogm/ogg. Devrait accelrer le traitement (3-4 s).

- Version 1.03 :
    - Correction d'une erreur qui empechait l'affichage de l'icone dans la barre de titre.
    - Internationalisation de la sortie en fichier texte.
    - Ajout de la longueur des pistes Audio (parfois diffrente de la piste video, et utile si pas de vido (pour le ogg vorbis)).
    - Ajout du facteur qualit vido.
    - Ajout des raccourcis clavier (Ctrl + O, Ctrl + S, F1).

- Version 1.02 :
    - Mise a jour du systeme de "configure" pour le multi-plateforme.
    - Utilisation des icones xpm aussi sur windows (simplifie la portabilit).
    - Correction des icones xpm (contenaient des caractres non valides).
    - Ajout des icones en dpendances dans le Makefile.

- Version 1.01 :
    - Correction de quelques chaines concernant les noms des codecs.
    - Amlioration des arrondis, notamment sur les bitrates.
    - Utilisation des valeur "true" et "false", natives en C++, plutot que leur alias "TRUE" et "FALSE" crs par wxWindows.
    - Passage des definition de types utiliss uniquement en priv dans les classes concernes, en private.
    - Utilisation de la lecture de fichier bufferise, ce qui accelre le traitement.
    - Utilisation de la classe wxFileName pour les noms de fichier (augmente la portabilit et la clart du code).
    - Fenetre non redimensionnable (c'est inutile, et moche...).
    - Possibilit d'analyser les fichiers *.ogg (identiques aux *.ogm en fait on peut mettre de la vido dans un *.ogg, et que de l'audio dans un *.ogm...).

- Version 1.00 :
    - Premire version publique.

###############
# VI) Licence #
###############

- Ce programme est soumis a la licence GNU General Public License (voir le fichier gpl.txt ou www.fsf.org).

- Gtk+-2.4 / gtkmm-2.4 sont sous license lgpl.
- LibOgg et LibVorbis sont sous une licence BSD-Like (vois www.xiph.org).

######################
# VII) Remerciements #
######################

- L'quipe de Ogg Vorbis pour la librairie et l'excellent format de donnes.
- Cyrius, dont le programme "OGMInfo" m'a permit de mieux comprendre le format ogm et la manire de l'analyser.
- Une fois n'est pas coutume : Microsoft pour la MSDN et sa spcification complete du format RIFF AVI.

