Renderizado en Batch#

Linea de Comandos#

Hay que situarse en el directorio donde deben estar las fotos, los ficheros *.pair y al menos un fichero de descripciones *.descr, y desde ahí usar el comando gen-render.py:

python3 gen-render.py <Fichero>.descr -PIX <Prescr. Tamaño> -DISP <Prescr. Disparidad> [Otras opciones]
python3 gen-render.py <Fichero>.descr -RAT <Prescr. Ratio> -DISP <Prescr. Disparidad> [Otras opciones]
python3 gen-render.py <Fichero>.descr -ESC <Prescr. Escala> -DISP <Prescr. Disparidad> [Otras opciones]

Es necesario suministrar un fichero *.descr y las prescripciones de tamaño y disparidad. El fichero *.descr es un XML que indica al programa qué ficheros *.pair se desean renderizar, qué título tiene cada uno, y algunos datos aplicables cuando se genera un conjunto como una página HTML5 (Título, autor, etc): 

<?xml version="1.0" encoding="utf-8"?>
<presentacion titulo= 'Ejemplo de fichero .descr'
     cabecera= 'Ejemplo'
     pie= 'Autor: A. Fdez. Galaz'
     nombre6= 'STMANI' >

   <pag pair= '20111009_133032_STL_0094_STR_2197' titulo= 'La Gran Dolina' />
   <pag pair= '20131010_150134_IMG_8989_IMG_8990' titulo= 'Alcázar de Segovia' />
   <pag pair= '20140730_181910_DSCF2504' titulo= 'As Veigas' />
   <pag pair= '20160321-132056DSCF50' titulo= 'Valencia,\nJardín Botánico' />
</presentacion>

Hay dos formas de generar el fichero .descr:

  • En la lista de miniaturas de Stmani3 se pueden seleccionar todas las fotos o un subconjunto de ellas, y después dar la orden GEN. DESCR (ver Opciones de Grupo en Manejo de Miniaturas)
  • Con el comando gen-descr.py Este genera un fichero .descr con todos los ficheros .pair que encuentra en el directorio. Si se desea eliminar alguno, o cambiar títulos se puede editar el fichero después.

Prescripciones de Tamaño#

Pueden ser de uno de estos tres tipos:

     -PIX <X>[E|M|F]:<Y>[E|M|F] (pixels)
     -RAT <X>[E|M|F]:<Y>[E|M|F] (ratio)
     -ESC <Escala> (escala)

La siguiente descripción gráfica muestra como se transforma la imagen ideal del Ajuste Angular en una imagen renderizada. Según sea la prescripción de tamaño y el tamaño de imagen original, la imagen generada puede ajustarse exactamente a la pantalla, puede dejar algún espacio vacío, o puede desbordar la pantalla. Notar que:

  • La imagen del Ajuste Angular se muestra sombreada en gris.
  • La imagen generada se muestra con un contorno de líneas gruesas.
  • La pantalla se muestra con un contorno rojo.

-PIX Especifica el tamaño en pixels de cada JPG de la pareja estéreo, o el de medio SBS, o el de cada buffer de un MPO. Debe ir seguida del tamaño en X e Y, donde cada dimensión viene seguida de una letra:

  • "E": "Exacto" La dimensión de salida es fija. La imagen siempre se encoge para adaptarse a esta dimensión. Si ya es menor, se queda como está, salvo que esté activada la opción de ampliar: "-ampl".
  • "F": "Fijo" La dimensión de salida es fija. La imagen se encoge para adaptarse a esta dimensión, excepto cuando:
    - La otra dimensión sea "F" también, en cuyo caso la imagen se encoge lo necesario para que encajen las dos, lo que generalmente produce un espacio vacío - La otra dimensión sea "E" (Exacta), en cuyo caso la imagen puede desbordar la dimensión "F" o no llenarla, dejando un espacio vacío.

  • "M": "Máximo" La dimensión de salida es variable pero sin superar este máximo. - Si la otra dimensión es "M" también, se encoge hasta que ninguna de las dos supere el tamaño respectivo. Al contrario que con las "F", en este caso no se produce ningún espacio vacío. - Si la otra dimensión es "E", esta de "M" se ajusta al tamaño resultante sin espacio vacío, salvo que supere el valor de "M", en cuyo caso se recorta.

    NOTAS:
    - Por defecto la imagen solo puede encoger, no ampliar, excepto con la opción -ampl
    - Los tamaños deben ser números enteros.
    - Solo se admiten estas combinaciones de F, M y E (los valores en pixel son un ejemplo):
         -PIX 700E:800M (típico para generar 1/2 SBS para el visor HTML5)
         -PIX 900E:1200F
         -PIX 900F:1200F
         -PIX 1920F:1080E (típico para una 3DTV con tamaño de imagen justo)
         -PIX 3840M:2160M
         -PIX 800M:480E (típico para el visor de la W3 con tamaño de imagen justo)

-RAT Indica la relación de aspecto de los JPG, o el de medio SBS, o el de cada mitad de un MPO. Cada componente numerador y denominador debe ir seguido de una letra "F", "M" o "E", similar a la opción "-PIX".
Si una de las componentes va seguida de una "E" (Exacto), la otra se recorta si resulta mayor que la proporción. Si resulta menor, depende de su letra:

  • Si lleva la letra "F" genera la imagen con la proporción prescrita dejando un espacio vacío.
  • Si lleva la letra "M" altera la proporción prescrita, ajustando a la de la imagen.
    NOTAS:
  • Los valores de numerador y denominador pueden ser números enteros o reales.
  • Solo se admiten estas combinaciones (los valores numéricos son un ejemplo):
         -RAT 3.0E:4.0M
         -RAT 3E:4F
         -RAT 3F:4F
         -RAT 36F:24E (típico para diapositivas de 36mm)
         -RAT 16M:9E (típico para 3DTV o cualquier visor 16:9 con tamaño de imagen máximo)

-ESC Indica la escala de la foto resultante respecto de la original del Ajuste Angular. Tiene un único valor que es un número real.
EJEMPLOS:
     -ESC 1.0 (fotos resultantes del mismo tamaño que la original)
     -ESC 0.5 (fotos resultantes de mitad de tamaño que la original)

Prescripciones de Disparidad#

-DISP <Lejana>M:<Cercana>M
-DISP <Lejana>E:<Cercana>M

Indican las restricciones de disparidad horizontal para los puntos más lejano y más cercano: Ver descripción gráfica de prescripciones de disparidad

Cada punto tiene un valor numérico de la disparidad como porcentaje de la anchura del visor (incluyendo zonas vacías si las hay), seguido de una letra "M" o "E". Por ejemplo:
     -DISP 6.71M:-2.0M

  • Disparidades positivas significan puntos más lejos que la ventana
  • Disparidades negativas significan puntos más cerca que la ventana
  • La disparidad lejana debe tener una "M" (Máximo) o una "E" (Exacto)
  • La disparidad cercana solo debe tener una "M" (Máximo).
  • Si la disparidad lejana supera su valor máximo, se desplazan las imágenes, hacia dentro. Si es un valor exacto y fuera inferior se desplazan hacia fuera.
  • Si la disparidad cercana es más negativa del valor máximo, se desplazan las imágenes hacia fuera.
  • Si no fuera posible cumplir el límite lejano y el cercano a la vez, se reduce el tamaño de la imagen de salida de forma que cumplan los dos.

EJEMPLOS:
     -DISP 6.71M:-2.0M Lejano: +6.71% max. Cercano: -2% max.
     -DISP 6.71E:-2.0M Lejano: +6.71% exacto Cercano: -2% max.
     -DISP 6.71I:-2.0M Infinito:+6.71% exacto Cercano: -2% max.
     -DISP 100M:-100M Sin restricción (Lejano: +100% max. Cercano: -100% max.)

Otras opciones de tamaño#

Amplificar Imagen#

     -AMPL Permite que la imagen se amplíe (escala > 1), lo que puede ocurrir en las opciones de tamaño "-PIX" si la imagen es menor que el tamaño especificado.

Incremento de Lienzo#

    -INCR <izquierdo>:<derecho>:<interior>:<exterior>:<superior>:<inferior>

No modifican el tamaño de imagen, pero aumentan el tamaño del lienzo desde cada borde de la imagen útil. El área añadida se rellena con negro.
Los valores indican el tamaño del incremento desde cada borde, y pueden ser números enteros o reales.

  • <izquierdo> es el borde izquierdo de las imágenes izquierda y derecha. Lo contrario para <derecho>
  • <interior> es el borde derecho de la imagen izquierda, y el izquierdo de la imagen derecha. Lo contrario para <exterior>
  • <superior>es el borde superior de las imágenes izquierda y derecha. Lo contrario para <inferior>

Las unidades usadas son las mismas de la prescripción de tamaño:
Pixels, si el tamaño se especifica con -PIX
Unidades de aspecto, si el tamaño se especifica con -RAT
NO es compatible con tamaños formato -ESC

Unos ejemplos:
     -pix 900F:1200F -incr 20:40:0:0:0:0 Resulta una imagen de 960x1200 pixels
     -pix 894F:1194F -incr 3:3:0:0:3:3 Resulta una imagen de 900x1200 pixels
     -rat 34F:24E -incr 2.0:2.0:0:0:0:0 Resulta un aspecto de 36:24 (diapositiva de 36mm)""")

Líneas Guía#

     -LINES <izquierdo>:<derecho>:<interior>:<exterior>:<superior>:<inferior>

Dibuja unas líneas, generalmente por fuera de la imagen, pero dentro de la zona aumentada del lienzo (con la opción -INCR). Se pretenden como guías para recortar tarjetas estéreo que se han fabricado a un tamaño mayor que el necesario para el visor.

La posición de las líneas se define de la misma forma que en la opción -INCR, es decir, con referencia al lienzo original (antes del aumento con -INCR):

Los valores negativos la pintarían por dentro, encima de la imagen.
Se pueden inhibir líneas marcándolas con "X" en lugar de un valor numérico.
Las unidades usadas son las mismas de la prescripción de tamaño:
- Pixels, si el tamaño se especifica con -PIX
- Unidades de aspecto, si el tamaño se especifica con -RAT
- NO es compatible con tamaños formato -ESC

Ejemplo:
     -RAT 7.7E:8.0F -INCR 0:0:0:1.3:2.5:2.5 -LINES X:X:X:0.6:1.0:1.5 -SBS
En este ejemplo la prescripción de tamaño genera una imagen útil de relación de aspecto 7.7:8.0 por tanto la pareja estéreo tendría en principio una relación de aspecto de 15.4:8.0
Al incrementar el lienzo en 1.3 en los lados exteriores, 2.5 por arriba y 2.5 por abajo, tenemos un lienzo de aspecto (1.3+15.4+1.3):(2.5+8.0+2.5)= 18:13
Al definir líneas verticales a 0.6 de los lados exteriores, y horizontales 1.0 del borde superior y 1.5 del inferior, se dibuja un rectángulo de aspecto (0.6+15.4+0.6):(1.0+8.0+1.5)= 16.6:10.5 Si la imagen se envía a un servicio de impresión de tamaño 18x13 cm, mostraría un rectángulo guía de 16.6x10.5 cm que ayudaría a cortarla a este tamaño.

Opciones de Salida#

Unir Imágenes#

-SBS    -SBS50    -MPO    -ANA    -OU50    -INTH    -INTV

Si no se selecciona alguna de estas, se generan dos imágenes independientes izquierda y derecha, con un sufijo "_I" o "_D" en cada una.
-SBS Compone una imagen con las originales lado a lado.
-SBS50 Compone una imagen con las originales lado a lado encogidas un 50%.
-MPO Compone las imágenes dentro de un fichero MPO ("Multi Picture Object")
-ANA Compone una imagen en Anaglifo rojo-cían.
-OU50 Compone una imagen con las originales una encima de otra encogidas un 50%.
-INTH Compone una imagen pre-entrelazada horizontal, para ver en monitores 3D pasivos.
-INTV Compone una imagen pre-entrelazada vertical, para ver en monitores 3D pasivos.

Cruzar Imágenes#

-CROSS Pone las imágenes cruzadas (invierte la izquierda con la derecha)
Válido solo con alguna de las opciones de Unir Imágenes
Si no se selecciona, las imágenes se colocan según el modo:
-SBS y -SBS50: izquierda y derecha a izquierda y derecha respectivamente
-MPO: izquierda y derecha en los buffer 0 y 1 respectivamente
-ANA: izquierda color rojo, y derecha color cían
-OU50: izquierda arriba y derecha abajo
-INTH -INTV: izquierda filas (o columnas) pares
       derecha filas (o columnas) impares

Rotar Imágenes#

-CW Gira las imágenes 90° a la derecha.
-CCW Gira las imágenes 90° a la izquierda.
Válido solo con alguna de las opciones de Unir Imágenes

Opciones de Decoración#

Dibujo de Textos#

-TEX Pinta el Título (si está definido en .descr), y textos (si están definidos en .pair) El texto del Título está definido en .descr, pero su posición puede, o no, estar definida en el primer texto del fichero .pair. Si no lo está, se pone en la parte inferior de la ventana con un tamaño por defecto en proporción a la altura de la imagen por defecto.

Dibujo de Márgenes#

-MARG_I <grosor> Pinta un rectángulo de margen interno (parte visible de la imagen renderizada). El rectángulo es de color amarillo. Debe ir seguido del grosor del margen en pixels.

-MARG_E <grosor> Pinta un rectángulo de margen externo (Toda la imagen renderizada). El rectángulo es de color rojo. Debe ir seguido del grosor del margen en pixels.""")

Dibujo de Puntos Homólogos#

-HOMOP (<decimales disparidad horizontal>,<decimales disparidad vertical>) Pinta un círculo sobre cada pareja de puntos homólogos, seguido del valor de disparidad horizontal y/o vertical.
Requiere dos números enteros separados por una coma, el primero define si se escribe disparidad horizontal, y el segundo la vertical. Si alguno es cero inhibe la impresión de la disparidad correspondiente, y si es mayor que cero indica el número de cifras del valor de disparidad.
NOTA: La tupla debe incluir los paréntesis sin espacios. Ejemplos:
-HOMOP (0,0)
-HOMOP (2,0)

Pair & Comando#

Son dos opciones similares, que escriben determinados textos sobre las imágenes:

     -PAIR <posición>:<tamaño letra> Escribe el nombre del fichero .pair
     -COMMD <posición>:<tamaño letra> Escribe la línea de comandos usada

Las dos opciones están pensadas para marcar imágenes estéreo por fuera de su borde (en la zona aumentada con -INCR)

<posición> y <tamaño letra> se definen en las mismas unidades que la prescripción de tamaño:
- Pixels, si el tamaño se especifica con -PIX
- Unidades de aspecto, si el tamaño se especifica con -RAT
- NO es compatible con tamaños formato -ESC

El origen de <posición> es el borde superior de la imagen antes del aumento con -INCR. Si es negativo está por encima, y si es positivo por debajo. Ejemplo:
  -RAT 7.7E:8.0F -INCR 0:0:0:1.3:2.5:2.5 -LINES X:X:X:0.6:1.0:1.5 -SBS -PAIR -0.9:0.2 -COMMD -0.6:0.2

Opciones de Nombre#

Nombre Corto#

-NAME8 Renombra todos los ficheros con 8 caracteres (para compatibilidad con sistemas MS-DOS), compuestos de un prefijo de 6 caracteres seguidos de un número de 2 cifras que incrementa secuencialmente.
El prefijo debe venir indicado en el fichero .descr (atributo "name6")
Si el número de fotos en un directorio exige más de 2 cifras, se trunca el prefijo a 5 y se usa 3 cifras.
Los nombres de ficheros se ponen en mayúsculas, independientemente de como estén definidos en el fichero .descr

Prefijo Numérico#

-IDX Añade un prefijo numérico de 2 ó 3 cifras (según sea necesario) a cada nombre de fichero, que indica el orden en que está el fichero .pair en .descr
Si está presente -NAME8, entonces -IDX no tiene ningún efecto

Prefijo Arbitrario#

-PREFIX <Texto de Prefijo> Añade un prefijo de texto arbitrario al comienzo del nombre de la imagen de salida. Requiere el texto a continuación de la opción. Es compatible con la opción -IDX, pero no con la opción -NAME8
     -prefix '5.5"'

Sufijo Arbitrario#

-SUFIX <Texto de Sufijo> Añade un sufijo de texto arbitrario al final del nombre de la imagen de salida. Requiere el texto a continuación de la opción. Es compatible con la opción -IDX, pero no con la opción -NAME8
     -sufix PP3

Extensión JPS#

-JPS Pone extensión .JPS a la imagen generada. Solo con las opciones -SBS y -SBS50