====== oautils ======

  * version 1.1 (20080825) {{:ressource:oautils-1.1.tar.gz|oautils-1.1.tar.gz}}
  * version 1.0 (20080823) {{:ressource:oautils-1.0.tar.gz|oautils-1.0.tar.gz}}

//Ceci est un ensemble de petits utilitaires en rapport avec OpenArena pour les systèmes d'exploitation GNU/Linux et de type UNIX. Distribué sous la license ISC.//

La version 1.0 contient les utilitaires suivants :
  * df-demotidy.sh
  * df-maptime.sh
  * oa-extractshot.sh
  * oa-videorename.sh
  * oa-videotomp2v.sh

Ces scripts sont relativement simples et petits, n'hésitez pas à regarder le code pour voir si leur action vous convient.

Note : les scripts avec l'extension ''.sh'' utilisent un interpréteur de commandes type bourne (comme GNU Bash).

===== Description des outils =====

  * **df-demotidy.sh**

Ce script permet de « nettoyer » un répertoire de démos DeFRaG en effacant toutes les démos d'une même //map// ayant un temps moins bon au meilleur temps.

**Attention**, si vous ne voulez pas effacer de démos, n'exécuter pas ce script.

  * **df-maptime.sh**

Ce script permet de générer, sur la sortie standard, une liste facilement analysable de toutes les démos « standard » de type DeFRaG. Par « standard » il faut comprendre une démo dont le nom est de la forme ''<nom_de_la_map>[<type_de_jeu>.<type_de_pysique>]<temps>(<nom_du_joueur>.<pays>).dm_68'' (format par défaut de DeFRaG).

  * **oa-extractshot.sh**

Ce script prend en argument un répertoire contenant des fichiers ''.pk3'' et extrait les //levelshots// (images d'une //map//) stockés dans des archives ''pk3'' dans un répertoire créé dans le répertoire courant.

Ce script permet aussi de convertir les images dans un même format et, optionnellement, de les retailler en utilisant une largeur donnée à l'aide la commande ''convert'' (de la suite logicielle //ImageMagick//).

Lancer la commande sans argument pour voir l'usage.

  * **oa-videorename.sh**

Ce script permet de renommer les fichiers vidéos générés par OpenArena.

Quand on fait une vidéo à partir d'une démo, si le fichier résultant excède 2 Go, plusieurs fichiers sont alors créés avec un tiret (_) pour chaque fichier supplémentaire (par exemple, le fichier video0001.avi, video0001.avi_, video0001.avi__, etc.).

Ce script renomme ces multiples fichiers sous la forme video0001-<indice>.avi, ''indice'' variant de 01 au nombre de parties trouvées.

Lancer la commande sans argument pour voir l'usage.

  * **oa-videotomp2v.sh**

Ce script permet de générer une version MPEG2 dans un conteneur MPEG-ES (//element stream//), ne contenant que la video (et pas l'audio) des vidéos générées par OpenArena, en utilsant l'encodeur //FFmpeg//.

L'intéret principal est de réduire la taille occupée tout en préservant une très haute qualité. Les options utilisées peuvent être adaptées au besoin en éditant le script.

Lancer la commande sans argument pour voir l'usage.

===== Notes de version =====

==== Version 1.1 ====

  * tests d'existence des commandes externes utilisées (ffmpeg, convert, unzip)
  * changement du copyright (utilise désormais [[http://openarena.tuxfamily.org/licence.txt|celui du site]])
  * distribution sous les seuls termes de la licence ISC
