-------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------

  oooooooooooo          .o.           .oooooo..o    ooooooooooooo 
  `888'     `8         .888.         d8P'    `Y8    8'   888   `8 
   888                .8"888.        Y88bo.              888      
   888oooo8          .8' `888.        `"Y8888o.          888      
   888    "         .88ooo8888.           `"Y88b         888      
   888             .8'     `888.     oo     .d8P         888      
  o888o           o88o     o8888o    8""88888P'         o888o     

      _           ____        _     _       ____                 
__  _| |____  __ |___ \    __| | __| |___  |___ \   _ _   _  ____
\ \/ / '_ \ \/ /   __) |  / _` |/ _` / __|   __) | |_| \_/ |/ _  |
 >  <| |_) >  <   / __/  | (_| | (_| \__ \  / __/  | |     | (_| |
/_/\_\_.__/_/\_\ |_____|  \__,_|\__,_|___/ |_____| |_|_|_|_|\__, |
                                                            |___/   
-------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------
Batch Extraction/Injection/Conversion Version 1.0.0 Finale du 23/09/2K3 By fuckdb..
 XBX <-> DDS <-> IMG (Supporte "jpg", "tif", "tga", "png", "ppm", "bmp")
-------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------

Quoi de neuf:
-------------
1.0.0 Finale:
+ Ajout: Slection des fichiers  convertir,
+ Ajout: de la fonction xbx => img
+ Ajout: de la fonction img => xbx
+ Ajout: de la fonction de prvisualisation,
+ Ajout: de l'utilisation de l'utilitaire de conversion
  d'image de ImageMagik (lisez le tools\copyright.txt),
+ Ajout: du gadget sur la transparence de la fentre.
+ Dsormais les conversions d'images n'acceptent
  que les formats compltement supports dans les fichiers xbx,
+ Une valise de bugs corrigs ;)
+ Suppression: du support des images de toutes tailles
  (cela enlve une complte compatibilit avec les
  textures DDS, lisez plus bas "UTILISATION"),
+ Update: de l'outils de conversion de chez NVidia (5.59),
+ Update: de la librairie de convertion (devil),
+ Beaucoup de changement ont eu lieu donc: RTFM,
+ Plus d'volutions  partir de maintenant ;)

0.9.9 -> 0.6.2: Privates releases Only.

0.6.1beta:
+ les problmes de conversion de certains types
  d'images est rsolu,
+ lisez la section ATTENTION SVP.

0.6.0beta:
+ redimensionnement automatique des images non
  conforme au format DDS (dja prsent dans la
  version prcdente mais je n'ai pas modifi le
  readme)
+ format d'extraction d'image slectionable,
+ la fentre de log scrolle automatiquement,
+ option permettant d'enlever les avertissements.


TODO:
-----
+ Rien de plus :>>


Description:
------------

Toutes ces fonctionalits sont des traitements par lots pour vous simplifier
la manipulation d'un grand nombre de fichiers.

* Extraction des fichiers DDS contenus dans des fichiers XBX,

* Injection des DDS dans les fichiers XBX,

* Conversion de fichiers DDS vers une image (Supporte les formats suivants
comme destination: .tga, .bmp, .jpg, .ppm, .png, .tif, .raw et .sgi),

* Conversion de fichiers images vers un ou des fichiers DDS ou XBX (Supporte
les formats suivants en entre: .tga, .ppm, .jpg, .tif et d'autres mais je
n'ai pas eu le temps d'essayer toutes les combinaisons)

* Support multilangue.

* Slection unique et multiple de fichiers  traiter,

* Support de la prvisualisation (effectif aussi lors d'un double clic sur
un fichier dans la section "Fichiers  choisir", les previsualisations des
fichiers dds et xbx ne sont qu'un aperu, le resultat sur la XBox ne sera
pas exactement le mme mais bien plus beau),

* Gadget permettant de changer la transparence de le fentre principale
du programme (attention vous pouvez le faire totalement disparaitre),

* Les controles Windows sont accessibles afin de pouvoir minimiser et
restaurer le programme.


Installation:
-------------

1) Prparation des outils:
~~~~~~~~~~~~~~~~~~~~~~~~~~
Il suffit de mettre les fichiers suivants dans le rpertoire tools:
- bundler.exe      (non inclus, MS Copyrighted)
- xprextract2.exe  (inclus)
- nvdxt.exe        (inclus NVidia Copyrighted)
- dds2img.exe      (inclus)
- convert.exe      (inclus, lisez tools\copyright.txt)

--> TOUT LES OUTILS EXCEPTE BUNDLER.EXE SONT FOURNIS DANS LE PACKAGE  <--
--> Pour des raisons de droits d'auteurs entre autre et de copyrights <--
--> je ne peux les fournir dans ce package ;)                         <--

2) Prparation des fichiers:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ Mettre les .XBX  extraire dans le rpertoire "xbx",
+ Les fichiers .DDS se trouveront dans le rpertoire "dds",
+ Enfin le rpertoire "img" contiendra les fichiers images dans
leur diffrents formats.


Utilisation:
------------

  Si vous suivez les conseils suivants vous aurez des XBX parfaits, comme l'explique
le tutorial sur www.xboxdash.net .

  Les seules choses  connaitre sont les tailles que doivent respecter vos fichiers
images sources. Afin de pouvoir tre converti avec la plus grande exactitude j'ai
enlev le redimensionememt automatique des textures qui donnait un rsultat plus
que foireux. Vous devez maintenant faire des images d'une taille compatible avec le
format DXT1, c'est  dire que la taille (largeur et hauteur) de vos images sources
doit tre une puissance de 2 pour tre convertie et une puissance de 4 (mais cela
reste optionel) pour bnificier de la compression intgre au DXT1.

   Si vous ne respectez pas les consigne numres ci-dessus vous ne trouverez
aucun DDS ou XBX correspondant aux images dont les tailles ne coincident pas.


ATTENTION:
----------

* attention lors de la conversion d'images vers les fichiers .DDS, seulement les
fichiers des types suivants sont supports (.tga, .bmp, .gif, .ppm, .jpg, .tif),
si par hasard un fichier n'tait pas conforme  ces standarts le programme ne
retourne pas d'erreur et vous n'obtiendrez peut tre pas le rsultat attendu....

^^^^ Cela ne peut plus arriv en thorie, si c'est le cas cf: Contact ^^^^

* pour avoir des fichier .xbx valides vous devez utilisez bundler.exe du XDK
version 4627 au moins,

* certain .xbx ne peuvent pas tre convertis en .dds et vous obtiendrez
de rsultats surprenant, cela vient du fait que ce ne sont pas des vrai .xpr.

* ne pas utiliser de noms de fichiers avec des espaces (de toutes manire y en
 pas dans les XIP de la xboite).


BUGS CONNUS:
------------

??? Il y en a un sur la previsualisation mais vous pouvez vivre avec ;)
Au cas ou rien ne s'affiche j'ai pris soin de mettre un timer de 10 secondes
avant de fermer la fentre de prvisualisation, vous pourrez comme cela revenir
au programme principal.


Me Contacter:
-------------
Vous pouvez toujours essayer... Sur irc effnet #evolutionx #xboxdash !!!!


 -----------------------------------------------------------------------------------
 -----------------------------------------------------------------------------------
 Gr33ts: _n3o_ (nfo,auto-installeur), la scene XBox, #xbins, #xboxdash, Xbox-Scene,
 -------  XboxHacker.net, legueux et la plupart de la Team ;),
         un peut M$ quand mme :)
         et tout ceux qui me donnent le courage de continuer dans cette voie :p

 Beta Testeurs Officiels: _n3o_, BigGanja
 ~~~~~~~~~~~~~~~~~~~~~~~~

 Third Party Authors: NghtShd pour dds2img.exe
 ~~~~~~~~~~~~~~~~~~~~ Mirage  pour xprextract2.exe
                      NVidia  pour NVdxt.exe
                      ImageMagik pour convert.exe
                      BigGanja pour le SplashScreen
 -----------------------------------------------------------------------------------
 -----------------------------------------------------------------------------------
