Mercurial > mplayer.hg
annotate DOCS/man/ru/mplayer.1 @ 20913:ced37d884c05
r20900: Missing : in -vf expand ar example
author | voroshil |
---|---|
date | Tue, 14 Nov 2006 18:38:36 +0000 |
parents | ae265b1dbecd |
children | 5e7183c4d01c |
rev | line source |
---|---|
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 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
5 .\" synced with r20876 |
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'ом (смотри ниже). | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
179 Он кодирует в MPEG-4 (DivX/Xvid), любой из libavcodec кодеков и |
20707 | 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) | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
1154 Сохранает сырой сжатый аудио поток в ./stream.dump (полезно с MPEG/\:AC3, |
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
1155 в большинстве остальных случаев полученный файл проигрываться не будет). |
20707 | 1156 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, |
1157 \-dumpstream, будет использоваться только последняя. | |
1158 . | |
1159 .TP | |
1160 .B \-dumpfile <файл> (только MPlayer) | |
1161 Указывает в какой файл должно происходить сохранение. | |
1162 Следует использовать вместе с \-dumpaudio / \-dumpvideo / \-dumpstream. | |
1163 . | |
1164 .TP | |
1165 .B \-dumpstream (только MPlayer) | |
1166 Сохраняет сырой поток в ./stream.dump. | |
1167 Полезно при рипе с DVD или сети. | |
1168 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1169 \-dumpstream, будет использоваться только последняя. | |
1170 . | |
1171 .TP | |
1172 .B \-dumpvideo (только MPlayer) | |
1173 Сохраняет сырой сжатый видео поток в ./stream.dump (не очень пригодно). | |
1174 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1175 \-dumpstream, будет использоваться только последняя. | |
1176 . | |
1177 .TP | |
1178 .B \-dvbin <options> (только DVB) | |
1179 Передает следующие параметры модулю DVB, для переопределения стандартных: | |
1180 .sp 1 | |
1181 .PD 0 | |
1182 .RSs | |
1183 .IPs card=<1\-4> | |
1184 Указывает номер используемой карты 1\-4 (default: 1). | |
1185 .IPs file=<файл> | |
1186 Указывает MPlayer читать список каналов из файла <файл>. | |
1187 По-умолчанию: ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (в зависимости от типа карты) | |
1188 или ~/.mplayer/\:channels.conf. | |
1189 .IPs timeout=<1\-30> | |
1190 Максимальное количество секунд ожидания настройки на частоту перед началом воспроизведения | |
1191 (по-умолчанию: 30). | |
1192 .RE | |
1193 .PD 1 | |
1194 . | |
1195 .TP | |
1196 .B \-dvd-device <путь к устройству> (только DVD) | |
1197 Указывает устройство DVD (по-умолчанию: /dev/\:dvd). | |
1198 Вы также можете указать каталог, содержащий файлы, предварительно скопированные | |
1199 непосредственно с DVD (например, с помощью vobcopy). | |
1200 Заметьте, что для копирования роликов DVD, как правило, лучше использовать \-dumpstream | |
1201 (смотрите примеры). | |
1202 . | |
1203 .TP | |
1204 .B \-dvdangle <ID угла> (только DVD) | |
1205 Некоторые DVD диски содержат сцены, которые можно смотреть с разных углов. | |
1206 Здесь вы можете указать MPlayer какой угол использовать (по-умолчанию: 1). | |
1207 . | |
1208 .TP | |
1209 .B \-edl <файл> | |
1210 Задействует действия списка решений редактирования (EDL) при воспроизведении. | |
1211 Видео будет пропущено или звук будет включен/\:выключен в соответствии с | |
1212 записями в указанном файле. | |
1213 Смотрите http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:edl.html для подробностей об | |
1214 использовании этих файлов. | |
1215 . | |
1216 .TP | |
1217 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (смотрите также \-ss и \-sb) | |
1218 Останавливает воспроизведение в указанное время или байтовой позиции. | |
1219 .br | |
1220 .I ЗАМЕЧАНИЕ: | |
1221 Бйтовая позиция задействуется только для MEncoder и будет не очень точной, поскольку | |
1222 остановка возможна только на границе кадра. | |
1223 При использовании совместно с опцией \-ss, время \-endpos будет сдвинуто вперед на | |
1224 указанное с помощью \-ss количество секунд. | |
1225 .sp 1 | |
1226 .I ПРИМЕР: | |
1227 .PD 0 | |
1228 .RSs | |
1229 .IPs "\-endpos 56" | |
1230 Остановиться на 56 секунде. | |
1231 .IPs "\-endpos 01:10:00" | |
1232 Остановиться через 1 час 10 минут. | |
1233 .IPs "\-ss 10 \-endpos 56" | |
1234 Остановиться на позиции 1 минута 6 секунд. | |
1235 .IPs "\-endpos 100mb" | |
1236 Кодировать только 100 Мб. | |
1237 .RE | |
1238 .PD 1 | |
1239 . | |
1240 .TP | |
1241 .B \-forceidx | |
1242 Принудительно перестраивает индекс. | |
1243 Полезно для файлов с испорченным индексом (A/V рассинхронизация, и т.п.). | |
1244 Это позволит перемещаться по файлу, в которм перемещение было невозможно. | |
1245 Вы можете исправить индекс в самом файле при помощи MEncoder (смотрите документацию). | |
1246 .br | |
1247 .I ЗАМЕЧАНИЕ: | |
1248 Опция работает, только если лежащее в основе медиа позволяет перемещение | |
1249 (т.е.\& не с stdin, pipe, т.д.). | |
1250 . | |
1251 .TP | |
1252 .B \-fps <вещественное значение> | |
1253 Переопределяет частоту кадров. | |
1254 Полезно, если оригинальное значение неверно или отсутствует. | |
1255 . | |
1256 .TP | |
1257 .B \-frames <число> | |
1258 Воспроизводит/\:конвертирует только первое <число> кадров, затем выходит. | |
1259 . | |
1260 .TP | |
1261 .B \-hr-mp3-seek (только MP3) | |
1262 Точное перемещение по MP3. | |
1263 Включается при воспроизведении из внешнего MP3 файла, как только требуется очень точное | |
1264 перемещение к позиции для сохранения A/V синхронизации.. | |
1265 Может быть медленным, особенно при перемещении назад, поскольку необходимо | |
1266 переместиться к началу для поиска точной позиции кадра. | |
1267 . | |
1268 .TP | |
1269 .B \-idx (смотрите также \-forceidx) | |
1270 Перестраивает индекс файла, если таковой не был найден, позволяя осуществлять перемещение. | |
1271 Полезно с испорченными/\:неполностью скачанными или неверно созданными файлами. | |
1272 .br | |
1273 .I ЗАМЕЧАНИЕ: | |
1274 Опция работает только если лежащее в основе медиа позволяет перемещение | |
1275 (т.е.\& не с stdin, pipe, т.д.). | |
1276 . | |
1277 .TP | |
1278 .B \-ipv4-only-proxy (только сеть) | |
1279 Указывает не использовать прокси для IPv6 адресов. | |
1280 Он по-прежнему будет использоваться для IPv4 соединений. | |
1281 . | |
1282 .TP | |
1283 .B \-loadidx <индексный файл> | |
1284 Файл из которого следует читать данные индекса видео, сохраненные \-saveidx. | |
1285 Этот индекс будет использоваться для перемещения, переопределяя любые | |
1286 индексные данные, содержащиеся в самом AVI. | |
1287 MPlayer не запрещает загрузку индексного файла, созданного по другому AVI фильму, но | |
1288 это обязательно приведет к неприятным результатам. | |
1289 .br | |
1290 .I ЗАМЕЧАНИЕ: | |
1291 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML. | |
1292 . | |
1293 .TP | |
1294 .B \-mc <секунд/кадр> | |
1295 Максимальная величина корректировки A-V синхронизации на один кадр (в секундах) | |
1296 . | |
1297 .TP | |
1298 .B \-mf <опция1:опция2:...> | |
1299 Используется при кодировании из нескольких PNG или JPEG файлов. | |
1300 .sp 1 | |
1301 Доступные опции: | |
1302 .sp 1 | |
1303 .PD 0 | |
1304 .RSs | |
1305 .IPs w=<значение> | |
1306 ширина входного файла (по-умолчанию: автоопределение) | |
1307 .IPs h=<значение> | |
1308 высота входного файла (по-умолчанию: автоопределение) | |
1309 .IPs fps=<значение> | |
1310 fps результата (по-умолчанию: 25) | |
1311 .IPs type=<значение> | |
1312 тип входного файла (доступны: jpeg, png, tga, sgi) | |
1313 .RE | |
1314 .PD 1 | |
1315 . | |
1316 .TP | |
1317 .B \-ni (только AVI) | |
1318 Принуждает использовать обработчик нечередующегося AVI | |
1319 (исправляет воспроизведение некоторых плохих AVI файлов). | |
1320 . | |
1321 .TP | |
1322 .B \-nobps (только AVI) | |
1323 Указывает не использовать среднее значение байт/\:секунду для | |
1324 A-V синхронизации. Помогает для некоторых AVI файлов с испорченным заголовком. | |
1325 . | |
1326 .TP | |
1327 .B \-noextbased | |
1328 Отключает выбор демуксера на основе расширения файла. | |
1329 По-умолчанию, когда тип файла (демуксер) не может быть достоверно определен | |
1330 (файл не имеет заголовка, или он недостаточно достоверен), для выбора | |
1331 демуксера будет использовано расширение файла. | |
1332 Опция указывает всегда использовать содержимое файла для определения демуксера. | |
1333 . | |
1334 .TP | |
1335 .B \-passwd <пароль> (смотрите также see \-user) (только сеть) | |
1336 Указывает пароль для HTTP аутентификации. | |
1337 . | |
1338 .TP | |
1339 .B \-prefer-ipv4 (только сеть) | |
1340 Использует IPv4 для сетевых соединений. | |
1341 При необходимости автоматически используется IPv6. | |
1342 . | |
1343 .TP | |
1344 .B \-prefer-ipv6 (только IPv6 сеть) | |
1345 Использует IPv6 для сетевых соединений. | |
1346 При необходимости автоматически используется IPv4. | |
1347 . | |
1348 .TP | |
1349 .B \-pvr <опция1:опция2:...> (только PVR) | |
1350 Эта опция настраивает различные свойства кодирования модуля PVR. | |
1351 Она должна использоваться с любой картой на основе аппаратного MPEG | |
1352 кодера, совместимого с драйвером V4L2. | |
1353 Hauppauge WinTV PVR\-150/250/350/500 и все карты, основанные на IVTV, | |
1354 известны как PVR карты захвата. Знайте, что только ядра Linux старше 2.6.18 | |
1355 способны обрабатывать MPEG поток через слой V4L2. | |
1356 Для аппаратного захвата MPEG потока и его просмотра с MPlayer/MEncoder, | |
1357 используйте 'pvr://' в качестве URL фильма. | |
1358 .sp 1 | |
1359 Доступные опции: | |
1360 .RSs | |
1361 .IPs aspect=<0\-3> | |
1362 Указывает входные пропорции: | |
1363 .RSss | |
1364 0: 1:1 | |
1365 .br | |
1366 1: 4:3 (по-умолчанию) | |
1367 .br | |
1368 2: 16:9 | |
1369 .br | |
1370 3: 2.21:1 | |
1371 .REss | |
1372 .IPs arate=<32000\-48000> | |
1373 Указывает частоту дискретизации звука (по-умолчанию: 48000 Гц, доступны: 32000, 44100 | |
1374 и 48000 Гц). | |
1375 .IPs alayer=<1\-3> | |
1376 Указывает слой кодирования MPEG[MPEG layer](по-умолчанию: 2). | |
1377 .IPs abitrate=<32\-448> | |
1378 Указывает битпоток кодируемого звука в кбит/с (по-умолчанию: 384). | |
1379 .IPs amode=<значение> | |
1380 Указывает режим кодирования звука. | |
1381 Доступны следующие предустановки: 'stereo', 'joint_stereo', 'dual' | |
1382 и 'mono' (по-умолчанию: stereo). | |
1383 .IPs vbitrate=<значение> | |
1384 Указывает среднее значение битпотока кодируемого видео в Мбит/с (по-умолчанию: 6). | |
1385 .IPs vmode=<значение> | |
1386 Указывает режим кодирования видео: | |
1387 .RSss | |
1388 vbr: Переменный битпоток (по-умолчанию) | |
1389 .br | |
1390 cbr: Постоянный битпоток | |
1391 .REss | |
1392 .IPs vpeak=<значение> | |
1393 Указывает пиковое значение битпотока кодируемого видео в Мбит/с | |
1394 (имеет смысл только для VBR кодирования, по-умолчанию: 6.6). | |
1395 .IPs fmt=<value> | |
1396 Выбирает MPEG формат для кодирования: | |
1397 .RSss | |
1398 ps: MPEG-2 Программный поток (по-умолчанию) | |
1399 .br | |
1400 ts: MPEG-2 Транспортный поток | |
1401 .br | |
1402 mpeg1: MPEG-1 системный поток | |
1403 .br | |
1404 vcd: Video CD совместимый поток | |
1405 .br | |
1406 svcd: Super Video CD совместимый | |
1407 .br | |
1408 dvd: DVD совместимый | |
1409 .REss | |
1410 .RE | |
1411 .PD 1 | |
1412 . | |
1413 .TP | |
1414 .B \-radio <опция1:опция2:...> (только радио) | |
1415 Эта опция устанавливает различные параметры модуля захвата с радио. | |
1416 Для прослушивания радио с MPlayer используйте 'radio://<частота>' | |
1417 (если не указана опция channels) или 'radio://<номер канала>' | |
1418 (если опция channels указана) в качестве URL. | |
20768 | 1419 Вы можете увидеть допустимый диапазон частот, запустив MPlayer |
1420 с опцией '\-v'. | |
20707 | 1421 Для запуска подсистемы захвата, |
1422 используйте 'radio://<частота или канал>/capture'. | |
1423 Если не указано ключевое слово capture, вы можете слушать радио только | |
1424 при помоши line-in кабеля. Использование capture для прослушивания не | |
1425 рекомендуется в связи с проблемами синхронизации, которые | |
1426 делают прослушивание некомфортным. | |
1427 .sp 1 | |
1428 Доступные опции: | |
1429 .RSs | |
1430 .IPs device=<значение> | |
1431 Уиспользуемое устройство радио (по-умолчанию: /dev/radio0). | |
1432 .IPs driver=<значение> | |
1433 Используемый радио драйвер (пл-умолчанию: v4l2 если доступно, иначе v4l). | |
1434 В данный момент поддерживаются драйверы v4l и v4l2. | |
1435 .IPs volume=<0..100> | |
1436 Уровень звука для радио (по-умолчанию: 100) | |
1437 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,... | |
1438 Устанавливает список каналов. | |
1439 Используйте _ вместо пробелов в именах (или играйтесь с экранированием ;-). | |
1440 Имена каналов будут выводиться при помощи OSD, и для управления с пульта | |
1441 будут доступны команды radio_step_channel и radio_set_channel (смотрите LIRC). | |
1442 Если эта опция указана, то число в URL будет означать позицию канала в списке. | |
1443 .br | |
1444 .I ПРИМЕР: | |
1445 radio://1, radio://104.4, radio_set_channel 1 | |
1446 .IPs adevice=<значение> (с включенной поддержкой захвата с радио) | |
1447 Название устройства, с которого будет производиться захват. | |
1448 Без его указания захват будет отключен, даже если в URL указано слово capture. | |
1449 Для ALSA устройств указывайте его в виде hw=<карта>.<устройство>. | |
1450 Если название устройства содержит '=', то для захвата модуль будет | |
1451 использовать ALSA, иначе OSS. | |
1452 .IPs arate=<значение> (с включенной поддержкой захвата с радио) | |
1453 Частота в сэмплах в секунду (по-умолчанию: 44100). | |
1454 .br | |
1455 .I ЗАМЕЧАНИЕ: | |
1456 При использовании захвата звука, установите также опцию | |
1457 \-rawaudio rate=<значение> с таким же значением, как у arate. | |
1458 Если у вас проблемы со скоростью звука (слишком быстрый), попробуйте | |
1459 поиграть с разными значениями arate (например, 48000,44100,32000,...). | |
1460 .IPs achannels=<значение> (с включенной поддержкой захвата с радио) | |
1461 Количество аудио каналов для захвата. | |
1462 .RE | |
1463 . | |
1464 .TP | |
1465 .B \-rawaudio <опция1:опция2:...> | |
1466 Эта опция позполяет проигрывать сырые аудио файлы. | |
1467 Вам придется также указать \-demuxer rawaudio. | |
1468 Ее еще можно использовать для воспроизведения аудио CD, отличных от 44кГц 16-бит стерео. | |
1469 Для воспроизведения сырых AC3 потоков используйте \-rawaudio format=0x2000 \-demuxer rawaudio. | |
1470 .sp 1 | |
1471 Доступные опции: | |
1472 .sp 1 | |
1473 .PD 0 | |
1474 .RSs | |
1475 .IPs channels=<значение> | |
1476 количество каналов | |
1477 .IPs rate=<значение> | |
1478 частота в сэмплах в секунду | |
1479 .IPs samplesize=<значение> | |
1480 размер сэмпла в байтах | |
1481 .IPs bitrate=<значение> | |
1482 битпоток для rawaudio файлов | |
1483 .IPs format=<значение> | |
1484 fourcc в шестнадцатеричном формате | |
1485 .RE | |
1486 .PD 1 | |
1487 . | |
1488 .TP | |
1489 .B \-rawvideo <опция1:опция2:...> | |
1490 Эта опция позволяет воспроизводить сырые видео файлы. | |
1491 Вам придется также указать \-demuxer rawaudio. | |
1492 .sp 1 | |
1493 Доступные опции: | |
1494 .sp 1 | |
1495 .PD 0 | |
1496 .RSs | |
1497 .IPs fps=<значение> | |
1498 частота в кадрах в секунду (по-умолчанию: 25.0) | |
1499 .IPs sqcif|qcif|cif|4cif|pal|ntsc | |
1500 устанавливает стандартный размер изображения | |
1501 .IPs w=<значение> | |
1502 ширина изоражения в пикселах | |
1503 .IPs h=<value> | |
1504 высота изображения в пикселах | |
1505 .IPs i420|yv12|yuy2|y8 | |
1506 устанавливает пространство цветов | |
1507 .IPs format=<значение> | |
1508 цветовое пространство (fourcc) в шестнадцатеричном формате | |
1509 .IPs size=<значение> | |
1510 размер кадра в байтах | |
1511 .REss | |
1512 .sp 1 | |
1513 .RS | |
1514 .I ПРИМЕР: | |
1515 .RE | |
1516 .PD 0 | |
1517 .RSs | |
1518 .IPs "mplayer foreman.qcif \-demuxer rawvideo -rawvideo qcif" | |
1519 Проигрывает известный фильм "foreman". | |
1520 .IPs "mplayer sample-720x576.yuv \-demuxer rawvideo \-rawvideo w=720:h=576" | |
1521 Проигрывает сырой YUV фильм. | |
1522 .RE | |
1523 .PD 1 | |
1524 . | |
1525 .TP | |
1526 .B \-rtsp-port | |
1527 Используется с 'rtsp://' URL для назначения номера порта на клиенте. | |
1528 Опция может быть полезна, если вы находитесь за маршрутизатором и хотите | |
1529 направлять RTSP поток с сервера определенному клиенту. | |
1530 . | |
1531 .TP | |
1532 .B \-rtsp-destination | |
1533 Используется с rtsp://' URL для привязки к указанному IP адресу назначения. | |
1534 Опция может быть полезна с некоторыми RTSP серверами, не отправляющими | |
1535 RTP пакеты на нужный интерфейс. Если невозможно установить соединение | |
1536 с RTSP сервером, используйте опцию \-v, чтобы определить, | |
1537 к какому IP адресу пытается привязаться MPlayer, и попытайтесь назначить | |
1538 вместо него один из назначенных вашему компьютеру. | |
1539 . | |
1540 .TP | |
1541 .B \-rtsp-stream-over-tcp (только LIVE555) | |
1542 Используется с'rtsp://' URL для указания, что в результате входящие RTP и RTCP | |
1543 пакеты должны передаваться по TCP (используя то же TCP соединение, что и RTSP). | |
1544 Опция может быть полезна, если у вас сбоящее интернет соединение, | |
1545 не пропускающее входящие UDP пакеты (смотрите http://www.live555.com/\:mplayer/). | |
1546 . | |
1547 .TP | |
1548 .B \-saveidx <файл> | |
1549 Принудительно перестраивает индекс и сохраняет его в <файл>. | |
1550 В данный момент это работает только с AVI файлами. | |
1551 .br | |
1552 .I ЗАМЕЧАНИЕ: | |
1553 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML. | |
1554 . | |
1555 .TP | |
1556 .B \-sb <байтовая позиция> (смотрите также \-ss) | |
1557 Перемещается к байтовой позиции. | |
1558 Полезно для воспроизведения с образов CD-ROM или VOB файлов с мусором в начале. | |
1559 . | |
1560 .TP | |
1561 .B \-speed <0.01\-100> | |
1562 Уменьшает или увеличивает скорость воспроизведения в указанное количество раз. | |
1563 Не гарантируется правильная работа с \-oac copy. | |
1564 . | |
1565 .TP | |
1566 .B \-srate <Гц> | |
1567 Выбирает используемую выходную частоту семплов | |
1568 (конечно, звуковые карты имеют на нее ограничения). | |
1569 Если выбранная частота сэмплов отличается от текущего медиа, то для компенсации | |
1570 различий в слой звуковых фильтров будет автоматически добавлен звуковой | |
1571 фильтр resample или lavcresample. | |
1572 Тип ресэмплирования может быть указан опцией \-af-adv. | |
1573 По-цмолчанию, используется быстрое преобразование, что может | |
1574 привести к искажениям. | |
1575 . | |
1576 .TP | |
1577 .B \-ss <time> (also see \-sb) | |
1578 Перемещение в указаную временную позицию. | |
1579 .sp 1 | |
1580 .I ПРИМЕР: | |
1581 .PD 0 | |
1582 .RSs | |
1583 .IPs "\-ss 56" | |
1584 Перемещается к позиции 56 секунд. | |
1585 .IPs "\-ss 01:10:00" | |
1586 Перемещается в позицию 1 час 10 мин. | |
1587 .RE | |
1588 .PD 1 | |
1589 . | |
1590 .TP | |
1591 .B \-tskeepbroken | |
1592 Указывает MPlayer не отбрасывать TS пакеты в потоке, определенные как испорченные. | |
1593 Иногда требуется для воспроизведения испорченных MPEG-TS файлов. | |
1594 . | |
1595 .TP | |
1596 .B \-tsprobe <байтовая позиция> | |
1597 При воспроизведении MPEG-TS потока, эта опция позволяет указать, в пределах какого | |
1598 количества байт в потоке MPlayer должен искать желаемые аудио и видео ID. | |
1599 . | |
1600 .TP | |
1601 .B \-tsprog <1\-65534> | |
1602 При воспроизведении MPEG-TS потока, этой опцией можно указать какую | |
1603 программу (если присутствует) вы хотите воспроизвести. | |
1604 Может использоваться с \-vid и \-aid. | |
1605 . | |
1606 .TP | |
1607 .B \-tv <опция1:опция2:...> (только TV/\:PVR) | |
1608 Эта опция настраивает различные свойства модуля TV захвата. | |
1609 Для просмотра TV с MPlayer, используйте 'tv://' или 'tv://<номер_канала>' | |
1610 или даже 'tv://<название_канала> (смотрите ниже опцию channels для подробностей о | |
1611 параметре название_канала) в качестве URL. | |
1612 .sp 1 | |
1613 Доступные опции: | |
1614 .RSs | |
1615 .IPs noaudio | |
1616 без звука | |
1617 .IPs driver=<значение> | |
1618 доступны: dummy, v4l, v4l2, bsdbt848 | |
1619 .IPs device=<значение> | |
1620 Указывает устройство TV (по-умолчанию: /dev/\:video0). | |
1621 .IPs input=<значение> | |
1622 Указывает источник (по-умолчанию: 0 (TV), смотрите консольный вывод для определения доступных | |
1623 источников). | |
1624 .IPs freq=<значение> | |
1625 Указывает частоту, на которую необходимо настроиться (например 511.250). | |
1626 Не совместимо с параметром channels. | |
1627 .IPs outfmt=<значение> | |
1628 Устанавливает формат вывода с тюнера в одно из предустановленных значений, | |
1629 поддерживаемых драйвером V4L (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) или в | |
1630 произвольный формат, заданный шестнадцатеричным значением. | |
1631 Попробуйте outfmt=help, чтобы получить список доступных форматов. | |
1632 .IPs width=<значение> | |
1633 Ширина окна вывода | |
1634 .IPs height=<значение> | |
1635 Высота окна вывода | |
1636 .IPs fps=<значение> | |
1637 Частота кодров с которой захватывается видео (кадров в секунду) | |
1638 .IPs buffersize=<значение> | |
1639 Максимальный размер буфера захвата в мегабайтах (по-умолчанию: динамический) | |
1640 .IPs norm=<значение> | |
1641 Для bsdbt848 и v4l доступны PAL, SECAM, NTSC. | |
1642 Для v4l2 смотрите консольный вывод для получения списка доступных стандартов. | |
1643 можете также посмотреть опицю normid ниже. | |
1644 .IPs "normid=<значение> (только v4l2)" | |
1645 Устанавливает TV стандарт в указанное числовое ID. | |
1646 TV стандарт зависит от карты захвата. | |
1647 Смотрите консольный вывод для получения списка доступных TV стандартов. | |
1648 .IPs channel=<значение> | |
1649 Переключает тюнер на <значение> канал. | |
1650 .IPs chanlist=<значение> | |
1651 Доступны: europe-east, europe-west, us-bcast, us-cable, другие | |
1652 .IPs channels=<канал>\-<название>,<канал>\-<название>,... | |
1653 Устанавливает названия для каналов. | |
1654 Используйте _ вместо пробелов в названиях (или поиграйте с экранированием ;-). | |
1655 Названия каналов будут выводиться при помощи OSD, и станут доступными | |
1656 команды tv_step_channel, tv_set_channel и tv_last_channel, полезные для | |
1657 управления с пульта (смотрите LIRC). | |
1658 Не совместима с параметром frequency. | |
1659 .br | |
1660 .I ЗАМЕЧАНИЕ: | |
1661 После этого номер канала будет являться позицией в списке 'channels', | |
1662 начиная с 1. | |
1663 .br | |
1664 .I ПРИМЕР: | |
1665 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1 | |
1666 .IPs [brightness|contrast|hue|saturation]=<-100\-100> | |
1667 Устанавливает эквалайзер изображения на карте. | |
1668 .IPs audiorate=<значение> | |
1669 Устанавливает аудио битпоток. | |
1670 .IPs forceaudio | |
1671 Указывает захватывать звук даже если v4l сообщает, что нет источников звука. | |
1672 .IPs "alsa\ " | |
1673 Захват через ALSA. | |
1674 .IPs amode=<0\-3> | |
1675 Выбирает аудио режим: | |
1676 .RSss | |
1677 0: моно | |
1678 .br | |
1679 1: стерео | |
1680 .br | |
1681 2: язык 1 | |
1682 .br | |
1683 3: язык 2 | |
1684 .REss | |
1685 .IPs forcechan=<1\-2> | |
1686 По-умолчанию, количество записываемых аудио каналов определяется автоматически, | |
1687 запрашивая режим аудио у TV карты. | |
1688 Эта опция позволяет принудительно назначить стерео/\:моно запись независимо | |
1689 от опции amode и значений, возвращаемых v4l. | |
1690 Это может быть использовано для решения проблем, в случае когда TV карта не | |
1691 способна указать текущий аудио режим. | |
1692 .IPs adevice=<значение> | |
1693 Устанавливает аудио устройство. | |
1694 <значение> должно быть /dev/\:xxx для OSS и аппаратный ID для ALSA. | |
1695 Вы должны заменить любые ':' на '.' в ID для ALSA. | |
1696 .IPs audioid=<значение> | |
1697 Выбирает выход звука карты захвата, если их более одного. | |
1698 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)" | |
1699 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)" | |
1700 Эти опции устанавливают параметры микшера на карте видео захвата. | |
1701 Они не имеют эффекта, если на карте такового нет. | |
1702 Для v4l2, 50 означает элемент управления по-умолчанию, как указано | |
1703 драйвером. | |
1704 .IPs immediatemode=<логическое> | |
1705 Значение 0 означает совместный захват и буферизацию звука и видео | |
1706 (по-умолчанию для MEncoder). | |
1707 Значение 1 (по-умолчанию для MPlayer) означает захват только видео и прохождение | |
1708 звука через кабель от TV карты к звуковой. | |
1709 .IPs mjpeg | |
1710 Используется аппаратное MJPEG сжатие (если карта его поддерживает). | |
1711 При использовании этой опции, вам не требуется указывать ширину и высоту | |
1712 окна вывода, потому что MPlayer определит их автоматически по | |
1713 значению decimation (смотрите ниже). | |
1714 .IPs decimation=<1|2|4> | |
1715 выбирает размер картинки, сжимаемой аппаратным MJPEG кодером: | |
1716 .RSss | |
1717 1: full size | |
1718 704x576 PAL | |
1719 704x480 NTSC | |
1720 .br | |
1721 2: medium size | |
1722 352x288 PAL | |
1723 352x240 NTSC | |
1724 .br | |
1725 4: small size | |
1726 176x144 PAL | |
1727 176x120 NTSC | |
1728 .REss | |
1729 .IPs quality=<0\-100> | |
1730 Выбирает качество JPEG сжатия | |
1731 (для полного размера рекомендуется < 60). | |
1732 .RE | |
1733 . | |
1734 .TP | |
1735 .B \-user <имя пользователя> (смотрите также \-passwd) (только сеть) | |
1736 Указывает имя пользователя для HTTP аутентификации. | |
1737 . | |
1738 .TP | |
1739 .B \-user-agent <строка> | |
1740 Используется <строка> в качестве значения user agent для потоков HTTP. | |
1741 . | |
1742 .TP | |
1743 .B \-vid <ID> | |
1744 Выбирает видео канал (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190). | |
1745 При воспроизведении потока MPEG-TS, MPlayer/\:MEncoder будет использовать | |
1746 первую программу (если присутствует) с указанным видео потоком. | |
1747 . | |
1748 .TP | |
1749 .B \-vivo <под-опции> (КОД ОТЛАДКИ) | |
1750 Принудительно устанавливает параметры звука для VIVO демуксера (для отладочных целей). | |
1751 . | |
1752 . | |
1753 . | |
1754 .SH "ОПЦИИ OSD/СУБТИТРОВ" | |
1755 .I ЗАМЕЧАНИЕ: | |
1756 Смотрите также \-vf expand. | |
1757 . | |
1758 .TP | |
1759 .B \-ass (только FreeType) | |
1760 Включает SSA/ASS рендеринг субтиров. | |
1761 С этой опцией для внешних субтитров SSA/ASS и дорожек Matroska будет использоваться | |
1762 libass. Смотрите также \-embeddedfonts. | |
1763 . | |
1764 .TP | |
1765 .B \-ass-border-color <значение> | |
1766 Устанавливает цвет границы (обрамления) для текста субтитров. | |
1767 Формат цвета: RRGGBBAA. | |
1768 . | |
1769 .TP | |
1770 .B \-ass-bottom-margin <значение> | |
1771 Добавляет черную полосу в нижней части кадра. | |
1772 Рендерер SSA/ASS может поместить туда субтитры (с \-ass-use-margins). | |
1773 . | |
1774 .TP | |
1775 .B \-ass-color <значение> | |
1776 Устанавливает цвет текста субтитров. | |
1777 Формат цвета: RRGGBBAA. | |
1778 . | |
1779 .TP | |
1780 .B \-ass-font-scale <значение> | |
1781 Устанавливает коэффициент масштабирования, используемый в рендерере SSA/ASS. | |
1782 . | |
1783 .TP | |
1784 .B \-ass-force-style <[Стиль.]Параметр=Значение[,...]> | |
1785 Переопределяет некоторые параметры стиля. | |
1786 .sp | |
1787 .I ПРИМЕР: | |
1788 .PD 0 | |
1789 .RSs | |
1790 \-ass-force-style FontName=Arial,Default.Bold=1 | |
1791 .RE | |
1792 .PD 1 | |
1793 . | |
1794 .TP | |
1795 .B \-ass-line-spacing <значение> | |
1796 Устанавливает межстрочный интервал для рендерера SSA/ASS. | |
1797 . | |
1798 .TP | |
1799 .B \-ass-styles <файл> | |
1800 Загружает все SSA/ASS стили, найденные в указанном файле и использует их для | |
1801 рендеринга текста субтитров. Синтаксис файла такой же как в | |
1802 [V4 Styles] / [V4+ Styles] разделах SSA/ASS. | |
1803 . | |
1804 .TP | |
1805 .B \-ass-top-margin <значение> | |
1806 Добавляет черную полосу в верхней части кадра. | |
1807 SSA/ASS рендерер может поместить туда субтитры (с \-ass-use-margins). | |
1808 . | |
1809 .TP | |
1810 .B \-(no)ass-use-margins | |
1811 Включает/выключает расположение субтитров на черных полосах, когда они доступны | |
1812 (по-умолчанию: нет). | |
1813 . | |
1814 .TP | |
1815 .B \-dumpjacosub (только MPlayer) | |
1816 Преобразует субтитры (указанные опцией \-sub) в основанный на времени | |
1817 JACOsub формат. | |
1818 Создает файл dumpsub.js в текущем каталоге. | |
1819 . | |
1820 .TP | |
1821 .B \-dumpmicrodvdsub (только MPlayer) | |
1822 Преобразует субтитры (указанные опцией \-sub) в MicroDVD формат. | |
1823 Создает файл dumpsub.sub в текущем каталоге. | |
1824 . | |
1825 .TP | |
1826 .B \-dumpmpsub (только MPlayer) | |
1827 Преобразует субтитры (указанные опцией \-sub) в MPsub, формат субтитров MPlayer. | |
1828 Создает файл dump.mpsub в текущем каталоге. | |
1829 . | |
1830 .TP | |
1831 .B \-dumpsami (только MPlayer) | |
1832 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат SAMI. | |
1833 Создает файл dumpsub.sm в текущем каталоге. | |
1834 . | |
1835 .TP | |
1836 .B \-dumpsrtsub (только MPlayer) | |
1837 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат | |
1838 SubViewer (SRT). | |
1839 Создает файл dumpsub.srt в текущем каталоге. | |
1840 . | |
1841 .br | |
1842 .I ЗАМЕЧАНИЕ: | |
1843 Некоторые глючные аппаратные проигрыватели давятся SRT субтитрами с концами строк | |
1844 в стиле Unix. Если вам неповезло иметь такой, пропустите файлы субтитров | |
1845 через unix2dos или аналогичную программу для замены символов конца строка на | |
1846 принятые в DOS/Windows. | |
1847 . | |
1848 .TP | |
1849 .B \-dumpsub (только MPlayer) (БЕТА КОД) | |
1850 Сохраняет субпоток субтитров из VOB потоков. | |
1851 Смотрите также опции \-dump*sub и \-vobsubout*. | |
1852 . | |
1853 .TP | |
1854 .B \-embeddedfonts (только FreeType) | |
1855 Задействует извлечение внедренных шрифтов Matroska. | |
1856 Эти шрифты затем могут быть использованы для рендеринга SSA/ASS субтитров | |
1857 (опция \-ass). | |
1858 . | |
1859 .TP | |
1860 .B \-ffactor <число> (только OSD) | |
1861 .\" FIXME Resample the font alphamap. | |
1862 Преобразует альфакарту шрифта. | |
1863 Может быть: | |
1864 .PD 0 | |
1865 .RSs | |
1866 .IPs 0 | |
1867 простые белые шрифты | |
1868 .IPs 0.75 | |
1869 очень тонкое черное обрамление (по-умолчанию) | |
1870 .IPs 1 | |
1871 тонкое черное обрамление | |
1872 .IPs 10 | |
1873 жирное черное обрамление | |
1874 .RE | |
1875 .PD 1 | |
1876 . | |
1877 .TP | |
1878 .B \-flip-hebrew (только FriBiDi) | |
1879 Включает отражение субтитров, используя FriBiDi. | |
1880 . | |
1881 .TP | |
1882 .B \-noflip-hebrew-commas | |
1883 Изменяет предположения FriBiDi о расположении запятых в субтитрах. | |
1884 Используйте ее, если запятые в субтитрах начинаются в начале фраз, | |
1885 вместо их конца. | |
1886 . | |
1887 .TP | |
1888 .B \-font <путь к файлу font.desc> (только OSD) | |
1889 Ищет OSD/\:SUB шрифты в другом каталоге (по-умолчанию для обычных | |
1890 шрифтов: ~/\:.mplayer/\:font/\:font.desc, по-умолчанию для FreeType шрифтов: | |
1891 ~/.mplayer/\:subfont.ttf). | |
1892 .br | |
1893 .I ЗАМЕЧАНИЕ: | |
1894 С FreeType, эта опция определяет путь к файлу шрифта текста. | |
1895 С fontconfig, эта опция определяет название шрифта fontconfig. | |
1896 .sp 1 | |
1897 .I ПРИМЕР: | |
1898 .PD 0 | |
1899 .RSs | |
1900 \-font ~/\:.mplayer/\:arial-14/\:font.desc | |
1901 .br | |
1902 \-font ~/\:.mplayer/\:arialuni.ttf | |
1903 .br | |
1904 \-font 'Bitstream Vera Sans' | |
1905 .RE | |
1906 .PD 1 | |
1907 . | |
1908 .TP | |
1909 .B \-fontconfig (только fontconfig) | |
1910 Задействует использование шрифтов, управляемых fontconfig. | |
1911 . | |
1912 .TP | |
1913 .B \-forcedsubsonly | |
1914 Отображает только форсированные субтитры для потока субтитров DVD, выбранного, | |
1915 например \-slang. | |
1916 . | |
1917 .TP | |
1918 .B \-fribidi-charset <название кодировки> (только FriBiDi) | |
1919 Указывает кодировку, которая будет передана FriBiDi при декодировании | |
1920 не-UTF-8 субтитров (по-умолчанию: ISO8859-8). | |
1921 . | |
1922 .TP | |
1923 .B \-ifo <VOBsub IFO файл> | |
1924 Указывает файл, используемый для загрузки палитры и размера кадра для VOBsub субтитров. | |
1925 . | |
1926 .TP | |
1927 .B \-noautosub | |
1928 Выключает автоматическую загрузку файла субтитров. | |
1929 . | |
1930 .TP | |
1931 .B \-osd-duration <время> | |
1932 Устанавливает длительность отобрадения сообщений OSD в мс (по-умолчанию: 1000). | |
1933 . | |
1934 .TP | |
1935 .B \-osdlevel <0\-3> (только MPlayer) | |
1936 Указывает в каком режиме должен запускаться OSD. | |
1937 .PD 0 | |
1938 .RSs | |
1939 .IPs 0 | |
1940 только субтитры | |
1941 .IPs 1 | |
1942 громкость + позиция (по-умолчанию) | |
1943 .IPs 2 | |
1944 громкость + позиция + время + процент | |
1945 .IPs 3 | |
1946 громкость + пощиция + время + процент + общее время | |
1947 .RE | |
1948 .PD 1 | |
1949 . | |
1950 .TP | |
1951 .B \-overlapsub | |
1952 Позволяет очередным субтитрам быть отображенными, когда текущие еще видимы | |
1953 (по-умолчанию поддержка включается только для определенных форматов). | |
1954 . | |
1955 .TP | |
1956 .B \-sid <ID> (смотрите также \-slang, \-vobsubid) | |
1957 Отображает поток субтитров, указаный по <ID> (0\-31). | |
1958 MPlayer показывает доступные ID субтитров, когда запущен в подробном (\-v) режиме. | |
1959 Если вы не можете выбрать ни один из субтитров на DVD, попробуйте также \-vobsubid. | |
1960 . | |
1961 .TP | |
1962 .B \-slang <код языка[,код языка,...]> (смотрите также \-sid) | |
1963 Указывает языков используемых в субтитрах в порядке приоритетности. | |
1964 Разные форматы файлов работают с разными кодами языков. | |
1965 DVD используют ISO 639-1 двухбуквенные коды, Matroska использует | |
1966 ISO 639-2 трехбуквенные, в то время как OGM использует идентификатор | |
1967 в свободной форме. MPlayer выводит доступные языки при запуске в подробном (\-v) режиме. | |
1968 .sp 1 | |
1969 .I ПРИМЕР: | |
1970 .PD 0 | |
1971 .RSs | |
1972 .IPs "mplayer dvd://1 \-slang hu,en" | |
1973 Выбирает дорожку с Венгерскими субтитрами на DVD, а в случае отсутствия таковой | |
1974 возвращается к использованию Английского. | |
1975 .IPs "mplayer \-slang jpn example.mkv" | |
1976 Воспроизводит файл Matroska с Японскими субтитрами. | |
1977 .RE | |
1978 .PD 1 | |
1979 . | |
1980 .TP | |
1981 .B \-spuaa <режим> (только OSD) | |
1982 Режим сглаживания/\:масштабирования для DVD/\:VOBsub. | |
1983 Значение 16 может быть добавлено к <режим> для задействования масштабирования, | |
1984 лаже если размеры исходного и отмасштабированного кадра уже совпадают. | |
1985 Может использоваться, например, для гауссового размытия субтитров. | |
1986 Доступные режимы: | |
1987 .PD 0 | |
1988 .RSs | |
1989 .IPs 0 | |
1990 ничего (наиболее быстрое, очень безобразное) | |
1991 .IPs 1 | |
1992 апроксимированный (сбоит?) | |
1993 .IPs 2 | |
1994 полное (меделенное) | |
1995 .IPs 3 | |
1996 билинейное (быстрое и не очень плохое, по-умолчанию) | |
1997 .IPs 4 | |
1998 используется гауссово размытие swscaler'a (выглядит очень хорошо) | |
1999 .RE | |
2000 .PD 1 | |
2001 . | |
2002 .TP | |
2003 .B \-spualign <-1\-2> (только OSD) | |
2004 Указывает как должны выравниваться SPU (DVD/\:VOBsub) субтитры. | |
2005 .PD 0 | |
2006 .RSs | |
2007 .IPs "-1" | |
2008 исходное положение | |
2009 .IPs " 0" | |
2010 Выравнивание к верху (изначальное поведение, по-умолчанию). | |
2011 .IPs " 1" | |
2012 Выравнивание к центру. | |
2013 .IPs " 2" | |
2014 Выравнивание к низу. | |
2015 .RE | |
2016 .PD 1 | |
2017 . | |
2018 .TP | |
2019 .B \-spugauss <0.0\-3.0> (только OSD) | |
2020 Параметр отклонения гауссового размытия, используемый \-spuaa 4. | |
2021 Большие значения означают более сильное размытие (по-умолчанию: 1.0). | |
2022 . | |
2023 .TP | |
2024 .B \-sub <файл_субтитров1,файл_субтитров2,...> | |
2025 Использует/\:отображает указанные файлы субтитров. | |
2026 В каждый момент времени может быть показан только один файл. | |
2027 . | |
2028 .TP | |
2029 .B \-sub-bg-alpha <0\-255> | |
2030 Указывает значение альфа канала для субтитров и фона OSD. | |
2031 Большее значение означает большую прозрачность. | |
2032 0 означает полную прозрачность. | |
2033 . | |
2034 .TP | |
2035 .B \-sub-bg-color <0\-255> | |
2036 Указывает цвет для субтитров у фона OSD. | |
2037 В данный момент субтитры выводятся в оттенках серого, так что это | |
2038 эквивалентно интенсивности цвета. | |
2039 255 означает белый и 0 - черный. | |
2040 . | |
2041 .TP | |
2042 .B \-sub-demuxer <[+]название> (только \-subfile only) (БЕТА КОД) | |
2043 Принудительно устанвливает тип демуксера субтитров для \-subfile. | |
2044 Используйте '+' перед названием для принудительного использования, это | |
2045 пропустит некоторые проверки! | |
2046 Указывайте название демуксера таким, как оно выводится опцией \-sub-demuxer help. | |
2047 Для обратной совместимости также допускается ID демуксера, определенный в | |
2048 libmpdemux/\:demuxer.h. | |
2049 . | |
2050 .TP | |
2051 .B \-sub-fuzziness <режим> | |
2052 .\" FIXME | |
2053 Настраивает точность совпадения при поиске субтитров: | |
2054 .PD 0 | |
2055 .RSs | |
2056 .IPs 0 | |
2057 точное совпадение | |
2058 .IPs 1 | |
2059 Загружает все субтитры, содержащие название фильма. | |
2060 .IPs 2 | |
2061 Загружает все субтитры, в текущем каталоге. | |
2062 .RE | |
2063 .PD 1 | |
2064 . | |
2065 .TP | |
2066 .B \-sub-no-text-pp | |
2067 Отключает любые виды постпроцессинга текста, производимого после загрузки | |
2068 субтитров. Используется для отладочных целей. | |
2069 . | |
2070 .TP | |
2071 .B \-subalign <0\-2> (только OSD) | |
2072 Указывает какой край субтитров должен выравниваться по высоте, указанной | |
2073 опцией \-subpos. | |
2074 .PD 0 | |
2075 .RSs | |
2076 .IPs 0 | |
2077 Выравнивают верх субтитров (изначальное поведение). | |
2078 .IPs 1 | |
2079 Выранивает центр субтитров. | |
2080 .IPs 2 | |
2081 Выравнивает нижнюю границу субтитров (по-умолчанию). | |
2082 .RE | |
2083 .PD 1 | |
2084 . | |
2085 .TP | |
2086 .B "\-subcc \ " | |
2087 Отображает DVD Closed Caption (CC) субтитры. | |
2088 Это | |
2089 .B не | |
2090 .\" FIXME i cannot translate this | |
2091 VOB субтитры, это специальные ASCII субтитры для | |
2092 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs. | |
2093 CC subtitles have not been spotted on DVDs from other regions so far. | |
2094 . | |
2095 .TP | |
2096 .B \-subcp <кодировка> (только iconv) | |
2097 Если ваша система поддерживает iconv(3), можно использовать эту опцию для | |
2098 указания кодировки субтитров. | |
2099 .sp 1 | |
2100 .I ПРИМЕР: | |
2101 .PD 0 | |
2102 .RSs | |
2103 \-subcp latin2 | |
2104 .br | |
2105 \-subcp cp1250 | |
2106 .RE | |
2107 .PD 1 | |
2108 . | |
2109 .TP | |
2110 .B \-subcp enca:<язык>:<кодировка при сбое> (только ENCA) | |
2111 Вы можете указать ваш язык, используя двухбуквенный код языка, | |
2112 чтобы дать ENCA вохможность определить кадовую страницу автоматически. | |
2113 Если неуверены, введите что-нибудь и смотрите вывод с \-v, чтобы определить | |
2114 список доступных языков. <кодировка при сбое> указывает кодировку, используемую, | |
2115 когда не срабатывает автоопределение. | |
2116 .sp 1 | |
2117 .I ПРИМЕР: | |
2118 .PD 0 | |
2119 .RSs | |
2120 .IPs "\-subcp enca:cs:latin2" | |
2121 Определяет кодировку, предполагая, что субтитры на Чешском, устанавливает | |
2122 latin 2, если определение не работает. | |
2123 .IPs "\-subcp enca:pl:cp1250" | |
2124 Определяет кодировку для Польского, устанавливает | |
2125 cp1250, если определение не работает. | |
2126 .RE | |
2127 .PD 1 | |
2128 . | |
2129 .TP | |
2130 .B \-subdelay <сек> | |
2131 Отображает субтитры <сек> секунд. | |
2132 Может быть отрицательным. | |
2133 . | |
2134 .TP | |
2135 .B \-subfile <файл> (БЕТА КОД) | |
2136 В данный момент бесполезно. | |
2137 То же, что и \-audiofile, но для потока субтитров (OggDS?). | |
2138 . | |
2139 .TP | |
2140 .B \-subfont-autoscale <0\-3> (только FreeType) | |
2141 Устанавливает режим автомасштабирования. | |
2142 .br | |
2143 .I ЗАМЕЧАНИЕ: | |
2144 0 означает, что масштаб текста и масштаб OSD - это высота шрифта в точках. | |
2145 .sp 1 | |
2146 Режим может быть: | |
2147 .sp 1 | |
2148 .PD 0 | |
2149 .RSs | |
2150 .IPs 0 | |
2151 нет автомасштаба | |
2152 .IPs 1 | |
2153 пропорционально высоте фильма | |
2154 .IPs 2 | |
2155 пропорционально ширине фильма | |
2156 .IPs 3 | |
2157 пропорционально диагонали фильма (по-умолчанию) | |
2158 .RE | |
2159 .PD 1 | |
2160 . | |
2161 .TP | |
2162 .B \-subfont-blur <0\-8> (только FreeType) | |
2163 Указывает радиус размытия шрифта (по-умолчанию: 2). | |
2164 . | |
2165 .TP | |
2166 .B \-subfont-encoding <значение> (только FreeType) | |
2167 Устанавливает кодировку шрифта. | |
2168 Когда установлена в 'unicode', будут рендериться все глифы из файла шрифта и | |
2169 использоваться юникод (по-умолчанию: unicode). | |
2170 . | |
2171 .TP | |
2172 .B \-subfont-osd-scale <0\-100> (только FreeType) | |
2173 Устанавливает коэффициент автомасштаба OSD элементов (по-умолчанию: 6). | |
2174 . | |
2175 .TP | |
2176 .B \-subfont-outline <0\-8> (только FreeType) | |
2177 Устанавливает толщину обрамления шрифта (по-умолчанию: 2). | |
2178 . | |
2179 .TP | |
2180 .B \-subfont-text-scale <0\-100> (только FreeType) | |
2181 Устанавливает коэффициент автомасштаба текста субтитров как | |
2182 процент от размера экрана (по-умолчанию: 5). | |
2183 . | |
2184 .TP | |
2185 .B \-subfps <частота> | |
2186 Указывает частоту кадров файла субтитров (по-умолчанию: fps фильма). | |
2187 .br | |
2188 .I ЗАМЕЧАНИЕ: | |
2189 Только для файлов субтитров, основанных на времени, например MicroDVD формат. | |
2190 . | |
2191 .TP | |
2192 .B \-subpos <0\-100> (имеет смысл только с \-vf expand) (только OSD) | |
2193 Указывает позицию субтитров на экране. | |
2194 Указывается вертикальная позиция субтитров в % от высоты экрана. | |
2195 . | |
2196 .TP | |
2197 .B \-subwidth <10\-100> (только OSD) | |
2198 Указывает максимальную ширину субтитров на экране. | |
2199 Полезно для TV-вывода. | |
2200 Указывается ширина субтитров в % от ширины экрана. | |
2201 . | |
2202 .TP | |
2203 .B \-noterm-osd | |
2204 Отключает отображение сообщений OSD на консоли, когда недоступно никакого видео. | |
2205 . | |
2206 .TP | |
2207 .B \-term-osd-esc <escape последовательность> | |
2208 Указывает escape последовательность выодимую на консоль перед выводом сообщения OSD. | |
2209 Escape последовательность должна передвигать указатель на начало строки, используемой для | |
2210 OSD и очищать ее (по-умолчанию: ^[[A\\r^[[K). | |
2211 . | |
2212 .TP | |
2213 .B \-unicode | |
2214 Указывает MPlayer обрабатывать файл субтитров как unicode. | |
2215 . | |
2216 .TP | |
2217 .B "\-utf8 \ \ " | |
2218 Указывает MPlayer обрабатывать файл субтитров как UTF-8. | |
2219 . | |
2220 .TP | |
2221 .B \-vobsub <VOBsub файл без расширения> | |
2222 Указывает VOBsub файл, используемый для субтитров. | |
20735 | 2223 Должен быть полным путем без расширения, т.е.\& без '.idx', '.ifo' или '.sub'. |
20707 | 2224 . |
2225 .TP | |
2226 .B \-vobsubid <0\-31> | |
2227 Указывает ID субтитров VOBsub. | |
2228 . | |
2229 . | |
2230 . | |
2231 .SH "ОПЦИИ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)" | |
2232 . | |
2233 .TP | |
2234 .B \-abs <значение> (только \-ao oss) (УСТАРЕЛО) | |
2235 Переопределяет размер буфера аудио драйвера/\:карты. | |
2236 . | |
2237 .TP | |
2238 .B \-format <формат> (смотрите также аудио фильтр format) | |
2239 Выбирает формат сэмпла, используемый для вывода со слоя | |
2240 аудио фильтров на звуковую карту. | |
2241 Значения, которые может принимать <формат> перечислены ниже в описании | |
2242 аудио фильтра format. | |
2243 . | |
2244 .TP | |
2245 .B \-mixer <устройство> | |
2246 Использует устройство микшера, отличное от значения по-умолчанию | |
2247 /dev/\:mixer. Для ALSA это название микшера. | |
2248 . | |
2249 .TP | |
2250 .B \-mixer-channel <mixer line>[,mixer index] (только \-ao oss и \-ao) | |
2251 Эта опция укажет MPlayer использовать другой канал для управления | |
2252 громкостью, вместо PCM. Опции для OSS включают | |
2253 .B vol, pcm, line. | |
2254 Полный список опций смотрите в SOUND_DEVICE_NAMES в | |
2255 /usr/\:include/\:linux/\:soundcard.h. | |
2256 Для ALSA вы можете использовать названия, отображаемые, например alsamixer, | |
2257 вроде | |
2258 .B Master, Line, PCM. | |
2259 .br | |
2260 .I ЗАМЕЧАНИЕ: | |
2261 Названия каналов микшера ALSA, с последующими числами должны быть указаны в формате | |
2262 <название,число>, например канал, помеченный 'PCM 1', в alsamixer должен быть | |
2263 преобразован в | |
2264 .BR PCM,1 . | |
2265 . | |
2266 .TP | |
2267 .B \-softvol | |
2268 Принудительно использует программный микшер, вместо микшера звуковой карты. | |
2269 . | |
2270 .TP | |
2271 .B \-softvol-max <10.0\-10000.0> | |
2272 Устанавливает максимальный уровень усиления в процентах (по-умолчанию: 110). | |
2273 Значение 200 позволит вам изменять громкость до величины в два раза | |
2274 превышающей текущий уровень. Со значениями ниже 100 начальный уровень | |
2275 (равный 100%) будет больше максимального, и OSD не мможет отобразить его | |
2276 корректно. | |
2277 . | |
2278 .TP | |
2279 .B \-volstep <0\-100> | |
2280 Устанавливает размер шага изменения громкости микшера в процентах от | |
2281 всего диапазона (по-умолчанию: 3). | |
2282 . | |
2283 . | |
2284 . | |
2285 .SH "ДАЙВЕРЫ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)" | |
2286 Драйверы вывода звука являются интерфейсом к различным средствам вывода звука. | |
2287 Синтаксис: | |
2288 . | |
2289 .TP | |
2290 .B \-ao <драйвер1[:подопция1[=значение]:...],драйвер2,...[,]> | |
2291 Указывает список приоритетности использования драйверов вывода звука. | |
2292 .PP | |
2293 Если список содержит в конце ',' MPlayer в случае проблем будет использовать | |
2294 драйверы, не включенные в список. | |
2295 Подопции необязательны, и в большинстве случаев могут быть опущены. | |
2296 .br | |
2297 .I ЗАМЕЧАНИЕ: | |
2298 Смотрите \-ao help, чтобы получить список встроенных драйверов вывода звука. | |
2299 .sp 1 | |
2300 .I ПРИМЕР: | |
2301 .PD 0 | |
2302 .RSs | |
2303 .IPs "\-ao alsa,oss," | |
2304 Пробуется ALSA драйвер, затем OSS, затем остальные. | |
2305 .IPs "\-ao alsa:noblock:device=hw=0.3" | |
2306 Устанавливает неблокирующий режим и в качестве устройства первую карту, | |
2307 четвертое устройство. | |
2308 .RE | |
2309 .PD 1 | |
2310 .sp 1 | |
2311 Доступные драйверы вывода звука: | |
2312 . | |
2313 .TP | |
2314 .B "alsa\ \ \ " | |
2315 Драйвер вывода звука ALSA 0.9/1.x | |
2316 .PD 0 | |
2317 .RSs | |
2318 .IPs noblock | |
2319 Устанавливает неблокирующий режим. | |
2320 .IPs device=<устройство> | |
2321 Устанавливает название устройства. | |
2322 Замените любые ',' на '.' и любые ':' на '=' в названии устройства ALSA. | |
2323 Для hwac3 вывода через S/PDIF, используйте "iec958" или "spdif" устройство, | |
2324 если вы не знаете как правильно его установить. | |
2325 .RE | |
2326 .PD 1 | |
2327 . | |
2328 .TP | |
2329 .B "alsa5\ \ " | |
2330 Драйвер вывода звука ALSA 0.5 | |
2331 . | |
2332 .TP | |
2333 .B "oss\ \ \ \ " | |
2334 Драйвер вывода звука OSS | |
2335 .PD 0 | |
2336 .RSs | |
2337 .IPs <dsp-устройство> | |
2338 Устанавливает устройство вывода звука (по-умолчанию: /dev/\:dsp). | |
2339 .IPs <mixer-устройство> | |
2340 Устанавливает устройство микширования звука (по-умолчанию: /dev/\:mixer). | |
2341 .IPs <mixer-канал> | |
2342 Устанавливает канал микшера звука (по-умолчанию: pcm). | |
2343 .RE | |
2344 .PD 1 | |
2345 . | |
2346 .TP | |
2347 .B sdl (только SDL) | |
20832 | 2348 Драйвер вывода звука высокоуровневой платформенно-мезависимой библиотеки |
20707 | 2349 SDL (Simple Directmedia Layer) |
2350 .PD 0 | |
2351 .RSs | |
2352 .IPs <драйвер> | |
2353 Явно выбирает используемый SDL драйвер (по-умолчанию: на усмотрение SDL). | |
2354 .RE | |
2355 .PD 1 | |
2356 . | |
2357 .TP | |
2358 .B "arts\ \ \ " | |
2359 Драйвер вывода звука через демон aRts | |
2360 . | |
2361 .TP | |
2362 .B "esd\ \ \ \ " | |
2363 Драйвер вывода звука через демон ESD | |
2364 .PD 0 | |
2365 .RSs | |
2366 .IPs <сервер> | |
2367 Явно выбирает используемый ESD сервер (по-умолчанию: localhost). | |
2368 .RE | |
2369 .PD 1 | |
2370 . | |
2371 .TP | |
2372 .B "jack\ \ \ \ " | |
2373 Драйвер вывода звука через JACK (Jack Audio Connection Kit) | |
2374 .PD 0 | |
2375 .RSs | |
2376 .IPs port=<имя> | |
2377 Указывает присоединяться к портам с указанным именем (по-умолчанию: physical ports). | |
2378 .IPs name=<имя клиента> | |
2379 Имя клиента, передаваемое JACK (по-умолчанию: MPlayer [<PID>]). | |
2380 Полезно, если вы хотите автоматически устанавливать определенные соединения. | |
2381 .IPs (no)estimate | |
2382 Оценка задержки аудио, предлагаемой для более плавного воспроизведения видео | |
2383 (по-умодчанию: включено). | |
2384 .RE | |
2385 .PD 1 | |
2386 . | |
2387 .TP | |
2388 .B "nas\ \ \ \ " | |
2389 Драйвер вывода звука через NAS | |
2390 . | |
2391 .TP | |
2392 .B macosx (только Mac OS X) | |
2393 Родной драйвер вывода звука Mac OS X | |
2394 . | |
2395 .TP | |
2396 .B openal | |
2397 Экспериментальный, незавершенный (будет сводить в моно) драйвер выода OpenAL | |
2398 . | |
2399 .TP | |
2400 .B sgi (только SGI) | |
2401 Родной драйвер вывода звука SGI | |
2402 .PD 0 | |
2403 .RSs | |
2404 .IPs "<имя устройства вывода>" | |
2405 Явно выбирает используемое устройство/\:интерфейс вывода | |
2406 (по-умолчанию: системное значение по-умолчанию). | |
2407 Например, 'Analog Out' или 'Digital Out'. | |
2408 .RE | |
2409 .PD 1 | |
2410 . | |
2411 .TP | |
2412 .B sun (только Sun) | |
2413 Родной драйвер вывода звука Sun | |
2414 .PD 0 | |
2415 .RSs | |
2416 .IPs <device> | |
2417 Явно выбирает используемое устройство вывода (по-умолчанию: /dev/\:audio). | |
2418 .RE | |
2419 .PD 1 | |
2420 . | |
2421 .TP | |
2422 .B win32 (только Windows) | |
2423 Родной waveout драйвер вывода звука Windows | |
2424 . | |
2425 .TP | |
2426 .B dsound (только Windows) | |
2427 Драйвер вывода звука DirectX DirectSound | |
2428 .PD 0 | |
2429 .RSs | |
2430 .IPs device=<номер устройства> | |
2431 Устанавливает номер используемого устройства. | |
2432 Воспроизведение файла с \-v покажет список доступных устройств. | |
2433 .RE | |
2434 .PD 1 | |
2435 . | |
2436 .TP | |
2437 .B dxr2 (смотрите также \-dxr2) (только DXR2) | |
2438 Специальный драйвер вывода для Creative DXR2 | |
2439 . | |
2440 .TP | |
2441 .B ivtv (только IVTV) | |
2442 Специальный IVTV MPEG драйвер вывода. | |
2443 Работает только с \-ac hwmpa. | |
2444 . | |
2445 .TP | |
2446 .B mpegpes (только DVB) | |
2447 Драйвер вывода звука для DVB карт, записывающий вывод в MPEG-PES файл, | |
2448 если не установлено DVB карт. | |
2449 .PD 0 | |
2450 .RSs | |
2451 .IPs card=<1\-4> | |
2452 Используемая DVB карта, если установлено более одной. | |
2453 .IPs file=<файл> | |
2454 Имя выходного файла | |
2455 .RE | |
2456 .PD 1 | |
2457 . | |
2458 .TP | |
2459 .B "null\ \ \ " | |
2460 Не выводит никакого звука, но сохранаяет скорость воспроизведения видео. | |
2461 Используйте \-nosound для тестов производительности. | |
2462 . | |
2463 .TP | |
2464 .B "pcm\ \ \ \ " | |
2465 Драйвер вывода в файл сырого PCM/wave | |
2466 .PD 0 | |
2467 .RSs | |
2468 .IPs (no)waveheader | |
2469 Включает или не включает заголовок wave (по-умолчанию: включен). | |
2470 Если не включен, генерируется сырой PCM. | |
2471 .IPs file=<файл> | |
2472 Записывает звук в <файл> вместо audiodump.wav. | |
2473 Если указано nowaveheader, то по-умолчанию используется audiodump.pcm. | |
2474 .IPs "fast\ " | |
2475 Пытается выводить быстрее реальной скорости. | |
2476 Убедитесь, что вывод не обрезан (обычно с сообщением | |
2477 "Too many video packets in buffer"). | |
2478 Это нормально, если вы получаете сообщение | |
2479 "Your system is too SLOW to play this!". | |
2480 .RE | |
2481 .PD 1 | |
2482 . | |
2483 .TP | |
2484 .B "plugin\ \ " | |
2485 Драйвер вывода звука plugin | |
2486 . | |
2487 . | |
2488 . | |
2489 .SH "ОПЦИИ ВЫВОДА ВИДЕО (ТОЛЬКО MPLAYER)" | |
2490 . | |
2491 .TP | |
2492 .B \-adapter <значение> | |
2493 Указывает видеокарту, на которую будет выводиться изображение. | |
2494 Список доступных карт можно получить, указав эту опцию совместно с \-v. | |
2495 В данный момент работает только с directx драйвером вывода видео. | |
2496 . | |
2497 .TP | |
2498 .B \-bpp <глубина> | |
2499 Переназначает определенную автоматически глубину цвета. | |
2500 Поддерживается только fbdev, dga, svga, vesa драйверами. | |
2501 . | |
2502 .TP | |
2503 .B \-border | |
2504 Воспроизводит фильм в окне с рамками и оформлением. | |
2505 Поскольку это действие по-умолчанию, используйте \-noborder | |
2506 для отключения стандартного оформления окон. | |
2507 Поддерживается драйвером directx. | |
2508 . | |
2509 .TP | |
2510 .B \-brightness <-100\-100> | |
2511 Настраивает яркость видео сигнала (по-умолчанию: 0). | |
2512 Поддерживается не всеми драйверами. | |
2513 . | |
2514 .TP | |
2515 .B \-contrast <-100\-100> | |
2516 Настраивает контрастность видеосигнала (по-умолчанию: 0). | |
2517 Поддерживается не всеми драйверами. | |
2518 . | |
2519 .TP | |
2520 .B \-display <имя> (только X11) | |
2521 Указывает имя хоста и номер дисплея X сервера, на котором вы хотите выводить | |
2522 изображение. | |
2523 .sp 1 | |
2524 .I ПРИМЕР: | |
2525 .PD 0 | |
2526 .RSs | |
2527 \-display xtest.localdomain:0 | |
2528 .RE | |
2529 .PD 1 | |
2530 . | |
2531 .TP | |
2532 .B "\-dr \ \ \ " | |
2533 Включает direct rendering (поддерживается не всеми кодеками и драйверами вывода). | |
2534 .br | |
2535 .I ВНИМАНИЕ: | |
2536 Может привести к испорченным OSD/SUB! | |
2537 . | |
2538 .TP | |
2539 .B \-dxr2 <опция1:опция2:...> | |
2540 Эта опция используется для управления драйвером dxr2. | |
2541 .RSs | |
2542 .IPs ar-mode=<значение> | |
2543 пропорции (0 = normal, 1 = pan-and-scan, 2 = letterbox (по-умолчанию)) | |
2544 .IPs iec958-encoded | |
2545 устанавливает режим вывода iec958 в encoded. | |
2546 .IPs iec958-decoded | |
2547 устанавливает режим вывода iec958 в decoded (по-умолчанию). | |
2548 .IPs macrovision=<значение> | |
2549 режим macrovision (0 = выключено (по-умолчанию), 1 = agc, 2 = agc 2 colorstripe, | |
2550 3 = agc 4 colorstripe) | |
2551 .IPs "mute\ " | |
2552 отключает вывод звука | |
2553 .IPs unmute | |
2554 включает вывод звука | |
2555 .IPs ucode=<значение> | |
2556 путь к микрокоду | |
2557 .RE | |
2558 .RS | |
2559 .sp 1 | |
2560 .I TV вывод | |
2561 .RE | |
2562 .RSs | |
2563 .IPs 75ire | |
2564 включает режим вывода 7.5 IRE | |
2565 .IPs no75ire | |
2566 отключает режим вывода 7.5 IRE (по-умолчанию) | |
2567 .IPs "bw\ \ \ " | |
2568 ч/б TV вывод | |
2569 .IPs color | |
2570 цветной TV вывод (по-умолчанию) | |
2571 .IPs interlaced | |
2572 черезстрочный TV вывод (по-умолчанию) | |
2573 .IPs nointerlaced | |
2574 отключает черезстрочный TV вывод | |
2575 .IPs norm=<значение> | |
2576 TV стандарт (ntsc (по-умолчанию), pal, pal60, palm, paln, palnc) | |
2577 .IPs square-pixel | |
2578 устанавливает режим пиксела в square | |
2579 .IPs ccir601-pixel | |
2580 устанавливает режим пиксела в ccir601 | |
2581 .RE | |
2582 .RS | |
2583 .sp 1 | |
2584 .I оверлей | |
2585 .RE | |
2586 .RSs | |
2587 .IPs cr-left=<0\-500> | |
2588 Устанавливает левую границу обрезания (по-умолчанию: 50). | |
2589 .IPs cr-right=<0\-500> | |
2590 Устанавливает правую границу обрезания (по-умолчанию: 300). | |
2591 .IPs cr-top=<0\-500> | |
2592 Устанавливает верхнюю границу обрезания (по-умолчанию: 0). | |
2593 .IPs cr-bottom=<0\-500> | |
2594 Устанавливает нижнюю границу обрезания (по-умолчанию: 0). | |
2595 .IPs ck-[r|g|b]=<0\-255> | |
2596 Устанавливает величину красной(r), зеленой(g), синей (b) компоненты ключевого цвета оверлея. | |
2597 .IPs ck-[r|g|b]min=<0\-255> | |
2598 Минимальное значение для соответствующей компоненты ключевого цвета | |
2599 .IPs ck-[r|g|b]max=<0\-255> | |
2600 Максимальное значение для соответствующей компоненты ключевого цвета | |
2601 .IPs ignore-cache | |
2602 Игнорирует кешированные установки оверлея. | |
2603 .IPs update-cache | |
2604 Обновляет кешированные установки оверлея. | |
2605 .IPs ol-osd | |
2606 Включает оверлейный OSD. | |
2607 .IPs nool-osd | |
2608 Отключает оверлейный OSD (по-умолчанию). | |
2609 .IPs ol[h|w|x|y]-cor=<-20\-20> | |
2610 Настраивает размер (высоту(h),ширину(w)) и положение (x,y) оверлея | |
2611 в случает, когда он не точно соответствует окну (по-умолчанию: 0). | |
2612 .IPs overlay | |
2613 Активирует оверлей (по-умолчанию). | |
2614 .IPs nooverlay | |
2615 Автивирует TV выход. | |
2616 .IPs overlay-ratio=<1\-2500> | |
2617 Настраивает оверлей (по-умолчанию: 1000). | |
2618 .RE | |
2619 . | |
2620 .TP | |
2621 .B \-fbmode <режим> (только \-vo fbdev) | |
2622 Меняет видео режим на помеченный как <режим> в /etc/\:fb.modes. | |
2623 .br | |
2624 .I ЗАМЕЧАНИЕ: | |
2625 VESA фреймбуфер не поддерживает смену режима. | |
2626 . | |
2627 .TP | |
2628 .B \-fbmodeconfig <файл> (только \-vo fbdev) | |
2629 Переопределяет файл конфигурации режимов фреймбуфера (по-умолчанию: /etc/\:fb.modes). | |
2630 . | |
2631 .TP | |
2632 .B \-fs (смотрите также \-zoom) | |
2633 Полноэкранное воспроизведение (центрирует изображение и рисует черные рамки вокруг него). | |
2634 Поддерживается не всеми драйверами. | |
2635 . | |
2636 .TP | |
2637 .B \-fsmode-dontuse <0\-31> (УСТАРЕЛО, используйте опцию \-fs) | |
2638 Попробуйте эту опцию, если у вас по-прежнему проблемы с полноэкранным режимом. | |
2639 . | |
2640 .TP | |
2641 .B \-fstype <тип1,тип2,...> (только X11) | |
2642 Указывает список используемых полноэкранных режимов в порядке приоритета. | |
2643 Вы можете овергнуть режимы, ставя перед ними '\-'. | |
2644 Если у вас возникают проблемы вроде перекрывания полноэкранного окна другими, | |
2645 попробуйте использовать другой порядок. | |
2646 .br | |
2647 .I ЗАМЕЧАНИЕ: | |
2648 Список доступных типов можно получить опцией \-fstype help. | |
2649 .sp 1 | |
2650 Допустиные типы: | |
2651 .sp 1 | |
2652 .PD 0 | |
2653 .RSs | |
2654 .IPs above | |
2655 Использует подсказку _NETWM_STATE_ABOVE, если доступна. | |
2656 .IPs below | |
2657 Использует подсказку _NETWM_STATE_BELOW, если доступна. | |
2658 .IPs fullscreen | |
2659 Использует подсказку _NETWM_STATE_FULLSCREEN, если доступна. | |
2660 .IPs layer | |
2661 Использует подсказку _WIN_LAYER со слоем по-умолчанию. | |
2662 .IPs layer=<0...15> | |
2663 Использует подсказку _WIN_LAYER со слоем с указанным номером. | |
2664 .IPs netwm | |
2665 Принудительно указывает стиль NETWM. | |
2666 .IPs "none\ " | |
2667 Указывает не устанавливать слой полноэкранного окна. | |
2668 .IPs stays_on_top | |
2669 Использует подсказку _NETWM_STATE_STAYS_ON_TOP, если доступна. | |
2670 .REss | |
2671 .sp 1 | |
2672 .RS | |
2673 .I ПРИМЕР: | |
2674 .RE | |
2675 .PD 0 | |
2676 .RSs | |
2677 .IPs layer,stays_on_top,above,fullscreen | |
2678 Порядок по-умолчанию, будет использоваться, если указан некорректный или | |
2679 неподдерживаемый режим. | |
2680 .IPs \-fullscreen | |
2681 Исправляет переключение в полноэкранный режим в OpenBox 1.x. | |
2682 .RE | |
2683 .PD 1 | |
2684 . | |
2685 .TP | |
2686 .B \-geometry x[%][:y[%]] или [WxH][+x+y] | |
2687 Настраивает место появления на экране изображения. | |
2688 x и y указываются в пикселах, считая от верхнего левого до нижнего правого | |
2689 угла выводимого изображения. Если после значения указан символ процента, то | |
2690 оно превращается в процентное относительно размера экрана в соответствующем | |
2691 направлении. Опция также поддерживает стандартный формат X11 опции \-geometry. | |
2692 Если опцией \-wid указано внешнее окно, то координаты x и y указываются относительно | |
2693 его левого верхнего угла, а не экранного. | |
2694 .br | |
2695 .I ЗАМЕЧАНИЕ: | |
2696 Эта опция поддерживается только драйверами x11, xmga, xv, xvmc, xvidix, | |
2697 gl, gl2, directx и tdfxfb. | |
2698 .sp 1 | |
2699 .I ПРИМЕР: | |
2700 .PD 0 | |
2701 .RSs | |
2702 .IPs 50:40 | |
2703 Располагает окно в позиции x=50, y=40. | |
2704 .IPs 50%:50% | |
2705 Располагает окно в центре экрана. | |
2706 .IPs "100%\ " | |
2707 Располагает окно у центра правой границы экрана. | |
2708 .IPs 100%:100% | |
2709 Располагает окно у правого нижнего угла экрана. | |
2710 .RE | |
2711 .PD 1 | |
2712 . | |
2713 .TP | |
2714 .B \-guiwid <ID окна> (смотрите также \-wid) (только GUI) | |
2715 Опция указывает GUI использовать также X11 окно и прицепить себя к нижней | |
2716 части видео окна, что полезно для внедрения мини-GUI в браузер | |
2717 (с плагином MPlayer). | |
2718 . | |
2719 .TP | |
2720 .B \-hue <-100\-100> | |
2721 Настраивает цветность видеосигнала (по-умолчанию: 0). | |
2722 С этой опцией вы можете получить цветной негатив. | |
2723 Поддерживается не всеми драйверами. | |
2724 . | |
2725 .TP | |
2726 .B \-monitor-dotclock <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2727 Указывает диапазон значений dotclock или pixelclock монитора. | |
2728 . | |
2729 .TP | |
2730 .B \-monitor-hfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2731 Указывает диапазон значений горизонтальной частоты монитора. | |
2732 . | |
2733 .TP | |
2734 .B \-monitor-vfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2735 Указывает диапазон значений вертикальной частоты монитора. | |
2736 . | |
2737 .TP | |
2738 .B \-monitoraspect <значение> (смотрите также \-aspect) | |
2739 Указывает пропорции монитора или TV экрана. | |
2740 .sp 1 | |
2741 .I ПРИМЕР: | |
2742 .PD 0 | |
2743 .RSs | |
2744 \-monitoraspect 4:3 or 1.3333 | |
2745 .br | |
2746 \-monitoraspect 16:9 or 1.7777 | |
2747 .RE | |
2748 .PD 1 | |
2749 . | |
2750 .TP | |
2751 .B \-monitorpixelaspect <значение> (смотрите \-aspect) | |
2752 Устанавливает пропорции отдельного пиксела вашего монитора или TV | |
2753 экрана (по-умолчанию: отключено). | |
2754 Переопределяет установки \-monitoraspect. | |
2755 Значение 0 отключает, значение 1 означает квадратные пикселы | |
2756 (верно для (почти?) всех LCD). | |
2757 . | |
2758 .TP | |
2759 .B \-nodouble | |
2760 Отключает двойную буферизацию, используется, как правило, для целей откладки. | |
2761 Двойная буферизация исправляет мерцание, храня два кадра в памяти и | |
2762 отображая один из них, в то время, как декодируется второй. | |
2763 Это может негативно сказаться на OSD, но в большинстве случаев | |
2764 убирает мерцание OSD. | |
2765 . | |
2766 .TP | |
2767 .B \-nograbpointer | |
2768 Указывает не захватывать указатель мыши после смены видео режима (\-vm). | |
2769 Полезно для многоголовых конфигураций. | |
2770 . | |
2771 .TP | |
2772 .B \-nokeepaspect | |
2773 Указывает ге сохранять пропорции окна при изменении размера. | |
2774 Работает только с драйверами x11, xv, xmga, xvidix, directx. | |
2775 Кроме того, под X11 ваш оконный менеджер должен понимать подсказку | |
2776 созранения пропорций окна. | |
2777 . | |
2778 .TP | |
2779 .B "\-ontop\ " | |
2780 Помещает и сохраняет окно проигрывателя поверх всех окон. | |
2781 Поддерживается всеми драйверами, использующими X11, за | |
2782 исчключением SDL, а также драйверами directx, macosx, | |
2783 quartz, ggi и gl2. | |
2784 . | |
2785 .TP | |
2786 .B \-panscan <0.0\-1.0> | |
2787 Задействует функциональность pan-and-scan (обрезая стороны в соответствии | |
2788 с пропорциями, чтобы, например 16:9, фильм поместился на 4:3 экране | |
2789 без черных полос). Диапазон указывает какая часть изображения обрезается. | |
2790 Работает только с xv, xmga, mga, gl, gl2, quartz, macosx и xvidix драйверами. | |
2791 . | |
2792 .TP | |
2793 .B \-panscanrange <-19.0\-99.0> (экспериментальное) | |
2794 Изменяет диапазон pan-and-scan функциональности (по-умолчанию: 1). | |
2795 Положительные значения означают множитель диапазона по-умолчанию. | |
2796 Отрицательные значения означают, что можно увеличивать изображение | |
2797 до \-panscanrange+1 раз. | |
2798 Например \-panscanrange -3 означает увеличение вплоть до 4 раз. | |
2799 Это экспериментальная возможность. | |
2800 Не сообщайте об ошибках в ней, за исключением случая использования \-vo gl. | |
2801 . | |
2802 .TP | |
2803 .B \-refreshrate <Гц> | |
2804 Устанавливает частоту обновления монитора в Гц. | |
2805 В данный момент поддерживается только \-vo directx совместно с \-vm. | |
2806 . | |
2807 .TP | |
2808 .B \-rootwin | |
2809 Воспроизводит фильм на главном окне (фоне рабочего стола). | |
2810 Однако, фон рабочего стола может отображаться поверх изображения. | |
2811 Работает только с x11, xv, xmga, xvidix, quartz, macosx и directx драйверами. | |
2812 . | |
2813 .TP | |
2814 .B \-saturation <-100\-100> | |
2815 Настраивает насыщенность видео сигнала (по-умолчанию: 0). | |
2816 С этой опцией вы можете получить изображения в оттенках серого. | |
2817 Поддерживается не всеми драйверами. | |
2818 . | |
2819 .TP | |
2820 .B \-screenh <пикселов> | |
2821 Указывает вертикальное разрешение экрана для драйверов, которые не могут | |
2822 определить его самостоятельно, таких как fbdev, x11 и TVout. | |
2823 . | |
2824 .TP | |
2825 .B \-screenw <пикселов> | |
2826 Указывает горизонтальное разрешение экрана для драйверов, которые не могут | |
2827 определить его самостоятельно, таких как fbdev, x11 и TVout. | |
2828 . | |
2829 .TP | |
2830 .B \-stop-xscreensaver (только X11) | |
2831 Отключает xscreensaver при запуске и снова включает его при выходе. | |
2832 . | |
2833 .TP | |
2834 .B "\-vm \ \ \ " | |
2835 Пытается переключиться в другой видео режим. | |
2836 Поддерживается dga, x11, xv, sdl и directx драйверами. | |
2837 Если используется с directx драйвером, для изменения режима | |
2838 можно использовать опции \-screenw, \-screenh, \-bpp и \-refreshrate. | |
2839 . | |
2840 .TP | |
2841 .B "\-vsync \ \ " | |
2842 Включает VBI для vesa, dfbmga и svga драйверов. | |
2843 . | |
2844 .TP | |
2845 .B \-wid <ID окна> (смотрите также \-guiwid) (только X11, OpenGL и DirectX) | |
2846 Говорит MPlayer присоединиться к существующему окну. | |
2847 Полезно для внедрения MPlayer в браузер (например, расширение plugger). | |
2848 . | |
2849 .TP | |
2850 .B \-xineramascreen <\-2\-...> (только X11) | |
2851 В Xinerama конфигурациях (например, единственный рабочий стол, растянутый на | |
2852 несклько экранов) эта опция указывает MPlayer на каком из них показывать | |
2853 фильм. Значение \-2 означает полноэкранный режим на весь виртуальный экран, | |
2854 \-1 означает полноэкранный режим на экране с текущим окном. | |
2855 Начальная позиция устанавливается опцией \-geometry относительно указаного | |
2856 экрана. Как правило будет работать только с "\-fstype \-fullscreen" или | |
2857 "\-fstype none". | |
2858 . | |
2859 .TP | |
2860 .B \-zrbw (только \-vo zr) | |
2861 Показывает черно-белое изображение. | |
2862 Для оптимальной производительности может комбинироваться с '\-lavdopts gray'. | |
2863 . | |
2864 .TP | |
2865 .B \-zrcrop <[ширина]x[высота]+[x смещение]+[y смещение]> (только \-vo zr) | |
2866 Выбирает часть исходного изображения для показа, неоднократное указание | |
2867 этой опции включает режим cinerama. | |
2868 В режиме cinerama фильм распределяется по нескольким TV (или проекторам) для | |
2869 создания большей картинки. | |
2870 Опции, указаанные после n-ой \-zrcrop применяются к n-ой MJPEG карте, | |
2871 для каждой карты нужно указать, как минимум, \-zrdev в дополнении к \-zrcrop. | |
2872 Для примера смотрите вывод \-zrhelp и раздел Zr документации. | |
2873 . | |
2874 .TP | |
2875 .B \-zrdev <устройство> (только \-vo zr) | |
2876 Указывает файл устройства, относящийся к вашей MJPEG карте, по-умолчанию | |
2877 драйвер zr устанавливает ее в первое найденное v4l устройство. | |
2878 . | |
2879 .TP | |
2880 .B \-zrfd (только \-vo zr) | |
2881 Принудительное прореживание: Прореживание, указаное опциями \-zrhdec | |
2882 и \-zrvdec, применяется, только если аппаратный scaler может растянуть | |
2883 изображение до его исходного размера. | |
2884 Используйте эту опцию, чтобы форсировать прореживание. | |
2885 . | |
2886 .TP | |
2887 .B \-zrhdec <1|2|4> (только \-vo zr) | |
2888 Горизонтальное прореживание: Запрашивает драйвер отправлять только | |
2889 каждый 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
2890 использовать scaler MJPEG карты для растягивания изображения до | |
2891 исходного размера. | |
2892 . | |
2893 .TP | |
2894 .B \-zrhelp (только \-vo zr) | |
2895 Отображает список всех \-zr* опций, их значения по-умолчанию и | |
2896 пример режима cinerama. | |
2897 . | |
2898 .TP | |
2899 .B \-zrnorm <стандарт> (только \-vo zr) | |
2900 Указывает TV стандарт в PAL или NTSC (по-умолчанию: без изменения). | |
2901 . | |
2902 .TP | |
2903 .B \-zrquality <1\-20> (только \-vo) | |
2904 Число от 1 (наилучшее) до 20 (наихудшее) представляющее качество | |
2905 кодирования JPEG. | |
2906 . | |
2907 . | |
2908 .TP | |
2909 .B \-zrvdec <1|2|4> (только \-vo zr) | |
2910 Вертикальное прореживание: Запрашивает драйвер отправлять только | |
2911 каждую 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
2912 использовать scaler MJPEG карты для растягивания изображения до | |
2913 исходного размера. | |
2914 . | |
2915 .TP | |
2916 .B \-zrxdoff <x смещение на экране> (только \-vo zr) | |
2917 Если изображение меньше, чем TV экран, эта опция указывает смещение | |
2918 по x от верхнего левого угла TV экрана (по-умолчанию: центировано). | |
2919 . | |
2920 .TP | |
2921 .B \-zrydoff <y смещение на экране> (только \-vo zr) | |
2922 Если изображение меньше, чем TV экран, эта опция указывает смещение | |
2923 по y от верхнего левого угла TV экрана (по-умолчанию: центировано). | |
2924 . | |
2925 . | |
2926 . | |
20832 | 2927 .SH "ДРАЙВЕРЫ ВЫВОДА ВИДЕО (ТОЛЬКО MPLAYER)" |
2928 Драйверы вывода видео - это интерфейсы к различным средствам вывода видео. | |
2929 Синтаксис: | |
2930 . | |
2931 .TP | |
2932 .B \-vo <драйвер1[:подопция1[=значение]:...],драйвер2,...[,]> | |
2933 Указывает список используемых драйверов в порядке приоритетности. | |
20707 | 2934 .PP |
20832 | 2935 Если список содержит завершающую ',', то MPlayer в случае проблем будет |
2936 использовать драйверы, не содержащиеся в списке. | |
2937 Подопции необязательны и в большинстве опций могут быть опущены. | |
2938 .br | |
2939 .I ЗАМЕЧАНИЕ: | |
2940 Полный список скомпилированных драйверов вывода видео можно получить | |
2941 опцией \-vo help. | |
2942 .sp 1 | |
2943 .I ПРИМЕР: | |
20707 | 2944 .PD 0 |
2945 .RSs | |
2946 .IPs "\-vo xmga,xv," | |
20832 | 2947 Пробует X11 Matrox драйвер, затем Xv драйвер, затем остальные. |
20707 | 2948 .IPs "\-vo directx:noaccel" |
20832 | 2949 Использует DirectX драйвер без ускорения. |
2950 .RE | |
2951 .PD 1 | |
2952 .sp 1 | |
2953 Допустимые драйверы: | |
2954 . | |
2955 .TP | |
2956 .B xv (только X11 only) | |
2957 Использует XVideo расширение XFree86 4.x для задействования аппаратно | |
2958 ускоренного воспроизведения. | |
2959 Если вы не можете использовать специальный драйвер для вашего | |
2960 оборудования, то выбор этого, возможно, будет лучшим решением. | |
2961 Чтобы узнать информацию об используемом цветовом ключе и способе его отображения, | |
2962 запустите MPlayer с опцией \-v и обратите внимание на строки, помеченные | |
2963 [xv common] в начале. | |
2964 .PD 0 | |
2965 .RSs | |
2966 .IPs port=<число> | |
2967 Выбирает указанный XVideo порт. | |
20707 | 2968 .IPs ck=<cur|use|set> |
20832 | 2969 Выбирает источник, из которого берется цветовой ключ (по-умолчанию: cur). |
20707 | 2970 .RSss |
2971 .IPs cur | |
20832 | 2972 Значение по-умолчанию цветового ключа берется из текущих установок Xv. |
20707 | 2973 .IPs use |
20832 | 2974 Указывает использовать, но не устанавливать цветовой ключ MPlayer |
2975 (используйте опцию \-colorkey для его изменения). | |
20707 | 2976 .IPs set |
20832 | 2977 То же, что и предыдущее, но также устанавливает указанный цветовой ключ. |
20707 | 2978 .RE |
2979 .IPs ck-method=<man|bg|auto> | |
20832 | 2980 Устанавливает метод отрисовки цветового ключа (по-умолчанию: man). |
20707 | 2981 .RSss |
2982 .IPs man | |
20832 | 2983 Указывает рисовать цветовой ключ самостоятельно (уменьшает мерцание в некоторых случаях). |
20707 | 2984 .IPs bg |
20832 | 2985 Устанавливает цветовой ключ в качестве фона окна. |
20707 | 2986 .IPs auto |
20832 | 2987 Предоставляет Xv отрисовывать цветовой ключ. |
2988 .RE | |
2989 .RE | |
2990 .PD 1 | |
2991 . | |
2992 .TP | |
2993 .B x11 (только X11) | |
2994 Драйвер вывода видео с разделением памяти без аппаратного ускорения, | |
2995 работает везде, где есть X11. | |
2996 . | |
2997 .TP | |
2998 .B xover (только X11) | |
2999 Добавляет поддержку X11 ко всем драйверам, основанным на оверлее. | |
3000 В данный момент поддерживается только драйвером tdfx_vid. | |
20707 | 3001 .PD 0 |
3002 .RSs | |
3003 .IPs <vo_driver> | |
20832 | 3004 Выбирает драйвер, используемый в качестве источника к оверлею |
3005 поверх X11. | |
3006 .RE | |
3007 .PD 1 | |
3008 . | |
3009 .TP | |
3010 .B xvmc (только X11 с \-vc ffmpeg12mc) | |
3011 Драйвер, использующий расширение XvMC (X Video Motion Compensation) | |
3012 XFree86 4.x для ускорения декодирования MPEG-1/2 и VCR2. | |
3013 .PD 0 | |
3014 .RSs | |
3015 .IPs port=<число> | |
3016 Выбирает указанный XVideo порт. | |
20707 | 3017 .IPs (no)benchmark |
20832 | 3018 Отключает показ изображения. |
3019 Необходимо для правильного теста производительности | |
3020 драйверов, изменяющих буферы изображения только | |
3021 .\" FIXME правильно ли переведено monitor retrace ? | |
3022 между циклами обновления изображения на мониторе (nVidia). | |
3023 По-умолчанию, отображение экрана не отключается (nobenchmark). | |
20707 | 3024 .IPs (no)bobdeint |
20832 | 3025 Очень простой деинтерлейсер. |
3026 Может быть не лучше, чем \-vf tfields=1, но это | |
3027 единственный деинтерлейсер для xvmc (по-умолчанию: nobobdeint). | |
20707 | 3028 .IPs (no)queue |
20832 | 3029 Помещает кадры для отображения в очередь, чтобы сильнее распараллелить |
3030 работу видео оборудования. | |
3031 Может добавить маленькую (незначительную) постоянную A/V рассинхронизацию | |
3032 (по-умолчанию: noqueue). | |
20707 | 3033 .IPs (no)sleep |
20832 | 3034 Указывает использовать функцию sleep для ожидания конца рендеринга |
3035 (не рекомендуется в Linux) (по-умолчанию: nosleep). | |
20707 | 3036 .IPs ck=cur|use|set |
20832 | 3037 То же, что и \-vo xv:ck (смотрите \-vo xv). |
20707 | 3038 .IPs ck-method=man|bg|auto |
20832 | 3039 То же, что и \-vo xv:ck-method (смотрите \-vo xv). |
3040 .RE | |
3041 .PD 1 | |
3042 . | |
3043 .TP | |
3044 .B dga (только X11) | |
3045 Воспроизводит видео через XFree86 расширение Direct Graphics Access. | |
3046 Считается устаревшим. | |
3047 . | |
3048 .TP | |
3049 .B sdl (только SDL) | |
3050 Драйвер вывода видео с помощью высокоуровневой, платформенно-независимой | |
3051 библиотеки SDL (Simple Directmedia Layer). | |
3052 Поскольку SDL использует свой собственный слой X11, X11 опции MPlayer | |
3053 не будут иметь никакого эффекта на SDL. | |
3054 .PD 0 | |
3055 .RSs | |
3056 .IPs driver=<драйвер> | |
3057 Явно выбирает используемый SDL драйвер. | |
20707 | 3058 .IPs (no)forcexv |
20832 | 3059 Указывает использовать XVideo через видео драйвер sdl (по-умолчанию: forcexv). |
20707 | 3060 .IPs (no)hwaccel |
20832 | 3061 .\" FIXME scaler |
3062 Указывает использовать аппаратно ускоренное масштабирование (по-умолчанию: hwaccel). | |
20707 | 3063 .RE |
3064 .PD 1 | |
3065 . | |
3066 .TP | |
3067 .B "vidix\ \ " | |
20832 | 3068 VIDIX (VIDeo Interface for *niX, видео интерфейс для *nix) - это интерфейс |
3069 к возможностям ускорения видео различных графических карт. | |
3070 Очень быстрый драйвер вывода видео для карт, его поддерживающих. | |
3071 .PD 0 | |
3072 .RSs | |
3073 .IPs <подустройство> | |
3074 .\" FIXME "подустройства" | |
3075 Явно выбирает используемый драйвер подустройства VIDIX. | |
3076 Доступные драйверы подустройств: cyberblade_vid.so, mach64_vid.so, | |
20707 | 3077 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so, |
20832 | 3078 radeon_vid.so, rage128_vid.so, sis_vid.so и unichrome_vid.so. |
3079 .RE | |
3080 .PD 1 | |
3081 . | |
3082 .TP | |
3083 .B xvidix (только X11 only) | |
3084 X11 фронтенд для VIDIX | |
3085 .PD 0 | |
3086 .RSs | |
3087 .IPs <подустройство> | |
3088 То же, что и для vidix | |
20707 | 3089 .RE |
3090 .PD 1 | |
3091 . | |
3092 .TP | |
3093 .B "cvidix\ " | |
20832 | 3094 Универсальный и платформенно-независимый VIDIX фронтенд, с картами nVidia может работать |
3095 даже в текстовой консоли. | |
3096 .PD 0 | |
3097 .RSs | |
3098 .IPs <подустройство> | |
3099 То же, что и для vidix | |
3100 .RE | |
3101 .PD 1 | |
3102 . | |
3103 .TP | |
3104 .B winvidix (только Windows) | |
3105 Windows фронтенд для VIDIX | |
3106 .PD 0 | |
3107 .RSs | |
3108 .IPs <подустройство> | |
3109 То же, что и для vidix | |
20707 | 3110 .RE |
3111 .PD 1 | |
3112 . | |
3113 .TP | |
3114 .B directx (Windows only) | |
20832 | 3115 Драйвер вывода видео, использующий DirectX интерфейс. |
20707 | 3116 .PD 0 |
3117 .RSs | |
3118 .IPs noaccel | |
20832 | 3119 Отключает аппаратное ускорение. |
3120 Попробуйте эту опцию, если у вас проблемы с отображением. | |
3121 .RE | |
3122 .PD 1 | |
3123 . | |
3124 .TP | |
3125 .B quartz (только Mac OS X) | |
3126 Драйвер вывода видео Mac OS X Quartz. | |
3127 В некоторых случаях, форсирование пакованного выходного формата YUV с, | |
3128 например, \-vf format=yuy2, может быть более эффективным. | |
3129 .PD 0 | |
3130 .RSs | |
3131 .IPs device_id=<число> | |
3132 Выбирает устройство отображения для использования в полноэкранном режиме. | |
3133 .IPs fs_res=<ширина>:<высота> | |
3134 Указывает полноэкранное разрешение (полезно на медленных системах). | |
3135 .RE | |
3136 .PD 1 | |
3137 . | |
3138 .TP | |
3139 .B macosx (Mac OS X 10.4 или 10.3.9 с QuickTime 7) | |
3140 Драйвер вывода видео Mac OS X CoreVideo. | |
3141 .PD 0 | |
3142 .RSs | |
3143 .IPs device_id=<число> | |
3144 Выбирает устройство отображения для использования в полноэкранном режиме. | |
3145 .RE | |
3146 .PD 1 | |
3147 . | |
3148 .TP | |
3149 .B fbdev (только Linux) | |
3150 Использует фреймбуфер ядра для воспроизведения видео. | |
3151 .PD 0 | |
3152 .RSs | |
3153 .IPs <устройство> | |
3154 Явно указывает имя используемого fbdev устройства (например /dev/\:fb0) или | |
3155 имя подустройства VIDIX, если имя устройства начинается с 'vidix' | |
3156 (например 'vidixsis_vid для драйвера sis). | |
3157 .RE | |
3158 .PD 1 | |
3159 . | |
3160 .TP | |
3161 .B fbdev2 (только Linux) | |
3162 Использует фреймбуфер ядра для воспроизведения видео, альтернативная | |
3163 реализация. | |
3164 .PD 0 | |
3165 .RSs | |
3166 .IPs <устройство> | |
3167 Явно указывает имя используемого fbdev устройства (по-умолчанию: /dev/\:fb0). | |
20707 | 3168 .RE |
3169 .PD 1 | |
3170 . | |
3171 .TP | |
3172 .B "vesa\ \ \ " | |
20832 | 3173 Весьма универсальный драйвер, который должен работать на любой VESA VBE 2.0 |
3174 совместимой карте. | |
20707 | 3175 .PD 0 |
3176 .RSs | |
3177 .IPs "dga\ \ " | |
20832 | 3178 Включает режим DGA. |
20707 | 3179 .IPs nodga |
20832 | 3180 Выключает режим DGA. |
20707 | 3181 .IPs neotv_pal |
20832 | 3182 Активирует NeoMagic TV выход и устанавливает стандарт в PAL. |
20707 | 3183 .IPs neotv_ntsc |
20832 | 3184 Активирует NeoMagic TV выход и устанавливает стандарт в NTSC. |
20707 | 3185 .IPs vidix |
20832 | 3186 Указывает использовать VIDIX драйвер. |
20707 | 3187 .IPs "lvo:\ \ \ " |
20832 | 3188 Активирует видео оверлей Linux поверх VESA режима. |
20707 | 3189 .RE |
3190 .PD 1 | |
3191 . | |
3192 .TP | |
3193 .B "svga\ \ \ " | |
20832 | 3194 Воспроизводит видео, используя библиотеку SVGA. |
3195 .PD 0 | |
3196 .RSs | |
3197 .IPs "<видео режим>" | |
3198 Указывает используемый видео режим. | |
3199 Режим может быть задан в форме <ширина>x<высота>x<цветов>, | |
3200 например 640x480x16M или номером графического режима, например 84. | |
20707 | 3201 .IPs bbosd |
20832 | 3202 Выводит OSD на черных полях под изображением (медленнее). |
20707 | 3203 .IPs native |
20832 | 3204 Указывает использовать только 'нативные' функции. |
3205 Это отключает прямой рендеринг, OSD и аппаратное ускорение. | |
20707 | 3206 .IPs retrace |
20832 | 3207 .\" FIXME как коротко перевести vertical retrace? Существующий перевод |
3208 .\" не совсем верный (и звучит ужасно). | |
3209 Форсирует переключение кадров между циклами | |
3210 вертикальной развертки. | |
3211 Может использоваться только с \-double. | |
3212 Имеет тот же эффект, что и опция \-vsync. | |
20707 | 3213 .IPs "sq\ \ \ " |
20832 | 3214 Пытается выбрать видео режим с квадратными пикселами. |
20707 | 3215 .IPs vidix |
20832 | 3216 Указывает использовать svga с VIDIX. |
20707 | 3217 .RE |
3218 .PD 1 | |
3219 . | |
3220 .TP | |
3221 .B "gl\ \ \ \ \ " | |
20832 | 3222 OpenGL драйвер вывода видео, простая версия. |
3223 Размер видео должен быть меньше максимального размера | |
3224 текстуры в вашей реализации OpenGL. | |
3225 Предполагается, что будет работать даже с самыми простыми | |
3226 реализациями OpenGL, но также может использовать новые | |
3227 расширения, позволяющие поддерживать большее количество | |
3228 цветовых пространств и прямой рендеринг. | |
3229 Пожалуйста, используйте \-dr, если это работает с вашей | |
3230 реализацией OpenGL, поскольку для больших разрешений | |
3231 это | |
3232 .B значительно | |
3233 увеличивает скорость. | |
3234 Код выполняет очень малое количество проверок, так что, если что-то не | |
3235 работает, это может быть вызвано отсутствием поддержки в вашей | |
3236 карте/OpenGL реализации, даже если вы не получаете никаких сообщений об | |
3237 ошибках. Используйте glxinfo или аналогичный инструмент, чтобы увидеть | |
3238 поддерживаемые расширения OpenGL. | |
20707 | 3239 .PD 0 |
3240 .RSs | |
3241 .IPs (no)manyfmts | |
20832 | 3242 Включает поддержку большего количества форматов цветов (RGB и BGR) (по-умолчанию: включено). |
3243 Требует OpenGL версии >= 1.2. | |
20707 | 3244 .IPs slice-height=<0\-...> |
20832 | 3245 Количество строк, копируемых в текстуру одним целым (по-умолчанию: 4). |
3246 0 для всего изображения. | |
3247 .br | |
3248 .I ЗАМЕЧАНИЕ: | |
3249 Если используется пространство цветов YUV (смотрите подопцию yuv), применяются | |
3250 особые правила: | |
20707 | 3251 .RSss |
20832 | 3252 Если декодер использует рендеринг по слоям (смотрите \-noslices), эта опция не |
3253 имеет эффекта, размеры слоев указываются используемым декодером. | |
3254 .br | |
3255 Если декодер не использует рендеринг по слоям, то значением по-умолчанию | |
3256 является 16. | |
20707 | 3257 .RE |
3258 .IPs (no)osd | |
20832 | 3259 Включает или выключает поддержку рендеринга OSD при помощи OpenGL |
3260 (по-умолчанию: включено). Эта опция используется для тестирования; | |
3261 для отключения OSD используйте вместо нее \-osdlevel 0. | |
20707 | 3262 .IPs (no)scaled-osd |
20832 | 3263 Изменяет реакцию OSD на изменение размера окна (по-умолчанию: отключено). |
3264 .\" FIXME is translation correct ? | |
3265 .\" When enabled behaves more like the other video output drivers, | |
3266 .\" which is better for fixed-size fonts. | |
3267 .\" Disabled looks much better with FreeType fonts and uses the | |
3268 .\" borders in fullscreen mode. | |
3269 Когда включено, поведение такое же как и с остальными драйверами вывода | |
3270 видео, что лучше для шрифтов фиксированного размера. | |
3271 Когда отключено, то выглядит намного лучше со шрифтами TrueType и | |
3272 использует границы в полноэкранном режиме. | |
3273 С ass субтитрами (смотрите \-ass) работает некорректно. | |
20707 | 3274 .IPs osdcolor=<0xRRGGBB> |
20832 | 3275 Цвет для OSD (по-умолчанию: 0xffffff, соответствует белому цвету). |
20707 | 3276 .IPs (no)aspect |
20832 | 3277 Включает или выключает масштабирование с сохранением пропорций и поддержку |
3278 pan-and-scan (по-умолчанию: включено). | |
3279 Отключение может немного увеличить скорость. | |
20707 | 3280 .IPs rectangle=<0,1,2> |
20832 | 3281 Выбирает использование прямоугольныйх текстур, что экономит видеопамять, но |
3282 зачастую работает медленнее (по-умолчанию: 0). | |
20707 | 3283 .RSss |
20832 | 3284 0: Указывает использовать текстуры power-of-two (по-умолчанию). |
3285 .br | |
3286 1: Указывает использовать расширение GL_ARB_texture_rectangle. | |
3287 .br | |
3288 2: Указывает использовать расширение GL_ARB_texture_non_power_of_two. | |
3289 В некоторых случаях поддерживается только программно и, поэтому, очень медленно. | |
20707 | 3290 .RE |
3291 .IPs (no)glfinish | |
20832 | 3292 Вызывает glFinish() перед сменой буферов. |
3293 Медленнее, но в некоторых случаях дает более правильный результат (по-умолчанию: отключено). | |
20707 | 3294 .IPs swapinterval=<n> |
20832 | 3295 Минимальный интервал между сменами буферов, посчитанный в отображаемых |
3296 кадрах (по-умолчанию: 1). | |
3297 1 эквивалентно включению VSYNC, 0 - отключению VSYNC. | |
3298 Значения меньше 0 оставят его равным системному значению по-умолчанию. | |
3299 Это ограничивает частоту кадров значением (частота горизонтальной развертки / n). | |
3300 Для работы требуется поддержка GLX_SGI_swap_control. | |
3301 С некоторыми (многими/всеми?) реализациями работает только в полноэкранном режиме. | |
20707 | 3302 .IPs yuv=<n> |
20832 | 3303 Указывает тип преобразования YUV в RGB. |
20707 | 3304 .RSss |
20832 | 3305 0: Используется программное преобразование (по-умолчанию). |
3306 Совместимо со всеми версиями OpenGL. | |
3307 Предоставляет возможность управления яркостью, контрастностью и насыщенностью. | |
3308 .br | |
3309 .\" FIXME register combiners - блоки объединения регистров | |
3310 1: Используются блоки объединения регистров | |
3311 Используется nVidia-специфичное расширение (GL_NV_register_combiners). | |
3312 Требуются, как минимум, три текстуры. | |
3313 Предоставляет возможность управления насыщенностью и цветностью. | |
3314 Это быстрый, но не точный метод. | |
3315 .br | |
3316 .\" FIXME fragment program - программа фрагментации | |
3317 2: Используется программа фрагментации. | |
3318 Требуется расширение GL_ARB_fragment_program и, как минимум, три текстуры. | |
3319 Предоставляет возможность управления яркостью, контрастностью, | |
3320 насыщенностью и цветностью. | |
3321 .br | |
3322 .\" FIXME fragment program - программа фрагментации | |
3323 3: Используется программа фрагментации, используя POW инструкции. | |
3324 Требуется расширение GL_ARB_fragment_program и, как минимум, три текстуры. | |
3325 Предоставляет возможность управления яркостью, контрастностью, | |
3326 насыщенностью, цветностью и гаммой. | |
3327 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3328 Метод 4, как правило, быстрее. | |
3329 .br | |
3330 .\" FIXME fragment program - программа фрагментации | |
3331 4: Используется программа фрагментации с дополнительный поиском. | |
3332 Требуется расширение GL_ARB_fragment_program и, как минимум, | |
3333 четыре текстуры. | |
3334 Предоставляет возможность управления яркостью, контрастностью, насыщенностью, | |
3335 цветностью, и гаммой. | |
3336 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3337 .br | |
3338 5: Используется ATI-специфичный метод (для старых карт). | |
3339 при этом используется ATI-специфичное расширение | |
3340 (GL_ATI_fragment_shader - не GL_ARB_fragment_shader!). | |
3341 Необходимы, как минимум, три текстуры. | |
3342 Предоставляет возможность управления насыщенностью и цветностью. | |
3343 Это быстрый, но не точный метод. | |
3344 .br | |
3345 6: Используется 3D текстура для преобразования через поиск. | |
3346 Требуется расширение GL_ARB_fragment_program и, как минимум, четыре тестуры. | |
3347 Ужасно медленный (программная эмуляция) на некоторых (всех?) картах ATI, | |
3348 поскольку использует текстуру с пограничными пикселами. | |
3349 Предоставляет возможность управления яркостью, контрастностью, насыщенностью, | |
3350 цветностью, и гаммой. | |
3351 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3352 Скорость зависит от пропускной способности памяти GPU значительно сильнее, чем | |
3353 в остальных методах. | |
20707 | 3354 .RE |
3355 .IPs lscale=<n> | |
20832 | 3356 Выбирает функцию для масштабирования яркостность составляющей. |
3357 Допустимо только для 2, 3, 4 и 6 режимов yuv. | |
20707 | 3358 .RSss |
20832 | 3359 0: Используется простая линейная фильтрация (по-умолчанию). |
3360 .br | |
3361 1: Используется бикубическая фильтрация (повышенное качество). | |
3362 Требует одну дополнительную текстуру. | |
3363 Старые карты не смогут обработать с ее помощью цветовую составляющую, как минимум, | |
3364 в полноэкранном режиме. | |
20707 | 3365 .RE |
3366 .IPs cscale=<n> | |
20832 | 3367 Выбирает функцию для масштабирования цветовой составляющей. |
3368 Подробности смотрите в lscale. | |
3369 .IPs customprog=<файл> | |
3370 .\" FIXME fragment program - программа фрагментации | |
3371 Загружает нестандартную программу фрагментации из файла <файл>. | |
3372 пример смотрите в TOOLS/edgedect.fp. | |
3373 .IPs customtex=<файл> | |
3374 Загружает нестандартную "gamma ramp" текстуру из файла <файл>. | |
3375 Может использоваться совместно с yuv=4 или с опцией customprog. | |
20707 | 3376 .IPs (no)customtlin |
20832 | 3377 Если включено (по-умолчанию), для customtex текстуры используется GL_LINEAR |
3378 интерполяция, иначе - GL_NEAREST. | |
20707 | 3379 .IPs (no)customtrect |
20832 | 3380 Если включено, используется texture_rectangle для customtex текстуры. |
3381 По-умолчанию отключено. | |
20707 | 3382 .REss |
3383 .RE | |
3384 .PD 1 | |
3385 . | |
3386 .TP | |
3387 .B "gl2\ \ \ \ " | |
20832 | 3388 OpenGL драйвер вывода, второе поколение. |
3389 Поддерживает OSD и видео с размером больше допустимого для текстуры. | |
20707 | 3390 .PD 0 |
3391 .RSs | |
3392 .IPs (no)glfinish | |
20832 | 3393 То же, что и для gl (по-умолчанию: включено) |
20707 | 3394 .IPs yuv=<n> |
20832 | 3395 Указывает тип преобразования YUV в RGB. |
3396 Если установлено во что-либо, отличное от 0, то OSD выводиться не будет и | |
3397 регулировки яркости, контрастности и гаммы будут доступны только через | |
3398 глобальные настройки X сервера. | |
3399 В остальном значения те же, что и для \-vo gl. | |
20707 | 3400 .REss |
3401 . | |
3402 .TP | |
3403 .B "null\ \ \ " | |
20832 | 3404 Вы выводит никакого видео, |
3405 полезен для тестов производительности. | |
20707 | 3406 . |
3407 .TP | |
3408 .B "aa\ \ \ \ \ " | |
20832 | 3409 Драйвер вывода ASCII art, работающий в текстовой консоли. |
3410 Вы можете получить список и описание доступных подопций запустив | |
20707 | 3411 .I mplayer \-vo aa:help |
3412 . | |
3413 .TP | |
3414 .B "caca\ \ \ " | |
20832 | 3415 Драйвер вывода видео Color ASCII art, выботающий в текстовой консоли. |
20707 | 3416 . |
3417 .TP | |
3418 .B "bl\ \ \ \ \ " | |
20832 | 3419 Воспроизведение видео с использованием Blinkenlights UDP протокола. |
3420 Драйвер очень сильно аппаратно зависим. | |
3421 .PD 0 | |
3422 .RSs | |
3423 .IPs <подустройство> | |
3424 Явно указывает драйвер используемого подустройства Blinkenlights. | |
3425 Он выглядит как arcade:host=localhost:2323 или | |
20707 | 3426 hdl:file=name1,file=name2. |
20832 | 3427 Вы обязательно должны указать подустройство. |
20707 | 3428 .RE |
3429 .PD 1 | |
3430 . | |
3431 .TP | |
3432 .B "ggi\ \ \ \ " | |
20832 | 3433 Драйвер вывода видео графической системы GGI |
3434 .PD 0 | |
3435 .RSs | |
3436 .IPs <драйвер> | |
3437 Явно указывает используемый GGI драйвер. | |
3438 Замените любые ',', которые могут появиться в строке драйвера, на '.'. | |
20707 | 3439 .RE |
3440 .PD 1 | |
3441 . | |
3442 .TP | |
3443 .B directfb | |
20832 | 3444 Воспроизводит видео, используя библиотеку DirectFB. |
20707 | 3445 .PD 0 |
3446 .RSs | |
3447 .IPs (no)input | |
20832 | 3448 Указывает использовать коды клавиш DirectFB вместо кодов MPlayer (по-умолчанию: включено). |
20707 | 3449 .IPs buffermode=single|double|triple |
20832 | 3450 Двойная и тройная буферизация дает лучшие результаты, если вы хотите |
3451 .\" FIXME tearing - мерцание | |
3452 избежать мерцания. Тройная буферизация эффективнее двойной, поскольку | |
3453 .\" FIXME: vertical retrace | |
3454 она не блокирует MPlayer во время ожидания цикла обновления экрана монитора. | |
3455 Одиночной буферизации стоит избегать (по-умолчанию: single). | |
20707 | 3456 .IPs fieldparity=top|bottom |
20832 | 3457 Управляет порядком вывода чередующихся полей (по-умолчанию: отключено). |
3458 Допустимые значения: top = верхнее поле первое, bottom = нижнее поле первое. | |
3459 Это опция никак не влияет на прогрессивное видео, каковым являются большинство | |
3460 .\" FIXME tearing - мерцание | |
3461 MPEG фильмов, потребуется ее установить, если во время просмотра черезстрочного | |
3462 материала появляется мерцание или эффект гребенки при движении. | |
20707 | 3463 .IPs layer=N |
20832 | 3464 Форсирует для отображения слой с ID N (по-умолчанию: -1 - авто). |
3465 .IPs dfbopts=<список> | |
3466 Указывает список параметров для DirectFB. | |
20707 | 3467 .RE |
3468 .PD 1 | |
3469 . | |
3470 .TP | |
3471 .B "dfbmga\ " | |
20832 | 3472 Драйвер вывода видео для Matrox G400/\:G450/\:G550, использующий |
3473 библиотеку DirectFB для задействования особых возможностей оборудования. | |
3474 Задействует CRTC2 (вторую "голову"), отображая видео независимо от первой "головы". | |
20707 | 3475 .PD 0 |
3476 .RSs | |
3477 .IPs (no)input | |
20832 | 3478 То же, что и для directfb (по-умолчанию: отключено) |
20707 | 3479 .IPs buffermode=single|double|triple |
20832 | 3480 То же, что и для directfb (по-умолчанию: triple) |
20707 | 3481 .IPs fieldparity=top|bottom |
20832 | 3482 То же, что и для directfb |
20707 | 3483 .IPs (no)bes |
20832 | 3484 Задействует использование Matrox BES (модуля масштабирования) (по-умолчанию: отключено). |
3485 Дает отличный результат по скорости и качеству изображения, поскольку | |
3486 интерполяция производится аппаратно. Работает только на главной "голове". | |
20707 | 3487 .IPs (no)spic |
20832 | 3488 .\" FIXME correct translation of sub picture layer |
3489 Задействует использование специального слоя [sub picture layer] для отображения | |
3490 OSD (по-умолчанию: отключено). | |
20707 | 3491 .IPs (no)crtc2 |
20832 | 3492 Включает TV-выход на второй "голове" (по-умолчанию: включено). |
3493 Качество вывода удивительное, т.к. это полностью черезстрочное | |
3494 изображение с правильной синхронизацией каждого четнымого/\:нечетного поля. | |
20707 | 3495 .IPs tvnorm=pal|ntsc|auto |
20832 | 3496 Установит TV стандарт Matrox карты без необходимости |
3497 изменения /etc/\:directfbrc (по-умолчанию: отключено). | |
3498 Допустимые стандарты: pal = PAL, ntsc = NTSC. | |
3499 auto - особый стандарт (автоопределение использования PAL/\:NTSC), потому что | |
3500 он определяет используемый стандарт по частоте кадров фильма. | |
3501 .RE | |
3502 .PD 1 | |
3503 . | |
3504 .TP | |
3505 .B mga (только Linux) | |
3506 Драйвер вывода видео для Matrox, использующий модуль YUV масштабирования | |
3507 на Gxxx картах через драйвер ядра. | |
3508 Если у вас карта Matrox, то это самый быстрый вариант. | |
3509 .PD 0 | |
3510 .RSs | |
3511 .IPs <устройство> | |
3512 Явно указывает имя используемого Matrox устройства (по-цмолчанию: /dev/\:mga_vid). | |
3513 .RE | |
3514 .PD 1 | |
3515 . | |
3516 .TP | |
3517 .B xmga (только Linux, X11) | |
3518 Драйвер вывода видео mga, работающий в окне X11. | |
3519 .PD 0 | |
3520 .RSs | |
3521 .IPs <устройство> | |
3522 Явно указывает имя используемого Matrox устройства (по-цмолчанию: /dev/\:mga_vid). | |
20707 | 3523 .RE |
3524 .PD 1 | |
3525 . | |
3526 .TP | |
3527 .B "syncfb\ " | |
20832 | 3528 Драйвер вывода видео для SyncFB модуля ядра, предоставляющего |
3529 особые возможности Matrox Gxxx Карт, такие как аппаратные деинтерлейс, | |
3530 масштабирование и синхронизация видео с частотой вертикальной развертки | |
3531 вашего монитора. | |
3532 . | |
3533 .TP | |
3534 .B 3dfx (только Linux) | |
3535 Драйвер вывода для 3dfx. | |
3536 Этот драйвер работает напрямую c 3dfx оборудованием поверх X11. | |
3537 Поддерживается только 16 bpp. | |
3538 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
20707 | 3539 . |
3540 .TP | |
3541 .B tdfxfb (Linux only) | |
20832 | 3542 Этот драйвер работает с tdfx драйвером фреймбуфера для воспроизведения |
3543 фильмов с YUV ускорением на 3dfx картах. | |
3544 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
3545 .PD 0 | |
3546 .RSs | |
3547 .IPs <устройство> | |
3548 Явно указывает используемое fbdev устройство (по-умолчанию: /dev/\:fb0). | |
3549 .RE | |
3550 .PD 1 | |
3551 . | |
3552 .TP | |
3553 .B tdfx_vid (только Linux) | |
3554 Драйвер вывода видео для 3dfx. | |
3555 Этот драйвер напрямую использует драйвер ядра tdfx_vid. | |
3556 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
20707 | 3557 .PD 0 |
3558 .RSs | |
3559 .IPs <device> | |
20832 | 3560 Явно указывает имя используемого устройства (по-умолчанию: /dev/\:tdfx_vid). |
3561 .RE | |
3562 .PD 1 | |
3563 . | |
3564 .TP | |
3565 .B dxr2 (смотрите также \-dxr2) (только DXR2) | |
3566 Драйвер вывода видео Creative DXR2. | |
20707 | 3567 .PD 0 |
3568 .RSs | |
3569 .IPs <vo_driver> | |
20832 | 3570 Поддрайвер вывода видео, для использования в качестве оверлея (x11, xv). |
3571 .RE | |
3572 .PD 1 | |
3573 . | |
3574 .TP | |
3575 .B dxr3 (только DXR3) | |
3576 Драйвер выода видео чипов MPEG декодирования | |
3577 Sigma Designs em8300 (Creative DXR3, Sigma Designs | |
3578 Hollywood Plus). | |
3579 Смотрите также видео фильтр lavc. | |
20707 | 3580 .PD 0 |
3581 .RSs | |
3582 .IPs overlay | |
20832 | 3583 Активирует оверлей вместо TV вывода. |
20707 | 3584 .IPs prebuf |
20832 | 3585 Включает пребуферинг. |
20707 | 3586 .IPs "sync\ " |
20832 | 3587 Задействует новую систему синхронизации. |
3588 .IPs norm=<стандарт> | |
3589 Указывает TV стандарт. | |
20707 | 3590 .RSss |
20832 | 3591 0: Не изменяет текущий стандарт (по-умолчанию). |
3592 .br | |
3593 1: Автоопределение использования PAL/\:NTSC. | |
3594 .br | |
3595 2: Автоопределение использования PAL/\:PAL-60. | |
20707 | 3596 .br |
3597 3: PAL | |
3598 .br | |
3599 4: PAL-60 | |
3600 .br | |
3601 5: NTSC | |
3602 .REss | |
3603 .IPs <0\-3> | |
20832 | 3604 Указывает номер используемого устройства, если у вас установлено более одной |
3605 em8300 карты. | |
3606 .RE | |
3607 .PD 1 | |
3608 . | |
3609 .TP | |
3610 .B ivtv (только IVTV) | |
3611 Драйвер вывода через TV-Выход карт MPEG декодирования, основанных на для чипах | |
3612 Conexant CX23415 (iCompression iTVC15) или Conexant CX23416 (iCompression | |
3613 iTVC16), (Hauppauge WinTV PVR-150/250/350/500). | |
3614 Смотрите также видео фильтр lavc. | |
20707 | 3615 .PD 0 |
3616 .RSs | |
3617 .IPs device | |
20832 | 3618 Явно указывает имя устройства используемого MPEG декодера (по-умолчанию: /dev/video16). |
20707 | 3619 .IPs output |
20832 | 3620 Увно указывает используемый для видеосигнала TV-Выход. |
3621 .RE | |
3622 .PD 1 | |
3623 . | |
3624 .TP | |
3625 .B mpegpes (только DVB) | |
3626 Драйвер вывода видео DVB карт, записывающий вывод в MPEG-PES файл, если | |
3627 нет установленных DVB карт. | |
20707 | 3628 .PD 0 |
3629 .RSs | |
3630 .IPs card=<1\-4> | |
20832 | 3631 Указывает номер используемого устройства, если у вас более одной карты |
3632 (поддерживается только V3 API, такое как в драйверах 1.x.y серии). | |
3633 .IPs <файл> | |
3634 Файл для вывода (по-умолчанию: ./grab.mpg) | |
3635 .RE | |
3636 .PD 1 | |
3637 . | |
3638 .TP | |
3639 .B zr (смотрите также \-zr* и \-zrhelp) | |
3640 Драйвер вывода видео для некоторых MJPEG карт завата/\:воспроизведения. | |
3641 . | |
3642 .TP | |
3643 .B zr2 (смотрите также видео фильтр zrmjpeg) | |
3644 Драйвер вывода видео для некоторых MJPEG карт завата/\:воспроизведения, | |
3645 второе поколение. | |
3646 .PD 0 | |
3647 .RSs | |
3648 .IPs dev=<устройство> | |
3649 Указывает используемое устройство. | |
20707 | 3650 .IPs norm=<PAL|NTSC|SECAM|auto> |
20832 | 3651 Указывает используемый видео стандарт (по-умолчанию: авто). |
20707 | 3652 .IPs (no)prebuf |
20832 | 3653 (Де)Активирует пребуферинг, пока не поддерживается. |
20707 | 3654 .RE |
3655 .PD 1 | |
3656 . | |
3657 .TP | |
3658 .B "md5sum\ " | |
20832 | 3659 Рассчитывает MD5 сумму каждого кадра и записывает ее в файл. |
3660 Поддерживаются цветовые пространства RGB24 и YV12. | |
3661 Полезно для отладки. | |
3662 .PD 0 | |
3663 .RSs | |
3664 .IPs outfile=<значение> | |
3665 Указывает имя файла для вывода (по-умолчанию: ./md5sums). | |
20707 | 3666 .RE |
3667 .PD 1 | |
3668 . | |
3669 .TP | |
3670 .B yuv4mpeg | |
20832 | 3671 Преобразует видео поток в последовательность несжатых YUV 4:2:0 |
3672 изображений и сохраняет ее в файл (по-умолчанию: ./stream.yuv). | |
3673 Формат такой же, как и в mjpegtools, так что это полезно для | |
3674 обработки видео комплектом mjpegtools. | |
3675 Поддерживаются YV12, RGB (24 bpp) и BGR (24 bpp) форматы. | |
3676 Вы можете указывать ее совместно с опцией \-fixed-vo для | |
3677 объединения файлов с одинаковыми разрешениями и частотой кадров. | |
20707 | 3678 .PD 0 |
3679 .RSs | |
3680 .IPs interlaced | |
20832 | 3681 Зыписывает кадры в файл как черезстрочные с первым верхним полем. |
20707 | 3682 .IPs interlaced_bf |
20832 | 3683 Зыписывает кадры в файл как черезстрочные с первым нижним полем. |
3684 .IPs file=<файл> | |
3685 Записывает вывод в <файл> вместо стандартного stream.yuv. | |
20707 | 3686 .REss |
3687 .PD 1 | |
3688 .RS | |
3689 .sp 1 | |
20832 | 3690 .I ЗАМЕЧАНИЕ: |
3691 Если вы не указываете никаких опций, то вывод будет прогрессивным | |
3692 (т.е. нечерезстрочным). | |
20707 | 3693 .RE |
3694 . | |
3695 .TP | |
3696 .B "gif89a\ " | |
20832 | 3697 Выводит кадры в один анимированный GIF в текущем каталоге. |
3698 Поддерживается только формат RGB с глубиной цвета 24 бит, результат также | |
3699 будет преобразован в 256 цветный. | |
20707 | 3700 .PD 0 |
3701 .RSs | |
3702 .IPs <fps> | |
20832 | 3703 Вещественное число, указывающее частоту кадров (по-умолчанию: 5.0). |
3704 .IPs <файл> | |
3705 Указывает имя файла для вывода (по-умолчанию: ./out.gif). | |
20707 | 3706 .REss |
3707 .PD 1 | |
3708 .RS | |
3709 .sp 1 | |
20832 | 3710 .I ЗАМЕЧАНИЕ: |
3711 Вы должны указать частоту кадров до имени, иначе это значение будет | |
3712 частью имени файла. | |
3713 .sp 1 | |
3714 .I ПРИМЕР: | |
20707 | 3715 .RE |
3716 .PD 0 | |
3717 .RSs | |
3718 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif | |
3719 .RE | |
3720 .PD 1 | |
3721 . | |
3722 .TP | |
3723 .B "jpeg\ \ \ " | |
20832 | 3724 Выводит каждый кадр в JPEG файл в текущем каталоге. |
3725 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
20707 | 3726 .PD 0 |
3727 .RSs | |
3728 .IPs [no]progressive | |
20832 | 3729 Указывает создавать обычный или прогрессивный JPEG (по-умолчанию: обычный). |
20707 | 3730 .IPs [no]baseline |
20832 | 3731 Указывает использовать базовую линию [baseline] или нет (по-умолчанию: использовать). |
20707 | 3732 .IPs optimize=<0\-100> |
20832 | 3733 Степень оптимизации (по-умолчанию: 100) |
20707 | 3734 .IPs smooth=<0\-100> |
20832 | 3735 Степень размытия (по-умолчанию: 0) |
20707 | 3736 .IPs quality=<0\-100> |
20832 | 3737 Уровень качества (default: 75) |
3738 .IPs outdir=<каталог> | |
3739 Указывает каталог для вывода JPEG файлов (по-умолчанию: ./). | |
3740 .IPs subdirs=<префикс> | |
3741 Вместо использования текущего каталога создает нумерованные подкаталоги | |
3742 с указанным префиксом для сохранения файлов. | |
20707 | 3743 .IPs maxfiles=<value> (subdirs only) |
20832 | 3744 Максимальное количество файлов, сохраняемых в подкаталоге. |
3745 Должно быть больше или равно 1 (по-умолчанию: 1000). | |
20707 | 3746 .RE |
3747 .PD 1 | |
3748 . | |
3749 .TP | |
3750 .B "pnm\ \ \ \ " | |
20832 | 3751 Выводит каждый кадр в PNM файл в текущем каталоге. |
3752 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
3753 Поддерживаются файлы PPM, PGM и PGMYUV, как в raw, так и в ASCII режиме. | |
3754 Смотрите также pnm(5), ppm(5) и pgm(5). | |
20707 | 3755 .PD 0 |
3756 .RSs | |
3757 .IPs "ppm\ \ " | |
20832 | 3758 Записывает PPM файлы (по-умолчанию). |
20707 | 3759 .IPs "pgm\ \ " |
20832 | 3760 Записывает PGM файлы. |
20707 | 3761 .IPs pgmyuv |
20832 | 3762 Выводит PGMYUV файлы. |
3763 PGMYUV похож на PGM, но дополнительно содержит U и V компоненты, | |
3764 присоединенные к нижней части картинки. | |
3765 . | |
20707 | 3766 .IPs "raw\ \ " |
20832 | 3767 Записывает PNM файлы в raw режиме (по-умолчанию). |
20707 | 3768 .IPs ascii |
20832 | 3769 Записывает PNM файлы в ASCII режиме. |
3770 .IPs outdir=<каталог> | |
3771 Указывает каталог для сохранения PNM файлов (по-умолчанию: ./). | |
3772 .IPs subdirs=<префикс> | |
3773 Вместо использования текущего каталога создает нумерованные подкаталоги | |
3774 с указанным префиксом для сохранения файлов. | |
3775 .IPs maxfiles=<число> (только subdirs) | |
3776 Максимальное количество файлов, сохраняемых в подкаталоге. | |
3777 Должно быть больше или равно 1 (по-умолчанию: 1000). | |
20707 | 3778 .RE |
3779 .PD 1 | |
3780 . | |
3781 .TP | |
3782 .B "png\ \ \ \ " | |
20832 | 3783 Выводит каждый кадр в PNG файл в текущем каталоге. |
3784 Название файла формируется из номера кадра, дополненного слева нолями. | |
3785 Поддерживаются 24bpp RGB и BGR форматы. | |
20707 | 3786 .PD 0 |
3787 .RSs | |
3788 .IPs z=<0-9> | |
20832 | 3789 Указываеть степень сжатия. |
3790 0 - без сжатия, 9 - максимальное сжатие. | |
20707 | 3791 .RE |
3792 .PD 1 | |
3793 . | |
3794 .TP | |
3795 .B "tga\ \ \ \ " | |
20832 | 3796 Выводит каждый кадр в файл Targa в текущем каталоге. |
3797 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
3798 Назначение этого драйвера - сохранить кадры без потери качества, | |
3799 не используя сторонних библиотек. | |
3800 Он поддерживает BGR[A] формат с глубиной цвета 15, 24 или 32. | |
3801 Вы можете выбрать специфичный формат с помощью видео фильтра format. | |
3802 .sp 1 | |
3803 .I ПРИМЕР: | |
20707 | 3804 .RE |
3805 .PD 0 | |
3806 .RSs | |
3807 mplayer video.nut \-vf format=bgr15 \-vo tga | |
3808 .RE | |
3809 .PD 1 | |
3810 . | |
3811 . | |
3812 . | |
3813 .SH "DECODING/FILTERING OPTIONS" | |
3814 . | |
3815 .TP | |
3816 .B \-ac <[-|+]codec1,[-|+]codec2,...[,]> | |
3817 Specify a priority list of audio codecs to be used, according to their codec | |
3818 name in codecs.conf. | |
3819 Use a '-' before the codec name to omit it. | |
3820 Use a '+' before the codec name to force it, this will likely crash! | |
3821 If the list has a trailing ',' MPlayer will fall back on codecs not | |
3822 contained in the list. | |
3823 .br | |
3824 .I NOTE: | |
3825 See \-ac help for a full list of available codecs. | |
3826 .sp 1 | |
3827 .I EXAMPLE: | |
3828 .PD 0 | |
3829 .RSs | |
3830 .IPs "\-ac mp3acm" | |
3831 Force the l3codeca.acm MP3 codec. | |
3832 .IPs "\-ac mad," | |
3833 Try libmad first, then fall back on others. | |
3834 .IPs "\-ac hwac3,a52," | |
3835 Try hardware AC3 passthrough, software AC3, then others. | |
3836 .IPs "\-ac hwdts," | |
3837 Try hardware DTS passthrough, then fall back on others. | |
3838 .IPs "\-ac -ffmp3," | |
3839 Skip FFmpeg's MP3 decoder. | |
3840 .RE | |
3841 .PD 1 | |
3842 . | |
3843 .TP | |
3844 .B \-af-adv <force=(0\-7):list=(filters)> (also see \-af) | |
3845 Specify advanced audio filter options: | |
3846 .RSs | |
3847 .IPs force=<0\-7> | |
3848 Forces the insertion of audio filters to one of the following: | |
3849 .RSss | |
3850 0: Use completely automatic filter insertion. | |
3851 .br | |
3852 1: Optimize for accuracy (default). | |
3853 .br | |
3854 2: Optimize for speed. | |
3855 .I Warning: | |
3856 Some features in the audio filters may silently fail, | |
3857 and the sound quality may drop. | |
3858 .br | |
3859 3: Use no automatic insertion of filters and no optimization. | |
3860 .I Warning: | |
3861 It may be possible to crash MPlayer using this setting. | |
3862 .br | |
3863 4: Use automatic insertion of filters according to 0 above, | |
3864 but use floating point processing when possible. | |
3865 .br | |
3866 5: Use automatic insertion of filters according to 1 above, | |
3867 but use floating point processing when possible. | |
3868 .br | |
3869 6: Use automatic insertion of filters according to 2 above, | |
3870 but use floating point processing when possible. | |
3871 .br | |
3872 7: Use no automatic insertion of filters according to 3 above, | |
3873 and use floating point processing when possible. | |
3874 .REss | |
3875 .IPs list=<filters> | |
3876 Same as \-af. | |
3877 .RE | |
3878 . | |
3879 .TP | |
3880 .B \-afm <driver1,driver2,...> | |
3881 Specify a priority list of audio codec families to be used, according | |
3882 to their codec name in codecs.conf. | |
3883 Falls back on the default codecs if none of the given codec families work. | |
3884 .br | |
3885 .I NOTE: | |
3886 See \-afm help for a full list of available codec families. | |
3887 .sp 1 | |
3888 .I EXAMPLE: | |
3889 .PD 0 | |
3890 .RSs | |
3891 .IPs "\-afm ffmpeg" | |
3892 Try FFmpeg's libavcodec codecs first. | |
3893 .IPs "\-afm acm,dshow" | |
3894 Try Win32 codecs first. | |
3895 .RE | |
3896 .PD 1 | |
3897 . | |
3898 .TP | |
3899 .B \-aspect <ratio> (also see \-zoom) | |
3900 Override movie aspect ratio, in case aspect information is | |
3901 incorrect or missing in the file being played. | |
3902 .sp 1 | |
3903 .I EXAMPLE: | |
3904 .PD 0 | |
3905 .RSs | |
3906 \-aspect 4:3 or \-aspect 1.3333 | |
3907 .br | |
3908 \-aspect 16:9 or \-aspect 1.7777 | |
3909 .RE | |
3910 .PD 1 | |
3911 . | |
3912 .TP | |
3913 .B \-noaspect | |
3914 Disable automatic movie aspect ratio compensation. | |
3915 . | |
3916 .TP | |
3917 .B "\-flip \ " | |
3918 Flip image upside-down. | |
3919 . | |
3920 .TP | |
3921 .B \-lavdopts <option1:option2:...> (DEBUG CODE) | |
3922 Specify libavcodec decoding parameters. | |
3923 Separate multiple options with a colon. | |
3924 .sp 1 | |
3925 .I EXAMPLE: | |
3926 .PD 0 | |
3927 .RSs | |
3928 \-lavdopts gray:skiploopfilter=all:skipframe=nonref | |
3929 .RE | |
3930 .PD 1 | |
3931 .sp 1 | |
3932 .RS | |
3933 Available options are: | |
3934 .RE | |
3935 .RSs | |
3936 .IPs bitexact | |
3937 Only use bit-exact algorithms in all decoding steps (for codec testing). | |
3938 .IPs bug=<value> | |
3939 Manually work around encoder bugs. | |
3940 .RSss | |
3941 0: nothing | |
3942 .br | |
3943 1: autodetect bugs (default) | |
3944 .br | |
3945 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection) | |
3946 .br | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
3947 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX) |
20707 | 3948 .br |
3949 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4) | |
3950 .br | |
3951 16 (mpeg4): padding bug (autodetected) | |
3952 .br | |
3953 32 (mpeg4): illegal vlc bug (autodetected per fourcc) | |
3954 .br | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
3955 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version) |
20707 | 3956 .br |
3957 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version) | |
3958 .br | |
3959 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version) | |
3960 .br | |
3961 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version) | |
3962 .br | |
3963 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version) | |
3964 .REss | |
3965 .IPs debug=<value> | |
3966 Display debugging information. | |
3967 .RSss | |
3968 .br | |
3969 0: disabled | |
3970 .br | |
3971 1: picture info | |
3972 .br | |
3973 2: rate control | |
3974 .br | |
3975 4: bitstream | |
3976 .br | |
3977 8: macroblock (MB) type | |
3978 .br | |
3979 16: per-block quantization parameter (QP) | |
3980 .br | |
3981 32: motion vector | |
3982 .br | |
3983 0x0040: motion vector visualization (use \-noslices) | |
3984 .br | |
3985 0x0080: macroblock (MB) skip | |
3986 .br | |
3987 0x0100: startcode | |
3988 .br | |
3989 0x0200: PTS | |
3990 .br | |
3991 0x0400: error resilience | |
3992 .br | |
3993 0x0800: memory management control operations (H.264) | |
3994 .br | |
3995 0x1000: bugs | |
3996 .br | |
3997 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener. | |
3998 .br | |
3999 0x4000: Visualize block types. | |
4000 .REss | |
4001 .IPs ec=<value> | |
4002 Set error concealment strategy. | |
4003 .RSss | |
4004 1: Use strong deblock filter for damaged MBs. | |
4005 .br | |
4006 2: iterative motion vector (MV) search (slow) | |
4007 .br | |
4008 3: all (default) | |
4009 .REss | |
4010 .IPs er=<value> | |
4011 Set error resilience strategy. | |
4012 .RSss | |
4013 .br | |
4014 0: disabled | |
4015 .br | |
4016 1: careful (Should work with broken encoders.) | |
4017 .br | |
4018 2: normal (default) (Works with compliant encoders.) | |
4019 .br | |
4020 3: aggressive (More checks, but might cause problems even for valid bitstreams.) | |
4021 .br | |
4022 4: very aggressive | |
4023 .REss | |
4024 .IPs "fast (MPEG-2 only)" | |
4025 Enable optimizations which do not comply to the specification and might | |
4026 potentially cause problems, like simpler dequantization, assuming use | |
4027 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few | |
4028 checks to detect damaged bitstreams. | |
4029 .IPs "gray\ " | |
4030 grayscale only decoding (a bit faster than with color) | |
4031 .IPs "idct=<0\-99> (see \-lavcopts)" | |
4032 For best decoding quality use the same IDCT algorithm for decoding and encoding. | |
4033 This may come at a price in accuracy, though. | |
4034 .IPs lowres=<number>[,<w>] | |
4035 Decode at lower resolutions. | |
4036 Low resolution decoding is not supported by all codecs, and it will | |
4037 often result in ugly artifacts. | |
4038 This is not a bug, but a side effect of not decoding at full resolution. | |
4039 .RSss | |
4040 .br | |
4041 0: disabled | |
4042 .br | |
4043 1: 1/2 resolution | |
4044 .br | |
4045 2: 1/4 resolution | |
4046 .br | |
4047 3: 1/8 resolution | |
4048 .REss | |
4049 .RS | |
4050 If <w> is specified lowres decoding will be used only if the width of the | |
4051 video is major than or equal to <w>. | |
4052 .RE | |
4053 .IPs "sb=<number> (MPEG-2 only)" | |
4054 Skip the given number of macroblock rows at the bottom. | |
4055 .IPs "st=<number> (MPEG-2 only)" | |
4056 Skip the given number of macroblock rows at the top. | |
4057 .IPs skiploopfilter=<skipvalue> (H.264 only) | |
4058 Skips the loop filter (AKA deblocking) during H.264 decoding. | |
4059 Since the filtered frame is supposed to be used as reference | |
4060 for decoding dependent frames this has a worse effect on quality | |
4061 than not doing deblocking on e.g.\& MPEG-2 video. | |
4062 But at least for high bitrate HDTV this provides a big speedup with | |
4063 no visible quality loss. | |
4064 .sp 1 | |
4065 <skipvalue> can be either one of the following: | |
4066 .RSss | |
4067 .br | |
4068 none: Never skip. | |
4069 .br | |
4070 default: Skip useless processing steps (e.g.\& 0 size packets in AVI). | |
4071 .br | |
4072 nonref: Skip frames that are not referenced (i.e.\& not used for | |
4073 decoding other frames, the error cannot "build up"). | |
4074 .br | |
4075 bidir: Skip B-Frames. | |
4076 .br | |
4077 nonkey: Skip all frames except keyframes. | |
4078 .br | |
4079 all: Skip all frames. | |
4080 .REss | |
4081 .IPs skipidct=<skipvalue> (MPEG1/2 only) | |
4082 Skips the IDCT step. | |
4083 This degrades quality a lot of in almost all cases | |
4084 (see skiploopfilter for available skip values). | |
4085 .IPs skipframe=<skipvalue> | |
4086 Skips decoding of frames completely. | |
4087 Big speedup, but jerky motion and sometimes bad artifacts | |
4088 (see skiploopfilter for available skip values). | |
4089 .IPs threads=<1\-8> | |
4090 number of threads to use for decoding (default: 1) | |
4091 .IPs vismv=<value> | |
4092 Visualize motion vectors. | |
4093 .RSss | |
4094 .br | |
4095 0: disabled | |
4096 .br | |
4097 1: Visualize forward predicted MVs of P-frames. | |
4098 .br | |
4099 2: Visualize forward predicted MVs of B-frames. | |
4100 .br | |
4101 4: Visualize backward predicted MVs of B-frames. | |
4102 .REss | |
4103 .IPs vstats | |
4104 Prints some statistics and stores them in ./vstats_*.log. | |
4105 .RE | |
4106 . | |
4107 .TP | |
4108 .B \-noslices | |
4109 Disable drawing video by 16-pixel height slices/\:bands, instead draws the | |
4110 whole frame in a single run. | |
4111 May be faster or slower, depending on video card and available cache. | |
4112 It has effect only with libmpeg2 and libavcodec codecs. | |
4113 . | |
4114 .TP | |
4115 .B \-nosound | |
4116 Do not play/\:encode sound. | |
4117 Useful for benchmarking. | |
4118 . | |
4119 .TP | |
4120 .B \-novideo | |
4121 Do not play/\:encode video. | |
4122 In many cases this will not work, use \-vc null \-vo null instead. | |
4123 . | |
4124 .TP | |
4125 .B \-pp <quality> (also see \-vf pp) | |
4126 Set the DLL postprocess level. | |
4127 This option is no longer usable with \-vf pp. | |
4128 It only works with Win32 DirectShow DLLs with internal postprocessing routines. | |
4129 The valid range of \-pp values varies by codec, it is mostly | |
4130 0\-6, where 0=disable, 6=slowest/\:best. | |
4131 . | |
4132 .TP | |
4133 .B \-pphelp (also see \-vf pp) | |
4134 Show a summary about the available postprocess filters and their usage. | |
4135 . | |
4136 .TP | |
4137 .B \-ssf <mode> | |
4138 Specifies software scaler parameters. | |
4139 .sp 1 | |
4140 .I EXAMPLE: | |
4141 .PD 0 | |
4142 .RSs | |
4143 \-vf scale \-ssf lgb=3.0 | |
4144 .RE | |
4145 .PD 1 | |
4146 .PD 0 | |
4147 .RSs | |
4148 .IPs lgb=<0\-100> | |
4149 gaussian blur filter (luma) | |
4150 .IPs cgb=<0\-100> | |
4151 gaussian blur filter (chroma) | |
4152 .IPs ls=<-100\-100> | |
4153 sharpen filter (luma) | |
4154 .IPs cs=<-100\-100> | |
4155 sharpen filter (chroma) | |
4156 .IPs chs=<h> | |
4157 chroma horizontal shifting | |
4158 .IPs cvs=<v> | |
4159 chroma vertical shifting | |
4160 .RE | |
4161 .PD 1 | |
4162 . | |
4163 .TP | |
4164 .B \-stereo <mode> | |
4165 Select type of MP2/\:MP3 stereo output. | |
4166 .PD 0 | |
4167 .RSs | |
4168 .IPs 0 | |
4169 stereo | |
4170 .IPs 1 | |
4171 left channel | |
4172 .IPs 2 | |
4173 right channel | |
4174 .RE | |
4175 .PD 1 | |
4176 . | |
4177 .TP | |
4178 .B \-sws <software scaler type> (also see \-vf scale and \-zoom) | |
4179 Specify the software scaler algorithm to be used with the \-zoom option. | |
4180 This affects video output drivers which lack hardware acceleration, e.g.\& x11. | |
4181 .sp 1 | |
4182 Available types are: | |
4183 .sp 1 | |
4184 .PD 0 | |
4185 .RSs | |
4186 .IPs 0 | |
4187 fast bilinear | |
4188 .IPs 1 | |
4189 bilinear | |
4190 .IPs 2 | |
4191 bicubic (good quality) (default) | |
4192 .IPs 3 | |
4193 experimental | |
4194 .IPs 4 | |
4195 nearest neighbor (bad quality) | |
4196 .IPs 5 | |
4197 area | |
4198 .IPs 6 | |
4199 luma bicubic / chroma bilinear | |
4200 .IPs 7 | |
4201 gauss | |
4202 .IPs 8 | |
4203 sincR | |
4204 .IPs 9 | |
4205 lanczos | |
4206 .IPs 10 | |
4207 natural bicubic spline | |
4208 .RE | |
4209 .PD 1 | |
4210 .sp 1 | |
4211 .RS | |
4212 .I NOTE: | |
4213 Some \-sws options are tunable. | |
4214 The description of the scale video filter has further information. | |
4215 .RE | |
4216 . | |
4217 .TP | |
4218 .B \-vc <[-|+]codec1,[-|+]codec2,...[,]> | |
4219 Specify a priority list of video codecs to be used, according to their codec | |
4220 name in codecs.conf. | |
4221 Use a '-' before the codec name to omit it. | |
4222 Use a '+' before the codec name to force it, this will likely crash! | |
4223 If the list has a trailing ',' MPlayer will fall back on codecs not | |
4224 contained in the list. | |
4225 .br | |
4226 .I NOTE: | |
4227 See \-vc help for a full list of available codecs. | |
4228 .sp 1 | |
4229 .I EXAMPLE: | |
4230 .PD 0 | |
4231 .RSs | |
4232 .IPs "\-vc divx" | |
4233 Force Win32/\:VfW DivX codec, no fallback. | |
4234 .IPs "\-vc -divxds,-divx," | |
4235 Skip Win32 DivX codecs. | |
4236 .IPs "\-vc ffmpeg12,mpeg12," | |
4237 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others. | |
4238 .RE | |
4239 .PD 1 | |
4240 . | |
4241 .TP | |
4242 .B \-vfm <driver1,driver2,...> | |
4243 Specify a priority list of video codec families to be used, according | |
4244 to their names in codecs.conf. | |
4245 Falls back on the default codecs if none of the given codec families work. | |
4246 .br | |
4247 .I NOTE: | |
4248 See \-vfm help for a full list of available codec families. | |
4249 .sp 1 | |
4250 .I EXAMPLE: | |
4251 .PD 0 | |
4252 .RSs | |
4253 .IPs "\-vfm ffmpeg,dshow,vfw" | |
4254 Try the libavcodec, then Directshow, then VfW codecs and fall back | |
4255 on others, if they do not work. | |
4256 .IPs "\-vfm xanim" | |
4257 Try XAnim codecs first. | |
4258 .RE | |
4259 .PD 1 | |
4260 . | |
4261 .TP | |
4262 .B \-x <x> (also see \-zoom) (MPlayer only) | |
4263 Scale image to width <x> (if software/\:hardware scaling is available). | |
4264 Disables aspect calculations. | |
4265 . | |
4266 .TP | |
4267 .B \-xvidopts <option1:option2:...> | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
4268 Specify additional parameters when decoding with Xvid. |
20707 | 4269 .br |
4270 .I NOTE: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
4271 Since libavcodec is faster than Xvid you might want to use the libavcodec |
20707 | 4272 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead. |
4273 .sp 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
4274 Xvid's internal postprocessing filters: |
20707 | 4275 .PD 0 |
4276 .RSs | |
4277 .IPs deblock-chroma (also see \-vf pp) | |
4278 chroma deblock filter | |
4279 .IPs deblock-luma (also see \-vf pp) | |
4280 luma deblock filter | |
4281 .IPs dering-luma (also see \-vf pp) | |
4282 luma deringing filter | |
4283 .IPs dering-chroma (also see \-vf pp) | |
4284 chroma deringing filter | |
4285 .IPs filmeffect (also see \-vf noise) | |
4286 Adds artificial film grain to the video. | |
4287 May increase perceived quality, while lowering true quality. | |
4288 .RE | |
4289 .sp 1 | |
4290 .RS | |
4291 rendering methods: | |
4292 .RE | |
4293 .PD 0 | |
4294 .RSs | |
4295 .IPs "dr2\ \ " | |
4296 Activate direct rendering method 2. | |
4297 .IPs nodr2 | |
4298 Deactivate direct rendering method 2. | |
4299 .RE | |
4300 .PD 1 | |
4301 . | |
4302 .TP | |
4303 .B \-xy <value> (also see \-zoom) | |
4304 .PD 0 | |
4305 .RSs | |
4306 .IPs value<=8 | |
4307 Scale image by factor <value>. | |
4308 .IPs value>8 | |
4309 Set width to value and calculate height to keep correct aspect ratio. | |
4310 .RE | |
4311 .PD 1 | |
4312 . | |
4313 .TP | |
4314 .B \-y <y> (also see \-zoom) (MPlayer only) | |
4315 Scale image to height <y> (if software/\:hardware scaling is available). | |
4316 Disables aspect calculations. | |
4317 . | |
4318 .TP | |
4319 .B "\-zoom\ \ " | |
4320 Allow software scaling, where available. | |
4321 This will allow scaling with output drivers (like x11, fbdev) that | |
4322 do not support hardware scaling where MPlayer disables scaling by | |
4323 default for performance reasons. | |
4324 . | |
4325 . | |
4326 . | |
4327 .SH "AUDIO FILTERS" | |
4328 Audio filters allow you to modify the audio stream and its properties. | |
4329 The syntax is: | |
4330 . | |
4331 .TP | |
4332 .B \-af <filter1[=parameter1:parameter2:...],filter2,...> | |
4333 Setup a chain of audio filters. | |
4334 .PP | |
4335 .I NOTE: | |
4336 To get a full list of available audio filters, see \-af help. | |
4337 .PP | |
4338 Available filters are: | |
4339 . | |
4340 .TP | |
4341 .B resample[=srate[:sloppy[:type]]] | |
4342 Changes the sample rate of the audio stream. | |
4343 Can be used if you have a fixed frequency sound card or if you are | |
4344 stuck with an old sound card that is only capable of max 44.1kHz. | |
4345 This filter is automatically enabled if necessary. | |
4346 It only supports 16-bit integer and float in native-endian format as input. | |
4347 .br | |
4348 .I NOTE: | |
4349 With MEncoder, you need to also use \-srate <srate>. | |
4350 .PD 0 | |
4351 .RSs | |
4352 .IPs <srate> | |
4353 output sample frequency in Hz. | |
4354 The valid range for this parameter is 8000 to 192000. | |
4355 If the input and output sample frequency are the same or if this | |
4356 parameter is omitted the filter is automatically unloaded. | |
4357 A high sample frequency normally improves the audio quality, | |
4358 especially when used in combination with other filters. | |
4359 .IPs <sloppy> | |
4360 Allow (1) or disallow (0) the output frequency to differ slightly | |
4361 from the frequency given by <srate> (default: 1). | |
4362 Can be used if the startup of the playback is extremely slow. | |
4363 .IPs <type> | |
4364 Selects which resampling method to use. | |
4365 .RSss | |
4366 0: linear interpolation (fast, poor quality especially when upsampling) | |
4367 .br | |
4368 1: polyphase filterbank and integer processing | |
4369 .br | |
4370 2: polyphase filterbank and floating point processing (slow, best quality) | |
4371 .REss | |
4372 .PD 1 | |
4373 .RE | |
4374 .sp 1 | |
4375 .RS | |
4376 .I EXAMPLE: | |
4377 .RE | |
4378 .PD 0 | |
4379 .RSs | |
4380 .IPs "mplayer \-af resample=44100:0:0" | |
4381 would set the output frequency of the resample filter to 44100Hz using | |
4382 exact output frequency scaling and linear interpolation. | |
4383 .RE | |
4384 .PD 1 | |
4385 . | |
4386 .TP | |
4387 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]] | |
4388 Changes the sample rate of the audio stream to an integer <srate> in Hz. | |
4389 It only supports the 16-bit native-endian format. | |
4390 .br | |
4391 .I NOTE: | |
4392 With MEncoder, you need to also use \-srate <srate>. | |
4393 .PD 0 | |
4394 .RSs | |
4395 .IPs <srate> | |
4396 the output sample rate | |
4397 .IPs <length> | |
4398 length of the filter with respect to the lower sampling rate (default: 16) | |
4399 .IPs <linear> | |
4400 if 1 then filters will be linearly interpolated between polyphase entries | |
4401 .IPs <count> | |
4402 log2 of the number of polyphase entries | |
4403 (..., 10->1024, 11->2048, 12->4096, ...) | |
4404 (default: 10->1024) | |
4405 .IPs <cutoff> | |
4406 cutoff frequency (0.0-1.0), default set depending upon filter length | |
4407 .RE | |
4408 .PD 1 | |
4409 . | |
4410 .TP | |
4411 .B sweep[=speed] | |
4412 Produces a sine sweep. | |
4413 .PD 0 | |
4414 .RSs | |
4415 .IPs <0.0\-1.0> | |
4416 Sine function delta, use very low values to hear the sweep. | |
4417 .RE | |
4418 .PD 1 | |
4419 . | |
4420 .TP | |
4421 .B sinesuppress[=freq:decay] | |
4422 Remove a sine at the specified frequency. | |
4423 Useful to get rid of the 50/60Hz noise on low quality audio equipment. | |
4424 It probably only works on mono input. | |
4425 .PD 0 | |
4426 .RSs | |
4427 .IPs <freq> | |
4428 The frequency of the sine which should be removed (in Hz) (default: 50) | |
4429 .IPs <decay> | |
4430 Controls the adaptivity (a larger value will make the filter adapt to | |
4431 amplitude and phase changes quicker, a smaller value will make the | |
4432 adaptation slower) (default: 0.0001). | |
4433 Reasonable values are around 0.001. | |
4434 .RE | |
4435 .PD 1 | |
4436 . | |
4437 .TP | |
4438 .B hrtf[=flag] | |
4439 Head-related transfer function: Converts multichannel audio to | |
4440 2 channel output for headphones, preserving the spatiality of the sound. | |
4441 .sp 1 | |
4442 .PD 0 | |
4443 .RS | |
4444 .IPs "Flag Meaning" | |
4445 .IPs "m matrix decoding of the rear channel" | |
4446 .IPs "s 2-channel matrix decoding" | |
4447 .IPs "0 no matrix decoding (default)" | |
4448 .RE | |
4449 .PD 1 | |
4450 . | |
4451 .TP | |
4452 .B equalizer=[g1:g2:g3:...:g10] | |
4453 10 octave band graphic equalizer, implemented using 10 IIR band pass filters. | |
4454 This means that it works regardless of what type of audio is being played back. | |
4455 The center frequencies for the 10 bands are: | |
4456 .sp 1 | |
4457 .PD 0 | |
4458 .RS | |
4459 .IPs "No. frequency" | |
4460 .IPs "0 31.25 Hz" | |
4461 .IPs "1 62.50 Hz" | |
4462 .IPs "2 125.00 Hz" | |
4463 .IPs "3 250.00 Hz" | |
4464 .IPs "4 500.00 Hz" | |
4465 .IPs "5 1.00 kHz" | |
4466 .IPs "6 2.00 kHz" | |
4467 .IPs "7 4.00 kHz" | |
4468 .IPs "8 8.00 kHz" | |
4469 .IPs "9 16.00 kHz" | |
4470 .RE | |
4471 .PD 1 | |
4472 .sp 1 | |
4473 .RS | |
4474 If the sample rate of the sound being played is lower than the center | |
4475 frequency for a frequency band, then that band will be disabled. | |
4476 A known bug with this filter is that the characteristics for the | |
4477 uppermost band are not completely symmetric if the sample | |
4478 rate is close to the center frequency of that band. | |
4479 This problem can be worked around by upsampling the sound | |
4480 using the resample filter before it reaches this filter. | |
4481 .RE | |
4482 .PD 0 | |
4483 .RSs | |
4484 .IPs <g1>:<g2>:<g3>:...:<g10> | |
4485 floating point numbers representing the gain in dB | |
4486 for each frequency band (-12\-12) | |
4487 .RE | |
4488 .sp 1 | |
4489 .RS | |
4490 .I EXAMPLE: | |
4491 .RE | |
4492 .RSs | |
4493 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi" | |
4494 Would amplify the sound in the upper and lower frequency region | |
4495 while canceling it almost completely around 1kHz. | |
4496 .RE | |
4497 .PD 1 | |
4498 . | |
4499 .TP | |
4500 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...] | |
4501 Can be used for adding, removing, routing and copying audio channels. | |
4502 If only <nch> is given the default routing is used, it works as | |
4503 follows: If the number of output channels is bigger than the number of | |
4504 input channels empty channels are inserted (except mixing from mono to | |
4505 stereo, then the mono channel is repeated in both of the output | |
4506 channels). | |
4507 If the number of output channels is smaller than the number | |
4508 of input channels the exceeding channels are truncated. | |
4509 .PD 0 | |
4510 .RSs | |
4511 .IPs <nch> | |
4512 number of output channels (1\-6) | |
4513 .IPs "<nr>\ " | |
4514 number of routes (1\-6) | |
4515 .IPs <from1:to1:from2:to2:from3:to3:...> | |
4516 Pairs of numbers between 0 and 5 that define where to route each channel. | |
4517 .RE | |
4518 .sp 1 | |
4519 .RS | |
4520 .I EXAMPLE: | |
4521 .RE | |
4522 .RSs | |
4523 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi" | |
4524 Would change the number of channels to 4 and set up 4 routes that | |
4525 swap channel 0 and channel 1 and leave channel 2 and 3 intact. | |
4526 Observe that if media containing two channels was played back, channels | |
4527 2 and 3 would contain silence but 0 and 1 would still be swapped. | |
4528 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi" | |
4529 Would change the number of channels to 6 and set up 4 routes | |
4530 that copy channel 0 to channels 0 to 3. | |
4531 Channel 4 and 5 will contain silence. | |
4532 .RE | |
4533 .PD 1 | |
4534 . | |
4535 .TP | |
4536 .B format[=format] (also see \-format) | |
4537 Convert between different sample formats. | |
4538 Automatically enabled when needed by the sound card or another filter. | |
4539 .PD 0 | |
4540 .RSs | |
4541 .IPs <format> | |
4542 Sets the desired format. | |
4543 The general form is 'sbe', where 's' denotes the sign (either 's' for signed | |
4544 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32) | |
4545 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian | |
4546 and 'ne' the endianness of the computer MPlayer is running on). | |
4547 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'. | |
4548 Exceptions to this rule that are also valid format specifiers: u8, s8, | |
4549 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm. | |
4550 .RE | |
4551 .PD 1 | |
4552 . | |
4553 .TP | |
4554 .B volume[=v[:sc]] | |
4555 Implements software volume control. | |
4556 Use this filter with caution since it can reduce the signal | |
4557 to noise ratio of the sound. | |
4558 In most cases it is best to set the level for the PCM sound to max, | |
4559 leave this filter out and control the output level to your | |
4560 speakers with the master volume control of the mixer. | |
4561 In case your sound card has a digital PCM mixer instead of an analog | |
4562 one, and you hear distortion, use the MASTER mixer instead. | |
4563 If there is an external amplifier connected to the computer (this | |
4564 is almost always the case), the noise level can be minimized by | |
4565 adjusting the master level and the volume knob on the amplifier | |
4566 until the hissing noise in the background is gone. | |
4567 .br | |
4568 This filter has a second feature: It measures the overall maximum | |
4569 sound level and prints out that level when MPlayer exits. | |
4570 This volume estimate can be used for setting the sound level in | |
4571 MEncoder such that the maximum dynamic range is utilized. | |
4572 .br | |
4573 .I NOTE: | |
4574 This filter is not reentrant and can therefore only be enabled | |
4575 once for every audio stream. | |
4576 .PD 0 | |
4577 .RSs | |
4578 .IPs "<v>\ \ " | |
4579 Sets the desired gain in dB for all channels in the stream | |
4580 from -200dB to +60dB, where -200dB mutes the sound | |
4581 completely and +60dB equals a gain of 1000 (default: 0). | |
4582 .IPs "<sc>\ " | |
4583 Turns soft clipping on (1) or off (0). | |
4584 Soft-clipping can make the sound more smooth if very | |
4585 high volume levels are used. | |
4586 Enable this option if the dynamic range of the | |
4587 loudspeakers is very low. | |
4588 .br | |
4589 .I WARNING: | |
4590 This feature creates distortion and should be considered a last resort. | |
4591 .RE | |
4592 .sp 1 | |
4593 .RS | |
4594 .I EXAMPLE: | |
4595 .RE | |
4596 .RSs | |
4597 .IPs "mplayer \-af volume=10.1:0 media.avi" | |
4598 Would amplify the sound by 10.1dB and hard-clip if the | |
4599 sound level is too high. | |
4600 .RE | |
4601 .PD 1 | |
4602 . | |
4603 .TP | |
4604 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...] | |
4605 Mixes channels arbitrarily. | |
4606 Basically a combination of the volume and the channels filter | |
4607 that can be used to down-mix many channels to only a few, | |
4608 e.g.\& stereo to mono or vary the "width" of the center | |
4609 speaker in a surround sound system. | |
4610 This filter is hard to use, and will require some tinkering | |
4611 before the desired result is obtained. | |
4612 The number of options for this filter depends on | |
4613 the number of output channels. | |
4614 An example how to downmix a six-channel file to two channels with | |
4615 this filter can be found in the examples section near the end. | |
4616 .PD 0 | |
4617 .RSs | |
4618 .IPs "<n>\ \ " | |
4619 number of output channels (1\-6) | |
4620 .IPs <Lij> | |
4621 How much of input channel i is mixed into output channel j (0\-1). | |
4622 So in principle you first have n numbers saying what to do with the | |
4623 first input channel, then n numbers that act on the second input channel | |
4624 etc. | |
4625 If you do not specify any numbers for some input channels, 0 is assumed. | |
4626 .RE | |
4627 .sp 1 | |
4628 .RS | |
4629 .I EXAMPLE: | |
4630 .RE | |
4631 .RSs | |
4632 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi" | |
4633 Would down-mix from stereo to mono. | |
4634 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi" | |
4635 Would give 3 channel output leaving channels 0 and 1 intact, | |
4636 and mix channels 0 and 1 into output channel 2 (which could | |
4637 be sent to a subwoofer for example). | |
4638 .RE | |
4639 .PD 1 | |
4640 . | |
4641 .TP | |
4642 .B sub[=fc:ch] | |
4643 Adds a subwoofer channel to the audio stream. | |
4644 The audio data used for creating the subwoofer channel is | |
4645 an average of the sound in channel 0 and channel 1. | |
4646 The resulting sound is then low-pass filtered by a 4th order | |
4647 Butterworth filter with a default cutoff frequency of 60Hz | |
4648 and added to a separate channel in the audio stream. | |
4649 .br | |
4650 .I Warning: | |
4651 Disable this filter when you are playing DVDs with Dolby | |
4652 Digital 5.1 sound, otherwise this filter will disrupt | |
4653 the sound to the subwoofer. | |
4654 .PD 0 | |
4655 .RSs | |
4656 .IPs "<fc>\ " | |
4657 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz) | |
4658 For the best result try setting the cutoff frequency as low as possible. | |
4659 This will improve the stereo or surround sound experience. | |
4660 .IPs "<ch>\ " | |
4661 Determines the channel number in which to insert the sub-channel audio. | |
4662 Channel number can be between 0 and 5 (default: 5). | |
4663 Observe that the number of channels will automatically | |
4664 be increased to <ch> if necessary. | |
4665 .RE | |
4666 .sp 1 | |
4667 .RS | |
4668 .I EXAMPLE: | |
4669 .RE | |
4670 .RSs | |
4671 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi" | |
4672 Would add a sub-woofer channel with a cutoff frequency of | |
4673 100Hz to output channel 4. | |
4674 .RE | |
4675 .PD 1 | |
4676 . | |
4677 .TP | |
4678 .B "center\ " | |
4679 Creates a center channel from the front channels. | |
4680 May currently be low quality as it does not implement a | |
4681 high-pass filter for proper extraction yet, but averages and | |
4682 halves the channels instead. | |
4683 .PD 0 | |
4684 .RSs | |
4685 .IPs "<ch>\ " | |
4686 Determines the channel number in which to insert the center channel. | |
4687 Channel number can be between 0 and 5 (default: 5). | |
4688 Observe that the number of channels will automatically | |
4689 be increased to <ch> if necessary. | |
4690 .RE | |
4691 .PD 1 | |
4692 . | |
4693 .TP | |
4694 .B surround[=delay] | |
4695 Decoder for matrix encoded surround sound like Dolby Surround. | |
4696 Many files with 2 channel audio actually contain matrixed surround sound. | |
4697 Requires a sound card supporting at least 4 channels. | |
4698 .PD 0 | |
4699 .RSs | |
4700 .IPs <delay> | |
4701 delay time in ms for the rear speakers (0 to 1000) (default: 20) | |
4702 This delay should be set as follows: If d1 is the distance | |
4703 from the listening position to the front speakers and d2 is the distance | |
4704 from the listening position to the rear speakers, then the delay should | |
4705 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2. | |
4706 .RE | |
4707 .sp 1 | |
4708 .RS | |
4709 .I EXAMPLE: | |
4710 .RE | |
4711 .RSs | |
4712 .IPs "mplayer \-af surround=15 \-channels 4 media.avi" | |
4713 Would add surround sound decoding with 15ms delay for the sound to the | |
4714 rear speakers. | |
4715 .RE | |
4716 .PD 1 | |
4717 . | |
4718 .TP | |
4719 .B delay[=ch1:ch2:...] | |
4720 Delays the sound to the loudspeakers such that the sound from the | |
4721 different channels arrives at the listening position simultaneously. | |
4722 It is only useful if you have more than 2 loudspeakers. | |
4723 .PD 0 | |
4724 .RSs | |
4725 .IPs ch1,ch2,... | |
4726 The delay in ms that should be imposed on each channel | |
4727 (floating point number between 0 and 1000). | |
4728 .RE | |
4729 .PD 1 | |
4730 .sp 1 | |
4731 .RS | |
4732 To calculate the required delay for the different channels do as follows: | |
4733 .IP 1. 3 | |
4734 Measure the distance to the loudspeakers in meters in relation | |
4735 to your listening position, giving you the distances s1 to s5 | |
4736 (for a 5.1 system). | |
4737 There is no point in compensating for the subwoofer (you will not hear the | |
4738 difference anyway). | |
4739 .IP 2. 3 | |
4740 Subtract the distances s1 to s5 from the maximum distance, | |
4741 i.e.\& s[i] = max(s) - s[i]; i = 1...5. | |
4742 .IP 3. | |
4743 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5. | |
4744 .RE | |
4745 .PD 0 | |
4746 .sp 1 | |
4747 .RS | |
4748 .I EXAMPLE: | |
4749 .RE | |
4750 .RSs | |
4751 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi" | |
4752 Would delay front left and right by 10.5ms, the two rear channels | |
4753 and the sub by 0ms and the center channel by 7ms. | |
4754 .RE | |
4755 .PD 1 | |
4756 . | |
4757 .TP | |
4758 .B export[=mmapped_file[:nsamples]] | |
4759 Exports the incoming signal to other processes using memory mapping (mmap()). | |
4760 Memory mapped areas contain a header: | |
4761 .sp 1 | |
4762 .nf | |
4763 int nch /*number of channels*/ | |
4764 int size /*buffer size*/ | |
4765 unsigned long long counter /*Used to keep sync, updated every | |
4766 time new data is exported.*/ | |
4767 .fi | |
4768 .sp 1 | |
4769 The rest is payload (non-interleaved) 16 bit data. | |
4770 .PD 0 | |
4771 .RSs | |
4772 .IPs <mmapped_file> | |
4773 file to map data to (default: ~/.mplayer/\:mplayer-af_export) | |
4774 .IPs <nsamples> | |
4775 number of samples per channel (default: 512) | |
4776 .RE | |
4777 .sp 1 | |
4778 .RS | |
4779 .I EXAMPLE: | |
4780 .RE | |
4781 .RSs | |
4782 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi" | |
4783 Would export 1024 samples per channel to '/tmp/mplayer-af_export'. | |
4784 .RE | |
4785 .PD 1 | |
4786 . | |
4787 .TP | |
4788 .B extrastereo[=mul] | |
4789 (Linearly) increases the difference between left and right channels | |
4790 which adds some sort of "live" effect to playback. | |
4791 .PD 0 | |
4792 .RSs | |
4793 .IPs <mul> | |
4794 Sets the difference coefficient (default: 2.5). | |
4795 0.0 means mono sound (average of both channels), with 1.0 sound will be | |
4796 unchanged, with -1.0 left and right channels will be swapped. | |
4797 .RE | |
4798 .PD 1 | |
4799 . | |
4800 .TP | |
4801 .B volnorm[=method:target] | |
4802 Maximizes the volume without distorting the sound. | |
4803 .PD 0 | |
4804 .RSs | |
4805 .IPs <method> | |
4806 Sets the used method. | |
4807 .RSss | |
4808 1: Use a single sample to smooth the variations via the standard | |
4809 weighted mean over past samples (default). | |
4810 .br | |
4811 2: Use several samples to smooth the variations via the standard | |
4812 weighted mean over past samples. | |
4813 .REss | |
4814 .IPs <target> | |
4815 Sets the target amplitude as a fraction of the maximum for the | |
4816 sample type (default: 0.25). | |
4817 .RE | |
4818 .PD 1 | |
4819 . | |
4820 .TP | |
4821 .B ladspa=file:label[:controls...] | |
4822 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin. | |
4823 This filter is reentrant, so multiple LADSPA plugins can be used at once. | |
4824 .PD 0 | |
4825 .RSs | |
4826 .IPs <file> | |
4827 Specifies the LADSPA plugin library file. | |
4828 If LADSPA_PATH is set, it searches for the specified file. | |
4829 If it is not set, you must supply a fully specified pathname. | |
4830 .IPs <label> | |
4831 Specifies the filter within the library. | |
4832 Some libraries contain only one filter, but others contain many of them. | |
4833 Entering 'help' here, will list all available filters within the specified | |
4834 library, which eliminates the use of 'listplugins' from the LADSPA SDK. | |
4835 .IPs <controls> | |
4836 Controls are zero or more floating point values that determine the | |
4837 behavior of the loaded plugin (for example delay, threshold or gain). | |
4838 In verbose mode (add \-v to the MPlayer command line), all available controls | |
4839 and their valid ranges are printed. | |
4840 This eliminates the use of 'analyseplugin' from the LADSPA SDK. | |
4841 .RE | |
4842 .PD 1 | |
4843 . | |
4844 .TP | |
4845 .B "comp\ \ \ " | |
4846 Compressor/expander filter usable for microphone input. | |
4847 Prevents artifacts on very loud sound and raises the volume on | |
4848 very low sound. | |
4849 This filter is untested, maybe even unusable. | |
4850 . | |
4851 .TP | |
4852 .B "gate\ \ \ " | |
4853 Noise gate filter similar to the comp audio filter. | |
4854 This filter is untested, maybe even unusable. | |
4855 . | |
4856 .TP | |
4857 .B karaoke | |
4858 Simple voice removal filter exploiting the fact that voice is | |
4859 usually recorded with mono gear and later 'center' mixed onto | |
4860 the final audio stream. | |
4861 Beware that this filter will turn your signal into mono. | |
4862 Works well for 2 channel tracks; do not bother trying it | |
4863 on anything but 2 channel stereo. | |
4864 . | |
4865 . | |
4866 . | |
4867 .SH "VIDEO FILTERS" | |
4868 Video filters allow you to modify the video stream and its properties. | |
4869 The syntax is: | |
4870 . | |
4871 .TP | |
4872 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...> | |
4873 Setup a chain of video filters. | |
4874 . | |
4875 .TP | |
4876 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE) | |
4877 Setup a chain of video filters, to be applied in | |
4878 .B reverse | |
4879 order. | |
4880 Deprecated in favor of \-vf. | |
4881 .PP | |
4882 Many parameters are optional and set to default values if omitted. | |
4883 To explicitly use a default value set a parameter to '-1'. | |
4884 Parameters w:h means width x height in pixels, x:y means x;y position counted | |
4885 from the upper left corner of the bigger image. | |
4886 .br | |
4887 .I NOTE: | |
4888 To get a full list of available video filters, see \-vf help. | |
4889 .sp 1 | |
4890 Video filters are managed in lists. | |
4891 There are a few commands to manage the filter list. | |
4892 . | |
4893 .TP | |
4894 .B \-vf-add <filter1[,filter2,...]> | |
4895 Appends the filters given as arguments to the filter list. | |
4896 . | |
4897 .TP | |
4898 .B \-vf-pre <filter1[,filter2,...]> | |
4899 Prepends the filters given as arguments to the filter list. | |
4900 . | |
4901 .TP | |
4902 .B \-vf-del <index1[,index2,...]> | |
4903 Deletes the filters at the given indexes. | |
4904 Index numbers start at 0, negative numbers address the end of the | |
4905 list (-1 is the last). | |
4906 . | |
4907 .TP | |
4908 .B \-vf-clr | |
4909 Completely empties the filter list. | |
4910 .PP | |
4911 With filters that support it, you can access parameters by their name. | |
4912 . | |
4913 .TP | |
4914 .B \-vf <filter>=help | |
4915 Prints the parameter names and parameter value ranges for a particular | |
4916 filter. | |
4917 . | |
4918 .TP | |
4919 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]> | |
4920 Sets a named parameter to the given value. | |
4921 Use on and off or yes and no to set flag parameters. | |
4922 .PP | |
4923 Available filters are: | |
4924 . | |
4925 .TP | |
4926 .B crop[=w:h:x:y] | |
4927 Crops the given part of the image and discards the rest. | |
4928 Useful to remove black bands from widescreen movies. | |
4929 .PD 0 | |
4930 .RSs | |
4931 .IPs <w>,<h> | |
4932 Cropped width and height, defaults to original width and height. | |
4933 .IPs <x>,<y> | |
4934 Position of the cropped picture, defaults to center. | |
4935 .RE | |
4936 .PD 1 | |
4937 . | |
4938 .TP | |
4939 .B cropdetect[=limit:round] | |
4940 Calculates necessary cropping parameters and prints the recommended parameters | |
4941 to stdout. | |
4942 .PD 0 | |
4943 .RSs | |
4944 .IPs <limit> | |
4945 Threshold, which can be optionally specified from nothing (0) to | |
4946 everything (255) (default: 24). | |
4947 .br | |
4948 .IPs <round> | |
4949 Value which the width/\:height should be divisible by (default: 16). | |
4950 The offset is automatically adjusted to center the video. | |
4951 Use 2 to get only even dimensions (needed for 4:2:2 video). | |
4952 16 is best when encoding to most video codecs. | |
4953 .RE | |
4954 .PD 1 | |
4955 . | |
4956 .TP | |
4957 .B rectangle[=w:h:x:y] | |
4958 The plugin responds to the input.conf directive 'change_rectangle' | |
4959 that takes two parameters. | |
4960 .PD 0 | |
4961 .RSs | |
4962 .IPs <w>,<h> | |
4963 width and height (default: -1, maximum possible width where boundaries | |
4964 are still visible.) | |
4965 .IPs <x>,<y> | |
4966 top left corner position (default: -1, uppermost leftmost) | |
4967 .RE | |
4968 .PD 1 | |
4969 . | |
4970 .TP | |
4971 .B expand[=w:h:x:y:o:a:r] | |
4972 Expands (not scales) movie resolution to the given value and places the | |
4973 unscaled original at coordinates x, y. | |
4974 Can be used for placing subtitles/\:OSD in the resulting black bands. | |
4975 .RSs | |
4976 .IPs <w>,<h> | |
4977 Expanded width,height (default: original width,height). | |
4978 Negative values for w and h are treated as offsets to the original size. | |
4979 .sp 1 | |
4980 .I EXAMPLE: | |
4981 .PD 0 | |
4982 .RSs | |
4983 .IP expand=0:-50:0:0 | |
4984 Adds a 50 pixel border to the bottom of the picture. | |
4985 .RE | |
4986 .PD 1 | |
4987 .IPs <x>,<y> | |
4988 position of original image on the expanded image (default: center) | |
4989 .IPs "<o>\ \ " | |
4990 OSD/\:subtitle rendering | |
4991 .RSss | |
4992 0: disable (default) | |
4993 .br | |
4994 1: enable | |
4995 .REss | |
4996 .IPs "<a>\ \ " | |
4997 Expands to fit an aspect instead of a resolution (default: 0). | |
4998 .sp 1 | |
4999 .I EXAMPLE: | |
5000 .PD 0 | |
5001 .RSs | |
20913 | 5002 .IP expand=800:::::4/3 |
20707 | 5003 Expands to 800x600, unless the source is higher resolution, in which |
5004 case it expands to fill a 4/3 aspect. | |
5005 .RE | |
5006 .PD 1 | |
5007 .IPs "<r>\ \ " | |
5008 Rounds up to make both width and height divisible by <r> (default: 1). | |
5009 .RE | |
5010 . | |
5011 .TP | |
5012 .B flip (also see \-flip) | |
5013 Flips the image upside down. | |
5014 . | |
5015 .TP | |
5016 .B "mirror\ " | |
5017 Mirrors the image on the Y axis. | |
5018 . | |
5019 .TP | |
5020 .B rotate[=<0\-7>] | |
5021 Rotates the image by 90 degrees and optionally flips it. | |
5022 For values between 4\-7 rotation is only done if the movie geometry is | |
5023 portrait and not landscape. | |
5024 .RSs | |
5025 .IPs 0 | |
5026 Rotate by 90 degrees clockwise and flip (default). | |
5027 .IPs 1 | |
5028 Rotate by 90 degrees clockwise. | |
5029 .IPs 2 | |
5030 Rotate by 90 degrees counterclockwise. | |
5031 .IPs 3 | |
5032 Rotate by 90 degrees counterclockwise and flip. | |
5033 .RE | |
5034 . | |
5035 .TP | |
5036 .B scale[=w:h[:ilaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]] | |
5037 Scales the image with the software scaler (slow) and performs a YUV<\->RGB | |
5038 colorspace conversion (also see \-sws). | |
5039 .RSs | |
5040 .IPs <w>,<h> | |
5041 scaled width/\:height (default: original width/\:height) | |
5042 .br | |
5043 .I NOTE: | |
5044 If \-zoom is used, and underlying filters (including libvo) are | |
5045 incapable of scaling, it defaults to d_width/\:d_height! | |
5046 .RSss | |
5047 0: scaled d_width/\:d_height | |
5048 .br | |
5049 -1: original width/\:height | |
5050 .br | |
5051 -2: Calculate w/h using the other dimension and the prescaled aspect ratio. | |
5052 .br | |
5053 -3: Calculate w/h using the other dimension and the original aspect ratio. | |
5054 .br | |
5055 -(n+8): Like -n above, but rounding the dimension to the closest multiple of 16. | |
5056 .REss | |
5057 .IPs <ilaced> | |
5058 Toggle interlaced scaling. | |
5059 .RSss | |
5060 0: off (default) | |
5061 .br | |
5062 1: on | |
5063 .REss | |
5064 .IPs <chr_drop> | |
5065 chroma skipping | |
5066 .RSss | |
5067 0: Use all available input lines for chroma. | |
5068 .br | |
5069 1: Use only every 2. input line for chroma. | |
5070 .br | |
5071 2: Use only every 4. input line for chroma. | |
5072 .br | |
5073 3: Use only every 8. input line for chroma. | |
5074 .REss | |
5075 .IPs "<par>[:<par2>] (also see \-sws)" | |
5076 Set some scaling parameters depending on the type of scaler selected | |
5077 with \-sws. | |
5078 .RSss | |
5079 \-sws 2 (bicubic): B (blurring) and C (ringing) | |
5080 .br | |
5081 0.00:0.60 default | |
5082 .br | |
5083 0.00:0.75 VirtualDub's "precise bicubic" | |
5084 .br | |
5085 0.00:0.50 Catmull-Rom spline | |
5086 .br | |
5087 0.33:0.33 Mitchell-Netravali spline | |
5088 .br | |
5089 1.00:0.00 cubic B-spline | |
5090 .br | |
5091 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp)) | |
5092 .br | |
5093 \-sws 9 (lanczos): filter length (1\-10) | |
5094 .REss | |
5095 .IPs <presize> | |
5096 Scale to preset sizes. | |
5097 .RSss | |
5098 qntsc: 352x240 (NTSC quarter screen) | |
5099 .br | |
5100 qpal: 352x288 (PAL quarter screen) | |
5101 .br | |
5102 ntsc: 720x480 (standard NTSC) | |
5103 .br | |
5104 pal: 720x576 (standard PAL) | |
5105 .br | |
5106 sntsc: 640x480 (square pixel NTSC) | |
5107 .br | |
5108 spal: 768x576 (square pixel PAL) | |
5109 .REss | |
5110 .IPs <noup> | |
5111 Disallow upscaling past the original dimensions. | |
5112 .RSss | |
5113 0: Allow upscaling (default). | |
5114 .br | |
5115 1: Disallow upscaling if one dimension exceeds its original value. | |
5116 .br | |
5117 2: Disallow upscaling if both dimensions exceed their original values. | |
5118 .REss | |
5119 .IPs <arnd> | |
5120 Accurate rounding for the vertical scaler, which may be faster | |
5121 or slower than the default rounding. | |
5122 .RSss | |
5123 0: Disable accurate rounding (default). | |
5124 .br | |
5125 1: Enable accurate rounding. | |
5126 .REss | |
5127 .RE | |
5128 . | |
5129 .TP | |
5130 .B dsize[=aspect|w:h:aspect-method:r] | |
5131 Changes the intended display size/\:aspect at an arbitrary point in the | |
5132 filter chain. | |
5133 Aspect can be given as a fraction (4/3) or floating point number | |
5134 (1.33). | |
5135 Alternatively, you may specify the exact display width and height | |
5136 desired. | |
5137 Note that this filter does | |
5138 .B not | |
5139 do any scaling itself; it just affects | |
5140 what later scalers (software or hardware) will do when auto-scaling to | |
5141 correct aspect. | |
5142 .RSs | |
5143 .IPs <w>,<h> | |
5144 New display width and height. | |
5145 Can also be these special values: | |
5146 .RSss | |
5147 0: original display width and height | |
5148 .br | |
5149 -1: original video width and height (default) | |
5150 .br | |
5151 -2: Calculate w/h using the other dimension and the original display | |
5152 aspect ratio. | |
5153 .br | |
5154 -3: Calculate w/h using the other dimension and the original video | |
5155 aspect ratio. | |
5156 .REss | |
5157 .sp 1 | |
5158 .I EXAMPLE: | |
5159 .PD 0 | |
5160 .RSs | |
5161 .IP dsize=800:-2 | |
5162 Specifies a display resolution of 800x600 for a 4/3 aspect video, or | |
5163 800x450 for a 16/9 aspect video. | |
5164 .RE | |
5165 .IPs <aspect-method> | |
5166 Modifies width and height according to original aspect ratios. | |
5167 .RSss | |
5168 -1: Ignore original aspect ratio (default). | |
5169 .br | |
5170 0: Keep display aspect ratio by using <w> and <h> as maximum | |
5171 resolution. | |
5172 .br | |
5173 1: Keep display aspect ratio by using <w> and <h> as minimum | |
5174 resolution. | |
5175 .br | |
5176 2: Keep video aspect ratio by using <w> and <h> as maximum | |
5177 resolution. | |
5178 .br | |
5179 3: Keep video aspect ratio by using <w> and <h> as minimum | |
5180 resolution. | |
5181 .REss | |
5182 .sp 1 | |
5183 .I EXAMPLE: | |
5184 .PD 0 | |
5185 .RSs | |
5186 .IP dsize=800:600:0 | |
5187 Specifies a display resolution of at most 800x600, or smaller, in order | |
5188 to keep aspect. | |
5189 .RE | |
5190 .PD 1 | |
5191 .IPs "<r>\ \ " | |
5192 Rounds up to make both width and height divisible by <r> (default: 1). | |
5193 .RE | |
5194 . | |
5195 .TP | |
5196 .B "yuy2\ \ \ " | |
5197 Forces software YV12/\:I420/\:422P to YUY2 conversion. | |
5198 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support. | |
5199 . | |
5200 .TP | |
5201 .B "yvu9\ \ \ " | |
5202 Forces software YVU9 to YV12 colorspace conversion. | |
5203 Deprecated in favor of the software scaler. | |
5204 . | |
5205 .TP | |
5206 .B "yuvcsp\ " | |
5207 Clamps YUV color values to the CCIR 601 range without doing real conversion. | |
5208 . | |
5209 .TP | |
5210 .B rgb2bgr[=swap] | |
5211 RGB 24/32 <\-> BGR 24/32 colorspace conversion. | |
5212 .PD 0 | |
5213 .RSs | |
5214 .IPs "swap\ " | |
5215 Also perform R <-> B swapping. | |
5216 .RE | |
5217 .PD 1 | |
5218 . | |
5219 .TP | |
5220 .B palette | |
5221 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette. | |
5222 . | |
5223 .TP | |
5224 .B format[=fourcc] | |
5225 Restricts the colorspace for the next filter without doing any conversion. | |
5226 Use together with the scale filter for a real conversion. | |
5227 .br | |
5228 .I NOTE: | |
5229 For a list of available formats see format=fmt=help. | |
5230 .PD 0 | |
5231 .RSs | |
5232 .IPs <fourcc> | |
5233 format name like rgb15, bgr24, yv12, etc (default: yuy2) | |
5234 .RE | |
5235 .PD 1 | |
5236 . | |
5237 .TP | |
5238 .B noformat[=fourcc] | |
5239 Restricts the colorspace for the next filter without doing any conversion. | |
5240 Unlike the format filter, this will allow any colorspace | |
5241 .B except | |
5242 the one you specify. | |
5243 .br | |
5244 .I NOTE: | |
5245 For a list of available formats see noformat=fmt=help. | |
5246 .PD 0 | |
5247 .RSs | |
5248 .IPs <fourcc> | |
5249 format name like rgb15, bgr24, yv12, etc (default: yv12) | |
5250 .RE | |
5251 .PD 1 | |
5252 . | |
5253 .TP | |
5254 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (also see \-pphelp) | |
5255 Enables the specified chain of postprocessing subfilters. | |
5256 Subfilters must be separated by '/' and can be disabled by | |
5257 prepending a '\-'. | |
5258 Each subfilter and some options have a short and a long name that can be | |
5259 used interchangeably, i.e.\& dr/dering are the same. | |
5260 All subfilters share common options to determine their scope: | |
5261 .PD 0 | |
5262 .RSs | |
5263 .IPs a/autoq | |
5264 Automatically switch the subfilter off if the CPU is too slow. | |
5265 .IPs c/chrom | |
5266 Do chrominance filtering, too (default). | |
5267 .IPs y/nochrom | |
5268 Do luminance filtering only (no chrominance). | |
5269 .IPs n/noluma | |
5270 Do chrominance filtering only (no luminance). | |
5271 .RE | |
5272 .PD 1 | |
5273 .sp 1 | |
5274 .RS | |
5275 .br | |
5276 .I NOTE: | |
5277 \-pphelp shows a list of available subfilters. | |
5278 .sp 1 | |
5279 Available subfilters are | |
5280 .RE | |
5281 .RSs | |
5282 .IPs hb/hdeblock[:difference[:flatness]] | |
5283 horizontal deblocking filter | |
5284 .RSss | |
5285 <difference>: Difference factor where higher values mean | |
5286 more deblocking (default: 32). | |
5287 .br | |
5288 <flatness>: Flatness threshold where lower values mean | |
5289 more deblocking (default: 39). | |
5290 .REss | |
5291 .IPs vb/vdeblock[:difference[:flatness]] | |
5292 vertical deblocking filter | |
5293 .RSss | |
5294 <difference>: Difference factor where higher values mean | |
5295 more deblocking (default: 32). | |
5296 .br | |
5297 <flatness>: Flatness threshold where lower values mean | |
5298 more deblocking (default: 39). | |
5299 .REss | |
5300 .IPs ha/hadeblock[:difference[:flatness]] | |
5301 accurate horizontal deblocking filter | |
5302 .RSss | |
5303 <difference>: Difference factor where higher values mean | |
5304 more deblocking (default: 32). | |
5305 .br | |
5306 <flatness>: Flatness threshold where lower values mean | |
5307 more deblocking (default: 39). | |
5308 .REss | |
5309 .IPs va/vadeblock[:difference[:flatness]] | |
5310 accurate vertical deblocking filter | |
5311 .RSss | |
5312 <difference>: Difference factor where higher values mean | |
5313 more deblocking (default: 32). | |
5314 .br | |
5315 <flatness>: Flatness threshold where lower values mean | |
5316 more deblocking (default: 39). | |
5317 .REss | |
5318 .sp 1 | |
5319 The horizontal and vertical deblocking filters share the | |
5320 difference and flatness values so you cannot set | |
5321 different horizontal and vertical thresholds. | |
5322 .sp 1 | |
5323 .IPs h1/x1hdeblock | |
5324 experimental horizontal deblocking filter | |
5325 .IPs v1/x1vdeblock | |
5326 experimental vertical deblocking filter | |
5327 .IPs dr/dering | |
5328 deringing filter | |
5329 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]] | |
5330 temporal noise reducer | |
5331 .RSss | |
5332 <threshold1>: larger -> stronger filtering | |
5333 .br | |
5334 <threshold2>: larger -> stronger filtering | |
5335 .br | |
5336 <threshold3>: larger -> stronger filtering | |
5337 .REss | |
5338 .IPs al/autolevels[:f/fullyrange] | |
5339 automatic brightness / contrast correction | |
5340 .RSss | |
5341 f/fullyrange: Stretch luminance to (0\-255). | |
5342 .REss | |
5343 .IPs lb/linblenddeint | |
5344 Linear blend deinterlacing filter that deinterlaces the given block | |
5345 by filtering all lines with a (1 2 1) filter. | |
5346 .IPs li/linipoldeint | |
5347 Linear interpolating deinterlacing filter that deinterlaces the given block | |
5348 by linearly interpolating every second line. | |
5349 .IPs ci/cubicipoldeint | |
5350 Cubic interpolating deinterlacing filter deinterlaces the given block | |
5351 by cubically interpolating every second line. | |
5352 .IPs md/mediandeint | |
5353 Median deinterlacing filter that deinterlaces the given block | |
5354 by applying a median filter to every second line. | |
5355 .IPs fd/ffmpegdeint | |
5356 FFmpeg deinterlacing filter that deinterlaces the given block | |
5357 by filtering every second line with a (-1 4 2 4 -1) filter. | |
5358 .IPs l5/lowpass5 | |
5359 Vertically applied FIR lowpass deinterlacing filter that deinterlaces | |
5360 the given block by filtering all lines with a (-1 2 6 2 -1) filter. | |
5361 .IPs fq/forceQuant[:quantizer] | |
5362 Overrides the quantizer table from the input with the constant | |
5363 quantizer you specify. | |
5364 .RSss | |
5365 <quantizer>: quantizer to use | |
5366 .REss | |
5367 .IPs de/default | |
5368 default pp filter combination (hb:a,vb:a,dr:a) | |
5369 .IPs fa/fast | |
5370 fast pp filter combination (h1:a,v1:a,dr:a) | |
5371 .IPs "ac\ \ \ " | |
5372 high quality pp filter combination (ha:a:128:7,va:a,dr:a) | |
5373 .RE | |
5374 .RS | |
5375 .sp 1 | |
5376 .I EXAMPLE: | |
5377 .RE | |
5378 .PD 0 | |
5379 .RSs | |
5380 .IPs "\-vf pp=hb/vb/dr/al" | |
5381 horizontal and vertical deblocking, deringing and automatic | |
5382 brightness/\:contrast | |
5383 .IPs "\-vf pp=de/-al" | |
5384 default filters without brightness/\:contrast correction | |
5385 .IPs "\-vf pp=default/tmpnoise:1:2:3" | |
5386 Enable default filters & temporal denoiser. | |
5387 .IPs "\-vf pp=hb:y/vb:a" | |
5388 Horizontal deblocking on luminance only, and switch vertical deblocking | |
5389 on or off automatically depending on available CPU time. | |
5390 .RE | |
5391 .PD 1 | |
5392 . | |
5393 .TP | |
5394 .B spp[=quality[:qp[:mode]]] | |
5395 Simple postprocessing filter that compresses and decompresses the | |
5396 image at several (or \- in the case of quality level 6 \- all) | |
5397 shifts and averages the results. | |
5398 .RSs | |
5399 .IPs <quality> | |
5400 0\-6 (default: 3) | |
5401 .IPs "<qp>\ " | |
5402 Force quantization parameter (default: 0, use QP from video). | |
5403 .IPs <mode> | |
5404 0: hard thresholding (default) | |
5405 .br | |
5406 1: soft thresholding (better deringing, but blurrier) | |
5407 .br | |
5408 4: like 0, but also use B-frames' QP (may cause flicker) | |
5409 .br | |
5410 5: like 1, but also use B-frames' QP (may cause flicker) | |
5411 .RE | |
5412 . | |
5413 .TP | |
5414 .B uspp[=quality[:qp]] | |
5415 Ultra simple & slow postprocessing filter that compresses and | |
5416 decompresses the image at several (or \- in the case of quality | |
5417 level 8 \- all) shifts and averages the results. | |
5418 The way this differs from the behavior of spp is that uspp actually | |
5419 encodes & decodes each case with libavcodec Snow, whereas spp uses | |
5420 a simplified intra only 8x8 DCT similar to MJPEG. | |
5421 .RSs | |
5422 .IPs <quality> | |
5423 0\-8 (default: 3) | |
5424 .IPs "<qp>\ " | |
5425 Force quantization parameter (default: 0, use QP from video). | |
5426 .RE | |
5427 . | |
5428 .TP | |
5429 .B fspp[=quality[:qp[:strength[:bframes]]]] | |
5430 faster version of the simple postprocessing filter | |
5431 .RSs | |
5432 .IPs <quality> | |
5433 4\-5 (equivalent to spp; default: 4) | |
5434 .IPs "<qp>\ " | |
5435 Force quantization parameter (default: 0, use QP from video). | |
5436 .IPs <-15\-32> | |
5437 Filter strength, lower values mean more details but also more artifacts, | |
5438 while higher values make the image smoother but also blurrier (default: | |
5439 0 \- PSNR optimal). | |
5440 .IPs <bframes> | |
5441 0: do not use QP from B-frames (default) | |
5442 .br | |
5443 1: use QP from B-frames too (may cause flicker) | |
5444 .RE | |
5445 . | |
5446 .TP | |
5447 .B pp7[=qp[:mode]] | |
5448 Variant of the spp filter, similar to spp=6 with 7 point DCT where | |
5449 only the center sample is used after IDCT. | |
5450 .RSs | |
5451 .IPs <qp> | |
5452 Force quantization parameter (default: 0, use QP from video). | |
5453 .IPs <mode> | |
5454 0: hard thresholding | |
5455 .br | |
5456 1: soft thresholding (better deringing, but blurrier) | |
5457 .br | |
5458 2: medium thresholding (default, good results) | |
5459 .RE | |
5460 . | |
5461 .TP | |
5462 .B qp=equation | |
5463 quantization parameter (QP) change filter | |
5464 .RSs | |
5465 .IPs <equation> | |
5466 some equation like "2+2*sin(PI*qp)" | |
5467 .RE | |
5468 . | |
5469 .TP | |
5470 .B "test\ \ \ " | |
5471 Generate various test patterns. | |
5472 . | |
5473 .TP | |
5474 .B rgbtest | |
5475 Generate an RGB test pattern useful for detecting RGB vs BGR issues. | |
5476 You should see a red, green and blue stripe from top to bottom. | |
5477 . | |
5478 .TP | |
5479 .B lavc[=quality:fps] | |
5480 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV. | |
5481 .RSs | |
5482 .IPs <quality> | |
5483 .RSss | |
5484 1\-31: fixed qscale | |
5485 .br | |
5486 32\-: fixed bitrate in kbits | |
5487 .REss | |
5488 .IPs <fps> | |
5489 force output fps (float value) (default: 0, autodetect based on height) | |
5490 .RE | |
5491 . | |
5492 .TP | |
5493 .B dvbscale[=aspect] | |
5494 Set up optimal scaling for DVB cards, scaling the x axis in hardware and | |
5495 calculating the y axis scaling in software to keep aspect. | |
5496 Only useful together with expand and scale. | |
5497 .RSs | |
5498 .IPs <aspect> | |
5499 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default: | |
5500 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV. | |
5501 .RE | |
5502 .sp 1 | |
5503 .RS | |
5504 .I EXAMPLE: | |
5505 .RE | |
5506 .PD 0 | |
5507 .RSs | |
5508 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc" | |
5509 FIXME: Explain what this does. | |
5510 .RE | |
5511 .PD 1 | |
5512 . | |
5513 .TP | |
5514 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]] | |
5515 Adds noise. | |
5516 .PD 0 | |
5517 .RSs | |
5518 .IPs <0\-100> | |
5519 luma noise | |
5520 .IPs <0\-100> | |
5521 chroma noise | |
5522 .IPs u | |
5523 uniform noise (gaussian otherwise) | |
5524 .IPs t | |
5525 temporal noise (noise pattern changes between frames) | |
5526 .IPs a | |
5527 averaged temporal noise (smoother, but a lot slower) | |
5528 .IPs h | |
5529 high quality (slightly better looking, slightly slower) | |
5530 .IPs p | |
5531 mix random noise with a (semi)regular pattern | |
5532 .RE | |
5533 .PD 1 | |
5534 . | |
5535 .TP | |
5536 .B denoise3d[=luma:chroma:time] | |
5537 This filter aims to reduce image noise producing smooth images and making still | |
5538 images really still (This should enhance compressibility.). | |
5539 .PD 0 | |
5540 .RSs | |
5541 .IPs <luma> | |
5542 spatial luma strength (default: 4) | |
5543 .IPs <chroma> | |
5544 spatial chroma strength (default: 3) | |
5545 .IPs <time> | |
5546 temporal strength (default: 6) | |
5547 .RE | |
5548 .PD 1 | |
5549 . | |
5550 .TP | |
5551 .B hqdn3d[=luma:chroma:time] | |
5552 High precision/\:quality version of the denoise3d filter. | |
5553 Parameters and usage are the same. | |
5554 . | |
5555 .TP | |
5556 .B eq[=brightness:contrast] (OBSOLETE) | |
5557 Software equalizer with interactive controls just like the hardware | |
5558 equalizer, for cards/\:drivers that do not support brightness and | |
5559 contrast controls in hardware. | |
5560 Might also be useful with MEncoder, either for fixing poorly captured | |
5561 movies, or for slightly reducing contrast to mask artifacts and get by | |
5562 with lower bitrates. | |
5563 .PD 0 | |
5564 .RSs | |
5565 .IPs <-100\-100> | |
5566 initial brightness | |
5567 .IPs <-100\-100> | |
5568 initial contrast | |
5569 .RE | |
5570 .PD 1 | |
5571 . | |
5572 .TP | |
5573 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight] | |
5574 Alternative software equalizer that uses lookup tables (very slow), | |
5575 allowing gamma correction in addition to simple brightness | |
5576 and contrast adjustment. | |
5577 Note that it uses the same MMX optimized code as \-vf eq if all | |
5578 gamma values are 1.0. | |
5579 The parameters are given as floating point values. | |
5580 .PD 0 | |
5581 .RSs | |
5582 .IPs <0.1\-10> | |
5583 initial gamma value (default: 1.0) | |
5584 .IPs <-2\-2> | |
5585 initial contrast, where negative values result in a | |
5586 negative image (default: 1.0) | |
5587 .IPs <-1\-1> | |
5588 initial brightness (default: 0.0) | |
5589 .IPs <0\-3> | |
5590 initial saturation (default: 1.0) | |
5591 .IPs <0.1\-10> | |
5592 gamma value for the red component (default: 1.0) | |
5593 .IPs <0.1\-10> | |
5594 gamma value for the green component (default: 1.0) | |
5595 .IPs <0.1\-10> | |
5596 gamma value for the blue component (default: 1.0) | |
5597 .IPs <0\-1> | |
5598 The weight parameter can be used to reduce the effect of a high gamma value on | |
5599 bright image areas, e.g.\& keep them from getting overamplified and just plain | |
5600 white. | |
5601 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it | |
5602 at its full strength (default: 1.0). | |
5603 .RE | |
5604 .PD 1 | |
5605 . | |
5606 .TP | |
5607 .B hue[=hue:saturation] | |
5608 Software equalizer with interactive controls just like the hardware | |
5609 equalizer, for cards/\:drivers that do not support hue and | |
5610 saturation controls in hardware. | |
5611 .PD 0 | |
5612 .RSs | |
5613 .IPs <-180\-180> | |
5614 initial hue (default: 0.0) | |
5615 .IPs <-100\-100> | |
5616 initial saturation, where negative values result | |
5617 in a negative chroma (default: 1.0) | |
5618 .RE | |
5619 .PD 1 | |
5620 . | |
5621 .TP | |
5622 .B halfpack[=f] | |
5623 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but | |
5624 keeping all chroma samples. | |
5625 Useful for output to low-resolution display devices when hardware downscaling | |
5626 is poor quality or is not available. | |
5627 Can also be used as a primitive luma-only deinterlacer with very low CPU | |
5628 usage. | |
5629 .PD 0 | |
5630 .RSs | |
5631 .IPs "<f>\ \ " | |
5632 By default, halfpack averages pairs of lines when downsampling. | |
5633 Any value different from 0 or 1 gives the default (averaging) behavior. | |
5634 .RSss | |
5635 0: Only use even lines when downsampling. | |
5636 .br | |
5637 1: Only use odd lines when downsampling. | |
5638 .REss | |
5639 .RE | |
5640 .PD 1 | |
5641 . | |
5642 .TP | |
5643 .B ilpack[=mode] | |
5644 When interlaced video is stored in YUV 4:2:0 formats, chroma | |
5645 interlacing does not line up properly due to vertical downsampling of | |
5646 the chroma channels. | |
5647 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with | |
5648 the chroma lines in their proper locations, so that in any given | |
5649 scanline, the luma and chroma data both come from the same field. | |
5650 .PD 0 | |
5651 .RSs | |
5652 .IPs <mode> | |
5653 Select the sampling mode. | |
5654 .RSss | |
5655 0: nearest-neighbor sampling, fast but incorrect | |
5656 .br | |
5657 1: linear interpolation (default) | |
5658 .REss | |
5659 .RE | |
5660 .PD 1 | |
5661 . | |
5662 .TP | |
5663 .B harddup | |
5664 Only useful with MEncoder. | |
5665 If harddup is used when encoding, it will force duplicate frames to be | |
5666 encoded in the output. | |
5667 This uses slightly more space, but is necessary for output to MPEG | |
5668 files or if you plan to demux and remux the video stream after | |
5669 encoding. | |
5670 Should be placed at or near the end of the filter chain unless you | |
5671 have a good reason to do otherwise. | |
5672 . | |
5673 .TP | |
5674 .B softskip | |
5675 Only useful with MEncoder. | |
5676 Softskip moves the frame skipping (dropping) step of encoding from | |
5677 before the filter chain to some point during the filter chain. | |
5678 This allows filters which need to see all frames (inverse telecine, | |
5679 temporal denoising, etc.) to function properly. | |
5680 Should be placed after the filters which need to see all frames and | |
5681 before any subsequent filters that are CPU-intensive. | |
5682 . | |
5683 .TP | |
5684 .B decimate[=max:hi:lo:frac] | |
5685 Drops frames that do not differ greatly from the previous frame in | |
5686 order to reduce framerate. | |
5687 The main use of this filter is for very-low-bitrate encoding (e.g.\& | |
5688 streaming over dialup modem), but it could in theory be used for | |
5689 fixing movies that were inverse-telecined incorrectly. | |
5690 .PD 0 | |
5691 .RSs | |
5692 .IPs <max> | |
5693 Sets the maximum number of consecutive frames which can be | |
5694 dropped (if positive), or the minimum interval between | |
5695 dropped frames (if negative). | |
5696 .IPs <hi>,<lo>,<frac> | |
5697 A frame is a candidate for dropping if no 8x8 region differs by more | |
5698 than a threshold of <hi>, and if not more than <frac> portion (1 | |
5699 meaning the whole image) differs by more than a threshold of <lo>. | |
5700 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual | |
5701 pixel value differences, so a threshold of 64 corresponds to 1 unit of | |
5702 difference for each pixel, or the same spread out differently over the | |
5703 block. | |
5704 .RE | |
5705 .PD 1 | |
5706 . | |
5707 .TP | |
5708 .B dint[=sense:level] | |
5709 The drop-deinterlace (dint) filter detects and drops the first from a set | |
5710 of interlaced video frames. | |
5711 .PD 0 | |
5712 .RSs | |
5713 .IPs <0.0\-1.0> | |
5714 relative difference between neighboring pixels (default: 0.1) | |
5715 .IPs <0.0\-1.0> | |
5716 What part of the image has to be detected as interlaced to | |
5717 drop the frame (default: 0.15). | |
5718 .RE | |
5719 .PD 1 | |
5720 . | |
5721 .TP | |
5722 .B lavcdeint (OBSOLETE) | |
5723 FFmpeg deinterlacing filter, same as \-vf pp=fd | |
5724 . | |
5725 .TP | |
5726 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]] | |
5727 Donald Graft's adaptive kernel deinterlacer. | |
5728 Deinterlaces parts of a video if a configurable threshold is exceeded. | |
5729 .PD 0 | |
5730 .RSs | |
5731 .IPs <0\-255> | |
5732 threshold (default: 10) | |
5733 .IPs <map> | |
5734 .RSss | |
5735 0: Ignore pixels exceeding the threshold (default). | |
5736 .br | |
5737 1: Paint pixels exceeding the threshold white. | |
5738 .REss | |
5739 .IPs <order> | |
5740 .RSss | |
5741 0: Leave fields alone (default). | |
5742 .br | |
5743 1: Swap fields. | |
5744 .REss | |
5745 .IPs <sharp> | |
5746 .RSss | |
5747 0: Disable additional sharpening (default). | |
5748 .br | |
5749 1: Enable additional sharpening. | |
5750 .REss | |
5751 .IPs <twoway> | |
5752 .RSss | |
5753 0: Disable twoway sharpening (default). | |
5754 .br | |
5755 1: Enable twoway sharpening. | |
5756 .REss | |
5757 .RE | |
5758 .PD 1 | |
5759 . | |
5760 .TP | |
5761 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]] | |
5762 unsharp mask / gaussian blur | |
5763 .RSs | |
5764 .IPs "l\ \ \ \ " | |
5765 Apply effect on luma component. | |
5766 .IPs "c\ \ \ \ " | |
5767 Apply effect on chroma components. | |
5768 .IPs <width>x<height> | |
5769 width and height of the matrix, odd sized in both directions | |
5770 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7) | |
5771 .IPs amount | |
5772 Relative amount of sharpness/\:blur to add to the image | |
5773 (a sane range should be -1.5\-1.5). | |
5774 .RSss | |
5775 <0: blur | |
5776 .br | |
5777 >0: sharpen | |
5778 .REss | |
5779 .RE | |
5780 . | |
5781 .TP | |
5782 .B "swapuv\ " | |
5783 Swap U & V plane. | |
5784 . | |
5785 .TP | |
5786 .B il[=d|i][s][:[d|i][s]] | |
5787 (De)interleaves lines. | |
5788 The goal of this filter is to add the ability to process interlaced images | |
5789 pre-field without deinterlacing them. | |
5790 You can filter your interlaced DVD and play it on a TV without breaking the | |
5791 interlacing. | |
5792 While deinterlacing (with the postprocessing filter) removes interlacing | |
5793 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into | |
5794 2 fields (so called half pictures), so you can process (filter) them | |
5795 independently and then re-interleave them. | |
5796 .PD 0 | |
5797 .RSs | |
5798 .IPs d | |
5799 deinterleave (placing one above the other) | |
5800 .IPs i | |
5801 interleave | |
5802 .IPs s | |
5803 swap fields (exchange even & odd lines) | |
5804 .RE | |
5805 .PD 1 | |
5806 . | |
5807 .TP | |
5808 .B fil[=i|d] | |
5809 (De)interleaves lines. | |
5810 This filter is very similar to the il filter but much faster, the main | |
5811 disadvantage is that it does not always work. | |
5812 Especially if combined with other filters it may produce randomly messed | |
5813 up images, so be happy if it works but do not complain if it does not for | |
5814 your combination of filters. | |
5815 .PD 0 | |
5816 .RSs | |
5817 .IPs d | |
5818 Deinterleave fields, placing them side by side. | |
5819 .IPs i | |
5820 Interleave fields again (reversing the effect of fil=d). | |
5821 .RE | |
5822 .PD 1 | |
5823 . | |
5824 .TP | |
5825 .B field[=n] | |
5826 Extracts a single field from an interlaced image using stride arithmetic | |
5827 to avoid wasting CPU time. | |
5828 The optional argument n specifies whether to extract the even or the odd | |
5829 field (depending on whether n is even or odd). | |
5830 . | |
5831 .TP | |
5832 .B detc[=var1=value1:var2=value2:...] | |
5833 Attempts to reverse the 'telecine' process to recover a clean, | |
5834 non-interlaced stream at film framerate. | |
5835 This was the first and most primitive inverse telecine filter to be | |
5836 added to MPlayer/\:MEncoder. | |
5837 It works by latching onto the telecine 3:2 pattern and following it as | |
5838 long as possible. | |
5839 This makes it suitable for perfectly-telecined material, even in the | |
5840 presence of a fair degree of noise, but it will fail in the presence | |
5841 of complex post-telecine edits. | |
5842 Development on this filter is no longer taking place, as ivtc, pullup, | |
5843 and filmdint are better for most applications. | |
5844 The following arguments (see syntax above) may be used to control | |
5845 detc's behavior: | |
5846 .RSs | |
5847 .IPs "<dr>\ " | |
5848 Set the frame dropping mode. | |
5849 .RSss | |
5850 0: Do not drop frames to maintain fixed output framerate (default). | |
5851 .br | |
5852 1: Always drop a frame when there have been no drops or telecine | |
5853 merges in the past 5 frames. | |
5854 .br | |
5855 2: Always maintain exact 5:4 input to output frame ratio. | |
5856 .br | |
5857 .I NOTE: | |
5858 Use mode 1 or 2 with MEncoder. | |
5859 .REss | |
5860 .IPs "<am>\ " | |
5861 Analysis mode. | |
5862 .RSss | |
5863 0: Fixed pattern with initial frame number specified by <fr>. | |
5864 .br | |
5865 1: aggressive search for telecine pattern (default) | |
5866 .REss | |
5867 .IPs "<fr>\ " | |
5868 Set initial frame number in sequence. | |
5869 0\-2 are the three clean progressive frames; 3 and 4 are the two | |
5870 interlaced frames. | |
5871 The default, -1, means 'not in telecine sequence'. | |
5872 The number specified here is the type for the imaginary previous | |
5873 frame before the movie starts. | |
5874 .IPs "<t0>, <t1>, <t2>, <t3>" | |
5875 Threshold values to be used in certain modes. | |
5876 .RE | |
5877 . | |
5878 .TP | |
5879 .B ivtc[=1] | |
5880 Experimental 'stateless' inverse telecine filter. | |
5881 Rather than trying to lock on to a pattern like the detc filter does, | |
5882 ivtc makes its decisions independently for each frame. | |
5883 This will give much better results for material that has undergone | |
5884 heavy editing after telecine was applied, but as a result it is not as | |
5885 forgiving of noisy input, for example TV capture. | |
5886 The optional parameter (ivtc=1) corresponds to the dr=1 option for the | |
5887 detc filter, and should be used with MEncoder but not with MPlayer. | |
5888 As with detc, you must specify the correct output framerate (\-ofps | |
5889 24000/1001) when using MEncoder. | |
5890 Further development on ivtc has stopped, as the pullup and filmdint | |
5891 filters appear to be much more accurate. | |
5892 . | |
5893 .TP | |
5894 .B pullup[=jl:jr:jt:jb:sb:mp] | |
5895 Third-generation pulldown reversal (inverse telecine) filter, | |
5896 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001 | |
5897 fps progressive content. | |
5898 The pullup filter is designed to be much more robust than detc or | |
5899 ivtc, by taking advantage of future context in making its decisions. | |
5900 Like ivtc, pullup is stateless in the sense that it does not lock onto | |
5901 a pattern to follow, but it instead looks forward to the following | |
5902 fields in order to identify matches and rebuild progressive frames. | |
5903 It is still under development, but believed to be quite accurate. | |
5904 The jl, jr, jt, and jb options set the amount of "junk" to ignore at | |
5905 the left, right, top, and bottom of the image, respectively. | |
5906 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of | |
5907 2 lines. | |
5908 The default is 8 pixels on each side. | |
5909 Setting the sb (strict breaks) option to 1 will reduce the chances of | |
5910 pullup generating an occasional mismatched frame, but it may also | |
5911 cause an excessive number of frames to be dropped during high motion | |
5912 sequences. | |
5913 Conversely, setting it to -1 will make pullup match fields more | |
5914 easily. | |
5915 This may help processing of video where there is slight blurring | |
5916 between the fields, but may also cause there to be interlaced frames | |
5917 in the output. | |
5918 The mp (metric plane) option may be set to 1 or 2 to use a chroma | |
5919 plane instead of the luma plane for doing pullup's computations. | |
5920 This may improve accuracy on very clean source material, but more | |
5921 likely will decrease accuracy, especially if there is chroma noise | |
5922 (rainbow effect) or any grayscale video. | |
5923 The main purpose of setting mp to a chroma plane is to reduce CPU load | |
5924 and make pullup usable in realtime on slow machines. | |
5925 .br | |
5926 .I NOTE: | |
5927 Always follow pullup with the softskip filter when encoding to ensure | |
5928 that pullup is able to see each frame. | |
5929 Failure to do so will lead to incorrect output and will usually crash, | |
5930 due to design limitations in the codec/\:filter layer. | |
5931 . | |
5932 .TP | |
5933 .B filmdint[=options] | |
5934 Inverse telecine filter, similar to the pullup filter above. | |
5935 It is designed to handle any pulldown pattern, including mixed soft and | |
5936 hard telecine and limited support for movies that are slowed down or sped | |
5937 up from their original framerate for TV. | |
5938 Only the luma plane is used to find the frame breaks. | |
5939 If a field has no match, it is deinterlaced with simple linear | |
5940 approximation. | |
5941 If the source is MPEG-2, this must be the first filter to allow | |
5942 access to the field-flags set by the MPEG-2 decoder. | |
5943 Depending on the source MPEG, you may be fine ignoring this advice, as | |
5944 long as you do not see lots of "Bottom-first field" warnings. | |
5945 With no options it does normal inverse telecine, and should be used | |
5946 together with mencoder \-fps 30000/1001 \-ofps 24000/1001. | |
5947 When this filter is used with mplayer, it will result in an uneven | |
5948 framerate during playback, but it is still generally better than using | |
5949 pp=lb or no deinterlacing at all. | |
5950 Multiple options can be specified separated by /. | |
5951 .RSs | |
5952 .IPs crop=<w>:<h>:<x>:<y> | |
5953 Just like the crop filter, but faster, and works on mixed hard and soft | |
5954 telecined content as well as when y is not a multiple of 4. | |
5955 If x or y would require cropping fractional pixels from the chroma | |
5956 planes, the crop area is extended. | |
5957 This usually means that x and y must be even. | |
5958 .IPs io=<ifps>:<ofps> | |
5959 For each ifps input frames the filter will output ofps frames. | |
5960 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio. | |
5961 This could be used to filter movies that are broadcast on TV at a frame | |
5962 rate different from their original framerate. | |
5963 .IPs luma_only=<n> | |
5964 If n is nonzero, the chroma plane is copied unchanged. | |
5965 This is useful for YV12 sampled TV, which discards one of the chroma | |
5966 fields. | |
5967 .IPs mmx2=<n> | |
5968 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow! | |
5969 optimized functions, otherwise, use plain C. | |
5970 If this option is not specified, MMX2 and 3DNow! are auto-detected, use | |
5971 this option to override auto-detection. | |
5972 .IPs fast=<n> | |
5973 The larger n will speed up the filter at the expense of accuracy. | |
5974 The default value is n=3. | |
5975 If n is odd, a frame immediately following a frame marked with the | |
5976 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter | |
5977 will not spend any time on soft-telecined MPEG-2 content. | |
5978 This is the only effect of this flag if MMX2 or 3DNow! is available. | |
5979 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used | |
5980 as with n=2 or 3. | |
5981 If n=2 or 3, the number of luma levels used to find the frame breaks is | |
5982 reduced from 256 to 128, which results in a faster filter without losing | |
5983 much accuracy. | |
5984 If n=4 or 5, a faster, but much less accurate metric will be used to | |
5985 find the frame breaks, which is more likely to misdetect high vertical | |
5986 detail as interlaced content. | |
5987 .IPs verbose=<n> | |
5988 If n is nonzero, print the detailed metrics for each frame. | |
5989 Useful for debugging. | |
5990 .IPs dint_thres=<n> | |
5991 Deinterlace threshold. | |
5992 Used during de-interlacing of unmatched frames. | |
5993 Larger value means less deinterlacing, use n=256 to completely turn off | |
5994 deinterlacing. | |
5995 Default is n=8. | |
5996 .IPs comb_thres=<n> | |
5997 Threshold for comparing a top and bottom fields. | |
5998 Defaults to 128. | |
5999 .IPs diff_thres=<n> | |
6000 Threshold to detect temporal change of a field. | |
6001 Default is 128. | |
6002 .IPs sad_thres=<n> | |
6003 Sum of Absolute Difference threshold, default is 64. | |
6004 .RE | |
6005 . | |
6006 .TP | |
6007 .B softpulldown | |
6008 This filter works only correct with MEncoder and acts on the MPEG-2 flags | |
6009 used for soft 3:2 pulldown (soft telecine). | |
6010 If you want to use the ivtc or detc filter on movies that are partly soft | |
6011 telecined, inserting this filter before them should make them more reliable. | |
6012 . | |
6013 .TP | |
6014 .B divtc[=options] | |
6015 Inverse telecine for deinterlaced video. | |
6016 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced | |
6017 using a method that keeps one field and interpolates the other, the result is | |
6018 a juddering video that has every fourth frame duplicated. | |
6019 This filter is intended to find and drop those duplicates and restore the | |
6020 original film framerate. | |
6021 When using this filter, you must specify \-ofps that is 4/5 of | |
6022 the fps of the input file and place the softskip later in the | |
6023 filter chain to make sure that divtc sees all the frames. | |
6024 Two different modes are available: | |
6025 One pass mode is the default and is straightforward to use, | |
6026 but has the disadvantage that any changes in the telecine | |
6027 phase (lost frames or bad edits) cause momentary judder | |
6028 until the filter can resync again. | |
6029 Two pass mode avoids this by analyzing the whole video | |
6030 beforehand so it will have forward knowledge about the | |
6031 phase changes and can resync at the exact spot. | |
6032 These passes do | |
6033 .B not | |
6034 correspond to pass one and two of the encoding process. | |
6035 You must run an extra pass using divtc pass one before the | |
6036 actual encoding throwing the resulting video away. | |
6037 Use \-nosound \-ovc raw \-o /dev/null to avoid | |
6038 wasting CPU power for this pass. | |
6039 You may add something like crop=2:2:0:0 after divtc | |
6040 to speed things up even more. | |
6041 Then use divtc pass two for the actual encoding. | |
6042 If you use multiple encoder passes, use divtc | |
6043 pass two for all of them. | |
6044 The options are: | |
6045 .RSs | |
6046 .IPs pass=1|2 | |
6047 Use two pass mode. | |
6048 .IPs file=<filename> | |
6049 Set the two pass log filename (default: "framediff.log"). | |
6050 .IPs threshold=<value> | |
6051 Set the minimum strength the telecine pattern must have for the filter to | |
6052 believe in it (default: 0.5). | |
6053 This is used to avoid recognizing false pattern from the parts of the video | |
6054 that are very dark or very still. | |
6055 .IPs window=<numframes> | |
6056 Set the number of past frames to look at when searching for pattern | |
6057 (default: 30). | |
6058 Longer window improves the reliability of the pattern search, but shorter | |
6059 window improves the reaction time to the changes in the telecine phase. | |
6060 This only affects the one pass mode. | |
6061 The two pass mode currently uses fixed window that extends to both future | |
6062 and past. | |
6063 .IPs phase=0|1|2|3|4 | |
6064 Sets the initial telecine phase for one pass mode (default: 0). | |
6065 The two pass mode can see the future, so it is able to use the correct | |
6066 phase from the beginning, but one pass mode can only guess. | |
6067 It catches the correct phase when it finds it, but this option can be used | |
6068 to fix the possible juddering at the beginning. | |
6069 The first pass of the two pass mode also uses this, so if you save the output | |
6070 from the first pass, you get constant phase result. | |
6071 .IPs deghost=<value> | |
6072 Set the deghosting threshold (0\-255 for one pass mode, -255\-255 for two pass | |
6073 mode, default 0). | |
6074 If nonzero, deghosting mode is used. | |
6075 This is for video that has been deinterlaced by blending the fields | |
6076 together instead of dropping one of the fields. | |
6077 Deghosting amplifies any compression artifacts in the blended frames, so the | |
6078 parameter value is used as a threshold to exclude those pixels from | |
6079 deghosting that differ from the previous frame less than specified value. | |
6080 If two pass mode is used, then negative value can be used to make the | |
6081 filter analyze the whole video in the beginning of pass-2 to determine | |
6082 whether it needs deghosting or not and then select either zero or the | |
6083 absolute value of the parameter. | |
6084 Specify this option for pass-2, it makes no difference on pass-1. | |
6085 .RE | |
6086 . | |
6087 .TP | |
6088 .B phase[=t|b|p|a|u|T|B|A|U][:v] | |
6089 Delay interlaced video by one field time so that the field order | |
6090 changes. | |
6091 The intended use is to fix PAL movies that have been captured with the | |
6092 opposite field order to the film-to-video transfer. | |
6093 The options are: | |
6094 .RSs | |
6095 .IPs t | |
6096 Capture field order top-first, transfer bottom-first. | |
6097 Filter will delay the bottom field. | |
6098 .IPs b | |
6099 Capture bottom-first, transfer top-first. | |
6100 Filter will delay the top field. | |
6101 .IPs p | |
6102 Capture and transfer with the same field order. | |
6103 This mode only exists for the documentation of the other options to refer to, | |
6104 but if you actually select it, the filter will faithfully do nothing ;-) | |
6105 .IPs a | |
6106 Capture field order determined automatically by field flags, transfer opposite. | |
6107 Filter selects among t and b modes on a frame by frame basis using field flags. | |
6108 If no field information is available, then this works just like u. | |
6109 .IPs u | |
6110 Capture unknown or varying, transfer opposite. | |
6111 Filter selects among t and b on a frame by frame basis by analyzing the | |
6112 images and selecting the alternative that produces best match between the | |
6113 fields. | |
6114 .IPs T | |
6115 Capture top-first, transfer unknown or varying. | |
6116 Filter selects among t and p using image analysis. | |
6117 .IPs B | |
6118 Capture bottom-first, transfer unknown or varying. | |
6119 Filter selects among b and p using image analysis. | |
6120 .IPs A | |
6121 Capture determined by field flags, transfer unknown or varying. | |
6122 Filter selects among t, b and p using field flags and image analysis. | |
6123 If no field information is available, then this works just like U. | |
6124 This is the default mode. | |
6125 .IPs U | |
6126 Both capture and transfer unknown or varying. | |
6127 Filter selects among t, b and p using image analysis only. | |
6128 .IPs v | |
6129 Verbose operation. | |
6130 Prints the selected mode for each frame and the average squared difference | |
6131 between fields for t, b, and p alternatives. | |
6132 .RE | |
6133 . | |
6134 .TP | |
6135 .B telecine[=start] | |
6136 Apply 3:2 'telecine' process to increase framerate by 20%. | |
6137 This most likely will not work correctly with MPlayer, but it can | |
6138 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'. | |
6139 Both fps options are essential! | |
6140 (A/V sync will break if they are wrong.) | |
6141 The optional start parameter tells the filter where in the telecine | |
6142 pattern to start (0\-3). | |
6143 . | |
6144 .TP | |
6145 .B tinterlace[=mode] | |
6146 Temporal field interlacing \- merge pairs of frames into an interlaced | |
6147 frame, halving the framerate. | |
6148 Even frames are moved into the upper field, odd frames to the lower field. | |
6149 This can be used to fully reverse the effect of the tfields filter (in mode 0). | |
6150 Available modes are: | |
6151 .PD 0 | |
6152 .RSs | |
6153 .IPs 0 | |
6154 Move odd frames into the upper field, even into the lower field, generating | |
6155 a full-height frame at half framerate. | |
6156 .IPs 1 | |
6157 Only output odd frames, even frames are dropped; height unchanged. | |
6158 .IPs 2 | |
6159 Only output even frames, odd frames are dropped; height unchanged. | |
6160 .IPs 3 | |
6161 Expand each frame to full height, but pad alternate lines with black; | |
6162 framerate unchanged. | |
6163 .IPs 4 | |
6164 Interleave even lines from even frames with odd lines from odd frames. | |
6165 Generates full-height frame at half framerate. | |
6166 .RE | |
6167 .PD 1 | |
6168 . | |
6169 .TP | |
6170 .B tfields[=mode[:field_dominance]] | |
6171 Temporal field separation \- split fields into frames, doubling the | |
6172 output framerate. | |
6173 Like the telecine filter, tfields will only work properly with | |
6174 MEncoder, and only if both \-fps and \-ofps are set to the | |
6175 desired (double) framerate! | |
6176 .PD 0 | |
6177 .RSs | |
6178 .IPs <mode> | |
6179 0: Leave fields unchanged (will jump/\:flicker). | |
6180 .br | |
6181 1: Interpolate missing lines. (The algorithm used might not be so good.) | |
6182 .br | |
6183 2: Translate fields by 1/4 pixel with linear interpolation (no jump). | |
6184 .br | |
6185 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default). | |
6186 .IPs <field_dominance> | |
6187 -1: auto (default) | |
6188 Only works if the decoder exports the appropriate information and | |
6189 no other filters which discard that information come before tfields | |
6190 in the filter chain, otherwise it falls back to 0 (top field first). | |
6191 .br | |
6192 0: top field first | |
6193 .br | |
6194 1: bottom field first | |
6195 .RE | |
6196 .PD 1 | |
6197 . | |
6198 .TP | |
6199 .B yadif=[mode[:field_dominance]] | |
6200 Yet another deinterlacing filter | |
6201 .PD 0 | |
6202 .RSs | |
6203 .IPs <mode> | |
6204 0: Output 1 frame for each frame. | |
6205 .br | |
6206 1: Output 1 frame for each field. | |
6207 .br | |
6208 2: Like 0 but skips spatial interlacing check. | |
6209 .br | |
6210 3: Like 1 but skips spatial interlacing check. | |
6211 .IPs <field_dominance> | |
6212 Operates like tfields. | |
6213 .RE | |
6214 .PD 1 | |
6215 . | |
6216 .TP | |
6217 .B mcdeint=[mode[:parity[:qp]]] | |
6218 Motion compensating deinterlacer. | |
6219 It needs one field per frame as input and must thus be used together | |
6220 with tfields=1 or yadif=1/3 or equivalent. | |
6221 .PD 0 | |
6222 .RSs | |
6223 .IPs <mode> | |
6224 0: fast | |
6225 .br | |
6226 1: medium | |
6227 .br | |
6228 2: slow, iterative motion estimation | |
6229 .br | |
6230 3: extra slow, like 2 plus multiple reference frames | |
6231 .IPs <parity> | |
6232 0 or 1 selects which field to use (note: no autodetection yet!). | |
6233 .IPs "<qp>\ " | |
6234 Higher values should result in a smoother motion vector | |
6235 field but less optimal individual vectors. | |
6236 .RE | |
6237 .PD 1 | |
6238 . | |
6239 .TP | |
6240 .B boxblur=radius:power[:radius:power] | |
6241 box blur | |
6242 .PD 0 | |
6243 .RSs | |
6244 .IPs <radius> | |
6245 blur filter strength | |
6246 .IPs <power> | |
6247 number of filter applications | |
6248 .RE | |
6249 .PD 1 | |
6250 . | |
6251 .TP | |
6252 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff] | |
6253 shape adaptive blur | |
6254 .PD 0 | |
6255 .RSs | |
6256 .IPs <radius> | |
6257 blur filter strength (~0.1\-4.0) (slower if larger) | |
6258 .IPs "<pf>\ " | |
6259 prefilter strength (~0.1\-2.0) | |
6260 .IPs <colorDiff> | |
6261 maximum difference between pixels to still be considered (~0.1\-100.0) | |
6262 .RE | |
6263 .PD 1 | |
6264 . | |
6265 .TP | |
6266 .B smartblur=radius:strength:threshold[:radius:strength:threshold] | |
6267 smart blur | |
6268 .PD 0 | |
6269 .RSs | |
6270 .IPs <radius> | |
6271 blur filter strength (~0.1\-5.0) (slower if larger) | |
6272 .IPs <strength> | |
6273 blur (0.0\-1.0) or sharpen (-1.0\-0.0) | |
6274 .IPs <threshold> | |
6275 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) | |
6276 .RE | |
6277 .PD 1 | |
6278 . | |
6279 .TP | |
6280 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t | |
6281 Correct the perspective of movies not filmed perpendicular to the screen. | |
6282 .PD 0 | |
6283 .RSs | |
6284 .IPs <x0>,<y0>,... | |
6285 coordinates of the top left, top right, bottom left, bottom right corners | |
6286 .IPs "<t>\ \ " | |
6287 linear (0) or cubic resampling (1) | |
6288 .RE | |
6289 .PD 1 | |
6290 . | |
6291 .TP | |
6292 .B "2xsai\ \ " | |
6293 Scale and smooth the image with the 2x scale and interpolate algorithm. | |
6294 . | |
6295 .TP | |
6296 .B "1bpp\ \ \ " | |
6297 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion | |
6298 . | |
6299 .TP | |
6300 .B down3dright[=lines] | |
6301 Reposition and resize stereoscopic images. | |
6302 Extracts both stereo fields and places them side by side, resizing | |
6303 them to maintain the original movie aspect. | |
6304 .PD 0 | |
6305 .RSs | |
6306 .IPs <lines> | |
6307 number of lines to select from the middle of the image (default: 12) | |
6308 .RE | |
6309 .PD 1 | |
6310 . | |
6311 .TP | |
6312 .B bmovl=hidden:opaque:fifo | |
6313 The bitmap overlay filter reads bitmaps from a FIFO and displays them | |
6314 on top of the movie, allowing some transformations on the image. | |
6315 Also see TOOLS/bmovl-test.c for a small bmovl test program. | |
6316 .PD 0 | |
6317 .RSs | |
6318 .IPs <hidden> | |
6319 Set the default value of the 'hidden' flag (0=visible, 1=hidden). | |
6320 .IPs <opaque> | |
6321 Set the default value of the 'opaque' flag (0=transparent, 1=opaque). | |
6322 .IPs <fifo> | |
6323 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the | |
6324 controlling application) | |
6325 .RE | |
6326 .PD 1 | |
6327 .sp 1 | |
6328 .RS | |
6329 FIFO commands are: | |
6330 .RE | |
6331 .PD 0 | |
6332 .RSs | |
6333 .IPs "RGBA32 width height xpos ypos alpha clear" | |
6334 followed by width*height*4 Bytes of raw RGBA32 data. | |
6335 .IPs "ABGR32 width height xpos ypos alpha clear" | |
6336 followed by width*height*4 Bytes of raw ABGR32 data. | |
6337 .IPs "RGB24 width height xpos ypos alpha clear" | |
6338 followed by width*height*3 Bytes of raw RGB24 data. | |
6339 .IPs "BGR24 width height xpos ypos alpha clear" | |
6340 followed by width*height*3 Bytes of raw BGR24 data. | |
6341 .IPs "ALPHA width height xpos ypos alpha" | |
6342 Change alpha transparency of the specified area. | |
6343 .IPs "CLEAR width height xpos ypos" | |
6344 Clear area. | |
6345 .IPs OPAQUE | |
6346 Disable all alpha transparency. | |
6347 Send "ALPHA 0 0 0 0 0" to enable it again. | |
6348 .IPs "HIDE\ " | |
6349 Hide bitmap. | |
6350 .IPs "SHOW\ " | |
6351 Show bitmap. | |
6352 .RE | |
6353 .PD 1 | |
6354 .sp 1 | |
6355 .RS | |
6356 Arguments are: | |
6357 .RE | |
6358 .PD 0 | |
6359 .RSs | |
6360 .IPs "<width>, <height>" | |
6361 image/area size | |
6362 .IPs "<xpos>, <ypos>" | |
6363 Start blitting at position x/y. | |
6364 .IPs <alpha> | |
6365 Set alpha difference. | |
6366 If you set this to -255 you can then send a sequence of ALPHA-commands to set | |
6367 the area to -225, -200, -175 etc for a nice fade-in-effect! ;) | |
6368 .RSss | |
6369 0: same as original | |
6370 .br | |
6371 255: Make everything opaque. | |
6372 .br | |
6373 -255: Make everything transparent. | |
6374 .REss | |
6375 .IPs <clear> | |
6376 Clear the framebuffer before blitting. | |
6377 .RSss | |
6378 0: The image will just be blitted on top of the old one, so you do not need to | |
6379 send 1.8MB of RGBA32 data every time a small part of the screen is updated. | |
6380 .br | |
6381 1: clear | |
6382 .REss | |
6383 .RE | |
6384 .PD 1 | |
6385 . | |
6386 .TP | |
6387 .B framestep=I|[i]step | |
6388 Renders only every nth frame or every intra frame (keyframe). | |
6389 .sp 1 | |
6390 If you call the filter with I (uppercase) as the parameter, then | |
6391 .B only | |
6392 keyframes are rendered. | |
6393 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB), | |
6394 for AVI it means every scene change or every keyint value (see \-lavcopts | |
6395 keyint= value if you use MEncoder to encode the video). | |
6396 .sp 1 | |
6397 When a keyframe is found, an 'I!' string followed by a newline character is | |
6398 printed, leaving the current line of MPlayer/\:MEncoder output on the screen, | |
6399 because it contains the time (in seconds) and frame number of the keyframe | |
6400 (You can use this information to split the AVI.). | |
6401 .sp 1 | |
6402 If you call the filter with a numeric parameter 'step' then only one in | |
6403 every 'step' frames is rendered. | |
6404 .sp 1 | |
6405 If you put an 'i' (lowercase) before the number then an 'I!' is printed | |
6406 (like the I parameter). | |
6407 .sp 1 | |
6408 If you give only the i then nothing is done to the frames, only I! is | |
6409 printed. | |
6410 . | |
6411 .TP | |
6412 .B tile=xtiles:ytiles:output:start:delta | |
6413 Tile a series of images into a single, bigger image. | |
6414 If you omit a parameter or use a value less than 0, then the default | |
6415 value is used. | |
6416 You can also stop when you are satisfied (... \-vf tile=10:5 ...). | |
6417 It is probably a good idea to put the scale filter before the tile :-) | |
6418 .sp 1 | |
6419 The parameters are: | |
6420 .sp 1 | |
6421 .PD 0 | |
6422 .RSs | |
6423 .IPs <xtiles> | |
6424 number of tiles on the x axis (default: 5) | |
6425 .IPs <ytiles> | |
6426 number of tiles on the y axis (default: 5) | |
6427 .IPs <output> | |
6428 Render the tile when 'output' number of frames are reached, where 'output' | |
6429 should be a number less than xtile * ytile. | |
6430 Missing tiles are left blank. | |
6431 You could, for example, write an 8 * 7 tile every 50 frames to have one | |
6432 image every 2 seconds @ 25 fps. | |
6433 .IPs <start> | |
6434 outer border thickness in pixels (default: 2) | |
6435 .IPs <delta> | |
6436 inner border thickness in pixels (default: 4) | |
6437 .RE | |
6438 .PD 1 | |
6439 . | |
6440 .TP | |
6441 .B delogo[=x:y:w:h:t] | |
6442 Suppresses a TV station logo by a simple interpolation of the | |
6443 surrounding pixels. | |
6444 Just set a rectangle covering the logo and watch it disappear (and | |
6445 sometimes something even uglier appear \- your mileage may vary). | |
6446 .PD 0 | |
6447 .RSs | |
6448 .IPs <x>,<y> | |
6449 top left corner of the logo | |
6450 .IPs <w>,<h> | |
6451 width and height of the cleared rectangle | |
6452 .IPs <t> | |
6453 Thickness of the fuzzy edge of the rectangle (added to w and h). | |
6454 When set to -1, a green rectangle is drawn on the screen to | |
6455 simplify finding the right x,y,w,h parameters. | |
6456 .RE | |
6457 .PD 1 | |
6458 . | |
6459 .TP | |
6460 .B remove-logo=/path/to/logo_bitmap_file_name.pgm | |
6461 Suppresses a TV station logo, using a PGM or PPM image | |
6462 file to determine which pixels comprise the logo. | |
6463 The width and height of the image file must match | |
6464 those of the video stream being processed. | |
6465 Uses the filter image and a circular blur | |
6466 algorithm to remove the logo. | |
6467 .RSs | |
6468 .IPs /path/to/logo_bitmap_file_name.pgm | |
6469 [path] + filename of the filter image. | |
6470 .RE | |
6471 . | |
6472 .TP | |
6473 .B zrmjpeg[=options] | |
6474 Software YV12 to MJPEG encoder for use with the zr2 video | |
6475 output device. | |
6476 .RSs | |
6477 .IPs maxheight=<h>|maxwidth=<w> | |
6478 These options set the maximum width and height the zr card | |
6479 can handle (the MPlayer filter layer currently cannot query those). | |
6480 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC} | |
6481 Use these options to set maxwidth and maxheight automatically to the | |
6482 values known for card/\:mode combo. | |
6483 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL) | |
6484 .IPs color|bw | |
6485 Select color or black and white encoding. | |
6486 Black and white encoding is faster. | |
6487 Color is the default. | |
6488 .IPs hdec={1,2,4} | |
6489 Horizontal decimation 1, 2 or 4. | |
6490 .IPs vdec={1,2,4} | |
6491 Vertical decimation 1, 2 or 4. | |
6492 .IPs quality=1\-20 | |
6493 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD]. | |
6494 .IPs fd|nofd | |
6495 By default, decimation is only performed if the Zoran hardware | |
6496 can upscale the resulting MJPEG images to the original size. | |
6497 The option fd instructs the filter to always perform the requested | |
6498 decimation (ugly). | |
6499 .RE | |
6500 . | |
6501 .TP | |
6502 .B screenshot | |
6503 Allows acquiring screenshots of the movie using slave mode | |
6504 commands that can be bound to keypresses. | |
6505 See the slave mode documentation and the INTERACTIVE CONTROL | |
6506 section for details. | |
6507 Files named 'shotNNNN.png' will be saved in the working directory, | |
6508 using the first available number - no files will be overwritten. | |
6509 The filter has no overhead when not used and accepts an arbitrary | |
6510 colorspace, so it is safe to add it to the configuration file. | |
6511 .RE | |
6512 . | |
6513 .TP | |
6514 .B "ass\ \ \ \ " | |
6515 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain. | |
6516 Only useful with the \-ass option. | |
6517 .sp 1 | |
6518 .I EXAMPLE: | |
6519 .PD 0 | |
6520 .RSs | |
6521 .IPs "\-vf ass,screenshot" | |
6522 Moves SSA/ASS rendering before the screenshot filter. | |
6523 Screenshots taken this way will contain subtitles. | |
6524 .RE | |
6525 .PD 1 | |
6526 . | |
6527 .TP | |
6528 .B blackframe[=amount:threshold] | |
6529 Detect frames that are (almost) completely black. | |
6530 Can be useful to detect chapter transitions or commercials. | |
6531 Output lines consist of the frame number of the detected frame, the | |
6532 percentage of blackness, the frame type and the frame number of the last | |
6533 encountered keyframe. | |
6534 .RSs | |
6535 .IPs <amount> | |
6536 Percentage of the pixels that have to be below the threshold (default: 98). | |
6537 .IPs <threshold> | |
6538 Threshold below which a pixel value is considered black (default: 32). | |
6539 .RE | |
6540 . | |
6541 . | |
6542 . | |
6543 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)" | |
6544 . | |
6545 .TP | |
6546 .B \-audio-delay <any floating-point number> | |
6547 Delays either audio or video by setting a delay field in the header | |
6548 (default: 0.0). | |
6549 This does not delay either stream while encoding, but the player will | |
6550 see the delay field and compensate accordingly. | |
6551 Positive values delay the audio, and negative values delay the video. | |
6552 Note that this is the exact opposite of the \-delay option. | |
6553 For example, if a video plays correctly with \-delay 0.2, you can | |
6554 fix the video with MEncoder by using \-audio-delay -0.2. | |
6555 .sp 1 | |
6556 Currently, this option only works with the default muxer (\-of avi). | |
6557 If you are using a different muxer, then you must use \-delay instead. | |
6558 . | |
6559 .TP | |
6560 .B \-audio-density <1\-50> | |
6561 Number of audio chunks per second (default is 2 for 0.5s long audio chunks). | |
6562 .br | |
6563 .I NOTE: | |
6564 CBR only, VBR ignores this as it puts each packet in a new chunk. | |
6565 . | |
6566 .TP | |
6567 .B \-audio-preload <0.0\-2.0> | |
6568 Sets up the audio buffering time interval (default: 0.5s). | |
6569 . | |
6570 .TP | |
6571 .B \-fafmttag <format> | |
6572 Can be used to override the audio format tag of the output file. | |
6573 .sp 1 | |
6574 .I EXAMPLE: | |
6575 .PD 0 | |
6576 .RSs | |
6577 .IPs "\-fafmttag 0x55" | |
6578 Will have the output file contain 0x55 (mp3) as audio format tag. | |
6579 .RE | |
6580 .PD 1 | |
6581 . | |
6582 .TP | |
6583 .B \-ffourcc <fourcc> | |
6584 Can be used to override the video fourcc of the output file. | |
6585 .sp 1 | |
6586 .I EXAMPLE: | |
6587 .PD 0 | |
6588 .RSs | |
6589 .IPs "\-ffourcc div3" | |
6590 Will have the output file contain 'div3' as video fourcc. | |
6591 .RE | |
6592 .PD 1 | |
6593 . | |
6594 .TP | |
6595 .B \-force-avi-aspect <0.2\-3.0> | |
6596 Override the aspect stored in the AVI OpenDML vprp header. | |
6597 This can be used to change the aspect ratio with '\-ovc copy'. | |
6598 . | |
6599 .TP | |
6600 .B \-frameno-file <filename> (DEPRECATED) | |
6601 Specify the name of the audio file with framenumber mappings created in | |
6602 the first (audio only) pass of a special three pass encoding mode. | |
6603 .br | |
6604 .I NOTE: | |
6605 Using this mode will most likely give you A-V desync. | |
6606 Do not use it. | |
6607 It is kept for backwards compatibility only and will possibly | |
6608 be removed in a future version. | |
6609 . | |
6610 .TP | |
6611 .B \-hr-edl-seek | |
6612 Use a more precise, but much slower method for skipping areas. | |
6613 Areas marked for skipping are not seeked over, instead all | |
6614 frames are decoded, but only the necessary frames are encoded. | |
6615 This allows starting at non-keyframe boundaries. | |
6616 .br | |
6617 .I NOTE: | |
6618 Not guaranteed to work right with '\-ovc copy'. | |
6619 . | |
6620 .TP | |
6621 .B \-info <option1:option2:...> (AVI only) | |
6622 Specify the info header of the resulting AVI file. | |
6623 .sp 1 | |
6624 Available options are: | |
6625 .RSs | |
6626 .IPs "help\ " | |
6627 Show this description. | |
6628 .IPs name=<value> | |
6629 title of the work | |
6630 .IPs artist=<value> | |
6631 artist or author of the work | |
6632 .IPs genre=<value> | |
6633 original work category | |
6634 .IPs subject=<value> | |
6635 contents of the work | |
6636 .IPs copyright=<value> | |
6637 copyright information | |
6638 .IPs srcform=<value> | |
6639 original format of the digitized material | |
6640 .IPs comment=<value> | |
6641 general comments about the work | |
6642 .RE | |
6643 . | |
6644 .TP | |
6645 .B \-noautoexpand | |
6646 Do not automatically insert the expand filter into the MEncoder filter chain. | |
6647 Useful to control at which point of the filter chain subtitles are rendered | |
6648 when hardcoding subtitles onto a movie. | |
6649 . | |
6650 .TP | |
6651 .B \-noencodedups | |
6652 Do not attempt to encode duplicate frames in duplicate; always output | |
6653 zero-byte frames to indicate duplicates. | |
6654 Zero-byte frames will be written anyway unless a filter or encoder | |
6655 capable of doing duplicate encoding is loaded. | |
6656 Currently the only such filter is harddup. | |
6657 . | |
6658 .TP | |
6659 .B \-noodml (\-of avi only) | |
6660 Do not write OpenDML index for AVI files >1GB. | |
6661 . | |
6662 .TP | |
6663 .B \-noskip | |
6664 Do not skip frames. | |
6665 . | |
6666 .TP | |
6667 .B \-o <filename> | |
6668 Outputs to the given filename. | |
6669 .br | |
6670 If you want a default output filename, you can put this option in the | |
6671 MEncoder config file. | |
6672 . | |
6673 .TP | |
6674 .B \-oac <codec name> | |
6675 Encode with the given audio codec (no default set). | |
6676 .br | |
6677 .I NOTE: | |
6678 Use \-oac help to get a list of available audio codecs. | |
6679 .sp 1 | |
6680 .I EXAMPLE: | |
6681 .PD 0 | |
6682 .RSs | |
6683 .IPs "\-oac copy" | |
6684 no encoding, just streamcopy | |
6685 .IPs "\-oac pcm" | |
6686 Encode to uncompressed PCM. | |
6687 .IPs "\-oac mp3lame" | |
6688 Encode to MP3 (using LAME). | |
6689 .IPs "\-oac lavc" | |
6690 Encode with a libavcodec codec. | |
6691 .RE | |
6692 .PD 1 | |
6693 . | |
6694 .TP | |
6695 .B \-of <format> (BETA CODE!) | |
6696 Encode to the specified container format (default: AVI). | |
6697 .br | |
6698 .I NOTE: | |
6699 Use \-of help to get a list of available container formats. | |
6700 .sp 1 | |
6701 .I EXAMPLE: | |
6702 .PD 0 | |
6703 .RSs | |
6704 .IPs "\-of avi" | |
6705 Encode to AVI. | |
6706 .IPs "\-of mpeg" | |
6707 Encode to MPEG (also see \-mpegopts). | |
6708 .IPs "\-of lavf" | |
6709 Encode with libavformat muxers (also see \-lavfopts). | |
6710 .IPs "\-of rawvideo" | |
6711 raw video stream (no muxing \- one video stream only) | |
6712 .IPs "\-of rawaudio" | |
6713 raw audio stream (no muxing \- one audio stream only) | |
6714 .RE | |
6715 .PD 1 | |
6716 . | |
6717 .TP | |
6718 .B \-ofps <fps> | |
6719 Specify a frames per second (fps) value for the output file, | |
6720 which can be different from that of the source material. | |
6721 Must be set for variable fps (ASF, some MOV) and progressive | |
6722 (30000/1001 fps telecined MPEG) files. | |
6723 . | |
6724 .TP | |
6725 .B \-ovc <codec name> | |
6726 Encode with the given video codec (no default set). | |
6727 .br | |
6728 .I NOTE: | |
6729 Use \-ovc help to get a list of available video codecs. | |
6730 .sp 1 | |
6731 .I EXAMPLE: | |
6732 .PD 0 | |
6733 .RSs | |
6734 .IPs "\-ovc copy" | |
6735 no encoding, just streamcopy | |
6736 .IPs "\-ovc raw" | |
6737 Encode to an arbitrary uncompressed format (use '\-vf format' to select). | |
6738 .IPs "\-ovc lavc" | |
6739 Encode with a libavcodec codec. | |
6740 .RE | |
6741 .PD 1 | |
6742 . | |
6743 .TP | |
6744 .B \-passlogfile <filename> | |
6745 Dump first pass information to <filename> instead of the default divx2pass.log | |
6746 in two pass encoding mode. | |
6747 . | |
6748 .TP | |
6749 .B \-skiplimit <value> | |
6750 Specify the maximum number of frames that may be skipped after | |
6751 encoding one frame (\-noskiplimit for unlimited). | |
6752 . | |
6753 .TP | |
6754 .B \-vobsubout <basename> | |
6755 Specify the basename for the output .idx and .sub files. | |
6756 This turns off subtitle rendering in the encoded movie and diverts it to | |
6757 VOBsub subtitle files. | |
6758 . | |
6759 .TP | |
6760 .B \-vobsuboutid <langid> | |
6761 Specify the language two letter code for the subtitles. | |
6762 This overrides what is read from the DVD or the .ifo file. | |
6763 . | |
6764 .TP | |
6765 .B \-vobsuboutindex <index> | |
6766 Specify the index of the subtitles in the output files (default: 0). | |
6767 . | |
6768 . | |
6769 . | |
6770 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)" | |
6771 You can specify codec specific encoding parameters using the following | |
6772 syntax: | |
6773 . | |
6774 .TP | |
6775 .B \-<codec>opts <option1[=value],option2,...> | |
6776 . | |
6777 .PP | |
6778 Where <codec> may be: lavc, xvidenc, lame, toolame, twolame, | |
6779 nuv, xvfw, faac, x264enc, mpeg, lavf. | |
6780 . | |
6781 . | |
6782 .SS lame (\-lameopts) | |
6783 . | |
6784 .TP | |
6785 .B "help\ \ \ " | |
6786 get help | |
6787 . | |
6788 .TP | |
6789 .B vbr=<0\-4> | |
6790 variable bitrate method | |
6791 .PD 0 | |
6792 .RSs | |
6793 .IPs 0 | |
6794 cbr | |
6795 .IPs 1 | |
6796 mt | |
6797 .IPs 2 | |
6798 rh (default) | |
6799 .IPs 3 | |
6800 abr | |
6801 .IPs 4 | |
6802 mtrh | |
6803 .RE | |
6804 .PD 1 | |
6805 . | |
6806 .TP | |
6807 .B "abr\ \ \ \ " | |
6808 average bitrate | |
6809 . | |
6810 .TP | |
6811 .B "cbr\ \ \ \ " | |
6812 constant bitrate | |
6813 Also forces CBR mode encoding on subsequent ABR presets modes. | |
6814 . | |
6815 .TP | |
6816 .B br=<0\-1024> | |
6817 bitrate in kbps (CBR and ABR only) | |
6818 . | |
6819 .TP | |
6820 .B q=<0\-9> | |
6821 quality (0 \- highest, 9 \- lowest) (VBR only) | |
6822 . | |
6823 .TP | |
6824 .B aq=<0\-9> | |
6825 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest) | |
6826 . | |
6827 .TP | |
6828 .B ratio=<1\-100> | |
6829 compression ratio | |
6830 . | |
6831 .TP | |
6832 .B vol=<0\-10> | |
6833 audio input gain | |
6834 . | |
6835 .TP | |
6836 .B mode=<0\-3> | |
6837 (default: auto) | |
6838 .PD 0 | |
6839 .RSs | |
6840 .IPs 0 | |
6841 stereo | |
6842 .IPs 1 | |
6843 joint-stereo | |
6844 .IPs 2 | |
6845 dualchannel | |
6846 .IPs 3 | |
6847 mono | |
6848 .RE | |
6849 .PD 1 | |
6850 . | |
6851 .TP | |
6852 .B padding=<0\-2> | |
6853 .PD 0 | |
6854 .RSs | |
6855 .IPs 0 | |
6856 none | |
6857 .IPs 1 | |
6858 all | |
6859 .IPs 2 | |
6860 adjust | |
6861 .RE | |
6862 .PD 1 | |
6863 . | |
6864 .TP | |
6865 .B "fast\ \ \ " | |
6866 Switch on faster encoding on subsequent VBR presets modes. | |
6867 This results in slightly lower quality and higher bitrates. | |
6868 . | |
6869 .TP | |
6870 .B highpassfreq=<freq> | |
6871 Set a highpass filtering frequency in Hz. | |
6872 Frequencies below the specified one will be cut off. | |
6873 A value of -1 will disable filtering, a value of 0 | |
6874 will let LAME choose values automatically. | |
6875 . | |
6876 .TP | |
6877 .B lowpassfreq=<freq> | |
6878 Set a lowpass filtering frequency in Hz. | |
6879 Frequencies above the specified one will be cut off. | |
6880 A value of -1 will disable filtering, a value of 0 | |
6881 will let LAME choose values automatically. | |
6882 . | |
6883 .TP | |
6884 .B preset=<value> | |
6885 preset values | |
6886 .RSs | |
6887 .IPs "help\ " | |
6888 Print additional options and information about presets settings. | |
6889 .IPs medium | |
6890 VBR encoding, good quality, 150\-180 kbps bitrate range | |
6891 .IPs standard | |
6892 VBR encoding, high quality, 170\-210 kbps bitrate range | |
6893 .IPs extreme | |
6894 VBR encoding, very high quality, 200\-240 kbps bitrate range | |
6895 .IPs insane | |
6896 CBR encoding, highest preset quality, 320 kbps bitrate | |
6897 .IPs <8\-320> | |
6898 ABR encoding at average given kbps bitrate | |
6899 .RE | |
6900 .sp 1 | |
6901 .RS | |
6902 .I EXAMPLES: | |
6903 .RE | |
6904 .PD 0 | |
6905 .RSs | |
6906 .IPs fast:preset=standard | |
6907 suitable for most people and most music types and already quite high quality | |
6908 .IPs cbr:preset=192 | |
6909 Encode with ABR presets at a 192 kbps forced constant bitrate. | |
6910 .IPs preset=172 | |
6911 Encode with ABR presets at a 172 kbps average bitrate. | |
6912 .IPs preset=extreme | |
6913 for people with extremely good hearing and similar equipment | |
6914 .RE | |
6915 .PD 1 | |
6916 . | |
6917 . | |
6918 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively) | |
6919 . | |
6920 .TP | |
6921 .B br=<32\-384> | |
6922 In CBR mode this parameter indicates the bitrate in kbps, | |
6923 when in VBR mode it is the minimum bitrate allowed per frame. | |
6924 VBR mode will not work with a value below 112. | |
6925 . | |
6926 .TP | |
6927 .B vbr=<-50\-50> (VBR only) | |
6928 variability range; if negative the encoder shifts the average bitrate | |
6929 towards the lower limit, if positive towards the higher. | |
6930 When set to 0 CBR is used (default). | |
6931 . | |
6932 .TP | |
6933 .B maxvbr=<32\-384> (VBR only) | |
6934 maximum bitrate allowed per frame, in kbps | |
6935 . | |
6936 .TP | |
6937 .B mode=<stereo | jstereo | mono | dual> | |
6938 (default: mono for 1-channel audio, stereo otherwise) | |
6939 . | |
6940 .TP | |
6941 .B psy=<-1\-4> | |
6942 psychoacoustic model (default: 2) | |
6943 . | |
6944 .TP | |
6945 .B errprot=<0 | 1> | |
6946 Include error protection. | |
6947 . | |
6948 .TP | |
6949 .B debug=<0\-10> | |
6950 debug level | |
6951 .RE | |
6952 .PD 1 | |
6953 . | |
6954 . | |
6955 .SS faac (\-faacopts) | |
6956 . | |
6957 .TP | |
6958 .B br=<bitrate> | |
6959 average bitrate in kbps (mutually exclusive with quality) | |
6960 . | |
6961 .TP | |
6962 .B quality=<1\-1000> | |
6963 quality mode, the higher the better (mutually exclusive with br) | |
6964 . | |
6965 .TP | |
6966 .B object=<1\-4> | |
6967 object type complexity | |
6968 .PD 0 | |
6969 .RSs | |
6970 .IPs 1 | |
6971 MAIN (default) | |
6972 .IPs 2 | |
6973 LOW | |
6974 .IPs 3 | |
6975 SSR | |
6976 .IPs 4 | |
6977 LTP (extremely slow) | |
6978 .RE | |
6979 .PD 1 | |
6980 . | |
6981 .TP | |
6982 .B mpeg=<2|4> | |
6983 MPEG version (default: 4) | |
6984 . | |
6985 .TP | |
6986 .B "tns\ \ \ \ " | |
6987 Enables temporal noise shaping. | |
6988 . | |
6989 .TP | |
6990 .B cutoff=<0\-sampling_rate/2> | |
6991 cutoff frequency (default: sampling_rate/2) | |
6992 . | |
6993 .TP | |
6994 .B "raw\ \ \ \ " | |
6995 Stores the bitstream as raw payload with extradata in the container header | |
6996 (default: 0, corresponds to ADTS). | |
6997 Do not set this flag if not explicitly required or you will not be able to | |
6998 remux the audio stream later on. | |
6999 .RE | |
7000 .PD 1 | |
7001 . | |
7002 . | |
7003 .SS lavc (\-lavcopts) | |
7004 . | |
7005 Many libavcodec (lavc for short) options are tersely documented. | |
7006 Read the source for full details. | |
7007 .PP | |
7008 .I EXAMPLE: | |
7009 .PD 0 | |
7010 .RSs | |
7011 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 | |
7012 .RE | |
7013 .PD 1 | |
7014 . | |
7015 .TP | |
7016 .B acodec=<value> | |
7017 audio codec (default: mp2) | |
7018 .PD 0 | |
7019 .RSs | |
7020 .IPs "mp2\ \ " | |
7021 MPEG Layer 2 | |
7022 .IPs "mp3\ \ " | |
7023 MPEG Layer 3 | |
7024 .IPs "ac3\ \ " | |
7025 AC3 | |
7026 .IPs adpcm_ima_wav | |
7027 IMA Adaptive PCM (4bits per sample, 4:1 compression) | |
7028 .IPs "sonic\ " | |
7029 Experimental lossy/lossless codec | |
7030 .RE | |
7031 .PD 1 | |
7032 . | |
7033 .TP | |
7034 .B abitrate=<value> | |
7035 audio bitrate in kbps (default: 224) | |
7036 . | |
7037 .TP | |
7038 .B atag=<value> | |
7039 Use the specified Windows audio format tag (e.g.\& atag=0x55). | |
7040 . | |
7041 .TP | |
7042 .B bit_exact | |
7043 Use only bit exact algorithms (except (I)DCT). | |
7044 Additionally bit_exact disables several optimizations and thus | |
7045 should only be used for regression tests, which need binary | |
7046 identical files even if the encoder version changes. | |
7047 This also suppresses the user_data header in MPEG-4 streams. | |
7048 Do not use this option unless you know exactly what you are doing. | |
7049 . | |
7050 .TP | |
7051 .B threads=<1\-8> | |
7052 Maximum number of threads to use (default: 1). | |
7053 May have a slight negative effect on motion estimation. | |
7054 .RE | |
7055 . | |
7056 .TP | |
7057 .B vcodec=<value> | |
7058 Employ the specified codec (default: mpeg4). | |
7059 .PD 0 | |
7060 .RSs | |
7061 .IPs mjpeg | |
7062 Motion JPEG | |
7063 .IPs ljpeg | |
7064 Lossless JPEG | |
7065 .IPs "h261\ " | |
7066 H.261 | |
7067 .IPs "h263\ " | |
7068 H.263 | |
7069 .IPs h263p | |
7070 H.263+ | |
7071 .IPs mpeg4 | |
7072 MPEG-4 (DivX 4/5) | |
7073 .IPs msmpeg4 | |
7074 DivX 3 | |
7075 .IPs msmpeg4v2 | |
7076 MS MPEG4v2 | |
7077 .IPs "wmv1\ " | |
7078 Windows Media Video, version 1 (AKA WMV7) | |
7079 .IPs "wmv2\ " | |
7080 Windows Media Video, version 2 (AKA WMV8) | |
7081 .IPs "rv10\ " | |
7082 an old RealVideo codec | |
7083 .IPs mpeg1video | |
7084 MPEG-1 video | |
7085 .IPs mpeg2video | |
7086 MPEG-2 video | |
7087 .IPs huffyuv | |
7088 HuffYUV | |
7089 .IPs ffvhuff (also see: vstrict) | |
7090 nonstandard 20% smaller HuffYUV using YV12 | |
7091 .IPs "asv1\ " | |
7092 ASUS Video v1 | |
7093 .IPs "asv2\ " | |
7094 ASUS Video v2 | |
7095 .IPs "ffv1 (also see: vstrict)" | |
7096 FFmpeg's lossless video codec | |
7097 .IPs "flv\ \ " | |
7098 Sorenson H.263 used in Flash Video | |
7099 .IPs dvvideo | |
7100 Sony Digital Video | |
7101 .IPs "svq1\ " | |
7102 Apple Sorenson Video 1 | |
7103 .IPs "snow (also see: vstrict)" | |
7104 FFmpeg's experimental wavelet-based codec | |
7105 .RE | |
7106 .PD 1 | |
7107 . | |
7108 .TP | |
7109 .B vqmin=<1\-31> | |
7110 minimum quantizer (pass 1/2) | |
7111 .RSs | |
7112 .IPs 1 | |
7113 Not recommended (much larger file, little quality difference and weird side | |
7114 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused | |
7115 resulting in lower quality and some decoders will not be able to decode it). | |
7116 .IPs 2 | |
7117 Recommended for normal mpeg4/\:mpeg1video encoding (default). | |
7118 .IPs 3 | |
7119 Recommended for h263(p)/\:msmpeg4. | |
7120 The reason for preferring 3 over 2 is that 2 could lead to overflows. | |
7121 (This will be fixed for h263(p) by changing the quantizer per MB in | |
7122 the future, msmpeg4 cannot be fixed as it does not support that.) | |
7123 .RE | |
7124 . | |
7125 .TP | |
7126 .B lmin=<0.01\-255.0> | |
20768 | 7127 Minimum frame-level Lagrange multiplier for ratecontrol (default: 2.0). |
7128 Lavc will rarely use quantizers below the value of lmin. | |
7129 Lowering lmin will make lavc more likely to choose lower quantizers for | |
7130 some frames, but not lower than the value of vqmin. | |
7131 Likewise, raising lmin will make lavc less likely to choose low | |
7132 quantizers, even if vqmin would have allowed them. | |
7133 You probably want to set lmin approximately equal to vqmin. | |
7134 When adaptive quantization is in use, changing lmin/lmax may have less | |
7135 of an effect; see mblmin/mblmax. | |
20707 | 7136 .RE |
7137 . | |
7138 .TP | |
7139 .B lmax=<0.01\-255.0> | |
7140 maximum Lagrange multiplier for ratecontrol (default: 31.0) | |
7141 .RE | |
7142 . | |
7143 .TP | |
20768 | 7144 .B mblmin=<0.01\-255.0> |
7145 Minimum macroblock-level Lagrange multiplier for ratecontrol | |
7146 (default:2.0). | |
7147 This parameter affects adaptive quantization options like qprd, | |
7148 lumi_mask, etc.. | |
7149 .RE | |
7150 . | |
7151 .TP | |
7152 .B mblmax=<0.01\-255.0> | |
7153 Maximum macroblock-level Lagrange multiplier for ratecontrol | |
7154 (default: 31.0). | |
7155 .RE | |
7156 . | |
7157 .TP | |
20707 | 7158 .B vqscale=<0\-31> |
7159 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode). | |
7160 A lower value means better quality but larger files (default: 0). | |
7161 In case of snow codec, value 0 means lossless encoding. | |
7162 Since the other codecs do not support this, vqscale=0 will be ignored and | |
7163 variable quantizers are used, which is the default. | |
7164 1 is not recommended (see vqmin for details). | |
7165 . | |
7166 .TP | |
7167 .B vqmax=<1\-31> | |
7168 Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31). | |
7169 . | |
7170 .TP | |
7171 .B mbqmin=<1\-31> | |
7172 obsolete, use vqmin | |
7173 . | |
7174 .TP | |
7175 .B mbqmax=<1\-31> | |
7176 obsolete, use vqmax | |
7177 . | |
7178 .TP | |
7179 .B vqdiff=<1\-31> | |
7180 maximum quantizer difference between consecutive I- or P-frames | |
7181 (pass 1/2) (default: 3) | |
7182 . | |
7183 .TP | |
7184 .B vmax_b_frames=<0\-4> | |
7185 maximum number of B-frames between non-B-frames: | |
7186 .PD 0 | |
7187 .RSs | |
7188 .IPs 0 | |
7189 no B-frames (default) | |
7190 .IPs 0\-2 | |
7191 sane range for MPEG-4 | |
7192 .RE | |
7193 .PD 1 | |
7194 . | |
7195 .TP | |
7196 .B vme=<0\-5> | |
7197 motion estimation method. | |
7198 Available methods are: | |
7199 .PD 0 | |
7200 .RSs | |
7201 .IPs 0 | |
7202 none (very low quality) | |
7203 .IPs 1 | |
7204 full (slow, currently unmaintained and disabled) | |
7205 .IPs 2 | |
7206 log (low quality, currently unmaintained and disabled) | |
7207 .IPs 3 | |
7208 phods (low quality, currently unmaintained and disabled) | |
7209 .IPs 4 | |
7210 EPZS: size=1 diamond, size can be adjusted with the *dia options | |
7211 (default) | |
7212 .IPs 5 | |
7213 X1 (experimental, currently aliased to EPZS) | |
7214 .IPs 8 | |
7215 iter (iterative overlapped block, only used in snow) | |
7216 .RE | |
7217 .PD 1 | |
7218 .sp 1 | |
7219 .RS | |
7220 .br | |
7221 .I NOTE: | |
7222 0\-3 currently ignores the amount of bits spent, | |
7223 so quality may be low. | |
7224 .RE | |
7225 . | |
7226 .TP | |
7227 .B me_range=<0\-9999> | |
7228 motion estimation search range (default: 0 (unlimited)) | |
7229 . | |
7230 .TP | |
7231 .B mbd=<0\-2> | |
7232 Macroblock decision algorithm (high quality mode), encode each macro | |
7233 block in all modes and choose the best. | |
7234 This is slow but results in better quality and file size. | |
7235 .PD 0 | |
7236 .RSs | |
7237 .IPs 0 | |
7238 Use mbcmp (default). | |
7239 .IPs 1 | |
7240 Select the MB mode which needs the fewest bits (=vhq). | |
7241 .IPs 2 | |
7242 Select the MB mode which has the best rate distortion. | |
7243 .RE | |
7244 .PD 1 | |
7245 . | |
7246 .TP | |
7247 .B "vhq\ \ \ \ " | |
7248 Same as mbd=1, kept for compatibility reasons. | |
7249 . | |
7250 .TP | |
7251 .B "v4mv\ \ \ " | |
7252 Allow 4 motion vectors per macroblock (slightly better quality). | |
7253 Works better if used with mbd>0. | |
7254 . | |
7255 .TP | |
7256 .B "obmc\ \ \ " | |
7257 overlapped block motion compensation (H.263+) | |
7258 . | |
7259 .TP | |
7260 .B "loop\ \ \ " | |
7261 loop filter (H.263+) | |
7262 note, this is broken | |
7263 . | |
7264 .TP | |
7265 .B inter_threshold <-1000\-1000> | |
7266 Does absolutely nothing at the moment. | |
7267 . | |
7268 .TP | |
7269 .B keyint=<0\-300> | |
7270 maximum interval between keyframes in frames (default: 250 or one | |
7271 keyframe every ten seconds in a 25fps movie. | |
7272 This is the recommended default for MPEG-4). | |
7273 Most codecs require regular keyframes in order to limit the accumulation of mismatch error. | |
7274 Keyframes are also needed for seeking, as seeking is only possible to a keyframe - but | |
7275 keyframes need more space than other frames, so larger numbers here mean | |
7276 slightly smaller files but less precise seeking. | |
7277 0 is equivalent to 1, which makes every frame a keyframe. | |
7278 Values >300 are not recommended as the quality might be bad depending upon | |
7279 decoder, encoder and luck. | |
7280 It is a common for MPEG-1/2 to use values <=30. | |
7281 . | |
7282 .TP | |
7283 .B sc_threshold=<-1000000000\-1000000000> | |
7284 Threshold for scene change detection. | |
7285 A keyframe is inserted by libavcodec when it detects a scene change. | |
7286 You can specify the sensitivity of the detection with this option. | |
7287 -1000000000 means there is a scene change detected at every frame, | |
7288 1000000000 means no scene changes are detected (default: 0). | |
7289 . | |
7290 .TP | |
7291 .B sc_factor=<any positive integer> | |
7292 Causes frames with higher quantizers to be more likely to trigger a | |
7293 scene change detection and make libavcodec use an I-frame (default: 1). | |
7294 1\-16 is a sane range. | |
7295 Values between 2 and 6 may yield increasing PSNR (up to approximately | |
7296 0.04 dB) and better placement of I-frames in high-motion scenes. | |
7297 Higher values than 6 may give very slightly better PSNR (approximately | |
7298 0.01 dB more than sc_factor=6), but noticably worse visual quality. | |
7299 . | |
7300 .TP | |
7301 .B vb_strategy=<0\-2> (pass one only) | |
7302 strategy to choose between I/P/B-frames: | |
7303 .PD 0 | |
7304 .RSs | |
7305 .IPs 0 | |
7306 Always use the maximum number of B-frames (default). | |
7307 .IPs 1 | |
7308 Avoid B-frames in high motion scenes. | |
7309 See the b_sensitivity option to tune this strategy. | |
7310 .IPs 2 | |
7311 Places B-frames more or less optimally to yield maximum quality (slower). | |
7312 You may want to reduce the speed impact of this option by tuning the | |
7313 option brd_scale. | |
7314 .RE | |
7315 .PD 1 | |
7316 . | |
7317 .TP | |
7318 .B b_sensitivity=<any integer greater than 0> | |
7319 Adjusts how sensitively vb_strategy=1 detects motion and avoids using | |
7320 B-frames (default: 40). | |
7321 Lower sensitivities will result in more B-frames. | |
7322 Using more B-frames usually improves PSNR, but too many B-frames can | |
7323 hurt quality in high-motion scenes. | |
7324 Unless there is an extremely high amount of motion, b_sensitivity can | |
7325 safely be lowered below the default; 10 is a reasonable value in most | |
7326 cases. | |
7327 . | |
7328 .TP | |
7329 .B brd_scale=<0\-10> | |
7330 Downscales frames for dynamic B-frame decision (default: 0). | |
7331 Each time brd_scale is increased by one, the frame dimensions are | |
7332 divided by two, which improves speed by a factor of four. | |
7333 Both dimensions of the fully downscaled frame must be even numbers, so | |
7334 brd_scale=1 requires the original dimensions to be multiples of four, | |
7335 brd_scale=2 requires multiples of eight, etc. | |
7336 In other words, the dimensions of the original frame must both be | |
7337 divisible by 2^(brd_scale+1) with no remainder. | |
7338 . | |
7339 .TP | |
7340 .B bidir_refine=<0\-4> | |
7341 Refine the two motion vectors used in bidirectional macroblocks, | |
7342 rather than re-using vectors from the forward and backward searches. | |
7343 This option has no effect without B-frames. | |
7344 .PD 0 | |
7345 .RSs | |
7346 .IPs 0 | |
7347 Disabled (default). | |
7348 .IPs 1\-4 | |
7349 Use a wider search (larger values are slower). | |
7350 .RE | |
7351 .PD 1 | |
7352 . | |
7353 .TP | |
7354 .B vpass=<1\-3> | |
7355 Activates internal two (or more) pass mode, only specify if you wish to | |
7356 use two (or more) pass encoding. | |
7357 .PD 0 | |
7358 .RSs | |
7359 .IPs 1 | |
7360 first pass (also see turbo) | |
7361 .IPs 2 | |
7362 second pass | |
7363 .IPs 3 | |
7364 Nth pass (second and subsequent passes of N-pass encoding) | |
7365 .RE | |
7366 .RS | |
7367 Here is how it works, and how to use it: | |
7368 .br | |
7369 The first pass (vpass=1) writes the statistics file. | |
7370 You might want to deactivate some CPU-hungry options, like "turbo" | |
7371 mode does. | |
7372 .br | |
7373 In two pass mode, the second pass (vpass=2) reads the statistics file and | |
7374 bases ratecontrol decisions on it. | |
7375 .br | |
7376 In N-pass mode, the second pass (vpass=3, that is not a typo) | |
7377 does both: It first reads the statistics, then overwrites them. | |
7378 You might want to backup divx2pass.log before doing this if there is | |
7379 any possibility that you will have to cancel MEncoder. | |
7380 You can use all encoding options, except very CPU-hungry options like "qns". | |
7381 .br | |
7382 You can run this same pass over and over to refine the encode. | |
7383 Each subsequent pass will use the statistics from the previous pass to improve. | |
7384 The final pass can include any CPU-hungry encoding options. | |
7385 .br | |
7386 If you want a 2 pass encode, use first vpass=1, and then vpass=2. | |
7387 .br | |
7388 If you want a 3 or more pass encode, use vpass=1 for the first pass | |
7389 and then vpass=3 and then vpass=3 again and again until you are | |
7390 satisfied with the encode. | |
7391 .RE | |
7392 .PD 1 | |
7393 .sp 1 | |
7394 .RS | |
7395 huffyuv: | |
7396 .RE | |
7397 .PD 0 | |
7398 .RSs | |
7399 .IPs "pass 1" | |
7400 Saves statistics. | |
7401 .IPs "pass 2" | |
7402 Encodes with an optimal Huffman table based upon statistics | |
7403 from the first pass. | |
7404 .RE | |
7405 .PD 1 | |
7406 . | |
7407 .TP | |
7408 .B turbo (two pass only) | |
7409 Dramatically speeds up pass one using faster algorithms and disabling | |
7410 CPU-intensive options. | |
7411 This will probably reduce global PSNR a little bit (around 0.01dB) and | |
7412 change individual frame type and PSNR a little bit more (up to 0.03dB). | |
7413 . | |
7414 .TP | |
7415 .B aspect=<x/y> | |
7416 Store movie aspect internally, just like with MPEG files. | |
7417 Much nicer than rescaling, because quality is not decreased. | |
7418 Only MPlayer will play these files correctly, other players will display | |
7419 them with wrong aspect. | |
7420 The aspect parameter can be given as a ratio or a floating point number. | |
7421 .sp 1 | |
7422 .RS | |
7423 .I EXAMPLE: | |
7424 .RE | |
7425 .RSs | |
7426 .PD 0 | |
7427 .IPs "aspect=16/9 or aspect=1.78" | |
7428 .PD 1 | |
7429 .RE | |
7430 . | |
7431 .TP | |
7432 .B autoaspect | |
7433 Same as the aspect option, but automatically computes aspect, taking | |
7434 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
7435 filter chain. | |
7436 Does not incur a performance penalty, so you can safely leave it | |
7437 always on. | |
7438 . | |
7439 .TP | |
7440 .B vbitrate=<value> | |
7441 Specify bitrate (pass 1/2) (default: 800). | |
7442 .br | |
7443 .I WARNING: | |
7444 1kbit = 1000 bits | |
7445 .PD 0 | |
7446 .RSs | |
7447 .IPs 4\-16000 | |
7448 (in kbit) | |
7449 .IPs 16001\-24000000 | |
7450 (in bit) | |
7451 .RE | |
7452 .PD 1 | |
7453 . | |
7454 .TP | |
7455 .B vratetol=<value> | |
7456 approximated file size tolerance in kbit. | |
7457 1000\-100000 is a sane range. | |
7458 (warning: 1kbit = 1000 bits) | |
7459 (default: 8000) | |
7460 .br | |
7461 .I NOTE: | |
7462 vratetol should not be too large during the second pass or there might | |
7463 be problems if vrc_(min|max)rate is used. | |
7464 . | |
7465 .TP | |
7466 .B vrc_maxrate=<value> | |
7467 maximum bitrate in kbit/\:sec (pass 1/2) | |
7468 (default: 0, unlimited) | |
7469 . | |
7470 .TP | |
7471 .B vrc_minrate=<value> | |
7472 minimum bitrate in kbit/\:sec (pass 1/2) | |
7473 (default: 0, unlimited) | |
7474 . | |
7475 .TP | |
7476 .B vrc_buf_size=<value> | |
7477 buffer size in kbit (pass 1/2). | |
7478 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD, | |
7479 917 for SVCD and 1835 for DVD. | |
7480 . | |
7481 .TP | |
7482 .B vrc_buf_aggressivity | |
7483 currently useless | |
7484 . | |
7485 .TP | |
7486 .B vrc_strategy | |
7487 Ratecontrol method. | |
7488 Note that some of the ratecontrol-affecting options will have no effect | |
7489 if vrc_strategy is not set to 0. | |
7490 .PD 0 | |
7491 .RSs | |
7492 .IPs 0 | |
7493 Use internal lavc ratecontrol (default). | |
7494 .IPs 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
7495 Use Xvid ratecontrol (experimental; requires MEncoder to be compiled |
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
7496 with support for Xvid 1.1 or higher). |
20707 | 7497 .RE |
7498 .PD 1 | |
7499 . | |
7500 .TP | |
7501 .B vb_qfactor=<-31.0\-31.0> | |
7502 quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7503 . | |
7504 .TP | |
7505 .B vi_qfactor=<-31.0\-31.0> | |
7506 quantizer factor between I- and non-I-frames (pass 1/2) (default: 0.8) | |
7507 . | |
7508 .TP | |
7509 .B vb_qoffset=<-31.0\-31.0> | |
7510 quantizer offset between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7511 . | |
7512 .TP | |
7513 .B vi_qoffset=<-31.0\-31.0> | |
7514 (pass 1/2) (default: 0.0) | |
7515 .br | |
7516 if v{b|i}_qfactor > 0 | |
7517 .br | |
7518 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset | |
7519 .br | |
7520 else | |
7521 .br | |
7522 do normal ratecontrol (do not lock to next P-frame quantizer) and | |
7523 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset | |
7524 .br | |
7525 .I HINT: | |
7526 To do constant quantizer encoding with different quantizers for | |
7527 I/P- and B-frames you can use: | |
7528 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>. | |
7529 . | |
7530 .TP | |
7531 .B vqblur=<0.0\-1.0> (pass one) | |
7532 Quantizer blur (default: 0.5), larger values will average the | |
7533 quantizer more over time (slower change). | |
7534 .PD 0 | |
7535 .RSs | |
7536 .IPs 0.0 | |
7537 Quantizer blur disabled. | |
7538 .IPs 1.0 | |
7539 Average the quantizer over all previous frames. | |
7540 .RE | |
7541 .PD 1 | |
7542 . | |
7543 .TP | |
7544 .B vqblur=<0.0\-99.0> (pass two) | |
7545 Quantizer gaussian blur (default: 0.5), larger values will average | |
7546 the quantizer more over time (slower change). | |
7547 . | |
7548 .TP | |
7549 .B vqcomp=<0.0\-1.0> | |
7550 Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5). | |
7551 For instance, assuming the default rate control equation is used, | |
7552 if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits | |
7553 needed to encode them all at the same QP. | |
7554 If vqcomp=0.0, the ratecontrol allocates the same number of bits to each | |
7555 frame, i.e. strict CBR. | |
7556 .I NOTE: | |
7557 Those are extreme settings and should never be used. | |
7558 Perceptual quality will be optimal somewhere in between these two extremes. | |
7559 . | |
7560 .TP | |
7561 .B vrc_eq=<equation> | |
7562 main ratecontrol equation (pass 1/2) | |
7563 .RE | |
7564 .RSs | |
7565 .IPs "1\ \ \ \ " | |
7566 constant bitrate | |
7567 .IPs "tex\ \ " | |
7568 constant quality | |
7569 .IPs 1+(tex/\:avgTex-1)*qComp | |
7570 approximately the equation of the old ratecontrol code | |
7571 .IPs tex^qComp | |
7572 with qcomp 0.5 or something like that (default) | |
7573 .RE | |
7574 .PP | |
7575 .RS | |
7576 infix operators: | |
7577 .RE | |
7578 .RSs | |
7579 .IPs +,-,*,/,^ | |
7580 .RE | |
7581 .PP | |
7582 .RS | |
7583 variables: | |
7584 .RE | |
7585 .RSs | |
7586 .IPs "tex\ \ " | |
7587 texture complexity | |
7588 .IPs iTex,pTex | |
7589 intra, non-intra texture complexity | |
7590 .IPs avgTex | |
7591 average texture complexity | |
7592 .IPs avgIITex | |
7593 average intra texture complexity in I-frames | |
7594 .IPs avgPITex | |
7595 average intra texture complexity in P-frames | |
7596 .IPs avgPPTex | |
7597 average non-intra texture complexity in P-frames | |
7598 .IPs avgBPTex | |
7599 average non-intra texture complexity in B-frames | |
7600 .IPs "mv\ \ \ " | |
7601 bits used for motion vectors | |
7602 .IPs fCode | |
7603 maximum length of motion vector in log2 scale | |
7604 .IPs iCount | |
7605 number of intra macroblocks / number of macroblocks | |
7606 .IPs "var\ \ " | |
7607 spatial complexity | |
7608 .IPs mcVar | |
7609 temporal complexity | |
7610 .IPs qComp | |
7611 qcomp from the command line | |
7612 .IPs "isI, isP, isB" | |
7613 Is 1 if picture type is I/P/B else 0. | |
7614 .IPs "Pi,E\ " | |
7615 See your favorite math book. | |
7616 .RE | |
7617 .PP | |
7618 .RS | |
7619 functions: | |
7620 .RE | |
7621 .RSs | |
7622 .IPs max(a,b),min(a,b) | |
7623 maximum / minimum | |
7624 .IPs gt(a,b) | |
7625 is 1 if a>b, 0 otherwise | |
7626 .IPs lt(a,b) | |
7627 is 1 if a<b, 0 otherwise | |
7628 .IPs eq(a,b) | |
7629 is 1 if a==b, 0 otherwise | |
7630 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs" | |
7631 .RE | |
7632 . | |
7633 .TP | |
7634 .B vrc_override=<options> | |
7635 User specified quality for specific parts (ending, credits, ...) (pass 1/2). | |
7636 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>, | |
7637 <end-frame>, <quality>[/...]]: | |
7638 .PD 0 | |
7639 .RSs | |
7640 .IPs "quality (2\-31)" | |
7641 quantizer | |
7642 .IPs "quality (-500\-0)" | |
7643 quality correction in % | |
7644 .RE | |
7645 .PD 1 | |
7646 . | |
7647 .TP | |
7648 .B vrc_init_cplx=<0\-1000> | |
7649 initial complexity (pass 1) | |
7650 . | |
7651 .TP | |
7652 .B vrc_init_occupancy=<0.0\-1.0> | |
7653 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9) | |
7654 . | |
7655 .TP | |
7656 .B vqsquish=<0|1> | |
7657 Specify how to keep the quantizer between qmin and qmax (pass 1/2). | |
7658 .PD 0 | |
7659 .RSs | |
7660 .IPs 0 | |
7661 Use clipping. | |
7662 .IPs 1 | |
7663 Use a nice differentiable function (default). | |
7664 .RE | |
7665 .PD 1 | |
7666 . | |
7667 .TP | |
7668 .B vlelim=<-1000\-1000> | |
7669 Sets single coefficient elimination threshold for luminance. | |
7670 Negative values will also consider the DC coefficient (should be at least -4 | |
7671 or lower for encoding at quant=1): | |
7672 .PD 0 | |
7673 .RSs | |
7674 .IPs 0 | |
7675 disabled (default) | |
7676 .IPs -4 | |
7677 JVT recommendation | |
7678 .RE | |
7679 .PD 1 | |
7680 . | |
7681 .TP | |
7682 .B vcelim=<-1000\-1000> | |
7683 Sets single coefficient elimination threshold for chrominance. | |
7684 Negative values will also consider the DC coefficient (should be at least -4 | |
7685 or lower for encoding at quant=1): | |
7686 .PD 0 | |
7687 .RSs | |
7688 .IPs 0 | |
7689 disabled (default) | |
7690 .IPs 7 | |
7691 JVT recommendation | |
7692 .RE | |
7693 .PD 1 | |
7694 . | |
7695 .TP | |
7696 .B vstrict=<-2|-1|0|1> | |
7697 strict standard compliance | |
7698 .PD 0 | |
7699 .RSs | |
7700 .IPs 0 | |
7701 disabled | |
7702 .IPs 1 | |
7703 Only recommended if you want to feed the output into the | |
7704 MPEG-4 reference decoder. | |
7705 .IPs -1 | |
7706 Allow libavcodec specific extensions (default). | |
7707 .IPs -2 | |
7708 Enables experimental codecs and features which may not be playable | |
7709 with future MPlayer versions (snow, ffvhuff, ffv1). | |
7710 .RE | |
7711 .PD 1 | |
7712 . | |
7713 .TP | |
7714 .B "vdpart\ " | |
7715 Data partitioning. | |
7716 Adds 2 Bytes per video packet, improves error-resistance when transferring over | |
7717 unreliable channels (e.g.\& streaming over the internet). | |
7718 Each video packet will be encoded in 3 separate partitions: | |
7719 .PD 0 | |
7720 .RSs | |
7721 .IPs "1. MVs" | |
7722 movement | |
7723 .IPs "2. DC coefficients" | |
7724 low res picture | |
7725 .IPs "3. AC coefficients" | |
7726 details | |
7727 .RE | |
7728 .PD 1 | |
7729 .RS | |
7730 MV & DC are most important, loosing them looks far worse than loosing | |
7731 the AC and the 1. & 2. partition. | |
7732 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors | |
7733 will hit the AC partition much more often than the MV & DC partitions. | |
7734 Thus, the picture will look better with partitioning than without, | |
7735 as without partitioning an error will trash AC/\:DC/\:MV equally. | |
7736 .RE | |
7737 . | |
7738 .TP | |
7739 .B vpsize=<0\-10000> (also see vdpart) | |
7740 Video packet size, improves error-resistance. | |
7741 .PD 0 | |
7742 .RSs | |
7743 .IPs "0\ \ \ \ " | |
7744 disabled (default) | |
7745 .IPs 100\-1000 | |
7746 good choice | |
7747 .RE | |
7748 .PD 1 | |
7749 . | |
7750 .TP | |
7751 .B "ss\ \ \ \ \ " | |
7752 slice structured mode for H.263+ | |
7753 . | |
7754 .TP | |
7755 .B "gray\ \ \ " | |
7756 grayscale only encoding (faster) | |
7757 . | |
7758 .TP | |
7759 .B vfdct=<0\-10> | |
7760 DCT algorithm | |
7761 .PD 0 | |
7762 .RSs | |
7763 .IPs 0 | |
7764 Automatically select a good one (default). | |
7765 .IPs 1 | |
7766 fast integer | |
7767 .IPs 2 | |
7768 accurate integer | |
7769 .IPs 3 | |
7770 MMX | |
7771 .IPs 4 | |
7772 mlib | |
7773 .IPs 5 | |
7774 AltiVec | |
7775 .IPs 6 | |
7776 floating point AAN | |
7777 .RE | |
7778 .PD 1 | |
7779 . | |
7780 .TP | |
7781 .B idct=<0\-99> | |
7782 IDCT algorithm | |
7783 .br | |
7784 .I NOTE: | |
7785 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests. | |
7786 .PD 0 | |
7787 .RSs | |
7788 .IPs 0 | |
7789 Automatically select a good one (default). | |
7790 .IPs 1 | |
7791 JPEG reference integer | |
7792 .IPs 2 | |
7793 simple | |
7794 .IPs 3 | |
7795 simplemmx | |
7796 .IPs 4 | |
7797 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100) | |
7798 .IPs 5 | |
7799 ps2 | |
7800 .IPs 6 | |
7801 mlib | |
7802 .IPs 7 | |
7803 arm | |
7804 .IPs 8 | |
7805 AltiVec | |
7806 .IPs 9 | |
7807 sh4 | |
7808 .RE | |
7809 .PD 1 | |
7810 . | |
7811 .TP | |
7812 .B lumi_mask=<0.0\-1.0> | |
7813 Luminance masking is a 'psychosensory' setting that is supposed to | |
7814 make use of the fact that the human eye tends to notice fewer details | |
7815 in very bright parts of the picture. | |
7816 Luminance masking compresses bright areas stronger than medium ones, | |
7817 so it will save bits that can be spent again on other frames, raising | |
7818 overall subjective quality, while possibly reducing PSNR. | |
7819 .br | |
7820 .I WARNING: | |
7821 Be careful, overly large values can cause disastrous things. | |
7822 .br | |
7823 .I WARNING: | |
7824 Large values might look good on some monitors but may look horrible | |
7825 on other monitors. | |
7826 .PD 0 | |
7827 .RSs | |
7828 .IPs "0.0\ \ " | |
7829 disabled (default) | |
7830 .IPs 0.0\-0.3 | |
7831 sane range | |
7832 .RE | |
7833 .PD 1 | |
7834 . | |
7835 .TP | |
7836 .B dark_mask=<0.0\-1.0> | |
7837 Darkness masking is a 'psychosensory' setting that is supposed to | |
7838 make use of the fact that the human eye tends to notice fewer details | |
7839 in very dark parts of the picture. | |
7840 Darkness masking compresses dark areas stronger than medium ones, | |
7841 so it will save bits that can be spent again on other frames, raising | |
7842 overall subjective quality, while possibly reducing PSNR. | |
7843 .br | |
7844 .I WARNING: | |
7845 Be careful, overly large values can cause disastrous things. | |
7846 .br | |
7847 .I WARNING: | |
7848 Large values might look good on some monitors but may look horrible | |
7849 on other monitors / TV / TFT. | |
7850 .PD 0 | |
7851 .RSs | |
7852 .IPs "0.0\ \ " | |
7853 disabled (default) | |
7854 .IPs 0.0\-0.3 | |
7855 sane range | |
7856 .RE | |
7857 .PD 1 | |
7858 . | |
7859 .TP | |
7860 .B tcplx_mask=<0.0\-1.0> | |
7861 Temporal complexity masking (default: 0.0 (disabled)). | |
7862 Imagine a scene with a bird flying across the whole scene; tcplx_mask | |
7863 will raise the quantizers of the bird's macroblocks (thus decreasing their | |
7864 quality), as the human eye usually does not have time to see all the bird's | |
7865 details. | |
7866 Be warned that if the masked object stops (e.g.\& the bird lands) it is | |
7867 likely to look horrible for a short period of time, until the encoder | |
7868 figures out that the object is not moving and needs refined blocks. | |
7869 The saved bits will be spent on other parts of the video, which may increase | |
7870 subjective quality, provided that tcplx_mask is carefully chosen. | |
7871 . | |
7872 .TP | |
7873 .B scplx_mask=<0.0\-1.0> | |
7874 Spatial complexity masking. | |
7875 Larger values help against blockiness, if no deblocking filter is used for | |
7876 decoding, which is maybe not a good idea. | |
7877 .br | |
7878 Imagine a scene with grass (which usually has great spatial complexity), | |
7879 a blue sky and a house; scplx_mask will raise the quantizers of the grass' | |
7880 macroblocks, thus decreasing its quality, in order to spend more bits on | |
7881 the sky and the house. | |
7882 .br | |
7883 .I HINT: | |
7884 Crop any black borders completely as they will reduce the quality | |
7885 of the macroblocks (also applies without scplx_mask). | |
7886 .PD 0 | |
7887 .RSs | |
7888 .IPs "0.0\ \ " | |
7889 disabled (default) | |
7890 .IPs 0.0\-0.5 | |
7891 sane range | |
7892 .RE | |
7893 .PD 1 | |
7894 .sp 1 | |
7895 .RS | |
7896 .I NOTE: | |
7897 This setting does not have the same effect as using a custom matrix that | |
7898 would compress high frequencies harder, as scplx_mask will reduce the | |
7899 quality of P blocks even if only DC is changing. | |
7900 The result of scplx_mask will probably not look as good. | |
7901 .RE | |
7902 . | |
7903 .TP | |
7904 .B p_mask=<0.0\-1.0> (also see vi_qfactor) | |
7905 Reduces the quality of inter blocks. | |
7906 This is equivalent to increasing the quality of intra blocks, because the | |
7907 same average bitrate will be distributed by the rate controller to the | |
7908 whole video sequence (default: 0.0 (disabled)). | |
7909 p_mask=1.0 doubles the bits allocated to each intra block. | |
7910 . | |
7911 .TP | |
7912 .B border_mask=<0.0\-1.0> | |
7913 border-processing for MPEG-style encoders. | |
7914 Border processing increases the quantizer for macroblocks which are less | |
7915 than 1/5th of the frame width/height away from the frame border, | |
7916 since they are often visually less important. | |
7917 . | |
7918 .TP | |
7919 .B "naq\ \ \ \ " | |
7920 Normalize adaptive quantization (experimental). | |
7921 When using adaptive quantization (*_mask), the average per-MB quantizer may no | |
7922 longer match the requested frame-level quantizer. | |
7923 Naq will attempt to adjust the per-MB quantizers to maintain the proper | |
7924 average. | |
7925 . | |
7926 .TP | |
7927 .B "ildct\ \ " | |
7928 Use interlaced DCT. | |
7929 . | |
7930 .TP | |
7931 .B "ilme\ \ \ " | |
7932 Use interlaced motion estimation (mutually exclusive with qpel). | |
7933 . | |
7934 .TP | |
7935 .B "alt\ \ \ \ " | |
7936 Use alternative scantable. | |
7937 . | |
7938 .TP | |
7939 .B "top=<-1\-1>\ \ \ " | |
7940 .PD 0 | |
7941 .RSs | |
7942 .IPs -1 | |
7943 automatic | |
7944 .IPs 0 | |
7945 bottom field first | |
7946 .IPs 1 | |
7947 top field first | |
7948 .RE | |
7949 .PD 1 | |
7950 . | |
7951 .TP | |
7952 .B format=<value> | |
7953 .PD 0 | |
7954 .RSs | |
7955 .IPs "YV12\ " | |
7956 default | |
7957 .IPs "444P\ " | |
7958 for ffv1 | |
7959 .IPs "422P\ " | |
7960 for HuffYUV, lossless JPEG and ffv1 | |
7961 .IPs 411P,YVU9 | |
7962 for lossless JPEG and ffv1 | |
7963 .IPs BGR32 | |
7964 for lossless JPEG and ffv1 | |
7965 .RE | |
7966 .PD 1 | |
7967 . | |
7968 .TP | |
7969 .B "pred\ \ \ " | |
7970 (for HuffYUV) | |
7971 .PD 0 | |
7972 .RSs | |
7973 .IPs 0 | |
7974 left prediction | |
7975 .IPs 1 | |
7976 plane/\:gradient prediction | |
7977 .IPs 2 | |
7978 median prediction | |
7979 .RE | |
7980 .PD 1 | |
7981 . | |
7982 .TP | |
7983 .B "pred\ \ \ " | |
7984 (for lossless JPEG) | |
7985 .PD 0 | |
7986 .RSs | |
7987 .IPs 0 | |
7988 left prediction | |
7989 .IPs 1 | |
7990 top prediction | |
7991 .IPs 2 | |
7992 topleft prediction | |
7993 .IPs 3 | |
7994 plane/\:gradient prediction | |
7995 .IPs 6 | |
7996 mean prediction | |
7997 .RE | |
7998 .PD 1 | |
7999 . | |
8000 .TP | |
8001 .B "coder\ \ " | |
8002 (for ffv1) | |
8003 .PD 0 | |
8004 .RSs | |
8005 .IPs 0 | |
8006 vlc coding (Golomb-Rice) | |
8007 .IPs 1 | |
8008 arithmetic coding (CABAC) | |
8009 .RE | |
8010 .PD 1 | |
8011 . | |
8012 .TP | |
8013 .B context | |
8014 (for ffv1) | |
8015 .PD 0 | |
8016 .RSs | |
8017 .IPs 0 | |
8018 small context model | |
8019 .IPs 1 | |
8020 large context model | |
8021 .RE | |
8022 .PD 1 | |
8023 .sp 1 | |
8024 .RS | |
8025 (for ffvhuff) | |
8026 .RE | |
8027 .PD 0 | |
8028 .RSs | |
8029 .IPs 0 | |
8030 predetermined Huffman tables (builtin or two pass) | |
8031 .IPs 1 | |
8032 adaptive Huffman tables | |
8033 .RE | |
8034 .PD 1 | |
8035 . | |
8036 .TP | |
8037 .B "qpel\ \ \ " | |
8038 Use quarter pel motion compensation (mutually exclusive with ilme). | |
8039 .br | |
8040 .I HINT: | |
8041 This seems only useful for high bitrate encodings. | |
8042 . | |
8043 .TP | |
8044 .B mbcmp=<0\-2000> | |
8045 Sets the comparison function for the macroblock decision, only used if mbd=0. | |
8046 .PD 0 | |
8047 .RSs | |
8048 .IPs "0 (SAD)" | |
8049 sum of absolute differences, fast (default) | |
8050 .IPs "1 (SSE)" | |
8051 sum of squared errors | |
8052 .IPs "2 (SATD)" | |
8053 sum of absolute Hadamard transformed differences | |
8054 .IPs "3 (DCT)" | |
8055 sum of absolute DCT transformed differences | |
8056 .IPs "4 (PSNR)" | |
8057 sum of squared quantization errors (avoid, low quality) | |
8058 .IPs "5 (BIT)" | |
8059 number of bits needed for the block | |
8060 .IPs "6 (RD)" | |
8061 rate distortion optimal, slow | |
8062 .IPs "7 (ZERO)" | |
8063 0 | |
8064 .IPs "8 (VSAD)" | |
8065 sum of absolute vertical differences | |
8066 .IPs "9 (VSSE)" | |
8067 sum of squared vertical differences | |
8068 .IPs "10 (NSSE)" | |
8069 noise preserving sum of squared differences | |
8070 .IPs "11 (W53)" | |
8071 5/3 wavelet, only used in snow | |
8072 .IPs "12 (W97)" | |
8073 9/7 wavelet, only used in snow | |
8074 .IPs "+256\ " | |
8075 Also use chroma, currently does not work (correctly) with B-frames. | |
8076 .RE | |
8077 .PD 1 | |
8078 . | |
8079 .TP | |
8080 .B ildctcmp=<0\-2000> | |
8081 Sets the comparison function for interlaced DCT decision | |
8082 (see mbcmp for available comparison functions). | |
8083 . | |
8084 .TP | |
8085 .B precmp=<0\-2000> | |
8086 Sets the comparison function for motion estimation pre pass | |
8087 (see mbcmp for available comparison functions) (default: 0). | |
8088 . | |
8089 .TP | |
8090 .B cmp=<0\-2000> | |
8091 Sets the comparison function for full pel motion estimation | |
8092 (see mbcmp for available comparison functions) (default: 0). | |
8093 . | |
8094 .TP | |
8095 .B subcmp=<0\-2000> | |
8096 Sets the comparison function for sub pel motion estimation | |
8097 (see mbcmp for available comparison functions) (default: 0). | |
8098 . | |
8099 .TP | |
8100 .B nssew=<0\-1000000> | |
8101 This setting controls NSSE weight, where larger weights will result in | |
8102 more noise. | |
8103 0 NSSE is identical to SSE | |
8104 You may find this useful if you prefer to keep some noise in your encoded | |
8105 video rather than filtering it away before encoding (default: 8). | |
8106 . | |
8107 .TP | |
8108 .B predia=<-99\-6> | |
8109 diamond type and size for motion estimation pre-pass | |
8110 . | |
8111 .TP | |
8112 .B dia=<-99\-6> | |
8113 Diamond type & size for motion estimation. | |
8114 Motion search is an iterative process. | |
8115 Using a small diamond does not limit the search to finding only small | |
8116 motion vectors. | |
8117 It is just somewhat more likely to stop before finding the very best motion | |
8118 vector, especially when noise is involved. | |
8119 Bigger diamonds allow a wider search for the best motion vector, thus are | |
8120 slower but result in better quality. | |
8121 .br | |
8122 Big normal diamonds are better quality than shape-adaptive diamonds. | |
8123 .br | |
8124 Shape-adaptive diamonds are a good tradeoff between speed and quality. | |
8125 .br | |
8126 .I NOTE: | |
8127 The sizes of the normal diamonds and shape adaptive ones do not have | |
8128 the same meaning. | |
8129 .RSs | |
8130 .IPs -3 | |
8131 shape adaptive (fast) diamond with size 3 | |
8132 .IPs -2 | |
8133 shape adaptive (fast) diamond with size 2 | |
8134 .IPs -1 | |
8135 slightly special: Can be slower and/or better than dia=-2. | |
8136 .IPs 1 | |
8137 normal size=1 diamond (default) =EPZS type diamond | |
8138 .nf | |
8139 .ne | |
8140 0 | |
8141 000 | |
8142 0 | |
8143 .fi | |
8144 .IPs 2 | |
8145 normal size=2 diamond | |
8146 .nf | |
8147 .ne | |
8148 0 | |
8149 000 | |
8150 00000 | |
8151 000 | |
8152 0 | |
8153 .fi | |
8154 .RE | |
8155 . | |
8156 .TP | |
8157 .B "trell\ \ " | |
8158 Trellis searched quantization. | |
8159 This will find the optimal encoding for each 8x8 block. | |
8160 Trellis searched quantization is quite simply an optimal quantization in | |
8161 the PSNR versus bitrate sense (Assuming that there would be no rounding | |
8162 errors introduced by the IDCT, which is obviously not the case.). | |
8163 It simply finds a block for the minimum of error and lambda*bits. | |
8164 .PD 0 | |
8165 .RSs | |
8166 .IPs lambda | |
8167 quantization parameter (QP) dependent constant | |
8168 .IPs "bits\ " | |
8169 amount of bits needed to encode the block | |
8170 .IPs error | |
8171 sum of squared errors of the quantization | |
8172 .RE | |
8173 .PD 1 | |
8174 . | |
8175 .TP | |
8176 .B "cbp\ \ \ \ " | |
8177 Rate distorted optimal coded block pattern. | |
8178 Will select the coded block pattern which minimizes distortion + lambda*rate. | |
8179 This can only be used together with trellis quantization. | |
8180 . | |
8181 .TP | |
8182 .B "mv0\ \ \ \ " | |
8183 Try to encode each MB with MV=<0,0> and choose the better one. | |
8184 This has no effect if mbd=0. | |
8185 . | |
8186 .TP | |
8187 .B mv0_threshold=<any non-negative integer> | |
8188 When surrounding motion vectors are <0,0> and the motion estimation | |
8189 score of the current block is less than mv0_threshold, <0,0> is used for | |
8190 the motion vector and further motion estimation is skipped (default: | |
8191 256). | |
8192 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and | |
8193 possibly make the encoded video look slightly better; raising | |
8194 mv0_threshold past 320 results in diminished PSNR and visual quality. | |
8195 Higher values speed up encoding very slightly (usually less than 1%, | |
8196 depending on the other options used). | |
8197 .br | |
8198 .I NOTE: | |
8199 This option does not require mv0 to be enabled. | |
8200 . | |
8201 .TP | |
8202 .B qprd (mbd=2 only) | |
8203 rate distorted optimal quantization parameter (QP) for the given | |
8204 lambda of each macroblock | |
8205 . | |
8206 .TP | |
8207 .B last_pred=<0\-99> | |
8208 amount of motion predictors from the previous frame | |
8209 .PD 0 | |
8210 .RSs | |
8211 .IPs 0 | |
8212 (default) | |
8213 .IPs a | |
8214 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the | |
8215 previous frame. | |
8216 .RE | |
8217 .PD 1 | |
8218 . | |
8219 .TP | |
8220 .B preme=<0\-2> | |
8221 motion estimation pre-pass | |
8222 .PD 0 | |
8223 .RSs | |
8224 .IPs 0 | |
8225 disabled | |
8226 .IPs 1 | |
8227 only after I-frames (default) | |
8228 .IPs 2 | |
8229 always | |
8230 .RE | |
8231 .PD 1 | |
8232 . | |
8233 .TP | |
8234 .B subq=<1\-8> | |
8235 subpel refinement quality (for qpel) (default: 8 (high quality)) | |
8236 .br | |
8237 .I NOTE: | |
8238 This has a significant effect on speed. | |
8239 . | |
8240 .TP | |
8241 .B refs=<1\-8> | |
8242 number of reference frames to consider for motion compensation | |
8243 (Snow only) (default: 1) | |
8244 . | |
8245 .TP | |
8246 .B "psnr\ \ \ " | |
8247 print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8248 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'. | |
8249 Returned values are in dB (decibel), the higher the better. | |
8250 . | |
8251 .TP | |
8252 .B mpeg_quant | |
8253 Use MPEG quantizers instead of H.263. | |
8254 . | |
8255 .TP | |
8256 .B "aic\ \ \ \ " | |
8257 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+. | |
8258 This will improve quality very slightly (around 0.02 dB PSNR) and slow | |
8259 down encoding very slightly (about 1%). | |
8260 .br | |
8261 .I NOTE: | |
8262 vqmin should be 8 or larger for H.263+ AIC. | |
8263 . | |
8264 .TP | |
8265 .B "aiv\ \ \ \ " | |
8266 alternative inter vlc for H.263+ | |
8267 . | |
8268 .TP | |
8269 .B "umv\ \ \ \ " | |
8270 unlimited MVs (H.263+ only) | |
8271 Allows encoding of arbitrarily long MVs. | |
8272 . | |
8273 .TP | |
8274 .B ibias=<-256\-256> | |
8275 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96, | |
8276 H.263 style quantizer default: 0) | |
8277 .br | |
8278 .I NOTE: | |
8279 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8280 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8281 . | |
8282 .TP | |
8283 .B pbias=<-256\-256> | |
8284 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0, | |
8285 H.263 style quantizer default: -64) | |
8286 .br | |
8287 .I NOTE: | |
8288 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8289 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8290 .br | |
8291 .I HINT: | |
8292 A more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR. | |
8293 . | |
8294 .TP | |
8295 .B nr=<0\-100000> | |
8296 Noise reduction, 0 means disabled. | |
8297 0\-600 is a useful range for typical content, but you may want to turn it | |
8298 up a bit more for very noisy content (default: 0). | |
8299 Given its small impact on speed, you might want to prefer to use this over | |
8300 filtering noise away with video filters like denoise3d or hqdn3d. | |
8301 . | |
8302 .TP | |
8303 .B qns=<0\-3> | |
8304 Quantizer noise shaping. | |
8305 Rather than choosing quantization to most closely match the source video | |
8306 in the PSNR sense, it chooses quantization such that noise (usually ringing) | |
8307 will be masked by similar-frequency content in the image. | |
8308 Larger values are slower but may not result in better quality. | |
8309 This can and should be used together with trellis quantization, in which case | |
8310 the trellis quantization (optimal for constant weight) will be used as | |
8311 startpoint for the iterative search. | |
8312 .PD 0 | |
8313 .RSs | |
8314 .IPs 0 | |
8315 disabled (default) | |
8316 .IPs 1 | |
8317 Only lower the absolute value of coefficients. | |
8318 .IPs 2 | |
8319 Only change coefficients before the last non-zero coefficient + 1. | |
8320 .IPs 3 | |
8321 Try all. | |
8322 .RE | |
8323 .PD 1 | |
8324 . | |
8325 .TP | |
8326 .B inter_matrix=<comma separated matrix> | |
8327 Use custom inter matrix. | |
8328 It needs a comma separated string of 64 integers. | |
8329 . | |
8330 .TP | |
8331 .B intra_matrix=<comma separated matrix> | |
8332 Use custom intra matrix. | |
8333 It needs a comma separated string of 64 integers. | |
8334 . | |
8335 .TP | |
8336 .B vqmod_amp | |
8337 experimental quantizer modulation | |
8338 . | |
8339 .TP | |
8340 .B vqmod_freq | |
8341 experimental quantizer modulation | |
8342 . | |
8343 .TP | |
8344 .B "dc\ \ \ \ \ " | |
8345 intra DC precision in bits (default: 8). | |
8346 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11. | |
8347 . | |
8348 .TP | |
8349 .B cgop (also see sc_threshold) | |
8350 Close all GOPs. | |
8351 Currently it only works if scene change detection is disabled | |
8352 (sc_threshold=1000000000). | |
8353 . | |
8354 .TP | |
8355 .B vglobal=<0\-3> | |
8356 Control writing global video headers. | |
8357 .PD 0 | |
8358 .RSs | |
8359 .IPs 0 | |
8360 Codec decides where to write global headers (default). | |
8361 .IPs 1 | |
8362 Write global headers only in extradata (needed for .mp4/MOV/NUT). | |
8363 .IPs 2 | |
8364 Write global headers only in front of keyframes. | |
8365 .IPs 3 | |
8366 Combine 1 and 2. | |
8367 .RE | |
8368 .PD 1 | |
8369 . | |
8370 .TP | |
8371 .B aglobal=<0\-3> | |
8372 Same as vglobal for audio headers. | |
8373 . | |
8374 . | |
8375 .SS nuv (\-nuvopts) | |
8376 . | |
8377 Nuppel video is based on RTJPEG and LZO. | |
8378 By default frames are first encoded with RTJPEG and then compressed with LZO, | |
8379 but it is possible to disable either or both of the two passes. | |
8380 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG, | |
8381 or the default LZO compressed RTJPEG. | |
8382 .br | |
8383 .I NOTE: | |
8384 The nuvrec documentation contains some advice and examples about the | |
8385 settings to use for the most common TV encodings. | |
8386 . | |
8387 .TP | |
8388 .B c=<0\-20> | |
8389 chrominance threshold (default: 1) | |
8390 . | |
8391 .TP | |
8392 .B l=<0\-20> | |
8393 luminance threshold (default: 1) | |
8394 . | |
8395 .TP | |
8396 .B "lzo\ \ \ \ " | |
8397 Enable LZO compression (default). | |
8398 . | |
8399 .TP | |
8400 .B "nolzo\ \ " | |
8401 Disable LZO compression. | |
8402 . | |
8403 .TP | |
8404 .B q=<3\-255> | |
8405 quality level (default: 255) | |
8406 . | |
8407 .TP | |
8408 .B "raw \ \ \ " | |
8409 Disable RTJPEG encoding. | |
8410 . | |
8411 .TP | |
8412 .B "rtjpeg\ " | |
8413 Enable RTJPEG encoding (default). | |
8414 . | |
8415 . | |
8416 .SS xvidenc (\-xvidencopts) | |
8417 . | |
8418 There are three modes available: constant bitrate (CBR), fixed quantizer and | |
8419 two pass. | |
8420 . | |
8421 .TP | |
8422 .B pass=<1|2> | |
8423 Specify the pass in two pass mode. | |
8424 . | |
8425 .TP | |
8426 .B turbo (two pass only) | |
8427 Dramatically speeds up pass one using faster algorithms and disabling | |
8428 CPU-intensive options. | |
8429 This will probably reduce global PSNR a little bit and change individual | |
8430 frame type and PSNR a little bit more. | |
8431 . | |
8432 .TP | |
8433 .B bitrate=<value> (CBR or two pass mode) | |
8434 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second | |
8435 if >16000. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8436 If <value> is negative, Xvid will use its absolute value as the target size |
20707 | 8437 (in kBytes) of the video and compute the associated bitrate automagically |
8438 (default: 687 kbits/s). | |
8439 . | |
8440 .TP | |
8441 .B fixed_quant=<1\-31> | |
8442 Switch to fixed quantizer mode and specify the quantizer to be used. | |
8443 . | |
8444 .TP | |
8445 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode) | |
8446 User specified quality for specific parts (ending, credits, ...). | |
8447 Each zone is <start-frame>,<mode>,<value> where <mode> may be | |
8448 .PD 0 | |
8449 .RSs | |
8450 .IPs "q" | |
8451 Constant quantizer override, where value=<2.0\-31.0> | |
8452 represents the quantizer value. | |
8453 .IPs "w" | |
8454 Ratecontrol weight override, where value=<0.01\-2.00> | |
8455 represents the quality correction in %. | |
8456 .RE | |
8457 .PD 1 | |
8458 .sp 1 | |
8459 .RS | |
8460 .I EXAMPLE: | |
8461 .RE | |
8462 .PD 0 | |
8463 .RSs | |
8464 .IPs zones=90000,q,20 | |
8465 Encodes all frames starting with frame 90000 at constant quantizer 20. | |
8466 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20 | |
8467 Encode frames 0\-10000 at 10% bitrate, encode frames 90000 | |
8468 up to the end at constant quantizer 20. | |
8469 Note that the second zone is needed to delimit the first zone, as | |
8470 without it everything up until frame 89999 would be encoded at 10% | |
8471 bitrate. | |
8472 .RE | |
8473 .PD 1 | |
8474 . | |
8475 .TP | |
8476 .B me_quality=<0\-6> | |
8477 This option controls the motion estimation subsystem. | |
8478 The higher the value, the more precise the estimation should be (default: 6). | |
8479 The more precise the motion estimation is, the more bits can be saved. | |
8480 Precision is gained at the expense of CPU time so decrease this setting if | |
8481 you need realtime encoding. | |
8482 . | |
8483 .TP | |
8484 .B (no)interlacing | |
8485 Encode the fields of interlaced video material. | |
8486 Turn this option on for interlaced content. | |
8487 .br | |
8488 .I NOTE: | |
8489 Should you rescale the video, you would need an interlace-aware resizer, | |
8490 which you can activate with \-vf scale=<width>:<height>:1. | |
8491 . | |
8492 .TP | |
8493 .B "4mv\ \ \ \ " | |
8494 Use 4 motion vectors per macroblock. | |
8495 This might give better compression, but slows down encoding. | |
8496 .br | |
8497 .I WARNING: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8498 As of Xvid-1.0.x, this option is no longer available separately, and its |
20707 | 8499 functionality is included in the me_quality option. |
8500 When me_quality > 4, 4mv is activated. | |
8501 . | |
8502 .TP | |
8503 .B rc_reaction_delay_factor=<value> | |
8504 This parameter controls the number of frames the CBR rate controller | |
8505 will wait before reacting to bitrate changes and compensating for them | |
8506 to obtain a constant bitrate over an averaging range of frames. | |
8507 . | |
8508 .TP | |
8509 .B rc_averaging_period=<value> | |
8510 Real CBR is hard to achieve. | |
8511 Depending on the video material, bitrate can be variable, and hard to predict. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8512 Therefore Xvid uses an averaging period for which it guarantees a given |
20707 | 8513 amount of bits (minus a small variation). |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8514 This settings expresses the "number of frames" for which Xvid averages |
20707 | 8515 bitrate and tries to achieve CBR. |
8516 . | |
8517 .TP | |
8518 .B rc_buffer=<value> | |
8519 size of the rate control buffer | |
8520 . | |
8521 .TP | |
8522 .B quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>] | |
8523 CBR mode: min & max quantizer for all frames (default: 2\-31) | |
8524 .br | |
8525 two pass mode: min & max quantizer for I/P-frames (default: 2\-31/\:2\-31) | |
8526 .br | |
8527 .I WARNING: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8528 As of Xvid-1.0.x, this option is replaced by the |
20707 | 8529 [min|max]_[i|p|b]quant options. |
8530 . | |
8531 .TP | |
8532 .B min_key_interval=<value> (two pass only) | |
8533 minimum interval between keyframes (default: 0) | |
8534 . | |
8535 .TP | |
8536 .B max_key_interval=<value> | |
8537 maximum interval between keyframes (default: 10*fps) | |
8538 . | |
8539 .TP | |
8540 .B mpeg_quant | |
8541 Use MPEG quantizers instead of H.263. | |
8542 For high bitrates, you will find that MPEG quantization preserves more detail. | |
8543 For low bitrates, the smoothing of H.263 will give you less block noise. | |
8544 When using custom matrices, MPEG must be used. | |
8545 .br | |
8546 .I WARNING: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8547 As of Xvid-1.0.x, this option is replaced by the quant_type option. |
20707 | 8548 . |
8549 .TP | |
8550 .B mod_quant | |
8551 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis | |
8552 (two pass mode only). | |
8553 .br | |
8554 .I WARNING: | |
8555 This will generate an illegal bitstream, and most likely not be decodable | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8556 by any MPEG-4 decoder besides libavcodec or Xvid. |
20707 | 8557 .br |
8558 .I WARNING: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8559 As of Xvid-1.0.x, this option is no longer available. |
20707 | 8560 . |
8561 .TP | |
8562 .B keyframe_boost=<0\-1000> (two pass mode only) | |
8563 Shift some bits from the pool for other frame types to intra frames, | |
8564 thus improving keyframe quality. | |
8565 This amount is an extra percentage, so a value of 10 will give | |
8566 your keyframes 10% more bits than normal | |
8567 (default: 0). | |
8568 . | |
8569 .TP | |
8570 .B kfthreshold=<value> (two pass mode only) | |
8571 Works together with kfreduction. | |
8572 Determines the minimum distance below which you consider that | |
8573 two frames are considered consecutive and treated differently | |
8574 according to kfreduction | |
8575 (default: 10). | |
8576 . | |
8577 .TP | |
8578 .B kfreduction=<0\-100> (two pass mode only) | |
8579 The above two settings can be used to adjust the size of keyframes that | |
8580 you consider too close to the first (in a row). | |
8581 kfthreshold sets the range in which keyframes are reduced, and | |
8582 kfreduction determines the bitrate reduction they get. | |
8583 The last I-frame will get treated normally | |
8584 (default: 30). | |
8585 . | |
8586 .TP | |
8587 .B divx5bvop | |
8588 Generate DivX5 compatible B-frames (default: on). | |
8589 This seems to be mandatory only for old versions of DivX's decoder. | |
8590 .br | |
8591 .I WARNING: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8592 As of Xvid-1.0.x, this option is replaced by the closed_gop option. |
20707 | 8593 . |
8594 .TP | |
8595 .B (no)grayscale | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8596 Make Xvid discard chroma planes so the encoded video is grayscale only. |
20707 | 8597 Note that this does not speed up encoding, it just prevents chroma data |
8598 from being written in the last stage of encoding. | |
8599 . | |
8600 .TP | |
8601 .B "debug\ \ " | |
8602 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control | |
8603 file.) | |
8604 .RE | |
8605 . | |
8606 .PP | |
8607 .sp 1 | |
8608 The following options are only available with the latest stable | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8609 releases of Xvid 1.0.x (api4). |
20707 | 8610 . |
8611 .TP | |
8612 .B (no)packed | |
8613 This option is meant to solve frame-order issues when encoding to | |
8614 container formats like AVI that cannot cope with out-of-order frames. | |
8615 In practice, most decoders (both software and hardware) are able to deal | |
8616 with frame-order themselves, and may get confused when this option is | |
8617 turned on, so you can safely leave if off, unless you really know what | |
8618 you are doing. | |
8619 .br | |
8620 .I WARNING: | |
8621 This will generate an illegal bitstream, and will not be | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8622 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:Xvid. |
20707 | 8623 .br |
8624 .I WARNING: | |
8625 This will also store a fake DivX version in the file so the bug | |
8626 autodetection of some decoders might be confused. | |
8627 . | |
8628 .TP | |
8629 .B max_bframes=<0\-4> | |
8630 Maximum number of B-frames to put between I/P-frames (default: 2). | |
8631 . | |
8632 .TP | |
8633 .B bquant_ratio=<0\-1000> | |
8634 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150) | |
8635 . | |
8636 .TP | |
8637 .B bquant_offset=<-1000\-1000> | |
8638 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100) | |
8639 . | |
8640 .TP | |
8641 .B bf_threshold=<-255\-255> | |
8642 This setting allows you to specify what priority to place on the use of | |
8643 B-frames. | |
8644 The higher the value, the higher the probability of B-frames being used | |
8645 (default: 0). | |
8646 Do not forget that B-frames usually have a higher quantizer, and therefore | |
8647 aggressive production of B-frames may cause worse visual quality. | |
8648 . | |
8649 .TP | |
8650 .B (no)closed_gop | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8651 This option tells Xvid to close every GOP (Group Of Pictures bounded |
20707 | 8652 by two I-frames), which makes GOPs independent from each other. |
8653 This just implies that the last frame of the GOP is either a P-frame or a | |
8654 N-frame but not a B-frame. | |
8655 It is usually a good idea to turn this option on (default: on). | |
8656 . | |
8657 .TP | |
8658 .B frame_drop_ratio=<0\-100> (max_bframes=0 only) | |
8659 This setting allows the creation of variable framerate video streams. | |
8660 The value of the setting specifies a threshold under which, if the | |
8661 difference of the following frame to the previous frame is below or equal | |
8662 to this threshold, a frame gets not coded (a so called n-vop is placed | |
8663 in the stream). | |
8664 On playback, when reaching an n-vop the previous frame will be displayed. | |
8665 .br | |
8666 .I WARNING: | |
8667 Playing with this setting may result in a jerky video, so use it at your | |
8668 own risks! | |
8669 . | |
8670 .TP | |
8671 .B (no)qpel | |
8672 MPEG-4 uses a half pixel precision for its motion search by default. | |
8673 The standard proposes a mode where encoders are allowed to use quarter | |
8674 pixel precision. | |
8675 This option usually results in a sharper image. | |
8676 Unfortunately it has a great impact on bitrate and sometimes the | |
8677 higher bitrate use will prevent it from giving a better image | |
8678 quality at a fixed bitrate. | |
8679 It is better to test with and without this option and see whether it | |
8680 is worth activating. | |
8681 . | |
8682 .TP | |
8683 .B (no)gmc | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8684 Enable Global Motion Compensation, which makes Xvid generate special |
20707 | 8685 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images. |
8686 Whether or not the use of this option will save bits is highly | |
8687 dependent on the source material. | |
8688 . | |
8689 .TP | |
8690 .B (no)trellis | |
8691 Trellis Quantization is a kind of adaptive quantization method that | |
8692 saves bits by modifying quantized coefficients to make them more | |
8693 compressible by the entropy encoder. | |
8694 Its impact on quality is good, and if VHQ uses too much CPU for you, | |
8695 this setting can be a good alternative to save a few bits (and gain | |
8696 quality at fixed bitrate) at a lesser cost than with VHQ (default: on). | |
8697 . | |
8698 .TP | |
8699 .B (no)cartoon | |
8700 Activate this if your encoded sequence is an anime/\:cartoon. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8701 It modifies some Xvid internal thresholds so Xvid takes better decisions on |
20707 | 8702 frame types and motion vectors for flat looking cartoons. |
8703 . | |
8704 .TP | |
8705 .B quant_type=<h263|mpeg> | |
8706 Sets the type of quantizer to use. | |
8707 For high bitrates, you will find that MPEG quantization preserves more detail. | |
8708 For low bitrates, the smoothing of H.263 will give you less block noise. | |
8709 When using custom matrices, MPEG quantization | |
8710 .B must | |
8711 be used. | |
8712 . | |
8713 .TP | |
8714 .B (no)chroma_me | |
8715 The usual motion estimation algorithm uses only the luminance information to | |
8716 find the best motion vector. | |
8717 However for some video material, using the chroma planes can help find | |
8718 better vectors. | |
8719 This setting toggles the use of chroma planes for motion estimation | |
8720 (default: on). | |
8721 . | |
8722 .TP | |
8723 .B (no)chroma_opt | |
8724 Enable a chroma optimizer prefilter. | |
8725 It will do some extra magic on color information to minimize the | |
8726 stepped-stairs effect on edges. | |
8727 It will improve quality at the cost of encoding speed. | |
8728 It reduces PSNR by nature, as the mathematical deviation to the original | |
8729 picture will get bigger, but the subjective image quality will raise. | |
8730 Since it works with color information, you might want to turn it off when | |
8731 encoding in grayscale. | |
8732 . | |
8733 .TP | |
8734 .B (no)hq_ac | |
8735 Activates high-quality prediction of AC coefficients for intra frames from | |
8736 neighbor blocks (default: on). | |
8737 . | |
8738 .TP | |
8739 .B vhq=<0\-4> | |
8740 The motion search algorithm is based on a search in the usual color domain | |
8741 and tries to find a motion vector that minimizes the difference between the | |
8742 reference frame and the encoded frame. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8743 With this setting activated, Xvid will also use the frequency domain (DCT) |
20707 | 8744 to search for a motion vector that minimizes not only the spatial |
8745 difference but also the encoding length of the block. | |
8746 Fastest to slowest: | |
8747 .PD 0 | |
8748 .RSs | |
8749 .IPs 0 | |
8750 off | |
8751 .IPs 1 | |
8752 mode decision (inter/\:intra MB) (default) | |
8753 .IPs 2 | |
8754 limited search | |
8755 .IPs 3 | |
8756 medium search | |
8757 .IPs 4 | |
8758 wide search | |
8759 .RE | |
8760 .PD 1 | |
8761 . | |
8762 .TP | |
8763 .B (no)lumi_mask | |
8764 Adaptive quantization allows the macroblock quantizers to vary inside | |
8765 each frame. | |
8766 This is a 'psychosensory' setting that is supposed to make use of the | |
8767 fact that the human eye tends to notice fewer details in very bright | |
8768 and very dark parts of the picture. | |
8769 It compresses those areas more strongly than medium ones, which will | |
8770 save bits that can be spent again on other frames, raising overall | |
8771 subjective quality and possibly reducing PSNR. | |
8772 . | |
8773 .TP | |
8774 .B min_iquant=<0\-31> | |
8775 minimum I-frame quantizer (default: 2) | |
8776 . | |
8777 .TP | |
8778 .B max_iquant=<0\-31> | |
8779 maximum I-frame quantizer (default: 31) | |
8780 . | |
8781 .TP | |
8782 .B min_pquant=<0\-31> | |
8783 minimum P-frame quantizer (default: 2) | |
8784 . | |
8785 .TP | |
8786 .B max_pquant=<0\-31> | |
8787 maximum P-frame quantizer (default: 31) | |
8788 . | |
8789 .TP | |
8790 .B min_bquant=<0\-31> | |
8791 minimum B-frame quantizer (default: 2) | |
8792 . | |
8793 .TP | |
8794 .B max_bquant=<0\-31> | |
8795 maximum B-frame quantizer (default: 31) | |
8796 . | |
8797 .TP | |
8798 .B quant_intra_matrix=<filename> | |
8799 Load a custom intra matrix file. | |
8800 You can build such a file with xvid4conf's matrix editor. | |
8801 . | |
8802 .TP | |
8803 .B quant_inter_matrix=<filename> | |
8804 Load a custom inter matrix file. | |
8805 You can build such a file with xvid4conf's matrix editor. | |
8806 . | |
8807 .TP | |
8808 .B curve_compression_high=<0\-100> | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8809 This setting allows Xvid to take a certain percentage of bits away from |
20707 | 8810 high bitrate scenes and give them back to the bit reservoir. |
8811 You could also use this if you have a clip with so many bits allocated | |
8812 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad | |
8813 (default: 0). | |
8814 . | |
8815 .TP | |
8816 .B curve_compression_low=<0\-100> | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8817 This setting allows Xvid to give a certain percentage of extra bits to the |
20707 | 8818 low bitrate scenes, taking a few bits from the entire clip. |
8819 This might come in handy if you have a few low-bitrate scenes that are | |
8820 still blocky (default: 0). | |
8821 . | |
8822 .TP | |
8823 .B overflow_control_strength=<0\-100> | |
8824 During pass one of two pass encoding, a scaled bitrate curve is computed. | |
8825 The difference between that expected curve and the result obtained during | |
8826 encoding is called overflow. | |
8827 Obviously, the two pass rate controller tries to compensate for that overflow, | |
8828 distributing it over the next frames. | |
8829 This setting controls how much of the overflow is distributed every time | |
8830 there is a new frame. | |
8831 Low values allow lazy overflow control, big rate bursts are compensated for | |
8832 more slowly (could lead to lack of precision for small clips). | |
8833 Higher values will make changes in bit redistribution more abrupt, possibly | |
8834 too abrupt if you set it too high, creating artifacts (default: 5). | |
8835 .br | |
8836 .I NOTE: | |
8837 This setting impacts quality a lot, play with it carefully! | |
8838 . | |
8839 .TP | |
8840 .B max_overflow_improvement=<0\-100> | |
8841 During the frame bit allocation, overflow control may increase the frame | |
8842 size. | |
8843 This parameter specifies the maximum percentage by which the overflow | |
8844 control is allowed to increase the frame size, compared to the ideal curve | |
8845 allocation | |
8846 (default: 5). | |
8847 . | |
8848 .TP | |
8849 .B max_overflow_degradation=<0\-100> | |
8850 During the frame bit allocation, overflow control may decrease the frame | |
8851 size. | |
8852 This parameter specifies the maximum percentage by which the overflow | |
8853 control is allowed to decrease the frame size, compared to the ideal curve | |
8854 allocation | |
8855 (default: 5). | |
8856 . | |
8857 .TP | |
8858 .B container_frame_overhead=<0...> | |
8859 Specifies a frame average overhead per frame, in bytes. | |
8860 Most of the time users express their target bitrate for video w/o taking | |
8861 care of the video container overhead. | |
8862 This small but (mostly) constant overhead can cause the target file size | |
8863 to be exceeded. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8864 Xvid allows users to set the amount of overhead per frame the |
20707 | 8865 container generates (give only an average per frame). |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8866 0 has a special meaning, it lets Xvid use its own default values |
20707 | 8867 (default: 24 \- AVI average overhead). |
8868 . | |
8869 .TP | |
8870 .B profile=<profile_name> | |
8871 Restricts options and VBV (peak bitrate over a short period) according to | |
8872 the Simple, Advanced Simple and DivX profiles. | |
8873 The resulting videos should be playable on standalone players adhering to these | |
8874 profile specifications. | |
8875 .PD 0 | |
8876 .RSs | |
8877 .IPs unrestricted | |
8878 no restrictions (default) | |
8879 .IPs "sp0\ \ " | |
8880 simple profile at level 0 | |
8881 .IPs "sp1\ \ " | |
8882 simple profile at level 1 | |
8883 .IPs "sp2\ \ " | |
8884 simple profile at level 2 | |
8885 .IPs "sp3\ \ " | |
8886 simple profile at level 3 | |
8887 .IPs "asp0\ " | |
8888 advanced simple profile at level 0 | |
8889 .IPs "asp1\ " | |
8890 advanced simple profile at level 1 | |
8891 .IPs "asp2\ " | |
8892 advanced simple profile at level 2 | |
8893 .IPs "asp3\ " | |
8894 advanced simple profile at level 3 | |
8895 .IPs "asp4\ " | |
8896 advanced simple profile at level 4 | |
8897 .IPs "asp5\ " | |
8898 advanced simple profile at level 5 | |
8899 .IPs dxnhandheld | |
8900 DXN handheld profile | |
8901 .IPs dxnportntsc | |
8902 DXN portable NTSC profile | |
8903 .IPs dxnportpal | |
8904 DXN portable PAL profile | |
8905 .IPs dxnhtntsc | |
8906 DXN home theater NTSC profile | |
8907 .IPs dxnhtpal | |
8908 DXN home theater PAL profile | |
8909 .IPs dxnhdtv | |
8910 DXN HDTV profile | |
8911 .RE | |
8912 .PD 1 | |
8913 .RS | |
8914 .I NOTE: | |
8915 These profiles should be used in conjunction with an appropriate \-ffourcc. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8916 Generally DX50 is applicable, as some players do not recognize Xvid but |
20707 | 8917 most recognize DivX. |
8918 .RE | |
8919 . | |
8920 .TP | |
8921 .B par=<mode> | |
8922 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR, | |
8923 the Display Aspect Ratio). | |
8924 PAR is the ratio of the width and height of a single pixel. | |
8925 So both are related like this: DAR = PAR * (width/height). | |
8926 .br | |
8927 MPEG-4 defines 5 pixel aspect ratios and one extended | |
8928 one, giving the opportunity to specify a specific pixel aspect | |
8929 ratio. | |
8930 5 standard modes can be specified: | |
8931 .PD 0 | |
8932 .RSs | |
8933 .IPs vga11 | |
8934 It is the usual PAR for PC content. | |
8935 Pixels are a square unit. | |
8936 .IPs pal43 | |
8937 PAL standard 4:3 PAR. | |
8938 Pixels are rectangles. | |
8939 .IPs pal169 | |
8940 same as above | |
8941 .IPs ntsc43 | |
8942 same as above | |
8943 .IPs ntsc169 | |
8944 same as above (Do not forget to give the exact ratio.) | |
8945 .IPs "ext\ \ " | |
8946 Allows you to specify your own pixel aspect ratio with par_width and | |
8947 par_height. | |
8948 .RE | |
8949 .PD 1 | |
8950 .RS | |
8951 .I NOTE: | |
8952 In general, setting aspect and autoaspect options is enough. | |
8953 .RE | |
8954 . | |
8955 .TP | |
8956 .B par_width=<1\-255> (par=ext only) | |
8957 Specifies the width of the custom pixel aspect ratio. | |
8958 . | |
8959 .TP | |
8960 .B par_height=<1\-255> (par=ext only) | |
8961 Specifies the height of the custom pixel aspect ratio. | |
8962 . | |
8963 .TP | |
8964 .B aspect=<x/y | f (float value)> | |
8965 Store movie aspect internally, just like MPEG files. | |
8966 Much nicer solution than rescaling, because quality is not decreased. | |
8967 MPlayer and a few others players will play these files correctly, others | |
8968 will display them with the wrong aspect. | |
8969 The aspect parameter can be given as a ratio or a floating point number. | |
8970 . | |
8971 .TP | |
8972 .B (no)autoaspect | |
8973 Same as the aspect option, but automatically computes aspect, taking | |
8974 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
8975 filter chain. | |
8976 . | |
8977 .TP | |
8978 .B "psnr\ \ \ " | |
8979 Print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8980 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in | |
8981 the current directory. | |
8982 Returned values are in dB (decibel), the higher the better. | |
8983 . | |
8984 .PP | |
8985 .sp 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8986 The following option is only available in Xvid 1.1.x. |
20707 | 8987 . |
8988 .TP | |
8989 .B bvhq=<0|1> | |
8990 This setting allows vector candidates for B-frames to be used for | |
8991 the encoding chosen using a rate distortion optimized operator, | |
8992 which is what is done for P-frames by the vhq option. | |
8993 This produces nicer-looking B-frames while incurring almost no | |
8994 performance penalty (default: 1). | |
8995 . | |
8996 .PP | |
8997 .sp 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8998 The following option is only available in the CVS version of Xvid. |
20707 | 8999 . |
9000 .TP | |
9001 .B threads=<0\-n> | |
9002 Create n threads to run the motion estimation (default: 0). | |
9003 The maximum number of threads that can be used is the picture height | |
9004 divided by 16. | |
9005 . | |
9006 . | |
9007 .SS x264enc (\-x264encopts) | |
9008 . | |
9009 .TP | |
9010 .B bitrate=<value> | |
9011 Sets the average bitrate to be used in kbits/\:second (default: off). | |
9012 Since local bitrate may vary, this average may be inaccurate for | |
9013 very short videos (see ratetol). | |
9014 Constant bitrate can be achieved by combining this with vbv_maxrate, | |
9015 at significant reduction in quality. | |
9016 . | |
9017 .TP | |
9018 .B qp=<0\-51> | |
9019 This selects the quantizer to use for P-frames. | |
9020 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively. | |
9021 20\-40 is a useful range (default: 26). | |
9022 Lower values result in better fidelity, but higher bitrates. | |
9023 0 is lossless. | |
9024 Note that quantization in H.264 works differently from MPEG-1/2/4: | |
9025 H.264's quantization parameter (QP) is on a logarithmic scale. | |
9026 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP). | |
9027 For example, MPEG at QP=2 is equivalent to H.264 at QP=18. | |
9028 . | |
9029 .TP | |
9030 .B crf=<1\-50> | |
9031 Enables constant quality mode, and selects the quality. | |
9032 The scale is similar to QP. | |
9033 Like the bitrate-based modes, this allows each frame to use a | |
9034 different QP based on the frame's complexity. | |
9035 . | |
9036 .TP | |
9037 .B pass=<1\-3> | |
9038 Enable 2 or 3-pass mode. | |
9039 It is recommended to always encode in 2 or 3-pass mode as it leads to a | |
9040 better bit distribution and improves overall quality. | |
9041 .PD 0 | |
9042 .RSs | |
9043 .IPs 1 | |
9044 first pass | |
9045 .IPs 2 | |
9046 second pass (of two pass encoding) | |
9047 .IPs 3 | |
9048 Nth pass (second and third passes of three pass encoding) | |
9049 .RE | |
9050 .RS | |
9051 Here is how it works, and how to use it: | |
9052 .br | |
9053 The first pass (pass=1) collects statistics on the video and writes them | |
9054 to a file. | |
9055 You might want to deactivate some CPU-hungry options, apart from the ones | |
9056 that are on by default. | |
9057 .br | |
9058 In two pass mode, the second pass (pass=2) reads the statistics file and | |
9059 bases ratecontrol decisions on it. | |
9060 .br | |
9061 In three pass mode, the second pass (pass=3, that is not a typo) | |
9062 does both: It first reads the statistics, then overwrites them. | |
9063 You can use all encoding options, except very CPU-hungry options. | |
9064 .br | |
9065 The third pass (pass=3) is the same as the second pass, except that it has | |
9066 the second pass' statistics to work from. | |
9067 You can use all encoding options, including CPU-hungry ones. | |
9068 .br | |
9069 The first pass may use either average bitrate or constant quantizer. | |
9070 ABR is recommended, since it does not require guessing a quantizer. | |
9071 Subsequent passes are ABR, and must specify bitrate. | |
9072 .REss | |
9073 . | |
9074 .TP | |
9075 .B turbo=<0\-2> | |
9076 Fast first pass mode. | |
9077 During the first pass of a two or more pass encode it is possible to gain | |
9078 speed by disabling some options with negligible or even no impact on the | |
9079 final pass output quality. | |
9080 .PD 0 | |
9081 .RSs | |
9082 .IPs 0 | |
9083 disabled (default) | |
9084 .IPs 1 | |
9085 Reduce subq, frameref and disable some inter-macroblock partition analysis | |
9086 modes. | |
9087 .IPs 2 | |
9088 Reduce subq and frameref to 1, use a diamond ME search and disable all | |
9089 partition analysis modes. | |
9090 .RE | |
9091 .RS | |
9092 Level 1 can increase first pass speed up to 2x with no change in the global | |
9093 PSNR of the final pass compared to a full quality first pass. | |
9094 .br | |
9095 Level 2 can increase first pass speed up to 4x with about +/- 0.05dB change | |
9096 in the global PSNR of the final pass compared to a full quality first pass. | |
9097 .REss | |
9098 . | |
9099 .TP | |
9100 .B keyint=<value> | |
9101 Sets maximum interval between IDR-frames (default: 250). | |
9102 Larger values save bits, thus improve quality, at the cost of seeking | |
9103 precision. | |
9104 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large | |
9105 values of keyint. | |
9106 . | |
9107 .TP | |
9108 .B keyint_min=<1\-keyint/2> | |
9109 Sets minimum interval between IDR-frames (default: 25). | |
9110 If scenecuts appear within this interval, they are still encoded as | |
9111 I-frames, but do not start a new GOP. | |
9112 In H.264, I-frames do not necessarily bound a closed GOP because it is | |
9113 allowable for a P-frame to be predicted from more frames than just the one | |
9114 frame before it (also see frameref). | |
9115 Therefore, I-frames are not necessarily seekable. | |
9116 IDR-frames restrict subsequent P-frames from referring to any frame | |
9117 prior to the IDR-frame. | |
9118 . | |
9119 .TP | |
9120 .B scenecut=<-1\-100> | |
9121 Controls how aggressively to insert extra I-frames (default: 40). | |
9122 With small values of scenecut, the codec often has to force an I-frame | |
9123 when it would exceed keyint. | |
9124 Good values of scenecut may find a better location for the I-frame. | |
9125 Large values use more I-frames than necessary, thus wasting bits. | |
9126 -1 disables scene-cut detection, so I-frames are inserted only once | |
9127 every other keyint frames, even if a scene-cut occurs earlier. | |
9128 This is not recommended and wastes bitrate as scenecuts encoded as P-frames | |
9129 are just as big as I-frames, but do not reset the "keyint counter". | |
9130 . | |
9131 .TP | |
9132 .B frameref=<1\-16> | |
9133 Number of previous frames used as predictors in B- and P-frames (default: 1). | |
9134 This is effective in anime, but in live-action material the improvements | |
9135 usually drop off very rapidly above 6 or so reference frames. | |
9136 This has no effect on decoding speed, but does increase the memory needed for | |
9137 decoding. | |
9138 Some decoders can only handle a maximum of 15 reference frames. | |
9139 . | |
9140 .TP | |
9141 .B bframes=<0\-16> | |
9142 maximum number of consecutive B-frames between I- and P-frames (default: 0) | |
9143 . | |
9144 .TP | |
9145 .B (no)b_adapt | |
9146 Automatically decides when to use B-frames and how many, up to the maximum | |
9147 specified above (default: on). | |
9148 If this option is disabled, then the maximum number of B-frames is used. | |
9149 . | |
9150 .TP | |
9151 .B b_bias=<-100\-100> | |
9152 Controls the decision performed by b_adapt. | |
9153 A higher b_bias produces more B-frames (default: 0). | |
9154 . | |
9155 .TP | |
9156 .B (no)b_pyramid | |
9157 Allows B-frames to be used as references for predicting other frames. | |
9158 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4. | |
9159 Without this option, B-frames follow the same pattern as MPEG-[124]. | |
9160 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames | |
9161 are predicted from I0 and P4. | |
9162 With this option, they are coded as I0 P4 B2 B1 B3. | |
9163 B2 is the same as above, but B1 is predicted from I0 and B2, and | |
9164 B3 is predicted from B2 and P4. | |
9165 This usually results in slightly improved compression, at almost no | |
9166 speed cost. | |
9167 However, this is an experimental option: it is not fully tuned and | |
9168 may not always help. | |
9169 Requires bframes >= 2. | |
9170 Disadvantage: increases decoding delay to 2 frames. | |
9171 . | |
9172 .TP | |
9173 .B (no)deblock | |
9174 Use deblocking filter (default: on). | |
9175 As it takes very little time compared to its quality gain, it is not | |
9176 recommended to disable it. | |
9177 . | |
9178 .TP | |
9179 .B deblock=<-6\-6>,<-6\-6> | |
9180 The first parameter is AlphaC0 (default: 0). | |
9181 This adjusts thresholds for the H.264 in-loop deblocking filter. | |
9182 First, this parameter adjusts the maximum amount of change that the filter is | |
9183 allowed to cause on any one pixel. | |
9184 Secondly, this parameter affects the threshold for difference across the | |
9185 edge being filtered. | |
9186 A positive value reduces blocking artifacts more, but will also smear details. | |
9187 .br | |
9188 The second parameter is Beta (default: 0). | |
9189 This affects the detail threshold. | |
9190 Very detailed blocks are not filtered, since the smoothing caused by the | |
9191 filter would be more noticeable than the original blocking. | |
9192 .br | |
9193 The default behavior of the filter almost always achieves optimal quality, | |
9194 so it is best to either leave it alone, or make only small adjustments. | |
9195 However, if your source material already has some blocking or noise which | |
9196 you would like to remove, it may be a good idea to turn it up a little bit. | |
9197 . | |
9198 .TP | |
9199 .B (no)cabac | |
9200 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on). | |
9201 Slightly slows down encoding and decoding, but should save 10-15% bitrate. | |
9202 Unless you are looking for decoding speed, you should not disable it. | |
9203 . | |
9204 .TP | |
9205 .B qp_min=<1\-51> (ABR or two pass) | |
9206 Minimum quantizer, 10\-30 seems to be a useful range (default: 10). | |
9207 . | |
9208 .TP | |
9209 .B qp_max=<1\-51> (ABR or two pass) | |
9210 maximum quantizer (default: 51) | |
9211 . | |
9212 .TP | |
9213 .B qp_step=<1\-50> (ABR or two pass) | |
9214 maximum value by which the quantizer may be incremented/decremented between | |
9215 frames (default: 4) | |
9216 . | |
9217 .TP | |
9218 .B ratetol=<0.1\-100.0> (ABR or two pass) | |
9219 allowed variance in average bitrate (no particular units) (default: 1.0) | |
9220 . | |
9221 .TP | |
9222 .B vbv_maxrate=<value> (ABR or two pass) | |
9223 maximum local bitrate, in kbits/\:second (default: disabled) | |
9224 . | |
9225 .TP | |
9226 .B vbv_bufsize=<value> (ABR or two pass) | |
9227 averaging period for vbv_maxrate, in kbits | |
9228 (default: none, must be specified if vbv_maxrate is enabled) | |
9229 . | |
9230 .TP | |
9231 .B vbv_init=<0.0\-1.0> (ABR or two pass) | |
9232 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9) | |
9233 . | |
9234 .TP | |
9235 .B ip_factor=<value> | |
9236 quantizer factor between I- and P-frames (default: 1.4) | |
9237 . | |
9238 .TP | |
9239 .B pb_factor=<value> | |
9240 quantizer factor between P- and B-frames (default: 1.3) | |
9241 . | |
9242 .TP | |
9243 .B qcomp=<0\-1> (ABR or two pass) | |
9244 quantizer compression (default: 0.6). | |
9245 A lower value makes the bitrate more constant, | |
9246 while a higher value makes the quantization parameter more constant. | |
9247 . | |
9248 .TP | |
9249 .B cplx_blur=<0\-999> (two pass only) | |
9250 Temporal blur of the estimated frame complexity, before curve compression | |
9251 (default: 20). | |
9252 Lower values allow the quantizer value to jump around more, | |
9253 higher values force it to vary more smoothly. | |
9254 cplx_blur ensures that each I-frame has quality comparable to the following | |
9255 P-frames, and ensures that alternating high and low complexity frames | |
9256 (e.g. low fps animation) do not waste bits on fluctuating quantizer. | |
9257 . | |
9258 .TP | |
9259 .B qblur=<0\-99> (two pass only) | |
9260 Temporal blur of the quantization parameter, after curve compression | |
9261 (default: 0.5). | |
9262 Lower values allow the quantizer value to jump around more, | |
9263 higher values force it to vary more smoothly. | |
9264 . | |
9265 .TP | |
9266 .B zones=<zone0>[/<zone1>[/...]] | |
9267 User specified quality for specific parts (ending, credits, ...). | |
9268 Each zone is <start-frame>,<end-frame>,<option> where option may be | |
9269 .PD 0 | |
9270 .RSs | |
9271 .IPs "q=<0\-51>" | |
9272 quantizer | |
9273 .IPs "b=<0.01\-100.0>" | |
9274 bitrate multiplier | |
9275 .RE | |
9276 .PD 1 | |
9277 .RS | |
9278 .I NOTE: | |
9279 The quantizer option is not strictly enforced. | |
9280 It affects only the planning stage of ratecontrol, and is still subject | |
9281 to overflow compensation and qp_min/qp_max. | |
9282 .RE | |
9283 . | |
9284 .TP | |
9285 .B direct_pred=<name> | |
9286 Determines the type of motion prediction used for direct macroblocks | |
9287 in B-frames. | |
9288 .PD 0 | |
9289 .RSs | |
9290 .IPs none | |
9291 Direct macroblocks are not used. | |
9292 .IPs spatial | |
9293 Motion vectors are extrapolated from neighboring blocks. | |
9294 (default) | |
9295 .IPs temporal | |
9296 Motion vectors are interpolated from the following P-frame. | |
9297 .IPs auto | |
9298 The codec selects between spatial and temporal for each frame. | |
9299 .RE | |
9300 .PD 1 | |
9301 .RS | |
9302 Spatial and temporal are approximately the same speed and PSNR, | |
9303 the choice between them depends on the video content. | |
9304 Auto is slightly better, but slower. | |
9305 Auto is most effective when combined with multipass. | |
9306 direct_pred=none is both slower and lower quality. | |
9307 .RE | |
9308 . | |
9309 .TP | |
9310 .B (no)weight_b | |
9311 Use weighted prediction in B-frames. | |
9312 Without this option, bidirectionally predicted macroblocks give | |
9313 equal weight to each reference frame. | |
9314 With this option, the weights are determined by the temporal position | |
9315 of the B-frame relative to the references. | |
9316 Requires bframes > 1. | |
9317 . | |
9318 .TP | |
9319 .B partitions=<list> | |
9320 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4). | |
9321 .PD 0 | |
9322 .RSs | |
9323 .IPs p8x8 | |
9324 Enable types p16x8, p8x16, p8x8. | |
9325 .IPs p4x4 | |
9326 Enable types p8x4, p4x8, p4x4. | |
9327 p4x4 is recommended only with subq >= 5, and only at low resolutions. | |
9328 .IPs b8x8 | |
9329 Enable types b16x8, b8x16, b8x8. | |
9330 .IPs i8x8 | |
9331 Enable type i8x8. | |
9332 i8x8 has no effect unless 8x8dct is enabled. | |
9333 .IPs i4x4 | |
9334 Enable type i4x4. | |
9335 .IPs all | |
9336 Enable all of the above types. | |
9337 .IPs none | |
9338 Disable all of the above types. | |
9339 .RE | |
9340 .PD 1 | |
9341 .RS | |
9342 Regardless of this option, macroblock types p16x16, b16x16, and i16x16 | |
9343 are always enabled. | |
9344 .br | |
9345 The idea is to find the type and size that best describe a certain area | |
9346 of the picture. | |
9347 For example, a global pan is better represented by 16x16 blocks, while | |
9348 small moving objects are better represented by smaller blocks. | |
9349 .RE | |
9350 . | |
9351 .TP | |
9352 .B (no)8x8dct | |
9353 Adaptive spatial transform size: allows macroblocks to choose between | |
9354 4x4 and 8x8 DCT. | |
9355 Also allows the i8x8 macroblock type. | |
9356 Without this option, only 4x4 DCT is used. | |
9357 . | |
9358 .TP | |
9359 .B me=<name> | |
9360 Select fullpixel motion estimation algorithm. | |
9361 .PD 0 | |
9362 .RSs | |
9363 .IPs dia | |
9364 diamond search, radius 1 (fast) | |
9365 .IPs hex | |
9366 hexagon search, radius 2 (default) | |
9367 .IPs umh | |
9368 uneven multi-hexagon search (slow) | |
9369 .IPs esa | |
9370 exhaustive search (very slow, and no better than umh) | |
9371 .RE | |
9372 .PD 1 | |
9373 . | |
9374 .TP | |
9375 .B me_range=<4\-64> | |
9376 radius of exhaustive or multi-hexagon motion search (default: 16) | |
9377 . | |
9378 .TP | |
9379 .B subq=<1\-7> | |
9380 Adjust subpel refinement quality. | |
9381 This parameter controls quality versus speed tradeoffs involved in the motion | |
9382 estimation decision process. | |
9383 subq=5 can compress up to 10% better than subq=1. | |
9384 .PD 0 | |
9385 .RSs | |
9386 .IPs 1 | |
9387 Runs fullpixel precision motion estimation on all candidate | |
9388 macroblock types. | |
9389 Then selects the best type. | |
9390 Then refines the motion of that type to fast quarterpixel precision (fastest). | |
9391 .IPs 2 | |
9392 Runs halfpixel precision motion estimation on all candidate macroblock types. | |
9393 Then selects the best type. | |
9394 Then refines the motion of that type to fast quarterpixel precision. | |
9395 .IPs 3 | |
9396 As 2, but uses a slower quarterpixel refinement. | |
9397 .IPs 4 | |
9398 Runs fast quarterpixel precision motion estimation on all candidate | |
9399 macroblock types. | |
9400 Then selects the best type. | |
9401 Then finishes the quarterpixel refinement for that type. | |
9402 .IPs 5 | |
9403 Runs best quality quarterpixel precision motion estimation on all | |
9404 candidate macroblock types, before selecting the best type (default). | |
9405 .IPs 6 | |
9406 Enables rate-distortion optimization of macroblock types in | |
9407 I- and P-frames. | |
9408 .IPs 7 | |
9409 Enables rate-distortion optimization of motion vectors and intra modes. (best) | |
9410 .RE | |
9411 .PD 1 | |
9412 .RS | |
9413 In the above, "all candidates" does not exactly mean all enabled types: | |
9414 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16. | |
9415 .RE | |
9416 . | |
9417 .TP | |
9418 .B (no)chroma_me | |
9419 Takes into account chroma information during subpixel motion search | |
9420 (default: enabled). | |
9421 Requires subq>=5. | |
9422 . | |
9423 .TP | |
9424 .B (no)mixed_refs | |
9425 Allows each 8x8 or 16x8 motion partition to independently select a | |
9426 reference frame. | |
9427 Without this option, a whole macroblock must use the same reference. | |
9428 Requires frameref>1. | |
9429 . | |
9430 .TP | |
9431 .B (no)brdo | |
9432 Enables rate-distortion optimization of macroblock types in B-frames. | |
9433 Requires subq>=6. | |
9434 . | |
9435 .TP | |
9436 .B (no)bime | |
9437 Refine the two motion vectors used in bidirectional macroblocks, | |
9438 rather than re-using vectors from the forward and backward searches. | |
9439 This option has no effect without B-frames. | |
9440 . | |
9441 .TP | |
9442 .B trellis=<0\-2> | |
9443 rate-distortion optimal quantization | |
9444 .PD 0 | |
9445 .RSs | |
9446 .IPs 0 | |
9447 disabled (default) | |
9448 .IPs 1 | |
9449 enabled only for the final encode | |
9450 .IPs 2 | |
9451 enabled during all mode decisions (slow, requires subq>=6) | |
9452 .RE | |
9453 .PD 1 | |
9454 . | |
9455 .TP | |
9456 .B deadzone_inter=<0\-32> | |
9457 Set the size of the inter luma quantization deadzone for non-trellis | |
9458 quantization (default: 21). | |
9459 . | |
9460 .TP | |
9461 .B deadzone_intra=<0\-32> | |
9462 Set the size of the intra luma quantization deadzone for non-trellis | |
9463 quantization (default: 11). | |
9464 . | |
9465 .TP | |
9466 .B (no)fast_pskip | |
9467 Performs early skip detection in P-frames (default: enabled). | |
9468 This usually improves speed at no cost, but it can sometimes produce | |
9469 artifacts in areas with no details, like sky. | |
9470 . | |
9471 .TP | |
9472 .B (no)dct_decimate | |
9473 Eliminate dct blocks in P-frames containing only a small single coefficient | |
9474 (default: enabled). | |
9475 This will remove some details, so it will save bits that can be spent | |
9476 again on other frames, hopefully raising overall subjective quality. | |
9477 If you are compressing non-anime content with a high target bitrate, you | |
9478 may want to disable this to preserve as much detail as possible. | |
9479 . | |
9480 .TP | |
9481 .B nr=<0\-100000> | |
9482 Noise reduction, 0 means disabled. | |
9483 100\-1000 is a useful range for typical content, but you may want to turn it | |
9484 up a bit more for very noisy content (default: 0). | |
9485 Given its small impact on speed, you might want to prefer to use this over | |
9486 filtering noise away with video filters like denoise3d or hqdn3d. | |
9487 . | |
9488 .TP | |
9489 .B chroma_qp_offset=<-12\-12> | |
9490 Use a different quantizer for chroma as compared to luma. | |
9491 Useful values are in the range <-2\-2> (default: 0). | |
9492 . | |
9493 .TP | |
9494 .B cqm=<flat|jvt|<filename>> | |
9495 Either uses a predefined custom quantization matrix or loads a JM format | |
9496 matrix file. | |
9497 .PD 0 | |
9498 .RSs | |
9499 .IPs "flat\ " | |
9500 Use the predefined flat 16 matrix (default). | |
9501 .IPs "jvt\ \ " | |
9502 Use the predefined JVT matrix. | |
9503 .IPs <filename> | |
9504 Use the provided JM format matrix file. | |
9505 .PD 1 | |
9506 .RE | |
9507 .RS | |
9508 .I NOTE: | |
9509 Windows CMD.EXE users may experience problems with parsing the command line | |
9510 if they attempt to use all the CQM lists. | |
9511 This is due to a command line length limitation. | |
9512 In this case it is recommended the lists be put into a JM format CQM | |
9513 file and loaded as specified above. | |
9514 .RE | |
9515 . | |
9516 .TP | |
9517 .B cqm4iy=<list> (also see cqm) | |
9518 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated | |
9519 values in the 1\-255 range. | |
9520 . | |
9521 .TP | |
9522 .B cqm4ic=<list> (also see cqm) | |
9523 Custom 4x4 intra chrominance matrix, given as a list of 16 comma | |
9524 separated values in the 1\-255 range. | |
9525 . | |
9526 .TP | |
9527 .B cqm4py=<list> (also see cqm) | |
9528 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated | |
9529 values in the 1\-255 range. | |
9530 . | |
9531 .TP | |
9532 .B cqm4pc=<list> (also see cqm) | |
9533 Custom 4x4 inter chrominance matrix, given as a list of 16 comma | |
9534 separated values in the 1\-255 range. | |
9535 . | |
9536 .TP | |
9537 .B cqm8iy=<list> (also see cqm) | |
9538 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated | |
9539 values in the 1\-255 range. | |
9540 . | |
9541 .TP | |
9542 .B cqm8py=<list> (also see cqm) | |
9543 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated | |
9544 values in the 1\-255 range. | |
9545 . | |
9546 .TP | |
9547 .B level_idc=<10\-51> | |
9548 Set the bitstream's level as defined by annex A of the H.264 standard | |
9549 (default: 51 - Level 5.1). | |
9550 This is used for telling the decoder what capabilities it needs to support. | |
9551 Use this parameter only if you know what it means, | |
9552 and you have a need to set it. | |
9553 . | |
9554 .TP | |
9555 .B threads=<1\-4> | |
9556 Split each frame into slices and encode them in parallel (default: 1). | |
9557 Also allows multithreaded decoding if the decoder supports it (lavc does not). | |
9558 This has a slight penalty to compression. | |
9559 Requires that libx264 was compiled with pthread support; if not, this | |
9560 option will produce a warning and enables slices but not multithreading. | |
9561 . | |
9562 .TP | |
9563 .B (no)global_header | |
9564 Causes SPS and PPS to appear only once, at the beginning of the bitstream | |
9565 (default: disabled). | |
9566 Some players, such as the Sony PSP, require the use of this option. | |
9567 The default behavior causes SPS and PPS to repeat prior to each IDR frame. | |
9568 . | |
9569 .TP | |
9570 .B (no)interlaced | |
9571 Treat the video content as interlaced. | |
9572 . | |
9573 .TP | |
9574 .B log=<-1\-3> | |
9575 Adjust the amount of logging info printed to the screen. | |
9576 .PD 0 | |
9577 .RSs | |
9578 .IPs "-1" | |
9579 none | |
9580 .IPs " 0" | |
9581 Print errors only. | |
9582 .IPs " 1" | |
9583 warnings | |
9584 .IPs " 2" | |
9585 PSNR and other analysis statistics when the encode finishes (default) | |
9586 .IPs " 3" | |
9587 PSNR, QP, frametype, size, and other statistics for every frame | |
9588 .RE | |
9589 .PD 1 | |
9590 . | |
9591 .TP | |
9592 .B (no)psnr | |
9593 Print signal-to-noise ratio statistics. | |
9594 .br | |
9595 .I NOTE: | |
9596 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not | |
9597 mathematically sound (they are simply the average of per-frame PSNRs). | |
9598 They are kept only for comparison to the JM reference codec. | |
9599 For all other purposes, please use either the 'Global' PSNR, or the per-frame | |
9600 PSNRs printed by log=3. | |
9601 . | |
9602 .TP | |
9603 .B (no)ssim | |
9604 Print the Structural Similarity Metric results. | |
9605 This is an alternative to PSNR, and may be better correlated with the | |
9606 perceived quality of the compressed video. | |
9607 . | |
9608 .TP | |
9609 .B (no)visualize | |
9610 Enable x264 visualizations during encoding. | |
9611 If the x264 on your system supports it, a new window will be opened during | |
9612 the encoding process, in which x264 will attempt to present an overview of | |
9613 how each frame gets encoded. | |
9614 Each block type on the visualized movie will be colored as follows: | |
9615 .PD 0 | |
9616 .RSs | |
9617 .IPs red/pink | |
9618 intra block | |
9619 .IPs "blue\ " | |
9620 inter block | |
9621 .IPs green | |
9622 skip block | |
9623 .IPs yellow | |
9624 B-block | |
9625 .RE | |
9626 .PD 1 | |
9627 .RS | |
9628 This feature can be considered experimental and subject to change. | |
9629 In particular, it depends on x264 being compiled with visualizations enabled. | |
9630 Note that as of writing this, x264 pauses after encoding and visualizing | |
9631 each frame, waiting for the user to press a key, at which point the next | |
9632 frame will be encoded. | |
9633 .RE | |
9634 . | |
9635 . | |
9636 .SS xvfw (\-xvfwopts) | |
9637 . | |
9638 Encoding with Video for Windows codecs is mostly obsolete unless you wish | |
9639 to encode to some obscure fringe codec. | |
9640 . | |
9641 .TP | |
9642 .B codec=<name> | |
9643 The name of the binary codec file with which to encode. | |
9644 . | |
9645 . | |
9646 .SS MPEG muxer (\-mpegopts) | |
9647 . | |
9648 The MPEG muxer can generate 5 types of streams, each of which has reasonable | |
9649 default parameters that the user can override. | |
9650 Generally, when generating MPEG files, it is advisable to disable | |
9651 MEncoder's frame-skip code (see \-noskip, \-mc as well as the | |
9652 harddup and softskip video filters). | |
9653 .PP | |
9654 .I EXAMPLE: | |
9655 .PD 0 | |
9656 .RSs | |
9657 .IPs format=mpeg2:tsaf:vbitrate=8000 | |
9658 .RE | |
9659 .PD 1 | |
9660 . | |
9661 .TP | |
9662 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd> | |
9663 stream format (default: mpeg2) | |
9664 . | |
9665 .TP | |
9666 .B size=<up to 65535> | |
9667 Pack size in bytes, do not change unless you know exactly what | |
9668 you are doing (default: 2048). | |
9669 . | |
9670 .TP | |
9671 .B muxrate=<int> | |
9672 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s). | |
9673 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'. | |
9674 . | |
9675 .TP | |
9676 .B "tsaf\ \ \ " | |
9677 Sets timestamps on all frames, if possible; recommended when format=dvd. | |
9678 If dvdauthor complains with a message like "..audio sector out of range...", | |
9679 you probably did not enable this option. | |
9680 . | |
9681 .TP | |
9682 .B init_vpts=<100\-700> | |
9683 initial video pts, in milliseconds (default: 200) | |
9684 . | |
9685 .TP | |
9686 .B init_apts=<100\-700> | |
9687 initial audio pts, in milliseconds (default: 200) | |
9688 . | |
9689 .TP | |
9690 .B vdelay=<1\-32760> | |
9691 Initial video delay time, in milliseconds (default: 0), | |
9692 use it if you want to delay video with respect to audio. | |
9693 . | |
9694 .TP | |
9695 .B "drop\ \ \ " | |
9696 When used with init_adelay the muxer drops the part of audio that was | |
9697 anticipated. | |
9698 . | |
9699 .TP | |
9700 .B vwidth, vheight=<1\-4095> | |
9701 Set the video width and height when video is MPEG-1/2. | |
9702 . | |
9703 .TP | |
9704 .B vpswidth, vpsheight=<1\-4095> | |
9705 Set pan and scan video width and height when video is MPEG-2. | |
9706 . | |
9707 .TP | |
9708 .B vaspect=<1 | 4/3 | 16/9 | 221/100> | |
9709 Sets the display aspect ratio for MPEG-2 video. | |
9710 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong. | |
9711 . | |
9712 .TP | |
9713 .B vbitrate=<int> | |
9714 Sets the video bitrate in kbit/s for MPEG-1/2 video. | |
9715 . | |
9716 .TP | |
9717 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 > | |
9718 Sets the framerate for MPEG-1/2 video. | |
9719 This option will be ignored if used with the telecine option. | |
9720 . | |
9721 .TP | |
9722 .B telecine | |
9723 Enables 3:2 pulldown soft telecine mode: The muxer will make the | |
9724 video stream look like it was encoded at 30000/1001 or 30 fps. | |
9725 It only works with MPEG-2 video when the output framerate, | |
9726 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9727 Any other framerate is incompatible with this option. | |
9728 . | |
9729 .TP | |
9730 .B film2pal | |
9731 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer | |
9732 will make the video stream look like it was encoded at 25 fps. | |
9733 It only works with MPEG-2 video when the output framerate, | |
9734 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9735 Any other framerate is incompatible with this option. | |
9736 . | |
9737 . | |
9738 .SS FFmpeg libavformat demuxers (\-lavfdopts) | |
9739 . | |
9740 .TP | |
9741 .B probesize=<value> | |
9742 Maximum amount of data to probe during the detection phase. | |
9743 In the case of MPEG-TS this value identifies the maximum number | |
9744 of TS packets to scan. | |
9745 . | |
9746 . | |
9747 . | |
9748 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf) | |
9749 . | |
9750 .TP | |
9751 .B delay=<value> | |
9752 Currently only meaningful for MPEG[12]: Maximum allowed distance, | |
9753 in seconds, between the reference timer of the output stream (SCR) | |
9754 and the decoding timestamp (DTS) for any stream present | |
9755 (demux to decode delay). | |
9756 Default is 0.7 (as mandated by the standards defined by MPEG). | |
9757 Higher values require larger buffers and must not be used. | |
9758 . | |
9759 .TP | |
9760 .B format=<container_format> | |
9761 Override which container format to mux into | |
9762 (default: autodetect from output file extension). | |
9763 .PD 0 | |
9764 .RSs | |
9765 .IPs "mpg\ \ " | |
9766 MPEG-1 systems and MPEG-2 PS | |
9767 .IPs "asf\ \ " | |
9768 Advanced Streaming Format | |
9769 .IPs "avi\ \ " | |
9770 Audio Video Interleave file | |
9771 .IPs "wav\ \ " | |
9772 Waveform Audio | |
9773 .IPs "swf\ \ " | |
9774 Macromedia Flash | |
9775 .IPs "flv\ \ " | |
9776 Macromedia Flash video files | |
9777 .IPs "rm\ \ \ " | |
9778 RealAudio and RealVideo | |
9779 .IPs "au\ \ \ " | |
9780 SUN AU format | |
9781 .IPs "nut\ \ " | |
9782 NUT open container format (experimental) | |
9783 .IPs "mov\ \ " | |
9784 QuickTime | |
9785 .IPs "mp4\ \ " | |
9786 MPEG-4 format | |
9787 .IPs "dv\ \ \ " | |
9788 Sony Digital Video container | |
9789 .RE | |
9790 .PD 1 | |
9791 .TP | |
9792 .B i_certify_that_my_video_stream_does_not_use_b_frames | |
9793 MEncoder cannot assign correct timestamps when there are | |
9794 B-frames in the video stream, resulting in broken encodes. | |
9795 . | |
9796 .TP | |
9797 .B muxrate=<rate> | |
9798 Минимальный битовый поток мультиплексирования, в бит/с; | |
9799 в данный момент имеет смысл только для MPEG[12]. | |
9800 Иногда уго указание необходимо для избавления от "buffer underflows". | |
9801 . | |
9802 .TP | |
9803 .B packetsize=<size> | |
9804 .\" FIXME better translation | |
9805 Размер, выраженный в байтах, атомарного[unitary] пакета для выбранного формата. | |
9806 При сжатии в MPEG[12] используются следующие значения по-умолчанию: | |
9807 2324 для [S]VCD, 2048 для всех остальных форматов. | |
9808 . | |
9809 .TP | |
9810 .B preload=<distance> | |
9811 На текущий момент имеет смысл только для MPEG[12]: Начальное разница, | |
9812 в секундах, между значением таймера потока вывода (SCR) и временной меткой | |
9813 .\" FIXME better translation | |
9814 декодирования (DTS) для любого существующего потока (задержка декодирования | |
9815 [demux to decode delay]). | |
9816 . | |
9817 . | |
9818 . | |
9819 .\" -------------------------------------------------------------------------- | |
9820 .\" переменные окружения | |
9821 .\" -------------------------------------------------------------------------- | |
9822 . | |
9823 .SH ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ | |
9824 . | |
9825 Существуют некоторые переменные окружения, которые могут использоваться для управления | |
9826 поведением MPlayer И MEncoder. | |
9827 . | |
9828 .TP | |
9829 .B MPLAYER_CHARSET (также смотрите \-msgcharset) | |
9830 Преодразовывать сообщения консоли в указанную кодировку (по-умолчанию: автоопределение). | |
9831 Значение "noconv" означает отсутствие перекодировки. | |
9832 . | |
9833 .TP | |
9834 .B MPLAYER_HOME | |
9835 Каталог, в котором MPlayer ищет настройки пользователя. | |
9836 . | |
9837 .TP | |
9838 .B MPLAYER_VERBOSE (также смотрите \-v и \-msglevel) | |
9839 Указывает начальный уровень подробности сообщений для всех | |
9840 модулей (пл-умолчанию: 0). | |
9841 Отрицательные значения приведет к меньшему количеству сообщений, положительное - | |
9842 к большему. | |
9843 . | |
9844 .SS libaf: | |
9845 . | |
9846 .TP | |
9847 .B LADSPA_PATH | |
9848 Если LADSPA_PATH установлена, производится поиск указанного файла. Если не | |
9849 установлена, вам придется указать полный путь. | |
9850 FIXME: Ою этом также упоминается в разделе ladspa. | |
9851 . | |
9852 .SS libdvdcss: | |
9853 . | |
9854 .TP | |
9855 .B DVDCSS_CACHE | |
9856 Указывает каталог, хранящий ключи роликов. | |
9857 Это ускоряет расшифровку[descrambling] DVD? находящихся в кеше. | |
9858 Каталог DVDCSS_CACHE будет создан, если не существовал, | |
9859 а ткаже подкаталог с названием DVD ролика или даты изготовления. | |
9860 Если DVDCSS_CACHE не установлена или пуста, libdvdcss будет использовать | |
9861 значение по-умолчания, равное "${HOME}/.dvdcss/" под Unix и | |
9862 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" под Win32. | |
9863 Спецальное значение "off" отключает кеширование. | |
9864 . | |
9865 .TP | |
9866 .B DVDCSS_METHOD | |
9867 Устанавливает методы аутентикации и дешифровки, которые | |
9868 libdvdcss будет использовать для чтения шифрованных[scrambled] дисков. | |
9869 Может принимать значения title, key or disc. | |
9870 .PD 0 | |
9871 .RSs | |
9872 .IPs "key\ \ " | |
9873 это метод по-умолчанию. | |
9874 libdvdcss будет использовать набор рассчитанных ключей проигрывателей, | |
9875 чтобы попробовать и получить ключ диска. | |
9876 Это модет не сработать, если устройство не распознает ни один из ключей | |
9877 проигрывателей. | |
9878 .IPs "disc\ " | |
9879 это аварийный метод, когда предыдущий не справился. | |
9880 Вместо использования ключей проигрывателей, libdvdcss взломает ключ | |
9881 диска используя грубый метод взлома. Этот процесс требователен к CPU | |
9882 и требцет 64Мб памяти для хранения временных данных. | |
9883 .IPs title | |
9884 это аварийный метод, если ни один из предыдцщих не сработал. | |
9885 Он никак не связан с обменом клчами с устройством DVD, но вместо этого | |
9886 используеткрипто атаку, для угадыванию ключа ролика. | |
9887 В исключительных случаях и он может завершиться неудачно, по причине | |
9888 нехватки шифрованных данных для осуществления статистической атаки, | |
9889 но, с другой стороны, это единственный способ расшифровать DVD, | |
9890 сохраненный на жестский диск, или с неправильным регионом на RPC2 устройстве. | |
9891 .RE | |
9892 .PD 1 | |
9893 . | |
9894 .TP | |
9895 .B DVDCSS_RAW_DEVICE | |
9896 Указывает "сырое"[raw] устройство для использования. | |
9897 Конкретное использование будет зависеть от вашей оперционной системы, | |
9898 в Linux утилитой для настройки "сырых" устройств является raw(8). | |
9899 Заметьте, что на большинстве операционных систем, использование | |
9900 "сырого" устройства требует хорошо выровненных[highly aligned] буферов: | |
9901 Linux требует выравнивания на 2048 байт (что равняется размеру сектора DVD). | |
9902 . | |
9903 .TP | |
9904 .B DVDCSS_VERBOSE | |
9905 Устанавливает уровень подробности сообщений libdvdcss. | |
9906 .PD 0 | |
9907 .RSs | |
9908 .IPs 0 | |
9909 Вообще не выводить сообщения. | |
9910 .IPs 1 | |
9911 Выводить ошибки в stderr. | |
9912 .IPs 2 | |
9913 Выводить ошибки и сообщения отладки в stderr. | |
9914 .RE | |
9915 .PD 1 | |
9916 . | |
9917 .TP | |
9918 .B DVDREAD_NOKEYS | |
9919 Пропустить получение всех ключей при запуске. | |
9920 В данный момент отключено. | |
9921 . | |
9922 .TP | |
9923 .B HOME | |
9924 FIXME: Описать это. | |
9925 . | |
9926 .SS libao2: | |
9927 . | |
9928 .TP | |
9929 .B AO_SUN_DISABLE_SAMPLE_TIMING | |
9930 FIXME: Описать это. | |
9931 . | |
9932 .TP | |
9933 .B AUDIODEV | |
9934 FIXME: Описать это. | |
9935 . | |
9936 .TP | |
9937 .B AUDIOSERVER | |
9938 Указывает Network Audio System сервер к которому драйвер вывода nat | |
9939 должен присоединиться и транспорт,кторый должен быть использован. | |
9940 Если не установлена, вместо нее используется DISPLAY. | |
9941 Транспорт может быть tcp или unix. | |
9942 Синтаксис: tcp/<некий_хост>:<некий_порт>, <некий_хост>:<номер_экземпляра> | |
9943 или [unix]:<номер_экземпляра>. | |
9944 Основной порт NAS - 8000 и <номер_экземпляра> добавляется к нему. | |
9945 .sp 1 | |
9946 .RS | |
9947 .I EXAMPLES: | |
9948 .RE | |
9949 .PD 0 | |
9950 .RSs | |
9951 .IPs AUDIOSERVER=somehost:0 | |
9952 Присоединение к NAS серверу на somehost, используя опрт и транспорт по-умолчанию. | |
9953 .IPs AUDIOSERVER=tcp/somehost:8000 | |
9954 Присоединение к NAS серверу на somehost, слушающему TCP порт 8000. | |
9955 .IPs AUDIOSERVER=(unix)?:0 | |
9956 Присоединения к NAS серверу, экземпляр 0 на localhost используя unix сокеты. | |
9957 .RE | |
9958 .PD 1 | |
9959 . | |
9960 .TP | |
9961 .B DISPLAY | |
9962 FIXME: Описать это. | |
9963 . | |
9964 .SS vidix: | |
9965 . | |
9966 .TP | |
9967 .B VIDIX_CRT | |
9968 FIXME: Описать это. | |
9969 . | |
9970 .SS osdep: | |
9971 . | |
9972 .TP | |
9973 .B TERM | |
9974 FIXME: Описать это. | |
9975 . | |
9976 .SS libvo: | |
9977 . | |
9978 .TP | |
9979 .B DISPLAY | |
9980 FIXME: Описать это. | |
9981 . | |
9982 .TP | |
9983 .B FRAMEBUFFER | |
9984 FIXME: Описать это. | |
9985 . | |
9986 .TP | |
9987 .B HOME | |
9988 FIXME: Описать это. | |
9989 . | |
9990 .SS libmpdemux: | |
9991 . | |
9992 .TP | |
9993 .B HOME | |
9994 FIXME: Описать это. | |
9995 . | |
9996 .TP | |
9997 .B HOMEPATH | |
9998 FIXME: Описать это. | |
9999 . | |
10000 .TP | |
10001 .B http_proxy | |
10002 FIXME: Описать это. | |
10003 . | |
10004 .TP | |
10005 .B LOGNAME | |
10006 FIXME: Описать это. | |
10007 . | |
10008 .TP | |
10009 .B USERPROFILE | |
10010 FIXME: Описать это. | |
10011 . | |
10012 .SS libmpcodecs: | |
10013 . | |
10014 .TP | |
10015 .B XANIM_MOD_DIR | |
10016 FIXME: Описать это. | |
10017 . | |
10018 .SS GUI: | |
10019 . | |
10020 .TP | |
10021 .B CHARSET | |
10022 FIXME: Описать это. | |
10023 . | |
10024 .TP | |
10025 .B DISPLAY | |
10026 FIXME: Описать это. | |
10027 . | |
10028 .TP | |
10029 .B HOME | |
10030 FIXME: Описать это. | |
10031 . | |
10032 .SS libavformat: | |
10033 . | |
10034 .TP | |
10035 .B AUDIO_FLIP_LEFT | |
10036 FIXME: Описать это. | |
10037 . | |
10038 .TP | |
10039 .B BKTR_DEV | |
10040 FIXME: Описать это. | |
10041 . | |
10042 .TP | |
10043 .B BKTR_FORMAT | |
10044 FIXME: Описать это. | |
10045 . | |
10046 .TP | |
10047 .B BKTR_FREQUENCY | |
10048 FIXME: Описать это. | |
10049 . | |
10050 .TP | |
10051 .B http_proxy | |
10052 FIXME: Описать это. | |
10053 . | |
10054 .TP | |
10055 .B no_proxy | |
10056 FIXME: Описать это. | |
10057 . | |
10058 . | |
10059 . | |
10060 .\" -------------------------------------------------------------------------- | |
10061 .\" Файлы | |
10062 .\" -------------------------------------------------------------------------- | |
10063 . | |
10064 .SH ФАЙЛЫ | |
10065 . | |
10066 .TP | |
10067 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf | |
10068 Общесистемные настройки MPlayer | |
10069 . | |
10070 .TP | |
10071 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf | |
10072 Общесистемные настройки MEncoder | |
10073 . | |
10074 .TP | |
10075 ~/.mplayer/\:config | |
10076 Пользовательские настройки MPlayer | |
10077 . | |
10078 .TP | |
10079 ~/.mplayer/\:mencoder.conf | |
10080 Пользовательские настройки MEncoder | |
10081 . | |
10082 .TP | |
10083 ~/.mplayer/\:input.conf | |
10084 Привязки клавиш (смотрите '\-input keylist' для полного списка) | |
10085 . | |
10086 .TP | |
10087 ~/.mplayer/\:gui.conf | |
10088 Файл настройки GUI | |
10089 . | |
10090 .TP | |
10091 ~/.mplayer/\:gui.pl | |
10092 Список воспроизведения GUI | |
10093 . | |
10094 .TP | |
10095 ~/.mplayer/\:font/ | |
10096 Каталог шрифтов (В нем должен находиться файл font.desc и файлы с расширением .RAW) | |
10097 . | |
10098 .TP | |
10099 ~/.mplayer/\:DVDkeys/ | |
10100 Кэшированные ключи CSS | |
10101 . | |
10102 .TP | |
10103 Предполагая, что проигрывается файл /path/\:to/\:movie.avi, MPlayer ищет | |
10104 файлы с субтитрами в следующем порядке: | |
10105 .RS | |
10106 /path/\:to/\:movie.sub | |
10107 .br | |
10108 ~/.mplayer/\:sub/\:movie.sub | |
10109 .RE | |
10110 .PD 1 | |
10111 . | |
10112 . | |
10113 .\" -------------------------------------------------------------------------- | |
10114 .\" Примеры | |
10115 .\" -------------------------------------------------------------------------- | |
10116 . | |
10117 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MPLAYER | |
10118 . | |
10119 .PP | |
10120 .B Быстрый старт проигрывания DVD: | |
10121 .nf | |
10122 mplayer dvd://1 | |
10123 .fi | |
10124 . | |
10125 .PP | |
10126 .B Проиграть DVD на Японском с Английскими субтитрами: | |
10127 .nf | |
10128 mplayer dvd://1 \-alang ja \-slang en | |
10129 .fi | |
10130 . | |
10131 .PP | |
10132 .B Проиграть только эпизоды 5, 6, 7: | |
10133 .nf | |
10134 mplayer dvd://1 \-chapter 5-7 | |
10135 .fi | |
10136 . | |
10137 .PP | |
10138 .B Проиграть только заголовки 5, 6, 7: | |
10139 .nf | |
10140 mplayer dvd://5-7 | |
10141 .fi | |
10142 . | |
10143 .PP | |
10144 .B Проиграть multiangle DVD: | |
10145 .nf | |
10146 mplayer dvd://1 \-dvdangle 2 | |
10147 .fi | |
10148 . | |
10149 .PP | |
10150 .B Проиграть с другого DVD устройства: | |
10151 .nf | |
10152 mplayer dvd://1 \-dvd-device /dev/\:dvd2 | |
10153 .fi | |
10154 . | |
10155 .PP | |
10156 .B Проиграть DVD видео из папки, содержащей VOB файлы: | |
10157 .nf | |
10158 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/ | |
10159 .fi | |
10160 . | |
10161 .PP | |
10162 .B Копировать DVD заголовок на жесткий диск, сохраняя в файл "title1.vob": | |
10163 .nf | |
10164 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob | |
10165 .fi | |
10166 . | |
10167 .PP | |
10168 .B Поток по HTTP: | |
10169 .nf | |
10170 mplayer http://mplayer.hq/example.avi | |
10171 .fi | |
10172 . | |
10173 .PP | |
10174 .B Поток, используя RTSP: | |
10175 .nf | |
10176 mplayer rtsp://server.example.com/streamName | |
10177 .fi | |
10178 . | |
10179 .PP | |
10180 .B Преобразовать субтитры в формат MPsub: | |
10181 .nf | |
10182 mplayer dummy.avi \-sub source.sub \-dumpmpsub | |
10183 .fi | |
10184 . | |
10185 .PP | |
10186 .B Преобразовать субтитры в формат MPsub без просмотра фильма: | |
10187 .nf | |
10188 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub | |
10189 .fi | |
10190 . | |
10191 .PP | |
10192 .B со входа стандартного V4L: | |
10193 .nf | |
10194 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv | |
10195 .fi | |
10196 . | |
10197 .PP | |
10198 .B Проигрывание на картах Zoran (старый способ, устарел): | |
10199 .nf | |
10200 mplayer \-vo zr \-vf scale=352:288 file.avi | |
10201 .fi | |
10202 . | |
10203 .PP | |
10204 .B Проигрывание на картах Zoran (новый способ): | |
10205 .nf | |
10206 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi | |
10207 .fi | |
10208 . | |
10209 .PP | |
10210 .B Проиграть 6-ти канальный AAC файл на двух колонках: | |
10211 .nf | |
10212 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 | |
10213 .fi | |
10214 .br | |
10215 .\" FIXME correct translation? | |
10216 You might want to play a bit with the pan values (e.g multiply with a value) to | |
10217 increase volume or avoid clipping. | |
10218 . | |
10219 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MENCODER | |
10220 . | |
10221 .PP | |
10222 .B Кодировать DVD заголовок #2, только указанные эпизоды: | |
10223 .nf | |
10224 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10225 .fi | |
10226 . | |
10227 .PP | |
10228 .B Кодировать DVD заголовок #2, масштабируя до 640x480: | |
10229 .nf | |
10230 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10231 .fi | |
10232 . | |
10233 .PP | |
10234 .B кодировать DVD заголовок #2, масштабируя до 512xHHH (сохраняя пропорции): | |
10235 .nf | |
10236 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10237 .fi | |
10238 . | |
10239 .PP | |
10240 .B То же, но с битрейтом установленным в 1800kbit и оптимизированными макроблоками: | |
10241 .nf | |
10242 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800 | |
10243 .fi | |
10244 . | |
10245 .PP | |
10246 .B То же, но с MJPEG сжатием: | |
10247 .nf | |
10248 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 | |
10249 .fi | |
10250 . | |
10251 .PP | |
10252 .B Кодировать все *.jpg файлы в текущем каталоге: | |
10253 .nf | |
10254 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10255 .fi | |
10256 . | |
10257 .PP | |
10258 .B Кодировать с тюнера (указывайте формат при помощи \-vf формат): | |
10259 .nf | |
10260 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw | |
10261 .fi | |
10262 . | |
10263 .PP | |
10264 .B Кодировать из канала (pipe): | |
10265 .nf | |
10266 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \- | |
10267 .fi | |
10268 . | |
10269 . | |
10270 .\" -------------------------------------------------------------------------- | |
10271 .\" Ошибки, авторы, стандартное уведомление | |
10272 .\" -------------------------------------------------------------------------- | |
10273 . | |
10274 .SH ОШИБКИ | |
10275 Не паникуйте. | |
10276 Если вы нашли их, сообщите об этом нам, но предварительно убедитесь, что прочли всю документацию. | |
10277 Также ображайте внимание на смайлики. :) | |
10278 Многие ошибки - результат некорректной настройки программы и использования параметров. | |
10279 Раздел документации, посвященный отправке сообщений об ошибках | |
10280 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:bugreports.html) | |
10281 описывает как создать полезный отчет. | |
10282 . | |
10283 . | |
10284 . | |
10285 .SH АВТОРЫ | |
10286 .\" FIXME contributor!=разработчик | |
10287 MPlayer изначально был написан Arpad Gereoffy. | |
10288 Смотрите файл AUTHORS, чтобы получить список некоторых из множества других разработчиков. | |
10289 .PP | |
10290 MPlayer is (C) 2000\-2006 The MPlayer Team | |
10291 .PP | |
10292 Оригинальная английская версия этого руководства в основном была написана Gabucino, | |
10293 Jonas Jermann и Diego Biurrun. Сейчас она поддерживается Diego Biurrun. | |
10294 Первоначальный перевод осуществлен Владимиром Ворошиловым. | |
10295 Пожалуйста, отсылайте электронные письма об оригинальной странице в список рассылки MPlayer-DOCS. | |
10296 Письма, относящиеся к переводу, отсылайте в MPlayer-translations. | |
10297 .\" end of file |