Added doc and removed useless maxrate option

JTX-Encoder.bat

@@ -1,6 +1,23 @@
+::============================================================
+::=============== Programme d'encodage du JTX ================
+::============================================================
+::====== Par Denis Merigoux, inspir‚ de Nicolas Breton =======
+::============================================================
+
+::ffmpeg v2.7.2 doit ˆtre plac‚ dans le mˆme dossier que le .bat pour que celui-ci fonctionne.
+::Alternativement, on packagera le .bat et ffmpeg.exe … l'int‚rieur d'un unique .exe
+::… l'aide de http://www.f2ko.de/en/b2e.php pour plus de portabilit‚ et de protection du code.
+
+
+
+
+::On se r‚fŠrera au site http://ss64.com/ pour la documentation des commandes batch
 @echo off
+::Titre de la fenˆtre de ligne de commande.
 title= ---- Encodeur du JTX ----
+::Couleur du texte et du fond
 color 0D
+::Efface l'‚cran
 cls
 echo    ******************************************************
 echo    ****************** Encodeur du JTX *******************
@@ -17,7 +34,10 @@ echo    2 : HD       1280x720  3 Mbits/s   25 i/s
 echo    3 : Web      854x480   1.5 Mbits/s 25 i/s
 echo    4 : Archives 720x576   1.5 Mbits/s 25 i/s
 echo.
+::Affiche un prompt d'une seule touche
 choice /C 1234 /N /M "   S‚lectionez le r‚glage en appuyant sur [1], [2], [3] ou [4] :"
+::R‚cup‚ration mystique du r‚sultat de choice
+::L'ordre des if est important (?!)...
 if errorlevel 4 (
 	echo.
 	color 0E
@@ -27,6 +47,7 @@ if errorlevel 4 (
 	echo    ***** Appuie sur un touche pour lancer l'encodage ******
 	echo    ********************************************************
 	pause >nul
+	::Appel de la routine :encoding avec le paramŠtre 4
 	call :encoding 4
 )
 if errorlevel 3 (
@@ -66,16 +87,22 @@ goto:eof
 
 :encoding
 echo.
+::Cr‚er le r‚pertoire des fichiers originaux
 md Originaux
 color 0a
+::Boucle sur tous les fichiers du dossier en cours
+::%%a est le nom du fichier
 for %%a in (*.*) do (
 	call :encodingcheck %1 "%%a"
 )
+::Lors de l'ex‚cution, le goto amŠne le programme au label :end.
 goto:end
 
+::V‚rifie si le fichier peut ˆtre encod‚
 :encodingcheck
 set toencode="false"
 set extension="%~x2"
+::Ci dessous une liste d'extensions correspondant … tous les formats vid‚os usuels
 if %extension%==".mkv" set toencode="true"
 if %extension%==".MKV" set toencode="true"
 if %extension%==".avi" set toencode="true"
@@ -98,28 +125,58 @@ if %toencode%=="true" (
 	if %1==3 call :web %2
 	if %1==4 call :archives %2
 )
+::Le label :eof est pr‚defini et permet de retourner … l'endroit du code o— la routine a ‚t‚ appel‚e.
 goto:eof
 
+::Ci dessous les commandes d'encodage qui font appel … ffmpeg v2.7.2 (https://www.ffmpeg.org/)
+::Liste des paramŠtres utilis‚s par les commandes :
+::	-i <input>
+::		Fichier original … encoder.
+::	-threads <number>
+::		Nombre de CPU utilis‚s pour r‚aliser l'encodage. Si 0, un maximum de CPU sont utilis‚s.
+::	-c:v <codec>
+::		Codec vid‚o, le JTX a choisi d'utiliser H.264 impl‚ment‚ par la librairie libx264.
+::	-b:v <number>
+::		Bitrate de la vid‚o en sortie, exprim‚ en bits.
+::	-r <number>
+::		Framerate de la vid‚o en sortie.
+::	-s <width>x<hright>
+::		R‚solution de la vid‚o en sortie, exprim‚e en pixels.
+::	-x264opts <options>
+::		Permet de sp‚cifier des options pour la libraire libx264. En l'occurence, on d‚termine
+::		ici le level de l'encodage H.264. Plus d'infos ici : https://fr.wikipedia.org/wiki/H.264#Niveaux.
+::	-pix_fmt <format>
+::		Format d'encodage des pixels. yuv420p est sp‚cifi‚ ici car sinon les vid‚os ne sont pas
+::		lisibles par Windows Media Player. Plus d'infos ici : https://ffmpeg.zeranoe.com/forum/viewtopic.php?t=709.
+::	-c:a <codec>
+::		Codec audio de la vid‚o en sortie. Le JTX a choisi AAC.
+::	-strict <strictness>
+::		Le codec audio AAC ‚tant une fonctionnalit‚ exp‚rimentale pour ffmpeg 2.7.2, il est n‚cessaire
+::		de r‚gler ce paramŠtre sur experimental.
+::	-b:a <number>
+::		Bitrate de l'audio en sortie. Le JTX a choisi 192k.
+::	-y
+::		�crase automatiquement les fichiers en sortie s'ils existent d‚j… (pas de prompt).
 
 :fullhd
 title= ---- Encodeur du JTX ---- Encodage de %1 en FullHD
 move %1 Originaux/
-ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 8M -maxrate 12M -r 25 -s 1920x1080 -x264opts level=4 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
+ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 8M -r 25 -s 1920x1080 -x264opts level=4 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
 goto:eof
 :hd
 title= ---- Encodeur du JTX ---- Encodage de %1 en HD
 move %1 Originaux/
-ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 3M -maxrate 4.5M -r 25 -s 1280x720 -x264opts level=3.1 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
+ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 3M -r 25 -s 1280x720 -x264opts level=3.1 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
 goto:eof
 :web
 title= ---- Encodeur du JTX ---- Encodage de %1 au format Web
 move %1 Originaux/
-ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 1.5M -maxrate 2.25M -r 25 -s 854x480 -x264opts level=3 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
+ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 1.5M -r 25 -s 854x480 -x264opts level=3 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
 goto:eof
 :archives
 title= ---- Encodeur du JTX ---- Encodage de %1 au format Archives
 move %1 Originaux/
-ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 1.5M -maxrate 2.25M -r 25 -s  720x576 -x264opts level=3 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
+ffmpeg.exe -i Originaux/%1 -threads 0 -c:v libx264 -b:v 1.5M -r 25 -s  720x576 -x264opts level=3 -pix_fmt yuv420p -c:a aac -strict experimental -b:a 192k -y "%~np1.mp4"
 goto:eof