video.py

video.py es un programa para consola escrito en Python 2.7 que dirige la creación de vídeos a partir de fotos.
Está inspirado en el programa diascope, aunque tiene menos opciones que él.
La creación real del vídeo corresponde a avconv; video.py muestra en pantalla una propuesta de orden para invocar avconv, pero el usuario puede usar sus propias órdenes.
La generación de los distintos efectos a partir de las fotos originales la hace ImageMagick; video.py se encarga de todas las órdenes necesarias para invocar a ImageMagick.
La definición del vídeo se escribe en un archivo de texto plano, con cualquier extensión.

Índice del resto de la página

Desde aquí puedes saltar a cualquiera de los puntos de la página indicados a continuación.

Invocación del programa
Parámetros del archivo
Acciones
Generación de imágenes
Movimiento
Transiciones
Efectos
- difuminar
- bn
Descarga
Instalación
Utilización
Notas personales

Invocación del programa

Si el programa se invoca sin parámetros, ofrece una pequeña explicación de su uso.
El programa se invoca añadiendo como parámetro el nombre del archivo con la descripción y las opciones deseadas.
La opción -i muestra la información obtenida del archivo de definición del vídeo.
La opción -c revisa la correcta sintáxis del archivo de definición del vídeo.
La opción -g genera las imágenes necesarias para montar el vídeo.
La opción -o muestra las opciones propuesta para invocar avconv.
La opción -t realiza todas las operaciones anteriores.

Parámetros del archivo

En el archivo se deben especificar tres valores:

fps: es el número de cuadros por segundo que tendrá el vídeo (frames per second).
anchura: es el número de píxeles de anchura que tendrá el vídeo.
altura: es el número de píxeles de altura que tendrá el vídeo.

Acciones

En el archivo se escribe en cada línea una acción que define qué se debe añadir al vídeo. El tipo de acción puede ser:

imagen: aparece durante el tiempo especificado una imagen fija.
movimiento: se produce un movimiento a partir de un archivo.
transición: se produce una transición entre dos imágenes.
efecto: se produce gradualmente un efecto en una imagen.

Todas las acciones se identifican con claves de cuatro letras. A continuación de la clave se escribe el tiempo que debe actuar, en segundos con decimales.

Generación de imágenes

Es posible añadir imágenes en un vídeo con tres acciones:

colo: se genera una imagen de un color determinado y con las dimensiones del vídeo. [colo]
foto: se mantiene en el vídeo una foto que tiene exactamente las dimensiones del vídeo. [foto]
troz: se genera una imagen con las dimensiones del vídeo a partir de una imagen original que puede tener dimensiones diferentes. [troz]

Movimiento

La acción que define un movimiento es movi.
Para definir un movimiento hay que especificar el trozo inicial y el trozo final. [movi]
Los movimientos no se detienen ni en la imagen inicial ni en la imagen inicial, por lo que no admiten transiciones. Por eso, es habitual usar un movimiento poniendo como acciones anterior y posterior los trozos inicial y final que lo definen. [movitroz]

Transiciones

La acción que define una transición es tran.
Las transiciones se realizan entre la imagen anterior y la siguiente, que deber ser las acciones que la rodeen.
Cada transición tiene un nombre y algunas de ellas admiten parámetros para definir sus comportamientos, aunque siempre se pueden dejar sin parámetros y se adoptará un valor por defecto.
Si por cualquier motivo el programa interrumpe su ejecución mientras se están calculando las imágenes de una transición, la siguiente ejecución del programa volverá a generarlas todas.

Transición mezcla

Se realiza el paso de la imagen anterior a la siguiente por medio de una trasparencia de modo que las dos imágenes se ven completas y a la vez, mezcladas, cada una con una proporción distinta. [mezcla]
Esta transición no admite parámetros.

Transición mancha

En un punto de la imagen anterior aparece una mancha de forma irregular que se va extendiendo dejando ver la imagen siguiente. La mancha se extiende aleatoriamente hasta que se ve completa la imagen siguiente.
Esta transición admite un primer parámetro, que indica el punto en el que aparece la mancha. A continuación se explican las posibilidades:
a: la mancha aparece en un punto aleatorio que no está ni en los bordes ni en el centro. Este es el valor por defecto del parámetro. [mancha]
c: la mancha aparece en el centro.
n: la mancha aparece en el norte (el centro del lado superior).
s: la mancha aparece en el sur (el centro del lado inferior).
o: la mancha aparece en el oeste (el centro del lado izquierdo).
e: la mancha aparece en el este (el centro del lado derecho).
no: la mancha aparece en el noroeste (la esquina superior izquierda).
ne: la mancha aparece en el noreste (la esquina superior derecha).
so: la mancha aparece en el suroeste (la esquina inferior izquierda).
se: la mancha aparece en el sureste (la esquina inferior derecha).
La transición admite un segundo parámetro, opcional, que indica el tamaño en píxeles que usarán los cuadrados que constituyen la unidad mínima de mancha. El valor por defecto es 1; pero con este valor el tiempo de cálculo puede ser muy elevado, así que aconsejo comenzar por valores mayores e ir probando. [mancha c 2] [mancha no 6]

Transición luz

Se realiza el paso de la imagen anterior a la siguiente comenzando por las partes más luminosas y terminando por las más oscuras. [luz]
Esta transición no admite parámetros.

Transición cortina

Se realiza el paso de la imagen anterior a la siguiente por medio de una cortina que se desplaza de un lado a otro. Las imágenes siempre se mantienen en su sitio, lo único que se desplaza es la propia cortina.
Esta transición admite un parámetro, que indica el movimiento de la cortina. A continuación se explican las cuatro posibilidades:
ns: la cortina de desplaza desde el norte (el lado superior) hasta el sur (el lado inferior). Este es el valor por defecto del parámetro. [cortina ns]
sn: la cortina de desplaza desde el sur (el lado inferior) hasta el norte (el lado superior). [cortina sn]
oe: la cortina de desplaza desde el oeste (el lado izquierdo) hasta el este (el lado derecho). [cortina oe]
eo: la cortina de desplaza desde el este (el lado derecho) hasta el oeste (el lado izquierdo). [cortina eo]

Transición abanico

Se realiza el paso de la imagen anterior a la siguiente por medio de un abanico que gira cubriendo la imagen completa. Las imágenes siempre se mantienen en su sitio, lo único que se desplaza es el propio abanico.
Esta transición admite un parámetro, que indica el vértice del abanico. A continuación se explican las nueve posibilidades:
c: el vértice del abanico es el centro de la imagen Este es el valor por defecto del parámetro. [abanico c]
no: el vértice del abanico es el vértice superior izquierdo. [abanico no]
ne: el vértice del abanico es el vértice inferior izquierdo. [abanico ne]
so: el vértice del abanico es el vértice superior derecho. [abanico so]
se: el vértice del abanico es el vértice inferior derecho. [abanico se]
n: el vértice del abanico es el punto central del borde superior. [abanico n]
s: el vértice del abanico es el punto central del borde inferior. [abanico s]
o: el vértice del abanico es el punto central del borde izquierdo. [abanico o]
e: el vértice del abanico es el punto central del borde derecho. [abanico e]
Esta transición admite como segundo parámetro el número de zonas en las que debe haber abanicos; si no se espefidica, se usa solo una zona. Si se desea usar este parámetro, es imprescindible especificar el anterior. [abanico c 4] [abanico n 3] [abanico s 5] [abanico so 2]
También admite como tercer parámetro el sentido de giro, con las palabras pos para el positivo y neg para el negativo. Si no se especifica, se usa el sentido positivo. Si se desea usar este parámetro, es imprescindible especificar los dos parámetros anteriores. [abanico c 1 neg] [abanico s 2 neg]

Transición bandasvert

Se realiza el paso de la imagen anterior a la siguiente por medio de varias cortinas verticales que se desplazan de un lado a otro alternativamente dibujando columnas. Las imágenes siempre se mantienen en su sitio, lo único que se desplaza son las propias cortinas.
Esta transición admite un primer parámetro, que indica el movimiento de la cortina del extremo izquierdo. A continuación se explican las posibilidades:
ns: la primera cortina de desplaza desde el norte (el lado superior) hasta el sur (el lado inferior). Este es el valor por defecto del parámetro. [bandasvert ns]
sn: la primera cortina de desplaza desde el sur (el lado inferior) hasta el norte (el lado superior). [bandasvert sn]
oe: todas las cortinas de desplazan desde el oeste (el lado izquierdo) hasta el este (el lado derecho). [bandasvert oe]
eo: todas las cortinas de desplazan desde el este (el lado derecho) hasta el oeste (el lado izquierdo). [bandasvert eo]
La transición espera un segundo parámetro que indica el número de bandas que se desea usar. Si no se especifica, se usará solo una banda.

Transición bandashori

Se realiza el paso de la imagen anterior a la siguiente por medio de varias cortinas horizontales que se desplazan de un lado a otro alternativamente dibujando columnas. Las imágenes siempre se mantienen en su sitio, lo único que se desplaza son las propias cortinas.
Esta transición admite un primer parámetro, que indica el movimiento de la cortina del extremo izquierdo. A continuación se explican las posibilidades:
oe: la primera cortina de desplaza desde el oeste (el lado izquierdo) hasta el este (el lado derecho). Este es el valor por defecto del parámetro. [bandashori oe]
eo: la primera cortina de desplaza desde el este (el lado derecho) hasta el oeste (el lado izquierdo). [bandashori eo]
ns: todas las cortinas de desplazan desde el norte (el lado superior) hasta el sur (el lado inferior). [bandashori ns]
sn: todas las cortinas de desplazan desde el sur (el lado inferior) hasta el norte (el lado superior). [bandashori sn]
La transición espera un segundo parámetro que indica el número de bandas que se desea usar. Si no se especifica, se usará solo una banda.

Transición quitar

La imagen anterior se quita de su sitio dejando ver poco a poco la siguiente.
Esta transición admite un parámetro, que indica el punto o puntos por los que se va quitando la imagen anterior.
s: la imagen anterior se va quitando por el sur (el lado inferior). Este es el valor por defecto del parámetro. [quitar s]
n: la imagen anterior se va quitando por el norte (el lado superior). [quitar n]
e: la imagen anterior se va quitando por el este (el lado derecho). [quitar e]
o: la imagen anterior se va quitando por el oeste (el lado izquierdo). [quitar o]
ne: la imagen anterior se va quitando por el noreste (la esquina superior derecha). [quitar ne]
se: la imagen anterior se va quitando por el sureste (la esquina inferior derecha). [quitar se]
no: la imagen anterior se va quitando por el noroeste (la esquina superior izquierda). [quitar no]
so: la imagen anterior se va quitando por el suroeste (la esquina inferior izquierda). [quitar so]
ns o sn: la imagen anterior se va quitando simultáneamente por el norte (el lado superior) y por el sur (el lado inferior), partiéndose en dos trozos por la mitad. [quitar ns]
eo u oe: la imagen anterior se va quitando simultáneamente por el este (el lado derecho) y por el oeste (el lado derecho), partiéndose en dos trozos por la mitad. [quitar eo]
v: la imagen anterior se va quitando simultáneamente por los cuatro vértices de la imagen (las esquinas), partiéndose en cuatro trozos por el centro. [quitar v]

Transición poner

La imagen siguiente se pone de su sitio tapando poco a poco la anterior.
Esta transición admite un parámetro, que indica el punto o puntos por los que se va poniendo la imagen siguiente.
s: la imagen siguiente se va poniendo por el sur (el lado inferior). Este es el valor por defecto del parámetro. [poner s]
n: la imagen siguiente se va poniendo por el norte (el lado superior). [poner n]
e: la imagen siguiente se va poniendo por el este (el lado derecho). [poner e]
o: la imagen siguiente se va poniendo por el oeste (el lado izquierdo). [poner o]
ne: la imagen siguiente se va poniendo por el noreste (la esquina superior derecha). [poner ne]
se: la imagen siguiente se va poniendo por el sureste (la esquina inferior derecha). [poner se]
no: la imagen siguiente se va poniendo por el noroeste (la esquina superior izquierda). [poner no]
so: la imagen siguiente se va poniendo por el suroeste (la esquina inferior izquierda). [poner so]
ns o sn: la imagen siguiente se va poniendo simultáneamente por el norte (el lado superior) y por el sur (el lado inferior), uniéndose los dos trozos en la mitad. [poner ns]
eo u oe: la imagen siguiente se va poniendo simultáneamente por el este (el lado derecho) y por el oeste (el lado derecho), uniéndose los dos trozos en la mitad. [poner eo]
v: la imagen siguiente se va poniendo simultáneamente por los cuatro vértices de la imagen (las esquinas), uniéndose los cuatro trozos en el centro. [poner v]

Transición empuja

La imagen siguiente empuja a la imagen anterior hasta que la saca de cuadro.
Esta transición admite un parámetro, que indica el sentido en que la imagen siguiente empuja a la anterior. A continuación se explican las cuatro posibilidades:
ns: la imagen siguiente empuja a la anterior desde el norte (el lado superior) hacia el sur (el lado inferior). Este es el valor por defecto del parámetro. [empuja ns]
sn: la imagen siguiente empuja a la anterior desde el sur (el lado inferior) hacia el norte (el lado superior). [empuja sn]
oe: la imagen siguiente empuja a la anterior desde el oeste (el lado izquierdo) hacia el este (el lado derecho). [empuja oe]
eo: la imagen siguiente empuja a la anterior desde el este (el lado derecho) hacia el oeste (el lado izquierdo). [empuja eo]

Transición rectangulo

Se realiza el paso de la imagen anterior a la siguiente por medio de un rectángulo que cambia de tamaño. Las imágenes siempre se mantienen en su sitio, lo único que se modifica es el tamaño del rectángulo.
Esta transición admite un parámetro, que indica la dirección de la aparición de la imagen siguiente. A continuación se explican las dos posibilidades:
df: la imagen siguiente aparece en un rectángulo desde dentro hacia fuera. Este es el valor por defecto del parámetro. [rectangulo df]
fd: la imagen siguiente aparece en un rectángulo desde fuera hacia dentro. [rectangulo fd]

Transición aparece

En esta transición la imagen siguiente aparece muy pequeña en un punto determinado y va creciendo de tamaño hasta ocupar la pantalla completa. La imagen anterior siempre queda por debajo, inalterada.
Esta transición admite un parámetro, que indica el punto en el que aparece la imagen siguiente. A continuación se explican las nueve posibilidades:
c: la imagen siguiente aparece en el centro. Este es el valor por defecto del parámetro. [aparece c]
n: la imagen siguiente aparece en el norte (el centro del lado superior). [aparece n]
s: la imagen siguiente aparece en el sur (el centro del lado inferior). [aparece s]
o: la imagen siguiente aparece en el oeste (el centro del lado izquierdo). [aparece o]
e: la imagen siguiente aparece en el este (el centro del lado derecho). [aparece e]
no: la imagen siguiente aparece en el noroeste (la esquina superior izquierda). [aparece no]
ne: la imagen siguiente aparece en el noreste (la esquina superior derecha). [aparece ne]
so: la imagen siguiente aparece en el suroeste (la esquina inferior izquierda). [aparece so]
se: la imagen siguiente aparece en el sureste (la esquina inferior derecha). [aparece se]

Transición desaparece

En esta transición la imagen anterior va reduciendo su tamaño poco a poco hasta que desaparece por un punto mientras se va viendo cada vez más parte de la imagen siguiente.
Esta transición admite un parámetro, que indica el punto en el que desaparece la imagen anterior. A continuación se explican las nueve posibilidades:
c: la imagen anterior desaparece por el centro. Este es el valor por defecto del parámetro. [desaparece c]
n: la imagen anterior desaparece en el norte (el centro del lado superior). [desaparece n]
s: la imagen anterior desaparece en el sur (el centro del lado inferior). [desaparece s]
o: la imagen anterior desaparece en el oeste (el centro del lado izquierdo). [desaparece o]
e: la imagen anterior desaparece en el este (el centro del lado derecho). [desaparece e]
no: la imagen anterior desaparece en el noroeste (la esquina superior izquierda). [desaparece no]
ne: la imagen anterior desaparece en el noreste (la esquina superior derecha). [desaparece ne]
so: la imagen anterior desaparece en el suroeste (la esquina inferior izquierda). [desaparece so]
se: la imagen anterior desaparece en el sureste (la esquina inferior derecha). [desaparece se]

Transición aleatorio

Se realiza el paso de la imagen anterior a la siguiente por medio de cuadrados que pueden mostrar aleatoriamente la imagen anterior o la siguiente, pero según avanza la transición es cada vez más probable que muestre la siguiente.
Esta transición admite como parámetro el tamaño en píxeles del lado de cada cuadrado. [aleatorio]
Si no se le pasa ningún parámetro, se formarán por defecto los cuadrados de un píxel de lado, convirtiéndose así cada cuadrado en un píxel individual.

Transición mosaico

Se realiza el paso de la imagen anterior a la siguiente por medio de cuadrados que pasan a mostrar la imagen siguiente. El orden de cambio es aleatorio.
Esta transición admite como parámetro el tamaño en píxeles del lado de cada cuadrado. [mosaico 50]
Si no se le pasa este segundo parámetro, se formarán por defecto los cuadrados de un píxel de lado, convirtiéndose así cada cuadrado en un píxel individual. [mosaico 0]

Transición cascada

Se realiza el paso de la imagen anterior a la siguiente por medio de cuadrados que pasan a mostrar la imagen siguiente comenzando por un extremo de la imagen y acabando por el opuesto, pero con una ligera aleatoriedad.
Esta transición admite como segundo parámetro el tamaño en píxeles del lado de cada cuadrado.
Si no se le pasa este segundo parámetro, se formarán por defecto los cuadrados de un píxel de lado, convirtiéndose así cada cuadrado en un píxel individual.
Si se desea utilizar este segundo parámetro, es obligatorio escribir el primero.
Esta transición admite un primer parámetro, que indica el punto por el que comienza el cambio y el punto por el que termina. Hay ocho posibilidades:
ns: el cambio empieza por el norte (el lado superior) y termina por el sur (el lado inferior). Este es el valor por defecto del parámetro. [cascada ns 10] [cascada ns 0]
sn: el cambio empieza por el sur (el lado inferior) y termina por el norte (el lado superior). [cascada sn 10] [cascada sn 0]
oe: el cambio empieza por el oeste (el lado izquierdo) y termina por el este (el lado derecho). [cascada oe 10] [cascada oe 0]
eo: el cambio empieza por el este (el lado derecho) y termina por el oeste (el lado izquierdo). [cascada eo 10] [cascada eo 0]
nose: el cambio empieza por el noroeste (la esquina superior izquierda) y termina por el sureste (la esquina inferior derecha). [cascada nose 10] [cascada nose 0]
seno: el cambio empieza por el sureste (la esquina inferior derecha) y termina por el noroeste (la esquina superior izquierda). [cascada seno 10] [cascada seno 0]
neso: el cambio empieza por el noreste (la esquina superior derecha) y termina por el suroeste (la esquina inferior izquierda). [cascada neso 10] [cascada neso 0]
sone: el cambio empieza por el suroeste (la esquina inferior izquierda) y termina por el noreste (la esquina superior derecha). [cascada sone 10] [cascada sone 0]

Transición cuadrados

Se realiza el paso de la imagen anterior a la siguiente por medio de cuadrados repartidos uniformemente que van creciendo mostrando cada vez una parte mayor de la imagen siguiente.
Como primer parámetro se puede elegir entre dos opciones.
df: La imagen siguiente va apareciendo desde la parte de dentro de cada cuadrado hacia fuera. Este es el valor por defecto del parámetro. [cuadrados df]
fd: La imagen siguiente va apareciendo desde la parte de fuera de cada cuadrado hacia dentro. [cuadrados fd]
Se puede especificar como segundo parámetro el tamaño en píxeles del lado de cada cuadrado. [cuadrados 75]
Si no se le pasa ningún valor como segundo parámetro, se formarán por defecto los cuadrados del mayor tamaño posible que admitan las dimensiones del vídeo.

Transición circulos

Se realiza el paso de la imagen anterior a la siguiente por medio de círculos repartidos uniformemente que van creciendo mostrando cada vez una parte mayor de la imagen siguiente.
Como primer parámetro se puede elegir entre dos opciones.
df: La imagen siguiente va apareciendo desde la parte de dentro de cada círculo hacia fuera. Este es el valor por defecto del parámetro. [circulos df]
fd: La imagen siguiente va apareciendo desde la parte de fuera de cada círculo hacia dentro. [circulos fd]
Se puede especificar como segundo parámetro el tamaño en píxeles del lado de los cuadrados que circunscriben a los círculos [circulos 75]
Si no se le pasa ningún valor como segundo parámetro, se formarán por defecto los círculos del mayor tamaño posible que admitan las dimensiones del vídeo.

Transición triangulo

Se realiza el paso de la imagen anterior a la siguiente por medio de un triángulo que va recorriendo la superficie sustituyendo la imagen anterior por la siguiente.
Esta transición admite un primer parámetro, que indica el punto por el que comienza el cambio y el punto por el que termina. Hay ocho posibilidades:
oe: el cambio empieza por el oeste (el lado izquierdo) y termina por el este (el lado derecho). Este es el valor por defecto del parámetro. [triangulo]
eo: el cambio empieza por el este (el lado derecho) y termina por el oeste (el lado izquierdo).
ns: el cambio empieza por el norte (el lado superior) y termina por el sur (el lado inferior).
sn: el cambio empieza por el sur (el lado inferior) y termina por el norte (el lado superior). [triangulo sn]
Se puede especificar como segundo parámetro el ángulo del vértice que va abriendo camino. El valor por defecto es 90 grados. [triangulo eo 45]

Transición uves

Se realiza el paso de la imagen anterior a la siguiente mediante una sucesión de uves que recorren distintas partes de la imagen en tres fases.
Esta transición admite un parámetro, que indica el punto por el que comienza el cambio y el punto por el que termina. Hay cuatro posibilidades:
oe: el cambio empieza por el oeste (el lado izquierdo) y termina por el este (el lado derecho). Este es el valor por defecto del parámetro. [uves]
eo: el cambio empieza por el este (el lado derecho) y termina por el oeste (el lado izquierdo).
ns: el cambio empieza por el norte (el lado superior) y termina por el sur (el lado inferior). [uves ns]
sn: el cambio empieza por el sur (el lado inferior) y termina por el norte (el lado superior).

Transición peano

Esta transición se llama así en honor a la curva de Peano, que consiste en una curva que llena completamente un rectángulo. Las curvas de Peano normalmente presentan algún tipo de simetría, pero las de esta transición son aleatorias.
El cálculo de la transición es laborioso y no dura un tiempo determinado, por lo que para ser más eficiente está programado en C y requiere una instalación adicional que se explica más abajo.
Una línea que recorre toda la imagen va haciendo aparecer la imagen siguiente, hasta que aparece completa. Yo solo he llegado hasta líneas de 54 cuadrados, y puede tardar algunos segundos en un i5. A partir de esos valores, habría que ver caso a caso hasta qué longitud se puede llegar en un tiempo razonable.
El primer parámetro es el tamaño de los cuadrados que formarán la línea; si no se le pasa ningún valor, o el valor 0, se formarán los cuadrados del mayor tamaño posible que admitan las dimensiones del vídeo.
Como segundo parámetro se puede elegir el punto en que debe comenzar la línea, con las opciones ya habituales en otras transiciones del programa de no, n, ne, o, c, e, so, s y se. Si no se especifica el parámetro, se toma como valor por defecto no. Si se desea usar este segundo parámetro, es obligatorio usar el primero.
Ejemplos: [peano 50] [peano 50 c] [peano 0 n]

Transición dosrec

El nombre de esta transición proviene de dos rectángulos, ya que se divide la imagen verticalmente en dos rectángulos.
A cada rectángulo se le puede aplicar una transición diferente, dentro de una selección de las transiciones disponibles.
El primer parámetro, opcional, indica la anchura en píxeles del rectángulo izquierdo. Si no se usa, la imagen se divide en dos rectángulos de la misma anchura.
Los dos parámetros siguientes, opcionales, indican las transiciones que hay que aplicar al rectángulo izquierdo (segundo parámetro) y al rectángulo derecho (tercer parámetro). Si se omite alguno de ellos, se toma como valor por defecto rec-df.
Los valores que admiten estos dos últimos parámetros se explican en Transiciones de dosrec, dosban y dosdia.
Ejemplos: [dosrec] [dosrec mez mos] [dosrec cor aba] [dosrec qui pon] [dosrec apa des] [dosrec cas]

Transición dosban

El nombre de esta transición proviene de dos bandas, ya que se divide la imagen horizontalmente en dos bandas.
A cada banda se le puede aplicar una transición diferente, dentro de una selección de las transiciones disponibles.
El primer parámetro, opcional, indica la anchura en píxeles de la banda superior. Si no se usa, la imagen se divide en dos bandas de la misma altura.
Los dos parámetros siguientes, opcionales, indican las transiciones que hay que aplicar a la banda superior (segundo parámetro) y a la banda inferior (tercer parámetro). Si se omite alguno de ellos, se toma como valor por defecto rec-df.
Los valores que admiten estos dos últimos parámetros se explican en Transiciones de dosrec, dosban y dosdia.
Ejemplos: [dosban] [dosban mez mos] [dosban cor aba] [dosban qui pon] [dosban apa des] [dosban cas]

Transición dosdia

El nombre de esta transición proviene de dos diagonales, ya que se divide la imagen diagonalmente en cuatro cuadrantes. Se aplica al segundo cuadrante (superior izquierdo) y al cuarto cuadrante (inferior derecho) la misma transición y al primer cuadrante (superior derecho) y el tercer cuadrante (inferior izquierdo) la misma transición, que puede ser la misma que la anterior.
A cada diagonal se le puede aplicar una transición diferente, dentro de una selección de las transiciones disponibles.
Los dos parámetros opcionales, opcionales, indican las transiciones que hay que aplicar a los cuadrantes segundo y cuarto (primer parámetro) y a los cuadrantes primero y tercero (segundo parámetro). Si se omite alguno de ellos, se toma como valor por defecto rec-df.
Los valores que admiten estos dos últimos parámetros se explican en Transiciones de dosrec, dosban y dosdia.
Ejemplos: [dosdia] [dosdia cor] [dosdia aba] [dosdia cua cir] [dosdia bh bv]

Transiciones de dosrec, dosban y dosdia

aba-c, aba-no, aba-ne, aba-so, aba-se, aba-n, aba-s, aba-e, aba-o: las transiciones abanico, usadas con una sola zona y con sentido positivo de giro.
aleatorio: la transición aleatorio con tamaño de cuadrado de cuatro píxeles.
apa-c, apa-n, apa-s, apa-o, apa-e, apa-no, apa-ne, apa-so, apa-se: las transiciones aparece.
bh-ns, bh-sn, bh-oe, bh-eo: las transiciones bandashori con dos bandas
bv-ns, bv-sn, bv-oe, bv-eo: las transiciones bandasvert con dos bandas
cas-ns, cas-sn, cas-oe, cas-eo, cas-nose, cas-seno, cas-neso, cas-sone: las transiciones cascada, usadas con tamaño de cuadrado de cuatro píxeles.
cir-df, cir-fd: las dos transiciones de círculos
cor-ns, cor-sn, cor-eo, cor-oe: las transiciones cortina.
cua-df, cua-fd: las dos transiciones de cuadrados
des-c, des-n, des-s, des-o, des-e, des-no, des-ne, des-so, des-se: las transiciones desaparece.
emp-ns, emp-sn, emp-oe, emp-eo: las transiciones empuja.
luz
man-a, man-c, man-n, man-s, man-o, man-e, man-no, man-ne, man-so y man-se: las transiciones mancha, con un tamaño de dos píxeles
mezcla
mosaico: la transición mosaico con tamaño de cuadrado de cuatro píxeles.
pon-s, pon-n, pon-e, pon-o, pon-se, pon-ne, pon-so, pon-no, pon-ns, pon-sn, pon-eo, pon-oe, pon-v: las transiciones poner.
qui-s, qui-n, qui-e, qui-o, qui-se, qui-ne, qui-so, qui-no, qui-ns, qui-sn, qui-eo, qui-oe, qui-v: las transiciones quitar.
rec-df, rec-fd: las dos transiciones de rectángulo
tri-ns, tri-sn, tri-eo, tri-oe: las transiciones triangulo.
uves-ns, uves-sn, uves-eo, uves-oe: las transiciones uves con un ángulo de 90 grados.

Efectos

La acción que define un efecto es efec.
Cada efecto requiere un primer parámetro que indica la duración total en pantalla del efecto.
Cada efecto requiere un segundo parámetro que indica el archivo de imagen que va a recibir el efecto.
Cada efecto requiere un tercer parámetro que indica el nombre del efecto que se va a emplear.
Cada efecto puede tener opcionalmente un cuarto parámetro que indica si el efecto se aplicará de forma directa (desde la imagen hasta el efecto aplicado al máximo) o inversa. Se expresa como d o i. El valor por defecto de este parámetro es d.
Opcionalmente, se puede añadir un quinto parámetro que indica los tiempos que deben permanecer las imágenes inicial y final en pantalla. Los tiempos se escriben separados con un guión, pueden llevar decimales, su suma no puede ser mayor que el tiempo total otorgado al efecto y cualquiera de los tiempos puede ser cero. Se se desea utilizar este quinto parámetro, es obligatorio escribir el cuarto. El valor por defecto de este parámetro es 0-0.
Los efectos admiten tener transiciones delante o detrás, ya que se usará la imagen inicial o final del efecto para crear la transición, aunque se haya definido tiempo cero para alguna de ellas.

Efecto difuminar

En modo directo, la imagen se va difuminado cada vez más y llega un momento en que apenas se distingue nada. [difuminar d]
En modo inverso, aparece una mancha borrosa y poco a poco se va convirtiendo en la imagen precisa. [difuminar i]

Efecto bn

En modo directo, la imagen va perdiendo color hasta que se convierte en una imagen en blanco y negro. [bn d]
En modo inverso, aparece una imagen en blanco y negro que va tomando color hasta convertirse en la imagen original. [bn i]

Descarga

El programa se entrega sin ninguna garantía de funcionamiento correcto. Úsalo bajo tu responsabilidad.
El programa va obteniendo nuevas versiones según lo voy desarrollando, pero no sigo la historia de las versiones. Al ejecutar el programa se ve el número de versión, que es la fecha en que lo escribí, en formato ISO.
El programa se ha desarrollado, probado y utilizado exclusivamente con el sistema operativo Debian GNU/Linux 7; en ningún momento se ha tomado en consideración el uso de ningún otro sistema operativo.
El programa se entrega con licencia Dominio público.
Si todo lo anterior no te ha quitado las ganas de descargar el programa, pues aquí lo tienes: video.py.
Si deseas usar la transición peano debes descargar el archivo peano.c y compilarlo con la orden

gcc -o peano peano.c

Instalación

Para que el programa arranque no es necesario instalarlo, basta que tenga permisos de ejecución e invocarlo con el camino (path) completo hasta llegar a él. Si se copia en algún directorio que ya esté incluido en el PATH, solo será necesario invocarlo con su nombre.
Para que el programa funcione es necesario que estén instalados Python 2.7 y ImageMagick.
Para usar la transición peano hay que especificar en el código del programa video.py la ruta al ejecutable que creaste al compilarlo.
Para generar el vídeo es necesario disponer de avconv.

Utilización

Se crea un directorio vacío para contener todos los archivos del proyecto.
Se copian al directorio todas las fotos que se vayan a usar con las acciones foto o efec; deben estar en formato PNG y tener exactamente las dimensiones del vídeo.
Se copian al directorio todas las fotos que se vayan a usar con las acciones movi o troz; pueden estar en cualquier formato que admita ImageMagick y pueden tener cualquier dimensión.
Con un editor de textos se crea el archivo con los tres parámetros obligatorios y todas las acciones deseadas. Puede tener cualquier extensión; yo uso vid.
Si el primer carácter no blanco de una línea del archivo es el carácter almohadilla ('#'), la línea se considera un comentario y no se tiene en cuenta para la definición del vídeo.
Se ejecuta el programa con el nombre del archivo como parámetro; si hay errores, el programa informa de ellos; si no hay errores, el parámetro -i es útil para ver toda la información que se puede recoger del archivo de texto. Si no hay errores y no se ha usado el parámetro -i, se generan todas las imágenes necesarias para crear el vídeo, todas dentro de un directorio dentro del directorio del proyecto, que tendrá el nombre sin extensión del archivo de texto.
Si se modifica el archivo de texto y se vuelve a invocar el programa, solo se recalcularán las modificaciones que haya habido. Si se desea realizar todo partiendo de cero, es imprescindible eliminar a mano completamente el directorio de trabajo generado.

Notas personales

¿Por qué escribir un programa que hace lo mismo que cientos de programas más, incluso existiendo ya uno que trabaja desde la línea de órdenes a partir de un archivo de texto? Para aprender, para divertirme y para tener más control.
Todo comenzó cuando compré una cámara de fotos nueva, un cuerpo de Canon 70D. Esta cámara graba vídeos en FullHD con buena calidad. Me animé a hacer uno. Previendo la posibilidad de que en un futuro grabe vídeos de ayuda a estudiantes de matemáticas de enseñanza media, hice una cuenta en vimeo.com y lo subí.
A los pocos días me llegó un intervalómetro que había encargado por Internet. Había pensado la posibilidad de programarlo yo mismo con un Arduino o con un microprocesador ATmega, pero al final desistí y me fui por el camino fácil.
Con la nueva cámara y el intervalómetro, me animé a probar a ver si me salía un vídeo uniendo fotos, un vídeo a cámara rápida (en inglés se usa el conocido término timelapse). Efectivamente, con la ayuda de ffmpeg, lo conseguí; y lo subí también a vimeo.com.
En una salida a un bonito pueblo gallego volví a hacer otro vídeo a cámara rápida, pero esta vez lo acompañé de música con licencia libre que para mi agradable sorpresa pude encontrar en Internet.
Así las cosas, dada mi afición a la fotografía, me animé a hacer un vídeo con unas cuantas fotos tomadas en una salida para disfrutar de la nueva cámara. Era muy simple, no tenía transiciones, solo las fotos una tras otra.
Entonces se me ocurrió pensar que quizá ya alguien habría unido avconv con llamadas por línea de órdenes para generar vídeos con más posibilidades. Encontré diascope, que me encantó, y lo usé para mi siguente vídeo, este ya con un tipo de transición.
Cuando vi las ideas que usaba diascope para generar los vídeos, descubrí una gran oportunidad para mejorar mi nivel de programación en Python. Es esos momentos estaba estudiando varios libros sobre este lenguaje y pensé que escribir yo mismo un programa en Python que aplicara las ideas de diascope me haría mejorar mucho.
En un mes pasé de ser capaz de producir un vídeo básico con una transición a programar dieciocho transiciones (con varios parámetros cada una) y dos efectos. Iba creando nuevos vídeos y programando más ideas en Python simultáneamente. Las dos tareas se complementan bien.
Y el proceso continúa...

Posibilidades para seguir

Volver a la página principal