Mercurial > mplayer.hg
comparison DOCS/man/ru/mplayer.1 @ 20707:a8d7e977ca8d
Initial partial translation of man page
(synced with last SVN).
TODO:
Translate sections:
"VIDEO OUTPUT DRIVERS"
"DECODING/FILTERING OPTIONS"
"AUDIO FILTERS"
"VIDEO FILTERS"
"GENERAL ENCODING OPTIONS"
"CODEC SPECIFIC ENCODING OPTIONS"
Resolve all FIXME issues.
author | voroshil |
---|---|
date | Sun, 05 Nov 2006 19:04:41 +0000 |
parents | |
children | 4c49ff8992e9 |
comparison
equal
deleted
inserted
replaced
20706:6ae01628975f | 20707:a8d7e977ca8d |
---|---|
1 .\" MPlayer (C) 2000-2006 MPlayer Team | |
2 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann | |
3 .\" Translated by Vladimir Voroshilov <voroshil@gmail.com> | |
4 .\" Encoding: koi8-r | |
5 .\" synced with r20707 | |
6 . | |
7 .\" -------------------------------------------------------------------------- | |
8 .\" Определения макросов | |
9 .\" -------------------------------------------------------------------------- | |
10 . | |
11 .\" define indentation for suboptions | |
12 .nr SS 5 | |
13 .\" add new suboption | |
14 .de IPs | |
15 .IP "\\$1" \n(SS | |
16 .. | |
17 .\" begin of first level suboptions, end with .RE | |
18 .de RSs | |
19 .RS 10 | |
20 .. | |
21 .\" begin of 2nd level suboptions | |
22 .de RSss | |
23 .PD 0 | |
24 .RS \n(SS+3 | |
25 .. | |
26 .\" end of 2nd level suboptions | |
27 .de REss | |
28 .RE | |
29 .PD 1 | |
30 .. | |
31 . | |
32 .\" -------------------------------------------------------------------------- | |
33 .\" Заголовок | |
34 .\" -------------------------------------------------------------------------- | |
35 . | |
36 .TH MPlayer 1 "2006-10-15" "Проект MPlayer" "Медиапроигрыватель" | |
37 . | |
38 .SH НАЗВАНИЕ | |
39 mplayer \- медиапроигрыватель | |
40 .br | |
41 mencoder \- медиа кодировщик | |
42 . | |
43 .\" -------------------------------------------------------------------------- | |
44 .\" Использование | |
45 .\" -------------------------------------------------------------------------- | |
46 . | |
47 .SH ИСПОЛЬЗОВАНИЕ | |
48 .na | |
49 .nh | |
50 .B mplayer | |
51 [опции] [файл|URL|плейлист|\-] | |
52 . | |
53 .br | |
54 .B mplayer | |
55 [опции] файл1 | |
56 [особые опции] [файл2] [особые опции] | |
57 . | |
58 .br | |
59 .B mplayer | |
60 [опции] | |
61 { "группа файлов и опций" } | |
62 [особые опции группы] | |
63 . | |
64 .br | |
65 .B mplayer | |
66 [dvd|dvdnav]://[заголовок|[первый_заголовок]\-последний_заголовок] | |
67 [опции] | |
68 . | |
69 .br | |
70 .B mplayer | |
71 vcd://дорожка[/устройство] | |
72 . | |
73 .br | |
74 .B mplayer | |
75 tv://[канал] | |
76 [options] | |
77 . | |
78 .br | |
79 .B mplayer | |
80 radio://[канал или частота][/capture] | |
81 [опции] | |
82 . | |
83 .br | |
84 .B mplayer | |
85 pvr:// | |
86 [опции] | |
87 . | |
88 .br | |
89 .B mplayer | |
90 dvb://[номер_карты@]канал | |
91 [опции] | |
92 . | |
93 .br | |
94 .B mplayer | |
95 mf://файловая_маска | |
96 [-mf опции] [опции] | |
97 . | |
98 .br | |
99 .B mplayer | |
100 [cdda|cddb]://дорожка[-посл._дорожка][:скорость][/устройство] | |
101 [опции] | |
102 . | |
103 .br | |
104 .B mplayer | |
105 cue://файл[:дорожка] | |
106 [опции] | |
107 . | |
108 .br | |
109 .B mplayer | |
110 [файл|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv]:// | |
111 [пользователь:пароль@]URL[:порт] [опции] | |
112 . | |
113 .br | |
114 .B mplayer | |
115 sdp://файл | |
116 [опции] | |
117 . | |
118 .br | |
119 .B mplayer | |
120 mpst://адрес[:порт]/URL | |
121 [опции] | |
122 . | |
123 .br | |
124 .B mplayer | |
125 tivo://адрес/[list|llist|fsid] | |
126 [опции] | |
127 . | |
128 .br | |
129 .B gmplayer | |
130 [опции] | |
131 [\-skin\ skin] | |
132 . | |
133 .br | |
134 .B mencoder | |
135 [опции] файл | |
136 [файл|URL|\-] [\-o файл] | |
137 . | |
138 .br | |
139 .B mencoder | |
140 [опции] файл1 | |
141 [особые опции] [файл2] [особые опции] | |
142 .ad | |
143 .hy | |
144 . | |
145 .\" -------------------------------------------------------------------------- | |
146 .\" Описание | |
147 .\" -------------------------------------------------------------------------- | |
148 . | |
149 .SH ОПИСАНИЕ | |
150 .B mplayer | |
151 это медиа проигрыватель для Linux (работает на множестве различных платформ и | |
152 процессорных архитектур, смотри документацию). | |
153 Он проигрывает большинство MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM, | |
154 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM и RoQ файлов, поддерживаемых большим количеством | |
155 встроенных и бинарных кодеков. | |
156 Вы также можете смотреть Video CD, SVCD, DVD, 3ivx, DivX 3/4/5 и даже WMV фильмы. | |
157 .PP | |
158 MPlayer поддерживает множество драйверов вывода видео и аудио. | |
159 Он работает с X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB, | |
160 Quartz, Mac OS X CoreVideo, вы также можете использовать GGI, SDL (и все его драйверы), | |
161 VESA (на любой VESA-совместимой карте, даже без X11), некоторые низкоуровневые | |
162 аппаратно-зависимые драйвера (для Matrox, 3dfx b ATI) и некоторые платформы аппаратного | |
163 декодирования MPEG, такие как Siemens DVB, Hauppauge PVR (IVTV), DXR2 и DXR3/\:Hollywood+. | |
164 Большинство из них поддерживает аппаратное или программное масштабирование, так что вы можете | |
165 насладиться просмотром фильмов в полноэкранном режиме. | |
166 .PP | |
167 .\" FIXME onscreen display | |
168 MPlayer имеет onscreen display (OSD) для отображения информации о состоянии , | |
169 больших сглаженных субтитров с тенью и визуального отклика на клавиатурные команды. | |
170 Европейские/\:ISO8859-1,2 (Венгерские, Английские, Чешские, и т.д.), Кириллические и Корейские | |
171 шрифты вкупе с 12 форматами субтитров (MicroDVD, SubRip, OGM, | |
172 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS и наш собственный: MPsub) и | |
173 DVD субтитры (SPU streams, VOBsub и Closed Captions). | |
174 .PP | |
175 .B mencoder | |
176 (MPlayer Media Encoder, Кодировщик Фильмов MPlayer) это простой кодировщик фильмов, разработанный | |
177 для кодирования фильмой, проигрываемых MPlayer'ом (смотри выше) в другие форматы, | |
178 поддерживаемые MPlayer'ом (смотри ниже). | |
179 Он кодирует в MPEG-4 (DivX/XviD), любой из libavcodec кодеков и | |
180 PCM/\:MP3/\:VBRMP3 звук в 1, 2 или 3 прохода. | |
181 Кроме того, он имеет возможности копирования потоков, можную систему фильтров (обрезка, | |
182 растяжение, зеркальное отражение, постобработка, поворот, масштабирование, шум, RGB/\:YUV преобразование) | |
183 и многое другое. | |
184 .PP | |
185 .B gmplayer | |
186 это MPlayer с графическим пользовательским интерфейсом. Он имеет те же опции, что и MPlayer. | |
187 .PP | |
188 Примеры использования, которые могут помочь вам быстро начать работу с MPlayer, можно найти в конце этого | |
189 руководства. | |
190 .PP | |
191 .B Смотрите также HTML документацию | |
192 . | |
193 . | |
194 .\" -------------------------------------------------------------------------- | |
195 .\" Интерактивное управление | |
196 .\" -------------------------------------------------------------------------- | |
197 . | |
198 .SH "ИНТЕРАКТИВНОЕ УПРАВЛЕНИЕ" | |
199 MPlayer имеет полность настраиваемый, основанный на командах, слой управления, который | |
200 позволяет вам управлять MPlayer'ом при помощи клавиатуры, мыши, джойстика или пульта | |
201 дистанционного управления (при помощи LIRC). | |
202 Смотрите описание опции \-input, для определения способов настройки. | |
203 . | |
204 .TP | |
205 .B управление клавиатурой | |
206 .PD 0 | |
207 .RS | |
208 .IPs "<\- и \->" | |
209 Перемотка назад/\:вперед на 10 секунд. | |
210 .IPs "up и down" | |
211 Перемотка вперед/\:назад на 1 минуту. | |
212 .IPs "pgup и pgdown" | |
213 Перемотка вперед/\:назад на 10 минут. | |
214 .IPs "[ и ]" | |
215 Уменьшает/увеличивает скорость воспроизведения на 10%. | |
216 .IPs "{ и }" | |
217 Вдвое меньшая/большая скорость воспроизведения. | |
218 .IPs "backspace" | |
219 Восстановливает нормальную скорость воспроизведения. | |
220 .IPs "< и >" | |
221 Перемещение назад/\:вперед по списку воспроизведения. | |
222 .IPs "ENTER" | |
223 Перемещение вперед по списку воспроизведение, даже за пределы списка. | |
224 .IPs "HOME и END" | |
225 Следующий/\:предыдущий элемент в родительском списке | |
226 .IPs "INS и DEL (только для списков ASX)" | |
227 Следующий/\:предыдущий из возможных источников. | |
228 .IPs "p / SPACE" | |
229 Пауза (повторное нажатие продолжает воспроизведение). | |
230 .IPs ".\ \ \ \ " | |
231 Кадр вперед. | |
232 Однократное нажатие приостанавливает воспроизведение, каждое последующее нажатие будет проигрывать | |
233 один кадр и снова возвращаться в режим паузы (любая другая клавиша продолжает воспроизведение). | |
234 .IPs "q / ESC" | |
235 Остановка воспроизведения и выход и программы. | |
236 .IPs "+ и -" | |
237 Изменить задержку аудио на +/- 0.1 секунды. | |
238 .IPs "/ и *" | |
239 Уменьшает/\:увеличивает громкость. | |
240 .IPs "9 и 0" | |
241 Уменьшает/\:увеличивает громкость. | |
242 .IPs "m\ \ \ \ " | |
243 Выключает звук. | |
244 .IPs "# (только для MPEG и Matroska)" | |
245 Циклически переключает доступные аудио дорожки. | |
246 .IPs "f\ \ \ \ " | |
247 Включает полноэкранный режим (смотрите также \-fs). | |
248 .IPs "T\ \ \ \ " | |
249 Включает режим `поверх всех окон` (также смотрите \-ontop). | |
250 .IPs "w и e" | |
251 Уменьшает/\:увеличивает диапазон pan-and-scan. | |
252 .IPs "o\ \ \ \ " | |
253 Изменяет режим OSD: нет / положение / положение + время / положение + время + общее время. | |
254 .IPs "d\ \ \ \ " | |
255 Изменяет режим выбрасывания кадров: нет / пропустить экран / пропустить декодирование | |
256 (смотрите \-framedrop и \-hardframedrop). | |
257 .IPs "v\ \ \ \ " | |
258 Изменяет видимость субтитров. | |
259 .IPs "b / j" | |
260 Циклически меняет доступные субтитры. | |
261 .IPs "y и g" | |
262 Перемещение вперед/назад по списку субтитров. | |
263 .IP "F\ \ \ \ " | |
264 Переключает отображения "форсированных субтиров". | |
265 .IPs "a\ \ \ \ " | |
266 Изменяет положение субтитров: верх / центр / низ. | |
267 .IPs "x и z" | |
268 Изменяет задeржку субтитров на +/- 0.1 секунды. | |
269 .IPs "r и t" | |
270 Перемещает субтитры вверх/вниз. | |
271 .IPs "i (только в режиме \-edlout)" | |
272 Устанавливает начало или конец EDL пропуска и записывает его в указанный файл. | |
273 .IPs "s (только для \-vf screenshot)" | |
274 Делает снимок экрана. | |
275 .IPs "I" | |
276 Показывет имя файла на OSD. | |
277 .IPs "! и @" | |
278 Перейти к началу предыдущего/следующего эпизода. | |
279 .RE | |
280 .PD 1 | |
281 .PP | |
282 .RS | |
283 (Следующие клавиши доступны только при использованиие аппаратно ускоренного видео вывода | |
284 (xv, (x)vidix, (x)mga, и т.д.), программного эквалайзера | |
285 (\-vf eq или \-vf eq2) или фильтра hue (\-vf hue). | |
286 .RE | |
287 .PP | |
288 .PD 0 | |
289 .RS | |
290 .IPs "1 и 2" | |
291 Настраивает контрастность. | |
292 .IPs "3 и 4" | |
293 Настраивает яркость. | |
294 .IPs "5 и 6" | |
295 Настраивает цветность. | |
296 .IPs "7 и 8" | |
297 Настраивает насыщенность. | |
298 .RE | |
299 .PD 1 | |
300 .PP | |
301 .RS | |
302 (Следующие клавиши доступны только при использовании видео драйверов quartz или macosx). | |
303 .RE | |
304 .PP | |
305 .PD 0 | |
306 .RS | |
307 .IPs "command + 0" | |
308 Изменяет размер окна до половины оригинального размера. | |
309 .IPs "command + 1" | |
310 Изменяет размер окна до оригинального. | |
311 .IPs "command + 2" | |
312 Устанавливает размер окна в два раза больше оригинального. | |
313 .IPs "command + f" | |
314 Переключает полноэканный режим (также смотрите \-fs). | |
315 .IPs "command + [ и command + ]" | |
316 Установливает прозрачность окна воспроизведения. | |
317 .RE | |
318 .PD 1 | |
319 .PP | |
320 .RS | |
321 (Следующие клавиши работают только при использовании клавиатуры с мультимедиа клавишами.) | |
322 .RE | |
323 .PP | |
324 .PD 0 | |
325 .RS | |
326 .IPs PAUSE | |
327 Пауза. | |
328 .IPs "STOP\ " | |
329 Остановить воспроизведение и выйти. | |
330 .IPs "PREVIOUS и NEXT" | |
331 Перемотать назад/\:вперед на 1 минуту. | |
332 .RE | |
333 .PD 1 | |
334 .PP | |
335 .RS | |
336 (Следующие клавиши работают только если MPlayer собран с поддержкой GUI и имеют | |
337 преимущество перед описанными выше клавишами.) | |
338 .RE | |
339 .PP | |
340 .PD 0 | |
341 .RS | |
342 .IPs ENTER | |
343 Начать воспроизведение. | |
344 .IPs "ESC\ \ " | |
345 Остановить воспроизведение. | |
346 .IPs "l\ \ \ \ " | |
347 Открыть файл. | |
348 .IPs "t\ \ \ \ " | |
349 Открыть субтитры. | |
350 .IPs "c\ \ \ \ " | |
351 Открыть браузер скинов. | |
352 .IPs "p\ \ \ \ " | |
353 Открыть список воспроизведения. | |
354 .IPs "r\ \ \ \ " | |
355 Открыть настройки. | |
356 .RE | |
357 .PD 1 | |
358 .PP | |
359 .RS | |
360 (Следуюшие комбинации клавиш работают, если MPlayer собран с поддержкой TV и имеют | |
361 преимущество перед описанными выше клавишами.) | |
362 .RE | |
363 .PP | |
364 .PD 0 | |
365 .RS | |
366 .IPs "h и k" | |
367 Выбрать предыдущий/\:следующий канал. | |
368 .IPs "n\ \ \ \ " | |
369 Выбрать стандарт вещания. | |
370 .IPs "u\ \ \ \ " | |
371 Выбрать таблицу каналов. | |
372 .RE | |
373 .PD 1 | |
374 . | |
375 .TP | |
376 .B управление мышью | |
377 .PD 0 | |
378 .RS | |
379 .IPs "button 3 и button 4" | |
380 Перемотка назад/\:вперед на 1 минуту. | |
381 .IPs "button 5 и button 6" | |
382 Уменьшает/\:увеличивает громкость. | |
383 .RE | |
384 .PD 1 | |
385 . | |
386 .TP | |
387 .B управление джойстиком | |
388 .PD 0 | |
389 .RS | |
390 .IPs "влево и вправо" | |
391 Перемотка назад/\:вперед на 10 секунд. | |
392 .IPs "up и down" | |
393 Перемотка назад/\:вперед на 1 минуту. | |
394 .IPs "button 1" | |
395 Пауза | |
396 .IPs "button 2" | |
397 Переключает режимы OSD: скрыто / положение / положение + время / положение + время + общее время. | |
398 .IPs "button 3 и button 4" | |
399 Уменьшить/\:увеличить громкость. | |
400 .RE | |
401 .PD 1 | |
402 . | |
403 . | |
404 .\" -------------------------------------------------------------------------- | |
405 .\" Использование | |
406 .\" -------------------------------------------------------------------------- | |
407 . | |
408 .SH "ИСПОЛЬЗОВАНИЕ" | |
409 Каждая опция 'flag' имеет противоположную по смыслу опцию 'noflag', например противоположные | |
410 по смыслу опции \-fs и \-nofs. | |
411 .PP | |
412 Если опции помечена как (только XXX), то она будет работать только в комбинации с опцией XXX, | |
413 если включена поддержка опции XXX. | |
414 .PP | |
415 .I ЗАМЕЧАНИЕ: | |
416 Разборщик подопций (используется, например, для \-ao pcm подопций) поддерживает | |
417 специальную формы выделения строк для использования со сторонними GUI. | |
418 .br | |
419 Она имеет следующий формат: | |
420 .br | |
421 %n%строка_длины_n | |
422 .br | |
423 .I ПРИМЕРЫ: | |
424 .br | |
425 mplayer \-ao pcm:file=%10%C:test.wav test.avi | |
426 .br | |
427 Или в программе: | |
428 .br | |
429 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi | |
430 .PP | |
431 . | |
432 .\" -------------------------------------------------------------------------- | |
433 .\" Файлы конфигурации | |
434 .\" -------------------------------------------------------------------------- | |
435 . | |
436 .SH "ФАЙЛЫ КОНФИГУРАЦИИ" | |
437 Вы можете поместить все опции в конфигурационные файлы, которые MPlayer/\:MEncoder | |
438 будет считывать при каждом запуске. | |
439 Системный файл конфигурации 'mplayer.conf' находится в системном каталоге конфигурации | |
440 (например /etc/\:mplayer или /usr/\:local/\:etc/\:mplayer), пользовательский - это | |
441 '~/\:.mplayer/\:config'. | |
442 Конфигурационный файл для MEncoder называется 'mencoder.conf' и находится в системном каталоге | |
443 (например /etc/\:mplayer или /usr/\:local/\:etc/\:mplayer), пользовательский - | |
444 '~/\:.mplayer/\:mencoder.conf. | |
445 Опции в пользовательском файле перекрывают системные, а опции командной строки перекрывают | |
446 заданные в конфигурационных файлах. | |
447 Синтаксис конфигурационного файла: 'option=<значение>', все символы после '#' считаются | |
448 комментарием. | |
449 Опции, не имеющие значений, могут быть включены присваиванием им значения 'yes','1' или 'true' и | |
450 выключены присваиванием 'no','0' или 'false'. | |
451 Подопции также могут быть заданы этим способом. | |
452 .PP | |
453 Вы можете задавать опции индивидуально для каждого файла. Если вы хотите иметь файл | |
454 конфигурации для 'movie.avi', создайте конфигурационный файл с именем 'movie.avi.conf' | |
455 и поместите его в ~/.mplayer/. Вы также можете поместить файл конфигурации в каталог с | |
456 проигрываемым файлом, при условии что указали опцию \-use\-filedir\-conf (либо в | |
457 командной строке, либо в глобальном файле конфигурации. | |
458 .PP | |
459 .I ПРИМЕР КОНФИГУРАЦИОННОГО ФАЙЛА MPLAYER: | |
460 .sp 1 | |
461 .nf | |
462 # Use Matrox driver by default. | |
463 vo=xmga | |
464 # I love practicing handstands while watching videos. | |
465 flip=yes | |
466 # Decode/encode multiple files from PNG, | |
467 # start with mf://filemask | |
468 mf=type=png:fps=25 | |
469 # Eerie negative images are cool. | |
470 vf=eq2=1.0:-0.8 | |
471 .fi | |
472 .PP | |
473 .I "ПРИМЕР КОНФИГУРАЦИОННОГО ФАЙЛА MENCODER:" | |
474 .sp 1 | |
475 .nf | |
476 # Make MEncoder output to a default filename. | |
477 o=encoded.avi | |
478 # The next 4 lines allow mencoder tv:// to start capturing immediately. | |
479 oac=pcm=yes | |
480 ovc=lavc=yes | |
481 lavcopts=vcodec=mjpeg | |
482 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000 | |
483 # more complex default encoding option set | |
484 lavcopts=vcodec=mpeg4:autoaspect=1 | |
485 lameopts=aq=2:vbr=4 | |
486 ovc=lavc=1 | |
487 oac=lavc=1 | |
488 passlogfile=pass1stats.log | |
489 noautoexpand=1 | |
490 subfont-autoscale=3 | |
491 subfont-osd-scale=6 | |
492 subfont-text-scale=4 | |
493 subalign=2 | |
494 subpos=96 | |
495 spuaa=20 | |
496 .fi | |
497 . | |
498 .\" -------------------------------------------------------------------------- | |
499 .\" Профили | |
500 .\" -------------------------------------------------------------------------- | |
501 . | |
502 .SH "ПРОФИЛИ" | |
503 Для облегчения работы с различными конфигурациями в конфигурационном файле могут быть | |
504 указаны несколько профилей. | |
505 Профиль начинается с имени, залюченного в квадратные скобки, например '[my-profile]'. | |
506 Все последующие опции будут считаться частью профиля. | |
507 Описание (отображаемое при помощи \-profile help) может быть задано опцией profile\-desc. | |
508 Для окончания профиля укажите имя другого профиля или используйте имя профиля 'default', | |
509 чтобы продолжить описание обычных опций. | |
510 .fi | |
511 .PP | |
512 .I "ПРИМЕР ПРОФИЛЯ MENCODER:" | |
513 .sp 1 | |
514 .nf | |
515 | |
516 [mpeg4] | |
517 profile-desc="MPEG4 encoding" | |
518 ovc=lacv=yes | |
519 lavcopts=vcodec=mpeg4:vbitrate=1200 | |
520 | |
521 [mpeg4-hq] | |
522 profile-desc="HQ MPEG4 encoding" | |
523 profile=mpeg4 | |
524 lavcopts=mbd=2:trell=yes:v4mv=yes | |
525 .fi | |
526 . | |
527 .\" -------------------------------------------------------------------------- | |
528 .\" Опции | |
529 .\" -------------------------------------------------------------------------- | |
530 . | |
531 .SH "ОСНОВНЫЕ ОПЦИИ" | |
532 . | |
533 .TP | |
534 .B \-codecs-file <имя файла> (смотрите также \-afm, \-ac, \-vfm, \-vc) | |
535 Переопределяет стандартный путь поиска и предписывает использовать указанный файл | |
536 вместо встроенного codecs.conf. | |
537 . | |
538 .TP | |
539 .B \-include <файл конфигурации> | |
540 Указывает файл конфигурации, который будет прочитан после анализа файла, используемого | |
541 по-умолчанию. | |
542 . | |
543 .TP | |
544 .B \-list-options | |
545 Печатает все доступные опции. | |
546 . | |
547 .TP | |
548 .B \-msgcharset <кодировка> | |
549 Преобразование сообщений консоли в указанную кодировку (по-умолчанию: автоопределение). | |
550 Текст будет в кодировке, заданной \-\-charset опцией configure. | |
551 Установите ее в "noconv" для отключения перекодировки (например при проблеме с iconv). | |
552 .br | |
553 .I ЗАМЕЧАНИЕ: | |
554 Опция вступает в силу после окончания анализа опций командной строки. | |
555 Переменная окружения MPLAYER_CHARSET модет помочь если выводится мусор в первых строках. | |
556 . | |
557 .TP | |
558 .B \-msglevel <all=<уровень>:<модуль>=<уровень>:...> | |
559 Управляет подробность вывода непосредственно для каждого модуля. | |
560 Значение, указанное для модуля 'all', изменяет подробность вывода для всех модулей, которым | |
561 параметр не задан явно. | |
562 Смотрите '\-msglevel help' для списка модулей. | |
563 .br | |
564 .I ЗАМЕЧАНИЕ: | |
565 Сообщения печатаемые до конца анализа командной строки могут контролироваться переменной | |
566 окружения MPLAYER_VERBOSE, котороая применяется ко всем модулям. | |
567 .br | |
568 Доступные уровни: | |
569 .PD 0 | |
570 .RSs | |
571 .IPs "-1" | |
572 отсутствие сообщений | |
573 .IPs " 0" | |
574 только фатальные ошибки | |
575 .IPs " 1" | |
576 ошибки | |
577 .IPs " 2" | |
578 предупреждения | |
579 .IPs " 3" | |
580 короткие подсказки | |
581 .IPs " 4" | |
582 информационные сообщения | |
583 .IPs " 5" | |
584 статусные сообщения (которые скрываются при помощи \-quiet) | |
585 .IPs " 6" | |
586 подробные сообщения | |
587 .IPs " 7" | |
588 уровень отладки 2 | |
589 .IPs " 8" | |
590 уровень отладки 3 | |
591 .IPs " 9" | |
592 уровень отладки 4 | |
593 .RE | |
594 .PD 1 | |
595 . | |
596 .TP | |
597 .B "\-quiet\ " | |
598 Делает консольный вывод менее подробным; в частности, прячет статусную строку | |
599 т.е.\& A: 0.7 V: 0.6 A-V: 0.068 ...). | |
600 Может быть полезно на медленных или неполноценных терминалах, которые некорректно обрабатывают | |
601 возврат каретки (т.е.\& \\r). | |
602 . | |
603 .TP | |
604 .B \-priority <prio> (только Windows) | |
605 Установить приоритет процесса MPlayer в соответствии с предопределенными приоритетами, доступными | |
606 под Windows. | |
607 Допустимые значения <prio>: | |
608 .RSs | |
609 idle|belownormal|normal|abovenormal|high|realtime | |
610 .RE | |
611 .sp 1 | |
612 .RS | |
613 .I ВНИМАНИЕ: | |
614 Использование приоритета realtime может привести к зависанию системы. | |
615 .RE | |
616 . | |
617 .TP | |
618 .B \-profile <профиль1,профиль2,...> | |
619 Предписывает использовать указанный профиль(и), \-profile help отображает список определенных | |
620 профилей. | |
621 . | |
622 .TP | |
623 .B \-really-quiet (смотрите также \-quiet) | |
624 Указывает отображать еще меньше сообщений, чем при использовании \-quiet. | |
625 . | |
626 .TP | |
627 .B \-show-profile <профиль> | |
628 Отображает описание и содержимое профиля. | |
629 . | |
630 .TP | |
631 .B \-use-filedir-conf | |
632 Ищет индивидуальный файл конфигурации фильма в каталоге из которого | |
633 фильм проигрывается. | |
634 .br | |
635 .I ВНИМАНИЕ: | |
636 Это может быть опасно при воспроизведении из источников, которым вы не доверяете. | |
637 . | |
638 .TP | |
639 .B "\-v\ \ \ \ \ " | |
640 Увеличитает подробность вывода на один уровень для каждой указанной \-v в командной строке. | |
641 . | |
642 . | |
643 . | |
644 .SH "ОПЦИИ ПРОИГРЫВАТЕЛЯ (ТОЛЬКО MPLAYER)" | |
645 . | |
646 .TP | |
647 .B \-autoq <качество> (используйте с \-vf [s]pp) | |
648 Динамически меняет уровень постобработки в зависимости от загруженности CPU. | |
649 Число, указанное вами, будет максимальным используемым уровнем. | |
650 Обычно можно использовать некоторое большое число. | |
651 Вы должны использовать \-vf [s]pp без параметров, чтобы это работало. | |
652 . | |
653 .TP | |
654 .B \-autosync <factor> | |
655 Постепенно подстраивает A/V синхронизацию на основе измерений задержки аудио. | |
656 Указание \-autosync 0 (по-умолчанию) указывает, что тайминг кадров будет основываться | |
657 исключительно на измерениях задержки аудио. | |
658 Указание \-autosync 1 делает то же самое, но внутренне меняет алгоритм A/V коррекции. | |
659 При непостоянности частоты кадров в фильме, прекрасно воспроизводящемся с опцией | |
660 \-nosound, обычно помогает установка этой опции в значения большие 1. | |
661 Чем выше значение, тем ближе к \-nosound будет тайминг. | |
662 Попробуйте \-autosync 30, чтобы смягчить проблемы со звуковыми драйверами, | |
663 которые не реализуют хорошего измерения задержки аудио. | |
664 С этим значением, если происходит большое расхождение A/V синхронизации, потребуется | |
665 около 1 или 2 секунд для исправления проблемы. | |
666 Задержка во времени реакции на внезапные сдвиги A/V должна быть | |
667 единственным побочным эффектом включения этой опции для всех звуковых драйверов. | |
668 . | |
669 .TP | |
670 .B \-benchmark | |
671 Выводит некоторую статистику об использовании CPU и пропущенных кадрах в | |
672 конце воспроизведения. Используйте в комбинации с \-nosound и \-vo null для | |
673 измерения производительности исключительно видео кодека. | |
674 .br | |
675 .I ЗАМЕЧАНИЕ: | |
676 С этой опцией MPlayer будет игнорировать продолжительность кадров при | |
677 проигрывании только видео (можете думать об этом, как о бесконечном fps). | |
678 . | |
679 .TP | |
680 .B \-colorkey <число> | |
681 Изменяет colorkey на указанное вами RGB значение. | |
682 0x000000 это черный, а 0xffffff \- белый. | |
683 Поддерживается только для cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix, | |
684 xover, xv (смотри \-vo xv:ck), xvmc (смотри \-vo xv:ck) и directx драйверами вывода. | |
685 . | |
686 .TP | |
687 .B \-nocolorkey | |
688 Отлючает механизм colorkey. | |
689 Поддерживается только cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix, | |
690 xover, xv (смотри \-vo xv:ck), xvmc (смотри \-vo xv:ck) и directx драйверами вывода. | |
691 . | |
692 .TP | |
693 .B \-correct-pts (экспериментальное) | |
694 Переключает MPlayer в экспериментальный режим, в котором тайминг | |
695 видео кадров рассчитываются независимо, и тем самым поддерживаются видео фильтры, | |
696 добавляющие новые кадры или меняющие тайминг существующих. | |
697 Более точный тайминг может быть заметен, например, при воспроизведении с опцией \-ass | |
698 субтитров, привязанных к смене сцены, | |
699 .\" FIXME is translation correct ? | |
700 .\" Without \-correct-pts the subtitle timing will typically be off by some frames. | |
701 Без \-correct-pts тайминг субтитров, как правило, будет отключен некоторыми кадрами. | |
702 С некоторыми демуксерами и кодеками эта опция работает некоректно. | |
703 | |
704 . | |
705 .TP | |
706 .B \-crash-debug (КОД ОТЛАДКИ) | |
707 Автоматически запускает gdb в случае краха или SIGTRAP. | |
708 Поддержка дожна быть скомпилирована при помощи опции \-\-enable\-crash\-debug. | |
709 . | |
710 .TP | |
711 .B \-edlout <файл> | |
712 Создает новый файл и выводит в него записи списка решений редактирования (EDL). | |
713 При воспроизведении, пользователь нажимает 'i', чтобы отметить начало и конец | |
714 пропускаемого блока. Это создает основу для последующей тонкой настройки | |
715 эдементов EDL. Подробности смотрите на | |
716 http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:edl.html. | |
717 . | |
718 .TP | |
719 .B \-enqueue (только GUI) | |
720 Добавляет файлы, указанные в командной строке, в список воспроизведения вместо | |
721 немедленного их проигрывания. | |
722 . | |
723 .TP | |
724 .B \-fixed-vo | |
725 Принуждает использовать фиксированнцю систему видео для многих файлов | |
726 (одна (де)инициализация для всех файлов). | |
727 Тпким образом для всех файлов будет открыто только одно окно. | |
728 Н данный момент следующие драйвера поддерживают fixed-vo: gl, gl2, mga, svga, x11, | |
729 xmga, xv, xvidix и dfbmga. | |
730 . | |
731 .TP | |
732 .B \-framedrop (смотрите также \-hardframedrop) | |
733 Указываеть пропускать отображение некоторых кадров для управления A/V синхронизацией на | |
734 медленных системах. Видео фильтры не применяются для таких кадров. Для В-кадров | |
735 не выполняется даже декодирование. | |
736 . | |
737 .TP | |
738 .B \-(no)gui | |
739 Включает или выключает GUI интерфейс (значение по-умолчанию зависит от имени исполняемого | |
740 файла). Работает только как первый параметр командной строки. Не работает в | |
741 файле конфигурации. | |
742 . | |
743 .TP | |
744 .B \-h, \-help, \-\-help | |
745 Показывает краткую информацию об опциях. | |
746 . | |
747 .TP | |
748 .B \-hardframedrop | |
749 Более интенсивный пропуск кадров (нарушает декодирование). | |
750 Ведет к искажению изображения! | |
751 . | |
752 .TP | |
753 .B \-identify | |
754 Краткая форма для \-msglevel identify=4 | |
755 Показывает параметры файлов в удобном для анализа формате. | |
756 Также печатает более подробную информацию о субтитрах, языках и идентификаторах | |
757 аудио дорожек. В некоторых случаях вы можете получить больше информации, используя | |
758 \-msglevel identify=6. | |
759 Для DVD, например, это отобразит длину каждого заголовка и ID диска. | |
760 Скрипт TOOLS/\:midentify подавляет остальной вывод MPlayer и (успешно) экранирует | |
761 имена файлов. | |
762 . | |
763 .TP | |
764 .B \-idle (смотрите также \-slave) | |
765 Если не осталось больше файлов для воспроизведения, MPlayer будет ждать вместо | |
766 завершения работы. Весьма полезно при запуске в подчиненном режиме, когда MPlayer | |
767 управляется через команды. | |
768 . | |
769 .TP | |
770 .B \-input <команды> | |
771 Эта опция может использоваться для настройки некоторых параметроа системы ввода. | |
772 Пути указываются относительно к ~/.mplayer/. | |
773 .br | |
774 .I ЗАМЕЧАНИЕ: | |
775 Автоповтор в данный момент поддерживается только для джойстиков. | |
776 .sp 1 | |
777 Доступные команды: | |
778 .sp 1 | |
779 .PD 0 | |
780 .RSs | |
781 .IPs conf=<имя_файла> | |
782 Указывает файл конфигурации системы ввода, отличный от установленного по-умолчанию | |
783 ~/\:.mplayer/\:input.conf. | |
784 ~/\:.mplayer/\:<имя_файла> подразумевается, если не указан полный путь. | |
785 .IPs ar-delay | |
786 Задержка в миллисекундах перед началом автоповтора (0 для отключения). | |
787 .IPs ar-rate | |
788 Количество клавиш в секунду, генерируемых при автоповторе. | |
789 .IPs keylist | |
790 Выводит все клавиши, которые можно назначить командам. | |
791 .IPs cmdlist | |
792 выводит все команды, которые можно назначить клавишам. | |
793 .IPs js-dev | |
794 Указвает какое устройство использовать в качестве джойстика (по-умрочанию: /dev/\:input/\:js0). | |
795 .IPs file=<filename> | |
796 Указывает читать команды из файла. Используется для работы с FIFO. | |
797 .br | |
798 .I ЗАМЕЧАНИЕ: | |
799 Если указанный файл является FIFO, MPlayer открывает обе стороны, позволяя вам | |
800 выполнить несколько 'echo "seek 10" > mp_pipe', оставляя канал рабочим. | |
801 .RE | |
802 .PD 1 | |
803 . | |
804 .TP | |
805 .B \-key-fifo-size <2\-65000> | |
806 Указывает размер FIFO, буферизуюшей события клавиатуры (по-умолчанию: 10). | |
807 FIFO размера n может буферизовать (n-1) событие. | |
808 Если это значение мало, некоторые события могут быть потеряны | |
809 (что приводит к "залипанию кнопок мыши" и похожим эффектам). | |
810 Если оно велико, MPlayer может выглядеть зависшим во время обработки буферизованных | |
811 событий. Чтобы обеспечить поведение программы по-умолчанию, установите | |
812 значение в 2 для Linux или 1024 для Windows. | |
813 . | |
814 .TP | |
815 .B \-lircconf <имя_файла> (только LIRC) | |
816 Указывает файл конфигурации для LIRC (по-умолчанию: ~/.lircrc). | |
817 . | |
818 .TP | |
819 .B \-list-properties | |
820 Печатает список доступных свойств. | |
821 . | |
822 .TP | |
823 .B \-loop <число> | |
824 Проигрывает фильм указанное число раз подряд. 0 \- значит бесконечно. | |
825 . | |
826 .TP | |
827 .B \-menu (только OSD меню) | |
828 Включает поддержку OSD меню. | |
829 . | |
830 .TP | |
831 .B \-menu-cfg <имя_файла> (только OSD меню) | |
832 Указывает использовать другой файл вместо menu.conf. | |
833 . | |
834 .TP | |
835 .B \-menu-root <значение> (только OSD меню) | |
836 Указывает основное меню. | |
837 . | |
838 .TP | |
839 .B \-menu-startup (только OSD меню) | |
840 Показывает основное меню при запуске MPlayer. | |
841 . | |
842 .TP | |
843 .B \-mouse-movements | |
844 Позволяет MPlayer получать события указателя мыши, генерируемые | |
845 драйвером вывода видео (в данный момент поддерживаются только производные X11). | |
846 Необходимо для выбора кнопок в DVD меню. | |
847 . | |
848 .TP | |
849 .B \-noconsolecontrols | |
850 Не допускает чтение событий клавиатуры со стандартного входа программой MPlayer. | |
851 Полезно при чтении данных со стандартного входа. | |
852 Включается автоматичество, если в командной строке найдено \-. | |
853 Есть ситуации, когда нужно установить это вручную, например | |
854 если вы открываете /dev/\:stdin (или аналогичный в вашей системе), используете stdin | |
855 в списке воспроизведения или собираетесь читать из stdin позже командами loadfile или | |
856 loadlist. | |
857 . | |
858 .TP | |
859 .B \-nojoystick | |
860 Отключает поддержку джойстика. | |
861 . | |
862 .TP | |
863 .B \-nolirc | |
864 Отключает поддержку LIRC. | |
865 . | |
866 .TP | |
867 .B \-nomouseinput (только X11) | |
868 Отключает события нажатия/\:отпускания кнопок мыши (контекстное меню | |
869 mozplayerxp полагается на эту опцию). | |
870 . | |
871 .TP | |
872 .B \-rtc (только RTC) | |
873 Включает использование Linux RTC (часов реального времени - /dev/\:rtc) как механизма | |
874 синхронизации. | |
875 Это приводит к пробуждению процессс каждую 1/1024 секунды для проверки текущего времени. | |
876 Бесполезно с современныеми ядрами Linux, настроенными для десктопа, поскольку | |
877 они уже пробуждают процесс со сравнимой точностью при использовании обычного | |
878 способа засыпания. | |
879 . | |
880 .TP | |
881 .B \-playing-msg <строка> | |
882 Выводит строку перед началом воспроизведенияю | |
883 Поддерживаются следующие расширения: | |
884 .RSs | |
885 .IPs ${NAME} | |
886 Заменяется на значение свойства NAME. | |
887 .IPs $(NAME:TEXT) | |
888 Заменяется на TEXT только если доступно свойство NAME. | |
889 .RE | |
890 . | |
891 .TP | |
892 .B \-playlist <имя_файла> | |
893 Воспроизводит файлы в соответствии со списком (ASX, Winamp, SMIL, или | |
894 по-одному-файлу-в-строке формата). | |
895 .br | |
896 .I ЗАМЕЧАНИЕ: | |
897 Опция считается элементом, так что все последующие опции будут применяться только к | |
898 элементам списка воспроизведения. | |
899 .br | |
900 FIXME: Это требует тщательного разъяснения и описания. | |
901 . | |
902 .TP | |
903 .B \-rtc-device <устройство> | |
904 Указывает использовать указанное устройство для RTC тайминга. | |
905 . | |
906 .TP | |
907 .B \-shuffle | |
908 Проигрывает файлы в случайном порядке. | |
909 . | |
910 .TP | |
911 .B \-skin <название> (только GUI) | |
912 Загружает скин из каталога, указанного в качестве параметра, находящегося | |
913 в одном из стандартных каталогов со скинами, | |
914 /usr/\:local/\:share/\:mplayer/\:skins/\: и ~/.mplayer/\:skins/. | |
915 .sp 1 | |
916 .I ПРИМЕР: | |
917 .PD 0 | |
918 .RSs | |
919 .IPs "\-skin fittyfene" | |
920 Пробуется /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene | |
921 и затем ~/.mplayer/\:skins/\:fittyfene. | |
922 .RE | |
923 .PD 1 | |
924 . | |
925 .TP | |
926 .B \-slave (смотрите также \-input) | |
927 Включает "рабский" режим, в котором MPlayer работает в качестве бэкэнда к другим программам. | |
928 Вместо перехвата событий клавиатуры, MPlayer будет читать со стандартного входа команды, | |
929 разделенные символом новой строки (\\n). | |
930 .br | |
931 .I ЗАМЕЧАНИЕ: | |
932 Смотрите список этох команд в \-input cmdlist и описания в DOCS/tech/slave.txt. | |
933 . | |
934 .TP | |
935 .B \-softsleep | |
936 .\" FIXME is translation correct? | |
937 .\" Time frames by repeatedly checking the current time instead of asking the | |
938 Устанавливает тайминг кадров, постоянно проверяя текущее время, вместо просьбы | |
939 ядру пробуждать MPlayer в нужный момент. | |
940 Полезно, если таймер вашего ядра неточен и вы не можете использовать RTC. | |
941 Дается ценой повышенной нагрузки на CPU. | |
942 . | |
943 .TP | |
944 .B \-sstep <сек> | |
945 Пропускать <сек> секунд после каждого кадра. | |
946 Сохраняется оригинальная частота кадров, так что вопроизведение ускоряется. | |
947 Т.к. MPlayer может перемещаться только по ключевым кадрам, то значение | |
948 может оказаться неточным. | |
949 . | |
950 . | |
951 . | |
952 .SH "ОПЦИИ ДЕМУКСЕРА/ПОТОКА" | |
953 . | |
954 .TP | |
955 .B \-a52drc <уровень> | |
956 .\" нужен ли перевод DRC ? | |
957 Выбирает уровень Dynamic Range Compression[Сжатие Динамического Диапазона] для | |
958 аудио потоков AC3. <уровень> - это вещественное число от 0 до 1, где 0 означает | |
959 отсутствие сжатия, а 1 (по-умолчанию) означает полное сжатие (делает громкие звуки | |
960 более тихими и наоборот). | |
961 Эта опция действует, только если AC3 поток содержит необходимую информацию | |
962 сжатия диапазона. | |
963 . | |
964 .TP | |
965 .B \-aid <ID> (смотрите также \-alang) | |
966 Выбирает аудио канал (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127, | |
967 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190). | |
968 MPlayer выводит все доступные аудио ID, когда запущен в режиме | |
969 побробного вывода сообщений (\-v). | |
970 При воспроизведении MPEG-TS потока, MPlayer/\:MEncoder будет использовать | |
971 первую программу (если существует) с выбранным аудио потоком. | |
972 . | |
973 .TP | |
974 .B \-alang <код языка[,код языка,...]> (смотрите также \-aid) | |
975 Указывает список используемых языков в порядке приоритетности. | |
976 Различные форматы файлов используют различные коды языков. | |
977 DVD используют ISO 639-1 двухбуквенные коды, Matroska и NUT используют ISO 639-2 | |
978 трехбуквенные коды языков, в то время как OGM использует идентификаторы в свободной форме. | |
979 MPlayer выводит доступные языки, когда запущен в режиме вывода подробных сообщений (\-v). | |
980 .sp 1 | |
981 .I ПРИМЕР: | |
982 .PD 0 | |
983 .RSs | |
984 .IPs "mplayer dvd://1 \-alang hu,en" | |
985 Выбирает Венгерскую языковую дорожку на DVD и возвращается обратно к Аглийскому, если | |
986 Венгерский недоступен. | |
987 .IPs "mplayer \-alang jpn example.mkv" | |
988 Воспроизводит файл Matroska на Японском. | |
989 .RE | |
990 .PD 1 | |
991 . | |
992 .TP | |
993 .B \-audio-demuxer <[+]name> (только \-audiofile) | |
994 Принудительно устанавливает тип демуксера для \-audiofile. | |
995 Используйте '+' перед именем для принудительного выбора, это пропустит некоторые проверки! | |
996 Передайте название демуксера таким, каким оно выводится опцией \-audio-demuxer help. | |
997 Для обратной совместимости эта опция также принимает ID демуксера, указанный в | |
998 libmpdemux/\:demuxer.h. | |
999 \-audio-demuxer audio или \-audio-demuxer 17 принудительно устанавливает MP3. | |
1000 . | |
1001 .TP | |
1002 .B \-audiofile <имя файла> | |
1003 Воспроизводит аудио из внешнего файла (WAV, MP3 или Ogg Vorbis) при просмотре фильма. | |
1004 . | |
1005 .TP | |
1006 .B \-audiofile-cache <кБайт> | |
1007 Включает кеширование файла, указанного опцией \-audiofile, используя указанное количество | |
1008 памяти. | |
1009 . | |
1010 .TP | |
1011 .B \-bandwidth <значение> (только сеть) | |
1012 Указывает максимальную пропускную способность для сетевого вещания (для | |
1013 серверов, способных отдавать контент с различным битпотоком). | |
1014 Полезно, если вы хотите смотреть потоковую трансляцию при медленном соединении. | |
1015 При Real RTSP вещании, она также используется для установки максимальной | |
1016 пропускной способности для получения потока, позволяя быстрее заполнять кеш | |
1017 и сохранять поток. | |
1018 . | |
1019 .TP | |
1020 .B \-cache <килобайт> | |
1021 Эта опция указывает какое количество памяти (в килобайтах) использовать при | |
1022 предварительном кешировании файла или URL. | |
1023 Особенно полезно на медленных носителях. | |
1024 . | |
1025 .TP | |
1026 .B \-nocache | |
1027 Отключает кеширование. | |
1028 . | |
1029 .TP | |
1030 .B \-cache-min <процент> | |
1031 Воспроизведение начнется, когда кеш будет заполнен на <процент> процентов | |
1032 от полного размера. | |
1033 . | |
1034 .TP | |
1035 .B \-cache-seek-min <процент> | |
1036 Если производится попытка перемотать фильм на позицию в пределах | |
1037 величины <процент> от размера кеша, MPlayer будет ждать заполнения кеша до | |
1038 этой позиции вместо осуществления перемещения по потоку (по-умолчанию: 50). | |
1039 . | |
1040 .TP | |
1041 .B \-cdda <опция1:опция2> (только CDDA) | |
1042 Эта опция может использоваться для тонкой настройки возможности чтения CD Audio. | |
1043 .sp 1 | |
1044 Доступные опции: | |
1045 .RSs | |
1046 .IPs speed=<значение> | |
1047 Устанавливает скорость вращения CD. | |
1048 .IPs paranoia=<0\-2> | |
1049 Устанавливает уровень paranoia. | |
1050 Значения, отличные от нуля, похоже нарушают воспроизведение всего, кроме первой дорожки. | |
1051 .RSss | |
1052 0: отключает проверку (по-умолчанию) | |
1053 .br | |
1054 1: проверка только наложения | |
1055 .br | |
1056 2: полная коррекция и проверка данных | |
1057 .REss | |
1058 .IPs generic-dev=<значение> | |
1059 Указывает использовать указанное SCSI устройство. | |
1060 .IPs sector-size=<значение> | |
1061 Устанавливает атомарный размер чтения. | |
1062 .IPs overlap=<значение> | |
1063 Принудительно устанавливает минимальный поиск перекрытия в <значение> | |
1064 секторов. | |
1065 .IPs toc-bias | |
1066 Указывает предполагать, что смещение начала дорожки 1, указанной в TOC, | |
1067 адресуется как LBA 0. | |
1068 Это требуется для некоторых устройств Toshiba, чтобы стали правильными | |
1069 границы дорожек. | |
1070 .IPs toc-offset=<значение> | |
1071 Добавляет <значение> секторов к значению, выдаваемому при адресаци дорожек. | |
1072 Может быть отрицательным. | |
1073 .IPs (no)skip | |
1074 (Никогда не) допускает неполную реконструкию данных. | |
1075 .RE | |
1076 . | |
1077 .TP | |
1078 .B \-cdrom-device <путь к устройству> | |
1079 Указывает устройство CD-ROM (по-умолчанию: /dev/\:cdrom). | |
1080 . | |
1081 .TP | |
1082 .B \-channels <число> (смотрите также \-af channels) | |
1083 Запрашивает количество каналов воспроизведения (по-умолчанию: 2). | |
1084 MPlayer просит декодер декодировать звук в указанное количество каналов. | |
1085 Выполнение задачи ложится на плечи декодера. | |
1086 Обычно это требуется только при воспроизведении видео с AC3 звуком (например DVD). | |
1087 В этом случае liba52 выполняет декодирование как обычно и корректно сводит | |
1088 звук в запрошенное количество каналов. | |
1089 Для прямого управления количеством выходных каналов независимо от количества декодируемых, | |
1090 используйте фильтр channels. | |
1091 .br | |
1092 .I ЗАМЕЧАНИЕ: | |
1093 Эта опция учитывается кодеками (только AC3), фильтрами (surround) и драйверами вывода | |
1094 звука (как минимум OSS). | |
1095 .sp 1 | |
1096 Доступные опции: | |
1097 .sp 1 | |
1098 .PD 0 | |
1099 .RSs | |
1100 .IPs 2 | |
1101 stereo | |
1102 .IPs 4 | |
1103 surround | |
1104 .IPs 6 | |
1105 full 5.1 | |
1106 .RE | |
1107 .PD 1 | |
1108 . | |
1109 .TP | |
1110 .B \-chapter <ID раздела>[\-<ID посл. раздела>] (только dvd:// и dvdnav://) | |
1111 Указывает с какого раздела начать воспроизведение. | |
1112 Опционально указывает каким разделом закончить воспроизведение (по-умолчанию: 1). | |
1113 . | |
1114 .TP | |
1115 .B \-cookies (только сеть) | |
1116 Указывает отправлять cookie при выполнении HTTP запросов. | |
1117 . | |
1118 .TP | |
1119 .B \-cookies-file <файл> (только сеть) | |
1120 Читает HTTP cookie из файла <файл> (по-умолчанию: ~/.mozilla/ и ~/.netscape/) | |
1121 и пропускает чтение из стандартных мест. | |
1122 Предполагается файл в формате Netscape. | |
1123 . | |
1124 .TP | |
1125 .B \-delay <сек> | |
1126 Задержка аудио в секундах (положительное или отрицательное вещественное число) | |
1127 .br | |
1128 .I ЗАМЕЧАНИЕ: | |
1129 При использовании с MEncoder не гарантируется правильная работу с \-ovc copy; | |
1130 используйте вместо этого \-audio\-delay. | |
1131 . | |
1132 .TP | |
1133 .B \-ignore-start | |
1134 Игнорирует указанное время начала для потоков в AVI файлах. | |
1135 В MPlayer это обнуляет задержки потоков в файлах, кодированных с | |
1136 опцией \-audio\-delay. В процессе кодирования эта опция предотвращает | |
1137 перенос программой MEncoder времени начала из оригинального файла в кодируемый; | |
1138 опция \-audio-delay не затрагивается. | |
1139 Имейте в виду, что Mencoder иногда автоматически исправляет время начала потока | |
1140 для компенсации ожидаемых задержек декодирования, так что никогда | |
1141 не используйте эту опцию при кодировании без предварительного тестирования. | |
1142 . | |
1143 .TP | |
1144 .B \-demuxer <[+]name> | |
1145 Устанавливает тип демуксера. | |
1146 Используйте '+' перед названием для принудительной установки, это пропустит некоторые проверки! | |
1147 Передайте название демуксера как оно выводится пр помощи \-demuxer help. | |
1148 Для обратной совместимости она также принимает ID демуксера, определенного в | |
1149 libmpdemux/\:demuxer.h. | |
1150 \-demuxer audio или \-demuxer 17 устанавливает MP3. | |
1151 . | |
1152 .TP | |
1153 .B \-dumpaudio (только MPlayer) | |
1154 Сохранает сырой сжатый аудио поток в ./stream.dump (полезно с MPEG/\:AC3). | |
1155 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1156 \-dumpstream, будет использоваться только последняя. | |
1157 . | |
1158 .TP | |
1159 .B \-dumpfile <файл> (только MPlayer) | |
1160 Указывает в какой файл должно происходить сохранение. | |
1161 Следует использовать вместе с \-dumpaudio / \-dumpvideo / \-dumpstream. | |
1162 . | |
1163 .TP | |
1164 .B \-dumpstream (только MPlayer) | |
1165 Сохраняет сырой поток в ./stream.dump. | |
1166 Полезно при рипе с DVD или сети. | |
1167 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1168 \-dumpstream, будет использоваться только последняя. | |
1169 . | |
1170 .TP | |
1171 .B \-dumpvideo (только MPlayer) | |
1172 Сохраняет сырой сжатый видео поток в ./stream.dump (не очень пригодно). | |
1173 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1174 \-dumpstream, будет использоваться только последняя. | |
1175 . | |
1176 .TP | |
1177 .B \-dvbin <options> (только DVB) | |
1178 Передает следующие параметры модулю DVB, для переопределения стандартных: | |
1179 .sp 1 | |
1180 .PD 0 | |
1181 .RSs | |
1182 .IPs card=<1\-4> | |
1183 Указывает номер используемой карты 1\-4 (default: 1). | |
1184 .IPs file=<файл> | |
1185 Указывает MPlayer читать список каналов из файла <файл>. | |
1186 По-умолчанию: ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (в зависимости от типа карты) | |
1187 или ~/.mplayer/\:channels.conf. | |
1188 .IPs timeout=<1\-30> | |
1189 Максимальное количество секунд ожидания настройки на частоту перед началом воспроизведения | |
1190 (по-умолчанию: 30). | |
1191 .RE | |
1192 .PD 1 | |
1193 . | |
1194 .TP | |
1195 .B \-dvd-device <путь к устройству> (только DVD) | |
1196 Указывает устройство DVD (по-умолчанию: /dev/\:dvd). | |
1197 Вы также можете указать каталог, содержащий файлы, предварительно скопированные | |
1198 непосредственно с DVD (например, с помощью vobcopy). | |
1199 Заметьте, что для копирования роликов DVD, как правило, лучше использовать \-dumpstream | |
1200 (смотрите примеры). | |
1201 . | |
1202 .TP | |
1203 .B \-dvdangle <ID угла> (только DVD) | |
1204 Некоторые DVD диски содержат сцены, которые можно смотреть с разных углов. | |
1205 Здесь вы можете указать MPlayer какой угол использовать (по-умолчанию: 1). | |
1206 . | |
1207 .TP | |
1208 .B \-edl <файл> | |
1209 Задействует действия списка решений редактирования (EDL) при воспроизведении. | |
1210 Видео будет пропущено или звук будет включен/\:выключен в соответствии с | |
1211 записями в указанном файле. | |
1212 Смотрите http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:edl.html для подробностей об | |
1213 использовании этих файлов. | |
1214 . | |
1215 .TP | |
1216 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (смотрите также \-ss и \-sb) | |
1217 Останавливает воспроизведение в указанное время или байтовой позиции. | |
1218 .br | |
1219 .I ЗАМЕЧАНИЕ: | |
1220 Бйтовая позиция задействуется только для MEncoder и будет не очень точной, поскольку | |
1221 остановка возможна только на границе кадра. | |
1222 При использовании совместно с опцией \-ss, время \-endpos будет сдвинуто вперед на | |
1223 указанное с помощью \-ss количество секунд. | |
1224 .sp 1 | |
1225 .I ПРИМЕР: | |
1226 .PD 0 | |
1227 .RSs | |
1228 .IPs "\-endpos 56" | |
1229 Остановиться на 56 секунде. | |
1230 .IPs "\-endpos 01:10:00" | |
1231 Остановиться через 1 час 10 минут. | |
1232 .IPs "\-ss 10 \-endpos 56" | |
1233 Остановиться на позиции 1 минута 6 секунд. | |
1234 .IPs "\-endpos 100mb" | |
1235 Кодировать только 100 Мб. | |
1236 .RE | |
1237 .PD 1 | |
1238 . | |
1239 .TP | |
1240 .B \-forceidx | |
1241 Принудительно перестраивает индекс. | |
1242 Полезно для файлов с испорченным индексом (A/V рассинхронизация, и т.п.). | |
1243 Это позволит перемещаться по файлу, в которм перемещение было невозможно. | |
1244 Вы можете исправить индекс в самом файле при помощи MEncoder (смотрите документацию). | |
1245 .br | |
1246 .I ЗАМЕЧАНИЕ: | |
1247 Опция работает, только если лежащее в основе медиа позволяет перемещение | |
1248 (т.е.\& не с stdin, pipe, т.д.). | |
1249 . | |
1250 .TP | |
1251 .B \-fps <вещественное значение> | |
1252 Переопределяет частоту кадров. | |
1253 Полезно, если оригинальное значение неверно или отсутствует. | |
1254 . | |
1255 .TP | |
1256 .B \-frames <число> | |
1257 Воспроизводит/\:конвертирует только первое <число> кадров, затем выходит. | |
1258 . | |
1259 .TP | |
1260 .B \-hr-mp3-seek (только MP3) | |
1261 Точное перемещение по MP3. | |
1262 Включается при воспроизведении из внешнего MP3 файла, как только требуется очень точное | |
1263 перемещение к позиции для сохранения A/V синхронизации.. | |
1264 Может быть медленным, особенно при перемещении назад, поскольку необходимо | |
1265 переместиться к началу для поиска точной позиции кадра. | |
1266 . | |
1267 .TP | |
1268 .B \-idx (смотрите также \-forceidx) | |
1269 Перестраивает индекс файла, если таковой не был найден, позволяя осуществлять перемещение. | |
1270 Полезно с испорченными/\:неполностью скачанными или неверно созданными файлами. | |
1271 .br | |
1272 .I ЗАМЕЧАНИЕ: | |
1273 Опция работает только если лежащее в основе медиа позволяет перемещение | |
1274 (т.е.\& не с stdin, pipe, т.д.). | |
1275 . | |
1276 .TP | |
1277 .B \-ipv4-only-proxy (только сеть) | |
1278 Указывает не использовать прокси для IPv6 адресов. | |
1279 Он по-прежнему будет использоваться для IPv4 соединений. | |
1280 . | |
1281 .TP | |
1282 .B \-loadidx <индексный файл> | |
1283 Файл из которого следует читать данные индекса видео, сохраненные \-saveidx. | |
1284 Этот индекс будет использоваться для перемещения, переопределяя любые | |
1285 индексные данные, содержащиеся в самом AVI. | |
1286 MPlayer не запрещает загрузку индексного файла, созданного по другому AVI фильму, но | |
1287 это обязательно приведет к неприятным результатам. | |
1288 .br | |
1289 .I ЗАМЕЧАНИЕ: | |
1290 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML. | |
1291 . | |
1292 .TP | |
1293 .B \-mc <секунд/кадр> | |
1294 Максимальная величина корректировки A-V синхронизации на один кадр (в секундах) | |
1295 . | |
1296 .TP | |
1297 .B \-mf <опция1:опция2:...> | |
1298 Используется при кодировании из нескольких PNG или JPEG файлов. | |
1299 .sp 1 | |
1300 Доступные опции: | |
1301 .sp 1 | |
1302 .PD 0 | |
1303 .RSs | |
1304 .IPs w=<значение> | |
1305 ширина входного файла (по-умолчанию: автоопределение) | |
1306 .IPs h=<значение> | |
1307 высота входного файла (по-умолчанию: автоопределение) | |
1308 .IPs fps=<значение> | |
1309 fps результата (по-умолчанию: 25) | |
1310 .IPs type=<значение> | |
1311 тип входного файла (доступны: jpeg, png, tga, sgi) | |
1312 .RE | |
1313 .PD 1 | |
1314 . | |
1315 .TP | |
1316 .B \-ni (только AVI) | |
1317 Принуждает использовать обработчик нечередующегося AVI | |
1318 (исправляет воспроизведение некоторых плохих AVI файлов). | |
1319 . | |
1320 .TP | |
1321 .B \-nobps (только AVI) | |
1322 Указывает не использовать среднее значение байт/\:секунду для | |
1323 A-V синхронизации. Помогает для некоторых AVI файлов с испорченным заголовком. | |
1324 . | |
1325 .TP | |
1326 .B \-noextbased | |
1327 Отключает выбор демуксера на основе расширения файла. | |
1328 По-умолчанию, когда тип файла (демуксер) не может быть достоверно определен | |
1329 (файл не имеет заголовка, или он недостаточно достоверен), для выбора | |
1330 демуксера будет использовано расширение файла. | |
1331 Опция указывает всегда использовать содержимое файла для определения демуксера. | |
1332 . | |
1333 .TP | |
1334 .B \-passwd <пароль> (смотрите также see \-user) (только сеть) | |
1335 Указывает пароль для HTTP аутентификации. | |
1336 . | |
1337 .TP | |
1338 .B \-prefer-ipv4 (только сеть) | |
1339 Использует IPv4 для сетевых соединений. | |
1340 При необходимости автоматически используется IPv6. | |
1341 . | |
1342 .TP | |
1343 .B \-prefer-ipv6 (только IPv6 сеть) | |
1344 Использует IPv6 для сетевых соединений. | |
1345 При необходимости автоматически используется IPv4. | |
1346 . | |
1347 .TP | |
1348 .B \-pvr <опция1:опция2:...> (только PVR) | |
1349 Эта опция настраивает различные свойства кодирования модуля PVR. | |
1350 Она должна использоваться с любой картой на основе аппаратного MPEG | |
1351 кодера, совместимого с драйвером V4L2. | |
1352 Hauppauge WinTV PVR\-150/250/350/500 и все карты, основанные на IVTV, | |
1353 известны как PVR карты захвата. Знайте, что только ядра Linux старше 2.6.18 | |
1354 способны обрабатывать MPEG поток через слой V4L2. | |
1355 Для аппаратного захвата MPEG потока и его просмотра с MPlayer/MEncoder, | |
1356 используйте 'pvr://' в качестве URL фильма. | |
1357 .sp 1 | |
1358 Доступные опции: | |
1359 .RSs | |
1360 .IPs aspect=<0\-3> | |
1361 Указывает входные пропорции: | |
1362 .RSss | |
1363 0: 1:1 | |
1364 .br | |
1365 1: 4:3 (по-умолчанию) | |
1366 .br | |
1367 2: 16:9 | |
1368 .br | |
1369 3: 2.21:1 | |
1370 .REss | |
1371 .IPs arate=<32000\-48000> | |
1372 Указывает частоту дискретизации звука (по-умолчанию: 48000 Гц, доступны: 32000, 44100 | |
1373 и 48000 Гц). | |
1374 .IPs alayer=<1\-3> | |
1375 Указывает слой кодирования MPEG[MPEG layer](по-умолчанию: 2). | |
1376 .IPs abitrate=<32\-448> | |
1377 Указывает битпоток кодируемого звука в кбит/с (по-умолчанию: 384). | |
1378 .IPs amode=<значение> | |
1379 Указывает режим кодирования звука. | |
1380 Доступны следующие предустановки: 'stereo', 'joint_stereo', 'dual' | |
1381 и 'mono' (по-умолчанию: stereo). | |
1382 .IPs vbitrate=<значение> | |
1383 Указывает среднее значение битпотока кодируемого видео в Мбит/с (по-умолчанию: 6). | |
1384 .IPs vmode=<значение> | |
1385 Указывает режим кодирования видео: | |
1386 .RSss | |
1387 vbr: Переменный битпоток (по-умолчанию) | |
1388 .br | |
1389 cbr: Постоянный битпоток | |
1390 .REss | |
1391 .IPs vpeak=<значение> | |
1392 Указывает пиковое значение битпотока кодируемого видео в Мбит/с | |
1393 (имеет смысл только для VBR кодирования, по-умолчанию: 6.6). | |
1394 .IPs fmt=<value> | |
1395 Выбирает MPEG формат для кодирования: | |
1396 .RSss | |
1397 ps: MPEG-2 Программный поток (по-умолчанию) | |
1398 .br | |
1399 ts: MPEG-2 Транспортный поток | |
1400 .br | |
1401 mpeg1: MPEG-1 системный поток | |
1402 .br | |
1403 vcd: Video CD совместимый поток | |
1404 .br | |
1405 svcd: Super Video CD совместимый | |
1406 .br | |
1407 dvd: DVD совместимый | |
1408 .REss | |
1409 .RE | |
1410 .PD 1 | |
1411 . | |
1412 .TP | |
1413 .B \-radio <опция1:опция2:...> (только радио) | |
1414 Эта опция устанавливает различные параметры модуля захвата с радио. | |
1415 Для прослушивания радио с MPlayer используйте 'radio://<частота>' | |
1416 (если не указана опция channels) или 'radio://<номер канала>' | |
1417 (если опция channels указана) в качестве URL. | |
1418 Для запуска подсистемы захвата, | |
1419 используйте 'radio://<частота или канал>/capture'. | |
1420 Если не указано ключевое слово capture, вы можете слушать радио только | |
1421 при помоши line-in кабеля. Использование capture для прослушивания не | |
1422 рекомендуется в связи с проблемами синхронизации, которые | |
1423 делают прослушивание некомфортным. | |
1424 .sp 1 | |
1425 Доступные опции: | |
1426 .RSs | |
1427 .IPs device=<значение> | |
1428 Уиспользуемое устройство радио (по-умолчанию: /dev/radio0). | |
1429 .IPs driver=<значение> | |
1430 Используемый радио драйвер (пл-умолчанию: v4l2 если доступно, иначе v4l). | |
1431 В данный момент поддерживаются драйверы v4l и v4l2. | |
1432 .IPs volume=<0..100> | |
1433 Уровень звука для радио (по-умолчанию: 100) | |
1434 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,... | |
1435 Устанавливает список каналов. | |
1436 Используйте _ вместо пробелов в именах (или играйтесь с экранированием ;-). | |
1437 Имена каналов будут выводиться при помощи OSD, и для управления с пульта | |
1438 будут доступны команды radio_step_channel и radio_set_channel (смотрите LIRC). | |
1439 Если эта опция указана, то число в URL будет означать позицию канала в списке. | |
1440 .br | |
1441 .I ПРИМЕР: | |
1442 radio://1, radio://104.4, radio_set_channel 1 | |
1443 .IPs adevice=<значение> (с включенной поддержкой захвата с радио) | |
1444 Название устройства, с которого будет производиться захват. | |
1445 Без его указания захват будет отключен, даже если в URL указано слово capture. | |
1446 Для ALSA устройств указывайте его в виде hw=<карта>.<устройство>. | |
1447 Если название устройства содержит '=', то для захвата модуль будет | |
1448 использовать ALSA, иначе OSS. | |
1449 .IPs arate=<значение> (с включенной поддержкой захвата с радио) | |
1450 Частота в сэмплах в секунду (по-умолчанию: 44100). | |
1451 .br | |
1452 .I ЗАМЕЧАНИЕ: | |
1453 При использовании захвата звука, установите также опцию | |
1454 \-rawaudio rate=<значение> с таким же значением, как у arate. | |
1455 Если у вас проблемы со скоростью звука (слишком быстрый), попробуйте | |
1456 поиграть с разными значениями arate (например, 48000,44100,32000,...). | |
1457 .IPs achannels=<значение> (с включенной поддержкой захвата с радио) | |
1458 Количество аудио каналов для захвата. | |
1459 .RE | |
1460 . | |
1461 .TP | |
1462 .B \-rawaudio <опция1:опция2:...> | |
1463 Эта опция позполяет проигрывать сырые аудио файлы. | |
1464 Вам придется также указать \-demuxer rawaudio. | |
1465 Ее еще можно использовать для воспроизведения аудио CD, отличных от 44кГц 16-бит стерео. | |
1466 Для воспроизведения сырых AC3 потоков используйте \-rawaudio format=0x2000 \-demuxer rawaudio. | |
1467 .sp 1 | |
1468 Доступные опции: | |
1469 .sp 1 | |
1470 .PD 0 | |
1471 .RSs | |
1472 .IPs channels=<значение> | |
1473 количество каналов | |
1474 .IPs rate=<значение> | |
1475 частота в сэмплах в секунду | |
1476 .IPs samplesize=<значение> | |
1477 размер сэмпла в байтах | |
1478 .IPs bitrate=<значение> | |
1479 битпоток для rawaudio файлов | |
1480 .IPs format=<значение> | |
1481 fourcc в шестнадцатеричном формате | |
1482 .RE | |
1483 .PD 1 | |
1484 . | |
1485 .TP | |
1486 .B \-rawvideo <опция1:опция2:...> | |
1487 Эта опция позволяет воспроизводить сырые видео файлы. | |
1488 Вам придется также указать \-demuxer rawaudio. | |
1489 .sp 1 | |
1490 Доступные опции: | |
1491 .sp 1 | |
1492 .PD 0 | |
1493 .RSs | |
1494 .IPs fps=<значение> | |
1495 частота в кадрах в секунду (по-умолчанию: 25.0) | |
1496 .IPs sqcif|qcif|cif|4cif|pal|ntsc | |
1497 устанавливает стандартный размер изображения | |
1498 .IPs w=<значение> | |
1499 ширина изоражения в пикселах | |
1500 .IPs h=<value> | |
1501 высота изображения в пикселах | |
1502 .IPs i420|yv12|yuy2|y8 | |
1503 устанавливает пространство цветов | |
1504 .IPs format=<значение> | |
1505 цветовое пространство (fourcc) в шестнадцатеричном формате | |
1506 .IPs size=<значение> | |
1507 размер кадра в байтах | |
1508 .REss | |
1509 .sp 1 | |
1510 .RS | |
1511 .I ПРИМЕР: | |
1512 .RE | |
1513 .PD 0 | |
1514 .RSs | |
1515 .IPs "mplayer foreman.qcif \-demuxer rawvideo -rawvideo qcif" | |
1516 Проигрывает известный фильм "foreman". | |
1517 .IPs "mplayer sample-720x576.yuv \-demuxer rawvideo \-rawvideo w=720:h=576" | |
1518 Проигрывает сырой YUV фильм. | |
1519 .RE | |
1520 .PD 1 | |
1521 . | |
1522 .TP | |
1523 .B \-rtsp-port | |
1524 Используется с 'rtsp://' URL для назначения номера порта на клиенте. | |
1525 Опция может быть полезна, если вы находитесь за маршрутизатором и хотите | |
1526 направлять RTSP поток с сервера определенному клиенту. | |
1527 . | |
1528 .TP | |
1529 .B \-rtsp-destination | |
1530 Используется с rtsp://' URL для привязки к указанному IP адресу назначения. | |
1531 Опция может быть полезна с некоторыми RTSP серверами, не отправляющими | |
1532 RTP пакеты на нужный интерфейс. Если невозможно установить соединение | |
1533 с RTSP сервером, используйте опцию \-v, чтобы определить, | |
1534 к какому IP адресу пытается привязаться MPlayer, и попытайтесь назначить | |
1535 вместо него один из назначенных вашему компьютеру. | |
1536 . | |
1537 .TP | |
1538 .B \-rtsp-stream-over-tcp (только LIVE555) | |
1539 Используется с'rtsp://' URL для указания, что в результате входящие RTP и RTCP | |
1540 пакеты должны передаваться по TCP (используя то же TCP соединение, что и RTSP). | |
1541 Опция может быть полезна, если у вас сбоящее интернет соединение, | |
1542 не пропускающее входящие UDP пакеты (смотрите http://www.live555.com/\:mplayer/). | |
1543 . | |
1544 .TP | |
1545 .B \-saveidx <файл> | |
1546 Принудительно перестраивает индекс и сохраняет его в <файл>. | |
1547 В данный момент это работает только с AVI файлами. | |
1548 .br | |
1549 .I ЗАМЕЧАНИЕ: | |
1550 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML. | |
1551 . | |
1552 .TP | |
1553 .B \-sb <байтовая позиция> (смотрите также \-ss) | |
1554 Перемещается к байтовой позиции. | |
1555 Полезно для воспроизведения с образов CD-ROM или VOB файлов с мусором в начале. | |
1556 . | |
1557 .TP | |
1558 .B \-speed <0.01\-100> | |
1559 Уменьшает или увеличивает скорость воспроизведения в указанное количество раз. | |
1560 Не гарантируется правильная работа с \-oac copy. | |
1561 . | |
1562 .TP | |
1563 .B \-srate <Гц> | |
1564 Выбирает используемую выходную частоту семплов | |
1565 (конечно, звуковые карты имеют на нее ограничения). | |
1566 Если выбранная частота сэмплов отличается от текущего медиа, то для компенсации | |
1567 различий в слой звуковых фильтров будет автоматически добавлен звуковой | |
1568 фильтр resample или lavcresample. | |
1569 Тип ресэмплирования может быть указан опцией \-af-adv. | |
1570 По-цмолчанию, используется быстрое преобразование, что может | |
1571 привести к искажениям. | |
1572 . | |
1573 .TP | |
1574 .B \-ss <time> (also see \-sb) | |
1575 Перемещение в указаную временную позицию. | |
1576 .sp 1 | |
1577 .I ПРИМЕР: | |
1578 .PD 0 | |
1579 .RSs | |
1580 .IPs "\-ss 56" | |
1581 Перемещается к позиции 56 секунд. | |
1582 .IPs "\-ss 01:10:00" | |
1583 Перемещается в позицию 1 час 10 мин. | |
1584 .RE | |
1585 .PD 1 | |
1586 . | |
1587 .TP | |
1588 .B \-tskeepbroken | |
1589 Указывает MPlayer не отбрасывать TS пакеты в потоке, определенные как испорченные. | |
1590 Иногда требуется для воспроизведения испорченных MPEG-TS файлов. | |
1591 . | |
1592 .TP | |
1593 .B \-tsprobe <байтовая позиция> | |
1594 При воспроизведении MPEG-TS потока, эта опция позволяет указать, в пределах какого | |
1595 количества байт в потоке MPlayer должен искать желаемые аудио и видео ID. | |
1596 . | |
1597 .TP | |
1598 .B \-tsprog <1\-65534> | |
1599 При воспроизведении MPEG-TS потока, этой опцией можно указать какую | |
1600 программу (если присутствует) вы хотите воспроизвести. | |
1601 Может использоваться с \-vid и \-aid. | |
1602 . | |
1603 .TP | |
1604 .B \-tv <опция1:опция2:...> (только TV/\:PVR) | |
1605 Эта опция настраивает различные свойства модуля TV захвата. | |
1606 Для просмотра TV с MPlayer, используйте 'tv://' или 'tv://<номер_канала>' | |
1607 или даже 'tv://<название_канала> (смотрите ниже опцию channels для подробностей о | |
1608 параметре название_канала) в качестве URL. | |
1609 .sp 1 | |
1610 Доступные опции: | |
1611 .RSs | |
1612 .IPs noaudio | |
1613 без звука | |
1614 .IPs driver=<значение> | |
1615 доступны: dummy, v4l, v4l2, bsdbt848 | |
1616 .IPs device=<значение> | |
1617 Указывает устройство TV (по-умолчанию: /dev/\:video0). | |
1618 .IPs input=<значение> | |
1619 Указывает источник (по-умолчанию: 0 (TV), смотрите консольный вывод для определения доступных | |
1620 источников). | |
1621 .IPs freq=<значение> | |
1622 Указывает частоту, на которую необходимо настроиться (например 511.250). | |
1623 Не совместимо с параметром channels. | |
1624 .IPs outfmt=<значение> | |
1625 Устанавливает формат вывода с тюнера в одно из предустановленных значений, | |
1626 поддерживаемых драйвером V4L (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) или в | |
1627 произвольный формат, заданный шестнадцатеричным значением. | |
1628 Попробуйте outfmt=help, чтобы получить список доступных форматов. | |
1629 .IPs width=<значение> | |
1630 Ширина окна вывода | |
1631 .IPs height=<значение> | |
1632 Высота окна вывода | |
1633 .IPs fps=<значение> | |
1634 Частота кодров с которой захватывается видео (кадров в секунду) | |
1635 .IPs buffersize=<значение> | |
1636 Максимальный размер буфера захвата в мегабайтах (по-умолчанию: динамический) | |
1637 .IPs norm=<значение> | |
1638 Для bsdbt848 и v4l доступны PAL, SECAM, NTSC. | |
1639 Для v4l2 смотрите консольный вывод для получения списка доступных стандартов. | |
1640 можете также посмотреть опицю normid ниже. | |
1641 .IPs "normid=<значение> (только v4l2)" | |
1642 Устанавливает TV стандарт в указанное числовое ID. | |
1643 TV стандарт зависит от карты захвата. | |
1644 Смотрите консольный вывод для получения списка доступных TV стандартов. | |
1645 .IPs channel=<значение> | |
1646 Переключает тюнер на <значение> канал. | |
1647 .IPs chanlist=<значение> | |
1648 Доступны: europe-east, europe-west, us-bcast, us-cable, другие | |
1649 .IPs channels=<канал>\-<название>,<канал>\-<название>,... | |
1650 Устанавливает названия для каналов. | |
1651 Используйте _ вместо пробелов в названиях (или поиграйте с экранированием ;-). | |
1652 Названия каналов будут выводиться при помощи OSD, и станут доступными | |
1653 команды tv_step_channel, tv_set_channel и tv_last_channel, полезные для | |
1654 управления с пульта (смотрите LIRC). | |
1655 Не совместима с параметром frequency. | |
1656 .br | |
1657 .I ЗАМЕЧАНИЕ: | |
1658 После этого номер канала будет являться позицией в списке 'channels', | |
1659 начиная с 1. | |
1660 .br | |
1661 .I ПРИМЕР: | |
1662 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1 | |
1663 .IPs [brightness|contrast|hue|saturation]=<-100\-100> | |
1664 Устанавливает эквалайзер изображения на карте. | |
1665 .IPs audiorate=<значение> | |
1666 Устанавливает аудио битпоток. | |
1667 .IPs forceaudio | |
1668 Указывает захватывать звук даже если v4l сообщает, что нет источников звука. | |
1669 .IPs "alsa\ " | |
1670 Захват через ALSA. | |
1671 .IPs amode=<0\-3> | |
1672 Выбирает аудио режим: | |
1673 .RSss | |
1674 0: моно | |
1675 .br | |
1676 1: стерео | |
1677 .br | |
1678 2: язык 1 | |
1679 .br | |
1680 3: язык 2 | |
1681 .REss | |
1682 .IPs forcechan=<1\-2> | |
1683 По-умолчанию, количество записываемых аудио каналов определяется автоматически, | |
1684 запрашивая режим аудио у TV карты. | |
1685 Эта опция позволяет принудительно назначить стерео/\:моно запись независимо | |
1686 от опции amode и значений, возвращаемых v4l. | |
1687 Это может быть использовано для решения проблем, в случае когда TV карта не | |
1688 способна указать текущий аудио режим. | |
1689 .IPs adevice=<значение> | |
1690 Устанавливает аудио устройство. | |
1691 <значение> должно быть /dev/\:xxx для OSS и аппаратный ID для ALSA. | |
1692 Вы должны заменить любые ':' на '.' в ID для ALSA. | |
1693 .IPs audioid=<значение> | |
1694 Выбирает выход звука карты захвата, если их более одного. | |
1695 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)" | |
1696 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)" | |
1697 Эти опции устанавливают параметры микшера на карте видео захвата. | |
1698 Они не имеют эффекта, если на карте такового нет. | |
1699 Для v4l2, 50 означает элемент управления по-умолчанию, как указано | |
1700 драйвером. | |
1701 .IPs immediatemode=<логическое> | |
1702 Значение 0 означает совместный захват и буферизацию звука и видео | |
1703 (по-умолчанию для MEncoder). | |
1704 Значение 1 (по-умолчанию для MPlayer) означает захват только видео и прохождение | |
1705 звука через кабель от TV карты к звуковой. | |
1706 .IPs mjpeg | |
1707 Используется аппаратное MJPEG сжатие (если карта его поддерживает). | |
1708 При использовании этой опции, вам не требуется указывать ширину и высоту | |
1709 окна вывода, потому что MPlayer определит их автоматически по | |
1710 значению decimation (смотрите ниже). | |
1711 .IPs decimation=<1|2|4> | |
1712 выбирает размер картинки, сжимаемой аппаратным MJPEG кодером: | |
1713 .RSss | |
1714 1: full size | |
1715 704x576 PAL | |
1716 704x480 NTSC | |
1717 .br | |
1718 2: medium size | |
1719 352x288 PAL | |
1720 352x240 NTSC | |
1721 .br | |
1722 4: small size | |
1723 176x144 PAL | |
1724 176x120 NTSC | |
1725 .REss | |
1726 .IPs quality=<0\-100> | |
1727 Выбирает качество JPEG сжатия | |
1728 (для полного размера рекомендуется < 60). | |
1729 .RE | |
1730 . | |
1731 .TP | |
1732 .B \-user <имя пользователя> (смотрите также \-passwd) (только сеть) | |
1733 Указывает имя пользователя для HTTP аутентификации. | |
1734 . | |
1735 .TP | |
1736 .B \-user-agent <строка> | |
1737 Используется <строка> в качестве значения user agent для потоков HTTP. | |
1738 . | |
1739 .TP | |
1740 .B \-vid <ID> | |
1741 Выбирает видео канал (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190). | |
1742 При воспроизведении потока MPEG-TS, MPlayer/\:MEncoder будет использовать | |
1743 первую программу (если присутствует) с указанным видео потоком. | |
1744 . | |
1745 .TP | |
1746 .B \-vivo <под-опции> (КОД ОТЛАДКИ) | |
1747 Принудительно устанавливает параметры звука для VIVO демуксера (для отладочных целей). | |
1748 . | |
1749 . | |
1750 . | |
1751 .SH "ОПЦИИ OSD/СУБТИТРОВ" | |
1752 .I ЗАМЕЧАНИЕ: | |
1753 Смотрите также \-vf expand. | |
1754 . | |
1755 .TP | |
1756 .B \-ass (только FreeType) | |
1757 Включает SSA/ASS рендеринг субтиров. | |
1758 С этой опцией для внешних субтитров SSA/ASS и дорожек Matroska будет использоваться | |
1759 libass. Смотрите также \-embeddedfonts. | |
1760 . | |
1761 .TP | |
1762 .B \-ass-border-color <значение> | |
1763 Устанавливает цвет границы (обрамления) для текста субтитров. | |
1764 Формат цвета: RRGGBBAA. | |
1765 . | |
1766 .TP | |
1767 .B \-ass-bottom-margin <значение> | |
1768 Добавляет черную полосу в нижней части кадра. | |
1769 Рендерер SSA/ASS может поместить туда субтитры (с \-ass-use-margins). | |
1770 . | |
1771 .TP | |
1772 .B \-ass-color <значение> | |
1773 Устанавливает цвет текста субтитров. | |
1774 Формат цвета: RRGGBBAA. | |
1775 . | |
1776 .TP | |
1777 .B \-ass-font-scale <значение> | |
1778 Устанавливает коэффициент масштабирования, используемый в рендерере SSA/ASS. | |
1779 . | |
1780 .TP | |
1781 .B \-ass-force-style <[Стиль.]Параметр=Значение[,...]> | |
1782 Переопределяет некоторые параметры стиля. | |
1783 .sp | |
1784 .I ПРИМЕР: | |
1785 .PD 0 | |
1786 .RSs | |
1787 \-ass-force-style FontName=Arial,Default.Bold=1 | |
1788 .RE | |
1789 .PD 1 | |
1790 . | |
1791 .TP | |
1792 .B \-ass-line-spacing <значение> | |
1793 Устанавливает межстрочный интервал для рендерера SSA/ASS. | |
1794 . | |
1795 .TP | |
1796 .B \-ass-styles <файл> | |
1797 Загружает все SSA/ASS стили, найденные в указанном файле и использует их для | |
1798 рендеринга текста субтитров. Синтаксис файла такой же как в | |
1799 [V4 Styles] / [V4+ Styles] разделах SSA/ASS. | |
1800 . | |
1801 .TP | |
1802 .B \-ass-top-margin <значение> | |
1803 Добавляет черную полосу в верхней части кадра. | |
1804 SSA/ASS рендерер может поместить туда субтитры (с \-ass-use-margins). | |
1805 . | |
1806 .TP | |
1807 .B \-(no)ass-use-margins | |
1808 Включает/выключает расположение субтитров на черных полосах, когда они доступны | |
1809 (по-умолчанию: нет). | |
1810 . | |
1811 .TP | |
1812 .B \-dumpjacosub (только MPlayer) | |
1813 Преобразует субтитры (указанные опцией \-sub) в основанный на времени | |
1814 JACOsub формат. | |
1815 Создает файл dumpsub.js в текущем каталоге. | |
1816 . | |
1817 .TP | |
1818 .B \-dumpmicrodvdsub (только MPlayer) | |
1819 Преобразует субтитры (указанные опцией \-sub) в MicroDVD формат. | |
1820 Создает файл dumpsub.sub в текущем каталоге. | |
1821 . | |
1822 .TP | |
1823 .B \-dumpmpsub (только MPlayer) | |
1824 Преобразует субтитры (указанные опцией \-sub) в MPsub, формат субтитров MPlayer. | |
1825 Создает файл dump.mpsub в текущем каталоге. | |
1826 . | |
1827 .TP | |
1828 .B \-dumpsami (только MPlayer) | |
1829 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат SAMI. | |
1830 Создает файл dumpsub.sm в текущем каталоге. | |
1831 . | |
1832 .TP | |
1833 .B \-dumpsrtsub (только MPlayer) | |
1834 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат | |
1835 SubViewer (SRT). | |
1836 Создает файл dumpsub.srt в текущем каталоге. | |
1837 . | |
1838 .br | |
1839 .I ЗАМЕЧАНИЕ: | |
1840 Некоторые глючные аппаратные проигрыватели давятся SRT субтитрами с концами строк | |
1841 в стиле Unix. Если вам неповезло иметь такой, пропустите файлы субтитров | |
1842 через unix2dos или аналогичную программу для замены символов конца строка на | |
1843 принятые в DOS/Windows. | |
1844 . | |
1845 .TP | |
1846 .B \-dumpsub (только MPlayer) (БЕТА КОД) | |
1847 Сохраняет субпоток субтитров из VOB потоков. | |
1848 Смотрите также опции \-dump*sub и \-vobsubout*. | |
1849 . | |
1850 .TP | |
1851 .B \-embeddedfonts (только FreeType) | |
1852 Задействует извлечение внедренных шрифтов Matroska. | |
1853 Эти шрифты затем могут быть использованы для рендеринга SSA/ASS субтитров | |
1854 (опция \-ass). | |
1855 . | |
1856 .TP | |
1857 .B \-ffactor <число> (только OSD) | |
1858 .\" FIXME Resample the font alphamap. | |
1859 Преобразует альфакарту шрифта. | |
1860 Может быть: | |
1861 .PD 0 | |
1862 .RSs | |
1863 .IPs 0 | |
1864 простые белые шрифты | |
1865 .IPs 0.75 | |
1866 очень тонкое черное обрамление (по-умолчанию) | |
1867 .IPs 1 | |
1868 тонкое черное обрамление | |
1869 .IPs 10 | |
1870 жирное черное обрамление | |
1871 .RE | |
1872 .PD 1 | |
1873 . | |
1874 .TP | |
1875 .B \-flip-hebrew (только FriBiDi) | |
1876 Включает отражение субтитров, используя FriBiDi. | |
1877 . | |
1878 .TP | |
1879 .B \-noflip-hebrew-commas | |
1880 Изменяет предположения FriBiDi о расположении запятых в субтитрах. | |
1881 Используйте ее, если запятые в субтитрах начинаются в начале фраз, | |
1882 вместо их конца. | |
1883 . | |
1884 .TP | |
1885 .B \-font <путь к файлу font.desc> (только OSD) | |
1886 Ищет OSD/\:SUB шрифты в другом каталоге (по-умолчанию для обычных | |
1887 шрифтов: ~/\:.mplayer/\:font/\:font.desc, по-умолчанию для FreeType шрифтов: | |
1888 ~/.mplayer/\:subfont.ttf). | |
1889 .br | |
1890 .I ЗАМЕЧАНИЕ: | |
1891 С FreeType, эта опция определяет путь к файлу шрифта текста. | |
1892 С fontconfig, эта опция определяет название шрифта fontconfig. | |
1893 .sp 1 | |
1894 .I ПРИМЕР: | |
1895 .PD 0 | |
1896 .RSs | |
1897 \-font ~/\:.mplayer/\:arial-14/\:font.desc | |
1898 .br | |
1899 \-font ~/\:.mplayer/\:arialuni.ttf | |
1900 .br | |
1901 \-font 'Bitstream Vera Sans' | |
1902 .RE | |
1903 .PD 1 | |
1904 . | |
1905 .TP | |
1906 .B \-fontconfig (только fontconfig) | |
1907 Задействует использование шрифтов, управляемых fontconfig. | |
1908 . | |
1909 .TP | |
1910 .B \-forcedsubsonly | |
1911 Отображает только форсированные субтитры для потока субтитров DVD, выбранного, | |
1912 например \-slang. | |
1913 . | |
1914 .TP | |
1915 .B \-fribidi-charset <название кодировки> (только FriBiDi) | |
1916 Указывает кодировку, которая будет передана FriBiDi при декодировании | |
1917 не-UTF-8 субтитров (по-умолчанию: ISO8859-8). | |
1918 . | |
1919 .TP | |
1920 .B \-ifo <VOBsub IFO файл> | |
1921 Указывает файл, используемый для загрузки палитры и размера кадра для VOBsub субтитров. | |
1922 . | |
1923 .TP | |
1924 .B \-noautosub | |
1925 Выключает автоматическую загрузку файла субтитров. | |
1926 . | |
1927 .TP | |
1928 .B \-osd-duration <время> | |
1929 Устанавливает длительность отобрадения сообщений OSD в мс (по-умолчанию: 1000). | |
1930 . | |
1931 .TP | |
1932 .B \-osdlevel <0\-3> (только MPlayer) | |
1933 Указывает в каком режиме должен запускаться OSD. | |
1934 .PD 0 | |
1935 .RSs | |
1936 .IPs 0 | |
1937 только субтитры | |
1938 .IPs 1 | |
1939 громкость + позиция (по-умолчанию) | |
1940 .IPs 2 | |
1941 громкость + позиция + время + процент | |
1942 .IPs 3 | |
1943 громкость + пощиция + время + процент + общее время | |
1944 .RE | |
1945 .PD 1 | |
1946 . | |
1947 .TP | |
1948 .B \-overlapsub | |
1949 Позволяет очередным субтитрам быть отображенными, когда текущие еще видимы | |
1950 (по-умолчанию поддержка включается только для определенных форматов). | |
1951 . | |
1952 .TP | |
1953 .B \-sid <ID> (смотрите также \-slang, \-vobsubid) | |
1954 Отображает поток субтитров, указаный по <ID> (0\-31). | |
1955 MPlayer показывает доступные ID субтитров, когда запущен в подробном (\-v) режиме. | |
1956 Если вы не можете выбрать ни один из субтитров на DVD, попробуйте также \-vobsubid. | |
1957 . | |
1958 .TP | |
1959 .B \-slang <код языка[,код языка,...]> (смотрите также \-sid) | |
1960 Указывает языков используемых в субтитрах в порядке приоритетности. | |
1961 Разные форматы файлов работают с разными кодами языков. | |
1962 DVD используют ISO 639-1 двухбуквенные коды, Matroska использует | |
1963 ISO 639-2 трехбуквенные, в то время как OGM использует идентификатор | |
1964 в свободной форме. MPlayer выводит доступные языки при запуске в подробном (\-v) режиме. | |
1965 .sp 1 | |
1966 .I ПРИМЕР: | |
1967 .PD 0 | |
1968 .RSs | |
1969 .IPs "mplayer dvd://1 \-slang hu,en" | |
1970 Выбирает дорожку с Венгерскими субтитрами на DVD, а в случае отсутствия таковой | |
1971 возвращается к использованию Английского. | |
1972 .IPs "mplayer \-slang jpn example.mkv" | |
1973 Воспроизводит файл Matroska с Японскими субтитрами. | |
1974 .RE | |
1975 .PD 1 | |
1976 . | |
1977 .TP | |
1978 .B \-spuaa <режим> (только OSD) | |
1979 Режим сглаживания/\:масштабирования для DVD/\:VOBsub. | |
1980 Значение 16 может быть добавлено к <режим> для задействования масштабирования, | |
1981 лаже если размеры исходного и отмасштабированного кадра уже совпадают. | |
1982 Может использоваться, например, для гауссового размытия субтитров. | |
1983 Доступные режимы: | |
1984 .PD 0 | |
1985 .RSs | |
1986 .IPs 0 | |
1987 ничего (наиболее быстрое, очень безобразное) | |
1988 .IPs 1 | |
1989 апроксимированный (сбоит?) | |
1990 .IPs 2 | |
1991 полное (меделенное) | |
1992 .IPs 3 | |
1993 билинейное (быстрое и не очень плохое, по-умолчанию) | |
1994 .IPs 4 | |
1995 используется гауссово размытие swscaler'a (выглядит очень хорошо) | |
1996 .RE | |
1997 .PD 1 | |
1998 . | |
1999 .TP | |
2000 .B \-spualign <-1\-2> (только OSD) | |
2001 Указывает как должны выравниваться SPU (DVD/\:VOBsub) субтитры. | |
2002 .PD 0 | |
2003 .RSs | |
2004 .IPs "-1" | |
2005 исходное положение | |
2006 .IPs " 0" | |
2007 Выравнивание к верху (изначальное поведение, по-умолчанию). | |
2008 .IPs " 1" | |
2009 Выравнивание к центру. | |
2010 .IPs " 2" | |
2011 Выравнивание к низу. | |
2012 .RE | |
2013 .PD 1 | |
2014 . | |
2015 .TP | |
2016 .B \-spugauss <0.0\-3.0> (только OSD) | |
2017 Параметр отклонения гауссового размытия, используемый \-spuaa 4. | |
2018 Большие значения означают более сильное размытие (по-умолчанию: 1.0). | |
2019 . | |
2020 .TP | |
2021 .B \-sub <файл_субтитров1,файл_субтитров2,...> | |
2022 Использует/\:отображает указанные файлы субтитров. | |
2023 В каждый момент времени может быть показан только один файл. | |
2024 . | |
2025 .TP | |
2026 .B \-sub-bg-alpha <0\-255> | |
2027 Указывает значение альфа канала для субтитров и фона OSD. | |
2028 Большее значение означает большую прозрачность. | |
2029 0 означает полную прозрачность. | |
2030 . | |
2031 .TP | |
2032 .B \-sub-bg-color <0\-255> | |
2033 Указывает цвет для субтитров у фона OSD. | |
2034 В данный момент субтитры выводятся в оттенках серого, так что это | |
2035 эквивалентно интенсивности цвета. | |
2036 255 означает белый и 0 - черный. | |
2037 . | |
2038 .TP | |
2039 .B \-sub-demuxer <[+]название> (только \-subfile only) (БЕТА КОД) | |
2040 Принудительно устанвливает тип демуксера субтитров для \-subfile. | |
2041 Используйте '+' перед названием для принудительного использования, это | |
2042 пропустит некоторые проверки! | |
2043 Указывайте название демуксера таким, как оно выводится опцией \-sub-demuxer help. | |
2044 Для обратной совместимости также допускается ID демуксера, определенный в | |
2045 libmpdemux/\:demuxer.h. | |
2046 . | |
2047 .TP | |
2048 .B \-sub-fuzziness <режим> | |
2049 .\" FIXME | |
2050 Настраивает точность совпадения при поиске субтитров: | |
2051 .PD 0 | |
2052 .RSs | |
2053 .IPs 0 | |
2054 точное совпадение | |
2055 .IPs 1 | |
2056 Загружает все субтитры, содержащие название фильма. | |
2057 .IPs 2 | |
2058 Загружает все субтитры, в текущем каталоге. | |
2059 .RE | |
2060 .PD 1 | |
2061 . | |
2062 .TP | |
2063 .B \-sub-no-text-pp | |
2064 Отключает любые виды постпроцессинга текста, производимого после загрузки | |
2065 субтитров. Используется для отладочных целей. | |
2066 . | |
2067 .TP | |
2068 .B \-subalign <0\-2> (только OSD) | |
2069 Указывает какой край субтитров должен выравниваться по высоте, указанной | |
2070 опцией \-subpos. | |
2071 .PD 0 | |
2072 .RSs | |
2073 .IPs 0 | |
2074 Выравнивают верх субтитров (изначальное поведение). | |
2075 .IPs 1 | |
2076 Выранивает центр субтитров. | |
2077 .IPs 2 | |
2078 Выравнивает нижнюю границу субтитров (по-умолчанию). | |
2079 .RE | |
2080 .PD 1 | |
2081 . | |
2082 .TP | |
2083 .B "\-subcc \ " | |
2084 Отображает DVD Closed Caption (CC) субтитры. | |
2085 Это | |
2086 .B не | |
2087 .\" FIXME i cannot translate this | |
2088 VOB субтитры, это специальные ASCII субтитры для | |
2089 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs. | |
2090 CC subtitles have not been spotted on DVDs from other regions so far. | |
2091 . | |
2092 .TP | |
2093 .B \-subcp <кодировка> (только iconv) | |
2094 Если ваша система поддерживает iconv(3), можно использовать эту опцию для | |
2095 указания кодировки субтитров. | |
2096 .sp 1 | |
2097 .I ПРИМЕР: | |
2098 .PD 0 | |
2099 .RSs | |
2100 \-subcp latin2 | |
2101 .br | |
2102 \-subcp cp1250 | |
2103 .RE | |
2104 .PD 1 | |
2105 . | |
2106 .TP | |
2107 .B \-subcp enca:<язык>:<кодировка при сбое> (только ENCA) | |
2108 Вы можете указать ваш язык, используя двухбуквенный код языка, | |
2109 чтобы дать ENCA вохможность определить кадовую страницу автоматически. | |
2110 Если неуверены, введите что-нибудь и смотрите вывод с \-v, чтобы определить | |
2111 список доступных языков. <кодировка при сбое> указывает кодировку, используемую, | |
2112 когда не срабатывает автоопределение. | |
2113 .sp 1 | |
2114 .I ПРИМЕР: | |
2115 .PD 0 | |
2116 .RSs | |
2117 .IPs "\-subcp enca:cs:latin2" | |
2118 Определяет кодировку, предполагая, что субтитры на Чешском, устанавливает | |
2119 latin 2, если определение не работает. | |
2120 .IPs "\-subcp enca:pl:cp1250" | |
2121 Определяет кодировку для Польского, устанавливает | |
2122 cp1250, если определение не работает. | |
2123 .RE | |
2124 .PD 1 | |
2125 . | |
2126 .TP | |
2127 .B \-subdelay <сек> | |
2128 Отображает субтитры <сек> секунд. | |
2129 Может быть отрицательным. | |
2130 . | |
2131 .TP | |
2132 .B \-subfile <файл> (БЕТА КОД) | |
2133 В данный момент бесполезно. | |
2134 То же, что и \-audiofile, но для потока субтитров (OggDS?). | |
2135 . | |
2136 .TP | |
2137 .B \-subfont-autoscale <0\-3> (только FreeType) | |
2138 Устанавливает режим автомасштабирования. | |
2139 .br | |
2140 .I ЗАМЕЧАНИЕ: | |
2141 0 означает, что масштаб текста и масштаб OSD - это высота шрифта в точках. | |
2142 .sp 1 | |
2143 Режим может быть: | |
2144 .sp 1 | |
2145 .PD 0 | |
2146 .RSs | |
2147 .IPs 0 | |
2148 нет автомасштаба | |
2149 .IPs 1 | |
2150 пропорционально высоте фильма | |
2151 .IPs 2 | |
2152 пропорционально ширине фильма | |
2153 .IPs 3 | |
2154 пропорционально диагонали фильма (по-умолчанию) | |
2155 .RE | |
2156 .PD 1 | |
2157 . | |
2158 .TP | |
2159 .B \-subfont-blur <0\-8> (только FreeType) | |
2160 Указывает радиус размытия шрифта (по-умолчанию: 2). | |
2161 . | |
2162 .TP | |
2163 .B \-subfont-encoding <значение> (только FreeType) | |
2164 Устанавливает кодировку шрифта. | |
2165 Когда установлена в 'unicode', будут рендериться все глифы из файла шрифта и | |
2166 использоваться юникод (по-умолчанию: unicode). | |
2167 . | |
2168 .TP | |
2169 .B \-subfont-osd-scale <0\-100> (только FreeType) | |
2170 Устанавливает коэффициент автомасштаба OSD элементов (по-умолчанию: 6). | |
2171 . | |
2172 .TP | |
2173 .B \-subfont-outline <0\-8> (только FreeType) | |
2174 Устанавливает толщину обрамления шрифта (по-умолчанию: 2). | |
2175 . | |
2176 .TP | |
2177 .B \-subfont-text-scale <0\-100> (только FreeType) | |
2178 Устанавливает коэффициент автомасштаба текста субтитров как | |
2179 процент от размера экрана (по-умолчанию: 5). | |
2180 . | |
2181 .TP | |
2182 .B \-subfps <частота> | |
2183 Указывает частоту кадров файла субтитров (по-умолчанию: fps фильма). | |
2184 .br | |
2185 .I ЗАМЕЧАНИЕ: | |
2186 Только для файлов субтитров, основанных на времени, например MicroDVD формат. | |
2187 . | |
2188 .TP | |
2189 .B \-subpos <0\-100> (имеет смысл только с \-vf expand) (только OSD) | |
2190 Указывает позицию субтитров на экране. | |
2191 Указывается вертикальная позиция субтитров в % от высоты экрана. | |
2192 . | |
2193 .TP | |
2194 .B \-subwidth <10\-100> (только OSD) | |
2195 Указывает максимальную ширину субтитров на экране. | |
2196 Полезно для TV-вывода. | |
2197 Указывается ширина субтитров в % от ширины экрана. | |
2198 . | |
2199 .TP | |
2200 .B \-noterm-osd | |
2201 Отключает отображение сообщений OSD на консоли, когда недоступно никакого видео. | |
2202 . | |
2203 .TP | |
2204 .B \-term-osd-esc <escape последовательность> | |
2205 Указывает escape последовательность выодимую на консоль перед выводом сообщения OSD. | |
2206 Escape последовательность должна передвигать указатель на начало строки, используемой для | |
2207 OSD и очищать ее (по-умолчанию: ^[[A\\r^[[K). | |
2208 . | |
2209 .TP | |
2210 .B \-unicode | |
2211 Указывает MPlayer обрабатывать файл субтитров как unicode. | |
2212 . | |
2213 .TP | |
2214 .B "\-utf8 \ \ " | |
2215 Указывает MPlayer обрабатывать файл субтитров как UTF-8. | |
2216 . | |
2217 .TP | |
2218 .B \-vobsub <VOBsub файл без расширения> | |
2219 Указывает VOBsub файл, используемый для субтитров. | |
2220 Должен быть полным путем без расширения, т.е.\& без | |
2221 '.idx', '.ifo' или '.sub'. | |
2222 . | |
2223 .TP | |
2224 .B \-vobsubid <0\-31> | |
2225 Указывает ID субтитров VOBsub. | |
2226 . | |
2227 . | |
2228 . | |
2229 .SH "ОПЦИИ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)" | |
2230 . | |
2231 .TP | |
2232 .B \-abs <значение> (только \-ao oss) (УСТАРЕЛО) | |
2233 Переопределяет размер буфера аудио драйвера/\:карты. | |
2234 . | |
2235 .TP | |
2236 .B \-format <формат> (смотрите также аудио фильтр format) | |
2237 Выбирает формат сэмпла, используемый для вывода со слоя | |
2238 аудио фильтров на звуковую карту. | |
2239 Значения, которые может принимать <формат> перечислены ниже в описании | |
2240 аудио фильтра format. | |
2241 . | |
2242 .TP | |
2243 .B \-mixer <устройство> | |
2244 Использует устройство микшера, отличное от значения по-умолчанию | |
2245 /dev/\:mixer. Для ALSA это название микшера. | |
2246 . | |
2247 .TP | |
2248 .B \-mixer-channel <mixer line>[,mixer index] (только \-ao oss и \-ao) | |
2249 Эта опция укажет MPlayer использовать другой канал для управления | |
2250 громкостью, вместо PCM. Опции для OSS включают | |
2251 .B vol, pcm, line. | |
2252 Полный список опций смотрите в SOUND_DEVICE_NAMES в | |
2253 /usr/\:include/\:linux/\:soundcard.h. | |
2254 Для ALSA вы можете использовать названия, отображаемые, например alsamixer, | |
2255 вроде | |
2256 .B Master, Line, PCM. | |
2257 .br | |
2258 .I ЗАМЕЧАНИЕ: | |
2259 Названия каналов микшера ALSA, с последующими числами должны быть указаны в формате | |
2260 <название,число>, например канал, помеченный 'PCM 1', в alsamixer должен быть | |
2261 преобразован в | |
2262 .BR PCM,1 . | |
2263 . | |
2264 .TP | |
2265 .B \-softvol | |
2266 Принудительно использует программный микшер, вместо микшера звуковой карты. | |
2267 . | |
2268 .TP | |
2269 .B \-softvol-max <10.0\-10000.0> | |
2270 Устанавливает максимальный уровень усиления в процентах (по-умолчанию: 110). | |
2271 Значение 200 позволит вам изменять громкость до величины в два раза | |
2272 превышающей текущий уровень. Со значениями ниже 100 начальный уровень | |
2273 (равный 100%) будет больше максимального, и OSD не мможет отобразить его | |
2274 корректно. | |
2275 . | |
2276 .TP | |
2277 .B \-volstep <0\-100> | |
2278 Устанавливает размер шага изменения громкости микшера в процентах от | |
2279 всего диапазона (по-умолчанию: 3). | |
2280 . | |
2281 . | |
2282 . | |
2283 .SH "ДАЙВЕРЫ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)" | |
2284 Драйверы вывода звука являются интерфейсом к различным средствам вывода звука. | |
2285 Синтаксис: | |
2286 . | |
2287 .TP | |
2288 .B \-ao <драйвер1[:подопция1[=значение]:...],драйвер2,...[,]> | |
2289 Указывает список приоритетности использования драйверов вывода звука. | |
2290 .PP | |
2291 Если список содержит в конце ',' MPlayer в случае проблем будет использовать | |
2292 драйверы, не включенные в список. | |
2293 Подопции необязательны, и в большинстве случаев могут быть опущены. | |
2294 .br | |
2295 .I ЗАМЕЧАНИЕ: | |
2296 Смотрите \-ao help, чтобы получить список встроенных драйверов вывода звука. | |
2297 .sp 1 | |
2298 .I ПРИМЕР: | |
2299 .PD 0 | |
2300 .RSs | |
2301 .IPs "\-ao alsa,oss," | |
2302 Пробуется ALSA драйвер, затем OSS, затем остальные. | |
2303 .IPs "\-ao alsa:noblock:device=hw=0.3" | |
2304 Устанавливает неблокирующий режим и в качестве устройства первую карту, | |
2305 четвертое устройство. | |
2306 .RE | |
2307 .PD 1 | |
2308 .sp 1 | |
2309 Доступные драйверы вывода звука: | |
2310 . | |
2311 .TP | |
2312 .B "alsa\ \ \ " | |
2313 Драйвер вывода звука ALSA 0.9/1.x | |
2314 .PD 0 | |
2315 .RSs | |
2316 .IPs noblock | |
2317 Устанавливает неблокирующий режим. | |
2318 .IPs device=<устройство> | |
2319 Устанавливает название устройства. | |
2320 Замените любые ',' на '.' и любые ':' на '=' в названии устройства ALSA. | |
2321 Для hwac3 вывода через S/PDIF, используйте "iec958" или "spdif" устройство, | |
2322 если вы не знаете как правильно его установить. | |
2323 .RE | |
2324 .PD 1 | |
2325 . | |
2326 .TP | |
2327 .B "alsa5\ \ " | |
2328 Драйвер вывода звука ALSA 0.5 | |
2329 . | |
2330 .TP | |
2331 .B "oss\ \ \ \ " | |
2332 Драйвер вывода звука OSS | |
2333 .PD 0 | |
2334 .RSs | |
2335 .IPs <dsp-устройство> | |
2336 Устанавливает устройство вывода звука (по-умолчанию: /dev/\:dsp). | |
2337 .IPs <mixer-устройство> | |
2338 Устанавливает устройство микширования звука (по-умолчанию: /dev/\:mixer). | |
2339 .IPs <mixer-канал> | |
2340 Устанавливает канал микшера звука (по-умолчанию: pcm). | |
2341 .RE | |
2342 .PD 1 | |
2343 . | |
2344 .TP | |
2345 .B sdl (только SDL) | |
2346 Драйвер вывода звука высокоуровневой платформо-мезависимой библиотеки | |
2347 SDL (Simple Directmedia Layer) | |
2348 .PD 0 | |
2349 .RSs | |
2350 .IPs <драйвер> | |
2351 Явно выбирает используемый SDL драйвер (по-умолчанию: на усмотрение SDL). | |
2352 .RE | |
2353 .PD 1 | |
2354 . | |
2355 .TP | |
2356 .B "arts\ \ \ " | |
2357 Драйвер вывода звука через демон aRts | |
2358 . | |
2359 .TP | |
2360 .B "esd\ \ \ \ " | |
2361 Драйвер вывода звука через демон ESD | |
2362 .PD 0 | |
2363 .RSs | |
2364 .IPs <сервер> | |
2365 Явно выбирает используемый ESD сервер (по-умолчанию: localhost). | |
2366 .RE | |
2367 .PD 1 | |
2368 . | |
2369 .TP | |
2370 .B "jack\ \ \ \ " | |
2371 Драйвер вывода звука через JACK (Jack Audio Connection Kit) | |
2372 .PD 0 | |
2373 .RSs | |
2374 .IPs port=<имя> | |
2375 Указывает присоединяться к портам с указанным именем (по-умолчанию: physical ports). | |
2376 .IPs name=<имя клиента> | |
2377 Имя клиента, передаваемое JACK (по-умолчанию: MPlayer [<PID>]). | |
2378 Полезно, если вы хотите автоматически устанавливать определенные соединения. | |
2379 .IPs (no)estimate | |
2380 Оценка задержки аудио, предлагаемой для более плавного воспроизведения видео | |
2381 (по-умодчанию: включено). | |
2382 .RE | |
2383 .PD 1 | |
2384 . | |
2385 .TP | |
2386 .B "nas\ \ \ \ " | |
2387 Драйвер вывода звука через NAS | |
2388 . | |
2389 .TP | |
2390 .B macosx (только Mac OS X) | |
2391 Родной драйвер вывода звука Mac OS X | |
2392 . | |
2393 .TP | |
2394 .B openal | |
2395 Экспериментальный, незавершенный (будет сводить в моно) драйвер выода OpenAL | |
2396 . | |
2397 .TP | |
2398 .B sgi (только SGI) | |
2399 Родной драйвер вывода звука SGI | |
2400 .PD 0 | |
2401 .RSs | |
2402 .IPs "<имя устройства вывода>" | |
2403 Явно выбирает используемое устройство/\:интерфейс вывода | |
2404 (по-умолчанию: системное значение по-умолчанию). | |
2405 Например, 'Analog Out' или 'Digital Out'. | |
2406 .RE | |
2407 .PD 1 | |
2408 . | |
2409 .TP | |
2410 .B sun (только Sun) | |
2411 Родной драйвер вывода звука Sun | |
2412 .PD 0 | |
2413 .RSs | |
2414 .IPs <device> | |
2415 Явно выбирает используемое устройство вывода (по-умолчанию: /dev/\:audio). | |
2416 .RE | |
2417 .PD 1 | |
2418 . | |
2419 .TP | |
2420 .B win32 (только Windows) | |
2421 Родной waveout драйвер вывода звука Windows | |
2422 . | |
2423 .TP | |
2424 .B dsound (только Windows) | |
2425 Драйвер вывода звука DirectX DirectSound | |
2426 .PD 0 | |
2427 .RSs | |
2428 .IPs device=<номер устройства> | |
2429 Устанавливает номер используемого устройства. | |
2430 Воспроизведение файла с \-v покажет список доступных устройств. | |
2431 .RE | |
2432 .PD 1 | |
2433 . | |
2434 .TP | |
2435 .B dxr2 (смотрите также \-dxr2) (только DXR2) | |
2436 Специальный драйвер вывода для Creative DXR2 | |
2437 . | |
2438 .TP | |
2439 .B ivtv (только IVTV) | |
2440 Специальный IVTV MPEG драйвер вывода. | |
2441 Работает только с \-ac hwmpa. | |
2442 . | |
2443 .TP | |
2444 .B mpegpes (только DVB) | |
2445 Драйвер вывода звука для DVB карт, записывающий вывод в MPEG-PES файл, | |
2446 если не установлено DVB карт. | |
2447 .PD 0 | |
2448 .RSs | |
2449 .IPs card=<1\-4> | |
2450 Используемая DVB карта, если установлено более одной. | |
2451 .IPs file=<файл> | |
2452 Имя выходного файла | |
2453 .RE | |
2454 .PD 1 | |
2455 . | |
2456 .TP | |
2457 .B "null\ \ \ " | |
2458 Не выводит никакого звука, но сохранаяет скорость воспроизведения видео. | |
2459 Используйте \-nosound для тестов производительности. | |
2460 . | |
2461 .TP | |
2462 .B "pcm\ \ \ \ " | |
2463 Драйвер вывода в файл сырого PCM/wave | |
2464 .PD 0 | |
2465 .RSs | |
2466 .IPs (no)waveheader | |
2467 Включает или не включает заголовок wave (по-умолчанию: включен). | |
2468 Если не включен, генерируется сырой PCM. | |
2469 .IPs file=<файл> | |
2470 Записывает звук в <файл> вместо audiodump.wav. | |
2471 Если указано nowaveheader, то по-умолчанию используется audiodump.pcm. | |
2472 .IPs "fast\ " | |
2473 Пытается выводить быстрее реальной скорости. | |
2474 Убедитесь, что вывод не обрезан (обычно с сообщением | |
2475 "Too many video packets in buffer"). | |
2476 Это нормально, если вы получаете сообщение | |
2477 "Your system is too SLOW to play this!". | |
2478 .RE | |
2479 .PD 1 | |
2480 . | |
2481 .TP | |
2482 .B "plugin\ \ " | |
2483 Драйвер вывода звука plugin | |
2484 . | |
2485 . | |
2486 . | |
2487 .SH "ОПЦИИ ВЫВОДА ВИДЕО (ТОЛЬКО MPLAYER)" | |
2488 . | |
2489 .TP | |
2490 .B \-adapter <значение> | |
2491 Указывает видеокарту, на которую будет выводиться изображение. | |
2492 Список доступных карт можно получить, указав эту опцию совместно с \-v. | |
2493 В данный момент работает только с directx драйвером вывода видео. | |
2494 . | |
2495 .TP | |
2496 .B \-bpp <глубина> | |
2497 Переназначает определенную автоматически глубину цвета. | |
2498 Поддерживается только fbdev, dga, svga, vesa драйверами. | |
2499 . | |
2500 .TP | |
2501 .B \-border | |
2502 Воспроизводит фильм в окне с рамками и оформлением. | |
2503 Поскольку это действие по-умолчанию, используйте \-noborder | |
2504 для отключения стандартного оформления окон. | |
2505 Поддерживается драйвером directx. | |
2506 . | |
2507 .TP | |
2508 .B \-brightness <-100\-100> | |
2509 Настраивает яркость видео сигнала (по-умолчанию: 0). | |
2510 Поддерживается не всеми драйверами. | |
2511 . | |
2512 .TP | |
2513 .B \-contrast <-100\-100> | |
2514 Настраивает контрастность видеосигнала (по-умолчанию: 0). | |
2515 Поддерживается не всеми драйверами. | |
2516 . | |
2517 .TP | |
2518 .B \-display <имя> (только X11) | |
2519 Указывает имя хоста и номер дисплея X сервера, на котором вы хотите выводить | |
2520 изображение. | |
2521 .sp 1 | |
2522 .I ПРИМЕР: | |
2523 .PD 0 | |
2524 .RSs | |
2525 \-display xtest.localdomain:0 | |
2526 .RE | |
2527 .PD 1 | |
2528 . | |
2529 .TP | |
2530 .B "\-dr \ \ \ " | |
2531 Включает direct rendering (поддерживается не всеми кодеками и драйверами вывода). | |
2532 .br | |
2533 .I ВНИМАНИЕ: | |
2534 Может привести к испорченным OSD/SUB! | |
2535 . | |
2536 .TP | |
2537 .B \-dxr2 <опция1:опция2:...> | |
2538 Эта опция используется для управления драйвером dxr2. | |
2539 .RSs | |
2540 .IPs ar-mode=<значение> | |
2541 пропорции (0 = normal, 1 = pan-and-scan, 2 = letterbox (по-умолчанию)) | |
2542 .IPs iec958-encoded | |
2543 устанавливает режим вывода iec958 в encoded. | |
2544 .IPs iec958-decoded | |
2545 устанавливает режим вывода iec958 в decoded (по-умолчанию). | |
2546 .IPs macrovision=<значение> | |
2547 режим macrovision (0 = выключено (по-умолчанию), 1 = agc, 2 = agc 2 colorstripe, | |
2548 3 = agc 4 colorstripe) | |
2549 .IPs "mute\ " | |
2550 отключает вывод звука | |
2551 .IPs unmute | |
2552 включает вывод звука | |
2553 .IPs ucode=<значение> | |
2554 путь к микрокоду | |
2555 .RE | |
2556 .RS | |
2557 .sp 1 | |
2558 .I TV вывод | |
2559 .RE | |
2560 .RSs | |
2561 .IPs 75ire | |
2562 включает режим вывода 7.5 IRE | |
2563 .IPs no75ire | |
2564 отключает режим вывода 7.5 IRE (по-умолчанию) | |
2565 .IPs "bw\ \ \ " | |
2566 ч/б TV вывод | |
2567 .IPs color | |
2568 цветной TV вывод (по-умолчанию) | |
2569 .IPs interlaced | |
2570 черезстрочный TV вывод (по-умолчанию) | |
2571 .IPs nointerlaced | |
2572 отключает черезстрочный TV вывод | |
2573 .IPs norm=<значение> | |
2574 TV стандарт (ntsc (по-умолчанию), pal, pal60, palm, paln, palnc) | |
2575 .IPs square-pixel | |
2576 устанавливает режим пиксела в square | |
2577 .IPs ccir601-pixel | |
2578 устанавливает режим пиксела в ccir601 | |
2579 .RE | |
2580 .RS | |
2581 .sp 1 | |
2582 .I оверлей | |
2583 .RE | |
2584 .RSs | |
2585 .IPs cr-left=<0\-500> | |
2586 Устанавливает левую границу обрезания (по-умолчанию: 50). | |
2587 .IPs cr-right=<0\-500> | |
2588 Устанавливает правую границу обрезания (по-умолчанию: 300). | |
2589 .IPs cr-top=<0\-500> | |
2590 Устанавливает верхнюю границу обрезания (по-умолчанию: 0). | |
2591 .IPs cr-bottom=<0\-500> | |
2592 Устанавливает нижнюю границу обрезания (по-умолчанию: 0). | |
2593 .IPs ck-[r|g|b]=<0\-255> | |
2594 Устанавливает величину красной(r), зеленой(g), синей (b) компоненты ключевого цвета оверлея. | |
2595 .IPs ck-[r|g|b]min=<0\-255> | |
2596 Минимальное значение для соответствующей компоненты ключевого цвета | |
2597 .IPs ck-[r|g|b]max=<0\-255> | |
2598 Максимальное значение для соответствующей компоненты ключевого цвета | |
2599 .IPs ignore-cache | |
2600 Игнорирует кешированные установки оверлея. | |
2601 .IPs update-cache | |
2602 Обновляет кешированные установки оверлея. | |
2603 .IPs ol-osd | |
2604 Включает оверлейный OSD. | |
2605 .IPs nool-osd | |
2606 Отключает оверлейный OSD (по-умолчанию). | |
2607 .IPs ol[h|w|x|y]-cor=<-20\-20> | |
2608 Настраивает размер (высоту(h),ширину(w)) и положение (x,y) оверлея | |
2609 в случает, когда он не точно соответствует окну (по-умолчанию: 0). | |
2610 .IPs overlay | |
2611 Активирует оверлей (по-умолчанию). | |
2612 .IPs nooverlay | |
2613 Автивирует TV выход. | |
2614 .IPs overlay-ratio=<1\-2500> | |
2615 Настраивает оверлей (по-умолчанию: 1000). | |
2616 .RE | |
2617 . | |
2618 .TP | |
2619 .B \-fbmode <режим> (только \-vo fbdev) | |
2620 Меняет видео режим на помеченный как <режим> в /etc/\:fb.modes. | |
2621 .br | |
2622 .I ЗАМЕЧАНИЕ: | |
2623 VESA фреймбуфер не поддерживает смену режима. | |
2624 . | |
2625 .TP | |
2626 .B \-fbmodeconfig <файл> (только \-vo fbdev) | |
2627 Переопределяет файл конфигурации режимов фреймбуфера (по-умолчанию: /etc/\:fb.modes). | |
2628 . | |
2629 .TP | |
2630 .B \-fs (смотрите также \-zoom) | |
2631 Полноэкранное воспроизведение (центрирует изображение и рисует черные рамки вокруг него). | |
2632 Поддерживается не всеми драйверами. | |
2633 . | |
2634 .TP | |
2635 .B \-fsmode-dontuse <0\-31> (УСТАРЕЛО, используйте опцию \-fs) | |
2636 Попробуйте эту опцию, если у вас по-прежнему проблемы с полноэкранным режимом. | |
2637 . | |
2638 .TP | |
2639 .B \-fstype <тип1,тип2,...> (только X11) | |
2640 Указывает список используемых полноэкранных режимов в порядке приоритета. | |
2641 Вы можете овергнуть режимы, ставя перед ними '\-'. | |
2642 Если у вас возникают проблемы вроде перекрывания полноэкранного окна другими, | |
2643 попробуйте использовать другой порядок. | |
2644 .br | |
2645 .I ЗАМЕЧАНИЕ: | |
2646 Список доступных типов можно получить опцией \-fstype help. | |
2647 .sp 1 | |
2648 Допустиные типы: | |
2649 .sp 1 | |
2650 .PD 0 | |
2651 .RSs | |
2652 .IPs above | |
2653 Использует подсказку _NETWM_STATE_ABOVE, если доступна. | |
2654 .IPs below | |
2655 Использует подсказку _NETWM_STATE_BELOW, если доступна. | |
2656 .IPs fullscreen | |
2657 Использует подсказку _NETWM_STATE_FULLSCREEN, если доступна. | |
2658 .IPs layer | |
2659 Использует подсказку _WIN_LAYER со слоем по-умолчанию. | |
2660 .IPs layer=<0...15> | |
2661 Использует подсказку _WIN_LAYER со слоем с указанным номером. | |
2662 .IPs netwm | |
2663 Принудительно указывает стиль NETWM. | |
2664 .IPs "none\ " | |
2665 Указывает не устанавливать слой полноэкранного окна. | |
2666 .IPs stays_on_top | |
2667 Использует подсказку _NETWM_STATE_STAYS_ON_TOP, если доступна. | |
2668 .REss | |
2669 .sp 1 | |
2670 .RS | |
2671 .I ПРИМЕР: | |
2672 .RE | |
2673 .PD 0 | |
2674 .RSs | |
2675 .IPs layer,stays_on_top,above,fullscreen | |
2676 Порядок по-умолчанию, будет использоваться, если указан некорректный или | |
2677 неподдерживаемый режим. | |
2678 .IPs \-fullscreen | |
2679 Исправляет переключение в полноэкранный режим в OpenBox 1.x. | |
2680 .RE | |
2681 .PD 1 | |
2682 . | |
2683 .TP | |
2684 .B \-geometry x[%][:y[%]] или [WxH][+x+y] | |
2685 Настраивает место появления на экране изображения. | |
2686 x и y указываются в пикселах, считая от верхнего левого до нижнего правого | |
2687 угла выводимого изображения. Если после значения указан символ процента, то | |
2688 оно превращается в процентное относительно размера экрана в соответствующем | |
2689 направлении. Опция также поддерживает стандартный формат X11 опции \-geometry. | |
2690 Если опцией \-wid указано внешнее окно, то координаты x и y указываются относительно | |
2691 его левого верхнего угла, а не экранного. | |
2692 .br | |
2693 .I ЗАМЕЧАНИЕ: | |
2694 Эта опция поддерживается только драйверами x11, xmga, xv, xvmc, xvidix, | |
2695 gl, gl2, directx и tdfxfb. | |
2696 .sp 1 | |
2697 .I ПРИМЕР: | |
2698 .PD 0 | |
2699 .RSs | |
2700 .IPs 50:40 | |
2701 Располагает окно в позиции x=50, y=40. | |
2702 .IPs 50%:50% | |
2703 Располагает окно в центре экрана. | |
2704 .IPs "100%\ " | |
2705 Располагает окно у центра правой границы экрана. | |
2706 .IPs 100%:100% | |
2707 Располагает окно у правого нижнего угла экрана. | |
2708 .RE | |
2709 .PD 1 | |
2710 . | |
2711 .TP | |
2712 .B \-guiwid <ID окна> (смотрите также \-wid) (только GUI) | |
2713 Опция указывает GUI использовать также X11 окно и прицепить себя к нижней | |
2714 части видео окна, что полезно для внедрения мини-GUI в браузер | |
2715 (с плагином MPlayer). | |
2716 . | |
2717 .TP | |
2718 .B \-hue <-100\-100> | |
2719 Настраивает цветность видеосигнала (по-умолчанию: 0). | |
2720 С этой опцией вы можете получить цветной негатив. | |
2721 Поддерживается не всеми драйверами. | |
2722 . | |
2723 .TP | |
2724 .B \-monitor-dotclock <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2725 Указывает диапазон значений dotclock или pixelclock монитора. | |
2726 . | |
2727 .TP | |
2728 .B \-monitor-hfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2729 Указывает диапазон значений горизонтальной частоты монитора. | |
2730 . | |
2731 .TP | |
2732 .B \-monitor-vfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2733 Указывает диапазон значений вертикальной частоты монитора. | |
2734 . | |
2735 .TP | |
2736 .B \-monitoraspect <значение> (смотрите также \-aspect) | |
2737 Указывает пропорции монитора или TV экрана. | |
2738 .sp 1 | |
2739 .I ПРИМЕР: | |
2740 .PD 0 | |
2741 .RSs | |
2742 \-monitoraspect 4:3 or 1.3333 | |
2743 .br | |
2744 \-monitoraspect 16:9 or 1.7777 | |
2745 .RE | |
2746 .PD 1 | |
2747 . | |
2748 .TP | |
2749 .B \-monitorpixelaspect <значение> (смотрите \-aspect) | |
2750 Устанавливает пропорции отдельного пиксела вашего монитора или TV | |
2751 экрана (по-умолчанию: отключено). | |
2752 Переопределяет установки \-monitoraspect. | |
2753 Значение 0 отключает, значение 1 означает квадратные пикселы | |
2754 (верно для (почти?) всех LCD). | |
2755 . | |
2756 .TP | |
2757 .B \-nodouble | |
2758 Отключает двойную буферизацию, используется, как правило, для целей откладки. | |
2759 Двойная буферизация исправляет мерцание, храня два кадра в памяти и | |
2760 отображая один из них, в то время, как декодируется второй. | |
2761 Это может негативно сказаться на OSD, но в большинстве случаев | |
2762 убирает мерцание OSD. | |
2763 . | |
2764 .TP | |
2765 .B \-nograbpointer | |
2766 Указывает не захватывать указатель мыши после смены видео режима (\-vm). | |
2767 Полезно для многоголовых конфигураций. | |
2768 . | |
2769 .TP | |
2770 .B \-nokeepaspect | |
2771 Указывает ге сохранять пропорции окна при изменении размера. | |
2772 Работает только с драйверами x11, xv, xmga, xvidix, directx. | |
2773 Кроме того, под X11 ваш оконный менеджер должен понимать подсказку | |
2774 созранения пропорций окна. | |
2775 . | |
2776 .TP | |
2777 .B "\-ontop\ " | |
2778 Помещает и сохраняет окно проигрывателя поверх всех окон. | |
2779 Поддерживается всеми драйверами, использующими X11, за | |
2780 исчключением SDL, а также драйверами directx, macosx, | |
2781 quartz, ggi и gl2. | |
2782 . | |
2783 .TP | |
2784 .B \-panscan <0.0\-1.0> | |
2785 Задействует функциональность pan-and-scan (обрезая стороны в соответствии | |
2786 с пропорциями, чтобы, например 16:9, фильм поместился на 4:3 экране | |
2787 без черных полос). Диапазон указывает какая часть изображения обрезается. | |
2788 Работает только с xv, xmga, mga, gl, gl2, quartz, macosx и xvidix драйверами. | |
2789 . | |
2790 .TP | |
2791 .B \-panscanrange <-19.0\-99.0> (экспериментальное) | |
2792 Изменяет диапазон pan-and-scan функциональности (по-умолчанию: 1). | |
2793 Положительные значения означают множитель диапазона по-умолчанию. | |
2794 Отрицательные значения означают, что можно увеличивать изображение | |
2795 до \-panscanrange+1 раз. | |
2796 Например \-panscanrange -3 означает увеличение вплоть до 4 раз. | |
2797 Это экспериментальная возможность. | |
2798 Не сообщайте об ошибках в ней, за исключением случая использования \-vo gl. | |
2799 . | |
2800 .TP | |
2801 .B \-refreshrate <Гц> | |
2802 Устанавливает частоту обновления монитора в Гц. | |
2803 В данный момент поддерживается только \-vo directx совместно с \-vm. | |
2804 . | |
2805 .TP | |
2806 .B \-rootwin | |
2807 Воспроизводит фильм на главном окне (фоне рабочего стола). | |
2808 Однако, фон рабочего стола может отображаться поверх изображения. | |
2809 Работает только с x11, xv, xmga, xvidix, quartz, macosx и directx драйверами. | |
2810 . | |
2811 .TP | |
2812 .B \-saturation <-100\-100> | |
2813 Настраивает насыщенность видео сигнала (по-умолчанию: 0). | |
2814 С этой опцией вы можете получить изображения в оттенках серого. | |
2815 Поддерживается не всеми драйверами. | |
2816 . | |
2817 .TP | |
2818 .B \-screenh <пикселов> | |
2819 Указывает вертикальное разрешение экрана для драйверов, которые не могут | |
2820 определить его самостоятельно, таких как fbdev, x11 и TVout. | |
2821 . | |
2822 .TP | |
2823 .B \-screenw <пикселов> | |
2824 Указывает горизонтальное разрешение экрана для драйверов, которые не могут | |
2825 определить его самостоятельно, таких как fbdev, x11 и TVout. | |
2826 . | |
2827 .TP | |
2828 .B \-stop-xscreensaver (только X11) | |
2829 Отключает xscreensaver при запуске и снова включает его при выходе. | |
2830 . | |
2831 .TP | |
2832 .B "\-vm \ \ \ " | |
2833 Пытается переключиться в другой видео режим. | |
2834 Поддерживается dga, x11, xv, sdl и directx драйверами. | |
2835 Если используется с directx драйвером, для изменения режима | |
2836 можно использовать опции \-screenw, \-screenh, \-bpp и \-refreshrate. | |
2837 . | |
2838 .TP | |
2839 .B "\-vsync \ \ " | |
2840 Включает VBI для vesa, dfbmga и svga драйверов. | |
2841 . | |
2842 .TP | |
2843 .B \-wid <ID окна> (смотрите также \-guiwid) (только X11, OpenGL и DirectX) | |
2844 Говорит MPlayer присоединиться к существующему окну. | |
2845 Полезно для внедрения MPlayer в браузер (например, расширение plugger). | |
2846 . | |
2847 .TP | |
2848 .B \-xineramascreen <\-2\-...> (только X11) | |
2849 В Xinerama конфигурациях (например, единственный рабочий стол, растянутый на | |
2850 несклько экранов) эта опция указывает MPlayer на каком из них показывать | |
2851 фильм. Значение \-2 означает полноэкранный режим на весь виртуальный экран, | |
2852 \-1 означает полноэкранный режим на экране с текущим окном. | |
2853 Начальная позиция устанавливается опцией \-geometry относительно указаного | |
2854 экрана. Как правило будет работать только с "\-fstype \-fullscreen" или | |
2855 "\-fstype none". | |
2856 . | |
2857 .TP | |
2858 .B \-zrbw (только \-vo zr) | |
2859 Показывает черно-белое изображение. | |
2860 Для оптимальной производительности может комбинироваться с '\-lavdopts gray'. | |
2861 . | |
2862 .TP | |
2863 .B \-zrcrop <[ширина]x[высота]+[x смещение]+[y смещение]> (только \-vo zr) | |
2864 Выбирает часть исходного изображения для показа, неоднократное указание | |
2865 этой опции включает режим cinerama. | |
2866 В режиме cinerama фильм распределяется по нескольким TV (или проекторам) для | |
2867 создания большей картинки. | |
2868 Опции, указаанные после n-ой \-zrcrop применяются к n-ой MJPEG карте, | |
2869 для каждой карты нужно указать, как минимум, \-zrdev в дополнении к \-zrcrop. | |
2870 Для примера смотрите вывод \-zrhelp и раздел Zr документации. | |
2871 . | |
2872 .TP | |
2873 .B \-zrdev <устройство> (только \-vo zr) | |
2874 Указывает файл устройства, относящийся к вашей MJPEG карте, по-умолчанию | |
2875 драйвер zr устанавливает ее в первое найденное v4l устройство. | |
2876 . | |
2877 .TP | |
2878 .B \-zrfd (только \-vo zr) | |
2879 Принудительное прореживание: Прореживание, указаное опциями \-zrhdec | |
2880 и \-zrvdec, применяется, только если аппаратный scaler может растянуть | |
2881 изображение до его исходного размера. | |
2882 Используйте эту опцию, чтобы форсировать прореживание. | |
2883 . | |
2884 .TP | |
2885 .B \-zrhdec <1|2|4> (только \-vo zr) | |
2886 Горизонтальное прореживание: Запрашивает драйвер отправлять только | |
2887 каждый 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
2888 использовать scaler MJPEG карты для растягивания изображения до | |
2889 исходного размера. | |
2890 . | |
2891 .TP | |
2892 .B \-zrhelp (только \-vo zr) | |
2893 Отображает список всех \-zr* опций, их значения по-умолчанию и | |
2894 пример режима cinerama. | |
2895 . | |
2896 .TP | |
2897 .B \-zrnorm <стандарт> (только \-vo zr) | |
2898 Указывает TV стандарт в PAL или NTSC (по-умолчанию: без изменения). | |
2899 . | |
2900 .TP | |
2901 .B \-zrquality <1\-20> (только \-vo) | |
2902 Число от 1 (наилучшее) до 20 (наихудшее) представляющее качество | |
2903 кодирования JPEG. | |
2904 . | |
2905 . | |
2906 .TP | |
2907 .B \-zrvdec <1|2|4> (только \-vo zr) | |
2908 Вертикальное прореживание: Запрашивает драйвер отправлять только | |
2909 каждую 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
2910 использовать scaler MJPEG карты для растягивания изображения до | |
2911 исходного размера. | |
2912 . | |
2913 .TP | |
2914 .B \-zrxdoff <x смещение на экране> (только \-vo zr) | |
2915 Если изображение меньше, чем TV экран, эта опция указывает смещение | |
2916 по x от верхнего левого угла TV экрана (по-умолчанию: центировано). | |
2917 . | |
2918 .TP | |
2919 .B \-zrydoff <y смещение на экране> (только \-vo zr) | |
2920 Если изображение меньше, чем TV экран, эта опция указывает смещение | |
2921 по y от верхнего левого угла TV экрана (по-умолчанию: центировано). | |
2922 . | |
2923 . | |
2924 . | |
2925 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)" | |
2926 Video output drivers are interfaces to different video output facilities. | |
2927 The syntax is: | |
2928 . | |
2929 .TP | |
2930 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]> | |
2931 Specify a priority list of video output drivers to be used. | |
2932 .PP | |
2933 If the list has a trailing ',' MPlayer will fall back on drivers not | |
2934 contained in the list. | |
2935 Suboptions are optional and can mostly be omitted. | |
2936 .br | |
2937 .I NOTE: | |
2938 See \-vo help for a list of compiled-in video output drivers. | |
2939 .sp 1 | |
2940 .I EXAMPLE: | |
2941 .PD 0 | |
2942 .RSs | |
2943 .IPs "\-vo xmga,xv," | |
2944 Try the Matrox X11 driver, then the Xv driver, then others. | |
2945 .IPs "\-vo directx:noaccel" | |
2946 Uses the DirectX driver with acceleration features turned off. | |
2947 .RE | |
2948 .PD 1 | |
2949 .sp 1 | |
2950 Available video output drivers are: | |
2951 . | |
2952 .TP | |
2953 .B xv (X11 only) | |
2954 Uses the XVideo extension of XFree86 4.x to enable hardware | |
2955 accelerated playback. | |
2956 If you cannot use a hardware specific driver, this is probably | |
2957 the best option. | |
2958 For information about what colorkey is used and how it is drawn run MPlayer | |
2959 with \-v option and look out for the lines tagged with [xv common] at the | |
2960 beginning. | |
2961 .PD 0 | |
2962 .RSs | |
2963 .IPs port=<number> | |
2964 Select a specific XVideo port. | |
2965 .IPs ck=<cur|use|set> | |
2966 Select the source from which the colorkey is taken (default: cur). | |
2967 .RSss | |
2968 .IPs cur | |
2969 The default takes the colorkey currently set in Xv. | |
2970 .IPs use | |
2971 Use but do not set the colorkey from MPlayer (use \-colorkey option to change | |
2972 it). | |
2973 .IPs set | |
2974 Same as use but also sets the supplied colorkey. | |
2975 .RE | |
2976 .IPs ck-method=<man|bg|auto> | |
2977 Sets the colorkey drawing method (default: man). | |
2978 .RSss | |
2979 .IPs man | |
2980 Draw the colorkey manually (reduces flicker in some cases). | |
2981 .IPs bg | |
2982 Set the colorkey as window background. | |
2983 .IPs auto | |
2984 Let Xv draw the colorkey. | |
2985 .RE | |
2986 .RE | |
2987 .PD 1 | |
2988 . | |
2989 .TP | |
2990 .B x11 (X11 only) | |
2991 Shared memory video output driver without hardware acceleration that | |
2992 works whenever X11 is present. | |
2993 . | |
2994 .TP | |
2995 .B xover (X11 only) | |
2996 Adds X11 support to all overlay based video output drivers. | |
2997 Currently only supported by tdfx_vid. | |
2998 .PD 0 | |
2999 .RSs | |
3000 .IPs <vo_driver> | |
3001 Select the driver to use as source to overlay on top of X11. | |
3002 .RE | |
3003 .PD 1 | |
3004 . | |
3005 .TP | |
3006 .B xvmc (X11 with \-vc ffmpeg12mc only) | |
3007 Video output driver that uses the XvMC (X Video Motion Compensation) | |
3008 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding. | |
3009 .PD 0 | |
3010 .RSs | |
3011 .IPs port=<number> | |
3012 Select a specific XVideo port. | |
3013 .IPs (no)benchmark | |
3014 Disables image display. | |
3015 Necessary for proper benchmarking of drivers that change | |
3016 image buffers on monitor retrace only (nVidia). | |
3017 Default is not to disable image display (nobenchmark). | |
3018 .IPs (no)bobdeint | |
3019 Very simple deinterlacer. | |
3020 Might not look better than \-vf tfields=1, | |
3021 but it is the only deinterlacer for xvmc (default: nobobdeint). | |
3022 .IPs (no)queue | |
3023 Queue frames for display to allow more parallel work of the video hardware. | |
3024 May add a small (not noticeable) constant A/V desync (default: noqueue). | |
3025 .IPs (no)sleep | |
3026 Use sleep function while waiting for rendering to finish | |
3027 (not recommended on Linux) (default: nosleep). | |
3028 .IPs ck=cur|use|set | |
3029 Same as \-vo xv:ck (see \-vo xv). | |
3030 .IPs ck-method=man|bg|auto | |
3031 Same as \-vo xv:ck-method (see \-vo xv). | |
3032 .RE | |
3033 .PD 1 | |
3034 . | |
3035 .TP | |
3036 .B dga (X11 only) | |
3037 Play video through the XFree86 Direct Graphics Access extension. | |
3038 Considered obsolete. | |
3039 . | |
3040 .TP | |
3041 .B sdl (SDL only) | |
3042 Highly platform independent SDL (Simple Directmedia Layer) library | |
3043 video output driver. | |
3044 Since SDL uses its own X11 layer, MPlayer X11 options do not have | |
3045 any effect on SDL. | |
3046 .PD 0 | |
3047 .RSs | |
3048 .IPs driver=<driver> | |
3049 Explicitly choose the SDL driver to use. | |
3050 .IPs (no)forcexv | |
3051 Use XVideo through the sdl video output driver (default: forcexv). | |
3052 .IPs (no)hwaccel | |
3053 Use hardware accelerated scaler (default: hwaccel). | |
3054 .RE | |
3055 .PD 1 | |
3056 . | |
3057 .TP | |
3058 .B "vidix\ \ " | |
3059 VIDIX (VIDeo Interface for *niX) is an interface to the | |
3060 video acceleration features of different graphics cards. | |
3061 Very fast video output driver on cards that support it. | |
3062 .PD 0 | |
3063 .RSs | |
3064 .IPs <subdevice> | |
3065 Explicitly choose the VIDIX subdevice driver to use. | |
3066 Available subdevice drivers are cyberblade_vid.so, mach64_vid.so, | |
3067 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so, | |
3068 radeon_vid.so, rage128_vid.so, sis_vid.so and unichrome_vid.so. | |
3069 .RE | |
3070 .PD 1 | |
3071 . | |
3072 .TP | |
3073 .B xvidix (X11 only) | |
3074 X11 frontend for VIDIX | |
3075 .PD 0 | |
3076 .RSs | |
3077 .IPs <subdevice> | |
3078 same as vidix | |
3079 .RE | |
3080 .PD 1 | |
3081 . | |
3082 .TP | |
3083 .B "cvidix\ " | |
3084 Generic and platform independent VIDIX frontend, can even run in a | |
3085 text console with nVidia cards. | |
3086 .PD 0 | |
3087 .RSs | |
3088 .IPs <subdevice> | |
3089 same as vidix | |
3090 .RE | |
3091 .PD 1 | |
3092 . | |
3093 .TP | |
3094 .B winvidix (Windows only) | |
3095 Windows frontend for VIDIX | |
3096 .PD 0 | |
3097 .RSs | |
3098 .IPs <subdevice> | |
3099 same as vidix | |
3100 .RE | |
3101 .PD 1 | |
3102 . | |
3103 .TP | |
3104 .B directx (Windows only) | |
3105 Video output driver that uses the DirectX interface. | |
3106 .PD 0 | |
3107 .RSs | |
3108 .IPs noaccel | |
3109 Turns off hardware acceleration. | |
3110 Try this option if you have display problems. | |
3111 .RE | |
3112 .PD 1 | |
3113 . | |
3114 .TP | |
3115 .B quartz (Mac OS X only) | |
3116 Mac OS X Quartz video output driver. | |
3117 Under some circumstances, it might be more efficient to force a | |
3118 packed YUV output format, with e.g.\& \-vf format=yuy2. | |
3119 .PD 0 | |
3120 .RSs | |
3121 .IPs device_id=<number> | |
3122 Choose the display device to use in fullscreen. | |
3123 .IPs fs_res=<width>:<height> | |
3124 Specify the fullscreen resolution (useful on slow systems). | |
3125 .RE | |
3126 .PD 1 | |
3127 . | |
3128 .TP | |
3129 .B macosx (Mac OS X 10.4 or 10.3.9 with QuickTime 7) | |
3130 Mac OS X CoreVideo video output driver | |
3131 .PD 0 | |
3132 .RSs | |
3133 .IPs device_id=<number> | |
3134 Choose the display device to use in fullscreen. | |
3135 .RE | |
3136 .PD 1 | |
3137 . | |
3138 .TP | |
3139 .B fbdev (Linux only) | |
3140 Uses the kernel framebuffer to play video. | |
3141 .PD 0 | |
3142 .RSs | |
3143 .IPs <device> | |
3144 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the | |
3145 name of the VIDIX subdevice if the device name starts with 'vidix' | |
3146 (e.g.\& 'vidixsis_vid' for the sis driver). | |
3147 .RE | |
3148 .PD 1 | |
3149 . | |
3150 .TP | |
3151 .B fbdev2 (Linux only) | |
3152 Uses the kernel framebuffer to play video, | |
3153 alternative implementation. | |
3154 .PD 0 | |
3155 .RSs | |
3156 .IPs <device> | |
3157 Explicitly choose the fbdev device name to use (default: /dev/\:fb0). | |
3158 .RE | |
3159 .PD 1 | |
3160 . | |
3161 .TP | |
3162 .B "vesa\ \ \ " | |
3163 Very general video output driver that should work on any VESA VBE 2.0 | |
3164 compatible card. | |
3165 .PD 0 | |
3166 .RSs | |
3167 .IPs "dga\ \ " | |
3168 Turns on DGA mode. | |
3169 .IPs nodga | |
3170 Turns off DGA mode. | |
3171 .IPs neotv_pal | |
3172 Activate the NeoMagic TV out and set it to PAL norm. | |
3173 .IPs neotv_ntsc | |
3174 Activate the NeoMagic TV out and set it to NTSC norm. | |
3175 .IPs vidix | |
3176 Use the VIDIX driver. | |
3177 .IPs "lvo:\ \ \ " | |
3178 Activate the Linux Video Overlay on top of VESA mode. | |
3179 .RE | |
3180 .PD 1 | |
3181 . | |
3182 .TP | |
3183 .B "svga\ \ \ " | |
3184 Play video using the SVGA library. | |
3185 .PD 0 | |
3186 .RSs | |
3187 .IPs "<video mode>" | |
3188 Specify video mode to use. | |
3189 The mode can be given in a <width>x<height>x<colors> format, | |
3190 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84. | |
3191 .IPs bbosd | |
3192 Draw OSD into black bands below the movie (slower). | |
3193 .IPs native | |
3194 Use only native drawing functions. | |
3195 This avoids direct rendering, OSD and hardware acceleration. | |
3196 .IPs retrace | |
3197 Force frame switch on vertical retrace. | |
3198 Usable only with \-double. | |
3199 It has the same effect as the \-vsync option. | |
3200 .IPs "sq\ \ \ " | |
3201 Try to select a video mode with square pixels. | |
3202 .IPs vidix | |
3203 Use svga with VIDIX. | |
3204 .RE | |
3205 .PD 1 | |
3206 . | |
3207 .TP | |
3208 .B "gl\ \ \ \ \ " | |
3209 OpenGL video output driver, simple version. | |
3210 Video size must be smaller than | |
3211 the maximum texture size of your OpenGL implementation. | |
3212 Intended to work even with the most basic OpenGL implementations, | |
3213 but also makes use of newer extensions, which allow support for more | |
3214 colorspaces and direct rendering. | |
3215 Please use \-dr if it works with your OpenGL implementation, | |
3216 since for higher resolutions this provides a | |
3217 .B big | |
3218 speedup. | |
3219 The code performs very few checks, so if a feature does not work, this | |
3220 might be because it is not supported by your card/OpenGL implementation | |
3221 even if you do not get any error message. | |
3222 Use glxinfo or a similar tool to display the supported OpenGL extensions. | |
3223 .PD 0 | |
3224 .RSs | |
3225 .IPs (no)manyfmts | |
3226 Enables support for more (RGB and BGR) color formats (default: enabled). | |
3227 Needs OpenGL version >= 1.2. | |
3228 .IPs slice-height=<0\-...> | |
3229 Number of lines copied to texture in one piece (default: 4). | |
3230 0 for whole image. | |
3231 .br | |
3232 .I NOTE: | |
3233 If YUV colorspace is used (see yuv suboption), special rules apply: | |
3234 .RSss | |
3235 If the decoder uses slice rendering (see \-noslices), this setting | |
3236 has no effect, the size of the slices as provided by the decoder is used. | |
3237 .br | |
3238 If the decoder does not use slice rendering, the default is 16. | |
3239 .RE | |
3240 .IPs (no)osd | |
3241 Enable or disable support for OSD rendering via OpenGL (default: enabled). | |
3242 This option is for testing; to disable the OSD use \-osdlevel 0 instead. | |
3243 .IPs (no)scaled-osd | |
3244 Changes the way the OSD behaves when the size of the | |
3245 window changes (default: disabled). | |
3246 When enabled behaves more like the other video output drivers, | |
3247 which is better for fixed-size fonts. | |
3248 Disabled looks much better with FreeType fonts and uses the | |
3249 borders in fullscreen mode. | |
3250 Does not work correctly with ass subtitles (see \-ass). | |
3251 .IPs osdcolor=<0xRRGGBB> | |
3252 Color for OSD (default: 0xffffff, corresponds to white). | |
3253 .IPs (no)aspect | |
3254 Enable or disable aspect scaling and pan-and-scan support (default: enabled). | |
3255 Disabling might increase speed. | |
3256 .IPs rectangle=<0,1,2> | |
3257 Select usage of rectangular textures which saves video RAM, but often is | |
3258 slower (default: 0). | |
3259 .RSss | |
3260 0: Use power-of-two textures (default). | |
3261 .br | |
3262 1: Use the GL_ARB_texture_rectangle extension. | |
3263 .br | |
3264 2: Use the GL_ARB_texture_non_power_of_two extension. | |
3265 In some cases only supported in software and thus very slow. | |
3266 .RE | |
3267 .IPs (no)glfinish | |
3268 Call glFinish() before swapping buffers. | |
3269 Slower but in some cases more correct output (default: disabled). | |
3270 .IPs swapinterval=<n> | |
3271 Minimum interval between two buffer swaps, counted in | |
3272 displayed frames (default: 1). | |
3273 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC. | |
3274 Values below 0 will leave it at the system default. | |
3275 This limits the framerate to (horizontal refresh rate / n). | |
3276 Requires GLX_SGI_swap_control support to work. | |
3277 With some (most/all?) implementations this only works in fullscreen mode. | |
3278 .IPs yuv=<n> | |
3279 Select the type of YUV to RGB conversion. | |
3280 .RSss | |
3281 0: Use software conversion (default). | |
3282 Compatible with all OpenGL versions. | |
3283 Provides brightness, contrast and saturation control. | |
3284 .br | |
3285 1: Use register combiners. | |
3286 This uses an nVidia-specific extension (GL_NV_register_combiners). | |
3287 At least three texture units are needed. | |
3288 Provides saturation and hue control. | |
3289 This method is fast but inexact. | |
3290 .br | |
3291 2: Use a fragment program. | |
3292 Needs the GL_ARB_fragment_program extension and at least three texture units. | |
3293 Provides brightness, contrast, saturation and hue control. | |
3294 .br | |
3295 3: Use a fragment program using the POW instruction. | |
3296 Needs the GL_ARB_fragment_program extension and at least three texture units. | |
3297 Provides brightness, contrast, saturation, hue and gamma control. | |
3298 Gamma can also be set independently for red, green and blue. | |
3299 Method 4 is usually faster. | |
3300 .br | |
3301 4: Use a fragment program with additional lookup. | |
3302 Needs the GL_ARB_fragment_program extension and at least four texture units. | |
3303 Provides brightness, contrast, saturation, hue and gamma control. | |
3304 Gamma can also be set independently for red, green and blue. | |
3305 .br | |
3306 5: Use ATI-specific method (for older cards). | |
3307 This uses an ATI-specific extension (GL_ATI_fragment_shader - not | |
3308 GL_ARB_fragment_shader!). | |
3309 At least three texture units are needed. | |
3310 Provides saturation and hue control. | |
3311 This method is fast but inexact. | |
3312 .br | |
3313 6: Use a 3D texture to do conversion via lookup. | |
3314 Needs the GL_ARB_fragment_program extension and at least four texture units. | |
3315 Extremely slow (software emulation) on some (all?) ATI cards since it uses | |
3316 a texture with border pixels. | |
3317 Provides brightness, contrast, saturation, hue and gamma control. | |
3318 Gamma can also be set independently for red, green and blue. | |
3319 Speed depends more on GPU memory bandwidth than other methods. | |
3320 .RE | |
3321 .IPs lscale=<n> | |
3322 Select the scaling function to use for luminance scaling. | |
3323 Only valid for yuv modes 2, 3, 4 and 6. | |
3324 .RSss | |
3325 0: Use simple linear filtering (default). | |
3326 .br | |
3327 1: Use bicubic filtering (better quality). | |
3328 Needs one additional texture unit. | |
3329 Older cards will not be able to handle this for chroma at least in fullscreen mode. | |
3330 .RE | |
3331 .IPs cscale=<n> | |
3332 Select the scaling function to use for chrominance scaling. | |
3333 For details see lscale. | |
3334 .IPs customprog=<filename> | |
3335 Load a custom fragment program from <filename>. | |
3336 See TOOLS/edgedect.fp for an example. | |
3337 .IPs customtex=<filename> | |
3338 Load a custom "gamma ramp" texture from <filename>. | |
3339 This can be used in combination with yuv=4 or with the customprog option. | |
3340 .IPs (no)customtlin | |
3341 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST | |
3342 for customtex texture. | |
3343 .IPs (no)customtrect | |
3344 If enabled, use texture_rectangle for customtex texture. | |
3345 Default is disabled. | |
3346 .REss | |
3347 .RE | |
3348 .PD 1 | |
3349 . | |
3350 .TP | |
3351 .B "gl2\ \ \ \ " | |
3352 OpenGL video output driver, second generation. | |
3353 Supports OSD and videos larger than the maximum texture size. | |
3354 .PD 0 | |
3355 .RSs | |
3356 .IPs (no)glfinish | |
3357 same as gl (default: enabled) | |
3358 .IPs yuv=<n> | |
3359 Select the type of YUV to RGB conversion. | |
3360 If set to anything except 0 OSD will be disabled and brightness, contrast and | |
3361 gamma setting is only available via the global X server settings. | |
3362 Apart from this the values have the same meaning as for \-vo gl. | |
3363 .REss | |
3364 . | |
3365 .TP | |
3366 .B "null\ \ \ " | |
3367 Produces no video output. | |
3368 Useful for benchmarking. | |
3369 . | |
3370 .TP | |
3371 .B "aa\ \ \ \ \ " | |
3372 ASCII art video output driver that works on a text console. | |
3373 You can get a list and an explanation of available suboptions executing | |
3374 .I mplayer \-vo aa:help | |
3375 . | |
3376 .TP | |
3377 .B "caca\ \ \ " | |
3378 Color ASCII art video output driver that works on a text console. | |
3379 . | |
3380 .TP | |
3381 .B "bl\ \ \ \ \ " | |
3382 Video playback using the Blinkenlights UDP protocol. | |
3383 This driver is highly hardware specific. | |
3384 .PD 0 | |
3385 .RSs | |
3386 .IPs <subdevice> | |
3387 Explicitly choose the Blinkenlights subdevice driver to use. | |
3388 It is something like arcade:host=localhost:2323 or | |
3389 hdl:file=name1,file=name2. | |
3390 You must specify a subdevice. | |
3391 .RE | |
3392 .PD 1 | |
3393 . | |
3394 .TP | |
3395 .B "ggi\ \ \ \ " | |
3396 GGI graphics system video output driver | |
3397 .PD 0 | |
3398 .RSs | |
3399 .IPs <driver> | |
3400 Explicitly choose the GGI driver to use. | |
3401 Replace any ',' that would appear in the driver string by a '.'. | |
3402 .RE | |
3403 .PD 1 | |
3404 . | |
3405 .TP | |
3406 .B directfb | |
3407 Play video using the DirectFB library. | |
3408 .PD 0 | |
3409 .RSs | |
3410 .IPs (no)input | |
3411 Use the DirectFB instead of the MPlayer keyboard code (default: enabled). | |
3412 .IPs buffermode=single|double|triple | |
3413 Double and triple buffering give best results if you want to avoid tearing issues. | |
3414 Triple buffering is more efficient than double buffering as it does | |
3415 not block MPlayer while waiting for the vertical retrace. | |
3416 Single buffering should be avoided (default: single). | |
3417 .IPs fieldparity=top|bottom | |
3418 Control the output order for interlaced frames (default: disabled). | |
3419 Valid values are top = top fields first, bottom = bottom fields first. | |
3420 This option does not have any effect on progressive film material | |
3421 like most MPEG movies are. | |
3422 You need to enable this option if you have tearing issues or unsmooth | |
3423 motions watching interlaced film material. | |
3424 .IPs layer=N | |
3425 Will force layer with ID N for playback (default: -1 - auto). | |
3426 .IPs dfbopts=<list> | |
3427 Specify a parameter list for DirectFB. | |
3428 .RE | |
3429 .PD 1 | |
3430 . | |
3431 .TP | |
3432 .B "dfbmga\ " | |
3433 Matrox G400/\:G450/\:G550 specific video output driver that uses the | |
3434 DirectFB library to make use of special hardware features. | |
3435 Enables CRTC2 (second head), displaying video independently of the first head. | |
3436 .PD 0 | |
3437 .RSs | |
3438 .IPs (no)input | |
3439 same as directfb (default: disabled) | |
3440 .IPs buffermode=single|double|triple | |
3441 same as directfb (default: triple) | |
3442 .IPs fieldparity=top|bottom | |
3443 same as directfb | |
3444 .IPs (no)bes | |
3445 Enable the use of the Matrox BES (backend scaler) (default: disabled). | |
3446 Gives very good results concerning speed and output quality as interpolated | |
3447 picture processing is done in hardware. | |
3448 Works only on the primary head. | |
3449 .IPs (no)spic | |
3450 Make use of the Matrox sub picture layer to display the OSD (default: enabled). | |
3451 .IPs (no)crtc2 | |
3452 Turn on TV-out on the second head (default: enabled). | |
3453 The output quality is amazing as it is a full interlaced picture | |
3454 with proper sync to every odd/\:even field. | |
3455 .IPs tvnorm=pal|ntsc|auto | |
3456 Will set the TV norm of the Matrox card without the need | |
3457 for modifying /etc/\:directfbrc (default: disabled). | |
3458 Valid norms are pal = PAL, ntsc = NTSC. | |
3459 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides | |
3460 which norm to use by looking at the framerate of the movie. | |
3461 .RE | |
3462 .PD 1 | |
3463 . | |
3464 .TP | |
3465 .B mga (Linux only) | |
3466 Matrox specific video output driver that makes use of the YUV back | |
3467 end scaler on Gxxx cards through a kernel module. | |
3468 If you have a Matrox card, this is the fastest option. | |
3469 .PD 0 | |
3470 .RSs | |
3471 .IPs <device> | |
3472 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid). | |
3473 .RE | |
3474 .PD 1 | |
3475 . | |
3476 .TP | |
3477 .B xmga (Linux, X11 only) | |
3478 The mga video output driver, running in an X11 window. | |
3479 .PD 0 | |
3480 .RSs | |
3481 .IPs <device> | |
3482 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid). | |
3483 .RE | |
3484 .PD 1 | |
3485 . | |
3486 .TP | |
3487 .B "syncfb\ " | |
3488 Video output driver for the SyncFB kernel module, which provides | |
3489 special hardware features of Matrox Gxxx cards like hardware | |
3490 deinterlacing, scaling and synchronizing your video output to | |
3491 the vertical retrace of your monitor. | |
3492 . | |
3493 .TP | |
3494 .B 3dfx (Linux only) | |
3495 3dfx specific video output driver. | |
3496 This driver directly uses the 3dfx hardware on top of X11. | |
3497 Only 16 bpp are supported. | |
3498 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid? | |
3499 . | |
3500 .TP | |
3501 .B tdfxfb (Linux only) | |
3502 This driver employs the tdfx framebuffer driver to play movies with | |
3503 YUV acceleration on 3dfx cards. | |
3504 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid? | |
3505 .PD 0 | |
3506 .RSs | |
3507 .IPs <device> | |
3508 Explicitly choose the fbdev device name to use (default: /dev/\:fb0). | |
3509 .RE | |
3510 .PD 1 | |
3511 . | |
3512 .TP | |
3513 .B tdfx_vid (Linux only) | |
3514 3dfx specific video output driver. | |
3515 This driver directly uses the tdfx_vid kernel module. | |
3516 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid? | |
3517 .PD 0 | |
3518 .RSs | |
3519 .IPs <device> | |
3520 Explicitly choose the device name to use (default: /dev/\:tdfx_vid). | |
3521 .RE | |
3522 .PD 1 | |
3523 . | |
3524 .TP | |
3525 .B dxr2 (also see \-dxr2) (DXR2 only) | |
3526 Creative DXR2 specific video output driver. | |
3527 .PD 0 | |
3528 .RSs | |
3529 .IPs <vo_driver> | |
3530 Output video subdriver to use as overlay (x11, xv). | |
3531 .RE | |
3532 .PD 1 | |
3533 . | |
3534 .TP | |
3535 .B dxr3 (DXR3 only) | |
3536 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs | |
3537 Hollywood Plus) specific video output driver. | |
3538 Also see the lavc video filter. | |
3539 .PD 0 | |
3540 .RSs | |
3541 .IPs overlay | |
3542 Activates the overlay instead of TVOut. | |
3543 .IPs prebuf | |
3544 Turns on prebuffering. | |
3545 .IPs "sync\ " | |
3546 Will turn on the new sync-engine. | |
3547 .IPs norm=<norm> | |
3548 Specifies the TV norm. | |
3549 .RSss | |
3550 0: Does not change current norm (default). | |
3551 .br | |
3552 1: Auto-adjust using PAL/\:NTSC. | |
3553 .br | |
3554 2: Auto-adjust using PAL/\:PAL-60. | |
3555 .br | |
3556 3: PAL | |
3557 .br | |
3558 4: PAL-60 | |
3559 .br | |
3560 5: NTSC | |
3561 .REss | |
3562 .IPs <0\-3> | |
3563 Specifies the device number to use if you have more than one em8300 card. | |
3564 .RE | |
3565 .PD 1 | |
3566 . | |
3567 .TP | |
3568 .B ivtv (IVTV only) | |
3569 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression | |
3570 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500) | |
3571 specific video output driver for TV-Out. | |
3572 Also see the lavc video filter. | |
3573 .PD 0 | |
3574 .RSs | |
3575 .IPs device | |
3576 Explicitly choose the MPEG decoder device name to use (default: /dev/video16). | |
3577 .IPs output | |
3578 Explicitly choose the TV-Out output to be used for the video signal. | |
3579 .RE | |
3580 .PD 1 | |
3581 . | |
3582 .TP | |
3583 .B mpegpes (DVB only) | |
3584 Video output driver for DVB cards that writes the output to an MPEG-PES file | |
3585 if no DVB card is installed. | |
3586 .PD 0 | |
3587 .RSs | |
3588 .IPs card=<1\-4> | |
3589 Specifies the device number to use if you have more than one DVB output card | |
3590 (V3 API only, such as 1.x.y series drivers). | |
3591 .IPs <filename> | |
3592 output filename (default: ./grab.mpg) | |
3593 .RE | |
3594 .PD 1 | |
3595 . | |
3596 .TP | |
3597 .B zr (also see \-zr* and \-zrhelp) | |
3598 Video output driver for a number of MJPEG capture/\:playback cards. | |
3599 . | |
3600 .TP | |
3601 .B zr2 (also see the zrmjpeg video filter) | |
3602 Video output driver for a number of MJPEG capture/\:playback cards, | |
3603 second generation. | |
3604 .PD 0 | |
3605 .RSs | |
3606 .IPs dev=<device> | |
3607 Specifies the video device to use. | |
3608 .IPs norm=<PAL|NTSC|SECAM|auto> | |
3609 Specifies the video norm to use (default: auto). | |
3610 .IPs (no)prebuf | |
3611 (De)Activate prebuffering, not yet supported. | |
3612 .RE | |
3613 .PD 1 | |
3614 . | |
3615 .TP | |
3616 .B "md5sum\ " | |
3617 Calculate MD5 sums of each frame and write them to a file. | |
3618 Supports RGB24 and YV12 colorspaces. | |
3619 Useful for debugging. | |
3620 .PD 0 | |
3621 .RSs | |
3622 .IPs outfile=<value> | |
3623 Specify the output filename (default: ./md5sums). | |
3624 .RE | |
3625 .PD 1 | |
3626 . | |
3627 .TP | |
3628 .B yuv4mpeg | |
3629 Transforms the video stream into a sequence of uncompressed YUV 4:2:0 | |
3630 images and stores it in a file (default: ./stream.yuv). | |
3631 The format is the same as the one employed by mjpegtools, so this is | |
3632 useful if you want to process the video with the mjpegtools suite. | |
3633 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format. | |
3634 You can combine it with the \-fixed-vo option to concatenate files | |
3635 with the same dimensions and fps value. | |
3636 .PD 0 | |
3637 .RSs | |
3638 .IPs interlaced | |
3639 Write the output as interlaced frames, top field first. | |
3640 .IPs interlaced_bf | |
3641 Write the output as interlaced frames, bottom field first. | |
3642 .IPs file=<filename> | |
3643 Write the output to <filename> instead of the default stream.yuv. | |
3644 .REss | |
3645 .PD 1 | |
3646 .RS | |
3647 .sp 1 | |
3648 .I NOTE: | |
3649 If you do not specify any option the output is progressive | |
3650 (i.e.\& not interlaced). | |
3651 .RE | |
3652 . | |
3653 .TP | |
3654 .B "gif89a\ " | |
3655 Output each frame into a single animated GIF file in the current directory. | |
3656 It supports only RGB format with 24 bpp and the output is converted to 256 | |
3657 colors. | |
3658 .PD 0 | |
3659 .RSs | |
3660 .IPs <fps> | |
3661 Float value to specify framerate (default: 5.0). | |
3662 .IPs <filename> | |
3663 Specify the output filename (default: ./out.gif). | |
3664 .REss | |
3665 .PD 1 | |
3666 .RS | |
3667 .sp 1 | |
3668 .I NOTE: | |
3669 You must specify the framerate before the filename or the framerate will | |
3670 be part of the filename. | |
3671 .sp 1 | |
3672 .I EXAMPLE: | |
3673 .RE | |
3674 .PD 0 | |
3675 .RSs | |
3676 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif | |
3677 .RE | |
3678 .PD 1 | |
3679 . | |
3680 .TP | |
3681 .B "jpeg\ \ \ " | |
3682 Output each frame into a JPEG file in the current directory. | |
3683 Each file takes the frame number padded with leading zeros as name. | |
3684 .PD 0 | |
3685 .RSs | |
3686 .IPs [no]progressive | |
3687 Specify standard or progressive JPEG (default: noprogressive). | |
3688 .IPs [no]baseline | |
3689 Specify use of baseline or not (default: baseline). | |
3690 .IPs optimize=<0\-100> | |
3691 optimization factor (default: 100) | |
3692 .IPs smooth=<0\-100> | |
3693 smooth factor (default: 0) | |
3694 .IPs quality=<0\-100> | |
3695 quality factor (default: 75) | |
3696 .IPs outdir=<dirname> | |
3697 Specify the directory to save the JPEG files to (default: ./). | |
3698 .IPs subdirs=<prefix> | |
3699 Create numbered subdirectories with the specified prefix to | |
3700 save the files in instead of the current directory. | |
3701 .IPs maxfiles=<value> (subdirs only) | |
3702 Maximum number of files to be saved per subdirectory. | |
3703 Must be equal to or larger than 1 (default: 1000). | |
3704 .RE | |
3705 .PD 1 | |
3706 . | |
3707 .TP | |
3708 .B "pnm\ \ \ \ " | |
3709 Output each frame into a PNM file in the current directory. | |
3710 Each file takes the frame number padded with leading zeros as name. | |
3711 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode. | |
3712 Also see pnm(5), ppm(5) and pgm(5). | |
3713 .PD 0 | |
3714 .RSs | |
3715 .IPs "ppm\ \ " | |
3716 Write PPM files (default). | |
3717 .IPs "pgm\ \ " | |
3718 Write PGM files. | |
3719 .IPs pgmyuv | |
3720 Write PGMYUV files. | |
3721 PGMYUV is like PGM, but it also contains the U and V plane, appended at the | |
3722 bottom of the picture. | |
3723 .IPs "raw\ \ " | |
3724 Write PNM files in raw mode (default). | |
3725 .IPs ascii | |
3726 Write PNM files in ASCII mode. | |
3727 .IPs outdir=<dirname> | |
3728 Specify the directory to save the PNM files to (default: ./). | |
3729 .IPs subdirs=<prefix> | |
3730 Create numbered subdirectories with the specified prefix to | |
3731 save the files in instead of the current directory. | |
3732 .IPs maxfiles=<value> (subdirs only) | |
3733 Maximum number of files to be saved per subdirectory. | |
3734 Must be equal to or larger than 1 (default: 1000). | |
3735 .RE | |
3736 .PD 1 | |
3737 . | |
3738 .TP | |
3739 .B "png\ \ \ \ " | |
3740 Output each frame into a PNG file in the current directory. | |
3741 Each file takes the frame number padded with leading zeros as name. | |
3742 24bpp RGB and BGR formats are supported. | |
3743 .PD 0 | |
3744 .RSs | |
3745 .IPs z=<0-9> | |
3746 Specifies the compression level. | |
3747 0 is no compression, 9 is maximum compression. | |
3748 .RE | |
3749 .PD 1 | |
3750 . | |
3751 .TP | |
3752 .B "tga\ \ \ \ " | |
3753 Output each frame into a Targa file in the current directory. | |
3754 Each file takes the frame number padded with leading zeros as name. | |
3755 The purpose of this video output driver is to have a simple lossless | |
3756 image writer to use without any external library. | |
3757 It supports the BGR[A] color format, with 15, 24 and 32 bpp. | |
3758 You can force a particular format with the format video filter. | |
3759 .sp 1 | |
3760 .I EXAMPLE: | |
3761 .RE | |
3762 .PD 0 | |
3763 .RSs | |
3764 mplayer video.nut \-vf format=bgr15 \-vo tga | |
3765 .RE | |
3766 .PD 1 | |
3767 . | |
3768 . | |
3769 . | |
3770 .SH "DECODING/FILTERING OPTIONS" | |
3771 . | |
3772 .TP | |
3773 .B \-ac <[-|+]codec1,[-|+]codec2,...[,]> | |
3774 Specify a priority list of audio codecs to be used, according to their codec | |
3775 name in codecs.conf. | |
3776 Use a '-' before the codec name to omit it. | |
3777 Use a '+' before the codec name to force it, this will likely crash! | |
3778 If the list has a trailing ',' MPlayer will fall back on codecs not | |
3779 contained in the list. | |
3780 .br | |
3781 .I NOTE: | |
3782 See \-ac help for a full list of available codecs. | |
3783 .sp 1 | |
3784 .I EXAMPLE: | |
3785 .PD 0 | |
3786 .RSs | |
3787 .IPs "\-ac mp3acm" | |
3788 Force the l3codeca.acm MP3 codec. | |
3789 .IPs "\-ac mad," | |
3790 Try libmad first, then fall back on others. | |
3791 .IPs "\-ac hwac3,a52," | |
3792 Try hardware AC3 passthrough, software AC3, then others. | |
3793 .IPs "\-ac hwdts," | |
3794 Try hardware DTS passthrough, then fall back on others. | |
3795 .IPs "\-ac -ffmp3," | |
3796 Skip FFmpeg's MP3 decoder. | |
3797 .RE | |
3798 .PD 1 | |
3799 . | |
3800 .TP | |
3801 .B \-af-adv <force=(0\-7):list=(filters)> (also see \-af) | |
3802 Specify advanced audio filter options: | |
3803 .RSs | |
3804 .IPs force=<0\-7> | |
3805 Forces the insertion of audio filters to one of the following: | |
3806 .RSss | |
3807 0: Use completely automatic filter insertion. | |
3808 .br | |
3809 1: Optimize for accuracy (default). | |
3810 .br | |
3811 2: Optimize for speed. | |
3812 .I Warning: | |
3813 Some features in the audio filters may silently fail, | |
3814 and the sound quality may drop. | |
3815 .br | |
3816 3: Use no automatic insertion of filters and no optimization. | |
3817 .I Warning: | |
3818 It may be possible to crash MPlayer using this setting. | |
3819 .br | |
3820 4: Use automatic insertion of filters according to 0 above, | |
3821 but use floating point processing when possible. | |
3822 .br | |
3823 5: Use automatic insertion of filters according to 1 above, | |
3824 but use floating point processing when possible. | |
3825 .br | |
3826 6: Use automatic insertion of filters according to 2 above, | |
3827 but use floating point processing when possible. | |
3828 .br | |
3829 7: Use no automatic insertion of filters according to 3 above, | |
3830 and use floating point processing when possible. | |
3831 .REss | |
3832 .IPs list=<filters> | |
3833 Same as \-af. | |
3834 .RE | |
3835 . | |
3836 .TP | |
3837 .B \-afm <driver1,driver2,...> | |
3838 Specify a priority list of audio codec families to be used, according | |
3839 to their codec name in codecs.conf. | |
3840 Falls back on the default codecs if none of the given codec families work. | |
3841 .br | |
3842 .I NOTE: | |
3843 See \-afm help for a full list of available codec families. | |
3844 .sp 1 | |
3845 .I EXAMPLE: | |
3846 .PD 0 | |
3847 .RSs | |
3848 .IPs "\-afm ffmpeg" | |
3849 Try FFmpeg's libavcodec codecs first. | |
3850 .IPs "\-afm acm,dshow" | |
3851 Try Win32 codecs first. | |
3852 .RE | |
3853 .PD 1 | |
3854 . | |
3855 .TP | |
3856 .B \-aspect <ratio> (also see \-zoom) | |
3857 Override movie aspect ratio, in case aspect information is | |
3858 incorrect or missing in the file being played. | |
3859 .sp 1 | |
3860 .I EXAMPLE: | |
3861 .PD 0 | |
3862 .RSs | |
3863 \-aspect 4:3 or \-aspect 1.3333 | |
3864 .br | |
3865 \-aspect 16:9 or \-aspect 1.7777 | |
3866 .RE | |
3867 .PD 1 | |
3868 . | |
3869 .TP | |
3870 .B \-noaspect | |
3871 Disable automatic movie aspect ratio compensation. | |
3872 . | |
3873 .TP | |
3874 .B "\-flip \ " | |
3875 Flip image upside-down. | |
3876 . | |
3877 .TP | |
3878 .B \-lavdopts <option1:option2:...> (DEBUG CODE) | |
3879 Specify libavcodec decoding parameters. | |
3880 Separate multiple options with a colon. | |
3881 .sp 1 | |
3882 .I EXAMPLE: | |
3883 .PD 0 | |
3884 .RSs | |
3885 \-lavdopts gray:skiploopfilter=all:skipframe=nonref | |
3886 .RE | |
3887 .PD 1 | |
3888 .sp 1 | |
3889 .RS | |
3890 Available options are: | |
3891 .RE | |
3892 .RSs | |
3893 .IPs bitexact | |
3894 Only use bit-exact algorithms in all decoding steps (for codec testing). | |
3895 .IPs bug=<value> | |
3896 Manually work around encoder bugs. | |
3897 .RSss | |
3898 0: nothing | |
3899 .br | |
3900 1: autodetect bugs (default) | |
3901 .br | |
3902 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection) | |
3903 .br | |
3904 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX) | |
3905 .br | |
3906 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4) | |
3907 .br | |
3908 16 (mpeg4): padding bug (autodetected) | |
3909 .br | |
3910 32 (mpeg4): illegal vlc bug (autodetected per fourcc) | |
3911 .br | |
3912 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/\:version) | |
3913 .br | |
3914 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version) | |
3915 .br | |
3916 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version) | |
3917 .br | |
3918 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version) | |
3919 .br | |
3920 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version) | |
3921 .REss | |
3922 .IPs debug=<value> | |
3923 Display debugging information. | |
3924 .RSss | |
3925 .br | |
3926 0: disabled | |
3927 .br | |
3928 1: picture info | |
3929 .br | |
3930 2: rate control | |
3931 .br | |
3932 4: bitstream | |
3933 .br | |
3934 8: macroblock (MB) type | |
3935 .br | |
3936 16: per-block quantization parameter (QP) | |
3937 .br | |
3938 32: motion vector | |
3939 .br | |
3940 0x0040: motion vector visualization (use \-noslices) | |
3941 .br | |
3942 0x0080: macroblock (MB) skip | |
3943 .br | |
3944 0x0100: startcode | |
3945 .br | |
3946 0x0200: PTS | |
3947 .br | |
3948 0x0400: error resilience | |
3949 .br | |
3950 0x0800: memory management control operations (H.264) | |
3951 .br | |
3952 0x1000: bugs | |
3953 .br | |
3954 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener. | |
3955 .br | |
3956 0x4000: Visualize block types. | |
3957 .REss | |
3958 .IPs ec=<value> | |
3959 Set error concealment strategy. | |
3960 .RSss | |
3961 1: Use strong deblock filter for damaged MBs. | |
3962 .br | |
3963 2: iterative motion vector (MV) search (slow) | |
3964 .br | |
3965 3: all (default) | |
3966 .REss | |
3967 .IPs er=<value> | |
3968 Set error resilience strategy. | |
3969 .RSss | |
3970 .br | |
3971 0: disabled | |
3972 .br | |
3973 1: careful (Should work with broken encoders.) | |
3974 .br | |
3975 2: normal (default) (Works with compliant encoders.) | |
3976 .br | |
3977 3: aggressive (More checks, but might cause problems even for valid bitstreams.) | |
3978 .br | |
3979 4: very aggressive | |
3980 .REss | |
3981 .IPs "fast (MPEG-2 only)" | |
3982 Enable optimizations which do not comply to the specification and might | |
3983 potentially cause problems, like simpler dequantization, assuming use | |
3984 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few | |
3985 checks to detect damaged bitstreams. | |
3986 .IPs "gray\ " | |
3987 grayscale only decoding (a bit faster than with color) | |
3988 .IPs "idct=<0\-99> (see \-lavcopts)" | |
3989 For best decoding quality use the same IDCT algorithm for decoding and encoding. | |
3990 This may come at a price in accuracy, though. | |
3991 .IPs lowres=<number>[,<w>] | |
3992 Decode at lower resolutions. | |
3993 Low resolution decoding is not supported by all codecs, and it will | |
3994 often result in ugly artifacts. | |
3995 This is not a bug, but a side effect of not decoding at full resolution. | |
3996 .RSss | |
3997 .br | |
3998 0: disabled | |
3999 .br | |
4000 1: 1/2 resolution | |
4001 .br | |
4002 2: 1/4 resolution | |
4003 .br | |
4004 3: 1/8 resolution | |
4005 .REss | |
4006 .RS | |
4007 If <w> is specified lowres decoding will be used only if the width of the | |
4008 video is major than or equal to <w>. | |
4009 .RE | |
4010 .IPs "sb=<number> (MPEG-2 only)" | |
4011 Skip the given number of macroblock rows at the bottom. | |
4012 .IPs "st=<number> (MPEG-2 only)" | |
4013 Skip the given number of macroblock rows at the top. | |
4014 .IPs skiploopfilter=<skipvalue> (H.264 only) | |
4015 Skips the loop filter (AKA deblocking) during H.264 decoding. | |
4016 Since the filtered frame is supposed to be used as reference | |
4017 for decoding dependent frames this has a worse effect on quality | |
4018 than not doing deblocking on e.g.\& MPEG-2 video. | |
4019 But at least for high bitrate HDTV this provides a big speedup with | |
4020 no visible quality loss. | |
4021 .sp 1 | |
4022 <skipvalue> can be either one of the following: | |
4023 .RSss | |
4024 .br | |
4025 none: Never skip. | |
4026 .br | |
4027 default: Skip useless processing steps (e.g.\& 0 size packets in AVI). | |
4028 .br | |
4029 nonref: Skip frames that are not referenced (i.e.\& not used for | |
4030 decoding other frames, the error cannot "build up"). | |
4031 .br | |
4032 bidir: Skip B-Frames. | |
4033 .br | |
4034 nonkey: Skip all frames except keyframes. | |
4035 .br | |
4036 all: Skip all frames. | |
4037 .REss | |
4038 .IPs skipidct=<skipvalue> (MPEG1/2 only) | |
4039 Skips the IDCT step. | |
4040 This degrades quality a lot of in almost all cases | |
4041 (see skiploopfilter for available skip values). | |
4042 .IPs skipframe=<skipvalue> | |
4043 Skips decoding of frames completely. | |
4044 Big speedup, but jerky motion and sometimes bad artifacts | |
4045 (see skiploopfilter for available skip values). | |
4046 .IPs threads=<1\-8> | |
4047 number of threads to use for decoding (default: 1) | |
4048 .IPs vismv=<value> | |
4049 Visualize motion vectors. | |
4050 .RSss | |
4051 .br | |
4052 0: disabled | |
4053 .br | |
4054 1: Visualize forward predicted MVs of P-frames. | |
4055 .br | |
4056 2: Visualize forward predicted MVs of B-frames. | |
4057 .br | |
4058 4: Visualize backward predicted MVs of B-frames. | |
4059 .REss | |
4060 .IPs vstats | |
4061 Prints some statistics and stores them in ./vstats_*.log. | |
4062 .RE | |
4063 . | |
4064 .TP | |
4065 .B \-noslices | |
4066 Disable drawing video by 16-pixel height slices/\:bands, instead draws the | |
4067 whole frame in a single run. | |
4068 May be faster or slower, depending on video card and available cache. | |
4069 It has effect only with libmpeg2 and libavcodec codecs. | |
4070 . | |
4071 .TP | |
4072 .B \-nosound | |
4073 Do not play/\:encode sound. | |
4074 Useful for benchmarking. | |
4075 . | |
4076 .TP | |
4077 .B \-novideo | |
4078 Do not play/\:encode video. | |
4079 In many cases this will not work, use \-vc null \-vo null instead. | |
4080 . | |
4081 .TP | |
4082 .B \-pp <quality> (also see \-vf pp) | |
4083 Set the DLL postprocess level. | |
4084 This option is no longer usable with \-vf pp. | |
4085 It only works with Win32 DirectShow DLLs with internal postprocessing routines. | |
4086 The valid range of \-pp values varies by codec, it is mostly | |
4087 0\-6, where 0=disable, 6=slowest/\:best. | |
4088 . | |
4089 .TP | |
4090 .B \-pphelp (also see \-vf pp) | |
4091 Show a summary about the available postprocess filters and their usage. | |
4092 . | |
4093 .TP | |
4094 .B \-ssf <mode> | |
4095 Specifies software scaler parameters. | |
4096 .sp 1 | |
4097 .I EXAMPLE: | |
4098 .PD 0 | |
4099 .RSs | |
4100 \-vf scale \-ssf lgb=3.0 | |
4101 .RE | |
4102 .PD 1 | |
4103 .PD 0 | |
4104 .RSs | |
4105 .IPs lgb=<0\-100> | |
4106 gaussian blur filter (luma) | |
4107 .IPs cgb=<0\-100> | |
4108 gaussian blur filter (chroma) | |
4109 .IPs ls=<-100\-100> | |
4110 sharpen filter (luma) | |
4111 .IPs cs=<-100\-100> | |
4112 sharpen filter (chroma) | |
4113 .IPs chs=<h> | |
4114 chroma horizontal shifting | |
4115 .IPs cvs=<v> | |
4116 chroma vertical shifting | |
4117 .RE | |
4118 .PD 1 | |
4119 . | |
4120 .TP | |
4121 .B \-stereo <mode> | |
4122 Select type of MP2/\:MP3 stereo output. | |
4123 .PD 0 | |
4124 .RSs | |
4125 .IPs 0 | |
4126 stereo | |
4127 .IPs 1 | |
4128 left channel | |
4129 .IPs 2 | |
4130 right channel | |
4131 .RE | |
4132 .PD 1 | |
4133 . | |
4134 .TP | |
4135 .B \-sws <software scaler type> (also see \-vf scale and \-zoom) | |
4136 Specify the software scaler algorithm to be used with the \-zoom option. | |
4137 This affects video output drivers which lack hardware acceleration, e.g.\& x11. | |
4138 .sp 1 | |
4139 Available types are: | |
4140 .sp 1 | |
4141 .PD 0 | |
4142 .RSs | |
4143 .IPs 0 | |
4144 fast bilinear | |
4145 .IPs 1 | |
4146 bilinear | |
4147 .IPs 2 | |
4148 bicubic (good quality) (default) | |
4149 .IPs 3 | |
4150 experimental | |
4151 .IPs 4 | |
4152 nearest neighbor (bad quality) | |
4153 .IPs 5 | |
4154 area | |
4155 .IPs 6 | |
4156 luma bicubic / chroma bilinear | |
4157 .IPs 7 | |
4158 gauss | |
4159 .IPs 8 | |
4160 sincR | |
4161 .IPs 9 | |
4162 lanczos | |
4163 .IPs 10 | |
4164 natural bicubic spline | |
4165 .RE | |
4166 .PD 1 | |
4167 .sp 1 | |
4168 .RS | |
4169 .I NOTE: | |
4170 Some \-sws options are tunable. | |
4171 The description of the scale video filter has further information. | |
4172 .RE | |
4173 . | |
4174 .TP | |
4175 .B \-vc <[-|+]codec1,[-|+]codec2,...[,]> | |
4176 Specify a priority list of video codecs to be used, according to their codec | |
4177 name in codecs.conf. | |
4178 Use a '-' before the codec name to omit it. | |
4179 Use a '+' before the codec name to force it, this will likely crash! | |
4180 If the list has a trailing ',' MPlayer will fall back on codecs not | |
4181 contained in the list. | |
4182 .br | |
4183 .I NOTE: | |
4184 See \-vc help for a full list of available codecs. | |
4185 .sp 1 | |
4186 .I EXAMPLE: | |
4187 .PD 0 | |
4188 .RSs | |
4189 .IPs "\-vc divx" | |
4190 Force Win32/\:VfW DivX codec, no fallback. | |
4191 .IPs "\-vc -divxds,-divx," | |
4192 Skip Win32 DivX codecs. | |
4193 .IPs "\-vc ffmpeg12,mpeg12," | |
4194 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others. | |
4195 .RE | |
4196 .PD 1 | |
4197 . | |
4198 .TP | |
4199 .B \-vfm <driver1,driver2,...> | |
4200 Specify a priority list of video codec families to be used, according | |
4201 to their names in codecs.conf. | |
4202 Falls back on the default codecs if none of the given codec families work. | |
4203 .br | |
4204 .I NOTE: | |
4205 See \-vfm help for a full list of available codec families. | |
4206 .sp 1 | |
4207 .I EXAMPLE: | |
4208 .PD 0 | |
4209 .RSs | |
4210 .IPs "\-vfm ffmpeg,dshow,vfw" | |
4211 Try the libavcodec, then Directshow, then VfW codecs and fall back | |
4212 on others, if they do not work. | |
4213 .IPs "\-vfm xanim" | |
4214 Try XAnim codecs first. | |
4215 .RE | |
4216 .PD 1 | |
4217 . | |
4218 .TP | |
4219 .B \-x <x> (also see \-zoom) (MPlayer only) | |
4220 Scale image to width <x> (if software/\:hardware scaling is available). | |
4221 Disables aspect calculations. | |
4222 . | |
4223 .TP | |
4224 .B \-xvidopts <option1:option2:...> | |
4225 Specify additional parameters when decoding with XviD. | |
4226 .br | |
4227 .I NOTE: | |
4228 Since libavcodec is faster than XviD you might want to use the libavcodec | |
4229 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead. | |
4230 .sp 1 | |
4231 XviD's internal postprocessing filters: | |
4232 .PD 0 | |
4233 .RSs | |
4234 .IPs deblock-chroma (also see \-vf pp) | |
4235 chroma deblock filter | |
4236 .IPs deblock-luma (also see \-vf pp) | |
4237 luma deblock filter | |
4238 .IPs dering-luma (also see \-vf pp) | |
4239 luma deringing filter | |
4240 .IPs dering-chroma (also see \-vf pp) | |
4241 chroma deringing filter | |
4242 .IPs filmeffect (also see \-vf noise) | |
4243 Adds artificial film grain to the video. | |
4244 May increase perceived quality, while lowering true quality. | |
4245 .RE | |
4246 .sp 1 | |
4247 .RS | |
4248 rendering methods: | |
4249 .RE | |
4250 .PD 0 | |
4251 .RSs | |
4252 .IPs "dr2\ \ " | |
4253 Activate direct rendering method 2. | |
4254 .IPs nodr2 | |
4255 Deactivate direct rendering method 2. | |
4256 .RE | |
4257 .PD 1 | |
4258 . | |
4259 .TP | |
4260 .B \-xy <value> (also see \-zoom) | |
4261 .PD 0 | |
4262 .RSs | |
4263 .IPs value<=8 | |
4264 Scale image by factor <value>. | |
4265 .IPs value>8 | |
4266 Set width to value and calculate height to keep correct aspect ratio. | |
4267 .RE | |
4268 .PD 1 | |
4269 . | |
4270 .TP | |
4271 .B \-y <y> (also see \-zoom) (MPlayer only) | |
4272 Scale image to height <y> (if software/\:hardware scaling is available). | |
4273 Disables aspect calculations. | |
4274 . | |
4275 .TP | |
4276 .B "\-zoom\ \ " | |
4277 Allow software scaling, where available. | |
4278 This will allow scaling with output drivers (like x11, fbdev) that | |
4279 do not support hardware scaling where MPlayer disables scaling by | |
4280 default for performance reasons. | |
4281 . | |
4282 . | |
4283 . | |
4284 .SH "AUDIO FILTERS" | |
4285 Audio filters allow you to modify the audio stream and its properties. | |
4286 The syntax is: | |
4287 . | |
4288 .TP | |
4289 .B \-af <filter1[=parameter1:parameter2:...],filter2,...> | |
4290 Setup a chain of audio filters. | |
4291 .PP | |
4292 .I NOTE: | |
4293 To get a full list of available audio filters, see \-af help. | |
4294 .PP | |
4295 Available filters are: | |
4296 . | |
4297 .TP | |
4298 .B resample[=srate[:sloppy[:type]]] | |
4299 Changes the sample rate of the audio stream. | |
4300 Can be used if you have a fixed frequency sound card or if you are | |
4301 stuck with an old sound card that is only capable of max 44.1kHz. | |
4302 This filter is automatically enabled if necessary. | |
4303 It only supports 16-bit integer and float in native-endian format as input. | |
4304 .br | |
4305 .I NOTE: | |
4306 With MEncoder, you need to also use \-srate <srate>. | |
4307 .PD 0 | |
4308 .RSs | |
4309 .IPs <srate> | |
4310 output sample frequency in Hz. | |
4311 The valid range for this parameter is 8000 to 192000. | |
4312 If the input and output sample frequency are the same or if this | |
4313 parameter is omitted the filter is automatically unloaded. | |
4314 A high sample frequency normally improves the audio quality, | |
4315 especially when used in combination with other filters. | |
4316 .IPs <sloppy> | |
4317 Allow (1) or disallow (0) the output frequency to differ slightly | |
4318 from the frequency given by <srate> (default: 1). | |
4319 Can be used if the startup of the playback is extremely slow. | |
4320 .IPs <type> | |
4321 Selects which resampling method to use. | |
4322 .RSss | |
4323 0: linear interpolation (fast, poor quality especially when upsampling) | |
4324 .br | |
4325 1: polyphase filterbank and integer processing | |
4326 .br | |
4327 2: polyphase filterbank and floating point processing (slow, best quality) | |
4328 .REss | |
4329 .PD 1 | |
4330 .RE | |
4331 .sp 1 | |
4332 .RS | |
4333 .I EXAMPLE: | |
4334 .RE | |
4335 .PD 0 | |
4336 .RSs | |
4337 .IPs "mplayer \-af resample=44100:0:0" | |
4338 would set the output frequency of the resample filter to 44100Hz using | |
4339 exact output frequency scaling and linear interpolation. | |
4340 .RE | |
4341 .PD 1 | |
4342 . | |
4343 .TP | |
4344 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]] | |
4345 Changes the sample rate of the audio stream to an integer <srate> in Hz. | |
4346 It only supports the 16-bit native-endian format. | |
4347 .br | |
4348 .I NOTE: | |
4349 With MEncoder, you need to also use \-srate <srate>. | |
4350 .PD 0 | |
4351 .RSs | |
4352 .IPs <srate> | |
4353 the output sample rate | |
4354 .IPs <length> | |
4355 length of the filter with respect to the lower sampling rate (default: 16) | |
4356 .IPs <linear> | |
4357 if 1 then filters will be linearly interpolated between polyphase entries | |
4358 .IPs <count> | |
4359 log2 of the number of polyphase entries | |
4360 (..., 10->1024, 11->2048, 12->4096, ...) | |
4361 (default: 10->1024) | |
4362 .IPs <cutoff> | |
4363 cutoff frequency (0.0-1.0), default set depending upon filter length | |
4364 .RE | |
4365 .PD 1 | |
4366 . | |
4367 .TP | |
4368 .B sweep[=speed] | |
4369 Produces a sine sweep. | |
4370 .PD 0 | |
4371 .RSs | |
4372 .IPs <0.0\-1.0> | |
4373 Sine function delta, use very low values to hear the sweep. | |
4374 .RE | |
4375 .PD 1 | |
4376 . | |
4377 .TP | |
4378 .B sinesuppress[=freq:decay] | |
4379 Remove a sine at the specified frequency. | |
4380 Useful to get rid of the 50/60Hz noise on low quality audio equipment. | |
4381 It probably only works on mono input. | |
4382 .PD 0 | |
4383 .RSs | |
4384 .IPs <freq> | |
4385 The frequency of the sine which should be removed (in Hz) (default: 50) | |
4386 .IPs <decay> | |
4387 Controls the adaptivity (a larger value will make the filter adapt to | |
4388 amplitude and phase changes quicker, a smaller value will make the | |
4389 adaptation slower) (default: 0.0001). | |
4390 Reasonable values are around 0.001. | |
4391 .RE | |
4392 .PD 1 | |
4393 . | |
4394 .TP | |
4395 .B hrtf[=flag] | |
4396 Head-related transfer function: Converts multichannel audio to | |
4397 2 channel output for headphones, preserving the spatiality of the sound. | |
4398 .sp 1 | |
4399 .PD 0 | |
4400 .RS | |
4401 .IPs "Flag Meaning" | |
4402 .IPs "m matrix decoding of the rear channel" | |
4403 .IPs "s 2-channel matrix decoding" | |
4404 .IPs "0 no matrix decoding (default)" | |
4405 .RE | |
4406 .PD 1 | |
4407 . | |
4408 .TP | |
4409 .B equalizer=[g1:g2:g3:...:g10] | |
4410 10 octave band graphic equalizer, implemented using 10 IIR band pass filters. | |
4411 This means that it works regardless of what type of audio is being played back. | |
4412 The center frequencies for the 10 bands are: | |
4413 .sp 1 | |
4414 .PD 0 | |
4415 .RS | |
4416 .IPs "No. frequency" | |
4417 .IPs "0 31.25 Hz" | |
4418 .IPs "1 62.50 Hz" | |
4419 .IPs "2 125.00 Hz" | |
4420 .IPs "3 250.00 Hz" | |
4421 .IPs "4 500.00 Hz" | |
4422 .IPs "5 1.00 kHz" | |
4423 .IPs "6 2.00 kHz" | |
4424 .IPs "7 4.00 kHz" | |
4425 .IPs "8 8.00 kHz" | |
4426 .IPs "9 16.00 kHz" | |
4427 .RE | |
4428 .PD 1 | |
4429 .sp 1 | |
4430 .RS | |
4431 If the sample rate of the sound being played is lower than the center | |
4432 frequency for a frequency band, then that band will be disabled. | |
4433 A known bug with this filter is that the characteristics for the | |
4434 uppermost band are not completely symmetric if the sample | |
4435 rate is close to the center frequency of that band. | |
4436 This problem can be worked around by upsampling the sound | |
4437 using the resample filter before it reaches this filter. | |
4438 .RE | |
4439 .PD 0 | |
4440 .RSs | |
4441 .IPs <g1>:<g2>:<g3>:...:<g10> | |
4442 floating point numbers representing the gain in dB | |
4443 for each frequency band (-12\-12) | |
4444 .RE | |
4445 .sp 1 | |
4446 .RS | |
4447 .I EXAMPLE: | |
4448 .RE | |
4449 .RSs | |
4450 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi" | |
4451 Would amplify the sound in the upper and lower frequency region | |
4452 while canceling it almost completely around 1kHz. | |
4453 .RE | |
4454 .PD 1 | |
4455 . | |
4456 .TP | |
4457 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...] | |
4458 Can be used for adding, removing, routing and copying audio channels. | |
4459 If only <nch> is given the default routing is used, it works as | |
4460 follows: If the number of output channels is bigger than the number of | |
4461 input channels empty channels are inserted (except mixing from mono to | |
4462 stereo, then the mono channel is repeated in both of the output | |
4463 channels). | |
4464 If the number of output channels is smaller than the number | |
4465 of input channels the exceeding channels are truncated. | |
4466 .PD 0 | |
4467 .RSs | |
4468 .IPs <nch> | |
4469 number of output channels (1\-6) | |
4470 .IPs "<nr>\ " | |
4471 number of routes (1\-6) | |
4472 .IPs <from1:to1:from2:to2:from3:to3:...> | |
4473 Pairs of numbers between 0 and 5 that define where to route each channel. | |
4474 .RE | |
4475 .sp 1 | |
4476 .RS | |
4477 .I EXAMPLE: | |
4478 .RE | |
4479 .RSs | |
4480 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi" | |
4481 Would change the number of channels to 4 and set up 4 routes that | |
4482 swap channel 0 and channel 1 and leave channel 2 and 3 intact. | |
4483 Observe that if media containing two channels was played back, channels | |
4484 2 and 3 would contain silence but 0 and 1 would still be swapped. | |
4485 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi" | |
4486 Would change the number of channels to 6 and set up 4 routes | |
4487 that copy channel 0 to channels 0 to 3. | |
4488 Channel 4 and 5 will contain silence. | |
4489 .RE | |
4490 .PD 1 | |
4491 . | |
4492 .TP | |
4493 .B format[=format] (also see \-format) | |
4494 Convert between different sample formats. | |
4495 Automatically enabled when needed by the sound card or another filter. | |
4496 .PD 0 | |
4497 .RSs | |
4498 .IPs <format> | |
4499 Sets the desired format. | |
4500 The general form is 'sbe', where 's' denotes the sign (either 's' for signed | |
4501 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32) | |
4502 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian | |
4503 and 'ne' the endianness of the computer MPlayer is running on). | |
4504 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'. | |
4505 Exceptions to this rule that are also valid format specifiers: u8, s8, | |
4506 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm. | |
4507 .RE | |
4508 .PD 1 | |
4509 . | |
4510 .TP | |
4511 .B volume[=v[:sc]] | |
4512 Implements software volume control. | |
4513 Use this filter with caution since it can reduce the signal | |
4514 to noise ratio of the sound. | |
4515 In most cases it is best to set the level for the PCM sound to max, | |
4516 leave this filter out and control the output level to your | |
4517 speakers with the master volume control of the mixer. | |
4518 In case your sound card has a digital PCM mixer instead of an analog | |
4519 one, and you hear distortion, use the MASTER mixer instead. | |
4520 If there is an external amplifier connected to the computer (this | |
4521 is almost always the case), the noise level can be minimized by | |
4522 adjusting the master level and the volume knob on the amplifier | |
4523 until the hissing noise in the background is gone. | |
4524 .br | |
4525 This filter has a second feature: It measures the overall maximum | |
4526 sound level and prints out that level when MPlayer exits. | |
4527 This volume estimate can be used for setting the sound level in | |
4528 MEncoder such that the maximum dynamic range is utilized. | |
4529 .br | |
4530 .I NOTE: | |
4531 This filter is not reentrant and can therefore only be enabled | |
4532 once for every audio stream. | |
4533 .PD 0 | |
4534 .RSs | |
4535 .IPs "<v>\ \ " | |
4536 Sets the desired gain in dB for all channels in the stream | |
4537 from -200dB to +60dB, where -200dB mutes the sound | |
4538 completely and +60dB equals a gain of 1000 (default: 0). | |
4539 .IPs "<sc>\ " | |
4540 Turns soft clipping on (1) or off (0). | |
4541 Soft-clipping can make the sound more smooth if very | |
4542 high volume levels are used. | |
4543 Enable this option if the dynamic range of the | |
4544 loudspeakers is very low. | |
4545 .br | |
4546 .I WARNING: | |
4547 This feature creates distortion and should be considered a last resort. | |
4548 .RE | |
4549 .sp 1 | |
4550 .RS | |
4551 .I EXAMPLE: | |
4552 .RE | |
4553 .RSs | |
4554 .IPs "mplayer \-af volume=10.1:0 media.avi" | |
4555 Would amplify the sound by 10.1dB and hard-clip if the | |
4556 sound level is too high. | |
4557 .RE | |
4558 .PD 1 | |
4559 . | |
4560 .TP | |
4561 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...] | |
4562 Mixes channels arbitrarily. | |
4563 Basically a combination of the volume and the channels filter | |
4564 that can be used to down-mix many channels to only a few, | |
4565 e.g.\& stereo to mono or vary the "width" of the center | |
4566 speaker in a surround sound system. | |
4567 This filter is hard to use, and will require some tinkering | |
4568 before the desired result is obtained. | |
4569 The number of options for this filter depends on | |
4570 the number of output channels. | |
4571 An example how to downmix a six-channel file to two channels with | |
4572 this filter can be found in the examples section near the end. | |
4573 .PD 0 | |
4574 .RSs | |
4575 .IPs "<n>\ \ " | |
4576 number of output channels (1\-6) | |
4577 .IPs <Lij> | |
4578 How much of input channel i is mixed into output channel j (0\-1). | |
4579 So in principle you first have n numbers saying what to do with the | |
4580 first input channel, then n numbers that act on the second input channel | |
4581 etc. | |
4582 If you do not specify any numbers for some input channels, 0 is assumed. | |
4583 .RE | |
4584 .sp 1 | |
4585 .RS | |
4586 .I EXAMPLE: | |
4587 .RE | |
4588 .RSs | |
4589 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi" | |
4590 Would down-mix from stereo to mono. | |
4591 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi" | |
4592 Would give 3 channel output leaving channels 0 and 1 intact, | |
4593 and mix channels 0 and 1 into output channel 2 (which could | |
4594 be sent to a subwoofer for example). | |
4595 .RE | |
4596 .PD 1 | |
4597 . | |
4598 .TP | |
4599 .B sub[=fc:ch] | |
4600 Adds a subwoofer channel to the audio stream. | |
4601 The audio data used for creating the subwoofer channel is | |
4602 an average of the sound in channel 0 and channel 1. | |
4603 The resulting sound is then low-pass filtered by a 4th order | |
4604 Butterworth filter with a default cutoff frequency of 60Hz | |
4605 and added to a separate channel in the audio stream. | |
4606 .br | |
4607 .I Warning: | |
4608 Disable this filter when you are playing DVDs with Dolby | |
4609 Digital 5.1 sound, otherwise this filter will disrupt | |
4610 the sound to the subwoofer. | |
4611 .PD 0 | |
4612 .RSs | |
4613 .IPs "<fc>\ " | |
4614 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz) | |
4615 For the best result try setting the cutoff frequency as low as possible. | |
4616 This will improve the stereo or surround sound experience. | |
4617 .IPs "<ch>\ " | |
4618 Determines the channel number in which to insert the sub-channel audio. | |
4619 Channel number can be between 0 and 5 (default: 5). | |
4620 Observe that the number of channels will automatically | |
4621 be increased to <ch> if necessary. | |
4622 .RE | |
4623 .sp 1 | |
4624 .RS | |
4625 .I EXAMPLE: | |
4626 .RE | |
4627 .RSs | |
4628 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi" | |
4629 Would add a sub-woofer channel with a cutoff frequency of | |
4630 100Hz to output channel 4. | |
4631 .RE | |
4632 .PD 1 | |
4633 . | |
4634 .TP | |
4635 .B "center\ " | |
4636 Creates a center channel from the front channels. | |
4637 May currently be low quality as it does not implement a | |
4638 high-pass filter for proper extraction yet, but averages and | |
4639 halves the channels instead. | |
4640 .PD 0 | |
4641 .RSs | |
4642 .IPs "<ch>\ " | |
4643 Determines the channel number in which to insert the center channel. | |
4644 Channel number can be between 0 and 5 (default: 5). | |
4645 Observe that the number of channels will automatically | |
4646 be increased to <ch> if necessary. | |
4647 .RE | |
4648 .PD 1 | |
4649 . | |
4650 .TP | |
4651 .B surround[=delay] | |
4652 Decoder for matrix encoded surround sound like Dolby Surround. | |
4653 Many files with 2 channel audio actually contain matrixed surround sound. | |
4654 Requires a sound card supporting at least 4 channels. | |
4655 .PD 0 | |
4656 .RSs | |
4657 .IPs <delay> | |
4658 delay time in ms for the rear speakers (0 to 1000) (default: 20) | |
4659 This delay should be set as follows: If d1 is the distance | |
4660 from the listening position to the front speakers and d2 is the distance | |
4661 from the listening position to the rear speakers, then the delay should | |
4662 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2. | |
4663 .RE | |
4664 .sp 1 | |
4665 .RS | |
4666 .I EXAMPLE: | |
4667 .RE | |
4668 .RSs | |
4669 .IPs "mplayer \-af surround=15 \-channels 4 media.avi" | |
4670 Would add surround sound decoding with 15ms delay for the sound to the | |
4671 rear speakers. | |
4672 .RE | |
4673 .PD 1 | |
4674 . | |
4675 .TP | |
4676 .B delay[=ch1:ch2:...] | |
4677 Delays the sound to the loudspeakers such that the sound from the | |
4678 different channels arrives at the listening position simultaneously. | |
4679 It is only useful if you have more than 2 loudspeakers. | |
4680 .PD 0 | |
4681 .RSs | |
4682 .IPs ch1,ch2,... | |
4683 The delay in ms that should be imposed on each channel | |
4684 (floating point number between 0 and 1000). | |
4685 .RE | |
4686 .PD 1 | |
4687 .sp 1 | |
4688 .RS | |
4689 To calculate the required delay for the different channels do as follows: | |
4690 .IP 1. 3 | |
4691 Measure the distance to the loudspeakers in meters in relation | |
4692 to your listening position, giving you the distances s1 to s5 | |
4693 (for a 5.1 system). | |
4694 There is no point in compensating for the subwoofer (you will not hear the | |
4695 difference anyway). | |
4696 .IP 2. 3 | |
4697 Subtract the distances s1 to s5 from the maximum distance, | |
4698 i.e.\& s[i] = max(s) - s[i]; i = 1...5. | |
4699 .IP 3. | |
4700 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5. | |
4701 .RE | |
4702 .PD 0 | |
4703 .sp 1 | |
4704 .RS | |
4705 .I EXAMPLE: | |
4706 .RE | |
4707 .RSs | |
4708 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi" | |
4709 Would delay front left and right by 10.5ms, the two rear channels | |
4710 and the sub by 0ms and the center channel by 7ms. | |
4711 .RE | |
4712 .PD 1 | |
4713 . | |
4714 .TP | |
4715 .B export[=mmapped_file[:nsamples]] | |
4716 Exports the incoming signal to other processes using memory mapping (mmap()). | |
4717 Memory mapped areas contain a header: | |
4718 .sp 1 | |
4719 .nf | |
4720 int nch /*number of channels*/ | |
4721 int size /*buffer size*/ | |
4722 unsigned long long counter /*Used to keep sync, updated every | |
4723 time new data is exported.*/ | |
4724 .fi | |
4725 .sp 1 | |
4726 The rest is payload (non-interleaved) 16 bit data. | |
4727 .PD 0 | |
4728 .RSs | |
4729 .IPs <mmapped_file> | |
4730 file to map data to (default: ~/.mplayer/\:mplayer-af_export) | |
4731 .IPs <nsamples> | |
4732 number of samples per channel (default: 512) | |
4733 .RE | |
4734 .sp 1 | |
4735 .RS | |
4736 .I EXAMPLE: | |
4737 .RE | |
4738 .RSs | |
4739 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi" | |
4740 Would export 1024 samples per channel to '/tmp/mplayer-af_export'. | |
4741 .RE | |
4742 .PD 1 | |
4743 . | |
4744 .TP | |
4745 .B extrastereo[=mul] | |
4746 (Linearly) increases the difference between left and right channels | |
4747 which adds some sort of "live" effect to playback. | |
4748 .PD 0 | |
4749 .RSs | |
4750 .IPs <mul> | |
4751 Sets the difference coefficient (default: 2.5). | |
4752 0.0 means mono sound (average of both channels), with 1.0 sound will be | |
4753 unchanged, with -1.0 left and right channels will be swapped. | |
4754 .RE | |
4755 .PD 1 | |
4756 . | |
4757 .TP | |
4758 .B volnorm[=method:target] | |
4759 Maximizes the volume without distorting the sound. | |
4760 .PD 0 | |
4761 .RSs | |
4762 .IPs <method> | |
4763 Sets the used method. | |
4764 .RSss | |
4765 1: Use a single sample to smooth the variations via the standard | |
4766 weighted mean over past samples (default). | |
4767 .br | |
4768 2: Use several samples to smooth the variations via the standard | |
4769 weighted mean over past samples. | |
4770 .REss | |
4771 .IPs <target> | |
4772 Sets the target amplitude as a fraction of the maximum for the | |
4773 sample type (default: 0.25). | |
4774 .RE | |
4775 .PD 1 | |
4776 . | |
4777 .TP | |
4778 .B ladspa=file:label[:controls...] | |
4779 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin. | |
4780 This filter is reentrant, so multiple LADSPA plugins can be used at once. | |
4781 .PD 0 | |
4782 .RSs | |
4783 .IPs <file> | |
4784 Specifies the LADSPA plugin library file. | |
4785 If LADSPA_PATH is set, it searches for the specified file. | |
4786 If it is not set, you must supply a fully specified pathname. | |
4787 .IPs <label> | |
4788 Specifies the filter within the library. | |
4789 Some libraries contain only one filter, but others contain many of them. | |
4790 Entering 'help' here, will list all available filters within the specified | |
4791 library, which eliminates the use of 'listplugins' from the LADSPA SDK. | |
4792 .IPs <controls> | |
4793 Controls are zero or more floating point values that determine the | |
4794 behavior of the loaded plugin (for example delay, threshold or gain). | |
4795 In verbose mode (add \-v to the MPlayer command line), all available controls | |
4796 and their valid ranges are printed. | |
4797 This eliminates the use of 'analyseplugin' from the LADSPA SDK. | |
4798 .RE | |
4799 .PD 1 | |
4800 . | |
4801 .TP | |
4802 .B "comp\ \ \ " | |
4803 Compressor/expander filter usable for microphone input. | |
4804 Prevents artifacts on very loud sound and raises the volume on | |
4805 very low sound. | |
4806 This filter is untested, maybe even unusable. | |
4807 . | |
4808 .TP | |
4809 .B "gate\ \ \ " | |
4810 Noise gate filter similar to the comp audio filter. | |
4811 This filter is untested, maybe even unusable. | |
4812 . | |
4813 .TP | |
4814 .B karaoke | |
4815 Simple voice removal filter exploiting the fact that voice is | |
4816 usually recorded with mono gear and later 'center' mixed onto | |
4817 the final audio stream. | |
4818 Beware that this filter will turn your signal into mono. | |
4819 Works well for 2 channel tracks; do not bother trying it | |
4820 on anything but 2 channel stereo. | |
4821 . | |
4822 . | |
4823 . | |
4824 .SH "VIDEO FILTERS" | |
4825 Video filters allow you to modify the video stream and its properties. | |
4826 The syntax is: | |
4827 . | |
4828 .TP | |
4829 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...> | |
4830 Setup a chain of video filters. | |
4831 . | |
4832 .TP | |
4833 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE) | |
4834 Setup a chain of video filters, to be applied in | |
4835 .B reverse | |
4836 order. | |
4837 Deprecated in favor of \-vf. | |
4838 .PP | |
4839 Many parameters are optional and set to default values if omitted. | |
4840 To explicitly use a default value set a parameter to '-1'. | |
4841 Parameters w:h means width x height in pixels, x:y means x;y position counted | |
4842 from the upper left corner of the bigger image. | |
4843 .br | |
4844 .I NOTE: | |
4845 To get a full list of available video filters, see \-vf help. | |
4846 .sp 1 | |
4847 Video filters are managed in lists. | |
4848 There are a few commands to manage the filter list. | |
4849 . | |
4850 .TP | |
4851 .B \-vf-add <filter1[,filter2,...]> | |
4852 Appends the filters given as arguments to the filter list. | |
4853 . | |
4854 .TP | |
4855 .B \-vf-pre <filter1[,filter2,...]> | |
4856 Prepends the filters given as arguments to the filter list. | |
4857 . | |
4858 .TP | |
4859 .B \-vf-del <index1[,index2,...]> | |
4860 Deletes the filters at the given indexes. | |
4861 Index numbers start at 0, negative numbers address the end of the | |
4862 list (-1 is the last). | |
4863 . | |
4864 .TP | |
4865 .B \-vf-clr | |
4866 Completely empties the filter list. | |
4867 .PP | |
4868 With filters that support it, you can access parameters by their name. | |
4869 . | |
4870 .TP | |
4871 .B \-vf <filter>=help | |
4872 Prints the parameter names and parameter value ranges for a particular | |
4873 filter. | |
4874 . | |
4875 .TP | |
4876 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]> | |
4877 Sets a named parameter to the given value. | |
4878 Use on and off or yes and no to set flag parameters. | |
4879 .PP | |
4880 Available filters are: | |
4881 . | |
4882 .TP | |
4883 .B crop[=w:h:x:y] | |
4884 Crops the given part of the image and discards the rest. | |
4885 Useful to remove black bands from widescreen movies. | |
4886 .PD 0 | |
4887 .RSs | |
4888 .IPs <w>,<h> | |
4889 Cropped width and height, defaults to original width and height. | |
4890 .IPs <x>,<y> | |
4891 Position of the cropped picture, defaults to center. | |
4892 .RE | |
4893 .PD 1 | |
4894 . | |
4895 .TP | |
4896 .B cropdetect[=limit:round] | |
4897 Calculates necessary cropping parameters and prints the recommended parameters | |
4898 to stdout. | |
4899 .PD 0 | |
4900 .RSs | |
4901 .IPs <limit> | |
4902 Threshold, which can be optionally specified from nothing (0) to | |
4903 everything (255) (default: 24). | |
4904 .br | |
4905 .IPs <round> | |
4906 Value which the width/\:height should be divisible by (default: 16). | |
4907 The offset is automatically adjusted to center the video. | |
4908 Use 2 to get only even dimensions (needed for 4:2:2 video). | |
4909 16 is best when encoding to most video codecs. | |
4910 .RE | |
4911 .PD 1 | |
4912 . | |
4913 .TP | |
4914 .B rectangle[=w:h:x:y] | |
4915 The plugin responds to the input.conf directive 'change_rectangle' | |
4916 that takes two parameters. | |
4917 .PD 0 | |
4918 .RSs | |
4919 .IPs <w>,<h> | |
4920 width and height (default: -1, maximum possible width where boundaries | |
4921 are still visible.) | |
4922 .IPs <x>,<y> | |
4923 top left corner position (default: -1, uppermost leftmost) | |
4924 .RE | |
4925 .PD 1 | |
4926 . | |
4927 .TP | |
4928 .B expand[=w:h:x:y:o:a:r] | |
4929 Expands (not scales) movie resolution to the given value and places the | |
4930 unscaled original at coordinates x, y. | |
4931 Can be used for placing subtitles/\:OSD in the resulting black bands. | |
4932 .RSs | |
4933 .IPs <w>,<h> | |
4934 Expanded width,height (default: original width,height). | |
4935 Negative values for w and h are treated as offsets to the original size. | |
4936 .sp 1 | |
4937 .I EXAMPLE: | |
4938 .PD 0 | |
4939 .RSs | |
4940 .IP expand=0:-50:0:0 | |
4941 Adds a 50 pixel border to the bottom of the picture. | |
4942 .RE | |
4943 .PD 1 | |
4944 .IPs <x>,<y> | |
4945 position of original image on the expanded image (default: center) | |
4946 .IPs "<o>\ \ " | |
4947 OSD/\:subtitle rendering | |
4948 .RSss | |
4949 0: disable (default) | |
4950 .br | |
4951 1: enable | |
4952 .REss | |
4953 .IPs "<a>\ \ " | |
4954 Expands to fit an aspect instead of a resolution (default: 0). | |
4955 .sp 1 | |
4956 .I EXAMPLE: | |
4957 .PD 0 | |
4958 .RSs | |
4959 .IP expand=800::::4/3 | |
4960 Expands to 800x600, unless the source is higher resolution, in which | |
4961 case it expands to fill a 4/3 aspect. | |
4962 .RE | |
4963 .PD 1 | |
4964 .IPs "<r>\ \ " | |
4965 Rounds up to make both width and height divisible by <r> (default: 1). | |
4966 .RE | |
4967 . | |
4968 .TP | |
4969 .B flip (also see \-flip) | |
4970 Flips the image upside down. | |
4971 . | |
4972 .TP | |
4973 .B "mirror\ " | |
4974 Mirrors the image on the Y axis. | |
4975 . | |
4976 .TP | |
4977 .B rotate[=<0\-7>] | |
4978 Rotates the image by 90 degrees and optionally flips it. | |
4979 For values between 4\-7 rotation is only done if the movie geometry is | |
4980 portrait and not landscape. | |
4981 .RSs | |
4982 .IPs 0 | |
4983 Rotate by 90 degrees clockwise and flip (default). | |
4984 .IPs 1 | |
4985 Rotate by 90 degrees clockwise. | |
4986 .IPs 2 | |
4987 Rotate by 90 degrees counterclockwise. | |
4988 .IPs 3 | |
4989 Rotate by 90 degrees counterclockwise and flip. | |
4990 .RE | |
4991 . | |
4992 .TP | |
4993 .B scale[=w:h[:ilaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]] | |
4994 Scales the image with the software scaler (slow) and performs a YUV<\->RGB | |
4995 colorspace conversion (also see \-sws). | |
4996 .RSs | |
4997 .IPs <w>,<h> | |
4998 scaled width/\:height (default: original width/\:height) | |
4999 .br | |
5000 .I NOTE: | |
5001 If \-zoom is used, and underlying filters (including libvo) are | |
5002 incapable of scaling, it defaults to d_width/\:d_height! | |
5003 .RSss | |
5004 0: scaled d_width/\:d_height | |
5005 .br | |
5006 -1: original width/\:height | |
5007 .br | |
5008 -2: Calculate w/h using the other dimension and the prescaled aspect ratio. | |
5009 .br | |
5010 -3: Calculate w/h using the other dimension and the original aspect ratio. | |
5011 .br | |
5012 -(n+8): Like -n above, but rounding the dimension to the closest multiple of 16. | |
5013 .REss | |
5014 .IPs <ilaced> | |
5015 Toggle interlaced scaling. | |
5016 .RSss | |
5017 0: off (default) | |
5018 .br | |
5019 1: on | |
5020 .REss | |
5021 .IPs <chr_drop> | |
5022 chroma skipping | |
5023 .RSss | |
5024 0: Use all available input lines for chroma. | |
5025 .br | |
5026 1: Use only every 2. input line for chroma. | |
5027 .br | |
5028 2: Use only every 4. input line for chroma. | |
5029 .br | |
5030 3: Use only every 8. input line for chroma. | |
5031 .REss | |
5032 .IPs "<par>[:<par2>] (also see \-sws)" | |
5033 Set some scaling parameters depending on the type of scaler selected | |
5034 with \-sws. | |
5035 .RSss | |
5036 \-sws 2 (bicubic): B (blurring) and C (ringing) | |
5037 .br | |
5038 0.00:0.60 default | |
5039 .br | |
5040 0.00:0.75 VirtualDub's "precise bicubic" | |
5041 .br | |
5042 0.00:0.50 Catmull-Rom spline | |
5043 .br | |
5044 0.33:0.33 Mitchell-Netravali spline | |
5045 .br | |
5046 1.00:0.00 cubic B-spline | |
5047 .br | |
5048 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp)) | |
5049 .br | |
5050 \-sws 9 (lanczos): filter length (1\-10) | |
5051 .REss | |
5052 .IPs <presize> | |
5053 Scale to preset sizes. | |
5054 .RSss | |
5055 qntsc: 352x240 (NTSC quarter screen) | |
5056 .br | |
5057 qpal: 352x288 (PAL quarter screen) | |
5058 .br | |
5059 ntsc: 720x480 (standard NTSC) | |
5060 .br | |
5061 pal: 720x576 (standard PAL) | |
5062 .br | |
5063 sntsc: 640x480 (square pixel NTSC) | |
5064 .br | |
5065 spal: 768x576 (square pixel PAL) | |
5066 .REss | |
5067 .IPs <noup> | |
5068 Disallow upscaling past the original dimensions. | |
5069 .RSss | |
5070 0: Allow upscaling (default). | |
5071 .br | |
5072 1: Disallow upscaling if one dimension exceeds its original value. | |
5073 .br | |
5074 2: Disallow upscaling if both dimensions exceed their original values. | |
5075 .REss | |
5076 .IPs <arnd> | |
5077 Accurate rounding for the vertical scaler, which may be faster | |
5078 or slower than the default rounding. | |
5079 .RSss | |
5080 0: Disable accurate rounding (default). | |
5081 .br | |
5082 1: Enable accurate rounding. | |
5083 .REss | |
5084 .RE | |
5085 . | |
5086 .TP | |
5087 .B dsize[=aspect|w:h:aspect-method:r] | |
5088 Changes the intended display size/\:aspect at an arbitrary point in the | |
5089 filter chain. | |
5090 Aspect can be given as a fraction (4/3) or floating point number | |
5091 (1.33). | |
5092 Alternatively, you may specify the exact display width and height | |
5093 desired. | |
5094 Note that this filter does | |
5095 .B not | |
5096 do any scaling itself; it just affects | |
5097 what later scalers (software or hardware) will do when auto-scaling to | |
5098 correct aspect. | |
5099 .RSs | |
5100 .IPs <w>,<h> | |
5101 New display width and height. | |
5102 Can also be these special values: | |
5103 .RSss | |
5104 0: original display width and height | |
5105 .br | |
5106 -1: original video width and height (default) | |
5107 .br | |
5108 -2: Calculate w/h using the other dimension and the original display | |
5109 aspect ratio. | |
5110 .br | |
5111 -3: Calculate w/h using the other dimension and the original video | |
5112 aspect ratio. | |
5113 .REss | |
5114 .sp 1 | |
5115 .I EXAMPLE: | |
5116 .PD 0 | |
5117 .RSs | |
5118 .IP dsize=800:-2 | |
5119 Specifies a display resolution of 800x600 for a 4/3 aspect video, or | |
5120 800x450 for a 16/9 aspect video. | |
5121 .RE | |
5122 .IPs <aspect-method> | |
5123 Modifies width and height according to original aspect ratios. | |
5124 .RSss | |
5125 -1: Ignore original aspect ratio (default). | |
5126 .br | |
5127 0: Keep display aspect ratio by using <w> and <h> as maximum | |
5128 resolution. | |
5129 .br | |
5130 1: Keep display aspect ratio by using <w> and <h> as minimum | |
5131 resolution. | |
5132 .br | |
5133 2: Keep video aspect ratio by using <w> and <h> as maximum | |
5134 resolution. | |
5135 .br | |
5136 3: Keep video aspect ratio by using <w> and <h> as minimum | |
5137 resolution. | |
5138 .REss | |
5139 .sp 1 | |
5140 .I EXAMPLE: | |
5141 .PD 0 | |
5142 .RSs | |
5143 .IP dsize=800:600:0 | |
5144 Specifies a display resolution of at most 800x600, or smaller, in order | |
5145 to keep aspect. | |
5146 .RE | |
5147 .PD 1 | |
5148 .IPs "<r>\ \ " | |
5149 Rounds up to make both width and height divisible by <r> (default: 1). | |
5150 .RE | |
5151 . | |
5152 .TP | |
5153 .B "yuy2\ \ \ " | |
5154 Forces software YV12/\:I420/\:422P to YUY2 conversion. | |
5155 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support. | |
5156 . | |
5157 .TP | |
5158 .B "yvu9\ \ \ " | |
5159 Forces software YVU9 to YV12 colorspace conversion. | |
5160 Deprecated in favor of the software scaler. | |
5161 . | |
5162 .TP | |
5163 .B "yuvcsp\ " | |
5164 Clamps YUV color values to the CCIR 601 range without doing real conversion. | |
5165 . | |
5166 .TP | |
5167 .B rgb2bgr[=swap] | |
5168 RGB 24/32 <\-> BGR 24/32 colorspace conversion. | |
5169 .PD 0 | |
5170 .RSs | |
5171 .IPs "swap\ " | |
5172 Also perform R <-> B swapping. | |
5173 .RE | |
5174 .PD 1 | |
5175 . | |
5176 .TP | |
5177 .B palette | |
5178 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette. | |
5179 . | |
5180 .TP | |
5181 .B format[=fourcc] | |
5182 Restricts the colorspace for the next filter without doing any conversion. | |
5183 Use together with the scale filter for a real conversion. | |
5184 .br | |
5185 .I NOTE: | |
5186 For a list of available formats see format=fmt=help. | |
5187 .PD 0 | |
5188 .RSs | |
5189 .IPs <fourcc> | |
5190 format name like rgb15, bgr24, yv12, etc (default: yuy2) | |
5191 .RE | |
5192 .PD 1 | |
5193 . | |
5194 .TP | |
5195 .B noformat[=fourcc] | |
5196 Restricts the colorspace for the next filter without doing any conversion. | |
5197 Unlike the format filter, this will allow any colorspace | |
5198 .B except | |
5199 the one you specify. | |
5200 .br | |
5201 .I NOTE: | |
5202 For a list of available formats see noformat=fmt=help. | |
5203 .PD 0 | |
5204 .RSs | |
5205 .IPs <fourcc> | |
5206 format name like rgb15, bgr24, yv12, etc (default: yv12) | |
5207 .RE | |
5208 .PD 1 | |
5209 . | |
5210 .TP | |
5211 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (also see \-pphelp) | |
5212 Enables the specified chain of postprocessing subfilters. | |
5213 Subfilters must be separated by '/' and can be disabled by | |
5214 prepending a '\-'. | |
5215 Each subfilter and some options have a short and a long name that can be | |
5216 used interchangeably, i.e.\& dr/dering are the same. | |
5217 All subfilters share common options to determine their scope: | |
5218 .PD 0 | |
5219 .RSs | |
5220 .IPs a/autoq | |
5221 Automatically switch the subfilter off if the CPU is too slow. | |
5222 .IPs c/chrom | |
5223 Do chrominance filtering, too (default). | |
5224 .IPs y/nochrom | |
5225 Do luminance filtering only (no chrominance). | |
5226 .IPs n/noluma | |
5227 Do chrominance filtering only (no luminance). | |
5228 .RE | |
5229 .PD 1 | |
5230 .sp 1 | |
5231 .RS | |
5232 .br | |
5233 .I NOTE: | |
5234 \-pphelp shows a list of available subfilters. | |
5235 .sp 1 | |
5236 Available subfilters are | |
5237 .RE | |
5238 .RSs | |
5239 .IPs hb/hdeblock[:difference[:flatness]] | |
5240 horizontal deblocking filter | |
5241 .RSss | |
5242 <difference>: Difference factor where higher values mean | |
5243 more deblocking (default: 32). | |
5244 .br | |
5245 <flatness>: Flatness threshold where lower values mean | |
5246 more deblocking (default: 39). | |
5247 .REss | |
5248 .IPs vb/vdeblock[:difference[:flatness]] | |
5249 vertical deblocking filter | |
5250 .RSss | |
5251 <difference>: Difference factor where higher values mean | |
5252 more deblocking (default: 32). | |
5253 .br | |
5254 <flatness>: Flatness threshold where lower values mean | |
5255 more deblocking (default: 39). | |
5256 .REss | |
5257 .IPs ha/hadeblock[:difference[:flatness]] | |
5258 accurate horizontal deblocking filter | |
5259 .RSss | |
5260 <difference>: Difference factor where higher values mean | |
5261 more deblocking (default: 32). | |
5262 .br | |
5263 <flatness>: Flatness threshold where lower values mean | |
5264 more deblocking (default: 39). | |
5265 .REss | |
5266 .IPs va/vadeblock[:difference[:flatness]] | |
5267 accurate vertical deblocking filter | |
5268 .RSss | |
5269 <difference>: Difference factor where higher values mean | |
5270 more deblocking (default: 32). | |
5271 .br | |
5272 <flatness>: Flatness threshold where lower values mean | |
5273 more deblocking (default: 39). | |
5274 .REss | |
5275 .sp 1 | |
5276 The horizontal and vertical deblocking filters share the | |
5277 difference and flatness values so you cannot set | |
5278 different horizontal and vertical thresholds. | |
5279 .sp 1 | |
5280 .IPs h1/x1hdeblock | |
5281 experimental horizontal deblocking filter | |
5282 .IPs v1/x1vdeblock | |
5283 experimental vertical deblocking filter | |
5284 .IPs dr/dering | |
5285 deringing filter | |
5286 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]] | |
5287 temporal noise reducer | |
5288 .RSss | |
5289 <threshold1>: larger -> stronger filtering | |
5290 .br | |
5291 <threshold2>: larger -> stronger filtering | |
5292 .br | |
5293 <threshold3>: larger -> stronger filtering | |
5294 .REss | |
5295 .IPs al/autolevels[:f/fullyrange] | |
5296 automatic brightness / contrast correction | |
5297 .RSss | |
5298 f/fullyrange: Stretch luminance to (0\-255). | |
5299 .REss | |
5300 .IPs lb/linblenddeint | |
5301 Linear blend deinterlacing filter that deinterlaces the given block | |
5302 by filtering all lines with a (1 2 1) filter. | |
5303 .IPs li/linipoldeint | |
5304 Linear interpolating deinterlacing filter that deinterlaces the given block | |
5305 by linearly interpolating every second line. | |
5306 .IPs ci/cubicipoldeint | |
5307 Cubic interpolating deinterlacing filter deinterlaces the given block | |
5308 by cubically interpolating every second line. | |
5309 .IPs md/mediandeint | |
5310 Median deinterlacing filter that deinterlaces the given block | |
5311 by applying a median filter to every second line. | |
5312 .IPs fd/ffmpegdeint | |
5313 FFmpeg deinterlacing filter that deinterlaces the given block | |
5314 by filtering every second line with a (-1 4 2 4 -1) filter. | |
5315 .IPs l5/lowpass5 | |
5316 Vertically applied FIR lowpass deinterlacing filter that deinterlaces | |
5317 the given block by filtering all lines with a (-1 2 6 2 -1) filter. | |
5318 .IPs fq/forceQuant[:quantizer] | |
5319 Overrides the quantizer table from the input with the constant | |
5320 quantizer you specify. | |
5321 .RSss | |
5322 <quantizer>: quantizer to use | |
5323 .REss | |
5324 .IPs de/default | |
5325 default pp filter combination (hb:a,vb:a,dr:a) | |
5326 .IPs fa/fast | |
5327 fast pp filter combination (h1:a,v1:a,dr:a) | |
5328 .IPs "ac\ \ \ " | |
5329 high quality pp filter combination (ha:a:128:7,va:a,dr:a) | |
5330 .RE | |
5331 .RS | |
5332 .sp 1 | |
5333 .I EXAMPLE: | |
5334 .RE | |
5335 .PD 0 | |
5336 .RSs | |
5337 .IPs "\-vf pp=hb/vb/dr/al" | |
5338 horizontal and vertical deblocking, deringing and automatic | |
5339 brightness/\:contrast | |
5340 .IPs "\-vf pp=de/-al" | |
5341 default filters without brightness/\:contrast correction | |
5342 .IPs "\-vf pp=default/tmpnoise:1:2:3" | |
5343 Enable default filters & temporal denoiser. | |
5344 .IPs "\-vf pp=hb:y/vb:a" | |
5345 Horizontal deblocking on luminance only, and switch vertical deblocking | |
5346 on or off automatically depending on available CPU time. | |
5347 .RE | |
5348 .PD 1 | |
5349 . | |
5350 .TP | |
5351 .B spp[=quality[:qp[:mode]]] | |
5352 Simple postprocessing filter that compresses and decompresses the | |
5353 image at several (or \- in the case of quality level 6 \- all) | |
5354 shifts and averages the results. | |
5355 .RSs | |
5356 .IPs <quality> | |
5357 0\-6 (default: 3) | |
5358 .IPs "<qp>\ " | |
5359 Force quantization parameter (default: 0, use QP from video). | |
5360 .IPs <mode> | |
5361 0: hard thresholding (default) | |
5362 .br | |
5363 1: soft thresholding (better deringing, but blurrier) | |
5364 .br | |
5365 4: like 0, but also use B-frames' QP (may cause flicker) | |
5366 .br | |
5367 5: like 1, but also use B-frames' QP (may cause flicker) | |
5368 .RE | |
5369 . | |
5370 .TP | |
5371 .B uspp[=quality[:qp]] | |
5372 Ultra simple & slow postprocessing filter that compresses and | |
5373 decompresses the image at several (or \- in the case of quality | |
5374 level 8 \- all) shifts and averages the results. | |
5375 The way this differs from the behavior of spp is that uspp actually | |
5376 encodes & decodes each case with libavcodec Snow, whereas spp uses | |
5377 a simplified intra only 8x8 DCT similar to MJPEG. | |
5378 .RSs | |
5379 .IPs <quality> | |
5380 0\-8 (default: 3) | |
5381 .IPs "<qp>\ " | |
5382 Force quantization parameter (default: 0, use QP from video). | |
5383 .RE | |
5384 . | |
5385 .TP | |
5386 .B fspp[=quality[:qp[:strength[:bframes]]]] | |
5387 faster version of the simple postprocessing filter | |
5388 .RSs | |
5389 .IPs <quality> | |
5390 4\-5 (equivalent to spp; default: 4) | |
5391 .IPs "<qp>\ " | |
5392 Force quantization parameter (default: 0, use QP from video). | |
5393 .IPs <-15\-32> | |
5394 Filter strength, lower values mean more details but also more artifacts, | |
5395 while higher values make the image smoother but also blurrier (default: | |
5396 0 \- PSNR optimal). | |
5397 .IPs <bframes> | |
5398 0: do not use QP from B-frames (default) | |
5399 .br | |
5400 1: use QP from B-frames too (may cause flicker) | |
5401 .RE | |
5402 . | |
5403 .TP | |
5404 .B pp7[=qp[:mode]] | |
5405 Variant of the spp filter, similar to spp=6 with 7 point DCT where | |
5406 only the center sample is used after IDCT. | |
5407 .RSs | |
5408 .IPs <qp> | |
5409 Force quantization parameter (default: 0, use QP from video). | |
5410 .IPs <mode> | |
5411 0: hard thresholding | |
5412 .br | |
5413 1: soft thresholding (better deringing, but blurrier) | |
5414 .br | |
5415 2: medium thresholding (default, good results) | |
5416 .RE | |
5417 . | |
5418 .TP | |
5419 .B qp=equation | |
5420 quantization parameter (QP) change filter | |
5421 .RSs | |
5422 .IPs <equation> | |
5423 some equation like "2+2*sin(PI*qp)" | |
5424 .RE | |
5425 . | |
5426 .TP | |
5427 .B "test\ \ \ " | |
5428 Generate various test patterns. | |
5429 . | |
5430 .TP | |
5431 .B rgbtest | |
5432 Generate an RGB test pattern useful for detecting RGB vs BGR issues. | |
5433 You should see a red, green and blue stripe from top to bottom. | |
5434 . | |
5435 .TP | |
5436 .B lavc[=quality:fps] | |
5437 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV. | |
5438 Faster and of better quality than \-vf fame. | |
5439 .RSs | |
5440 .IPs <quality> | |
5441 .RSss | |
5442 1\-31: fixed qscale | |
5443 .br | |
5444 32\-: fixed bitrate in kbits | |
5445 .REss | |
5446 .IPs <fps> | |
5447 force output fps (float value) (default: 0, autodetect based on height) | |
5448 .RE | |
5449 . | |
5450 .TP | |
5451 .B "fame\ \ \ " | |
5452 Fast software YV12 to MPEG-1 conversion with libfame for use with DVB/\:DXR3/\:IVTV. | |
5453 . | |
5454 .TP | |
5455 .B dvbscale[=aspect] | |
5456 Set up optimal scaling for DVB cards, scaling the x axis in hardware and | |
5457 calculating the y axis scaling in software to keep aspect. | |
5458 Only useful together with expand and scale. | |
5459 .RSs | |
5460 .IPs <aspect> | |
5461 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default: | |
5462 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV. | |
5463 .RE | |
5464 .sp 1 | |
5465 .RS | |
5466 .I EXAMPLE: | |
5467 .RE | |
5468 .PD 0 | |
5469 .RSs | |
5470 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc" | |
5471 FIXME: Explain what this does. | |
5472 .RE | |
5473 .PD 1 | |
5474 . | |
5475 .TP | |
5476 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]] | |
5477 Adds noise. | |
5478 .PD 0 | |
5479 .RSs | |
5480 .IPs <0\-100> | |
5481 luma noise | |
5482 .IPs <0\-100> | |
5483 chroma noise | |
5484 .IPs u | |
5485 uniform noise (gaussian otherwise) | |
5486 .IPs t | |
5487 temporal noise (noise pattern changes between frames) | |
5488 .IPs a | |
5489 averaged temporal noise (smoother, but a lot slower) | |
5490 .IPs h | |
5491 high quality (slightly better looking, slightly slower) | |
5492 .IPs p | |
5493 mix random noise with a (semi)regular pattern | |
5494 .RE | |
5495 .PD 1 | |
5496 . | |
5497 .TP | |
5498 .B denoise3d[=luma:chroma:time] | |
5499 This filter aims to reduce image noise producing smooth images and making still | |
5500 images really still (This should enhance compressibility.). | |
5501 .PD 0 | |
5502 .RSs | |
5503 .IPs <luma> | |
5504 spatial luma strength (default: 4) | |
5505 .IPs <chroma> | |
5506 spatial chroma strength (default: 3) | |
5507 .IPs <time> | |
5508 temporal strength (default: 6) | |
5509 .RE | |
5510 .PD 1 | |
5511 . | |
5512 .TP | |
5513 .B hqdn3d[=luma:chroma:time] | |
5514 High precision/\:quality version of the denoise3d filter. | |
5515 Parameters and usage are the same. | |
5516 . | |
5517 .TP | |
5518 .B eq[=brightness:contrast] (OBSOLETE) | |
5519 Software equalizer with interactive controls just like the hardware | |
5520 equalizer, for cards/\:drivers that do not support brightness and | |
5521 contrast controls in hardware. | |
5522 Might also be useful with MEncoder, either for fixing poorly captured | |
5523 movies, or for slightly reducing contrast to mask artifacts and get by | |
5524 with lower bitrates. | |
5525 .PD 0 | |
5526 .RSs | |
5527 .IPs <-100\-100> | |
5528 initial brightness | |
5529 .IPs <-100\-100> | |
5530 initial contrast | |
5531 .RE | |
5532 .PD 1 | |
5533 . | |
5534 .TP | |
5535 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight] | |
5536 Alternative software equalizer that uses lookup tables (very slow), | |
5537 allowing gamma correction in addition to simple brightness | |
5538 and contrast adjustment. | |
5539 Note that it uses the same MMX optimized code as \-vf eq if all | |
5540 gamma values are 1.0. | |
5541 The parameters are given as floating point values. | |
5542 .PD 0 | |
5543 .RSs | |
5544 .IPs <0.1\-10> | |
5545 initial gamma value (default: 1.0) | |
5546 .IPs <-2\-2> | |
5547 initial contrast, where negative values result in a | |
5548 negative image (default: 1.0) | |
5549 .IPs <-1\-1> | |
5550 initial brightness (default: 0.0) | |
5551 .IPs <0\-3> | |
5552 initial saturation (default: 1.0) | |
5553 .IPs <0.1\-10> | |
5554 gamma value for the red component (default: 1.0) | |
5555 .IPs <0.1\-10> | |
5556 gamma value for the green component (default: 1.0) | |
5557 .IPs <0.1\-10> | |
5558 gamma value for the blue component (default: 1.0) | |
5559 .IPs <0\-1> | |
5560 The weight parameter can be used to reduce the effect of a high gamma value on | |
5561 bright image areas, e.g.\& keep them from getting overamplified and just plain | |
5562 white. | |
5563 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it | |
5564 at its full strength (default: 1.0). | |
5565 .RE | |
5566 .PD 1 | |
5567 . | |
5568 .TP | |
5569 .B hue[=hue:saturation] | |
5570 Software equalizer with interactive controls just like the hardware | |
5571 equalizer, for cards/\:drivers that do not support hue and | |
5572 saturation controls in hardware. | |
5573 .PD 0 | |
5574 .RSs | |
5575 .IPs <-180\-180> | |
5576 initial hue (default: 0.0) | |
5577 .IPs <-100\-100> | |
5578 initial saturation, where negative values result | |
5579 in a negative chroma (default: 1.0) | |
5580 .RE | |
5581 .PD 1 | |
5582 . | |
5583 .TP | |
5584 .B halfpack[=f] | |
5585 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but | |
5586 keeping all chroma samples. | |
5587 Useful for output to low-resolution display devices when hardware downscaling | |
5588 is poor quality or is not available. | |
5589 Can also be used as a primitive luma-only deinterlacer with very low CPU | |
5590 usage. | |
5591 .PD 0 | |
5592 .RSs | |
5593 .IPs "<f>\ \ " | |
5594 By default, halfpack averages pairs of lines when downsampling. | |
5595 Any value different from 0 or 1 gives the default (averaging) behavior. | |
5596 .RSss | |
5597 0: Only use even lines when downsampling. | |
5598 .br | |
5599 1: Only use odd lines when downsampling. | |
5600 .REss | |
5601 .RE | |
5602 .PD 1 | |
5603 . | |
5604 .TP | |
5605 .B ilpack[=mode] | |
5606 When interlaced video is stored in YUV 4:2:0 formats, chroma | |
5607 interlacing does not line up properly due to vertical downsampling of | |
5608 the chroma channels. | |
5609 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with | |
5610 the chroma lines in their proper locations, so that in any given | |
5611 scanline, the luma and chroma data both come from the same field. | |
5612 .PD 0 | |
5613 .RSs | |
5614 .IPs <mode> | |
5615 Select the sampling mode. | |
5616 .RSss | |
5617 0: nearest-neighbor sampling, fast but incorrect | |
5618 .br | |
5619 1: linear interpolation (default) | |
5620 .REss | |
5621 .RE | |
5622 .PD 1 | |
5623 . | |
5624 .TP | |
5625 .B harddup | |
5626 Only useful with MEncoder. | |
5627 If harddup is used when encoding, it will force duplicate frames to be | |
5628 encoded in the output. | |
5629 This uses slightly more space, but is necessary for output to MPEG | |
5630 files or if you plan to demux and remux the video stream after | |
5631 encoding. | |
5632 Should be placed at or near the end of the filter chain unless you | |
5633 have a good reason to do otherwise. | |
5634 . | |
5635 .TP | |
5636 .B softskip | |
5637 Only useful with MEncoder. | |
5638 Softskip moves the frame skipping (dropping) step of encoding from | |
5639 before the filter chain to some point during the filter chain. | |
5640 This allows filters which need to see all frames (inverse telecine, | |
5641 temporal denoising, etc.) to function properly. | |
5642 Should be placed after the filters which need to see all frames and | |
5643 before any subsequent filters that are CPU-intensive. | |
5644 . | |
5645 .TP | |
5646 .B decimate[=max:hi:lo:frac] | |
5647 Drops frames that do not differ greatly from the previous frame in | |
5648 order to reduce framerate. | |
5649 The main use of this filter is for very-low-bitrate encoding (e.g.\& | |
5650 streaming over dialup modem), but it could in theory be used for | |
5651 fixing movies that were inverse-telecined incorrectly. | |
5652 .PD 0 | |
5653 .RSs | |
5654 .IPs <max> | |
5655 Sets the maximum number of consecutive frames which can be | |
5656 dropped (if positive), or the minimum interval between | |
5657 dropped frames (if negative). | |
5658 .IPs <hi>,<lo>,<frac> | |
5659 A frame is a candidate for dropping if no 8x8 region differs by more | |
5660 than a threshold of <hi>, and if not more than <frac> portion (1 | |
5661 meaning the whole image) differs by more than a threshold of <lo>. | |
5662 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual | |
5663 pixel value differences, so a threshold of 64 corresponds to 1 unit of | |
5664 difference for each pixel, or the same spread out differently over the | |
5665 block. | |
5666 .RE | |
5667 .PD 1 | |
5668 . | |
5669 .TP | |
5670 .B dint[=sense:level] | |
5671 The drop-deinterlace (dint) filter detects and drops the first from a set | |
5672 of interlaced video frames. | |
5673 .PD 0 | |
5674 .RSs | |
5675 .IPs <0.0\-1.0> | |
5676 relative difference between neighboring pixels (default: 0.1) | |
5677 .IPs <0.0\-1.0> | |
5678 What part of the image has to be detected as interlaced to | |
5679 drop the frame (default: 0.15). | |
5680 .RE | |
5681 .PD 1 | |
5682 . | |
5683 .TP | |
5684 .B lavcdeint (OBSOLETE) | |
5685 FFmpeg deinterlacing filter, same as \-vf pp=fd | |
5686 . | |
5687 .TP | |
5688 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]] | |
5689 Donald Graft's adaptive kernel deinterlacer. | |
5690 Deinterlaces parts of a video if a configurable threshold is exceeded. | |
5691 .PD 0 | |
5692 .RSs | |
5693 .IPs <0\-255> | |
5694 threshold (default: 10) | |
5695 .IPs <map> | |
5696 .RSss | |
5697 0: Ignore pixels exceeding the threshold (default). | |
5698 .br | |
5699 1: Paint pixels exceeding the threshold white. | |
5700 .REss | |
5701 .IPs <order> | |
5702 .RSss | |
5703 0: Leave fields alone (default). | |
5704 .br | |
5705 1: Swap fields. | |
5706 .REss | |
5707 .IPs <sharp> | |
5708 .RSss | |
5709 0: Disable additional sharpening (default). | |
5710 .br | |
5711 1: Enable additional sharpening. | |
5712 .REss | |
5713 .IPs <twoway> | |
5714 .RSss | |
5715 0: Disable twoway sharpening (default). | |
5716 .br | |
5717 1: Enable twoway sharpening. | |
5718 .REss | |
5719 .RE | |
5720 .PD 1 | |
5721 . | |
5722 .TP | |
5723 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]] | |
5724 unsharp mask / gaussian blur | |
5725 .RSs | |
5726 .IPs "l\ \ \ \ " | |
5727 Apply effect on luma component. | |
5728 .IPs "c\ \ \ \ " | |
5729 Apply effect on chroma components. | |
5730 .IPs <width>x<height> | |
5731 width and height of the matrix, odd sized in both directions | |
5732 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7) | |
5733 .IPs amount | |
5734 Relative amount of sharpness/\:blur to add to the image | |
5735 (a sane range should be -1.5\-1.5). | |
5736 .RSss | |
5737 <0: blur | |
5738 .br | |
5739 >0: sharpen | |
5740 .REss | |
5741 .RE | |
5742 . | |
5743 .TP | |
5744 .B "swapuv\ " | |
5745 Swap U & V plane. | |
5746 . | |
5747 .TP | |
5748 .B il[=d|i][s][:[d|i][s]] | |
5749 (De)interleaves lines. | |
5750 The goal of this filter is to add the ability to process interlaced images | |
5751 pre-field without deinterlacing them. | |
5752 You can filter your interlaced DVD and play it on a TV without breaking the | |
5753 interlacing. | |
5754 While deinterlacing (with the postprocessing filter) removes interlacing | |
5755 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into | |
5756 2 fields (so called half pictures), so you can process (filter) them | |
5757 independently and then re-interleave them. | |
5758 .PD 0 | |
5759 .RSs | |
5760 .IPs d | |
5761 deinterleave (placing one above the other) | |
5762 .IPs i | |
5763 interleave | |
5764 .IPs s | |
5765 swap fields (exchange even & odd lines) | |
5766 .RE | |
5767 .PD 1 | |
5768 . | |
5769 .TP | |
5770 .B fil[=i|d] | |
5771 (De)interleaves lines. | |
5772 This filter is very similar to the il filter but much faster, the main | |
5773 disadvantage is that it does not always work. | |
5774 Especially if combined with other filters it may produce randomly messed | |
5775 up images, so be happy if it works but do not complain if it does not for | |
5776 your combination of filters. | |
5777 .PD 0 | |
5778 .RSs | |
5779 .IPs d | |
5780 Deinterleave fields, placing them side by side. | |
5781 .IPs i | |
5782 Interleave fields again (reversing the effect of fil=d). | |
5783 .RE | |
5784 .PD 1 | |
5785 . | |
5786 .TP | |
5787 .B field[=n] | |
5788 Extracts a single field from an interlaced image using stride arithmetic | |
5789 to avoid wasting CPU time. | |
5790 The optional argument n specifies whether to extract the even or the odd | |
5791 field (depending on whether n is even or odd). | |
5792 . | |
5793 .TP | |
5794 .B detc[=var1=value1:var2=value2:...] | |
5795 Attempts to reverse the 'telecine' process to recover a clean, | |
5796 non-interlaced stream at film framerate. | |
5797 This was the first and most primitive inverse telecine filter to be | |
5798 added to MPlayer/\:MEncoder. | |
5799 It works by latching onto the telecine 3:2 pattern and following it as | |
5800 long as possible. | |
5801 This makes it suitable for perfectly-telecined material, even in the | |
5802 presence of a fair degree of noise, but it will fail in the presence | |
5803 of complex post-telecine edits. | |
5804 Development on this filter is no longer taking place, as ivtc, pullup, | |
5805 and filmdint are better for most applications. | |
5806 The following arguments (see syntax above) may be used to control | |
5807 detc's behavior: | |
5808 .RSs | |
5809 .IPs "<dr>\ " | |
5810 Set the frame dropping mode. | |
5811 .RSss | |
5812 0: Do not drop frames to maintain fixed output framerate (default). | |
5813 .br | |
5814 1: Always drop a frame when there have been no drops or telecine | |
5815 merges in the past 5 frames. | |
5816 .br | |
5817 2: Always maintain exact 5:4 input to output frame ratio. | |
5818 .br | |
5819 .I NOTE: | |
5820 Use mode 1 or 2 with MEncoder. | |
5821 .REss | |
5822 .IPs "<am>\ " | |
5823 Analysis mode. | |
5824 .RSss | |
5825 0: Fixed pattern with initial frame number specified by <fr>. | |
5826 .br | |
5827 1: aggressive search for telecine pattern (default) | |
5828 .REss | |
5829 .IPs "<fr>\ " | |
5830 Set initial frame number in sequence. | |
5831 0\-2 are the three clean progressive frames; 3 and 4 are the two | |
5832 interlaced frames. | |
5833 The default, -1, means 'not in telecine sequence'. | |
5834 The number specified here is the type for the imaginary previous | |
5835 frame before the movie starts. | |
5836 .IPs "<t0>, <t1>, <t2>, <t3>" | |
5837 Threshold values to be used in certain modes. | |
5838 .RE | |
5839 . | |
5840 .TP | |
5841 .B ivtc[=1] | |
5842 Experimental 'stateless' inverse telecine filter. | |
5843 Rather than trying to lock on to a pattern like the detc filter does, | |
5844 ivtc makes its decisions independently for each frame. | |
5845 This will give much better results for material that has undergone | |
5846 heavy editing after telecine was applied, but as a result it is not as | |
5847 forgiving of noisy input, for example TV capture. | |
5848 The optional parameter (ivtc=1) corresponds to the dr=1 option for the | |
5849 detc filter, and should be used with MEncoder but not with MPlayer. | |
5850 As with detc, you must specify the correct output framerate (\-ofps | |
5851 24000/1001) when using MEncoder. | |
5852 Further development on ivtc has stopped, as the pullup and filmdint | |
5853 filters appear to be much more accurate. | |
5854 . | |
5855 .TP | |
5856 .B pullup[=jl:jr:jt:jb:sb:mp] | |
5857 Third-generation pulldown reversal (inverse telecine) filter, | |
5858 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001 | |
5859 fps progressive content. | |
5860 The pullup filter is designed to be much more robust than detc or | |
5861 ivtc, by taking advantage of future context in making its decisions. | |
5862 Like ivtc, pullup is stateless in the sense that it does not lock onto | |
5863 a pattern to follow, but it instead looks forward to the following | |
5864 fields in order to identify matches and rebuild progressive frames. | |
5865 It is still under development, but believed to be quite accurate. | |
5866 The jl, jr, jt, and jb options set the amount of "junk" to ignore at | |
5867 the left, right, top, and bottom of the image, respectively. | |
5868 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of | |
5869 2 lines. | |
5870 The default is 8 pixels on each side. | |
5871 Setting the sb (strict breaks) option to 1 will reduce the chances of | |
5872 pullup generating an occasional mismatched frame, but it may also | |
5873 cause an excessive number of frames to be dropped during high motion | |
5874 sequences. | |
5875 Conversely, setting it to -1 will make pullup match fields more | |
5876 easily. | |
5877 This may help processing of video where there is slight blurring | |
5878 between the fields, but may also cause there to be interlaced frames | |
5879 in the output. | |
5880 The mp (metric plane) option may be set to 1 or 2 to use a chroma | |
5881 plane instead of the luma plane for doing pullup's computations. | |
5882 This may improve accuracy on very clean source material, but more | |
5883 likely will decrease accuracy, especially if there is chroma noise | |
5884 (rainbow effect) or any grayscale video. | |
5885 The main purpose of setting mp to a chroma plane is to reduce CPU load | |
5886 and make pullup usable in realtime on slow machines. | |
5887 .br | |
5888 .I NOTE: | |
5889 Always follow pullup with the softskip filter when encoding to ensure | |
5890 that pullup is able to see each frame. | |
5891 Failure to do so will lead to incorrect output and will usually crash, | |
5892 due to design limitations in the codec/\:filter layer. | |
5893 . | |
5894 .TP | |
5895 .B filmdint[=options] | |
5896 Inverse telecine filter, similar to the pullup filter above. | |
5897 It is designed to handle any pulldown pattern, including mixed soft and | |
5898 hard telecine and limited support for movies that are slowed down or sped | |
5899 up from their original framerate for TV. | |
5900 Only the luma plane is used to find the frame breaks. | |
5901 If a field has no match, it is deinterlaced with simple linear | |
5902 approximation. | |
5903 If the source is MPEG-2, this must be the first filter to allow | |
5904 access to the field-flags set by the MPEG-2 decoder. | |
5905 Depending on the source MPEG, you may be fine ignoring this advice, as | |
5906 long as you do not see lots of "Bottom-first field" warnings. | |
5907 With no options it does normal inverse telecine, and should be used | |
5908 together with mencoder \-fps 30000/1001 \-ofps 24000/1001. | |
5909 When this filter is used with mplayer, it will result in an uneven | |
5910 framerate during playback, but it is still generally better than using | |
5911 pp=lb or no deinterlacing at all. | |
5912 Multiple options can be specified separated by /. | |
5913 .RSs | |
5914 .IPs crop=<w>:<h>:<x>:<y> | |
5915 Just like the crop filter, but faster, and works on mixed hard and soft | |
5916 telecined content as well as when y is not a multiple of 4. | |
5917 If x or y would require cropping fractional pixels from the chroma | |
5918 planes, the crop area is extended. | |
5919 This usually means that x and y must be even. | |
5920 .IPs io=<ifps>:<ofps> | |
5921 For each ifps input frames the filter will output ofps frames. | |
5922 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio. | |
5923 This could be used to filter movies that are broadcast on TV at a frame | |
5924 rate different from their original framerate. | |
5925 .IPs luma_only=<n> | |
5926 If n is nonzero, the chroma plane is copied unchanged. | |
5927 This is useful for YV12 sampled TV, which discards one of the chroma | |
5928 fields. | |
5929 .IPs mmx2=<n> | |
5930 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow! | |
5931 optimized functions, otherwise, use plain C. | |
5932 If this option is not specified, MMX2 and 3DNow! are auto-detected, use | |
5933 this option to override auto-detection. | |
5934 .IPs fast=<n> | |
5935 The larger n will speed up the filter at the expense of accuracy. | |
5936 The default value is n=3. | |
5937 If n is odd, a frame immediately following a frame marked with the | |
5938 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter | |
5939 will not spend any time on soft-telecined MPEG-2 content. | |
5940 This is the only effect of this flag if MMX2 or 3DNow! is available. | |
5941 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used | |
5942 as with n=2 or 3. | |
5943 If n=2 or 3, the number of luma levels used to find the frame breaks is | |
5944 reduced from 256 to 128, which results in a faster filter without losing | |
5945 much accuracy. | |
5946 If n=4 or 5, a faster, but much less accurate metric will be used to | |
5947 find the frame breaks, which is more likely to misdetect high vertical | |
5948 detail as interlaced content. | |
5949 .IPs verbose=<n> | |
5950 If n is nonzero, print the detailed metrics for each frame. | |
5951 Useful for debugging. | |
5952 .IPs dint_thres=<n> | |
5953 Deinterlace threshold. | |
5954 Used during de-interlacing of unmatched frames. | |
5955 Larger value means less deinterlacing, use n=256 to completely turn off | |
5956 deinterlacing. | |
5957 Default is n=8. | |
5958 .IPs comb_thres=<n> | |
5959 Threshold for comparing a top and bottom fields. | |
5960 Defaults to 128. | |
5961 .IPs diff_thres=<n> | |
5962 Threshold to detect temporal change of a field. | |
5963 Default is 128. | |
5964 .IPs sad_thres=<n> | |
5965 Sum of Absolute Difference threshold, default is 64. | |
5966 .RE | |
5967 . | |
5968 .TP | |
5969 .B softpulldown | |
5970 This filter works only correct with MEncoder and acts on the MPEG-2 flags | |
5971 used for soft 3:2 pulldown (soft telecine). | |
5972 If you want to use the ivtc or detc filter on movies that are partly soft | |
5973 telecined, inserting this filter before them should make them more reliable. | |
5974 . | |
5975 .TP | |
5976 .B divtc[=options] | |
5977 Inverse telecine for deinterlaced video. | |
5978 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced | |
5979 using a method that keeps one field and interpolates the other, the result is | |
5980 a juddering video that has every fourth frame duplicated. | |
5981 This filter is intended to find and drop those duplicates and restore the | |
5982 original film framerate. | |
5983 When using this filter, you must specify \-ofps that is 4/5 of | |
5984 the fps of the input file and place the softskip later in the | |
5985 filter chain to make sure that divtc sees all the frames. | |
5986 Two different modes are available: | |
5987 One pass mode is the default and is straightforward to use, | |
5988 but has the disadvantage that any changes in the telecine | |
5989 phase (lost frames or bad edits) cause momentary judder | |
5990 until the filter can resync again. | |
5991 Two pass mode avoids this by analyzing the whole video | |
5992 beforehand so it will have forward knowledge about the | |
5993 phase changes and can resync at the exact spot. | |
5994 These passes do | |
5995 .B not | |
5996 correspond to pass one and two of the encoding process. | |
5997 You must run an extra pass using divtc pass one before the | |
5998 actual encoding throwing the resulting video away. | |
5999 Use \-nosound \-ovc raw \-o /dev/null to avoid | |
6000 wasting CPU power for this pass. | |
6001 You may add something like crop=2:2:0:0 after divtc | |
6002 to speed things up even more. | |
6003 Then use divtc pass two for the actual encoding. | |
6004 If you use multiple encoder passes, use divtc | |
6005 pass two for all of them. | |
6006 The options are: | |
6007 .RSs | |
6008 .IPs pass=1|2 | |
6009 Use two pass mode. | |
6010 .IPs file=<filename> | |
6011 Set the two pass log filename (default: "framediff.log"). | |
6012 .IPs threshold=<value> | |
6013 Set the minimum strength the telecine pattern must have for the filter to | |
6014 believe in it (default: 0.5). | |
6015 This is used to avoid recognizing false pattern from the parts of the video | |
6016 that are very dark or very still. | |
6017 .IPs window=<numframes> | |
6018 Set the number of past frames to look at when searching for pattern | |
6019 (default: 30). | |
6020 Longer window improves the reliability of the pattern search, but shorter | |
6021 window improves the reaction time to the changes in the telecine phase. | |
6022 This only affects the one pass mode. | |
6023 The two pass mode currently uses fixed window that extends to both future | |
6024 and past. | |
6025 .IPs phase=0|1|2|3|4 | |
6026 Sets the initial telecine phase for one pass mode (default: 0). | |
6027 The two pass mode can see the future, so it is able to use the correct | |
6028 phase from the beginning, but one pass mode can only guess. | |
6029 It catches the correct phase when it finds it, but this option can be used | |
6030 to fix the possible juddering at the beginning. | |
6031 The first pass of the two pass mode also uses this, so if you save the output | |
6032 from the first pass, you get constant phase result. | |
6033 .IPs deghost=<value> | |
6034 Set the deghosting threshold (0\-255 for one pass mode, -255\-255 for two pass | |
6035 mode, default 0). | |
6036 If nonzero, deghosting mode is used. | |
6037 This is for video that has been deinterlaced by blending the fields | |
6038 together instead of dropping one of the fields. | |
6039 Deghosting amplifies any compression artifacts in the blended frames, so the | |
6040 parameter value is used as a threshold to exclude those pixels from | |
6041 deghosting that differ from the previous frame less than specified value. | |
6042 If two pass mode is used, then negative value can be used to make the | |
6043 filter analyze the whole video in the beginning of pass-2 to determine | |
6044 whether it needs deghosting or not and then select either zero or the | |
6045 absolute value of the parameter. | |
6046 Specify this option for pass-2, it makes no difference on pass-1. | |
6047 .RE | |
6048 . | |
6049 .TP | |
6050 .B phase[=t|b|p|a|u|T|B|A|U][:v] | |
6051 Delay interlaced video by one field time so that the field order | |
6052 changes. | |
6053 The intended use is to fix PAL movies that have been captured with the | |
6054 opposite field order to the film-to-video transfer. | |
6055 The options are: | |
6056 .RSs | |
6057 .IPs t | |
6058 Capture field order top-first, transfer bottom-first. | |
6059 Filter will delay the bottom field. | |
6060 .IPs b | |
6061 Capture bottom-first, transfer top-first. | |
6062 Filter will delay the top field. | |
6063 .IPs p | |
6064 Capture and transfer with the same field order. | |
6065 This mode only exists for the documentation of the other options to refer to, | |
6066 but if you actually select it, the filter will faithfully do nothing ;-) | |
6067 .IPs a | |
6068 Capture field order determined automatically by field flags, transfer opposite. | |
6069 Filter selects among t and b modes on a frame by frame basis using field flags. | |
6070 If no field information is available, then this works just like u. | |
6071 .IPs u | |
6072 Capture unknown or varying, transfer opposite. | |
6073 Filter selects among t and b on a frame by frame basis by analyzing the | |
6074 images and selecting the alternative that produces best match between the | |
6075 fields. | |
6076 .IPs T | |
6077 Capture top-first, transfer unknown or varying. | |
6078 Filter selects among t and p using image analysis. | |
6079 .IPs B | |
6080 Capture bottom-first, transfer unknown or varying. | |
6081 Filter selects among b and p using image analysis. | |
6082 .IPs A | |
6083 Capture determined by field flags, transfer unknown or varying. | |
6084 Filter selects among t, b and p using field flags and image analysis. | |
6085 If no field information is available, then this works just like U. | |
6086 This is the default mode. | |
6087 .IPs U | |
6088 Both capture and transfer unknown or varying. | |
6089 Filter selects among t, b and p using image analysis only. | |
6090 .IPs v | |
6091 Verbose operation. | |
6092 Prints the selected mode for each frame and the average squared difference | |
6093 between fields for t, b, and p alternatives. | |
6094 .RE | |
6095 . | |
6096 .TP | |
6097 .B telecine[=start] | |
6098 Apply 3:2 'telecine' process to increase framerate by 20%. | |
6099 This most likely will not work correctly with MPlayer, but it can | |
6100 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'. | |
6101 Both fps options are essential! | |
6102 (A/V sync will break if they are wrong.) | |
6103 The optional start parameter tells the filter where in the telecine | |
6104 pattern to start (0\-3). | |
6105 . | |
6106 .TP | |
6107 .B tinterlace[=mode] | |
6108 Temporal field interlacing \- merge pairs of frames into an interlaced | |
6109 frame, halving the framerate. | |
6110 Even frames are moved into the upper field, odd frames to the lower field. | |
6111 This can be used to fully reverse the effect of the tfields filter (in mode 0). | |
6112 Available modes are: | |
6113 .PD 0 | |
6114 .RSs | |
6115 .IPs 0 | |
6116 Move odd frames into the upper field, even into the lower field, generating | |
6117 a full-height frame at half framerate. | |
6118 .IPs 1 | |
6119 Only output odd frames, even frames are dropped; height unchanged. | |
6120 .IPs 2 | |
6121 Only output even frames, odd frames are dropped; height unchanged. | |
6122 .IPs 3 | |
6123 Expand each frame to full height, but pad alternate lines with black; | |
6124 framerate unchanged. | |
6125 .IPs 4 | |
6126 Interleave even lines from even frames with odd lines from odd frames. | |
6127 Generates full-height frame at half framerate. | |
6128 .RE | |
6129 .PD 1 | |
6130 . | |
6131 .TP | |
6132 .B tfields[=mode[:field_dominance]] | |
6133 Temporal field separation \- split fields into frames, doubling the | |
6134 output framerate. | |
6135 Like the telecine filter, tfields will only work properly with | |
6136 MEncoder, and only if both \-fps and \-ofps are set to the | |
6137 desired (double) framerate! | |
6138 .PD 0 | |
6139 .RSs | |
6140 .IPs <mode> | |
6141 0: Leave fields unchanged (will jump/\:flicker). | |
6142 .br | |
6143 1: Interpolate missing lines. (The algorithm used might not be so good.) | |
6144 .br | |
6145 2: Translate fields by 1/4 pixel with linear interpolation (no jump). | |
6146 .br | |
6147 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default). | |
6148 .IPs <field_dominance> | |
6149 -1: auto (default) | |
6150 Only works if the decoder exports the appropriate information and | |
6151 no other filters which discard that information come before tfields | |
6152 in the filter chain, otherwise it falls back to 0 (top field first). | |
6153 .br | |
6154 0: top field first | |
6155 .br | |
6156 1: bottom field first | |
6157 .RE | |
6158 .PD 1 | |
6159 . | |
6160 .TP | |
6161 .B yadif=[mode[:field_dominance]] | |
6162 Yet another deinterlacing filter | |
6163 .PD 0 | |
6164 .RSs | |
6165 .IPs <mode> | |
6166 0: Output 1 frame for each frame. | |
6167 .br | |
6168 1: Output 1 frame for each field. | |
6169 .br | |
6170 2: Like 0 but skips spatial interlacing check. | |
6171 .br | |
6172 3: Like 1 but skips spatial interlacing check. | |
6173 .IPs <field_dominance> | |
6174 Operates like tfields. | |
6175 .RE | |
6176 .PD 1 | |
6177 . | |
6178 .TP | |
6179 .B mcdeint=[mode[:parity[:qp]]] | |
6180 Motion compensating deinterlacer. | |
6181 It needs one field per frame as input and must thus be used together | |
6182 with tfields=1 or yadif=1/3 or equivalent. | |
6183 .PD 0 | |
6184 .RSs | |
6185 .IPs <mode> | |
6186 0: fast | |
6187 .br | |
6188 1: medium | |
6189 .br | |
6190 2: slow, iterative motion estimation | |
6191 .br | |
6192 3: extra slow, like 2 plus multiple reference frames | |
6193 .IPs <parity> | |
6194 0 or 1 selects which field to use (note: no autodetection yet!). | |
6195 .IPs "<qp>\ " | |
6196 Higher values should result in a smoother motion vector | |
6197 field but less optimal individual vectors. | |
6198 .RE | |
6199 .PD 1 | |
6200 . | |
6201 .TP | |
6202 .B boxblur=radius:power[:radius:power] | |
6203 box blur | |
6204 .PD 0 | |
6205 .RSs | |
6206 .IPs <radius> | |
6207 blur filter strength | |
6208 .IPs <power> | |
6209 number of filter applications | |
6210 .RE | |
6211 .PD 1 | |
6212 . | |
6213 .TP | |
6214 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff] | |
6215 shape adaptive blur | |
6216 .PD 0 | |
6217 .RSs | |
6218 .IPs <radius> | |
6219 blur filter strength (~0.1\-4.0) (slower if larger) | |
6220 .IPs "<pf>\ " | |
6221 prefilter strength (~0.1\-2.0) | |
6222 .IPs <colorDiff> | |
6223 maximum difference between pixels to still be considered (~0.1\-100.0) | |
6224 .RE | |
6225 .PD 1 | |
6226 . | |
6227 .TP | |
6228 .B smartblur=radius:strength:threshold[:radius:strength:threshold] | |
6229 smart blur | |
6230 .PD 0 | |
6231 .RSs | |
6232 .IPs <radius> | |
6233 blur filter strength (~0.1\-5.0) (slower if larger) | |
6234 .IPs <strength> | |
6235 blur (0.0\-1.0) or sharpen (-1.0\-0.0) | |
6236 .IPs <threshold> | |
6237 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) | |
6238 .RE | |
6239 .PD 1 | |
6240 . | |
6241 .TP | |
6242 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t | |
6243 Correct the perspective of movies not filmed perpendicular to the screen. | |
6244 .PD 0 | |
6245 .RSs | |
6246 .IPs <x0>,<y0>,... | |
6247 coordinates of the top left, top right, bottom left, bottom right corners | |
6248 .IPs "<t>\ \ " | |
6249 linear (0) or cubic resampling (1) | |
6250 .RE | |
6251 .PD 1 | |
6252 . | |
6253 .TP | |
6254 .B "2xsai\ \ " | |
6255 Scale and smooth the image with the 2x scale and interpolate algorithm. | |
6256 . | |
6257 .TP | |
6258 .B "1bpp\ \ \ " | |
6259 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion | |
6260 . | |
6261 .TP | |
6262 .B down3dright[=lines] | |
6263 Reposition and resize stereoscopic images. | |
6264 Extracts both stereo fields and places them side by side, resizing | |
6265 them to maintain the original movie aspect. | |
6266 .PD 0 | |
6267 .RSs | |
6268 .IPs <lines> | |
6269 number of lines to select from the middle of the image (default: 12) | |
6270 .RE | |
6271 .PD 1 | |
6272 . | |
6273 .TP | |
6274 .B bmovl=hidden:opaque:fifo | |
6275 The bitmap overlay filter reads bitmaps from a FIFO and displays them | |
6276 on top of the movie, allowing some transformations on the image. | |
6277 Also see TOOLS/bmovl-test.c for a small bmovl test program. | |
6278 .PD 0 | |
6279 .RSs | |
6280 .IPs <hidden> | |
6281 Set the default value of the 'hidden' flag (0=visible, 1=hidden). | |
6282 .IPs <opaque> | |
6283 Set the default value of the 'opaque' flag (0=transparent, 1=opaque). | |
6284 .IPs <fifo> | |
6285 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the | |
6286 controlling application) | |
6287 .RE | |
6288 .PD 1 | |
6289 .sp 1 | |
6290 .RS | |
6291 FIFO commands are: | |
6292 .RE | |
6293 .PD 0 | |
6294 .RSs | |
6295 .IPs "RGBA32 width height xpos ypos alpha clear" | |
6296 followed by width*height*4 Bytes of raw RGBA32 data. | |
6297 .IPs "ABGR32 width height xpos ypos alpha clear" | |
6298 followed by width*height*4 Bytes of raw ABGR32 data. | |
6299 .IPs "RGB24 width height xpos ypos alpha clear" | |
6300 followed by width*height*3 Bytes of raw RGB24 data. | |
6301 .IPs "BGR24 width height xpos ypos alpha clear" | |
6302 followed by width*height*3 Bytes of raw BGR24 data. | |
6303 .IPs "ALPHA width height xpos ypos alpha" | |
6304 Change alpha transparency of the specified area. | |
6305 .IPs "CLEAR width height xpos ypos" | |
6306 Clear area. | |
6307 .IPs OPAQUE | |
6308 Disable all alpha transparency. | |
6309 Send "ALPHA 0 0 0 0 0" to enable it again. | |
6310 .IPs "HIDE\ " | |
6311 Hide bitmap. | |
6312 .IPs "SHOW\ " | |
6313 Show bitmap. | |
6314 .RE | |
6315 .PD 1 | |
6316 .sp 1 | |
6317 .RS | |
6318 Arguments are: | |
6319 .RE | |
6320 .PD 0 | |
6321 .RSs | |
6322 .IPs "<width>, <height>" | |
6323 image/area size | |
6324 .IPs "<xpos>, <ypos>" | |
6325 Start blitting at position x/y. | |
6326 .IPs <alpha> | |
6327 Set alpha difference. | |
6328 If you set this to -255 you can then send a sequence of ALPHA-commands to set | |
6329 the area to -225, -200, -175 etc for a nice fade-in-effect! ;) | |
6330 .RSss | |
6331 0: same as original | |
6332 .br | |
6333 255: Make everything opaque. | |
6334 .br | |
6335 -255: Make everything transparent. | |
6336 .REss | |
6337 .IPs <clear> | |
6338 Clear the framebuffer before blitting. | |
6339 .RSss | |
6340 0: The image will just be blitted on top of the old one, so you do not need to | |
6341 send 1.8MB of RGBA32 data every time a small part of the screen is updated. | |
6342 .br | |
6343 1: clear | |
6344 .REss | |
6345 .RE | |
6346 .PD 1 | |
6347 . | |
6348 .TP | |
6349 .B framestep=I|[i]step | |
6350 Renders only every nth frame or every intra frame (keyframe). | |
6351 .sp 1 | |
6352 If you call the filter with I (uppercase) as the parameter, then | |
6353 .B only | |
6354 keyframes are rendered. | |
6355 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB), | |
6356 for AVI it means every scene change or every keyint value (see \-lavcopts | |
6357 keyint= value if you use MEncoder to encode the video). | |
6358 .sp 1 | |
6359 When a keyframe is found, an 'I!' string followed by a newline character is | |
6360 printed, leaving the current line of MPlayer/\:MEncoder output on the screen, | |
6361 because it contains the time (in seconds) and frame number of the keyframe | |
6362 (You can use this information to split the AVI.). | |
6363 .sp 1 | |
6364 If you call the filter with a numeric parameter 'step' then only one in | |
6365 every 'step' frames is rendered. | |
6366 .sp 1 | |
6367 If you put an 'i' (lowercase) before the number then an 'I!' is printed | |
6368 (like the I parameter). | |
6369 .sp 1 | |
6370 If you give only the i then nothing is done to the frames, only I! is | |
6371 printed. | |
6372 . | |
6373 .TP | |
6374 .B tile=xtiles:ytiles:output:start:delta | |
6375 Tile a series of images into a single, bigger image. | |
6376 If you omit a parameter or use a value less than 0, then the default | |
6377 value is used. | |
6378 You can also stop when you are satisfied (... \-vf tile=10:5 ...). | |
6379 It is probably a good idea to put the scale filter before the tile :-) | |
6380 .sp 1 | |
6381 The parameters are: | |
6382 .sp 1 | |
6383 .PD 0 | |
6384 .RSs | |
6385 .IPs <xtiles> | |
6386 number of tiles on the x axis (default: 5) | |
6387 .IPs <ytiles> | |
6388 number of tiles on the y axis (default: 5) | |
6389 .IPs <output> | |
6390 Render the tile when 'output' number of frames are reached, where 'output' | |
6391 should be a number less than xtile * ytile. | |
6392 Missing tiles are left blank. | |
6393 You could, for example, write an 8 * 7 tile every 50 frames to have one | |
6394 image every 2 seconds @ 25 fps. | |
6395 .IPs <start> | |
6396 outer border thickness in pixels (default: 2) | |
6397 .IPs <delta> | |
6398 inner border thickness in pixels (default: 4) | |
6399 .RE | |
6400 .PD 1 | |
6401 . | |
6402 .TP | |
6403 .B delogo[=x:y:w:h:t] | |
6404 Suppresses a TV station logo by a simple interpolation of the | |
6405 surrounding pixels. | |
6406 Just set a rectangle covering the logo and watch it disappear (and | |
6407 sometimes something even uglier appear \- your mileage may vary). | |
6408 .PD 0 | |
6409 .RSs | |
6410 .IPs <x>,<y> | |
6411 top left corner of the logo | |
6412 .IPs <w>,<h> | |
6413 width and height of the cleared rectangle | |
6414 .IPs <t> | |
6415 Thickness of the fuzzy edge of the rectangle (added to w and h). | |
6416 When set to -1, a green rectangle is drawn on the screen to | |
6417 simplify finding the right x,y,w,h parameters. | |
6418 .RE | |
6419 .PD 1 | |
6420 . | |
6421 .TP | |
6422 .B remove-logo=/path/to/logo_bitmap_file_name.pgm | |
6423 Suppresses a TV station logo, using a PGM or PPM image | |
6424 file to determine which pixels comprise the logo. | |
6425 The width and height of the image file must match | |
6426 those of the video stream being processed. | |
6427 Uses the filter image and a circular blur | |
6428 algorithm to remove the logo. | |
6429 .RSs | |
6430 .IPs /path/to/logo_bitmap_file_name.pgm | |
6431 [path] + filename of the filter image. | |
6432 .RE | |
6433 . | |
6434 .TP | |
6435 .B zrmjpeg[=options] | |
6436 Software YV12 to MJPEG encoder for use with the zr2 video | |
6437 output device. | |
6438 .RSs | |
6439 .IPs maxheight=<h>|maxwidth=<w> | |
6440 These options set the maximum width and height the zr card | |
6441 can handle (the MPlayer filter layer currently cannot query those). | |
6442 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC} | |
6443 Use these options to set maxwidth and maxheight automatically to the | |
6444 values known for card/\:mode combo. | |
6445 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL) | |
6446 .IPs color|bw | |
6447 Select color or black and white encoding. | |
6448 Black and white encoding is faster. | |
6449 Color is the default. | |
6450 .IPs hdec={1,2,4} | |
6451 Horizontal decimation 1, 2 or 4. | |
6452 .IPs vdec={1,2,4} | |
6453 Vertical decimation 1, 2 or 4. | |
6454 .IPs quality=1\-20 | |
6455 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD]. | |
6456 .IPs fd|nofd | |
6457 By default, decimation is only performed if the Zoran hardware | |
6458 can upscale the resulting MJPEG images to the original size. | |
6459 The option fd instructs the filter to always perform the requested | |
6460 decimation (ugly). | |
6461 .RE | |
6462 . | |
6463 .TP | |
6464 .B screenshot | |
6465 Allows acquiring screenshots of the movie using slave mode | |
6466 commands that can be bound to keypresses. | |
6467 See the slave mode documentation and the INTERACTIVE CONTROL | |
6468 section for details. | |
6469 Files named 'shotNNNN.png' will be saved in the working directory, | |
6470 using the first available number - no files will be overwritten. | |
6471 The filter has no overhead when not used and accepts an arbitrary | |
6472 colorspace, so it is safe to add it to the configuration file. | |
6473 .RE | |
6474 . | |
6475 .TP | |
6476 .B "ass\ \ \ \ " | |
6477 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain. | |
6478 Only useful with the \-ass option. | |
6479 .sp 1 | |
6480 .I EXAMPLE: | |
6481 .PD 0 | |
6482 .RSs | |
6483 .IPs "\-vf ass,screenshot" | |
6484 Moves SSA/ASS rendering before the screenshot filter. | |
6485 Screenshots taken this way will contain subtitles. | |
6486 .RE | |
6487 .PD 1 | |
6488 . | |
6489 .TP | |
6490 .B blackframe[=amount:threshold] | |
6491 Detect frames that are (almost) completely black. | |
6492 Can be useful to detect chapter transitions or commercials. | |
6493 Output lines consist of the frame number of the detected frame, the | |
6494 percentage of blackness, the frame type and the frame number of the last | |
6495 encountered keyframe. | |
6496 .RSs | |
6497 .IPs <amount> | |
6498 Percentage of the pixels that have to be below the threshold (default: 98). | |
6499 .IPs <threshold> | |
6500 Threshold below which a pixel value is considered black (default: 32). | |
6501 .RE | |
6502 . | |
6503 . | |
6504 . | |
6505 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)" | |
6506 . | |
6507 .TP | |
6508 .B \-audio-delay <any floating-point number> | |
6509 Delays either audio or video by setting a delay field in the header | |
6510 (default: 0.0). | |
6511 This does not delay either stream while encoding, but the player will | |
6512 see the delay field and compensate accordingly. | |
6513 Positive values delay the audio, and negative values delay the video. | |
6514 Note that this is the exact opposite of the \-delay option. | |
6515 For example, if a video plays correctly with \-delay 0.2, you can | |
6516 fix the video with MEncoder by using \-audio-delay -0.2. | |
6517 .sp 1 | |
6518 Currently, this option only works with the default muxer (\-of avi). | |
6519 If you are using a different muxer, then you must use \-delay instead. | |
6520 . | |
6521 .TP | |
6522 .B \-audio-density <1\-50> | |
6523 Number of audio chunks per second (default is 2 for 0.5s long audio chunks). | |
6524 .br | |
6525 .I NOTE: | |
6526 CBR only, VBR ignores this as it puts each packet in a new chunk. | |
6527 . | |
6528 .TP | |
6529 .B \-audio-preload <0.0\-2.0> | |
6530 Sets up the audio buffering time interval (default: 0.5s). | |
6531 . | |
6532 .TP | |
6533 .B \-fafmttag <format> | |
6534 Can be used to override the audio format tag of the output file. | |
6535 .sp 1 | |
6536 .I EXAMPLE: | |
6537 .PD 0 | |
6538 .RSs | |
6539 .IPs "\-fafmttag 0x55" | |
6540 Will have the output file contain 0x55 (mp3) as audio format tag. | |
6541 .RE | |
6542 .PD 1 | |
6543 . | |
6544 .TP | |
6545 .B \-ffourcc <fourcc> | |
6546 Can be used to override the video fourcc of the output file. | |
6547 .sp 1 | |
6548 .I EXAMPLE: | |
6549 .PD 0 | |
6550 .RSs | |
6551 .IPs "\-ffourcc div3" | |
6552 Will have the output file contain 'div3' as video fourcc. | |
6553 .RE | |
6554 .PD 1 | |
6555 . | |
6556 .TP | |
6557 .B \-force-avi-aspect <0.2\-3.0> | |
6558 Override the aspect stored in the AVI OpenDML vprp header. | |
6559 This can be used to change the aspect ratio with '\-ovc copy'. | |
6560 . | |
6561 .TP | |
6562 .B \-frameno-file <filename> (DEPRECATED) | |
6563 Specify the name of the audio file with framenumber mappings created in | |
6564 the first (audio only) pass of a special three pass encoding mode. | |
6565 .br | |
6566 .I NOTE: | |
6567 Using this mode will most likely give you A-V desync. | |
6568 Do not use it. | |
6569 It is kept for backwards compatibility only and will possibly | |
6570 be removed in a future version. | |
6571 . | |
6572 .TP | |
6573 .B \-hr-edl-seek | |
6574 Use a more precise, but much slower method for skipping areas. | |
6575 Areas marked for skipping are not seeked over, instead all | |
6576 frames are decoded, but only the necessary frames are encoded. | |
6577 This allows starting at non-keyframe boundaries. | |
6578 .br | |
6579 .I NOTE: | |
6580 Not guaranteed to work right with '\-ovc copy'. | |
6581 . | |
6582 .TP | |
6583 .B \-info <option1:option2:...> (AVI only) | |
6584 Specify the info header of the resulting AVI file. | |
6585 .sp 1 | |
6586 Available options are: | |
6587 .RSs | |
6588 .IPs "help\ " | |
6589 Show this description. | |
6590 .IPs name=<value> | |
6591 title of the work | |
6592 .IPs artist=<value> | |
6593 artist or author of the work | |
6594 .IPs genre=<value> | |
6595 original work category | |
6596 .IPs subject=<value> | |
6597 contents of the work | |
6598 .IPs copyright=<value> | |
6599 copyright information | |
6600 .IPs srcform=<value> | |
6601 original format of the digitized material | |
6602 .IPs comment=<value> | |
6603 general comments about the work | |
6604 .RE | |
6605 . | |
6606 .TP | |
6607 .B \-noautoexpand | |
6608 Do not automatically insert the expand filter into the MEncoder filter chain. | |
6609 Useful to control at which point of the filter chain subtitles are rendered | |
6610 when hardcoding subtitles onto a movie. | |
6611 . | |
6612 .TP | |
6613 .B \-noencodedups | |
6614 Do not attempt to encode duplicate frames in duplicate; always output | |
6615 zero-byte frames to indicate duplicates. | |
6616 Zero-byte frames will be written anyway unless a filter or encoder | |
6617 capable of doing duplicate encoding is loaded. | |
6618 Currently the only such filter is harddup. | |
6619 . | |
6620 .TP | |
6621 .B \-noodml (\-of avi only) | |
6622 Do not write OpenDML index for AVI files >1GB. | |
6623 . | |
6624 .TP | |
6625 .B \-noskip | |
6626 Do not skip frames. | |
6627 . | |
6628 .TP | |
6629 .B \-o <filename> | |
6630 Outputs to the given filename. | |
6631 .br | |
6632 If you want a default output filename, you can put this option in the | |
6633 MEncoder config file. | |
6634 . | |
6635 .TP | |
6636 .B \-oac <codec name> | |
6637 Encode with the given audio codec (no default set). | |
6638 .br | |
6639 .I NOTE: | |
6640 Use \-oac help to get a list of available audio codecs. | |
6641 .sp 1 | |
6642 .I EXAMPLE: | |
6643 .PD 0 | |
6644 .RSs | |
6645 .IPs "\-oac copy" | |
6646 no encoding, just streamcopy | |
6647 .IPs "\-oac pcm" | |
6648 Encode to uncompressed PCM. | |
6649 .IPs "\-oac mp3lame" | |
6650 Encode to MP3 (using LAME). | |
6651 .IPs "\-oac lavc" | |
6652 Encode with a libavcodec codec. | |
6653 .RE | |
6654 .PD 1 | |
6655 . | |
6656 .TP | |
6657 .B \-of <format> (BETA CODE!) | |
6658 Encode to the specified container format (default: AVI). | |
6659 .br | |
6660 .I NOTE: | |
6661 Use \-of help to get a list of available container formats. | |
6662 .sp 1 | |
6663 .I EXAMPLE: | |
6664 .PD 0 | |
6665 .RSs | |
6666 .IPs "\-of avi" | |
6667 Encode to AVI. | |
6668 .IPs "\-of mpeg" | |
6669 Encode to MPEG (also see \-mpegopts). | |
6670 .IPs "\-of lavf" | |
6671 Encode with libavformat muxers (also see \-lavfopts). | |
6672 .IPs "\-of rawvideo" | |
6673 raw video stream (no muxing \- one video stream only) | |
6674 .IPs "\-of rawaudio" | |
6675 raw audio stream (no muxing \- one audio stream only) | |
6676 .RE | |
6677 .PD 1 | |
6678 . | |
6679 .TP | |
6680 .B \-ofps <fps> | |
6681 Specify a frames per second (fps) value for the output file, | |
6682 which can be different from that of the source material. | |
6683 Must be set for variable fps (ASF, some MOV) and progressive | |
6684 (30000/1001 fps telecined MPEG) files. | |
6685 . | |
6686 .TP | |
6687 .B \-ovc <codec name> | |
6688 Encode with the given video codec (no default set). | |
6689 .br | |
6690 .I NOTE: | |
6691 Use \-ovc help to get a list of available video codecs. | |
6692 .sp 1 | |
6693 .I EXAMPLE: | |
6694 .PD 0 | |
6695 .RSs | |
6696 .IPs "\-ovc copy" | |
6697 no encoding, just streamcopy | |
6698 .IPs "\-ovc raw" | |
6699 Encode to an arbitrary uncompressed format (use '\-vf format' to select). | |
6700 .IPs "\-ovc lavc" | |
6701 Encode with a libavcodec codec. | |
6702 .RE | |
6703 .PD 1 | |
6704 . | |
6705 .TP | |
6706 .B \-passlogfile <filename> | |
6707 Dump first pass information to <filename> instead of the default divx2pass.log | |
6708 in two pass encoding mode. | |
6709 . | |
6710 .TP | |
6711 .B \-skiplimit <value> | |
6712 Specify the maximum number of frames that may be skipped after | |
6713 encoding one frame (\-noskiplimit for unlimited). | |
6714 . | |
6715 .TP | |
6716 .B \-vobsubout <basename> | |
6717 Specify the basename for the output .idx and .sub files. | |
6718 This turns off subtitle rendering in the encoded movie and diverts it to | |
6719 VOBsub subtitle files. | |
6720 . | |
6721 .TP | |
6722 .B \-vobsuboutid <langid> | |
6723 Specify the language two letter code for the subtitles. | |
6724 This overrides what is read from the DVD or the .ifo file. | |
6725 . | |
6726 .TP | |
6727 .B \-vobsuboutindex <index> | |
6728 Specify the index of the subtitles in the output files (default: 0). | |
6729 . | |
6730 . | |
6731 . | |
6732 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)" | |
6733 You can specify codec specific encoding parameters using the following | |
6734 syntax: | |
6735 . | |
6736 .TP | |
6737 .B \-<codec>opts <option1[=value],option2,...> | |
6738 . | |
6739 .PP | |
6740 Where <codec> may be: lavc, xvidenc, lame, toolame, twolame, | |
6741 nuv, xvfw, faac, x264enc, mpeg, lavf. | |
6742 . | |
6743 . | |
6744 .SS lame (\-lameopts) | |
6745 . | |
6746 .TP | |
6747 .B "help\ \ \ " | |
6748 get help | |
6749 . | |
6750 .TP | |
6751 .B vbr=<0\-4> | |
6752 variable bitrate method | |
6753 .PD 0 | |
6754 .RSs | |
6755 .IPs 0 | |
6756 cbr | |
6757 .IPs 1 | |
6758 mt | |
6759 .IPs 2 | |
6760 rh (default) | |
6761 .IPs 3 | |
6762 abr | |
6763 .IPs 4 | |
6764 mtrh | |
6765 .RE | |
6766 .PD 1 | |
6767 . | |
6768 .TP | |
6769 .B "abr\ \ \ \ " | |
6770 average bitrate | |
6771 . | |
6772 .TP | |
6773 .B "cbr\ \ \ \ " | |
6774 constant bitrate | |
6775 Also forces CBR mode encoding on subsequent ABR presets modes. | |
6776 . | |
6777 .TP | |
6778 .B br=<0\-1024> | |
6779 bitrate in kbps (CBR and ABR only) | |
6780 . | |
6781 .TP | |
6782 .B q=<0\-9> | |
6783 quality (0 \- highest, 9 \- lowest) (VBR only) | |
6784 . | |
6785 .TP | |
6786 .B aq=<0\-9> | |
6787 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest) | |
6788 . | |
6789 .TP | |
6790 .B ratio=<1\-100> | |
6791 compression ratio | |
6792 . | |
6793 .TP | |
6794 .B vol=<0\-10> | |
6795 audio input gain | |
6796 . | |
6797 .TP | |
6798 .B mode=<0\-3> | |
6799 (default: auto) | |
6800 .PD 0 | |
6801 .RSs | |
6802 .IPs 0 | |
6803 stereo | |
6804 .IPs 1 | |
6805 joint-stereo | |
6806 .IPs 2 | |
6807 dualchannel | |
6808 .IPs 3 | |
6809 mono | |
6810 .RE | |
6811 .PD 1 | |
6812 . | |
6813 .TP | |
6814 .B padding=<0\-2> | |
6815 .PD 0 | |
6816 .RSs | |
6817 .IPs 0 | |
6818 none | |
6819 .IPs 1 | |
6820 all | |
6821 .IPs 2 | |
6822 adjust | |
6823 .RE | |
6824 .PD 1 | |
6825 . | |
6826 .TP | |
6827 .B "fast\ \ \ " | |
6828 Switch on faster encoding on subsequent VBR presets modes. | |
6829 This results in slightly lower quality and higher bitrates. | |
6830 . | |
6831 .TP | |
6832 .B highpassfreq=<freq> | |
6833 Set a highpass filtering frequency in Hz. | |
6834 Frequencies below the specified one will be cut off. | |
6835 A value of -1 will disable filtering, a value of 0 | |
6836 will let LAME choose values automatically. | |
6837 . | |
6838 .TP | |
6839 .B lowpassfreq=<freq> | |
6840 Set a lowpass filtering frequency in Hz. | |
6841 Frequencies above the specified one will be cut off. | |
6842 A value of -1 will disable filtering, a value of 0 | |
6843 will let LAME choose values automatically. | |
6844 . | |
6845 .TP | |
6846 .B preset=<value> | |
6847 preset values | |
6848 .RSs | |
6849 .IPs "help\ " | |
6850 Print additional options and information about presets settings. | |
6851 .IPs medium | |
6852 VBR encoding, good quality, 150\-180 kbps bitrate range | |
6853 .IPs standard | |
6854 VBR encoding, high quality, 170\-210 kbps bitrate range | |
6855 .IPs extreme | |
6856 VBR encoding, very high quality, 200\-240 kbps bitrate range | |
6857 .IPs insane | |
6858 CBR encoding, highest preset quality, 320 kbps bitrate | |
6859 .IPs <8\-320> | |
6860 ABR encoding at average given kbps bitrate | |
6861 .RE | |
6862 .sp 1 | |
6863 .RS | |
6864 .I EXAMPLES: | |
6865 .RE | |
6866 .PD 0 | |
6867 .RSs | |
6868 .IPs fast:preset=standard | |
6869 suitable for most people and most music types and already quite high quality | |
6870 .IPs cbr:preset=192 | |
6871 Encode with ABR presets at a 192 kbps forced constant bitrate. | |
6872 .IPs preset=172 | |
6873 Encode with ABR presets at a 172 kbps average bitrate. | |
6874 .IPs preset=extreme | |
6875 for people with extremely good hearing and similar equipment | |
6876 .RE | |
6877 .PD 1 | |
6878 . | |
6879 . | |
6880 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively) | |
6881 . | |
6882 .TP | |
6883 .B br=<32\-384> | |
6884 In CBR mode this parameter indicates the bitrate in kbps, | |
6885 when in VBR mode it is the minimum bitrate allowed per frame. | |
6886 VBR mode will not work with a value below 112. | |
6887 . | |
6888 .TP | |
6889 .B vbr=<-50\-50> (VBR only) | |
6890 variability range; if negative the encoder shifts the average bitrate | |
6891 towards the lower limit, if positive towards the higher. | |
6892 When set to 0 CBR is used (default). | |
6893 . | |
6894 .TP | |
6895 .B maxvbr=<32\-384> (VBR only) | |
6896 maximum bitrate allowed per frame, in kbps | |
6897 . | |
6898 .TP | |
6899 .B mode=<stereo | jstereo | mono | dual> | |
6900 (default: mono for 1-channel audio, stereo otherwise) | |
6901 . | |
6902 .TP | |
6903 .B psy=<-1\-4> | |
6904 psychoacoustic model (default: 2) | |
6905 . | |
6906 .TP | |
6907 .B errprot=<0 | 1> | |
6908 Include error protection. | |
6909 . | |
6910 .TP | |
6911 .B debug=<0\-10> | |
6912 debug level | |
6913 .RE | |
6914 .PD 1 | |
6915 . | |
6916 . | |
6917 .SS faac (\-faacopts) | |
6918 . | |
6919 .TP | |
6920 .B br=<bitrate> | |
6921 average bitrate in kbps (mutually exclusive with quality) | |
6922 . | |
6923 .TP | |
6924 .B quality=<1\-1000> | |
6925 quality mode, the higher the better (mutually exclusive with br) | |
6926 . | |
6927 .TP | |
6928 .B object=<1\-4> | |
6929 object type complexity | |
6930 .PD 0 | |
6931 .RSs | |
6932 .IPs 1 | |
6933 MAIN (default) | |
6934 .IPs 2 | |
6935 LOW | |
6936 .IPs 3 | |
6937 SSR | |
6938 .IPs 4 | |
6939 LTP (extremely slow) | |
6940 .RE | |
6941 .PD 1 | |
6942 . | |
6943 .TP | |
6944 .B mpeg=<2|4> | |
6945 MPEG version (default: 4) | |
6946 . | |
6947 .TP | |
6948 .B "tns\ \ \ \ " | |
6949 Enables temporal noise shaping. | |
6950 . | |
6951 .TP | |
6952 .B cutoff=<0\-sampling_rate/2> | |
6953 cutoff frequency (default: sampling_rate/2) | |
6954 . | |
6955 .TP | |
6956 .B "raw\ \ \ \ " | |
6957 Stores the bitstream as raw payload with extradata in the container header | |
6958 (default: 0, corresponds to ADTS). | |
6959 Do not set this flag if not explicitly required or you will not be able to | |
6960 remux the audio stream later on. | |
6961 .RE | |
6962 .PD 1 | |
6963 . | |
6964 . | |
6965 .SS lavc (\-lavcopts) | |
6966 . | |
6967 Many libavcodec (lavc for short) options are tersely documented. | |
6968 Read the source for full details. | |
6969 .PP | |
6970 .I EXAMPLE: | |
6971 .PD 0 | |
6972 .RSs | |
6973 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 | |
6974 .RE | |
6975 .PD 1 | |
6976 . | |
6977 .TP | |
6978 .B acodec=<value> | |
6979 audio codec (default: mp2) | |
6980 .PD 0 | |
6981 .RSs | |
6982 .IPs "mp2\ \ " | |
6983 MPEG Layer 2 | |
6984 .IPs "mp3\ \ " | |
6985 MPEG Layer 3 | |
6986 .IPs "ac3\ \ " | |
6987 AC3 | |
6988 .IPs adpcm_ima_wav | |
6989 IMA Adaptive PCM (4bits per sample, 4:1 compression) | |
6990 .IPs "sonic\ " | |
6991 Experimental lossy/lossless codec | |
6992 .RE | |
6993 .PD 1 | |
6994 . | |
6995 .TP | |
6996 .B abitrate=<value> | |
6997 audio bitrate in kbps (default: 224) | |
6998 . | |
6999 .TP | |
7000 .B atag=<value> | |
7001 Use the specified Windows audio format tag (e.g.\& atag=0x55). | |
7002 . | |
7003 .TP | |
7004 .B bit_exact | |
7005 Use only bit exact algorithms (except (I)DCT). | |
7006 Additionally bit_exact disables several optimizations and thus | |
7007 should only be used for regression tests, which need binary | |
7008 identical files even if the encoder version changes. | |
7009 This also suppresses the user_data header in MPEG-4 streams. | |
7010 Do not use this option unless you know exactly what you are doing. | |
7011 . | |
7012 .TP | |
7013 .B threads=<1\-8> | |
7014 Maximum number of threads to use (default: 1). | |
7015 May have a slight negative effect on motion estimation. | |
7016 .RE | |
7017 . | |
7018 .TP | |
7019 .B vcodec=<value> | |
7020 Employ the specified codec (default: mpeg4). | |
7021 .PD 0 | |
7022 .RSs | |
7023 .IPs mjpeg | |
7024 Motion JPEG | |
7025 .IPs ljpeg | |
7026 Lossless JPEG | |
7027 .IPs "h261\ " | |
7028 H.261 | |
7029 .IPs "h263\ " | |
7030 H.263 | |
7031 .IPs h263p | |
7032 H.263+ | |
7033 .IPs mpeg4 | |
7034 MPEG-4 (DivX 4/5) | |
7035 .IPs msmpeg4 | |
7036 DivX 3 | |
7037 .IPs msmpeg4v2 | |
7038 MS MPEG4v2 | |
7039 .IPs "wmv1\ " | |
7040 Windows Media Video, version 1 (AKA WMV7) | |
7041 .IPs "wmv2\ " | |
7042 Windows Media Video, version 2 (AKA WMV8) | |
7043 .IPs "rv10\ " | |
7044 an old RealVideo codec | |
7045 .IPs mpeg1video | |
7046 MPEG-1 video | |
7047 .IPs mpeg2video | |
7048 MPEG-2 video | |
7049 .IPs huffyuv | |
7050 HuffYUV | |
7051 .IPs ffvhuff (also see: vstrict) | |
7052 nonstandard 20% smaller HuffYUV using YV12 | |
7053 .IPs "asv1\ " | |
7054 ASUS Video v1 | |
7055 .IPs "asv2\ " | |
7056 ASUS Video v2 | |
7057 .IPs "ffv1 (also see: vstrict)" | |
7058 FFmpeg's lossless video codec | |
7059 .IPs "flv\ \ " | |
7060 Sorenson H.263 used in Flash Video | |
7061 .IPs dvvideo | |
7062 Sony Digital Video | |
7063 .IPs "svq1\ " | |
7064 Apple Sorenson Video 1 | |
7065 .IPs "snow (also see: vstrict)" | |
7066 FFmpeg's experimental wavelet-based codec | |
7067 .RE | |
7068 .PD 1 | |
7069 . | |
7070 .TP | |
7071 .B vqmin=<1\-31> | |
7072 minimum quantizer (pass 1/2) | |
7073 .RSs | |
7074 .IPs 1 | |
7075 Not recommended (much larger file, little quality difference and weird side | |
7076 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused | |
7077 resulting in lower quality and some decoders will not be able to decode it). | |
7078 .IPs 2 | |
7079 Recommended for normal mpeg4/\:mpeg1video encoding (default). | |
7080 .IPs 3 | |
7081 Recommended for h263(p)/\:msmpeg4. | |
7082 The reason for preferring 3 over 2 is that 2 could lead to overflows. | |
7083 (This will be fixed for h263(p) by changing the quantizer per MB in | |
7084 the future, msmpeg4 cannot be fixed as it does not support that.) | |
7085 .RE | |
7086 . | |
7087 .TP | |
7088 .B lmin=<0.01\-255.0> | |
7089 Minimum Lagrange multiplier for ratecontrol, you probably want it to be | |
7090 equal to or lower than vqmin (default: 2.0). | |
7091 .RE | |
7092 . | |
7093 .TP | |
7094 .B lmax=<0.01\-255.0> | |
7095 maximum Lagrange multiplier for ratecontrol (default: 31.0) | |
7096 .RE | |
7097 . | |
7098 .TP | |
7099 .B vqscale=<0\-31> | |
7100 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode). | |
7101 A lower value means better quality but larger files (default: 0). | |
7102 In case of snow codec, value 0 means lossless encoding. | |
7103 Since the other codecs do not support this, vqscale=0 will be ignored and | |
7104 variable quantizers are used, which is the default. | |
7105 1 is not recommended (see vqmin for details). | |
7106 . | |
7107 .TP | |
7108 .B vqmax=<1\-31> | |
7109 Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31). | |
7110 . | |
7111 .TP | |
7112 .B mbqmin=<1\-31> | |
7113 obsolete, use vqmin | |
7114 . | |
7115 .TP | |
7116 .B mbqmax=<1\-31> | |
7117 obsolete, use vqmax | |
7118 . | |
7119 .TP | |
7120 .B vqdiff=<1\-31> | |
7121 maximum quantizer difference between consecutive I- or P-frames | |
7122 (pass 1/2) (default: 3) | |
7123 . | |
7124 .TP | |
7125 .B vmax_b_frames=<0\-4> | |
7126 maximum number of B-frames between non-B-frames: | |
7127 .PD 0 | |
7128 .RSs | |
7129 .IPs 0 | |
7130 no B-frames (default) | |
7131 .IPs 0\-2 | |
7132 sane range for MPEG-4 | |
7133 .RE | |
7134 .PD 1 | |
7135 . | |
7136 .TP | |
7137 .B vme=<0\-5> | |
7138 motion estimation method. | |
7139 Available methods are: | |
7140 .PD 0 | |
7141 .RSs | |
7142 .IPs 0 | |
7143 none (very low quality) | |
7144 .IPs 1 | |
7145 full (slow, currently unmaintained and disabled) | |
7146 .IPs 2 | |
7147 log (low quality, currently unmaintained and disabled) | |
7148 .IPs 3 | |
7149 phods (low quality, currently unmaintained and disabled) | |
7150 .IPs 4 | |
7151 EPZS: size=1 diamond, size can be adjusted with the *dia options | |
7152 (default) | |
7153 .IPs 5 | |
7154 X1 (experimental, currently aliased to EPZS) | |
7155 .IPs 8 | |
7156 iter (iterative overlapped block, only used in snow) | |
7157 .RE | |
7158 .PD 1 | |
7159 .sp 1 | |
7160 .RS | |
7161 .br | |
7162 .I NOTE: | |
7163 0\-3 currently ignores the amount of bits spent, | |
7164 so quality may be low. | |
7165 .RE | |
7166 . | |
7167 .TP | |
7168 .B me_range=<0\-9999> | |
7169 motion estimation search range (default: 0 (unlimited)) | |
7170 . | |
7171 .TP | |
7172 .B mbd=<0\-2> | |
7173 Macroblock decision algorithm (high quality mode), encode each macro | |
7174 block in all modes and choose the best. | |
7175 This is slow but results in better quality and file size. | |
7176 .PD 0 | |
7177 .RSs | |
7178 .IPs 0 | |
7179 Use mbcmp (default). | |
7180 .IPs 1 | |
7181 Select the MB mode which needs the fewest bits (=vhq). | |
7182 .IPs 2 | |
7183 Select the MB mode which has the best rate distortion. | |
7184 .RE | |
7185 .PD 1 | |
7186 . | |
7187 .TP | |
7188 .B "vhq\ \ \ \ " | |
7189 Same as mbd=1, kept for compatibility reasons. | |
7190 . | |
7191 .TP | |
7192 .B "v4mv\ \ \ " | |
7193 Allow 4 motion vectors per macroblock (slightly better quality). | |
7194 Works better if used with mbd>0. | |
7195 . | |
7196 .TP | |
7197 .B "obmc\ \ \ " | |
7198 overlapped block motion compensation (H.263+) | |
7199 . | |
7200 .TP | |
7201 .B "loop\ \ \ " | |
7202 loop filter (H.263+) | |
7203 note, this is broken | |
7204 . | |
7205 .TP | |
7206 .B inter_threshold <-1000\-1000> | |
7207 Does absolutely nothing at the moment. | |
7208 . | |
7209 .TP | |
7210 .B keyint=<0\-300> | |
7211 maximum interval between keyframes in frames (default: 250 or one | |
7212 keyframe every ten seconds in a 25fps movie. | |
7213 This is the recommended default for MPEG-4). | |
7214 Most codecs require regular keyframes in order to limit the accumulation of mismatch error. | |
7215 Keyframes are also needed for seeking, as seeking is only possible to a keyframe - but | |
7216 keyframes need more space than other frames, so larger numbers here mean | |
7217 slightly smaller files but less precise seeking. | |
7218 0 is equivalent to 1, which makes every frame a keyframe. | |
7219 Values >300 are not recommended as the quality might be bad depending upon | |
7220 decoder, encoder and luck. | |
7221 It is a common for MPEG-1/2 to use values <=30. | |
7222 . | |
7223 .TP | |
7224 .B sc_threshold=<-1000000000\-1000000000> | |
7225 Threshold for scene change detection. | |
7226 A keyframe is inserted by libavcodec when it detects a scene change. | |
7227 You can specify the sensitivity of the detection with this option. | |
7228 -1000000000 means there is a scene change detected at every frame, | |
7229 1000000000 means no scene changes are detected (default: 0). | |
7230 . | |
7231 .TP | |
7232 .B sc_factor=<any positive integer> | |
7233 Causes frames with higher quantizers to be more likely to trigger a | |
7234 scene change detection and make libavcodec use an I-frame (default: 1). | |
7235 1\-16 is a sane range. | |
7236 Values between 2 and 6 may yield increasing PSNR (up to approximately | |
7237 0.04 dB) and better placement of I-frames in high-motion scenes. | |
7238 Higher values than 6 may give very slightly better PSNR (approximately | |
7239 0.01 dB more than sc_factor=6), but noticably worse visual quality. | |
7240 . | |
7241 .TP | |
7242 .B vb_strategy=<0\-2> (pass one only) | |
7243 strategy to choose between I/P/B-frames: | |
7244 .PD 0 | |
7245 .RSs | |
7246 .IPs 0 | |
7247 Always use the maximum number of B-frames (default). | |
7248 .IPs 1 | |
7249 Avoid B-frames in high motion scenes. | |
7250 See the b_sensitivity option to tune this strategy. | |
7251 .IPs 2 | |
7252 Places B-frames more or less optimally to yield maximum quality (slower). | |
7253 You may want to reduce the speed impact of this option by tuning the | |
7254 option brd_scale. | |
7255 .RE | |
7256 .PD 1 | |
7257 . | |
7258 .TP | |
7259 .B b_sensitivity=<any integer greater than 0> | |
7260 Adjusts how sensitively vb_strategy=1 detects motion and avoids using | |
7261 B-frames (default: 40). | |
7262 Lower sensitivities will result in more B-frames. | |
7263 Using more B-frames usually improves PSNR, but too many B-frames can | |
7264 hurt quality in high-motion scenes. | |
7265 Unless there is an extremely high amount of motion, b_sensitivity can | |
7266 safely be lowered below the default; 10 is a reasonable value in most | |
7267 cases. | |
7268 . | |
7269 .TP | |
7270 .B brd_scale=<0\-10> | |
7271 Downscales frames for dynamic B-frame decision (default: 0). | |
7272 Each time brd_scale is increased by one, the frame dimensions are | |
7273 divided by two, which improves speed by a factor of four. | |
7274 Both dimensions of the fully downscaled frame must be even numbers, so | |
7275 brd_scale=1 requires the original dimensions to be multiples of four, | |
7276 brd_scale=2 requires multiples of eight, etc. | |
7277 In other words, the dimensions of the original frame must both be | |
7278 divisible by 2^(brd_scale+1) with no remainder. | |
7279 . | |
7280 .TP | |
7281 .B bidir_refine=<0\-4> | |
7282 Refine the two motion vectors used in bidirectional macroblocks, | |
7283 rather than re-using vectors from the forward and backward searches. | |
7284 This option has no effect without B-frames. | |
7285 .PD 0 | |
7286 .RSs | |
7287 .IPs 0 | |
7288 Disabled (default). | |
7289 .IPs 1\-4 | |
7290 Use a wider search (larger values are slower). | |
7291 .RE | |
7292 .PD 1 | |
7293 . | |
7294 .TP | |
7295 .B vpass=<1\-3> | |
7296 Activates internal two (or more) pass mode, only specify if you wish to | |
7297 use two (or more) pass encoding. | |
7298 .PD 0 | |
7299 .RSs | |
7300 .IPs 1 | |
7301 first pass (also see turbo) | |
7302 .IPs 2 | |
7303 second pass | |
7304 .IPs 3 | |
7305 Nth pass (second and subsequent passes of N-pass encoding) | |
7306 .RE | |
7307 .RS | |
7308 Here is how it works, and how to use it: | |
7309 .br | |
7310 The first pass (vpass=1) writes the statistics file. | |
7311 You might want to deactivate some CPU-hungry options, like "turbo" | |
7312 mode does. | |
7313 .br | |
7314 In two pass mode, the second pass (vpass=2) reads the statistics file and | |
7315 bases ratecontrol decisions on it. | |
7316 .br | |
7317 In N-pass mode, the second pass (vpass=3, that is not a typo) | |
7318 does both: It first reads the statistics, then overwrites them. | |
7319 You might want to backup divx2pass.log before doing this if there is | |
7320 any possibility that you will have to cancel MEncoder. | |
7321 You can use all encoding options, except very CPU-hungry options like "qns". | |
7322 .br | |
7323 You can run this same pass over and over to refine the encode. | |
7324 Each subsequent pass will use the statistics from the previous pass to improve. | |
7325 The final pass can include any CPU-hungry encoding options. | |
7326 .br | |
7327 If you want a 2 pass encode, use first vpass=1, and then vpass=2. | |
7328 .br | |
7329 If you want a 3 or more pass encode, use vpass=1 for the first pass | |
7330 and then vpass=3 and then vpass=3 again and again until you are | |
7331 satisfied with the encode. | |
7332 .RE | |
7333 .PD 1 | |
7334 .sp 1 | |
7335 .RS | |
7336 huffyuv: | |
7337 .RE | |
7338 .PD 0 | |
7339 .RSs | |
7340 .IPs "pass 1" | |
7341 Saves statistics. | |
7342 .IPs "pass 2" | |
7343 Encodes with an optimal Huffman table based upon statistics | |
7344 from the first pass. | |
7345 .RE | |
7346 .PD 1 | |
7347 . | |
7348 .TP | |
7349 .B turbo (two pass only) | |
7350 Dramatically speeds up pass one using faster algorithms and disabling | |
7351 CPU-intensive options. | |
7352 This will probably reduce global PSNR a little bit (around 0.01dB) and | |
7353 change individual frame type and PSNR a little bit more (up to 0.03dB). | |
7354 . | |
7355 .TP | |
7356 .B aspect=<x/y> | |
7357 Store movie aspect internally, just like with MPEG files. | |
7358 Much nicer than rescaling, because quality is not decreased. | |
7359 Only MPlayer will play these files correctly, other players will display | |
7360 them with wrong aspect. | |
7361 The aspect parameter can be given as a ratio or a floating point number. | |
7362 .sp 1 | |
7363 .RS | |
7364 .I EXAMPLE: | |
7365 .RE | |
7366 .RSs | |
7367 .PD 0 | |
7368 .IPs "aspect=16/9 or aspect=1.78" | |
7369 .PD 1 | |
7370 .RE | |
7371 . | |
7372 .TP | |
7373 .B autoaspect | |
7374 Same as the aspect option, but automatically computes aspect, taking | |
7375 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
7376 filter chain. | |
7377 Does not incur a performance penalty, so you can safely leave it | |
7378 always on. | |
7379 . | |
7380 .TP | |
7381 .B vbitrate=<value> | |
7382 Specify bitrate (pass 1/2) (default: 800). | |
7383 .br | |
7384 .I WARNING: | |
7385 1kbit = 1000 bits | |
7386 .PD 0 | |
7387 .RSs | |
7388 .IPs 4\-16000 | |
7389 (in kbit) | |
7390 .IPs 16001\-24000000 | |
7391 (in bit) | |
7392 .RE | |
7393 .PD 1 | |
7394 . | |
7395 .TP | |
7396 .B vratetol=<value> | |
7397 approximated file size tolerance in kbit. | |
7398 1000\-100000 is a sane range. | |
7399 (warning: 1kbit = 1000 bits) | |
7400 (default: 8000) | |
7401 .br | |
7402 .I NOTE: | |
7403 vratetol should not be too large during the second pass or there might | |
7404 be problems if vrc_(min|max)rate is used. | |
7405 . | |
7406 .TP | |
7407 .B vrc_maxrate=<value> | |
7408 maximum bitrate in kbit/\:sec (pass 1/2) | |
7409 (default: 0, unlimited) | |
7410 . | |
7411 .TP | |
7412 .B vrc_minrate=<value> | |
7413 minimum bitrate in kbit/\:sec (pass 1/2) | |
7414 (default: 0, unlimited) | |
7415 . | |
7416 .TP | |
7417 .B vrc_buf_size=<value> | |
7418 buffer size in kbit (pass 1/2). | |
7419 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD, | |
7420 917 for SVCD and 1835 for DVD. | |
7421 . | |
7422 .TP | |
7423 .B vrc_buf_aggressivity | |
7424 currently useless | |
7425 . | |
7426 .TP | |
7427 .B vrc_strategy | |
7428 Ratecontrol method. | |
7429 Note that some of the ratecontrol-affecting options will have no effect | |
7430 if vrc_strategy is not set to 0. | |
7431 .PD 0 | |
7432 .RSs | |
7433 .IPs 0 | |
7434 Use internal lavc ratecontrol (default). | |
7435 .IPs 1 | |
7436 Use XviD ratecontrol (experimental; requires MEncoder to be compiled | |
7437 with support for XviD 1.1 or higher). | |
7438 .RE | |
7439 .PD 1 | |
7440 . | |
7441 .TP | |
7442 .B vb_qfactor=<-31.0\-31.0> | |
7443 quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7444 . | |
7445 .TP | |
7446 .B vi_qfactor=<-31.0\-31.0> | |
7447 quantizer factor between I- and non-I-frames (pass 1/2) (default: 0.8) | |
7448 . | |
7449 .TP | |
7450 .B vb_qoffset=<-31.0\-31.0> | |
7451 quantizer offset between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7452 . | |
7453 .TP | |
7454 .B vi_qoffset=<-31.0\-31.0> | |
7455 (pass 1/2) (default: 0.0) | |
7456 .br | |
7457 if v{b|i}_qfactor > 0 | |
7458 .br | |
7459 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset | |
7460 .br | |
7461 else | |
7462 .br | |
7463 do normal ratecontrol (do not lock to next P-frame quantizer) and | |
7464 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset | |
7465 .br | |
7466 .I HINT: | |
7467 To do constant quantizer encoding with different quantizers for | |
7468 I/P- and B-frames you can use: | |
7469 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>. | |
7470 . | |
7471 .TP | |
7472 .B vqblur=<0.0\-1.0> (pass one) | |
7473 Quantizer blur (default: 0.5), larger values will average the | |
7474 quantizer more over time (slower change). | |
7475 .PD 0 | |
7476 .RSs | |
7477 .IPs 0.0 | |
7478 Quantizer blur disabled. | |
7479 .IPs 1.0 | |
7480 Average the quantizer over all previous frames. | |
7481 .RE | |
7482 .PD 1 | |
7483 . | |
7484 .TP | |
7485 .B vqblur=<0.0\-99.0> (pass two) | |
7486 Quantizer gaussian blur (default: 0.5), larger values will average | |
7487 the quantizer more over time (slower change). | |
7488 . | |
7489 .TP | |
7490 .B vqcomp=<0.0\-1.0> | |
7491 Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5). | |
7492 For instance, assuming the default rate control equation is used, | |
7493 if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits | |
7494 needed to encode them all at the same QP. | |
7495 If vqcomp=0.0, the ratecontrol allocates the same number of bits to each | |
7496 frame, i.e. strict CBR. | |
7497 .I NOTE: | |
7498 Those are extreme settings and should never be used. | |
7499 Perceptual quality will be optimal somewhere in between these two extremes. | |
7500 . | |
7501 .TP | |
7502 .B vrc_eq=<equation> | |
7503 main ratecontrol equation (pass 1/2) | |
7504 .RE | |
7505 .RSs | |
7506 .IPs "1\ \ \ \ " | |
7507 constant bitrate | |
7508 .IPs "tex\ \ " | |
7509 constant quality | |
7510 .IPs 1+(tex/\:avgTex-1)*qComp | |
7511 approximately the equation of the old ratecontrol code | |
7512 .IPs tex^qComp | |
7513 with qcomp 0.5 or something like that (default) | |
7514 .RE | |
7515 .PP | |
7516 .RS | |
7517 infix operators: | |
7518 .RE | |
7519 .RSs | |
7520 .IPs +,-,*,/,^ | |
7521 .RE | |
7522 .PP | |
7523 .RS | |
7524 variables: | |
7525 .RE | |
7526 .RSs | |
7527 .IPs "tex\ \ " | |
7528 texture complexity | |
7529 .IPs iTex,pTex | |
7530 intra, non-intra texture complexity | |
7531 .IPs avgTex | |
7532 average texture complexity | |
7533 .IPs avgIITex | |
7534 average intra texture complexity in I-frames | |
7535 .IPs avgPITex | |
7536 average intra texture complexity in P-frames | |
7537 .IPs avgPPTex | |
7538 average non-intra texture complexity in P-frames | |
7539 .IPs avgBPTex | |
7540 average non-intra texture complexity in B-frames | |
7541 .IPs "mv\ \ \ " | |
7542 bits used for motion vectors | |
7543 .IPs fCode | |
7544 maximum length of motion vector in log2 scale | |
7545 .IPs iCount | |
7546 number of intra macroblocks / number of macroblocks | |
7547 .IPs "var\ \ " | |
7548 spatial complexity | |
7549 .IPs mcVar | |
7550 temporal complexity | |
7551 .IPs qComp | |
7552 qcomp from the command line | |
7553 .IPs "isI, isP, isB" | |
7554 Is 1 if picture type is I/P/B else 0. | |
7555 .IPs "Pi,E\ " | |
7556 See your favorite math book. | |
7557 .RE | |
7558 .PP | |
7559 .RS | |
7560 functions: | |
7561 .RE | |
7562 .RSs | |
7563 .IPs max(a,b),min(a,b) | |
7564 maximum / minimum | |
7565 .IPs gt(a,b) | |
7566 is 1 if a>b, 0 otherwise | |
7567 .IPs lt(a,b) | |
7568 is 1 if a<b, 0 otherwise | |
7569 .IPs eq(a,b) | |
7570 is 1 if a==b, 0 otherwise | |
7571 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs" | |
7572 .RE | |
7573 . | |
7574 .TP | |
7575 .B vrc_override=<options> | |
7576 User specified quality for specific parts (ending, credits, ...) (pass 1/2). | |
7577 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>, | |
7578 <end-frame>, <quality>[/...]]: | |
7579 .PD 0 | |
7580 .RSs | |
7581 .IPs "quality (2\-31)" | |
7582 quantizer | |
7583 .IPs "quality (-500\-0)" | |
7584 quality correction in % | |
7585 .RE | |
7586 .PD 1 | |
7587 . | |
7588 .TP | |
7589 .B vrc_init_cplx=<0\-1000> | |
7590 initial complexity (pass 1) | |
7591 . | |
7592 .TP | |
7593 .B vrc_init_occupancy=<0.0\-1.0> | |
7594 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9) | |
7595 . | |
7596 .TP | |
7597 .B vqsquish=<0|1> | |
7598 Specify how to keep the quantizer between qmin and qmax (pass 1/2). | |
7599 .PD 0 | |
7600 .RSs | |
7601 .IPs 0 | |
7602 Use clipping. | |
7603 .IPs 1 | |
7604 Use a nice differentiable function (default). | |
7605 .RE | |
7606 .PD 1 | |
7607 . | |
7608 .TP | |
7609 .B vlelim=<-1000\-1000> | |
7610 Sets single coefficient elimination threshold for luminance. | |
7611 Negative values will also consider the DC coefficient (should be at least -4 | |
7612 or lower for encoding at quant=1): | |
7613 .PD 0 | |
7614 .RSs | |
7615 .IPs 0 | |
7616 disabled (default) | |
7617 .IPs -4 | |
7618 JVT recommendation | |
7619 .RE | |
7620 .PD 1 | |
7621 . | |
7622 .TP | |
7623 .B vcelim=<-1000\-1000> | |
7624 Sets single coefficient elimination threshold for chrominance. | |
7625 Negative values will also consider the DC coefficient (should be at least -4 | |
7626 or lower for encoding at quant=1): | |
7627 .PD 0 | |
7628 .RSs | |
7629 .IPs 0 | |
7630 disabled (default) | |
7631 .IPs 7 | |
7632 JVT recommendation | |
7633 .RE | |
7634 .PD 1 | |
7635 . | |
7636 .TP | |
7637 .B vstrict=<-2|-1|0|1> | |
7638 strict standard compliance | |
7639 .PD 0 | |
7640 .RSs | |
7641 .IPs 0 | |
7642 disabled | |
7643 .IPs 1 | |
7644 Only recommended if you want to feed the output into the | |
7645 MPEG-4 reference decoder. | |
7646 .IPs -1 | |
7647 Allow libavcodec specific extensions (default). | |
7648 .IPs -2 | |
7649 Enables experimental codecs and features which may not be playable | |
7650 with future MPlayer versions (snow, ffvhuff, ffv1). | |
7651 .RE | |
7652 .PD 1 | |
7653 . | |
7654 .TP | |
7655 .B "vdpart\ " | |
7656 Data partitioning. | |
7657 Adds 2 Bytes per video packet, improves error-resistance when transferring over | |
7658 unreliable channels (e.g.\& streaming over the internet). | |
7659 Each video packet will be encoded in 3 separate partitions: | |
7660 .PD 0 | |
7661 .RSs | |
7662 .IPs "1. MVs" | |
7663 movement | |
7664 .IPs "2. DC coefficients" | |
7665 low res picture | |
7666 .IPs "3. AC coefficients" | |
7667 details | |
7668 .RE | |
7669 .PD 1 | |
7670 .RS | |
7671 MV & DC are most important, loosing them looks far worse than loosing | |
7672 the AC and the 1. & 2. partition. | |
7673 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors | |
7674 will hit the AC partition much more often than the MV & DC partitions. | |
7675 Thus, the picture will look better with partitioning than without, | |
7676 as without partitioning an error will trash AC/\:DC/\:MV equally. | |
7677 .RE | |
7678 . | |
7679 .TP | |
7680 .B vpsize=<0\-10000> (also see vdpart) | |
7681 Video packet size, improves error-resistance. | |
7682 .PD 0 | |
7683 .RSs | |
7684 .IPs "0\ \ \ \ " | |
7685 disabled (default) | |
7686 .IPs 100\-1000 | |
7687 good choice | |
7688 .RE | |
7689 .PD 1 | |
7690 . | |
7691 .TP | |
7692 .B "ss\ \ \ \ \ " | |
7693 slice structured mode for H.263+ | |
7694 . | |
7695 .TP | |
7696 .B "gray\ \ \ " | |
7697 grayscale only encoding (faster) | |
7698 . | |
7699 .TP | |
7700 .B vfdct=<0\-10> | |
7701 DCT algorithm | |
7702 .PD 0 | |
7703 .RSs | |
7704 .IPs 0 | |
7705 Automatically select a good one (default). | |
7706 .IPs 1 | |
7707 fast integer | |
7708 .IPs 2 | |
7709 accurate integer | |
7710 .IPs 3 | |
7711 MMX | |
7712 .IPs 4 | |
7713 mlib | |
7714 .IPs 5 | |
7715 AltiVec | |
7716 .IPs 6 | |
7717 floating point AAN | |
7718 .RE | |
7719 .PD 1 | |
7720 . | |
7721 .TP | |
7722 .B idct=<0\-99> | |
7723 IDCT algorithm | |
7724 .br | |
7725 .I NOTE: | |
7726 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests. | |
7727 .PD 0 | |
7728 .RSs | |
7729 .IPs 0 | |
7730 Automatically select a good one (default). | |
7731 .IPs 1 | |
7732 JPEG reference integer | |
7733 .IPs 2 | |
7734 simple | |
7735 .IPs 3 | |
7736 simplemmx | |
7737 .IPs 4 | |
7738 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100) | |
7739 .IPs 5 | |
7740 ps2 | |
7741 .IPs 6 | |
7742 mlib | |
7743 .IPs 7 | |
7744 arm | |
7745 .IPs 8 | |
7746 AltiVec | |
7747 .IPs 9 | |
7748 sh4 | |
7749 .RE | |
7750 .PD 1 | |
7751 . | |
7752 .TP | |
7753 .B lumi_mask=<0.0\-1.0> | |
7754 Luminance masking is a 'psychosensory' setting that is supposed to | |
7755 make use of the fact that the human eye tends to notice fewer details | |
7756 in very bright parts of the picture. | |
7757 Luminance masking compresses bright areas stronger than medium ones, | |
7758 so it will save bits that can be spent again on other frames, raising | |
7759 overall subjective quality, while possibly reducing PSNR. | |
7760 .br | |
7761 .I WARNING: | |
7762 Be careful, overly large values can cause disastrous things. | |
7763 .br | |
7764 .I WARNING: | |
7765 Large values might look good on some monitors but may look horrible | |
7766 on other monitors. | |
7767 .PD 0 | |
7768 .RSs | |
7769 .IPs "0.0\ \ " | |
7770 disabled (default) | |
7771 .IPs 0.0\-0.3 | |
7772 sane range | |
7773 .RE | |
7774 .PD 1 | |
7775 . | |
7776 .TP | |
7777 .B dark_mask=<0.0\-1.0> | |
7778 Darkness masking is a 'psychosensory' setting that is supposed to | |
7779 make use of the fact that the human eye tends to notice fewer details | |
7780 in very dark parts of the picture. | |
7781 Darkness masking compresses dark areas stronger than medium ones, | |
7782 so it will save bits that can be spent again on other frames, raising | |
7783 overall subjective quality, while possibly reducing PSNR. | |
7784 .br | |
7785 .I WARNING: | |
7786 Be careful, overly large values can cause disastrous things. | |
7787 .br | |
7788 .I WARNING: | |
7789 Large values might look good on some monitors but may look horrible | |
7790 on other monitors / TV / TFT. | |
7791 .PD 0 | |
7792 .RSs | |
7793 .IPs "0.0\ \ " | |
7794 disabled (default) | |
7795 .IPs 0.0\-0.3 | |
7796 sane range | |
7797 .RE | |
7798 .PD 1 | |
7799 . | |
7800 .TP | |
7801 .B tcplx_mask=<0.0\-1.0> | |
7802 Temporal complexity masking (default: 0.0 (disabled)). | |
7803 Imagine a scene with a bird flying across the whole scene; tcplx_mask | |
7804 will raise the quantizers of the bird's macroblocks (thus decreasing their | |
7805 quality), as the human eye usually does not have time to see all the bird's | |
7806 details. | |
7807 Be warned that if the masked object stops (e.g.\& the bird lands) it is | |
7808 likely to look horrible for a short period of time, until the encoder | |
7809 figures out that the object is not moving and needs refined blocks. | |
7810 The saved bits will be spent on other parts of the video, which may increase | |
7811 subjective quality, provided that tcplx_mask is carefully chosen. | |
7812 . | |
7813 .TP | |
7814 .B scplx_mask=<0.0\-1.0> | |
7815 Spatial complexity masking. | |
7816 Larger values help against blockiness, if no deblocking filter is used for | |
7817 decoding, which is maybe not a good idea. | |
7818 .br | |
7819 Imagine a scene with grass (which usually has great spatial complexity), | |
7820 a blue sky and a house; scplx_mask will raise the quantizers of the grass' | |
7821 macroblocks, thus decreasing its quality, in order to spend more bits on | |
7822 the sky and the house. | |
7823 .br | |
7824 .I HINT: | |
7825 Crop any black borders completely as they will reduce the quality | |
7826 of the macroblocks (also applies without scplx_mask). | |
7827 .PD 0 | |
7828 .RSs | |
7829 .IPs "0.0\ \ " | |
7830 disabled (default) | |
7831 .IPs 0.0\-0.5 | |
7832 sane range | |
7833 .RE | |
7834 .PD 1 | |
7835 .sp 1 | |
7836 .RS | |
7837 .I NOTE: | |
7838 This setting does not have the same effect as using a custom matrix that | |
7839 would compress high frequencies harder, as scplx_mask will reduce the | |
7840 quality of P blocks even if only DC is changing. | |
7841 The result of scplx_mask will probably not look as good. | |
7842 .RE | |
7843 . | |
7844 .TP | |
7845 .B p_mask=<0.0\-1.0> (also see vi_qfactor) | |
7846 Reduces the quality of inter blocks. | |
7847 This is equivalent to increasing the quality of intra blocks, because the | |
7848 same average bitrate will be distributed by the rate controller to the | |
7849 whole video sequence (default: 0.0 (disabled)). | |
7850 p_mask=1.0 doubles the bits allocated to each intra block. | |
7851 . | |
7852 .TP | |
7853 .B border_mask=<0.0\-1.0> | |
7854 border-processing for MPEG-style encoders. | |
7855 Border processing increases the quantizer for macroblocks which are less | |
7856 than 1/5th of the frame width/height away from the frame border, | |
7857 since they are often visually less important. | |
7858 . | |
7859 .TP | |
7860 .B "naq\ \ \ \ " | |
7861 Normalize adaptive quantization (experimental). | |
7862 When using adaptive quantization (*_mask), the average per-MB quantizer may no | |
7863 longer match the requested frame-level quantizer. | |
7864 Naq will attempt to adjust the per-MB quantizers to maintain the proper | |
7865 average. | |
7866 . | |
7867 .TP | |
7868 .B "ildct\ \ " | |
7869 Use interlaced DCT. | |
7870 . | |
7871 .TP | |
7872 .B "ilme\ \ \ " | |
7873 Use interlaced motion estimation (mutually exclusive with qpel). | |
7874 . | |
7875 .TP | |
7876 .B "alt\ \ \ \ " | |
7877 Use alternative scantable. | |
7878 . | |
7879 .TP | |
7880 .B "top=<-1\-1>\ \ \ " | |
7881 .PD 0 | |
7882 .RSs | |
7883 .IPs -1 | |
7884 automatic | |
7885 .IPs 0 | |
7886 bottom field first | |
7887 .IPs 1 | |
7888 top field first | |
7889 .RE | |
7890 .PD 1 | |
7891 . | |
7892 .TP | |
7893 .B format=<value> | |
7894 .PD 0 | |
7895 .RSs | |
7896 .IPs "YV12\ " | |
7897 default | |
7898 .IPs "444P\ " | |
7899 for ffv1 | |
7900 .IPs "422P\ " | |
7901 for HuffYUV, lossless JPEG and ffv1 | |
7902 .IPs 411P,YVU9 | |
7903 for lossless JPEG and ffv1 | |
7904 .IPs BGR32 | |
7905 for lossless JPEG and ffv1 | |
7906 .RE | |
7907 .PD 1 | |
7908 . | |
7909 .TP | |
7910 .B "pred\ \ \ " | |
7911 (for HuffYUV) | |
7912 .PD 0 | |
7913 .RSs | |
7914 .IPs 0 | |
7915 left prediction | |
7916 .IPs 1 | |
7917 plane/\:gradient prediction | |
7918 .IPs 2 | |
7919 median prediction | |
7920 .RE | |
7921 .PD 1 | |
7922 . | |
7923 .TP | |
7924 .B "pred\ \ \ " | |
7925 (for lossless JPEG) | |
7926 .PD 0 | |
7927 .RSs | |
7928 .IPs 0 | |
7929 left prediction | |
7930 .IPs 1 | |
7931 top prediction | |
7932 .IPs 2 | |
7933 topleft prediction | |
7934 .IPs 3 | |
7935 plane/\:gradient prediction | |
7936 .IPs 6 | |
7937 mean prediction | |
7938 .RE | |
7939 .PD 1 | |
7940 . | |
7941 .TP | |
7942 .B "coder\ \ " | |
7943 (for ffv1) | |
7944 .PD 0 | |
7945 .RSs | |
7946 .IPs 0 | |
7947 vlc coding (Golomb-Rice) | |
7948 .IPs 1 | |
7949 arithmetic coding (CABAC) | |
7950 .RE | |
7951 .PD 1 | |
7952 . | |
7953 .TP | |
7954 .B context | |
7955 (for ffv1) | |
7956 .PD 0 | |
7957 .RSs | |
7958 .IPs 0 | |
7959 small context model | |
7960 .IPs 1 | |
7961 large context model | |
7962 .RE | |
7963 .PD 1 | |
7964 .sp 1 | |
7965 .RS | |
7966 (for ffvhuff) | |
7967 .RE | |
7968 .PD 0 | |
7969 .RSs | |
7970 .IPs 0 | |
7971 predetermined Huffman tables (builtin or two pass) | |
7972 .IPs 1 | |
7973 adaptive Huffman tables | |
7974 .RE | |
7975 .PD 1 | |
7976 . | |
7977 .TP | |
7978 .B "qpel\ \ \ " | |
7979 Use quarter pel motion compensation (mutually exclusive with ilme). | |
7980 .br | |
7981 .I HINT: | |
7982 This seems only useful for high bitrate encodings. | |
7983 . | |
7984 .TP | |
7985 .B mbcmp=<0\-2000> | |
7986 Sets the comparison function for the macroblock decision, only used if mbd=0. | |
7987 .PD 0 | |
7988 .RSs | |
7989 .IPs "0 (SAD)" | |
7990 sum of absolute differences, fast (default) | |
7991 .IPs "1 (SSE)" | |
7992 sum of squared errors | |
7993 .IPs "2 (SATD)" | |
7994 sum of absolute Hadamard transformed differences | |
7995 .IPs "3 (DCT)" | |
7996 sum of absolute DCT transformed differences | |
7997 .IPs "4 (PSNR)" | |
7998 sum of squared quantization errors (avoid, low quality) | |
7999 .IPs "5 (BIT)" | |
8000 number of bits needed for the block | |
8001 .IPs "6 (RD)" | |
8002 rate distortion optimal, slow | |
8003 .IPs "7 (ZERO)" | |
8004 0 | |
8005 .IPs "8 (VSAD)" | |
8006 sum of absolute vertical differences | |
8007 .IPs "9 (VSSE)" | |
8008 sum of squared vertical differences | |
8009 .IPs "10 (NSSE)" | |
8010 noise preserving sum of squared differences | |
8011 .IPs "11 (W53)" | |
8012 5/3 wavelet, only used in snow | |
8013 .IPs "12 (W97)" | |
8014 9/7 wavelet, only used in snow | |
8015 .IPs "+256\ " | |
8016 Also use chroma, currently does not work (correctly) with B-frames. | |
8017 .RE | |
8018 .PD 1 | |
8019 . | |
8020 .TP | |
8021 .B ildctcmp=<0\-2000> | |
8022 Sets the comparison function for interlaced DCT decision | |
8023 (see mbcmp for available comparison functions). | |
8024 . | |
8025 .TP | |
8026 .B precmp=<0\-2000> | |
8027 Sets the comparison function for motion estimation pre pass | |
8028 (see mbcmp for available comparison functions) (default: 0). | |
8029 . | |
8030 .TP | |
8031 .B cmp=<0\-2000> | |
8032 Sets the comparison function for full pel motion estimation | |
8033 (see mbcmp for available comparison functions) (default: 0). | |
8034 . | |
8035 .TP | |
8036 .B subcmp=<0\-2000> | |
8037 Sets the comparison function for sub pel motion estimation | |
8038 (see mbcmp for available comparison functions) (default: 0). | |
8039 . | |
8040 .TP | |
8041 .B nssew=<0\-1000000> | |
8042 This setting controls NSSE weight, where larger weights will result in | |
8043 more noise. | |
8044 0 NSSE is identical to SSE | |
8045 You may find this useful if you prefer to keep some noise in your encoded | |
8046 video rather than filtering it away before encoding (default: 8). | |
8047 . | |
8048 .TP | |
8049 .B predia=<-99\-6> | |
8050 diamond type and size for motion estimation pre-pass | |
8051 . | |
8052 .TP | |
8053 .B dia=<-99\-6> | |
8054 Diamond type & size for motion estimation. | |
8055 Motion search is an iterative process. | |
8056 Using a small diamond does not limit the search to finding only small | |
8057 motion vectors. | |
8058 It is just somewhat more likely to stop before finding the very best motion | |
8059 vector, especially when noise is involved. | |
8060 Bigger diamonds allow a wider search for the best motion vector, thus are | |
8061 slower but result in better quality. | |
8062 .br | |
8063 Big normal diamonds are better quality than shape-adaptive diamonds. | |
8064 .br | |
8065 Shape-adaptive diamonds are a good tradeoff between speed and quality. | |
8066 .br | |
8067 .I NOTE: | |
8068 The sizes of the normal diamonds and shape adaptive ones do not have | |
8069 the same meaning. | |
8070 .RSs | |
8071 .IPs -3 | |
8072 shape adaptive (fast) diamond with size 3 | |
8073 .IPs -2 | |
8074 shape adaptive (fast) diamond with size 2 | |
8075 .IPs -1 | |
8076 slightly special: Can be slower and/or better than dia=-2. | |
8077 .IPs 1 | |
8078 normal size=1 diamond (default) =EPZS type diamond | |
8079 .nf | |
8080 .ne | |
8081 0 | |
8082 000 | |
8083 0 | |
8084 .fi | |
8085 .IPs 2 | |
8086 normal size=2 diamond | |
8087 .nf | |
8088 .ne | |
8089 0 | |
8090 000 | |
8091 00000 | |
8092 000 | |
8093 0 | |
8094 .fi | |
8095 .RE | |
8096 . | |
8097 .TP | |
8098 .B "trell\ \ " | |
8099 Trellis searched quantization. | |
8100 This will find the optimal encoding for each 8x8 block. | |
8101 Trellis searched quantization is quite simply an optimal quantization in | |
8102 the PSNR versus bitrate sense (Assuming that there would be no rounding | |
8103 errors introduced by the IDCT, which is obviously not the case.). | |
8104 It simply finds a block for the minimum of error and lambda*bits. | |
8105 .PD 0 | |
8106 .RSs | |
8107 .IPs lambda | |
8108 quantization parameter (QP) dependent constant | |
8109 .IPs "bits\ " | |
8110 amount of bits needed to encode the block | |
8111 .IPs error | |
8112 sum of squared errors of the quantization | |
8113 .RE | |
8114 .PD 1 | |
8115 . | |
8116 .TP | |
8117 .B "cbp\ \ \ \ " | |
8118 Rate distorted optimal coded block pattern. | |
8119 Will select the coded block pattern which minimizes distortion + lambda*rate. | |
8120 This can only be used together with trellis quantization. | |
8121 . | |
8122 .TP | |
8123 .B "mv0\ \ \ \ " | |
8124 Try to encode each MB with MV=<0,0> and choose the better one. | |
8125 This has no effect if mbd=0. | |
8126 . | |
8127 .TP | |
8128 .B mv0_threshold=<any non-negative integer> | |
8129 When surrounding motion vectors are <0,0> and the motion estimation | |
8130 score of the current block is less than mv0_threshold, <0,0> is used for | |
8131 the motion vector and further motion estimation is skipped (default: | |
8132 256). | |
8133 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and | |
8134 possibly make the encoded video look slightly better; raising | |
8135 mv0_threshold past 320 results in diminished PSNR and visual quality. | |
8136 Higher values speed up encoding very slightly (usually less than 1%, | |
8137 depending on the other options used). | |
8138 .br | |
8139 .I NOTE: | |
8140 This option does not require mv0 to be enabled. | |
8141 . | |
8142 .TP | |
8143 .B qprd (mbd=2 only) | |
8144 rate distorted optimal quantization parameter (QP) for the given | |
8145 lambda of each macroblock | |
8146 . | |
8147 .TP | |
8148 .B last_pred=<0\-99> | |
8149 amount of motion predictors from the previous frame | |
8150 .PD 0 | |
8151 .RSs | |
8152 .IPs 0 | |
8153 (default) | |
8154 .IPs a | |
8155 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the | |
8156 previous frame. | |
8157 .RE | |
8158 .PD 1 | |
8159 . | |
8160 .TP | |
8161 .B preme=<0\-2> | |
8162 motion estimation pre-pass | |
8163 .PD 0 | |
8164 .RSs | |
8165 .IPs 0 | |
8166 disabled | |
8167 .IPs 1 | |
8168 only after I-frames (default) | |
8169 .IPs 2 | |
8170 always | |
8171 .RE | |
8172 .PD 1 | |
8173 . | |
8174 .TP | |
8175 .B subq=<1\-8> | |
8176 subpel refinement quality (for qpel) (default: 8 (high quality)) | |
8177 .br | |
8178 .I NOTE: | |
8179 This has a significant effect on speed. | |
8180 . | |
8181 .TP | |
8182 .B refs=<1\-8> | |
8183 number of reference frames to consider for motion compensation | |
8184 (Snow only) (default: 1) | |
8185 . | |
8186 .TP | |
8187 .B "psnr\ \ \ " | |
8188 print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8189 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'. | |
8190 Returned values are in dB (decibel), the higher the better. | |
8191 . | |
8192 .TP | |
8193 .B mpeg_quant | |
8194 Use MPEG quantizers instead of H.263. | |
8195 . | |
8196 .TP | |
8197 .B "aic\ \ \ \ " | |
8198 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+. | |
8199 This will improve quality very slightly (around 0.02 dB PSNR) and slow | |
8200 down encoding very slightly (about 1%). | |
8201 .br | |
8202 .I NOTE: | |
8203 vqmin should be 8 or larger for H.263+ AIC. | |
8204 . | |
8205 .TP | |
8206 .B "aiv\ \ \ \ " | |
8207 alternative inter vlc for H.263+ | |
8208 . | |
8209 .TP | |
8210 .B "umv\ \ \ \ " | |
8211 unlimited MVs (H.263+ only) | |
8212 Allows encoding of arbitrarily long MVs. | |
8213 . | |
8214 .TP | |
8215 .B ibias=<-256\-256> | |
8216 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96, | |
8217 H.263 style quantizer default: 0) | |
8218 .br | |
8219 .I NOTE: | |
8220 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8221 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8222 . | |
8223 .TP | |
8224 .B pbias=<-256\-256> | |
8225 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0, | |
8226 H.263 style quantizer default: -64) | |
8227 .br | |
8228 .I NOTE: | |
8229 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8230 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8231 .br | |
8232 .I HINT: | |
8233 A more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR. | |
8234 . | |
8235 .TP | |
8236 .B nr=<0\-100000> | |
8237 Noise reduction, 0 means disabled. | |
8238 0\-600 is a useful range for typical content, but you may want to turn it | |
8239 up a bit more for very noisy content (default: 0). | |
8240 Given its small impact on speed, you might want to prefer to use this over | |
8241 filtering noise away with video filters like denoise3d or hqdn3d. | |
8242 . | |
8243 .TP | |
8244 .B qns=<0\-3> | |
8245 Quantizer noise shaping. | |
8246 Rather than choosing quantization to most closely match the source video | |
8247 in the PSNR sense, it chooses quantization such that noise (usually ringing) | |
8248 will be masked by similar-frequency content in the image. | |
8249 Larger values are slower but may not result in better quality. | |
8250 This can and should be used together with trellis quantization, in which case | |
8251 the trellis quantization (optimal for constant weight) will be used as | |
8252 startpoint for the iterative search. | |
8253 .PD 0 | |
8254 .RSs | |
8255 .IPs 0 | |
8256 disabled (default) | |
8257 .IPs 1 | |
8258 Only lower the absolute value of coefficients. | |
8259 .IPs 2 | |
8260 Only change coefficients before the last non-zero coefficient + 1. | |
8261 .IPs 3 | |
8262 Try all. | |
8263 .RE | |
8264 .PD 1 | |
8265 . | |
8266 .TP | |
8267 .B inter_matrix=<comma separated matrix> | |
8268 Use custom inter matrix. | |
8269 It needs a comma separated string of 64 integers. | |
8270 . | |
8271 .TP | |
8272 .B intra_matrix=<comma separated matrix> | |
8273 Use custom intra matrix. | |
8274 It needs a comma separated string of 64 integers. | |
8275 . | |
8276 .TP | |
8277 .B vqmod_amp | |
8278 experimental quantizer modulation | |
8279 . | |
8280 .TP | |
8281 .B vqmod_freq | |
8282 experimental quantizer modulation | |
8283 . | |
8284 .TP | |
8285 .B "dc\ \ \ \ \ " | |
8286 intra DC precision in bits (default: 8). | |
8287 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11. | |
8288 . | |
8289 .TP | |
8290 .B cgop (also see sc_threshold) | |
8291 Close all GOPs. | |
8292 Currently it only works if scene change detection is disabled | |
8293 (sc_threshold=1000000000). | |
8294 . | |
8295 .TP | |
8296 .B vglobal=<0\-3> | |
8297 Control writing global video headers. | |
8298 .PD 0 | |
8299 .RSs | |
8300 .IPs 0 | |
8301 Codec decides where to write global headers (default). | |
8302 .IPs 1 | |
8303 Write global headers only in extradata (needed for .mp4/MOV/NUT). | |
8304 .IPs 2 | |
8305 Write global headers only in front of keyframes. | |
8306 .IPs 3 | |
8307 Combine 1 and 2. | |
8308 .RE | |
8309 .PD 1 | |
8310 . | |
8311 .TP | |
8312 .B aglobal=<0\-3> | |
8313 Same as vglobal for audio headers. | |
8314 . | |
8315 . | |
8316 .SS nuv (\-nuvopts) | |
8317 . | |
8318 Nuppel video is based on RTJPEG and LZO. | |
8319 By default frames are first encoded with RTJPEG and then compressed with LZO, | |
8320 but it is possible to disable either or both of the two passes. | |
8321 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG, | |
8322 or the default LZO compressed RTJPEG. | |
8323 .br | |
8324 .I NOTE: | |
8325 The nuvrec documentation contains some advice and examples about the | |
8326 settings to use for the most common TV encodings. | |
8327 . | |
8328 .TP | |
8329 .B c=<0\-20> | |
8330 chrominance threshold (default: 1) | |
8331 . | |
8332 .TP | |
8333 .B l=<0\-20> | |
8334 luminance threshold (default: 1) | |
8335 . | |
8336 .TP | |
8337 .B "lzo\ \ \ \ " | |
8338 Enable LZO compression (default). | |
8339 . | |
8340 .TP | |
8341 .B "nolzo\ \ " | |
8342 Disable LZO compression. | |
8343 . | |
8344 .TP | |
8345 .B q=<3\-255> | |
8346 quality level (default: 255) | |
8347 . | |
8348 .TP | |
8349 .B "raw \ \ \ " | |
8350 Disable RTJPEG encoding. | |
8351 . | |
8352 .TP | |
8353 .B "rtjpeg\ " | |
8354 Enable RTJPEG encoding (default). | |
8355 . | |
8356 . | |
8357 .SS xvidenc (\-xvidencopts) | |
8358 . | |
8359 There are three modes available: constant bitrate (CBR), fixed quantizer and | |
8360 two pass. | |
8361 . | |
8362 .TP | |
8363 .B pass=<1|2> | |
8364 Specify the pass in two pass mode. | |
8365 . | |
8366 .TP | |
8367 .B turbo (two pass only) | |
8368 Dramatically speeds up pass one using faster algorithms and disabling | |
8369 CPU-intensive options. | |
8370 This will probably reduce global PSNR a little bit and change individual | |
8371 frame type and PSNR a little bit more. | |
8372 . | |
8373 .TP | |
8374 .B bitrate=<value> (CBR or two pass mode) | |
8375 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second | |
8376 if >16000. | |
8377 If <value> is negative, XviD will use its absolute value as the target size | |
8378 (in kBytes) of the video and compute the associated bitrate automagically | |
8379 (default: 687 kbits/s). | |
8380 . | |
8381 .TP | |
8382 .B fixed_quant=<1\-31> | |
8383 Switch to fixed quantizer mode and specify the quantizer to be used. | |
8384 . | |
8385 .TP | |
8386 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode) | |
8387 User specified quality for specific parts (ending, credits, ...). | |
8388 Each zone is <start-frame>,<mode>,<value> where <mode> may be | |
8389 .PD 0 | |
8390 .RSs | |
8391 .IPs "q" | |
8392 Constant quantizer override, where value=<2.0\-31.0> | |
8393 represents the quantizer value. | |
8394 .IPs "w" | |
8395 Ratecontrol weight override, where value=<0.01\-2.00> | |
8396 represents the quality correction in %. | |
8397 .RE | |
8398 .PD 1 | |
8399 .sp 1 | |
8400 .RS | |
8401 .I EXAMPLE: | |
8402 .RE | |
8403 .PD 0 | |
8404 .RSs | |
8405 .IPs zones=90000,q,20 | |
8406 Encodes all frames starting with frame 90000 at constant quantizer 20. | |
8407 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20 | |
8408 Encode frames 0\-10000 at 10% bitrate, encode frames 90000 | |
8409 up to the end at constant quantizer 20. | |
8410 Note that the second zone is needed to delimit the first zone, as | |
8411 without it everything up until frame 89999 would be encoded at 10% | |
8412 bitrate. | |
8413 .RE | |
8414 .PD 1 | |
8415 . | |
8416 .TP | |
8417 .B me_quality=<0\-6> | |
8418 This option controls the motion estimation subsystem. | |
8419 The higher the value, the more precise the estimation should be (default: 6). | |
8420 The more precise the motion estimation is, the more bits can be saved. | |
8421 Precision is gained at the expense of CPU time so decrease this setting if | |
8422 you need realtime encoding. | |
8423 . | |
8424 .TP | |
8425 .B (no)interlacing | |
8426 Encode the fields of interlaced video material. | |
8427 Turn this option on for interlaced content. | |
8428 .br | |
8429 .I NOTE: | |
8430 Should you rescale the video, you would need an interlace-aware resizer, | |
8431 which you can activate with \-vf scale=<width>:<height>:1. | |
8432 . | |
8433 .TP | |
8434 .B "4mv\ \ \ \ " | |
8435 Use 4 motion vectors per macroblock. | |
8436 This might give better compression, but slows down encoding. | |
8437 .br | |
8438 .I WARNING: | |
8439 As of XviD-1.0.x, this option is no longer available separately, and its | |
8440 functionality is included in the me_quality option. | |
8441 When me_quality > 4, 4mv is activated. | |
8442 . | |
8443 .TP | |
8444 .B rc_reaction_delay_factor=<value> | |
8445 This parameter controls the number of frames the CBR rate controller | |
8446 will wait before reacting to bitrate changes and compensating for them | |
8447 to obtain a constant bitrate over an averaging range of frames. | |
8448 . | |
8449 .TP | |
8450 .B rc_averaging_period=<value> | |
8451 Real CBR is hard to achieve. | |
8452 Depending on the video material, bitrate can be variable, and hard to predict. | |
8453 Therefore XviD uses an averaging period for which it guarantees a given | |
8454 amount of bits (minus a small variation). | |
8455 This settings expresses the "number of frames" for which XviD averages | |
8456 bitrate and tries to achieve CBR. | |
8457 . | |
8458 .TP | |
8459 .B rc_buffer=<value> | |
8460 size of the rate control buffer | |
8461 . | |
8462 .TP | |
8463 .B quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>] | |
8464 CBR mode: min & max quantizer for all frames (default: 2\-31) | |
8465 .br | |
8466 two pass mode: min & max quantizer for I/P-frames (default: 2\-31/\:2\-31) | |
8467 .br | |
8468 .I WARNING: | |
8469 As of XviD-1.0.x, this option is replaced by the | |
8470 [min|max]_[i|p|b]quant options. | |
8471 . | |
8472 .TP | |
8473 .B min_key_interval=<value> (two pass only) | |
8474 minimum interval between keyframes (default: 0) | |
8475 . | |
8476 .TP | |
8477 .B max_key_interval=<value> | |
8478 maximum interval between keyframes (default: 10*fps) | |
8479 . | |
8480 .TP | |
8481 .B mpeg_quant | |
8482 Use MPEG quantizers instead of H.263. | |
8483 For high bitrates, you will find that MPEG quantization preserves more detail. | |
8484 For low bitrates, the smoothing of H.263 will give you less block noise. | |
8485 When using custom matrices, MPEG must be used. | |
8486 .br | |
8487 .I WARNING: | |
8488 As of XviD-1.0.x, this option is replaced by the quant_type option. | |
8489 . | |
8490 .TP | |
8491 .B mod_quant | |
8492 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis | |
8493 (two pass mode only). | |
8494 .br | |
8495 .I WARNING: | |
8496 This will generate an illegal bitstream, and most likely not be decodable | |
8497 by any MPEG-4 decoder besides libavcodec or XviD. | |
8498 .br | |
8499 .I WARNING: | |
8500 As of XviD-1.0.x, this option is no longer available. | |
8501 . | |
8502 .TP | |
8503 .B keyframe_boost=<0\-1000> (two pass mode only) | |
8504 Shift some bits from the pool for other frame types to intra frames, | |
8505 thus improving keyframe quality. | |
8506 This amount is an extra percentage, so a value of 10 will give | |
8507 your keyframes 10% more bits than normal | |
8508 (default: 0). | |
8509 . | |
8510 .TP | |
8511 .B kfthreshold=<value> (two pass mode only) | |
8512 Works together with kfreduction. | |
8513 Determines the minimum distance below which you consider that | |
8514 two frames are considered consecutive and treated differently | |
8515 according to kfreduction | |
8516 (default: 10). | |
8517 . | |
8518 .TP | |
8519 .B kfreduction=<0\-100> (two pass mode only) | |
8520 The above two settings can be used to adjust the size of keyframes that | |
8521 you consider too close to the first (in a row). | |
8522 kfthreshold sets the range in which keyframes are reduced, and | |
8523 kfreduction determines the bitrate reduction they get. | |
8524 The last I-frame will get treated normally | |
8525 (default: 30). | |
8526 . | |
8527 .TP | |
8528 .B divx5bvop | |
8529 Generate DivX5 compatible B-frames (default: on). | |
8530 This seems to be mandatory only for old versions of DivX's decoder. | |
8531 .br | |
8532 .I WARNING: | |
8533 As of XviD-1.0.x, this option is replaced by the closed_gop option. | |
8534 . | |
8535 .TP | |
8536 .B (no)grayscale | |
8537 Make XviD discard chroma planes so the encoded video is grayscale only. | |
8538 Note that this does not speed up encoding, it just prevents chroma data | |
8539 from being written in the last stage of encoding. | |
8540 . | |
8541 .TP | |
8542 .B "debug\ \ " | |
8543 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control | |
8544 file.) | |
8545 .RE | |
8546 . | |
8547 .PP | |
8548 .sp 1 | |
8549 The following options are only available with the latest stable | |
8550 releases of XviD 1.0.x (api4). | |
8551 . | |
8552 .TP | |
8553 .B (no)packed | |
8554 This option is meant to solve frame-order issues when encoding to | |
8555 container formats like AVI that cannot cope with out-of-order frames. | |
8556 In practice, most decoders (both software and hardware) are able to deal | |
8557 with frame-order themselves, and may get confused when this option is | |
8558 turned on, so you can safely leave if off, unless you really know what | |
8559 you are doing. | |
8560 .br | |
8561 .I WARNING: | |
8562 This will generate an illegal bitstream, and will not be | |
8563 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:XviD. | |
8564 .br | |
8565 .I WARNING: | |
8566 This will also store a fake DivX version in the file so the bug | |
8567 autodetection of some decoders might be confused. | |
8568 . | |
8569 .TP | |
8570 .B max_bframes=<0\-4> | |
8571 Maximum number of B-frames to put between I/P-frames (default: 2). | |
8572 . | |
8573 .TP | |
8574 .B bquant_ratio=<0\-1000> | |
8575 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150) | |
8576 . | |
8577 .TP | |
8578 .B bquant_offset=<-1000\-1000> | |
8579 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100) | |
8580 . | |
8581 .TP | |
8582 .B bf_threshold=<-255\-255> | |
8583 This setting allows you to specify what priority to place on the use of | |
8584 B-frames. | |
8585 The higher the value, the higher the probability of B-frames being used | |
8586 (default: 0). | |
8587 Do not forget that B-frames usually have a higher quantizer, and therefore | |
8588 aggressive production of B-frames may cause worse visual quality. | |
8589 . | |
8590 .TP | |
8591 .B (no)closed_gop | |
8592 This option tells XviD to close every GOP (Group Of Pictures bounded | |
8593 by two I-frames), which makes GOPs independent from each other. | |
8594 This just implies that the last frame of the GOP is either a P-frame or a | |
8595 N-frame but not a B-frame. | |
8596 It is usually a good idea to turn this option on (default: on). | |
8597 . | |
8598 .TP | |
8599 .B frame_drop_ratio=<0\-100> (max_bframes=0 only) | |
8600 This setting allows the creation of variable framerate video streams. | |
8601 The value of the setting specifies a threshold under which, if the | |
8602 difference of the following frame to the previous frame is below or equal | |
8603 to this threshold, a frame gets not coded (a so called n-vop is placed | |
8604 in the stream). | |
8605 On playback, when reaching an n-vop the previous frame will be displayed. | |
8606 .br | |
8607 .I WARNING: | |
8608 Playing with this setting may result in a jerky video, so use it at your | |
8609 own risks! | |
8610 . | |
8611 .TP | |
8612 .B (no)qpel | |
8613 MPEG-4 uses a half pixel precision for its motion search by default. | |
8614 The standard proposes a mode where encoders are allowed to use quarter | |
8615 pixel precision. | |
8616 This option usually results in a sharper image. | |
8617 Unfortunately it has a great impact on bitrate and sometimes the | |
8618 higher bitrate use will prevent it from giving a better image | |
8619 quality at a fixed bitrate. | |
8620 It is better to test with and without this option and see whether it | |
8621 is worth activating. | |
8622 . | |
8623 .TP | |
8624 .B (no)gmc | |
8625 Enable Global Motion Compensation, which makes XviD generate special | |
8626 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images. | |
8627 Whether or not the use of this option will save bits is highly | |
8628 dependent on the source material. | |
8629 . | |
8630 .TP | |
8631 .B (no)trellis | |
8632 Trellis Quantization is a kind of adaptive quantization method that | |
8633 saves bits by modifying quantized coefficients to make them more | |
8634 compressible by the entropy encoder. | |
8635 Its impact on quality is good, and if VHQ uses too much CPU for you, | |
8636 this setting can be a good alternative to save a few bits (and gain | |
8637 quality at fixed bitrate) at a lesser cost than with VHQ (default: on). | |
8638 . | |
8639 .TP | |
8640 .B (no)cartoon | |
8641 Activate this if your encoded sequence is an anime/\:cartoon. | |
8642 It modifies some XviD internal thresholds so XviD takes better decisions on | |
8643 frame types and motion vectors for flat looking cartoons. | |
8644 . | |
8645 .TP | |
8646 .B quant_type=<h263|mpeg> | |
8647 Sets the type of quantizer to use. | |
8648 For high bitrates, you will find that MPEG quantization preserves more detail. | |
8649 For low bitrates, the smoothing of H.263 will give you less block noise. | |
8650 When using custom matrices, MPEG quantization | |
8651 .B must | |
8652 be used. | |
8653 . | |
8654 .TP | |
8655 .B (no)chroma_me | |
8656 The usual motion estimation algorithm uses only the luminance information to | |
8657 find the best motion vector. | |
8658 However for some video material, using the chroma planes can help find | |
8659 better vectors. | |
8660 This setting toggles the use of chroma planes for motion estimation | |
8661 (default: on). | |
8662 . | |
8663 .TP | |
8664 .B (no)chroma_opt | |
8665 Enable a chroma optimizer prefilter. | |
8666 It will do some extra magic on color information to minimize the | |
8667 stepped-stairs effect on edges. | |
8668 It will improve quality at the cost of encoding speed. | |
8669 It reduces PSNR by nature, as the mathematical deviation to the original | |
8670 picture will get bigger, but the subjective image quality will raise. | |
8671 Since it works with color information, you might want to turn it off when | |
8672 encoding in grayscale. | |
8673 . | |
8674 .TP | |
8675 .B (no)hq_ac | |
8676 Activates high-quality prediction of AC coefficients for intra frames from | |
8677 neighbor blocks (default: on). | |
8678 . | |
8679 .TP | |
8680 .B vhq=<0\-4> | |
8681 The motion search algorithm is based on a search in the usual color domain | |
8682 and tries to find a motion vector that minimizes the difference between the | |
8683 reference frame and the encoded frame. | |
8684 With this setting activated, XviD will also use the frequency domain (DCT) | |
8685 to search for a motion vector that minimizes not only the spatial | |
8686 difference but also the encoding length of the block. | |
8687 Fastest to slowest: | |
8688 .PD 0 | |
8689 .RSs | |
8690 .IPs 0 | |
8691 off | |
8692 .IPs 1 | |
8693 mode decision (inter/\:intra MB) (default) | |
8694 .IPs 2 | |
8695 limited search | |
8696 .IPs 3 | |
8697 medium search | |
8698 .IPs 4 | |
8699 wide search | |
8700 .RE | |
8701 .PD 1 | |
8702 . | |
8703 .TP | |
8704 .B (no)lumi_mask | |
8705 Adaptive quantization allows the macroblock quantizers to vary inside | |
8706 each frame. | |
8707 This is a 'psychosensory' setting that is supposed to make use of the | |
8708 fact that the human eye tends to notice fewer details in very bright | |
8709 and very dark parts of the picture. | |
8710 It compresses those areas more strongly than medium ones, which will | |
8711 save bits that can be spent again on other frames, raising overall | |
8712 subjective quality and possibly reducing PSNR. | |
8713 . | |
8714 .TP | |
8715 .B min_iquant=<0\-31> | |
8716 minimum I-frame quantizer (default: 2) | |
8717 . | |
8718 .TP | |
8719 .B max_iquant=<0\-31> | |
8720 maximum I-frame quantizer (default: 31) | |
8721 . | |
8722 .TP | |
8723 .B min_pquant=<0\-31> | |
8724 minimum P-frame quantizer (default: 2) | |
8725 . | |
8726 .TP | |
8727 .B max_pquant=<0\-31> | |
8728 maximum P-frame quantizer (default: 31) | |
8729 . | |
8730 .TP | |
8731 .B min_bquant=<0\-31> | |
8732 minimum B-frame quantizer (default: 2) | |
8733 . | |
8734 .TP | |
8735 .B max_bquant=<0\-31> | |
8736 maximum B-frame quantizer (default: 31) | |
8737 . | |
8738 .TP | |
8739 .B quant_intra_matrix=<filename> | |
8740 Load a custom intra matrix file. | |
8741 You can build such a file with xvid4conf's matrix editor. | |
8742 . | |
8743 .TP | |
8744 .B quant_inter_matrix=<filename> | |
8745 Load a custom inter matrix file. | |
8746 You can build such a file with xvid4conf's matrix editor. | |
8747 . | |
8748 .TP | |
8749 .B curve_compression_high=<0\-100> | |
8750 This setting allows XviD to take a certain percentage of bits away from | |
8751 high bitrate scenes and give them back to the bit reservoir. | |
8752 You could also use this if you have a clip with so many bits allocated | |
8753 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad | |
8754 (default: 0). | |
8755 . | |
8756 .TP | |
8757 .B curve_compression_low=<0\-100> | |
8758 This setting allows XviD to give a certain percentage of extra bits to the | |
8759 low bitrate scenes, taking a few bits from the entire clip. | |
8760 This might come in handy if you have a few low-bitrate scenes that are | |
8761 still blocky (default: 0). | |
8762 . | |
8763 .TP | |
8764 .B overflow_control_strength=<0\-100> | |
8765 During pass one of two pass encoding, a scaled bitrate curve is computed. | |
8766 The difference between that expected curve and the result obtained during | |
8767 encoding is called overflow. | |
8768 Obviously, the two pass rate controller tries to compensate for that overflow, | |
8769 distributing it over the next frames. | |
8770 This setting controls how much of the overflow is distributed every time | |
8771 there is a new frame. | |
8772 Low values allow lazy overflow control, big rate bursts are compensated for | |
8773 more slowly (could lead to lack of precision for small clips). | |
8774 Higher values will make changes in bit redistribution more abrupt, possibly | |
8775 too abrupt if you set it too high, creating artifacts (default: 5). | |
8776 .br | |
8777 .I NOTE: | |
8778 This setting impacts quality a lot, play with it carefully! | |
8779 . | |
8780 .TP | |
8781 .B max_overflow_improvement=<0\-100> | |
8782 During the frame bit allocation, overflow control may increase the frame | |
8783 size. | |
8784 This parameter specifies the maximum percentage by which the overflow | |
8785 control is allowed to increase the frame size, compared to the ideal curve | |
8786 allocation | |
8787 (default: 5). | |
8788 . | |
8789 .TP | |
8790 .B max_overflow_degradation=<0\-100> | |
8791 During the frame bit allocation, overflow control may decrease the frame | |
8792 size. | |
8793 This parameter specifies the maximum percentage by which the overflow | |
8794 control is allowed to decrease the frame size, compared to the ideal curve | |
8795 allocation | |
8796 (default: 5). | |
8797 . | |
8798 .TP | |
8799 .B container_frame_overhead=<0...> | |
8800 Specifies a frame average overhead per frame, in bytes. | |
8801 Most of the time users express their target bitrate for video w/o taking | |
8802 care of the video container overhead. | |
8803 This small but (mostly) constant overhead can cause the target file size | |
8804 to be exceeded. | |
8805 XviD allows users to set the amount of overhead per frame the | |
8806 container generates (give only an average per frame). | |
8807 0 has a special meaning, it lets XviD use its own default values | |
8808 (default: 24 \- AVI average overhead). | |
8809 . | |
8810 .TP | |
8811 .B profile=<profile_name> | |
8812 Restricts options and VBV (peak bitrate over a short period) according to | |
8813 the Simple, Advanced Simple and DivX profiles. | |
8814 The resulting videos should be playable on standalone players adhering to these | |
8815 profile specifications. | |
8816 .PD 0 | |
8817 .RSs | |
8818 .IPs unrestricted | |
8819 no restrictions (default) | |
8820 .IPs "sp0\ \ " | |
8821 simple profile at level 0 | |
8822 .IPs "sp1\ \ " | |
8823 simple profile at level 1 | |
8824 .IPs "sp2\ \ " | |
8825 simple profile at level 2 | |
8826 .IPs "sp3\ \ " | |
8827 simple profile at level 3 | |
8828 .IPs "asp0\ " | |
8829 advanced simple profile at level 0 | |
8830 .IPs "asp1\ " | |
8831 advanced simple profile at level 1 | |
8832 .IPs "asp2\ " | |
8833 advanced simple profile at level 2 | |
8834 .IPs "asp3\ " | |
8835 advanced simple profile at level 3 | |
8836 .IPs "asp4\ " | |
8837 advanced simple profile at level 4 | |
8838 .IPs "asp5\ " | |
8839 advanced simple profile at level 5 | |
8840 .IPs dxnhandheld | |
8841 DXN handheld profile | |
8842 .IPs dxnportntsc | |
8843 DXN portable NTSC profile | |
8844 .IPs dxnportpal | |
8845 DXN portable PAL profile | |
8846 .IPs dxnhtntsc | |
8847 DXN home theater NTSC profile | |
8848 .IPs dxnhtpal | |
8849 DXN home theater PAL profile | |
8850 .IPs dxnhdtv | |
8851 DXN HDTV profile | |
8852 .RE | |
8853 .PD 1 | |
8854 .RS | |
8855 .I NOTE: | |
8856 These profiles should be used in conjunction with an appropriate \-ffourcc. | |
8857 Generally DX50 is applicable, as some players do not recognize XviD but | |
8858 most recognize DivX. | |
8859 .RE | |
8860 . | |
8861 .TP | |
8862 .B par=<mode> | |
8863 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR, | |
8864 the Display Aspect Ratio). | |
8865 PAR is the ratio of the width and height of a single pixel. | |
8866 So both are related like this: DAR = PAR * (width/height). | |
8867 .br | |
8868 MPEG-4 defines 5 pixel aspect ratios and one extended | |
8869 one, giving the opportunity to specify a specific pixel aspect | |
8870 ratio. | |
8871 5 standard modes can be specified: | |
8872 .PD 0 | |
8873 .RSs | |
8874 .IPs vga11 | |
8875 It is the usual PAR for PC content. | |
8876 Pixels are a square unit. | |
8877 .IPs pal43 | |
8878 PAL standard 4:3 PAR. | |
8879 Pixels are rectangles. | |
8880 .IPs pal169 | |
8881 same as above | |
8882 .IPs ntsc43 | |
8883 same as above | |
8884 .IPs ntsc169 | |
8885 same as above (Do not forget to give the exact ratio.) | |
8886 .IPs "ext\ \ " | |
8887 Allows you to specify your own pixel aspect ratio with par_width and | |
8888 par_height. | |
8889 .RE | |
8890 .PD 1 | |
8891 .RS | |
8892 .I NOTE: | |
8893 In general, setting aspect and autoaspect options is enough. | |
8894 .RE | |
8895 . | |
8896 .TP | |
8897 .B par_width=<1\-255> (par=ext only) | |
8898 Specifies the width of the custom pixel aspect ratio. | |
8899 . | |
8900 .TP | |
8901 .B par_height=<1\-255> (par=ext only) | |
8902 Specifies the height of the custom pixel aspect ratio. | |
8903 . | |
8904 .TP | |
8905 .B aspect=<x/y | f (float value)> | |
8906 Store movie aspect internally, just like MPEG files. | |
8907 Much nicer solution than rescaling, because quality is not decreased. | |
8908 MPlayer and a few others players will play these files correctly, others | |
8909 will display them with the wrong aspect. | |
8910 The aspect parameter can be given as a ratio or a floating point number. | |
8911 . | |
8912 .TP | |
8913 .B (no)autoaspect | |
8914 Same as the aspect option, but automatically computes aspect, taking | |
8915 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
8916 filter chain. | |
8917 . | |
8918 .TP | |
8919 .B "psnr\ \ \ " | |
8920 Print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8921 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in | |
8922 the current directory. | |
8923 Returned values are in dB (decibel), the higher the better. | |
8924 . | |
8925 .PP | |
8926 .sp 1 | |
8927 The following option is only available in XviD 1.1.x. | |
8928 . | |
8929 .TP | |
8930 .B bvhq=<0|1> | |
8931 This setting allows vector candidates for B-frames to be used for | |
8932 the encoding chosen using a rate distortion optimized operator, | |
8933 which is what is done for P-frames by the vhq option. | |
8934 This produces nicer-looking B-frames while incurring almost no | |
8935 performance penalty (default: 1). | |
8936 . | |
8937 .PP | |
8938 .sp 1 | |
8939 The following option is only available in the CVS version of XviD. | |
8940 . | |
8941 .TP | |
8942 .B threads=<0\-n> | |
8943 Create n threads to run the motion estimation (default: 0). | |
8944 The maximum number of threads that can be used is the picture height | |
8945 divided by 16. | |
8946 . | |
8947 . | |
8948 .SS x264enc (\-x264encopts) | |
8949 . | |
8950 .TP | |
8951 .B bitrate=<value> | |
8952 Sets the average bitrate to be used in kbits/\:second (default: off). | |
8953 Since local bitrate may vary, this average may be inaccurate for | |
8954 very short videos (see ratetol). | |
8955 Constant bitrate can be achieved by combining this with vbv_maxrate, | |
8956 at significant reduction in quality. | |
8957 . | |
8958 .TP | |
8959 .B qp=<0\-51> | |
8960 This selects the quantizer to use for P-frames. | |
8961 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively. | |
8962 20\-40 is a useful range (default: 26). | |
8963 Lower values result in better fidelity, but higher bitrates. | |
8964 0 is lossless. | |
8965 Note that quantization in H.264 works differently from MPEG-1/2/4: | |
8966 H.264's quantization parameter (QP) is on a logarithmic scale. | |
8967 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP). | |
8968 For example, MPEG at QP=2 is equivalent to H.264 at QP=18. | |
8969 . | |
8970 .TP | |
8971 .B crf=<1\-50> | |
8972 Enables constant quality mode, and selects the quality. | |
8973 The scale is similar to QP. | |
8974 Like the bitrate-based modes, this allows each frame to use a | |
8975 different QP based on the frame's complexity. | |
8976 . | |
8977 .TP | |
8978 .B pass=<1\-3> | |
8979 Enable 2 or 3-pass mode. | |
8980 It is recommended to always encode in 2 or 3-pass mode as it leads to a | |
8981 better bit distribution and improves overall quality. | |
8982 .PD 0 | |
8983 .RSs | |
8984 .IPs 1 | |
8985 first pass | |
8986 .IPs 2 | |
8987 second pass (of two pass encoding) | |
8988 .IPs 3 | |
8989 Nth pass (second and third passes of three pass encoding) | |
8990 .RE | |
8991 .RS | |
8992 Here is how it works, and how to use it: | |
8993 .br | |
8994 The first pass (pass=1) collects statistics on the video and writes them | |
8995 to a file. | |
8996 You might want to deactivate some CPU-hungry options, apart from the ones | |
8997 that are on by default. | |
8998 .br | |
8999 In two pass mode, the second pass (pass=2) reads the statistics file and | |
9000 bases ratecontrol decisions on it. | |
9001 .br | |
9002 In three pass mode, the second pass (pass=3, that is not a typo) | |
9003 does both: It first reads the statistics, then overwrites them. | |
9004 You can use all encoding options, except very CPU-hungry options. | |
9005 .br | |
9006 The third pass (pass=3) is the same as the second pass, except that it has | |
9007 the second pass' statistics to work from. | |
9008 You can use all encoding options, including CPU-hungry ones. | |
9009 .br | |
9010 The first pass may use either average bitrate or constant quantizer. | |
9011 ABR is recommended, since it does not require guessing a quantizer. | |
9012 Subsequent passes are ABR, and must specify bitrate. | |
9013 .REss | |
9014 . | |
9015 .TP | |
9016 .B turbo=<0\-2> | |
9017 Fast first pass mode. | |
9018 During the first pass of a two or more pass encode it is possible to gain | |
9019 speed by disabling some options with negligible or even no impact on the | |
9020 final pass output quality. | |
9021 .PD 0 | |
9022 .RSs | |
9023 .IPs 0 | |
9024 disabled (default) | |
9025 .IPs 1 | |
9026 Reduce subq, frameref and disable some inter-macroblock partition analysis | |
9027 modes. | |
9028 .IPs 2 | |
9029 Reduce subq and frameref to 1, use a diamond ME search and disable all | |
9030 partition analysis modes. | |
9031 .RE | |
9032 .RS | |
9033 Level 1 can increase first pass speed up to 2x with no change in the global | |
9034 PSNR of the final pass compared to a full quality first pass. | |
9035 .br | |
9036 Level 2 can increase first pass speed up to 4x with about +/- 0.05dB change | |
9037 in the global PSNR of the final pass compared to a full quality first pass. | |
9038 .REss | |
9039 . | |
9040 .TP | |
9041 .B keyint=<value> | |
9042 Sets maximum interval between IDR-frames (default: 250). | |
9043 Larger values save bits, thus improve quality, at the cost of seeking | |
9044 precision. | |
9045 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large | |
9046 values of keyint. | |
9047 . | |
9048 .TP | |
9049 .B keyint_min=<1\-keyint/2> | |
9050 Sets minimum interval between IDR-frames (default: 25). | |
9051 If scenecuts appear within this interval, they are still encoded as | |
9052 I-frames, but do not start a new GOP. | |
9053 In H.264, I-frames do not necessarily bound a closed GOP because it is | |
9054 allowable for a P-frame to be predicted from more frames than just the one | |
9055 frame before it (also see frameref). | |
9056 Therefore, I-frames are not necessarily seekable. | |
9057 IDR-frames restrict subsequent P-frames from referring to any frame | |
9058 prior to the IDR-frame. | |
9059 . | |
9060 .TP | |
9061 .B scenecut=<-1\-100> | |
9062 Controls how aggressively to insert extra I-frames (default: 40). | |
9063 With small values of scenecut, the codec often has to force an I-frame | |
9064 when it would exceed keyint. | |
9065 Good values of scenecut may find a better location for the I-frame. | |
9066 Large values use more I-frames than necessary, thus wasting bits. | |
9067 -1 disables scene-cut detection, so I-frames are inserted only once | |
9068 every other keyint frames, even if a scene-cut occurs earlier. | |
9069 This is not recommended and wastes bitrate as scenecuts encoded as P-frames | |
9070 are just as big as I-frames, but do not reset the "keyint counter". | |
9071 . | |
9072 .TP | |
9073 .B frameref=<1\-16> | |
9074 Number of previous frames used as predictors in B- and P-frames (default: 1). | |
9075 This is effective in anime, but in live-action material the improvements | |
9076 usually drop off very rapidly above 6 or so reference frames. | |
9077 This has no effect on decoding speed, but does increase the memory needed for | |
9078 decoding. | |
9079 Some decoders can only handle a maximum of 15 reference frames. | |
9080 . | |
9081 .TP | |
9082 .B bframes=<0\-16> | |
9083 maximum number of consecutive B-frames between I- and P-frames (default: 0) | |
9084 . | |
9085 .TP | |
9086 .B (no)b_adapt | |
9087 Automatically decides when to use B-frames and how many, up to the maximum | |
9088 specified above (default: on). | |
9089 If this option is disabled, then the maximum number of B-frames is used. | |
9090 . | |
9091 .TP | |
9092 .B b_bias=<-100\-100> | |
9093 Controls the decision performed by b_adapt. | |
9094 A higher b_bias produces more B-frames (default: 0). | |
9095 . | |
9096 .TP | |
9097 .B (no)b_pyramid | |
9098 Allows B-frames to be used as references for predicting other frames. | |
9099 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4. | |
9100 Without this option, B-frames follow the same pattern as MPEG-[124]. | |
9101 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames | |
9102 are predicted from I0 and P4. | |
9103 With this option, they are coded as I0 P4 B2 B1 B3. | |
9104 B2 is the same as above, but B1 is predicted from I0 and B2, and | |
9105 B3 is predicted from B2 and P4. | |
9106 This usually results in slightly improved compression, at almost no | |
9107 speed cost. | |
9108 However, this is an experimental option: it is not fully tuned and | |
9109 may not always help. | |
9110 Requires bframes >= 2. | |
9111 Disadvantage: increases decoding delay to 2 frames. | |
9112 . | |
9113 .TP | |
9114 .B (no)deblock | |
9115 Use deblocking filter (default: on). | |
9116 As it takes very little time compared to its quality gain, it is not | |
9117 recommended to disable it. | |
9118 . | |
9119 .TP | |
9120 .B deblock=<-6\-6>,<-6\-6> | |
9121 The first parameter is AlphaC0 (default: 0). | |
9122 This adjusts thresholds for the H.264 in-loop deblocking filter. | |
9123 First, this parameter adjusts the maximum amount of change that the filter is | |
9124 allowed to cause on any one pixel. | |
9125 Secondly, this parameter affects the threshold for difference across the | |
9126 edge being filtered. | |
9127 A positive value reduces blocking artifacts more, but will also smear details. | |
9128 .br | |
9129 The second parameter is Beta (default: 0). | |
9130 This affects the detail threshold. | |
9131 Very detailed blocks are not filtered, since the smoothing caused by the | |
9132 filter would be more noticeable than the original blocking. | |
9133 .br | |
9134 The default behavior of the filter almost always achieves optimal quality, | |
9135 so it is best to either leave it alone, or make only small adjustments. | |
9136 However, if your source material already has some blocking or noise which | |
9137 you would like to remove, it may be a good idea to turn it up a little bit. | |
9138 . | |
9139 .TP | |
9140 .B (no)cabac | |
9141 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on). | |
9142 Slightly slows down encoding and decoding, but should save 10-15% bitrate. | |
9143 Unless you are looking for decoding speed, you should not disable it. | |
9144 . | |
9145 .TP | |
9146 .B qp_min=<1\-51> (ABR or two pass) | |
9147 Minimum quantizer, 10\-30 seems to be a useful range (default: 10). | |
9148 . | |
9149 .TP | |
9150 .B qp_max=<1\-51> (ABR or two pass) | |
9151 maximum quantizer (default: 51) | |
9152 . | |
9153 .TP | |
9154 .B qp_step=<1\-50> (ABR or two pass) | |
9155 maximum value by which the quantizer may be incremented/decremented between | |
9156 frames (default: 4) | |
9157 . | |
9158 .TP | |
9159 .B ratetol=<0.1\-100.0> (ABR or two pass) | |
9160 allowed variance in average bitrate (no particular units) (default: 1.0) | |
9161 . | |
9162 .TP | |
9163 .B vbv_maxrate=<value> (ABR or two pass) | |
9164 maximum local bitrate, in kbits/\:second (default: disabled) | |
9165 . | |
9166 .TP | |
9167 .B vbv_bufsize=<value> (ABR or two pass) | |
9168 averaging period for vbv_maxrate, in kbits | |
9169 (default: none, must be specified if vbv_maxrate is enabled) | |
9170 . | |
9171 .TP | |
9172 .B vbv_init=<0.0\-1.0> (ABR or two pass) | |
9173 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9) | |
9174 . | |
9175 .TP | |
9176 .B ip_factor=<value> | |
9177 quantizer factor between I- and P-frames (default: 1.4) | |
9178 . | |
9179 .TP | |
9180 .B pb_factor=<value> | |
9181 quantizer factor between P- and B-frames (default: 1.3) | |
9182 . | |
9183 .TP | |
9184 .B qcomp=<0\-1> (ABR or two pass) | |
9185 quantizer compression (default: 0.6). | |
9186 A lower value makes the bitrate more constant, | |
9187 while a higher value makes the quantization parameter more constant. | |
9188 . | |
9189 .TP | |
9190 .B cplx_blur=<0\-999> (two pass only) | |
9191 Temporal blur of the estimated frame complexity, before curve compression | |
9192 (default: 20). | |
9193 Lower values allow the quantizer value to jump around more, | |
9194 higher values force it to vary more smoothly. | |
9195 cplx_blur ensures that each I-frame has quality comparable to the following | |
9196 P-frames, and ensures that alternating high and low complexity frames | |
9197 (e.g. low fps animation) do not waste bits on fluctuating quantizer. | |
9198 . | |
9199 .TP | |
9200 .B qblur=<0\-99> (two pass only) | |
9201 Temporal blur of the quantization parameter, after curve compression | |
9202 (default: 0.5). | |
9203 Lower values allow the quantizer value to jump around more, | |
9204 higher values force it to vary more smoothly. | |
9205 . | |
9206 .TP | |
9207 .B zones=<zone0>[/<zone1>[/...]] | |
9208 User specified quality for specific parts (ending, credits, ...). | |
9209 Each zone is <start-frame>,<end-frame>,<option> where option may be | |
9210 .PD 0 | |
9211 .RSs | |
9212 .IPs "q=<0\-51>" | |
9213 quantizer | |
9214 .IPs "b=<0.01\-100.0>" | |
9215 bitrate multiplier | |
9216 .RE | |
9217 .PD 1 | |
9218 .RS | |
9219 .I NOTE: | |
9220 The quantizer option is not strictly enforced. | |
9221 It affects only the planning stage of ratecontrol, and is still subject | |
9222 to overflow compensation and qp_min/qp_max. | |
9223 .RE | |
9224 . | |
9225 .TP | |
9226 .B direct_pred=<name> | |
9227 Determines the type of motion prediction used for direct macroblocks | |
9228 in B-frames. | |
9229 .PD 0 | |
9230 .RSs | |
9231 .IPs none | |
9232 Direct macroblocks are not used. | |
9233 .IPs spatial | |
9234 Motion vectors are extrapolated from neighboring blocks. | |
9235 (default) | |
9236 .IPs temporal | |
9237 Motion vectors are interpolated from the following P-frame. | |
9238 .IPs auto | |
9239 The codec selects between spatial and temporal for each frame. | |
9240 .RE | |
9241 .PD 1 | |
9242 .RS | |
9243 Spatial and temporal are approximately the same speed and PSNR, | |
9244 the choice between them depends on the video content. | |
9245 Auto is slightly better, but slower. | |
9246 Auto is most effective when combined with multipass. | |
9247 direct_pred=none is both slower and lower quality. | |
9248 .RE | |
9249 . | |
9250 .TP | |
9251 .B (no)weight_b | |
9252 Use weighted prediction in B-frames. | |
9253 Without this option, bidirectionally predicted macroblocks give | |
9254 equal weight to each reference frame. | |
9255 With this option, the weights are determined by the temporal position | |
9256 of the B-frame relative to the references. | |
9257 Requires bframes > 1. | |
9258 . | |
9259 .TP | |
9260 .B partitions=<list> | |
9261 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4). | |
9262 .PD 0 | |
9263 .RSs | |
9264 .IPs p8x8 | |
9265 Enable types p16x8, p8x16, p8x8. | |
9266 .IPs p4x4 | |
9267 Enable types p8x4, p4x8, p4x4. | |
9268 p4x4 is recommended only with subq >= 5, and only at low resolutions. | |
9269 .IPs b8x8 | |
9270 Enable types b16x8, b8x16, b8x8. | |
9271 .IPs i8x8 | |
9272 Enable type i8x8. | |
9273 i8x8 has no effect unless 8x8dct is enabled. | |
9274 .IPs i4x4 | |
9275 Enable type i4x4. | |
9276 .IPs all | |
9277 Enable all of the above types. | |
9278 .IPs none | |
9279 Disable all of the above types. | |
9280 .RE | |
9281 .PD 1 | |
9282 .RS | |
9283 Regardless of this option, macroblock types p16x16, b16x16, and i16x16 | |
9284 are always enabled. | |
9285 .br | |
9286 The idea is to find the type and size that best describe a certain area | |
9287 of the picture. | |
9288 For example, a global pan is better represented by 16x16 blocks, while | |
9289 small moving objects are better represented by smaller blocks. | |
9290 .RE | |
9291 . | |
9292 .TP | |
9293 .B (no)8x8dct | |
9294 Adaptive spatial transform size: allows macroblocks to choose between | |
9295 4x4 and 8x8 DCT. | |
9296 Also allows the i8x8 macroblock type. | |
9297 Without this option, only 4x4 DCT is used. | |
9298 . | |
9299 .TP | |
9300 .B me=<name> | |
9301 Select fullpixel motion estimation algorithm. | |
9302 .PD 0 | |
9303 .RSs | |
9304 .IPs dia | |
9305 diamond search, radius 1 (fast) | |
9306 .IPs hex | |
9307 hexagon search, radius 2 (default) | |
9308 .IPs umh | |
9309 uneven multi-hexagon search (slow) | |
9310 .IPs esa | |
9311 exhaustive search (very slow, and no better than umh) | |
9312 .RE | |
9313 .PD 1 | |
9314 . | |
9315 .TP | |
9316 .B me_range=<4\-64> | |
9317 radius of exhaustive or multi-hexagon motion search (default: 16) | |
9318 . | |
9319 .TP | |
9320 .B subq=<1\-7> | |
9321 Adjust subpel refinement quality. | |
9322 This parameter controls quality versus speed tradeoffs involved in the motion | |
9323 estimation decision process. | |
9324 subq=5 can compress up to 10% better than subq=1. | |
9325 .PD 0 | |
9326 .RSs | |
9327 .IPs 1 | |
9328 Runs fullpixel precision motion estimation on all candidate | |
9329 macroblock types. | |
9330 Then selects the best type. | |
9331 Then refines the motion of that type to fast quarterpixel precision (fastest). | |
9332 .IPs 2 | |
9333 Runs halfpixel precision motion estimation on all candidate macroblock types. | |
9334 Then selects the best type. | |
9335 Then refines the motion of that type to fast quarterpixel precision. | |
9336 .IPs 3 | |
9337 As 2, but uses a slower quarterpixel refinement. | |
9338 .IPs 4 | |
9339 Runs fast quarterpixel precision motion estimation on all candidate | |
9340 macroblock types. | |
9341 Then selects the best type. | |
9342 Then finishes the quarterpixel refinement for that type. | |
9343 .IPs 5 | |
9344 Runs best quality quarterpixel precision motion estimation on all | |
9345 candidate macroblock types, before selecting the best type (default). | |
9346 .IPs 6 | |
9347 Enables rate-distortion optimization of macroblock types in | |
9348 I- and P-frames. | |
9349 .IPs 7 | |
9350 Enables rate-distortion optimization of motion vectors and intra modes. (best) | |
9351 .RE | |
9352 .PD 1 | |
9353 .RS | |
9354 In the above, "all candidates" does not exactly mean all enabled types: | |
9355 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16. | |
9356 .RE | |
9357 . | |
9358 .TP | |
9359 .B (no)chroma_me | |
9360 Takes into account chroma information during subpixel motion search | |
9361 (default: enabled). | |
9362 Requires subq>=5. | |
9363 . | |
9364 .TP | |
9365 .B (no)mixed_refs | |
9366 Allows each 8x8 or 16x8 motion partition to independently select a | |
9367 reference frame. | |
9368 Without this option, a whole macroblock must use the same reference. | |
9369 Requires frameref>1. | |
9370 . | |
9371 .TP | |
9372 .B (no)brdo | |
9373 Enables rate-distortion optimization of macroblock types in B-frames. | |
9374 Requires subq>=6. | |
9375 . | |
9376 .TP | |
9377 .B (no)bime | |
9378 Refine the two motion vectors used in bidirectional macroblocks, | |
9379 rather than re-using vectors from the forward and backward searches. | |
9380 This option has no effect without B-frames. | |
9381 . | |
9382 .TP | |
9383 .B trellis=<0\-2> | |
9384 rate-distortion optimal quantization | |
9385 .PD 0 | |
9386 .RSs | |
9387 .IPs 0 | |
9388 disabled (default) | |
9389 .IPs 1 | |
9390 enabled only for the final encode | |
9391 .IPs 2 | |
9392 enabled during all mode decisions (slow, requires subq>=6) | |
9393 .RE | |
9394 .PD 1 | |
9395 . | |
9396 .TP | |
9397 .B deadzone_inter=<0\-32> | |
9398 Set the size of the inter luma quantization deadzone for non-trellis | |
9399 quantization (default: 21). | |
9400 . | |
9401 .TP | |
9402 .B deadzone_intra=<0\-32> | |
9403 Set the size of the intra luma quantization deadzone for non-trellis | |
9404 quantization (default: 11). | |
9405 . | |
9406 .TP | |
9407 .B (no)fast_pskip | |
9408 Performs early skip detection in P-frames (default: enabled). | |
9409 This usually improves speed at no cost, but it can sometimes produce | |
9410 artifacts in areas with no details, like sky. | |
9411 . | |
9412 .TP | |
9413 .B (no)dct_decimate | |
9414 Eliminate dct blocks in P-frames containing only a small single coefficient | |
9415 (default: enabled). | |
9416 This will remove some details, so it will save bits that can be spent | |
9417 again on other frames, hopefully raising overall subjective quality. | |
9418 If you are compressing non-anime content with a high target bitrate, you | |
9419 may want to disable this to preserve as much detail as possible. | |
9420 . | |
9421 .TP | |
9422 .B nr=<0\-100000> | |
9423 Noise reduction, 0 means disabled. | |
9424 100\-1000 is a useful range for typical content, but you may want to turn it | |
9425 up a bit more for very noisy content (default: 0). | |
9426 Given its small impact on speed, you might want to prefer to use this over | |
9427 filtering noise away with video filters like denoise3d or hqdn3d. | |
9428 . | |
9429 .TP | |
9430 .B chroma_qp_offset=<-12\-12> | |
9431 Use a different quantizer for chroma as compared to luma. | |
9432 Useful values are in the range <-2\-2> (default: 0). | |
9433 . | |
9434 .TP | |
9435 .B cqm=<flat|jvt|<filename>> | |
9436 Either uses a predefined custom quantization matrix or loads a JM format | |
9437 matrix file. | |
9438 .PD 0 | |
9439 .RSs | |
9440 .IPs "flat\ " | |
9441 Use the predefined flat 16 matrix (default). | |
9442 .IPs "jvt\ \ " | |
9443 Use the predefined JVT matrix. | |
9444 .IPs <filename> | |
9445 Use the provided JM format matrix file. | |
9446 .PD 1 | |
9447 .RE | |
9448 .RS | |
9449 .I NOTE: | |
9450 Windows CMD.EXE users may experience problems with parsing the command line | |
9451 if they attempt to use all the CQM lists. | |
9452 This is due to a command line length limitation. | |
9453 In this case it is recommended the lists be put into a JM format CQM | |
9454 file and loaded as specified above. | |
9455 .RE | |
9456 . | |
9457 .TP | |
9458 .B cqm4iy=<list> (also see cqm) | |
9459 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated | |
9460 values in the 1\-255 range. | |
9461 . | |
9462 .TP | |
9463 .B cqm4ic=<list> (also see cqm) | |
9464 Custom 4x4 intra chrominance matrix, given as a list of 16 comma | |
9465 separated values in the 1\-255 range. | |
9466 . | |
9467 .TP | |
9468 .B cqm4py=<list> (also see cqm) | |
9469 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated | |
9470 values in the 1\-255 range. | |
9471 . | |
9472 .TP | |
9473 .B cqm4pc=<list> (also see cqm) | |
9474 Custom 4x4 inter chrominance matrix, given as a list of 16 comma | |
9475 separated values in the 1\-255 range. | |
9476 . | |
9477 .TP | |
9478 .B cqm8iy=<list> (also see cqm) | |
9479 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated | |
9480 values in the 1\-255 range. | |
9481 . | |
9482 .TP | |
9483 .B cqm8py=<list> (also see cqm) | |
9484 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated | |
9485 values in the 1\-255 range. | |
9486 . | |
9487 .TP | |
9488 .B level_idc=<10\-51> | |
9489 Set the bitstream's level as defined by annex A of the H.264 standard | |
9490 (default: 51 - Level 5.1). | |
9491 This is used for telling the decoder what capabilities it needs to support. | |
9492 Use this parameter only if you know what it means, | |
9493 and you have a need to set it. | |
9494 . | |
9495 .TP | |
9496 .B threads=<1\-4> | |
9497 Split each frame into slices and encode them in parallel (default: 1). | |
9498 Also allows multithreaded decoding if the decoder supports it (lavc does not). | |
9499 This has a slight penalty to compression. | |
9500 Requires that libx264 was compiled with pthread support; if not, this | |
9501 option will produce a warning and enables slices but not multithreading. | |
9502 . | |
9503 .TP | |
9504 .B (no)global_header | |
9505 Causes SPS and PPS to appear only once, at the beginning of the bitstream | |
9506 (default: disabled). | |
9507 Some players, such as the Sony PSP, require the use of this option. | |
9508 The default behavior causes SPS and PPS to repeat prior to each IDR frame. | |
9509 . | |
9510 .TP | |
9511 .B (no)interlaced | |
9512 Treat the video content as interlaced. | |
9513 . | |
9514 .TP | |
9515 .B log=<-1\-3> | |
9516 Adjust the amount of logging info printed to the screen. | |
9517 .PD 0 | |
9518 .RSs | |
9519 .IPs "-1" | |
9520 none | |
9521 .IPs " 0" | |
9522 Print errors only. | |
9523 .IPs " 1" | |
9524 warnings | |
9525 .IPs " 2" | |
9526 PSNR and other analysis statistics when the encode finishes (default) | |
9527 .IPs " 3" | |
9528 PSNR, QP, frametype, size, and other statistics for every frame | |
9529 .RE | |
9530 .PD 1 | |
9531 . | |
9532 .TP | |
9533 .B (no)psnr | |
9534 Print signal-to-noise ratio statistics. | |
9535 .br | |
9536 .I NOTE: | |
9537 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not | |
9538 mathematically sound (they are simply the average of per-frame PSNRs). | |
9539 They are kept only for comparison to the JM reference codec. | |
9540 For all other purposes, please use either the 'Global' PSNR, or the per-frame | |
9541 PSNRs printed by log=3. | |
9542 . | |
9543 .TP | |
9544 .B (no)ssim | |
9545 Print the Structural Similarity Metric results. | |
9546 This is an alternative to PSNR, and may be better correlated with the | |
9547 perceived quality of the compressed video. | |
9548 . | |
9549 .TP | |
9550 .B (no)visualize | |
9551 Enable x264 visualizations during encoding. | |
9552 If the x264 on your system supports it, a new window will be opened during | |
9553 the encoding process, in which x264 will attempt to present an overview of | |
9554 how each frame gets encoded. | |
9555 Each block type on the visualized movie will be colored as follows: | |
9556 .PD 0 | |
9557 .RSs | |
9558 .IPs red/pink | |
9559 intra block | |
9560 .IPs "blue\ " | |
9561 inter block | |
9562 .IPs green | |
9563 skip block | |
9564 .IPs yellow | |
9565 B-block | |
9566 .RE | |
9567 .PD 1 | |
9568 .RS | |
9569 This feature can be considered experimental and subject to change. | |
9570 In particular, it depends on x264 being compiled with visualizations enabled. | |
9571 Note that as of writing this, x264 pauses after encoding and visualizing | |
9572 each frame, waiting for the user to press a key, at which point the next | |
9573 frame will be encoded. | |
9574 .RE | |
9575 . | |
9576 . | |
9577 .SS xvfw (\-xvfwopts) | |
9578 . | |
9579 Encoding with Video for Windows codecs is mostly obsolete unless you wish | |
9580 to encode to some obscure fringe codec. | |
9581 . | |
9582 .TP | |
9583 .B codec=<name> | |
9584 The name of the binary codec file with which to encode. | |
9585 . | |
9586 . | |
9587 .SS MPEG muxer (\-mpegopts) | |
9588 . | |
9589 The MPEG muxer can generate 5 types of streams, each of which has reasonable | |
9590 default parameters that the user can override. | |
9591 Generally, when generating MPEG files, it is advisable to disable | |
9592 MEncoder's frame-skip code (see \-noskip, \-mc as well as the | |
9593 harddup and softskip video filters). | |
9594 .PP | |
9595 .I EXAMPLE: | |
9596 .PD 0 | |
9597 .RSs | |
9598 .IPs format=mpeg2:tsaf:vbitrate=8000 | |
9599 .RE | |
9600 .PD 1 | |
9601 . | |
9602 .TP | |
9603 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd> | |
9604 stream format (default: mpeg2) | |
9605 . | |
9606 .TP | |
9607 .B size=<up to 65535> | |
9608 Pack size in bytes, do not change unless you know exactly what | |
9609 you are doing (default: 2048). | |
9610 . | |
9611 .TP | |
9612 .B muxrate=<int> | |
9613 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s). | |
9614 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'. | |
9615 . | |
9616 .TP | |
9617 .B "tsaf\ \ \ " | |
9618 Sets timestamps on all frames, if possible; recommended when format=dvd. | |
9619 If dvdauthor complains with a message like "..audio sector out of range...", | |
9620 you probably did not enable this option. | |
9621 . | |
9622 .TP | |
9623 .B init_vpts=<100\-700> | |
9624 initial video pts, in milliseconds (default: 200) | |
9625 . | |
9626 .TP | |
9627 .B init_apts=<100\-700> | |
9628 initial audio pts, in milliseconds (default: 200) | |
9629 . | |
9630 .TP | |
9631 .B vdelay=<1\-32760> | |
9632 Initial video delay time, in milliseconds (default: 0), | |
9633 use it if you want to delay video with respect to audio. | |
9634 . | |
9635 .TP | |
9636 .B "drop\ \ \ " | |
9637 When used with init_adelay the muxer drops the part of audio that was | |
9638 anticipated. | |
9639 . | |
9640 .TP | |
9641 .B vwidth, vheight=<1\-4095> | |
9642 Set the video width and height when video is MPEG-1/2. | |
9643 . | |
9644 .TP | |
9645 .B vpswidth, vpsheight=<1\-4095> | |
9646 Set pan and scan video width and height when video is MPEG-2. | |
9647 . | |
9648 .TP | |
9649 .B vaspect=<1 | 4/3 | 16/9 | 221/100> | |
9650 Sets the display aspect ratio for MPEG-2 video. | |
9651 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong. | |
9652 . | |
9653 .TP | |
9654 .B vbitrate=<int> | |
9655 Sets the video bitrate in kbit/s for MPEG-1/2 video. | |
9656 . | |
9657 .TP | |
9658 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 > | |
9659 Sets the framerate for MPEG-1/2 video. | |
9660 This option will be ignored if used with the telecine option. | |
9661 . | |
9662 .TP | |
9663 .B telecine | |
9664 Enables 3:2 pulldown soft telecine mode: The muxer will make the | |
9665 video stream look like it was encoded at 30000/1001 or 30 fps. | |
9666 It only works with MPEG-2 video when the output framerate, | |
9667 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9668 Any other framerate is incompatible with this option. | |
9669 . | |
9670 .TP | |
9671 .B film2pal | |
9672 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer | |
9673 will make the video stream look like it was encoded at 25 fps. | |
9674 It only works with MPEG-2 video when the output framerate, | |
9675 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9676 Any other framerate is incompatible with this option. | |
9677 . | |
9678 . | |
9679 .SS FFmpeg libavformat demuxers (\-lavfdopts) | |
9680 . | |
9681 .TP | |
9682 .B probesize=<value> | |
9683 Maximum amount of data to probe during the detection phase. | |
9684 In the case of MPEG-TS this value identifies the maximum number | |
9685 of TS packets to scan. | |
9686 . | |
9687 . | |
9688 . | |
9689 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf) | |
9690 . | |
9691 .TP | |
9692 .B delay=<value> | |
9693 Currently only meaningful for MPEG[12]: Maximum allowed distance, | |
9694 in seconds, between the reference timer of the output stream (SCR) | |
9695 and the decoding timestamp (DTS) for any stream present | |
9696 (demux to decode delay). | |
9697 Default is 0.7 (as mandated by the standards defined by MPEG). | |
9698 Higher values require larger buffers and must not be used. | |
9699 . | |
9700 .TP | |
9701 .B format=<container_format> | |
9702 Override which container format to mux into | |
9703 (default: autodetect from output file extension). | |
9704 .PD 0 | |
9705 .RSs | |
9706 .IPs "mpg\ \ " | |
9707 MPEG-1 systems and MPEG-2 PS | |
9708 .IPs "asf\ \ " | |
9709 Advanced Streaming Format | |
9710 .IPs "avi\ \ " | |
9711 Audio Video Interleave file | |
9712 .IPs "wav\ \ " | |
9713 Waveform Audio | |
9714 .IPs "swf\ \ " | |
9715 Macromedia Flash | |
9716 .IPs "flv\ \ " | |
9717 Macromedia Flash video files | |
9718 .IPs "rm\ \ \ " | |
9719 RealAudio and RealVideo | |
9720 .IPs "au\ \ \ " | |
9721 SUN AU format | |
9722 .IPs "nut\ \ " | |
9723 NUT open container format (experimental) | |
9724 .IPs "mov\ \ " | |
9725 QuickTime | |
9726 .IPs "mp4\ \ " | |
9727 MPEG-4 format | |
9728 .IPs "dv\ \ \ " | |
9729 Sony Digital Video container | |
9730 .RE | |
9731 .PD 1 | |
9732 .TP | |
9733 .B i_certify_that_my_video_stream_does_not_use_b_frames | |
9734 MEncoder cannot assign correct timestamps when there are | |
9735 B-frames in the video stream, resulting in broken encodes. | |
9736 . | |
9737 .TP | |
9738 .B muxrate=<rate> | |
9739 Минимальный битовый поток мультиплексирования, в бит/с; | |
9740 в данный момент имеет смысл только для MPEG[12]. | |
9741 Иногда уго указание необходимо для избавления от "buffer underflows". | |
9742 . | |
9743 .TP | |
9744 .B packetsize=<size> | |
9745 .\" FIXME better translation | |
9746 Размер, выраженный в байтах, атомарного[unitary] пакета для выбранного формата. | |
9747 При сжатии в MPEG[12] используются следующие значения по-умолчанию: | |
9748 2324 для [S]VCD, 2048 для всех остальных форматов. | |
9749 . | |
9750 .TP | |
9751 .B preload=<distance> | |
9752 На текущий момент имеет смысл только для MPEG[12]: Начальное разница, | |
9753 в секундах, между значением таймера потока вывода (SCR) и временной меткой | |
9754 .\" FIXME better translation | |
9755 декодирования (DTS) для любого существующего потока (задержка декодирования | |
9756 [demux to decode delay]). | |
9757 . | |
9758 . | |
9759 . | |
9760 .\" -------------------------------------------------------------------------- | |
9761 .\" переменные окружения | |
9762 .\" -------------------------------------------------------------------------- | |
9763 . | |
9764 .SH ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ | |
9765 . | |
9766 Существуют некоторые переменные окружения, которые могут использоваться для управления | |
9767 поведением MPlayer И MEncoder. | |
9768 . | |
9769 .TP | |
9770 .B MPLAYER_CHARSET (также смотрите \-msgcharset) | |
9771 Преодразовывать сообщения консоли в указанную кодировку (по-умолчанию: автоопределение). | |
9772 Значение "noconv" означает отсутствие перекодировки. | |
9773 . | |
9774 .TP | |
9775 .B MPLAYER_HOME | |
9776 Каталог, в котором MPlayer ищет настройки пользователя. | |
9777 . | |
9778 .TP | |
9779 .B MPLAYER_VERBOSE (также смотрите \-v и \-msglevel) | |
9780 Указывает начальный уровень подробности сообщений для всех | |
9781 модулей (пл-умолчанию: 0). | |
9782 Отрицательные значения приведет к меньшему количеству сообщений, положительное - | |
9783 к большему. | |
9784 . | |
9785 .SS libaf: | |
9786 . | |
9787 .TP | |
9788 .B LADSPA_PATH | |
9789 Если LADSPA_PATH установлена, производится поиск указанного файла. Если не | |
9790 установлена, вам придется указать полный путь. | |
9791 FIXME: Ою этом также упоминается в разделе ladspa. | |
9792 . | |
9793 .SS libdvdcss: | |
9794 . | |
9795 .TP | |
9796 .B DVDCSS_CACHE | |
9797 Указывает каталог, хранящий ключи роликов. | |
9798 Это ускоряет расшифровку[descrambling] DVD? находящихся в кеше. | |
9799 Каталог DVDCSS_CACHE будет создан, если не существовал, | |
9800 а ткаже подкаталог с названием DVD ролика или даты изготовления. | |
9801 Если DVDCSS_CACHE не установлена или пуста, libdvdcss будет использовать | |
9802 значение по-умолчания, равное "${HOME}/.dvdcss/" под Unix и | |
9803 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" под Win32. | |
9804 Спецальное значение "off" отключает кеширование. | |
9805 . | |
9806 .TP | |
9807 .B DVDCSS_METHOD | |
9808 Устанавливает методы аутентикации и дешифровки, которые | |
9809 libdvdcss будет использовать для чтения шифрованных[scrambled] дисков. | |
9810 Может принимать значения title, key or disc. | |
9811 .PD 0 | |
9812 .RSs | |
9813 .IPs "key\ \ " | |
9814 это метод по-умолчанию. | |
9815 libdvdcss будет использовать набор рассчитанных ключей проигрывателей, | |
9816 чтобы попробовать и получить ключ диска. | |
9817 Это модет не сработать, если устройство не распознает ни один из ключей | |
9818 проигрывателей. | |
9819 .IPs "disc\ " | |
9820 это аварийный метод, когда предыдущий не справился. | |
9821 Вместо использования ключей проигрывателей, libdvdcss взломает ключ | |
9822 диска используя грубый метод взлома. Этот процесс требователен к CPU | |
9823 и требцет 64Мб памяти для хранения временных данных. | |
9824 .IPs title | |
9825 это аварийный метод, если ни один из предыдцщих не сработал. | |
9826 Он никак не связан с обменом клчами с устройством DVD, но вместо этого | |
9827 используеткрипто атаку, для угадыванию ключа ролика. | |
9828 В исключительных случаях и он может завершиться неудачно, по причине | |
9829 нехватки шифрованных данных для осуществления статистической атаки, | |
9830 но, с другой стороны, это единственный способ расшифровать DVD, | |
9831 сохраненный на жестский диск, или с неправильным регионом на RPC2 устройстве. | |
9832 .RE | |
9833 .PD 1 | |
9834 . | |
9835 .TP | |
9836 .B DVDCSS_RAW_DEVICE | |
9837 Указывает "сырое"[raw] устройство для использования. | |
9838 Конкретное использование будет зависеть от вашей оперционной системы, | |
9839 в Linux утилитой для настройки "сырых" устройств является raw(8). | |
9840 Заметьте, что на большинстве операционных систем, использование | |
9841 "сырого" устройства требует хорошо выровненных[highly aligned] буферов: | |
9842 Linux требует выравнивания на 2048 байт (что равняется размеру сектора DVD). | |
9843 . | |
9844 .TP | |
9845 .B DVDCSS_VERBOSE | |
9846 Устанавливает уровень подробности сообщений libdvdcss. | |
9847 .PD 0 | |
9848 .RSs | |
9849 .IPs 0 | |
9850 Вообще не выводить сообщения. | |
9851 .IPs 1 | |
9852 Выводить ошибки в stderr. | |
9853 .IPs 2 | |
9854 Выводить ошибки и сообщения отладки в stderr. | |
9855 .RE | |
9856 .PD 1 | |
9857 . | |
9858 .TP | |
9859 .B DVDREAD_NOKEYS | |
9860 Пропустить получение всех ключей при запуске. | |
9861 В данный момент отключено. | |
9862 . | |
9863 .TP | |
9864 .B HOME | |
9865 FIXME: Описать это. | |
9866 . | |
9867 .SS libao2: | |
9868 . | |
9869 .TP | |
9870 .B AO_SUN_DISABLE_SAMPLE_TIMING | |
9871 FIXME: Описать это. | |
9872 . | |
9873 .TP | |
9874 .B AUDIODEV | |
9875 FIXME: Описать это. | |
9876 . | |
9877 .TP | |
9878 .B AUDIOSERVER | |
9879 Указывает Network Audio System сервер к которому драйвер вывода nat | |
9880 должен присоединиться и транспорт,кторый должен быть использован. | |
9881 Если не установлена, вместо нее используется DISPLAY. | |
9882 Транспорт может быть tcp или unix. | |
9883 Синтаксис: tcp/<некий_хост>:<некий_порт>, <некий_хост>:<номер_экземпляра> | |
9884 или [unix]:<номер_экземпляра>. | |
9885 Основной порт NAS - 8000 и <номер_экземпляра> добавляется к нему. | |
9886 .sp 1 | |
9887 .RS | |
9888 .I EXAMPLES: | |
9889 .RE | |
9890 .PD 0 | |
9891 .RSs | |
9892 .IPs AUDIOSERVER=somehost:0 | |
9893 Присоединение к NAS серверу на somehost, используя опрт и транспорт по-умолчанию. | |
9894 .IPs AUDIOSERVER=tcp/somehost:8000 | |
9895 Присоединение к NAS серверу на somehost, слушающему TCP порт 8000. | |
9896 .IPs AUDIOSERVER=(unix)?:0 | |
9897 Присоединения к NAS серверу, экземпляр 0 на localhost используя unix сокеты. | |
9898 .RE | |
9899 .PD 1 | |
9900 . | |
9901 .TP | |
9902 .B DISPLAY | |
9903 FIXME: Описать это. | |
9904 . | |
9905 .SS vidix: | |
9906 . | |
9907 .TP | |
9908 .B VIDIX_CRT | |
9909 FIXME: Описать это. | |
9910 . | |
9911 .SS osdep: | |
9912 . | |
9913 .TP | |
9914 .B TERM | |
9915 FIXME: Описать это. | |
9916 . | |
9917 .SS libvo: | |
9918 . | |
9919 .TP | |
9920 .B DISPLAY | |
9921 FIXME: Описать это. | |
9922 . | |
9923 .TP | |
9924 .B FRAMEBUFFER | |
9925 FIXME: Описать это. | |
9926 . | |
9927 .TP | |
9928 .B HOME | |
9929 FIXME: Описать это. | |
9930 . | |
9931 .SS libmpdemux: | |
9932 . | |
9933 .TP | |
9934 .B HOME | |
9935 FIXME: Описать это. | |
9936 . | |
9937 .TP | |
9938 .B HOMEPATH | |
9939 FIXME: Описать это. | |
9940 . | |
9941 .TP | |
9942 .B http_proxy | |
9943 FIXME: Описать это. | |
9944 . | |
9945 .TP | |
9946 .B LOGNAME | |
9947 FIXME: Описать это. | |
9948 . | |
9949 .TP | |
9950 .B USERPROFILE | |
9951 FIXME: Описать это. | |
9952 . | |
9953 .SS libmpcodecs: | |
9954 . | |
9955 .TP | |
9956 .B XANIM_MOD_DIR | |
9957 FIXME: Описать это. | |
9958 . | |
9959 .SS GUI: | |
9960 . | |
9961 .TP | |
9962 .B CHARSET | |
9963 FIXME: Описать это. | |
9964 . | |
9965 .TP | |
9966 .B DISPLAY | |
9967 FIXME: Описать это. | |
9968 . | |
9969 .TP | |
9970 .B HOME | |
9971 FIXME: Описать это. | |
9972 . | |
9973 .SS libavformat: | |
9974 . | |
9975 .TP | |
9976 .B AUDIO_FLIP_LEFT | |
9977 FIXME: Описать это. | |
9978 . | |
9979 .TP | |
9980 .B BKTR_DEV | |
9981 FIXME: Описать это. | |
9982 . | |
9983 .TP | |
9984 .B BKTR_FORMAT | |
9985 FIXME: Описать это. | |
9986 . | |
9987 .TP | |
9988 .B BKTR_FREQUENCY | |
9989 FIXME: Описать это. | |
9990 . | |
9991 .TP | |
9992 .B http_proxy | |
9993 FIXME: Описать это. | |
9994 . | |
9995 .TP | |
9996 .B no_proxy | |
9997 FIXME: Описать это. | |
9998 . | |
9999 . | |
10000 . | |
10001 .\" -------------------------------------------------------------------------- | |
10002 .\" Файлы | |
10003 .\" -------------------------------------------------------------------------- | |
10004 . | |
10005 .SH ФАЙЛЫ | |
10006 . | |
10007 .TP | |
10008 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf | |
10009 Общесистемные настройки MPlayer | |
10010 . | |
10011 .TP | |
10012 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf | |
10013 Общесистемные настройки MEncoder | |
10014 . | |
10015 .TP | |
10016 ~/.mplayer/\:config | |
10017 Пользовательские настройки MPlayer | |
10018 . | |
10019 .TP | |
10020 ~/.mplayer/\:mencoder.conf | |
10021 Пользовательские настройки MEncoder | |
10022 . | |
10023 .TP | |
10024 ~/.mplayer/\:input.conf | |
10025 Привязки клавиш (смотрите '\-input keylist' для полного списка) | |
10026 . | |
10027 .TP | |
10028 ~/.mplayer/\:gui.conf | |
10029 Файл настройки GUI | |
10030 . | |
10031 .TP | |
10032 ~/.mplayer/\:gui.pl | |
10033 Список воспроизведения GUI | |
10034 . | |
10035 .TP | |
10036 ~/.mplayer/\:font/ | |
10037 Каталог шрифтов (В нем должен находиться файл font.desc и файлы с расширением .RAW) | |
10038 . | |
10039 .TP | |
10040 ~/.mplayer/\:DVDkeys/ | |
10041 Кэшированные ключи CSS | |
10042 . | |
10043 .TP | |
10044 Предполагая, что проигрывается файл /path/\:to/\:movie.avi, MPlayer ищет | |
10045 файлы с субтитрами в следующем порядке: | |
10046 .RS | |
10047 /path/\:to/\:movie.sub | |
10048 .br | |
10049 ~/.mplayer/\:sub/\:movie.sub | |
10050 .RE | |
10051 .PD 1 | |
10052 . | |
10053 . | |
10054 .\" -------------------------------------------------------------------------- | |
10055 .\" Примеры | |
10056 .\" -------------------------------------------------------------------------- | |
10057 . | |
10058 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MPLAYER | |
10059 . | |
10060 .PP | |
10061 .B Быстрый старт проигрывания DVD: | |
10062 .nf | |
10063 mplayer dvd://1 | |
10064 .fi | |
10065 . | |
10066 .PP | |
10067 .B Проиграть DVD на Японском с Английскими субтитрами: | |
10068 .nf | |
10069 mplayer dvd://1 \-alang ja \-slang en | |
10070 .fi | |
10071 . | |
10072 .PP | |
10073 .B Проиграть только эпизоды 5, 6, 7: | |
10074 .nf | |
10075 mplayer dvd://1 \-chapter 5-7 | |
10076 .fi | |
10077 . | |
10078 .PP | |
10079 .B Проиграть только заголовки 5, 6, 7: | |
10080 .nf | |
10081 mplayer dvd://5-7 | |
10082 .fi | |
10083 . | |
10084 .PP | |
10085 .B Проиграть multiangle DVD: | |
10086 .nf | |
10087 mplayer dvd://1 \-dvdangle 2 | |
10088 .fi | |
10089 . | |
10090 .PP | |
10091 .B Проиграть с другого DVD устройства: | |
10092 .nf | |
10093 mplayer dvd://1 \-dvd-device /dev/\:dvd2 | |
10094 .fi | |
10095 . | |
10096 .PP | |
10097 .B Проиграть DVD видео из папки, содержащей VOB файлы: | |
10098 .nf | |
10099 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/ | |
10100 .fi | |
10101 . | |
10102 .PP | |
10103 .B Копировать DVD заголовок на жесткий диск, сохраняя в файл "title1.vob": | |
10104 .nf | |
10105 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob | |
10106 .fi | |
10107 . | |
10108 .PP | |
10109 .B Поток по HTTP: | |
10110 .nf | |
10111 mplayer http://mplayer.hq/example.avi | |
10112 .fi | |
10113 . | |
10114 .PP | |
10115 .B Поток, используя RTSP: | |
10116 .nf | |
10117 mplayer rtsp://server.example.com/streamName | |
10118 .fi | |
10119 . | |
10120 .PP | |
10121 .B Преобразовать субтитры в формат MPsub: | |
10122 .nf | |
10123 mplayer dummy.avi \-sub source.sub \-dumpmpsub | |
10124 .fi | |
10125 . | |
10126 .PP | |
10127 .B Преобразовать субтитры в формат MPsub без просмотра фильма: | |
10128 .nf | |
10129 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub | |
10130 .fi | |
10131 . | |
10132 .PP | |
10133 .B со входа стандартного V4L: | |
10134 .nf | |
10135 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv | |
10136 .fi | |
10137 . | |
10138 .PP | |
10139 .B Проигрывание на картах Zoran (старый способ, устарел): | |
10140 .nf | |
10141 mplayer \-vo zr \-vf scale=352:288 file.avi | |
10142 .fi | |
10143 . | |
10144 .PP | |
10145 .B Проигрывание на картах Zoran (новый способ): | |
10146 .nf | |
10147 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi | |
10148 .fi | |
10149 . | |
10150 .PP | |
10151 .B Проиграть 6-ти канальный AAC файл на двух колонках: | |
10152 .nf | |
10153 mplayer \-rawaudio format=0xff \-demuxer rawaudio \-af pan=2:.32:.32:.39:.06:.06:.39:.17:-.17:-.17:.17:.33:.33 adts_he-aac160_51.aac | |
10154 .fi | |
10155 .br | |
10156 .\" FIXME correct translation? | |
10157 You might want to play a bit with the pan values (e.g multiply with a value) to | |
10158 increase volume or avoid clipping. | |
10159 . | |
10160 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MENCODER | |
10161 . | |
10162 .PP | |
10163 .B Кодировать DVD заголовок #2, только указанные эпизоды: | |
10164 .nf | |
10165 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10166 .fi | |
10167 . | |
10168 .PP | |
10169 .B Кодировать DVD заголовок #2, масштабируя до 640x480: | |
10170 .nf | |
10171 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10172 .fi | |
10173 . | |
10174 .PP | |
10175 .B кодировать DVD заголовок #2, масштабируя до 512xHHH (сохраняя пропорции): | |
10176 .nf | |
10177 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10178 .fi | |
10179 . | |
10180 .PP | |
10181 .B То же, но с битрейтом установленным в 1800kbit и оптимизированными макроблоками: | |
10182 .nf | |
10183 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800 | |
10184 .fi | |
10185 . | |
10186 .PP | |
10187 .B То же, но с MJPEG сжатием: | |
10188 .nf | |
10189 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 | |
10190 .fi | |
10191 . | |
10192 .PP | |
10193 .B Кодировать все *.jpg файлы в текущем каталоге: | |
10194 .nf | |
10195 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10196 .fi | |
10197 . | |
10198 .PP | |
10199 .B Кодировать с тюнера (указывайте формат при помощи \-vf формат): | |
10200 .nf | |
10201 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw | |
10202 .fi | |
10203 . | |
10204 .PP | |
10205 .B Кодировать из канала (pipe): | |
10206 .nf | |
10207 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \- | |
10208 .fi | |
10209 . | |
10210 . | |
10211 .\" -------------------------------------------------------------------------- | |
10212 .\" Ошибки, авторы, стандартное уведомление | |
10213 .\" -------------------------------------------------------------------------- | |
10214 . | |
10215 .SH ОШИБКИ | |
10216 Не паникуйте. | |
10217 Если вы нашли их, сообщите об этом нам, но предварительно убедитесь, что прочли всю документацию. | |
10218 Также ображайте внимание на смайлики. :) | |
10219 Многие ошибки - результат некорректной настройки программы и использования параметров. | |
10220 Раздел документации, посвященный отправке сообщений об ошибках | |
10221 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:bugreports.html) | |
10222 описывает как создать полезный отчет. | |
10223 . | |
10224 . | |
10225 . | |
10226 .SH АВТОРЫ | |
10227 .\" FIXME contributor!=разработчик | |
10228 MPlayer изначально был написан Arpad Gereoffy. | |
10229 Смотрите файл AUTHORS, чтобы получить список некоторых из множества других разработчиков. | |
10230 .PP | |
10231 MPlayer is (C) 2000\-2006 The MPlayer Team | |
10232 .PP | |
10233 Оригинальная английская версия этого руководства в основном была написана Gabucino, | |
10234 Jonas Jermann и Diego Biurrun. Сейчас она поддерживается Diego Biurrun. | |
10235 Первоначальный перевод осуществлен Владимиром Ворошиловым. | |
10236 Пожалуйста, отсылайте электронные письма об оригинальной странице в список рассылки MPlayer-DOCS. | |
10237 Письма, относящиеся к переводу, отсылайте в MPlayer-translations. | |
10238 .\" end of file |