StereoMovieBuilder v0.3 - Août 2010
StereoMovieBuilder est un outil pour constuire des vidéos à partir de séries d'images.
- Peut générer des fichiers AVI standard, des fichiers WMV ou des vidéo Quicktime.
- Accèpte en entrée des images au format JPEG ou PNG et des vidéos.
- Les images en entrée peuvent être monoscopiques ou stéréoscopiques (format côte à côte).
- SMB utilsie des scripts écrits dans un format très simple pour ajouter des effets aux images comme l'effet Ken Burns et des transitions entre les images.
- SMB peut redimensionner les images, transposer une image stéréo et générer différents formats stéréo (anaglyphe, demi-format, entrelacé,...)
Fichiers Script
Un script est à la base un simple fichier texte listant les images devant être incluses dans la vidéo.
De manière à mieux contrôler la génération du fichier vidéo, des commandes spéciales peuvent être placées dans le script.
Un script est composé des éléments suivants :
- Commentaires: Les lignes vides ou commençant par un point-virgule (;) sont considérées comme des commentaires et sont igorées.
- Commandes: Une commande est une ligne spéciale qui commence par le signe > (en première colonne) et est suivie d'un mot-clé.
Format : >Commande[|paramètres optionels]
Les commandes peuvent être globales ou positionelles, les commandes globales ne peuvent apparaître qu'une fois dans le script et se placent généralement au débuty du script. Les commandes positionelles peuvent apparaître n'importe où dans le script et peuvent être répétées.
- Images: Les autres lignes sont considérées comme des images : elles seront lues et ajoutées au fichier vidéo en cours.
Les images peuvent être spécifiées avec un chemin d'accèes complet ou bien seulement leur nom de fichier si la commande "Path" est utilisée.
Une image peut être répétées en ajoutant " *d" après le nom de l'image (d spécifie le nombre de secondes de la répétition) :
Image_1.png *5
va répéter la même image "Image_1.png" dans le fichier vidéo de manière à ce que sa durée soit 5 secondes.
Liste des commandes disponibles
Notes : La casse des noms des commandes est ignorée. Les durées sont exprimées en secondes et peuvent être un chiffre décimal (attention le séparateur décimal est le point).
- Stereo
Traite les image en entrée comme stéréoscopiques ou bien comme de simples images 2D.
Type : Global
Paramètre (obligatoire) : 1: les images sont stéréoscopiques en format côte à côte (défaut), 0: les images sont 2D.
Exemple : >Stereo=1
- FrameRate
Spécifie de nombre d'image par seconde de la vidéo générée.
Type : Global
Paramètre (obligatoire) : le nombre d'images par seconde désiré. Ca peut être un nombre décimal (attention : le séparateur décimal est le point).
Note : Si non spécifié, la valeur sera de 25 img/s et ne pourra être changée une fois la première image traitée.
Exemple : >FrameRate=30
- MovieFile
Spécifie le fichier vidéo à générer.
Type : Global
Paramètres: Fichier|Codec|Compression
Fichier: Paramètre obligatoire, un nom de fichier valide. Ca peut être un simple nom de fichier si une commande Path a été utilisée auparavant ou bien
un chemin d'accès complet (dossier + nom de fichier). L'extension du nom est utilisée pour déterminer le type de vidéo à produire : .avi pour un fichier AVI, .wmv pour un fichier Windows Media Video et .mov pour un fichier QuickTime.
Codec: Paramètre optionnel, codec de compression vidéo à utilsier. Si non renseigné, on demandera à l'utilisateur de le choisir dans une liste et il poura changer ses paramètres.
Compression: Paramètre optionnel, paramètres de compression.
Note : Si la commande n'est pas incluse dans le script, le nom du fichier vidéo sera celui défini dans l'interface utilisateur de l'application. Si ce champ est vide, on demadera
à l'utilisateur de choisir un fichier.
Exemple : >MovieFile=Test.avi
- Path
Spécifie de dossier par défaut où seront cherchées les images si un nom de fichier complet n'est pas utilisé.
Type : Positionnel
Paramètre (obligatoire): un nom de dossier valide.
Note : Si on utilise à nouveau la commande Path, elle remplacera la précédente et la nouvelle sera utilisée pour les commandes suivantes dans le script.
Exemple : >Path=J:\POVRay\Test
- Resize
Redimensionne les images à la taille spécifiée. La taille indique le "rectangle englobant" du redimensionnement.
Type : Global
Paramètre (obligatoire) : largeur x hauteur en pixels
Note : pour le redimensionnement des images stéréo, la taille indique toujours la taille de l'image stéréo, même si une conversion modifiant la taille (anaglyphe par exemple)
est appliquée après.
Exemple : >Resize=1600x600
- ResizeMode
Spécifie comment les images sont redimensionnées.
Type : Global
Paramètre (obligatoire) : mode : 0:Rectangle englobant, 1:Taille exacte (avec ajout de bords noirs), 2:Etirement pour obtenir la taille spécifiée.
Note : pour les images stéréo, le "centrage des vue" est automatiquement réalisé (les vues G & D sont centrées dans leur demi images respectives).
Exemple : >ResizeMode=2
- Transpose
Pour les images stéréo, intervertit les vues gauches et droite.
Type : Global
Paramètre (obligatoire) : 1 pour transposer, 0 pour ne rien faire (défaut).
Exemple : >Transpose=1
- Convert
Pour les images stéréo, convertit l'image dans un autre type (anaglyphe par exemple).
Type : Global
Paramètre (obligatoire) : numéro de la conversion désirée (voir liste plus bas).
Exemple : >Convert=12
- Crop
Pour les images stéréo, recadre l'image pour qu'elle corresponde au raport d'aspect de la vidéo.
Type: Global
Paramètre (obligatoire): une lettre indiquant la partie de l'image à découper.
0: ne rien faire (défaut)
T: découper le haut de l'image
B: découper le bas de l'image
C: découper le haut et le bas de l'image (recadrage centré)
Exemple: >Crop=C
- Mirror
Effet miroir sur les images.
Type : Global
Paramètres (obligatoire) : Miroir_G, Miroir_D
Miroir_G: si 1, un effet miroir est appliqué à la partie gauche de l'image stéréo.
Miroir_D: si 1, un effet miroir est appliqué à la partie droite de l'image stéréo.
Note : pour les images mono, Miroir_G est utilisé pour l'image totale et le paramètre Miroir_D est ignoré.
Exemple : >Mirror=1,0
- FlipV
Retournement vertical des images
Type : Global
Paramètre (obligatoire) : 1 pour retourner les images, 0 pour ne rien faire (défaut)
Exemple: >FlipV=1
- Background
Spécifie la couleur de fond
Type : Global
Paramètre (obligatoire) : Couleur (voir Frame pour le format)
Exemple: >Background=red
- Frame
Ajoute des images monochromatiques à la vidéo.
Type : Positionnel
Paramètres (obligatoire) : Couleur|Durée
Couleur: couleur de l'image. Ca peut être une des couleurs de base du HTML (Aqua, Black, Blue, Fuchsia, Gray, Green, Lime, Maroon, Navy, Olive, Purple, Red, Silver, Teal, White, Yellow, LtGray)
ou un code RGB hexadecimal : #RRVVBB (par exemple #ff0000 pour du rouge ou #00ffff pour du cyan).
Durée: durée en seconde.
Exemple: >Frame=black|4
Générera une image noire pendant 4 secondes.
- Sequence
Ajoute un jeu d'images ayant une numérotation consécutive.
Type : Positionnel
Paramètres (obligatoire) : Nom_de_base[d]|N°_début|N°_fin
Nom_de_base: base du nom commun au jeu d'images, [d] spécifie où insérer le compteur et d indique le nombre de chiffres de ce compteur.
N°_début: valeur de départ du compteur de la séquence.
N°_fin: valeur de fin du compteur de la séquence. Si non précisé, l'application va incrémenter le compteur tant que des images sont trouvées.
Exemple : >Sequence=MonImage_[4]_X.jpg|1|237
Ajoutera à la vidéo les images "MonImage_0001_X.jpg", "MonImage_0002_X.jpg",... "MonImage_0237_X.jpg"
- Video
Ajoute les images extraites d'un fichier vidéo (le son n'est pas pris en compte).
Type: Positionel
Paramètres (obligatoire) : Nom_Vidéo
Nom_Vidéo: nom du fichier de la vidéo.
Exemple : >Video=MaVideo.avi
Ajoutera le fichier "MyVideo.avi" à la vidéo en cours.
- Transition
Ajoute au fichier vidéo un effet de transition entre deux images.
Type : Positionnel
Paramètres (obligatoire) : Nom_Transition|Durée
Nom_Transition: see the list of available transition below.
Durée: durée de la transition en secondes. En indiquant une valeur négative, la transition sera jouée en sens inverse.
Note : une commande transition doit apparaître entre deux commandes images (une image simple, une commande KBE, Sequence, Frame ou Video).
Placer une commande transition fera que les deux images de part et d'autre se recouvreront le temps de la transition : pour une image simple ou une Frame la durée
sera allongée de la durée de la transition.
Pour les Sequence, Video et KBE, la durée de la transition sera incluse dans la durée des commandes.
Exemple :
Image_1
>Transition=Fade|0.5
Image_2
Va générer une transition de Image_1 vers Image_2 en utilisant l'effet "Fade" (fondu) pour une durée d'une demie seconde.
- KBE
Effet Ken Burns sur une image. Permet de créer une animation sur une image fixe avec des effets de zoom et de panoramique.
Type : Positionnel
Paramètres (obligatoire) : Image|Rect_Initial|Rect_Cible|Durée
Image: image à utiliser (doit être de la plus grande résolution disponible si un zoom est utilisé).
Rect_Initial, Rect_Cible: Le rectangle initial défini la vue initiale sur l'image, c'est à dire la première image de l'animation.
Ce rectangle sera déplacé et redimensionné pour corerspondre, à la fin de l'animation à la taille et position du rectangle cible.
Si le rectangle initial est plus grand que le rectangle cible, on aurra un effet de zoom sur l'image, s'il est plus petit, ce sera un effet de zoom arrière.
Un rectangle est défini par les cinq paramètres suivants : x, y, w, z, t
x, y: position du coin supérieur-gauche du rectangle (valeur en pixels ou %, le coin supérieur-gauche de l'image est 0,0)
w: largeur du rectangle en pixels ou % (la hauteur est déduite du raport d'aspect du fichier vidéo produit)
z: correction de la fenêtre stéréoscopique (mode stéréo seulement). Utile lors de zooms avant sur une image pour garder une
séparation des infinis acceptable.
t: durée additionnelle pour la première (ou dernière) image de l'animation.
L'image sera répétée au début (ou à la fin) de la durée spécifiée (par defaut : 0)
Les paramètres x, y et w peuvent être spécifiés en pixel (défaut) ou en pourcentage des dimension de l'image (ajouter le signe pourcent % à la valeur).
Un rectangle défini par 0,0,0 indique qu'on souhaite utiliser l'image entière.
Durée: Durée en secondes de l'animation (sans compter les durées additionnelles au début et à la fin, la durée totale sera : Durée + t1 + t2).
Note : des bords noirs seront ajoutés si le rapport d'aspect de l'image ne correspond pas à celui de la vidéo générée.
Exemple : >KBE=Volcano0001.png|400,600,800,-70,1|0,0,0,0,2|6
Va montrer une partie zoomée de l'image pendant une seconde avant d'effectuer un zoom arrière en 300 pas (6s) pour montrer l'image entière qui est alors affichée pendant
encore 2s supplémentaires.
- PIP
Incrustation d'une image dans une autre (expériental).
Type : Positionnel
Paramètres (obligatoire) : Rect_1|Rect_2|Durée
Rect_1 : Le rectangle d'incrustation.
Rect_2 : (usage futur).
Un rectangle est défini par les paramètres suivants : x, y, w, z, t, a
x, y : position du coin supérieur-gauche du rectangle (valeur en pixels, le coin supérieur-gauche de l'image est 0,0)
w : largeur du rectangle en pixels (la hauteur est déduite du raport d'aspect du fichier vidéo produit)
z : position en profondeur du rectangle d'incrustation.
t, a : ignoré (usage futur).
Les paramètres x, y et w peuvent être spécifiés en pixel (défaut) ou en pourcentage des dimension de l'image (ajouter le signe pourcent % à la valeur).
Durée: Durée en secondes de l'incrustation.
Exemple :
MN2008_625_X.jps
>PIP=5%,5%,60%,0,0,0|5%,5%,40%,0,0,0|36
>Video=MN2008_626b_X.avi
MN2008_625_X.jps
Incuste la vidéo MN2008_626b_X.avi dans le coin supérieur gauche de l'image fixe MN2008_625_X.jps durant la durée de la vidéo (36 s).
- Text
Affiche un texte en surimpression sur les images de la vidéo. Plusieurs comandes peuvent être utilisées pour imprimer plus d'un texte.
Utiliser la commande >Text=0
pour effacer tous les textes préalablement définis.
Type : Positionel
Paramètres (obligatoires) : Texte|Position|Police|Format_Couleur
Texte : le texte à imprimer.
Position: Cinq champs séparés par des virgules : x, y, w, h, z
x, y : position du coin supérieur gauche du rectangle englobant (le coin supérieur-gauche de l'image est 0,0)
w, h: largeur et hauteur du rectangle englobant.
z: position en profondeur du texte (mode stéréo seulement).
Font: Police à utiliser
Format_Couleur: Format, CouleurTexte, CouleurFond, CouleurOmbre
Format : nombre spécifiant le formattage à appliquer au texte.
CouleurTexte : couleur du texte.
CouleurFond : couleur du fond du rectangle englobant (utiliser 'none' pour un fond transparent).
CouleurOmbre : couleur de l'ombrage du texte (utiliser 'none' pour supprimer l'ombre)
Example: >Text=www.stereoscopie.fr|10%,10%,80%,100%,4|Times,120,0,700,1,0,0|1,blue,none,gray
Texte:
Position:
Police:
Exemple : >Text=www.stereoscopie.fr|-10,-10,10|Times,120,0,700,1,0,0,#0000ff
- Logo
Affiche une image en surimpression sur les images de la vidéo.
Type : Positionel
Paramètres (obligatoire) : Image|Position
Image:
Position:
Exemple : >Logo=monLogo.png|-10,-10,10
- Stop
Arrête le traitement du script.
Type : Positionel
Paramètre (obligatoire) : toujours 1
Exemple : >Stop=1
- Skip
Saute (ignore) une partie du script (utile pour ne travailler que sur une partie d'une vidéo).
Type: Positionnel
Paramètre (obligatoire) : 1: les commandes de script suivantes sont ignorées. 0: SMB reprend l'interprétation des commandes.
Exemple:
Image_1.jpg
>Skip=1
Image_2.jpg
Image_3.jpg
>Skip=0
Les images image n°2 et 3 seront ignorées.
- MergeFrames
Fusionne chaque image de la vidéo avec celle qui précède (expérimental).
Type : Positionel
Paramètre (obligatoire) : facteur de fusion variant de 0 (pas de fusion) à 255 (image précédente complète).
Exemple : >MergeFrames=128
- Debug
Commande utilisée pour positionner différents indicateurs de test et debug (expérimental).
Type : Global
Paramètre (obligatoire) : indicateurs :
X: imprime sur les images générées différentes informations de debug.
T: liste les transitions disponibles.
W: désactive l'avertissement quand le fichier vidéo de sortie va être écrasé.
Exemple : >Debug=XW
List of available Convert modes
0 | Anaglyphe N&B à utiliser avec des lunettes Rouge / Vert |
1 | Anaglyphe N&B à utiliser avec des lunettes Rouge / Bleue |
2 | Anaglyphe en pseudo-couleurs à utiliser avec des lunettes Rouge / Cyan |
3 | Image entrelacée horizontalement (gauche en premier) |
4 | Image entrelacée horizontalement (droite en premier) |
5 | Anaglyphe N&B à utiliser avec des lunettes Rouge / Cyan |
6 | Anaglyphe en pseudo-couleurs à utiliser avec des lunettes Jaune / Bleue |
7 | Comme 2 mais le canal rouge de l'image droite est utilisé pour le canal vert |
8 | Image entrelacée verticalement (gauche en premier) |
9 | Image entrelacée verticalement (droite en premier) |
10 | Anaglyphe demi-couleur à utiliser avec des lunettes Rouge / Cyan |
11 | Anaglyphe en pseudo-couleurs à utiliser avec des lunettes Vert / Magenta ou LCD polarisé |
12 | Anaglyphe Rouge / Cyan utilisant la formule de Eric Dubois |
15 | Anaglyphe Rouge / Cyan utilisant partiellement la méthode Imre-Dub |
16 | Anaglyphe demi-couleur à utiliser avec des lunettes Jaune / Bleue |
19 | Conversion en monoscopie (prend la partie gauche ou droite de la paire stéréo en fonction de la commande Transpose). |
20 | Côte à côte, demie largeur (compression horizontale). |
Liste des effets de transistion disponibles
Les transitions utilisées dans StereoMovieBuilder sont celles de Microsoft Internet Explorer.
La plupart peut être utilisée par StereoMovieBuilder :
Fade, Barn, Blinds, CheckerBoard, GradientWipe, Inset, Iris, Pixelate, RadialWipe, RandomBars,
RandomDisolve, RevealTrans, Slide, Spiral, Stretch, Strips, Wheel, Wipe, ZigZag
Limitations de la présente version
- Seul le format AVI est disponible comme format pour les vidéos produites.
- La commande Logo n'est pas implémentés.
Versions
- v0.1 (Nov-2008) : Version initiale.
- v0.2 (Nov-2008) : Ajout de la commande Video.
Ajout du mode de conversion 19 pour construire une vidéo mono à partir d'images stéréo.
- v0.2.4 (Fév-2009) : Ajout du mode de conversion 20 pour du côte à côte demie largeur.
- v0.2.5 (Fév-2009) : Ajout de la commande Text.
- v0.3 (Août-2010) : Ajout des commandes Crop, Background.
Exemples
1) Construit une vidéo anaglyphique réduite (640x480, mode 12) à partir d'images côte à côte en mode (nous devons donc transposer chaque image).
La vidéo restera 2s sur la première image (répétée 48 fois) puis montrera chacune des images suivante sur une seule trame de la vidéo jusqu'au titre de fon (montré 6s) qu'on
va chercher dans le sous-dossier Titres.
>Path=C:\Program Files\POV-Ray for Windows v3.5\Misc\AnimB
>Resize=1280x480
>Convert=12
>Transpose=1
>FrameRate=24
AnimB000.png *2
AnimB001.png
AnimB002.png
AnimB003.png
AnimB004.png
...
Titres\Titre_Fin.png *6
2) Utilisation d'un effet de transition : on démarre avec un écran noir pendant 1/2s puis on arrive par un fondu lent de 4s sur la première image qui est alors
affichée pendant 1/2s et fondu sur l'image suivante. En poursuit avec une série d'image, en commençant avec l'image nommée
MP_scenesG002.png puis en cherchant les images MP_scenesG003.png, MP_scenesG004.png,...
...
>Frame=Black|0.5
>Transition=Fade|4
MP_scenesG000.png *0.5
>Transition=Fade|1
MP_scenesG001.png *1.5
>Sequence=MP_scenesG[3].png|2
...
3) Utilisation de transitions et des effets Ken Burns.
MN2008_130_X.jps
; Fondu de l'image 130 vers une partie zoomée de l'image 589
>Transition=Fade|1
; On continue par un effet Ken Burns effects : panoramque horizontal lent sur l'image 589.
>KBE=MN2008_589_X.jps|198,383,667,-100,0.5|1882,370,667,-100,0.5|24
; Après le panoramique, on efectue un lent zoom arrière pour découvrir l'image complète.
; Notez que le Rect_Initial de ce KBE est le même que le Rect_Cible du KBE précédent pour que les effets s'enchaînent sans à coup.
>KBE=MN2008_589_X.jps|1882,370,667,-100,0.5|0,0,0,0,2|6
Copyright © DigitalMatrix, 2008-10