20707
|
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
|
20768
|
5 .\" synced with r20774
|
20707
|
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.
|
20768
|
1418 Вы можете увидеть допустимый диапазон частот, запустив MPlayer
|
|
1419 с опцией '\-v'.
|
20707
|
1420 Для запуска подсистемы захвата,
|
|
1421 используйте 'radio://<частота или канал>/capture'.
|
|
1422 Если не указано ключевое слово capture, вы можете слушать радио только
|
|
1423 при помоши line-in кабеля. Использование capture для прослушивания не
|
|
1424 рекомендуется в связи с проблемами синхронизации, которые
|
|
1425 делают прослушивание некомфортным.
|
|
1426 .sp 1
|
|
1427 Доступные опции:
|
|
1428 .RSs
|
|
1429 .IPs device=<значение>
|
|
1430 Уиспользуемое устройство радио (по-умолчанию: /dev/radio0).
|
|
1431 .IPs driver=<значение>
|
|
1432 Используемый радио драйвер (пл-умолчанию: v4l2 если доступно, иначе v4l).
|
|
1433 В данный момент поддерживаются драйверы v4l и v4l2.
|
|
1434 .IPs volume=<0..100>
|
|
1435 Уровень звука для радио (по-умолчанию: 100)
|
|
1436 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
|
|
1437 Устанавливает список каналов.
|
|
1438 Используйте _ вместо пробелов в именах (или играйтесь с экранированием ;-).
|
|
1439 Имена каналов будут выводиться при помощи OSD, и для управления с пульта
|
|
1440 будут доступны команды radio_step_channel и radio_set_channel (смотрите LIRC).
|
|
1441 Если эта опция указана, то число в URL будет означать позицию канала в списке.
|
|
1442 .br
|
|
1443 .I ПРИМЕР:
|
|
1444 radio://1, radio://104.4, radio_set_channel 1
|
|
1445 .IPs adevice=<значение> (с включенной поддержкой захвата с радио)
|
|
1446 Название устройства, с которого будет производиться захват.
|
|
1447 Без его указания захват будет отключен, даже если в URL указано слово capture.
|
|
1448 Для ALSA устройств указывайте его в виде hw=<карта>.<устройство>.
|
|
1449 Если название устройства содержит '=', то для захвата модуль будет
|
|
1450 использовать ALSA, иначе OSS.
|
|
1451 .IPs arate=<значение> (с включенной поддержкой захвата с радио)
|
|
1452 Частота в сэмплах в секунду (по-умолчанию: 44100).
|
|
1453 .br
|
|
1454 .I ЗАМЕЧАНИЕ:
|
|
1455 При использовании захвата звука, установите также опцию
|
|
1456 \-rawaudio rate=<значение> с таким же значением, как у arate.
|
|
1457 Если у вас проблемы со скоростью звука (слишком быстрый), попробуйте
|
|
1458 поиграть с разными значениями arate (например, 48000,44100,32000,...).
|
|
1459 .IPs achannels=<значение> (с включенной поддержкой захвата с радио)
|
|
1460 Количество аудио каналов для захвата.
|
|
1461 .RE
|
|
1462 .
|
|
1463 .TP
|
|
1464 .B \-rawaudio <опция1:опция2:...>
|
|
1465 Эта опция позполяет проигрывать сырые аудио файлы.
|
|
1466 Вам придется также указать \-demuxer rawaudio.
|
|
1467 Ее еще можно использовать для воспроизведения аудио CD, отличных от 44кГц 16-бит стерео.
|
|
1468 Для воспроизведения сырых AC3 потоков используйте \-rawaudio format=0x2000 \-demuxer rawaudio.
|
|
1469 .sp 1
|
|
1470 Доступные опции:
|
|
1471 .sp 1
|
|
1472 .PD 0
|
|
1473 .RSs
|
|
1474 .IPs channels=<значение>
|
|
1475 количество каналов
|
|
1476 .IPs rate=<значение>
|
|
1477 частота в сэмплах в секунду
|
|
1478 .IPs samplesize=<значение>
|
|
1479 размер сэмпла в байтах
|
|
1480 .IPs bitrate=<значение>
|
|
1481 битпоток для rawaudio файлов
|
|
1482 .IPs format=<значение>
|
|
1483 fourcc в шестнадцатеричном формате
|
|
1484 .RE
|
|
1485 .PD 1
|
|
1486 .
|
|
1487 .TP
|
|
1488 .B \-rawvideo <опция1:опция2:...>
|
|
1489 Эта опция позволяет воспроизводить сырые видео файлы.
|
|
1490 Вам придется также указать \-demuxer rawaudio.
|
|
1491 .sp 1
|
|
1492 Доступные опции:
|
|
1493 .sp 1
|
|
1494 .PD 0
|
|
1495 .RSs
|
|
1496 .IPs fps=<значение>
|
|
1497 частота в кадрах в секунду (по-умолчанию: 25.0)
|
|
1498 .IPs sqcif|qcif|cif|4cif|pal|ntsc
|
|
1499 устанавливает стандартный размер изображения
|
|
1500 .IPs w=<значение>
|
|
1501 ширина изоражения в пикселах
|
|
1502 .IPs h=<value>
|
|
1503 высота изображения в пикселах
|
|
1504 .IPs i420|yv12|yuy2|y8
|
|
1505 устанавливает пространство цветов
|
|
1506 .IPs format=<значение>
|
|
1507 цветовое пространство (fourcc) в шестнадцатеричном формате
|
|
1508 .IPs size=<значение>
|
|
1509 размер кадра в байтах
|
|
1510 .REss
|
|
1511 .sp 1
|
|
1512 .RS
|
|
1513 .I ПРИМЕР:
|
|
1514 .RE
|
|
1515 .PD 0
|
|
1516 .RSs
|
|
1517 .IPs "mplayer foreman.qcif \-demuxer rawvideo -rawvideo qcif"
|
|
1518 Проигрывает известный фильм "foreman".
|
|
1519 .IPs "mplayer sample-720x576.yuv \-demuxer rawvideo \-rawvideo w=720:h=576"
|
|
1520 Проигрывает сырой YUV фильм.
|
|
1521 .RE
|
|
1522 .PD 1
|
|
1523 .
|
|
1524 .TP
|
|
1525 .B \-rtsp-port
|
|
1526 Используется с 'rtsp://' URL для назначения номера порта на клиенте.
|
|
1527 Опция может быть полезна, если вы находитесь за маршрутизатором и хотите
|
|
1528 направлять RTSP поток с сервера определенному клиенту.
|
|
1529 .
|
|
1530 .TP
|
|
1531 .B \-rtsp-destination
|
|
1532 Используется с rtsp://' URL для привязки к указанному IP адресу назначения.
|
|
1533 Опция может быть полезна с некоторыми RTSP серверами, не отправляющими
|
|
1534 RTP пакеты на нужный интерфейс. Если невозможно установить соединение
|
|
1535 с RTSP сервером, используйте опцию \-v, чтобы определить,
|
|
1536 к какому IP адресу пытается привязаться MPlayer, и попытайтесь назначить
|
|
1537 вместо него один из назначенных вашему компьютеру.
|
|
1538 .
|
|
1539 .TP
|
|
1540 .B \-rtsp-stream-over-tcp (только LIVE555)
|
|
1541 Используется с'rtsp://' URL для указания, что в результате входящие RTP и RTCP
|
|
1542 пакеты должны передаваться по TCP (используя то же TCP соединение, что и RTSP).
|
|
1543 Опция может быть полезна, если у вас сбоящее интернет соединение,
|
|
1544 не пропускающее входящие UDP пакеты (смотрите http://www.live555.com/\:mplayer/).
|
|
1545 .
|
|
1546 .TP
|
|
1547 .B \-saveidx <файл>
|
|
1548 Принудительно перестраивает индекс и сохраняет его в <файл>.
|
|
1549 В данный момент это работает только с AVI файлами.
|
|
1550 .br
|
|
1551 .I ЗАМЕЧАНИЕ:
|
|
1552 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML.
|
|
1553 .
|
|
1554 .TP
|
|
1555 .B \-sb <байтовая позиция> (смотрите также \-ss)
|
|
1556 Перемещается к байтовой позиции.
|
|
1557 Полезно для воспроизведения с образов CD-ROM или VOB файлов с мусором в начале.
|
|
1558 .
|
|
1559 .TP
|
|
1560 .B \-speed <0.01\-100>
|
|
1561 Уменьшает или увеличивает скорость воспроизведения в указанное количество раз.
|
|
1562 Не гарантируется правильная работа с \-oac copy.
|
|
1563 .
|
|
1564 .TP
|
|
1565 .B \-srate <Гц>
|
|
1566 Выбирает используемую выходную частоту семплов
|
|
1567 (конечно, звуковые карты имеют на нее ограничения).
|
|
1568 Если выбранная частота сэмплов отличается от текущего медиа, то для компенсации
|
|
1569 различий в слой звуковых фильтров будет автоматически добавлен звуковой
|
|
1570 фильтр resample или lavcresample.
|
|
1571 Тип ресэмплирования может быть указан опцией \-af-adv.
|
|
1572 По-цмолчанию, используется быстрое преобразование, что может
|
|
1573 привести к искажениям.
|
|
1574 .
|
|
1575 .TP
|
|
1576 .B \-ss <time> (also see \-sb)
|
|
1577 Перемещение в указаную временную позицию.
|
|
1578 .sp 1
|
|
1579 .I ПРИМЕР:
|
|
1580 .PD 0
|
|
1581 .RSs
|
|
1582 .IPs "\-ss 56"
|
|
1583 Перемещается к позиции 56 секунд.
|
|
1584 .IPs "\-ss 01:10:00"
|
|
1585 Перемещается в позицию 1 час 10 мин.
|
|
1586 .RE
|
|
1587 .PD 1
|
|
1588 .
|
|
1589 .TP
|
|
1590 .B \-tskeepbroken
|
|
1591 Указывает MPlayer не отбрасывать TS пакеты в потоке, определенные как испорченные.
|
|
1592 Иногда требуется для воспроизведения испорченных MPEG-TS файлов.
|
|
1593 .
|
|
1594 .TP
|
|
1595 .B \-tsprobe <байтовая позиция>
|
|
1596 При воспроизведении MPEG-TS потока, эта опция позволяет указать, в пределах какого
|
|
1597 количества байт в потоке MPlayer должен искать желаемые аудио и видео ID.
|
|
1598 .
|
|
1599 .TP
|
|
1600 .B \-tsprog <1\-65534>
|
|
1601 При воспроизведении MPEG-TS потока, этой опцией можно указать какую
|
|
1602 программу (если присутствует) вы хотите воспроизвести.
|
|
1603 Может использоваться с \-vid и \-aid.
|
|
1604 .
|
|
1605 .TP
|
|
1606 .B \-tv <опция1:опция2:...> (только TV/\:PVR)
|
|
1607 Эта опция настраивает различные свойства модуля TV захвата.
|
|
1608 Для просмотра TV с MPlayer, используйте 'tv://' или 'tv://<номер_канала>'
|
|
1609 или даже 'tv://<название_канала> (смотрите ниже опцию channels для подробностей о
|
|
1610 параметре название_канала) в качестве URL.
|
|
1611 .sp 1
|
|
1612 Доступные опции:
|
|
1613 .RSs
|
|
1614 .IPs noaudio
|
|
1615 без звука
|
|
1616 .IPs driver=<значение>
|
|
1617 доступны: dummy, v4l, v4l2, bsdbt848
|
|
1618 .IPs device=<значение>
|
|
1619 Указывает устройство TV (по-умолчанию: /dev/\:video0).
|
|
1620 .IPs input=<значение>
|
|
1621 Указывает источник (по-умолчанию: 0 (TV), смотрите консольный вывод для определения доступных
|
|
1622 источников).
|
|
1623 .IPs freq=<значение>
|
|
1624 Указывает частоту, на которую необходимо настроиться (например 511.250).
|
|
1625 Не совместимо с параметром channels.
|
|
1626 .IPs outfmt=<значение>
|
|
1627 Устанавливает формат вывода с тюнера в одно из предустановленных значений,
|
|
1628 поддерживаемых драйвером V4L (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) или в
|
|
1629 произвольный формат, заданный шестнадцатеричным значением.
|
|
1630 Попробуйте outfmt=help, чтобы получить список доступных форматов.
|
|
1631 .IPs width=<значение>
|
|
1632 Ширина окна вывода
|
|
1633 .IPs height=<значение>
|
|
1634 Высота окна вывода
|
|
1635 .IPs fps=<значение>
|
|
1636 Частота кодров с которой захватывается видео (кадров в секунду)
|
|
1637 .IPs buffersize=<значение>
|
|
1638 Максимальный размер буфера захвата в мегабайтах (по-умолчанию: динамический)
|
|
1639 .IPs norm=<значение>
|
|
1640 Для bsdbt848 и v4l доступны PAL, SECAM, NTSC.
|
|
1641 Для v4l2 смотрите консольный вывод для получения списка доступных стандартов.
|
|
1642 можете также посмотреть опицю normid ниже.
|
|
1643 .IPs "normid=<значение> (только v4l2)"
|
|
1644 Устанавливает TV стандарт в указанное числовое ID.
|
|
1645 TV стандарт зависит от карты захвата.
|
|
1646 Смотрите консольный вывод для получения списка доступных TV стандартов.
|
|
1647 .IPs channel=<значение>
|
|
1648 Переключает тюнер на <значение> канал.
|
|
1649 .IPs chanlist=<значение>
|
|
1650 Доступны: europe-east, europe-west, us-bcast, us-cable, другие
|
|
1651 .IPs channels=<канал>\-<название>,<канал>\-<название>,...
|
|
1652 Устанавливает названия для каналов.
|
|
1653 Используйте _ вместо пробелов в названиях (или поиграйте с экранированием ;-).
|
|
1654 Названия каналов будут выводиться при помощи OSD, и станут доступными
|
|
1655 команды tv_step_channel, tv_set_channel и tv_last_channel, полезные для
|
|
1656 управления с пульта (смотрите LIRC).
|
|
1657 Не совместима с параметром frequency.
|
|
1658 .br
|
|
1659 .I ЗАМЕЧАНИЕ:
|
|
1660 После этого номер канала будет являться позицией в списке 'channels',
|
|
1661 начиная с 1.
|
|
1662 .br
|
|
1663 .I ПРИМЕР:
|
|
1664 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
|
|
1665 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
|
|
1666 Устанавливает эквалайзер изображения на карте.
|
|
1667 .IPs audiorate=<значение>
|
|
1668 Устанавливает аудио битпоток.
|
|
1669 .IPs forceaudio
|
|
1670 Указывает захватывать звук даже если v4l сообщает, что нет источников звука.
|
|
1671 .IPs "alsa\ "
|
|
1672 Захват через ALSA.
|
|
1673 .IPs amode=<0\-3>
|
|
1674 Выбирает аудио режим:
|
|
1675 .RSss
|
|
1676 0: моно
|
|
1677 .br
|
|
1678 1: стерео
|
|
1679 .br
|
|
1680 2: язык 1
|
|
1681 .br
|
|
1682 3: язык 2
|
|
1683 .REss
|
|
1684 .IPs forcechan=<1\-2>
|
|
1685 По-умолчанию, количество записываемых аудио каналов определяется автоматически,
|
|
1686 запрашивая режим аудио у TV карты.
|
|
1687 Эта опция позволяет принудительно назначить стерео/\:моно запись независимо
|
|
1688 от опции amode и значений, возвращаемых v4l.
|
|
1689 Это может быть использовано для решения проблем, в случае когда TV карта не
|
|
1690 способна указать текущий аудио режим.
|
|
1691 .IPs adevice=<значение>
|
|
1692 Устанавливает аудио устройство.
|
|
1693 <значение> должно быть /dev/\:xxx для OSS и аппаратный ID для ALSA.
|
|
1694 Вы должны заменить любые ':' на '.' в ID для ALSA.
|
|
1695 .IPs audioid=<значение>
|
|
1696 Выбирает выход звука карты захвата, если их более одного.
|
|
1697 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
|
|
1698 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
|
|
1699 Эти опции устанавливают параметры микшера на карте видео захвата.
|
|
1700 Они не имеют эффекта, если на карте такового нет.
|
|
1701 Для v4l2, 50 означает элемент управления по-умолчанию, как указано
|
|
1702 драйвером.
|
|
1703 .IPs immediatemode=<логическое>
|
|
1704 Значение 0 означает совместный захват и буферизацию звука и видео
|
|
1705 (по-умолчанию для MEncoder).
|
|
1706 Значение 1 (по-умолчанию для MPlayer) означает захват только видео и прохождение
|
|
1707 звука через кабель от TV карты к звуковой.
|
|
1708 .IPs mjpeg
|
|
1709 Используется аппаратное MJPEG сжатие (если карта его поддерживает).
|
|
1710 При использовании этой опции, вам не требуется указывать ширину и высоту
|
|
1711 окна вывода, потому что MPlayer определит их автоматически по
|
|
1712 значению decimation (смотрите ниже).
|
|
1713 .IPs decimation=<1|2|4>
|
|
1714 выбирает размер картинки, сжимаемой аппаратным MJPEG кодером:
|
|
1715 .RSss
|
|
1716 1: full size
|
|
1717 704x576 PAL
|
|
1718 704x480 NTSC
|
|
1719 .br
|
|
1720 2: medium size
|
|
1721 352x288 PAL
|
|
1722 352x240 NTSC
|
|
1723 .br
|
|
1724 4: small size
|
|
1725 176x144 PAL
|
|
1726 176x120 NTSC
|
|
1727 .REss
|
|
1728 .IPs quality=<0\-100>
|
|
1729 Выбирает качество JPEG сжатия
|
|
1730 (для полного размера рекомендуется < 60).
|
|
1731 .RE
|
|
1732 .
|
|
1733 .TP
|
|
1734 .B \-user <имя пользователя> (смотрите также \-passwd) (только сеть)
|
|
1735 Указывает имя пользователя для HTTP аутентификации.
|
|
1736 .
|
|
1737 .TP
|
|
1738 .B \-user-agent <строка>
|
|
1739 Используется <строка> в качестве значения user agent для потоков HTTP.
|
|
1740 .
|
|
1741 .TP
|
|
1742 .B \-vid <ID>
|
|
1743 Выбирает видео канал (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
|
|
1744 При воспроизведении потока MPEG-TS, MPlayer/\:MEncoder будет использовать
|
|
1745 первую программу (если присутствует) с указанным видео потоком.
|
|
1746 .
|
|
1747 .TP
|
|
1748 .B \-vivo <под-опции> (КОД ОТЛАДКИ)
|
|
1749 Принудительно устанавливает параметры звука для VIVO демуксера (для отладочных целей).
|
|
1750 .
|
|
1751 .
|
|
1752 .
|
|
1753 .SH "ОПЦИИ OSD/СУБТИТРОВ"
|
|
1754 .I ЗАМЕЧАНИЕ:
|
|
1755 Смотрите также \-vf expand.
|
|
1756 .
|
|
1757 .TP
|
|
1758 .B \-ass (только FreeType)
|
|
1759 Включает SSA/ASS рендеринг субтиров.
|
|
1760 С этой опцией для внешних субтитров SSA/ASS и дорожек Matroska будет использоваться
|
|
1761 libass. Смотрите также \-embeddedfonts.
|
|
1762 .
|
|
1763 .TP
|
|
1764 .B \-ass-border-color <значение>
|
|
1765 Устанавливает цвет границы (обрамления) для текста субтитров.
|
|
1766 Формат цвета: RRGGBBAA.
|
|
1767 .
|
|
1768 .TP
|
|
1769 .B \-ass-bottom-margin <значение>
|
|
1770 Добавляет черную полосу в нижней части кадра.
|
|
1771 Рендерер SSA/ASS может поместить туда субтитры (с \-ass-use-margins).
|
|
1772 .
|
|
1773 .TP
|
|
1774 .B \-ass-color <значение>
|
|
1775 Устанавливает цвет текста субтитров.
|
|
1776 Формат цвета: RRGGBBAA.
|
|
1777 .
|
|
1778 .TP
|
|
1779 .B \-ass-font-scale <значение>
|
|
1780 Устанавливает коэффициент масштабирования, используемый в рендерере SSA/ASS.
|
|
1781 .
|
|
1782 .TP
|
|
1783 .B \-ass-force-style <[Стиль.]Параметр=Значение[,...]>
|
|
1784 Переопределяет некоторые параметры стиля.
|
|
1785 .sp
|
|
1786 .I ПРИМЕР:
|
|
1787 .PD 0
|
|
1788 .RSs
|
|
1789 \-ass-force-style FontName=Arial,Default.Bold=1
|
|
1790 .RE
|
|
1791 .PD 1
|
|
1792 .
|
|
1793 .TP
|
|
1794 .B \-ass-line-spacing <значение>
|
|
1795 Устанавливает межстрочный интервал для рендерера SSA/ASS.
|
|
1796 .
|
|
1797 .TP
|
|
1798 .B \-ass-styles <файл>
|
|
1799 Загружает все SSA/ASS стили, найденные в указанном файле и использует их для
|
|
1800 рендеринга текста субтитров. Синтаксис файла такой же как в
|
|
1801 [V4 Styles] / [V4+ Styles] разделах SSA/ASS.
|
|
1802 .
|
|
1803 .TP
|
|
1804 .B \-ass-top-margin <значение>
|
|
1805 Добавляет черную полосу в верхней части кадра.
|
|
1806 SSA/ASS рендерер может поместить туда субтитры (с \-ass-use-margins).
|
|
1807 .
|
|
1808 .TP
|
|
1809 .B \-(no)ass-use-margins
|
|
1810 Включает/выключает расположение субтитров на черных полосах, когда они доступны
|
|
1811 (по-умолчанию: нет).
|
|
1812 .
|
|
1813 .TP
|
|
1814 .B \-dumpjacosub (только MPlayer)
|
|
1815 Преобразует субтитры (указанные опцией \-sub) в основанный на времени
|
|
1816 JACOsub формат.
|
|
1817 Создает файл dumpsub.js в текущем каталоге.
|
|
1818 .
|
|
1819 .TP
|
|
1820 .B \-dumpmicrodvdsub (только MPlayer)
|
|
1821 Преобразует субтитры (указанные опцией \-sub) в MicroDVD формат.
|
|
1822 Создает файл dumpsub.sub в текущем каталоге.
|
|
1823 .
|
|
1824 .TP
|
|
1825 .B \-dumpmpsub (только MPlayer)
|
|
1826 Преобразует субтитры (указанные опцией \-sub) в MPsub, формат субтитров MPlayer.
|
|
1827 Создает файл dump.mpsub в текущем каталоге.
|
|
1828 .
|
|
1829 .TP
|
|
1830 .B \-dumpsami (только MPlayer)
|
|
1831 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат SAMI.
|
|
1832 Создает файл dumpsub.sm в текущем каталоге.
|
|
1833 .
|
|
1834 .TP
|
|
1835 .B \-dumpsrtsub (только MPlayer)
|
|
1836 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат
|
|
1837 SubViewer (SRT).
|
|
1838 Создает файл dumpsub.srt в текущем каталоге.
|
|
1839 .
|
|
1840 .br
|
|
1841 .I ЗАМЕЧАНИЕ:
|
|
1842 Некоторые глючные аппаратные проигрыватели давятся SRT субтитрами с концами строк
|
|
1843 в стиле Unix. Если вам неповезло иметь такой, пропустите файлы субтитров
|
|
1844 через unix2dos или аналогичную программу для замены символов конца строка на
|
|
1845 принятые в DOS/Windows.
|
|
1846 .
|
|
1847 .TP
|
|
1848 .B \-dumpsub (только MPlayer) (БЕТА КОД)
|
|
1849 Сохраняет субпоток субтитров из VOB потоков.
|
|
1850 Смотрите также опции \-dump*sub и \-vobsubout*.
|
|
1851 .
|
|
1852 .TP
|
|
1853 .B \-embeddedfonts (только FreeType)
|
|
1854 Задействует извлечение внедренных шрифтов Matroska.
|
|
1855 Эти шрифты затем могут быть использованы для рендеринга SSA/ASS субтитров
|
|
1856 (опция \-ass).
|
|
1857 .
|
|
1858 .TP
|
|
1859 .B \-ffactor <число> (только OSD)
|
|
1860 .\" FIXME Resample the font alphamap.
|
|
1861 Преобразует альфакарту шрифта.
|
|
1862 Может быть:
|
|
1863 .PD 0
|
|
1864 .RSs
|
|
1865 .IPs 0
|
|
1866 простые белые шрифты
|
|
1867 .IPs 0.75
|
|
1868 очень тонкое черное обрамление (по-умолчанию)
|
|
1869 .IPs 1
|
|
1870 тонкое черное обрамление
|
|
1871 .IPs 10
|
|
1872 жирное черное обрамление
|
|
1873 .RE
|
|
1874 .PD 1
|
|
1875 .
|
|
1876 .TP
|
|
1877 .B \-flip-hebrew (только FriBiDi)
|
|
1878 Включает отражение субтитров, используя FriBiDi.
|
|
1879 .
|
|
1880 .TP
|
|
1881 .B \-noflip-hebrew-commas
|
|
1882 Изменяет предположения FriBiDi о расположении запятых в субтитрах.
|
|
1883 Используйте ее, если запятые в субтитрах начинаются в начале фраз,
|
|
1884 вместо их конца.
|
|
1885 .
|
|
1886 .TP
|
|
1887 .B \-font <путь к файлу font.desc> (только OSD)
|
|
1888 Ищет OSD/\:SUB шрифты в другом каталоге (по-умолчанию для обычных
|
|
1889 шрифтов: ~/\:.mplayer/\:font/\:font.desc, по-умолчанию для FreeType шрифтов:
|
|
1890 ~/.mplayer/\:subfont.ttf).
|
|
1891 .br
|
|
1892 .I ЗАМЕЧАНИЕ:
|
|
1893 С FreeType, эта опция определяет путь к файлу шрифта текста.
|
|
1894 С fontconfig, эта опция определяет название шрифта fontconfig.
|
|
1895 .sp 1
|
|
1896 .I ПРИМЕР:
|
|
1897 .PD 0
|
|
1898 .RSs
|
|
1899 \-font ~/\:.mplayer/\:arial-14/\:font.desc
|
|
1900 .br
|
|
1901 \-font ~/\:.mplayer/\:arialuni.ttf
|
|
1902 .br
|
|
1903 \-font 'Bitstream Vera Sans'
|
|
1904 .RE
|
|
1905 .PD 1
|
|
1906 .
|
|
1907 .TP
|
|
1908 .B \-fontconfig (только fontconfig)
|
|
1909 Задействует использование шрифтов, управляемых fontconfig.
|
|
1910 .
|
|
1911 .TP
|
|
1912 .B \-forcedsubsonly
|
|
1913 Отображает только форсированные субтитры для потока субтитров DVD, выбранного,
|
|
1914 например \-slang.
|
|
1915 .
|
|
1916 .TP
|
|
1917 .B \-fribidi-charset <название кодировки> (только FriBiDi)
|
|
1918 Указывает кодировку, которая будет передана FriBiDi при декодировании
|
|
1919 не-UTF-8 субтитров (по-умолчанию: ISO8859-8).
|
|
1920 .
|
|
1921 .TP
|
|
1922 .B \-ifo <VOBsub IFO файл>
|
|
1923 Указывает файл, используемый для загрузки палитры и размера кадра для VOBsub субтитров.
|
|
1924 .
|
|
1925 .TP
|
|
1926 .B \-noautosub
|
|
1927 Выключает автоматическую загрузку файла субтитров.
|
|
1928 .
|
|
1929 .TP
|
|
1930 .B \-osd-duration <время>
|
|
1931 Устанавливает длительность отобрадения сообщений OSD в мс (по-умолчанию: 1000).
|
|
1932 .
|
|
1933 .TP
|
|
1934 .B \-osdlevel <0\-3> (только MPlayer)
|
|
1935 Указывает в каком режиме должен запускаться OSD.
|
|
1936 .PD 0
|
|
1937 .RSs
|
|
1938 .IPs 0
|
|
1939 только субтитры
|
|
1940 .IPs 1
|
|
1941 громкость + позиция (по-умолчанию)
|
|
1942 .IPs 2
|
|
1943 громкость + позиция + время + процент
|
|
1944 .IPs 3
|
|
1945 громкость + пощиция + время + процент + общее время
|
|
1946 .RE
|
|
1947 .PD 1
|
|
1948 .
|
|
1949 .TP
|
|
1950 .B \-overlapsub
|
|
1951 Позволяет очередным субтитрам быть отображенными, когда текущие еще видимы
|
|
1952 (по-умолчанию поддержка включается только для определенных форматов).
|
|
1953 .
|
|
1954 .TP
|
|
1955 .B \-sid <ID> (смотрите также \-slang, \-vobsubid)
|
|
1956 Отображает поток субтитров, указаный по <ID> (0\-31).
|
|
1957 MPlayer показывает доступные ID субтитров, когда запущен в подробном (\-v) режиме.
|
|
1958 Если вы не можете выбрать ни один из субтитров на DVD, попробуйте также \-vobsubid.
|
|
1959 .
|
|
1960 .TP
|
|
1961 .B \-slang <код языка[,код языка,...]> (смотрите также \-sid)
|
|
1962 Указывает языков используемых в субтитрах в порядке приоритетности.
|
|
1963 Разные форматы файлов работают с разными кодами языков.
|
|
1964 DVD используют ISO 639-1 двухбуквенные коды, Matroska использует
|
|
1965 ISO 639-2 трехбуквенные, в то время как OGM использует идентификатор
|
|
1966 в свободной форме. MPlayer выводит доступные языки при запуске в подробном (\-v) режиме.
|
|
1967 .sp 1
|
|
1968 .I ПРИМЕР:
|
|
1969 .PD 0
|
|
1970 .RSs
|
|
1971 .IPs "mplayer dvd://1 \-slang hu,en"
|
|
1972 Выбирает дорожку с Венгерскими субтитрами на DVD, а в случае отсутствия таковой
|
|
1973 возвращается к использованию Английского.
|
|
1974 .IPs "mplayer \-slang jpn example.mkv"
|
|
1975 Воспроизводит файл Matroska с Японскими субтитрами.
|
|
1976 .RE
|
|
1977 .PD 1
|
|
1978 .
|
|
1979 .TP
|
|
1980 .B \-spuaa <режим> (только OSD)
|
|
1981 Режим сглаживания/\:масштабирования для DVD/\:VOBsub.
|
|
1982 Значение 16 может быть добавлено к <режим> для задействования масштабирования,
|
|
1983 лаже если размеры исходного и отмасштабированного кадра уже совпадают.
|
|
1984 Может использоваться, например, для гауссового размытия субтитров.
|
|
1985 Доступные режимы:
|
|
1986 .PD 0
|
|
1987 .RSs
|
|
1988 .IPs 0
|
|
1989 ничего (наиболее быстрое, очень безобразное)
|
|
1990 .IPs 1
|
|
1991 апроксимированный (сбоит?)
|
|
1992 .IPs 2
|
|
1993 полное (меделенное)
|
|
1994 .IPs 3
|
|
1995 билинейное (быстрое и не очень плохое, по-умолчанию)
|
|
1996 .IPs 4
|
|
1997 используется гауссово размытие swscaler'a (выглядит очень хорошо)
|
|
1998 .RE
|
|
1999 .PD 1
|
|
2000 .
|
|
2001 .TP
|
|
2002 .B \-spualign <-1\-2> (только OSD)
|
|
2003 Указывает как должны выравниваться SPU (DVD/\:VOBsub) субтитры.
|
|
2004 .PD 0
|
|
2005 .RSs
|
|
2006 .IPs "-1"
|
|
2007 исходное положение
|
|
2008 .IPs " 0"
|
|
2009 Выравнивание к верху (изначальное поведение, по-умолчанию).
|
|
2010 .IPs " 1"
|
|
2011 Выравнивание к центру.
|
|
2012 .IPs " 2"
|
|
2013 Выравнивание к низу.
|
|
2014 .RE
|
|
2015 .PD 1
|
|
2016 .
|
|
2017 .TP
|
|
2018 .B \-spugauss <0.0\-3.0> (только OSD)
|
|
2019 Параметр отклонения гауссового размытия, используемый \-spuaa 4.
|
|
2020 Большие значения означают более сильное размытие (по-умолчанию: 1.0).
|
|
2021 .
|
|
2022 .TP
|
|
2023 .B \-sub <файл_субтитров1,файл_субтитров2,...>
|
|
2024 Использует/\:отображает указанные файлы субтитров.
|
|
2025 В каждый момент времени может быть показан только один файл.
|
|
2026 .
|
|
2027 .TP
|
|
2028 .B \-sub-bg-alpha <0\-255>
|
|
2029 Указывает значение альфа канала для субтитров и фона OSD.
|
|
2030 Большее значение означает большую прозрачность.
|
|
2031 0 означает полную прозрачность.
|
|
2032 .
|
|
2033 .TP
|
|
2034 .B \-sub-bg-color <0\-255>
|
|
2035 Указывает цвет для субтитров у фона OSD.
|
|
2036 В данный момент субтитры выводятся в оттенках серого, так что это
|
|
2037 эквивалентно интенсивности цвета.
|
|
2038 255 означает белый и 0 - черный.
|
|
2039 .
|
|
2040 .TP
|
|
2041 .B \-sub-demuxer <[+]название> (только \-subfile only) (БЕТА КОД)
|
|
2042 Принудительно устанвливает тип демуксера субтитров для \-subfile.
|
|
2043 Используйте '+' перед названием для принудительного использования, это
|
|
2044 пропустит некоторые проверки!
|
|
2045 Указывайте название демуксера таким, как оно выводится опцией \-sub-demuxer help.
|
|
2046 Для обратной совместимости также допускается ID демуксера, определенный в
|
|
2047 libmpdemux/\:demuxer.h.
|
|
2048 .
|
|
2049 .TP
|
|
2050 .B \-sub-fuzziness <режим>
|
|
2051 .\" FIXME
|
|
2052 Настраивает точность совпадения при поиске субтитров:
|
|
2053 .PD 0
|
|
2054 .RSs
|
|
2055 .IPs 0
|
|
2056 точное совпадение
|
|
2057 .IPs 1
|
|
2058 Загружает все субтитры, содержащие название фильма.
|
|
2059 .IPs 2
|
|
2060 Загружает все субтитры, в текущем каталоге.
|
|
2061 .RE
|
|
2062 .PD 1
|
|
2063 .
|
|
2064 .TP
|
|
2065 .B \-sub-no-text-pp
|
|
2066 Отключает любые виды постпроцессинга текста, производимого после загрузки
|
|
2067 субтитров. Используется для отладочных целей.
|
|
2068 .
|
|
2069 .TP
|
|
2070 .B \-subalign <0\-2> (только OSD)
|
|
2071 Указывает какой край субтитров должен выравниваться по высоте, указанной
|
|
2072 опцией \-subpos.
|
|
2073 .PD 0
|
|
2074 .RSs
|
|
2075 .IPs 0
|
|
2076 Выравнивают верх субтитров (изначальное поведение).
|
|
2077 .IPs 1
|
|
2078 Выранивает центр субтитров.
|
|
2079 .IPs 2
|
|
2080 Выравнивает нижнюю границу субтитров (по-умолчанию).
|
|
2081 .RE
|
|
2082 .PD 1
|
|
2083 .
|
|
2084 .TP
|
|
2085 .B "\-subcc \ "
|
|
2086 Отображает DVD Closed Caption (CC) субтитры.
|
|
2087 Это
|
|
2088 .B не
|
|
2089 .\" FIXME i cannot translate this
|
|
2090 VOB субтитры, это специальные ASCII субтитры для
|
|
2091 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
|
|
2092 CC subtitles have not been spotted on DVDs from other regions so far.
|
|
2093 .
|
|
2094 .TP
|
|
2095 .B \-subcp <кодировка> (только iconv)
|
|
2096 Если ваша система поддерживает iconv(3), можно использовать эту опцию для
|
|
2097 указания кодировки субтитров.
|
|
2098 .sp 1
|
|
2099 .I ПРИМЕР:
|
|
2100 .PD 0
|
|
2101 .RSs
|
|
2102 \-subcp latin2
|
|
2103 .br
|
|
2104 \-subcp cp1250
|
|
2105 .RE
|
|
2106 .PD 1
|
|
2107 .
|
|
2108 .TP
|
|
2109 .B \-subcp enca:<язык>:<кодировка при сбое> (только ENCA)
|
|
2110 Вы можете указать ваш язык, используя двухбуквенный код языка,
|
|
2111 чтобы дать ENCA вохможность определить кадовую страницу автоматически.
|
|
2112 Если неуверены, введите что-нибудь и смотрите вывод с \-v, чтобы определить
|
|
2113 список доступных языков. <кодировка при сбое> указывает кодировку, используемую,
|
|
2114 когда не срабатывает автоопределение.
|
|
2115 .sp 1
|
|
2116 .I ПРИМЕР:
|
|
2117 .PD 0
|
|
2118 .RSs
|
|
2119 .IPs "\-subcp enca:cs:latin2"
|
|
2120 Определяет кодировку, предполагая, что субтитры на Чешском, устанавливает
|
|
2121 latin 2, если определение не работает.
|
|
2122 .IPs "\-subcp enca:pl:cp1250"
|
|
2123 Определяет кодировку для Польского, устанавливает
|
|
2124 cp1250, если определение не работает.
|
|
2125 .RE
|
|
2126 .PD 1
|
|
2127 .
|
|
2128 .TP
|
|
2129 .B \-subdelay <сек>
|
|
2130 Отображает субтитры <сек> секунд.
|
|
2131 Может быть отрицательным.
|
|
2132 .
|
|
2133 .TP
|
|
2134 .B \-subfile <файл> (БЕТА КОД)
|
|
2135 В данный момент бесполезно.
|
|
2136 То же, что и \-audiofile, но для потока субтитров (OggDS?).
|
|
2137 .
|
|
2138 .TP
|
|
2139 .B \-subfont-autoscale <0\-3> (только FreeType)
|
|
2140 Устанавливает режим автомасштабирования.
|
|
2141 .br
|
|
2142 .I ЗАМЕЧАНИЕ:
|
|
2143 0 означает, что масштаб текста и масштаб OSD - это высота шрифта в точках.
|
|
2144 .sp 1
|
|
2145 Режим может быть:
|
|
2146 .sp 1
|
|
2147 .PD 0
|
|
2148 .RSs
|
|
2149 .IPs 0
|
|
2150 нет автомасштаба
|
|
2151 .IPs 1
|
|
2152 пропорционально высоте фильма
|
|
2153 .IPs 2
|
|
2154 пропорционально ширине фильма
|
|
2155 .IPs 3
|
|
2156 пропорционально диагонали фильма (по-умолчанию)
|
|
2157 .RE
|
|
2158 .PD 1
|
|
2159 .
|
|
2160 .TP
|
|
2161 .B \-subfont-blur <0\-8> (только FreeType)
|
|
2162 Указывает радиус размытия шрифта (по-умолчанию: 2).
|
|
2163 .
|
|
2164 .TP
|
|
2165 .B \-subfont-encoding <значение> (только FreeType)
|
|
2166 Устанавливает кодировку шрифта.
|
|
2167 Когда установлена в 'unicode', будут рендериться все глифы из файла шрифта и
|
|
2168 использоваться юникод (по-умолчанию: unicode).
|
|
2169 .
|
|
2170 .TP
|
|
2171 .B \-subfont-osd-scale <0\-100> (только FreeType)
|
|
2172 Устанавливает коэффициент автомасштаба OSD элементов (по-умолчанию: 6).
|
|
2173 .
|
|
2174 .TP
|
|
2175 .B \-subfont-outline <0\-8> (только FreeType)
|
|
2176 Устанавливает толщину обрамления шрифта (по-умолчанию: 2).
|
|
2177 .
|
|
2178 .TP
|
|
2179 .B \-subfont-text-scale <0\-100> (только FreeType)
|
|
2180 Устанавливает коэффициент автомасштаба текста субтитров как
|
|
2181 процент от размера экрана (по-умолчанию: 5).
|
|
2182 .
|
|
2183 .TP
|
|
2184 .B \-subfps <частота>
|
|
2185 Указывает частоту кадров файла субтитров (по-умолчанию: fps фильма).
|
|
2186 .br
|
|
2187 .I ЗАМЕЧАНИЕ:
|
|
2188 Только для файлов субтитров, основанных на времени, например MicroDVD формат.
|
|
2189 .
|
|
2190 .TP
|
|
2191 .B \-subpos <0\-100> (имеет смысл только с \-vf expand) (только OSD)
|
|
2192 Указывает позицию субтитров на экране.
|
|
2193 Указывается вертикальная позиция субтитров в % от высоты экрана.
|
|
2194 .
|
|
2195 .TP
|
|
2196 .B \-subwidth <10\-100> (только OSD)
|
|
2197 Указывает максимальную ширину субтитров на экране.
|
|
2198 Полезно для TV-вывода.
|
|
2199 Указывается ширина субтитров в % от ширины экрана.
|
|
2200 .
|
|
2201 .TP
|
|
2202 .B \-noterm-osd
|
|
2203 Отключает отображение сообщений OSD на консоли, когда недоступно никакого видео.
|
|
2204 .
|
|
2205 .TP
|
|
2206 .B \-term-osd-esc <escape последовательность>
|
|
2207 Указывает escape последовательность выодимую на консоль перед выводом сообщения OSD.
|
|
2208 Escape последовательность должна передвигать указатель на начало строки, используемой для
|
|
2209 OSD и очищать ее (по-умолчанию: ^[[A\\r^[[K).
|
|
2210 .
|
|
2211 .TP
|
|
2212 .B \-unicode
|
|
2213 Указывает MPlayer обрабатывать файл субтитров как unicode.
|
|
2214 .
|
|
2215 .TP
|
|
2216 .B "\-utf8 \ \ "
|
|
2217 Указывает MPlayer обрабатывать файл субтитров как UTF-8.
|
|
2218 .
|
|
2219 .TP
|
|
2220 .B \-vobsub <VOBsub файл без расширения>
|
|
2221 Указывает VOBsub файл, используемый для субтитров.
|
20735
|
2222 Должен быть полным путем без расширения, т.е.\& без '.idx', '.ifo' или '.sub'.
|
20707
|
2223 .
|
|
2224 .TP
|
|
2225 .B \-vobsubid <0\-31>
|
|
2226 Указывает ID субтитров VOBsub.
|
|
2227 .
|
|
2228 .
|
|
2229 .
|
|
2230 .SH "ОПЦИИ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)"
|
|
2231 .
|
|
2232 .TP
|
|
2233 .B \-abs <значение> (только \-ao oss) (УСТАРЕЛО)
|
|
2234 Переопределяет размер буфера аудио драйвера/\:карты.
|
|
2235 .
|
|
2236 .TP
|
|
2237 .B \-format <формат> (смотрите также аудио фильтр format)
|
|
2238 Выбирает формат сэмпла, используемый для вывода со слоя
|
|
2239 аудио фильтров на звуковую карту.
|
|
2240 Значения, которые может принимать <формат> перечислены ниже в описании
|
|
2241 аудио фильтра format.
|
|
2242 .
|
|
2243 .TP
|
|
2244 .B \-mixer <устройство>
|
|
2245 Использует устройство микшера, отличное от значения по-умолчанию
|
|
2246 /dev/\:mixer. Для ALSA это название микшера.
|
|
2247 .
|
|
2248 .TP
|
|
2249 .B \-mixer-channel <mixer line>[,mixer index] (только \-ao oss и \-ao)
|
|
2250 Эта опция укажет MPlayer использовать другой канал для управления
|
|
2251 громкостью, вместо PCM. Опции для OSS включают
|
|
2252 .B vol, pcm, line.
|
|
2253 Полный список опций смотрите в SOUND_DEVICE_NAMES в
|
|
2254 /usr/\:include/\:linux/\:soundcard.h.
|
|
2255 Для ALSA вы можете использовать названия, отображаемые, например alsamixer,
|
|
2256 вроде
|
|
2257 .B Master, Line, PCM.
|
|
2258 .br
|
|
2259 .I ЗАМЕЧАНИЕ:
|
|
2260 Названия каналов микшера ALSA, с последующими числами должны быть указаны в формате
|
|
2261 <название,число>, например канал, помеченный 'PCM 1', в alsamixer должен быть
|
|
2262 преобразован в
|
|
2263 .BR PCM,1 .
|
|
2264 .
|
|
2265 .TP
|
|
2266 .B \-softvol
|
|
2267 Принудительно использует программный микшер, вместо микшера звуковой карты.
|
|
2268 .
|
|
2269 .TP
|
|
2270 .B \-softvol-max <10.0\-10000.0>
|
|
2271 Устанавливает максимальный уровень усиления в процентах (по-умолчанию: 110).
|
|
2272 Значение 200 позволит вам изменять громкость до величины в два раза
|
|
2273 превышающей текущий уровень. Со значениями ниже 100 начальный уровень
|
|
2274 (равный 100%) будет больше максимального, и OSD не мможет отобразить его
|
|
2275 корректно.
|
|
2276 .
|
|
2277 .TP
|
|
2278 .B \-volstep <0\-100>
|
|
2279 Устанавливает размер шага изменения громкости микшера в процентах от
|
|
2280 всего диапазона (по-умолчанию: 3).
|
|
2281 .
|
|
2282 .
|
|
2283 .
|
|
2284 .SH "ДАЙВЕРЫ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)"
|
|
2285 Драйверы вывода звука являются интерфейсом к различным средствам вывода звука.
|
|
2286 Синтаксис:
|
|
2287 .
|
|
2288 .TP
|
|
2289 .B \-ao <драйвер1[:подопция1[=значение]:...],драйвер2,...[,]>
|
|
2290 Указывает список приоритетности использования драйверов вывода звука.
|
|
2291 .PP
|
|
2292 Если список содержит в конце ',' MPlayer в случае проблем будет использовать
|
|
2293 драйверы, не включенные в список.
|
|
2294 Подопции необязательны, и в большинстве случаев могут быть опущены.
|
|
2295 .br
|
|
2296 .I ЗАМЕЧАНИЕ:
|
|
2297 Смотрите \-ao help, чтобы получить список встроенных драйверов вывода звука.
|
|
2298 .sp 1
|
|
2299 .I ПРИМЕР:
|
|
2300 .PD 0
|
|
2301 .RSs
|
|
2302 .IPs "\-ao alsa,oss,"
|
|
2303 Пробуется ALSA драйвер, затем OSS, затем остальные.
|
|
2304 .IPs "\-ao alsa:noblock:device=hw=0.3"
|
|
2305 Устанавливает неблокирующий режим и в качестве устройства первую карту,
|
|
2306 четвертое устройство.
|
|
2307 .RE
|
|
2308 .PD 1
|
|
2309 .sp 1
|
|
2310 Доступные драйверы вывода звука:
|
|
2311 .
|
|
2312 .TP
|
|
2313 .B "alsa\ \ \ "
|
|
2314 Драйвер вывода звука ALSA 0.9/1.x
|
|
2315 .PD 0
|
|
2316 .RSs
|
|
2317 .IPs noblock
|
|
2318 Устанавливает неблокирующий режим.
|
|
2319 .IPs device=<устройство>
|
|
2320 Устанавливает название устройства.
|
|
2321 Замените любые ',' на '.' и любые ':' на '=' в названии устройства ALSA.
|
|
2322 Для hwac3 вывода через S/PDIF, используйте "iec958" или "spdif" устройство,
|
|
2323 если вы не знаете как правильно его установить.
|
|
2324 .RE
|
|
2325 .PD 1
|
|
2326 .
|
|
2327 .TP
|
|
2328 .B "alsa5\ \ "
|
|
2329 Драйвер вывода звука ALSA 0.5
|
|
2330 .
|
|
2331 .TP
|
|
2332 .B "oss\ \ \ \ "
|
|
2333 Драйвер вывода звука OSS
|
|
2334 .PD 0
|
|
2335 .RSs
|
|
2336 .IPs <dsp-устройство>
|
|
2337 Устанавливает устройство вывода звука (по-умолчанию: /dev/\:dsp).
|
|
2338 .IPs <mixer-устройство>
|
|
2339 Устанавливает устройство микширования звука (по-умолчанию: /dev/\:mixer).
|
|
2340 .IPs <mixer-канал>
|
|
2341 Устанавливает канал микшера звука (по-умолчанию: pcm).
|
|
2342 .RE
|
|
2343 .PD 1
|
|
2344 .
|
|
2345 .TP
|
|
2346 .B sdl (только SDL)
|
|
2347 Драйвер вывода звука высокоуровневой платформо-мезависимой библиотеки
|
|
2348 SDL (Simple Directmedia Layer)
|
|
2349 .PD 0
|
|
2350 .RSs
|
|
2351 .IPs <драйвер>
|
|
2352 Явно выбирает используемый SDL драйвер (по-умолчанию: на усмотрение SDL).
|
|
2353 .RE
|
|
2354 .PD 1
|
|
2355 .
|
|
2356 .TP
|
|
2357 .B "arts\ \ \ "
|
|
2358 Драйвер вывода звука через демон aRts
|
|
2359 .
|
|
2360 .TP
|
|
2361 .B "esd\ \ \ \ "
|
|
2362 Драйвер вывода звука через демон ESD
|
|
2363 .PD 0
|
|
2364 .RSs
|
|
2365 .IPs <сервер>
|
|
2366 Явно выбирает используемый ESD сервер (по-умолчанию: localhost).
|
|
2367 .RE
|
|
2368 .PD 1
|
|
2369 .
|
|
2370 .TP
|
|
2371 .B "jack\ \ \ \ "
|
|
2372 Драйвер вывода звука через JACK (Jack Audio Connection Kit)
|
|
2373 .PD 0
|
|
2374 .RSs
|
|
2375 .IPs port=<имя>
|
|
2376 Указывает присоединяться к портам с указанным именем (по-умолчанию: physical ports).
|
|
2377 .IPs name=<имя клиента>
|
|
2378 Имя клиента, передаваемое JACK (по-умолчанию: MPlayer [<PID>]).
|
|
2379 Полезно, если вы хотите автоматически устанавливать определенные соединения.
|
|
2380 .IPs (no)estimate
|
|
2381 Оценка задержки аудио, предлагаемой для более плавного воспроизведения видео
|
|
2382 (по-умодчанию: включено).
|
|
2383 .RE
|
|
2384 .PD 1
|
|
2385 .
|
|
2386 .TP
|
|
2387 .B "nas\ \ \ \ "
|
|
2388 Драйвер вывода звука через NAS
|
|
2389 .
|
|
2390 .TP
|
|
2391 .B macosx (только Mac OS X)
|
|
2392 Родной драйвер вывода звука Mac OS X
|
|
2393 .
|
|
2394 .TP
|
|
2395 .B openal
|
|
2396 Экспериментальный, незавершенный (будет сводить в моно) драйвер выода OpenAL
|
|
2397 .
|
|
2398 .TP
|
|
2399 .B sgi (только SGI)
|
|
2400 Родной драйвер вывода звука SGI
|
|
2401 .PD 0
|
|
2402 .RSs
|
|
2403 .IPs "<имя устройства вывода>"
|
|
2404 Явно выбирает используемое устройство/\:интерфейс вывода
|
|
2405 (по-умолчанию: системное значение по-умолчанию).
|
|
2406 Например, 'Analog Out' или 'Digital Out'.
|
|
2407 .RE
|
|
2408 .PD 1
|
|
2409 .
|
|
2410 .TP
|
|
2411 .B sun (только Sun)
|
|
2412 Родной драйвер вывода звука Sun
|
|
2413 .PD 0
|
|
2414 .RSs
|
|
2415 .IPs <device>
|
|
2416 Явно выбирает используемое устройство вывода (по-умолчанию: /dev/\:audio).
|
|
2417 .RE
|
|
2418 .PD 1
|
|
2419 .
|
|
2420 .TP
|
|
2421 .B win32 (только Windows)
|
|
2422 Родной waveout драйвер вывода звука Windows
|
|
2423 .
|
|
2424 .TP
|
|
2425 .B dsound (только Windows)
|
|
2426 Драйвер вывода звука DirectX DirectSound
|
|
2427 .PD 0
|
|
2428 .RSs
|
|
2429 .IPs device=<номер устройства>
|
|
2430 Устанавливает номер используемого устройства.
|
|
2431 Воспроизведение файла с \-v покажет список доступных устройств.
|
|
2432 .RE
|
|
2433 .PD 1
|
|
2434 .
|
|
2435 .TP
|
|
2436 .B dxr2 (смотрите также \-dxr2) (только DXR2)
|
|
2437 Специальный драйвер вывода для Creative DXR2
|
|
2438 .
|
|
2439 .TP
|
|
2440 .B ivtv (только IVTV)
|
|
2441 Специальный IVTV MPEG драйвер вывода.
|
|
2442 Работает только с \-ac hwmpa.
|
|
2443 .
|
|
2444 .TP
|
|
2445 .B mpegpes (только DVB)
|
|
2446 Драйвер вывода звука для DVB карт, записывающий вывод в MPEG-PES файл,
|
|
2447 если не установлено DVB карт.
|
|
2448 .PD 0
|
|
2449 .RSs
|
|
2450 .IPs card=<1\-4>
|
|
2451 Используемая DVB карта, если установлено более одной.
|
|
2452 .IPs file=<файл>
|
|
2453 Имя выходного файла
|
|
2454 .RE
|
|
2455 .PD 1
|
|
2456 .
|
|
2457 .TP
|
|
2458 .B "null\ \ \ "
|
|
2459 Не выводит никакого звука, но сохранаяет скорость воспроизведения видео.
|
|
2460 Используйте \-nosound для тестов производительности.
|
|
2461 .
|
|
2462 .TP
|
|
2463 .B "pcm\ \ \ \ "
|
|
2464 Драйвер вывода в файл сырого PCM/wave
|
|
2465 .PD 0
|
|
2466 .RSs
|
|
2467 .IPs (no)waveheader
|
|
2468 Включает или не включает заголовок wave (по-умолчанию: включен).
|
|
2469 Если не включен, генерируется сырой PCM.
|
|
2470 .IPs file=<файл>
|
|
2471 Записывает звук в <файл> вместо audiodump.wav.
|
|
2472 Если указано nowaveheader, то по-умолчанию используется audiodump.pcm.
|
|
2473 .IPs "fast\ "
|
|
2474 Пытается выводить быстрее реальной скорости.
|
|
2475 Убедитесь, что вывод не обрезан (обычно с сообщением
|
|
2476 "Too many video packets in buffer").
|
|
2477 Это нормально, если вы получаете сообщение
|
|
2478 "Your system is too SLOW to play this!".
|
|
2479 .RE
|
|
2480 .PD 1
|
|
2481 .
|
|
2482 .TP
|
|
2483 .B "plugin\ \ "
|
|
2484 Драйвер вывода звука plugin
|
|
2485 .
|
|
2486 .
|
|
2487 .
|
|
2488 .SH "ОПЦИИ ВЫВОДА ВИДЕО (ТОЛЬКО MPLAYER)"
|
|
2489 .
|
|
2490 .TP
|
|
2491 .B \-adapter <значение>
|
|
2492 Указывает видеокарту, на которую будет выводиться изображение.
|
|
2493 Список доступных карт можно получить, указав эту опцию совместно с \-v.
|
|
2494 В данный момент работает только с directx драйвером вывода видео.
|
|
2495 .
|
|
2496 .TP
|
|
2497 .B \-bpp <глубина>
|
|
2498 Переназначает определенную автоматически глубину цвета.
|
|
2499 Поддерживается только fbdev, dga, svga, vesa драйверами.
|
|
2500 .
|
|
2501 .TP
|
|
2502 .B \-border
|
|
2503 Воспроизводит фильм в окне с рамками и оформлением.
|
|
2504 Поскольку это действие по-умолчанию, используйте \-noborder
|
|
2505 для отключения стандартного оформления окон.
|
|
2506 Поддерживается драйвером directx.
|
|
2507 .
|
|
2508 .TP
|
|
2509 .B \-brightness <-100\-100>
|
|
2510 Настраивает яркость видео сигнала (по-умолчанию: 0).
|
|
2511 Поддерживается не всеми драйверами.
|
|
2512 .
|
|
2513 .TP
|
|
2514 .B \-contrast <-100\-100>
|
|
2515 Настраивает контрастность видеосигнала (по-умолчанию: 0).
|
|
2516 Поддерживается не всеми драйверами.
|
|
2517 .
|
|
2518 .TP
|
|
2519 .B \-display <имя> (только X11)
|
|
2520 Указывает имя хоста и номер дисплея X сервера, на котором вы хотите выводить
|
|
2521 изображение.
|
|
2522 .sp 1
|
|
2523 .I ПРИМЕР:
|
|
2524 .PD 0
|
|
2525 .RSs
|
|
2526 \-display xtest.localdomain:0
|
|
2527 .RE
|
|
2528 .PD 1
|
|
2529 .
|
|
2530 .TP
|
|
2531 .B "\-dr \ \ \ "
|
|
2532 Включает direct rendering (поддерживается не всеми кодеками и драйверами вывода).
|
|
2533 .br
|
|
2534 .I ВНИМАНИЕ:
|
|
2535 Может привести к испорченным OSD/SUB!
|
|
2536 .
|
|
2537 .TP
|
|
2538 .B \-dxr2 <опция1:опция2:...>
|
|
2539 Эта опция используется для управления драйвером dxr2.
|
|
2540 .RSs
|
|
2541 .IPs ar-mode=<значение>
|
|
2542 пропорции (0 = normal, 1 = pan-and-scan, 2 = letterbox (по-умолчанию))
|
|
2543 .IPs iec958-encoded
|
|
2544 устанавливает режим вывода iec958 в encoded.
|
|
2545 .IPs iec958-decoded
|
|
2546 устанавливает режим вывода iec958 в decoded (по-умолчанию).
|
|
2547 .IPs macrovision=<значение>
|
|
2548 режим macrovision (0 = выключено (по-умолчанию), 1 = agc, 2 = agc 2 colorstripe,
|
|
2549 3 = agc 4 colorstripe)
|
|
2550 .IPs "mute\ "
|
|
2551 отключает вывод звука
|
|
2552 .IPs unmute
|
|
2553 включает вывод звука
|
|
2554 .IPs ucode=<значение>
|
|
2555 путь к микрокоду
|
|
2556 .RE
|
|
2557 .RS
|
|
2558 .sp 1
|
|
2559 .I TV вывод
|
|
2560 .RE
|
|
2561 .RSs
|
|
2562 .IPs 75ire
|
|
2563 включает режим вывода 7.5 IRE
|
|
2564 .IPs no75ire
|
|
2565 отключает режим вывода 7.5 IRE (по-умолчанию)
|
|
2566 .IPs "bw\ \ \ "
|
|
2567 ч/б TV вывод
|
|
2568 .IPs color
|
|
2569 цветной TV вывод (по-умолчанию)
|
|
2570 .IPs interlaced
|
|
2571 черезстрочный TV вывод (по-умолчанию)
|
|
2572 .IPs nointerlaced
|
|
2573 отключает черезстрочный TV вывод
|
|
2574 .IPs norm=<значение>
|
|
2575 TV стандарт (ntsc (по-умолчанию), pal, pal60, palm, paln, palnc)
|
|
2576 .IPs square-pixel
|
|
2577 устанавливает режим пиксела в square
|
|
2578 .IPs ccir601-pixel
|
|
2579 устанавливает режим пиксела в ccir601
|
|
2580 .RE
|
|
2581 .RS
|
|
2582 .sp 1
|
|
2583 .I оверлей
|
|
2584 .RE
|
|
2585 .RSs
|
|
2586 .IPs cr-left=<0\-500>
|
|
2587 Устанавливает левую границу обрезания (по-умолчанию: 50).
|
|
2588 .IPs cr-right=<0\-500>
|
|
2589 Устанавливает правую границу обрезания (по-умолчанию: 300).
|
|
2590 .IPs cr-top=<0\-500>
|
|
2591 Устанавливает верхнюю границу обрезания (по-умолчанию: 0).
|
|
2592 .IPs cr-bottom=<0\-500>
|
|
2593 Устанавливает нижнюю границу обрезания (по-умолчанию: 0).
|
|
2594 .IPs ck-[r|g|b]=<0\-255>
|
|
2595 Устанавливает величину красной(r), зеленой(g), синей (b) компоненты ключевого цвета оверлея.
|
|
2596 .IPs ck-[r|g|b]min=<0\-255>
|
|
2597 Минимальное значение для соответствующей компоненты ключевого цвета
|
|
2598 .IPs ck-[r|g|b]max=<0\-255>
|
|
2599 Максимальное значение для соответствующей компоненты ключевого цвета
|
|
2600 .IPs ignore-cache
|
|
2601 Игнорирует кешированные установки оверлея.
|
|
2602 .IPs update-cache
|
|
2603 Обновляет кешированные установки оверлея.
|
|
2604 .IPs ol-osd
|
|
2605 Включает оверлейный OSD.
|
|
2606 .IPs nool-osd
|
|
2607 Отключает оверлейный OSD (по-умолчанию).
|
|
2608 .IPs ol[h|w|x|y]-cor=<-20\-20>
|
|
2609 Настраивает размер (высоту(h),ширину(w)) и положение (x,y) оверлея
|
|
2610 в случает, когда он не точно соответствует окну (по-умолчанию: 0).
|
|
2611 .IPs overlay
|
|
2612 Активирует оверлей (по-умолчанию).
|
|
2613 .IPs nooverlay
|
|
2614 Автивирует TV выход.
|
|
2615 .IPs overlay-ratio=<1\-2500>
|
|
2616 Настраивает оверлей (по-умолчанию: 1000).
|
|
2617 .RE
|
|
2618 .
|
|
2619 .TP
|
|
2620 .B \-fbmode <режим> (только \-vo fbdev)
|
|
2621 Меняет видео режим на помеченный как <режим> в /etc/\:fb.modes.
|
|
2622 .br
|
|
2623 .I ЗАМЕЧАНИЕ:
|
|
2624 VESA фреймбуфер не поддерживает смену режима.
|
|
2625 .
|
|
2626 .TP
|
|
2627 .B \-fbmodeconfig <файл> (только \-vo fbdev)
|
|
2628 Переопределяет файл конфигурации режимов фреймбуфера (по-умолчанию: /etc/\:fb.modes).
|
|
2629 .
|
|
2630 .TP
|
|
2631 .B \-fs (смотрите также \-zoom)
|
|
2632 Полноэкранное воспроизведение (центрирует изображение и рисует черные рамки вокруг него).
|
|
2633 Поддерживается не всеми драйверами.
|
|
2634 .
|
|
2635 .TP
|
|
2636 .B \-fsmode-dontuse <0\-31> (УСТАРЕЛО, используйте опцию \-fs)
|
|
2637 Попробуйте эту опцию, если у вас по-прежнему проблемы с полноэкранным режимом.
|
|
2638 .
|
|
2639 .TP
|
|
2640 .B \-fstype <тип1,тип2,...> (только X11)
|
|
2641 Указывает список используемых полноэкранных режимов в порядке приоритета.
|
|
2642 Вы можете овергнуть режимы, ставя перед ними '\-'.
|
|
2643 Если у вас возникают проблемы вроде перекрывания полноэкранного окна другими,
|
|
2644 попробуйте использовать другой порядок.
|
|
2645 .br
|
|
2646 .I ЗАМЕЧАНИЕ:
|
|
2647 Список доступных типов можно получить опцией \-fstype help.
|
|
2648 .sp 1
|
|
2649 Допустиные типы:
|
|
2650 .sp 1
|
|
2651 .PD 0
|
|
2652 .RSs
|
|
2653 .IPs above
|
|
2654 Использует подсказку _NETWM_STATE_ABOVE, если доступна.
|
|
2655 .IPs below
|
|
2656 Использует подсказку _NETWM_STATE_BELOW, если доступна.
|
|
2657 .IPs fullscreen
|
|
2658 Использует подсказку _NETWM_STATE_FULLSCREEN, если доступна.
|
|
2659 .IPs layer
|
|
2660 Использует подсказку _WIN_LAYER со слоем по-умолчанию.
|
|
2661 .IPs layer=<0...15>
|
|
2662 Использует подсказку _WIN_LAYER со слоем с указанным номером.
|
|
2663 .IPs netwm
|
|
2664 Принудительно указывает стиль NETWM.
|
|
2665 .IPs "none\ "
|
|
2666 Указывает не устанавливать слой полноэкранного окна.
|
|
2667 .IPs stays_on_top
|
|
2668 Использует подсказку _NETWM_STATE_STAYS_ON_TOP, если доступна.
|
|
2669 .REss
|
|
2670 .sp 1
|
|
2671 .RS
|
|
2672 .I ПРИМЕР:
|
|
2673 .RE
|
|
2674 .PD 0
|
|
2675 .RSs
|
|
2676 .IPs layer,stays_on_top,above,fullscreen
|
|
2677 Порядок по-умолчанию, будет использоваться, если указан некорректный или
|
|
2678 неподдерживаемый режим.
|
|
2679 .IPs \-fullscreen
|
|
2680 Исправляет переключение в полноэкранный режим в OpenBox 1.x.
|
|
2681 .RE
|
|
2682 .PD 1
|
|
2683 .
|
|
2684 .TP
|
|
2685 .B \-geometry x[%][:y[%]] или [WxH][+x+y]
|
|
2686 Настраивает место появления на экране изображения.
|
|
2687 x и y указываются в пикселах, считая от верхнего левого до нижнего правого
|
|
2688 угла выводимого изображения. Если после значения указан символ процента, то
|
|
2689 оно превращается в процентное относительно размера экрана в соответствующем
|
|
2690 направлении. Опция также поддерживает стандартный формат X11 опции \-geometry.
|
|
2691 Если опцией \-wid указано внешнее окно, то координаты x и y указываются относительно
|
|
2692 его левого верхнего угла, а не экранного.
|
|
2693 .br
|
|
2694 .I ЗАМЕЧАНИЕ:
|
|
2695 Эта опция поддерживается только драйверами x11, xmga, xv, xvmc, xvidix,
|
|
2696 gl, gl2, directx и tdfxfb.
|
|
2697 .sp 1
|
|
2698 .I ПРИМЕР:
|
|
2699 .PD 0
|
|
2700 .RSs
|
|
2701 .IPs 50:40
|
|
2702 Располагает окно в позиции x=50, y=40.
|
|
2703 .IPs 50%:50%
|
|
2704 Располагает окно в центре экрана.
|
|
2705 .IPs "100%\ "
|
|
2706 Располагает окно у центра правой границы экрана.
|
|
2707 .IPs 100%:100%
|
|
2708 Располагает окно у правого нижнего угла экрана.
|
|
2709 .RE
|
|
2710 .PD 1
|
|
2711 .
|
|
2712 .TP
|
|
2713 .B \-guiwid <ID окна> (смотрите также \-wid) (только GUI)
|
|
2714 Опция указывает GUI использовать также X11 окно и прицепить себя к нижней
|
|
2715 части видео окна, что полезно для внедрения мини-GUI в браузер
|
|
2716 (с плагином MPlayer).
|
|
2717 .
|
|
2718 .TP
|
|
2719 .B \-hue <-100\-100>
|
|
2720 Настраивает цветность видеосигнала (по-умолчанию: 0).
|
|
2721 С этой опцией вы можете получить цветной негатив.
|
|
2722 Поддерживается не всеми драйверами.
|
|
2723 .
|
|
2724 .TP
|
|
2725 .B \-monitor-dotclock <диапазон[,диапазон,...]> (только \-vo fbdev и vesa)
|
|
2726 Указывает диапазон значений dotclock или pixelclock монитора.
|
|
2727 .
|
|
2728 .TP
|
|
2729 .B \-monitor-hfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa)
|
|
2730 Указывает диапазон значений горизонтальной частоты монитора.
|
|
2731 .
|
|
2732 .TP
|
|
2733 .B \-monitor-vfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa)
|
|
2734 Указывает диапазон значений вертикальной частоты монитора.
|
|
2735 .
|
|
2736 .TP
|
|
2737 .B \-monitoraspect <значение> (смотрите также \-aspect)
|
|
2738 Указывает пропорции монитора или TV экрана.
|
|
2739 .sp 1
|
|
2740 .I ПРИМЕР:
|
|
2741 .PD 0
|
|
2742 .RSs
|
|
2743 \-monitoraspect 4:3 or 1.3333
|
|
2744 .br
|
|
2745 \-monitoraspect 16:9 or 1.7777
|
|
2746 .RE
|
|
2747 .PD 1
|
|
2748 .
|
|
2749 .TP
|
|
2750 .B \-monitorpixelaspect <значение> (смотрите \-aspect)
|
|
2751 Устанавливает пропорции отдельного пиксела вашего монитора или TV
|
|
2752 экрана (по-умолчанию: отключено).
|
|
2753 Переопределяет установки \-monitoraspect.
|
|
2754 Значение 0 отключает, значение 1 означает квадратные пикселы
|
|
2755 (верно для (почти?) всех LCD).
|
|
2756 .
|
|
2757 .TP
|
|
2758 .B \-nodouble
|
|
2759 Отключает двойную буферизацию, используется, как правило, для целей откладки.
|
|
2760 Двойная буферизация исправляет мерцание, храня два кадра в памяти и
|
|
2761 отображая один из них, в то время, как декодируется второй.
|
|
2762 Это может негативно сказаться на OSD, но в большинстве случаев
|
|
2763 убирает мерцание OSD.
|
|
2764 .
|
|
2765 .TP
|
|
2766 .B \-nograbpointer
|
|
2767 Указывает не захватывать указатель мыши после смены видео режима (\-vm).
|
|
2768 Полезно для многоголовых конфигураций.
|
|
2769 .
|
|
2770 .TP
|
|
2771 .B \-nokeepaspect
|
|
2772 Указывает ге сохранять пропорции окна при изменении размера.
|
|
2773 Работает только с драйверами x11, xv, xmga, xvidix, directx.
|
|
2774 Кроме того, под X11 ваш оконный менеджер должен понимать подсказку
|
|
2775 созранения пропорций окна.
|
|
2776 .
|
|
2777 .TP
|
|
2778 .B "\-ontop\ "
|
|
2779 Помещает и сохраняет окно проигрывателя поверх всех окон.
|
|
2780 Поддерживается всеми драйверами, использующими X11, за
|
|
2781 исчключением SDL, а также драйверами directx, macosx,
|
|
2782 quartz, ggi и gl2.
|
|
2783 .
|
|
2784 .TP
|
|
2785 .B \-panscan <0.0\-1.0>
|
|
2786 Задействует функциональность pan-and-scan (обрезая стороны в соответствии
|
|
2787 с пропорциями, чтобы, например 16:9, фильм поместился на 4:3 экране
|
|
2788 без черных полос). Диапазон указывает какая часть изображения обрезается.
|
|
2789 Работает только с xv, xmga, mga, gl, gl2, quartz, macosx и xvidix драйверами.
|
|
2790 .
|
|
2791 .TP
|
|
2792 .B \-panscanrange <-19.0\-99.0> (экспериментальное)
|
|
2793 Изменяет диапазон pan-and-scan функциональности (по-умолчанию: 1).
|
|
2794 Положительные значения означают множитель диапазона по-умолчанию.
|
|
2795 Отрицательные значения означают, что можно увеличивать изображение
|
|
2796 до \-panscanrange+1 раз.
|
|
2797 Например \-panscanrange -3 означает увеличение вплоть до 4 раз.
|
|
2798 Это экспериментальная возможность.
|
|
2799 Не сообщайте об ошибках в ней, за исключением случая использования \-vo gl.
|
|
2800 .
|
|
2801 .TP
|
|
2802 .B \-refreshrate <Гц>
|
|
2803 Устанавливает частоту обновления монитора в Гц.
|
|
2804 В данный момент поддерживается только \-vo directx совместно с \-vm.
|
|
2805 .
|
|
2806 .TP
|
|
2807 .B \-rootwin
|
|
2808 Воспроизводит фильм на главном окне (фоне рабочего стола).
|
|
2809 Однако, фон рабочего стола может отображаться поверх изображения.
|
|
2810 Работает только с x11, xv, xmga, xvidix, quartz, macosx и directx драйверами.
|
|
2811 .
|
|
2812 .TP
|
|
2813 .B \-saturation <-100\-100>
|
|
2814 Настраивает насыщенность видео сигнала (по-умолчанию: 0).
|
|
2815 С этой опцией вы можете получить изображения в оттенках серого.
|
|
2816 Поддерживается не всеми драйверами.
|
|
2817 .
|
|
2818 .TP
|
|
2819 .B \-screenh <пикселов>
|
|
2820 Указывает вертикальное разрешение экрана для драйверов, которые не могут
|
|
2821 определить его самостоятельно, таких как fbdev, x11 и TVout.
|
|
2822 .
|
|
2823 .TP
|
|
2824 .B \-screenw <пикселов>
|
|
2825 Указывает горизонтальное разрешение экрана для драйверов, которые не могут
|
|
2826 определить его самостоятельно, таких как fbdev, x11 и TVout.
|
|
2827 .
|
|
2828 .TP
|
|
2829 .B \-stop-xscreensaver (только X11)
|
|
2830 Отключает xscreensaver при запуске и снова включает его при выходе.
|
|
2831 .
|
|
2832 .TP
|
|
2833 .B "\-vm \ \ \ "
|
|
2834 Пытается переключиться в другой видео режим.
|
|
2835 Поддерживается dga, x11, xv, sdl и directx драйверами.
|
|
2836 Если используется с directx драйвером, для изменения режима
|
|
2837 можно использовать опции \-screenw, \-screenh, \-bpp и \-refreshrate.
|
|
2838 .
|
|
2839 .TP
|
|
2840 .B "\-vsync \ \ "
|
|
2841 Включает VBI для vesa, dfbmga и svga драйверов.
|
|
2842 .
|
|
2843 .TP
|
|
2844 .B \-wid <ID окна> (смотрите также \-guiwid) (только X11, OpenGL и DirectX)
|
|
2845 Говорит MPlayer присоединиться к существующему окну.
|
|
2846 Полезно для внедрения MPlayer в браузер (например, расширение plugger).
|
|
2847 .
|
|
2848 .TP
|
|
2849 .B \-xineramascreen <\-2\-...> (только X11)
|
|
2850 В Xinerama конфигурациях (например, единственный рабочий стол, растянутый на
|
|
2851 несклько экранов) эта опция указывает MPlayer на каком из них показывать
|
|
2852 фильм. Значение \-2 означает полноэкранный режим на весь виртуальный экран,
|
|
2853 \-1 означает полноэкранный режим на экране с текущим окном.
|
|
2854 Начальная позиция устанавливается опцией \-geometry относительно указаного
|
|
2855 экрана. Как правило будет работать только с "\-fstype \-fullscreen" или
|
|
2856 "\-fstype none".
|
|
2857 .
|
|
2858 .TP
|
|
2859 .B \-zrbw (только \-vo zr)
|
|
2860 Показывает черно-белое изображение.
|
|
2861 Для оптимальной производительности может комбинироваться с '\-lavdopts gray'.
|
|
2862 .
|
|
2863 .TP
|
|
2864 .B \-zrcrop <[ширина]x[высота]+[x смещение]+[y смещение]> (только \-vo zr)
|
|
2865 Выбирает часть исходного изображения для показа, неоднократное указание
|
|
2866 этой опции включает режим cinerama.
|
|
2867 В режиме cinerama фильм распределяется по нескольким TV (или проекторам) для
|
|
2868 создания большей картинки.
|
|
2869 Опции, указаанные после n-ой \-zrcrop применяются к n-ой MJPEG карте,
|
|
2870 для каждой карты нужно указать, как минимум, \-zrdev в дополнении к \-zrcrop.
|
|
2871 Для примера смотрите вывод \-zrhelp и раздел Zr документации.
|
|
2872 .
|
|
2873 .TP
|
|
2874 .B \-zrdev <устройство> (только \-vo zr)
|
|
2875 Указывает файл устройства, относящийся к вашей MJPEG карте, по-умолчанию
|
|
2876 драйвер zr устанавливает ее в первое найденное v4l устройство.
|
|
2877 .
|
|
2878 .TP
|
|
2879 .B \-zrfd (только \-vo zr)
|
|
2880 Принудительное прореживание: Прореживание, указаное опциями \-zrhdec
|
|
2881 и \-zrvdec, применяется, только если аппаратный scaler может растянуть
|
|
2882 изображение до его исходного размера.
|
|
2883 Используйте эту опцию, чтобы форсировать прореживание.
|
|
2884 .
|
|
2885 .TP
|
|
2886 .B \-zrhdec <1|2|4> (только \-vo zr)
|
|
2887 Горизонтальное прореживание: Запрашивает драйвер отправлять только
|
|
2888 каждый 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и
|
|
2889 использовать scaler MJPEG карты для растягивания изображения до
|
|
2890 исходного размера.
|
|
2891 .
|
|
2892 .TP
|
|
2893 .B \-zrhelp (только \-vo zr)
|
|
2894 Отображает список всех \-zr* опций, их значения по-умолчанию и
|
|
2895 пример режима cinerama.
|
|
2896 .
|
|
2897 .TP
|
|
2898 .B \-zrnorm <стандарт> (только \-vo zr)
|
|
2899 Указывает TV стандарт в PAL или NTSC (по-умолчанию: без изменения).
|
|
2900 .
|
|
2901 .TP
|
|
2902 .B \-zrquality <1\-20> (только \-vo)
|
|
2903 Число от 1 (наилучшее) до 20 (наихудшее) представляющее качество
|
|
2904 кодирования JPEG.
|
|
2905 .
|
|
2906 .
|
|
2907 .TP
|
|
2908 .B \-zrvdec <1|2|4> (только \-vo zr)
|
|
2909 Вертикальное прореживание: Запрашивает драйвер отправлять только
|
|
2910 каждую 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и
|
|
2911 использовать scaler MJPEG карты для растягивания изображения до
|
|
2912 исходного размера.
|
|
2913 .
|
|
2914 .TP
|
|
2915 .B \-zrxdoff <x смещение на экране> (только \-vo zr)
|
|
2916 Если изображение меньше, чем TV экран, эта опция указывает смещение
|
|
2917 по x от верхнего левого угла TV экрана (по-умолчанию: центировано).
|
|
2918 .
|
|
2919 .TP
|
|
2920 .B \-zrydoff <y смещение на экране> (только \-vo zr)
|
|
2921 Если изображение меньше, чем TV экран, эта опция указывает смещение
|
|
2922 по y от верхнего левого угла TV экрана (по-умолчанию: центировано).
|
|
2923 .
|
|
2924 .
|
|
2925 .
|
|
2926 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
|
|
2927 Video output drivers are interfaces to different video output facilities.
|
|
2928 The syntax is:
|
|
2929 .
|
|
2930 .TP
|
|
2931 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
|
|
2932 Specify a priority list of video output drivers to be used.
|
|
2933 .PP
|
|
2934 If the list has a trailing ',' MPlayer will fall back on drivers not
|
|
2935 contained in the list.
|
|
2936 Suboptions are optional and can mostly be omitted.
|
|
2937 .br
|
|
2938 .I NOTE:
|
|
2939 See \-vo help for a list of compiled-in video output drivers.
|
|
2940 .sp 1
|
|
2941 .I EXAMPLE:
|
|
2942 .PD 0
|
|
2943 .RSs
|
|
2944 .IPs "\-vo xmga,xv,"
|
|
2945 Try the Matrox X11 driver, then the Xv driver, then others.
|
|
2946 .IPs "\-vo directx:noaccel"
|
|
2947 Uses the DirectX driver with acceleration features turned off.
|
|
2948 .RE
|
|
2949 .PD 1
|
|
2950 .sp 1
|
|
2951 Available video output drivers are:
|
|
2952 .
|
|
2953 .TP
|
|
2954 .B xv (X11 only)
|
|
2955 Uses the XVideo extension of XFree86 4.x to enable hardware
|
|
2956 accelerated playback.
|
|
2957 If you cannot use a hardware specific driver, this is probably
|
|
2958 the best option.
|
|
2959 For information about what colorkey is used and how it is drawn run MPlayer
|
|
2960 with \-v option and look out for the lines tagged with [xv common] at the
|
|
2961 beginning.
|
|
2962 .PD 0
|
|
2963 .RSs
|
|
2964 .IPs port=<number>
|
|
2965 Select a specific XVideo port.
|
|
2966 .IPs ck=<cur|use|set>
|
|
2967 Select the source from which the colorkey is taken (default: cur).
|
|
2968 .RSss
|
|
2969 .IPs cur
|
|
2970 The default takes the colorkey currently set in Xv.
|
|
2971 .IPs use
|
|
2972 Use but do not set the colorkey from MPlayer (use \-colorkey option to change
|
|
2973 it).
|
|
2974 .IPs set
|
|
2975 Same as use but also sets the supplied colorkey.
|
|
2976 .RE
|
|
2977 .IPs ck-method=<man|bg|auto>
|
|
2978 Sets the colorkey drawing method (default: man).
|
|
2979 .RSss
|
|
2980 .IPs man
|
|
2981 Draw the colorkey manually (reduces flicker in some cases).
|
|
2982 .IPs bg
|
|
2983 Set the colorkey as window background.
|
|
2984 .IPs auto
|
|
2985 Let Xv draw the colorkey.
|
|
2986 .RE
|
|
2987 .RE
|
|
2988 .PD 1
|
|
2989 .
|
|
2990 .TP
|
|
2991 .B x11 (X11 only)
|
|
2992 Shared memory video output driver without hardware acceleration that
|
|
2993 works whenever X11 is present.
|
|
2994 .
|
|
2995 .TP
|
|
2996 .B xover (X11 only)
|
|
2997 Adds X11 support to all overlay based video output drivers.
|
|
2998 Currently only supported by tdfx_vid.
|
|
2999 .PD 0
|
|
3000 .RSs
|
|
3001 .IPs <vo_driver>
|
|
3002 Select the driver to use as source to overlay on top of X11.
|
|
3003 .RE
|
|
3004 .PD 1
|
|
3005 .
|
|
3006 .TP
|
|
3007 .B xvmc (X11 with \-vc ffmpeg12mc only)
|
|
3008 Video output driver that uses the XvMC (X Video Motion Compensation)
|
|
3009 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.
|
|
3010 .PD 0
|
|
3011 .RSs
|
|
3012 .IPs port=<number>
|
|
3013 Select a specific XVideo port.
|
|
3014 .IPs (no)benchmark
|
|
3015 Disables image display.
|
|
3016 Necessary for proper benchmarking of drivers that change
|
|
3017 image buffers on monitor retrace only (nVidia).
|
|
3018 Default is not to disable image display (nobenchmark).
|
|
3019 .IPs (no)bobdeint
|
|
3020 Very simple deinterlacer.
|
|
3021 Might not look better than \-vf tfields=1,
|
|
3022 but it is the only deinterlacer for xvmc (default: nobobdeint).
|
|
3023 .IPs (no)queue
|
|
3024 Queue frames for display to allow more parallel work of the video hardware.
|
|
3025 May add a small (not noticeable) constant A/V desync (default: noqueue).
|
|
3026 .IPs (no)sleep
|
|
3027 Use sleep function while waiting for rendering to finish
|
|
3028 (not recommended on Linux) (default: nosleep).
|
|
3029 .IPs ck=cur|use|set
|
|
3030 Same as \-vo xv:ck (see \-vo xv).
|
|
3031 .IPs ck-method=man|bg|auto
|
|
3032 Same as \-vo xv:ck-method (see \-vo xv).
|
|
3033 .RE
|
|
3034 .PD 1
|
|
3035 .
|
|
3036 .TP
|
|
3037 .B dga (X11 only)
|
|
3038 Play video through the XFree86 Direct Graphics Access extension.
|
|
3039 Considered obsolete.
|
|
3040 .
|
|
3041 .TP
|
|
3042 .B sdl (SDL only)
|
|
3043 Highly platform independent SDL (Simple Directmedia Layer) library
|
|
3044 video output driver.
|
|
3045 Since SDL uses its own X11 layer, MPlayer X11 options do not have
|
|
3046 any effect on SDL.
|
|
3047 .PD 0
|
|
3048 .RSs
|
|
3049 .IPs driver=<driver>
|
|
3050 Explicitly choose the SDL driver to use.
|
|
3051 .IPs (no)forcexv
|
|
3052 Use XVideo through the sdl video output driver (default: forcexv).
|
|
3053 .IPs (no)hwaccel
|
|
3054 Use hardware accelerated scaler (default: hwaccel).
|
|
3055 .RE
|
|
3056 .PD 1
|
|
3057 .
|
|
3058 .TP
|
|
3059 .B "vidix\ \ "
|
|
3060 VIDIX (VIDeo Interface for *niX) is an interface to the
|
|
3061 video acceleration features of different graphics cards.
|
|
3062 Very fast video output driver on cards that support it.
|
|
3063 .PD 0
|
|
3064 .RSs
|
|
3065 .IPs <subdevice>
|
|
3066 Explicitly choose the VIDIX subdevice driver to use.
|
|
3067 Available subdevice drivers are cyberblade_vid.so, mach64_vid.so,
|
|
3068 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so,
|
|
3069 radeon_vid.so, rage128_vid.so, sis_vid.so and unichrome_vid.so.
|
|
3070 .RE
|
|
3071 .PD 1
|
|
3072 .
|
|
3073 .TP
|
|
3074 .B xvidix (X11 only)
|
|
3075 X11 frontend for VIDIX
|
|
3076 .PD 0
|
|
3077 .RSs
|
|
3078 .IPs <subdevice>
|
|
3079 same as vidix
|
|
3080 .RE
|
|
3081 .PD 1
|
|
3082 .
|
|
3083 .TP
|
|
3084 .B "cvidix\ "
|
|
3085 Generic and platform independent VIDIX frontend, can even run in a
|
|
3086 text console with nVidia cards.
|
|
3087 .PD 0
|
|
3088 .RSs
|
|
3089 .IPs <subdevice>
|
|
3090 same as vidix
|
|
3091 .RE
|
|
3092 .PD 1
|
|
3093 .
|
|
3094 .TP
|
|
3095 .B winvidix (Windows only)
|
|
3096 Windows frontend for VIDIX
|
|
3097 .PD 0
|
|
3098 .RSs
|
|
3099 .IPs <subdevice>
|
|
3100 same as vidix
|
|
3101 .RE
|
|
3102 .PD 1
|
|
3103 .
|
|
3104 .TP
|
|
3105 .B directx (Windows only)
|
|
3106 Video output driver that uses the DirectX interface.
|
|
3107 .PD 0
|
|
3108 .RSs
|
|
3109 .IPs noaccel
|
|
3110 Turns off hardware acceleration.
|
|
3111 Try this option if you have display problems.
|
|
3112 .RE
|
|
3113 .PD 1
|
|
3114 .
|
|
3115 .TP
|
|
3116 .B quartz (Mac OS X only)
|
|
3117 Mac OS X Quartz video output driver.
|
|
3118 Under some circumstances, it might be more efficient to force a
|
|
3119 packed YUV output format, with e.g.\& \-vf format=yuy2.
|
|
3120 .PD 0
|
|
3121 .RSs
|
|
3122 .IPs device_id=<number>
|
|
3123 Choose the display device to use in fullscreen.
|
|
3124 .IPs fs_res=<width>:<height>
|
|
3125 Specify the fullscreen resolution (useful on slow systems).
|
|
3126 .RE
|
|
3127 .PD 1
|
|
3128 .
|
|
3129 .TP
|
|
3130 .B macosx (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
|
|
3131 Mac OS X CoreVideo video output driver
|
|
3132 .PD 0
|
|
3133 .RSs
|
|
3134 .IPs device_id=<number>
|
|
3135 Choose the display device to use in fullscreen.
|
|
3136 .RE
|
|
3137 .PD 1
|
|
3138 .
|
|
3139 .TP
|
|
3140 .B fbdev (Linux only)
|
|
3141 Uses the kernel framebuffer to play video.
|
|
3142 .PD 0
|
|
3143 .RSs
|
|
3144 .IPs <device>
|
|
3145 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
|
|
3146 name of the VIDIX subdevice if the device name starts with 'vidix'
|
|
3147 (e.g.\& 'vidixsis_vid' for the sis driver).
|
|
3148 .RE
|
|
3149 .PD 1
|
|
3150 .
|
|
3151 .TP
|
|
3152 .B fbdev2 (Linux only)
|
|
3153 Uses the kernel framebuffer to play video,
|
|
3154 alternative implementation.
|
|
3155 .PD 0
|
|
3156 .RSs
|
|
3157 .IPs <device>
|
|
3158 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
|
|
3159 .RE
|
|
3160 .PD 1
|
|
3161 .
|
|
3162 .TP
|
|
3163 .B "vesa\ \ \ "
|
|
3164 Very general video output driver that should work on any VESA VBE 2.0
|
|
3165 compatible card.
|
|
3166 .PD 0
|
|
3167 .RSs
|
|
3168 .IPs "dga\ \ "
|
|
3169 Turns on DGA mode.
|
|
3170 .IPs nodga
|
|
3171 Turns off DGA mode.
|
|
3172 .IPs neotv_pal
|
|
3173 Activate the NeoMagic TV out and set it to PAL norm.
|
|
3174 .IPs neotv_ntsc
|
|
3175 Activate the NeoMagic TV out and set it to NTSC norm.
|
|
3176 .IPs vidix
|
|
3177 Use the VIDIX driver.
|
|
3178 .IPs "lvo:\ \ \ "
|
|
3179 Activate the Linux Video Overlay on top of VESA mode.
|
|
3180 .RE
|
|
3181 .PD 1
|
|
3182 .
|
|
3183 .TP
|
|
3184 .B "svga\ \ \ "
|
|
3185 Play video using the SVGA library.
|
|
3186 .PD 0
|
|
3187 .RSs
|
|
3188 .IPs "<video mode>"
|
|
3189 Specify video mode to use.
|
|
3190 The mode can be given in a <width>x<height>x<colors> format,
|
|
3191 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
|
|
3192 .IPs bbosd
|
|
3193 Draw OSD into black bands below the movie (slower).
|
|
3194 .IPs native
|
|
3195 Use only native drawing functions.
|
|
3196 This avoids direct rendering, OSD and hardware acceleration.
|
|
3197 .IPs retrace
|
|
3198 Force frame switch on vertical retrace.
|
|
3199 Usable only with \-double.
|
|
3200 It has the same effect as the \-vsync option.
|
|
3201 .IPs "sq\ \ \ "
|
|
3202 Try to select a video mode with square pixels.
|
|
3203 .IPs vidix
|
|
3204 Use svga with VIDIX.
|
|
3205 .RE
|
|
3206 .PD 1
|
|
3207 .
|
|
3208 .TP
|
|
3209 .B "gl\ \ \ \ \ "
|
|
3210 OpenGL video output driver, simple version.
|
|
3211 Video size must be smaller than
|
|
3212 the maximum texture size of your OpenGL implementation.
|
|
3213 Intended to work even with the most basic OpenGL implementations,
|
|
3214 but also makes use of newer extensions, which allow support for more
|
|
3215 colorspaces and direct rendering.
|
|
3216 Please use \-dr if it works with your OpenGL implementation,
|
|
3217 since for higher resolutions this provides a
|
|
3218 .B big
|
|
3219 speedup.
|
|
3220 The code performs very few checks, so if a feature does not work, this
|
|
3221 might be because it is not supported by your card/OpenGL implementation
|
|
3222 even if you do not get any error message.
|
|
3223 Use glxinfo or a similar tool to display the supported OpenGL extensions.
|
|
3224 .PD 0
|
|
3225 .RSs
|
|
3226 .IPs (no)manyfmts
|
|
3227 Enables support for more (RGB and BGR) color formats (default: enabled).
|
|
3228 Needs OpenGL version >= 1.2.
|
|
3229 .IPs slice-height=<0\-...>
|
|
3230 Number of lines copied to texture in one piece (default: 4).
|
|
3231 0 for whole image.
|
|
3232 .br
|
|
3233 .I NOTE:
|
|
3234 If YUV colorspace is used (see yuv suboption), special rules apply:
|
|
3235 .RSss
|
|
3236 If the decoder uses slice rendering (see \-noslices), this setting
|
|
3237 has no effect, the size of the slices as provided by the decoder is used.
|
|
3238 .br
|
|
3239 If the decoder does not use slice rendering, the default is 16.
|
|
3240 .RE
|
|
3241 .IPs (no)osd
|
|
3242 Enable or disable support for OSD rendering via OpenGL (default: enabled).
|
|
3243 This option is for testing; to disable the OSD use \-osdlevel 0 instead.
|
|
3244 .IPs (no)scaled-osd
|
|
3245 Changes the way the OSD behaves when the size of the
|
|
3246 window changes (default: disabled).
|
|
3247 When enabled behaves more like the other video output drivers,
|
|
3248 which is better for fixed-size fonts.
|
|
3249 Disabled looks much better with FreeType fonts and uses the
|
|
3250 borders in fullscreen mode.
|
|
3251 Does not work correctly with ass subtitles (see \-ass).
|
|
3252 .IPs osdcolor=<0xRRGGBB>
|
|
3253 Color for OSD (default: 0xffffff, corresponds to white).
|
|
3254 .IPs (no)aspect
|
|
3255 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
|
|
3256 Disabling might increase speed.
|
|
3257 .IPs rectangle=<0,1,2>
|
|
3258 Select usage of rectangular textures which saves video RAM, but often is
|
|
3259 slower (default: 0).
|
|
3260 .RSss
|
|
3261 0: Use power-of-two textures (default).
|
|
3262 .br
|
|
3263 1: Use the GL_ARB_texture_rectangle extension.
|
|
3264 .br
|
|
3265 2: Use the GL_ARB_texture_non_power_of_two extension.
|
|
3266 In some cases only supported in software and thus very slow.
|
|
3267 .RE
|
|
3268 .IPs (no)glfinish
|
|
3269 Call glFinish() before swapping buffers.
|
|
3270 Slower but in some cases more correct output (default: disabled).
|
|
3271 .IPs swapinterval=<n>
|
|
3272 Minimum interval between two buffer swaps, counted in
|
|
3273 displayed frames (default: 1).
|
|
3274 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
|
|
3275 Values below 0 will leave it at the system default.
|
|
3276 This limits the framerate to (horizontal refresh rate / n).
|
|
3277 Requires GLX_SGI_swap_control support to work.
|
|
3278 With some (most/all?) implementations this only works in fullscreen mode.
|
|
3279 .IPs yuv=<n>
|
|
3280 Select the type of YUV to RGB conversion.
|
|
3281 .RSss
|
|
3282 0: Use software conversion (default).
|
|
3283 Compatible with all OpenGL versions.
|
|
3284 Provides brightness, contrast and saturation control.
|
|
3285 .br
|
|
3286 1: Use register combiners.
|
|
3287 This uses an nVidia-specific extension (GL_NV_register_combiners).
|
|
3288 At least three texture units are needed.
|
|
3289 Provides saturation and hue control.
|
|
3290 This method is fast but inexact.
|
|
3291 .br
|
|
3292 2: Use a fragment program.
|
|
3293 Needs the GL_ARB_fragment_program extension and at least three texture units.
|
|
3294 Provides brightness, contrast, saturation and hue control.
|
|
3295 .br
|
|
3296 3: Use a fragment program using the POW instruction.
|
|
3297 Needs the GL_ARB_fragment_program extension and at least three texture units.
|
|
3298 Provides brightness, contrast, saturation, hue and gamma control.
|
|
3299 Gamma can also be set independently for red, green and blue.
|
|
3300 Method 4 is usually faster.
|
|
3301 .br
|
|
3302 4: Use a fragment program with additional lookup.
|
|
3303 Needs the GL_ARB_fragment_program extension and at least four texture units.
|
|
3304 Provides brightness, contrast, saturation, hue and gamma control.
|
|
3305 Gamma can also be set independently for red, green and blue.
|
|
3306 .br
|
|
3307 5: Use ATI-specific method (for older cards).
|
|
3308 This uses an ATI-specific extension (GL_ATI_fragment_shader - not
|
|
3309 GL_ARB_fragment_shader!).
|
|
3310 At least three texture units are needed.
|
|
3311 Provides saturation and hue control.
|
|
3312 This method is fast but inexact.
|
|
3313 .br
|
|
3314 6: Use a 3D texture to do conversion via lookup.
|
|
3315 Needs the GL_ARB_fragment_program extension and at least four texture units.
|
|
3316 Extremely slow (software emulation) on some (all?) ATI cards since it uses
|
|
3317 a texture with border pixels.
|
|
3318 Provides brightness, contrast, saturation, hue and gamma control.
|
|
3319 Gamma can also be set independently for red, green and blue.
|
|
3320 Speed depends more on GPU memory bandwidth than other methods.
|
|
3321 .RE
|
|
3322 .IPs lscale=<n>
|
|
3323 Select the scaling function to use for luminance scaling.
|
|
3324 Only valid for yuv modes 2, 3, 4 and 6.
|
|
3325 .RSss
|
|
3326 0: Use simple linear filtering (default).
|
|
3327 .br
|
|
3328 1: Use bicubic filtering (better quality).
|
|
3329 Needs one additional texture unit.
|
|
3330 Older cards will not be able to handle this for chroma at least in fullscreen mode.
|
|
3331 .RE
|
|
3332 .IPs cscale=<n>
|
|
3333 Select the scaling function to use for chrominance scaling.
|
|
3334 For details see lscale.
|
|
3335 .IPs customprog=<filename>
|
|
3336 Load a custom fragment program from <filename>.
|
|
3337 See TOOLS/edgedect.fp for an example.
|
|
3338 .IPs customtex=<filename>
|
|
3339 Load a custom "gamma ramp" texture from <filename>.
|
|
3340 This can be used in combination with yuv=4 or with the customprog option.
|
|
3341 .IPs (no)customtlin
|
|
3342 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
|
|
3343 for customtex texture.
|
|
3344 .IPs (no)customtrect
|
|
3345 If enabled, use texture_rectangle for customtex texture.
|
|
3346 Default is disabled.
|
|
3347 .REss
|
|
3348 .RE
|
|
3349 .PD 1
|
|
3350 .
|
|
3351 .TP
|
|
3352 .B "gl2\ \ \ \ "
|
|
3353 OpenGL video output driver, second generation.
|
|
3354 Supports OSD and videos larger than the maximum texture size.
|
|
3355 .PD 0
|
|
3356 .RSs
|
|
3357 .IPs (no)glfinish
|
|
3358 same as gl (default: enabled)
|
|
3359 .IPs yuv=<n>
|
|
3360 Select the type of YUV to RGB conversion.
|
|
3361 If set to anything except 0 OSD will be disabled and brightness, contrast and
|
|
3362 gamma setting is only available via the global X server settings.
|
|
3363 Apart from this the values have the same meaning as for \-vo gl.
|
|
3364 .REss
|
|
3365 .
|
|
3366 .TP
|
|
3367 .B "null\ \ \ "
|
|
3368 Produces no video output.
|
|
3369 Useful for benchmarking.
|
|
3370 .
|
|
3371 .TP
|
|
3372 .B "aa\ \ \ \ \ "
|
|
3373 ASCII art video output driver that works on a text console.
|
|
3374 You can get a list and an explanation of available suboptions executing
|
|
3375 .I mplayer \-vo aa:help
|
|
3376 .
|
|
3377 .TP
|
|
3378 .B "caca\ \ \ "
|
|
3379 Color ASCII art video output driver that works on a text console.
|
|
3380 .
|
|
3381 .TP
|
|
3382 .B "bl\ \ \ \ \ "
|
|
3383 Video playback using the Blinkenlights UDP protocol.
|
|
3384 This driver is highly hardware specific.
|
|
3385 .PD 0
|
|
3386 .RSs
|
|
3387 .IPs <subdevice>
|
|
3388 Explicitly choose the Blinkenlights subdevice driver to use.
|
|
3389 It is something like arcade:host=localhost:2323 or
|
|
3390 hdl:file=name1,file=name2.
|
|
3391 You must specify a subdevice.
|
|
3392 .RE
|
|
3393 .PD 1
|
|
3394 .
|
|
3395 .TP
|
|
3396 .B "ggi\ \ \ \ "
|
|
3397 GGI graphics system video output driver
|
|
3398 .PD 0
|
|
3399 .RSs
|
|
3400 .IPs <driver>
|
|
3401 Explicitly choose the GGI driver to use.
|
|
3402 Replace any ',' that would appear in the driver string by a '.'.
|
|
3403 .RE
|
|
3404 .PD 1
|
|
3405 .
|
|
3406 .TP
|
|
3407 .B directfb
|
|
3408 Play video using the DirectFB library.
|
|
3409 .PD 0
|
|
3410 .RSs
|
|
3411 .IPs (no)input
|
|
3412 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
|
|
3413 .IPs buffermode=single|double|triple
|
|
3414 Double and triple buffering give best results if you want to avoid tearing issues.
|
|
3415 Triple buffering is more efficient than double buffering as it does
|
|
3416 not block MPlayer while waiting for the vertical retrace.
|
|
3417 Single buffering should be avoided (default: single).
|
|
3418 .IPs fieldparity=top|bottom
|
|
3419 Control the output order for interlaced frames (default: disabled).
|
|
3420 Valid values are top = top fields first, bottom = bottom fields first.
|
|
3421 This option does not have any effect on progressive film material
|
|
3422 like most MPEG movies are.
|
|
3423 You need to enable this option if you have tearing issues or unsmooth
|
|
3424 motions watching interlaced film material.
|
|
3425 .IPs layer=N
|
|
3426 Will force layer with ID N for playback (default: -1 - auto).
|
|
3427 .IPs dfbopts=<list>
|
|
3428 Specify a parameter list for DirectFB.
|
|
3429 .RE
|
|
3430 .PD 1
|
|
3431 .
|
|
3432 .TP
|
|
3433 .B "dfbmga\ "
|
|
3434 Matrox G400/\:G450/\:G550 specific video output driver that uses the
|
|
3435 DirectFB library to make use of special hardware features.
|
|
3436 Enables CRTC2 (second head), displaying video independently of the first head.
|
|
3437 .PD 0
|
|
3438 .RSs
|
|
3439 .IPs (no)input
|
|
3440 same as directfb (default: disabled)
|
|
3441 .IPs buffermode=single|double|triple
|
|
3442 same as directfb (default: triple)
|
|
3443 .IPs fieldparity=top|bottom
|
|
3444 same as directfb
|
|
3445 .IPs (no)bes
|
|
3446 Enable the use of the Matrox BES (backend scaler) (default: disabled).
|
|
3447 Gives very good results concerning speed and output quality as interpolated
|
|
3448 picture processing is done in hardware.
|
|
3449 Works only on the primary head.
|
|
3450 .IPs (no)spic
|
|
3451 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
|
|
3452 .IPs (no)crtc2
|
|
3453 Turn on TV-out on the second head (default: enabled).
|
|
3454 The output quality is amazing as it is a full interlaced picture
|
|
3455 with proper sync to every odd/\:even field.
|
|
3456 .IPs tvnorm=pal|ntsc|auto
|
|
3457 Will set the TV norm of the Matrox card without the need
|
|
3458 for modifying /etc/\:directfbrc (default: disabled).
|
|
3459 Valid norms are pal = PAL, ntsc = NTSC.
|
|
3460 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
|
|
3461 which norm to use by looking at the framerate of the movie.
|
|
3462 .RE
|
|
3463 .PD 1
|
|
3464 .
|
|
3465 .TP
|
|
3466 .B mga (Linux only)
|
|
3467 Matrox specific video output driver that makes use of the YUV back
|
|
3468 end scaler on Gxxx cards through a kernel module.
|
|
3469 If you have a Matrox card, this is the fastest option.
|
|
3470 .PD 0
|
|
3471 .RSs
|
|
3472 .IPs <device>
|
|
3473 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
|
|
3474 .RE
|
|
3475 .PD 1
|
|
3476 .
|
|
3477 .TP
|
|
3478 .B xmga (Linux, X11 only)
|
|
3479 The mga video output driver, running in an X11 window.
|
|
3480 .PD 0
|
|
3481 .RSs
|
|
3482 .IPs <device>
|
|
3483 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
|
|
3484 .RE
|
|
3485 .PD 1
|
|
3486 .
|
|
3487 .TP
|
|
3488 .B "syncfb\ "
|
|
3489 Video output driver for the SyncFB kernel module, which provides
|
|
3490 special hardware features of Matrox Gxxx cards like hardware
|
|
3491 deinterlacing, scaling and synchronizing your video output to
|
|
3492 the vertical retrace of your monitor.
|
|
3493 .
|
|
3494 .TP
|
|
3495 .B 3dfx (Linux only)
|
|
3496 3dfx specific video output driver.
|
|
3497 This driver directly uses the 3dfx hardware on top of X11.
|
|
3498 Only 16 bpp are supported.
|
|
3499 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
|
|
3500 .
|
|
3501 .TP
|
|
3502 .B tdfxfb (Linux only)
|
|
3503 This driver employs the tdfx framebuffer driver to play movies with
|
|
3504 YUV acceleration on 3dfx cards.
|
|
3505 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
|
|
3506 .PD 0
|
|
3507 .RSs
|
|
3508 .IPs <device>
|
|
3509 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
|
|
3510 .RE
|
|
3511 .PD 1
|
|
3512 .
|
|
3513 .TP
|
|
3514 .B tdfx_vid (Linux only)
|
|
3515 3dfx specific video output driver.
|
|
3516 This driver directly uses the tdfx_vid kernel module.
|
|
3517 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
|
|
3518 .PD 0
|
|
3519 .RSs
|
|
3520 .IPs <device>
|
|
3521 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
|
|
3522 .RE
|
|
3523 .PD 1
|
|
3524 .
|
|
3525 .TP
|
|
3526 .B dxr2 (also see \-dxr2) (DXR2 only)
|
|
3527 Creative DXR2 specific video output driver.
|
|
3528 .PD 0
|
|
3529 .RSs
|
|
3530 .IPs <vo_driver>
|
|
3531 Output video subdriver to use as overlay (x11, xv).
|
|
3532 .RE
|
|
3533 .PD 1
|
|
3534 .
|
|
3535 .TP
|
|
3536 .B dxr3 (DXR3 only)
|
|
3537 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
|
|
3538 Hollywood Plus) specific video output driver.
|
|
3539 Also see the lavc video filter.
|
|
3540 .PD 0
|
|
3541 .RSs
|
|
3542 .IPs overlay
|
|
3543 Activates the overlay instead of TVOut.
|
|
3544 .IPs prebuf
|
|
3545 Turns on prebuffering.
|
|
3546 .IPs "sync\ "
|
|
3547 Will turn on the new sync-engine.
|
|
3548 .IPs norm=<norm>
|
|
3549 Specifies the TV norm.
|
|
3550 .RSss
|
|
3551 0: Does not change current norm (default).
|
|
3552 .br
|
|
3553 1: Auto-adjust using PAL/\:NTSC.
|
|
3554 .br
|
|
3555 2: Auto-adjust using PAL/\:PAL-60.
|
|
3556 .br
|
|
3557 3: PAL
|
|
3558 .br
|
|
3559 4: PAL-60
|
|
3560 .br
|
|
3561 5: NTSC
|
|
3562 .REss
|
|
3563 .IPs <0\-3>
|
|
3564 Specifies the device number to use if you have more than one em8300 card.
|
|
3565 .RE
|
|
3566 .PD 1
|
|
3567 .
|
|
3568 .TP
|
|
3569 .B ivtv (IVTV only)
|
|
3570 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
|
|
3571 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
|
|
3572 specific video output driver for TV-Out.
|
|
3573 Also see the lavc video filter.
|
|
3574 .PD 0
|
|
3575 .RSs
|
|
3576 .IPs device
|
|
3577 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
|
|
3578 .IPs output
|
|
3579 Explicitly choose the TV-Out output to be used for the video signal.
|
|
3580 .RE
|
|
3581 .PD 1
|
|
3582 .
|
|
3583 .TP
|
|
3584 .B mpegpes (DVB only)
|
|
3585 Video output driver for DVB cards that writes the output to an MPEG-PES file
|
|
3586 if no DVB card is installed.
|
|
3587 .PD 0
|
|
3588 .RSs
|
|
3589 .IPs card=<1\-4>
|
|
3590 Specifies the device number to use if you have more than one DVB output card
|
|
3591 (V3 API only, such as 1.x.y series drivers).
|
|
3592 .IPs <filename>
|
|
3593 output filename (default: ./grab.mpg)
|
|
3594 .RE
|
|
3595 .PD 1
|
|
3596 .
|
|
3597 .TP
|
|
3598 .B zr (also see \-zr* and \-zrhelp)
|
|
3599 Video output driver for a number of MJPEG capture/\:playback cards.
|
|
3600 .
|
|
3601 .TP
|
|
3602 .B zr2 (also see the zrmjpeg video filter)
|
|
3603 Video output driver for a number of MJPEG capture/\:playback cards,
|
|
3604 second generation.
|
|
3605 .PD 0
|
|
3606 .RSs
|
|
3607 .IPs dev=<device>
|
|
3608 Specifies the video device to use.
|
|
3609 .IPs norm=<PAL|NTSC|SECAM|auto>
|
|
3610 Specifies the video norm to use (default: auto).
|
|
3611 .IPs (no)prebuf
|
|
3612 (De)Activate prebuffering, not yet supported.
|
|
3613 .RE
|
|
3614 .PD 1
|
|
3615 .
|
|
3616 .TP
|
|
3617 .B "md5sum\ "
|
|
3618 Calculate MD5 sums of each frame and write them to a file.
|
|
3619 Supports RGB24 and YV12 colorspaces.
|
|
3620 Useful for debugging.
|
|
3621 .PD 0
|
|
3622 .RSs
|
|
3623 .IPs outfile=<value>
|
|
3624 Specify the output filename (default: ./md5sums).
|
|
3625 .RE
|
|
3626 .PD 1
|
|
3627 .
|
|
3628 .TP
|
|
3629 .B yuv4mpeg
|
|
3630 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
|
|
3631 images and stores it in a file (default: ./stream.yuv).
|
|
3632 The format is the same as the one employed by mjpegtools, so this is
|
|
3633 useful if you want to process the video with the mjpegtools suite.
|
|
3634 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format.
|
|
3635 You can combine it with the \-fixed-vo option to concatenate files
|
|
3636 with the same dimensions and fps value.
|
|
3637 .PD 0
|
|
3638 .RSs
|
|
3639 .IPs interlaced
|
|
3640 Write the output as interlaced frames, top field first.
|
|
3641 .IPs interlaced_bf
|
|
3642 Write the output as interlaced frames, bottom field first.
|
|
3643 .IPs file=<filename>
|
|
3644 Write the output to <filename> instead of the default stream.yuv.
|
|
3645 .REss
|
|
3646 .PD 1
|
|
3647 .RS
|
|
3648 .sp 1
|
|
3649 .I NOTE:
|
|
3650 If you do not specify any option the output is progressive
|
|
3651 (i.e.\& not interlaced).
|
|
3652 .RE
|
|
3653 .
|
|
3654 .TP
|
|
3655 .B "gif89a\ "
|
|
3656 Output each frame into a single animated GIF file in the current directory.
|
|
3657 It supports only RGB format with 24 bpp and the output is converted to 256
|
|
3658 colors.
|
|
3659 .PD 0
|
|
3660 .RSs
|
|
3661 .IPs <fps>
|
|
3662 Float value to specify framerate (default: 5.0).
|
|
3663 .IPs <filename>
|
|
3664 Specify the output filename (default: ./out.gif).
|
|
3665 .REss
|
|
3666 .PD 1
|
|
3667 .RS
|
|
3668 .sp 1
|
|
3669 .I NOTE:
|
|
3670 You must specify the framerate before the filename or the framerate will
|
|
3671 be part of the filename.
|
|
3672 .sp 1
|
|
3673 .I EXAMPLE:
|
|
3674 .RE
|
|
3675 .PD 0
|
|
3676 .RSs
|
|
3677 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif
|
|
3678 .RE
|
|
3679 .PD 1
|
|
3680 .
|
|
3681 .TP
|
|
3682 .B "jpeg\ \ \ "
|
|
3683 Output each frame into a JPEG file in the current directory.
|
|
3684 Each file takes the frame number padded with leading zeros as name.
|
|
3685 .PD 0
|
|
3686 .RSs
|
|
3687 .IPs [no]progressive
|
|
3688 Specify standard or progressive JPEG (default: noprogressive).
|
|
3689 .IPs [no]baseline
|
|
3690 Specify use of baseline or not (default: baseline).
|
|
3691 .IPs optimize=<0\-100>
|
|
3692 optimization factor (default: 100)
|
|
3693 .IPs smooth=<0\-100>
|
|
3694 smooth factor (default: 0)
|
|
3695 .IPs quality=<0\-100>
|
|
3696 quality factor (default: 75)
|
|
3697 .IPs outdir=<dirname>
|
|
3698 Specify the directory to save the JPEG files to (default: ./).
|
|
3699 .IPs subdirs=<prefix>
|
|
3700 Create numbered subdirectories with the specified prefix to
|
|
3701 save the files in instead of the current directory.
|
|
3702 .IPs maxfiles=<value> (subdirs only)
|
|
3703 Maximum number of files to be saved per subdirectory.
|
|
3704 Must be equal to or larger than 1 (default: 1000).
|
|
3705 .RE
|
|
3706 .PD 1
|
|
3707 .
|
|
3708 .TP
|
|
3709 .B "pnm\ \ \ \ "
|
|
3710 Output each frame into a PNM file in the current directory.
|
|
3711 Each file takes the frame number padded with leading zeros as name.
|
|
3712 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
|
|
3713 Also see pnm(5), ppm(5) and pgm(5).
|
|
3714 .PD 0
|
|
3715 .RSs
|
|
3716 .IPs "ppm\ \ "
|
|
3717 Write PPM files (default).
|
|
3718 .IPs "pgm\ \ "
|
|
3719 Write PGM files.
|
|
3720 .IPs pgmyuv
|
|
3721 Write PGMYUV files.
|
|
3722 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
|
|
3723 bottom of the picture.
|
|
3724 .IPs "raw\ \ "
|
|
3725 Write PNM files in raw mode (default).
|
|
3726 .IPs ascii
|
|
3727 Write PNM files in ASCII mode.
|
|
3728 .IPs outdir=<dirname>
|
|
3729 Specify the directory to save the PNM files to (default: ./).
|
|
3730 .IPs subdirs=<prefix>
|
|
3731 Create numbered subdirectories with the specified prefix to
|
|
3732 save the files in instead of the current directory.
|
|
3733 .IPs maxfiles=<value> (subdirs only)
|
|
3734 Maximum number of files to be saved per subdirectory.
|
|
3735 Must be equal to or larger than 1 (default: 1000).
|
|
3736 .RE
|
|
3737 .PD 1
|
|
3738 .
|
|
3739 .TP
|
|
3740 .B "png\ \ \ \ "
|
|
3741 Output each frame into a PNG file in the current directory.
|
|
3742 Each file takes the frame number padded with leading zeros as name.
|
|
3743 24bpp RGB and BGR formats are supported.
|
|
3744 .PD 0
|
|
3745 .RSs
|
|
3746 .IPs z=<0-9>
|
|
3747 Specifies the compression level.
|
|
3748 0 is no compression, 9 is maximum compression.
|
|
3749 .RE
|
|
3750 .PD 1
|
|
3751 .
|
|
3752 .TP
|
|
3753 .B "tga\ \ \ \ "
|
|
3754 Output each frame into a Targa file in the current directory.
|
|
3755 Each file takes the frame number padded with leading zeros as name.
|
|
3756 The purpose of this video output driver is to have a simple lossless
|
|
3757 image writer to use without any external library.
|
|
3758 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
|
|
3759 You can force a particular format with the format video filter.
|
|
3760 .sp 1
|
|
3761 .I EXAMPLE:
|
|
3762 .RE
|
|
3763 .PD 0
|
|
3764 .RSs
|
|
3765 mplayer video.nut \-vf format=bgr15 \-vo tga
|
|
3766 .RE
|
|
3767 .PD 1
|
|
3768 .
|
|
3769 .
|
|
3770 .
|
|
3771 .SH "DECODING/FILTERING OPTIONS"
|
|
3772 .
|
|
3773 .TP
|
|
3774 .B \-ac <[-|+]codec1,[-|+]codec2,...[,]>
|
|
3775 Specify a priority list of audio codecs to be used, according to their codec
|
|
3776 name in codecs.conf.
|
|
3777 Use a '-' before the codec name to omit it.
|
|
3778 Use a '+' before the codec name to force it, this will likely crash!
|
|
3779 If the list has a trailing ',' MPlayer will fall back on codecs not
|
|
3780 contained in the list.
|
|
3781 .br
|
|
3782 .I NOTE:
|
|
3783 See \-ac help for a full list of available codecs.
|
|
3784 .sp 1
|
|
3785 .I EXAMPLE:
|
|
3786 .PD 0
|
|
3787 .RSs
|
|
3788 .IPs "\-ac mp3acm"
|
|
3789 Force the l3codeca.acm MP3 codec.
|
|
3790 .IPs "\-ac mad,"
|
|
3791 Try libmad first, then fall back on others.
|
|
3792 .IPs "\-ac hwac3,a52,"
|
|
3793 Try hardware AC3 passthrough, software AC3, then others.
|
|
3794 .IPs "\-ac hwdts,"
|
|
3795 Try hardware DTS passthrough, then fall back on others.
|
|
3796 .IPs "\-ac -ffmp3,"
|
|
3797 Skip FFmpeg's MP3 decoder.
|
|
3798 .RE
|
|
3799 .PD 1
|
|
3800 .
|
|
3801 .TP
|
|
3802 .B \-af-adv <force=(0\-7):list=(filters)> (also see \-af)
|
|
3803 Specify advanced audio filter options:
|
|
3804 .RSs
|
|
3805 .IPs force=<0\-7>
|
|
3806 Forces the insertion of audio filters to one of the following:
|
|
3807 .RSss
|
|
3808 0: Use completely automatic filter insertion.
|
|
3809 .br
|
|
3810 1: Optimize for accuracy (default).
|
|
3811 .br
|
|
3812 2: Optimize for speed.
|
|
3813 .I Warning:
|
|
3814 Some features in the audio filters may silently fail,
|
|
3815 and the sound quality may drop.
|
|
3816 .br
|
|
3817 3: Use no automatic insertion of filters and no optimization.
|
|
3818 .I Warning:
|
|
3819 It may be possible to crash MPlayer using this setting.
|
|
3820 .br
|
|
3821 4: Use automatic insertion of filters according to 0 above,
|
|
3822 but use floating point processing when possible.
|
|
3823 .br
|
|
3824 5: Use automatic insertion of filters according to 1 above,
|
|
3825 but use floating point processing when possible.
|
|
3826 .br
|
|
3827 6: Use automatic insertion of filters according to 2 above,
|
|
3828 but use floating point processing when possible.
|
|
3829 .br
|
|
3830 7: Use no automatic insertion of filters according to 3 above,
|
|
3831 and use floating point processing when possible.
|
|
3832 .REss
|
|
3833 .IPs list=<filters>
|
|
3834 Same as \-af.
|
|
3835 .RE
|
|
3836 .
|
|
3837 .TP
|
|
3838 .B \-afm <driver1,driver2,...>
|
|
3839 Specify a priority list of audio codec families to be used, according
|
|
3840 to their codec name in codecs.conf.
|
|
3841 Falls back on the default codecs if none of the given codec families work.
|
|
3842 .br
|
|
3843 .I NOTE:
|
|
3844 See \-afm help for a full list of available codec families.
|
|
3845 .sp 1
|
|
3846 .I EXAMPLE:
|
|
3847 .PD 0
|
|
3848 .RSs
|
|
3849 .IPs "\-afm ffmpeg"
|
|
3850 Try FFmpeg's libavcodec codecs first.
|
|
3851 .IPs "\-afm acm,dshow"
|
|
3852 Try Win32 codecs first.
|
|
3853 .RE
|
|
3854 .PD 1
|
|
3855 .
|
|
3856 .TP
|
|
3857 .B \-aspect <ratio> (also see \-zoom)
|
|
3858 Override movie aspect ratio, in case aspect information is
|
|
3859 incorrect or missing in the file being played.
|
|
3860 .sp 1
|
|
3861 .I EXAMPLE:
|
|
3862 .PD 0
|
|
3863 .RSs
|
|
3864 \-aspect 4:3 or \-aspect 1.3333
|
|
3865 .br
|
|
3866 \-aspect 16:9 or \-aspect 1.7777
|
|
3867 .RE
|
|
3868 .PD 1
|
|
3869 .
|
|
3870 .TP
|
|
3871 .B \-noaspect
|
|
3872 Disable automatic movie aspect ratio compensation.
|
|
3873 .
|
|
3874 .TP
|
|
3875 .B "\-flip \ "
|
|
3876 Flip image upside-down.
|
|
3877 .
|
|
3878 .TP
|
|
3879 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
|
|
3880 Specify libavcodec decoding parameters.
|
|
3881 Separate multiple options with a colon.
|
|
3882 .sp 1
|
|
3883 .I EXAMPLE:
|
|
3884 .PD 0
|
|
3885 .RSs
|
|
3886 \-lavdopts gray:skiploopfilter=all:skipframe=nonref
|
|
3887 .RE
|
|
3888 .PD 1
|
|
3889 .sp 1
|
|
3890 .RS
|
|
3891 Available options are:
|
|
3892 .RE
|
|
3893 .RSs
|
|
3894 .IPs bitexact
|
|
3895 Only use bit-exact algorithms in all decoding steps (for codec testing).
|
|
3896 .IPs bug=<value>
|
|
3897 Manually work around encoder bugs.
|
|
3898 .RSss
|
|
3899 0: nothing
|
|
3900 .br
|
|
3901 1: autodetect bugs (default)
|
|
3902 .br
|
|
3903 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
|
|
3904 .br
|
|
3905 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX)
|
|
3906 .br
|
|
3907 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
|
|
3908 .br
|
|
3909 16 (mpeg4): padding bug (autodetected)
|
|
3910 .br
|
|
3911 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
|
|
3912 .br
|
|
3913 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/\:version)
|
|
3914 .br
|
|
3915 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
|
|
3916 .br
|
|
3917 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
|
|
3918 .br
|
|
3919 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
|
|
3920 .br
|
|
3921 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
|
|
3922 .REss
|
|
3923 .IPs debug=<value>
|
|
3924 Display debugging information.
|
|
3925 .RSss
|
|
3926 .br
|
|
3927 0: disabled
|
|
3928 .br
|
|
3929 1: picture info
|
|
3930 .br
|
|
3931 2: rate control
|
|
3932 .br
|
|
3933 4: bitstream
|
|
3934 .br
|
|
3935 8: macroblock (MB) type
|
|
3936 .br
|
|
3937 16: per-block quantization parameter (QP)
|
|
3938 .br
|
|
3939 32: motion vector
|
|
3940 .br
|
|
3941 0x0040: motion vector visualization (use \-noslices)
|
|
3942 .br
|
|
3943 0x0080: macroblock (MB) skip
|
|
3944 .br
|
|
3945 0x0100: startcode
|
|
3946 .br
|
|
3947 0x0200: PTS
|
|
3948 .br
|
|
3949 0x0400: error resilience
|
|
3950 .br
|
|
3951 0x0800: memory management control operations (H.264)
|
|
3952 .br
|
|
3953 0x1000: bugs
|
|
3954 .br
|
|
3955 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
|
|
3956 .br
|
|
3957 0x4000: Visualize block types.
|
|
3958 .REss
|
|
3959 .IPs ec=<value>
|
|
3960 Set error concealment strategy.
|
|
3961 .RSss
|
|
3962 1: Use strong deblock filter for damaged MBs.
|
|
3963 .br
|
|
3964 2: iterative motion vector (MV) search (slow)
|
|
3965 .br
|
|
3966 3: all (default)
|
|
3967 .REss
|
|
3968 .IPs er=<value>
|
|
3969 Set error resilience strategy.
|
|
3970 .RSss
|
|
3971 .br
|
|
3972 0: disabled
|
|
3973 .br
|
|
3974 1: careful (Should work with broken encoders.)
|
|
3975 .br
|
|
3976 2: normal (default) (Works with compliant encoders.)
|
|
3977 .br
|
|
3978 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
|
|
3979 .br
|
|
3980 4: very aggressive
|
|
3981 .REss
|
|
3982 .IPs "fast (MPEG-2 only)"
|
|
3983 Enable optimizations which do not comply to the specification and might
|
|
3984 potentially cause problems, like simpler dequantization, assuming use
|
|
3985 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
|
|
3986 checks to detect damaged bitstreams.
|
|
3987 .IPs "gray\ "
|
|
3988 grayscale only decoding (a bit faster than with color)
|
|
3989 .IPs "idct=<0\-99> (see \-lavcopts)"
|
|
3990 For best decoding quality use the same IDCT algorithm for decoding and encoding.
|
|
3991 This may come at a price in accuracy, though.
|
|
3992 .IPs lowres=<number>[,<w>]
|
|
3993 Decode at lower resolutions.
|
|
3994 Low resolution decoding is not supported by all codecs, and it will
|
|
3995 often result in ugly artifacts.
|
|
3996 This is not a bug, but a side effect of not decoding at full resolution.
|
|
3997 .RSss
|
|
3998 .br
|
|
3999 0: disabled
|
|
4000 .br
|
|
4001 1: 1/2 resolution
|
|
4002 .br
|
|
4003 2: 1/4 resolution
|
|
4004 .br
|
|
4005 3: 1/8 resolution
|
|
4006 .REss
|
|
4007 .RS
|
|
4008 If <w> is specified lowres decoding will be used only if the width of the
|
|
4009 video is major than or equal to <w>.
|
|
4010 .RE
|
|
4011 .IPs "sb=<number> (MPEG-2 only)"
|
|
4012 Skip the given number of macroblock rows at the bottom.
|
|
4013 .IPs "st=<number> (MPEG-2 only)"
|
|
4014 Skip the given number of macroblock rows at the top.
|
|
4015 .IPs skiploopfilter=<skipvalue> (H.264 only)
|
|
4016 Skips the loop filter (AKA deblocking) during H.264 decoding.
|
|
4017 Since the filtered frame is supposed to be used as reference
|
|
4018 for decoding dependent frames this has a worse effect on quality
|
|
4019 than not doing deblocking on e.g.\& MPEG-2 video.
|
|
4020 But at least for high bitrate HDTV this provides a big speedup with
|
|
4021 no visible quality loss.
|
|
4022 .sp 1
|
|
4023 <skipvalue> can be either one of the following:
|
|
4024 .RSss
|
|
4025 .br
|
|
4026 none: Never skip.
|
|
4027 .br
|
|
4028 default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
|
|
4029 .br
|
|
4030 nonref: Skip frames that are not referenced (i.e.\& not used for
|
|
4031 decoding other frames, the error cannot "build up").
|
|
4032 .br
|
|
4033 bidir: Skip B-Frames.
|
|
4034 .br
|
|
4035 nonkey: Skip all frames except keyframes.
|
|
4036 .br
|
|
4037 all: Skip all frames.
|
|
4038 .REss
|
|
4039 .IPs skipidct=<skipvalue> (MPEG1/2 only)
|
|
4040 Skips the IDCT step.
|
|
4041 This degrades quality a lot of in almost all cases
|
|
4042 (see skiploopfilter for available skip values).
|
|
4043 .IPs skipframe=<skipvalue>
|
|
4044 Skips decoding of frames completely.
|
|
4045 Big speedup, but jerky motion and sometimes bad artifacts
|
|
4046 (see skiploopfilter for available skip values).
|
|
4047 .IPs threads=<1\-8>
|
|
4048 number of threads to use for decoding (default: 1)
|
|
4049 .IPs vismv=<value>
|
|
4050 Visualize motion vectors.
|
|
4051 .RSss
|
|
4052 .br
|
|
4053 0: disabled
|
|
4054 .br
|
|
4055 1: Visualize forward predicted MVs of P-frames.
|
|
4056 .br
|
|
4057 2: Visualize forward predicted MVs of B-frames.
|
|
4058 .br
|
|
4059 4: Visualize backward predicted MVs of B-frames.
|
|
4060 .REss
|
|
4061 .IPs vstats
|
|
4062 Prints some statistics and stores them in ./vstats_*.log.
|
|
4063 .RE
|
|
4064 .
|
|
4065 .TP
|
|
4066 .B \-noslices
|
|
4067 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
|
|
4068 whole frame in a single run.
|
|
4069 May be faster or slower, depending on video card and available cache.
|
|
4070 It has effect only with libmpeg2 and libavcodec codecs.
|
|
4071 .
|
|
4072 .TP
|
|
4073 .B \-nosound
|
|
4074 Do not play/\:encode sound.
|
|
4075 Useful for benchmarking.
|
|
4076 .
|
|
4077 .TP
|
|
4078 .B \-novideo
|
|
4079 Do not play/\:encode video.
|
|
4080 In many cases this will not work, use \-vc null \-vo null instead.
|
|
4081 .
|
|
4082 .TP
|
|
4083 .B \-pp <quality> (also see \-vf pp)
|
|
4084 Set the DLL postprocess level.
|
|
4085 This option is no longer usable with \-vf pp.
|
|
4086 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
|
|
4087 The valid range of \-pp values varies by codec, it is mostly
|
|
4088 0\-6, where 0=disable, 6=slowest/\:best.
|
|
4089 .
|
|
4090 .TP
|
|
4091 .B \-pphelp (also see \-vf pp)
|
|
4092 Show a summary about the available postprocess filters and their usage.
|
|
4093 .
|
|
4094 .TP
|
|
4095 .B \-ssf <mode>
|
|
4096 Specifies software scaler parameters.
|
|
4097 .sp 1
|
|
4098 .I EXAMPLE:
|
|
4099 .PD 0
|
|
4100 .RSs
|
|
4101 \-vf scale \-ssf lgb=3.0
|
|
4102 .RE
|
|
4103 .PD 1
|
|
4104 .PD 0
|
|
4105 .RSs
|
|
4106 .IPs lgb=<0\-100>
|
|
4107 gaussian blur filter (luma)
|
|
4108 .IPs cgb=<0\-100>
|
|
4109 gaussian blur filter (chroma)
|
|
4110 .IPs ls=<-100\-100>
|
|
4111 sharpen filter (luma)
|
|
4112 .IPs cs=<-100\-100>
|
|
4113 sharpen filter (chroma)
|
|
4114 .IPs chs=<h>
|
|
4115 chroma horizontal shifting
|
|
4116 .IPs cvs=<v>
|
|
4117 chroma vertical shifting
|
|
4118 .RE
|
|
4119 .PD 1
|
|
4120 .
|
|
4121 .TP
|
|
4122 .B \-stereo <mode>
|
|
4123 Select type of MP2/\:MP3 stereo output.
|
|
4124 .PD 0
|
|
4125 .RSs
|
|
4126 .IPs 0
|
|
4127 stereo
|
|
4128 .IPs 1
|
|
4129 left channel
|
|
4130 .IPs 2
|
|
4131 right channel
|
|
4132 .RE
|
|
4133 .PD 1
|
|
4134 .
|
|
4135 .TP
|
|
4136 .B \-sws <software scaler type> (also see \-vf scale and \-zoom)
|
|
4137 Specify the software scaler algorithm to be used with the \-zoom option.
|
|
4138 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
|
|
4139 .sp 1
|
|
4140 Available types are:
|
|
4141 .sp 1
|
|
4142 .PD 0
|
|
4143 .RSs
|
|
4144 .IPs 0
|
|
4145 fast bilinear
|
|
4146 .IPs 1
|
|
4147 bilinear
|
|
4148 .IPs 2
|
|
4149 bicubic (good quality) (default)
|
|
4150 .IPs 3
|
|
4151 experimental
|
|
4152 .IPs 4
|
|
4153 nearest neighbor (bad quality)
|
|
4154 .IPs 5
|
|
4155 area
|
|
4156 .IPs 6
|
|
4157 luma bicubic / chroma bilinear
|
|
4158 .IPs 7
|
|
4159 gauss
|
|
4160 .IPs 8
|
|
4161 sincR
|
|
4162 .IPs 9
|
|
4163 lanczos
|
|
4164 .IPs 10
|
|
4165 natural bicubic spline
|
|
4166 .RE
|
|
4167 .PD 1
|
|
4168 .sp 1
|
|
4169 .RS
|
|
4170 .I NOTE:
|
|
4171 Some \-sws options are tunable.
|
|
4172 The description of the scale video filter has further information.
|
|
4173 .RE
|
|
4174 .
|
|
4175 .TP
|
|
4176 .B \-vc <[-|+]codec1,[-|+]codec2,...[,]>
|
|
4177 Specify a priority list of video codecs to be used, according to their codec
|
|
4178 name in codecs.conf.
|
|
4179 Use a '-' before the codec name to omit it.
|
|
4180 Use a '+' before the codec name to force it, this will likely crash!
|
|
4181 If the list has a trailing ',' MPlayer will fall back on codecs not
|
|
4182 contained in the list.
|
|
4183 .br
|
|
4184 .I NOTE:
|
|
4185 See \-vc help for a full list of available codecs.
|
|
4186 .sp 1
|
|
4187 .I EXAMPLE:
|
|
4188 .PD 0
|
|
4189 .RSs
|
|
4190 .IPs "\-vc divx"
|
|
4191 Force Win32/\:VfW DivX codec, no fallback.
|
|
4192 .IPs "\-vc -divxds,-divx,"
|
|
4193 Skip Win32 DivX codecs.
|
|
4194 .IPs "\-vc ffmpeg12,mpeg12,"
|
|
4195 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
|
|
4196 .RE
|
|
4197 .PD 1
|
|
4198 .
|
|
4199 .TP
|
|
4200 .B \-vfm <driver1,driver2,...>
|
|
4201 Specify a priority list of video codec families to be used, according
|
|
4202 to their names in codecs.conf.
|
|
4203 Falls back on the default codecs if none of the given codec families work.
|
|
4204 .br
|
|
4205 .I NOTE:
|
|
4206 See \-vfm help for a full list of available codec families.
|
|
4207 .sp 1
|
|
4208 .I EXAMPLE:
|
|
4209 .PD 0
|
|
4210 .RSs
|
|
4211 .IPs "\-vfm ffmpeg,dshow,vfw"
|
|
4212 Try the libavcodec, then Directshow, then VfW codecs and fall back
|
|
4213 on others, if they do not work.
|
|
4214 .IPs "\-vfm xanim"
|
|
4215 Try XAnim codecs first.
|
|
4216 .RE
|
|
4217 .PD 1
|
|
4218 .
|
|
4219 .TP
|
|
4220 .B \-x <x> (also see \-zoom) (MPlayer only)
|
|
4221 Scale image to width <x> (if software/\:hardware scaling is available).
|
|
4222 Disables aspect calculations.
|
|
4223 .
|
|
4224 .TP
|
|
4225 .B \-xvidopts <option1:option2:...>
|
|
4226 Specify additional parameters when decoding with XviD.
|
|
4227 .br
|
|
4228 .I NOTE:
|
|
4229 Since libavcodec is faster than XviD you might want to use the libavcodec
|
|
4230 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
|
|
4231 .sp 1
|
|
4232 XviD's internal postprocessing filters:
|
|
4233 .PD 0
|
|
4234 .RSs
|
|
4235 .IPs deblock-chroma (also see \-vf pp)
|
|
4236 chroma deblock filter
|
|
4237 .IPs deblock-luma (also see \-vf pp)
|
|
4238 luma deblock filter
|
|
4239 .IPs dering-luma (also see \-vf pp)
|
|
4240 luma deringing filter
|
|
4241 .IPs dering-chroma (also see \-vf pp)
|
|
4242 chroma deringing filter
|
|
4243 .IPs filmeffect (also see \-vf noise)
|
|
4244 Adds artificial film grain to the video.
|
|
4245 May increase perceived quality, while lowering true quality.
|
|
4246 .RE
|
|
4247 .sp 1
|
|
4248 .RS
|
|
4249 rendering methods:
|
|
4250 .RE
|
|
4251 .PD 0
|
|
4252 .RSs
|
|
4253 .IPs "dr2\ \ "
|
|
4254 Activate direct rendering method 2.
|
|
4255 .IPs nodr2
|
|
4256 Deactivate direct rendering method 2.
|
|
4257 .RE
|
|
4258 .PD 1
|
|
4259 .
|
|
4260 .TP
|
|
4261 .B \-xy <value> (also see \-zoom)
|
|
4262 .PD 0
|
|
4263 .RSs
|
|
4264 .IPs value<=8
|
|
4265 Scale image by factor <value>.
|
|
4266 .IPs value>8
|
|
4267 Set width to value and calculate height to keep correct aspect ratio.
|
|
4268 .RE
|
|
4269 .PD 1
|
|
4270 .
|
|
4271 .TP
|
|
4272 .B \-y <y> (also see \-zoom) (MPlayer only)
|
|
4273 Scale image to height <y> (if software/\:hardware scaling is available).
|
|
4274 Disables aspect calculations.
|
|
4275 .
|
|
4276 .TP
|
|
4277 .B "\-zoom\ \ "
|
|
4278 Allow software scaling, where available.
|
|
4279 This will allow scaling with output drivers (like x11, fbdev) that
|
|
4280 do not support hardware scaling where MPlayer disables scaling by
|
|
4281 default for performance reasons.
|
|
4282 .
|
|
4283 .
|
|
4284 .
|
|
4285 .SH "AUDIO FILTERS"
|
|
4286 Audio filters allow you to modify the audio stream and its properties.
|
|
4287 The syntax is:
|
|
4288 .
|
|
4289 .TP
|
|
4290 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
|
|
4291 Setup a chain of audio filters.
|
|
4292 .PP
|
|
4293 .I NOTE:
|
|
4294 To get a full list of available audio filters, see \-af help.
|
|
4295 .PP
|
|
4296 Available filters are:
|
|
4297 .
|
|
4298 .TP
|
|
4299 .B resample[=srate[:sloppy[:type]]]
|
|
4300 Changes the sample rate of the audio stream.
|
|
4301 Can be used if you have a fixed frequency sound card or if you are
|
|
4302 stuck with an old sound card that is only capable of max 44.1kHz.
|
|
4303 This filter is automatically enabled if necessary.
|
|
4304 It only supports 16-bit integer and float in native-endian format as input.
|
|
4305 .br
|
|
4306 .I NOTE:
|
|
4307 With MEncoder, you need to also use \-srate <srate>.
|
|
4308 .PD 0
|
|
4309 .RSs
|
|
4310 .IPs <srate>
|
|
4311 output sample frequency in Hz.
|
|
4312 The valid range for this parameter is 8000 to 192000.
|
|
4313 If the input and output sample frequency are the same or if this
|
|
4314 parameter is omitted the filter is automatically unloaded.
|
|
4315 A high sample frequency normally improves the audio quality,
|
|
4316 especially when used in combination with other filters.
|
|
4317 .IPs <sloppy>
|
|
4318 Allow (1) or disallow (0) the output frequency to differ slightly
|
|
4319 from the frequency given by <srate> (default: 1).
|
|
4320 Can be used if the startup of the playback is extremely slow.
|
|
4321 .IPs <type>
|
|
4322 Selects which resampling method to use.
|
|
4323 .RSss
|
|
4324 0: linear interpolation (fast, poor quality especially when upsampling)
|
|
4325 .br
|
|
4326 1: polyphase filterbank and integer processing
|
|
4327 .br
|
|
4328 2: polyphase filterbank and floating point processing (slow, best quality)
|
|
4329 .REss
|
|
4330 .PD 1
|
|
4331 .RE
|
|
4332 .sp 1
|
|
4333 .RS
|
|
4334 .I EXAMPLE:
|
|
4335 .RE
|
|
4336 .PD 0
|
|
4337 .RSs
|
|
4338 .IPs "mplayer \-af resample=44100:0:0"
|
|
4339 would set the output frequency of the resample filter to 44100Hz using
|
|
4340 exact output frequency scaling and linear interpolation.
|
|
4341 .RE
|
|
4342 .PD 1
|
|
4343 .
|
|
4344 .TP
|
|
4345 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
|
|
4346 Changes the sample rate of the audio stream to an integer <srate> in Hz.
|
|
4347 It only supports the 16-bit native-endian format.
|
|
4348 .br
|
|
4349 .I NOTE:
|
|
4350 With MEncoder, you need to also use \-srate <srate>.
|
|
4351 .PD 0
|
|
4352 .RSs
|
|
4353 .IPs <srate>
|
|
4354 the output sample rate
|
|
4355 .IPs <length>
|
|
4356 length of the filter with respect to the lower sampling rate (default: 16)
|
|
4357 .IPs <linear>
|
|
4358 if 1 then filters will be linearly interpolated between polyphase entries
|
|
4359 .IPs <count>
|
|
4360 log2 of the number of polyphase entries
|
|
4361 (..., 10->1024, 11->2048, 12->4096, ...)
|
|
4362 (default: 10->1024)
|
|
4363 .IPs <cutoff>
|
|
4364 cutoff frequency (0.0-1.0), default set depending upon filter length
|
|
4365 .RE
|
|
4366 .PD 1
|
|
4367 .
|
|
4368 .TP
|
|
4369 .B sweep[=speed]
|
|
4370 Produces a sine sweep.
|
|
4371 .PD 0
|
|
4372 .RSs
|
|
4373 .IPs <0.0\-1.0>
|
|
4374 Sine function delta, use very low values to hear the sweep.
|
|
4375 .RE
|
|
4376 .PD 1
|
|
4377 .
|
|
4378 .TP
|
|
4379 .B sinesuppress[=freq:decay]
|
|
4380 Remove a sine at the specified frequency.
|
|
4381 Useful to get rid of the 50/60Hz noise on low quality audio equipment.
|
|
4382 It probably only works on mono input.
|
|
4383 .PD 0
|
|
4384 .RSs
|
|
4385 .IPs <freq>
|
|
4386 The frequency of the sine which should be removed (in Hz) (default: 50)
|
|
4387 .IPs <decay>
|
|
4388 Controls the adaptivity (a larger value will make the filter adapt to
|
|
4389 amplitude and phase changes quicker, a smaller value will make the
|
|
4390 adaptation slower) (default: 0.0001).
|
|
4391 Reasonable values are around 0.001.
|
|
4392 .RE
|
|
4393 .PD 1
|
|
4394 .
|
|
4395 .TP
|
|
4396 .B hrtf[=flag]
|
|
4397 Head-related transfer function: Converts multichannel audio to
|
|
4398 2 channel output for headphones, preserving the spatiality of the sound.
|
|
4399 .sp 1
|
|
4400 .PD 0
|
|
4401 .RS
|
|
4402 .IPs "Flag Meaning"
|
|
4403 .IPs "m matrix decoding of the rear channel"
|
|
4404 .IPs "s 2-channel matrix decoding"
|
|
4405 .IPs "0 no matrix decoding (default)"
|
|
4406 .RE
|
|
4407 .PD 1
|
|
4408 .
|
|
4409 .TP
|
|
4410 .B equalizer=[g1:g2:g3:...:g10]
|
|
4411 10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
|
|
4412 This means that it works regardless of what type of audio is being played back.
|
|
4413 The center frequencies for the 10 bands are:
|
|
4414 .sp 1
|
|
4415 .PD 0
|
|
4416 .RS
|
|
4417 .IPs "No. frequency"
|
|
4418 .IPs "0 31.25 Hz"
|
|
4419 .IPs "1 62.50 Hz"
|
|
4420 .IPs "2 125.00 Hz"
|
|
4421 .IPs "3 250.00 Hz"
|
|
4422 .IPs "4 500.00 Hz"
|
|
4423 .IPs "5 1.00 kHz"
|
|
4424 .IPs "6 2.00 kHz"
|
|
4425 .IPs "7 4.00 kHz"
|
|
4426 .IPs "8 8.00 kHz"
|
|
4427 .IPs "9 16.00 kHz"
|
|
4428 .RE
|
|
4429 .PD 1
|
|
4430 .sp 1
|
|
4431 .RS
|
|
4432 If the sample rate of the sound being played is lower than the center
|
|
4433 frequency for a frequency band, then that band will be disabled.
|
|
4434 A known bug with this filter is that the characteristics for the
|
|
4435 uppermost band are not completely symmetric if the sample
|
|
4436 rate is close to the center frequency of that band.
|
|
4437 This problem can be worked around by upsampling the sound
|
|
4438 using the resample filter before it reaches this filter.
|
|
4439 .RE
|
|
4440 .PD 0
|
|
4441 .RSs
|
|
4442 .IPs <g1>:<g2>:<g3>:...:<g10>
|
|
4443 floating point numbers representing the gain in dB
|
|
4444 for each frequency band (-12\-12)
|
|
4445 .RE
|
|
4446 .sp 1
|
|
4447 .RS
|
|
4448 .I EXAMPLE:
|
|
4449 .RE
|
|
4450 .RSs
|
|
4451 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi"
|
|
4452 Would amplify the sound in the upper and lower frequency region
|
|
4453 while canceling it almost completely around 1kHz.
|
|
4454 .RE
|
|
4455 .PD 1
|
|
4456 .
|
|
4457 .TP
|
|
4458 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
|
|
4459 Can be used for adding, removing, routing and copying audio channels.
|
|
4460 If only <nch> is given the default routing is used, it works as
|
|
4461 follows: If the number of output channels is bigger than the number of
|
|
4462 input channels empty channels are inserted (except mixing from mono to
|
|
4463 stereo, then the mono channel is repeated in both of the output
|
|
4464 channels).
|
|
4465 If the number of output channels is smaller than the number
|
|
4466 of input channels the exceeding channels are truncated.
|
|
4467 .PD 0
|
|
4468 .RSs
|
|
4469 .IPs <nch>
|
|
4470 number of output channels (1\-6)
|
|
4471 .IPs "<nr>\ "
|
|
4472 number of routes (1\-6)
|
|
4473 .IPs <from1:to1:from2:to2:from3:to3:...>
|
|
4474 Pairs of numbers between 0 and 5 that define where to route each channel.
|
|
4475 .RE
|
|
4476 .sp 1
|
|
4477 .RS
|
|
4478 .I EXAMPLE:
|
|
4479 .RE
|
|
4480 .RSs
|
|
4481 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
|
|
4482 Would change the number of channels to 4 and set up 4 routes that
|
|
4483 swap channel 0 and channel 1 and leave channel 2 and 3 intact.
|
|
4484 Observe that if media containing two channels was played back, channels
|
|
4485 2 and 3 would contain silence but 0 and 1 would still be swapped.
|
|
4486 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
|
|
4487 Would change the number of channels to 6 and set up 4 routes
|
|
4488 that copy channel 0 to channels 0 to 3.
|
|
4489 Channel 4 and 5 will contain silence.
|
|
4490 .RE
|
|
4491 .PD 1
|
|
4492 .
|
|
4493 .TP
|
|
4494 .B format[=format] (also see \-format)
|
|
4495 Convert between different sample formats.
|
|
4496 Automatically enabled when needed by the sound card or another filter.
|
|
4497 .PD 0
|
|
4498 .RSs
|
|
4499 .IPs <format>
|
|
4500 Sets the desired format.
|
|
4501 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
|
|
4502 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
|
|
4503 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
|
|
4504 and 'ne' the endianness of the computer MPlayer is running on).
|
|
4505 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
|
|
4506 Exceptions to this rule that are also valid format specifiers: u8, s8,
|
|
4507 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
|
|
4508 .RE
|
|
4509 .PD 1
|
|
4510 .
|
|
4511 .TP
|
|
4512 .B volume[=v[:sc]]
|
|
4513 Implements software volume control.
|
|
4514 Use this filter with caution since it can reduce the signal
|
|
4515 to noise ratio of the sound.
|
|
4516 In most cases it is best to set the level for the PCM sound to max,
|
|
4517 leave this filter out and control the output level to your
|
|
4518 speakers with the master volume control of the mixer.
|
|
4519 In case your sound card has a digital PCM mixer instead of an analog
|
|
4520 one, and you hear distortion, use the MASTER mixer instead.
|
|
4521 If there is an external amplifier connected to the computer (this
|
|
4522 is almost always the case), the noise level can be minimized by
|
|
4523 adjusting the master level and the volume knob on the amplifier
|
|
4524 until the hissing noise in the background is gone.
|
|
4525 .br
|
|
4526 This filter has a second feature: It measures the overall maximum
|
|
4527 sound level and prints out that level when MPlayer exits.
|
|
4528 This volume estimate can be used for setting the sound level in
|
|
4529 MEncoder such that the maximum dynamic range is utilized.
|
|
4530 .br
|
|
4531 .I NOTE:
|
|
4532 This filter is not reentrant and can therefore only be enabled
|
|
4533 once for every audio stream.
|
|
4534 .PD 0
|
|
4535 .RSs
|
|
4536 .IPs "<v>\ \ "
|
|
4537 Sets the desired gain in dB for all channels in the stream
|
|
4538 from -200dB to +60dB, where -200dB mutes the sound
|
|
4539 completely and +60dB equals a gain of 1000 (default: 0).
|
|
4540 .IPs "<sc>\ "
|
|
4541 Turns soft clipping on (1) or off (0).
|
|
4542 Soft-clipping can make the sound more smooth if very
|
|
4543 high volume levels are used.
|
|
4544 Enable this option if the dynamic range of the
|
|
4545 loudspeakers is very low.
|
|
4546 .br
|
|
4547 .I WARNING:
|
|
4548 This feature creates distortion and should be considered a last resort.
|
|
4549 .RE
|
|
4550 .sp 1
|
|
4551 .RS
|
|
4552 .I EXAMPLE:
|
|
4553 .RE
|
|
4554 .RSs
|
|
4555 .IPs "mplayer \-af volume=10.1:0 media.avi"
|
|
4556 Would amplify the sound by 10.1dB and hard-clip if the
|
|
4557 sound level is too high.
|
|
4558 .RE
|
|
4559 .PD 1
|
|
4560 .
|
|
4561 .TP
|
|
4562 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
|
|
4563 Mixes channels arbitrarily.
|
|
4564 Basically a combination of the volume and the channels filter
|
|
4565 that can be used to down-mix many channels to only a few,
|
|
4566 e.g.\& stereo to mono or vary the "width" of the center
|
|
4567 speaker in a surround sound system.
|
|
4568 This filter is hard to use, and will require some tinkering
|
|
4569 before the desired result is obtained.
|
|
4570 The number of options for this filter depends on
|
|
4571 the number of output channels.
|
|
4572 An example how to downmix a six-channel file to two channels with
|
|
4573 this filter can be found in the examples section near the end.
|
|
4574 .PD 0
|
|
4575 .RSs
|
|
4576 .IPs "<n>\ \ "
|
|
4577 number of output channels (1\-6)
|
|
4578 .IPs <Lij>
|
|
4579 How much of input channel i is mixed into output channel j (0\-1).
|
|
4580 So in principle you first have n numbers saying what to do with the
|
|
4581 first input channel, then n numbers that act on the second input channel
|
|
4582 etc.
|
|
4583 If you do not specify any numbers for some input channels, 0 is assumed.
|
|
4584 .RE
|
|
4585 .sp 1
|
|
4586 .RS
|
|
4587 .I EXAMPLE:
|
|
4588 .RE
|
|
4589 .RSs
|
|
4590 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
|
|
4591 Would down-mix from stereo to mono.
|
|
4592 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
|
|
4593 Would give 3 channel output leaving channels 0 and 1 intact,
|
|
4594 and mix channels 0 and 1 into output channel 2 (which could
|
|
4595 be sent to a subwoofer for example).
|
|
4596 .RE
|
|
4597 .PD 1
|
|
4598 .
|
|
4599 .TP
|
|
4600 .B sub[=fc:ch]
|
|
4601 Adds a subwoofer channel to the audio stream.
|
|
4602 The audio data used for creating the subwoofer channel is
|
|
4603 an average of the sound in channel 0 and channel 1.
|
|
4604 The resulting sound is then low-pass filtered by a 4th order
|
|
4605 Butterworth filter with a default cutoff frequency of 60Hz
|
|
4606 and added to a separate channel in the audio stream.
|
|
4607 .br
|
|
4608 .I Warning:
|
|
4609 Disable this filter when you are playing DVDs with Dolby
|
|
4610 Digital 5.1 sound, otherwise this filter will disrupt
|
|
4611 the sound to the subwoofer.
|
|
4612 .PD 0
|
|
4613 .RSs
|
|
4614 .IPs "<fc>\ "
|
|
4615 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
|
|
4616 For the best result try setting the cutoff frequency as low as possible.
|
|
4617 This will improve the stereo or surround sound experience.
|
|
4618 .IPs "<ch>\ "
|
|
4619 Determines the channel number in which to insert the sub-channel audio.
|
|
4620 Channel number can be between 0 and 5 (default: 5).
|
|
4621 Observe that the number of channels will automatically
|
|
4622 be increased to <ch> if necessary.
|
|
4623 .RE
|
|
4624 .sp 1
|
|
4625 .RS
|
|
4626 .I EXAMPLE:
|
|
4627 .RE
|
|
4628 .RSs
|
|
4629 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
|
|
4630 Would add a sub-woofer channel with a cutoff frequency of
|
|
4631 100Hz to output channel 4.
|
|
4632 .RE
|
|
4633 .PD 1
|
|
4634 .
|
|
4635 .TP
|
|
4636 .B "center\ "
|
|
4637 Creates a center channel from the front channels.
|
|
4638 May currently be low quality as it does not implement a
|
|
4639 high-pass filter for proper extraction yet, but averages and
|
|
4640 halves the channels instead.
|
|
4641 .PD 0
|
|
4642 .RSs
|
|
4643 .IPs "<ch>\ "
|
|
4644 Determines the channel number in which to insert the center channel.
|
|
4645 Channel number can be between 0 and 5 (default: 5).
|
|
4646 Observe that the number of channels will automatically
|
|
4647 be increased to <ch> if necessary.
|
|
4648 .RE
|
|
4649 .PD 1
|
|
4650 .
|
|
4651 .TP
|
|
4652 .B surround[=delay]
|
|
4653 Decoder for matrix encoded surround sound like Dolby Surround.
|
|
4654 Many files with 2 channel audio actually contain matrixed surround sound.
|
|
4655 Requires a sound card supporting at least 4 channels.
|
|
4656 .PD 0
|
|
4657 .RSs
|
|
4658 .IPs <delay>
|
|
4659 delay time in ms for the rear speakers (0 to 1000) (default: 20)
|
|
4660 This delay should be set as follows: If d1 is the distance
|
|
4661 from the listening position to the front speakers and d2 is the distance
|
|
4662 from the listening position to the rear speakers, then the delay should
|
|
4663 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
|
|
4664 .RE
|
|
4665 .sp 1
|
|
4666 .RS
|
|
4667 .I EXAMPLE:
|
|
4668 .RE
|
|
4669 .RSs
|
|
4670 .IPs "mplayer \-af surround=15 \-channels 4 media.avi"
|
|
4671 Would add surround sound decoding with 15ms delay for the sound to the
|
|
4672 rear speakers.
|
|
4673 .RE
|
|
4674 .PD 1
|
|
4675 .
|
|
4676 .TP
|
|
4677 .B delay[=ch1:ch2:...]
|
|
4678 Delays the sound to the loudspeakers such that the sound from the
|
|
4679 different channels arrives at the listening position simultaneously.
|
|
4680 It is only useful if you have more than 2 loudspeakers.
|
|
4681 .PD 0
|
|
4682 .RSs
|
|
4683 .IPs ch1,ch2,...
|
|
4684 The delay in ms that should be imposed on each channel
|
|
4685 (floating point number between 0 and 1000).
|
|
4686 .RE
|
|
4687 .PD 1
|
|
4688 .sp 1
|
|
4689 .RS
|
|
4690 To calculate the required delay for the different channels do as follows:
|
|
4691 .IP 1. 3
|
|
4692 Measure the distance to the loudspeakers in meters in relation
|
|
4693 to your listening position, giving you the distances s1 to s5
|
|
4694 (for a 5.1 system).
|
|
4695 There is no point in compensating for the subwoofer (you will not hear the
|
|
4696 difference anyway).
|
|
4697 .IP 2. 3
|
|
4698 Subtract the distances s1 to s5 from the maximum distance,
|
|
4699 i.e.\& s[i] = max(s) - s[i]; i = 1...5.
|
|
4700 .IP 3.
|
|
4701 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
|
|
4702 .RE
|
|
4703 .PD 0
|
|
4704 .sp 1
|
|
4705 .RS
|
|
4706 .I EXAMPLE:
|
|
4707 .RE
|
|
4708 .RSs
|
|
4709 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
|
|
4710 Would delay front left and right by 10.5ms, the two rear channels
|
|
4711 and the sub by 0ms and the center channel by 7ms.
|
|
4712 .RE
|
|
4713 .PD 1
|
|
4714 .
|
|
4715 .TP
|
|
4716 .B export[=mmapped_file[:nsamples]]
|
|
4717 Exports the incoming signal to other processes using memory mapping (mmap()).
|
|
4718 Memory mapped areas contain a header:
|
|
4719 .sp 1
|
|
4720 .nf
|
|
4721 int nch /*number of channels*/
|
|
4722 int size /*buffer size*/
|
|
4723 unsigned long long counter /*Used to keep sync, updated every
|
|
4724 time new data is exported.*/
|
|
4725 .fi
|
|
4726 .sp 1
|
|
4727 The rest is payload (non-interleaved) 16 bit data.
|
|
4728 .PD 0
|
|
4729 .RSs
|
|
4730 .IPs <mmapped_file>
|
|
4731 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
|
|
4732 .IPs <nsamples>
|
|
4733 number of samples per channel (default: 512)
|
|
4734 .RE
|
|
4735 .sp 1
|
|
4736 .RS
|
|
4737 .I EXAMPLE:
|
|
4738 .RE
|
|
4739 .RSs
|
|
4740 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
|
|
4741 Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
|
|
4742 .RE
|
|
4743 .PD 1
|
|
4744 .
|
|
4745 .TP
|
|
4746 .B extrastereo[=mul]
|
|
4747 (Linearly) increases the difference between left and right channels
|
|
4748 which adds some sort of "live" effect to playback.
|
|
4749 .PD 0
|
|
4750 .RSs
|
|
4751 .IPs <mul>
|
|
4752 Sets the difference coefficient (default: 2.5).
|
|
4753 0.0 means mono sound (average of both channels), with 1.0 sound will be
|
|
4754 unchanged, with -1.0 left and right channels will be swapped.
|
|
4755 .RE
|
|
4756 .PD 1
|
|
4757 .
|
|
4758 .TP
|
|
4759 .B volnorm[=method:target]
|
|
4760 Maximizes the volume without distorting the sound.
|
|
4761 .PD 0
|
|
4762 .RSs
|
|
4763 .IPs <method>
|
|
4764 Sets the used method.
|
|
4765 .RSss
|
|
4766 1: Use a single sample to smooth the variations via the standard
|
|
4767 weighted mean over past samples (default).
|
|
4768 .br
|
|
4769 2: Use several samples to smooth the variations via the standard
|
|
4770 weighted mean over past samples.
|
|
4771 .REss
|
|
4772 .IPs <target>
|
|
4773 Sets the target amplitude as a fraction of the maximum for the
|
|
4774 sample type (default: 0.25).
|
|
4775 .RE
|
|
4776 .PD 1
|
|
4777 .
|
|
4778 .TP
|
|
4779 .B ladspa=file:label[:controls...]
|
|
4780 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
|
|
4781 This filter is reentrant, so multiple LADSPA plugins can be used at once.
|
|
4782 .PD 0
|
|
4783 .RSs
|
|
4784 .IPs <file>
|
|
4785 Specifies the LADSPA plugin library file.
|
|
4786 If LADSPA_PATH is set, it searches for the specified file.
|
|
4787 If it is not set, you must supply a fully specified pathname.
|
|
4788 .IPs <label>
|
|
4789 Specifies the filter within the library.
|
|
4790 Some libraries contain only one filter, but others contain many of them.
|
|
4791 Entering 'help' here, will list all available filters within the specified
|
|
4792 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
|
|
4793 .IPs <controls>
|
|
4794 Controls are zero or more floating point values that determine the
|
|
4795 behavior of the loaded plugin (for example delay, threshold or gain).
|
|
4796 In verbose mode (add \-v to the MPlayer command line), all available controls
|
|
4797 and their valid ranges are printed.
|
|
4798 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
|
|
4799 .RE
|
|
4800 .PD 1
|
|
4801 .
|
|
4802 .TP
|
|
4803 .B "comp\ \ \ "
|
|
4804 Compressor/expander filter usable for microphone input.
|
|
4805 Prevents artifacts on very loud sound and raises the volume on
|
|
4806 very low sound.
|
|
4807 This filter is untested, maybe even unusable.
|
|
4808 .
|
|
4809 .TP
|
|
4810 .B "gate\ \ \ "
|
|
4811 Noise gate filter similar to the comp audio filter.
|
|
4812 This filter is untested, maybe even unusable.
|
|
4813 .
|
|
4814 .TP
|
|
4815 .B karaoke
|
|
4816 Simple voice removal filter exploiting the fact that voice is
|
|
4817 usually recorded with mono gear and later 'center' mixed onto
|
|
4818 the final audio stream.
|
|
4819 Beware that this filter will turn your signal into mono.
|
|
4820 Works well for 2 channel tracks; do not bother trying it
|
|
4821 on anything but 2 channel stereo.
|
|
4822 .
|
|
4823 .
|
|
4824 .
|
|
4825 .SH "VIDEO FILTERS"
|
|
4826 Video filters allow you to modify the video stream and its properties.
|
|
4827 The syntax is:
|
|
4828 .
|
|
4829 .TP
|
|
4830 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
|
|
4831 Setup a chain of video filters.
|
|
4832 .
|
|
4833 .TP
|
|
4834 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE)
|
|
4835 Setup a chain of video filters, to be applied in
|
|
4836 .B reverse
|
|
4837 order.
|
|
4838 Deprecated in favor of \-vf.
|
|
4839 .PP
|
|
4840 Many parameters are optional and set to default values if omitted.
|
|
4841 To explicitly use a default value set a parameter to '-1'.
|
|
4842 Parameters w:h means width x height in pixels, x:y means x;y position counted
|
|
4843 from the upper left corner of the bigger image.
|
|
4844 .br
|
|
4845 .I NOTE:
|
|
4846 To get a full list of available video filters, see \-vf help.
|
|
4847 .sp 1
|
|
4848 Video filters are managed in lists.
|
|
4849 There are a few commands to manage the filter list.
|
|
4850 .
|
|
4851 .TP
|
|
4852 .B \-vf-add <filter1[,filter2,...]>
|
|
4853 Appends the filters given as arguments to the filter list.
|
|
4854 .
|
|
4855 .TP
|
|
4856 .B \-vf-pre <filter1[,filter2,...]>
|
|
4857 Prepends the filters given as arguments to the filter list.
|
|
4858 .
|
|
4859 .TP
|
|
4860 .B \-vf-del <index1[,index2,...]>
|
|
4861 Deletes the filters at the given indexes.
|
|
4862 Index numbers start at 0, negative numbers address the end of the
|
|
4863 list (-1 is the last).
|
|
4864 .
|
|
4865 .TP
|
|
4866 .B \-vf-clr
|
|
4867 Completely empties the filter list.
|
|
4868 .PP
|
|
4869 With filters that support it, you can access parameters by their name.
|
|
4870 .
|
|
4871 .TP
|
|
4872 .B \-vf <filter>=help
|
|
4873 Prints the parameter names and parameter value ranges for a particular
|
|
4874 filter.
|
|
4875 .
|
|
4876 .TP
|
|
4877 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
|
|
4878 Sets a named parameter to the given value.
|
|
4879 Use on and off or yes and no to set flag parameters.
|
|
4880 .PP
|
|
4881 Available filters are:
|
|
4882 .
|
|
4883 .TP
|
|
4884 .B crop[=w:h:x:y]
|
|
4885 Crops the given part of the image and discards the rest.
|
|
4886 Useful to remove black bands from widescreen movies.
|
|
4887 .PD 0
|
|
4888 .RSs
|
|
4889 .IPs <w>,<h>
|
|
4890 Cropped width and height, defaults to original width and height.
|
|
4891 .IPs <x>,<y>
|
|
4892 Position of the cropped picture, defaults to center.
|
|
4893 .RE
|
|
4894 .PD 1
|
|
4895 .
|
|
4896 .TP
|
|
4897 .B cropdetect[=limit:round]
|
|
4898 Calculates necessary cropping parameters and prints the recommended parameters
|
|
4899 to stdout.
|
|
4900 .PD 0
|
|
4901 .RSs
|
|
4902 .IPs <limit>
|
|
4903 Threshold, which can be optionally specified from nothing (0) to
|
|
4904 everything (255) (default: 24).
|
|
4905 .br
|
|
4906 .IPs <round>
|
|
4907 Value which the width/\:height should be divisible by (default: 16).
|
|
4908 The offset is automatically adjusted to center the video.
|
|
4909 Use 2 to get only even dimensions (needed for 4:2:2 video).
|
|
4910 16 is best when encoding to most video codecs.
|
|
4911 .RE
|
|
4912 .PD 1
|
|
4913 .
|
|
4914 .TP
|
|
4915 .B rectangle[=w:h:x:y]
|
|
4916 The plugin responds to the input.conf directive 'change_rectangle'
|
|
4917 that takes two parameters.
|
|
4918 .PD 0
|
|
4919 .RSs
|
|
4920 .IPs <w>,<h>
|
|
4921 width and height (default: -1, maximum possible width where boundaries
|
|
4922 are still visible.)
|
|
4923 .IPs <x>,<y>
|
|
4924 top left corner position (default: -1, uppermost leftmost)
|
|
4925 .RE
|
|
4926 .PD 1
|
|
4927 .
|
|
4928 .TP
|
|
4929 .B expand[=w:h:x:y:o:a:r]
|
|
4930 Expands (not scales) movie resolution to the given value and places the
|
|
4931 unscaled original at coordinates x, y.
|
|
4932 Can be used for placing subtitles/\:OSD in the resulting black bands.
|
|
4933 .RSs
|
|
4934 .IPs <w>,<h>
|
|
4935 Expanded width,height (default: original width,height).
|
|
4936 Negative values for w and h are treated as offsets to the original size.
|
|
4937 .sp 1
|
|
4938 .I EXAMPLE:
|
|
4939 .PD 0
|
|
4940 .RSs
|
|
4941 .IP expand=0:-50:0:0
|
|
4942 Adds a 50 pixel border to the bottom of the picture.
|
|
4943 .RE
|
|
4944 .PD 1
|
|
4945 .IPs <x>,<y>
|
|
4946 position of original image on the expanded image (default: center)
|
|
4947 .IPs "<o>\ \ "
|
|
4948 OSD/\:subtitle rendering
|
|
4949 .RSss
|
|
4950 0: disable (default)
|
|
4951 .br
|
|
4952 1: enable
|
|
4953 .REss
|
|
4954 .IPs "<a>\ \ "
|
|
4955 Expands to fit an aspect instead of a resolution (default: 0).
|
|
4956 .sp 1
|
|
4957 .I EXAMPLE:
|
|
4958 .PD 0
|
|
4959 .RSs
|
|
4960 .IP expand=800::::4/3
|
|
4961 Expands to 800x600, unless the source is higher resolution, in which
|
|
4962 case it expands to fill a 4/3 aspect.
|
|
4963 .RE
|
|
4964 .PD 1
|
|
4965 .IPs "<r>\ \ "
|
|
4966 Rounds up to make both width and height divisible by <r> (default: 1).
|
|
4967 .RE
|
|
4968 .
|
|
4969 .TP
|
|
4970 .B flip (also see \-flip)
|
|
4971 Flips the image upside down.
|
|
4972 .
|
|
4973 .TP
|
|
4974 .B "mirror\ "
|
|
4975 Mirrors the image on the Y axis.
|
|
4976 .
|
|
4977 .TP
|
|
4978 .B rotate[=<0\-7>]
|
|
4979 Rotates the image by 90 degrees and optionally flips it.
|
|
4980 For values between 4\-7 rotation is only done if the movie geometry is
|
|
4981 portrait and not landscape.
|
|
4982 .RSs
|
|
4983 .IPs 0
|
|
4984 Rotate by 90 degrees clockwise and flip (default).
|
|
4985 .IPs 1
|
|
4986 Rotate by 90 degrees clockwise.
|
|
4987 .IPs 2
|
|
4988 Rotate by 90 degrees counterclockwise.
|
|
4989 .IPs 3
|
|
4990 Rotate by 90 degrees counterclockwise and flip.
|
|
4991 .RE
|
|
4992 .
|
|
4993 .TP
|
|
4994 .B scale[=w:h[:ilaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]]
|
|
4995 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
|
|
4996 colorspace conversion (also see \-sws).
|
|
4997 .RSs
|
|
4998 .IPs <w>,<h>
|
|
4999 scaled width/\:height (default: original width/\:height)
|
|
5000 .br
|
|
5001 .I NOTE:
|
|
5002 If \-zoom is used, and underlying filters (including libvo) are
|
|
5003 incapable of scaling, it defaults to d_width/\:d_height!
|
|
5004 .RSss
|
|
5005 0: scaled d_width/\:d_height
|
|
5006 .br
|
|
5007 -1: original width/\:height
|
|
5008 .br
|
|
5009 -2: Calculate w/h using the other dimension and the prescaled aspect ratio.
|
|
5010 .br
|
|
5011 -3: Calculate w/h using the other dimension and the original aspect ratio.
|
|
5012 .br
|
|
5013 -(n+8): Like -n above, but rounding the dimension to the closest multiple of 16.
|
|
5014 .REss
|
|
5015 .IPs <ilaced>
|
|
5016 Toggle interlaced scaling.
|
|
5017 .RSss
|
|
5018 0: off (default)
|
|
5019 .br
|
|
5020 1: on
|
|
5021 .REss
|
|
5022 .IPs <chr_drop>
|
|
5023 chroma skipping
|
|
5024 .RSss
|
|
5025 0: Use all available input lines for chroma.
|
|
5026 .br
|
|
5027 1: Use only every 2. input line for chroma.
|
|
5028 .br
|
|
5029 2: Use only every 4. input line for chroma.
|
|
5030 .br
|
|
5031 3: Use only every 8. input line for chroma.
|
|
5032 .REss
|
|
5033 .IPs "<par>[:<par2>] (also see \-sws)"
|
|
5034 Set some scaling parameters depending on the type of scaler selected
|
|
5035 with \-sws.
|
|
5036 .RSss
|
|
5037 \-sws 2 (bicubic): B (blurring) and C (ringing)
|
|
5038 .br
|
|
5039 0.00:0.60 default
|
|
5040 .br
|
|
5041 0.00:0.75 VirtualDub's "precise bicubic"
|
|
5042 .br
|
|
5043 0.00:0.50 Catmull-Rom spline
|
|
5044 .br
|
|
5045 0.33:0.33 Mitchell-Netravali spline
|
|
5046 .br
|
|
5047 1.00:0.00 cubic B-spline
|
|
5048 .br
|
|
5049 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
|
|
5050 .br
|
|
5051 \-sws 9 (lanczos): filter length (1\-10)
|
|
5052 .REss
|
|
5053 .IPs <presize>
|
|
5054 Scale to preset sizes.
|
|
5055 .RSss
|
|
5056 qntsc: 352x240 (NTSC quarter screen)
|
|
5057 .br
|
|
5058 qpal: 352x288 (PAL quarter screen)
|
|
5059 .br
|
|
5060 ntsc: 720x480 (standard NTSC)
|
|
5061 .br
|
|
5062 pal: 720x576 (standard PAL)
|
|
5063 .br
|
|
5064 sntsc: 640x480 (square pixel NTSC)
|
|
5065 .br
|
|
5066 spal: 768x576 (square pixel PAL)
|
|
5067 .REss
|
|
5068 .IPs <noup>
|
|
5069 Disallow upscaling past the original dimensions.
|
|
5070 .RSss
|
|
5071 0: Allow upscaling (default).
|
|
5072 .br
|
|
5073 1: Disallow upscaling if one dimension exceeds its original value.
|
|
5074 .br
|
|
5075 2: Disallow upscaling if both dimensions exceed their original values.
|
|
5076 .REss
|
|
5077 .IPs <arnd>
|
|
5078 Accurate rounding for the vertical scaler, which may be faster
|
|
5079 or slower than the default rounding.
|
|
5080 .RSss
|
|
5081 0: Disable accurate rounding (default).
|
|
5082 .br
|
|
5083 1: Enable accurate rounding.
|
|
5084 .REss
|
|
5085 .RE
|
|
5086 .
|
|
5087 .TP
|
|
5088 .B dsize[=aspect|w:h:aspect-method:r]
|
|
5089 Changes the intended display size/\:aspect at an arbitrary point in the
|
|
5090 filter chain.
|
|
5091 Aspect can be given as a fraction (4/3) or floating point number
|
|
5092 (1.33).
|
|
5093 Alternatively, you may specify the exact display width and height
|
|
5094 desired.
|
|
5095 Note that this filter does
|
|
5096 .B not
|
|
5097 do any scaling itself; it just affects
|
|
5098 what later scalers (software or hardware) will do when auto-scaling to
|
|
5099 correct aspect.
|
|
5100 .RSs
|
|
5101 .IPs <w>,<h>
|
|
5102 New display width and height.
|
|
5103 Can also be these special values:
|
|
5104 .RSss
|
|
5105 0: original display width and height
|
|
5106 .br
|
|
5107 -1: original video width and height (default)
|
|
5108 .br
|
|
5109 -2: Calculate w/h using the other dimension and the original display
|
|
5110 aspect ratio.
|
|
5111 .br
|
|
5112 -3: Calculate w/h using the other dimension and the original video
|
|
5113 aspect ratio.
|
|
5114 .REss
|
|
5115 .sp 1
|
|
5116 .I EXAMPLE:
|
|
5117 .PD 0
|
|
5118 .RSs
|
|
5119 .IP dsize=800:-2
|
|
5120 Specifies a display resolution of 800x600 for a 4/3 aspect video, or
|
|
5121 800x450 for a 16/9 aspect video.
|
|
5122 .RE
|
|
5123 .IPs <aspect-method>
|
|
5124 Modifies width and height according to original aspect ratios.
|
|
5125 .RSss
|
|
5126 -1: Ignore original aspect ratio (default).
|
|
5127 .br
|
|
5128 0: Keep display aspect ratio by using <w> and <h> as maximum
|
|
5129 resolution.
|
|
5130 .br
|
|
5131 1: Keep display aspect ratio by using <w> and <h> as minimum
|
|
5132 resolution.
|
|
5133 .br
|
|
5134 2: Keep video aspect ratio by using <w> and <h> as maximum
|
|
5135 resolution.
|
|
5136 .br
|
|
5137 3: Keep video aspect ratio by using <w> and <h> as minimum
|
|
5138 resolution.
|
|
5139 .REss
|
|
5140 .sp 1
|
|
5141 .I EXAMPLE:
|
|
5142 .PD 0
|
|
5143 .RSs
|
|
5144 .IP dsize=800:600:0
|
|
5145 Specifies a display resolution of at most 800x600, or smaller, in order
|
|
5146 to keep aspect.
|
|
5147 .RE
|
|
5148 .PD 1
|
|
5149 .IPs "<r>\ \ "
|
|
5150 Rounds up to make both width and height divisible by <r> (default: 1).
|
|
5151 .RE
|
|
5152 .
|
|
5153 .TP
|
|
5154 .B "yuy2\ \ \ "
|
|
5155 Forces software YV12/\:I420/\:422P to YUY2 conversion.
|
|
5156 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
|
|
5157 .
|
|
5158 .TP
|
|
5159 .B "yvu9\ \ \ "
|
|
5160 Forces software YVU9 to YV12 colorspace conversion.
|
|
5161 Deprecated in favor of the software scaler.
|
|
5162 .
|
|
5163 .TP
|
|
5164 .B "yuvcsp\ "
|
|
5165 Clamps YUV color values to the CCIR 601 range without doing real conversion.
|
|
5166 .
|
|
5167 .TP
|
|
5168 .B rgb2bgr[=swap]
|
|
5169 RGB 24/32 <\-> BGR 24/32 colorspace conversion.
|
|
5170 .PD 0
|
|
5171 .RSs
|
|
5172 .IPs "swap\ "
|
|
5173 Also perform R <-> B swapping.
|
|
5174 .RE
|
|
5175 .PD 1
|
|
5176 .
|
|
5177 .TP
|
|
5178 .B palette
|
|
5179 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette.
|
|
5180 .
|
|
5181 .TP
|
|
5182 .B format[=fourcc]
|
|
5183 Restricts the colorspace for the next filter without doing any conversion.
|
|
5184 Use together with the scale filter for a real conversion.
|
|
5185 .br
|
|
5186 .I NOTE:
|
|
5187 For a list of available formats see format=fmt=help.
|
|
5188 .PD 0
|
|
5189 .RSs
|
|
5190 .IPs <fourcc>
|
|
5191 format name like rgb15, bgr24, yv12, etc (default: yuy2)
|
|
5192 .RE
|
|
5193 .PD 1
|
|
5194 .
|
|
5195 .TP
|
|
5196 .B noformat[=fourcc]
|
|
5197 Restricts the colorspace for the next filter without doing any conversion.
|
|
5198 Unlike the format filter, this will allow any colorspace
|
|
5199 .B except
|
|
5200 the one you specify.
|
|
5201 .br
|
|
5202 .I NOTE:
|
|
5203 For a list of available formats see noformat=fmt=help.
|
|
5204 .PD 0
|
|
5205 .RSs
|
|
5206 .IPs <fourcc>
|
|
5207 format name like rgb15, bgr24, yv12, etc (default: yv12)
|
|
5208 .RE
|
|
5209 .PD 1
|
|
5210 .
|
|
5211 .TP
|
|
5212 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (also see \-pphelp)
|
|
5213 Enables the specified chain of postprocessing subfilters.
|
|
5214 Subfilters must be separated by '/' and can be disabled by
|
|
5215 prepending a '\-'.
|
|
5216 Each subfilter and some options have a short and a long name that can be
|
|
5217 used interchangeably, i.e.\& dr/dering are the same.
|
|
5218 All subfilters share common options to determine their scope:
|
|
5219 .PD 0
|
|
5220 .RSs
|
|
5221 .IPs a/autoq
|
|
5222 Automatically switch the subfilter off if the CPU is too slow.
|
|
5223 .IPs c/chrom
|
|
5224 Do chrominance filtering, too (default).
|
|
5225 .IPs y/nochrom
|
|
5226 Do luminance filtering only (no chrominance).
|
|
5227 .IPs n/noluma
|
|
5228 Do chrominance filtering only (no luminance).
|
|
5229 .RE
|
|
5230 .PD 1
|
|
5231 .sp 1
|
|
5232 .RS
|
|
5233 .br
|
|
5234 .I NOTE:
|
|
5235 \-pphelp shows a list of available subfilters.
|
|
5236 .sp 1
|
|
5237 Available subfilters are
|
|
5238 .RE
|
|
5239 .RSs
|
|
5240 .IPs hb/hdeblock[:difference[:flatness]]
|
|
5241 horizontal deblocking filter
|
|
5242 .RSss
|
|
5243 <difference>: Difference factor where higher values mean
|
|
5244 more deblocking (default: 32).
|
|
5245 .br
|
|
5246 <flatness>: Flatness threshold where lower values mean
|
|
5247 more deblocking (default: 39).
|
|
5248 .REss
|
|
5249 .IPs vb/vdeblock[:difference[:flatness]]
|
|
5250 vertical deblocking filter
|
|
5251 .RSss
|
|
5252 <difference>: Difference factor where higher values mean
|
|
5253 more deblocking (default: 32).
|
|
5254 .br
|
|
5255 <flatness>: Flatness threshold where lower values mean
|
|
5256 more deblocking (default: 39).
|
|
5257 .REss
|
|
5258 .IPs ha/hadeblock[:difference[:flatness]]
|
|
5259 accurate horizontal deblocking filter
|
|
5260 .RSss
|
|
5261 <difference>: Difference factor where higher values mean
|
|
5262 more deblocking (default: 32).
|
|
5263 .br
|
|
5264 <flatness>: Flatness threshold where lower values mean
|
|
5265 more deblocking (default: 39).
|
|
5266 .REss
|
|
5267 .IPs va/vadeblock[:difference[:flatness]]
|
|
5268 accurate vertical deblocking filter
|
|
5269 .RSss
|
|
5270 <difference>: Difference factor where higher values mean
|
|
5271 more deblocking (default: 32).
|
|
5272 .br
|
|
5273 <flatness>: Flatness threshold where lower values mean
|
|
5274 more deblocking (default: 39).
|
|
5275 .REss
|
|
5276 .sp 1
|
|
5277 The horizontal and vertical deblocking filters share the
|
|
5278 difference and flatness values so you cannot set
|
|
5279 different horizontal and vertical thresholds.
|
|
5280 .sp 1
|
|
5281 .IPs h1/x1hdeblock
|
|
5282 experimental horizontal deblocking filter
|
|
5283 .IPs v1/x1vdeblock
|
|
5284 experimental vertical deblocking filter
|
|
5285 .IPs dr/dering
|
|
5286 deringing filter
|
|
5287 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]]
|
|
5288 temporal noise reducer
|
|
5289 .RSss
|
|
5290 <threshold1>: larger -> stronger filtering
|
|
5291 .br
|
|
5292 <threshold2>: larger -> stronger filtering
|
|
5293 .br
|
|
5294 <threshold3>: larger -> stronger filtering
|
|
5295 .REss
|
|
5296 .IPs al/autolevels[:f/fullyrange]
|
|
5297 automatic brightness / contrast correction
|
|
5298 .RSss
|
|
5299 f/fullyrange: Stretch luminance to (0\-255).
|
|
5300 .REss
|
|
5301 .IPs lb/linblenddeint
|
|
5302 Linear blend deinterlacing filter that deinterlaces the given block
|
|
5303 by filtering all lines with a (1 2 1) filter.
|
|
5304 .IPs li/linipoldeint
|
|
5305 Linear interpolating deinterlacing filter that deinterlaces the given block
|
|
5306 by linearly interpolating every second line.
|
|
5307 .IPs ci/cubicipoldeint
|
|
5308 Cubic interpolating deinterlacing filter deinterlaces the given block
|
|
5309 by cubically interpolating every second line.
|
|
5310 .IPs md/mediandeint
|
|
5311 Median deinterlacing filter that deinterlaces the given block
|
|
5312 by applying a median filter to every second line.
|
|
5313 .IPs fd/ffmpegdeint
|
|
5314 FFmpeg deinterlacing filter that deinterlaces the given block
|
|
5315 by filtering every second line with a (-1 4 2 4 -1) filter.
|
|
5316 .IPs l5/lowpass5
|
|
5317 Vertically applied FIR lowpass deinterlacing filter that deinterlaces
|
|
5318 the given block by filtering all lines with a (-1 2 6 2 -1) filter.
|
|
5319 .IPs fq/forceQuant[:quantizer]
|
|
5320 Overrides the quantizer table from the input with the constant
|
|
5321 quantizer you specify.
|
|
5322 .RSss
|
|
5323 <quantizer>: quantizer to use
|
|
5324 .REss
|
|
5325 .IPs de/default
|
|
5326 default pp filter combination (hb:a,vb:a,dr:a)
|
|
5327 .IPs fa/fast
|
|
5328 fast pp filter combination (h1:a,v1:a,dr:a)
|
|
5329 .IPs "ac\ \ \ "
|
|
5330 high quality pp filter combination (ha:a:128:7,va:a,dr:a)
|
|
5331 .RE
|
|
5332 .RS
|
|
5333 .sp 1
|
|
5334 .I EXAMPLE:
|
|
5335 .RE
|
|
5336 .PD 0
|
|
5337 .RSs
|
|
5338 .IPs "\-vf pp=hb/vb/dr/al"
|
|
5339 horizontal and vertical deblocking, deringing and automatic
|
|
5340 brightness/\:contrast
|
|
5341 .IPs "\-vf pp=de/-al"
|
|
5342 default filters without brightness/\:contrast correction
|
|
5343 .IPs "\-vf pp=default/tmpnoise:1:2:3"
|
|
5344 Enable default filters & temporal denoiser.
|
|
5345 .IPs "\-vf pp=hb:y/vb:a"
|
|
5346 Horizontal deblocking on luminance only, and switch vertical deblocking
|
|
5347 on or off automatically depending on available CPU time.
|
|
5348 .RE
|
|
5349 .PD 1
|
|
5350 .
|
|
5351 .TP
|
|
5352 .B spp[=quality[:qp[:mode]]]
|
|
5353 Simple postprocessing filter that compresses and decompresses the
|
|
5354 image at several (or \- in the case of quality level 6 \- all)
|
|
5355 shifts and averages the results.
|
|
5356 .RSs
|
|
5357 .IPs <quality>
|
|
5358 0\-6 (default: 3)
|
|
5359 .IPs "<qp>\ "
|
|
5360 Force quantization parameter (default: 0, use QP from video).
|
|
5361 .IPs <mode>
|
|
5362 0: hard thresholding (default)
|
|
5363 .br
|
|
5364 1: soft thresholding (better deringing, but blurrier)
|
|
5365 .br
|
|
5366 4: like 0, but also use B-frames' QP (may cause flicker)
|
|
5367 .br
|
|
5368 5: like 1, but also use B-frames' QP (may cause flicker)
|
|
5369 .RE
|
|
5370 .
|
|
5371 .TP
|
|
5372 .B uspp[=quality[:qp]]
|
|
5373 Ultra simple & slow postprocessing filter that compresses and
|
|
5374 decompresses the image at several (or \- in the case of quality
|
|
5375 level 8 \- all) shifts and averages the results.
|
|
5376 The way this differs from the behavior of spp is that uspp actually
|
|
5377 encodes & decodes each case with libavcodec Snow, whereas spp uses
|
|
5378 a simplified intra only 8x8 DCT similar to MJPEG.
|
|
5379 .RSs
|
|
5380 .IPs <quality>
|
|
5381 0\-8 (default: 3)
|
|
5382 .IPs "<qp>\ "
|
|
5383 Force quantization parameter (default: 0, use QP from video).
|
|
5384 .RE
|
|
5385 .
|
|
5386 .TP
|
|
5387 .B fspp[=quality[:qp[:strength[:bframes]]]]
|
|
5388 faster version of the simple postprocessing filter
|
|
5389 .RSs
|
|
5390 .IPs <quality>
|
|
5391 4\-5 (equivalent to spp; default: 4)
|
|
5392 .IPs "<qp>\ "
|
|
5393 Force quantization parameter (default: 0, use QP from video).
|
|
5394 .IPs <-15\-32>
|
|
5395 Filter strength, lower values mean more details but also more artifacts,
|
|
5396 while higher values make the image smoother but also blurrier (default:
|
|
5397 0 \- PSNR optimal).
|
|
5398 .IPs <bframes>
|
|
5399 0: do not use QP from B-frames (default)
|
|
5400 .br
|
|
5401 1: use QP from B-frames too (may cause flicker)
|
|
5402 .RE
|
|
5403 .
|
|
5404 .TP
|
|
5405 .B pp7[=qp[:mode]]
|
|
5406 Variant of the spp filter, similar to spp=6 with 7 point DCT where
|
|
5407 only the center sample is used after IDCT.
|
|
5408 .RSs
|
|
5409 .IPs <qp>
|
|
5410 Force quantization parameter (default: 0, use QP from video).
|
|
5411 .IPs <mode>
|
|
5412 0: hard thresholding
|
|
5413 .br
|
|
5414 1: soft thresholding (better deringing, but blurrier)
|
|
5415 .br
|
|
5416 2: medium thresholding (default, good results)
|
|
5417 .RE
|
|
5418 .
|
|
5419 .TP
|
|
5420 .B qp=equation
|
|
5421 quantization parameter (QP) change filter
|
|
5422 .RSs
|
|
5423 .IPs <equation>
|
|
5424 some equation like "2+2*sin(PI*qp)"
|
|
5425 .RE
|
|
5426 .
|
|
5427 .TP
|
|
5428 .B "test\ \ \ "
|
|
5429 Generate various test patterns.
|
|
5430 .
|
|
5431 .TP
|
|
5432 .B rgbtest
|
|
5433 Generate an RGB test pattern useful for detecting RGB vs BGR issues.
|
|
5434 You should see a red, green and blue stripe from top to bottom.
|
|
5435 .
|
|
5436 .TP
|
|
5437 .B lavc[=quality:fps]
|
|
5438 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV.
|
|
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 dvbscale[=aspect]
|
|
5452 Set up optimal scaling for DVB cards, scaling the x axis in hardware and
|
|
5453 calculating the y axis scaling in software to keep aspect.
|
|
5454 Only useful together with expand and scale.
|
|
5455 .RSs
|
|
5456 .IPs <aspect>
|
|
5457 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
|
|
5458 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
|
|
5459 .RE
|
|
5460 .sp 1
|
|
5461 .RS
|
|
5462 .I EXAMPLE:
|
|
5463 .RE
|
|
5464 .PD 0
|
|
5465 .RSs
|
|
5466 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc"
|
|
5467 FIXME: Explain what this does.
|
|
5468 .RE
|
|
5469 .PD 1
|
|
5470 .
|
|
5471 .TP
|
|
5472 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
|
|
5473 Adds noise.
|
|
5474 .PD 0
|
|
5475 .RSs
|
|
5476 .IPs <0\-100>
|
|
5477 luma noise
|
|
5478 .IPs <0\-100>
|
|
5479 chroma noise
|
|
5480 .IPs u
|
|
5481 uniform noise (gaussian otherwise)
|
|
5482 .IPs t
|
|
5483 temporal noise (noise pattern changes between frames)
|
|
5484 .IPs a
|
|
5485 averaged temporal noise (smoother, but a lot slower)
|
|
5486 .IPs h
|
|
5487 high quality (slightly better looking, slightly slower)
|
|
5488 .IPs p
|
|
5489 mix random noise with a (semi)regular pattern
|
|
5490 .RE
|
|
5491 .PD 1
|
|
5492 .
|
|
5493 .TP
|
|
5494 .B denoise3d[=luma:chroma:time]
|
|
5495 This filter aims to reduce image noise producing smooth images and making still
|
|
5496 images really still (This should enhance compressibility.).
|
|
5497 .PD 0
|
|
5498 .RSs
|
|
5499 .IPs <luma>
|
|
5500 spatial luma strength (default: 4)
|
|
5501 .IPs <chroma>
|
|
5502 spatial chroma strength (default: 3)
|
|
5503 .IPs <time>
|
|
5504 temporal strength (default: 6)
|
|
5505 .RE
|
|
5506 .PD 1
|
|
5507 .
|
|
5508 .TP
|
|
5509 .B hqdn3d[=luma:chroma:time]
|
|
5510 High precision/\:quality version of the denoise3d filter.
|
|
5511 Parameters and usage are the same.
|
|
5512 .
|
|
5513 .TP
|
|
5514 .B eq[=brightness:contrast] (OBSOLETE)
|
|
5515 Software equalizer with interactive controls just like the hardware
|
|
5516 equalizer, for cards/\:drivers that do not support brightness and
|
|
5517 contrast controls in hardware.
|
|
5518 Might also be useful with MEncoder, either for fixing poorly captured
|
|
5519 movies, or for slightly reducing contrast to mask artifacts and get by
|
|
5520 with lower bitrates.
|
|
5521 .PD 0
|
|
5522 .RSs
|
|
5523 .IPs <-100\-100>
|
|
5524 initial brightness
|
|
5525 .IPs <-100\-100>
|
|
5526 initial contrast
|
|
5527 .RE
|
|
5528 .PD 1
|
|
5529 .
|
|
5530 .TP
|
|
5531 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
|
|
5532 Alternative software equalizer that uses lookup tables (very slow),
|
|
5533 allowing gamma correction in addition to simple brightness
|
|
5534 and contrast adjustment.
|
|
5535 Note that it uses the same MMX optimized code as \-vf eq if all
|
|
5536 gamma values are 1.0.
|
|
5537 The parameters are given as floating point values.
|
|
5538 .PD 0
|
|
5539 .RSs
|
|
5540 .IPs <0.1\-10>
|
|
5541 initial gamma value (default: 1.0)
|
|
5542 .IPs <-2\-2>
|
|
5543 initial contrast, where negative values result in a
|
|
5544 negative image (default: 1.0)
|
|
5545 .IPs <-1\-1>
|
|
5546 initial brightness (default: 0.0)
|
|
5547 .IPs <0\-3>
|
|
5548 initial saturation (default: 1.0)
|
|
5549 .IPs <0.1\-10>
|
|
5550 gamma value for the red component (default: 1.0)
|
|
5551 .IPs <0.1\-10>
|
|
5552 gamma value for the green component (default: 1.0)
|
|
5553 .IPs <0.1\-10>
|
|
5554 gamma value for the blue component (default: 1.0)
|
|
5555 .IPs <0\-1>
|
|
5556 The weight parameter can be used to reduce the effect of a high gamma value on
|
|
5557 bright image areas, e.g.\& keep them from getting overamplified and just plain
|
|
5558 white.
|
|
5559 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
|
|
5560 at its full strength (default: 1.0).
|
|
5561 .RE
|
|
5562 .PD 1
|
|
5563 .
|
|
5564 .TP
|
|
5565 .B hue[=hue:saturation]
|
|
5566 Software equalizer with interactive controls just like the hardware
|
|
5567 equalizer, for cards/\:drivers that do not support hue and
|
|
5568 saturation controls in hardware.
|
|
5569 .PD 0
|
|
5570 .RSs
|
|
5571 .IPs <-180\-180>
|
|
5572 initial hue (default: 0.0)
|
|
5573 .IPs <-100\-100>
|
|
5574 initial saturation, where negative values result
|
|
5575 in a negative chroma (default: 1.0)
|
|
5576 .RE
|
|
5577 .PD 1
|
|
5578 .
|
|
5579 .TP
|
|
5580 .B halfpack[=f]
|
|
5581 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
|
|
5582 keeping all chroma samples.
|
|
5583 Useful for output to low-resolution display devices when hardware downscaling
|
|
5584 is poor quality or is not available.
|
|
5585 Can also be used as a primitive luma-only deinterlacer with very low CPU
|
|
5586 usage.
|
|
5587 .PD 0
|
|
5588 .RSs
|
|
5589 .IPs "<f>\ \ "
|
|
5590 By default, halfpack averages pairs of lines when downsampling.
|
|
5591 Any value different from 0 or 1 gives the default (averaging) behavior.
|
|
5592 .RSss
|
|
5593 0: Only use even lines when downsampling.
|
|
5594 .br
|
|
5595 1: Only use odd lines when downsampling.
|
|
5596 .REss
|
|
5597 .RE
|
|
5598 .PD 1
|
|
5599 .
|
|
5600 .TP
|
|
5601 .B ilpack[=mode]
|
|
5602 When interlaced video is stored in YUV 4:2:0 formats, chroma
|
|
5603 interlacing does not line up properly due to vertical downsampling of
|
|
5604 the chroma channels.
|
|
5605 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
|
|
5606 the chroma lines in their proper locations, so that in any given
|
|
5607 scanline, the luma and chroma data both come from the same field.
|
|
5608 .PD 0
|
|
5609 .RSs
|
|
5610 .IPs <mode>
|
|
5611 Select the sampling mode.
|
|
5612 .RSss
|
|
5613 0: nearest-neighbor sampling, fast but incorrect
|
|
5614 .br
|
|
5615 1: linear interpolation (default)
|
|
5616 .REss
|
|
5617 .RE
|
|
5618 .PD 1
|
|
5619 .
|
|
5620 .TP
|
|
5621 .B harddup
|
|
5622 Only useful with MEncoder.
|
|
5623 If harddup is used when encoding, it will force duplicate frames to be
|
|
5624 encoded in the output.
|
|
5625 This uses slightly more space, but is necessary for output to MPEG
|
|
5626 files or if you plan to demux and remux the video stream after
|
|
5627 encoding.
|
|
5628 Should be placed at or near the end of the filter chain unless you
|
|
5629 have a good reason to do otherwise.
|
|
5630 .
|
|
5631 .TP
|
|
5632 .B softskip
|
|
5633 Only useful with MEncoder.
|
|
5634 Softskip moves the frame skipping (dropping) step of encoding from
|
|
5635 before the filter chain to some point during the filter chain.
|
|
5636 This allows filters which need to see all frames (inverse telecine,
|
|
5637 temporal denoising, etc.) to function properly.
|
|
5638 Should be placed after the filters which need to see all frames and
|
|
5639 before any subsequent filters that are CPU-intensive.
|
|
5640 .
|
|
5641 .TP
|
|
5642 .B decimate[=max:hi:lo:frac]
|
|
5643 Drops frames that do not differ greatly from the previous frame in
|
|
5644 order to reduce framerate.
|
|
5645 The main use of this filter is for very-low-bitrate encoding (e.g.\&
|
|
5646 streaming over dialup modem), but it could in theory be used for
|
|
5647 fixing movies that were inverse-telecined incorrectly.
|
|
5648 .PD 0
|
|
5649 .RSs
|
|
5650 .IPs <max>
|
|
5651 Sets the maximum number of consecutive frames which can be
|
|
5652 dropped (if positive), or the minimum interval between
|
|
5653 dropped frames (if negative).
|
|
5654 .IPs <hi>,<lo>,<frac>
|
|
5655 A frame is a candidate for dropping if no 8x8 region differs by more
|
|
5656 than a threshold of <hi>, and if not more than <frac> portion (1
|
|
5657 meaning the whole image) differs by more than a threshold of <lo>.
|
|
5658 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual
|
|
5659 pixel value differences, so a threshold of 64 corresponds to 1 unit of
|
|
5660 difference for each pixel, or the same spread out differently over the
|
|
5661 block.
|
|
5662 .RE
|
|
5663 .PD 1
|
|
5664 .
|
|
5665 .TP
|
|
5666 .B dint[=sense:level]
|
|
5667 The drop-deinterlace (dint) filter detects and drops the first from a set
|
|
5668 of interlaced video frames.
|
|
5669 .PD 0
|
|
5670 .RSs
|
|
5671 .IPs <0.0\-1.0>
|
|
5672 relative difference between neighboring pixels (default: 0.1)
|
|
5673 .IPs <0.0\-1.0>
|
|
5674 What part of the image has to be detected as interlaced to
|
|
5675 drop the frame (default: 0.15).
|
|
5676 .RE
|
|
5677 .PD 1
|
|
5678 .
|
|
5679 .TP
|
|
5680 .B lavcdeint (OBSOLETE)
|
|
5681 FFmpeg deinterlacing filter, same as \-vf pp=fd
|
|
5682 .
|
|
5683 .TP
|
|
5684 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
|
|
5685 Donald Graft's adaptive kernel deinterlacer.
|
|
5686 Deinterlaces parts of a video if a configurable threshold is exceeded.
|
|
5687 .PD 0
|
|
5688 .RSs
|
|
5689 .IPs <0\-255>
|
|
5690 threshold (default: 10)
|
|
5691 .IPs <map>
|
|
5692 .RSss
|
|
5693 0: Ignore pixels exceeding the threshold (default).
|
|
5694 .br
|
|
5695 1: Paint pixels exceeding the threshold white.
|
|
5696 .REss
|
|
5697 .IPs <order>
|
|
5698 .RSss
|
|
5699 0: Leave fields alone (default).
|
|
5700 .br
|
|
5701 1: Swap fields.
|
|
5702 .REss
|
|
5703 .IPs <sharp>
|
|
5704 .RSss
|
|
5705 0: Disable additional sharpening (default).
|
|
5706 .br
|
|
5707 1: Enable additional sharpening.
|
|
5708 .REss
|
|
5709 .IPs <twoway>
|
|
5710 .RSss
|
|
5711 0: Disable twoway sharpening (default).
|
|
5712 .br
|
|
5713 1: Enable twoway sharpening.
|
|
5714 .REss
|
|
5715 .RE
|
|
5716 .PD 1
|
|
5717 .
|
|
5718 .TP
|
|
5719 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]]
|
|
5720 unsharp mask / gaussian blur
|
|
5721 .RSs
|
|
5722 .IPs "l\ \ \ \ "
|
|
5723 Apply effect on luma component.
|
|
5724 .IPs "c\ \ \ \ "
|
|
5725 Apply effect on chroma components.
|
|
5726 .IPs <width>x<height>
|
|
5727 width and height of the matrix, odd sized in both directions
|
|
5728 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
|
|
5729 .IPs amount
|
|
5730 Relative amount of sharpness/\:blur to add to the image
|
|
5731 (a sane range should be -1.5\-1.5).
|
|
5732 .RSss
|
|
5733 <0: blur
|
|
5734 .br
|
|
5735 >0: sharpen
|
|
5736 .REss
|
|
5737 .RE
|
|
5738 .
|
|
5739 .TP
|
|
5740 .B "swapuv\ "
|
|
5741 Swap U & V plane.
|
|
5742 .
|
|
5743 .TP
|
|
5744 .B il[=d|i][s][:[d|i][s]]
|
|
5745 (De)interleaves lines.
|
|
5746 The goal of this filter is to add the ability to process interlaced images
|
|
5747 pre-field without deinterlacing them.
|
|
5748 You can filter your interlaced DVD and play it on a TV without breaking the
|
|
5749 interlacing.
|
|
5750 While deinterlacing (with the postprocessing filter) removes interlacing
|
|
5751 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
|
|
5752 2 fields (so called half pictures), so you can process (filter) them
|
|
5753 independently and then re-interleave them.
|
|
5754 .PD 0
|
|
5755 .RSs
|
|
5756 .IPs d
|
|
5757 deinterleave (placing one above the other)
|
|
5758 .IPs i
|
|
5759 interleave
|
|
5760 .IPs s
|
|
5761 swap fields (exchange even & odd lines)
|
|
5762 .RE
|
|
5763 .PD 1
|
|
5764 .
|
|
5765 .TP
|
|
5766 .B fil[=i|d]
|
|
5767 (De)interleaves lines.
|
|
5768 This filter is very similar to the il filter but much faster, the main
|
|
5769 disadvantage is that it does not always work.
|
|
5770 Especially if combined with other filters it may produce randomly messed
|
|
5771 up images, so be happy if it works but do not complain if it does not for
|
|
5772 your combination of filters.
|
|
5773 .PD 0
|
|
5774 .RSs
|
|
5775 .IPs d
|
|
5776 Deinterleave fields, placing them side by side.
|
|
5777 .IPs i
|
|
5778 Interleave fields again (reversing the effect of fil=d).
|
|
5779 .RE
|
|
5780 .PD 1
|
|
5781 .
|
|
5782 .TP
|
|
5783 .B field[=n]
|
|
5784 Extracts a single field from an interlaced image using stride arithmetic
|
|
5785 to avoid wasting CPU time.
|
|
5786 The optional argument n specifies whether to extract the even or the odd
|
|
5787 field (depending on whether n is even or odd).
|
|
5788 .
|
|
5789 .TP
|
|
5790 .B detc[=var1=value1:var2=value2:...]
|
|
5791 Attempts to reverse the 'telecine' process to recover a clean,
|
|
5792 non-interlaced stream at film framerate.
|
|
5793 This was the first and most primitive inverse telecine filter to be
|
|
5794 added to MPlayer/\:MEncoder.
|
|
5795 It works by latching onto the telecine 3:2 pattern and following it as
|
|
5796 long as possible.
|
|
5797 This makes it suitable for perfectly-telecined material, even in the
|
|
5798 presence of a fair degree of noise, but it will fail in the presence
|
|
5799 of complex post-telecine edits.
|
|
5800 Development on this filter is no longer taking place, as ivtc, pullup,
|
|
5801 and filmdint are better for most applications.
|
|
5802 The following arguments (see syntax above) may be used to control
|
|
5803 detc's behavior:
|
|
5804 .RSs
|
|
5805 .IPs "<dr>\ "
|
|
5806 Set the frame dropping mode.
|
|
5807 .RSss
|
|
5808 0: Do not drop frames to maintain fixed output framerate (default).
|
|
5809 .br
|
|
5810 1: Always drop a frame when there have been no drops or telecine
|
|
5811 merges in the past 5 frames.
|
|
5812 .br
|
|
5813 2: Always maintain exact 5:4 input to output frame ratio.
|
|
5814 .br
|
|
5815 .I NOTE:
|
|
5816 Use mode 1 or 2 with MEncoder.
|
|
5817 .REss
|
|
5818 .IPs "<am>\ "
|
|
5819 Analysis mode.
|
|
5820 .RSss
|
|
5821 0: Fixed pattern with initial frame number specified by <fr>.
|
|
5822 .br
|
|
5823 1: aggressive search for telecine pattern (default)
|
|
5824 .REss
|
|
5825 .IPs "<fr>\ "
|
|
5826 Set initial frame number in sequence.
|
|
5827 0\-2 are the three clean progressive frames; 3 and 4 are the two
|
|
5828 interlaced frames.
|
|
5829 The default, -1, means 'not in telecine sequence'.
|
|
5830 The number specified here is the type for the imaginary previous
|
|
5831 frame before the movie starts.
|
|
5832 .IPs "<t0>, <t1>, <t2>, <t3>"
|
|
5833 Threshold values to be used in certain modes.
|
|
5834 .RE
|
|
5835 .
|
|
5836 .TP
|
|
5837 .B ivtc[=1]
|
|
5838 Experimental 'stateless' inverse telecine filter.
|
|
5839 Rather than trying to lock on to a pattern like the detc filter does,
|
|
5840 ivtc makes its decisions independently for each frame.
|
|
5841 This will give much better results for material that has undergone
|
|
5842 heavy editing after telecine was applied, but as a result it is not as
|
|
5843 forgiving of noisy input, for example TV capture.
|
|
5844 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
|
|
5845 detc filter, and should be used with MEncoder but not with MPlayer.
|
|
5846 As with detc, you must specify the correct output framerate (\-ofps
|
|
5847 24000/1001) when using MEncoder.
|
|
5848 Further development on ivtc has stopped, as the pullup and filmdint
|
|
5849 filters appear to be much more accurate.
|
|
5850 .
|
|
5851 .TP
|
|
5852 .B pullup[=jl:jr:jt:jb:sb:mp]
|
|
5853 Third-generation pulldown reversal (inverse telecine) filter,
|
|
5854 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001
|
|
5855 fps progressive content.
|
|
5856 The pullup filter is designed to be much more robust than detc or
|
|
5857 ivtc, by taking advantage of future context in making its decisions.
|
|
5858 Like ivtc, pullup is stateless in the sense that it does not lock onto
|
|
5859 a pattern to follow, but it instead looks forward to the following
|
|
5860 fields in order to identify matches and rebuild progressive frames.
|
|
5861 It is still under development, but believed to be quite accurate.
|
|
5862 The jl, jr, jt, and jb options set the amount of "junk" to ignore at
|
|
5863 the left, right, top, and bottom of the image, respectively.
|
|
5864 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of
|
|
5865 2 lines.
|
|
5866 The default is 8 pixels on each side.
|
|
5867 Setting the sb (strict breaks) option to 1 will reduce the chances of
|
|
5868 pullup generating an occasional mismatched frame, but it may also
|
|
5869 cause an excessive number of frames to be dropped during high motion
|
|
5870 sequences.
|
|
5871 Conversely, setting it to -1 will make pullup match fields more
|
|
5872 easily.
|
|
5873 This may help processing of video where there is slight blurring
|
|
5874 between the fields, but may also cause there to be interlaced frames
|
|
5875 in the output.
|
|
5876 The mp (metric plane) option may be set to 1 or 2 to use a chroma
|
|
5877 plane instead of the luma plane for doing pullup's computations.
|
|
5878 This may improve accuracy on very clean source material, but more
|
|
5879 likely will decrease accuracy, especially if there is chroma noise
|
|
5880 (rainbow effect) or any grayscale video.
|
|
5881 The main purpose of setting mp to a chroma plane is to reduce CPU load
|
|
5882 and make pullup usable in realtime on slow machines.
|
|
5883 .br
|
|
5884 .I NOTE:
|
|
5885 Always follow pullup with the softskip filter when encoding to ensure
|
|
5886 that pullup is able to see each frame.
|
|
5887 Failure to do so will lead to incorrect output and will usually crash,
|
|
5888 due to design limitations in the codec/\:filter layer.
|
|
5889 .
|
|
5890 .TP
|
|
5891 .B filmdint[=options]
|
|
5892 Inverse telecine filter, similar to the pullup filter above.
|
|
5893 It is designed to handle any pulldown pattern, including mixed soft and
|
|
5894 hard telecine and limited support for movies that are slowed down or sped
|
|
5895 up from their original framerate for TV.
|
|
5896 Only the luma plane is used to find the frame breaks.
|
|
5897 If a field has no match, it is deinterlaced with simple linear
|
|
5898 approximation.
|
|
5899 If the source is MPEG-2, this must be the first filter to allow
|
|
5900 access to the field-flags set by the MPEG-2 decoder.
|
|
5901 Depending on the source MPEG, you may be fine ignoring this advice, as
|
|
5902 long as you do not see lots of "Bottom-first field" warnings.
|
|
5903 With no options it does normal inverse telecine, and should be used
|
|
5904 together with mencoder \-fps 30000/1001 \-ofps 24000/1001.
|
|
5905 When this filter is used with mplayer, it will result in an uneven
|
|
5906 framerate during playback, but it is still generally better than using
|
|
5907 pp=lb or no deinterlacing at all.
|
|
5908 Multiple options can be specified separated by /.
|
|
5909 .RSs
|
|
5910 .IPs crop=<w>:<h>:<x>:<y>
|
|
5911 Just like the crop filter, but faster, and works on mixed hard and soft
|
|
5912 telecined content as well as when y is not a multiple of 4.
|
|
5913 If x or y would require cropping fractional pixels from the chroma
|
|
5914 planes, the crop area is extended.
|
|
5915 This usually means that x and y must be even.
|
|
5916 .IPs io=<ifps>:<ofps>
|
|
5917 For each ifps input frames the filter will output ofps frames.
|
|
5918 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio.
|
|
5919 This could be used to filter movies that are broadcast on TV at a frame
|
|
5920 rate different from their original framerate.
|
|
5921 .IPs luma_only=<n>
|
|
5922 If n is nonzero, the chroma plane is copied unchanged.
|
|
5923 This is useful for YV12 sampled TV, which discards one of the chroma
|
|
5924 fields.
|
|
5925 .IPs mmx2=<n>
|
|
5926 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
|
|
5927 optimized functions, otherwise, use plain C.
|
|
5928 If this option is not specified, MMX2 and 3DNow! are auto-detected, use
|
|
5929 this option to override auto-detection.
|
|
5930 .IPs fast=<n>
|
|
5931 The larger n will speed up the filter at the expense of accuracy.
|
|
5932 The default value is n=3.
|
|
5933 If n is odd, a frame immediately following a frame marked with the
|
|
5934 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter
|
|
5935 will not spend any time on soft-telecined MPEG-2 content.
|
|
5936 This is the only effect of this flag if MMX2 or 3DNow! is available.
|
|
5937 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
|
|
5938 as with n=2 or 3.
|
|
5939 If n=2 or 3, the number of luma levels used to find the frame breaks is
|
|
5940 reduced from 256 to 128, which results in a faster filter without losing
|
|
5941 much accuracy.
|
|
5942 If n=4 or 5, a faster, but much less accurate metric will be used to
|
|
5943 find the frame breaks, which is more likely to misdetect high vertical
|
|
5944 detail as interlaced content.
|
|
5945 .IPs verbose=<n>
|
|
5946 If n is nonzero, print the detailed metrics for each frame.
|
|
5947 Useful for debugging.
|
|
5948 .IPs dint_thres=<n>
|
|
5949 Deinterlace threshold.
|
|
5950 Used during de-interlacing of unmatched frames.
|
|
5951 Larger value means less deinterlacing, use n=256 to completely turn off
|
|
5952 deinterlacing.
|
|
5953 Default is n=8.
|
|
5954 .IPs comb_thres=<n>
|
|
5955 Threshold for comparing a top and bottom fields.
|
|
5956 Defaults to 128.
|
|
5957 .IPs diff_thres=<n>
|
|
5958 Threshold to detect temporal change of a field.
|
|
5959 Default is 128.
|
|
5960 .IPs sad_thres=<n>
|
|
5961 Sum of Absolute Difference threshold, default is 64.
|
|
5962 .RE
|
|
5963 .
|
|
5964 .TP
|
|
5965 .B softpulldown
|
|
5966 This filter works only correct with MEncoder and acts on the MPEG-2 flags
|
|
5967 used for soft 3:2 pulldown (soft telecine).
|
|
5968 If you want to use the ivtc or detc filter on movies that are partly soft
|
|
5969 telecined, inserting this filter before them should make them more reliable.
|
|
5970 .
|
|
5971 .TP
|
|
5972 .B divtc[=options]
|
|
5973 Inverse telecine for deinterlaced video.
|
|
5974 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced
|
|
5975 using a method that keeps one field and interpolates the other, the result is
|
|
5976 a juddering video that has every fourth frame duplicated.
|
|
5977 This filter is intended to find and drop those duplicates and restore the
|
|
5978 original film framerate.
|
|
5979 When using this filter, you must specify \-ofps that is 4/5 of
|
|
5980 the fps of the input file and place the softskip later in the
|
|
5981 filter chain to make sure that divtc sees all the frames.
|
|
5982 Two different modes are available:
|
|
5983 One pass mode is the default and is straightforward to use,
|
|
5984 but has the disadvantage that any changes in the telecine
|
|
5985 phase (lost frames or bad edits) cause momentary judder
|
|
5986 until the filter can resync again.
|
|
5987 Two pass mode avoids this by analyzing the whole video
|
|
5988 beforehand so it will have forward knowledge about the
|
|
5989 phase changes and can resync at the exact spot.
|
|
5990 These passes do
|
|
5991 .B not
|
|
5992 correspond to pass one and two of the encoding process.
|
|
5993 You must run an extra pass using divtc pass one before the
|
|
5994 actual encoding throwing the resulting video away.
|
|
5995 Use \-nosound \-ovc raw \-o /dev/null to avoid
|
|
5996 wasting CPU power for this pass.
|
|
5997 You may add something like crop=2:2:0:0 after divtc
|
|
5998 to speed things up even more.
|
|
5999 Then use divtc pass two for the actual encoding.
|
|
6000 If you use multiple encoder passes, use divtc
|
|
6001 pass two for all of them.
|
|
6002 The options are:
|
|
6003 .RSs
|
|
6004 .IPs pass=1|2
|
|
6005 Use two pass mode.
|
|
6006 .IPs file=<filename>
|
|
6007 Set the two pass log filename (default: "framediff.log").
|
|
6008 .IPs threshold=<value>
|
|
6009 Set the minimum strength the telecine pattern must have for the filter to
|
|
6010 believe in it (default: 0.5).
|
|
6011 This is used to avoid recognizing false pattern from the parts of the video
|
|
6012 that are very dark or very still.
|
|
6013 .IPs window=<numframes>
|
|
6014 Set the number of past frames to look at when searching for pattern
|
|
6015 (default: 30).
|
|
6016 Longer window improves the reliability of the pattern search, but shorter
|
|
6017 window improves the reaction time to the changes in the telecine phase.
|
|
6018 This only affects the one pass mode.
|
|
6019 The two pass mode currently uses fixed window that extends to both future
|
|
6020 and past.
|
|
6021 .IPs phase=0|1|2|3|4
|
|
6022 Sets the initial telecine phase for one pass mode (default: 0).
|
|
6023 The two pass mode can see the future, so it is able to use the correct
|
|
6024 phase from the beginning, but one pass mode can only guess.
|
|
6025 It catches the correct phase when it finds it, but this option can be used
|
|
6026 to fix the possible juddering at the beginning.
|
|
6027 The first pass of the two pass mode also uses this, so if you save the output
|
|
6028 from the first pass, you get constant phase result.
|
|
6029 .IPs deghost=<value>
|
|
6030 Set the deghosting threshold (0\-255 for one pass mode, -255\-255 for two pass
|
|
6031 mode, default 0).
|
|
6032 If nonzero, deghosting mode is used.
|
|
6033 This is for video that has been deinterlaced by blending the fields
|
|
6034 together instead of dropping one of the fields.
|
|
6035 Deghosting amplifies any compression artifacts in the blended frames, so the
|
|
6036 parameter value is used as a threshold to exclude those pixels from
|
|
6037 deghosting that differ from the previous frame less than specified value.
|
|
6038 If two pass mode is used, then negative value can be used to make the
|
|
6039 filter analyze the whole video in the beginning of pass-2 to determine
|
|
6040 whether it needs deghosting or not and then select either zero or the
|
|
6041 absolute value of the parameter.
|
|
6042 Specify this option for pass-2, it makes no difference on pass-1.
|
|
6043 .RE
|
|
6044 .
|
|
6045 .TP
|
|
6046 .B phase[=t|b|p|a|u|T|B|A|U][:v]
|
|
6047 Delay interlaced video by one field time so that the field order
|
|
6048 changes.
|
|
6049 The intended use is to fix PAL movies that have been captured with the
|
|
6050 opposite field order to the film-to-video transfer.
|
|
6051 The options are:
|
|
6052 .RSs
|
|
6053 .IPs t
|
|
6054 Capture field order top-first, transfer bottom-first.
|
|
6055 Filter will delay the bottom field.
|
|
6056 .IPs b
|
|
6057 Capture bottom-first, transfer top-first.
|
|
6058 Filter will delay the top field.
|
|
6059 .IPs p
|
|
6060 Capture and transfer with the same field order.
|
|
6061 This mode only exists for the documentation of the other options to refer to,
|
|
6062 but if you actually select it, the filter will faithfully do nothing ;-)
|
|
6063 .IPs a
|
|
6064 Capture field order determined automatically by field flags, transfer opposite.
|
|
6065 Filter selects among t and b modes on a frame by frame basis using field flags.
|
|
6066 If no field information is available, then this works just like u.
|
|
6067 .IPs u
|
|
6068 Capture unknown or varying, transfer opposite.
|
|
6069 Filter selects among t and b on a frame by frame basis by analyzing the
|
|
6070 images and selecting the alternative that produces best match between the
|
|
6071 fields.
|
|
6072 .IPs T
|
|
6073 Capture top-first, transfer unknown or varying.
|
|
6074 Filter selects among t and p using image analysis.
|
|
6075 .IPs B
|
|
6076 Capture bottom-first, transfer unknown or varying.
|
|
6077 Filter selects among b and p using image analysis.
|
|
6078 .IPs A
|
|
6079 Capture determined by field flags, transfer unknown or varying.
|
|
6080 Filter selects among t, b and p using field flags and image analysis.
|
|
6081 If no field information is available, then this works just like U.
|
|
6082 This is the default mode.
|
|
6083 .IPs U
|
|
6084 Both capture and transfer unknown or varying.
|
|
6085 Filter selects among t, b and p using image analysis only.
|
|
6086 .IPs v
|
|
6087 Verbose operation.
|
|
6088 Prints the selected mode for each frame and the average squared difference
|
|
6089 between fields for t, b, and p alternatives.
|
|
6090 .RE
|
|
6091 .
|
|
6092 .TP
|
|
6093 .B telecine[=start]
|
|
6094 Apply 3:2 'telecine' process to increase framerate by 20%.
|
|
6095 This most likely will not work correctly with MPlayer, but it can
|
|
6096 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'.
|
|
6097 Both fps options are essential!
|
|
6098 (A/V sync will break if they are wrong.)
|
|
6099 The optional start parameter tells the filter where in the telecine
|
|
6100 pattern to start (0\-3).
|
|
6101 .
|
|
6102 .TP
|
|
6103 .B tinterlace[=mode]
|
|
6104 Temporal field interlacing \- merge pairs of frames into an interlaced
|
|
6105 frame, halving the framerate.
|
|
6106 Even frames are moved into the upper field, odd frames to the lower field.
|
|
6107 This can be used to fully reverse the effect of the tfields filter (in mode 0).
|
|
6108 Available modes are:
|
|
6109 .PD 0
|
|
6110 .RSs
|
|
6111 .IPs 0
|
|
6112 Move odd frames into the upper field, even into the lower field, generating
|
|
6113 a full-height frame at half framerate.
|
|
6114 .IPs 1
|
|
6115 Only output odd frames, even frames are dropped; height unchanged.
|
|
6116 .IPs 2
|
|
6117 Only output even frames, odd frames are dropped; height unchanged.
|
|
6118 .IPs 3
|
|
6119 Expand each frame to full height, but pad alternate lines with black;
|
|
6120 framerate unchanged.
|
|
6121 .IPs 4
|
|
6122 Interleave even lines from even frames with odd lines from odd frames.
|
|
6123 Generates full-height frame at half framerate.
|
|
6124 .RE
|
|
6125 .PD 1
|
|
6126 .
|
|
6127 .TP
|
|
6128 .B tfields[=mode[:field_dominance]]
|
|
6129 Temporal field separation \- split fields into frames, doubling the
|
|
6130 output framerate.
|
|
6131 Like the telecine filter, tfields will only work properly with
|
|
6132 MEncoder, and only if both \-fps and \-ofps are set to the
|
|
6133 desired (double) framerate!
|
|
6134 .PD 0
|
|
6135 .RSs
|
|
6136 .IPs <mode>
|
|
6137 0: Leave fields unchanged (will jump/\:flicker).
|
|
6138 .br
|
|
6139 1: Interpolate missing lines. (The algorithm used might not be so good.)
|
|
6140 .br
|
|
6141 2: Translate fields by 1/4 pixel with linear interpolation (no jump).
|
|
6142 .br
|
|
6143 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default).
|
|
6144 .IPs <field_dominance>
|
|
6145 -1: auto (default)
|
|
6146 Only works if the decoder exports the appropriate information and
|
|
6147 no other filters which discard that information come before tfields
|
|
6148 in the filter chain, otherwise it falls back to 0 (top field first).
|
|
6149 .br
|
|
6150 0: top field first
|
|
6151 .br
|
|
6152 1: bottom field first
|
|
6153 .RE
|
|
6154 .PD 1
|
|
6155 .
|
|
6156 .TP
|
|
6157 .B yadif=[mode[:field_dominance]]
|
|
6158 Yet another deinterlacing filter
|
|
6159 .PD 0
|
|
6160 .RSs
|
|
6161 .IPs <mode>
|
|
6162 0: Output 1 frame for each frame.
|
|
6163 .br
|
|
6164 1: Output 1 frame for each field.
|
|
6165 .br
|
|
6166 2: Like 0 but skips spatial interlacing check.
|
|
6167 .br
|
|
6168 3: Like 1 but skips spatial interlacing check.
|
|
6169 .IPs <field_dominance>
|
|
6170 Operates like tfields.
|
|
6171 .RE
|
|
6172 .PD 1
|
|
6173 .
|
|
6174 .TP
|
|
6175 .B mcdeint=[mode[:parity[:qp]]]
|
|
6176 Motion compensating deinterlacer.
|
|
6177 It needs one field per frame as input and must thus be used together
|
|
6178 with tfields=1 or yadif=1/3 or equivalent.
|
|
6179 .PD 0
|
|
6180 .RSs
|
|
6181 .IPs <mode>
|
|
6182 0: fast
|
|
6183 .br
|
|
6184 1: medium
|
|
6185 .br
|
|
6186 2: slow, iterative motion estimation
|
|
6187 .br
|
|
6188 3: extra slow, like 2 plus multiple reference frames
|
|
6189 .IPs <parity>
|
|
6190 0 or 1 selects which field to use (note: no autodetection yet!).
|
|
6191 .IPs "<qp>\ "
|
|
6192 Higher values should result in a smoother motion vector
|
|
6193 field but less optimal individual vectors.
|
|
6194 .RE
|
|
6195 .PD 1
|
|
6196 .
|
|
6197 .TP
|
|
6198 .B boxblur=radius:power[:radius:power]
|
|
6199 box blur
|
|
6200 .PD 0
|
|
6201 .RSs
|
|
6202 .IPs <radius>
|
|
6203 blur filter strength
|
|
6204 .IPs <power>
|
|
6205 number of filter applications
|
|
6206 .RE
|
|
6207 .PD 1
|
|
6208 .
|
|
6209 .TP
|
|
6210 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
|
|
6211 shape adaptive blur
|
|
6212 .PD 0
|
|
6213 .RSs
|
|
6214 .IPs <radius>
|
|
6215 blur filter strength (~0.1\-4.0) (slower if larger)
|
|
6216 .IPs "<pf>\ "
|
|
6217 prefilter strength (~0.1\-2.0)
|
|
6218 .IPs <colorDiff>
|
|
6219 maximum difference between pixels to still be considered (~0.1\-100.0)
|
|
6220 .RE
|
|
6221 .PD 1
|
|
6222 .
|
|
6223 .TP
|
|
6224 .B smartblur=radius:strength:threshold[:radius:strength:threshold]
|
|
6225 smart blur
|
|
6226 .PD 0
|
|
6227 .RSs
|
|
6228 .IPs <radius>
|
|
6229 blur filter strength (~0.1\-5.0) (slower if larger)
|
|
6230 .IPs <strength>
|
|
6231 blur (0.0\-1.0) or sharpen (-1.0\-0.0)
|
|
6232 .IPs <threshold>
|
|
6233 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0)
|
|
6234 .RE
|
|
6235 .PD 1
|
|
6236 .
|
|
6237 .TP
|
|
6238 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
|
|
6239 Correct the perspective of movies not filmed perpendicular to the screen.
|
|
6240 .PD 0
|
|
6241 .RSs
|
|
6242 .IPs <x0>,<y0>,...
|
|
6243 coordinates of the top left, top right, bottom left, bottom right corners
|
|
6244 .IPs "<t>\ \ "
|
|
6245 linear (0) or cubic resampling (1)
|
|
6246 .RE
|
|
6247 .PD 1
|
|
6248 .
|
|
6249 .TP
|
|
6250 .B "2xsai\ \ "
|
|
6251 Scale and smooth the image with the 2x scale and interpolate algorithm.
|
|
6252 .
|
|
6253 .TP
|
|
6254 .B "1bpp\ \ \ "
|
|
6255 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
|
|
6256 .
|
|
6257 .TP
|
|
6258 .B down3dright[=lines]
|
|
6259 Reposition and resize stereoscopic images.
|
|
6260 Extracts both stereo fields and places them side by side, resizing
|
|
6261 them to maintain the original movie aspect.
|
|
6262 .PD 0
|
|
6263 .RSs
|
|
6264 .IPs <lines>
|
|
6265 number of lines to select from the middle of the image (default: 12)
|
|
6266 .RE
|
|
6267 .PD 1
|
|
6268 .
|
|
6269 .TP
|
|
6270 .B bmovl=hidden:opaque:fifo
|
|
6271 The bitmap overlay filter reads bitmaps from a FIFO and displays them
|
|
6272 on top of the movie, allowing some transformations on the image.
|
|
6273 Also see TOOLS/bmovl-test.c for a small bmovl test program.
|
|
6274 .PD 0
|
|
6275 .RSs
|
|
6276 .IPs <hidden>
|
|
6277 Set the default value of the 'hidden' flag (0=visible, 1=hidden).
|
|
6278 .IPs <opaque>
|
|
6279 Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
|
|
6280 .IPs <fifo>
|
|
6281 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the
|
|
6282 controlling application)
|
|
6283 .RE
|
|
6284 .PD 1
|
|
6285 .sp 1
|
|
6286 .RS
|
|
6287 FIFO commands are:
|
|
6288 .RE
|
|
6289 .PD 0
|
|
6290 .RSs
|
|
6291 .IPs "RGBA32 width height xpos ypos alpha clear"
|
|
6292 followed by width*height*4 Bytes of raw RGBA32 data.
|
|
6293 .IPs "ABGR32 width height xpos ypos alpha clear"
|
|
6294 followed by width*height*4 Bytes of raw ABGR32 data.
|
|
6295 .IPs "RGB24 width height xpos ypos alpha clear"
|
|
6296 followed by width*height*3 Bytes of raw RGB24 data.
|
|
6297 .IPs "BGR24 width height xpos ypos alpha clear"
|
|
6298 followed by width*height*3 Bytes of raw BGR24 data.
|
|
6299 .IPs "ALPHA width height xpos ypos alpha"
|
|
6300 Change alpha transparency of the specified area.
|
|
6301 .IPs "CLEAR width height xpos ypos"
|
|
6302 Clear area.
|
|
6303 .IPs OPAQUE
|
|
6304 Disable all alpha transparency.
|
|
6305 Send "ALPHA 0 0 0 0 0" to enable it again.
|
|
6306 .IPs "HIDE\ "
|
|
6307 Hide bitmap.
|
|
6308 .IPs "SHOW\ "
|
|
6309 Show bitmap.
|
|
6310 .RE
|
|
6311 .PD 1
|
|
6312 .sp 1
|
|
6313 .RS
|
|
6314 Arguments are:
|
|
6315 .RE
|
|
6316 .PD 0
|
|
6317 .RSs
|
|
6318 .IPs "<width>, <height>"
|
|
6319 image/area size
|
|
6320 .IPs "<xpos>, <ypos>"
|
|
6321 Start blitting at position x/y.
|
|
6322 .IPs <alpha>
|
|
6323 Set alpha difference.
|
|
6324 If you set this to -255 you can then send a sequence of ALPHA-commands to set
|
|
6325 the area to -225, -200, -175 etc for a nice fade-in-effect! ;)
|
|
6326 .RSss
|
|
6327 0: same as original
|
|
6328 .br
|
|
6329 255: Make everything opaque.
|
|
6330 .br
|
|
6331 -255: Make everything transparent.
|
|
6332 .REss
|
|
6333 .IPs <clear>
|
|
6334 Clear the framebuffer before blitting.
|
|
6335 .RSss
|
|
6336 0: The image will just be blitted on top of the old one, so you do not need to
|
|
6337 send 1.8MB of RGBA32 data every time a small part of the screen is updated.
|
|
6338 .br
|
|
6339 1: clear
|
|
6340 .REss
|
|
6341 .RE
|
|
6342 .PD 1
|
|
6343 .
|
|
6344 .TP
|
|
6345 .B framestep=I|[i]step
|
|
6346 Renders only every nth frame or every intra frame (keyframe).
|
|
6347 .sp 1
|
|
6348 If you call the filter with I (uppercase) as the parameter, then
|
|
6349 .B only
|
|
6350 keyframes are rendered.
|
|
6351 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB),
|
|
6352 for AVI it means every scene change or every keyint value (see \-lavcopts
|
|
6353 keyint= value if you use MEncoder to encode the video).
|
|
6354 .sp 1
|
|
6355 When a keyframe is found, an 'I!' string followed by a newline character is
|
|
6356 printed, leaving the current line of MPlayer/\:MEncoder output on the screen,
|
|
6357 because it contains the time (in seconds) and frame number of the keyframe
|
|
6358 (You can use this information to split the AVI.).
|
|
6359 .sp 1
|
|
6360 If you call the filter with a numeric parameter 'step' then only one in
|
|
6361 every 'step' frames is rendered.
|
|
6362 .sp 1
|
|
6363 If you put an 'i' (lowercase) before the number then an 'I!' is printed
|
|
6364 (like the I parameter).
|
|
6365 .sp 1
|
|
6366 If you give only the i then nothing is done to the frames, only I! is
|
|
6367 printed.
|
|
6368 .
|
|
6369 .TP
|
|
6370 .B tile=xtiles:ytiles:output:start:delta
|
|
6371 Tile a series of images into a single, bigger image.
|
|
6372 If you omit a parameter or use a value less than 0, then the default
|
|
6373 value is used.
|
|
6374 You can also stop when you are satisfied (... \-vf tile=10:5 ...).
|
|
6375 It is probably a good idea to put the scale filter before the tile :-)
|
|
6376 .sp 1
|
|
6377 The parameters are:
|
|
6378 .sp 1
|
|
6379 .PD 0
|
|
6380 .RSs
|
|
6381 .IPs <xtiles>
|
|
6382 number of tiles on the x axis (default: 5)
|
|
6383 .IPs <ytiles>
|
|
6384 number of tiles on the y axis (default: 5)
|
|
6385 .IPs <output>
|
|
6386 Render the tile when 'output' number of frames are reached, where 'output'
|
|
6387 should be a number less than xtile * ytile.
|
|
6388 Missing tiles are left blank.
|
|
6389 You could, for example, write an 8 * 7 tile every 50 frames to have one
|
|
6390 image every 2 seconds @ 25 fps.
|
|
6391 .IPs <start>
|
|
6392 outer border thickness in pixels (default: 2)
|
|
6393 .IPs <delta>
|
|
6394 inner border thickness in pixels (default: 4)
|
|
6395 .RE
|
|
6396 .PD 1
|
|
6397 .
|
|
6398 .TP
|
|
6399 .B delogo[=x:y:w:h:t]
|
|
6400 Suppresses a TV station logo by a simple interpolation of the
|
|
6401 surrounding pixels.
|
|
6402 Just set a rectangle covering the logo and watch it disappear (and
|
|
6403 sometimes something even uglier appear \- your mileage may vary).
|
|
6404 .PD 0
|
|
6405 .RSs
|
|
6406 .IPs <x>,<y>
|
|
6407 top left corner of the logo
|
|
6408 .IPs <w>,<h>
|
|
6409 width and height of the cleared rectangle
|
|
6410 .IPs <t>
|
|
6411 Thickness of the fuzzy edge of the rectangle (added to w and h).
|
|
6412 When set to -1, a green rectangle is drawn on the screen to
|
|
6413 simplify finding the right x,y,w,h parameters.
|
|
6414 .RE
|
|
6415 .PD 1
|
|
6416 .
|
|
6417 .TP
|
|
6418 .B remove-logo=/path/to/logo_bitmap_file_name.pgm
|
|
6419 Suppresses a TV station logo, using a PGM or PPM image
|
|
6420 file to determine which pixels comprise the logo.
|
|
6421 The width and height of the image file must match
|
|
6422 those of the video stream being processed.
|
|
6423 Uses the filter image and a circular blur
|
|
6424 algorithm to remove the logo.
|
|
6425 .RSs
|
|
6426 .IPs /path/to/logo_bitmap_file_name.pgm
|
|
6427 [path] + filename of the filter image.
|
|
6428 .RE
|
|
6429 .
|
|
6430 .TP
|
|
6431 .B zrmjpeg[=options]
|
|
6432 Software YV12 to MJPEG encoder for use with the zr2 video
|
|
6433 output device.
|
|
6434 .RSs
|
|
6435 .IPs maxheight=<h>|maxwidth=<w>
|
|
6436 These options set the maximum width and height the zr card
|
|
6437 can handle (the MPlayer filter layer currently cannot query those).
|
|
6438 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
|
|
6439 Use these options to set maxwidth and maxheight automatically to the
|
|
6440 values known for card/\:mode combo.
|
|
6441 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL)
|
|
6442 .IPs color|bw
|
|
6443 Select color or black and white encoding.
|
|
6444 Black and white encoding is faster.
|
|
6445 Color is the default.
|
|
6446 .IPs hdec={1,2,4}
|
|
6447 Horizontal decimation 1, 2 or 4.
|
|
6448 .IPs vdec={1,2,4}
|
|
6449 Vertical decimation 1, 2 or 4.
|
|
6450 .IPs quality=1\-20
|
|
6451 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD].
|
|
6452 .IPs fd|nofd
|
|
6453 By default, decimation is only performed if the Zoran hardware
|
|
6454 can upscale the resulting MJPEG images to the original size.
|
|
6455 The option fd instructs the filter to always perform the requested
|
|
6456 decimation (ugly).
|
|
6457 .RE
|
|
6458 .
|
|
6459 .TP
|
|
6460 .B screenshot
|
|
6461 Allows acquiring screenshots of the movie using slave mode
|
|
6462 commands that can be bound to keypresses.
|
|
6463 See the slave mode documentation and the INTERACTIVE CONTROL
|
|
6464 section for details.
|
|
6465 Files named 'shotNNNN.png' will be saved in the working directory,
|
|
6466 using the first available number - no files will be overwritten.
|
|
6467 The filter has no overhead when not used and accepts an arbitrary
|
|
6468 colorspace, so it is safe to add it to the configuration file.
|
|
6469 .RE
|
|
6470 .
|
|
6471 .TP
|
|
6472 .B "ass\ \ \ \ "
|
|
6473 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
|
|
6474 Only useful with the \-ass option.
|
|
6475 .sp 1
|
|
6476 .I EXAMPLE:
|
|
6477 .PD 0
|
|
6478 .RSs
|
|
6479 .IPs "\-vf ass,screenshot"
|
|
6480 Moves SSA/ASS rendering before the screenshot filter.
|
|
6481 Screenshots taken this way will contain subtitles.
|
|
6482 .RE
|
|
6483 .PD 1
|
|
6484 .
|
|
6485 .TP
|
|
6486 .B blackframe[=amount:threshold]
|
|
6487 Detect frames that are (almost) completely black.
|
|
6488 Can be useful to detect chapter transitions or commercials.
|
|
6489 Output lines consist of the frame number of the detected frame, the
|
|
6490 percentage of blackness, the frame type and the frame number of the last
|
|
6491 encountered keyframe.
|
|
6492 .RSs
|
|
6493 .IPs <amount>
|
|
6494 Percentage of the pixels that have to be below the threshold (default: 98).
|
|
6495 .IPs <threshold>
|
|
6496 Threshold below which a pixel value is considered black (default: 32).
|
|
6497 .RE
|
|
6498 .
|
|
6499 .
|
|
6500 .
|
|
6501 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
|
|
6502 .
|
|
6503 .TP
|
|
6504 .B \-audio-delay <any floating-point number>
|
|
6505 Delays either audio or video by setting a delay field in the header
|
|
6506 (default: 0.0).
|
|
6507 This does not delay either stream while encoding, but the player will
|
|
6508 see the delay field and compensate accordingly.
|
|
6509 Positive values delay the audio, and negative values delay the video.
|
|
6510 Note that this is the exact opposite of the \-delay option.
|
|
6511 For example, if a video plays correctly with \-delay 0.2, you can
|
|
6512 fix the video with MEncoder by using \-audio-delay -0.2.
|
|
6513 .sp 1
|
|
6514 Currently, this option only works with the default muxer (\-of avi).
|
|
6515 If you are using a different muxer, then you must use \-delay instead.
|
|
6516 .
|
|
6517 .TP
|
|
6518 .B \-audio-density <1\-50>
|
|
6519 Number of audio chunks per second (default is 2 for 0.5s long audio chunks).
|
|
6520 .br
|
|
6521 .I NOTE:
|
|
6522 CBR only, VBR ignores this as it puts each packet in a new chunk.
|
|
6523 .
|
|
6524 .TP
|
|
6525 .B \-audio-preload <0.0\-2.0>
|
|
6526 Sets up the audio buffering time interval (default: 0.5s).
|
|
6527 .
|
|
6528 .TP
|
|
6529 .B \-fafmttag <format>
|
|
6530 Can be used to override the audio format tag of the output file.
|
|
6531 .sp 1
|
|
6532 .I EXAMPLE:
|
|
6533 .PD 0
|
|
6534 .RSs
|
|
6535 .IPs "\-fafmttag 0x55"
|
|
6536 Will have the output file contain 0x55 (mp3) as audio format tag.
|
|
6537 .RE
|
|
6538 .PD 1
|
|
6539 .
|
|
6540 .TP
|
|
6541 .B \-ffourcc <fourcc>
|
|
6542 Can be used to override the video fourcc of the output file.
|
|
6543 .sp 1
|
|
6544 .I EXAMPLE:
|
|
6545 .PD 0
|
|
6546 .RSs
|
|
6547 .IPs "\-ffourcc div3"
|
|
6548 Will have the output file contain 'div3' as video fourcc.
|
|
6549 .RE
|
|
6550 .PD 1
|
|
6551 .
|
|
6552 .TP
|
|
6553 .B \-force-avi-aspect <0.2\-3.0>
|
|
6554 Override the aspect stored in the AVI OpenDML vprp header.
|
|
6555 This can be used to change the aspect ratio with '\-ovc copy'.
|
|
6556 .
|
|
6557 .TP
|
|
6558 .B \-frameno-file <filename> (DEPRECATED)
|
|
6559 Specify the name of the audio file with framenumber mappings created in
|
|
6560 the first (audio only) pass of a special three pass encoding mode.
|
|
6561 .br
|
|
6562 .I NOTE:
|
|
6563 Using this mode will most likely give you A-V desync.
|
|
6564 Do not use it.
|
|
6565 It is kept for backwards compatibility only and will possibly
|
|
6566 be removed in a future version.
|
|
6567 .
|
|
6568 .TP
|
|
6569 .B \-hr-edl-seek
|
|
6570 Use a more precise, but much slower method for skipping areas.
|
|
6571 Areas marked for skipping are not seeked over, instead all
|
|
6572 frames are decoded, but only the necessary frames are encoded.
|
|
6573 This allows starting at non-keyframe boundaries.
|
|
6574 .br
|
|
6575 .I NOTE:
|
|
6576 Not guaranteed to work right with '\-ovc copy'.
|
|
6577 .
|
|
6578 .TP
|
|
6579 .B \-info <option1:option2:...> (AVI only)
|
|
6580 Specify the info header of the resulting AVI file.
|
|
6581 .sp 1
|
|
6582 Available options are:
|
|
6583 .RSs
|
|
6584 .IPs "help\ "
|
|
6585 Show this description.
|
|
6586 .IPs name=<value>
|
|
6587 title of the work
|
|
6588 .IPs artist=<value>
|
|
6589 artist or author of the work
|
|
6590 .IPs genre=<value>
|
|
6591 original work category
|
|
6592 .IPs subject=<value>
|
|
6593 contents of the work
|
|
6594 .IPs copyright=<value>
|
|
6595 copyright information
|
|
6596 .IPs srcform=<value>
|
|
6597 original format of the digitized material
|
|
6598 .IPs comment=<value>
|
|
6599 general comments about the work
|
|
6600 .RE
|
|
6601 .
|
|
6602 .TP
|
|
6603 .B \-noautoexpand
|
|
6604 Do not automatically insert the expand filter into the MEncoder filter chain.
|
|
6605 Useful to control at which point of the filter chain subtitles are rendered
|
|
6606 when hardcoding subtitles onto a movie.
|
|
6607 .
|
|
6608 .TP
|
|
6609 .B \-noencodedups
|
|
6610 Do not attempt to encode duplicate frames in duplicate; always output
|
|
6611 zero-byte frames to indicate duplicates.
|
|
6612 Zero-byte frames will be written anyway unless a filter or encoder
|
|
6613 capable of doing duplicate encoding is loaded.
|
|
6614 Currently the only such filter is harddup.
|
|
6615 .
|
|
6616 .TP
|
|
6617 .B \-noodml (\-of avi only)
|
|
6618 Do not write OpenDML index for AVI files >1GB.
|
|
6619 .
|
|
6620 .TP
|
|
6621 .B \-noskip
|
|
6622 Do not skip frames.
|
|
6623 .
|
|
6624 .TP
|
|
6625 .B \-o <filename>
|
|
6626 Outputs to the given filename.
|
|
6627 .br
|
|
6628 If you want a default output filename, you can put this option in the
|
|
6629 MEncoder config file.
|
|
6630 .
|
|
6631 .TP
|
|
6632 .B \-oac <codec name>
|
|
6633 Encode with the given audio codec (no default set).
|
|
6634 .br
|
|
6635 .I NOTE:
|
|
6636 Use \-oac help to get a list of available audio codecs.
|
|
6637 .sp 1
|
|
6638 .I EXAMPLE:
|
|
6639 .PD 0
|
|
6640 .RSs
|
|
6641 .IPs "\-oac copy"
|
|
6642 no encoding, just streamcopy
|
|
6643 .IPs "\-oac pcm"
|
|
6644 Encode to uncompressed PCM.
|
|
6645 .IPs "\-oac mp3lame"
|
|
6646 Encode to MP3 (using LAME).
|
|
6647 .IPs "\-oac lavc"
|
|
6648 Encode with a libavcodec codec.
|
|
6649 .RE
|
|
6650 .PD 1
|
|
6651 .
|
|
6652 .TP
|
|
6653 .B \-of <format> (BETA CODE!)
|
|
6654 Encode to the specified container format (default: AVI).
|
|
6655 .br
|
|
6656 .I NOTE:
|
|
6657 Use \-of help to get a list of available container formats.
|
|
6658 .sp 1
|
|
6659 .I EXAMPLE:
|
|
6660 .PD 0
|
|
6661 .RSs
|
|
6662 .IPs "\-of avi"
|
|
6663 Encode to AVI.
|
|
6664 .IPs "\-of mpeg"
|
|
6665 Encode to MPEG (also see \-mpegopts).
|
|
6666 .IPs "\-of lavf"
|
|
6667 Encode with libavformat muxers (also see \-lavfopts).
|
|
6668 .IPs "\-of rawvideo"
|
|
6669 raw video stream (no muxing \- one video stream only)
|
|
6670 .IPs "\-of rawaudio"
|
|
6671 raw audio stream (no muxing \- one audio stream only)
|
|
6672 .RE
|
|
6673 .PD 1
|
|
6674 .
|
|
6675 .TP
|
|
6676 .B \-ofps <fps>
|
|
6677 Specify a frames per second (fps) value for the output file,
|
|
6678 which can be different from that of the source material.
|
|
6679 Must be set for variable fps (ASF, some MOV) and progressive
|
|
6680 (30000/1001 fps telecined MPEG) files.
|
|
6681 .
|
|
6682 .TP
|
|
6683 .B \-ovc <codec name>
|
|
6684 Encode with the given video codec (no default set).
|
|
6685 .br
|
|
6686 .I NOTE:
|
|
6687 Use \-ovc help to get a list of available video codecs.
|
|
6688 .sp 1
|
|
6689 .I EXAMPLE:
|
|
6690 .PD 0
|
|
6691 .RSs
|
|
6692 .IPs "\-ovc copy"
|
|
6693 no encoding, just streamcopy
|
|
6694 .IPs "\-ovc raw"
|
|
6695 Encode to an arbitrary uncompressed format (use '\-vf format' to select).
|
|
6696 .IPs "\-ovc lavc"
|
|
6697 Encode with a libavcodec codec.
|
|
6698 .RE
|
|
6699 .PD 1
|
|
6700 .
|
|
6701 .TP
|
|
6702 .B \-passlogfile <filename>
|
|
6703 Dump first pass information to <filename> instead of the default divx2pass.log
|
|
6704 in two pass encoding mode.
|
|
6705 .
|
|
6706 .TP
|
|
6707 .B \-skiplimit <value>
|
|
6708 Specify the maximum number of frames that may be skipped after
|
|
6709 encoding one frame (\-noskiplimit for unlimited).
|
|
6710 .
|
|
6711 .TP
|
|
6712 .B \-vobsubout <basename>
|
|
6713 Specify the basename for the output .idx and .sub files.
|
|
6714 This turns off subtitle rendering in the encoded movie and diverts it to
|
|
6715 VOBsub subtitle files.
|
|
6716 .
|
|
6717 .TP
|
|
6718 .B \-vobsuboutid <langid>
|
|
6719 Specify the language two letter code for the subtitles.
|
|
6720 This overrides what is read from the DVD or the .ifo file.
|
|
6721 .
|
|
6722 .TP
|
|
6723 .B \-vobsuboutindex <index>
|
|
6724 Specify the index of the subtitles in the output files (default: 0).
|
|
6725 .
|
|
6726 .
|
|
6727 .
|
|
6728 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
|
|
6729 You can specify codec specific encoding parameters using the following
|
|
6730 syntax:
|
|
6731 .
|
|
6732 .TP
|
|
6733 .B \-<codec>opts <option1[=value],option2,...>
|
|
6734 .
|
|
6735 .PP
|
|
6736 Where <codec> may be: lavc, xvidenc, lame, toolame, twolame,
|
|
6737 nuv, xvfw, faac, x264enc, mpeg, lavf.
|
|
6738 .
|
|
6739 .
|
|
6740 .SS lame (\-lameopts)
|
|
6741 .
|
|
6742 .TP
|
|
6743 .B "help\ \ \ "
|
|
6744 get help
|
|
6745 .
|
|
6746 .TP
|
|
6747 .B vbr=<0\-4>
|
|
6748 variable bitrate method
|
|
6749 .PD 0
|
|
6750 .RSs
|
|
6751 .IPs 0
|
|
6752 cbr
|
|
6753 .IPs 1
|
|
6754 mt
|
|
6755 .IPs 2
|
|
6756 rh (default)
|
|
6757 .IPs 3
|
|
6758 abr
|
|
6759 .IPs 4
|
|
6760 mtrh
|
|
6761 .RE
|
|
6762 .PD 1
|
|
6763 .
|
|
6764 .TP
|
|
6765 .B "abr\ \ \ \ "
|
|
6766 average bitrate
|
|
6767 .
|
|
6768 .TP
|
|
6769 .B "cbr\ \ \ \ "
|
|
6770 constant bitrate
|
|
6771 Also forces CBR mode encoding on subsequent ABR presets modes.
|
|
6772 .
|
|
6773 .TP
|
|
6774 .B br=<0\-1024>
|
|
6775 bitrate in kbps (CBR and ABR only)
|
|
6776 .
|
|
6777 .TP
|
|
6778 .B q=<0\-9>
|
|
6779 quality (0 \- highest, 9 \- lowest) (VBR only)
|
|
6780 .
|
|
6781 .TP
|
|
6782 .B aq=<0\-9>
|
|
6783 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest)
|
|
6784 .
|
|
6785 .TP
|
|
6786 .B ratio=<1\-100>
|
|
6787 compression ratio
|
|
6788 .
|
|
6789 .TP
|
|
6790 .B vol=<0\-10>
|
|
6791 audio input gain
|
|
6792 .
|
|
6793 .TP
|
|
6794 .B mode=<0\-3>
|
|
6795 (default: auto)
|
|
6796 .PD 0
|
|
6797 .RSs
|
|
6798 .IPs 0
|
|
6799 stereo
|
|
6800 .IPs 1
|
|
6801 joint-stereo
|
|
6802 .IPs 2
|
|
6803 dualchannel
|
|
6804 .IPs 3
|
|
6805 mono
|
|
6806 .RE
|
|
6807 .PD 1
|
|
6808 .
|
|
6809 .TP
|
|
6810 .B padding=<0\-2>
|
|
6811 .PD 0
|
|
6812 .RSs
|
|
6813 .IPs 0
|
|
6814 none
|
|
6815 .IPs 1
|
|
6816 all
|
|
6817 .IPs 2
|
|
6818 adjust
|
|
6819 .RE
|
|
6820 .PD 1
|
|
6821 .
|
|
6822 .TP
|
|
6823 .B "fast\ \ \ "
|
|
6824 Switch on faster encoding on subsequent VBR presets modes.
|
|
6825 This results in slightly lower quality and higher bitrates.
|
|
6826 .
|
|
6827 .TP
|
|
6828 .B highpassfreq=<freq>
|
|
6829 Set a highpass filtering frequency in Hz.
|
|
6830 Frequencies below the specified one will be cut off.
|
|
6831 A value of -1 will disable filtering, a value of 0
|
|
6832 will let LAME choose values automatically.
|
|
6833 .
|
|
6834 .TP
|
|
6835 .B lowpassfreq=<freq>
|
|
6836 Set a lowpass filtering frequency in Hz.
|
|
6837 Frequencies above the specified one will be cut off.
|
|
6838 A value of -1 will disable filtering, a value of 0
|
|
6839 will let LAME choose values automatically.
|
|
6840 .
|
|
6841 .TP
|
|
6842 .B preset=<value>
|
|
6843 preset values
|
|
6844 .RSs
|
|
6845 .IPs "help\ "
|
|
6846 Print additional options and information about presets settings.
|
|
6847 .IPs medium
|
|
6848 VBR encoding, good quality, 150\-180 kbps bitrate range
|
|
6849 .IPs standard
|
|
6850 VBR encoding, high quality, 170\-210 kbps bitrate range
|
|
6851 .IPs extreme
|
|
6852 VBR encoding, very high quality, 200\-240 kbps bitrate range
|
|
6853 .IPs insane
|
|
6854 CBR encoding, highest preset quality, 320 kbps bitrate
|
|
6855 .IPs <8\-320>
|
|
6856 ABR encoding at average given kbps bitrate
|
|
6857 .RE
|
|
6858 .sp 1
|
|
6859 .RS
|
|
6860 .I EXAMPLES:
|
|
6861 .RE
|
|
6862 .PD 0
|
|
6863 .RSs
|
|
6864 .IPs fast:preset=standard
|
|
6865 suitable for most people and most music types and already quite high quality
|
|
6866 .IPs cbr:preset=192
|
|
6867 Encode with ABR presets at a 192 kbps forced constant bitrate.
|
|
6868 .IPs preset=172
|
|
6869 Encode with ABR presets at a 172 kbps average bitrate.
|
|
6870 .IPs preset=extreme
|
|
6871 for people with extremely good hearing and similar equipment
|
|
6872 .RE
|
|
6873 .PD 1
|
|
6874 .
|
|
6875 .
|
|
6876 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively)
|
|
6877 .
|
|
6878 .TP
|
|
6879 .B br=<32\-384>
|
|
6880 In CBR mode this parameter indicates the bitrate in kbps,
|
|
6881 when in VBR mode it is the minimum bitrate allowed per frame.
|
|
6882 VBR mode will not work with a value below 112.
|
|
6883 .
|
|
6884 .TP
|
|
6885 .B vbr=<-50\-50> (VBR only)
|
|
6886 variability range; if negative the encoder shifts the average bitrate
|
|
6887 towards the lower limit, if positive towards the higher.
|
|
6888 When set to 0 CBR is used (default).
|
|
6889 .
|
|
6890 .TP
|
|
6891 .B maxvbr=<32\-384> (VBR only)
|
|
6892 maximum bitrate allowed per frame, in kbps
|
|
6893 .
|
|
6894 .TP
|
|
6895 .B mode=<stereo | jstereo | mono | dual>
|
|
6896 (default: mono for 1-channel audio, stereo otherwise)
|
|
6897 .
|
|
6898 .TP
|
|
6899 .B psy=<-1\-4>
|
|
6900 psychoacoustic model (default: 2)
|
|
6901 .
|
|
6902 .TP
|
|
6903 .B errprot=<0 | 1>
|
|
6904 Include error protection.
|
|
6905 .
|
|
6906 .TP
|
|
6907 .B debug=<0\-10>
|
|
6908 debug level
|
|
6909 .RE
|
|
6910 .PD 1
|
|
6911 .
|
|
6912 .
|
|
6913 .SS faac (\-faacopts)
|
|
6914 .
|
|
6915 .TP
|
|
6916 .B br=<bitrate>
|
|
6917 average bitrate in kbps (mutually exclusive with quality)
|
|
6918 .
|
|
6919 .TP
|
|
6920 .B quality=<1\-1000>
|
|
6921 quality mode, the higher the better (mutually exclusive with br)
|
|
6922 .
|
|
6923 .TP
|
|
6924 .B object=<1\-4>
|
|
6925 object type complexity
|
|
6926 .PD 0
|
|
6927 .RSs
|
|
6928 .IPs 1
|
|
6929 MAIN (default)
|
|
6930 .IPs 2
|
|
6931 LOW
|
|
6932 .IPs 3
|
|
6933 SSR
|
|
6934 .IPs 4
|
|
6935 LTP (extremely slow)
|
|
6936 .RE
|
|
6937 .PD 1
|
|
6938 .
|
|
6939 .TP
|
|
6940 .B mpeg=<2|4>
|
|
6941 MPEG version (default: 4)
|
|
6942 .
|
|
6943 .TP
|
|
6944 .B "tns\ \ \ \ "
|
|
6945 Enables temporal noise shaping.
|
|
6946 .
|
|
6947 .TP
|
|
6948 .B cutoff=<0\-sampling_rate/2>
|
|
6949 cutoff frequency (default: sampling_rate/2)
|
|
6950 .
|
|
6951 .TP
|
|
6952 .B "raw\ \ \ \ "
|
|
6953 Stores the bitstream as raw payload with extradata in the container header
|
|
6954 (default: 0, corresponds to ADTS).
|
|
6955 Do not set this flag if not explicitly required or you will not be able to
|
|
6956 remux the audio stream later on.
|
|
6957 .RE
|
|
6958 .PD 1
|
|
6959 .
|
|
6960 .
|
|
6961 .SS lavc (\-lavcopts)
|
|
6962 .
|
|
6963 Many libavcodec (lavc for short) options are tersely documented.
|
|
6964 Read the source for full details.
|
|
6965 .PP
|
|
6966 .I EXAMPLE:
|
|
6967 .PD 0
|
|
6968 .RSs
|
|
6969 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
|
|
6970 .RE
|
|
6971 .PD 1
|
|
6972 .
|
|
6973 .TP
|
|
6974 .B acodec=<value>
|
|
6975 audio codec (default: mp2)
|
|
6976 .PD 0
|
|
6977 .RSs
|
|
6978 .IPs "mp2\ \ "
|
|
6979 MPEG Layer 2
|
|
6980 .IPs "mp3\ \ "
|
|
6981 MPEG Layer 3
|
|
6982 .IPs "ac3\ \ "
|
|
6983 AC3
|
|
6984 .IPs adpcm_ima_wav
|
|
6985 IMA Adaptive PCM (4bits per sample, 4:1 compression)
|
|
6986 .IPs "sonic\ "
|
|
6987 Experimental lossy/lossless codec
|
|
6988 .RE
|
|
6989 .PD 1
|
|
6990 .
|
|
6991 .TP
|
|
6992 .B abitrate=<value>
|
|
6993 audio bitrate in kbps (default: 224)
|
|
6994 .
|
|
6995 .TP
|
|
6996 .B atag=<value>
|
|
6997 Use the specified Windows audio format tag (e.g.\& atag=0x55).
|
|
6998 .
|
|
6999 .TP
|
|
7000 .B bit_exact
|
|
7001 Use only bit exact algorithms (except (I)DCT).
|
|
7002 Additionally bit_exact disables several optimizations and thus
|
|
7003 should only be used for regression tests, which need binary
|
|
7004 identical files even if the encoder version changes.
|
|
7005 This also suppresses the user_data header in MPEG-4 streams.
|
|
7006 Do not use this option unless you know exactly what you are doing.
|
|
7007 .
|
|
7008 .TP
|
|
7009 .B threads=<1\-8>
|
|
7010 Maximum number of threads to use (default: 1).
|
|
7011 May have a slight negative effect on motion estimation.
|
|
7012 .RE
|
|
7013 .
|
|
7014 .TP
|
|
7015 .B vcodec=<value>
|
|
7016 Employ the specified codec (default: mpeg4).
|
|
7017 .PD 0
|
|
7018 .RSs
|
|
7019 .IPs mjpeg
|
|
7020 Motion JPEG
|
|
7021 .IPs ljpeg
|
|
7022 Lossless JPEG
|
|
7023 .IPs "h261\ "
|
|
7024 H.261
|
|
7025 .IPs "h263\ "
|
|
7026 H.263
|
|
7027 .IPs h263p
|
|
7028 H.263+
|
|
7029 .IPs mpeg4
|
|
7030 MPEG-4 (DivX 4/5)
|
|
7031 .IPs msmpeg4
|
|
7032 DivX 3
|
|
7033 .IPs msmpeg4v2
|
|
7034 MS MPEG4v2
|
|
7035 .IPs "wmv1\ "
|
|
7036 Windows Media Video, version 1 (AKA WMV7)
|
|
7037 .IPs "wmv2\ "
|
|
7038 Windows Media Video, version 2 (AKA WMV8)
|
|
7039 .IPs "rv10\ "
|
|
7040 an old RealVideo codec
|
|
7041 .IPs mpeg1video
|
|
7042 MPEG-1 video
|
|
7043 .IPs mpeg2video
|
|
7044 MPEG-2 video
|
|
7045 .IPs huffyuv
|
|
7046 HuffYUV
|
|
7047 .IPs ffvhuff (also see: vstrict)
|
|
7048 nonstandard 20% smaller HuffYUV using YV12
|
|
7049 .IPs "asv1\ "
|
|
7050 ASUS Video v1
|
|
7051 .IPs "asv2\ "
|
|
7052 ASUS Video v2
|
|
7053 .IPs "ffv1 (also see: vstrict)"
|
|
7054 FFmpeg's lossless video codec
|
|
7055 .IPs "flv\ \ "
|
|
7056 Sorenson H.263 used in Flash Video
|
|
7057 .IPs dvvideo
|
|
7058 Sony Digital Video
|
|
7059 .IPs "svq1\ "
|
|
7060 Apple Sorenson Video 1
|
|
7061 .IPs "snow (also see: vstrict)"
|
|
7062 FFmpeg's experimental wavelet-based codec
|
|
7063 .RE
|
|
7064 .PD 1
|
|
7065 .
|
|
7066 .TP
|
|
7067 .B vqmin=<1\-31>
|
|
7068 minimum quantizer (pass 1/2)
|
|
7069 .RSs
|
|
7070 .IPs 1
|
|
7071 Not recommended (much larger file, little quality difference and weird side
|
|
7072 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
|
|
7073 resulting in lower quality and some decoders will not be able to decode it).
|
|
7074 .IPs 2
|
|
7075 Recommended for normal mpeg4/\:mpeg1video encoding (default).
|
|
7076 .IPs 3
|
|
7077 Recommended for h263(p)/\:msmpeg4.
|
|
7078 The reason for preferring 3 over 2 is that 2 could lead to overflows.
|
|
7079 (This will be fixed for h263(p) by changing the quantizer per MB in
|
|
7080 the future, msmpeg4 cannot be fixed as it does not support that.)
|
|
7081 .RE
|
|
7082 .
|
|
7083 .TP
|
|
7084 .B lmin=<0.01\-255.0>
|
20768
|
7085 Minimum frame-level Lagrange multiplier for ratecontrol (default: 2.0).
|
|
7086 Lavc will rarely use quantizers below the value of lmin.
|
|
7087 Lowering lmin will make lavc more likely to choose lower quantizers for
|
|
7088 some frames, but not lower than the value of vqmin.
|
|
7089 Likewise, raising lmin will make lavc less likely to choose low
|
|
7090 quantizers, even if vqmin would have allowed them.
|
|
7091 You probably want to set lmin approximately equal to vqmin.
|
|
7092 When adaptive quantization is in use, changing lmin/lmax may have less
|
|
7093 of an effect; see mblmin/mblmax.
|
20707
|
7094 .RE
|
|
7095 .
|
|
7096 .TP
|
|
7097 .B lmax=<0.01\-255.0>
|
|
7098 maximum Lagrange multiplier for ratecontrol (default: 31.0)
|
|
7099 .RE
|
|
7100 .
|
|
7101 .TP
|
20768
|
7102 .B mblmin=<0.01\-255.0>
|
|
7103 Minimum macroblock-level Lagrange multiplier for ratecontrol
|
|
7104 (default:2.0).
|
|
7105 This parameter affects adaptive quantization options like qprd,
|
|
7106 lumi_mask, etc..
|
|
7107 .RE
|
|
7108 .
|
|
7109 .TP
|
|
7110 .B mblmax=<0.01\-255.0>
|
|
7111 Maximum macroblock-level Lagrange multiplier for ratecontrol
|
|
7112 (default: 31.0).
|
|
7113 .RE
|
|
7114 .
|
|
7115 .TP
|
20707
|
7116 .B vqscale=<0\-31>
|
|
7117 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
|
|
7118 A lower value means better quality but larger files (default: 0).
|
|
7119 In case of snow codec, value 0 means lossless encoding.
|
|
7120 Since the other codecs do not support this, vqscale=0 will be ignored and
|
|
7121 variable quantizers are used, which is the default.
|
|
7122 1 is not recommended (see vqmin for details).
|
|
7123 .
|
|
7124 .TP
|
|
7125 .B vqmax=<1\-31>
|
|
7126 Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31).
|
|
7127 .
|
|
7128 .TP
|
|
7129 .B mbqmin=<1\-31>
|
|
7130 obsolete, use vqmin
|
|
7131 .
|
|
7132 .TP
|
|
7133 .B mbqmax=<1\-31>
|
|
7134 obsolete, use vqmax
|
|
7135 .
|
|
7136 .TP
|
|
7137 .B vqdiff=<1\-31>
|
|
7138 maximum quantizer difference between consecutive I- or P-frames
|
|
7139 (pass 1/2) (default: 3)
|
|
7140 .
|
|
7141 .TP
|
|
7142 .B vmax_b_frames=<0\-4>
|
|
7143 maximum number of B-frames between non-B-frames:
|
|
7144 .PD 0
|
|
7145 .RSs
|
|
7146 .IPs 0
|
|
7147 no B-frames (default)
|
|
7148 .IPs 0\-2
|
|
7149 sane range for MPEG-4
|
|
7150 .RE
|
|
7151 .PD 1
|
|
7152 .
|
|
7153 .TP
|
|
7154 .B vme=<0\-5>
|
|
7155 motion estimation method.
|
|
7156 Available methods are:
|
|
7157 .PD 0
|
|
7158 .RSs
|
|
7159 .IPs 0
|
|
7160 none (very low quality)
|
|
7161 .IPs 1
|
|
7162 full (slow, currently unmaintained and disabled)
|
|
7163 .IPs 2
|
|
7164 log (low quality, currently unmaintained and disabled)
|
|
7165 .IPs 3
|
|
7166 phods (low quality, currently unmaintained and disabled)
|
|
7167 .IPs 4
|
|
7168 EPZS: size=1 diamond, size can be adjusted with the *dia options
|
|
7169 (default)
|
|
7170 .IPs 5
|
|
7171 X1 (experimental, currently aliased to EPZS)
|
|
7172 .IPs 8
|
|
7173 iter (iterative overlapped block, only used in snow)
|
|
7174 .RE
|
|
7175 .PD 1
|
|
7176 .sp 1
|
|
7177 .RS
|
|
7178 .br
|
|
7179 .I NOTE:
|
|
7180 0\-3 currently ignores the amount of bits spent,
|
|
7181 so quality may be low.
|
|
7182 .RE
|
|
7183 .
|
|
7184 .TP
|
|
7185 .B me_range=<0\-9999>
|
|
7186 motion estimation search range (default: 0 (unlimited))
|
|
7187 .
|
|
7188 .TP
|
|
7189 .B mbd=<0\-2>
|
|
7190 Macroblock decision algorithm (high quality mode), encode each macro
|
|
7191 block in all modes and choose the best.
|
|
7192 This is slow but results in better quality and file size.
|
|
7193 .PD 0
|
|
7194 .RSs
|
|
7195 .IPs 0
|
|
7196 Use mbcmp (default).
|
|
7197 .IPs 1
|
|
7198 Select the MB mode which needs the fewest bits (=vhq).
|
|
7199 .IPs 2
|
|
7200 Select the MB mode which has the best rate distortion.
|
|
7201 .RE
|
|
7202 .PD 1
|
|
7203 .
|
|
7204 .TP
|
|
7205 .B "vhq\ \ \ \ "
|
|
7206 Same as mbd=1, kept for compatibility reasons.
|
|
7207 .
|
|
7208 .TP
|
|
7209 .B "v4mv\ \ \ "
|
|
7210 Allow 4 motion vectors per macroblock (slightly better quality).
|
|
7211 Works better if used with mbd>0.
|
|
7212 .
|
|
7213 .TP
|
|
7214 .B "obmc\ \ \ "
|
|
7215 overlapped block motion compensation (H.263+)
|
|
7216 .
|
|
7217 .TP
|
|
7218 .B "loop\ \ \ "
|
|
7219 loop filter (H.263+)
|
|
7220 note, this is broken
|
|
7221 .
|
|
7222 .TP
|
|
7223 .B inter_threshold <-1000\-1000>
|
|
7224 Does absolutely nothing at the moment.
|
|
7225 .
|
|
7226 .TP
|
|
7227 .B keyint=<0\-300>
|
|
7228 maximum interval between keyframes in frames (default: 250 or one
|
|
7229 keyframe every ten seconds in a 25fps movie.
|
|
7230 This is the recommended default for MPEG-4).
|
|
7231 Most codecs require regular keyframes in order to limit the accumulation of mismatch error.
|
|
7232 Keyframes are also needed for seeking, as seeking is only possible to a keyframe - but
|
|
7233 keyframes need more space than other frames, so larger numbers here mean
|
|
7234 slightly smaller files but less precise seeking.
|
|
7235 0 is equivalent to 1, which makes every frame a keyframe.
|
|
7236 Values >300 are not recommended as the quality might be bad depending upon
|
|
7237 decoder, encoder and luck.
|
|
7238 It is a common for MPEG-1/2 to use values <=30.
|
|
7239 .
|
|
7240 .TP
|
|
7241 .B sc_threshold=<-1000000000\-1000000000>
|
|
7242 Threshold for scene change detection.
|
|
7243 A keyframe is inserted by libavcodec when it detects a scene change.
|
|
7244 You can specify the sensitivity of the detection with this option.
|
|
7245 -1000000000 means there is a scene change detected at every frame,
|
|
7246 1000000000 means no scene changes are detected (default: 0).
|
|
7247 .
|
|
7248 .TP
|
|
7249 .B sc_factor=<any positive integer>
|
|
7250 Causes frames with higher quantizers to be more likely to trigger a
|
|
7251 scene change detection and make libavcodec use an I-frame (default: 1).
|
|
7252 1\-16 is a sane range.
|
|
7253 Values between 2 and 6 may yield increasing PSNR (up to approximately
|
|
7254 0.04 dB) and better placement of I-frames in high-motion scenes.
|
|
7255 Higher values than 6 may give very slightly better PSNR (approximately
|
|
7256 0.01 dB more than sc_factor=6), but noticably worse visual quality.
|
|
7257 .
|
|
7258 .TP
|
|
7259 .B vb_strategy=<0\-2> (pass one only)
|
|
7260 strategy to choose between I/P/B-frames:
|
|
7261 .PD 0
|
|
7262 .RSs
|
|
7263 .IPs 0
|
|
7264 Always use the maximum number of B-frames (default).
|
|
7265 .IPs 1
|
|
7266 Avoid B-frames in high motion scenes.
|
|
7267 See the b_sensitivity option to tune this strategy.
|
|
7268 .IPs 2
|
|
7269 Places B-frames more or less optimally to yield maximum quality (slower).
|
|
7270 You may want to reduce the speed impact of this option by tuning the
|
|
7271 option brd_scale.
|
|
7272 .RE
|
|
7273 .PD 1
|
|
7274 .
|
|
7275 .TP
|
|
7276 .B b_sensitivity=<any integer greater than 0>
|
|
7277 Adjusts how sensitively vb_strategy=1 detects motion and avoids using
|
|
7278 B-frames (default: 40).
|
|
7279 Lower sensitivities will result in more B-frames.
|
|
7280 Using more B-frames usually improves PSNR, but too many B-frames can
|
|
7281 hurt quality in high-motion scenes.
|
|
7282 Unless there is an extremely high amount of motion, b_sensitivity can
|
|
7283 safely be lowered below the default; 10 is a reasonable value in most
|
|
7284 cases.
|
|
7285 .
|
|
7286 .TP
|
|
7287 .B brd_scale=<0\-10>
|
|
7288 Downscales frames for dynamic B-frame decision (default: 0).
|
|
7289 Each time brd_scale is increased by one, the frame dimensions are
|
|
7290 divided by two, which improves speed by a factor of four.
|
|
7291 Both dimensions of the fully downscaled frame must be even numbers, so
|
|
7292 brd_scale=1 requires the original dimensions to be multiples of four,
|
|
7293 brd_scale=2 requires multiples of eight, etc.
|
|
7294 In other words, the dimensions of the original frame must both be
|
|
7295 divisible by 2^(brd_scale+1) with no remainder.
|
|
7296 .
|
|
7297 .TP
|
|
7298 .B bidir_refine=<0\-4>
|
|
7299 Refine the two motion vectors used in bidirectional macroblocks,
|
|
7300 rather than re-using vectors from the forward and backward searches.
|
|
7301 This option has no effect without B-frames.
|
|
7302 .PD 0
|
|
7303 .RSs
|
|
7304 .IPs 0
|
|
7305 Disabled (default).
|
|
7306 .IPs 1\-4
|
|
7307 Use a wider search (larger values are slower).
|
|
7308 .RE
|
|
7309 .PD 1
|
|
7310 .
|
|
7311 .TP
|
|
7312 .B vpass=<1\-3>
|
|
7313 Activates internal two (or more) pass mode, only specify if you wish to
|
|
7314 use two (or more) pass encoding.
|
|
7315 .PD 0
|
|
7316 .RSs
|
|
7317 .IPs 1
|
|
7318 first pass (also see turbo)
|
|
7319 .IPs 2
|
|
7320 second pass
|
|
7321 .IPs 3
|
|
7322 Nth pass (second and subsequent passes of N-pass encoding)
|
|
7323 .RE
|
|
7324 .RS
|
|
7325 Here is how it works, and how to use it:
|
|
7326 .br
|
|
7327 The first pass (vpass=1) writes the statistics file.
|
|
7328 You might want to deactivate some CPU-hungry options, like "turbo"
|
|
7329 mode does.
|
|
7330 .br
|
|
7331 In two pass mode, the second pass (vpass=2) reads the statistics file and
|
|
7332 bases ratecontrol decisions on it.
|
|
7333 .br
|
|
7334 In N-pass mode, the second pass (vpass=3, that is not a typo)
|
|
7335 does both: It first reads the statistics, then overwrites them.
|
|
7336 You might want to backup divx2pass.log before doing this if there is
|
|
7337 any possibility that you will have to cancel MEncoder.
|
|
7338 You can use all encoding options, except very CPU-hungry options like "qns".
|
|
7339 .br
|
|
7340 You can run this same pass over and over to refine the encode.
|
|
7341 Each subsequent pass will use the statistics from the previous pass to improve.
|
|
7342 The final pass can include any CPU-hungry encoding options.
|
|
7343 .br
|
|
7344 If you want a 2 pass encode, use first vpass=1, and then vpass=2.
|
|
7345 .br
|
|
7346 If you want a 3 or more pass encode, use vpass=1 for the first pass
|
|
7347 and then vpass=3 and then vpass=3 again and again until you are
|
|
7348 satisfied with the encode.
|
|
7349 .RE
|
|
7350 .PD 1
|
|
7351 .sp 1
|
|
7352 .RS
|
|
7353 huffyuv:
|
|
7354 .RE
|
|
7355 .PD 0
|
|
7356 .RSs
|
|
7357 .IPs "pass 1"
|
|
7358 Saves statistics.
|
|
7359 .IPs "pass 2"
|
|
7360 Encodes with an optimal Huffman table based upon statistics
|
|
7361 from the first pass.
|
|
7362 .RE
|
|
7363 .PD 1
|
|
7364 .
|
|
7365 .TP
|
|
7366 .B turbo (two pass only)
|
|
7367 Dramatically speeds up pass one using faster algorithms and disabling
|
|
7368 CPU-intensive options.
|
|
7369 This will probably reduce global PSNR a little bit (around 0.01dB) and
|
|
7370 change individual frame type and PSNR a little bit more (up to 0.03dB).
|
|
7371 .
|
|
7372 .TP
|
|
7373 .B aspect=<x/y>
|
|
7374 Store movie aspect internally, just like with MPEG files.
|
|
7375 Much nicer than rescaling, because quality is not decreased.
|
|
7376 Only MPlayer will play these files correctly, other players will display
|
|
7377 them with wrong aspect.
|
|
7378 The aspect parameter can be given as a ratio or a floating point number.
|
|
7379 .sp 1
|
|
7380 .RS
|
|
7381 .I EXAMPLE:
|
|
7382 .RE
|
|
7383 .RSs
|
|
7384 .PD 0
|
|
7385 .IPs "aspect=16/9 or aspect=1.78"
|
|
7386 .PD 1
|
|
7387 .RE
|
|
7388 .
|
|
7389 .TP
|
|
7390 .B autoaspect
|
|
7391 Same as the aspect option, but automatically computes aspect, taking
|
|
7392 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
|
|
7393 filter chain.
|
|
7394 Does not incur a performance penalty, so you can safely leave it
|
|
7395 always on.
|
|
7396 .
|
|
7397 .TP
|
|
7398 .B vbitrate=<value>
|
|
7399 Specify bitrate (pass 1/2) (default: 800).
|
|
7400 .br
|
|
7401 .I WARNING:
|
|
7402 1kbit = 1000 bits
|
|
7403 .PD 0
|
|
7404 .RSs
|
|
7405 .IPs 4\-16000
|
|
7406 (in kbit)
|
|
7407 .IPs 16001\-24000000
|
|
7408 (in bit)
|
|
7409 .RE
|
|
7410 .PD 1
|
|
7411 .
|
|
7412 .TP
|
|
7413 .B vratetol=<value>
|
|
7414 approximated file size tolerance in kbit.
|
|
7415 1000\-100000 is a sane range.
|
|
7416 (warning: 1kbit = 1000 bits)
|
|
7417 (default: 8000)
|
|
7418 .br
|
|
7419 .I NOTE:
|
|
7420 vratetol should not be too large during the second pass or there might
|
|
7421 be problems if vrc_(min|max)rate is used.
|
|
7422 .
|
|
7423 .TP
|
|
7424 .B vrc_maxrate=<value>
|
|
7425 maximum bitrate in kbit/\:sec (pass 1/2)
|
|
7426 (default: 0, unlimited)
|
|
7427 .
|
|
7428 .TP
|
|
7429 .B vrc_minrate=<value>
|
|
7430 minimum bitrate in kbit/\:sec (pass 1/2)
|
|
7431 (default: 0, unlimited)
|
|
7432 .
|
|
7433 .TP
|
|
7434 .B vrc_buf_size=<value>
|
|
7435 buffer size in kbit (pass 1/2).
|
|
7436 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD,
|
|
7437 917 for SVCD and 1835 for DVD.
|
|
7438 .
|
|
7439 .TP
|
|
7440 .B vrc_buf_aggressivity
|
|
7441 currently useless
|
|
7442 .
|
|
7443 .TP
|
|
7444 .B vrc_strategy
|
|
7445 Ratecontrol method.
|
|
7446 Note that some of the ratecontrol-affecting options will have no effect
|
|
7447 if vrc_strategy is not set to 0.
|
|
7448 .PD 0
|
|
7449 .RSs
|
|
7450 .IPs 0
|
|
7451 Use internal lavc ratecontrol (default).
|
|
7452 .IPs 1
|
|
7453 Use XviD ratecontrol (experimental; requires MEncoder to be compiled
|
|
7454 with support for XviD 1.1 or higher).
|
|
7455 .RE
|
|
7456 .PD 1
|
|
7457 .
|
|
7458 .TP
|
|
7459 .B vb_qfactor=<-31.0\-31.0>
|
|
7460 quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25)
|
|
7461 .
|
|
7462 .TP
|
|
7463 .B vi_qfactor=<-31.0\-31.0>
|
|
7464 quantizer factor between I- and non-I-frames (pass 1/2) (default: 0.8)
|
|
7465 .
|
|
7466 .TP
|
|
7467 .B vb_qoffset=<-31.0\-31.0>
|
|
7468 quantizer offset between B- and non-B-frames (pass 1/2) (default: 1.25)
|
|
7469 .
|
|
7470 .TP
|
|
7471 .B vi_qoffset=<-31.0\-31.0>
|
|
7472 (pass 1/2) (default: 0.0)
|
|
7473 .br
|
|
7474 if v{b|i}_qfactor > 0
|
|
7475 .br
|
|
7476 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
|
|
7477 .br
|
|
7478 else
|
|
7479 .br
|
|
7480 do normal ratecontrol (do not lock to next P-frame quantizer) and
|
|
7481 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
|
|
7482 .br
|
|
7483 .I HINT:
|
|
7484 To do constant quantizer encoding with different quantizers for
|
|
7485 I/P- and B-frames you can use:
|
|
7486 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>.
|
|
7487 .
|
|
7488 .TP
|
|
7489 .B vqblur=<0.0\-1.0> (pass one)
|
|
7490 Quantizer blur (default: 0.5), larger values will average the
|
|
7491 quantizer more over time (slower change).
|
|
7492 .PD 0
|
|
7493 .RSs
|
|
7494 .IPs 0.0
|
|
7495 Quantizer blur disabled.
|
|
7496 .IPs 1.0
|
|
7497 Average the quantizer over all previous frames.
|
|
7498 .RE
|
|
7499 .PD 1
|
|
7500 .
|
|
7501 .TP
|
|
7502 .B vqblur=<0.0\-99.0> (pass two)
|
|
7503 Quantizer gaussian blur (default: 0.5), larger values will average
|
|
7504 the quantizer more over time (slower change).
|
|
7505 .
|
|
7506 .TP
|
|
7507 .B vqcomp=<0.0\-1.0>
|
|
7508 Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5).
|
|
7509 For instance, assuming the default rate control equation is used,
|
|
7510 if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits
|
|
7511 needed to encode them all at the same QP.
|
|
7512 If vqcomp=0.0, the ratecontrol allocates the same number of bits to each
|
|
7513 frame, i.e. strict CBR.
|
|
7514 .I NOTE:
|
|
7515 Those are extreme settings and should never be used.
|
|
7516 Perceptual quality will be optimal somewhere in between these two extremes.
|
|
7517 .
|
|
7518 .TP
|
|
7519 .B vrc_eq=<equation>
|
|
7520 main ratecontrol equation (pass 1/2)
|
|
7521 .RE
|
|
7522 .RSs
|
|
7523 .IPs "1\ \ \ \ "
|
|
7524 constant bitrate
|
|
7525 .IPs "tex\ \ "
|
|
7526 constant quality
|
|
7527 .IPs 1+(tex/\:avgTex-1)*qComp
|
|
7528 approximately the equation of the old ratecontrol code
|
|
7529 .IPs tex^qComp
|
|
7530 with qcomp 0.5 or something like that (default)
|
|
7531 .RE
|
|
7532 .PP
|
|
7533 .RS
|
|
7534 infix operators:
|
|
7535 .RE
|
|
7536 .RSs
|
|
7537 .IPs +,-,*,/,^
|
|
7538 .RE
|
|
7539 .PP
|
|
7540 .RS
|
|
7541 variables:
|
|
7542 .RE
|
|
7543 .RSs
|
|
7544 .IPs "tex\ \ "
|
|
7545 texture complexity
|
|
7546 .IPs iTex,pTex
|
|
7547 intra, non-intra texture complexity
|
|
7548 .IPs avgTex
|
|
7549 average texture complexity
|
|
7550 .IPs avgIITex
|
|
7551 average intra texture complexity in I-frames
|
|
7552 .IPs avgPITex
|
|
7553 average intra texture complexity in P-frames
|
|
7554 .IPs avgPPTex
|
|
7555 average non-intra texture complexity in P-frames
|
|
7556 .IPs avgBPTex
|
|
7557 average non-intra texture complexity in B-frames
|
|
7558 .IPs "mv\ \ \ "
|
|
7559 bits used for motion vectors
|
|
7560 .IPs fCode
|
|
7561 maximum length of motion vector in log2 scale
|
|
7562 .IPs iCount
|
|
7563 number of intra macroblocks / number of macroblocks
|
|
7564 .IPs "var\ \ "
|
|
7565 spatial complexity
|
|
7566 .IPs mcVar
|
|
7567 temporal complexity
|
|
7568 .IPs qComp
|
|
7569 qcomp from the command line
|
|
7570 .IPs "isI, isP, isB"
|
|
7571 Is 1 if picture type is I/P/B else 0.
|
|
7572 .IPs "Pi,E\ "
|
|
7573 See your favorite math book.
|
|
7574 .RE
|
|
7575 .PP
|
|
7576 .RS
|
|
7577 functions:
|
|
7578 .RE
|
|
7579 .RSs
|
|
7580 .IPs max(a,b),min(a,b)
|
|
7581 maximum / minimum
|
|
7582 .IPs gt(a,b)
|
|
7583 is 1 if a>b, 0 otherwise
|
|
7584 .IPs lt(a,b)
|
|
7585 is 1 if a<b, 0 otherwise
|
|
7586 .IPs eq(a,b)
|
|
7587 is 1 if a==b, 0 otherwise
|
|
7588 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
|
|
7589 .RE
|
|
7590 .
|
|
7591 .TP
|
|
7592 .B vrc_override=<options>
|
|
7593 User specified quality for specific parts (ending, credits, ...) (pass 1/2).
|
|
7594 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>,
|
|
7595 <end-frame>, <quality>[/...]]:
|
|
7596 .PD 0
|
|
7597 .RSs
|
|
7598 .IPs "quality (2\-31)"
|
|
7599 quantizer
|
|
7600 .IPs "quality (-500\-0)"
|
|
7601 quality correction in %
|
|
7602 .RE
|
|
7603 .PD 1
|
|
7604 .
|
|
7605 .TP
|
|
7606 .B vrc_init_cplx=<0\-1000>
|
|
7607 initial complexity (pass 1)
|
|
7608 .
|
|
7609 .TP
|
|
7610 .B vrc_init_occupancy=<0.0\-1.0>
|
|
7611 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9)
|
|
7612 .
|
|
7613 .TP
|
|
7614 .B vqsquish=<0|1>
|
|
7615 Specify how to keep the quantizer between qmin and qmax (pass 1/2).
|
|
7616 .PD 0
|
|
7617 .RSs
|
|
7618 .IPs 0
|
|
7619 Use clipping.
|
|
7620 .IPs 1
|
|
7621 Use a nice differentiable function (default).
|
|
7622 .RE
|
|
7623 .PD 1
|
|
7624 .
|
|
7625 .TP
|
|
7626 .B vlelim=<-1000\-1000>
|
|
7627 Sets single coefficient elimination threshold for luminance.
|
|
7628 Negative values will also consider the DC coefficient (should be at least -4
|
|
7629 or lower for encoding at quant=1):
|
|
7630 .PD 0
|
|
7631 .RSs
|
|
7632 .IPs 0
|
|
7633 disabled (default)
|
|
7634 .IPs -4
|
|
7635 JVT recommendation
|
|
7636 .RE
|
|
7637 .PD 1
|
|
7638 .
|
|
7639 .TP
|
|
7640 .B vcelim=<-1000\-1000>
|
|
7641 Sets single coefficient elimination threshold for chrominance.
|
|
7642 Negative values will also consider the DC coefficient (should be at least -4
|
|
7643 or lower for encoding at quant=1):
|
|
7644 .PD 0
|
|
7645 .RSs
|
|
7646 .IPs 0
|
|
7647 disabled (default)
|
|
7648 .IPs 7
|
|
7649 JVT recommendation
|
|
7650 .RE
|
|
7651 .PD 1
|
|
7652 .
|
|
7653 .TP
|
|
7654 .B vstrict=<-2|-1|0|1>
|
|
7655 strict standard compliance
|
|
7656 .PD 0
|
|
7657 .RSs
|
|
7658 .IPs 0
|
|
7659 disabled
|
|
7660 .IPs 1
|
|
7661 Only recommended if you want to feed the output into the
|
|
7662 MPEG-4 reference decoder.
|
|
7663 .IPs -1
|
|
7664 Allow libavcodec specific extensions (default).
|
|
7665 .IPs -2
|
|
7666 Enables experimental codecs and features which may not be playable
|
|
7667 with future MPlayer versions (snow, ffvhuff, ffv1).
|
|
7668 .RE
|
|
7669 .PD 1
|
|
7670 .
|
|
7671 .TP
|
|
7672 .B "vdpart\ "
|
|
7673 Data partitioning.
|
|
7674 Adds 2 Bytes per video packet, improves error-resistance when transferring over
|
|
7675 unreliable channels (e.g.\& streaming over the internet).
|
|
7676 Each video packet will be encoded in 3 separate partitions:
|
|
7677 .PD 0
|
|
7678 .RSs
|
|
7679 .IPs "1. MVs"
|
|
7680 movement
|
|
7681 .IPs "2. DC coefficients"
|
|
7682 low res picture
|
|
7683 .IPs "3. AC coefficients"
|
|
7684 details
|
|
7685 .RE
|
|
7686 .PD 1
|
|
7687 .RS
|
|
7688 MV & DC are most important, loosing them looks far worse than loosing
|
|
7689 the AC and the 1. & 2. partition.
|
|
7690 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors
|
|
7691 will hit the AC partition much more often than the MV & DC partitions.
|
|
7692 Thus, the picture will look better with partitioning than without,
|
|
7693 as without partitioning an error will trash AC/\:DC/\:MV equally.
|
|
7694 .RE
|
|
7695 .
|
|
7696 .TP
|
|
7697 .B vpsize=<0\-10000> (also see vdpart)
|
|
7698 Video packet size, improves error-resistance.
|
|
7699 .PD 0
|
|
7700 .RSs
|
|
7701 .IPs "0\ \ \ \ "
|
|
7702 disabled (default)
|
|
7703 .IPs 100\-1000
|
|
7704 good choice
|
|
7705 .RE
|
|
7706 .PD 1
|
|
7707 .
|
|
7708 .TP
|
|
7709 .B "ss\ \ \ \ \ "
|
|
7710 slice structured mode for H.263+
|
|
7711 .
|
|
7712 .TP
|
|
7713 .B "gray\ \ \ "
|
|
7714 grayscale only encoding (faster)
|
|
7715 .
|
|
7716 .TP
|
|
7717 .B vfdct=<0\-10>
|
|
7718 DCT algorithm
|
|
7719 .PD 0
|
|
7720 .RSs
|
|
7721 .IPs 0
|
|
7722 Automatically select a good one (default).
|
|
7723 .IPs 1
|
|
7724 fast integer
|
|
7725 .IPs 2
|
|
7726 accurate integer
|
|
7727 .IPs 3
|
|
7728 MMX
|
|
7729 .IPs 4
|
|
7730 mlib
|
|
7731 .IPs 5
|
|
7732 AltiVec
|
|
7733 .IPs 6
|
|
7734 floating point AAN
|
|
7735 .RE
|
|
7736 .PD 1
|
|
7737 .
|
|
7738 .TP
|
|
7739 .B idct=<0\-99>
|
|
7740 IDCT algorithm
|
|
7741 .br
|
|
7742 .I NOTE:
|
|
7743 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests.
|
|
7744 .PD 0
|
|
7745 .RSs
|
|
7746 .IPs 0
|
|
7747 Automatically select a good one (default).
|
|
7748 .IPs 1
|
|
7749 JPEG reference integer
|
|
7750 .IPs 2
|
|
7751 simple
|
|
7752 .IPs 3
|
|
7753 simplemmx
|
|
7754 .IPs 4
|
|
7755 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100)
|
|
7756 .IPs 5
|
|
7757 ps2
|
|
7758 .IPs 6
|
|
7759 mlib
|
|
7760 .IPs 7
|
|
7761 arm
|
|
7762 .IPs 8
|
|
7763 AltiVec
|
|
7764 .IPs 9
|
|
7765 sh4
|
|
7766 .RE
|
|
7767 .PD 1
|
|
7768 .
|
|
7769 .TP
|
|
7770 .B lumi_mask=<0.0\-1.0>
|
|
7771 Luminance masking is a 'psychosensory' setting that is supposed to
|
|
7772 make use of the fact that the human eye tends to notice fewer details
|
|
7773 in very bright parts of the picture.
|
|
7774 Luminance masking compresses bright areas stronger than medium ones,
|
|
7775 so it will save bits that can be spent again on other frames, raising
|
|
7776 overall subjective quality, while possibly reducing PSNR.
|
|
7777 .br
|
|
7778 .I WARNING:
|
|
7779 Be careful, overly large values can cause disastrous things.
|
|
7780 .br
|
|
7781 .I WARNING:
|
|
7782 Large values might look good on some monitors but may look horrible
|
|
7783 on other monitors.
|
|
7784 .PD 0
|
|
7785 .RSs
|
|
7786 .IPs "0.0\ \ "
|
|
7787 disabled (default)
|
|
7788 .IPs 0.0\-0.3
|
|
7789 sane range
|
|
7790 .RE
|
|
7791 .PD 1
|
|
7792 .
|
|
7793 .TP
|
|
7794 .B dark_mask=<0.0\-1.0>
|
|
7795 Darkness masking is a 'psychosensory' setting that is supposed to
|
|
7796 make use of the fact that the human eye tends to notice fewer details
|
|
7797 in very dark parts of the picture.
|
|
7798 Darkness masking compresses dark areas stronger than medium ones,
|
|
7799 so it will save bits that can be spent again on other frames, raising
|
|
7800 overall subjective quality, while possibly reducing PSNR.
|
|
7801 .br
|
|
7802 .I WARNING:
|
|
7803 Be careful, overly large values can cause disastrous things.
|
|
7804 .br
|
|
7805 .I WARNING:
|
|
7806 Large values might look good on some monitors but may look horrible
|
|
7807 on other monitors / TV / TFT.
|
|
7808 .PD 0
|
|
7809 .RSs
|
|
7810 .IPs "0.0\ \ "
|
|
7811 disabled (default)
|
|
7812 .IPs 0.0\-0.3
|
|
7813 sane range
|
|
7814 .RE
|
|
7815 .PD 1
|
|
7816 .
|
|
7817 .TP
|
|
7818 .B tcplx_mask=<0.0\-1.0>
|
|
7819 Temporal complexity masking (default: 0.0 (disabled)).
|
|
7820 Imagine a scene with a bird flying across the whole scene; tcplx_mask
|
|
7821 will raise the quantizers of the bird's macroblocks (thus decreasing their
|
|
7822 quality), as the human eye usually does not have time to see all the bird's
|
|
7823 details.
|
|
7824 Be warned that if the masked object stops (e.g.\& the bird lands) it is
|
|
7825 likely to look horrible for a short period of time, until the encoder
|
|
7826 figures out that the object is not moving and needs refined blocks.
|
|
7827 The saved bits will be spent on other parts of the video, which may increase
|
|
7828 subjective quality, provided that tcplx_mask is carefully chosen.
|
|
7829 .
|
|
7830 .TP
|
|
7831 .B scplx_mask=<0.0\-1.0>
|
|
7832 Spatial complexity masking.
|
|
7833 Larger values help against blockiness, if no deblocking filter is used for
|
|
7834 decoding, which is maybe not a good idea.
|
|
7835 .br
|
|
7836 Imagine a scene with grass (which usually has great spatial complexity),
|
|
7837 a blue sky and a house; scplx_mask will raise the quantizers of the grass'
|
|
7838 macroblocks, thus decreasing its quality, in order to spend more bits on
|
|
7839 the sky and the house.
|
|
7840 .br
|
|
7841 .I HINT:
|
|
7842 Crop any black borders completely as they will reduce the quality
|
|
7843 of the macroblocks (also applies without scplx_mask).
|
|
7844 .PD 0
|
|
7845 .RSs
|
|
7846 .IPs "0.0\ \ "
|
|
7847 disabled (default)
|
|
7848 .IPs 0.0\-0.5
|
|
7849 sane range
|
|
7850 .RE
|
|
7851 .PD 1
|
|
7852 .sp 1
|
|
7853 .RS
|
|
7854 .I NOTE:
|
|
7855 This setting does not have the same effect as using a custom matrix that
|
|
7856 would compress high frequencies harder, as scplx_mask will reduce the
|
|
7857 quality of P blocks even if only DC is changing.
|
|
7858 The result of scplx_mask will probably not look as good.
|
|
7859 .RE
|
|
7860 .
|
|
7861 .TP
|
|
7862 .B p_mask=<0.0\-1.0> (also see vi_qfactor)
|
|
7863 Reduces the quality of inter blocks.
|
|
7864 This is equivalent to increasing the quality of intra blocks, because the
|
|
7865 same average bitrate will be distributed by the rate controller to the
|
|
7866 whole video sequence (default: 0.0 (disabled)).
|
|
7867 p_mask=1.0 doubles the bits allocated to each intra block.
|
|
7868 .
|
|
7869 .TP
|
|
7870 .B border_mask=<0.0\-1.0>
|
|
7871 border-processing for MPEG-style encoders.
|
|
7872 Border processing increases the quantizer for macroblocks which are less
|
|
7873 than 1/5th of the frame width/height away from the frame border,
|
|
7874 since they are often visually less important.
|
|
7875 .
|
|
7876 .TP
|
|
7877 .B "naq\ \ \ \ "
|
|
7878 Normalize adaptive quantization (experimental).
|
|
7879 When using adaptive quantization (*_mask), the average per-MB quantizer may no
|
|
7880 longer match the requested frame-level quantizer.
|
|
7881 Naq will attempt to adjust the per-MB quantizers to maintain the proper
|
|
7882 average.
|
|
7883 .
|
|
7884 .TP
|
|
7885 .B "ildct\ \ "
|
|
7886 Use interlaced DCT.
|
|
7887 .
|
|
7888 .TP
|
|
7889 .B "ilme\ \ \ "
|
|
7890 Use interlaced motion estimation (mutually exclusive with qpel).
|
|
7891 .
|
|
7892 .TP
|
|
7893 .B "alt\ \ \ \ "
|
|
7894 Use alternative scantable.
|
|
7895 .
|
|
7896 .TP
|
|
7897 .B "top=<-1\-1>\ \ \ "
|
|
7898 .PD 0
|
|
7899 .RSs
|
|
7900 .IPs -1
|
|
7901 automatic
|
|
7902 .IPs 0
|
|
7903 bottom field first
|
|
7904 .IPs 1
|
|
7905 top field first
|
|
7906 .RE
|
|
7907 .PD 1
|
|
7908 .
|
|
7909 .TP
|
|
7910 .B format=<value>
|
|
7911 .PD 0
|
|
7912 .RSs
|
|
7913 .IPs "YV12\ "
|
|
7914 default
|
|
7915 .IPs "444P\ "
|
|
7916 for ffv1
|
|
7917 .IPs "422P\ "
|
|
7918 for HuffYUV, lossless JPEG and ffv1
|
|
7919 .IPs 411P,YVU9
|
|
7920 for lossless JPEG and ffv1
|
|
7921 .IPs BGR32
|
|
7922 for lossless JPEG and ffv1
|
|
7923 .RE
|
|
7924 .PD 1
|
|
7925 .
|
|
7926 .TP
|
|
7927 .B "pred\ \ \ "
|
|
7928 (for HuffYUV)
|
|
7929 .PD 0
|
|
7930 .RSs
|
|
7931 .IPs 0
|
|
7932 left prediction
|
|
7933 .IPs 1
|
|
7934 plane/\:gradient prediction
|
|
7935 .IPs 2
|
|
7936 median prediction
|
|
7937 .RE
|
|
7938 .PD 1
|
|
7939 .
|
|
7940 .TP
|
|
7941 .B "pred\ \ \ "
|
|
7942 (for lossless JPEG)
|
|
7943 .PD 0
|
|
7944 .RSs
|
|
7945 .IPs 0
|
|
7946 left prediction
|
|
7947 .IPs 1
|
|
7948 top prediction
|
|
7949 .IPs 2
|
|
7950 topleft prediction
|
|
7951 .IPs 3
|
|
7952 plane/\:gradient prediction
|
|
7953 .IPs 6
|
|
7954 mean prediction
|
|
7955 .RE
|
|
7956 .PD 1
|
|
7957 .
|
|
7958 .TP
|
|
7959 .B "coder\ \ "
|
|
7960 (for ffv1)
|
|
7961 .PD 0
|
|
7962 .RSs
|
|
7963 .IPs 0
|
|
7964 vlc coding (Golomb-Rice)
|
|
7965 .IPs 1
|
|
7966 arithmetic coding (CABAC)
|
|
7967 .RE
|
|
7968 .PD 1
|
|
7969 .
|
|
7970 .TP
|
|
7971 .B context
|
|
7972 (for ffv1)
|
|
7973 .PD 0
|
|
7974 .RSs
|
|
7975 .IPs 0
|
|
7976 small context model
|
|
7977 .IPs 1
|
|
7978 large context model
|
|
7979 .RE
|
|
7980 .PD 1
|
|
7981 .sp 1
|
|
7982 .RS
|
|
7983 (for ffvhuff)
|
|
7984 .RE
|
|
7985 .PD 0
|
|
7986 .RSs
|
|
7987 .IPs 0
|
|
7988 predetermined Huffman tables (builtin or two pass)
|
|
7989 .IPs 1
|
|
7990 adaptive Huffman tables
|
|
7991 .RE
|
|
7992 .PD 1
|
|
7993 .
|
|
7994 .TP
|
|
7995 .B "qpel\ \ \ "
|
|
7996 Use quarter pel motion compensation (mutually exclusive with ilme).
|
|
7997 .br
|
|
7998 .I HINT:
|
|
7999 This seems only useful for high bitrate encodings.
|
|
8000 .
|
|
8001 .TP
|
|
8002 .B mbcmp=<0\-2000>
|
|
8003 Sets the comparison function for the macroblock decision, only used if mbd=0.
|
|
8004 .PD 0
|
|
8005 .RSs
|
|
8006 .IPs "0 (SAD)"
|
|
8007 sum of absolute differences, fast (default)
|
|
8008 .IPs "1 (SSE)"
|
|
8009 sum of squared errors
|
|
8010 .IPs "2 (SATD)"
|
|
8011 sum of absolute Hadamard transformed differences
|
|
8012 .IPs "3 (DCT)"
|
|
8013 sum of absolute DCT transformed differences
|
|
8014 .IPs "4 (PSNR)"
|
|
8015 sum of squared quantization errors (avoid, low quality)
|
|
8016 .IPs "5 (BIT)"
|
|
8017 number of bits needed for the block
|
|
8018 .IPs "6 (RD)"
|
|
8019 rate distortion optimal, slow
|
|
8020 .IPs "7 (ZERO)"
|
|
8021 0
|
|
8022 .IPs "8 (VSAD)"
|
|
8023 sum of absolute vertical differences
|
|
8024 .IPs "9 (VSSE)"
|
|
8025 sum of squared vertical differences
|
|
8026 .IPs "10 (NSSE)"
|
|
8027 noise preserving sum of squared differences
|
|
8028 .IPs "11 (W53)"
|
|
8029 5/3 wavelet, only used in snow
|
|
8030 .IPs "12 (W97)"
|
|
8031 9/7 wavelet, only used in snow
|
|
8032 .IPs "+256\ "
|
|
8033 Also use chroma, currently does not work (correctly) with B-frames.
|
|
8034 .RE
|
|
8035 .PD 1
|
|
8036 .
|
|
8037 .TP
|
|
8038 .B ildctcmp=<0\-2000>
|
|
8039 Sets the comparison function for interlaced DCT decision
|
|
8040 (see mbcmp for available comparison functions).
|
|
8041 .
|
|
8042 .TP
|
|
8043 .B precmp=<0\-2000>
|
|
8044 Sets the comparison function for motion estimation pre pass
|
|
8045 (see mbcmp for available comparison functions) (default: 0).
|
|
8046 .
|
|
8047 .TP
|
|
8048 .B cmp=<0\-2000>
|
|
8049 Sets the comparison function for full pel motion estimation
|
|
8050 (see mbcmp for available comparison functions) (default: 0).
|
|
8051 .
|
|
8052 .TP
|
|
8053 .B subcmp=<0\-2000>
|
|
8054 Sets the comparison function for sub pel motion estimation
|
|
8055 (see mbcmp for available comparison functions) (default: 0).
|
|
8056 .
|
|
8057 .TP
|
|
8058 .B nssew=<0\-1000000>
|
|
8059 This setting controls NSSE weight, where larger weights will result in
|
|
8060 more noise.
|
|
8061 0 NSSE is identical to SSE
|
|
8062 You may find this useful if you prefer to keep some noise in your encoded
|
|
8063 video rather than filtering it away before encoding (default: 8).
|
|
8064 .
|
|
8065 .TP
|
|
8066 .B predia=<-99\-6>
|
|
8067 diamond type and size for motion estimation pre-pass
|
|
8068 .
|
|
8069 .TP
|
|
8070 .B dia=<-99\-6>
|
|
8071 Diamond type & size for motion estimation.
|
|
8072 Motion search is an iterative process.
|
|
8073 Using a small diamond does not limit the search to finding only small
|
|
8074 motion vectors.
|
|
8075 It is just somewhat more likely to stop before finding the very best motion
|
|
8076 vector, especially when noise is involved.
|
|
8077 Bigger diamonds allow a wider search for the best motion vector, thus are
|
|
8078 slower but result in better quality.
|
|
8079 .br
|
|
8080 Big normal diamonds are better quality than shape-adaptive diamonds.
|
|
8081 .br
|
|
8082 Shape-adaptive diamonds are a good tradeoff between speed and quality.
|
|
8083 .br
|
|
8084 .I NOTE:
|
|
8085 The sizes of the normal diamonds and shape adaptive ones do not have
|
|
8086 the same meaning.
|
|
8087 .RSs
|
|
8088 .IPs -3
|
|
8089 shape adaptive (fast) diamond with size 3
|
|
8090 .IPs -2
|
|
8091 shape adaptive (fast) diamond with size 2
|
|
8092 .IPs -1
|
|
8093 slightly special: Can be slower and/or better than dia=-2.
|
|
8094 .IPs 1
|
|
8095 normal size=1 diamond (default) =EPZS type diamond
|
|
8096 .nf
|
|
8097 .ne
|
|
8098 0
|
|
8099 000
|
|
8100 0
|
|
8101 .fi
|
|
8102 .IPs 2
|
|
8103 normal size=2 diamond
|
|
8104 .nf
|
|
8105 .ne
|
|
8106 0
|
|
8107 000
|
|
8108 00000
|
|
8109 000
|
|
8110 0
|
|
8111 .fi
|
|
8112 .RE
|
|
8113 .
|
|
8114 .TP
|
|
8115 .B "trell\ \ "
|
|
8116 Trellis searched quantization.
|
|
8117 This will find the optimal encoding for each 8x8 block.
|
|
8118 Trellis searched quantization is quite simply an optimal quantization in
|
|
8119 the PSNR versus bitrate sense (Assuming that there would be no rounding
|
|
8120 errors introduced by the IDCT, which is obviously not the case.).
|
|
8121 It simply finds a block for the minimum of error and lambda*bits.
|
|
8122 .PD 0
|
|
8123 .RSs
|
|
8124 .IPs lambda
|
|
8125 quantization parameter (QP) dependent constant
|
|
8126 .IPs "bits\ "
|
|
8127 amount of bits needed to encode the block
|
|
8128 .IPs error
|
|
8129 sum of squared errors of the quantization
|
|
8130 .RE
|
|
8131 .PD 1
|
|
8132 .
|
|
8133 .TP
|
|
8134 .B "cbp\ \ \ \ "
|
|
8135 Rate distorted optimal coded block pattern.
|
|
8136 Will select the coded block pattern which minimizes distortion + lambda*rate.
|
|
8137 This can only be used together with trellis quantization.
|
|
8138 .
|
|
8139 .TP
|
|
8140 .B "mv0\ \ \ \ "
|
|
8141 Try to encode each MB with MV=<0,0> and choose the better one.
|
|
8142 This has no effect if mbd=0.
|
|
8143 .
|
|
8144 .TP
|
|
8145 .B mv0_threshold=<any non-negative integer>
|
|
8146 When surrounding motion vectors are <0,0> and the motion estimation
|
|
8147 score of the current block is less than mv0_threshold, <0,0> is used for
|
|
8148 the motion vector and further motion estimation is skipped (default:
|
|
8149 256).
|
|
8150 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and
|
|
8151 possibly make the encoded video look slightly better; raising
|
|
8152 mv0_threshold past 320 results in diminished PSNR and visual quality.
|
|
8153 Higher values speed up encoding very slightly (usually less than 1%,
|
|
8154 depending on the other options used).
|
|
8155 .br
|
|
8156 .I NOTE:
|
|
8157 This option does not require mv0 to be enabled.
|
|
8158 .
|
|
8159 .TP
|
|
8160 .B qprd (mbd=2 only)
|
|
8161 rate distorted optimal quantization parameter (QP) for the given
|
|
8162 lambda of each macroblock
|
|
8163 .
|
|
8164 .TP
|
|
8165 .B last_pred=<0\-99>
|
|
8166 amount of motion predictors from the previous frame
|
|
8167 .PD 0
|
|
8168 .RSs
|
|
8169 .IPs 0
|
|
8170 (default)
|
|
8171 .IPs a
|
|
8172 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the
|
|
8173 previous frame.
|
|
8174 .RE
|
|
8175 .PD 1
|
|
8176 .
|
|
8177 .TP
|
|
8178 .B preme=<0\-2>
|
|
8179 motion estimation pre-pass
|
|
8180 .PD 0
|
|
8181 .RSs
|
|
8182 .IPs 0
|
|
8183 disabled
|
|
8184 .IPs 1
|
|
8185 only after I-frames (default)
|
|
8186 .IPs 2
|
|
8187 always
|
|
8188 .RE
|
|
8189 .PD 1
|
|
8190 .
|
|
8191 .TP
|
|
8192 .B subq=<1\-8>
|
|
8193 subpel refinement quality (for qpel) (default: 8 (high quality))
|
|
8194 .br
|
|
8195 .I NOTE:
|
|
8196 This has a significant effect on speed.
|
|
8197 .
|
|
8198 .TP
|
|
8199 .B refs=<1\-8>
|
|
8200 number of reference frames to consider for motion compensation
|
|
8201 (Snow only) (default: 1)
|
|
8202 .
|
|
8203 .TP
|
|
8204 .B "psnr\ \ \ "
|
|
8205 print the PSNR (peak signal to noise ratio) for the whole video after encoding
|
|
8206 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'.
|
|
8207 Returned values are in dB (decibel), the higher the better.
|
|
8208 .
|
|
8209 .TP
|
|
8210 .B mpeg_quant
|
|
8211 Use MPEG quantizers instead of H.263.
|
|
8212 .
|
|
8213 .TP
|
|
8214 .B "aic\ \ \ \ "
|
|
8215 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+.
|
|
8216 This will improve quality very slightly (around 0.02 dB PSNR) and slow
|
|
8217 down encoding very slightly (about 1%).
|
|
8218 .br
|
|
8219 .I NOTE:
|
|
8220 vqmin should be 8 or larger for H.263+ AIC.
|
|
8221 .
|
|
8222 .TP
|
|
8223 .B "aiv\ \ \ \ "
|
|
8224 alternative inter vlc for H.263+
|
|
8225 .
|
|
8226 .TP
|
|
8227 .B "umv\ \ \ \ "
|
|
8228 unlimited MVs (H.263+ only)
|
|
8229 Allows encoding of arbitrarily long MVs.
|
|
8230 .
|
|
8231 .TP
|
|
8232 .B ibias=<-256\-256>
|
|
8233 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96,
|
|
8234 H.263 style quantizer default: 0)
|
|
8235 .br
|
|
8236 .I NOTE:
|
|
8237 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
|
|
8238 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
|
|
8239 .
|
|
8240 .TP
|
|
8241 .B pbias=<-256\-256>
|
|
8242 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0,
|
|
8243 H.263 style quantizer default: -64)
|
|
8244 .br
|
|
8245 .I NOTE:
|
|
8246 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
|
|
8247 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
|
|
8248 .br
|
|
8249 .I HINT:
|
|
8250 A more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR.
|
|
8251 .
|
|
8252 .TP
|
|
8253 .B nr=<0\-100000>
|
|
8254 Noise reduction, 0 means disabled.
|
|
8255 0\-600 is a useful range for typical content, but you may want to turn it
|
|
8256 up a bit more for very noisy content (default: 0).
|
|
8257 Given its small impact on speed, you might want to prefer to use this over
|
|
8258 filtering noise away with video filters like denoise3d or hqdn3d.
|
|
8259 .
|
|
8260 .TP
|
|
8261 .B qns=<0\-3>
|
|
8262 Quantizer noise shaping.
|
|
8263 Rather than choosing quantization to most closely match the source video
|
|
8264 in the PSNR sense, it chooses quantization such that noise (usually ringing)
|
|
8265 will be masked by similar-frequency content in the image.
|
|
8266 Larger values are slower but may not result in better quality.
|
|
8267 This can and should be used together with trellis quantization, in which case
|
|
8268 the trellis quantization (optimal for constant weight) will be used as
|
|
8269 startpoint for the iterative search.
|
|
8270 .PD 0
|
|
8271 .RSs
|
|
8272 .IPs 0
|
|
8273 disabled (default)
|
|
8274 .IPs 1
|
|
8275 Only lower the absolute value of coefficients.
|
|
8276 .IPs 2
|
|
8277 Only change coefficients before the last non-zero coefficient + 1.
|
|
8278 .IPs 3
|
|
8279 Try all.
|
|
8280 .RE
|
|
8281 .PD 1
|
|
8282 .
|
|
8283 .TP
|
|
8284 .B inter_matrix=<comma separated matrix>
|
|
8285 Use custom inter matrix.
|
|
8286 It needs a comma separated string of 64 integers.
|
|
8287 .
|
|
8288 .TP
|
|
8289 .B intra_matrix=<comma separated matrix>
|
|
8290 Use custom intra matrix.
|
|
8291 It needs a comma separated string of 64 integers.
|
|
8292 .
|
|
8293 .TP
|
|
8294 .B vqmod_amp
|
|
8295 experimental quantizer modulation
|
|
8296 .
|
|
8297 .TP
|
|
8298 .B vqmod_freq
|
|
8299 experimental quantizer modulation
|
|
8300 .
|
|
8301 .TP
|
|
8302 .B "dc\ \ \ \ \ "
|
|
8303 intra DC precision in bits (default: 8).
|
|
8304 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
|
|
8305 .
|
|
8306 .TP
|
|
8307 .B cgop (also see sc_threshold)
|
|
8308 Close all GOPs.
|
|
8309 Currently it only works if scene change detection is disabled
|
|
8310 (sc_threshold=1000000000).
|
|
8311 .
|
|
8312 .TP
|
|
8313 .B vglobal=<0\-3>
|
|
8314 Control writing global video headers.
|
|
8315 .PD 0
|
|
8316 .RSs
|
|
8317 .IPs 0
|
|
8318 Codec decides where to write global headers (default).
|
|
8319 .IPs 1
|
|
8320 Write global headers only in extradata (needed for .mp4/MOV/NUT).
|
|
8321 .IPs 2
|
|
8322 Write global headers only in front of keyframes.
|
|
8323 .IPs 3
|
|
8324 Combine 1 and 2.
|
|
8325 .RE
|
|
8326 .PD 1
|
|
8327 .
|
|
8328 .TP
|
|
8329 .B aglobal=<0\-3>
|
|
8330 Same as vglobal for audio headers.
|
|
8331 .
|
|
8332 .
|
|
8333 .SS nuv (\-nuvopts)
|
|
8334 .
|
|
8335 Nuppel video is based on RTJPEG and LZO.
|
|
8336 By default frames are first encoded with RTJPEG and then compressed with LZO,
|
|
8337 but it is possible to disable either or both of the two passes.
|
|
8338 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG,
|
|
8339 or the default LZO compressed RTJPEG.
|
|
8340 .br
|
|
8341 .I NOTE:
|
|
8342 The nuvrec documentation contains some advice and examples about the
|
|
8343 settings to use for the most common TV encodings.
|
|
8344 .
|
|
8345 .TP
|
|
8346 .B c=<0\-20>
|
|
8347 chrominance threshold (default: 1)
|
|
8348 .
|
|
8349 .TP
|
|
8350 .B l=<0\-20>
|
|
8351 luminance threshold (default: 1)
|
|
8352 .
|
|
8353 .TP
|
|
8354 .B "lzo\ \ \ \ "
|
|
8355 Enable LZO compression (default).
|
|
8356 .
|
|
8357 .TP
|
|
8358 .B "nolzo\ \ "
|
|
8359 Disable LZO compression.
|
|
8360 .
|
|
8361 .TP
|
|
8362 .B q=<3\-255>
|
|
8363 quality level (default: 255)
|
|
8364 .
|
|
8365 .TP
|
|
8366 .B "raw \ \ \ "
|
|
8367 Disable RTJPEG encoding.
|
|
8368 .
|
|
8369 .TP
|
|
8370 .B "rtjpeg\ "
|
|
8371 Enable RTJPEG encoding (default).
|
|
8372 .
|
|
8373 .
|
|
8374 .SS xvidenc (\-xvidencopts)
|
|
8375 .
|
|
8376 There are three modes available: constant bitrate (CBR), fixed quantizer and
|
|
8377 two pass.
|
|
8378 .
|
|
8379 .TP
|
|
8380 .B pass=<1|2>
|
|
8381 Specify the pass in two pass mode.
|
|
8382 .
|
|
8383 .TP
|
|
8384 .B turbo (two pass only)
|
|
8385 Dramatically speeds up pass one using faster algorithms and disabling
|
|
8386 CPU-intensive options.
|
|
8387 This will probably reduce global PSNR a little bit and change individual
|
|
8388 frame type and PSNR a little bit more.
|
|
8389 .
|
|
8390 .TP
|
|
8391 .B bitrate=<value> (CBR or two pass mode)
|
|
8392 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
|
|
8393 if >16000.
|
|
8394 If <value> is negative, XviD will use its absolute value as the target size
|
|
8395 (in kBytes) of the video and compute the associated bitrate automagically
|
|
8396 (default: 687 kbits/s).
|
|
8397 .
|
|
8398 .TP
|
|
8399 .B fixed_quant=<1\-31>
|
|
8400 Switch to fixed quantizer mode and specify the quantizer to be used.
|
|
8401 .
|
|
8402 .TP
|
|
8403 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode)
|
|
8404 User specified quality for specific parts (ending, credits, ...).
|
|
8405 Each zone is <start-frame>,<mode>,<value> where <mode> may be
|
|
8406 .PD 0
|
|
8407 .RSs
|
|
8408 .IPs "q"
|
|
8409 Constant quantizer override, where value=<2.0\-31.0>
|
|
8410 represents the quantizer value.
|
|
8411 .IPs "w"
|
|
8412 Ratecontrol weight override, where value=<0.01\-2.00>
|
|
8413 represents the quality correction in %.
|
|
8414 .RE
|
|
8415 .PD 1
|
|
8416 .sp 1
|
|
8417 .RS
|
|
8418 .I EXAMPLE:
|
|
8419 .RE
|
|
8420 .PD 0
|
|
8421 .RSs
|
|
8422 .IPs zones=90000,q,20
|
|
8423 Encodes all frames starting with frame 90000 at constant quantizer 20.
|
|
8424 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20
|
|
8425 Encode frames 0\-10000 at 10% bitrate, encode frames 90000
|
|
8426 up to the end at constant quantizer 20.
|
|
8427 Note that the second zone is needed to delimit the first zone, as
|
|
8428 without it everything up until frame 89999 would be encoded at 10%
|
|
8429 bitrate.
|
|
8430 .RE
|
|
8431 .PD 1
|
|
8432 .
|
|
8433 .TP
|
|
8434 .B me_quality=<0\-6>
|
|
8435 This option controls the motion estimation subsystem.
|
|
8436 The higher the value, the more precise the estimation should be (default: 6).
|
|
8437 The more precise the motion estimation is, the more bits can be saved.
|
|
8438 Precision is gained at the expense of CPU time so decrease this setting if
|
|
8439 you need realtime encoding.
|
|
8440 .
|
|
8441 .TP
|
|
8442 .B (no)interlacing
|
|
8443 Encode the fields of interlaced video material.
|
|
8444 Turn this option on for interlaced content.
|
|
8445 .br
|
|
8446 .I NOTE:
|
|
8447 Should you rescale the video, you would need an interlace-aware resizer,
|
|
8448 which you can activate with \-vf scale=<width>:<height>:1.
|
|
8449 .
|
|
8450 .TP
|
|
8451 .B "4mv\ \ \ \ "
|
|
8452 Use 4 motion vectors per macroblock.
|
|
8453 This might give better compression, but slows down encoding.
|
|
8454 .br
|
|
8455 .I WARNING:
|
|
8456 As of XviD-1.0.x, this option is no longer available separately, and its
|
|
8457 functionality is included in the me_quality option.
|
|
8458 When me_quality > 4, 4mv is activated.
|
|
8459 .
|
|
8460 .TP
|
|
8461 .B rc_reaction_delay_factor=<value>
|
|
8462 This parameter controls the number of frames the CBR rate controller
|
|
8463 will wait before reacting to bitrate changes and compensating for them
|
|
8464 to obtain a constant bitrate over an averaging range of frames.
|
|
8465 .
|
|
8466 .TP
|
|
8467 .B rc_averaging_period=<value>
|
|
8468 Real CBR is hard to achieve.
|
|
8469 Depending on the video material, bitrate can be variable, and hard to predict.
|
|
8470 Therefore XviD uses an averaging period for which it guarantees a given
|
|
8471 amount of bits (minus a small variation).
|
|
8472 This settings expresses the "number of frames" for which XviD averages
|
|
8473 bitrate and tries to achieve CBR.
|
|
8474 .
|
|
8475 .TP
|
|
8476 .B rc_buffer=<value>
|
|
8477 size of the rate control buffer
|
|
8478 .
|
|
8479 .TP
|
|
8480 .B quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>]
|
|
8481 CBR mode: min & max quantizer for all frames (default: 2\-31)
|
|
8482 .br
|
|
8483 two pass mode: min & max quantizer for I/P-frames (default: 2\-31/\:2\-31)
|
|
8484 .br
|
|
8485 .I WARNING:
|
|
8486 As of XviD-1.0.x, this option is replaced by the
|
|
8487 [min|max]_[i|p|b]quant options.
|
|
8488 .
|
|
8489 .TP
|
|
8490 .B min_key_interval=<value> (two pass only)
|
|
8491 minimum interval between keyframes (default: 0)
|
|
8492 .
|
|
8493 .TP
|
|
8494 .B max_key_interval=<value>
|
|
8495 maximum interval between keyframes (default: 10*fps)
|
|
8496 .
|
|
8497 .TP
|
|
8498 .B mpeg_quant
|
|
8499 Use MPEG quantizers instead of H.263.
|
|
8500 For high bitrates, you will find that MPEG quantization preserves more detail.
|
|
8501 For low bitrates, the smoothing of H.263 will give you less block noise.
|
|
8502 When using custom matrices, MPEG must be used.
|
|
8503 .br
|
|
8504 .I WARNING:
|
|
8505 As of XviD-1.0.x, this option is replaced by the quant_type option.
|
|
8506 .
|
|
8507 .TP
|
|
8508 .B mod_quant
|
|
8509 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis
|
|
8510 (two pass mode only).
|
|
8511 .br
|
|
8512 .I WARNING:
|
|
8513 This will generate an illegal bitstream, and most likely not be decodable
|
|
8514 by any MPEG-4 decoder besides libavcodec or XviD.
|
|
8515 .br
|
|
8516 .I WARNING:
|
|
8517 As of XviD-1.0.x, this option is no longer available.
|
|
8518 .
|
|
8519 .TP
|
|
8520 .B keyframe_boost=<0\-1000> (two pass mode only)
|
|
8521 Shift some bits from the pool for other frame types to intra frames,
|
|
8522 thus improving keyframe quality.
|
|
8523 This amount is an extra percentage, so a value of 10 will give
|
|
8524 your keyframes 10% more bits than normal
|
|
8525 (default: 0).
|
|
8526 .
|
|
8527 .TP
|
|
8528 .B kfthreshold=<value> (two pass mode only)
|
|
8529 Works together with kfreduction.
|
|
8530 Determines the minimum distance below which you consider that
|
|
8531 two frames are considered consecutive and treated differently
|
|
8532 according to kfreduction
|
|
8533 (default: 10).
|
|
8534 .
|
|
8535 .TP
|
|
8536 .B kfreduction=<0\-100> (two pass mode only)
|
|
8537 The above two settings can be used to adjust the size of keyframes that
|
|
8538 you consider too close to the first (in a row).
|
|
8539 kfthreshold sets the range in which keyframes are reduced, and
|
|
8540 kfreduction determines the bitrate reduction they get.
|
|
8541 The last I-frame will get treated normally
|
|
8542 (default: 30).
|
|
8543 .
|
|
8544 .TP
|
|
8545 .B divx5bvop
|
|
8546 Generate DivX5 compatible B-frames (default: on).
|
|
8547 This seems to be mandatory only for old versions of DivX's decoder.
|
|
8548 .br
|
|
8549 .I WARNING:
|
|
8550 As of XviD-1.0.x, this option is replaced by the closed_gop option.
|
|
8551 .
|
|
8552 .TP
|
|
8553 .B (no)grayscale
|
|
8554 Make XviD discard chroma planes so the encoded video is grayscale only.
|
|
8555 Note that this does not speed up encoding, it just prevents chroma data
|
|
8556 from being written in the last stage of encoding.
|
|
8557 .
|
|
8558 .TP
|
|
8559 .B "debug\ \ "
|
|
8560 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control
|
|
8561 file.)
|
|
8562 .RE
|
|
8563 .
|
|
8564 .PP
|
|
8565 .sp 1
|
|
8566 The following options are only available with the latest stable
|
|
8567 releases of XviD 1.0.x (api4).
|
|
8568 .
|
|
8569 .TP
|
|
8570 .B (no)packed
|
|
8571 This option is meant to solve frame-order issues when encoding to
|
|
8572 container formats like AVI that cannot cope with out-of-order frames.
|
|
8573 In practice, most decoders (both software and hardware) are able to deal
|
|
8574 with frame-order themselves, and may get confused when this option is
|
|
8575 turned on, so you can safely leave if off, unless you really know what
|
|
8576 you are doing.
|
|
8577 .br
|
|
8578 .I WARNING:
|
|
8579 This will generate an illegal bitstream, and will not be
|
|
8580 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:XviD.
|
|
8581 .br
|
|
8582 .I WARNING:
|
|
8583 This will also store a fake DivX version in the file so the bug
|
|
8584 autodetection of some decoders might be confused.
|
|
8585 .
|
|
8586 .TP
|
|
8587 .B max_bframes=<0\-4>
|
|
8588 Maximum number of B-frames to put between I/P-frames (default: 2).
|
|
8589 .
|
|
8590 .TP
|
|
8591 .B bquant_ratio=<0\-1000>
|
|
8592 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150)
|
|
8593 .
|
|
8594 .TP
|
|
8595 .B bquant_offset=<-1000\-1000>
|
|
8596 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100)
|
|
8597 .
|
|
8598 .TP
|
|
8599 .B bf_threshold=<-255\-255>
|
|
8600 This setting allows you to specify what priority to place on the use of
|
|
8601 B-frames.
|
|
8602 The higher the value, the higher the probability of B-frames being used
|
|
8603 (default: 0).
|
|
8604 Do not forget that B-frames usually have a higher quantizer, and therefore
|
|
8605 aggressive production of B-frames may cause worse visual quality.
|
|
8606 .
|
|
8607 .TP
|
|
8608 .B (no)closed_gop
|
|
8609 This option tells XviD to close every GOP (Group Of Pictures bounded
|
|
8610 by two I-frames), which makes GOPs independent from each other.
|
|
8611 This just implies that the last frame of the GOP is either a P-frame or a
|
|
8612 N-frame but not a B-frame.
|
|
8613 It is usually a good idea to turn this option on (default: on).
|
|
8614 .
|
|
8615 .TP
|
|
8616 .B frame_drop_ratio=<0\-100> (max_bframes=0 only)
|
|
8617 This setting allows the creation of variable framerate video streams.
|
|
8618 The value of the setting specifies a threshold under which, if the
|
|
8619 difference of the following frame to the previous frame is below or equal
|
|
8620 to this threshold, a frame gets not coded (a so called n-vop is placed
|
|
8621 in the stream).
|
|
8622 On playback, when reaching an n-vop the previous frame will be displayed.
|
|
8623 .br
|
|
8624 .I WARNING:
|
|
8625 Playing with this setting may result in a jerky video, so use it at your
|
|
8626 own risks!
|
|
8627 .
|
|
8628 .TP
|
|
8629 .B (no)qpel
|
|
8630 MPEG-4 uses a half pixel precision for its motion search by default.
|
|
8631 The standard proposes a mode where encoders are allowed to use quarter
|
|
8632 pixel precision.
|
|
8633 This option usually results in a sharper image.
|
|
8634 Unfortunately it has a great impact on bitrate and sometimes the
|
|
8635 higher bitrate use will prevent it from giving a better image
|
|
8636 quality at a fixed bitrate.
|
|
8637 It is better to test with and without this option and see whether it
|
|
8638 is worth activating.
|
|
8639 .
|
|
8640 .TP
|
|
8641 .B (no)gmc
|
|
8642 Enable Global Motion Compensation, which makes XviD generate special
|
|
8643 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images.
|
|
8644 Whether or not the use of this option will save bits is highly
|
|
8645 dependent on the source material.
|
|
8646 .
|
|
8647 .TP
|
|
8648 .B (no)trellis
|
|
8649 Trellis Quantization is a kind of adaptive quantization method that
|
|
8650 saves bits by modifying quantized coefficients to make them more
|
|
8651 compressible by the entropy encoder.
|
|
8652 Its impact on quality is good, and if VHQ uses too much CPU for you,
|
|
8653 this setting can be a good alternative to save a few bits (and gain
|
|
8654 quality at fixed bitrate) at a lesser cost than with VHQ (default: on).
|
|
8655 .
|
|
8656 .TP
|
|
8657 .B (no)cartoon
|
|
8658 Activate this if your encoded sequence is an anime/\:cartoon.
|
|
8659 It modifies some XviD internal thresholds so XviD takes better decisions on
|
|
8660 frame types and motion vectors for flat looking cartoons.
|
|
8661 .
|
|
8662 .TP
|
|
8663 .B quant_type=<h263|mpeg>
|
|
8664 Sets the type of quantizer to use.
|
|
8665 For high bitrates, you will find that MPEG quantization preserves more detail.
|
|
8666 For low bitrates, the smoothing of H.263 will give you less block noise.
|
|
8667 When using custom matrices, MPEG quantization
|
|
8668 .B must
|
|
8669 be used.
|
|
8670 .
|
|
8671 .TP
|
|
8672 .B (no)chroma_me
|
|
8673 The usual motion estimation algorithm uses only the luminance information to
|
|
8674 find the best motion vector.
|
|
8675 However for some video material, using the chroma planes can help find
|
|
8676 better vectors.
|
|
8677 This setting toggles the use of chroma planes for motion estimation
|
|
8678 (default: on).
|
|
8679 .
|
|
8680 .TP
|
|
8681 .B (no)chroma_opt
|
|
8682 Enable a chroma optimizer prefilter.
|
|
8683 It will do some extra magic on color information to minimize the
|
|
8684 stepped-stairs effect on edges.
|
|
8685 It will improve quality at the cost of encoding speed.
|
|
8686 It reduces PSNR by nature, as the mathematical deviation to the original
|
|
8687 picture will get bigger, but the subjective image quality will raise.
|
|
8688 Since it works with color information, you might want to turn it off when
|
|
8689 encoding in grayscale.
|
|
8690 .
|
|
8691 .TP
|
|
8692 .B (no)hq_ac
|
|
8693 Activates high-quality prediction of AC coefficients for intra frames from
|
|
8694 neighbor blocks (default: on).
|
|
8695 .
|
|
8696 .TP
|
|
8697 .B vhq=<0\-4>
|
|
8698 The motion search algorithm is based on a search in the usual color domain
|
|
8699 and tries to find a motion vector that minimizes the difference between the
|
|
8700 reference frame and the encoded frame.
|
|
8701 With this setting activated, XviD will also use the frequency domain (DCT)
|
|
8702 to search for a motion vector that minimizes not only the spatial
|
|
8703 difference but also the encoding length of the block.
|
|
8704 Fastest to slowest:
|
|
8705 .PD 0
|
|
8706 .RSs
|
|
8707 .IPs 0
|
|
8708 off
|
|
8709 .IPs 1
|
|
8710 mode decision (inter/\:intra MB) (default)
|
|
8711 .IPs 2
|
|
8712 limited search
|
|
8713 .IPs 3
|
|
8714 medium search
|
|
8715 .IPs 4
|
|
8716 wide search
|
|
8717 .RE
|
|
8718 .PD 1
|
|
8719 .
|
|
8720 .TP
|
|
8721 .B (no)lumi_mask
|
|
8722 Adaptive quantization allows the macroblock quantizers to vary inside
|
|
8723 each frame.
|
|
8724 This is a 'psychosensory' setting that is supposed to make use of the
|
|
8725 fact that the human eye tends to notice fewer details in very bright
|
|
8726 and very dark parts of the picture.
|
|
8727 It compresses those areas more strongly than medium ones, which will
|
|
8728 save bits that can be spent again on other frames, raising overall
|
|
8729 subjective quality and possibly reducing PSNR.
|
|
8730 .
|
|
8731 .TP
|
|
8732 .B min_iquant=<0\-31>
|
|
8733 minimum I-frame quantizer (default: 2)
|
|
8734 .
|
|
8735 .TP
|
|
8736 .B max_iquant=<0\-31>
|
|
8737 maximum I-frame quantizer (default: 31)
|
|
8738 .
|
|
8739 .TP
|
|
8740 .B min_pquant=<0\-31>
|
|
8741 minimum P-frame quantizer (default: 2)
|
|
8742 .
|
|
8743 .TP
|
|
8744 .B max_pquant=<0\-31>
|
|
8745 maximum P-frame quantizer (default: 31)
|
|
8746 .
|
|
8747 .TP
|
|
8748 .B min_bquant=<0\-31>
|
|
8749 minimum B-frame quantizer (default: 2)
|
|
8750 .
|
|
8751 .TP
|
|
8752 .B max_bquant=<0\-31>
|
|
8753 maximum B-frame quantizer (default: 31)
|
|
8754 .
|
|
8755 .TP
|
|
8756 .B quant_intra_matrix=<filename>
|
|
8757 Load a custom intra matrix file.
|
|
8758 You can build such a file with xvid4conf's matrix editor.
|
|
8759 .
|
|
8760 .TP
|
|
8761 .B quant_inter_matrix=<filename>
|
|
8762 Load a custom inter matrix file.
|
|
8763 You can build such a file with xvid4conf's matrix editor.
|
|
8764 .
|
|
8765 .TP
|
|
8766 .B curve_compression_high=<0\-100>
|
|
8767 This setting allows XviD to take a certain percentage of bits away from
|
|
8768 high bitrate scenes and give them back to the bit reservoir.
|
|
8769 You could also use this if you have a clip with so many bits allocated
|
|
8770 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad
|
|
8771 (default: 0).
|
|
8772 .
|
|
8773 .TP
|
|
8774 .B curve_compression_low=<0\-100>
|
|
8775 This setting allows XviD to give a certain percentage of extra bits to the
|
|
8776 low bitrate scenes, taking a few bits from the entire clip.
|
|
8777 This might come in handy if you have a few low-bitrate scenes that are
|
|
8778 still blocky (default: 0).
|
|
8779 .
|
|
8780 .TP
|
|
8781 .B overflow_control_strength=<0\-100>
|
|
8782 During pass one of two pass encoding, a scaled bitrate curve is computed.
|
|
8783 The difference between that expected curve and the result obtained during
|
|
8784 encoding is called overflow.
|
|
8785 Obviously, the two pass rate controller tries to compensate for that overflow,
|
|
8786 distributing it over the next frames.
|
|
8787 This setting controls how much of the overflow is distributed every time
|
|
8788 there is a new frame.
|
|
8789 Low values allow lazy overflow control, big rate bursts are compensated for
|
|
8790 more slowly (could lead to lack of precision for small clips).
|
|
8791 Higher values will make changes in bit redistribution more abrupt, possibly
|
|
8792 too abrupt if you set it too high, creating artifacts (default: 5).
|
|
8793 .br
|
|
8794 .I NOTE:
|
|
8795 This setting impacts quality a lot, play with it carefully!
|
|
8796 .
|
|
8797 .TP
|
|
8798 .B max_overflow_improvement=<0\-100>
|
|
8799 During the frame bit allocation, overflow control may increase the frame
|
|
8800 size.
|
|
8801 This parameter specifies the maximum percentage by which the overflow
|
|
8802 control is allowed to increase the frame size, compared to the ideal curve
|
|
8803 allocation
|
|
8804 (default: 5).
|
|
8805 .
|
|
8806 .TP
|
|
8807 .B max_overflow_degradation=<0\-100>
|
|
8808 During the frame bit allocation, overflow control may decrease the frame
|
|
8809 size.
|
|
8810 This parameter specifies the maximum percentage by which the overflow
|
|
8811 control is allowed to decrease the frame size, compared to the ideal curve
|
|
8812 allocation
|
|
8813 (default: 5).
|
|
8814 .
|
|
8815 .TP
|
|
8816 .B container_frame_overhead=<0...>
|
|
8817 Specifies a frame average overhead per frame, in bytes.
|
|
8818 Most of the time users express their target bitrate for video w/o taking
|
|
8819 care of the video container overhead.
|
|
8820 This small but (mostly) constant overhead can cause the target file size
|
|
8821 to be exceeded.
|
|
8822 XviD allows users to set the amount of overhead per frame the
|
|
8823 container generates (give only an average per frame).
|
|
8824 0 has a special meaning, it lets XviD use its own default values
|
|
8825 (default: 24 \- AVI average overhead).
|
|
8826 .
|
|
8827 .TP
|
|
8828 .B profile=<profile_name>
|
|
8829 Restricts options and VBV (peak bitrate over a short period) according to
|
|
8830 the Simple, Advanced Simple and DivX profiles.
|
|
8831 The resulting videos should be playable on standalone players adhering to these
|
|
8832 profile specifications.
|
|
8833 .PD 0
|
|
8834 .RSs
|
|
8835 .IPs unrestricted
|
|
8836 no restrictions (default)
|
|
8837 .IPs "sp0\ \ "
|
|
8838 simple profile at level 0
|
|
8839 .IPs "sp1\ \ "
|
|
8840 simple profile at level 1
|
|
8841 .IPs "sp2\ \ "
|
|
8842 simple profile at level 2
|
|
8843 .IPs "sp3\ \ "
|
|
8844 simple profile at level 3
|
|
8845 .IPs "asp0\ "
|
|
8846 advanced simple profile at level 0
|
|
8847 .IPs "asp1\ "
|
|
8848 advanced simple profile at level 1
|
|
8849 .IPs "asp2\ "
|
|
8850 advanced simple profile at level 2
|
|
8851 .IPs "asp3\ "
|
|
8852 advanced simple profile at level 3
|
|
8853 .IPs "asp4\ "
|
|
8854 advanced simple profile at level 4
|
|
8855 .IPs "asp5\ "
|
|
8856 advanced simple profile at level 5
|
|
8857 .IPs dxnhandheld
|
|
8858 DXN handheld profile
|
|
8859 .IPs dxnportntsc
|
|
8860 DXN portable NTSC profile
|
|
8861 .IPs dxnportpal
|
|
8862 DXN portable PAL profile
|
|
8863 .IPs dxnhtntsc
|
|
8864 DXN home theater NTSC profile
|
|
8865 .IPs dxnhtpal
|
|
8866 DXN home theater PAL profile
|
|
8867 .IPs dxnhdtv
|
|
8868 DXN HDTV profile
|
|
8869 .RE
|
|
8870 .PD 1
|
|
8871 .RS
|
|
8872 .I NOTE:
|
|
8873 These profiles should be used in conjunction with an appropriate \-ffourcc.
|
|
8874 Generally DX50 is applicable, as some players do not recognize XviD but
|
|
8875 most recognize DivX.
|
|
8876 .RE
|
|
8877 .
|
|
8878 .TP
|
|
8879 .B par=<mode>
|
|
8880 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR,
|
|
8881 the Display Aspect Ratio).
|
|
8882 PAR is the ratio of the width and height of a single pixel.
|
|
8883 So both are related like this: DAR = PAR * (width/height).
|
|
8884 .br
|
|
8885 MPEG-4 defines 5 pixel aspect ratios and one extended
|
|
8886 one, giving the opportunity to specify a specific pixel aspect
|
|
8887 ratio.
|
|
8888 5 standard modes can be specified:
|
|
8889 .PD 0
|
|
8890 .RSs
|
|
8891 .IPs vga11
|
|
8892 It is the usual PAR for PC content.
|
|
8893 Pixels are a square unit.
|
|
8894 .IPs pal43
|
|
8895 PAL standard 4:3 PAR.
|
|
8896 Pixels are rectangles.
|
|
8897 .IPs pal169
|
|
8898 same as above
|
|
8899 .IPs ntsc43
|
|
8900 same as above
|
|
8901 .IPs ntsc169
|
|
8902 same as above (Do not forget to give the exact ratio.)
|
|
8903 .IPs "ext\ \ "
|
|
8904 Allows you to specify your own pixel aspect ratio with par_width and
|
|
8905 par_height.
|
|
8906 .RE
|
|
8907 .PD 1
|
|
8908 .RS
|
|
8909 .I NOTE:
|
|
8910 In general, setting aspect and autoaspect options is enough.
|
|
8911 .RE
|
|
8912 .
|
|
8913 .TP
|
|
8914 .B par_width=<1\-255> (par=ext only)
|
|
8915 Specifies the width of the custom pixel aspect ratio.
|
|
8916 .
|
|
8917 .TP
|
|
8918 .B par_height=<1\-255> (par=ext only)
|
|
8919 Specifies the height of the custom pixel aspect ratio.
|
|
8920 .
|
|
8921 .TP
|
|
8922 .B aspect=<x/y | f (float value)>
|
|
8923 Store movie aspect internally, just like MPEG files.
|
|
8924 Much nicer solution than rescaling, because quality is not decreased.
|
|
8925 MPlayer and a few others players will play these files correctly, others
|
|
8926 will display them with the wrong aspect.
|
|
8927 The aspect parameter can be given as a ratio or a floating point number.
|
|
8928 .
|
|
8929 .TP
|
|
8930 .B (no)autoaspect
|
|
8931 Same as the aspect option, but automatically computes aspect, taking
|
|
8932 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
|
|
8933 filter chain.
|
|
8934 .
|
|
8935 .TP
|
|
8936 .B "psnr\ \ \ "
|
|
8937 Print the PSNR (peak signal to noise ratio) for the whole video after encoding
|
|
8938 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in
|
|
8939 the current directory.
|
|
8940 Returned values are in dB (decibel), the higher the better.
|
|
8941 .
|
|
8942 .PP
|
|
8943 .sp 1
|
|
8944 The following option is only available in XviD 1.1.x.
|
|
8945 .
|
|
8946 .TP
|
|
8947 .B bvhq=<0|1>
|
|
8948 This setting allows vector candidates for B-frames to be used for
|
|
8949 the encoding chosen using a rate distortion optimized operator,
|
|
8950 which is what is done for P-frames by the vhq option.
|
|
8951 This produces nicer-looking B-frames while incurring almost no
|
|
8952 performance penalty (default: 1).
|
|
8953 .
|
|
8954 .PP
|
|
8955 .sp 1
|
|
8956 The following option is only available in the CVS version of XviD.
|
|
8957 .
|
|
8958 .TP
|
|
8959 .B threads=<0\-n>
|
|
8960 Create n threads to run the motion estimation (default: 0).
|
|
8961 The maximum number of threads that can be used is the picture height
|
|
8962 divided by 16.
|
|
8963 .
|
|
8964 .
|
|
8965 .SS x264enc (\-x264encopts)
|
|
8966 .
|
|
8967 .TP
|
|
8968 .B bitrate=<value>
|
|
8969 Sets the average bitrate to be used in kbits/\:second (default: off).
|
|
8970 Since local bitrate may vary, this average may be inaccurate for
|
|
8971 very short videos (see ratetol).
|
|
8972 Constant bitrate can be achieved by combining this with vbv_maxrate,
|
|
8973 at significant reduction in quality.
|
|
8974 .
|
|
8975 .TP
|
|
8976 .B qp=<0\-51>
|
|
8977 This selects the quantizer to use for P-frames.
|
|
8978 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively.
|
|
8979 20\-40 is a useful range (default: 26).
|
|
8980 Lower values result in better fidelity, but higher bitrates.
|
|
8981 0 is lossless.
|
|
8982 Note that quantization in H.264 works differently from MPEG-1/2/4:
|
|
8983 H.264's quantization parameter (QP) is on a logarithmic scale.
|
|
8984 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP).
|
|
8985 For example, MPEG at QP=2 is equivalent to H.264 at QP=18.
|
|
8986 .
|
|
8987 .TP
|
|
8988 .B crf=<1\-50>
|
|
8989 Enables constant quality mode, and selects the quality.
|
|
8990 The scale is similar to QP.
|
|
8991 Like the bitrate-based modes, this allows each frame to use a
|
|
8992 different QP based on the frame's complexity.
|
|
8993 .
|
|
8994 .TP
|
|
8995 .B pass=<1\-3>
|
|
8996 Enable 2 or 3-pass mode.
|
|
8997 It is recommended to always encode in 2 or 3-pass mode as it leads to a
|
|
8998 better bit distribution and improves overall quality.
|
|
8999 .PD 0
|
|
9000 .RSs
|
|
9001 .IPs 1
|
|
9002 first pass
|
|
9003 .IPs 2
|
|
9004 second pass (of two pass encoding)
|
|
9005 .IPs 3
|
|
9006 Nth pass (second and third passes of three pass encoding)
|
|
9007 .RE
|
|
9008 .RS
|
|
9009 Here is how it works, and how to use it:
|
|
9010 .br
|
|
9011 The first pass (pass=1) collects statistics on the video and writes them
|
|
9012 to a file.
|
|
9013 You might want to deactivate some CPU-hungry options, apart from the ones
|
|
9014 that are on by default.
|
|
9015 .br
|
|
9016 In two pass mode, the second pass (pass=2) reads the statistics file and
|
|
9017 bases ratecontrol decisions on it.
|
|
9018 .br
|
|
9019 In three pass mode, the second pass (pass=3, that is not a typo)
|
|
9020 does both: It first reads the statistics, then overwrites them.
|
|
9021 You can use all encoding options, except very CPU-hungry options.
|
|
9022 .br
|
|
9023 The third pass (pass=3) is the same as the second pass, except that it has
|
|
9024 the second pass' statistics to work from.
|
|
9025 You can use all encoding options, including CPU-hungry ones.
|
|
9026 .br
|
|
9027 The first pass may use either average bitrate or constant quantizer.
|
|
9028 ABR is recommended, since it does not require guessing a quantizer.
|
|
9029 Subsequent passes are ABR, and must specify bitrate.
|
|
9030 .REss
|
|
9031 .
|
|
9032 .TP
|
|
9033 .B turbo=<0\-2>
|
|
9034 Fast first pass mode.
|
|
9035 During the first pass of a two or more pass encode it is possible to gain
|
|
9036 speed by disabling some options with negligible or even no impact on the
|
|
9037 final pass output quality.
|
|
9038 .PD 0
|
|
9039 .RSs
|
|
9040 .IPs 0
|
|
9041 disabled (default)
|
|
9042 .IPs 1
|
|
9043 Reduce subq, frameref and disable some inter-macroblock partition analysis
|
|
9044 modes.
|
|
9045 .IPs 2
|
|
9046 Reduce subq and frameref to 1, use a diamond ME search and disable all
|
|
9047 partition analysis modes.
|
|
9048 .RE
|
|
9049 .RS
|
|
9050 Level 1 can increase first pass speed up to 2x with no change in the global
|
|
9051 PSNR of the final pass compared to a full quality first pass.
|
|
9052 .br
|
|
9053 Level 2 can increase first pass speed up to 4x with about +/- 0.05dB change
|
|
9054 in the global PSNR of the final pass compared to a full quality first pass.
|
|
9055 .REss
|
|
9056 .
|
|
9057 .TP
|
|
9058 .B keyint=<value>
|
|
9059 Sets maximum interval between IDR-frames (default: 250).
|
|
9060 Larger values save bits, thus improve quality, at the cost of seeking
|
|
9061 precision.
|
|
9062 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large
|
|
9063 values of keyint.
|
|
9064 .
|
|
9065 .TP
|
|
9066 .B keyint_min=<1\-keyint/2>
|
|
9067 Sets minimum interval between IDR-frames (default: 25).
|
|
9068 If scenecuts appear within this interval, they are still encoded as
|
|
9069 I-frames, but do not start a new GOP.
|
|
9070 In H.264, I-frames do not necessarily bound a closed GOP because it is
|
|
9071 allowable for a P-frame to be predicted from more frames than just the one
|
|
9072 frame before it (also see frameref).
|
|
9073 Therefore, I-frames are not necessarily seekable.
|
|
9074 IDR-frames restrict subsequent P-frames from referring to any frame
|
|
9075 prior to the IDR-frame.
|
|
9076 .
|
|
9077 .TP
|
|
9078 .B scenecut=<-1\-100>
|
|
9079 Controls how aggressively to insert extra I-frames (default: 40).
|
|
9080 With small values of scenecut, the codec often has to force an I-frame
|
|
9081 when it would exceed keyint.
|
|
9082 Good values of scenecut may find a better location for the I-frame.
|
|
9083 Large values use more I-frames than necessary, thus wasting bits.
|
|
9084 -1 disables scene-cut detection, so I-frames are inserted only once
|
|
9085 every other keyint frames, even if a scene-cut occurs earlier.
|
|
9086 This is not recommended and wastes bitrate as scenecuts encoded as P-frames
|
|
9087 are just as big as I-frames, but do not reset the "keyint counter".
|
|
9088 .
|
|
9089 .TP
|
|
9090 .B frameref=<1\-16>
|
|
9091 Number of previous frames used as predictors in B- and P-frames (default: 1).
|
|
9092 This is effective in anime, but in live-action material the improvements
|
|
9093 usually drop off very rapidly above 6 or so reference frames.
|
|
9094 This has no effect on decoding speed, but does increase the memory needed for
|
|
9095 decoding.
|
|
9096 Some decoders can only handle a maximum of 15 reference frames.
|
|
9097 .
|
|
9098 .TP
|
|
9099 .B bframes=<0\-16>
|
|
9100 maximum number of consecutive B-frames between I- and P-frames (default: 0)
|
|
9101 .
|
|
9102 .TP
|
|
9103 .B (no)b_adapt
|
|
9104 Automatically decides when to use B-frames and how many, up to the maximum
|
|
9105 specified above (default: on).
|
|
9106 If this option is disabled, then the maximum number of B-frames is used.
|
|
9107 .
|
|
9108 .TP
|
|
9109 .B b_bias=<-100\-100>
|
|
9110 Controls the decision performed by b_adapt.
|
|
9111 A higher b_bias produces more B-frames (default: 0).
|
|
9112 .
|
|
9113 .TP
|
|
9114 .B (no)b_pyramid
|
|
9115 Allows B-frames to be used as references for predicting other frames.
|
|
9116 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4.
|
|
9117 Without this option, B-frames follow the same pattern as MPEG-[124].
|
|
9118 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames
|
|
9119 are predicted from I0 and P4.
|
|
9120 With this option, they are coded as I0 P4 B2 B1 B3.
|
|
9121 B2 is the same as above, but B1 is predicted from I0 and B2, and
|
|
9122 B3 is predicted from B2 and P4.
|
|
9123 This usually results in slightly improved compression, at almost no
|
|
9124 speed cost.
|
|
9125 However, this is an experimental option: it is not fully tuned and
|
|
9126 may not always help.
|
|
9127 Requires bframes >= 2.
|
|
9128 Disadvantage: increases decoding delay to 2 frames.
|
|
9129 .
|
|
9130 .TP
|
|
9131 .B (no)deblock
|
|
9132 Use deblocking filter (default: on).
|
|
9133 As it takes very little time compared to its quality gain, it is not
|
|
9134 recommended to disable it.
|
|
9135 .
|
|
9136 .TP
|
|
9137 .B deblock=<-6\-6>,<-6\-6>
|
|
9138 The first parameter is AlphaC0 (default: 0).
|
|
9139 This adjusts thresholds for the H.264 in-loop deblocking filter.
|
|
9140 First, this parameter adjusts the maximum amount of change that the filter is
|
|
9141 allowed to cause on any one pixel.
|
|
9142 Secondly, this parameter affects the threshold for difference across the
|
|
9143 edge being filtered.
|
|
9144 A positive value reduces blocking artifacts more, but will also smear details.
|
|
9145 .br
|
|
9146 The second parameter is Beta (default: 0).
|
|
9147 This affects the detail threshold.
|
|
9148 Very detailed blocks are not filtered, since the smoothing caused by the
|
|
9149 filter would be more noticeable than the original blocking.
|
|
9150 .br
|
|
9151 The default behavior of the filter almost always achieves optimal quality,
|
|
9152 so it is best to either leave it alone, or make only small adjustments.
|
|
9153 However, if your source material already has some blocking or noise which
|
|
9154 you would like to remove, it may be a good idea to turn it up a little bit.
|
|
9155 .
|
|
9156 .TP
|
|
9157 .B (no)cabac
|
|
9158 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on).
|
|
9159 Slightly slows down encoding and decoding, but should save 10-15% bitrate.
|
|
9160 Unless you are looking for decoding speed, you should not disable it.
|
|
9161 .
|
|
9162 .TP
|
|
9163 .B qp_min=<1\-51> (ABR or two pass)
|
|
9164 Minimum quantizer, 10\-30 seems to be a useful range (default: 10).
|
|
9165 .
|
|
9166 .TP
|
|
9167 .B qp_max=<1\-51> (ABR or two pass)
|
|
9168 maximum quantizer (default: 51)
|
|
9169 .
|
|
9170 .TP
|
|
9171 .B qp_step=<1\-50> (ABR or two pass)
|
|
9172 maximum value by which the quantizer may be incremented/decremented between
|
|
9173 frames (default: 4)
|
|
9174 .
|
|
9175 .TP
|
|
9176 .B ratetol=<0.1\-100.0> (ABR or two pass)
|
|
9177 allowed variance in average bitrate (no particular units) (default: 1.0)
|
|
9178 .
|
|
9179 .TP
|
|
9180 .B vbv_maxrate=<value> (ABR or two pass)
|
|
9181 maximum local bitrate, in kbits/\:second (default: disabled)
|
|
9182 .
|
|
9183 .TP
|
|
9184 .B vbv_bufsize=<value> (ABR or two pass)
|
|
9185 averaging period for vbv_maxrate, in kbits
|
|
9186 (default: none, must be specified if vbv_maxrate is enabled)
|
|
9187 .
|
|
9188 .TP
|
|
9189 .B vbv_init=<0.0\-1.0> (ABR or two pass)
|
|
9190 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9)
|
|
9191 .
|
|
9192 .TP
|
|
9193 .B ip_factor=<value>
|
|
9194 quantizer factor between I- and P-frames (default: 1.4)
|
|
9195 .
|
|
9196 .TP
|
|
9197 .B pb_factor=<value>
|
|
9198 quantizer factor between P- and B-frames (default: 1.3)
|
|
9199 .
|
|
9200 .TP
|
|
9201 .B qcomp=<0\-1> (ABR or two pass)
|
|
9202 quantizer compression (default: 0.6).
|
|
9203 A lower value makes the bitrate more constant,
|
|
9204 while a higher value makes the quantization parameter more constant.
|
|
9205 .
|
|
9206 .TP
|
|
9207 .B cplx_blur=<0\-999> (two pass only)
|
|
9208 Temporal blur of the estimated frame complexity, before curve compression
|
|
9209 (default: 20).
|
|
9210 Lower values allow the quantizer value to jump around more,
|
|
9211 higher values force it to vary more smoothly.
|
|
9212 cplx_blur ensures that each I-frame has quality comparable to the following
|
|
9213 P-frames, and ensures that alternating high and low complexity frames
|
|
9214 (e.g. low fps animation) do not waste bits on fluctuating quantizer.
|
|
9215 .
|
|
9216 .TP
|
|
9217 .B qblur=<0\-99> (two pass only)
|
|
9218 Temporal blur of the quantization parameter, after curve compression
|
|
9219 (default: 0.5).
|
|
9220 Lower values allow the quantizer value to jump around more,
|
|
9221 higher values force it to vary more smoothly.
|
|
9222 .
|
|
9223 .TP
|
|
9224 .B zones=<zone0>[/<zone1>[/...]]
|
|
9225 User specified quality for specific parts (ending, credits, ...).
|
|
9226 Each zone is <start-frame>,<end-frame>,<option> where option may be
|
|
9227 .PD 0
|
|
9228 .RSs
|
|
9229 .IPs "q=<0\-51>"
|
|
9230 quantizer
|
|
9231 .IPs "b=<0.01\-100.0>"
|
|
9232 bitrate multiplier
|
|
9233 .RE
|
|
9234 .PD 1
|
|
9235 .RS
|
|
9236 .I NOTE:
|
|
9237 The quantizer option is not strictly enforced.
|
|
9238 It affects only the planning stage of ratecontrol, and is still subject
|
|
9239 to overflow compensation and qp_min/qp_max.
|
|
9240 .RE
|
|
9241 .
|
|
9242 .TP
|
|
9243 .B direct_pred=<name>
|
|
9244 Determines the type of motion prediction used for direct macroblocks
|
|
9245 in B-frames.
|
|
9246 .PD 0
|
|
9247 .RSs
|
|
9248 .IPs none
|
|
9249 Direct macroblocks are not used.
|
|
9250 .IPs spatial
|
|
9251 Motion vectors are extrapolated from neighboring blocks.
|
|
9252 (default)
|
|
9253 .IPs temporal
|
|
9254 Motion vectors are interpolated from the following P-frame.
|
|
9255 .IPs auto
|
|
9256 The codec selects between spatial and temporal for each frame.
|
|
9257 .RE
|
|
9258 .PD 1
|
|
9259 .RS
|
|
9260 Spatial and temporal are approximately the same speed and PSNR,
|
|
9261 the choice between them depends on the video content.
|
|
9262 Auto is slightly better, but slower.
|
|
9263 Auto is most effective when combined with multipass.
|
|
9264 direct_pred=none is both slower and lower quality.
|
|
9265 .RE
|
|
9266 .
|
|
9267 .TP
|
|
9268 .B (no)weight_b
|
|
9269 Use weighted prediction in B-frames.
|
|
9270 Without this option, bidirectionally predicted macroblocks give
|
|
9271 equal weight to each reference frame.
|
|
9272 With this option, the weights are determined by the temporal position
|
|
9273 of the B-frame relative to the references.
|
|
9274 Requires bframes > 1.
|
|
9275 .
|
|
9276 .TP
|
|
9277 .B partitions=<list>
|
|
9278 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4).
|
|
9279 .PD 0
|
|
9280 .RSs
|
|
9281 .IPs p8x8
|
|
9282 Enable types p16x8, p8x16, p8x8.
|
|
9283 .IPs p4x4
|
|
9284 Enable types p8x4, p4x8, p4x4.
|
|
9285 p4x4 is recommended only with subq >= 5, and only at low resolutions.
|
|
9286 .IPs b8x8
|
|
9287 Enable types b16x8, b8x16, b8x8.
|
|
9288 .IPs i8x8
|
|
9289 Enable type i8x8.
|
|
9290 i8x8 has no effect unless 8x8dct is enabled.
|
|
9291 .IPs i4x4
|
|
9292 Enable type i4x4.
|
|
9293 .IPs all
|
|
9294 Enable all of the above types.
|
|
9295 .IPs none
|
|
9296 Disable all of the above types.
|
|
9297 .RE
|
|
9298 .PD 1
|
|
9299 .RS
|
|
9300 Regardless of this option, macroblock types p16x16, b16x16, and i16x16
|
|
9301 are always enabled.
|
|
9302 .br
|
|
9303 The idea is to find the type and size that best describe a certain area
|
|
9304 of the picture.
|
|
9305 For example, a global pan is better represented by 16x16 blocks, while
|
|
9306 small moving objects are better represented by smaller blocks.
|
|
9307 .RE
|
|
9308 .
|
|
9309 .TP
|
|
9310 .B (no)8x8dct
|
|
9311 Adaptive spatial transform size: allows macroblocks to choose between
|
|
9312 4x4 and 8x8 DCT.
|
|
9313 Also allows the i8x8 macroblock type.
|
|
9314 Without this option, only 4x4 DCT is used.
|
|
9315 .
|
|
9316 .TP
|
|
9317 .B me=<name>
|
|
9318 Select fullpixel motion estimation algorithm.
|
|
9319 .PD 0
|
|
9320 .RSs
|
|
9321 .IPs dia
|
|
9322 diamond search, radius 1 (fast)
|
|
9323 .IPs hex
|
|
9324 hexagon search, radius 2 (default)
|
|
9325 .IPs umh
|
|
9326 uneven multi-hexagon search (slow)
|
|
9327 .IPs esa
|
|
9328 exhaustive search (very slow, and no better than umh)
|
|
9329 .RE
|
|
9330 .PD 1
|
|
9331 .
|
|
9332 .TP
|
|
9333 .B me_range=<4\-64>
|
|
9334 radius of exhaustive or multi-hexagon motion search (default: 16)
|
|
9335 .
|
|
9336 .TP
|
|
9337 .B subq=<1\-7>
|
|
9338 Adjust subpel refinement quality.
|
|
9339 This parameter controls quality versus speed tradeoffs involved in the motion
|
|
9340 estimation decision process.
|
|
9341 subq=5 can compress up to 10% better than subq=1.
|
|
9342 .PD 0
|
|
9343 .RSs
|
|
9344 .IPs 1
|
|
9345 Runs fullpixel precision motion estimation on all candidate
|
|
9346 macroblock types.
|
|
9347 Then selects the best type.
|
|
9348 Then refines the motion of that type to fast quarterpixel precision (fastest).
|
|
9349 .IPs 2
|
|
9350 Runs halfpixel precision motion estimation on all candidate macroblock types.
|
|
9351 Then selects the best type.
|
|
9352 Then refines the motion of that type to fast quarterpixel precision.
|
|
9353 .IPs 3
|
|
9354 As 2, but uses a slower quarterpixel refinement.
|
|
9355 .IPs 4
|
|
9356 Runs fast quarterpixel precision motion estimation on all candidate
|
|
9357 macroblock types.
|
|
9358 Then selects the best type.
|
|
9359 Then finishes the quarterpixel refinement for that type.
|
|
9360 .IPs 5
|
|
9361 Runs best quality quarterpixel precision motion estimation on all
|
|
9362 candidate macroblock types, before selecting the best type (default).
|
|
9363 .IPs 6
|
|
9364 Enables rate-distortion optimization of macroblock types in
|
|
9365 I- and P-frames.
|
|
9366 .IPs 7
|
|
9367 Enables rate-distortion optimization of motion vectors and intra modes. (best)
|
|
9368 .RE
|
|
9369 .PD 1
|
|
9370 .RS
|
|
9371 In the above, "all candidates" does not exactly mean all enabled types:
|
|
9372 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16.
|
|
9373 .RE
|
|
9374 .
|
|
9375 .TP
|
|
9376 .B (no)chroma_me
|
|
9377 Takes into account chroma information during subpixel motion search
|
|
9378 (default: enabled).
|
|
9379 Requires subq>=5.
|
|
9380 .
|
|
9381 .TP
|
|
9382 .B (no)mixed_refs
|
|
9383 Allows each 8x8 or 16x8 motion partition to independently select a
|
|
9384 reference frame.
|
|
9385 Without this option, a whole macroblock must use the same reference.
|
|
9386 Requires frameref>1.
|
|
9387 .
|
|
9388 .TP
|
|
9389 .B (no)brdo
|
|
9390 Enables rate-distortion optimization of macroblock types in B-frames.
|
|
9391 Requires subq>=6.
|
|
9392 .
|
|
9393 .TP
|
|
9394 .B (no)bime
|
|
9395 Refine the two motion vectors used in bidirectional macroblocks,
|
|
9396 rather than re-using vectors from the forward and backward searches.
|
|
9397 This option has no effect without B-frames.
|
|
9398 .
|
|
9399 .TP
|
|
9400 .B trellis=<0\-2>
|
|
9401 rate-distortion optimal quantization
|
|
9402 .PD 0
|
|
9403 .RSs
|
|
9404 .IPs 0
|
|
9405 disabled (default)
|
|
9406 .IPs 1
|
|
9407 enabled only for the final encode
|
|
9408 .IPs 2
|
|
9409 enabled during all mode decisions (slow, requires subq>=6)
|
|
9410 .RE
|
|
9411 .PD 1
|
|
9412 .
|
|
9413 .TP
|
|
9414 .B deadzone_inter=<0\-32>
|
|
9415 Set the size of the inter luma quantization deadzone for non-trellis
|
|
9416 quantization (default: 21).
|
|
9417 .
|
|
9418 .TP
|
|
9419 .B deadzone_intra=<0\-32>
|
|
9420 Set the size of the intra luma quantization deadzone for non-trellis
|
|
9421 quantization (default: 11).
|
|
9422 .
|
|
9423 .TP
|
|
9424 .B (no)fast_pskip
|
|
9425 Performs early skip detection in P-frames (default: enabled).
|
|
9426 This usually improves speed at no cost, but it can sometimes produce
|
|
9427 artifacts in areas with no details, like sky.
|
|
9428 .
|
|
9429 .TP
|
|
9430 .B (no)dct_decimate
|
|
9431 Eliminate dct blocks in P-frames containing only a small single coefficient
|
|
9432 (default: enabled).
|
|
9433 This will remove some details, so it will save bits that can be spent
|
|
9434 again on other frames, hopefully raising overall subjective quality.
|
|
9435 If you are compressing non-anime content with a high target bitrate, you
|
|
9436 may want to disable this to preserve as much detail as possible.
|
|
9437 .
|
|
9438 .TP
|
|
9439 .B nr=<0\-100000>
|
|
9440 Noise reduction, 0 means disabled.
|
|
9441 100\-1000 is a useful range for typical content, but you may want to turn it
|
|
9442 up a bit more for very noisy content (default: 0).
|
|
9443 Given its small impact on speed, you might want to prefer to use this over
|
|
9444 filtering noise away with video filters like denoise3d or hqdn3d.
|
|
9445 .
|
|
9446 .TP
|
|
9447 .B chroma_qp_offset=<-12\-12>
|
|
9448 Use a different quantizer for chroma as compared to luma.
|
|
9449 Useful values are in the range <-2\-2> (default: 0).
|
|
9450 .
|
|
9451 .TP
|
|
9452 .B cqm=<flat|jvt|<filename>>
|
|
9453 Either uses a predefined custom quantization matrix or loads a JM format
|
|
9454 matrix file.
|
|
9455 .PD 0
|
|
9456 .RSs
|
|
9457 .IPs "flat\ "
|
|
9458 Use the predefined flat 16 matrix (default).
|
|
9459 .IPs "jvt\ \ "
|
|
9460 Use the predefined JVT matrix.
|
|
9461 .IPs <filename>
|
|
9462 Use the provided JM format matrix file.
|
|
9463 .PD 1
|
|
9464 .RE
|
|
9465 .RS
|
|
9466 .I NOTE:
|
|
9467 Windows CMD.EXE users may experience problems with parsing the command line
|
|
9468 if they attempt to use all the CQM lists.
|
|
9469 This is due to a command line length limitation.
|
|
9470 In this case it is recommended the lists be put into a JM format CQM
|
|
9471 file and loaded as specified above.
|
|
9472 .RE
|
|
9473 .
|
|
9474 .TP
|
|
9475 .B cqm4iy=<list> (also see cqm)
|
|
9476 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated
|
|
9477 values in the 1\-255 range.
|
|
9478 .
|
|
9479 .TP
|
|
9480 .B cqm4ic=<list> (also see cqm)
|
|
9481 Custom 4x4 intra chrominance matrix, given as a list of 16 comma
|
|
9482 separated values in the 1\-255 range.
|
|
9483 .
|
|
9484 .TP
|
|
9485 .B cqm4py=<list> (also see cqm)
|
|
9486 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated
|
|
9487 values in the 1\-255 range.
|
|
9488 .
|
|
9489 .TP
|
|
9490 .B cqm4pc=<list> (also see cqm)
|
|
9491 Custom 4x4 inter chrominance matrix, given as a list of 16 comma
|
|
9492 separated values in the 1\-255 range.
|
|
9493 .
|
|
9494 .TP
|
|
9495 .B cqm8iy=<list> (also see cqm)
|
|
9496 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated
|
|
9497 values in the 1\-255 range.
|
|
9498 .
|
|
9499 .TP
|
|
9500 .B cqm8py=<list> (also see cqm)
|
|
9501 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated
|
|
9502 values in the 1\-255 range.
|
|
9503 .
|
|
9504 .TP
|
|
9505 .B level_idc=<10\-51>
|
|
9506 Set the bitstream's level as defined by annex A of the H.264 standard
|
|
9507 (default: 51 - Level 5.1).
|
|
9508 This is used for telling the decoder what capabilities it needs to support.
|
|
9509 Use this parameter only if you know what it means,
|
|
9510 and you have a need to set it.
|
|
9511 .
|
|
9512 .TP
|
|
9513 .B threads=<1\-4>
|
|
9514 Split each frame into slices and encode them in parallel (default: 1).
|
|
9515 Also allows multithreaded decoding if the decoder supports it (lavc does not).
|
|
9516 This has a slight penalty to compression.
|
|
9517 Requires that libx264 was compiled with pthread support; if not, this
|
|
9518 option will produce a warning and enables slices but not multithreading.
|
|
9519 .
|
|
9520 .TP
|
|
9521 .B (no)global_header
|
|
9522 Causes SPS and PPS to appear only once, at the beginning of the bitstream
|
|
9523 (default: disabled).
|
|
9524 Some players, such as the Sony PSP, require the use of this option.
|
|
9525 The default behavior causes SPS and PPS to repeat prior to each IDR frame.
|
|
9526 .
|
|
9527 .TP
|
|
9528 .B (no)interlaced
|
|
9529 Treat the video content as interlaced.
|
|
9530 .
|
|
9531 .TP
|
|
9532 .B log=<-1\-3>
|
|
9533 Adjust the amount of logging info printed to the screen.
|
|
9534 .PD 0
|
|
9535 .RSs
|
|
9536 .IPs "-1"
|
|
9537 none
|
|
9538 .IPs " 0"
|
|
9539 Print errors only.
|
|
9540 .IPs " 1"
|
|
9541 warnings
|
|
9542 .IPs " 2"
|
|
9543 PSNR and other analysis statistics when the encode finishes (default)
|
|
9544 .IPs " 3"
|
|
9545 PSNR, QP, frametype, size, and other statistics for every frame
|
|
9546 .RE
|
|
9547 .PD 1
|
|
9548 .
|
|
9549 .TP
|
|
9550 .B (no)psnr
|
|
9551 Print signal-to-noise ratio statistics.
|
|
9552 .br
|
|
9553 .I NOTE:
|
|
9554 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not
|
|
9555 mathematically sound (they are simply the average of per-frame PSNRs).
|
|
9556 They are kept only for comparison to the JM reference codec.
|
|
9557 For all other purposes, please use either the 'Global' PSNR, or the per-frame
|
|
9558 PSNRs printed by log=3.
|
|
9559 .
|
|
9560 .TP
|
|
9561 .B (no)ssim
|
|
9562 Print the Structural Similarity Metric results.
|
|
9563 This is an alternative to PSNR, and may be better correlated with the
|
|
9564 perceived quality of the compressed video.
|
|
9565 .
|
|
9566 .TP
|
|
9567 .B (no)visualize
|
|
9568 Enable x264 visualizations during encoding.
|
|
9569 If the x264 on your system supports it, a new window will be opened during
|
|
9570 the encoding process, in which x264 will attempt to present an overview of
|
|
9571 how each frame gets encoded.
|
|
9572 Each block type on the visualized movie will be colored as follows:
|
|
9573 .PD 0
|
|
9574 .RSs
|
|
9575 .IPs red/pink
|
|
9576 intra block
|
|
9577 .IPs "blue\ "
|
|
9578 inter block
|
|
9579 .IPs green
|
|
9580 skip block
|
|
9581 .IPs yellow
|
|
9582 B-block
|
|
9583 .RE
|
|
9584 .PD 1
|
|
9585 .RS
|
|
9586 This feature can be considered experimental and subject to change.
|
|
9587 In particular, it depends on x264 being compiled with visualizations enabled.
|
|
9588 Note that as of writing this, x264 pauses after encoding and visualizing
|
|
9589 each frame, waiting for the user to press a key, at which point the next
|
|
9590 frame will be encoded.
|
|
9591 .RE
|
|
9592 .
|
|
9593 .
|
|
9594 .SS xvfw (\-xvfwopts)
|
|
9595 .
|
|
9596 Encoding with Video for Windows codecs is mostly obsolete unless you wish
|
|
9597 to encode to some obscure fringe codec.
|
|
9598 .
|
|
9599 .TP
|
|
9600 .B codec=<name>
|
|
9601 The name of the binary codec file with which to encode.
|
|
9602 .
|
|
9603 .
|
|
9604 .SS MPEG muxer (\-mpegopts)
|
|
9605 .
|
|
9606 The MPEG muxer can generate 5 types of streams, each of which has reasonable
|
|
9607 default parameters that the user can override.
|
|
9608 Generally, when generating MPEG files, it is advisable to disable
|
|
9609 MEncoder's frame-skip code (see \-noskip, \-mc as well as the
|
|
9610 harddup and softskip video filters).
|
|
9611 .PP
|
|
9612 .I EXAMPLE:
|
|
9613 .PD 0
|
|
9614 .RSs
|
|
9615 .IPs format=mpeg2:tsaf:vbitrate=8000
|
|
9616 .RE
|
|
9617 .PD 1
|
|
9618 .
|
|
9619 .TP
|
|
9620 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd>
|
|
9621 stream format (default: mpeg2)
|
|
9622 .
|
|
9623 .TP
|
|
9624 .B size=<up to 65535>
|
|
9625 Pack size in bytes, do not change unless you know exactly what
|
|
9626 you are doing (default: 2048).
|
|
9627 .
|
|
9628 .TP
|
|
9629 .B muxrate=<int>
|
|
9630 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s).
|
|
9631 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'.
|
|
9632 .
|
|
9633 .TP
|
|
9634 .B "tsaf\ \ \ "
|
|
9635 Sets timestamps on all frames, if possible; recommended when format=dvd.
|
|
9636 If dvdauthor complains with a message like "..audio sector out of range...",
|
|
9637 you probably did not enable this option.
|
|
9638 .
|
|
9639 .TP
|
|
9640 .B init_vpts=<100\-700>
|
|
9641 initial video pts, in milliseconds (default: 200)
|
|
9642 .
|
|
9643 .TP
|
|
9644 .B init_apts=<100\-700>
|
|
9645 initial audio pts, in milliseconds (default: 200)
|
|
9646 .
|
|
9647 .TP
|
|
9648 .B vdelay=<1\-32760>
|
|
9649 Initial video delay time, in milliseconds (default: 0),
|
|
9650 use it if you want to delay video with respect to audio.
|
|
9651 .
|
|
9652 .TP
|
|
9653 .B "drop\ \ \ "
|
|
9654 When used with init_adelay the muxer drops the part of audio that was
|
|
9655 anticipated.
|
|
9656 .
|
|
9657 .TP
|
|
9658 .B vwidth, vheight=<1\-4095>
|
|
9659 Set the video width and height when video is MPEG-1/2.
|
|
9660 .
|
|
9661 .TP
|
|
9662 .B vpswidth, vpsheight=<1\-4095>
|
|
9663 Set pan and scan video width and height when video is MPEG-2.
|
|
9664 .
|
|
9665 .TP
|
|
9666 .B vaspect=<1 | 4/3 | 16/9 | 221/100>
|
|
9667 Sets the display aspect ratio for MPEG-2 video.
|
|
9668 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong.
|
|
9669 .
|
|
9670 .TP
|
|
9671 .B vbitrate=<int>
|
|
9672 Sets the video bitrate in kbit/s for MPEG-1/2 video.
|
|
9673 .
|
|
9674 .TP
|
|
9675 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 >
|
|
9676 Sets the framerate for MPEG-1/2 video.
|
|
9677 This option will be ignored if used with the telecine option.
|
|
9678 .
|
|
9679 .TP
|
|
9680 .B telecine
|
|
9681 Enables 3:2 pulldown soft telecine mode: The muxer will make the
|
|
9682 video stream look like it was encoded at 30000/1001 or 30 fps.
|
|
9683 It only works with MPEG-2 video when the output framerate,
|
|
9684 converted with \-ofps, is either 24000/1001 or 24 fps.
|
|
9685 Any other framerate is incompatible with this option.
|
|
9686 .
|
|
9687 .TP
|
|
9688 .B film2pal
|
|
9689 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer
|
|
9690 will make the video stream look like it was encoded at 25 fps.
|
|
9691 It only works with MPEG-2 video when the output framerate,
|
|
9692 converted with \-ofps, is either 24000/1001 or 24 fps.
|
|
9693 Any other framerate is incompatible with this option.
|
|
9694 .
|
|
9695 .
|
|
9696 .SS FFmpeg libavformat demuxers (\-lavfdopts)
|
|
9697 .
|
|
9698 .TP
|
|
9699 .B probesize=<value>
|
|
9700 Maximum amount of data to probe during the detection phase.
|
|
9701 In the case of MPEG-TS this value identifies the maximum number
|
|
9702 of TS packets to scan.
|
|
9703 .
|
|
9704 .
|
|
9705 .
|
|
9706 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf)
|
|
9707 .
|
|
9708 .TP
|
|
9709 .B delay=<value>
|
|
9710 Currently only meaningful for MPEG[12]: Maximum allowed distance,
|
|
9711 in seconds, between the reference timer of the output stream (SCR)
|
|
9712 and the decoding timestamp (DTS) for any stream present
|
|
9713 (demux to decode delay).
|
|
9714 Default is 0.7 (as mandated by the standards defined by MPEG).
|
|
9715 Higher values require larger buffers and must not be used.
|
|
9716 .
|
|
9717 .TP
|
|
9718 .B format=<container_format>
|
|
9719 Override which container format to mux into
|
|
9720 (default: autodetect from output file extension).
|
|
9721 .PD 0
|
|
9722 .RSs
|
|
9723 .IPs "mpg\ \ "
|
|
9724 MPEG-1 systems and MPEG-2 PS
|
|
9725 .IPs "asf\ \ "
|
|
9726 Advanced Streaming Format
|
|
9727 .IPs "avi\ \ "
|
|
9728 Audio Video Interleave file
|
|
9729 .IPs "wav\ \ "
|
|
9730 Waveform Audio
|
|
9731 .IPs "swf\ \ "
|
|
9732 Macromedia Flash
|
|
9733 .IPs "flv\ \ "
|
|
9734 Macromedia Flash video files
|
|
9735 .IPs "rm\ \ \ "
|
|
9736 RealAudio and RealVideo
|
|
9737 .IPs "au\ \ \ "
|
|
9738 SUN AU format
|
|
9739 .IPs "nut\ \ "
|
|
9740 NUT open container format (experimental)
|
|
9741 .IPs "mov\ \ "
|
|
9742 QuickTime
|
|
9743 .IPs "mp4\ \ "
|
|
9744 MPEG-4 format
|
|
9745 .IPs "dv\ \ \ "
|
|
9746 Sony Digital Video container
|
|
9747 .RE
|
|
9748 .PD 1
|
|
9749 .TP
|
|
9750 .B i_certify_that_my_video_stream_does_not_use_b_frames
|
|
9751 MEncoder cannot assign correct timestamps when there are
|
|
9752 B-frames in the video stream, resulting in broken encodes.
|
|
9753 .
|
|
9754 .TP
|
|
9755 .B muxrate=<rate>
|
|
9756 Минимальный битовый поток мультиплексирования, в бит/с;
|
|
9757 в данный момент имеет смысл только для MPEG[12].
|
|
9758 Иногда уго указание необходимо для избавления от "buffer underflows".
|
|
9759 .
|
|
9760 .TP
|
|
9761 .B packetsize=<size>
|
|
9762 .\" FIXME better translation
|
|
9763 Размер, выраженный в байтах, атомарного[unitary] пакета для выбранного формата.
|
|
9764 При сжатии в MPEG[12] используются следующие значения по-умолчанию:
|
|
9765 2324 для [S]VCD, 2048 для всех остальных форматов.
|
|
9766 .
|
|
9767 .TP
|
|
9768 .B preload=<distance>
|
|
9769 На текущий момент имеет смысл только для MPEG[12]: Начальное разница,
|
|
9770 в секундах, между значением таймера потока вывода (SCR) и временной меткой
|
|
9771 .\" FIXME better translation
|
|
9772 декодирования (DTS) для любого существующего потока (задержка декодирования
|
|
9773 [demux to decode delay]).
|
|
9774 .
|
|
9775 .
|
|
9776 .
|
|
9777 .\" --------------------------------------------------------------------------
|
|
9778 .\" переменные окружения
|
|
9779 .\" --------------------------------------------------------------------------
|
|
9780 .
|
|
9781 .SH ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ
|
|
9782 .
|
|
9783 Существуют некоторые переменные окружения, которые могут использоваться для управления
|
|
9784 поведением MPlayer И MEncoder.
|
|
9785 .
|
|
9786 .TP
|
|
9787 .B MPLAYER_CHARSET (также смотрите \-msgcharset)
|
|
9788 Преодразовывать сообщения консоли в указанную кодировку (по-умолчанию: автоопределение).
|
|
9789 Значение "noconv" означает отсутствие перекодировки.
|
|
9790 .
|
|
9791 .TP
|
|
9792 .B MPLAYER_HOME
|
|
9793 Каталог, в котором MPlayer ищет настройки пользователя.
|
|
9794 .
|
|
9795 .TP
|
|
9796 .B MPLAYER_VERBOSE (также смотрите \-v и \-msglevel)
|
|
9797 Указывает начальный уровень подробности сообщений для всех
|
|
9798 модулей (пл-умолчанию: 0).
|
|
9799 Отрицательные значения приведет к меньшему количеству сообщений, положительное -
|
|
9800 к большему.
|
|
9801 .
|
|
9802 .SS libaf:
|
|
9803 .
|
|
9804 .TP
|
|
9805 .B LADSPA_PATH
|
|
9806 Если LADSPA_PATH установлена, производится поиск указанного файла. Если не
|
|
9807 установлена, вам придется указать полный путь.
|
|
9808 FIXME: Ою этом также упоминается в разделе ladspa.
|
|
9809 .
|
|
9810 .SS libdvdcss:
|
|
9811 .
|
|
9812 .TP
|
|
9813 .B DVDCSS_CACHE
|
|
9814 Указывает каталог, хранящий ключи роликов.
|
|
9815 Это ускоряет расшифровку[descrambling] DVD? находящихся в кеше.
|
|
9816 Каталог DVDCSS_CACHE будет создан, если не существовал,
|
|
9817 а ткаже подкаталог с названием DVD ролика или даты изготовления.
|
|
9818 Если DVDCSS_CACHE не установлена или пуста, libdvdcss будет использовать
|
|
9819 значение по-умолчания, равное "${HOME}/.dvdcss/" под Unix и
|
|
9820 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" под Win32.
|
|
9821 Спецальное значение "off" отключает кеширование.
|
|
9822 .
|
|
9823 .TP
|
|
9824 .B DVDCSS_METHOD
|
|
9825 Устанавливает методы аутентикации и дешифровки, которые
|
|
9826 libdvdcss будет использовать для чтения шифрованных[scrambled] дисков.
|
|
9827 Может принимать значения title, key or disc.
|
|
9828 .PD 0
|
|
9829 .RSs
|
|
9830 .IPs "key\ \ "
|
|
9831 это метод по-умолчанию.
|
|
9832 libdvdcss будет использовать набор рассчитанных ключей проигрывателей,
|
|
9833 чтобы попробовать и получить ключ диска.
|
|
9834 Это модет не сработать, если устройство не распознает ни один из ключей
|
|
9835 проигрывателей.
|
|
9836 .IPs "disc\ "
|
|
9837 это аварийный метод, когда предыдущий не справился.
|
|
9838 Вместо использования ключей проигрывателей, libdvdcss взломает ключ
|
|
9839 диска используя грубый метод взлома. Этот процесс требователен к CPU
|
|
9840 и требцет 64Мб памяти для хранения временных данных.
|
|
9841 .IPs title
|
|
9842 это аварийный метод, если ни один из предыдцщих не сработал.
|
|
9843 Он никак не связан с обменом клчами с устройством DVD, но вместо этого
|
|
9844 используеткрипто атаку, для угадыванию ключа ролика.
|
|
9845 В исключительных случаях и он может завершиться неудачно, по причине
|
|
9846 нехватки шифрованных данных для осуществления статистической атаки,
|
|
9847 но, с другой стороны, это единственный способ расшифровать DVD,
|
|
9848 сохраненный на жестский диск, или с неправильным регионом на RPC2 устройстве.
|
|
9849 .RE
|
|
9850 .PD 1
|
|
9851 .
|
|
9852 .TP
|
|
9853 .B DVDCSS_RAW_DEVICE
|
|
9854 Указывает "сырое"[raw] устройство для использования.
|
|
9855 Конкретное использование будет зависеть от вашей оперционной системы,
|
|
9856 в Linux утилитой для настройки "сырых" устройств является raw(8).
|
|
9857 Заметьте, что на большинстве операционных систем, использование
|
|
9858 "сырого" устройства требует хорошо выровненных[highly aligned] буферов:
|
|
9859 Linux требует выравнивания на 2048 байт (что равняется размеру сектора DVD).
|
|
9860 .
|
|
9861 .TP
|
|
9862 .B DVDCSS_VERBOSE
|
|
9863 Устанавливает уровень подробности сообщений libdvdcss.
|
|
9864 .PD 0
|
|
9865 .RSs
|
|
9866 .IPs 0
|
|
9867 Вообще не выводить сообщения.
|
|
9868 .IPs 1
|
|
9869 Выводить ошибки в stderr.
|
|
9870 .IPs 2
|
|
9871 Выводить ошибки и сообщения отладки в stderr.
|
|
9872 .RE
|
|
9873 .PD 1
|
|
9874 .
|
|
9875 .TP
|
|
9876 .B DVDREAD_NOKEYS
|
|
9877 Пропустить получение всех ключей при запуске.
|
|
9878 В данный момент отключено.
|
|
9879 .
|
|
9880 .TP
|
|
9881 .B HOME
|
|
9882 FIXME: Описать это.
|
|
9883 .
|
|
9884 .SS libao2:
|
|
9885 .
|
|
9886 .TP
|
|
9887 .B AO_SUN_DISABLE_SAMPLE_TIMING
|
|
9888 FIXME: Описать это.
|
|
9889 .
|
|
9890 .TP
|
|
9891 .B AUDIODEV
|
|
9892 FIXME: Описать это.
|
|
9893 .
|
|
9894 .TP
|
|
9895 .B AUDIOSERVER
|
|
9896 Указывает Network Audio System сервер к которому драйвер вывода nat
|
|
9897 должен присоединиться и транспорт,кторый должен быть использован.
|
|
9898 Если не установлена, вместо нее используется DISPLAY.
|
|
9899 Транспорт может быть tcp или unix.
|
|
9900 Синтаксис: tcp/<некий_хост>:<некий_порт>, <некий_хост>:<номер_экземпляра>
|
|
9901 или [unix]:<номер_экземпляра>.
|
|
9902 Основной порт NAS - 8000 и <номер_экземпляра> добавляется к нему.
|
|
9903 .sp 1
|
|
9904 .RS
|
|
9905 .I EXAMPLES:
|
|
9906 .RE
|
|
9907 .PD 0
|
|
9908 .RSs
|
|
9909 .IPs AUDIOSERVER=somehost:0
|
|
9910 Присоединение к NAS серверу на somehost, используя опрт и транспорт по-умолчанию.
|
|
9911 .IPs AUDIOSERVER=tcp/somehost:8000
|
|
9912 Присоединение к NAS серверу на somehost, слушающему TCP порт 8000.
|
|
9913 .IPs AUDIOSERVER=(unix)?:0
|
|
9914 Присоединения к NAS серверу, экземпляр 0 на localhost используя unix сокеты.
|
|
9915 .RE
|
|
9916 .PD 1
|
|
9917 .
|
|
9918 .TP
|
|
9919 .B DISPLAY
|
|
9920 FIXME: Описать это.
|
|
9921 .
|
|
9922 .SS vidix:
|
|
9923 .
|
|
9924 .TP
|
|
9925 .B VIDIX_CRT
|
|
9926 FIXME: Описать это.
|
|
9927 .
|
|
9928 .SS osdep:
|
|
9929 .
|
|
9930 .TP
|
|
9931 .B TERM
|
|
9932 FIXME: Описать это.
|
|
9933 .
|
|
9934 .SS libvo:
|
|
9935 .
|
|
9936 .TP
|
|
9937 .B DISPLAY
|
|
9938 FIXME: Описать это.
|
|
9939 .
|
|
9940 .TP
|
|
9941 .B FRAMEBUFFER
|
|
9942 FIXME: Описать это.
|
|
9943 .
|
|
9944 .TP
|
|
9945 .B HOME
|
|
9946 FIXME: Описать это.
|
|
9947 .
|
|
9948 .SS libmpdemux:
|
|
9949 .
|
|
9950 .TP
|
|
9951 .B HOME
|
|
9952 FIXME: Описать это.
|
|
9953 .
|
|
9954 .TP
|
|
9955 .B HOMEPATH
|
|
9956 FIXME: Описать это.
|
|
9957 .
|
|
9958 .TP
|
|
9959 .B http_proxy
|
|
9960 FIXME: Описать это.
|
|
9961 .
|
|
9962 .TP
|
|
9963 .B LOGNAME
|
|
9964 FIXME: Описать это.
|
|
9965 .
|
|
9966 .TP
|
|
9967 .B USERPROFILE
|
|
9968 FIXME: Описать это.
|
|
9969 .
|
|
9970 .SS libmpcodecs:
|
|
9971 .
|
|
9972 .TP
|
|
9973 .B XANIM_MOD_DIR
|
|
9974 FIXME: Описать это.
|
|
9975 .
|
|
9976 .SS GUI:
|
|
9977 .
|
|
9978 .TP
|
|
9979 .B CHARSET
|
|
9980 FIXME: Описать это.
|
|
9981 .
|
|
9982 .TP
|
|
9983 .B DISPLAY
|
|
9984 FIXME: Описать это.
|
|
9985 .
|
|
9986 .TP
|
|
9987 .B HOME
|
|
9988 FIXME: Описать это.
|
|
9989 .
|
|
9990 .SS libavformat:
|
|
9991 .
|
|
9992 .TP
|
|
9993 .B AUDIO_FLIP_LEFT
|
|
9994 FIXME: Описать это.
|
|
9995 .
|
|
9996 .TP
|
|
9997 .B BKTR_DEV
|
|
9998 FIXME: Описать это.
|
|
9999 .
|
|
10000 .TP
|
|
10001 .B BKTR_FORMAT
|
|
10002 FIXME: Описать это.
|
|
10003 .
|
|
10004 .TP
|
|
10005 .B BKTR_FREQUENCY
|
|
10006 FIXME: Описать это.
|
|
10007 .
|
|
10008 .TP
|
|
10009 .B http_proxy
|
|
10010 FIXME: Описать это.
|
|
10011 .
|
|
10012 .TP
|
|
10013 .B no_proxy
|
|
10014 FIXME: Описать это.
|
|
10015 .
|
|
10016 .
|
|
10017 .
|
|
10018 .\" --------------------------------------------------------------------------
|
|
10019 .\" Файлы
|
|
10020 .\" --------------------------------------------------------------------------
|
|
10021 .
|
|
10022 .SH ФАЙЛЫ
|
|
10023 .
|
|
10024 .TP
|
|
10025 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf
|
|
10026 Общесистемные настройки MPlayer
|
|
10027 .
|
|
10028 .TP
|
|
10029 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf
|
|
10030 Общесистемные настройки MEncoder
|
|
10031 .
|
|
10032 .TP
|
|
10033 ~/.mplayer/\:config
|
|
10034 Пользовательские настройки MPlayer
|
|
10035 .
|
|
10036 .TP
|
|
10037 ~/.mplayer/\:mencoder.conf
|
|
10038 Пользовательские настройки MEncoder
|
|
10039 .
|
|
10040 .TP
|
|
10041 ~/.mplayer/\:input.conf
|
|
10042 Привязки клавиш (смотрите '\-input keylist' для полного списка)
|
|
10043 .
|
|
10044 .TP
|
|
10045 ~/.mplayer/\:gui.conf
|
|
10046 Файл настройки GUI
|
|
10047 .
|
|
10048 .TP
|
|
10049 ~/.mplayer/\:gui.pl
|
|
10050 Список воспроизведения GUI
|
|
10051 .
|
|
10052 .TP
|
|
10053 ~/.mplayer/\:font/
|
|
10054 Каталог шрифтов (В нем должен находиться файл font.desc и файлы с расширением .RAW)
|
|
10055 .
|
|
10056 .TP
|
|
10057 ~/.mplayer/\:DVDkeys/
|
|
10058 Кэшированные ключи CSS
|
|
10059 .
|
|
10060 .TP
|
|
10061 Предполагая, что проигрывается файл /path/\:to/\:movie.avi, MPlayer ищет
|
|
10062 файлы с субтитрами в следующем порядке:
|
|
10063 .RS
|
|
10064 /path/\:to/\:movie.sub
|
|
10065 .br
|
|
10066 ~/.mplayer/\:sub/\:movie.sub
|
|
10067 .RE
|
|
10068 .PD 1
|
|
10069 .
|
|
10070 .
|
|
10071 .\" --------------------------------------------------------------------------
|
|
10072 .\" Примеры
|
|
10073 .\" --------------------------------------------------------------------------
|
|
10074 .
|
|
10075 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MPLAYER
|
|
10076 .
|
|
10077 .PP
|
|
10078 .B Быстрый старт проигрывания DVD:
|
|
10079 .nf
|
|
10080 mplayer dvd://1
|
|
10081 .fi
|
|
10082 .
|
|
10083 .PP
|
|
10084 .B Проиграть DVD на Японском с Английскими субтитрами:
|
|
10085 .nf
|
|
10086 mplayer dvd://1 \-alang ja \-slang en
|
|
10087 .fi
|
|
10088 .
|
|
10089 .PP
|
|
10090 .B Проиграть только эпизоды 5, 6, 7:
|
|
10091 .nf
|
|
10092 mplayer dvd://1 \-chapter 5-7
|
|
10093 .fi
|
|
10094 .
|
|
10095 .PP
|
|
10096 .B Проиграть только заголовки 5, 6, 7:
|
|
10097 .nf
|
|
10098 mplayer dvd://5-7
|
|
10099 .fi
|
|
10100 .
|
|
10101 .PP
|
|
10102 .B Проиграть multiangle DVD:
|
|
10103 .nf
|
|
10104 mplayer dvd://1 \-dvdangle 2
|
|
10105 .fi
|
|
10106 .
|
|
10107 .PP
|
|
10108 .B Проиграть с другого DVD устройства:
|
|
10109 .nf
|
|
10110 mplayer dvd://1 \-dvd-device /dev/\:dvd2
|
|
10111 .fi
|
|
10112 .
|
|
10113 .PP
|
|
10114 .B Проиграть DVD видео из папки, содержащей VOB файлы:
|
|
10115 .nf
|
|
10116 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/
|
|
10117 .fi
|
|
10118 .
|
|
10119 .PP
|
|
10120 .B Копировать DVD заголовок на жесткий диск, сохраняя в файл "title1.vob":
|
|
10121 .nf
|
|
10122 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
|
|
10123 .fi
|
|
10124 .
|
|
10125 .PP
|
|
10126 .B Поток по HTTP:
|
|
10127 .nf
|
|
10128 mplayer http://mplayer.hq/example.avi
|
|
10129 .fi
|
|
10130 .
|
|
10131 .PP
|
|
10132 .B Поток, используя RTSP:
|
|
10133 .nf
|
|
10134 mplayer rtsp://server.example.com/streamName
|
|
10135 .fi
|
|
10136 .
|
|
10137 .PP
|
|
10138 .B Преобразовать субтитры в формат MPsub:
|
|
10139 .nf
|
|
10140 mplayer dummy.avi \-sub source.sub \-dumpmpsub
|
|
10141 .fi
|
|
10142 .
|
|
10143 .PP
|
|
10144 .B Преобразовать субтитры в формат MPsub без просмотра фильма:
|
|
10145 .nf
|
|
10146 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub
|
|
10147 .fi
|
|
10148 .
|
|
10149 .PP
|
|
10150 .B со входа стандартного V4L:
|
|
10151 .nf
|
|
10152 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv
|
|
10153 .fi
|
|
10154 .
|
|
10155 .PP
|
|
10156 .B Проигрывание на картах Zoran (старый способ, устарел):
|
|
10157 .nf
|
|
10158 mplayer \-vo zr \-vf scale=352:288 file.avi
|
|
10159 .fi
|
|
10160 .
|
|
10161 .PP
|
|
10162 .B Проигрывание на картах Zoran (новый способ):
|
|
10163 .nf
|
|
10164 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
|
|
10165 .fi
|
|
10166 .
|
|
10167 .PP
|
|
10168 .B Проиграть 6-ти канальный AAC файл на двух колонках:
|
|
10169 .nf
|
|
10170 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
|
|
10171 .fi
|
|
10172 .br
|
|
10173 .\" FIXME correct translation?
|
|
10174 You might want to play a bit with the pan values (e.g multiply with a value) to
|
|
10175 increase volume or avoid clipping.
|
|
10176 .
|
|
10177 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MENCODER
|
|
10178 .
|
|
10179 .PP
|
|
10180 .B Кодировать DVD заголовок #2, только указанные эпизоды:
|
|
10181 .nf
|
|
10182 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
|
|
10183 .fi
|
|
10184 .
|
|
10185 .PP
|
|
10186 .B Кодировать DVD заголовок #2, масштабируя до 640x480:
|
|
10187 .nf
|
|
10188 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
|
|
10189 .fi
|
|
10190 .
|
|
10191 .PP
|
|
10192 .B кодировать DVD заголовок #2, масштабируя до 512xHHH (сохраняя пропорции):
|
|
10193 .nf
|
|
10194 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
|
|
10195 .fi
|
|
10196 .
|
|
10197 .PP
|
|
10198 .B То же, но с битрейтом установленным в 1800kbit и оптимизированными макроблоками:
|
|
10199 .nf
|
|
10200 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
|
|
10201 .fi
|
|
10202 .
|
|
10203 .PP
|
|
10204 .B То же, но с MJPEG сжатием:
|
|
10205 .nf
|
|
10206 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800
|
|
10207 .fi
|
|
10208 .
|
|
10209 .PP
|
|
10210 .B Кодировать все *.jpg файлы в текущем каталоге:
|
|
10211 .nf
|
|
10212 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4
|
|
10213 .fi
|
|
10214 .
|
|
10215 .PP
|
|
10216 .B Кодировать с тюнера (указывайте формат при помощи \-vf формат):
|
|
10217 .nf
|
|
10218 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
|
|
10219 .fi
|
|
10220 .
|
|
10221 .PP
|
|
10222 .B Кодировать из канала (pipe):
|
|
10223 .nf
|
|
10224 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \-
|
|
10225 .fi
|
|
10226 .
|
|
10227 .
|
|
10228 .\" --------------------------------------------------------------------------
|
|
10229 .\" Ошибки, авторы, стандартное уведомление
|
|
10230 .\" --------------------------------------------------------------------------
|
|
10231 .
|
|
10232 .SH ОШИБКИ
|
|
10233 Не паникуйте.
|
|
10234 Если вы нашли их, сообщите об этом нам, но предварительно убедитесь, что прочли всю документацию.
|
|
10235 Также ображайте внимание на смайлики. :)
|
|
10236 Многие ошибки - результат некорректной настройки программы и использования параметров.
|
|
10237 Раздел документации, посвященный отправке сообщений об ошибках
|
|
10238 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:bugreports.html)
|
|
10239 описывает как создать полезный отчет.
|
|
10240 .
|
|
10241 .
|
|
10242 .
|
|
10243 .SH АВТОРЫ
|
|
10244 .\" FIXME contributor!=разработчик
|
|
10245 MPlayer изначально был написан Arpad Gereoffy.
|
|
10246 Смотрите файл AUTHORS, чтобы получить список некоторых из множества других разработчиков.
|
|
10247 .PP
|
|
10248 MPlayer is (C) 2000\-2006 The MPlayer Team
|
|
10249 .PP
|
|
10250 Оригинальная английская версия этого руководства в основном была написана Gabucino,
|
|
10251 Jonas Jermann и Diego Biurrun. Сейчас она поддерживается Diego Biurrun.
|
|
10252 Первоначальный перевод осуществлен Владимиром Ворошиловым.
|
|
10253 Пожалуйста, отсылайте электронные письма об оригинальной странице в список рассылки MPlayer-DOCS.
|
|
10254 Письма, относящиеся к переводу, отсылайте в MPlayer-translations.
|
|
10255 .\" end of file
|