1
.TH xvidcap 1 "Septiembre 2006"
3
XVidCap \- Graba porciones de una ventana X11 a video
5
\fBxvidcap\fR [\-v] [ \-\-mf | \-\-sf ] [\-\-file\fB nombre de fichero\fR |\- ] [\-\-fps\fB frames por segundo\fR] [\-\-cap_geometry\fB geometr\('ia\fR] [\-\-rescale\fB tama\(~no en porcentaje\fR] [\-\-quality\fB calidad en porcentaje\fR] [\-\-source x11|shm ] [\-\-time\fB duraci\('on m\('axima en segundos\fR] [\-\-frames\fB n\('umero m\('aximo de frames\fR] [\-\-start_no\fB n\('umero del frame de inicio\fR] [\-\-continue yes|no ] [\-\-gui yes|no ] [\-\-auto] [\-\-codec\fB codec de video\fR] [\-\-codec\-help] [\-\-format\fB formato de fichero de salida\fR] [\-\-format\-help] [\-\-audio yes|no ] [\-\-aucodec\fB codec de audio\fR] [\-\-aucodec\-help] [\-\-audio_in\fB dispositivo de captura de audio\fR |\- ] [\-\-audio_bits\fB bit rate de audio\fR] [\-\-audio_rate\fB sample rate de audio\fR] [\-\-audio_channels\fB canales de audio\fR]
7
xvidcap es una herramienta que captura a fichero el movimiento en un \('area seleccionada
8
de la pantalla. Puede operar en dos modos distintos: (1) captura \fIsingle\-frame\fR
9
o (2) captura \fImulti\-frame\fR. En modo de captura single\-frame
10
xvidcap saca un n\('umero configurable de capturas por segundo y
11
los guarda como ficheros individuales. En modo de captura multi\-frame xvidcap
12
tambi\('en saca un n\('umero de capturas por segundo, pero las codifica en un solo fichero de video en tiempo real.
13
La captura de audio solo est\('a disponible con formatos multi\-frame.
15
Es conveniente grabar en modo de captura single\-frame si se pretende preprocesar las
16
im\('agenes antes de codificarlas a video, o si necesita otros codecs de video que xvidcap
17
no soporta. Las im\('agenes individuales pueden posteriormente ser codificadas utilizando herramientas como ffmpeg, mencoder
20
Para ayuda, nuevas caracter\('isticas, o reportar bugs por favor dir\('ijase a
21
http://www.sourceforge.net/projects/xvidcap/
23
Estos programas siguen la sintaxis de la linea de comandos GNU,
24
con opciones de nombre largo comenzando por dos guiones (\fB\-\-\fR).
25
Un sumario de las opciones puede verse a continuaci\('on.
28
Ejecuta xvidcap en modo verbose. Esto proporciona m\('as informaci\('on sobre
29
ajustes de usuario, codecs de entrada y salida, rendimiento, ... Mensajes
30
como "missing XX milli secs .." durante la captura significa que est\('a perdiendo
31
frames debido a la falta de recursos (frames perdidos). Esto resulta en un video
32
que se reproducir\('a acelerado. Tenga en cuenta que el modo verbose ralentiza
33
xvidcap y podr\('ia ser el \fIcausante\fR de perdidas de frames. Pruebe a ejeutarlo sin
34
modo verbose y observe el contador de frames perdidos.
36
\fB\-\-mf\fR | \fB\-\-sf\fR
37
xvidcap intenta adivinar el modo de captura que desea. Si usted
38
especifica \fB\-\-file test.avi\fR xvidcap asumir\('a que usted desea una captura multi\-frame.
39
Puede especificar explicitamente el modo de captura deseado en la linea de comandos con este
40
modificador. Si, por ejemplo, usted tiene sus ajustes correctamente configurados y
41
guardados con captura multi\-frame como modo por defecto, ejecutar \fBxvidcap \-\-sf\fR
42
iniciar\('a xvidcap en modo de captura single\-frame con todos los ajustes guardados. Por
43
defecto es captura multi\-frame.
45
\fB\-\-file \fInombre/patr\('on de fichero\fB\fR
46
El nombre/patr\('on de fichero a utilizar para guardar los frames capturados. Un patr\('on de nombre
47
de fichero contiene un formato tipo printf() (ref. \fBman printf\fR)
48
para hacer el nombre de fichero incrementable, e.g. \fB\-\-file out\-%02d.xwd\fR.
49
Esto es necesario para capturas single\-frame. xvidcap reemplazar\('a
50
la primera cadena del formato printf() con el n\('umero del frame capturado.
51
As\('i pues, en el ejemplo dado, escribir\('a los ficheros \fBout\-00.xwd\fR,
52
\fBout\-01.xwd\fR, \fBout\-02.xwd\fR,
53
etc. El n\('umero de frame desde el que iniciar la capturapuede ser especificado con \fB\-\-start_no\fR,
56
La captura Multi\-frame no necesita un patr\('on de fichero. Si especifica uno,
57
no obstante como \fB\-\-file mymovie\-%d.mpeg\fR, xvidcap
58
reemplazar\('a la cadena de formato con el n\('umero de la sesi\('on grabaci\('on actual
59
(siempre empezando a contar desde cero). Esto le habilitar\('a para incrementar/disminuir manualmente ese
60
n\('umero, o usar la caracter\('istica autocontinuar (ref. \fB\-\-continue\fR arriba) creando
61
una serie de ficheros de video.
63
\fB\-\-fps\fI frames por segundo\fB\fR
64
Especifica el n\('umero de frames a capturar por segundo. Este par\('ametro
65
acepta n\('umeros de coma flotante, lo que permite capturas a frame rates muy bajos como
66
e.g. \fB\-\-fps 0.5\fR para grabar un frame cada 2 segundos. Esto solo es posible
67
en modo single\-frame. Los codecs usados para modo multi\-frame normalmente solo
68
aceptan ciertos frame rates como v\('alidos. Tenga en cuenta que frame rates fracionados para
69
codecs como MPEG1 que solo acepta fracciones muy espec\('ificas est\('an deshabilitados
70
en esta versi\('on debido a una inconsistencia con tiempos fraccionados entre
71
xvidcap y libavcodec. Solo frame rates de n\('umero entero ser\('an aceptados.
73
\fB\-\-cap_geometry\fI geometr\('ia\fB\fR
74
Especifica la geometr\('ia como por ejemplo xterm, i. e. de esta manera:
75
\fIwidth\fRx\fIheight\fR+\fIx\-position\fR+\fIy\-position\fR
77
Esto invalida la anchura y altura por defecto del marco de captura. Use el bot\('on
78
picker del GUI en vez de esta opci\('on de linea de comandos para ajustar el tama\(~no del marco de captura
79
a una ventana. Tama\(~nos de captura inferiores a 20 x 20 no parecen funcionar bi\('en con
80
la mayor\('ia de codecs de captura multi\-frame.
82
\fB\-\-rescale\fI tama\(~no en porcentaje\fB\fR
83
Reescala la salida a un porcentaje del original de entrada. Un valor de \fB25\fR, e. g.
84
har\('a que el tama\(~no de salida sea un 25 por ciento del \('area original de entrada.
86
\fB\-\-quality\fI calidad en porcentaje\fB\fR
87
Especifica un valor entre \fB0\fR y \fB100\fR para definir la calidad do codificaci\('on. El
88
valor por defecto es \fB75\fR.
90
\fB\-\-source\fR x11|shm
91
Habilita o deshabilita el uso de la extensi\('on de memoria compartida de X11. Para soportar
92
memoria ompartida, ambos, cliente y servidor han de ejecutarse en el mismo host. Si el uso de
93
memoria compartida est\('a disponible, xvidcap la usar\('a por defecto. Si su servidor X y
94
cliente no se ejecutan en la misma m\('aquina, necesita deshabilitarlo con el par\('ametro \fB\-\-source x11\fR.
96
\fB\-\-time\fI duraci\('on m\('axima en segundos\fB\fR
97
Especifica el tiempo m\('aximo de captura, si \fB0\fR xvidcap capturar\('a hasta
98
que sea parado interactivamente. Para cualquier otro valor, cualquier sesi\('on de grabaci\('on parar\('a
99
automaticamente despu\('es del n\('umero de segundos especificado. Este parametro entra en
100
conflicto con \fB\-\-frames\fR (vea mas abajo). Si se especifican ambos xvidcap parar\('a cuando
101
ocurra la primera de las dos. El programa acepta n\('umeros de coma flotante, e.g. \fB2.5\fR.
103
\fB\-\-frames\fI n\('umero m\('aximo de frames\fB\fR
104
Para la captura despu\('es de capturar el n\('umero de frames especificado. Si \fB0\fR
105
xvidcap capturar\('a hasta ser parado interactivamente, ref. \fB\-\-time\fR arriba.
107
\fB\-\-start_no\fI N\('umero de frame inicial\fB\fR
108
Define el n\('umero inicial con el que empezar a numerar los ficheros. El valor
109
por defecto es \fB0\fR. Este par\('ametro solo se utiliza para capturas single\-frame.
110
La numeraci\('on de ficheros de video para \fB\-\-continue\fR siempre empieza de cero.
112
\fB\-\-continue\fR yes|no
113
Cuando se selecciona captura multi\-frame, tiempo m\('aximo de captura o frames son
114
especificados, y el nombre de fichero de salida es incrementable (vea \fB\-\-file\fR abajo),
115
xvidcap puede continuar automaticamente capturando a un fichero nuevo cuando uno
116
excede el tiempo m\('aximo o el n\('umero de frames. Esto cambiar\('a el
117
comportamiento de \fB\-\-time\fR y \fB\-\-frames\fR porque la grabaci\('on no parar\('a
118
en los l\('imites especificados, si no, empezar\('a un nuevo fichero de video. Esta caracter\('istica es
119
de utilidad si desea dividir su grabaci\('on en fragmentos de
120
e. g. cinco minutos. Si no hay opci\('on \fB\-\-continue\fR, xvidcap usar\('a por defecto \fBno\fR.
121
Dado que la captura single\-frame necesita un nombre de fichero con un patr\('on incremental para contar los
122
frames individuales, esta caracter\('istica est\('a deshabilitada para las capturas single\-frame.
125
Inicia xvidcap con o sin GUI de control overriding what's in the
126
preferences file. Ejecutandolo sin GUI iniciar\('a automaticamente una sesi\('on
127
de captura. Puede pararse especificando o bien \fB\-\-time\fR o
128
\fB\-\-frames\fR, o pulsando CTRL\-C.
131
xvidcap soporta la detecci\('on autom\('atica de par\('ametros para
132
formatos de salida, codecs de video y audio. Si alguno de esos ajustes han sido guardados como valores
133
fijos en las preferencias, pueden ser invalidados especificando el par\('ametro
134
\fBauto\fR a cualquiera de los argumentos \fB\-\-format\fR, \fB\-\-codec\fR,
135
o \fB\-\-aucodec\fR. Este argumento es una manera r\('apida de ajustar los tres a
136
detecci\('on autom\('atica.
138
\fB\-\-codec\fI codec de video\fB\fR
139
Invalida las preferencias y la selecci\('on autom\('atica de codecs y utiliza el codec
140
explicitamente especificado.
142
\fB\-\-codec\-help\fR
143
Lista los codecs v\('alidos.
145
\fB\-\-format\fI Formato del fichero de salida\fB\fR
146
Invalida las preferencias y la selecci\('on autom\('atica de formato con el formato de fichero
147
explicitamente especificado.
149
\fB\-\-format\-help\fR
150
Lista los formatos de fichero v\('alidos.
151
.SH "OPCIONES DE AUDIO"
152
Las siguientes opciones hacen referencia a la captura de audio, la cual solo est\('a disponible con
153
formatos de salida multi\-frame. El audio puede ser capturado tanto desde cualquier
154
dispositivo de audio compatible (e.g. \fB/dev/dsp\fR) o desde
155
STDIN (ref. \fB\-\-audio_in\fR abajo).
157
\fB\-\-audio\fR yes|no
158
Habilita o deshabilita la captura de audio utilizando los par\('ametros por defecto o aquellos guardados en
159
el fichero de preferencias. Si est\('a soportado, se hbilitar\('a por defecto en las capturas multi\-frame.
161
\fB\-\-aucodec\fI codec de audio\fB\fR
162
Inhabilita las preferencias y la selecci\('on autom\('atica de codec con el codec de audio
163
explicitamente especificado.
165
\fB\-\-aucodec\-help\fR
166
Lista los codecs de audio v\('alidos.
168
\fB\-\-audio_in\fI dispositivo de captura de audio\fB|\-\fR
169
Camptura audio desde el dispositivo especificado o desde stdin. El \('ultimo permite
170
el doblaje de un video capturado utilizando la linea de comandos de la siguiente manera. Por
171
defecto es \fB/dev/dsp\fR.
173
cat some.mp3 | xvidcap \-\-audio_in \-
175
\fB\-\-audio_bits\fI bit rate del audio\fB\fR
176
Ajusta el bit rate deseado. Por defecto es \fB32000\fR bit. Tenga en cuenta que si utiliza
177
STDIN el fichero de entrada ser\('a resampleado seg\('un se necesite.
179
\fB\-\-audio_rate\fI sample rate del audio\fB\fR
180
Ajusta el sample rate deseado. Por defecto es \fB22050\fR Hz. Tenga en cuenta que si utiliza
181
STDIN el fichero de entrada ser\('a resampleado seg\('un se necesite.
183
\fB\-\-audio_channels\fI canales de audio\fB\fR
184
Ajusta el n\('umero de canales deseados. Por defecto es \fB1\fR para mono. Cualquier valor
185
superior a \fB2\fR probablemente solo sea util al tomar la entrada de STDIN y un fichero de entrada 5\-channel AC audio
186
5\-canales AC o equipos de grabaci\('on de alta gama.
188
xvidcap fu\('e escrito por Rasca Gmelch and Karl H. Beckers.
190
Esta p\('agina del manual fu\('e escrita por Karl H. Beckers karl.h.beckers@gmx.net para
193
Esta traducci\('on fu\('e hecha por Imanol Garc\('ia Calvo
197
Garantizado el permiso de copia, distribuci\('on y/o modificaci\('on de este documento bajo
198
Los t\('erminos de la licencia de documentaci\('on libre,
199
version 1.1 o cualquier versi\('on posterior publicada por la
200
Free Software Foundation; con la imposibilidad de variar secciones y/o a\(~nadir textos en la portada
added
removed
doc/man/es/xvidcap.1
