# &app; Manual V&manrevision;

## Introducción

&app; es una herramienta que captura a fichero el movimiento en un área seleccionada de la ventana X11. Esto lo lleva a cabo realizando un número configurable de capturas de pantalla por segundo y guardandolos bien como capturas individuales o como video. Este tipo de aplicaciónes, hoy, se llaman comunmente utilidades screencam o screencast. De hecho, una de las aplicaciones mas antiguas de este tipo fué Lotus Screencam que sirvió de inspiración para &app;.

&app; puede usarse en dos módos distintos de operación:

1. &sf-cap; -- captura pantallazos individuales a un fichero cada uno.

2. &mf-cap; -- captura y codifica a video al vuelo.

### Mnemonic

El nombre de los modos de operación derivan del número de frames que se almacenan en el fichero de salida: Una o varias.

### Captura de Audio

&app; puede capturar audio, pero solo en modo de operación &mf-cap;.

Grabar en modo single-frame puede ser mas conveniente si desea preprocesar la imagen antes de codificar, o si necesitas algún codec de video que &app; no soporta. Las imágenes individuales pueden ser codificadas con herramientas como ffmpeg, mencoder, or transcode.

Para reportar bugs o aportar sugerencias para la aplicación &app; o este manual, siga las instrucciones de la web de &app; en SF.net.

## Primeros pasos

### Para arrancar &app;

Puede arrancar &app; de las siguientes maneras:

menu Applicaciones

- Elija Sonido & Video XVidCap Screen Capture.

Linea de comandos

- Ejecute el siguiente comando: `xvidcap`. Para más información sobre su uso desde linea de comandos consulte la página de manual de xvidcap.

### Al arrancar &app;

Cuando arranque &app;, se muestran las siguiente pantallas:

#### &app; Control

Muestra el control de &app;.

La ventana con título y botones es el control principal de &app;, mientras que el rectángulo rojo es el borde del área a capturar.

### Elementos del control principal de &app;:

???Filename Display and Menu | El ???Filename Display and Menu muestra el nombre de fichero de salida y, si está en modo &mf-cap;, el número índice de el frame capturado mas reciente entre corchetes. En modo &sf-cap; el número indice del frame actual forma parte del nombre de fichero. En modo &sf-cap; un clic izquierdo reestablece el contador de frames al principio. Un clic derecho mientras no está capturando, mostrará el menú principal. #### Modo de captura por defecto Por defecto, &app; arranca en modo &mf-cap;.
Contador de Frames Perdidos | El Contador de Frames Perdidos proporciona una indicación de la capacidad de capturar la sesión de captura al frame-rate deseado. Si su sistema tiene demasiada carga, podría no ser capaz de capturar la cantidad de frames por segundo deseada. Esto dara como resultado un video que se reproduce muy acelerado. &app; muestra un estado verde si puede o casi puede capturar al frame-rate deseado. Si tiene pérdida de frames el estado se vuelve amarillo, o rojo en caso de que la perdida de frames sea excesiva. Para reducir la pérdida de frames, usted puede capturar una zona más pequeña de la pantalla, elegir un frame-rate menor, cerrar el máximo posible de aplicaciones abiertas que no sean necesarias para la captura, o usarlo en una máquina más potente. También puede ayudar reescalar los datos capturados.
Botón Stop | El Botón Stop para la sesión de grabación en curso.
Botón Pausa | El Botón Pausa pausa la sesión de grabación en curso. Puede seleccionar esto antes de iniciar la grabación para iniciar pausado.
Botón Grabar | El Botón Grabar comienza la sesión de grabación.
Botón Captura Individual | El Botón Captura Individual solo está activo al pausar una sesión de captura en modo &sf-cap;. Entonces se le permitirá sacar capturas de pantalla individuales haciendo clic sobre este botón.
Botón Rebobinar | El Botón Rebobinar tiene diferentes usos, dependiendo del modo de captura que esté usando. En modo &sf-cap; rebobinar se refiere al número índice del frame actual a capturar. Suponga que tiene una sesión de captura parada que ha capturado diez imágenes PNG. El nombre de fichero podría mostrar test-0010.png. Entonces se da cuenta de que los dos últimos frames no eran necesarios. Usted puede clicar el botón de rebobinar dos veces. Esto cambia el nombre de fichero mostrado a test-0008.png. Si continua capturando, los frames ocho y nueve en las imágenes test-0008.png y test-0009.png serán sobreescritas. En modo &mf-cap; el botón rebobinar funciona de maner bastante similar. Sin embargo, no manipula el número índice del frame actual, si no, la película actual, ya que se relacciona con la característica autocontinuar.
Botón Avanzar | El Botón Avanzar hace lo contrario al botón rebobinar, es decir, incrementa el número índice del frame actual o el número índice de la película, dependiendo del modo de captura.
Bloqueo de Frame de Selección | El Bloqueo de Frame de Selección hace que la selección a capturar se mueva con el control principal si está seleccionado. Si no está seleccionado, la selección a capturar se mantendrá en su posición cuando se mueva el control principal.
???Frame Selector Button | Cliquee el ???Frame Selector Button para cambiar el área que desea capturar. Al pulsar el botón, el cursor cambia a un punto de mira. Despues usted puede: clicar en una ventana para capturar solamente esa ventana. #### Moviendo Ventanas Capturadas El área de selección no se asigna a una ventana de forma que, el área de selección no seguirá a la ventana de la aplicación a capturar, si la mueves por la pantalla. Lo que hace, es ajustar la posición y tamaño del area de captura para ajustarse al contenido de la ventana sobre la que pulsó. Si después mueve usted la ventana, el área de captura se mantendrá donde está, a no ser que el bloqueo de frame de selección esté habilitado y manualmente mueva el control principala la posición correcta. cliquee y arrastre para seleccionar una porción arbitrária de la pantalla. cliquee directamente sobre el escritorio para capturar a pantalla completa. #### Captura a Pantalla Completa Con el tamaño actual de las pantallas, capturar a pantalla completa tiene una alta probabilidad de cargar demasiado su sistema. Fijesé en el contador de frames perdidos y juegue ajustando la resolución de pantalla si necesita imperiosamente hacer la captura a pantalla completa. Recuerde que los DVD normalmente tienen resoluciones de 720 x 486. Capturar a pantalla completa a una resolución de 1400 x 1050 significa un flujo de datos 4 veces superior a un DVD en tiempo real -- no es algo que vaya a hacer con un lapiz y papel.
Botón Editar | El Botón Editar llama a un programa externo para editar el frame capturado mas recientemente en modo &sf-cap; o el video en modo &mf-cap;. &app; no proporciona esas aplicaciones. Por defecto, &app; llama a gimp en modo &sf-cap; y nada en modo &mf-cap;. Ambos son configurables y pueden ser cambiados a través del ventana de preferencias.

### Menú Principal

Un clic derecho sobre el nombre de fichero muestra el siguiente menú:

#### Menú Principal

Menú Principal

### elementos del menú principal:

Elemento Preferencias | abre la ventana de preferencias
Elemento Guardar Preferencias | Guarda los ajustes actuales #### Ajustes Volátiles Recuerde que &app; no guarda los cambios en las preferencias automaticamente. Usted puede modificar los ajustes, salir de &app;, y volver a los ajustes anteriores con solo reiniciar &app;. Si quiere que los cambios sean permanentes, seleccione esto. Escribirá sus ajustes en un fichero `.xvidcaprc` en su directorio home.
Elemento Multi-Frame | selecciona modo de captura multi-frame #### Ajustes Paralelos para Modos de Captura Tenga en cuenta que puede tener distintos ajustes para los modos &mf-cap; y &sf-cap; configurados y guardados en paralelo. Elijiendo este elemento del menú o el siguiente alterna entre los dos modos y sus ajustes respectivos.
Elemento Single-Frame | selecciona modo de captura single-frame
Elemento Autocontinuar | alterna la opción autocontinuar on/off Esto solo es seleccionable en modo &mf-cap; y solo si el nombre de fichero es variable. Consulte ajustes de preferencias de autocontinuado para más información.
Elemento Crear Video | ejecutar el comando de codificación configurado en las preferencias En modo &mf-cap; esto no se necesita y no se activa por defecto. Sin embargo, puede ajustarse para permitir la ejecución de un comando personalizado si necesita un formato de salida distinto a los que &app; puede generar. El script usado en modo &sf-cap; por defecto es proporcionado por &app; pero podría ser necesario copiarlo a la ruta de sus ejecutables de modo que esté disponible. Consulte la pestaña de preferencias de comandos para más información sobre ajustes de los comandos de codificación.
Elemento Animar/Reproducir | ejecuta el comando de reproducción configurado en las preferencias. En modo &mf-cap; este es mplayer y animate (forma parte de ImageMagick) por defecto. Consulte la pestaña de preferencias de comandos para más información sobre ajustar los comandos de codificación.
Elemento Ayuda | muestra la ayuda online
Elemento Acerca de | muestra la ventana acerca de &app;'s
Elemento Salir | sale/cierra &app;

## Preferencias

Puede abrir la ventana de preferencias con un clic derecho sobre el display del control principal que muestra el nombre de fichero y seleccionando Preferencias o presionando CTRL-P. La ventana está dividida en cuatro pestañas.

### Pregerencias Generales

La primera pestaña de la ventana de preferencias contiene varios ajustes sobre el comportamiento general de &app;.

#### Preferencias Generales

Preferencias Generales

### las preferencias generales son:

Modo de Captura por Defecto | Este ajuste indica el modo de captura que utilizará &app; por defecto, i. e. si ningún otro ajuste da una pista a &app;.
Capturar el Puntero de Ratón | Marque esto para capturar la posición del puntero del ratón. Una vez marcado, puede elegir si quiere capturar un puntero de ratón blanco o negro. Esto se requiere porque &app; no es capaz de capturar el puntero de ratón real, solo su posición. Por lo tanto, &app; genera un puntero en la película capturada. #### Formas de Puntero de Ratón Personalizadas Por las razones arriba mencionadas, &app; no puede capturar la forma de su puntero de ratón. Si, por lo tanto, la aplicación que está capturando cambia la forma de su puntero, perderá ese cambio en la película capturada. Si la lógica del contenido capturado está altamente basada en esto, usted querrá asegurarse de tener algún método alternativo para mostrar esos cambios de puntero, o puede explicarlo en sus comentarios hablados.
Guardar la Geometría de Captura | Marque esto si quiere guardar el tamaño y posición del área de captura seleccionada junto con otras preferencias de al seleccionar Guardar Preferencias del menú principal.
Usar Memoria Compartida | Marque esto si la captura de frames debería usar la extensión de memoria compartida de X11. #### Acceso a Memoria Compartida X11 El uso de memoria compartida está habiliado por defecto si la máquina donde &app; fue compilado tenía soporte para acceso a memoria compartida de X11, lo cual es el caso típico hoy en día. Usted necesitará deshabilitar esto, si el servidor X11 y el client no están ejecutandose en la misma máquina, e. g. si está usando X desde un cliente ligero (thin client).
Autocontinuar | Si está grabando en modo &mf-cap; y especifica un número máximo de frames a capturar o una duración máxima de la captura, &app; puede automáticamente continuar capturando en un nuevo video una vez alcanzado el número máximo de frames o tiempo máximo de duración de la captura. Esto creará una serie de películas divididas en trozos de la duración máxima especificada. Para utilizar esto necesita especificar un nombre de fichero destino alternable.
Mostrar Siempre la Ventana de Resultados | Marque esto para mostrar siempre una entana con una descripción de los resultados de captura al parar la sesión de captura. La ventana se mostrará siempre que sea necesario (e. g. para especificar el nombre de fichero de salida). Esto hace que la ventana se muestre donde no sería extrictamente necesario. Por defecto la ventana de resultados se muestra siempre. Si, sin embargo, ha desmarcado Mostrar esta ventana la próxima vez en la ventana de resultados, puede volver a marcarla aquí.
Porcentaje de Reescalado de la Salida | Utilice esto para hacer el tamaño de salida del video mas pequeño que el tamaño original de la porción de pantalla capturada. El porcentaje especificado aquí es el tamaño de salida con respecto al de entrada. Por ejemplo, especificando 25 hará que el ancho y alto de salida sean la mitad del original cada uno. Así pues, el tamaño de salida de la imagen será un 25 por ciento del área capturada.

### Preferencias de Captura Single-Frame

Esta pestaña contiene los ajustes para el modo &sf-cap;. Porque el modo &sf-cap; no soporta la captura de audio, aquí solo los ajustes de video son configurables.

#### Preferencias de Captura Single-Frame

Preferencias de Captura Single-Frame

### los ajustes del modo &sf-cap; son:

Nombre de Fichero | Introduzca un patrón de nombre de fichero a usar para guardar los frames capturados individualmente. El nombre de fichero ha de contener un patrón que será reemplazado por por el número de frame actual para cada fichero individualmente. Los patrones utilizados son aquellos que es capaz de manejar fprintf. Un nombre de fichero conteniendo este tipo de patrón será llamado de aquí en adelante nombre de fichero alternable. #### Selección de Nombre de Fichero En vez de escribir el nombre de fichero, usted puede hacer clic en el botón selector de ficheros (...). Aseguresé de poner un patrón numérico tras el nombre de fichero. Si duda, use %5d en alguna parte del nombre de fichero.
Formato de Fichero | Una marca en el checkbox auto hace que &app; seeccione automaticamente el formato de fichero adecuado basandose en el nombre de fichero especificado. Por Ejemplo, si especifica test-%4d.png l formato de salida será un ficheroPortable Network Graphics (png). Si el checkbox auto está desmarcado, el menú desplegable permite elegir manualmente un formato, posiblemente inhabilitando la decisión de &app;.
Frames por Segundo | El número de frames a capturar por segundo.
Tiempo Máximo | iempo máximo a grabar en segundos
Máximo de Frames | Máximo de frames a capturar
Número de Frame Inicial | Empieza a contar frames a partir de este número
Incremento de Número de Frame | Durante la captra incrementa el número del contador de frames en el número especificado por cada frame capturado. #### Ajustes Desaprobados Debido al uso limitado de Número de Frame Inicial y Incremento de Número de Frame estos ajustespodrían desaparecer en futuras versiones.
Calidad | Calidad de salida deseada

### Preferencias de Captura Multi-Frame

Esta pestaña contiene los ajustes para el modo &mf-cap;.

#### Preferencias de Captura Multi-Frame

Preferencias de Captura Multi-Frame

### los ajustes del modo de captura &mf-cap; son:

Nombre de Fichero | Introduzca un nombre de fichero o patrónaquí ara guardar los frames capturados individualmente. Para &mf-cap; la cadena proporcionada solo necesita ser un nombre de fichero alternable si la característica autocontinuar va ser usada. De otra manera, un nombre de fichero simple es suficiente aquí, lo cual puede ser seleccionado a través del botón selector de ficheros (...).
Formato de Fichero | Una marca en el checkbox auto hace que &app; seleccione automaticamente un formato de salida apropiado basandose en el nombre de fichero especificado. Por ejemplo, si especifica test.avi el formato de salida será Microsoft Audio Video Interleaved (avi). Si el checkbox auto está desmarcado, el menú desplegable permite seleccionar manualmente un formato, posiblemente inhabilitando la decisión de &app;.
Codec de Video | Si la casilla auto está marcada hace que &app; seleccione automaticamente el codec de video apropiado para el formato de salida selecionado. Por ejemplo, si selecciona Microsoft Audio Video Interleaved (avi) el codec de video será Microsoft DIVX 2. Si la casilla auto está desmarcada, el menú desplegable permite seleccionar un codec manualmente, posiblemente inhabilitando la decisión de &app;.
Frames por Segundo | El número de frames a capturar por segundo. Este control puede ser una escala o un menú desplegable, si el codec seleccionado solo soporta ciertos frame rates.
Tiempo Máximo | Tiempo máximo a grabar en segundos
Máximo de Frames | Máximo de frames a capturar
Calidad | Calidad de salida deseada

### los ajustes de audio del modo &mf-cap; son:

Habilitar Audio | Marque esto para capturar audio junto con los frames de video.
Dispositivo de Entrada | Escriba el nombre del dispositivo de entrada desde el que capturar el audio o seleccioneló mediante el botón selector de ficheros (...).
Codec de Audio | Si la casilla auto está marcada hace que &app; seleccione automaticamente el codec de audio apropiado para el formato de salida de video seeccionado. Por ejemplo, si se selecciona Microsoft Audio Video Interleaved (avi) el codec de audio será MPEG2. Si la casilla auto esta desmarcada, el menú desplegable permite seleccionar manualmente un codec, posibemente inhabilitando la decisión de &app;.
Sample Rate | Sample rate del audio. Si está utilizando una entrada de audio redirigida mediante tuberías, el flujo de audio será resampleado al sample rate especificado si fuera necesario. #### Entrada de Audio Redirigida mediante Tuberías En vez de capturar audio de una fuente en tiempo real, usted puede redirigir un flujo de audio pregrabado a &app;. De esta manera puede doblar su grabación con un archivo de audio alternativo. Para hacer esto se necesita: cat my.mp3 | &app; `--mf` `--audio yes` `--audio_in -` `--file test.avi` Cuando empiece la sesión de grabación en &app;, el audio se tomará del archivo de audio redirigido desde un fichero.
Bit Rate | Bit rate de audio. Si está utilizando un flujo de audio redirigido, el audio será resampleado al bit rate especificado si fuera necesario.
Canales | Número de canales de audio. Si está utilizando una entrada de audio redirigida, el flujo de audio será resampleado al número especificado de canales si fuera necesario. #### Calidad de Captura de Audio Tenga en cuenta que los valores por defecto están optimizados para el tamaño en vez de calidad. Para mejorar la calidad, probablemente deba doblar el sample/bit rate y el número de canales.

### Preferencias de Comandos

Esta pestaña contiene varios ajustes various settings regarding which commands to execute for certain actions.

#### Preferencias de Comandos

Preferencias de Comandos

### los comandos a configurar son:

Comando de Reproducción de Frame Única | El comando aquí especificado se ejecuta cuando Animar / Reproducir es seleccionado en el menú principal o el botón reproducir es presionado en la ventana de resultados de la captura si está en modo &sf-cap;. #### Especificando Comandos Cualquier comando puede ser configurado aquí. Podría no tener nada que ver con la captura de video. Debe asegurarse de que la aplicación a ejecutar se encuentra en su ruta (path) y que termina el comando con & para evitar que &app; espere a que la aplicación lamada termine antes de continuarel mismo. &app; pone a disposición de la aplicación a ejecutar las siguientes variables de entornono:

XVFFRAME | número del primer frame capturado
XVLFRAME | número del último frame capturado
XVWIDTH | anchura del área capturada
XVHEIGHT | altura del área capturada
XVFPS | frame rate (!) deseado
XVTIME | tiempo por frame deseado (!)
XVFILE | nombre de fichero

El nombre de fichero precisa de un tratamiento especial para &sf-cap;. Here the pattern used for mutable file names is sent literally as specified for the Single Frame Encoding Command further down only. Para el comando de Reproducción de Frame Única el patrón se convierte en wildcards, i. e. test-%4d.png se transformará en test-????.png. Para el comando de Edición de Frame Único el patrón es reemplazado con el número del frame actual, i. e. test-%4d.png se transformará en test-0001.png. Para todos los comandos Multi Frame se utiliza comma se aplica el último caso expuesto, allí donde el nombre de fichero es alternable y el número usado es el índice del video grabado mas recientemente tal y como con la opción autocontinuar.
comando para Codificación Single Frame | Este comando se ejecuta cuando la opción Crear Video del menú principal es seleccionada estando en modo &sf-cap;.
Comando para Edicion Single Frame | Este comando se ejecutacuando el Botón Editar del menú principal es pulsado estando en modo &sf-cap;.
Comando para Reproducción Multi Frame | El comando aquí especificado se ejecuta cuando la opción Animar / Reproducir es seleccionada en el menú principal, o el botón reproducir es pulsado en la ventana de los resultados de la captura estando en modo &mf-cap;.
comando para Codificación Multi Frame | Este comando se ejecutacuando la opción Crear Video del menú principal es seleccionada estando en modo &mf-cap;.
Comando de Edición Multi Frame | Este comando se ejecuta cuando la el Botón Editar del control principal es pulsado estando en modo &mf-cap;.

## Ventana de Resultados de la Captura

Cuando pare por primera vez una sesión de captura, aparecerá una ventana mostrando los resultados de la sesión de captura. Se puede evitar que vuelva a aparecer desmarcando la casilla Mostrar la Próxima Vez o este botón en la ventana de preferencias.

La ventana se mostrará en dos posibles formatos dependiendo se si ha configurado o no &app; para que pregunte por el nombre de fichero destino después de la captura.

### Preguntar al Usuario por el Nombre de Fichero

Por el momento, la única manera de configurar &app; para que pregunte al usuario por un nombre de fichero después de la captura en vez de hacerlo al principio es especificar un nombre de fichero vacio desde la linea de comandos usando `--file ""` o en la ventana de preferencias. Esto requiere que se especifique manualmente un formato de fichero de salida. Con esta configuración &app; guardará el video en un fichero temporal en su direcorio home que puede después ser renombrado o movido a la ubicación deseada. Esto no es compatible con autocontinuar.

Si &app; se configura para que pregunte al usuario por el nombre de fichero, la ventana de resultados aparecerá así:

### Ventana de Resultado de la Captura preguntando al usuario por el nombre de fichero

Ventana de Resultados de la Capturapreguntando al usuario por el nombre de fichero

Además de la descripción de los ajustes usados y la información sobre el frame rate deseado y el conseguido, usted puede elegir el nombre y la ubicación del fichero en el que quiere guardar el video clicando sobre Guardar Como. Una vez halla seleccionado un fichero, la etiqueta junto al botón mostrará el nombre de fichero. También puede elegir previsualizar el video a través de Reproducir o eliminarlo mediante Borrar. Tenga en cuenta que la última opción no elimina inmediatamente el fichero temporal.

Normalmente, la ventana de resultados tendrá una apariencia como esta:

### Ventana de Resultados de Captura normal

Ventana de Resultados de Captura normal

## Ventana de Advertencia de Preferencias

Cuando quiera que &app; determine que los ajustes que ha elegido no funcionarán bién, mostrará esos problemas en un formato estandarizado. A no ser que esté ejecutando &app; con el parámetro `--gui no`, mostrará la siguiente ventana:

### Ventana de Advertencia de Preferencias

Ventana de Advertencia de Preferencias

### trabajando sin GUI

Cuando se ejecuta desde la linea de comando con el parámetro `--gui no`, esas advertencias se mostrarán en la terminal en texto plano. No podrá ver la sección Detalles a no ser que halla especificado `-v`.

## Hay algunas situaciones en las que se mostrarán esos mensajes:

Al Iniciar | Cuando &app; arranca, chequea la consistencia de los ajustes para el modo de captura actual y reportará los problemas que ahi encuentre. No tendrá posibilidad de cancelar esta ventana sin revisar sus preferencias. &app; solo comprueba sobre el modo de captura actual y no tendrá en cuenta las inconsistencias que afecten al otro modo. De ahi, se produce la segunda situación.
Cambiando el Modo de Captura | Si cambia el modo actual de captura mediante el menú &app; comprobará la consistencia de los ajustes para el nuevo modo de captura y reportará los problemas que ahi encuentre. Si cancela la ventana de advertencia, la aplicación retornará al modo de captura previamente selecionado.
Al eviar los cambios de preferencias | Al abandonar la ventana de preferencias &app; comprobará los ajustes para ambos modos de captura. Cancelar la ventana de advertencia le llevará de vuelta a la ventana de preferencias.

En la ventana de advertencia de preferencias se encontrará con uno o mas mensajes consistentes en tres filas cada uno. La primera fila contine el tipo o severidad del mensaje, un número ID único y el nombre corto del error. La segunda fila muestra una descripción detallada, y la tercera fila explica la acción que &app; va a llevar a cabo si elige hacer clic en OK.

Dicha acción podría corregir automaticamente el problema eligiendo valores por defecto, ignorando la advertencia si no es severa, o saliendo de &app; si no se puede determinar una solución automaticamente.

La severidad de las advertencias puede ser INFO para mensajes puramente informativos donde no se realiza ningun cambio a los ajustes, WARNING cuando se sugieren cambios menores a los ajustes actuales, ERROR cuando se requieren cambios importantes a los ajustes actuales, o FATAL ERROR. Un error fatal es siempre un error donde la acción sugerida es salir de &app;. Usted no verá advertencias de severidad INFO a no ser que se ejecute&app; en modo verbose.