Mercurial > mplayer.hg
annotate DOCS/man/ru/mplayer.1 @ 21021:bc0afb5afa98
help_mp-ru.h sync with r21001
mplayer.1 sync with r21026
author | voroshil |
---|---|
date | Sat, 18 Nov 2006 19:36:28 +0000 |
parents | 5e7183c4d01c |
children | b073c5879396 |
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 | |
21021 | 5 .\" synced with r21026 |
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 Выключает звук. | |
20970 | 244 .IPs "_ (только MPEG-TS)" |
245 Циклически переключает доступные видео дорожки. | |
20707 | 246 .IPs "# (только для MPEG и Matroska)" |
247 Циклически переключает доступные аудио дорожки. | |
21021 | 248 .IPs "TAB (только MPEG-TS)" |
249 Циклически переключает доступные программы. | |
20707 | 250 .IPs "f\ \ \ \ " |
251 Включает полноэкранный режим (смотрите также \-fs). | |
252 .IPs "T\ \ \ \ " | |
253 Включает режим `поверх всех окон` (также смотрите \-ontop). | |
254 .IPs "w и e" | |
255 Уменьшает/\:увеличивает диапазон pan-and-scan. | |
256 .IPs "o\ \ \ \ " | |
257 Изменяет режим OSD: нет / положение / положение + время / положение + время + общее время. | |
258 .IPs "d\ \ \ \ " | |
259 Изменяет режим выбрасывания кадров: нет / пропустить экран / пропустить декодирование | |
260 (смотрите \-framedrop и \-hardframedrop). | |
261 .IPs "v\ \ \ \ " | |
262 Изменяет видимость субтитров. | |
21021 | 263 .IPs "j\ \ \ \ " |
20707 | 264 Циклически меняет доступные субтитры. |
265 .IPs "y и g" | |
266 Перемещение вперед/назад по списку субтитров. | |
267 .IP "F\ \ \ \ " | |
268 Переключает отображения "форсированных субтиров". | |
269 .IPs "a\ \ \ \ " | |
270 Изменяет положение субтитров: верх / центр / низ. | |
271 .IPs "x и z" | |
272 Изменяет задeржку субтитров на +/- 0.1 секунды. | |
273 .IPs "r и t" | |
274 Перемещает субтитры вверх/вниз. | |
275 .IPs "i (только в режиме \-edlout)" | |
276 Устанавливает начало или конец EDL пропуска и записывает его в указанный файл. | |
277 .IPs "s (только для \-vf screenshot)" | |
278 Делает снимок экрана. | |
279 .IPs "I" | |
280 Показывет имя файла на OSD. | |
281 .IPs "! и @" | |
282 Перейти к началу предыдущего/следующего эпизода. | |
21021 | 283 .IPs "D (только \-vo xvmc)" |
284 Активирует/деактивирует деинтерлейсер. | |
20707 | 285 .RE |
286 .PD 1 | |
287 .PP | |
288 .RS | |
289 (Следующие клавиши доступны только при использованиие аппаратно ускоренного видео вывода | |
290 (xv, (x)vidix, (x)mga, и т.д.), программного эквалайзера | |
291 (\-vf eq или \-vf eq2) или фильтра hue (\-vf hue). | |
292 .RE | |
293 .PP | |
294 .PD 0 | |
295 .RS | |
296 .IPs "1 и 2" | |
297 Настраивает контрастность. | |
298 .IPs "3 и 4" | |
299 Настраивает яркость. | |
300 .IPs "5 и 6" | |
301 Настраивает цветность. | |
302 .IPs "7 и 8" | |
303 Настраивает насыщенность. | |
304 .RE | |
305 .PD 1 | |
306 .PP | |
307 .RS | |
308 (Следующие клавиши доступны только при использовании видео драйверов quartz или macosx). | |
309 .RE | |
310 .PP | |
311 .PD 0 | |
312 .RS | |
313 .IPs "command + 0" | |
314 Изменяет размер окна до половины оригинального размера. | |
315 .IPs "command + 1" | |
316 Изменяет размер окна до оригинального. | |
317 .IPs "command + 2" | |
318 Устанавливает размер окна в два раза больше оригинального. | |
319 .IPs "command + f" | |
320 Переключает полноэканный режим (также смотрите \-fs). | |
321 .IPs "command + [ и command + ]" | |
322 Установливает прозрачность окна воспроизведения. | |
323 .RE | |
324 .PD 1 | |
325 .PP | |
326 .RS | |
327 (Следующие клавиши работают только при использовании клавиатуры с мультимедиа клавишами.) | |
328 .RE | |
329 .PP | |
330 .PD 0 | |
331 .RS | |
332 .IPs PAUSE | |
333 Пауза. | |
334 .IPs "STOP\ " | |
335 Остановить воспроизведение и выйти. | |
336 .IPs "PREVIOUS и NEXT" | |
337 Перемотать назад/\:вперед на 1 минуту. | |
338 .RE | |
339 .PD 1 | |
340 .PP | |
341 .RS | |
342 (Следующие клавиши работают только если MPlayer собран с поддержкой GUI и имеют | |
343 преимущество перед описанными выше клавишами.) | |
344 .RE | |
345 .PP | |
346 .PD 0 | |
347 .RS | |
348 .IPs ENTER | |
349 Начать воспроизведение. | |
350 .IPs "ESC\ \ " | |
351 Остановить воспроизведение. | |
352 .IPs "l\ \ \ \ " | |
353 Открыть файл. | |
354 .IPs "t\ \ \ \ " | |
355 Открыть субтитры. | |
356 .IPs "c\ \ \ \ " | |
357 Открыть браузер скинов. | |
358 .IPs "p\ \ \ \ " | |
359 Открыть список воспроизведения. | |
360 .IPs "r\ \ \ \ " | |
361 Открыть настройки. | |
362 .RE | |
363 .PD 1 | |
364 .PP | |
365 .RS | |
366 (Следуюшие комбинации клавиш работают, если MPlayer собран с поддержкой TV и имеют | |
367 преимущество перед описанными выше клавишами.) | |
368 .RE | |
369 .PP | |
370 .PD 0 | |
371 .RS | |
372 .IPs "h и k" | |
373 Выбрать предыдущий/\:следующий канал. | |
374 .IPs "n\ \ \ \ " | |
375 Выбрать стандарт вещания. | |
376 .IPs "u\ \ \ \ " | |
377 Выбрать таблицу каналов. | |
378 .RE | |
379 .PD 1 | |
380 . | |
381 .TP | |
382 .B управление мышью | |
383 .PD 0 | |
384 .RS | |
385 .IPs "button 3 и button 4" | |
386 Перемотка назад/\:вперед на 1 минуту. | |
387 .IPs "button 5 и button 6" | |
388 Уменьшает/\:увеличивает громкость. | |
389 .RE | |
390 .PD 1 | |
391 . | |
392 .TP | |
393 .B управление джойстиком | |
394 .PD 0 | |
395 .RS | |
396 .IPs "влево и вправо" | |
397 Перемотка назад/\:вперед на 10 секунд. | |
398 .IPs "up и down" | |
399 Перемотка назад/\:вперед на 1 минуту. | |
400 .IPs "button 1" | |
401 Пауза | |
402 .IPs "button 2" | |
403 Переключает режимы OSD: скрыто / положение / положение + время / положение + время + общее время. | |
404 .IPs "button 3 и button 4" | |
405 Уменьшить/\:увеличить громкость. | |
406 .RE | |
407 .PD 1 | |
408 . | |
409 . | |
410 .\" -------------------------------------------------------------------------- | |
411 .\" Использование | |
412 .\" -------------------------------------------------------------------------- | |
413 . | |
414 .SH "ИСПОЛЬЗОВАНИЕ" | |
415 Каждая опция 'flag' имеет противоположную по смыслу опцию 'noflag', например противоположные | |
416 по смыслу опции \-fs и \-nofs. | |
417 .PP | |
418 Если опции помечена как (только XXX), то она будет работать только в комбинации с опцией XXX, | |
419 если включена поддержка опции XXX. | |
420 .PP | |
421 .I ЗАМЕЧАНИЕ: | |
422 Разборщик подопций (используется, например, для \-ao pcm подопций) поддерживает | |
423 специальную формы выделения строк для использования со сторонними GUI. | |
424 .br | |
425 Она имеет следующий формат: | |
426 .br | |
427 %n%строка_длины_n | |
428 .br | |
429 .I ПРИМЕРЫ: | |
430 .br | |
431 mplayer \-ao pcm:file=%10%C:test.wav test.avi | |
432 .br | |
433 Или в программе: | |
434 .br | |
435 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi | |
436 .PP | |
437 . | |
438 .\" -------------------------------------------------------------------------- | |
439 .\" Файлы конфигурации | |
440 .\" -------------------------------------------------------------------------- | |
441 . | |
442 .SH "ФАЙЛЫ КОНФИГУРАЦИИ" | |
443 Вы можете поместить все опции в конфигурационные файлы, которые MPlayer/\:MEncoder | |
444 будет считывать при каждом запуске. | |
445 Системный файл конфигурации 'mplayer.conf' находится в системном каталоге конфигурации | |
446 (например /etc/\:mplayer или /usr/\:local/\:etc/\:mplayer), пользовательский - это | |
447 '~/\:.mplayer/\:config'. | |
448 Конфигурационный файл для MEncoder называется 'mencoder.conf' и находится в системном каталоге | |
449 (например /etc/\:mplayer или /usr/\:local/\:etc/\:mplayer), пользовательский - | |
450 '~/\:.mplayer/\:mencoder.conf. | |
451 Опции в пользовательском файле перекрывают системные, а опции командной строки перекрывают | |
452 заданные в конфигурационных файлах. | |
453 Синтаксис конфигурационного файла: 'option=<значение>', все символы после '#' считаются | |
454 комментарием. | |
455 Опции, не имеющие значений, могут быть включены присваиванием им значения 'yes','1' или 'true' и | |
456 выключены присваиванием 'no','0' или 'false'. | |
457 Подопции также могут быть заданы этим способом. | |
458 .PP | |
459 Вы можете задавать опции индивидуально для каждого файла. Если вы хотите иметь файл | |
460 конфигурации для 'movie.avi', создайте конфигурационный файл с именем 'movie.avi.conf' | |
461 и поместите его в ~/.mplayer/. Вы также можете поместить файл конфигурации в каталог с | |
462 проигрываемым файлом, при условии что указали опцию \-use\-filedir\-conf (либо в | |
463 командной строке, либо в глобальном файле конфигурации. | |
464 .PP | |
465 .I ПРИМЕР КОНФИГУРАЦИОННОГО ФАЙЛА MPLAYER: | |
466 .sp 1 | |
467 .nf | |
468 # Use Matrox driver by default. | |
469 vo=xmga | |
470 # I love practicing handstands while watching videos. | |
471 flip=yes | |
472 # Decode/encode multiple files from PNG, | |
473 # start with mf://filemask | |
474 mf=type=png:fps=25 | |
475 # Eerie negative images are cool. | |
476 vf=eq2=1.0:-0.8 | |
477 .fi | |
478 .PP | |
479 .I "ПРИМЕР КОНФИГУРАЦИОННОГО ФАЙЛА MENCODER:" | |
480 .sp 1 | |
481 .nf | |
482 # Make MEncoder output to a default filename. | |
483 o=encoded.avi | |
484 # The next 4 lines allow mencoder tv:// to start capturing immediately. | |
485 oac=pcm=yes | |
486 ovc=lavc=yes | |
487 lavcopts=vcodec=mjpeg | |
488 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000 | |
489 # more complex default encoding option set | |
490 lavcopts=vcodec=mpeg4:autoaspect=1 | |
491 lameopts=aq=2:vbr=4 | |
492 ovc=lavc=1 | |
493 oac=lavc=1 | |
494 passlogfile=pass1stats.log | |
495 noautoexpand=1 | |
496 subfont-autoscale=3 | |
497 subfont-osd-scale=6 | |
498 subfont-text-scale=4 | |
499 subalign=2 | |
500 subpos=96 | |
501 spuaa=20 | |
502 .fi | |
503 . | |
504 .\" -------------------------------------------------------------------------- | |
505 .\" Профили | |
506 .\" -------------------------------------------------------------------------- | |
507 . | |
508 .SH "ПРОФИЛИ" | |
509 Для облегчения работы с различными конфигурациями в конфигурационном файле могут быть | |
510 указаны несколько профилей. | |
511 Профиль начинается с имени, залюченного в квадратные скобки, например '[my-profile]'. | |
512 Все последующие опции будут считаться частью профиля. | |
513 Описание (отображаемое при помощи \-profile help) может быть задано опцией profile\-desc. | |
514 Для окончания профиля укажите имя другого профиля или используйте имя профиля 'default', | |
515 чтобы продолжить описание обычных опций. | |
516 .fi | |
517 .PP | |
518 .I "ПРИМЕР ПРОФИЛЯ MENCODER:" | |
519 .sp 1 | |
520 .nf | |
521 | |
522 [mpeg4] | |
523 profile-desc="MPEG4 encoding" | |
524 ovc=lacv=yes | |
525 lavcopts=vcodec=mpeg4:vbitrate=1200 | |
526 | |
527 [mpeg4-hq] | |
528 profile-desc="HQ MPEG4 encoding" | |
529 profile=mpeg4 | |
530 lavcopts=mbd=2:trell=yes:v4mv=yes | |
531 .fi | |
532 . | |
533 .\" -------------------------------------------------------------------------- | |
534 .\" Опции | |
535 .\" -------------------------------------------------------------------------- | |
536 . | |
537 .SH "ОСНОВНЫЕ ОПЦИИ" | |
538 . | |
539 .TP | |
540 .B \-codecs-file <имя файла> (смотрите также \-afm, \-ac, \-vfm, \-vc) | |
541 Переопределяет стандартный путь поиска и предписывает использовать указанный файл | |
542 вместо встроенного codecs.conf. | |
543 . | |
544 .TP | |
545 .B \-include <файл конфигурации> | |
546 Указывает файл конфигурации, который будет прочитан после анализа файла, используемого | |
547 по-умолчанию. | |
548 . | |
549 .TP | |
550 .B \-list-options | |
551 Печатает все доступные опции. | |
552 . | |
553 .TP | |
554 .B \-msgcharset <кодировка> | |
555 Преобразование сообщений консоли в указанную кодировку (по-умолчанию: автоопределение). | |
556 Текст будет в кодировке, заданной \-\-charset опцией configure. | |
557 Установите ее в "noconv" для отключения перекодировки (например при проблеме с iconv). | |
558 .br | |
559 .I ЗАМЕЧАНИЕ: | |
560 Опция вступает в силу после окончания анализа опций командной строки. | |
561 Переменная окружения MPLAYER_CHARSET модет помочь если выводится мусор в первых строках. | |
562 . | |
563 .TP | |
564 .B \-msglevel <all=<уровень>:<модуль>=<уровень>:...> | |
565 Управляет подробность вывода непосредственно для каждого модуля. | |
566 Значение, указанное для модуля 'all', изменяет подробность вывода для всех модулей, которым | |
567 параметр не задан явно. | |
568 Смотрите '\-msglevel help' для списка модулей. | |
569 .br | |
570 .I ЗАМЕЧАНИЕ: | |
571 Сообщения печатаемые до конца анализа командной строки могут контролироваться переменной | |
572 окружения MPLAYER_VERBOSE, котороая применяется ко всем модулям. | |
573 .br | |
574 Доступные уровни: | |
575 .PD 0 | |
576 .RSs | |
577 .IPs "-1" | |
578 отсутствие сообщений | |
579 .IPs " 0" | |
580 только фатальные ошибки | |
581 .IPs " 1" | |
582 ошибки | |
583 .IPs " 2" | |
584 предупреждения | |
585 .IPs " 3" | |
586 короткие подсказки | |
587 .IPs " 4" | |
588 информационные сообщения | |
589 .IPs " 5" | |
590 статусные сообщения (которые скрываются при помощи \-quiet) | |
591 .IPs " 6" | |
592 подробные сообщения | |
593 .IPs " 7" | |
594 уровень отладки 2 | |
595 .IPs " 8" | |
596 уровень отладки 3 | |
597 .IPs " 9" | |
598 уровень отладки 4 | |
599 .RE | |
600 .PD 1 | |
601 . | |
602 .TP | |
603 .B "\-quiet\ " | |
604 Делает консольный вывод менее подробным; в частности, прячет статусную строку | |
605 т.е.\& A: 0.7 V: 0.6 A-V: 0.068 ...). | |
606 Может быть полезно на медленных или неполноценных терминалах, которые некорректно обрабатывают | |
607 возврат каретки (т.е.\& \\r). | |
608 . | |
609 .TP | |
610 .B \-priority <prio> (только Windows) | |
611 Установить приоритет процесса MPlayer в соответствии с предопределенными приоритетами, доступными | |
612 под Windows. | |
613 Допустимые значения <prio>: | |
614 .RSs | |
615 idle|belownormal|normal|abovenormal|high|realtime | |
616 .RE | |
617 .sp 1 | |
618 .RS | |
619 .I ВНИМАНИЕ: | |
620 Использование приоритета realtime может привести к зависанию системы. | |
621 .RE | |
622 . | |
623 .TP | |
624 .B \-profile <профиль1,профиль2,...> | |
625 Предписывает использовать указанный профиль(и), \-profile help отображает список определенных | |
626 профилей. | |
627 . | |
628 .TP | |
629 .B \-really-quiet (смотрите также \-quiet) | |
630 Указывает отображать еще меньше сообщений, чем при использовании \-quiet. | |
631 . | |
632 .TP | |
633 .B \-show-profile <профиль> | |
634 Отображает описание и содержимое профиля. | |
635 . | |
636 .TP | |
637 .B \-use-filedir-conf | |
638 Ищет индивидуальный файл конфигурации фильма в каталоге из которого | |
639 фильм проигрывается. | |
640 .br | |
641 .I ВНИМАНИЕ: | |
642 Это может быть опасно при воспроизведении из источников, которым вы не доверяете. | |
643 . | |
644 .TP | |
645 .B "\-v\ \ \ \ \ " | |
646 Увеличитает подробность вывода на один уровень для каждой указанной \-v в командной строке. | |
647 . | |
648 . | |
649 . | |
650 .SH "ОПЦИИ ПРОИГРЫВАТЕЛЯ (ТОЛЬКО MPLAYER)" | |
651 . | |
652 .TP | |
653 .B \-autoq <качество> (используйте с \-vf [s]pp) | |
654 Динамически меняет уровень постобработки в зависимости от загруженности CPU. | |
655 Число, указанное вами, будет максимальным используемым уровнем. | |
656 Обычно можно использовать некоторое большое число. | |
657 Вы должны использовать \-vf [s]pp без параметров, чтобы это работало. | |
658 . | |
659 .TP | |
660 .B \-autosync <factor> | |
661 Постепенно подстраивает A/V синхронизацию на основе измерений задержки аудио. | |
662 Указание \-autosync 0 (по-умолчанию) указывает, что тайминг кадров будет основываться | |
663 исключительно на измерениях задержки аудио. | |
664 Указание \-autosync 1 делает то же самое, но внутренне меняет алгоритм A/V коррекции. | |
665 При непостоянности частоты кадров в фильме, прекрасно воспроизводящемся с опцией | |
666 \-nosound, обычно помогает установка этой опции в значения большие 1. | |
667 Чем выше значение, тем ближе к \-nosound будет тайминг. | |
668 Попробуйте \-autosync 30, чтобы смягчить проблемы со звуковыми драйверами, | |
669 которые не реализуют хорошего измерения задержки аудио. | |
670 С этим значением, если происходит большое расхождение A/V синхронизации, потребуется | |
671 около 1 или 2 секунд для исправления проблемы. | |
672 Задержка во времени реакции на внезапные сдвиги A/V должна быть | |
673 единственным побочным эффектом включения этой опции для всех звуковых драйверов. | |
674 . | |
675 .TP | |
676 .B \-benchmark | |
677 Выводит некоторую статистику об использовании CPU и пропущенных кадрах в | |
678 конце воспроизведения. Используйте в комбинации с \-nosound и \-vo null для | |
679 измерения производительности исключительно видео кодека. | |
680 .br | |
681 .I ЗАМЕЧАНИЕ: | |
682 С этой опцией MPlayer будет игнорировать продолжительность кадров при | |
683 проигрывании только видео (можете думать об этом, как о бесконечном fps). | |
684 . | |
685 .TP | |
686 .B \-colorkey <число> | |
687 Изменяет colorkey на указанное вами RGB значение. | |
688 0x000000 это черный, а 0xffffff \- белый. | |
689 Поддерживается только для cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix, | |
690 xover, xv (смотри \-vo xv:ck), xvmc (смотри \-vo xv:ck) и directx драйверами вывода. | |
691 . | |
692 .TP | |
693 .B \-nocolorkey | |
694 Отлючает механизм colorkey. | |
695 Поддерживается только cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix, | |
696 xover, xv (смотри \-vo xv:ck), xvmc (смотри \-vo xv:ck) и directx драйверами вывода. | |
697 . | |
698 .TP | |
699 .B \-correct-pts (экспериментальное) | |
700 Переключает MPlayer в экспериментальный режим, в котором тайминг | |
701 видео кадров рассчитываются независимо, и тем самым поддерживаются видео фильтры, | |
702 добавляющие новые кадры или меняющие тайминг существующих. | |
703 Более точный тайминг может быть заметен, например, при воспроизведении с опцией \-ass | |
704 субтитров, привязанных к смене сцены, | |
705 .\" FIXME is translation correct ? | |
706 .\" Without \-correct-pts the subtitle timing will typically be off by some frames. | |
707 Без \-correct-pts тайминг субтитров, как правило, будет отключен некоторыми кадрами. | |
708 С некоторыми демуксерами и кодеками эта опция работает некоректно. | |
709 | |
710 . | |
711 .TP | |
712 .B \-crash-debug (КОД ОТЛАДКИ) | |
713 Автоматически запускает gdb в случае краха или SIGTRAP. | |
714 Поддержка дожна быть скомпилирована при помощи опции \-\-enable\-crash\-debug. | |
715 . | |
716 .TP | |
717 .B \-edlout <файл> | |
718 Создает новый файл и выводит в него записи списка решений редактирования (EDL). | |
719 При воспроизведении, пользователь нажимает 'i', чтобы отметить начало и конец | |
720 пропускаемого блока. Это создает основу для последующей тонкой настройки | |
721 эдементов EDL. Подробности смотрите на | |
722 http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:edl.html. | |
723 . | |
724 .TP | |
725 .B \-enqueue (только GUI) | |
726 Добавляет файлы, указанные в командной строке, в список воспроизведения вместо | |
727 немедленного их проигрывания. | |
728 . | |
729 .TP | |
730 .B \-fixed-vo | |
731 Принуждает использовать фиксированнцю систему видео для многих файлов | |
732 (одна (де)инициализация для всех файлов). | |
733 Тпким образом для всех файлов будет открыто только одно окно. | |
734 Н данный момент следующие драйвера поддерживают fixed-vo: gl, gl2, mga, svga, x11, | |
735 xmga, xv, xvidix и dfbmga. | |
736 . | |
737 .TP | |
738 .B \-framedrop (смотрите также \-hardframedrop) | |
739 Указываеть пропускать отображение некоторых кадров для управления A/V синхронизацией на | |
740 медленных системах. Видео фильтры не применяются для таких кадров. Для В-кадров | |
741 не выполняется даже декодирование. | |
742 . | |
743 .TP | |
744 .B \-(no)gui | |
745 Включает или выключает GUI интерфейс (значение по-умолчанию зависит от имени исполняемого | |
746 файла). Работает только как первый параметр командной строки. Не работает в | |
747 файле конфигурации. | |
748 . | |
749 .TP | |
750 .B \-h, \-help, \-\-help | |
751 Показывает краткую информацию об опциях. | |
752 . | |
753 .TP | |
754 .B \-hardframedrop | |
755 Более интенсивный пропуск кадров (нарушает декодирование). | |
756 Ведет к искажению изображения! | |
757 . | |
758 .TP | |
759 .B \-identify | |
760 Краткая форма для \-msglevel identify=4 | |
761 Показывает параметры файлов в удобном для анализа формате. | |
762 Также печатает более подробную информацию о субтитрах, языках и идентификаторах | |
763 аудио дорожек. В некоторых случаях вы можете получить больше информации, используя | |
764 \-msglevel identify=6. | |
765 Для DVD, например, это отобразит длину каждого заголовка и ID диска. | |
766 Скрипт TOOLS/\:midentify подавляет остальной вывод MPlayer и (успешно) экранирует | |
767 имена файлов. | |
768 . | |
769 .TP | |
770 .B \-idle (смотрите также \-slave) | |
771 Если не осталось больше файлов для воспроизведения, MPlayer будет ждать вместо | |
772 завершения работы. Весьма полезно при запуске в подчиненном режиме, когда MPlayer | |
773 управляется через команды. | |
774 . | |
775 .TP | |
776 .B \-input <команды> | |
777 Эта опция может использоваться для настройки некоторых параметроа системы ввода. | |
778 Пути указываются относительно к ~/.mplayer/. | |
779 .br | |
780 .I ЗАМЕЧАНИЕ: | |
781 Автоповтор в данный момент поддерживается только для джойстиков. | |
782 .sp 1 | |
783 Доступные команды: | |
784 .sp 1 | |
785 .PD 0 | |
786 .RSs | |
787 .IPs conf=<имя_файла> | |
788 Указывает файл конфигурации системы ввода, отличный от установленного по-умолчанию | |
789 ~/\:.mplayer/\:input.conf. | |
790 ~/\:.mplayer/\:<имя_файла> подразумевается, если не указан полный путь. | |
791 .IPs ar-delay | |
792 Задержка в миллисекундах перед началом автоповтора (0 для отключения). | |
793 .IPs ar-rate | |
794 Количество клавиш в секунду, генерируемых при автоповторе. | |
795 .IPs keylist | |
796 Выводит все клавиши, которые можно назначить командам. | |
797 .IPs cmdlist | |
798 выводит все команды, которые можно назначить клавишам. | |
799 .IPs js-dev | |
800 Указвает какое устройство использовать в качестве джойстика (по-умрочанию: /dev/\:input/\:js0). | |
801 .IPs file=<filename> | |
802 Указывает читать команды из файла. Используется для работы с FIFO. | |
803 .br | |
804 .I ЗАМЕЧАНИЕ: | |
805 Если указанный файл является FIFO, MPlayer открывает обе стороны, позволяя вам | |
806 выполнить несколько 'echo "seek 10" > mp_pipe', оставляя канал рабочим. | |
807 .RE | |
808 .PD 1 | |
809 . | |
810 .TP | |
811 .B \-key-fifo-size <2\-65000> | |
812 Указывает размер FIFO, буферизуюшей события клавиатуры (по-умолчанию: 10). | |
813 FIFO размера n может буферизовать (n-1) событие. | |
814 Если это значение мало, некоторые события могут быть потеряны | |
815 (что приводит к "залипанию кнопок мыши" и похожим эффектам). | |
816 Если оно велико, MPlayer может выглядеть зависшим во время обработки буферизованных | |
817 событий. Чтобы обеспечить поведение программы по-умолчанию, установите | |
818 значение в 2 для Linux или 1024 для Windows. | |
819 . | |
820 .TP | |
821 .B \-lircconf <имя_файла> (только LIRC) | |
822 Указывает файл конфигурации для LIRC (по-умолчанию: ~/.lircrc). | |
823 . | |
824 .TP | |
825 .B \-list-properties | |
826 Печатает список доступных свойств. | |
827 . | |
828 .TP | |
829 .B \-loop <число> | |
830 Проигрывает фильм указанное число раз подряд. 0 \- значит бесконечно. | |
831 . | |
832 .TP | |
833 .B \-menu (только OSD меню) | |
834 Включает поддержку OSD меню. | |
835 . | |
836 .TP | |
837 .B \-menu-cfg <имя_файла> (только OSD меню) | |
838 Указывает использовать другой файл вместо menu.conf. | |
839 . | |
840 .TP | |
841 .B \-menu-root <значение> (только OSD меню) | |
842 Указывает основное меню. | |
843 . | |
844 .TP | |
845 .B \-menu-startup (только OSD меню) | |
846 Показывает основное меню при запуске MPlayer. | |
847 . | |
848 .TP | |
849 .B \-mouse-movements | |
850 Позволяет MPlayer получать события указателя мыши, генерируемые | |
851 драйвером вывода видео (в данный момент поддерживаются только производные X11). | |
852 Необходимо для выбора кнопок в DVD меню. | |
853 . | |
854 .TP | |
855 .B \-noconsolecontrols | |
856 Не допускает чтение событий клавиатуры со стандартного входа программой MPlayer. | |
857 Полезно при чтении данных со стандартного входа. | |
858 Включается автоматичество, если в командной строке найдено \-. | |
859 Есть ситуации, когда нужно установить это вручную, например | |
860 если вы открываете /dev/\:stdin (или аналогичный в вашей системе), используете stdin | |
861 в списке воспроизведения или собираетесь читать из stdin позже командами loadfile или | |
862 loadlist. | |
863 . | |
864 .TP | |
865 .B \-nojoystick | |
866 Отключает поддержку джойстика. | |
867 . | |
868 .TP | |
869 .B \-nolirc | |
870 Отключает поддержку LIRC. | |
871 . | |
872 .TP | |
873 .B \-nomouseinput (только X11) | |
874 Отключает события нажатия/\:отпускания кнопок мыши (контекстное меню | |
875 mozplayerxp полагается на эту опцию). | |
876 . | |
877 .TP | |
878 .B \-rtc (только RTC) | |
879 Включает использование Linux RTC (часов реального времени - /dev/\:rtc) как механизма | |
880 синхронизации. | |
881 Это приводит к пробуждению процессс каждую 1/1024 секунды для проверки текущего времени. | |
882 Бесполезно с современныеми ядрами Linux, настроенными для десктопа, поскольку | |
883 они уже пробуждают процесс со сравнимой точностью при использовании обычного | |
884 способа засыпания. | |
885 . | |
886 .TP | |
887 .B \-playing-msg <строка> | |
888 Выводит строку перед началом воспроизведенияю | |
889 Поддерживаются следующие расширения: | |
890 .RSs | |
891 .IPs ${NAME} | |
892 Заменяется на значение свойства NAME. | |
893 .IPs $(NAME:TEXT) | |
894 Заменяется на TEXT только если доступно свойство NAME. | |
895 .RE | |
896 . | |
897 .TP | |
898 .B \-playlist <имя_файла> | |
899 Воспроизводит файлы в соответствии со списком (ASX, Winamp, SMIL, или | |
900 по-одному-файлу-в-строке формата). | |
901 .br | |
902 .I ЗАМЕЧАНИЕ: | |
903 Опция считается элементом, так что все последующие опции будут применяться только к | |
904 элементам списка воспроизведения. | |
905 .br | |
906 FIXME: Это требует тщательного разъяснения и описания. | |
907 . | |
908 .TP | |
909 .B \-rtc-device <устройство> | |
910 Указывает использовать указанное устройство для RTC тайминга. | |
911 . | |
912 .TP | |
913 .B \-shuffle | |
914 Проигрывает файлы в случайном порядке. | |
915 . | |
916 .TP | |
917 .B \-skin <название> (только GUI) | |
918 Загружает скин из каталога, указанного в качестве параметра, находящегося | |
919 в одном из стандартных каталогов со скинами, | |
920 /usr/\:local/\:share/\:mplayer/\:skins/\: и ~/.mplayer/\:skins/. | |
921 .sp 1 | |
922 .I ПРИМЕР: | |
923 .PD 0 | |
924 .RSs | |
925 .IPs "\-skin fittyfene" | |
926 Пробуется /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene | |
927 и затем ~/.mplayer/\:skins/\:fittyfene. | |
928 .RE | |
929 .PD 1 | |
930 . | |
931 .TP | |
932 .B \-slave (смотрите также \-input) | |
933 Включает "рабский" режим, в котором MPlayer работает в качестве бэкэнда к другим программам. | |
934 Вместо перехвата событий клавиатуры, MPlayer будет читать со стандартного входа команды, | |
935 разделенные символом новой строки (\\n). | |
936 .br | |
937 .I ЗАМЕЧАНИЕ: | |
938 Смотрите список этох команд в \-input cmdlist и описания в DOCS/tech/slave.txt. | |
939 . | |
940 .TP | |
941 .B \-softsleep | |
942 .\" FIXME is translation correct? | |
943 .\" Time frames by repeatedly checking the current time instead of asking the | |
944 Устанавливает тайминг кадров, постоянно проверяя текущее время, вместо просьбы | |
945 ядру пробуждать MPlayer в нужный момент. | |
946 Полезно, если таймер вашего ядра неточен и вы не можете использовать RTC. | |
947 Дается ценой повышенной нагрузки на CPU. | |
948 . | |
949 .TP | |
950 .B \-sstep <сек> | |
951 Пропускать <сек> секунд после каждого кадра. | |
952 Сохраняется оригинальная частота кадров, так что вопроизведение ускоряется. | |
953 Т.к. MPlayer может перемещаться только по ключевым кадрам, то значение | |
954 может оказаться неточным. | |
955 . | |
956 . | |
957 . | |
958 .SH "ОПЦИИ ДЕМУКСЕРА/ПОТОКА" | |
959 . | |
960 .TP | |
961 .B \-a52drc <уровень> | |
962 .\" нужен ли перевод DRC ? | |
963 Выбирает уровень Dynamic Range Compression[Сжатие Динамического Диапазона] для | |
964 аудио потоков AC3. <уровень> - это вещественное число от 0 до 1, где 0 означает | |
965 отсутствие сжатия, а 1 (по-умолчанию) означает полное сжатие (делает громкие звуки | |
966 более тихими и наоборот). | |
967 Эта опция действует, только если AC3 поток содержит необходимую информацию | |
968 сжатия диапазона. | |
969 . | |
970 .TP | |
971 .B \-aid <ID> (смотрите также \-alang) | |
972 Выбирает аудио канал (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127, | |
973 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190). | |
974 MPlayer выводит все доступные аудио ID, когда запущен в режиме | |
975 побробного вывода сообщений (\-v). | |
976 При воспроизведении MPEG-TS потока, MPlayer/\:MEncoder будет использовать | |
977 первую программу (если существует) с выбранным аудио потоком. | |
978 . | |
979 .TP | |
980 .B \-alang <код языка[,код языка,...]> (смотрите также \-aid) | |
981 Указывает список используемых языков в порядке приоритетности. | |
982 Различные форматы файлов используют различные коды языков. | |
983 DVD используют ISO 639-1 двухбуквенные коды, Matroska и NUT используют ISO 639-2 | |
984 трехбуквенные коды языков, в то время как OGM использует идентификаторы в свободной форме. | |
985 MPlayer выводит доступные языки, когда запущен в режиме вывода подробных сообщений (\-v). | |
986 .sp 1 | |
987 .I ПРИМЕР: | |
988 .PD 0 | |
989 .RSs | |
990 .IPs "mplayer dvd://1 \-alang hu,en" | |
991 Выбирает Венгерскую языковую дорожку на DVD и возвращается обратно к Аглийскому, если | |
992 Венгерский недоступен. | |
993 .IPs "mplayer \-alang jpn example.mkv" | |
994 Воспроизводит файл Matroska на Японском. | |
995 .RE | |
996 .PD 1 | |
997 . | |
998 .TP | |
999 .B \-audio-demuxer <[+]name> (только \-audiofile) | |
1000 Принудительно устанавливает тип демуксера для \-audiofile. | |
1001 Используйте '+' перед именем для принудительного выбора, это пропустит некоторые проверки! | |
1002 Передайте название демуксера таким, каким оно выводится опцией \-audio-demuxer help. | |
1003 Для обратной совместимости эта опция также принимает ID демуксера, указанный в | |
1004 libmpdemux/\:demuxer.h. | |
1005 \-audio-demuxer audio или \-audio-demuxer 17 принудительно устанавливает MP3. | |
1006 . | |
1007 .TP | |
1008 .B \-audiofile <имя файла> | |
1009 Воспроизводит аудио из внешнего файла (WAV, MP3 или Ogg Vorbis) при просмотре фильма. | |
1010 . | |
1011 .TP | |
1012 .B \-audiofile-cache <кБайт> | |
1013 Включает кеширование файла, указанного опцией \-audiofile, используя указанное количество | |
1014 памяти. | |
1015 . | |
1016 .TP | |
1017 .B \-bandwidth <значение> (только сеть) | |
1018 Указывает максимальную пропускную способность для сетевого вещания (для | |
1019 серверов, способных отдавать контент с различным битпотоком). | |
1020 Полезно, если вы хотите смотреть потоковую трансляцию при медленном соединении. | |
1021 При Real RTSP вещании, она также используется для установки максимальной | |
1022 пропускной способности для получения потока, позволяя быстрее заполнять кеш | |
1023 и сохранять поток. | |
1024 . | |
1025 .TP | |
1026 .B \-cache <килобайт> | |
1027 Эта опция указывает какое количество памяти (в килобайтах) использовать при | |
1028 предварительном кешировании файла или URL. | |
1029 Особенно полезно на медленных носителях. | |
1030 . | |
1031 .TP | |
1032 .B \-nocache | |
1033 Отключает кеширование. | |
1034 . | |
1035 .TP | |
1036 .B \-cache-min <процент> | |
1037 Воспроизведение начнется, когда кеш будет заполнен на <процент> процентов | |
1038 от полного размера. | |
1039 . | |
1040 .TP | |
1041 .B \-cache-seek-min <процент> | |
1042 Если производится попытка перемотать фильм на позицию в пределах | |
1043 величины <процент> от размера кеша, MPlayer будет ждать заполнения кеша до | |
1044 этой позиции вместо осуществления перемещения по потоку (по-умолчанию: 50). | |
1045 . | |
1046 .TP | |
1047 .B \-cdda <опция1:опция2> (только CDDA) | |
1048 Эта опция может использоваться для тонкой настройки возможности чтения CD Audio. | |
1049 .sp 1 | |
1050 Доступные опции: | |
1051 .RSs | |
1052 .IPs speed=<значение> | |
1053 Устанавливает скорость вращения CD. | |
1054 .IPs paranoia=<0\-2> | |
1055 Устанавливает уровень paranoia. | |
1056 Значения, отличные от нуля, похоже нарушают воспроизведение всего, кроме первой дорожки. | |
1057 .RSss | |
1058 0: отключает проверку (по-умолчанию) | |
1059 .br | |
1060 1: проверка только наложения | |
1061 .br | |
1062 2: полная коррекция и проверка данных | |
1063 .REss | |
1064 .IPs generic-dev=<значение> | |
1065 Указывает использовать указанное SCSI устройство. | |
1066 .IPs sector-size=<значение> | |
1067 Устанавливает атомарный размер чтения. | |
1068 .IPs overlap=<значение> | |
1069 Принудительно устанавливает минимальный поиск перекрытия в <значение> | |
1070 секторов. | |
1071 .IPs toc-bias | |
1072 Указывает предполагать, что смещение начала дорожки 1, указанной в TOC, | |
1073 адресуется как LBA 0. | |
1074 Это требуется для некоторых устройств Toshiba, чтобы стали правильными | |
1075 границы дорожек. | |
1076 .IPs toc-offset=<значение> | |
1077 Добавляет <значение> секторов к значению, выдаваемому при адресаци дорожек. | |
1078 Может быть отрицательным. | |
1079 .IPs (no)skip | |
1080 (Никогда не) допускает неполную реконструкию данных. | |
1081 .RE | |
1082 . | |
1083 .TP | |
1084 .B \-cdrom-device <путь к устройству> | |
1085 Указывает устройство CD-ROM (по-умолчанию: /dev/\:cdrom). | |
1086 . | |
1087 .TP | |
1088 .B \-channels <число> (смотрите также \-af channels) | |
1089 Запрашивает количество каналов воспроизведения (по-умолчанию: 2). | |
1090 MPlayer просит декодер декодировать звук в указанное количество каналов. | |
1091 Выполнение задачи ложится на плечи декодера. | |
1092 Обычно это требуется только при воспроизведении видео с AC3 звуком (например DVD). | |
1093 В этом случае liba52 выполняет декодирование как обычно и корректно сводит | |
1094 звук в запрошенное количество каналов. | |
1095 Для прямого управления количеством выходных каналов независимо от количества декодируемых, | |
1096 используйте фильтр channels. | |
1097 .br | |
1098 .I ЗАМЕЧАНИЕ: | |
1099 Эта опция учитывается кодеками (только AC3), фильтрами (surround) и драйверами вывода | |
1100 звука (как минимум OSS). | |
1101 .sp 1 | |
1102 Доступные опции: | |
1103 .sp 1 | |
1104 .PD 0 | |
1105 .RSs | |
1106 .IPs 2 | |
1107 stereo | |
1108 .IPs 4 | |
1109 surround | |
1110 .IPs 6 | |
1111 full 5.1 | |
1112 .RE | |
1113 .PD 1 | |
1114 . | |
1115 .TP | |
1116 .B \-chapter <ID раздела>[\-<ID посл. раздела>] (только dvd:// и dvdnav://) | |
1117 Указывает с какого раздела начать воспроизведение. | |
1118 Опционально указывает каким разделом закончить воспроизведение (по-умолчанию: 1). | |
1119 . | |
1120 .TP | |
1121 .B \-cookies (только сеть) | |
1122 Указывает отправлять cookie при выполнении HTTP запросов. | |
1123 . | |
1124 .TP | |
1125 .B \-cookies-file <файл> (только сеть) | |
1126 Читает HTTP cookie из файла <файл> (по-умолчанию: ~/.mozilla/ и ~/.netscape/) | |
1127 и пропускает чтение из стандартных мест. | |
1128 Предполагается файл в формате Netscape. | |
1129 . | |
1130 .TP | |
1131 .B \-delay <сек> | |
1132 Задержка аудио в секундах (положительное или отрицательное вещественное число) | |
1133 .br | |
1134 .I ЗАМЕЧАНИЕ: | |
1135 При использовании с MEncoder не гарантируется правильная работу с \-ovc copy; | |
1136 используйте вместо этого \-audio\-delay. | |
1137 . | |
1138 .TP | |
1139 .B \-ignore-start | |
1140 Игнорирует указанное время начала для потоков в AVI файлах. | |
1141 В MPlayer это обнуляет задержки потоков в файлах, кодированных с | |
1142 опцией \-audio\-delay. В процессе кодирования эта опция предотвращает | |
1143 перенос программой MEncoder времени начала из оригинального файла в кодируемый; | |
1144 опция \-audio-delay не затрагивается. | |
1145 Имейте в виду, что Mencoder иногда автоматически исправляет время начала потока | |
1146 для компенсации ожидаемых задержек декодирования, так что никогда | |
1147 не используйте эту опцию при кодировании без предварительного тестирования. | |
1148 . | |
1149 .TP | |
1150 .B \-demuxer <[+]name> | |
1151 Устанавливает тип демуксера. | |
1152 Используйте '+' перед названием для принудительной установки, это пропустит некоторые проверки! | |
1153 Передайте название демуксера как оно выводится пр помощи \-demuxer help. | |
1154 Для обратной совместимости она также принимает ID демуксера, определенного в | |
1155 libmpdemux/\:demuxer.h. | |
1156 \-demuxer audio или \-demuxer 17 устанавливает MP3. | |
1157 . | |
1158 .TP | |
1159 .B \-dumpaudio (только MPlayer) | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
1160 Сохранает сырой сжатый аудио поток в ./stream.dump (полезно с MPEG/\:AC3, |
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
1161 в большинстве остальных случаев полученный файл проигрываться не будет). |
20707 | 1162 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, |
1163 \-dumpstream, будет использоваться только последняя. | |
1164 . | |
1165 .TP | |
1166 .B \-dumpfile <файл> (только MPlayer) | |
1167 Указывает в какой файл должно происходить сохранение. | |
1168 Следует использовать вместе с \-dumpaudio / \-dumpvideo / \-dumpstream. | |
1169 . | |
1170 .TP | |
1171 .B \-dumpstream (только MPlayer) | |
1172 Сохраняет сырой поток в ./stream.dump. | |
1173 Полезно при рипе с DVD или сети. | |
1174 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1175 \-dumpstream, будет использоваться только последняя. | |
1176 . | |
1177 .TP | |
1178 .B \-dumpvideo (только MPlayer) | |
1179 Сохраняет сырой сжатый видео поток в ./stream.dump (не очень пригодно). | |
1180 Если вы укажете в командной строке более одной опции из \-dumpaudio, \-dumpvideo, | |
1181 \-dumpstream, будет использоваться только последняя. | |
1182 . | |
1183 .TP | |
1184 .B \-dvbin <options> (только DVB) | |
1185 Передает следующие параметры модулю DVB, для переопределения стандартных: | |
1186 .sp 1 | |
1187 .PD 0 | |
1188 .RSs | |
1189 .IPs card=<1\-4> | |
1190 Указывает номер используемой карты 1\-4 (default: 1). | |
1191 .IPs file=<файл> | |
1192 Указывает MPlayer читать список каналов из файла <файл>. | |
1193 По-умолчанию: ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (в зависимости от типа карты) | |
1194 или ~/.mplayer/\:channels.conf. | |
1195 .IPs timeout=<1\-30> | |
1196 Максимальное количество секунд ожидания настройки на частоту перед началом воспроизведения | |
1197 (по-умолчанию: 30). | |
1198 .RE | |
1199 .PD 1 | |
1200 . | |
1201 .TP | |
1202 .B \-dvd-device <путь к устройству> (только DVD) | |
1203 Указывает устройство DVD (по-умолчанию: /dev/\:dvd). | |
1204 Вы также можете указать каталог, содержащий файлы, предварительно скопированные | |
1205 непосредственно с DVD (например, с помощью vobcopy). | |
1206 Заметьте, что для копирования роликов DVD, как правило, лучше использовать \-dumpstream | |
1207 (смотрите примеры). | |
1208 . | |
1209 .TP | |
1210 .B \-dvdangle <ID угла> (только DVD) | |
1211 Некоторые DVD диски содержат сцены, которые можно смотреть с разных углов. | |
1212 Здесь вы можете указать MPlayer какой угол использовать (по-умолчанию: 1). | |
1213 . | |
1214 .TP | |
1215 .B \-edl <файл> | |
1216 Задействует действия списка решений редактирования (EDL) при воспроизведении. | |
1217 Видео будет пропущено или звук будет включен/\:выключен в соответствии с | |
1218 записями в указанном файле. | |
1219 Смотрите http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:edl.html для подробностей об | |
1220 использовании этих файлов. | |
1221 . | |
1222 .TP | |
1223 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (смотрите также \-ss и \-sb) | |
1224 Останавливает воспроизведение в указанное время или байтовой позиции. | |
1225 .br | |
1226 .I ЗАМЕЧАНИЕ: | |
1227 Бйтовая позиция задействуется только для MEncoder и будет не очень точной, поскольку | |
1228 остановка возможна только на границе кадра. | |
1229 При использовании совместно с опцией \-ss, время \-endpos будет сдвинуто вперед на | |
1230 указанное с помощью \-ss количество секунд. | |
1231 .sp 1 | |
1232 .I ПРИМЕР: | |
1233 .PD 0 | |
1234 .RSs | |
1235 .IPs "\-endpos 56" | |
1236 Остановиться на 56 секунде. | |
1237 .IPs "\-endpos 01:10:00" | |
1238 Остановиться через 1 час 10 минут. | |
1239 .IPs "\-ss 10 \-endpos 56" | |
1240 Остановиться на позиции 1 минута 6 секунд. | |
1241 .IPs "\-endpos 100mb" | |
1242 Кодировать только 100 Мб. | |
1243 .RE | |
1244 .PD 1 | |
1245 . | |
1246 .TP | |
1247 .B \-forceidx | |
1248 Принудительно перестраивает индекс. | |
1249 Полезно для файлов с испорченным индексом (A/V рассинхронизация, и т.п.). | |
1250 Это позволит перемещаться по файлу, в которм перемещение было невозможно. | |
1251 Вы можете исправить индекс в самом файле при помощи MEncoder (смотрите документацию). | |
1252 .br | |
1253 .I ЗАМЕЧАНИЕ: | |
1254 Опция работает, только если лежащее в основе медиа позволяет перемещение | |
1255 (т.е.\& не с stdin, pipe, т.д.). | |
1256 . | |
1257 .TP | |
1258 .B \-fps <вещественное значение> | |
1259 Переопределяет частоту кадров. | |
1260 Полезно, если оригинальное значение неверно или отсутствует. | |
1261 . | |
1262 .TP | |
1263 .B \-frames <число> | |
1264 Воспроизводит/\:конвертирует только первое <число> кадров, затем выходит. | |
1265 . | |
1266 .TP | |
1267 .B \-hr-mp3-seek (только MP3) | |
1268 Точное перемещение по MP3. | |
1269 Включается при воспроизведении из внешнего MP3 файла, как только требуется очень точное | |
1270 перемещение к позиции для сохранения A/V синхронизации.. | |
1271 Может быть медленным, особенно при перемещении назад, поскольку необходимо | |
1272 переместиться к началу для поиска точной позиции кадра. | |
1273 . | |
1274 .TP | |
1275 .B \-idx (смотрите также \-forceidx) | |
1276 Перестраивает индекс файла, если таковой не был найден, позволяя осуществлять перемещение. | |
1277 Полезно с испорченными/\:неполностью скачанными или неверно созданными файлами. | |
1278 .br | |
1279 .I ЗАМЕЧАНИЕ: | |
1280 Опция работает только если лежащее в основе медиа позволяет перемещение | |
1281 (т.е.\& не с stdin, pipe, т.д.). | |
1282 . | |
1283 .TP | |
1284 .B \-ipv4-only-proxy (только сеть) | |
1285 Указывает не использовать прокси для IPv6 адресов. | |
1286 Он по-прежнему будет использоваться для IPv4 соединений. | |
1287 . | |
1288 .TP | |
1289 .B \-loadidx <индексный файл> | |
1290 Файл из которого следует читать данные индекса видео, сохраненные \-saveidx. | |
1291 Этот индекс будет использоваться для перемещения, переопределяя любые | |
1292 индексные данные, содержащиеся в самом AVI. | |
1293 MPlayer не запрещает загрузку индексного файла, созданного по другому AVI фильму, но | |
1294 это обязательно приведет к неприятным результатам. | |
1295 .br | |
1296 .I ЗАМЕЧАНИЕ: | |
1297 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML. | |
1298 . | |
1299 .TP | |
1300 .B \-mc <секунд/кадр> | |
1301 Максимальная величина корректировки A-V синхронизации на один кадр (в секундах) | |
1302 . | |
1303 .TP | |
1304 .B \-mf <опция1:опция2:...> | |
1305 Используется при кодировании из нескольких PNG или JPEG файлов. | |
1306 .sp 1 | |
1307 Доступные опции: | |
1308 .sp 1 | |
1309 .PD 0 | |
1310 .RSs | |
1311 .IPs w=<значение> | |
1312 ширина входного файла (по-умолчанию: автоопределение) | |
1313 .IPs h=<значение> | |
1314 высота входного файла (по-умолчанию: автоопределение) | |
1315 .IPs fps=<значение> | |
1316 fps результата (по-умолчанию: 25) | |
1317 .IPs type=<значение> | |
1318 тип входного файла (доступны: jpeg, png, tga, sgi) | |
1319 .RE | |
1320 .PD 1 | |
1321 . | |
1322 .TP | |
1323 .B \-ni (только AVI) | |
1324 Принуждает использовать обработчик нечередующегося AVI | |
1325 (исправляет воспроизведение некоторых плохих AVI файлов). | |
1326 . | |
1327 .TP | |
1328 .B \-nobps (только AVI) | |
1329 Указывает не использовать среднее значение байт/\:секунду для | |
1330 A-V синхронизации. Помогает для некоторых AVI файлов с испорченным заголовком. | |
1331 . | |
1332 .TP | |
1333 .B \-noextbased | |
1334 Отключает выбор демуксера на основе расширения файла. | |
1335 По-умолчанию, когда тип файла (демуксер) не может быть достоверно определен | |
1336 (файл не имеет заголовка, или он недостаточно достоверен), для выбора | |
1337 демуксера будет использовано расширение файла. | |
1338 Опция указывает всегда использовать содержимое файла для определения демуксера. | |
1339 . | |
1340 .TP | |
1341 .B \-passwd <пароль> (смотрите также see \-user) (только сеть) | |
1342 Указывает пароль для HTTP аутентификации. | |
1343 . | |
1344 .TP | |
1345 .B \-prefer-ipv4 (только сеть) | |
1346 Использует IPv4 для сетевых соединений. | |
1347 При необходимости автоматически используется IPv6. | |
1348 . | |
1349 .TP | |
1350 .B \-prefer-ipv6 (только IPv6 сеть) | |
1351 Использует IPv6 для сетевых соединений. | |
1352 При необходимости автоматически используется IPv4. | |
1353 . | |
1354 .TP | |
1355 .B \-pvr <опция1:опция2:...> (только PVR) | |
1356 Эта опция настраивает различные свойства кодирования модуля PVR. | |
1357 Она должна использоваться с любой картой на основе аппаратного MPEG | |
1358 кодера, совместимого с драйвером V4L2. | |
1359 Hauppauge WinTV PVR\-150/250/350/500 и все карты, основанные на IVTV, | |
1360 известны как PVR карты захвата. Знайте, что только ядра Linux старше 2.6.18 | |
1361 способны обрабатывать MPEG поток через слой V4L2. | |
1362 Для аппаратного захвата MPEG потока и его просмотра с MPlayer/MEncoder, | |
1363 используйте 'pvr://' в качестве URL фильма. | |
1364 .sp 1 | |
1365 Доступные опции: | |
1366 .RSs | |
1367 .IPs aspect=<0\-3> | |
1368 Указывает входные пропорции: | |
1369 .RSss | |
1370 0: 1:1 | |
1371 .br | |
1372 1: 4:3 (по-умолчанию) | |
1373 .br | |
1374 2: 16:9 | |
1375 .br | |
1376 3: 2.21:1 | |
1377 .REss | |
1378 .IPs arate=<32000\-48000> | |
1379 Указывает частоту дискретизации звука (по-умолчанию: 48000 Гц, доступны: 32000, 44100 | |
1380 и 48000 Гц). | |
1381 .IPs alayer=<1\-3> | |
1382 Указывает слой кодирования MPEG[MPEG layer](по-умолчанию: 2). | |
1383 .IPs abitrate=<32\-448> | |
1384 Указывает битпоток кодируемого звука в кбит/с (по-умолчанию: 384). | |
1385 .IPs amode=<значение> | |
1386 Указывает режим кодирования звука. | |
1387 Доступны следующие предустановки: 'stereo', 'joint_stereo', 'dual' | |
1388 и 'mono' (по-умолчанию: stereo). | |
1389 .IPs vbitrate=<значение> | |
1390 Указывает среднее значение битпотока кодируемого видео в Мбит/с (по-умолчанию: 6). | |
1391 .IPs vmode=<значение> | |
1392 Указывает режим кодирования видео: | |
1393 .RSss | |
1394 vbr: Переменный битпоток (по-умолчанию) | |
1395 .br | |
1396 cbr: Постоянный битпоток | |
1397 .REss | |
1398 .IPs vpeak=<значение> | |
1399 Указывает пиковое значение битпотока кодируемого видео в Мбит/с | |
1400 (имеет смысл только для VBR кодирования, по-умолчанию: 6.6). | |
1401 .IPs fmt=<value> | |
1402 Выбирает MPEG формат для кодирования: | |
1403 .RSss | |
1404 ps: MPEG-2 Программный поток (по-умолчанию) | |
1405 .br | |
1406 ts: MPEG-2 Транспортный поток | |
1407 .br | |
1408 mpeg1: MPEG-1 системный поток | |
1409 .br | |
1410 vcd: Video CD совместимый поток | |
1411 .br | |
1412 svcd: Super Video CD совместимый | |
1413 .br | |
1414 dvd: DVD совместимый | |
1415 .REss | |
1416 .RE | |
1417 .PD 1 | |
1418 . | |
1419 .TP | |
1420 .B \-radio <опция1:опция2:...> (только радио) | |
1421 Эта опция устанавливает различные параметры модуля захвата с радио. | |
1422 Для прослушивания радио с MPlayer используйте 'radio://<частота>' | |
1423 (если не указана опция channels) или 'radio://<номер канала>' | |
1424 (если опция channels указана) в качестве URL. | |
20768 | 1425 Вы можете увидеть допустимый диапазон частот, запустив MPlayer |
1426 с опцией '\-v'. | |
20707 | 1427 Для запуска подсистемы захвата, |
1428 используйте 'radio://<частота или канал>/capture'. | |
1429 Если не указано ключевое слово capture, вы можете слушать радио только | |
1430 при помоши line-in кабеля. Использование capture для прослушивания не | |
1431 рекомендуется в связи с проблемами синхронизации, которые | |
1432 делают прослушивание некомфортным. | |
1433 .sp 1 | |
1434 Доступные опции: | |
1435 .RSs | |
1436 .IPs device=<значение> | |
21021 | 1437 Используемое устройство радио (по-умолчанию: /dev/radio0 для Linux и /dev/tuner0 для *BSD). |
20707 | 1438 .IPs driver=<значение> |
1439 Используемый радио драйвер (пл-умолчанию: v4l2 если доступно, иначе v4l). | |
1440 В данный момент поддерживаются драйверы v4l и v4l2. | |
1441 .IPs volume=<0..100> | |
1442 Уровень звука для радио (по-умолчанию: 100) | |
21021 | 1443 .IPs freq_min=<значение> (только *BSD BT848) |
1444 Минимальная допустимая частота (по-молчанию: 87.50) | |
1445 .IPs freq_max=<значение> (только *BSD BT848) | |
1446 Максимальная допустимая частота (по-умолчанию: 108.00) | |
20707 | 1447 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,... |
1448 Устанавливает список каналов. | |
1449 Используйте _ вместо пробелов в именах (или играйтесь с экранированием ;-). | |
1450 Имена каналов будут выводиться при помощи OSD, и для управления с пульта | |
1451 будут доступны команды radio_step_channel и radio_set_channel (смотрите LIRC). | |
1452 Если эта опция указана, то число в URL будет означать позицию канала в списке. | |
1453 .br | |
1454 .I ПРИМЕР: | |
1455 radio://1, radio://104.4, radio_set_channel 1 | |
1456 .IPs adevice=<значение> (с включенной поддержкой захвата с радио) | |
1457 Название устройства, с которого будет производиться захват. | |
1458 Без его указания захват будет отключен, даже если в URL указано слово capture. | |
1459 Для ALSA устройств указывайте его в виде hw=<карта>.<устройство>. | |
1460 Если название устройства содержит '=', то для захвата модуль будет | |
1461 использовать ALSA, иначе OSS. | |
1462 .IPs arate=<значение> (с включенной поддержкой захвата с радио) | |
1463 Частота в сэмплах в секунду (по-умолчанию: 44100). | |
1464 .br | |
1465 .I ЗАМЕЧАНИЕ: | |
1466 При использовании захвата звука, установите также опцию | |
1467 \-rawaudio rate=<значение> с таким же значением, как у arate. | |
1468 Если у вас проблемы со скоростью звука (слишком быстрый), попробуйте | |
1469 поиграть с разными значениями arate (например, 48000,44100,32000,...). | |
1470 .IPs achannels=<значение> (с включенной поддержкой захвата с радио) | |
1471 Количество аудио каналов для захвата. | |
1472 .RE | |
1473 . | |
1474 .TP | |
1475 .B \-rawaudio <опция1:опция2:...> | |
1476 Эта опция позполяет проигрывать сырые аудио файлы. | |
1477 Вам придется также указать \-demuxer rawaudio. | |
1478 Ее еще можно использовать для воспроизведения аудио CD, отличных от 44кГц 16-бит стерео. | |
1479 Для воспроизведения сырых AC3 потоков используйте \-rawaudio format=0x2000 \-demuxer rawaudio. | |
1480 .sp 1 | |
1481 Доступные опции: | |
1482 .sp 1 | |
1483 .PD 0 | |
1484 .RSs | |
1485 .IPs channels=<значение> | |
1486 количество каналов | |
1487 .IPs rate=<значение> | |
1488 частота в сэмплах в секунду | |
1489 .IPs samplesize=<значение> | |
1490 размер сэмпла в байтах | |
1491 .IPs bitrate=<значение> | |
1492 битпоток для rawaudio файлов | |
1493 .IPs format=<значение> | |
1494 fourcc в шестнадцатеричном формате | |
1495 .RE | |
1496 .PD 1 | |
1497 . | |
1498 .TP | |
1499 .B \-rawvideo <опция1:опция2:...> | |
1500 Эта опция позволяет воспроизводить сырые видео файлы. | |
1501 Вам придется также указать \-demuxer rawaudio. | |
1502 .sp 1 | |
1503 Доступные опции: | |
1504 .sp 1 | |
1505 .PD 0 | |
1506 .RSs | |
1507 .IPs fps=<значение> | |
1508 частота в кадрах в секунду (по-умолчанию: 25.0) | |
1509 .IPs sqcif|qcif|cif|4cif|pal|ntsc | |
1510 устанавливает стандартный размер изображения | |
1511 .IPs w=<значение> | |
1512 ширина изоражения в пикселах | |
1513 .IPs h=<value> | |
1514 высота изображения в пикселах | |
1515 .IPs i420|yv12|yuy2|y8 | |
1516 устанавливает пространство цветов | |
1517 .IPs format=<значение> | |
1518 цветовое пространство (fourcc) в шестнадцатеричном формате | |
1519 .IPs size=<значение> | |
1520 размер кадра в байтах | |
1521 .REss | |
1522 .sp 1 | |
1523 .RS | |
1524 .I ПРИМЕР: | |
1525 .RE | |
1526 .PD 0 | |
1527 .RSs | |
1528 .IPs "mplayer foreman.qcif \-demuxer rawvideo -rawvideo qcif" | |
1529 Проигрывает известный фильм "foreman". | |
1530 .IPs "mplayer sample-720x576.yuv \-demuxer rawvideo \-rawvideo w=720:h=576" | |
1531 Проигрывает сырой YUV фильм. | |
1532 .RE | |
1533 .PD 1 | |
1534 . | |
1535 .TP | |
1536 .B \-rtsp-port | |
1537 Используется с 'rtsp://' URL для назначения номера порта на клиенте. | |
1538 Опция может быть полезна, если вы находитесь за маршрутизатором и хотите | |
1539 направлять RTSP поток с сервера определенному клиенту. | |
1540 . | |
1541 .TP | |
1542 .B \-rtsp-destination | |
1543 Используется с rtsp://' URL для привязки к указанному IP адресу назначения. | |
1544 Опция может быть полезна с некоторыми RTSP серверами, не отправляющими | |
1545 RTP пакеты на нужный интерфейс. Если невозможно установить соединение | |
1546 с RTSP сервером, используйте опцию \-v, чтобы определить, | |
1547 к какому IP адресу пытается привязаться MPlayer, и попытайтесь назначить | |
1548 вместо него один из назначенных вашему компьютеру. | |
1549 . | |
1550 .TP | |
1551 .B \-rtsp-stream-over-tcp (только LIVE555) | |
1552 Используется с'rtsp://' URL для указания, что в результате входящие RTP и RTCP | |
1553 пакеты должны передаваться по TCP (используя то же TCP соединение, что и RTSP). | |
1554 Опция может быть полезна, если у вас сбоящее интернет соединение, | |
1555 не пропускающее входящие UDP пакеты (смотрите http://www.live555.com/\:mplayer/). | |
1556 . | |
1557 .TP | |
1558 .B \-saveidx <файл> | |
1559 Принудительно перестраивает индекс и сохраняет его в <файл>. | |
1560 В данный момент это работает только с AVI файлами. | |
1561 .br | |
1562 .I ЗАМЕЧАНИЕ: | |
1563 Эта опция устарела, поскольку MPlayer теперь имеет поддержку OpenDML. | |
1564 . | |
1565 .TP | |
1566 .B \-sb <байтовая позиция> (смотрите также \-ss) | |
1567 Перемещается к байтовой позиции. | |
1568 Полезно для воспроизведения с образов CD-ROM или VOB файлов с мусором в начале. | |
1569 . | |
1570 .TP | |
1571 .B \-speed <0.01\-100> | |
1572 Уменьшает или увеличивает скорость воспроизведения в указанное количество раз. | |
1573 Не гарантируется правильная работа с \-oac copy. | |
1574 . | |
1575 .TP | |
1576 .B \-srate <Гц> | |
1577 Выбирает используемую выходную частоту семплов | |
1578 (конечно, звуковые карты имеют на нее ограничения). | |
1579 Если выбранная частота сэмплов отличается от текущего медиа, то для компенсации | |
1580 различий в слой звуковых фильтров будет автоматически добавлен звуковой | |
1581 фильтр resample или lavcresample. | |
1582 Тип ресэмплирования может быть указан опцией \-af-adv. | |
1583 По-цмолчанию, используется быстрое преобразование, что может | |
1584 привести к искажениям. | |
1585 . | |
1586 .TP | |
1587 .B \-ss <time> (also see \-sb) | |
1588 Перемещение в указаную временную позицию. | |
1589 .sp 1 | |
1590 .I ПРИМЕР: | |
1591 .PD 0 | |
1592 .RSs | |
1593 .IPs "\-ss 56" | |
1594 Перемещается к позиции 56 секунд. | |
1595 .IPs "\-ss 01:10:00" | |
1596 Перемещается в позицию 1 час 10 мин. | |
1597 .RE | |
1598 .PD 1 | |
1599 . | |
1600 .TP | |
1601 .B \-tskeepbroken | |
1602 Указывает MPlayer не отбрасывать TS пакеты в потоке, определенные как испорченные. | |
1603 Иногда требуется для воспроизведения испорченных MPEG-TS файлов. | |
1604 . | |
1605 .TP | |
1606 .B \-tsprobe <байтовая позиция> | |
1607 При воспроизведении MPEG-TS потока, эта опция позволяет указать, в пределах какого | |
1608 количества байт в потоке MPlayer должен искать желаемые аудио и видео ID. | |
1609 . | |
1610 .TP | |
1611 .B \-tsprog <1\-65534> | |
1612 При воспроизведении MPEG-TS потока, этой опцией можно указать какую | |
1613 программу (если присутствует) вы хотите воспроизвести. | |
1614 Может использоваться с \-vid и \-aid. | |
1615 . | |
1616 .TP | |
1617 .B \-tv <опция1:опция2:...> (только TV/\:PVR) | |
1618 Эта опция настраивает различные свойства модуля TV захвата. | |
1619 Для просмотра TV с MPlayer, используйте 'tv://' или 'tv://<номер_канала>' | |
1620 или даже 'tv://<название_канала> (смотрите ниже опцию channels для подробностей о | |
1621 параметре название_канала) в качестве URL. | |
1622 .sp 1 | |
1623 Доступные опции: | |
1624 .RSs | |
1625 .IPs noaudio | |
1626 без звука | |
1627 .IPs driver=<значение> | |
1628 доступны: dummy, v4l, v4l2, bsdbt848 | |
1629 .IPs device=<значение> | |
1630 Указывает устройство TV (по-умолчанию: /dev/\:video0). | |
1631 .IPs input=<значение> | |
1632 Указывает источник (по-умолчанию: 0 (TV), смотрите консольный вывод для определения доступных | |
1633 источников). | |
1634 .IPs freq=<значение> | |
1635 Указывает частоту, на которую необходимо настроиться (например 511.250). | |
1636 Не совместимо с параметром channels. | |
1637 .IPs outfmt=<значение> | |
1638 Устанавливает формат вывода с тюнера в одно из предустановленных значений, | |
1639 поддерживаемых драйвером V4L (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) или в | |
1640 произвольный формат, заданный шестнадцатеричным значением. | |
1641 Попробуйте outfmt=help, чтобы получить список доступных форматов. | |
1642 .IPs width=<значение> | |
1643 Ширина окна вывода | |
1644 .IPs height=<значение> | |
1645 Высота окна вывода | |
1646 .IPs fps=<значение> | |
1647 Частота кодров с которой захватывается видео (кадров в секунду) | |
1648 .IPs buffersize=<значение> | |
1649 Максимальный размер буфера захвата в мегабайтах (по-умолчанию: динамический) | |
1650 .IPs norm=<значение> | |
1651 Для bsdbt848 и v4l доступны PAL, SECAM, NTSC. | |
1652 Для v4l2 смотрите консольный вывод для получения списка доступных стандартов. | |
1653 можете также посмотреть опицю normid ниже. | |
1654 .IPs "normid=<значение> (только v4l2)" | |
1655 Устанавливает TV стандарт в указанное числовое ID. | |
1656 TV стандарт зависит от карты захвата. | |
1657 Смотрите консольный вывод для получения списка доступных TV стандартов. | |
1658 .IPs channel=<значение> | |
1659 Переключает тюнер на <значение> канал. | |
1660 .IPs chanlist=<значение> | |
1661 Доступны: europe-east, europe-west, us-bcast, us-cable, другие | |
1662 .IPs channels=<канал>\-<название>,<канал>\-<название>,... | |
1663 Устанавливает названия для каналов. | |
1664 Используйте _ вместо пробелов в названиях (или поиграйте с экранированием ;-). | |
1665 Названия каналов будут выводиться при помощи OSD, и станут доступными | |
1666 команды tv_step_channel, tv_set_channel и tv_last_channel, полезные для | |
1667 управления с пульта (смотрите LIRC). | |
1668 Не совместима с параметром frequency. | |
1669 .br | |
1670 .I ЗАМЕЧАНИЕ: | |
1671 После этого номер канала будет являться позицией в списке 'channels', | |
1672 начиная с 1. | |
1673 .br | |
1674 .I ПРИМЕР: | |
1675 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1 | |
1676 .IPs [brightness|contrast|hue|saturation]=<-100\-100> | |
1677 Устанавливает эквалайзер изображения на карте. | |
1678 .IPs audiorate=<значение> | |
1679 Устанавливает аудио битпоток. | |
1680 .IPs forceaudio | |
1681 Указывает захватывать звук даже если v4l сообщает, что нет источников звука. | |
1682 .IPs "alsa\ " | |
1683 Захват через ALSA. | |
1684 .IPs amode=<0\-3> | |
1685 Выбирает аудио режим: | |
1686 .RSss | |
1687 0: моно | |
1688 .br | |
1689 1: стерео | |
1690 .br | |
1691 2: язык 1 | |
1692 .br | |
1693 3: язык 2 | |
1694 .REss | |
1695 .IPs forcechan=<1\-2> | |
1696 По-умолчанию, количество записываемых аудио каналов определяется автоматически, | |
1697 запрашивая режим аудио у TV карты. | |
1698 Эта опция позволяет принудительно назначить стерео/\:моно запись независимо | |
1699 от опции amode и значений, возвращаемых v4l. | |
1700 Это может быть использовано для решения проблем, в случае когда TV карта не | |
1701 способна указать текущий аудио режим. | |
1702 .IPs adevice=<значение> | |
1703 Устанавливает аудио устройство. | |
1704 <значение> должно быть /dev/\:xxx для OSS и аппаратный ID для ALSA. | |
1705 Вы должны заменить любые ':' на '.' в ID для ALSA. | |
1706 .IPs audioid=<значение> | |
1707 Выбирает выход звука карты захвата, если их более одного. | |
1708 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)" | |
1709 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)" | |
1710 Эти опции устанавливают параметры микшера на карте видео захвата. | |
1711 Они не имеют эффекта, если на карте такового нет. | |
1712 Для v4l2, 50 означает элемент управления по-умолчанию, как указано | |
1713 драйвером. | |
1714 .IPs immediatemode=<логическое> | |
1715 Значение 0 означает совместный захват и буферизацию звука и видео | |
1716 (по-умолчанию для MEncoder). | |
1717 Значение 1 (по-умолчанию для MPlayer) означает захват только видео и прохождение | |
1718 звука через кабель от TV карты к звуковой. | |
1719 .IPs mjpeg | |
1720 Используется аппаратное MJPEG сжатие (если карта его поддерживает). | |
1721 При использовании этой опции, вам не требуется указывать ширину и высоту | |
1722 окна вывода, потому что MPlayer определит их автоматически по | |
1723 значению decimation (смотрите ниже). | |
1724 .IPs decimation=<1|2|4> | |
1725 выбирает размер картинки, сжимаемой аппаратным MJPEG кодером: | |
1726 .RSss | |
1727 1: full size | |
1728 704x576 PAL | |
1729 704x480 NTSC | |
1730 .br | |
1731 2: medium size | |
1732 352x288 PAL | |
1733 352x240 NTSC | |
1734 .br | |
1735 4: small size | |
1736 176x144 PAL | |
1737 176x120 NTSC | |
1738 .REss | |
1739 .IPs quality=<0\-100> | |
1740 Выбирает качество JPEG сжатия | |
1741 (для полного размера рекомендуется < 60). | |
1742 .RE | |
1743 . | |
1744 .TP | |
1745 .B \-user <имя пользователя> (смотрите также \-passwd) (только сеть) | |
1746 Указывает имя пользователя для HTTP аутентификации. | |
1747 . | |
1748 .TP | |
1749 .B \-user-agent <строка> | |
1750 Используется <строка> в качестве значения user agent для потоков HTTP. | |
1751 . | |
1752 .TP | |
1753 .B \-vid <ID> | |
1754 Выбирает видео канал (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190). | |
1755 При воспроизведении потока MPEG-TS, MPlayer/\:MEncoder будет использовать | |
1756 первую программу (если присутствует) с указанным видео потоком. | |
1757 . | |
1758 .TP | |
1759 .B \-vivo <под-опции> (КОД ОТЛАДКИ) | |
1760 Принудительно устанавливает параметры звука для VIVO демуксера (для отладочных целей). | |
1761 . | |
1762 . | |
1763 . | |
1764 .SH "ОПЦИИ OSD/СУБТИТРОВ" | |
1765 .I ЗАМЕЧАНИЕ: | |
1766 Смотрите также \-vf expand. | |
1767 . | |
1768 .TP | |
1769 .B \-ass (только FreeType) | |
1770 Включает SSA/ASS рендеринг субтиров. | |
1771 С этой опцией для внешних субтитров SSA/ASS и дорожек Matroska будет использоваться | |
1772 libass. Смотрите также \-embeddedfonts. | |
1773 . | |
1774 .TP | |
1775 .B \-ass-border-color <значение> | |
1776 Устанавливает цвет границы (обрамления) для текста субтитров. | |
1777 Формат цвета: RRGGBBAA. | |
1778 . | |
1779 .TP | |
1780 .B \-ass-bottom-margin <значение> | |
1781 Добавляет черную полосу в нижней части кадра. | |
1782 Рендерер SSA/ASS может поместить туда субтитры (с \-ass-use-margins). | |
1783 . | |
1784 .TP | |
1785 .B \-ass-color <значение> | |
1786 Устанавливает цвет текста субтитров. | |
1787 Формат цвета: RRGGBBAA. | |
1788 . | |
1789 .TP | |
1790 .B \-ass-font-scale <значение> | |
1791 Устанавливает коэффициент масштабирования, используемый в рендерере SSA/ASS. | |
1792 . | |
1793 .TP | |
1794 .B \-ass-force-style <[Стиль.]Параметр=Значение[,...]> | |
1795 Переопределяет некоторые параметры стиля. | |
1796 .sp | |
1797 .I ПРИМЕР: | |
1798 .PD 0 | |
1799 .RSs | |
1800 \-ass-force-style FontName=Arial,Default.Bold=1 | |
1801 .RE | |
1802 .PD 1 | |
1803 . | |
1804 .TP | |
1805 .B \-ass-line-spacing <значение> | |
1806 Устанавливает межстрочный интервал для рендерера SSA/ASS. | |
1807 . | |
1808 .TP | |
1809 .B \-ass-styles <файл> | |
1810 Загружает все SSA/ASS стили, найденные в указанном файле и использует их для | |
1811 рендеринга текста субтитров. Синтаксис файла такой же как в | |
1812 [V4 Styles] / [V4+ Styles] разделах SSA/ASS. | |
1813 . | |
1814 .TP | |
1815 .B \-ass-top-margin <значение> | |
1816 Добавляет черную полосу в верхней части кадра. | |
1817 SSA/ASS рендерер может поместить туда субтитры (с \-ass-use-margins). | |
1818 . | |
1819 .TP | |
1820 .B \-(no)ass-use-margins | |
1821 Включает/выключает расположение субтитров на черных полосах, когда они доступны | |
1822 (по-умолчанию: нет). | |
1823 . | |
1824 .TP | |
1825 .B \-dumpjacosub (только MPlayer) | |
1826 Преобразует субтитры (указанные опцией \-sub) в основанный на времени | |
1827 JACOsub формат. | |
1828 Создает файл dumpsub.js в текущем каталоге. | |
1829 . | |
1830 .TP | |
1831 .B \-dumpmicrodvdsub (только MPlayer) | |
1832 Преобразует субтитры (указанные опцией \-sub) в MicroDVD формат. | |
1833 Создает файл dumpsub.sub в текущем каталоге. | |
1834 . | |
1835 .TP | |
1836 .B \-dumpmpsub (только MPlayer) | |
1837 Преобразует субтитры (указанные опцией \-sub) в MPsub, формат субтитров MPlayer. | |
1838 Создает файл dump.mpsub в текущем каталоге. | |
1839 . | |
1840 .TP | |
1841 .B \-dumpsami (только MPlayer) | |
1842 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат SAMI. | |
1843 Создает файл dumpsub.sm в текущем каталоге. | |
1844 . | |
1845 .TP | |
1846 .B \-dumpsrtsub (только MPlayer) | |
1847 Преобразует субтитры (указанные опцией \-sub) в основанный на времени формат | |
1848 SubViewer (SRT). | |
1849 Создает файл dumpsub.srt в текущем каталоге. | |
1850 . | |
1851 .br | |
1852 .I ЗАМЕЧАНИЕ: | |
1853 Некоторые глючные аппаратные проигрыватели давятся SRT субтитрами с концами строк | |
1854 в стиле Unix. Если вам неповезло иметь такой, пропустите файлы субтитров | |
1855 через unix2dos или аналогичную программу для замены символов конца строка на | |
1856 принятые в DOS/Windows. | |
1857 . | |
1858 .TP | |
1859 .B \-dumpsub (только MPlayer) (БЕТА КОД) | |
1860 Сохраняет субпоток субтитров из VOB потоков. | |
1861 Смотрите также опции \-dump*sub и \-vobsubout*. | |
1862 . | |
1863 .TP | |
1864 .B \-embeddedfonts (только FreeType) | |
1865 Задействует извлечение внедренных шрифтов Matroska. | |
1866 Эти шрифты затем могут быть использованы для рендеринга SSA/ASS субтитров | |
1867 (опция \-ass). | |
1868 . | |
1869 .TP | |
1870 .B \-ffactor <число> (только OSD) | |
1871 .\" FIXME Resample the font alphamap. | |
1872 Преобразует альфакарту шрифта. | |
1873 Может быть: | |
1874 .PD 0 | |
1875 .RSs | |
1876 .IPs 0 | |
1877 простые белые шрифты | |
1878 .IPs 0.75 | |
1879 очень тонкое черное обрамление (по-умолчанию) | |
1880 .IPs 1 | |
1881 тонкое черное обрамление | |
1882 .IPs 10 | |
1883 жирное черное обрамление | |
1884 .RE | |
1885 .PD 1 | |
1886 . | |
1887 .TP | |
1888 .B \-flip-hebrew (только FriBiDi) | |
1889 Включает отражение субтитров, используя FriBiDi. | |
1890 . | |
1891 .TP | |
1892 .B \-noflip-hebrew-commas | |
1893 Изменяет предположения FriBiDi о расположении запятых в субтитрах. | |
1894 Используйте ее, если запятые в субтитрах начинаются в начале фраз, | |
1895 вместо их конца. | |
1896 . | |
1897 .TP | |
1898 .B \-font <путь к файлу font.desc> (только OSD) | |
1899 Ищет OSD/\:SUB шрифты в другом каталоге (по-умолчанию для обычных | |
1900 шрифтов: ~/\:.mplayer/\:font/\:font.desc, по-умолчанию для FreeType шрифтов: | |
1901 ~/.mplayer/\:subfont.ttf). | |
1902 .br | |
1903 .I ЗАМЕЧАНИЕ: | |
1904 С FreeType, эта опция определяет путь к файлу шрифта текста. | |
1905 С fontconfig, эта опция определяет название шрифта fontconfig. | |
1906 .sp 1 | |
1907 .I ПРИМЕР: | |
1908 .PD 0 | |
1909 .RSs | |
1910 \-font ~/\:.mplayer/\:arial-14/\:font.desc | |
1911 .br | |
1912 \-font ~/\:.mplayer/\:arialuni.ttf | |
1913 .br | |
1914 \-font 'Bitstream Vera Sans' | |
1915 .RE | |
1916 .PD 1 | |
1917 . | |
1918 .TP | |
1919 .B \-fontconfig (только fontconfig) | |
1920 Задействует использование шрифтов, управляемых fontconfig. | |
1921 . | |
1922 .TP | |
1923 .B \-forcedsubsonly | |
1924 Отображает только форсированные субтитры для потока субтитров DVD, выбранного, | |
1925 например \-slang. | |
1926 . | |
1927 .TP | |
1928 .B \-fribidi-charset <название кодировки> (только FriBiDi) | |
1929 Указывает кодировку, которая будет передана FriBiDi при декодировании | |
1930 не-UTF-8 субтитров (по-умолчанию: ISO8859-8). | |
1931 . | |
1932 .TP | |
1933 .B \-ifo <VOBsub IFO файл> | |
1934 Указывает файл, используемый для загрузки палитры и размера кадра для VOBsub субтитров. | |
1935 . | |
1936 .TP | |
1937 .B \-noautosub | |
1938 Выключает автоматическую загрузку файла субтитров. | |
1939 . | |
1940 .TP | |
1941 .B \-osd-duration <время> | |
1942 Устанавливает длительность отобрадения сообщений OSD в мс (по-умолчанию: 1000). | |
1943 . | |
1944 .TP | |
1945 .B \-osdlevel <0\-3> (только MPlayer) | |
1946 Указывает в каком режиме должен запускаться OSD. | |
1947 .PD 0 | |
1948 .RSs | |
1949 .IPs 0 | |
1950 только субтитры | |
1951 .IPs 1 | |
1952 громкость + позиция (по-умолчанию) | |
1953 .IPs 2 | |
1954 громкость + позиция + время + процент | |
1955 .IPs 3 | |
1956 громкость + пощиция + время + процент + общее время | |
1957 .RE | |
1958 .PD 1 | |
1959 . | |
1960 .TP | |
1961 .B \-overlapsub | |
1962 Позволяет очередным субтитрам быть отображенными, когда текущие еще видимы | |
1963 (по-умолчанию поддержка включается только для определенных форматов). | |
1964 . | |
1965 .TP | |
1966 .B \-sid <ID> (смотрите также \-slang, \-vobsubid) | |
1967 Отображает поток субтитров, указаный по <ID> (0\-31). | |
1968 MPlayer показывает доступные ID субтитров, когда запущен в подробном (\-v) режиме. | |
1969 Если вы не можете выбрать ни один из субтитров на DVD, попробуйте также \-vobsubid. | |
1970 . | |
1971 .TP | |
1972 .B \-slang <код языка[,код языка,...]> (смотрите также \-sid) | |
1973 Указывает языков используемых в субтитрах в порядке приоритетности. | |
1974 Разные форматы файлов работают с разными кодами языков. | |
1975 DVD используют ISO 639-1 двухбуквенные коды, Matroska использует | |
1976 ISO 639-2 трехбуквенные, в то время как OGM использует идентификатор | |
1977 в свободной форме. MPlayer выводит доступные языки при запуске в подробном (\-v) режиме. | |
1978 .sp 1 | |
1979 .I ПРИМЕР: | |
1980 .PD 0 | |
1981 .RSs | |
1982 .IPs "mplayer dvd://1 \-slang hu,en" | |
1983 Выбирает дорожку с Венгерскими субтитрами на DVD, а в случае отсутствия таковой | |
1984 возвращается к использованию Английского. | |
1985 .IPs "mplayer \-slang jpn example.mkv" | |
1986 Воспроизводит файл Matroska с Японскими субтитрами. | |
1987 .RE | |
1988 .PD 1 | |
1989 . | |
1990 .TP | |
1991 .B \-spuaa <режим> (только OSD) | |
1992 Режим сглаживания/\:масштабирования для DVD/\:VOBsub. | |
1993 Значение 16 может быть добавлено к <режим> для задействования масштабирования, | |
1994 лаже если размеры исходного и отмасштабированного кадра уже совпадают. | |
1995 Может использоваться, например, для гауссового размытия субтитров. | |
1996 Доступные режимы: | |
1997 .PD 0 | |
1998 .RSs | |
1999 .IPs 0 | |
2000 ничего (наиболее быстрое, очень безобразное) | |
2001 .IPs 1 | |
2002 апроксимированный (сбоит?) | |
2003 .IPs 2 | |
2004 полное (меделенное) | |
2005 .IPs 3 | |
2006 билинейное (быстрое и не очень плохое, по-умолчанию) | |
2007 .IPs 4 | |
2008 используется гауссово размытие swscaler'a (выглядит очень хорошо) | |
2009 .RE | |
2010 .PD 1 | |
2011 . | |
2012 .TP | |
2013 .B \-spualign <-1\-2> (только OSD) | |
2014 Указывает как должны выравниваться SPU (DVD/\:VOBsub) субтитры. | |
2015 .PD 0 | |
2016 .RSs | |
2017 .IPs "-1" | |
2018 исходное положение | |
2019 .IPs " 0" | |
2020 Выравнивание к верху (изначальное поведение, по-умолчанию). | |
2021 .IPs " 1" | |
2022 Выравнивание к центру. | |
2023 .IPs " 2" | |
2024 Выравнивание к низу. | |
2025 .RE | |
2026 .PD 1 | |
2027 . | |
2028 .TP | |
2029 .B \-spugauss <0.0\-3.0> (только OSD) | |
2030 Параметр отклонения гауссового размытия, используемый \-spuaa 4. | |
2031 Большие значения означают более сильное размытие (по-умолчанию: 1.0). | |
2032 . | |
2033 .TP | |
2034 .B \-sub <файл_субтитров1,файл_субтитров2,...> | |
2035 Использует/\:отображает указанные файлы субтитров. | |
2036 В каждый момент времени может быть показан только один файл. | |
2037 . | |
2038 .TP | |
2039 .B \-sub-bg-alpha <0\-255> | |
2040 Указывает значение альфа канала для субтитров и фона OSD. | |
2041 Большее значение означает большую прозрачность. | |
2042 0 означает полную прозрачность. | |
2043 . | |
2044 .TP | |
2045 .B \-sub-bg-color <0\-255> | |
2046 Указывает цвет для субтитров у фона OSD. | |
2047 В данный момент субтитры выводятся в оттенках серого, так что это | |
2048 эквивалентно интенсивности цвета. | |
2049 255 означает белый и 0 - черный. | |
2050 . | |
2051 .TP | |
2052 .B \-sub-demuxer <[+]название> (только \-subfile only) (БЕТА КОД) | |
2053 Принудительно устанвливает тип демуксера субтитров для \-subfile. | |
2054 Используйте '+' перед названием для принудительного использования, это | |
2055 пропустит некоторые проверки! | |
2056 Указывайте название демуксера таким, как оно выводится опцией \-sub-demuxer help. | |
2057 Для обратной совместимости также допускается ID демуксера, определенный в | |
2058 libmpdemux/\:demuxer.h. | |
2059 . | |
2060 .TP | |
2061 .B \-sub-fuzziness <режим> | |
2062 .\" FIXME | |
2063 Настраивает точность совпадения при поиске субтитров: | |
2064 .PD 0 | |
2065 .RSs | |
2066 .IPs 0 | |
2067 точное совпадение | |
2068 .IPs 1 | |
2069 Загружает все субтитры, содержащие название фильма. | |
2070 .IPs 2 | |
2071 Загружает все субтитры, в текущем каталоге. | |
2072 .RE | |
2073 .PD 1 | |
2074 . | |
2075 .TP | |
2076 .B \-sub-no-text-pp | |
2077 Отключает любые виды постпроцессинга текста, производимого после загрузки | |
2078 субтитров. Используется для отладочных целей. | |
2079 . | |
2080 .TP | |
2081 .B \-subalign <0\-2> (только OSD) | |
2082 Указывает какой край субтитров должен выравниваться по высоте, указанной | |
2083 опцией \-subpos. | |
2084 .PD 0 | |
2085 .RSs | |
2086 .IPs 0 | |
2087 Выравнивают верх субтитров (изначальное поведение). | |
2088 .IPs 1 | |
2089 Выранивает центр субтитров. | |
2090 .IPs 2 | |
2091 Выравнивает нижнюю границу субтитров (по-умолчанию). | |
2092 .RE | |
2093 .PD 1 | |
2094 . | |
2095 .TP | |
2096 .B "\-subcc \ " | |
2097 Отображает DVD Closed Caption (CC) субтитры. | |
2098 Это | |
2099 .B не | |
2100 .\" FIXME i cannot translate this | |
2101 VOB субтитры, это специальные ASCII субтитры для | |
2102 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs. | |
2103 CC subtitles have not been spotted on DVDs from other regions so far. | |
2104 . | |
2105 .TP | |
2106 .B \-subcp <кодировка> (только iconv) | |
2107 Если ваша система поддерживает iconv(3), можно использовать эту опцию для | |
2108 указания кодировки субтитров. | |
2109 .sp 1 | |
2110 .I ПРИМЕР: | |
2111 .PD 0 | |
2112 .RSs | |
2113 \-subcp latin2 | |
2114 .br | |
2115 \-subcp cp1250 | |
2116 .RE | |
2117 .PD 1 | |
2118 . | |
2119 .TP | |
2120 .B \-subcp enca:<язык>:<кодировка при сбое> (только ENCA) | |
2121 Вы можете указать ваш язык, используя двухбуквенный код языка, | |
2122 чтобы дать ENCA вохможность определить кадовую страницу автоматически. | |
2123 Если неуверены, введите что-нибудь и смотрите вывод с \-v, чтобы определить | |
2124 список доступных языков. <кодировка при сбое> указывает кодировку, используемую, | |
2125 когда не срабатывает автоопределение. | |
2126 .sp 1 | |
2127 .I ПРИМЕР: | |
2128 .PD 0 | |
2129 .RSs | |
2130 .IPs "\-subcp enca:cs:latin2" | |
2131 Определяет кодировку, предполагая, что субтитры на Чешском, устанавливает | |
2132 latin 2, если определение не работает. | |
2133 .IPs "\-subcp enca:pl:cp1250" | |
2134 Определяет кодировку для Польского, устанавливает | |
2135 cp1250, если определение не работает. | |
2136 .RE | |
2137 .PD 1 | |
2138 . | |
2139 .TP | |
2140 .B \-subdelay <сек> | |
2141 Отображает субтитры <сек> секунд. | |
2142 Может быть отрицательным. | |
2143 . | |
2144 .TP | |
2145 .B \-subfile <файл> (БЕТА КОД) | |
2146 В данный момент бесполезно. | |
2147 То же, что и \-audiofile, но для потока субтитров (OggDS?). | |
2148 . | |
2149 .TP | |
2150 .B \-subfont-autoscale <0\-3> (только FreeType) | |
2151 Устанавливает режим автомасштабирования. | |
2152 .br | |
2153 .I ЗАМЕЧАНИЕ: | |
2154 0 означает, что масштаб текста и масштаб OSD - это высота шрифта в точках. | |
2155 .sp 1 | |
2156 Режим может быть: | |
2157 .sp 1 | |
2158 .PD 0 | |
2159 .RSs | |
2160 .IPs 0 | |
2161 нет автомасштаба | |
2162 .IPs 1 | |
2163 пропорционально высоте фильма | |
2164 .IPs 2 | |
2165 пропорционально ширине фильма | |
2166 .IPs 3 | |
2167 пропорционально диагонали фильма (по-умолчанию) | |
2168 .RE | |
2169 .PD 1 | |
2170 . | |
2171 .TP | |
2172 .B \-subfont-blur <0\-8> (только FreeType) | |
2173 Указывает радиус размытия шрифта (по-умолчанию: 2). | |
2174 . | |
2175 .TP | |
2176 .B \-subfont-encoding <значение> (только FreeType) | |
2177 Устанавливает кодировку шрифта. | |
2178 Когда установлена в 'unicode', будут рендериться все глифы из файла шрифта и | |
2179 использоваться юникод (по-умолчанию: unicode). | |
2180 . | |
2181 .TP | |
2182 .B \-subfont-osd-scale <0\-100> (только FreeType) | |
2183 Устанавливает коэффициент автомасштаба OSD элементов (по-умолчанию: 6). | |
2184 . | |
2185 .TP | |
2186 .B \-subfont-outline <0\-8> (только FreeType) | |
2187 Устанавливает толщину обрамления шрифта (по-умолчанию: 2). | |
2188 . | |
2189 .TP | |
2190 .B \-subfont-text-scale <0\-100> (только FreeType) | |
2191 Устанавливает коэффициент автомасштаба текста субтитров как | |
2192 процент от размера экрана (по-умолчанию: 5). | |
2193 . | |
2194 .TP | |
2195 .B \-subfps <частота> | |
2196 Указывает частоту кадров файла субтитров (по-умолчанию: fps фильма). | |
2197 .br | |
2198 .I ЗАМЕЧАНИЕ: | |
2199 Только для файлов субтитров, основанных на времени, например MicroDVD формат. | |
2200 . | |
2201 .TP | |
2202 .B \-subpos <0\-100> (имеет смысл только с \-vf expand) (только OSD) | |
2203 Указывает позицию субтитров на экране. | |
2204 Указывается вертикальная позиция субтитров в % от высоты экрана. | |
2205 . | |
2206 .TP | |
2207 .B \-subwidth <10\-100> (только OSD) | |
2208 Указывает максимальную ширину субтитров на экране. | |
2209 Полезно для TV-вывода. | |
2210 Указывается ширина субтитров в % от ширины экрана. | |
2211 . | |
2212 .TP | |
2213 .B \-noterm-osd | |
2214 Отключает отображение сообщений OSD на консоли, когда недоступно никакого видео. | |
2215 . | |
2216 .TP | |
2217 .B \-term-osd-esc <escape последовательность> | |
2218 Указывает escape последовательность выодимую на консоль перед выводом сообщения OSD. | |
2219 Escape последовательность должна передвигать указатель на начало строки, используемой для | |
2220 OSD и очищать ее (по-умолчанию: ^[[A\\r^[[K). | |
2221 . | |
2222 .TP | |
2223 .B \-unicode | |
2224 Указывает MPlayer обрабатывать файл субтитров как unicode. | |
2225 . | |
2226 .TP | |
2227 .B "\-utf8 \ \ " | |
2228 Указывает MPlayer обрабатывать файл субтитров как UTF-8. | |
2229 . | |
2230 .TP | |
2231 .B \-vobsub <VOBsub файл без расширения> | |
2232 Указывает VOBsub файл, используемый для субтитров. | |
20735 | 2233 Должен быть полным путем без расширения, т.е.\& без '.idx', '.ifo' или '.sub'. |
20707 | 2234 . |
2235 .TP | |
2236 .B \-vobsubid <0\-31> | |
2237 Указывает ID субтитров VOBsub. | |
2238 . | |
2239 . | |
2240 . | |
2241 .SH "ОПЦИИ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)" | |
2242 . | |
2243 .TP | |
2244 .B \-abs <значение> (только \-ao oss) (УСТАРЕЛО) | |
2245 Переопределяет размер буфера аудио драйвера/\:карты. | |
2246 . | |
2247 .TP | |
2248 .B \-format <формат> (смотрите также аудио фильтр format) | |
2249 Выбирает формат сэмпла, используемый для вывода со слоя | |
2250 аудио фильтров на звуковую карту. | |
2251 Значения, которые может принимать <формат> перечислены ниже в описании | |
2252 аудио фильтра format. | |
2253 . | |
2254 .TP | |
2255 .B \-mixer <устройство> | |
2256 Использует устройство микшера, отличное от значения по-умолчанию | |
2257 /dev/\:mixer. Для ALSA это название микшера. | |
2258 . | |
2259 .TP | |
2260 .B \-mixer-channel <mixer line>[,mixer index] (только \-ao oss и \-ao) | |
2261 Эта опция укажет MPlayer использовать другой канал для управления | |
2262 громкостью, вместо PCM. Опции для OSS включают | |
2263 .B vol, pcm, line. | |
2264 Полный список опций смотрите в SOUND_DEVICE_NAMES в | |
2265 /usr/\:include/\:linux/\:soundcard.h. | |
2266 Для ALSA вы можете использовать названия, отображаемые, например alsamixer, | |
2267 вроде | |
2268 .B Master, Line, PCM. | |
2269 .br | |
2270 .I ЗАМЕЧАНИЕ: | |
2271 Названия каналов микшера ALSA, с последующими числами должны быть указаны в формате | |
2272 <название,число>, например канал, помеченный 'PCM 1', в alsamixer должен быть | |
2273 преобразован в | |
2274 .BR PCM,1 . | |
2275 . | |
2276 .TP | |
2277 .B \-softvol | |
2278 Принудительно использует программный микшер, вместо микшера звуковой карты. | |
2279 . | |
2280 .TP | |
2281 .B \-softvol-max <10.0\-10000.0> | |
2282 Устанавливает максимальный уровень усиления в процентах (по-умолчанию: 110). | |
2283 Значение 200 позволит вам изменять громкость до величины в два раза | |
2284 превышающей текущий уровень. Со значениями ниже 100 начальный уровень | |
2285 (равный 100%) будет больше максимального, и OSD не мможет отобразить его | |
2286 корректно. | |
2287 . | |
2288 .TP | |
2289 .B \-volstep <0\-100> | |
2290 Устанавливает размер шага изменения громкости микшера в процентах от | |
2291 всего диапазона (по-умолчанию: 3). | |
2292 . | |
2293 . | |
2294 . | |
2295 .SH "ДАЙВЕРЫ ВЫВОДА ЗВУКА (ТОЛЬКО MPLAYER)" | |
2296 Драйверы вывода звука являются интерфейсом к различным средствам вывода звука. | |
2297 Синтаксис: | |
2298 . | |
2299 .TP | |
2300 .B \-ao <драйвер1[:подопция1[=значение]:...],драйвер2,...[,]> | |
2301 Указывает список приоритетности использования драйверов вывода звука. | |
2302 .PP | |
2303 Если список содержит в конце ',' MPlayer в случае проблем будет использовать | |
2304 драйверы, не включенные в список. | |
2305 Подопции необязательны, и в большинстве случаев могут быть опущены. | |
2306 .br | |
2307 .I ЗАМЕЧАНИЕ: | |
2308 Смотрите \-ao help, чтобы получить список встроенных драйверов вывода звука. | |
2309 .sp 1 | |
2310 .I ПРИМЕР: | |
2311 .PD 0 | |
2312 .RSs | |
2313 .IPs "\-ao alsa,oss," | |
2314 Пробуется ALSA драйвер, затем OSS, затем остальные. | |
2315 .IPs "\-ao alsa:noblock:device=hw=0.3" | |
2316 Устанавливает неблокирующий режим и в качестве устройства первую карту, | |
2317 четвертое устройство. | |
2318 .RE | |
2319 .PD 1 | |
2320 .sp 1 | |
2321 Доступные драйверы вывода звука: | |
2322 . | |
2323 .TP | |
2324 .B "alsa\ \ \ " | |
2325 Драйвер вывода звука ALSA 0.9/1.x | |
2326 .PD 0 | |
2327 .RSs | |
2328 .IPs noblock | |
2329 Устанавливает неблокирующий режим. | |
2330 .IPs device=<устройство> | |
2331 Устанавливает название устройства. | |
2332 Замените любые ',' на '.' и любые ':' на '=' в названии устройства ALSA. | |
2333 Для hwac3 вывода через S/PDIF, используйте "iec958" или "spdif" устройство, | |
2334 если вы не знаете как правильно его установить. | |
2335 .RE | |
2336 .PD 1 | |
2337 . | |
2338 .TP | |
2339 .B "alsa5\ \ " | |
2340 Драйвер вывода звука ALSA 0.5 | |
2341 . | |
2342 .TP | |
2343 .B "oss\ \ \ \ " | |
2344 Драйвер вывода звука OSS | |
2345 .PD 0 | |
2346 .RSs | |
2347 .IPs <dsp-устройство> | |
2348 Устанавливает устройство вывода звука (по-умолчанию: /dev/\:dsp). | |
2349 .IPs <mixer-устройство> | |
2350 Устанавливает устройство микширования звука (по-умолчанию: /dev/\:mixer). | |
2351 .IPs <mixer-канал> | |
2352 Устанавливает канал микшера звука (по-умолчанию: pcm). | |
2353 .RE | |
2354 .PD 1 | |
2355 . | |
2356 .TP | |
2357 .B sdl (только SDL) | |
20832 | 2358 Драйвер вывода звука высокоуровневой платформенно-мезависимой библиотеки |
20707 | 2359 SDL (Simple Directmedia Layer) |
2360 .PD 0 | |
2361 .RSs | |
2362 .IPs <драйвер> | |
2363 Явно выбирает используемый SDL драйвер (по-умолчанию: на усмотрение SDL). | |
2364 .RE | |
2365 .PD 1 | |
2366 . | |
2367 .TP | |
2368 .B "arts\ \ \ " | |
2369 Драйвер вывода звука через демон aRts | |
2370 . | |
2371 .TP | |
2372 .B "esd\ \ \ \ " | |
2373 Драйвер вывода звука через демон ESD | |
2374 .PD 0 | |
2375 .RSs | |
2376 .IPs <сервер> | |
2377 Явно выбирает используемый ESD сервер (по-умолчанию: localhost). | |
2378 .RE | |
2379 .PD 1 | |
2380 . | |
2381 .TP | |
2382 .B "jack\ \ \ \ " | |
2383 Драйвер вывода звука через JACK (Jack Audio Connection Kit) | |
2384 .PD 0 | |
2385 .RSs | |
2386 .IPs port=<имя> | |
2387 Указывает присоединяться к портам с указанным именем (по-умолчанию: physical ports). | |
2388 .IPs name=<имя клиента> | |
2389 Имя клиента, передаваемое JACK (по-умолчанию: MPlayer [<PID>]). | |
2390 Полезно, если вы хотите автоматически устанавливать определенные соединения. | |
2391 .IPs (no)estimate | |
2392 Оценка задержки аудио, предлагаемой для более плавного воспроизведения видео | |
2393 (по-умодчанию: включено). | |
2394 .RE | |
2395 .PD 1 | |
2396 . | |
2397 .TP | |
2398 .B "nas\ \ \ \ " | |
2399 Драйвер вывода звука через NAS | |
2400 . | |
2401 .TP | |
2402 .B macosx (только Mac OS X) | |
2403 Родной драйвер вывода звука Mac OS X | |
2404 . | |
2405 .TP | |
2406 .B openal | |
2407 Экспериментальный, незавершенный (будет сводить в моно) драйвер выода OpenAL | |
2408 . | |
2409 .TP | |
2410 .B sgi (только SGI) | |
2411 Родной драйвер вывода звука SGI | |
2412 .PD 0 | |
2413 .RSs | |
2414 .IPs "<имя устройства вывода>" | |
2415 Явно выбирает используемое устройство/\:интерфейс вывода | |
2416 (по-умолчанию: системное значение по-умолчанию). | |
2417 Например, 'Analog Out' или 'Digital Out'. | |
2418 .RE | |
2419 .PD 1 | |
2420 . | |
2421 .TP | |
2422 .B sun (только Sun) | |
2423 Родной драйвер вывода звука Sun | |
2424 .PD 0 | |
2425 .RSs | |
2426 .IPs <device> | |
2427 Явно выбирает используемое устройство вывода (по-умолчанию: /dev/\:audio). | |
2428 .RE | |
2429 .PD 1 | |
2430 . | |
2431 .TP | |
2432 .B win32 (только Windows) | |
2433 Родной waveout драйвер вывода звука Windows | |
2434 . | |
2435 .TP | |
2436 .B dsound (только Windows) | |
2437 Драйвер вывода звука DirectX DirectSound | |
2438 .PD 0 | |
2439 .RSs | |
2440 .IPs device=<номер устройства> | |
2441 Устанавливает номер используемого устройства. | |
2442 Воспроизведение файла с \-v покажет список доступных устройств. | |
2443 .RE | |
2444 .PD 1 | |
2445 . | |
2446 .TP | |
2447 .B dxr2 (смотрите также \-dxr2) (только DXR2) | |
2448 Специальный драйвер вывода для Creative DXR2 | |
2449 . | |
2450 .TP | |
2451 .B ivtv (только IVTV) | |
2452 Специальный IVTV MPEG драйвер вывода. | |
2453 Работает только с \-ac hwmpa. | |
2454 . | |
2455 .TP | |
2456 .B mpegpes (только DVB) | |
2457 Драйвер вывода звука для DVB карт, записывающий вывод в MPEG-PES файл, | |
2458 если не установлено DVB карт. | |
2459 .PD 0 | |
2460 .RSs | |
2461 .IPs card=<1\-4> | |
2462 Используемая DVB карта, если установлено более одной. | |
2463 .IPs file=<файл> | |
2464 Имя выходного файла | |
2465 .RE | |
2466 .PD 1 | |
2467 . | |
2468 .TP | |
2469 .B "null\ \ \ " | |
2470 Не выводит никакого звука, но сохранаяет скорость воспроизведения видео. | |
2471 Используйте \-nosound для тестов производительности. | |
2472 . | |
2473 .TP | |
2474 .B "pcm\ \ \ \ " | |
2475 Драйвер вывода в файл сырого PCM/wave | |
2476 .PD 0 | |
2477 .RSs | |
2478 .IPs (no)waveheader | |
2479 Включает или не включает заголовок wave (по-умолчанию: включен). | |
2480 Если не включен, генерируется сырой PCM. | |
2481 .IPs file=<файл> | |
2482 Записывает звук в <файл> вместо audiodump.wav. | |
2483 Если указано nowaveheader, то по-умолчанию используется audiodump.pcm. | |
2484 .IPs "fast\ " | |
2485 Пытается выводить быстрее реальной скорости. | |
2486 Убедитесь, что вывод не обрезан (обычно с сообщением | |
2487 "Too many video packets in buffer"). | |
2488 Это нормально, если вы получаете сообщение | |
2489 "Your system is too SLOW to play this!". | |
2490 .RE | |
2491 .PD 1 | |
2492 . | |
2493 .TP | |
2494 .B "plugin\ \ " | |
2495 Драйвер вывода звука plugin | |
2496 . | |
2497 . | |
2498 . | |
2499 .SH "ОПЦИИ ВЫВОДА ВИДЕО (ТОЛЬКО MPLAYER)" | |
2500 . | |
2501 .TP | |
2502 .B \-adapter <значение> | |
2503 Указывает видеокарту, на которую будет выводиться изображение. | |
2504 Список доступных карт можно получить, указав эту опцию совместно с \-v. | |
2505 В данный момент работает только с directx драйвером вывода видео. | |
2506 . | |
2507 .TP | |
2508 .B \-bpp <глубина> | |
2509 Переназначает определенную автоматически глубину цвета. | |
2510 Поддерживается только fbdev, dga, svga, vesa драйверами. | |
2511 . | |
2512 .TP | |
2513 .B \-border | |
2514 Воспроизводит фильм в окне с рамками и оформлением. | |
2515 Поскольку это действие по-умолчанию, используйте \-noborder | |
2516 для отключения стандартного оформления окон. | |
2517 Поддерживается драйвером directx. | |
2518 . | |
2519 .TP | |
2520 .B \-brightness <-100\-100> | |
2521 Настраивает яркость видео сигнала (по-умолчанию: 0). | |
2522 Поддерживается не всеми драйверами. | |
2523 . | |
2524 .TP | |
2525 .B \-contrast <-100\-100> | |
2526 Настраивает контрастность видеосигнала (по-умолчанию: 0). | |
2527 Поддерживается не всеми драйверами. | |
2528 . | |
2529 .TP | |
2530 .B \-display <имя> (только X11) | |
2531 Указывает имя хоста и номер дисплея X сервера, на котором вы хотите выводить | |
2532 изображение. | |
2533 .sp 1 | |
2534 .I ПРИМЕР: | |
2535 .PD 0 | |
2536 .RSs | |
2537 \-display xtest.localdomain:0 | |
2538 .RE | |
2539 .PD 1 | |
2540 . | |
2541 .TP | |
2542 .B "\-dr \ \ \ " | |
2543 Включает direct rendering (поддерживается не всеми кодеками и драйверами вывода). | |
2544 .br | |
2545 .I ВНИМАНИЕ: | |
2546 Может привести к испорченным OSD/SUB! | |
2547 . | |
2548 .TP | |
2549 .B \-dxr2 <опция1:опция2:...> | |
2550 Эта опция используется для управления драйвером dxr2. | |
2551 .RSs | |
2552 .IPs ar-mode=<значение> | |
2553 пропорции (0 = normal, 1 = pan-and-scan, 2 = letterbox (по-умолчанию)) | |
2554 .IPs iec958-encoded | |
2555 устанавливает режим вывода iec958 в encoded. | |
2556 .IPs iec958-decoded | |
2557 устанавливает режим вывода iec958 в decoded (по-умолчанию). | |
2558 .IPs macrovision=<значение> | |
2559 режим macrovision (0 = выключено (по-умолчанию), 1 = agc, 2 = agc 2 colorstripe, | |
2560 3 = agc 4 colorstripe) | |
2561 .IPs "mute\ " | |
2562 отключает вывод звука | |
2563 .IPs unmute | |
2564 включает вывод звука | |
2565 .IPs ucode=<значение> | |
2566 путь к микрокоду | |
2567 .RE | |
2568 .RS | |
2569 .sp 1 | |
2570 .I TV вывод | |
2571 .RE | |
2572 .RSs | |
2573 .IPs 75ire | |
2574 включает режим вывода 7.5 IRE | |
2575 .IPs no75ire | |
2576 отключает режим вывода 7.5 IRE (по-умолчанию) | |
2577 .IPs "bw\ \ \ " | |
2578 ч/б TV вывод | |
2579 .IPs color | |
2580 цветной TV вывод (по-умолчанию) | |
2581 .IPs interlaced | |
2582 черезстрочный TV вывод (по-умолчанию) | |
2583 .IPs nointerlaced | |
2584 отключает черезстрочный TV вывод | |
2585 .IPs norm=<значение> | |
2586 TV стандарт (ntsc (по-умолчанию), pal, pal60, palm, paln, palnc) | |
2587 .IPs square-pixel | |
2588 устанавливает режим пиксела в square | |
2589 .IPs ccir601-pixel | |
2590 устанавливает режим пиксела в ccir601 | |
2591 .RE | |
2592 .RS | |
2593 .sp 1 | |
2594 .I оверлей | |
2595 .RE | |
2596 .RSs | |
2597 .IPs cr-left=<0\-500> | |
2598 Устанавливает левую границу обрезания (по-умолчанию: 50). | |
2599 .IPs cr-right=<0\-500> | |
2600 Устанавливает правую границу обрезания (по-умолчанию: 300). | |
2601 .IPs cr-top=<0\-500> | |
2602 Устанавливает верхнюю границу обрезания (по-умолчанию: 0). | |
2603 .IPs cr-bottom=<0\-500> | |
2604 Устанавливает нижнюю границу обрезания (по-умолчанию: 0). | |
2605 .IPs ck-[r|g|b]=<0\-255> | |
2606 Устанавливает величину красной(r), зеленой(g), синей (b) компоненты ключевого цвета оверлея. | |
2607 .IPs ck-[r|g|b]min=<0\-255> | |
2608 Минимальное значение для соответствующей компоненты ключевого цвета | |
2609 .IPs ck-[r|g|b]max=<0\-255> | |
2610 Максимальное значение для соответствующей компоненты ключевого цвета | |
2611 .IPs ignore-cache | |
2612 Игнорирует кешированные установки оверлея. | |
2613 .IPs update-cache | |
2614 Обновляет кешированные установки оверлея. | |
2615 .IPs ol-osd | |
2616 Включает оверлейный OSD. | |
2617 .IPs nool-osd | |
2618 Отключает оверлейный OSD (по-умолчанию). | |
2619 .IPs ol[h|w|x|y]-cor=<-20\-20> | |
2620 Настраивает размер (высоту(h),ширину(w)) и положение (x,y) оверлея | |
2621 в случает, когда он не точно соответствует окну (по-умолчанию: 0). | |
2622 .IPs overlay | |
2623 Активирует оверлей (по-умолчанию). | |
2624 .IPs nooverlay | |
2625 Автивирует TV выход. | |
2626 .IPs overlay-ratio=<1\-2500> | |
2627 Настраивает оверлей (по-умолчанию: 1000). | |
2628 .RE | |
2629 . | |
2630 .TP | |
2631 .B \-fbmode <режим> (только \-vo fbdev) | |
2632 Меняет видео режим на помеченный как <режим> в /etc/\:fb.modes. | |
2633 .br | |
2634 .I ЗАМЕЧАНИЕ: | |
2635 VESA фреймбуфер не поддерживает смену режима. | |
2636 . | |
2637 .TP | |
2638 .B \-fbmodeconfig <файл> (только \-vo fbdev) | |
2639 Переопределяет файл конфигурации режимов фреймбуфера (по-умолчанию: /etc/\:fb.modes). | |
2640 . | |
2641 .TP | |
2642 .B \-fs (смотрите также \-zoom) | |
2643 Полноэкранное воспроизведение (центрирует изображение и рисует черные рамки вокруг него). | |
2644 Поддерживается не всеми драйверами. | |
2645 . | |
2646 .TP | |
2647 .B \-fsmode-dontuse <0\-31> (УСТАРЕЛО, используйте опцию \-fs) | |
2648 Попробуйте эту опцию, если у вас по-прежнему проблемы с полноэкранным режимом. | |
2649 . | |
2650 .TP | |
2651 .B \-fstype <тип1,тип2,...> (только X11) | |
2652 Указывает список используемых полноэкранных режимов в порядке приоритета. | |
2653 Вы можете овергнуть режимы, ставя перед ними '\-'. | |
2654 Если у вас возникают проблемы вроде перекрывания полноэкранного окна другими, | |
2655 попробуйте использовать другой порядок. | |
2656 .br | |
2657 .I ЗАМЕЧАНИЕ: | |
2658 Список доступных типов можно получить опцией \-fstype help. | |
2659 .sp 1 | |
2660 Допустиные типы: | |
2661 .sp 1 | |
2662 .PD 0 | |
2663 .RSs | |
2664 .IPs above | |
2665 Использует подсказку _NETWM_STATE_ABOVE, если доступна. | |
2666 .IPs below | |
2667 Использует подсказку _NETWM_STATE_BELOW, если доступна. | |
2668 .IPs fullscreen | |
2669 Использует подсказку _NETWM_STATE_FULLSCREEN, если доступна. | |
2670 .IPs layer | |
2671 Использует подсказку _WIN_LAYER со слоем по-умолчанию. | |
2672 .IPs layer=<0...15> | |
2673 Использует подсказку _WIN_LAYER со слоем с указанным номером. | |
2674 .IPs netwm | |
2675 Принудительно указывает стиль NETWM. | |
2676 .IPs "none\ " | |
2677 Указывает не устанавливать слой полноэкранного окна. | |
2678 .IPs stays_on_top | |
2679 Использует подсказку _NETWM_STATE_STAYS_ON_TOP, если доступна. | |
2680 .REss | |
2681 .sp 1 | |
2682 .RS | |
2683 .I ПРИМЕР: | |
2684 .RE | |
2685 .PD 0 | |
2686 .RSs | |
2687 .IPs layer,stays_on_top,above,fullscreen | |
2688 Порядок по-умолчанию, будет использоваться, если указан некорректный или | |
2689 неподдерживаемый режим. | |
2690 .IPs \-fullscreen | |
2691 Исправляет переключение в полноэкранный режим в OpenBox 1.x. | |
2692 .RE | |
2693 .PD 1 | |
2694 . | |
2695 .TP | |
2696 .B \-geometry x[%][:y[%]] или [WxH][+x+y] | |
2697 Настраивает место появления на экране изображения. | |
2698 x и y указываются в пикселах, считая от верхнего левого до нижнего правого | |
2699 угла выводимого изображения. Если после значения указан символ процента, то | |
2700 оно превращается в процентное относительно размера экрана в соответствующем | |
2701 направлении. Опция также поддерживает стандартный формат X11 опции \-geometry. | |
2702 Если опцией \-wid указано внешнее окно, то координаты x и y указываются относительно | |
2703 его левого верхнего угла, а не экранного. | |
2704 .br | |
2705 .I ЗАМЕЧАНИЕ: | |
2706 Эта опция поддерживается только драйверами x11, xmga, xv, xvmc, xvidix, | |
2707 gl, gl2, directx и tdfxfb. | |
2708 .sp 1 | |
2709 .I ПРИМЕР: | |
2710 .PD 0 | |
2711 .RSs | |
2712 .IPs 50:40 | |
2713 Располагает окно в позиции x=50, y=40. | |
2714 .IPs 50%:50% | |
2715 Располагает окно в центре экрана. | |
2716 .IPs "100%\ " | |
2717 Располагает окно у центра правой границы экрана. | |
2718 .IPs 100%:100% | |
2719 Располагает окно у правого нижнего угла экрана. | |
2720 .RE | |
2721 .PD 1 | |
2722 . | |
2723 .TP | |
2724 .B \-guiwid <ID окна> (смотрите также \-wid) (только GUI) | |
2725 Опция указывает GUI использовать также X11 окно и прицепить себя к нижней | |
2726 части видео окна, что полезно для внедрения мини-GUI в браузер | |
2727 (с плагином MPlayer). | |
2728 . | |
2729 .TP | |
2730 .B \-hue <-100\-100> | |
2731 Настраивает цветность видеосигнала (по-умолчанию: 0). | |
2732 С этой опцией вы можете получить цветной негатив. | |
2733 Поддерживается не всеми драйверами. | |
2734 . | |
2735 .TP | |
2736 .B \-monitor-dotclock <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2737 Указывает диапазон значений dotclock или pixelclock монитора. | |
2738 . | |
2739 .TP | |
2740 .B \-monitor-hfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2741 Указывает диапазон значений горизонтальной частоты монитора. | |
2742 . | |
2743 .TP | |
2744 .B \-monitor-vfreq <диапазон[,диапазон,...]> (только \-vo fbdev и vesa) | |
2745 Указывает диапазон значений вертикальной частоты монитора. | |
2746 . | |
2747 .TP | |
2748 .B \-monitoraspect <значение> (смотрите также \-aspect) | |
2749 Указывает пропорции монитора или TV экрана. | |
2750 .sp 1 | |
2751 .I ПРИМЕР: | |
2752 .PD 0 | |
2753 .RSs | |
2754 \-monitoraspect 4:3 or 1.3333 | |
2755 .br | |
2756 \-monitoraspect 16:9 or 1.7777 | |
2757 .RE | |
2758 .PD 1 | |
2759 . | |
2760 .TP | |
2761 .B \-monitorpixelaspect <значение> (смотрите \-aspect) | |
2762 Устанавливает пропорции отдельного пиксела вашего монитора или TV | |
2763 экрана (по-умолчанию: отключено). | |
2764 Переопределяет установки \-monitoraspect. | |
2765 Значение 0 отключает, значение 1 означает квадратные пикселы | |
2766 (верно для (почти?) всех LCD). | |
2767 . | |
2768 .TP | |
2769 .B \-nodouble | |
2770 Отключает двойную буферизацию, используется, как правило, для целей откладки. | |
2771 Двойная буферизация исправляет мерцание, храня два кадра в памяти и | |
2772 отображая один из них, в то время, как декодируется второй. | |
2773 Это может негативно сказаться на OSD, но в большинстве случаев | |
2774 убирает мерцание OSD. | |
2775 . | |
2776 .TP | |
2777 .B \-nograbpointer | |
2778 Указывает не захватывать указатель мыши после смены видео режима (\-vm). | |
2779 Полезно для многоголовых конфигураций. | |
2780 . | |
2781 .TP | |
2782 .B \-nokeepaspect | |
2783 Указывает ге сохранять пропорции окна при изменении размера. | |
2784 Работает только с драйверами x11, xv, xmga, xvidix, directx. | |
2785 Кроме того, под X11 ваш оконный менеджер должен понимать подсказку | |
2786 созранения пропорций окна. | |
2787 . | |
2788 .TP | |
2789 .B "\-ontop\ " | |
2790 Помещает и сохраняет окно проигрывателя поверх всех окон. | |
2791 Поддерживается всеми драйверами, использующими X11, за | |
2792 исчключением SDL, а также драйверами directx, macosx, | |
2793 quartz, ggi и gl2. | |
2794 . | |
2795 .TP | |
2796 .B \-panscan <0.0\-1.0> | |
2797 Задействует функциональность pan-and-scan (обрезая стороны в соответствии | |
2798 с пропорциями, чтобы, например 16:9, фильм поместился на 4:3 экране | |
2799 без черных полос). Диапазон указывает какая часть изображения обрезается. | |
2800 Работает только с xv, xmga, mga, gl, gl2, quartz, macosx и xvidix драйверами. | |
2801 . | |
2802 .TP | |
2803 .B \-panscanrange <-19.0\-99.0> (экспериментальное) | |
2804 Изменяет диапазон pan-and-scan функциональности (по-умолчанию: 1). | |
2805 Положительные значения означают множитель диапазона по-умолчанию. | |
2806 Отрицательные значения означают, что можно увеличивать изображение | |
2807 до \-panscanrange+1 раз. | |
2808 Например \-panscanrange -3 означает увеличение вплоть до 4 раз. | |
2809 Это экспериментальная возможность. | |
2810 Не сообщайте об ошибках в ней, за исключением случая использования \-vo gl. | |
2811 . | |
2812 .TP | |
2813 .B \-refreshrate <Гц> | |
2814 Устанавливает частоту обновления монитора в Гц. | |
2815 В данный момент поддерживается только \-vo directx совместно с \-vm. | |
2816 . | |
2817 .TP | |
2818 .B \-rootwin | |
2819 Воспроизводит фильм на главном окне (фоне рабочего стола). | |
2820 Однако, фон рабочего стола может отображаться поверх изображения. | |
2821 Работает только с x11, xv, xmga, xvidix, quartz, macosx и directx драйверами. | |
2822 . | |
2823 .TP | |
2824 .B \-saturation <-100\-100> | |
2825 Настраивает насыщенность видео сигнала (по-умолчанию: 0). | |
2826 С этой опцией вы можете получить изображения в оттенках серого. | |
2827 Поддерживается не всеми драйверами. | |
2828 . | |
2829 .TP | |
2830 .B \-screenh <пикселов> | |
2831 Указывает вертикальное разрешение экрана для драйверов, которые не могут | |
2832 определить его самостоятельно, таких как fbdev, x11 и TVout. | |
2833 . | |
2834 .TP | |
2835 .B \-screenw <пикселов> | |
2836 Указывает горизонтальное разрешение экрана для драйверов, которые не могут | |
2837 определить его самостоятельно, таких как fbdev, x11 и TVout. | |
2838 . | |
2839 .TP | |
2840 .B \-stop-xscreensaver (только X11) | |
2841 Отключает xscreensaver при запуске и снова включает его при выходе. | |
2842 . | |
2843 .TP | |
2844 .B "\-vm \ \ \ " | |
2845 Пытается переключиться в другой видео режим. | |
2846 Поддерживается dga, x11, xv, sdl и directx драйверами. | |
2847 Если используется с directx драйвером, для изменения режима | |
2848 можно использовать опции \-screenw, \-screenh, \-bpp и \-refreshrate. | |
2849 . | |
2850 .TP | |
2851 .B "\-vsync \ \ " | |
2852 Включает VBI для vesa, dfbmga и svga драйверов. | |
2853 . | |
2854 .TP | |
2855 .B \-wid <ID окна> (смотрите также \-guiwid) (только X11, OpenGL и DirectX) | |
2856 Говорит MPlayer присоединиться к существующему окну. | |
2857 Полезно для внедрения MPlayer в браузер (например, расширение plugger). | |
2858 . | |
2859 .TP | |
2860 .B \-xineramascreen <\-2\-...> (только X11) | |
2861 В Xinerama конфигурациях (например, единственный рабочий стол, растянутый на | |
2862 несклько экранов) эта опция указывает MPlayer на каком из них показывать | |
2863 фильм. Значение \-2 означает полноэкранный режим на весь виртуальный экран, | |
2864 \-1 означает полноэкранный режим на экране с текущим окном. | |
2865 Начальная позиция устанавливается опцией \-geometry относительно указаного | |
2866 экрана. Как правило будет работать только с "\-fstype \-fullscreen" или | |
2867 "\-fstype none". | |
2868 . | |
2869 .TP | |
2870 .B \-zrbw (только \-vo zr) | |
2871 Показывает черно-белое изображение. | |
2872 Для оптимальной производительности может комбинироваться с '\-lavdopts gray'. | |
2873 . | |
2874 .TP | |
2875 .B \-zrcrop <[ширина]x[высота]+[x смещение]+[y смещение]> (только \-vo zr) | |
2876 Выбирает часть исходного изображения для показа, неоднократное указание | |
2877 этой опции включает режим cinerama. | |
2878 В режиме cinerama фильм распределяется по нескольким TV (или проекторам) для | |
2879 создания большей картинки. | |
2880 Опции, указаанные после n-ой \-zrcrop применяются к n-ой MJPEG карте, | |
2881 для каждой карты нужно указать, как минимум, \-zrdev в дополнении к \-zrcrop. | |
2882 Для примера смотрите вывод \-zrhelp и раздел Zr документации. | |
2883 . | |
2884 .TP | |
2885 .B \-zrdev <устройство> (только \-vo zr) | |
2886 Указывает файл устройства, относящийся к вашей MJPEG карте, по-умолчанию | |
2887 драйвер zr устанавливает ее в первое найденное v4l устройство. | |
2888 . | |
2889 .TP | |
2890 .B \-zrfd (только \-vo zr) | |
2891 Принудительное прореживание: Прореживание, указаное опциями \-zrhdec | |
2892 и \-zrvdec, применяется, только если аппаратный scaler может растянуть | |
2893 изображение до его исходного размера. | |
2894 Используйте эту опцию, чтобы форсировать прореживание. | |
2895 . | |
2896 .TP | |
2897 .B \-zrhdec <1|2|4> (только \-vo zr) | |
2898 Горизонтальное прореживание: Запрашивает драйвер отправлять только | |
2899 каждый 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
2900 использовать scaler MJPEG карты для растягивания изображения до | |
2901 исходного размера. | |
2902 . | |
2903 .TP | |
2904 .B \-zrhelp (только \-vo zr) | |
2905 Отображает список всех \-zr* опций, их значения по-умолчанию и | |
2906 пример режима cinerama. | |
2907 . | |
2908 .TP | |
2909 .B \-zrnorm <стандарт> (только \-vo zr) | |
2910 Указывает TV стандарт в PAL или NTSC (по-умолчанию: без изменения). | |
2911 . | |
2912 .TP | |
2913 .B \-zrquality <1\-20> (только \-vo) | |
2914 Число от 1 (наилучшее) до 20 (наихудшее) представляющее качество | |
2915 кодирования JPEG. | |
2916 . | |
2917 . | |
2918 .TP | |
2919 .B \-zrvdec <1|2|4> (только \-vo zr) | |
2920 Вертикальное прореживание: Запрашивает драйвер отправлять только | |
2921 каждую 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
2922 использовать scaler MJPEG карты для растягивания изображения до | |
2923 исходного размера. | |
2924 . | |
2925 .TP | |
2926 .B \-zrxdoff <x смещение на экране> (только \-vo zr) | |
2927 Если изображение меньше, чем TV экран, эта опция указывает смещение | |
2928 по x от верхнего левого угла TV экрана (по-умолчанию: центировано). | |
2929 . | |
2930 .TP | |
2931 .B \-zrydoff <y смещение на экране> (только \-vo zr) | |
2932 Если изображение меньше, чем TV экран, эта опция указывает смещение | |
2933 по y от верхнего левого угла TV экрана (по-умолчанию: центировано). | |
2934 . | |
2935 . | |
2936 . | |
20832 | 2937 .SH "ДРАЙВЕРЫ ВЫВОДА ВИДЕО (ТОЛЬКО MPLAYER)" |
2938 Драйверы вывода видео - это интерфейсы к различным средствам вывода видео. | |
2939 Синтаксис: | |
2940 . | |
2941 .TP | |
2942 .B \-vo <драйвер1[:подопция1[=значение]:...],драйвер2,...[,]> | |
2943 Указывает список используемых драйверов в порядке приоритетности. | |
20707 | 2944 .PP |
20832 | 2945 Если список содержит завершающую ',', то MPlayer в случае проблем будет |
2946 использовать драйверы, не содержащиеся в списке. | |
2947 Подопции необязательны и в большинстве опций могут быть опущены. | |
2948 .br | |
2949 .I ЗАМЕЧАНИЕ: | |
2950 Полный список скомпилированных драйверов вывода видео можно получить | |
2951 опцией \-vo help. | |
2952 .sp 1 | |
2953 .I ПРИМЕР: | |
20707 | 2954 .PD 0 |
2955 .RSs | |
2956 .IPs "\-vo xmga,xv," | |
20832 | 2957 Пробует X11 Matrox драйвер, затем Xv драйвер, затем остальные. |
20707 | 2958 .IPs "\-vo directx:noaccel" |
20832 | 2959 Использует DirectX драйвер без ускорения. |
2960 .RE | |
2961 .PD 1 | |
2962 .sp 1 | |
2963 Допустимые драйверы: | |
2964 . | |
2965 .TP | |
2966 .B xv (только X11 only) | |
2967 Использует XVideo расширение XFree86 4.x для задействования аппаратно | |
2968 ускоренного воспроизведения. | |
2969 Если вы не можете использовать специальный драйвер для вашего | |
2970 оборудования, то выбор этого, возможно, будет лучшим решением. | |
2971 Чтобы узнать информацию об используемом цветовом ключе и способе его отображения, | |
2972 запустите MPlayer с опцией \-v и обратите внимание на строки, помеченные | |
2973 [xv common] в начале. | |
2974 .PD 0 | |
2975 .RSs | |
2976 .IPs port=<число> | |
2977 Выбирает указанный XVideo порт. | |
20707 | 2978 .IPs ck=<cur|use|set> |
20832 | 2979 Выбирает источник, из которого берется цветовой ключ (по-умолчанию: cur). |
20707 | 2980 .RSss |
2981 .IPs cur | |
20832 | 2982 Значение по-умолчанию цветового ключа берется из текущих установок Xv. |
20707 | 2983 .IPs use |
20832 | 2984 Указывает использовать, но не устанавливать цветовой ключ MPlayer |
2985 (используйте опцию \-colorkey для его изменения). | |
20707 | 2986 .IPs set |
20832 | 2987 То же, что и предыдущее, но также устанавливает указанный цветовой ключ. |
20707 | 2988 .RE |
2989 .IPs ck-method=<man|bg|auto> | |
20832 | 2990 Устанавливает метод отрисовки цветового ключа (по-умолчанию: man). |
20707 | 2991 .RSss |
2992 .IPs man | |
20832 | 2993 Указывает рисовать цветовой ключ самостоятельно (уменьшает мерцание в некоторых случаях). |
20707 | 2994 .IPs bg |
20832 | 2995 Устанавливает цветовой ключ в качестве фона окна. |
20707 | 2996 .IPs auto |
20832 | 2997 Предоставляет Xv отрисовывать цветовой ключ. |
2998 .RE | |
2999 .RE | |
3000 .PD 1 | |
3001 . | |
3002 .TP | |
3003 .B x11 (только X11) | |
3004 Драйвер вывода видео с разделением памяти без аппаратного ускорения, | |
3005 работает везде, где есть X11. | |
3006 . | |
3007 .TP | |
3008 .B xover (только X11) | |
3009 Добавляет поддержку X11 ко всем драйверам, основанным на оверлее. | |
3010 В данный момент поддерживается только драйвером tdfx_vid. | |
20707 | 3011 .PD 0 |
3012 .RSs | |
3013 .IPs <vo_driver> | |
20832 | 3014 Выбирает драйвер, используемый в качестве источника к оверлею |
3015 поверх X11. | |
3016 .RE | |
3017 .PD 1 | |
3018 . | |
3019 .TP | |
3020 .B xvmc (только X11 с \-vc ffmpeg12mc) | |
3021 Драйвер, использующий расширение XvMC (X Video Motion Compensation) | |
3022 XFree86 4.x для ускорения декодирования MPEG-1/2 и VCR2. | |
3023 .PD 0 | |
3024 .RSs | |
3025 .IPs port=<число> | |
3026 Выбирает указанный XVideo порт. | |
20707 | 3027 .IPs (no)benchmark |
20832 | 3028 Отключает показ изображения. |
3029 Необходимо для правильного теста производительности | |
3030 драйверов, изменяющих буферы изображения только | |
3031 .\" FIXME правильно ли переведено monitor retrace ? | |
3032 между циклами обновления изображения на мониторе (nVidia). | |
3033 По-умолчанию, отображение экрана не отключается (nobenchmark). | |
20707 | 3034 .IPs (no)bobdeint |
20832 | 3035 Очень простой деинтерлейсер. |
3036 Может быть не лучше, чем \-vf tfields=1, но это | |
3037 единственный деинтерлейсер для xvmc (по-умолчанию: nobobdeint). | |
20707 | 3038 .IPs (no)queue |
20832 | 3039 Помещает кадры для отображения в очередь, чтобы сильнее распараллелить |
3040 работу видео оборудования. | |
3041 Может добавить маленькую (незначительную) постоянную A/V рассинхронизацию | |
3042 (по-умолчанию: noqueue). | |
20707 | 3043 .IPs (no)sleep |
20832 | 3044 Указывает использовать функцию sleep для ожидания конца рендеринга |
3045 (не рекомендуется в Linux) (по-умолчанию: nosleep). | |
20707 | 3046 .IPs ck=cur|use|set |
20832 | 3047 То же, что и \-vo xv:ck (смотрите \-vo xv). |
20707 | 3048 .IPs ck-method=man|bg|auto |
20832 | 3049 То же, что и \-vo xv:ck-method (смотрите \-vo xv). |
3050 .RE | |
3051 .PD 1 | |
3052 . | |
3053 .TP | |
3054 .B dga (только X11) | |
3055 Воспроизводит видео через XFree86 расширение Direct Graphics Access. | |
3056 Считается устаревшим. | |
3057 . | |
3058 .TP | |
3059 .B sdl (только SDL) | |
3060 Драйвер вывода видео с помощью высокоуровневой, платформенно-независимой | |
3061 библиотеки SDL (Simple Directmedia Layer). | |
3062 Поскольку SDL использует свой собственный слой X11, X11 опции MPlayer | |
3063 не будут иметь никакого эффекта на SDL. | |
3064 .PD 0 | |
3065 .RSs | |
3066 .IPs driver=<драйвер> | |
3067 Явно выбирает используемый SDL драйвер. | |
20707 | 3068 .IPs (no)forcexv |
20832 | 3069 Указывает использовать XVideo через видео драйвер sdl (по-умолчанию: forcexv). |
20707 | 3070 .IPs (no)hwaccel |
20832 | 3071 .\" FIXME scaler |
3072 Указывает использовать аппаратно ускоренное масштабирование (по-умолчанию: hwaccel). | |
20707 | 3073 .RE |
3074 .PD 1 | |
3075 . | |
3076 .TP | |
3077 .B "vidix\ \ " | |
20832 | 3078 VIDIX (VIDeo Interface for *niX, видео интерфейс для *nix) - это интерфейс |
3079 к возможностям ускорения видео различных графических карт. | |
3080 Очень быстрый драйвер вывода видео для карт, его поддерживающих. | |
3081 .PD 0 | |
3082 .RSs | |
3083 .IPs <подустройство> | |
3084 .\" FIXME "подустройства" | |
3085 Явно выбирает используемый драйвер подустройства VIDIX. | |
3086 Доступные драйверы подустройств: cyberblade_vid.so, mach64_vid.so, | |
20707 | 3087 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so, |
20832 | 3088 radeon_vid.so, rage128_vid.so, sis_vid.so и unichrome_vid.so. |
3089 .RE | |
3090 .PD 1 | |
3091 . | |
3092 .TP | |
3093 .B xvidix (только X11 only) | |
3094 X11 фронтенд для VIDIX | |
3095 .PD 0 | |
3096 .RSs | |
3097 .IPs <подустройство> | |
3098 То же, что и для vidix | |
20707 | 3099 .RE |
3100 .PD 1 | |
3101 . | |
3102 .TP | |
3103 .B "cvidix\ " | |
20832 | 3104 Универсальный и платформенно-независимый VIDIX фронтенд, с картами nVidia может работать |
3105 даже в текстовой консоли. | |
3106 .PD 0 | |
3107 .RSs | |
3108 .IPs <подустройство> | |
3109 То же, что и для vidix | |
3110 .RE | |
3111 .PD 1 | |
3112 . | |
3113 .TP | |
3114 .B winvidix (только Windows) | |
3115 Windows фронтенд для VIDIX | |
3116 .PD 0 | |
3117 .RSs | |
3118 .IPs <подустройство> | |
3119 То же, что и для vidix | |
20707 | 3120 .RE |
3121 .PD 1 | |
3122 . | |
3123 .TP | |
3124 .B directx (Windows only) | |
20832 | 3125 Драйвер вывода видео, использующий DirectX интерфейс. |
20707 | 3126 .PD 0 |
3127 .RSs | |
3128 .IPs noaccel | |
20832 | 3129 Отключает аппаратное ускорение. |
3130 Попробуйте эту опцию, если у вас проблемы с отображением. | |
3131 .RE | |
3132 .PD 1 | |
3133 . | |
3134 .TP | |
3135 .B quartz (только Mac OS X) | |
3136 Драйвер вывода видео Mac OS X Quartz. | |
3137 В некоторых случаях, форсирование пакованного выходного формата YUV с, | |
3138 например, \-vf format=yuy2, может быть более эффективным. | |
3139 .PD 0 | |
3140 .RSs | |
3141 .IPs device_id=<число> | |
3142 Выбирает устройство отображения для использования в полноэкранном режиме. | |
3143 .IPs fs_res=<ширина>:<высота> | |
3144 Указывает полноэкранное разрешение (полезно на медленных системах). | |
3145 .RE | |
3146 .PD 1 | |
3147 . | |
3148 .TP | |
3149 .B macosx (Mac OS X 10.4 или 10.3.9 с QuickTime 7) | |
3150 Драйвер вывода видео Mac OS X CoreVideo. | |
3151 .PD 0 | |
3152 .RSs | |
3153 .IPs device_id=<число> | |
3154 Выбирает устройство отображения для использования в полноэкранном режиме. | |
3155 .RE | |
3156 .PD 1 | |
3157 . | |
3158 .TP | |
3159 .B fbdev (только Linux) | |
3160 Использует фреймбуфер ядра для воспроизведения видео. | |
3161 .PD 0 | |
3162 .RSs | |
3163 .IPs <устройство> | |
3164 Явно указывает имя используемого fbdev устройства (например /dev/\:fb0) или | |
3165 имя подустройства VIDIX, если имя устройства начинается с 'vidix' | |
3166 (например 'vidixsis_vid для драйвера sis). | |
3167 .RE | |
3168 .PD 1 | |
3169 . | |
3170 .TP | |
3171 .B fbdev2 (только Linux) | |
3172 Использует фреймбуфер ядра для воспроизведения видео, альтернативная | |
3173 реализация. | |
3174 .PD 0 | |
3175 .RSs | |
3176 .IPs <устройство> | |
3177 Явно указывает имя используемого fbdev устройства (по-умолчанию: /dev/\:fb0). | |
20707 | 3178 .RE |
3179 .PD 1 | |
3180 . | |
3181 .TP | |
3182 .B "vesa\ \ \ " | |
20832 | 3183 Весьма универсальный драйвер, который должен работать на любой VESA VBE 2.0 |
3184 совместимой карте. | |
20707 | 3185 .PD 0 |
3186 .RSs | |
3187 .IPs "dga\ \ " | |
20832 | 3188 Включает режим DGA. |
20707 | 3189 .IPs nodga |
20832 | 3190 Выключает режим DGA. |
20707 | 3191 .IPs neotv_pal |
20832 | 3192 Активирует NeoMagic TV выход и устанавливает стандарт в PAL. |
20707 | 3193 .IPs neotv_ntsc |
20832 | 3194 Активирует NeoMagic TV выход и устанавливает стандарт в NTSC. |
20707 | 3195 .IPs vidix |
20832 | 3196 Указывает использовать VIDIX драйвер. |
20707 | 3197 .IPs "lvo:\ \ \ " |
20832 | 3198 Активирует видео оверлей Linux поверх VESA режима. |
20707 | 3199 .RE |
3200 .PD 1 | |
3201 . | |
3202 .TP | |
3203 .B "svga\ \ \ " | |
20832 | 3204 Воспроизводит видео, используя библиотеку SVGA. |
3205 .PD 0 | |
3206 .RSs | |
3207 .IPs "<видео режим>" | |
3208 Указывает используемый видео режим. | |
3209 Режим может быть задан в форме <ширина>x<высота>x<цветов>, | |
3210 например 640x480x16M или номером графического режима, например 84. | |
20707 | 3211 .IPs bbosd |
20832 | 3212 Выводит OSD на черных полях под изображением (медленнее). |
20707 | 3213 .IPs native |
20832 | 3214 Указывает использовать только 'нативные' функции. |
3215 Это отключает прямой рендеринг, OSD и аппаратное ускорение. | |
20707 | 3216 .IPs retrace |
20832 | 3217 .\" FIXME как коротко перевести vertical retrace? Существующий перевод |
3218 .\" не совсем верный (и звучит ужасно). | |
3219 Форсирует переключение кадров между циклами | |
3220 вертикальной развертки. | |
3221 Может использоваться только с \-double. | |
3222 Имеет тот же эффект, что и опция \-vsync. | |
20707 | 3223 .IPs "sq\ \ \ " |
20832 | 3224 Пытается выбрать видео режим с квадратными пикселами. |
20707 | 3225 .IPs vidix |
20832 | 3226 Указывает использовать svga с VIDIX. |
20707 | 3227 .RE |
3228 .PD 1 | |
3229 . | |
3230 .TP | |
3231 .B "gl\ \ \ \ \ " | |
20832 | 3232 OpenGL драйвер вывода видео, простая версия. |
3233 Размер видео должен быть меньше максимального размера | |
3234 текстуры в вашей реализации OpenGL. | |
3235 Предполагается, что будет работать даже с самыми простыми | |
3236 реализациями OpenGL, но также может использовать новые | |
3237 расширения, позволяющие поддерживать большее количество | |
3238 цветовых пространств и прямой рендеринг. | |
3239 Пожалуйста, используйте \-dr, если это работает с вашей | |
3240 реализацией OpenGL, поскольку для больших разрешений | |
3241 это | |
3242 .B значительно | |
3243 увеличивает скорость. | |
3244 Код выполняет очень малое количество проверок, так что, если что-то не | |
3245 работает, это может быть вызвано отсутствием поддержки в вашей | |
3246 карте/OpenGL реализации, даже если вы не получаете никаких сообщений об | |
3247 ошибках. Используйте glxinfo или аналогичный инструмент, чтобы увидеть | |
3248 поддерживаемые расширения OpenGL. | |
20707 | 3249 .PD 0 |
3250 .RSs | |
3251 .IPs (no)manyfmts | |
20832 | 3252 Включает поддержку большего количества форматов цветов (RGB и BGR) (по-умолчанию: включено). |
3253 Требует OpenGL версии >= 1.2. | |
20707 | 3254 .IPs slice-height=<0\-...> |
20832 | 3255 Количество строк, копируемых в текстуру одним целым (по-умолчанию: 4). |
3256 0 для всего изображения. | |
3257 .br | |
3258 .I ЗАМЕЧАНИЕ: | |
3259 Если используется пространство цветов YUV (смотрите подопцию yuv), применяются | |
3260 особые правила: | |
20707 | 3261 .RSss |
20832 | 3262 Если декодер использует рендеринг по слоям (смотрите \-noslices), эта опция не |
3263 имеет эффекта, размеры слоев указываются используемым декодером. | |
3264 .br | |
3265 Если декодер не использует рендеринг по слоям, то значением по-умолчанию | |
3266 является 16. | |
20707 | 3267 .RE |
3268 .IPs (no)osd | |
20832 | 3269 Включает или выключает поддержку рендеринга OSD при помощи OpenGL |
3270 (по-умолчанию: включено). Эта опция используется для тестирования; | |
3271 для отключения OSD используйте вместо нее \-osdlevel 0. | |
20707 | 3272 .IPs (no)scaled-osd |
20832 | 3273 Изменяет реакцию OSD на изменение размера окна (по-умолчанию: отключено). |
3274 .\" FIXME is translation correct ? | |
3275 .\" When enabled behaves more like the other video output drivers, | |
3276 .\" which is better for fixed-size fonts. | |
3277 .\" Disabled looks much better with FreeType fonts and uses the | |
3278 .\" borders in fullscreen mode. | |
3279 Когда включено, поведение такое же как и с остальными драйверами вывода | |
3280 видео, что лучше для шрифтов фиксированного размера. | |
3281 Когда отключено, то выглядит намного лучше со шрифтами TrueType и | |
3282 использует границы в полноэкранном режиме. | |
3283 С ass субтитрами (смотрите \-ass) работает некорректно. | |
20707 | 3284 .IPs osdcolor=<0xRRGGBB> |
20832 | 3285 Цвет для OSD (по-умолчанию: 0xffffff, соответствует белому цвету). |
20707 | 3286 .IPs (no)aspect |
20832 | 3287 Включает или выключает масштабирование с сохранением пропорций и поддержку |
3288 pan-and-scan (по-умолчанию: включено). | |
3289 Отключение может немного увеличить скорость. | |
20707 | 3290 .IPs rectangle=<0,1,2> |
20832 | 3291 Выбирает использование прямоугольныйх текстур, что экономит видеопамять, но |
3292 зачастую работает медленнее (по-умолчанию: 0). | |
20707 | 3293 .RSss |
20832 | 3294 0: Указывает использовать текстуры power-of-two (по-умолчанию). |
3295 .br | |
3296 1: Указывает использовать расширение GL_ARB_texture_rectangle. | |
3297 .br | |
3298 2: Указывает использовать расширение GL_ARB_texture_non_power_of_two. | |
3299 В некоторых случаях поддерживается только программно и, поэтому, очень медленно. | |
20707 | 3300 .RE |
3301 .IPs (no)glfinish | |
20832 | 3302 Вызывает glFinish() перед сменой буферов. |
3303 Медленнее, но в некоторых случаях дает более правильный результат (по-умолчанию: отключено). | |
20707 | 3304 .IPs swapinterval=<n> |
20832 | 3305 Минимальный интервал между сменами буферов, посчитанный в отображаемых |
3306 кадрах (по-умолчанию: 1). | |
3307 1 эквивалентно включению VSYNC, 0 - отключению VSYNC. | |
3308 Значения меньше 0 оставят его равным системному значению по-умолчанию. | |
3309 Это ограничивает частоту кадров значением (частота горизонтальной развертки / n). | |
3310 Для работы требуется поддержка GLX_SGI_swap_control. | |
3311 С некоторыми (многими/всеми?) реализациями работает только в полноэкранном режиме. | |
20707 | 3312 .IPs yuv=<n> |
20832 | 3313 Указывает тип преобразования YUV в RGB. |
20707 | 3314 .RSss |
20832 | 3315 0: Используется программное преобразование (по-умолчанию). |
3316 Совместимо со всеми версиями OpenGL. | |
3317 Предоставляет возможность управления яркостью, контрастностью и насыщенностью. | |
3318 .br | |
3319 .\" FIXME register combiners - блоки объединения регистров | |
3320 1: Используются блоки объединения регистров | |
3321 Используется nVidia-специфичное расширение (GL_NV_register_combiners). | |
3322 Требуются, как минимум, три текстуры. | |
3323 Предоставляет возможность управления насыщенностью и цветностью. | |
3324 Это быстрый, но не точный метод. | |
3325 .br | |
3326 .\" FIXME fragment program - программа фрагментации | |
3327 2: Используется программа фрагментации. | |
3328 Требуется расширение GL_ARB_fragment_program и, как минимум, три текстуры. | |
3329 Предоставляет возможность управления яркостью, контрастностью, | |
3330 насыщенностью и цветностью. | |
3331 .br | |
3332 .\" FIXME fragment program - программа фрагментации | |
3333 3: Используется программа фрагментации, используя POW инструкции. | |
3334 Требуется расширение GL_ARB_fragment_program и, как минимум, три текстуры. | |
3335 Предоставляет возможность управления яркостью, контрастностью, | |
3336 насыщенностью, цветностью и гаммой. | |
3337 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3338 Метод 4, как правило, быстрее. | |
3339 .br | |
3340 .\" FIXME fragment program - программа фрагментации | |
3341 4: Используется программа фрагментации с дополнительный поиском. | |
3342 Требуется расширение GL_ARB_fragment_program и, как минимум, | |
3343 четыре текстуры. | |
3344 Предоставляет возможность управления яркостью, контрастностью, насыщенностью, | |
3345 цветностью, и гаммой. | |
3346 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3347 .br | |
3348 5: Используется ATI-специфичный метод (для старых карт). | |
3349 при этом используется ATI-специфичное расширение | |
3350 (GL_ATI_fragment_shader - не GL_ARB_fragment_shader!). | |
3351 Необходимы, как минимум, три текстуры. | |
3352 Предоставляет возможность управления насыщенностью и цветностью. | |
3353 Это быстрый, но не точный метод. | |
3354 .br | |
3355 6: Используется 3D текстура для преобразования через поиск. | |
3356 Требуется расширение GL_ARB_fragment_program и, как минимум, четыре тестуры. | |
3357 Ужасно медленный (программная эмуляция) на некоторых (всех?) картах ATI, | |
3358 поскольку использует текстуру с пограничными пикселами. | |
3359 Предоставляет возможность управления яркостью, контрастностью, насыщенностью, | |
3360 цветностью, и гаммой. | |
3361 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3362 Скорость зависит от пропускной способности памяти GPU значительно сильнее, чем | |
3363 в остальных методах. | |
20707 | 3364 .RE |
3365 .IPs lscale=<n> | |
20832 | 3366 Выбирает функцию для масштабирования яркостность составляющей. |
3367 Допустимо только для 2, 3, 4 и 6 режимов yuv. | |
20707 | 3368 .RSss |
20832 | 3369 0: Используется простая линейная фильтрация (по-умолчанию). |
3370 .br | |
3371 1: Используется бикубическая фильтрация (повышенное качество). | |
3372 Требует одну дополнительную текстуру. | |
3373 Старые карты не смогут обработать с ее помощью цветовую составляющую, как минимум, | |
3374 в полноэкранном режиме. | |
20707 | 3375 .RE |
3376 .IPs cscale=<n> | |
20832 | 3377 Выбирает функцию для масштабирования цветовой составляющей. |
3378 Подробности смотрите в lscale. | |
3379 .IPs customprog=<файл> | |
3380 .\" FIXME fragment program - программа фрагментации | |
3381 Загружает нестандартную программу фрагментации из файла <файл>. | |
3382 пример смотрите в TOOLS/edgedect.fp. | |
3383 .IPs customtex=<файл> | |
3384 Загружает нестандартную "gamma ramp" текстуру из файла <файл>. | |
3385 Может использоваться совместно с yuv=4 или с опцией customprog. | |
20707 | 3386 .IPs (no)customtlin |
20832 | 3387 Если включено (по-умолчанию), для customtex текстуры используется GL_LINEAR |
3388 интерполяция, иначе - GL_NEAREST. | |
20707 | 3389 .IPs (no)customtrect |
20832 | 3390 Если включено, используется texture_rectangle для customtex текстуры. |
3391 По-умолчанию отключено. | |
20707 | 3392 .REss |
3393 .RE | |
3394 .PD 1 | |
3395 . | |
3396 .TP | |
3397 .B "gl2\ \ \ \ " | |
20832 | 3398 OpenGL драйвер вывода, второе поколение. |
3399 Поддерживает OSD и видео с размером больше допустимого для текстуры. | |
20707 | 3400 .PD 0 |
3401 .RSs | |
3402 .IPs (no)glfinish | |
20832 | 3403 То же, что и для gl (по-умолчанию: включено) |
20707 | 3404 .IPs yuv=<n> |
20832 | 3405 Указывает тип преобразования YUV в RGB. |
3406 Если установлено во что-либо, отличное от 0, то OSD выводиться не будет и | |
3407 регулировки яркости, контрастности и гаммы будут доступны только через | |
3408 глобальные настройки X сервера. | |
3409 В остальном значения те же, что и для \-vo gl. | |
20707 | 3410 .REss |
3411 . | |
3412 .TP | |
3413 .B "null\ \ \ " | |
20832 | 3414 Вы выводит никакого видео, |
3415 полезен для тестов производительности. | |
20707 | 3416 . |
3417 .TP | |
3418 .B "aa\ \ \ \ \ " | |
20832 | 3419 Драйвер вывода ASCII art, работающий в текстовой консоли. |
3420 Вы можете получить список и описание доступных подопций запустив | |
20707 | 3421 .I mplayer \-vo aa:help |
3422 . | |
3423 .TP | |
3424 .B "caca\ \ \ " | |
20832 | 3425 Драйвер вывода видео Color ASCII art, выботающий в текстовой консоли. |
20707 | 3426 . |
3427 .TP | |
3428 .B "bl\ \ \ \ \ " | |
20832 | 3429 Воспроизведение видео с использованием Blinkenlights UDP протокола. |
3430 Драйвер очень сильно аппаратно зависим. | |
3431 .PD 0 | |
3432 .RSs | |
3433 .IPs <подустройство> | |
3434 Явно указывает драйвер используемого подустройства Blinkenlights. | |
3435 Он выглядит как arcade:host=localhost:2323 или | |
20707 | 3436 hdl:file=name1,file=name2. |
20832 | 3437 Вы обязательно должны указать подустройство. |
20707 | 3438 .RE |
3439 .PD 1 | |
3440 . | |
3441 .TP | |
3442 .B "ggi\ \ \ \ " | |
20832 | 3443 Драйвер вывода видео графической системы GGI |
3444 .PD 0 | |
3445 .RSs | |
3446 .IPs <драйвер> | |
3447 Явно указывает используемый GGI драйвер. | |
3448 Замените любые ',', которые могут появиться в строке драйвера, на '.'. | |
20707 | 3449 .RE |
3450 .PD 1 | |
3451 . | |
3452 .TP | |
3453 .B directfb | |
20832 | 3454 Воспроизводит видео, используя библиотеку DirectFB. |
20707 | 3455 .PD 0 |
3456 .RSs | |
3457 .IPs (no)input | |
20832 | 3458 Указывает использовать коды клавиш DirectFB вместо кодов MPlayer (по-умолчанию: включено). |
20707 | 3459 .IPs buffermode=single|double|triple |
20832 | 3460 Двойная и тройная буферизация дает лучшие результаты, если вы хотите |
3461 .\" FIXME tearing - мерцание | |
3462 избежать мерцания. Тройная буферизация эффективнее двойной, поскольку | |
3463 .\" FIXME: vertical retrace | |
3464 она не блокирует MPlayer во время ожидания цикла обновления экрана монитора. | |
3465 Одиночной буферизации стоит избегать (по-умолчанию: single). | |
20707 | 3466 .IPs fieldparity=top|bottom |
20832 | 3467 Управляет порядком вывода чередующихся полей (по-умолчанию: отключено). |
3468 Допустимые значения: top = верхнее поле первое, bottom = нижнее поле первое. | |
3469 Это опция никак не влияет на прогрессивное видео, каковым являются большинство | |
3470 .\" FIXME tearing - мерцание | |
3471 MPEG фильмов, потребуется ее установить, если во время просмотра черезстрочного | |
3472 материала появляется мерцание или эффект гребенки при движении. | |
20707 | 3473 .IPs layer=N |
20832 | 3474 Форсирует для отображения слой с ID N (по-умолчанию: -1 - авто). |
3475 .IPs dfbopts=<список> | |
3476 Указывает список параметров для DirectFB. | |
20707 | 3477 .RE |
3478 .PD 1 | |
3479 . | |
3480 .TP | |
3481 .B "dfbmga\ " | |
20832 | 3482 Драйвер вывода видео для Matrox G400/\:G450/\:G550, использующий |
3483 библиотеку DirectFB для задействования особых возможностей оборудования. | |
3484 Задействует CRTC2 (вторую "голову"), отображая видео независимо от первой "головы". | |
20707 | 3485 .PD 0 |
3486 .RSs | |
3487 .IPs (no)input | |
20832 | 3488 То же, что и для directfb (по-умолчанию: отключено) |
20707 | 3489 .IPs buffermode=single|double|triple |
20832 | 3490 То же, что и для directfb (по-умолчанию: triple) |
20707 | 3491 .IPs fieldparity=top|bottom |
20832 | 3492 То же, что и для directfb |
20707 | 3493 .IPs (no)bes |
20832 | 3494 Задействует использование Matrox BES (модуля масштабирования) (по-умолчанию: отключено). |
3495 Дает отличный результат по скорости и качеству изображения, поскольку | |
3496 интерполяция производится аппаратно. Работает только на главной "голове". | |
20707 | 3497 .IPs (no)spic |
20832 | 3498 .\" FIXME correct translation of sub picture layer |
3499 Задействует использование специального слоя [sub picture layer] для отображения | |
3500 OSD (по-умолчанию: отключено). | |
20707 | 3501 .IPs (no)crtc2 |
20832 | 3502 Включает TV-выход на второй "голове" (по-умолчанию: включено). |
3503 Качество вывода удивительное, т.к. это полностью черезстрочное | |
3504 изображение с правильной синхронизацией каждого четнымого/\:нечетного поля. | |
20707 | 3505 .IPs tvnorm=pal|ntsc|auto |
20832 | 3506 Установит TV стандарт Matrox карты без необходимости |
3507 изменения /etc/\:directfbrc (по-умолчанию: отключено). | |
3508 Допустимые стандарты: pal = PAL, ntsc = NTSC. | |
3509 auto - особый стандарт (автоопределение использования PAL/\:NTSC), потому что | |
3510 он определяет используемый стандарт по частоте кадров фильма. | |
3511 .RE | |
3512 .PD 1 | |
3513 . | |
3514 .TP | |
3515 .B mga (только Linux) | |
3516 Драйвер вывода видео для Matrox, использующий модуль YUV масштабирования | |
3517 на Gxxx картах через драйвер ядра. | |
3518 Если у вас карта Matrox, то это самый быстрый вариант. | |
3519 .PD 0 | |
3520 .RSs | |
3521 .IPs <устройство> | |
3522 Явно указывает имя используемого Matrox устройства (по-цмолчанию: /dev/\:mga_vid). | |
3523 .RE | |
3524 .PD 1 | |
3525 . | |
3526 .TP | |
3527 .B xmga (только Linux, X11) | |
3528 Драйвер вывода видео mga, работающий в окне X11. | |
3529 .PD 0 | |
3530 .RSs | |
3531 .IPs <устройство> | |
3532 Явно указывает имя используемого Matrox устройства (по-цмолчанию: /dev/\:mga_vid). | |
20707 | 3533 .RE |
3534 .PD 1 | |
3535 . | |
3536 .TP | |
3537 .B "syncfb\ " | |
20832 | 3538 Драйвер вывода видео для SyncFB модуля ядра, предоставляющего |
3539 особые возможности Matrox Gxxx Карт, такие как аппаратные деинтерлейс, | |
3540 масштабирование и синхронизация видео с частотой вертикальной развертки | |
3541 вашего монитора. | |
3542 . | |
3543 .TP | |
3544 .B 3dfx (только Linux) | |
3545 Драйвер вывода для 3dfx. | |
3546 Этот драйвер работает напрямую c 3dfx оборудованием поверх X11. | |
3547 Поддерживается только 16 bpp. | |
3548 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
20707 | 3549 . |
3550 .TP | |
3551 .B tdfxfb (Linux only) | |
20832 | 3552 Этот драйвер работает с tdfx драйвером фреймбуфера для воспроизведения |
3553 фильмов с YUV ускорением на 3dfx картах. | |
3554 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
3555 .PD 0 | |
3556 .RSs | |
3557 .IPs <устройство> | |
3558 Явно указывает используемое fbdev устройство (по-умолчанию: /dev/\:fb0). | |
3559 .RE | |
3560 .PD 1 | |
3561 . | |
3562 .TP | |
3563 .B tdfx_vid (только Linux) | |
3564 Драйвер вывода видео для 3dfx. | |
3565 Этот драйвер напрямую использует драйвер ядра tdfx_vid. | |
3566 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
20707 | 3567 .PD 0 |
3568 .RSs | |
3569 .IPs <device> | |
20832 | 3570 Явно указывает имя используемого устройства (по-умолчанию: /dev/\:tdfx_vid). |
3571 .RE | |
3572 .PD 1 | |
3573 . | |
3574 .TP | |
3575 .B dxr2 (смотрите также \-dxr2) (только DXR2) | |
3576 Драйвер вывода видео Creative DXR2. | |
20707 | 3577 .PD 0 |
3578 .RSs | |
3579 .IPs <vo_driver> | |
20832 | 3580 Поддрайвер вывода видео, для использования в качестве оверлея (x11, xv). |
3581 .RE | |
3582 .PD 1 | |
3583 . | |
3584 .TP | |
3585 .B dxr3 (только DXR3) | |
3586 Драйвер выода видео чипов MPEG декодирования | |
3587 Sigma Designs em8300 (Creative DXR3, Sigma Designs | |
3588 Hollywood Plus). | |
3589 Смотрите также видео фильтр lavc. | |
20707 | 3590 .PD 0 |
3591 .RSs | |
3592 .IPs overlay | |
20832 | 3593 Активирует оверлей вместо TV вывода. |
20707 | 3594 .IPs prebuf |
20832 | 3595 Включает пребуферинг. |
20707 | 3596 .IPs "sync\ " |
20832 | 3597 Задействует новую систему синхронизации. |
3598 .IPs norm=<стандарт> | |
3599 Указывает TV стандарт. | |
20707 | 3600 .RSss |
20832 | 3601 0: Не изменяет текущий стандарт (по-умолчанию). |
3602 .br | |
3603 1: Автоопределение использования PAL/\:NTSC. | |
3604 .br | |
3605 2: Автоопределение использования PAL/\:PAL-60. | |
20707 | 3606 .br |
3607 3: PAL | |
3608 .br | |
3609 4: PAL-60 | |
3610 .br | |
3611 5: NTSC | |
3612 .REss | |
3613 .IPs <0\-3> | |
20832 | 3614 Указывает номер используемого устройства, если у вас установлено более одной |
3615 em8300 карты. | |
3616 .RE | |
3617 .PD 1 | |
3618 . | |
3619 .TP | |
3620 .B ivtv (только IVTV) | |
3621 Драйвер вывода через TV-Выход карт MPEG декодирования, основанных на для чипах | |
3622 Conexant CX23415 (iCompression iTVC15) или Conexant CX23416 (iCompression | |
3623 iTVC16), (Hauppauge WinTV PVR-150/250/350/500). | |
3624 Смотрите также видео фильтр lavc. | |
20707 | 3625 .PD 0 |
3626 .RSs | |
3627 .IPs device | |
20832 | 3628 Явно указывает имя устройства используемого MPEG декодера (по-умолчанию: /dev/video16). |
20707 | 3629 .IPs output |
20832 | 3630 Увно указывает используемый для видеосигнала TV-Выход. |
3631 .RE | |
3632 .PD 1 | |
3633 . | |
3634 .TP | |
3635 .B mpegpes (только DVB) | |
3636 Драйвер вывода видео DVB карт, записывающий вывод в MPEG-PES файл, если | |
3637 нет установленных DVB карт. | |
20707 | 3638 .PD 0 |
3639 .RSs | |
3640 .IPs card=<1\-4> | |
20832 | 3641 Указывает номер используемого устройства, если у вас более одной карты |
3642 (поддерживается только V3 API, такое как в драйверах 1.x.y серии). | |
3643 .IPs <файл> | |
3644 Файл для вывода (по-умолчанию: ./grab.mpg) | |
3645 .RE | |
3646 .PD 1 | |
3647 . | |
3648 .TP | |
3649 .B zr (смотрите также \-zr* и \-zrhelp) | |
3650 Драйвер вывода видео для некоторых MJPEG карт завата/\:воспроизведения. | |
3651 . | |
3652 .TP | |
3653 .B zr2 (смотрите также видео фильтр zrmjpeg) | |
3654 Драйвер вывода видео для некоторых MJPEG карт завата/\:воспроизведения, | |
3655 второе поколение. | |
3656 .PD 0 | |
3657 .RSs | |
3658 .IPs dev=<устройство> | |
3659 Указывает используемое устройство. | |
20707 | 3660 .IPs norm=<PAL|NTSC|SECAM|auto> |
20832 | 3661 Указывает используемый видео стандарт (по-умолчанию: авто). |
20707 | 3662 .IPs (no)prebuf |
20832 | 3663 (Де)Активирует пребуферинг, пока не поддерживается. |
20707 | 3664 .RE |
3665 .PD 1 | |
3666 . | |
3667 .TP | |
3668 .B "md5sum\ " | |
20832 | 3669 Рассчитывает MD5 сумму каждого кадра и записывает ее в файл. |
3670 Поддерживаются цветовые пространства RGB24 и YV12. | |
3671 Полезно для отладки. | |
3672 .PD 0 | |
3673 .RSs | |
3674 .IPs outfile=<значение> | |
3675 Указывает имя файла для вывода (по-умолчанию: ./md5sums). | |
20707 | 3676 .RE |
3677 .PD 1 | |
3678 . | |
3679 .TP | |
3680 .B yuv4mpeg | |
20832 | 3681 Преобразует видео поток в последовательность несжатых YUV 4:2:0 |
3682 изображений и сохраняет ее в файл (по-умолчанию: ./stream.yuv). | |
3683 Формат такой же, как и в mjpegtools, так что это полезно для | |
3684 обработки видео комплектом mjpegtools. | |
3685 Поддерживаются YV12, RGB (24 bpp) и BGR (24 bpp) форматы. | |
3686 Вы можете указывать ее совместно с опцией \-fixed-vo для | |
3687 объединения файлов с одинаковыми разрешениями и частотой кадров. | |
20707 | 3688 .PD 0 |
3689 .RSs | |
3690 .IPs interlaced | |
20832 | 3691 Зыписывает кадры в файл как черезстрочные с первым верхним полем. |
20707 | 3692 .IPs interlaced_bf |
20832 | 3693 Зыписывает кадры в файл как черезстрочные с первым нижним полем. |
3694 .IPs file=<файл> | |
3695 Записывает вывод в <файл> вместо стандартного stream.yuv. | |
20707 | 3696 .REss |
3697 .PD 1 | |
3698 .RS | |
3699 .sp 1 | |
20832 | 3700 .I ЗАМЕЧАНИЕ: |
3701 Если вы не указываете никаких опций, то вывод будет прогрессивным | |
3702 (т.е. нечерезстрочным). | |
20707 | 3703 .RE |
3704 . | |
3705 .TP | |
3706 .B "gif89a\ " | |
20832 | 3707 Выводит кадры в один анимированный GIF в текущем каталоге. |
3708 Поддерживается только формат RGB с глубиной цвета 24 бит, результат также | |
3709 будет преобразован в 256 цветный. | |
20707 | 3710 .PD 0 |
3711 .RSs | |
3712 .IPs <fps> | |
20832 | 3713 Вещественное число, указывающее частоту кадров (по-умолчанию: 5.0). |
3714 .IPs <файл> | |
3715 Указывает имя файла для вывода (по-умолчанию: ./out.gif). | |
20707 | 3716 .REss |
3717 .PD 1 | |
3718 .RS | |
3719 .sp 1 | |
20832 | 3720 .I ЗАМЕЧАНИЕ: |
3721 Вы должны указать частоту кадров до имени, иначе это значение будет | |
3722 частью имени файла. | |
3723 .sp 1 | |
3724 .I ПРИМЕР: | |
20707 | 3725 .RE |
3726 .PD 0 | |
3727 .RSs | |
3728 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif | |
3729 .RE | |
3730 .PD 1 | |
3731 . | |
3732 .TP | |
3733 .B "jpeg\ \ \ " | |
20832 | 3734 Выводит каждый кадр в JPEG файл в текущем каталоге. |
3735 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
20707 | 3736 .PD 0 |
3737 .RSs | |
3738 .IPs [no]progressive | |
20832 | 3739 Указывает создавать обычный или прогрессивный JPEG (по-умолчанию: обычный). |
20707 | 3740 .IPs [no]baseline |
20832 | 3741 Указывает использовать базовую линию [baseline] или нет (по-умолчанию: использовать). |
20707 | 3742 .IPs optimize=<0\-100> |
20832 | 3743 Степень оптимизации (по-умолчанию: 100) |
20707 | 3744 .IPs smooth=<0\-100> |
20832 | 3745 Степень размытия (по-умолчанию: 0) |
20707 | 3746 .IPs quality=<0\-100> |
20832 | 3747 Уровень качества (default: 75) |
3748 .IPs outdir=<каталог> | |
3749 Указывает каталог для вывода JPEG файлов (по-умолчанию: ./). | |
3750 .IPs subdirs=<префикс> | |
3751 Вместо использования текущего каталога создает нумерованные подкаталоги | |
3752 с указанным префиксом для сохранения файлов. | |
20707 | 3753 .IPs maxfiles=<value> (subdirs only) |
20832 | 3754 Максимальное количество файлов, сохраняемых в подкаталоге. |
3755 Должно быть больше или равно 1 (по-умолчанию: 1000). | |
20707 | 3756 .RE |
3757 .PD 1 | |
3758 . | |
3759 .TP | |
3760 .B "pnm\ \ \ \ " | |
20832 | 3761 Выводит каждый кадр в PNM файл в текущем каталоге. |
3762 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
3763 Поддерживаются файлы PPM, PGM и PGMYUV, как в raw, так и в ASCII режиме. | |
3764 Смотрите также pnm(5), ppm(5) и pgm(5). | |
20707 | 3765 .PD 0 |
3766 .RSs | |
3767 .IPs "ppm\ \ " | |
20832 | 3768 Записывает PPM файлы (по-умолчанию). |
20707 | 3769 .IPs "pgm\ \ " |
20832 | 3770 Записывает PGM файлы. |
20707 | 3771 .IPs pgmyuv |
20832 | 3772 Выводит PGMYUV файлы. |
3773 PGMYUV похож на PGM, но дополнительно содержит U и V компоненты, | |
3774 присоединенные к нижней части картинки. | |
3775 . | |
20707 | 3776 .IPs "raw\ \ " |
20832 | 3777 Записывает PNM файлы в raw режиме (по-умолчанию). |
20707 | 3778 .IPs ascii |
20832 | 3779 Записывает PNM файлы в ASCII режиме. |
3780 .IPs outdir=<каталог> | |
3781 Указывает каталог для сохранения PNM файлов (по-умолчанию: ./). | |
3782 .IPs subdirs=<префикс> | |
3783 Вместо использования текущего каталога создает нумерованные подкаталоги | |
3784 с указанным префиксом для сохранения файлов. | |
3785 .IPs maxfiles=<число> (только subdirs) | |
3786 Максимальное количество файлов, сохраняемых в подкаталоге. | |
3787 Должно быть больше или равно 1 (по-умолчанию: 1000). | |
20707 | 3788 .RE |
3789 .PD 1 | |
3790 . | |
3791 .TP | |
3792 .B "png\ \ \ \ " | |
20832 | 3793 Выводит каждый кадр в PNG файл в текущем каталоге. |
3794 Название файла формируется из номера кадра, дополненного слева нолями. | |
3795 Поддерживаются 24bpp RGB и BGR форматы. | |
20707 | 3796 .PD 0 |
3797 .RSs | |
3798 .IPs z=<0-9> | |
20832 | 3799 Указываеть степень сжатия. |
3800 0 - без сжатия, 9 - максимальное сжатие. | |
20707 | 3801 .RE |
3802 .PD 1 | |
3803 . | |
3804 .TP | |
3805 .B "tga\ \ \ \ " | |
20832 | 3806 Выводит каждый кадр в файл Targa в текущем каталоге. |
3807 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
3808 Назначение этого драйвера - сохранить кадры без потери качества, | |
3809 не используя сторонних библиотек. | |
3810 Он поддерживает BGR[A] формат с глубиной цвета 15, 24 или 32. | |
3811 Вы можете выбрать специфичный формат с помощью видео фильтра format. | |
3812 .sp 1 | |
3813 .I ПРИМЕР: | |
20707 | 3814 .RE |
3815 .PD 0 | |
3816 .RSs | |
3817 mplayer video.nut \-vf format=bgr15 \-vo tga | |
3818 .RE | |
3819 .PD 1 | |
3820 . | |
3821 . | |
3822 . | |
3823 .SH "DECODING/FILTERING OPTIONS" | |
3824 . | |
3825 .TP | |
3826 .B \-ac <[-|+]codec1,[-|+]codec2,...[,]> | |
3827 Specify a priority list of audio codecs to be used, according to their codec | |
3828 name in codecs.conf. | |
3829 Use a '-' before the codec name to omit it. | |
3830 Use a '+' before the codec name to force it, this will likely crash! | |
3831 If the list has a trailing ',' MPlayer will fall back on codecs not | |
3832 contained in the list. | |
3833 .br | |
3834 .I NOTE: | |
3835 See \-ac help for a full list of available codecs. | |
3836 .sp 1 | |
3837 .I EXAMPLE: | |
3838 .PD 0 | |
3839 .RSs | |
3840 .IPs "\-ac mp3acm" | |
3841 Force the l3codeca.acm MP3 codec. | |
3842 .IPs "\-ac mad," | |
3843 Try libmad first, then fall back on others. | |
3844 .IPs "\-ac hwac3,a52," | |
3845 Try hardware AC3 passthrough, software AC3, then others. | |
3846 .IPs "\-ac hwdts," | |
3847 Try hardware DTS passthrough, then fall back on others. | |
3848 .IPs "\-ac -ffmp3," | |
3849 Skip FFmpeg's MP3 decoder. | |
3850 .RE | |
3851 .PD 1 | |
3852 . | |
3853 .TP | |
3854 .B \-af-adv <force=(0\-7):list=(filters)> (also see \-af) | |
3855 Specify advanced audio filter options: | |
3856 .RSs | |
3857 .IPs force=<0\-7> | |
3858 Forces the insertion of audio filters to one of the following: | |
3859 .RSss | |
3860 0: Use completely automatic filter insertion. | |
3861 .br | |
3862 1: Optimize for accuracy (default). | |
3863 .br | |
3864 2: Optimize for speed. | |
3865 .I Warning: | |
3866 Some features in the audio filters may silently fail, | |
3867 and the sound quality may drop. | |
3868 .br | |
3869 3: Use no automatic insertion of filters and no optimization. | |
3870 .I Warning: | |
3871 It may be possible to crash MPlayer using this setting. | |
3872 .br | |
3873 4: Use automatic insertion of filters according to 0 above, | |
3874 but use floating point processing when possible. | |
3875 .br | |
3876 5: Use automatic insertion of filters according to 1 above, | |
3877 but use floating point processing when possible. | |
3878 .br | |
3879 6: Use automatic insertion of filters according to 2 above, | |
3880 but use floating point processing when possible. | |
3881 .br | |
3882 7: Use no automatic insertion of filters according to 3 above, | |
3883 and use floating point processing when possible. | |
3884 .REss | |
3885 .IPs list=<filters> | |
3886 Same as \-af. | |
3887 .RE | |
3888 . | |
3889 .TP | |
3890 .B \-afm <driver1,driver2,...> | |
3891 Specify a priority list of audio codec families to be used, according | |
3892 to their codec name in codecs.conf. | |
3893 Falls back on the default codecs if none of the given codec families work. | |
3894 .br | |
3895 .I NOTE: | |
3896 See \-afm help for a full list of available codec families. | |
3897 .sp 1 | |
3898 .I EXAMPLE: | |
3899 .PD 0 | |
3900 .RSs | |
3901 .IPs "\-afm ffmpeg" | |
3902 Try FFmpeg's libavcodec codecs first. | |
3903 .IPs "\-afm acm,dshow" | |
3904 Try Win32 codecs first. | |
3905 .RE | |
3906 .PD 1 | |
3907 . | |
3908 .TP | |
3909 .B \-aspect <ratio> (also see \-zoom) | |
3910 Override movie aspect ratio, in case aspect information is | |
3911 incorrect or missing in the file being played. | |
3912 .sp 1 | |
3913 .I EXAMPLE: | |
3914 .PD 0 | |
3915 .RSs | |
3916 \-aspect 4:3 or \-aspect 1.3333 | |
3917 .br | |
3918 \-aspect 16:9 or \-aspect 1.7777 | |
3919 .RE | |
3920 .PD 1 | |
3921 . | |
3922 .TP | |
3923 .B \-noaspect | |
3924 Disable automatic movie aspect ratio compensation. | |
3925 . | |
3926 .TP | |
3927 .B "\-flip \ " | |
3928 Flip image upside-down. | |
3929 . | |
3930 .TP | |
3931 .B \-lavdopts <option1:option2:...> (DEBUG CODE) | |
3932 Specify libavcodec decoding parameters. | |
3933 Separate multiple options with a colon. | |
3934 .sp 1 | |
3935 .I EXAMPLE: | |
3936 .PD 0 | |
3937 .RSs | |
3938 \-lavdopts gray:skiploopfilter=all:skipframe=nonref | |
3939 .RE | |
3940 .PD 1 | |
3941 .sp 1 | |
3942 .RS | |
3943 Available options are: | |
3944 .RE | |
3945 .RSs | |
3946 .IPs bitexact | |
3947 Only use bit-exact algorithms in all decoding steps (for codec testing). | |
3948 .IPs bug=<value> | |
3949 Manually work around encoder bugs. | |
3950 .RSss | |
3951 0: nothing | |
3952 .br | |
3953 1: autodetect bugs (default) | |
3954 .br | |
3955 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection) | |
3956 .br | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
3957 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX) |
20707 | 3958 .br |
3959 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4) | |
3960 .br | |
3961 16 (mpeg4): padding bug (autodetected) | |
3962 .br | |
3963 32 (mpeg4): illegal vlc bug (autodetected per fourcc) | |
3964 .br | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
3965 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version) |
20707 | 3966 .br |
3967 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version) | |
3968 .br | |
3969 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version) | |
3970 .br | |
3971 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version) | |
3972 .br | |
3973 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version) | |
3974 .REss | |
3975 .IPs debug=<value> | |
3976 Display debugging information. | |
3977 .RSss | |
3978 .br | |
3979 0: disabled | |
3980 .br | |
3981 1: picture info | |
3982 .br | |
3983 2: rate control | |
3984 .br | |
3985 4: bitstream | |
3986 .br | |
3987 8: macroblock (MB) type | |
3988 .br | |
3989 16: per-block quantization parameter (QP) | |
3990 .br | |
3991 32: motion vector | |
3992 .br | |
3993 0x0040: motion vector visualization (use \-noslices) | |
3994 .br | |
3995 0x0080: macroblock (MB) skip | |
3996 .br | |
3997 0x0100: startcode | |
3998 .br | |
3999 0x0200: PTS | |
4000 .br | |
4001 0x0400: error resilience | |
4002 .br | |
4003 0x0800: memory management control operations (H.264) | |
4004 .br | |
4005 0x1000: bugs | |
4006 .br | |
4007 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener. | |
4008 .br | |
4009 0x4000: Visualize block types. | |
4010 .REss | |
4011 .IPs ec=<value> | |
4012 Set error concealment strategy. | |
4013 .RSss | |
4014 1: Use strong deblock filter for damaged MBs. | |
4015 .br | |
4016 2: iterative motion vector (MV) search (slow) | |
4017 .br | |
4018 3: all (default) | |
4019 .REss | |
4020 .IPs er=<value> | |
4021 Set error resilience strategy. | |
4022 .RSss | |
4023 .br | |
4024 0: disabled | |
4025 .br | |
4026 1: careful (Should work with broken encoders.) | |
4027 .br | |
4028 2: normal (default) (Works with compliant encoders.) | |
4029 .br | |
4030 3: aggressive (More checks, but might cause problems even for valid bitstreams.) | |
4031 .br | |
4032 4: very aggressive | |
4033 .REss | |
4034 .IPs "fast (MPEG-2 only)" | |
4035 Enable optimizations which do not comply to the specification and might | |
4036 potentially cause problems, like simpler dequantization, assuming use | |
4037 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few | |
4038 checks to detect damaged bitstreams. | |
4039 .IPs "gray\ " | |
4040 grayscale only decoding (a bit faster than with color) | |
4041 .IPs "idct=<0\-99> (see \-lavcopts)" | |
4042 For best decoding quality use the same IDCT algorithm for decoding and encoding. | |
4043 This may come at a price in accuracy, though. | |
4044 .IPs lowres=<number>[,<w>] | |
4045 Decode at lower resolutions. | |
4046 Low resolution decoding is not supported by all codecs, and it will | |
4047 often result in ugly artifacts. | |
4048 This is not a bug, but a side effect of not decoding at full resolution. | |
4049 .RSss | |
4050 .br | |
4051 0: disabled | |
4052 .br | |
4053 1: 1/2 resolution | |
4054 .br | |
4055 2: 1/4 resolution | |
4056 .br | |
4057 3: 1/8 resolution | |
4058 .REss | |
4059 .RS | |
4060 If <w> is specified lowres decoding will be used only if the width of the | |
4061 video is major than or equal to <w>. | |
4062 .RE | |
4063 .IPs "sb=<number> (MPEG-2 only)" | |
4064 Skip the given number of macroblock rows at the bottom. | |
4065 .IPs "st=<number> (MPEG-2 only)" | |
4066 Skip the given number of macroblock rows at the top. | |
4067 .IPs skiploopfilter=<skipvalue> (H.264 only) | |
4068 Skips the loop filter (AKA deblocking) during H.264 decoding. | |
4069 Since the filtered frame is supposed to be used as reference | |
4070 for decoding dependent frames this has a worse effect on quality | |
4071 than not doing deblocking on e.g.\& MPEG-2 video. | |
4072 But at least for high bitrate HDTV this provides a big speedup with | |
4073 no visible quality loss. | |
4074 .sp 1 | |
4075 <skipvalue> can be either one of the following: | |
4076 .RSss | |
4077 .br | |
4078 none: Never skip. | |
4079 .br | |
4080 default: Skip useless processing steps (e.g.\& 0 size packets in AVI). | |
4081 .br | |
4082 nonref: Skip frames that are not referenced (i.e.\& not used for | |
4083 decoding other frames, the error cannot "build up"). | |
4084 .br | |
4085 bidir: Skip B-Frames. | |
4086 .br | |
4087 nonkey: Skip all frames except keyframes. | |
4088 .br | |
4089 all: Skip all frames. | |
4090 .REss | |
4091 .IPs skipidct=<skipvalue> (MPEG1/2 only) | |
4092 Skips the IDCT step. | |
4093 This degrades quality a lot of in almost all cases | |
4094 (see skiploopfilter for available skip values). | |
4095 .IPs skipframe=<skipvalue> | |
4096 Skips decoding of frames completely. | |
4097 Big speedup, but jerky motion and sometimes bad artifacts | |
4098 (see skiploopfilter for available skip values). | |
4099 .IPs threads=<1\-8> | |
4100 number of threads to use for decoding (default: 1) | |
4101 .IPs vismv=<value> | |
4102 Visualize motion vectors. | |
4103 .RSss | |
4104 .br | |
4105 0: disabled | |
4106 .br | |
4107 1: Visualize forward predicted MVs of P-frames. | |
4108 .br | |
4109 2: Visualize forward predicted MVs of B-frames. | |
4110 .br | |
4111 4: Visualize backward predicted MVs of B-frames. | |
4112 .REss | |
4113 .IPs vstats | |
4114 Prints some statistics and stores them in ./vstats_*.log. | |
4115 .RE | |
4116 . | |
4117 .TP | |
4118 .B \-noslices | |
4119 Disable drawing video by 16-pixel height slices/\:bands, instead draws the | |
4120 whole frame in a single run. | |
4121 May be faster or slower, depending on video card and available cache. | |
4122 It has effect only with libmpeg2 and libavcodec codecs. | |
4123 . | |
4124 .TP | |
4125 .B \-nosound | |
4126 Do not play/\:encode sound. | |
4127 Useful for benchmarking. | |
4128 . | |
4129 .TP | |
4130 .B \-novideo | |
4131 Do not play/\:encode video. | |
4132 In many cases this will not work, use \-vc null \-vo null instead. | |
4133 . | |
4134 .TP | |
4135 .B \-pp <quality> (also see \-vf pp) | |
4136 Set the DLL postprocess level. | |
4137 This option is no longer usable with \-vf pp. | |
4138 It only works with Win32 DirectShow DLLs with internal postprocessing routines. | |
4139 The valid range of \-pp values varies by codec, it is mostly | |
4140 0\-6, where 0=disable, 6=slowest/\:best. | |
4141 . | |
4142 .TP | |
4143 .B \-pphelp (also see \-vf pp) | |
4144 Show a summary about the available postprocess filters and their usage. | |
4145 . | |
4146 .TP | |
4147 .B \-ssf <mode> | |
4148 Specifies software scaler parameters. | |
4149 .sp 1 | |
4150 .I EXAMPLE: | |
4151 .PD 0 | |
4152 .RSs | |
4153 \-vf scale \-ssf lgb=3.0 | |
4154 .RE | |
4155 .PD 1 | |
4156 .PD 0 | |
4157 .RSs | |
4158 .IPs lgb=<0\-100> | |
4159 gaussian blur filter (luma) | |
4160 .IPs cgb=<0\-100> | |
4161 gaussian blur filter (chroma) | |
4162 .IPs ls=<-100\-100> | |
4163 sharpen filter (luma) | |
4164 .IPs cs=<-100\-100> | |
4165 sharpen filter (chroma) | |
4166 .IPs chs=<h> | |
4167 chroma horizontal shifting | |
4168 .IPs cvs=<v> | |
4169 chroma vertical shifting | |
4170 .RE | |
4171 .PD 1 | |
4172 . | |
4173 .TP | |
4174 .B \-stereo <mode> | |
4175 Select type of MP2/\:MP3 stereo output. | |
4176 .PD 0 | |
4177 .RSs | |
4178 .IPs 0 | |
4179 stereo | |
4180 .IPs 1 | |
4181 left channel | |
4182 .IPs 2 | |
4183 right channel | |
4184 .RE | |
4185 .PD 1 | |
4186 . | |
4187 .TP | |
4188 .B \-sws <software scaler type> (also see \-vf scale and \-zoom) | |
4189 Specify the software scaler algorithm to be used with the \-zoom option. | |
4190 This affects video output drivers which lack hardware acceleration, e.g.\& x11. | |
4191 .sp 1 | |
4192 Available types are: | |
4193 .sp 1 | |
4194 .PD 0 | |
4195 .RSs | |
4196 .IPs 0 | |
4197 fast bilinear | |
4198 .IPs 1 | |
4199 bilinear | |
4200 .IPs 2 | |
4201 bicubic (good quality) (default) | |
4202 .IPs 3 | |
4203 experimental | |
4204 .IPs 4 | |
4205 nearest neighbor (bad quality) | |
4206 .IPs 5 | |
4207 area | |
4208 .IPs 6 | |
4209 luma bicubic / chroma bilinear | |
4210 .IPs 7 | |
4211 gauss | |
4212 .IPs 8 | |
4213 sincR | |
4214 .IPs 9 | |
4215 lanczos | |
4216 .IPs 10 | |
4217 natural bicubic spline | |
4218 .RE | |
4219 .PD 1 | |
4220 .sp 1 | |
4221 .RS | |
4222 .I NOTE: | |
4223 Some \-sws options are tunable. | |
4224 The description of the scale video filter has further information. | |
4225 .RE | |
4226 . | |
4227 .TP | |
4228 .B \-vc <[-|+]codec1,[-|+]codec2,...[,]> | |
4229 Specify a priority list of video codecs to be used, according to their codec | |
4230 name in codecs.conf. | |
4231 Use a '-' before the codec name to omit it. | |
4232 Use a '+' before the codec name to force it, this will likely crash! | |
4233 If the list has a trailing ',' MPlayer will fall back on codecs not | |
4234 contained in the list. | |
4235 .br | |
4236 .I NOTE: | |
4237 See \-vc help for a full list of available codecs. | |
4238 .sp 1 | |
4239 .I EXAMPLE: | |
4240 .PD 0 | |
4241 .RSs | |
4242 .IPs "\-vc divx" | |
4243 Force Win32/\:VfW DivX codec, no fallback. | |
4244 .IPs "\-vc -divxds,-divx," | |
4245 Skip Win32 DivX codecs. | |
4246 .IPs "\-vc ffmpeg12,mpeg12," | |
4247 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others. | |
4248 .RE | |
4249 .PD 1 | |
4250 . | |
4251 .TP | |
4252 .B \-vfm <driver1,driver2,...> | |
4253 Specify a priority list of video codec families to be used, according | |
4254 to their names in codecs.conf. | |
4255 Falls back on the default codecs if none of the given codec families work. | |
4256 .br | |
4257 .I NOTE: | |
4258 See \-vfm help for a full list of available codec families. | |
4259 .sp 1 | |
4260 .I EXAMPLE: | |
4261 .PD 0 | |
4262 .RSs | |
4263 .IPs "\-vfm ffmpeg,dshow,vfw" | |
4264 Try the libavcodec, then Directshow, then VfW codecs and fall back | |
4265 on others, if they do not work. | |
4266 .IPs "\-vfm xanim" | |
4267 Try XAnim codecs first. | |
4268 .RE | |
4269 .PD 1 | |
4270 . | |
4271 .TP | |
4272 .B \-x <x> (also see \-zoom) (MPlayer only) | |
4273 Scale image to width <x> (if software/\:hardware scaling is available). | |
4274 Disables aspect calculations. | |
4275 . | |
4276 .TP | |
4277 .B \-xvidopts <option1:option2:...> | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
4278 Specify additional parameters when decoding with Xvid. |
20707 | 4279 .br |
4280 .I NOTE: | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
4281 Since libavcodec is faster than Xvid you might want to use the libavcodec |
20707 | 4282 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead. |
4283 .sp 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
4284 Xvid's internal postprocessing filters: |
20707 | 4285 .PD 0 |
4286 .RSs | |
4287 .IPs deblock-chroma (also see \-vf pp) | |
4288 chroma deblock filter | |
4289 .IPs deblock-luma (also see \-vf pp) | |
4290 luma deblock filter | |
4291 .IPs dering-luma (also see \-vf pp) | |
4292 luma deringing filter | |
4293 .IPs dering-chroma (also see \-vf pp) | |
4294 chroma deringing filter | |
4295 .IPs filmeffect (also see \-vf noise) | |
4296 Adds artificial film grain to the video. | |
4297 May increase perceived quality, while lowering true quality. | |
4298 .RE | |
4299 .sp 1 | |
4300 .RS | |
4301 rendering methods: | |
4302 .RE | |
4303 .PD 0 | |
4304 .RSs | |
4305 .IPs "dr2\ \ " | |
4306 Activate direct rendering method 2. | |
4307 .IPs nodr2 | |
4308 Deactivate direct rendering method 2. | |
4309 .RE | |
4310 .PD 1 | |
4311 . | |
4312 .TP | |
4313 .B \-xy <value> (also see \-zoom) | |
4314 .PD 0 | |
4315 .RSs | |
4316 .IPs value<=8 | |
4317 Scale image by factor <value>. | |
4318 .IPs value>8 | |
4319 Set width to value and calculate height to keep correct aspect ratio. | |
4320 .RE | |
4321 .PD 1 | |
4322 . | |
4323 .TP | |
4324 .B \-y <y> (also see \-zoom) (MPlayer only) | |
4325 Scale image to height <y> (if software/\:hardware scaling is available). | |
4326 Disables aspect calculations. | |
4327 . | |
4328 .TP | |
4329 .B "\-zoom\ \ " | |
4330 Allow software scaling, where available. | |
4331 This will allow scaling with output drivers (like x11, fbdev) that | |
4332 do not support hardware scaling where MPlayer disables scaling by | |
4333 default for performance reasons. | |
4334 . | |
4335 . | |
4336 . | |
4337 .SH "AUDIO FILTERS" | |
4338 Audio filters allow you to modify the audio stream and its properties. | |
4339 The syntax is: | |
4340 . | |
4341 .TP | |
4342 .B \-af <filter1[=parameter1:parameter2:...],filter2,...> | |
4343 Setup a chain of audio filters. | |
4344 .PP | |
4345 .I NOTE: | |
4346 To get a full list of available audio filters, see \-af help. | |
4347 .PP | |
4348 Available filters are: | |
4349 . | |
4350 .TP | |
4351 .B resample[=srate[:sloppy[:type]]] | |
4352 Changes the sample rate of the audio stream. | |
4353 Can be used if you have a fixed frequency sound card or if you are | |
4354 stuck with an old sound card that is only capable of max 44.1kHz. | |
4355 This filter is automatically enabled if necessary. | |
4356 It only supports 16-bit integer and float in native-endian format as input. | |
4357 .br | |
4358 .I NOTE: | |
4359 With MEncoder, you need to also use \-srate <srate>. | |
4360 .PD 0 | |
4361 .RSs | |
4362 .IPs <srate> | |
4363 output sample frequency in Hz. | |
4364 The valid range for this parameter is 8000 to 192000. | |
4365 If the input and output sample frequency are the same or if this | |
4366 parameter is omitted the filter is automatically unloaded. | |
4367 A high sample frequency normally improves the audio quality, | |
4368 especially when used in combination with other filters. | |
4369 .IPs <sloppy> | |
4370 Allow (1) or disallow (0) the output frequency to differ slightly | |
4371 from the frequency given by <srate> (default: 1). | |
4372 Can be used if the startup of the playback is extremely slow. | |
4373 .IPs <type> | |
4374 Selects which resampling method to use. | |
4375 .RSss | |
4376 0: linear interpolation (fast, poor quality especially when upsampling) | |
4377 .br | |
4378 1: polyphase filterbank and integer processing | |
4379 .br | |
4380 2: polyphase filterbank and floating point processing (slow, best quality) | |
4381 .REss | |
4382 .PD 1 | |
4383 .RE | |
4384 .sp 1 | |
4385 .RS | |
4386 .I EXAMPLE: | |
4387 .RE | |
4388 .PD 0 | |
4389 .RSs | |
4390 .IPs "mplayer \-af resample=44100:0:0" | |
4391 would set the output frequency of the resample filter to 44100Hz using | |
4392 exact output frequency scaling and linear interpolation. | |
4393 .RE | |
4394 .PD 1 | |
4395 . | |
4396 .TP | |
4397 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]] | |
4398 Changes the sample rate of the audio stream to an integer <srate> in Hz. | |
4399 It only supports the 16-bit native-endian format. | |
4400 .br | |
4401 .I NOTE: | |
4402 With MEncoder, you need to also use \-srate <srate>. | |
4403 .PD 0 | |
4404 .RSs | |
4405 .IPs <srate> | |
4406 the output sample rate | |
4407 .IPs <length> | |
4408 length of the filter with respect to the lower sampling rate (default: 16) | |
4409 .IPs <linear> | |
4410 if 1 then filters will be linearly interpolated between polyphase entries | |
4411 .IPs <count> | |
4412 log2 of the number of polyphase entries | |
4413 (..., 10->1024, 11->2048, 12->4096, ...) | |
4414 (default: 10->1024) | |
4415 .IPs <cutoff> | |
4416 cutoff frequency (0.0-1.0), default set depending upon filter length | |
4417 .RE | |
4418 .PD 1 | |
4419 . | |
4420 .TP | |
4421 .B sweep[=speed] | |
4422 Produces a sine sweep. | |
4423 .PD 0 | |
4424 .RSs | |
4425 .IPs <0.0\-1.0> | |
4426 Sine function delta, use very low values to hear the sweep. | |
4427 .RE | |
4428 .PD 1 | |
4429 . | |
4430 .TP | |
4431 .B sinesuppress[=freq:decay] | |
4432 Remove a sine at the specified frequency. | |
4433 Useful to get rid of the 50/60Hz noise on low quality audio equipment. | |
4434 It probably only works on mono input. | |
4435 .PD 0 | |
4436 .RSs | |
4437 .IPs <freq> | |
4438 The frequency of the sine which should be removed (in Hz) (default: 50) | |
4439 .IPs <decay> | |
4440 Controls the adaptivity (a larger value will make the filter adapt to | |
4441 amplitude and phase changes quicker, a smaller value will make the | |
4442 adaptation slower) (default: 0.0001). | |
4443 Reasonable values are around 0.001. | |
4444 .RE | |
4445 .PD 1 | |
4446 . | |
4447 .TP | |
4448 .B hrtf[=flag] | |
4449 Head-related transfer function: Converts multichannel audio to | |
4450 2 channel output for headphones, preserving the spatiality of the sound. | |
4451 .sp 1 | |
4452 .PD 0 | |
4453 .RS | |
4454 .IPs "Flag Meaning" | |
4455 .IPs "m matrix decoding of the rear channel" | |
4456 .IPs "s 2-channel matrix decoding" | |
4457 .IPs "0 no matrix decoding (default)" | |
4458 .RE | |
4459 .PD 1 | |
4460 . | |
4461 .TP | |
4462 .B equalizer=[g1:g2:g3:...:g10] | |
4463 10 octave band graphic equalizer, implemented using 10 IIR band pass filters. | |
4464 This means that it works regardless of what type of audio is being played back. | |
4465 The center frequencies for the 10 bands are: | |
4466 .sp 1 | |
4467 .PD 0 | |
4468 .RS | |
4469 .IPs "No. frequency" | |
4470 .IPs "0 31.25 Hz" | |
4471 .IPs "1 62.50 Hz" | |
4472 .IPs "2 125.00 Hz" | |
4473 .IPs "3 250.00 Hz" | |
4474 .IPs "4 500.00 Hz" | |
4475 .IPs "5 1.00 kHz" | |
4476 .IPs "6 2.00 kHz" | |
4477 .IPs "7 4.00 kHz" | |
4478 .IPs "8 8.00 kHz" | |
4479 .IPs "9 16.00 kHz" | |
4480 .RE | |
4481 .PD 1 | |
4482 .sp 1 | |
4483 .RS | |
4484 If the sample rate of the sound being played is lower than the center | |
4485 frequency for a frequency band, then that band will be disabled. | |
4486 A known bug with this filter is that the characteristics for the | |
4487 uppermost band are not completely symmetric if the sample | |
4488 rate is close to the center frequency of that band. | |
4489 This problem can be worked around by upsampling the sound | |
4490 using the resample filter before it reaches this filter. | |
4491 .RE | |
4492 .PD 0 | |
4493 .RSs | |
4494 .IPs <g1>:<g2>:<g3>:...:<g10> | |
4495 floating point numbers representing the gain in dB | |
4496 for each frequency band (-12\-12) | |
4497 .RE | |
4498 .sp 1 | |
4499 .RS | |
4500 .I EXAMPLE: | |
4501 .RE | |
4502 .RSs | |
4503 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi" | |
4504 Would amplify the sound in the upper and lower frequency region | |
4505 while canceling it almost completely around 1kHz. | |
4506 .RE | |
4507 .PD 1 | |
4508 . | |
4509 .TP | |
4510 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...] | |
4511 Can be used for adding, removing, routing and copying audio channels. | |
4512 If only <nch> is given the default routing is used, it works as | |
4513 follows: If the number of output channels is bigger than the number of | |
4514 input channels empty channels are inserted (except mixing from mono to | |
4515 stereo, then the mono channel is repeated in both of the output | |
4516 channels). | |
4517 If the number of output channels is smaller than the number | |
4518 of input channels the exceeding channels are truncated. | |
4519 .PD 0 | |
4520 .RSs | |
4521 .IPs <nch> | |
4522 number of output channels (1\-6) | |
4523 .IPs "<nr>\ " | |
4524 number of routes (1\-6) | |
4525 .IPs <from1:to1:from2:to2:from3:to3:...> | |
4526 Pairs of numbers between 0 and 5 that define where to route each channel. | |
4527 .RE | |
4528 .sp 1 | |
4529 .RS | |
4530 .I EXAMPLE: | |
4531 .RE | |
4532 .RSs | |
4533 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi" | |
4534 Would change the number of channels to 4 and set up 4 routes that | |
4535 swap channel 0 and channel 1 and leave channel 2 and 3 intact. | |
4536 Observe that if media containing two channels was played back, channels | |
4537 2 and 3 would contain silence but 0 and 1 would still be swapped. | |
4538 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi" | |
4539 Would change the number of channels to 6 and set up 4 routes | |
4540 that copy channel 0 to channels 0 to 3. | |
4541 Channel 4 and 5 will contain silence. | |
4542 .RE | |
4543 .PD 1 | |
4544 . | |
4545 .TP | |
4546 .B format[=format] (also see \-format) | |
4547 Convert between different sample formats. | |
4548 Automatically enabled when needed by the sound card or another filter. | |
4549 .PD 0 | |
4550 .RSs | |
4551 .IPs <format> | |
4552 Sets the desired format. | |
4553 The general form is 'sbe', where 's' denotes the sign (either 's' for signed | |
4554 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32) | |
4555 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian | |
4556 and 'ne' the endianness of the computer MPlayer is running on). | |
4557 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'. | |
4558 Exceptions to this rule that are also valid format specifiers: u8, s8, | |
4559 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm. | |
4560 .RE | |
4561 .PD 1 | |
4562 . | |
4563 .TP | |
4564 .B volume[=v[:sc]] | |
4565 Implements software volume control. | |
4566 Use this filter with caution since it can reduce the signal | |
4567 to noise ratio of the sound. | |
4568 In most cases it is best to set the level for the PCM sound to max, | |
4569 leave this filter out and control the output level to your | |
4570 speakers with the master volume control of the mixer. | |
4571 In case your sound card has a digital PCM mixer instead of an analog | |
4572 one, and you hear distortion, use the MASTER mixer instead. | |
4573 If there is an external amplifier connected to the computer (this | |
4574 is almost always the case), the noise level can be minimized by | |
4575 adjusting the master level and the volume knob on the amplifier | |
4576 until the hissing noise in the background is gone. | |
4577 .br | |
4578 This filter has a second feature: It measures the overall maximum | |
4579 sound level and prints out that level when MPlayer exits. | |
4580 This volume estimate can be used for setting the sound level in | |
4581 MEncoder such that the maximum dynamic range is utilized. | |
4582 .br | |
4583 .I NOTE: | |
4584 This filter is not reentrant and can therefore only be enabled | |
4585 once for every audio stream. | |
4586 .PD 0 | |
4587 .RSs | |
4588 .IPs "<v>\ \ " | |
4589 Sets the desired gain in dB for all channels in the stream | |
4590 from -200dB to +60dB, where -200dB mutes the sound | |
4591 completely and +60dB equals a gain of 1000 (default: 0). | |
4592 .IPs "<sc>\ " | |
4593 Turns soft clipping on (1) or off (0). | |
4594 Soft-clipping can make the sound more smooth if very | |
4595 high volume levels are used. | |
4596 Enable this option if the dynamic range of the | |
4597 loudspeakers is very low. | |
4598 .br | |
4599 .I WARNING: | |
4600 This feature creates distortion and should be considered a last resort. | |
4601 .RE | |
4602 .sp 1 | |
4603 .RS | |
4604 .I EXAMPLE: | |
4605 .RE | |
4606 .RSs | |
4607 .IPs "mplayer \-af volume=10.1:0 media.avi" | |
4608 Would amplify the sound by 10.1dB and hard-clip if the | |
4609 sound level is too high. | |
4610 .RE | |
4611 .PD 1 | |
4612 . | |
4613 .TP | |
4614 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...] | |
4615 Mixes channels arbitrarily. | |
4616 Basically a combination of the volume and the channels filter | |
4617 that can be used to down-mix many channels to only a few, | |
4618 e.g.\& stereo to mono or vary the "width" of the center | |
4619 speaker in a surround sound system. | |
4620 This filter is hard to use, and will require some tinkering | |
4621 before the desired result is obtained. | |
4622 The number of options for this filter depends on | |
4623 the number of output channels. | |
4624 An example how to downmix a six-channel file to two channels with | |
4625 this filter can be found in the examples section near the end. | |
4626 .PD 0 | |
4627 .RSs | |
4628 .IPs "<n>\ \ " | |
4629 number of output channels (1\-6) | |
4630 .IPs <Lij> | |
4631 How much of input channel i is mixed into output channel j (0\-1). | |
4632 So in principle you first have n numbers saying what to do with the | |
4633 first input channel, then n numbers that act on the second input channel | |
4634 etc. | |
4635 If you do not specify any numbers for some input channels, 0 is assumed. | |
4636 .RE | |
4637 .sp 1 | |
4638 .RS | |
4639 .I EXAMPLE: | |
4640 .RE | |
4641 .RSs | |
4642 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi" | |
4643 Would down-mix from stereo to mono. | |
4644 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi" | |
4645 Would give 3 channel output leaving channels 0 and 1 intact, | |
4646 and mix channels 0 and 1 into output channel 2 (which could | |
4647 be sent to a subwoofer for example). | |
4648 .RE | |
4649 .PD 1 | |
4650 . | |
4651 .TP | |
4652 .B sub[=fc:ch] | |
4653 Adds a subwoofer channel to the audio stream. | |
4654 The audio data used for creating the subwoofer channel is | |
4655 an average of the sound in channel 0 and channel 1. | |
4656 The resulting sound is then low-pass filtered by a 4th order | |
4657 Butterworth filter with a default cutoff frequency of 60Hz | |
4658 and added to a separate channel in the audio stream. | |
4659 .br | |
4660 .I Warning: | |
4661 Disable this filter when you are playing DVDs with Dolby | |
4662 Digital 5.1 sound, otherwise this filter will disrupt | |
4663 the sound to the subwoofer. | |
4664 .PD 0 | |
4665 .RSs | |
4666 .IPs "<fc>\ " | |
4667 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz) | |
4668 For the best result try setting the cutoff frequency as low as possible. | |
4669 This will improve the stereo or surround sound experience. | |
4670 .IPs "<ch>\ " | |
4671 Determines the channel number in which to insert the sub-channel audio. | |
4672 Channel number can be between 0 and 5 (default: 5). | |
4673 Observe that the number of channels will automatically | |
4674 be increased to <ch> if necessary. | |
4675 .RE | |
4676 .sp 1 | |
4677 .RS | |
4678 .I EXAMPLE: | |
4679 .RE | |
4680 .RSs | |
4681 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi" | |
4682 Would add a sub-woofer channel with a cutoff frequency of | |
4683 100Hz to output channel 4. | |
4684 .RE | |
4685 .PD 1 | |
4686 . | |
4687 .TP | |
4688 .B "center\ " | |
4689 Creates a center channel from the front channels. | |
4690 May currently be low quality as it does not implement a | |
4691 high-pass filter for proper extraction yet, but averages and | |
4692 halves the channels instead. | |
4693 .PD 0 | |
4694 .RSs | |
4695 .IPs "<ch>\ " | |
4696 Determines the channel number in which to insert the center channel. | |
4697 Channel number can be between 0 and 5 (default: 5). | |
4698 Observe that the number of channels will automatically | |
4699 be increased to <ch> if necessary. | |
4700 .RE | |
4701 .PD 1 | |
4702 . | |
4703 .TP | |
4704 .B surround[=delay] | |
4705 Decoder for matrix encoded surround sound like Dolby Surround. | |
4706 Many files with 2 channel audio actually contain matrixed surround sound. | |
4707 Requires a sound card supporting at least 4 channels. | |
4708 .PD 0 | |
4709 .RSs | |
4710 .IPs <delay> | |
4711 delay time in ms for the rear speakers (0 to 1000) (default: 20) | |
4712 This delay should be set as follows: If d1 is the distance | |
4713 from the listening position to the front speakers and d2 is the distance | |
4714 from the listening position to the rear speakers, then the delay should | |
4715 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2. | |
4716 .RE | |
4717 .sp 1 | |
4718 .RS | |
4719 .I EXAMPLE: | |
4720 .RE | |
4721 .RSs | |
4722 .IPs "mplayer \-af surround=15 \-channels 4 media.avi" | |
4723 Would add surround sound decoding with 15ms delay for the sound to the | |
4724 rear speakers. | |
4725 .RE | |
4726 .PD 1 | |
4727 . | |
4728 .TP | |
4729 .B delay[=ch1:ch2:...] | |
4730 Delays the sound to the loudspeakers such that the sound from the | |
4731 different channels arrives at the listening position simultaneously. | |
4732 It is only useful if you have more than 2 loudspeakers. | |
4733 .PD 0 | |
4734 .RSs | |
4735 .IPs ch1,ch2,... | |
4736 The delay in ms that should be imposed on each channel | |
4737 (floating point number between 0 and 1000). | |
4738 .RE | |
4739 .PD 1 | |
4740 .sp 1 | |
4741 .RS | |
4742 To calculate the required delay for the different channels do as follows: | |
4743 .IP 1. 3 | |
4744 Measure the distance to the loudspeakers in meters in relation | |
4745 to your listening position, giving you the distances s1 to s5 | |
4746 (for a 5.1 system). | |
4747 There is no point in compensating for the subwoofer (you will not hear the | |
4748 difference anyway). | |
4749 .IP 2. 3 | |
4750 Subtract the distances s1 to s5 from the maximum distance, | |
4751 i.e.\& s[i] = max(s) - s[i]; i = 1...5. | |
4752 .IP 3. | |
4753 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5. | |
4754 .RE | |
4755 .PD 0 | |
4756 .sp 1 | |
4757 .RS | |
4758 .I EXAMPLE: | |
4759 .RE | |
4760 .RSs | |
4761 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi" | |
4762 Would delay front left and right by 10.5ms, the two rear channels | |
4763 and the sub by 0ms and the center channel by 7ms. | |
4764 .RE | |
4765 .PD 1 | |
4766 . | |
4767 .TP | |
4768 .B export[=mmapped_file[:nsamples]] | |
4769 Exports the incoming signal to other processes using memory mapping (mmap()). | |
4770 Memory mapped areas contain a header: | |
4771 .sp 1 | |
4772 .nf | |
4773 int nch /*number of channels*/ | |
4774 int size /*buffer size*/ | |
4775 unsigned long long counter /*Used to keep sync, updated every | |
4776 time new data is exported.*/ | |
4777 .fi | |
4778 .sp 1 | |
4779 The rest is payload (non-interleaved) 16 bit data. | |
4780 .PD 0 | |
4781 .RSs | |
4782 .IPs <mmapped_file> | |
4783 file to map data to (default: ~/.mplayer/\:mplayer-af_export) | |
4784 .IPs <nsamples> | |
4785 number of samples per channel (default: 512) | |
4786 .RE | |
4787 .sp 1 | |
4788 .RS | |
4789 .I EXAMPLE: | |
4790 .RE | |
4791 .RSs | |
4792 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi" | |
4793 Would export 1024 samples per channel to '/tmp/mplayer-af_export'. | |
4794 .RE | |
4795 .PD 1 | |
4796 . | |
4797 .TP | |
4798 .B extrastereo[=mul] | |
4799 (Linearly) increases the difference between left and right channels | |
4800 which adds some sort of "live" effect to playback. | |
4801 .PD 0 | |
4802 .RSs | |
4803 .IPs <mul> | |
4804 Sets the difference coefficient (default: 2.5). | |
4805 0.0 means mono sound (average of both channels), with 1.0 sound will be | |
4806 unchanged, with -1.0 left and right channels will be swapped. | |
4807 .RE | |
4808 .PD 1 | |
4809 . | |
4810 .TP | |
4811 .B volnorm[=method:target] | |
4812 Maximizes the volume without distorting the sound. | |
4813 .PD 0 | |
4814 .RSs | |
4815 .IPs <method> | |
4816 Sets the used method. | |
4817 .RSss | |
4818 1: Use a single sample to smooth the variations via the standard | |
4819 weighted mean over past samples (default). | |
4820 .br | |
4821 2: Use several samples to smooth the variations via the standard | |
4822 weighted mean over past samples. | |
4823 .REss | |
4824 .IPs <target> | |
4825 Sets the target amplitude as a fraction of the maximum for the | |
4826 sample type (default: 0.25). | |
4827 .RE | |
4828 .PD 1 | |
4829 . | |
4830 .TP | |
4831 .B ladspa=file:label[:controls...] | |
4832 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin. | |
4833 This filter is reentrant, so multiple LADSPA plugins can be used at once. | |
4834 .PD 0 | |
4835 .RSs | |
4836 .IPs <file> | |
4837 Specifies the LADSPA plugin library file. | |
4838 If LADSPA_PATH is set, it searches for the specified file. | |
4839 If it is not set, you must supply a fully specified pathname. | |
4840 .IPs <label> | |
4841 Specifies the filter within the library. | |
4842 Some libraries contain only one filter, but others contain many of them. | |
4843 Entering 'help' here, will list all available filters within the specified | |
4844 library, which eliminates the use of 'listplugins' from the LADSPA SDK. | |
4845 .IPs <controls> | |
4846 Controls are zero or more floating point values that determine the | |
4847 behavior of the loaded plugin (for example delay, threshold or gain). | |
4848 In verbose mode (add \-v to the MPlayer command line), all available controls | |
4849 and their valid ranges are printed. | |
4850 This eliminates the use of 'analyseplugin' from the LADSPA SDK. | |
4851 .RE | |
4852 .PD 1 | |
4853 . | |
4854 .TP | |
4855 .B "comp\ \ \ " | |
4856 Compressor/expander filter usable for microphone input. | |
4857 Prevents artifacts on very loud sound and raises the volume on | |
4858 very low sound. | |
4859 This filter is untested, maybe even unusable. | |
4860 . | |
4861 .TP | |
4862 .B "gate\ \ \ " | |
4863 Noise gate filter similar to the comp audio filter. | |
4864 This filter is untested, maybe even unusable. | |
4865 . | |
4866 .TP | |
4867 .B karaoke | |
4868 Simple voice removal filter exploiting the fact that voice is | |
4869 usually recorded with mono gear and later 'center' mixed onto | |
4870 the final audio stream. | |
4871 Beware that this filter will turn your signal into mono. | |
4872 Works well for 2 channel tracks; do not bother trying it | |
4873 on anything but 2 channel stereo. | |
4874 . | |
4875 . | |
4876 . | |
4877 .SH "VIDEO FILTERS" | |
4878 Video filters allow you to modify the video stream and its properties. | |
4879 The syntax is: | |
4880 . | |
4881 .TP | |
4882 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...> | |
4883 Setup a chain of video filters. | |
4884 . | |
4885 .TP | |
4886 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE) | |
4887 Setup a chain of video filters, to be applied in | |
4888 .B reverse | |
4889 order. | |
4890 Deprecated in favor of \-vf. | |
4891 .PP | |
4892 Many parameters are optional and set to default values if omitted. | |
4893 To explicitly use a default value set a parameter to '-1'. | |
4894 Parameters w:h means width x height in pixels, x:y means x;y position counted | |
4895 from the upper left corner of the bigger image. | |
4896 .br | |
4897 .I NOTE: | |
4898 To get a full list of available video filters, see \-vf help. | |
4899 .sp 1 | |
4900 Video filters are managed in lists. | |
4901 There are a few commands to manage the filter list. | |
4902 . | |
4903 .TP | |
4904 .B \-vf-add <filter1[,filter2,...]> | |
4905 Appends the filters given as arguments to the filter list. | |
4906 . | |
4907 .TP | |
4908 .B \-vf-pre <filter1[,filter2,...]> | |
4909 Prepends the filters given as arguments to the filter list. | |
4910 . | |
4911 .TP | |
4912 .B \-vf-del <index1[,index2,...]> | |
4913 Deletes the filters at the given indexes. | |
4914 Index numbers start at 0, negative numbers address the end of the | |
4915 list (-1 is the last). | |
4916 . | |
4917 .TP | |
4918 .B \-vf-clr | |
4919 Completely empties the filter list. | |
4920 .PP | |
4921 With filters that support it, you can access parameters by their name. | |
4922 . | |
4923 .TP | |
4924 .B \-vf <filter>=help | |
4925 Prints the parameter names and parameter value ranges for a particular | |
4926 filter. | |
4927 . | |
4928 .TP | |
4929 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]> | |
4930 Sets a named parameter to the given value. | |
4931 Use on and off or yes and no to set flag parameters. | |
4932 .PP | |
4933 Available filters are: | |
4934 . | |
4935 .TP | |
4936 .B crop[=w:h:x:y] | |
4937 Crops the given part of the image and discards the rest. | |
4938 Useful to remove black bands from widescreen movies. | |
4939 .PD 0 | |
4940 .RSs | |
4941 .IPs <w>,<h> | |
4942 Cropped width and height, defaults to original width and height. | |
4943 .IPs <x>,<y> | |
4944 Position of the cropped picture, defaults to center. | |
4945 .RE | |
4946 .PD 1 | |
4947 . | |
4948 .TP | |
4949 .B cropdetect[=limit:round] | |
4950 Calculates necessary cropping parameters and prints the recommended parameters | |
4951 to stdout. | |
4952 .PD 0 | |
4953 .RSs | |
4954 .IPs <limit> | |
4955 Threshold, which can be optionally specified from nothing (0) to | |
4956 everything (255) (default: 24). | |
4957 .br | |
4958 .IPs <round> | |
4959 Value which the width/\:height should be divisible by (default: 16). | |
4960 The offset is automatically adjusted to center the video. | |
4961 Use 2 to get only even dimensions (needed for 4:2:2 video). | |
4962 16 is best when encoding to most video codecs. | |
4963 .RE | |
4964 .PD 1 | |
4965 . | |
4966 .TP | |
4967 .B rectangle[=w:h:x:y] | |
4968 The plugin responds to the input.conf directive 'change_rectangle' | |
4969 that takes two parameters. | |
4970 .PD 0 | |
4971 .RSs | |
4972 .IPs <w>,<h> | |
4973 width and height (default: -1, maximum possible width where boundaries | |
4974 are still visible.) | |
4975 .IPs <x>,<y> | |
4976 top left corner position (default: -1, uppermost leftmost) | |
4977 .RE | |
4978 .PD 1 | |
4979 . | |
4980 .TP | |
4981 .B expand[=w:h:x:y:o:a:r] | |
4982 Expands (not scales) movie resolution to the given value and places the | |
4983 unscaled original at coordinates x, y. | |
4984 Can be used for placing subtitles/\:OSD in the resulting black bands. | |
4985 .RSs | |
4986 .IPs <w>,<h> | |
4987 Expanded width,height (default: original width,height). | |
4988 Negative values for w and h are treated as offsets to the original size. | |
4989 .sp 1 | |
4990 .I EXAMPLE: | |
4991 .PD 0 | |
4992 .RSs | |
4993 .IP expand=0:-50:0:0 | |
4994 Adds a 50 pixel border to the bottom of the picture. | |
4995 .RE | |
4996 .PD 1 | |
4997 .IPs <x>,<y> | |
4998 position of original image on the expanded image (default: center) | |
4999 .IPs "<o>\ \ " | |
5000 OSD/\:subtitle rendering | |
5001 .RSss | |
5002 0: disable (default) | |
5003 .br | |
5004 1: enable | |
5005 .REss | |
5006 .IPs "<a>\ \ " | |
5007 Expands to fit an aspect instead of a resolution (default: 0). | |
5008 .sp 1 | |
5009 .I EXAMPLE: | |
5010 .PD 0 | |
5011 .RSs | |
20913 | 5012 .IP expand=800:::::4/3 |
20707 | 5013 Expands to 800x600, unless the source is higher resolution, in which |
5014 case it expands to fill a 4/3 aspect. | |
5015 .RE | |
5016 .PD 1 | |
5017 .IPs "<r>\ \ " | |
5018 Rounds up to make both width and height divisible by <r> (default: 1). | |
5019 .RE | |
5020 . | |
5021 .TP | |
5022 .B flip (also see \-flip) | |
5023 Flips the image upside down. | |
5024 . | |
5025 .TP | |
5026 .B "mirror\ " | |
5027 Mirrors the image on the Y axis. | |
5028 . | |
5029 .TP | |
5030 .B rotate[=<0\-7>] | |
5031 Rotates the image by 90 degrees and optionally flips it. | |
5032 For values between 4\-7 rotation is only done if the movie geometry is | |
5033 portrait and not landscape. | |
5034 .RSs | |
5035 .IPs 0 | |
5036 Rotate by 90 degrees clockwise and flip (default). | |
5037 .IPs 1 | |
5038 Rotate by 90 degrees clockwise. | |
5039 .IPs 2 | |
5040 Rotate by 90 degrees counterclockwise. | |
5041 .IPs 3 | |
5042 Rotate by 90 degrees counterclockwise and flip. | |
5043 .RE | |
5044 . | |
5045 .TP | |
5046 .B scale[=w:h[:ilaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]] | |
5047 Scales the image with the software scaler (slow) and performs a YUV<\->RGB | |
5048 colorspace conversion (also see \-sws). | |
5049 .RSs | |
5050 .IPs <w>,<h> | |
5051 scaled width/\:height (default: original width/\:height) | |
5052 .br | |
5053 .I NOTE: | |
5054 If \-zoom is used, and underlying filters (including libvo) are | |
5055 incapable of scaling, it defaults to d_width/\:d_height! | |
5056 .RSss | |
5057 0: scaled d_width/\:d_height | |
5058 .br | |
5059 -1: original width/\:height | |
5060 .br | |
5061 -2: Calculate w/h using the other dimension and the prescaled aspect ratio. | |
5062 .br | |
5063 -3: Calculate w/h using the other dimension and the original aspect ratio. | |
5064 .br | |
5065 -(n+8): Like -n above, but rounding the dimension to the closest multiple of 16. | |
5066 .REss | |
5067 .IPs <ilaced> | |
5068 Toggle interlaced scaling. | |
5069 .RSss | |
5070 0: off (default) | |
5071 .br | |
5072 1: on | |
5073 .REss | |
5074 .IPs <chr_drop> | |
5075 chroma skipping | |
5076 .RSss | |
5077 0: Use all available input lines for chroma. | |
5078 .br | |
5079 1: Use only every 2. input line for chroma. | |
5080 .br | |
5081 2: Use only every 4. input line for chroma. | |
5082 .br | |
5083 3: Use only every 8. input line for chroma. | |
5084 .REss | |
5085 .IPs "<par>[:<par2>] (also see \-sws)" | |
5086 Set some scaling parameters depending on the type of scaler selected | |
5087 with \-sws. | |
5088 .RSss | |
5089 \-sws 2 (bicubic): B (blurring) and C (ringing) | |
5090 .br | |
5091 0.00:0.60 default | |
5092 .br | |
5093 0.00:0.75 VirtualDub's "precise bicubic" | |
5094 .br | |
5095 0.00:0.50 Catmull-Rom spline | |
5096 .br | |
5097 0.33:0.33 Mitchell-Netravali spline | |
5098 .br | |
5099 1.00:0.00 cubic B-spline | |
5100 .br | |
5101 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp)) | |
5102 .br | |
5103 \-sws 9 (lanczos): filter length (1\-10) | |
5104 .REss | |
5105 .IPs <presize> | |
5106 Scale to preset sizes. | |
5107 .RSss | |
5108 qntsc: 352x240 (NTSC quarter screen) | |
5109 .br | |
5110 qpal: 352x288 (PAL quarter screen) | |
5111 .br | |
5112 ntsc: 720x480 (standard NTSC) | |
5113 .br | |
5114 pal: 720x576 (standard PAL) | |
5115 .br | |
5116 sntsc: 640x480 (square pixel NTSC) | |
5117 .br | |
5118 spal: 768x576 (square pixel PAL) | |
5119 .REss | |
5120 .IPs <noup> | |
5121 Disallow upscaling past the original dimensions. | |
5122 .RSss | |
5123 0: Allow upscaling (default). | |
5124 .br | |
5125 1: Disallow upscaling if one dimension exceeds its original value. | |
5126 .br | |
5127 2: Disallow upscaling if both dimensions exceed their original values. | |
5128 .REss | |
5129 .IPs <arnd> | |
5130 Accurate rounding for the vertical scaler, which may be faster | |
5131 or slower than the default rounding. | |
5132 .RSss | |
5133 0: Disable accurate rounding (default). | |
5134 .br | |
5135 1: Enable accurate rounding. | |
5136 .REss | |
5137 .RE | |
5138 . | |
5139 .TP | |
5140 .B dsize[=aspect|w:h:aspect-method:r] | |
5141 Changes the intended display size/\:aspect at an arbitrary point in the | |
5142 filter chain. | |
5143 Aspect can be given as a fraction (4/3) or floating point number | |
5144 (1.33). | |
5145 Alternatively, you may specify the exact display width and height | |
5146 desired. | |
5147 Note that this filter does | |
5148 .B not | |
5149 do any scaling itself; it just affects | |
5150 what later scalers (software or hardware) will do when auto-scaling to | |
5151 correct aspect. | |
5152 .RSs | |
5153 .IPs <w>,<h> | |
5154 New display width and height. | |
5155 Can also be these special values: | |
5156 .RSss | |
5157 0: original display width and height | |
5158 .br | |
5159 -1: original video width and height (default) | |
5160 .br | |
5161 -2: Calculate w/h using the other dimension and the original display | |
5162 aspect ratio. | |
5163 .br | |
5164 -3: Calculate w/h using the other dimension and the original video | |
5165 aspect ratio. | |
5166 .REss | |
5167 .sp 1 | |
5168 .I EXAMPLE: | |
5169 .PD 0 | |
5170 .RSs | |
5171 .IP dsize=800:-2 | |
5172 Specifies a display resolution of 800x600 for a 4/3 aspect video, or | |
5173 800x450 for a 16/9 aspect video. | |
5174 .RE | |
5175 .IPs <aspect-method> | |
5176 Modifies width and height according to original aspect ratios. | |
5177 .RSss | |
5178 -1: Ignore original aspect ratio (default). | |
5179 .br | |
5180 0: Keep display aspect ratio by using <w> and <h> as maximum | |
5181 resolution. | |
5182 .br | |
5183 1: Keep display aspect ratio by using <w> and <h> as minimum | |
5184 resolution. | |
5185 .br | |
5186 2: Keep video aspect ratio by using <w> and <h> as maximum | |
5187 resolution. | |
5188 .br | |
5189 3: Keep video aspect ratio by using <w> and <h> as minimum | |
5190 resolution. | |
5191 .REss | |
5192 .sp 1 | |
5193 .I EXAMPLE: | |
5194 .PD 0 | |
5195 .RSs | |
5196 .IP dsize=800:600:0 | |
5197 Specifies a display resolution of at most 800x600, or smaller, in order | |
5198 to keep aspect. | |
5199 .RE | |
5200 .PD 1 | |
5201 .IPs "<r>\ \ " | |
5202 Rounds up to make both width and height divisible by <r> (default: 1). | |
5203 .RE | |
5204 . | |
5205 .TP | |
5206 .B "yuy2\ \ \ " | |
5207 Forces software YV12/\:I420/\:422P to YUY2 conversion. | |
5208 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support. | |
5209 . | |
5210 .TP | |
5211 .B "yvu9\ \ \ " | |
5212 Forces software YVU9 to YV12 colorspace conversion. | |
5213 Deprecated in favor of the software scaler. | |
5214 . | |
5215 .TP | |
5216 .B "yuvcsp\ " | |
5217 Clamps YUV color values to the CCIR 601 range without doing real conversion. | |
5218 . | |
5219 .TP | |
5220 .B rgb2bgr[=swap] | |
5221 RGB 24/32 <\-> BGR 24/32 colorspace conversion. | |
5222 .PD 0 | |
5223 .RSs | |
5224 .IPs "swap\ " | |
5225 Also perform R <-> B swapping. | |
5226 .RE | |
5227 .PD 1 | |
5228 . | |
5229 .TP | |
5230 .B palette | |
5231 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette. | |
5232 . | |
5233 .TP | |
5234 .B format[=fourcc] | |
5235 Restricts the colorspace for the next filter without doing any conversion. | |
5236 Use together with the scale filter for a real conversion. | |
5237 .br | |
5238 .I NOTE: | |
5239 For a list of available formats see format=fmt=help. | |
5240 .PD 0 | |
5241 .RSs | |
5242 .IPs <fourcc> | |
5243 format name like rgb15, bgr24, yv12, etc (default: yuy2) | |
5244 .RE | |
5245 .PD 1 | |
5246 . | |
5247 .TP | |
5248 .B noformat[=fourcc] | |
5249 Restricts the colorspace for the next filter without doing any conversion. | |
5250 Unlike the format filter, this will allow any colorspace | |
5251 .B except | |
5252 the one you specify. | |
5253 .br | |
5254 .I NOTE: | |
5255 For a list of available formats see noformat=fmt=help. | |
5256 .PD 0 | |
5257 .RSs | |
5258 .IPs <fourcc> | |
5259 format name like rgb15, bgr24, yv12, etc (default: yv12) | |
5260 .RE | |
5261 .PD 1 | |
5262 . | |
5263 .TP | |
5264 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (also see \-pphelp) | |
5265 Enables the specified chain of postprocessing subfilters. | |
5266 Subfilters must be separated by '/' and can be disabled by | |
5267 prepending a '\-'. | |
5268 Each subfilter and some options have a short and a long name that can be | |
5269 used interchangeably, i.e.\& dr/dering are the same. | |
5270 All subfilters share common options to determine their scope: | |
5271 .PD 0 | |
5272 .RSs | |
5273 .IPs a/autoq | |
5274 Automatically switch the subfilter off if the CPU is too slow. | |
5275 .IPs c/chrom | |
5276 Do chrominance filtering, too (default). | |
5277 .IPs y/nochrom | |
5278 Do luminance filtering only (no chrominance). | |
5279 .IPs n/noluma | |
5280 Do chrominance filtering only (no luminance). | |
5281 .RE | |
5282 .PD 1 | |
5283 .sp 1 | |
5284 .RS | |
5285 .br | |
5286 .I NOTE: | |
5287 \-pphelp shows a list of available subfilters. | |
5288 .sp 1 | |
5289 Available subfilters are | |
5290 .RE | |
5291 .RSs | |
5292 .IPs hb/hdeblock[:difference[:flatness]] | |
5293 horizontal deblocking filter | |
5294 .RSss | |
5295 <difference>: Difference factor where higher values mean | |
5296 more deblocking (default: 32). | |
5297 .br | |
5298 <flatness>: Flatness threshold where lower values mean | |
5299 more deblocking (default: 39). | |
5300 .REss | |
5301 .IPs vb/vdeblock[:difference[:flatness]] | |
5302 vertical deblocking filter | |
5303 .RSss | |
5304 <difference>: Difference factor where higher values mean | |
5305 more deblocking (default: 32). | |
5306 .br | |
5307 <flatness>: Flatness threshold where lower values mean | |
5308 more deblocking (default: 39). | |
5309 .REss | |
5310 .IPs ha/hadeblock[:difference[:flatness]] | |
5311 accurate horizontal deblocking filter | |
5312 .RSss | |
5313 <difference>: Difference factor where higher values mean | |
5314 more deblocking (default: 32). | |
5315 .br | |
5316 <flatness>: Flatness threshold where lower values mean | |
5317 more deblocking (default: 39). | |
5318 .REss | |
5319 .IPs va/vadeblock[:difference[:flatness]] | |
5320 accurate vertical deblocking filter | |
5321 .RSss | |
5322 <difference>: Difference factor where higher values mean | |
5323 more deblocking (default: 32). | |
5324 .br | |
5325 <flatness>: Flatness threshold where lower values mean | |
5326 more deblocking (default: 39). | |
5327 .REss | |
5328 .sp 1 | |
5329 The horizontal and vertical deblocking filters share the | |
5330 difference and flatness values so you cannot set | |
5331 different horizontal and vertical thresholds. | |
5332 .sp 1 | |
5333 .IPs h1/x1hdeblock | |
5334 experimental horizontal deblocking filter | |
5335 .IPs v1/x1vdeblock | |
5336 experimental vertical deblocking filter | |
5337 .IPs dr/dering | |
5338 deringing filter | |
5339 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]] | |
5340 temporal noise reducer | |
5341 .RSss | |
5342 <threshold1>: larger -> stronger filtering | |
5343 .br | |
5344 <threshold2>: larger -> stronger filtering | |
5345 .br | |
5346 <threshold3>: larger -> stronger filtering | |
5347 .REss | |
5348 .IPs al/autolevels[:f/fullyrange] | |
5349 automatic brightness / contrast correction | |
5350 .RSss | |
5351 f/fullyrange: Stretch luminance to (0\-255). | |
5352 .REss | |
5353 .IPs lb/linblenddeint | |
5354 Linear blend deinterlacing filter that deinterlaces the given block | |
5355 by filtering all lines with a (1 2 1) filter. | |
5356 .IPs li/linipoldeint | |
5357 Linear interpolating deinterlacing filter that deinterlaces the given block | |
5358 by linearly interpolating every second line. | |
5359 .IPs ci/cubicipoldeint | |
5360 Cubic interpolating deinterlacing filter deinterlaces the given block | |
5361 by cubically interpolating every second line. | |
5362 .IPs md/mediandeint | |
5363 Median deinterlacing filter that deinterlaces the given block | |
5364 by applying a median filter to every second line. | |
5365 .IPs fd/ffmpegdeint | |
5366 FFmpeg deinterlacing filter that deinterlaces the given block | |
5367 by filtering every second line with a (-1 4 2 4 -1) filter. | |
5368 .IPs l5/lowpass5 | |
5369 Vertically applied FIR lowpass deinterlacing filter that deinterlaces | |
5370 the given block by filtering all lines with a (-1 2 6 2 -1) filter. | |
5371 .IPs fq/forceQuant[:quantizer] | |
5372 Overrides the quantizer table from the input with the constant | |
5373 quantizer you specify. | |
5374 .RSss | |
5375 <quantizer>: quantizer to use | |
5376 .REss | |
5377 .IPs de/default | |
5378 default pp filter combination (hb:a,vb:a,dr:a) | |
5379 .IPs fa/fast | |
5380 fast pp filter combination (h1:a,v1:a,dr:a) | |
5381 .IPs "ac\ \ \ " | |
5382 high quality pp filter combination (ha:a:128:7,va:a,dr:a) | |
5383 .RE | |
5384 .RS | |
5385 .sp 1 | |
5386 .I EXAMPLE: | |
5387 .RE | |
5388 .PD 0 | |
5389 .RSs | |
5390 .IPs "\-vf pp=hb/vb/dr/al" | |
5391 horizontal and vertical deblocking, deringing and automatic | |
5392 brightness/\:contrast | |
5393 .IPs "\-vf pp=de/-al" | |
5394 default filters without brightness/\:contrast correction | |
5395 .IPs "\-vf pp=default/tmpnoise:1:2:3" | |
5396 Enable default filters & temporal denoiser. | |
5397 .IPs "\-vf pp=hb:y/vb:a" | |
5398 Horizontal deblocking on luminance only, and switch vertical deblocking | |
5399 on or off automatically depending on available CPU time. | |
5400 .RE | |
5401 .PD 1 | |
5402 . | |
5403 .TP | |
5404 .B spp[=quality[:qp[:mode]]] | |
5405 Simple postprocessing filter that compresses and decompresses the | |
5406 image at several (or \- in the case of quality level 6 \- all) | |
5407 shifts and averages the results. | |
5408 .RSs | |
5409 .IPs <quality> | |
5410 0\-6 (default: 3) | |
5411 .IPs "<qp>\ " | |
5412 Force quantization parameter (default: 0, use QP from video). | |
5413 .IPs <mode> | |
5414 0: hard thresholding (default) | |
5415 .br | |
5416 1: soft thresholding (better deringing, but blurrier) | |
5417 .br | |
5418 4: like 0, but also use B-frames' QP (may cause flicker) | |
5419 .br | |
5420 5: like 1, but also use B-frames' QP (may cause flicker) | |
5421 .RE | |
5422 . | |
5423 .TP | |
5424 .B uspp[=quality[:qp]] | |
5425 Ultra simple & slow postprocessing filter that compresses and | |
5426 decompresses the image at several (or \- in the case of quality | |
5427 level 8 \- all) shifts and averages the results. | |
5428 The way this differs from the behavior of spp is that uspp actually | |
5429 encodes & decodes each case with libavcodec Snow, whereas spp uses | |
5430 a simplified intra only 8x8 DCT similar to MJPEG. | |
5431 .RSs | |
5432 .IPs <quality> | |
5433 0\-8 (default: 3) | |
5434 .IPs "<qp>\ " | |
5435 Force quantization parameter (default: 0, use QP from video). | |
5436 .RE | |
5437 . | |
5438 .TP | |
5439 .B fspp[=quality[:qp[:strength[:bframes]]]] | |
5440 faster version of the simple postprocessing filter | |
5441 .RSs | |
5442 .IPs <quality> | |
5443 4\-5 (equivalent to spp; default: 4) | |
5444 .IPs "<qp>\ " | |
5445 Force quantization parameter (default: 0, use QP from video). | |
5446 .IPs <-15\-32> | |
5447 Filter strength, lower values mean more details but also more artifacts, | |
5448 while higher values make the image smoother but also blurrier (default: | |
5449 0 \- PSNR optimal). | |
5450 .IPs <bframes> | |
5451 0: do not use QP from B-frames (default) | |
5452 .br | |
5453 1: use QP from B-frames too (may cause flicker) | |
5454 .RE | |
5455 . | |
5456 .TP | |
5457 .B pp7[=qp[:mode]] | |
5458 Variant of the spp filter, similar to spp=6 with 7 point DCT where | |
5459 only the center sample is used after IDCT. | |
5460 .RSs | |
5461 .IPs <qp> | |
5462 Force quantization parameter (default: 0, use QP from video). | |
5463 .IPs <mode> | |
5464 0: hard thresholding | |
5465 .br | |
5466 1: soft thresholding (better deringing, but blurrier) | |
5467 .br | |
5468 2: medium thresholding (default, good results) | |
5469 .RE | |
5470 . | |
5471 .TP | |
5472 .B qp=equation | |
5473 quantization parameter (QP) change filter | |
5474 .RSs | |
5475 .IPs <equation> | |
5476 some equation like "2+2*sin(PI*qp)" | |
5477 .RE | |
5478 . | |
5479 .TP | |
5480 .B "test\ \ \ " | |
5481 Generate various test patterns. | |
5482 . | |
5483 .TP | |
5484 .B rgbtest | |
5485 Generate an RGB test pattern useful for detecting RGB vs BGR issues. | |
5486 You should see a red, green and blue stripe from top to bottom. | |
5487 . | |
5488 .TP | |
5489 .B lavc[=quality:fps] | |
5490 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV. | |
5491 .RSs | |
5492 .IPs <quality> | |
5493 .RSss | |
5494 1\-31: fixed qscale | |
5495 .br | |
5496 32\-: fixed bitrate in kbits | |
5497 .REss | |
5498 .IPs <fps> | |
5499 force output fps (float value) (default: 0, autodetect based on height) | |
5500 .RE | |
5501 . | |
5502 .TP | |
5503 .B dvbscale[=aspect] | |
5504 Set up optimal scaling for DVB cards, scaling the x axis in hardware and | |
5505 calculating the y axis scaling in software to keep aspect. | |
5506 Only useful together with expand and scale. | |
5507 .RSs | |
5508 .IPs <aspect> | |
5509 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default: | |
5510 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV. | |
5511 .RE | |
5512 .sp 1 | |
5513 .RS | |
5514 .I EXAMPLE: | |
5515 .RE | |
5516 .PD 0 | |
5517 .RSs | |
5518 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc" | |
5519 FIXME: Explain what this does. | |
5520 .RE | |
5521 .PD 1 | |
5522 . | |
5523 .TP | |
5524 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]] | |
5525 Adds noise. | |
5526 .PD 0 | |
5527 .RSs | |
5528 .IPs <0\-100> | |
5529 luma noise | |
5530 .IPs <0\-100> | |
5531 chroma noise | |
5532 .IPs u | |
5533 uniform noise (gaussian otherwise) | |
5534 .IPs t | |
5535 temporal noise (noise pattern changes between frames) | |
5536 .IPs a | |
5537 averaged temporal noise (smoother, but a lot slower) | |
5538 .IPs h | |
5539 high quality (slightly better looking, slightly slower) | |
5540 .IPs p | |
5541 mix random noise with a (semi)regular pattern | |
5542 .RE | |
5543 .PD 1 | |
5544 . | |
5545 .TP | |
5546 .B denoise3d[=luma:chroma:time] | |
5547 This filter aims to reduce image noise producing smooth images and making still | |
5548 images really still (This should enhance compressibility.). | |
5549 .PD 0 | |
5550 .RSs | |
5551 .IPs <luma> | |
5552 spatial luma strength (default: 4) | |
5553 .IPs <chroma> | |
5554 spatial chroma strength (default: 3) | |
5555 .IPs <time> | |
5556 temporal strength (default: 6) | |
5557 .RE | |
5558 .PD 1 | |
5559 . | |
5560 .TP | |
5561 .B hqdn3d[=luma:chroma:time] | |
5562 High precision/\:quality version of the denoise3d filter. | |
5563 Parameters and usage are the same. | |
5564 . | |
5565 .TP | |
5566 .B eq[=brightness:contrast] (OBSOLETE) | |
5567 Software equalizer with interactive controls just like the hardware | |
5568 equalizer, for cards/\:drivers that do not support brightness and | |
5569 contrast controls in hardware. | |
5570 Might also be useful with MEncoder, either for fixing poorly captured | |
5571 movies, or for slightly reducing contrast to mask artifacts and get by | |
5572 with lower bitrates. | |
5573 .PD 0 | |
5574 .RSs | |
5575 .IPs <-100\-100> | |
5576 initial brightness | |
5577 .IPs <-100\-100> | |
5578 initial contrast | |
5579 .RE | |
5580 .PD 1 | |
5581 . | |
5582 .TP | |
5583 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight] | |
5584 Alternative software equalizer that uses lookup tables (very slow), | |
5585 allowing gamma correction in addition to simple brightness | |
5586 and contrast adjustment. | |
5587 Note that it uses the same MMX optimized code as \-vf eq if all | |
5588 gamma values are 1.0. | |
5589 The parameters are given as floating point values. | |
5590 .PD 0 | |
5591 .RSs | |
5592 .IPs <0.1\-10> | |
5593 initial gamma value (default: 1.0) | |
5594 .IPs <-2\-2> | |
5595 initial contrast, where negative values result in a | |
5596 negative image (default: 1.0) | |
5597 .IPs <-1\-1> | |
5598 initial brightness (default: 0.0) | |
5599 .IPs <0\-3> | |
5600 initial saturation (default: 1.0) | |
5601 .IPs <0.1\-10> | |
5602 gamma value for the red component (default: 1.0) | |
5603 .IPs <0.1\-10> | |
5604 gamma value for the green component (default: 1.0) | |
5605 .IPs <0.1\-10> | |
5606 gamma value for the blue component (default: 1.0) | |
5607 .IPs <0\-1> | |
5608 The weight parameter can be used to reduce the effect of a high gamma value on | |
5609 bright image areas, e.g.\& keep them from getting overamplified and just plain | |
5610 white. | |
5611 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it | |
5612 at its full strength (default: 1.0). | |
5613 .RE | |
5614 .PD 1 | |
5615 . | |
5616 .TP | |
5617 .B hue[=hue:saturation] | |
5618 Software equalizer with interactive controls just like the hardware | |
5619 equalizer, for cards/\:drivers that do not support hue and | |
5620 saturation controls in hardware. | |
5621 .PD 0 | |
5622 .RSs | |
5623 .IPs <-180\-180> | |
5624 initial hue (default: 0.0) | |
5625 .IPs <-100\-100> | |
5626 initial saturation, where negative values result | |
5627 in a negative chroma (default: 1.0) | |
5628 .RE | |
5629 .PD 1 | |
5630 . | |
5631 .TP | |
5632 .B halfpack[=f] | |
5633 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but | |
5634 keeping all chroma samples. | |
5635 Useful for output to low-resolution display devices when hardware downscaling | |
5636 is poor quality or is not available. | |
5637 Can also be used as a primitive luma-only deinterlacer with very low CPU | |
5638 usage. | |
5639 .PD 0 | |
5640 .RSs | |
5641 .IPs "<f>\ \ " | |
5642 By default, halfpack averages pairs of lines when downsampling. | |
5643 Any value different from 0 or 1 gives the default (averaging) behavior. | |
5644 .RSss | |
5645 0: Only use even lines when downsampling. | |
5646 .br | |
5647 1: Only use odd lines when downsampling. | |
5648 .REss | |
5649 .RE | |
5650 .PD 1 | |
5651 . | |
5652 .TP | |
5653 .B ilpack[=mode] | |
5654 When interlaced video is stored in YUV 4:2:0 formats, chroma | |
5655 interlacing does not line up properly due to vertical downsampling of | |
5656 the chroma channels. | |
5657 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with | |
5658 the chroma lines in their proper locations, so that in any given | |
5659 scanline, the luma and chroma data both come from the same field. | |
5660 .PD 0 | |
5661 .RSs | |
5662 .IPs <mode> | |
5663 Select the sampling mode. | |
5664 .RSss | |
5665 0: nearest-neighbor sampling, fast but incorrect | |
5666 .br | |
5667 1: linear interpolation (default) | |
5668 .REss | |
5669 .RE | |
5670 .PD 1 | |
5671 . | |
5672 .TP | |
5673 .B harddup | |
5674 Only useful with MEncoder. | |
5675 If harddup is used when encoding, it will force duplicate frames to be | |
5676 encoded in the output. | |
5677 This uses slightly more space, but is necessary for output to MPEG | |
5678 files or if you plan to demux and remux the video stream after | |
5679 encoding. | |
5680 Should be placed at or near the end of the filter chain unless you | |
5681 have a good reason to do otherwise. | |
5682 . | |
5683 .TP | |
5684 .B softskip | |
5685 Only useful with MEncoder. | |
5686 Softskip moves the frame skipping (dropping) step of encoding from | |
5687 before the filter chain to some point during the filter chain. | |
5688 This allows filters which need to see all frames (inverse telecine, | |
5689 temporal denoising, etc.) to function properly. | |
5690 Should be placed after the filters which need to see all frames and | |
5691 before any subsequent filters that are CPU-intensive. | |
5692 . | |
5693 .TP | |
5694 .B decimate[=max:hi:lo:frac] | |
5695 Drops frames that do not differ greatly from the previous frame in | |
5696 order to reduce framerate. | |
5697 The main use of this filter is for very-low-bitrate encoding (e.g.\& | |
5698 streaming over dialup modem), but it could in theory be used for | |
5699 fixing movies that were inverse-telecined incorrectly. | |
5700 .PD 0 | |
5701 .RSs | |
5702 .IPs <max> | |
5703 Sets the maximum number of consecutive frames which can be | |
5704 dropped (if positive), or the minimum interval between | |
5705 dropped frames (if negative). | |
5706 .IPs <hi>,<lo>,<frac> | |
5707 A frame is a candidate for dropping if no 8x8 region differs by more | |
5708 than a threshold of <hi>, and if not more than <frac> portion (1 | |
5709 meaning the whole image) differs by more than a threshold of <lo>. | |
5710 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual | |
5711 pixel value differences, so a threshold of 64 corresponds to 1 unit of | |
5712 difference for each pixel, or the same spread out differently over the | |
5713 block. | |
5714 .RE | |
5715 .PD 1 | |
5716 . | |
5717 .TP | |
5718 .B dint[=sense:level] | |
5719 The drop-deinterlace (dint) filter detects and drops the first from a set | |
5720 of interlaced video frames. | |
5721 .PD 0 | |
5722 .RSs | |
5723 .IPs <0.0\-1.0> | |
5724 relative difference between neighboring pixels (default: 0.1) | |
5725 .IPs <0.0\-1.0> | |
5726 What part of the image has to be detected as interlaced to | |
5727 drop the frame (default: 0.15). | |
5728 .RE | |
5729 .PD 1 | |
5730 . | |
5731 .TP | |
5732 .B lavcdeint (OBSOLETE) | |
5733 FFmpeg deinterlacing filter, same as \-vf pp=fd | |
5734 . | |
5735 .TP | |
5736 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]] | |
5737 Donald Graft's adaptive kernel deinterlacer. | |
5738 Deinterlaces parts of a video if a configurable threshold is exceeded. | |
5739 .PD 0 | |
5740 .RSs | |
5741 .IPs <0\-255> | |
5742 threshold (default: 10) | |
5743 .IPs <map> | |
5744 .RSss | |
5745 0: Ignore pixels exceeding the threshold (default). | |
5746 .br | |
5747 1: Paint pixels exceeding the threshold white. | |
5748 .REss | |
5749 .IPs <order> | |
5750 .RSss | |
5751 0: Leave fields alone (default). | |
5752 .br | |
5753 1: Swap fields. | |
5754 .REss | |
5755 .IPs <sharp> | |
5756 .RSss | |
5757 0: Disable additional sharpening (default). | |
5758 .br | |
5759 1: Enable additional sharpening. | |
5760 .REss | |
5761 .IPs <twoway> | |
5762 .RSss | |
5763 0: Disable twoway sharpening (default). | |
5764 .br | |
5765 1: Enable twoway sharpening. | |
5766 .REss | |
5767 .RE | |
5768 .PD 1 | |
5769 . | |
5770 .TP | |
5771 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]] | |
5772 unsharp mask / gaussian blur | |
5773 .RSs | |
5774 .IPs "l\ \ \ \ " | |
5775 Apply effect on luma component. | |
5776 .IPs "c\ \ \ \ " | |
5777 Apply effect on chroma components. | |
5778 .IPs <width>x<height> | |
5779 width and height of the matrix, odd sized in both directions | |
5780 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7) | |
5781 .IPs amount | |
5782 Relative amount of sharpness/\:blur to add to the image | |
5783 (a sane range should be -1.5\-1.5). | |
5784 .RSss | |
5785 <0: blur | |
5786 .br | |
5787 >0: sharpen | |
5788 .REss | |
5789 .RE | |
5790 . | |
5791 .TP | |
5792 .B "swapuv\ " | |
5793 Swap U & V plane. | |
5794 . | |
5795 .TP | |
5796 .B il[=d|i][s][:[d|i][s]] | |
5797 (De)interleaves lines. | |
5798 The goal of this filter is to add the ability to process interlaced images | |
5799 pre-field without deinterlacing them. | |
5800 You can filter your interlaced DVD and play it on a TV without breaking the | |
5801 interlacing. | |
5802 While deinterlacing (with the postprocessing filter) removes interlacing | |
5803 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into | |
5804 2 fields (so called half pictures), so you can process (filter) them | |
5805 independently and then re-interleave them. | |
5806 .PD 0 | |
5807 .RSs | |
5808 .IPs d | |
5809 deinterleave (placing one above the other) | |
5810 .IPs i | |
5811 interleave | |
5812 .IPs s | |
5813 swap fields (exchange even & odd lines) | |
5814 .RE | |
5815 .PD 1 | |
5816 . | |
5817 .TP | |
5818 .B fil[=i|d] | |
5819 (De)interleaves lines. | |
5820 This filter is very similar to the il filter but much faster, the main | |
5821 disadvantage is that it does not always work. | |
5822 Especially if combined with other filters it may produce randomly messed | |
5823 up images, so be happy if it works but do not complain if it does not for | |
5824 your combination of filters. | |
5825 .PD 0 | |
5826 .RSs | |
5827 .IPs d | |
5828 Deinterleave fields, placing them side by side. | |
5829 .IPs i | |
5830 Interleave fields again (reversing the effect of fil=d). | |
5831 .RE | |
5832 .PD 1 | |
5833 . | |
5834 .TP | |
5835 .B field[=n] | |
5836 Extracts a single field from an interlaced image using stride arithmetic | |
5837 to avoid wasting CPU time. | |
5838 The optional argument n specifies whether to extract the even or the odd | |
5839 field (depending on whether n is even or odd). | |
5840 . | |
5841 .TP | |
5842 .B detc[=var1=value1:var2=value2:...] | |
5843 Attempts to reverse the 'telecine' process to recover a clean, | |
5844 non-interlaced stream at film framerate. | |
5845 This was the first and most primitive inverse telecine filter to be | |
5846 added to MPlayer/\:MEncoder. | |
5847 It works by latching onto the telecine 3:2 pattern and following it as | |
5848 long as possible. | |
5849 This makes it suitable for perfectly-telecined material, even in the | |
5850 presence of a fair degree of noise, but it will fail in the presence | |
5851 of complex post-telecine edits. | |
5852 Development on this filter is no longer taking place, as ivtc, pullup, | |
5853 and filmdint are better for most applications. | |
5854 The following arguments (see syntax above) may be used to control | |
5855 detc's behavior: | |
5856 .RSs | |
5857 .IPs "<dr>\ " | |
5858 Set the frame dropping mode. | |
5859 .RSss | |
5860 0: Do not drop frames to maintain fixed output framerate (default). | |
5861 .br | |
5862 1: Always drop a frame when there have been no drops or telecine | |
5863 merges in the past 5 frames. | |
5864 .br | |
5865 2: Always maintain exact 5:4 input to output frame ratio. | |
5866 .br | |
5867 .I NOTE: | |
5868 Use mode 1 or 2 with MEncoder. | |
5869 .REss | |
5870 .IPs "<am>\ " | |
5871 Analysis mode. | |
5872 .RSss | |
5873 0: Fixed pattern with initial frame number specified by <fr>. | |
5874 .br | |
5875 1: aggressive search for telecine pattern (default) | |
5876 .REss | |
5877 .IPs "<fr>\ " | |
5878 Set initial frame number in sequence. | |
5879 0\-2 are the three clean progressive frames; 3 and 4 are the two | |
5880 interlaced frames. | |
5881 The default, -1, means 'not in telecine sequence'. | |
5882 The number specified here is the type for the imaginary previous | |
5883 frame before the movie starts. | |
5884 .IPs "<t0>, <t1>, <t2>, <t3>" | |
5885 Threshold values to be used in certain modes. | |
5886 .RE | |
5887 . | |
5888 .TP | |
5889 .B ivtc[=1] | |
5890 Experimental 'stateless' inverse telecine filter. | |
5891 Rather than trying to lock on to a pattern like the detc filter does, | |
5892 ivtc makes its decisions independently for each frame. | |
5893 This will give much better results for material that has undergone | |
5894 heavy editing after telecine was applied, but as a result it is not as | |
5895 forgiving of noisy input, for example TV capture. | |
5896 The optional parameter (ivtc=1) corresponds to the dr=1 option for the | |
5897 detc filter, and should be used with MEncoder but not with MPlayer. | |
5898 As with detc, you must specify the correct output framerate (\-ofps | |
5899 24000/1001) when using MEncoder. | |
5900 Further development on ivtc has stopped, as the pullup and filmdint | |
5901 filters appear to be much more accurate. | |
5902 . | |
5903 .TP | |
5904 .B pullup[=jl:jr:jt:jb:sb:mp] | |
5905 Third-generation pulldown reversal (inverse telecine) filter, | |
5906 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001 | |
5907 fps progressive content. | |
5908 The pullup filter is designed to be much more robust than detc or | |
5909 ivtc, by taking advantage of future context in making its decisions. | |
5910 Like ivtc, pullup is stateless in the sense that it does not lock onto | |
5911 a pattern to follow, but it instead looks forward to the following | |
5912 fields in order to identify matches and rebuild progressive frames. | |
5913 It is still under development, but believed to be quite accurate. | |
5914 The jl, jr, jt, and jb options set the amount of "junk" to ignore at | |
5915 the left, right, top, and bottom of the image, respectively. | |
5916 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of | |
5917 2 lines. | |
5918 The default is 8 pixels on each side. | |
5919 Setting the sb (strict breaks) option to 1 will reduce the chances of | |
5920 pullup generating an occasional mismatched frame, but it may also | |
5921 cause an excessive number of frames to be dropped during high motion | |
5922 sequences. | |
5923 Conversely, setting it to -1 will make pullup match fields more | |
5924 easily. | |
5925 This may help processing of video where there is slight blurring | |
5926 between the fields, but may also cause there to be interlaced frames | |
5927 in the output. | |
5928 The mp (metric plane) option may be set to 1 or 2 to use a chroma | |
5929 plane instead of the luma plane for doing pullup's computations. | |
5930 This may improve accuracy on very clean source material, but more | |
5931 likely will decrease accuracy, especially if there is chroma noise | |
5932 (rainbow effect) or any grayscale video. | |
5933 The main purpose of setting mp to a chroma plane is to reduce CPU load | |
5934 and make pullup usable in realtime on slow machines. | |
5935 .br | |
5936 .I NOTE: | |
5937 Always follow pullup with the softskip filter when encoding to ensure | |
5938 that pullup is able to see each frame. | |
5939 Failure to do so will lead to incorrect output and will usually crash, | |
5940 due to design limitations in the codec/\:filter layer. | |
5941 . | |
5942 .TP | |
5943 .B filmdint[=options] | |
5944 Inverse telecine filter, similar to the pullup filter above. | |
5945 It is designed to handle any pulldown pattern, including mixed soft and | |
5946 hard telecine and limited support for movies that are slowed down or sped | |
5947 up from their original framerate for TV. | |
5948 Only the luma plane is used to find the frame breaks. | |
5949 If a field has no match, it is deinterlaced with simple linear | |
5950 approximation. | |
5951 If the source is MPEG-2, this must be the first filter to allow | |
5952 access to the field-flags set by the MPEG-2 decoder. | |
5953 Depending on the source MPEG, you may be fine ignoring this advice, as | |
5954 long as you do not see lots of "Bottom-first field" warnings. | |
5955 With no options it does normal inverse telecine, and should be used | |
5956 together with mencoder \-fps 30000/1001 \-ofps 24000/1001. | |
5957 When this filter is used with mplayer, it will result in an uneven | |
5958 framerate during playback, but it is still generally better than using | |
5959 pp=lb or no deinterlacing at all. | |
5960 Multiple options can be specified separated by /. | |
5961 .RSs | |
5962 .IPs crop=<w>:<h>:<x>:<y> | |
5963 Just like the crop filter, but faster, and works on mixed hard and soft | |
5964 telecined content as well as when y is not a multiple of 4. | |
5965 If x or y would require cropping fractional pixels from the chroma | |
5966 planes, the crop area is extended. | |
5967 This usually means that x and y must be even. | |
5968 .IPs io=<ifps>:<ofps> | |
5969 For each ifps input frames the filter will output ofps frames. | |
5970 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio. | |
5971 This could be used to filter movies that are broadcast on TV at a frame | |
5972 rate different from their original framerate. | |
5973 .IPs luma_only=<n> | |
5974 If n is nonzero, the chroma plane is copied unchanged. | |
5975 This is useful for YV12 sampled TV, which discards one of the chroma | |
5976 fields. | |
5977 .IPs mmx2=<n> | |
5978 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow! | |
5979 optimized functions, otherwise, use plain C. | |
5980 If this option is not specified, MMX2 and 3DNow! are auto-detected, use | |
5981 this option to override auto-detection. | |
5982 .IPs fast=<n> | |
5983 The larger n will speed up the filter at the expense of accuracy. | |
5984 The default value is n=3. | |
5985 If n is odd, a frame immediately following a frame marked with the | |
5986 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter | |
5987 will not spend any time on soft-telecined MPEG-2 content. | |
5988 This is the only effect of this flag if MMX2 or 3DNow! is available. | |
5989 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used | |
5990 as with n=2 or 3. | |
5991 If n=2 or 3, the number of luma levels used to find the frame breaks is | |
5992 reduced from 256 to 128, which results in a faster filter without losing | |
5993 much accuracy. | |
5994 If n=4 or 5, a faster, but much less accurate metric will be used to | |
5995 find the frame breaks, which is more likely to misdetect high vertical | |
5996 detail as interlaced content. | |
5997 .IPs verbose=<n> | |
5998 If n is nonzero, print the detailed metrics for each frame. | |
5999 Useful for debugging. | |
6000 .IPs dint_thres=<n> | |
6001 Deinterlace threshold. | |
6002 Used during de-interlacing of unmatched frames. | |
6003 Larger value means less deinterlacing, use n=256 to completely turn off | |
6004 deinterlacing. | |
6005 Default is n=8. | |
6006 .IPs comb_thres=<n> | |
6007 Threshold for comparing a top and bottom fields. | |
6008 Defaults to 128. | |
6009 .IPs diff_thres=<n> | |
6010 Threshold to detect temporal change of a field. | |
6011 Default is 128. | |
6012 .IPs sad_thres=<n> | |
6013 Sum of Absolute Difference threshold, default is 64. | |
6014 .RE | |
6015 . | |
6016 .TP | |
6017 .B softpulldown | |
6018 This filter works only correct with MEncoder and acts on the MPEG-2 flags | |
6019 used for soft 3:2 pulldown (soft telecine). | |
6020 If you want to use the ivtc or detc filter on movies that are partly soft | |
6021 telecined, inserting this filter before them should make them more reliable. | |
6022 . | |
6023 .TP | |
6024 .B divtc[=options] | |
6025 Inverse telecine for deinterlaced video. | |
6026 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced | |
6027 using a method that keeps one field and interpolates the other, the result is | |
6028 a juddering video that has every fourth frame duplicated. | |
6029 This filter is intended to find and drop those duplicates and restore the | |
6030 original film framerate. | |
6031 When using this filter, you must specify \-ofps that is 4/5 of | |
6032 the fps of the input file and place the softskip later in the | |
6033 filter chain to make sure that divtc sees all the frames. | |
6034 Two different modes are available: | |
6035 One pass mode is the default and is straightforward to use, | |
6036 but has the disadvantage that any changes in the telecine | |
6037 phase (lost frames or bad edits) cause momentary judder | |
6038 until the filter can resync again. | |
6039 Two pass mode avoids this by analyzing the whole video | |
6040 beforehand so it will have forward knowledge about the | |
6041 phase changes and can resync at the exact spot. | |
6042 These passes do | |
6043 .B not | |
6044 correspond to pass one and two of the encoding process. | |
6045 You must run an extra pass using divtc pass one before the | |
6046 actual encoding throwing the resulting video away. | |
6047 Use \-nosound \-ovc raw \-o /dev/null to avoid | |
6048 wasting CPU power for this pass. | |
6049 You may add something like crop=2:2:0:0 after divtc | |
6050 to speed things up even more. | |
6051 Then use divtc pass two for the actual encoding. | |
6052 If you use multiple encoder passes, use divtc | |
6053 pass two for all of them. | |
6054 The options are: | |
6055 .RSs | |
6056 .IPs pass=1|2 | |
6057 Use two pass mode. | |
6058 .IPs file=<filename> | |
6059 Set the two pass log filename (default: "framediff.log"). | |
6060 .IPs threshold=<value> | |
6061 Set the minimum strength the telecine pattern must have for the filter to | |
6062 believe in it (default: 0.5). | |
6063 This is used to avoid recognizing false pattern from the parts of the video | |
6064 that are very dark or very still. | |
6065 .IPs window=<numframes> | |
6066 Set the number of past frames to look at when searching for pattern | |
6067 (default: 30). | |
6068 Longer window improves the reliability of the pattern search, but shorter | |
6069 window improves the reaction time to the changes in the telecine phase. | |
6070 This only affects the one pass mode. | |
6071 The two pass mode currently uses fixed window that extends to both future | |
6072 and past. | |
6073 .IPs phase=0|1|2|3|4 | |
6074 Sets the initial telecine phase for one pass mode (default: 0). | |
6075 The two pass mode can see the future, so it is able to use the correct | |
6076 phase from the beginning, but one pass mode can only guess. | |
6077 It catches the correct phase when it finds it, but this option can be used | |
6078 to fix the possible juddering at the beginning. | |
6079 The first pass of the two pass mode also uses this, so if you save the output | |
6080 from the first pass, you get constant phase result. | |
6081 .IPs deghost=<value> | |
6082 Set the deghosting threshold (0\-255 for one pass mode, -255\-255 for two pass | |
6083 mode, default 0). | |
6084 If nonzero, deghosting mode is used. | |
6085 This is for video that has been deinterlaced by blending the fields | |
6086 together instead of dropping one of the fields. | |
6087 Deghosting amplifies any compression artifacts in the blended frames, so the | |
6088 parameter value is used as a threshold to exclude those pixels from | |
6089 deghosting that differ from the previous frame less than specified value. | |
6090 If two pass mode is used, then negative value can be used to make the | |
6091 filter analyze the whole video in the beginning of pass-2 to determine | |
6092 whether it needs deghosting or not and then select either zero or the | |
6093 absolute value of the parameter. | |
6094 Specify this option for pass-2, it makes no difference on pass-1. | |
6095 .RE | |
6096 . | |
6097 .TP | |
6098 .B phase[=t|b|p|a|u|T|B|A|U][:v] | |
6099 Delay interlaced video by one field time so that the field order | |
6100 changes. | |
6101 The intended use is to fix PAL movies that have been captured with the | |
6102 opposite field order to the film-to-video transfer. | |
6103 The options are: | |
6104 .RSs | |
6105 .IPs t | |
6106 Capture field order top-first, transfer bottom-first. | |
6107 Filter will delay the bottom field. | |
6108 .IPs b | |
6109 Capture bottom-first, transfer top-first. | |
6110 Filter will delay the top field. | |
6111 .IPs p | |
6112 Capture and transfer with the same field order. | |
6113 This mode only exists for the documentation of the other options to refer to, | |
6114 but if you actually select it, the filter will faithfully do nothing ;-) | |
6115 .IPs a | |
6116 Capture field order determined automatically by field flags, transfer opposite. | |
6117 Filter selects among t and b modes on a frame by frame basis using field flags. | |
6118 If no field information is available, then this works just like u. | |
6119 .IPs u | |
6120 Capture unknown or varying, transfer opposite. | |
6121 Filter selects among t and b on a frame by frame basis by analyzing the | |
6122 images and selecting the alternative that produces best match between the | |
6123 fields. | |
6124 .IPs T | |
6125 Capture top-first, transfer unknown or varying. | |
6126 Filter selects among t and p using image analysis. | |
6127 .IPs B | |
6128 Capture bottom-first, transfer unknown or varying. | |
6129 Filter selects among b and p using image analysis. | |
6130 .IPs A | |
6131 Capture determined by field flags, transfer unknown or varying. | |
6132 Filter selects among t, b and p using field flags and image analysis. | |
6133 If no field information is available, then this works just like U. | |
6134 This is the default mode. | |
6135 .IPs U | |
6136 Both capture and transfer unknown or varying. | |
6137 Filter selects among t, b and p using image analysis only. | |
6138 .IPs v | |
6139 Verbose operation. | |
6140 Prints the selected mode for each frame and the average squared difference | |
6141 between fields for t, b, and p alternatives. | |
6142 .RE | |
6143 . | |
6144 .TP | |
6145 .B telecine[=start] | |
6146 Apply 3:2 'telecine' process to increase framerate by 20%. | |
6147 This most likely will not work correctly with MPlayer, but it can | |
6148 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'. | |
6149 Both fps options are essential! | |
6150 (A/V sync will break if they are wrong.) | |
6151 The optional start parameter tells the filter where in the telecine | |
6152 pattern to start (0\-3). | |
6153 . | |
6154 .TP | |
6155 .B tinterlace[=mode] | |
6156 Temporal field interlacing \- merge pairs of frames into an interlaced | |
6157 frame, halving the framerate. | |
6158 Even frames are moved into the upper field, odd frames to the lower field. | |
6159 This can be used to fully reverse the effect of the tfields filter (in mode 0). | |
6160 Available modes are: | |
6161 .PD 0 | |
6162 .RSs | |
6163 .IPs 0 | |
6164 Move odd frames into the upper field, even into the lower field, generating | |
6165 a full-height frame at half framerate. | |
6166 .IPs 1 | |
6167 Only output odd frames, even frames are dropped; height unchanged. | |
6168 .IPs 2 | |
6169 Only output even frames, odd frames are dropped; height unchanged. | |
6170 .IPs 3 | |
6171 Expand each frame to full height, but pad alternate lines with black; | |
6172 framerate unchanged. | |
6173 .IPs 4 | |
6174 Interleave even lines from even frames with odd lines from odd frames. | |
6175 Generates full-height frame at half framerate. | |
6176 .RE | |
6177 .PD 1 | |
6178 . | |
6179 .TP | |
6180 .B tfields[=mode[:field_dominance]] | |
6181 Temporal field separation \- split fields into frames, doubling the | |
6182 output framerate. | |
6183 Like the telecine filter, tfields will only work properly with | |
6184 MEncoder, and only if both \-fps and \-ofps are set to the | |
6185 desired (double) framerate! | |
6186 .PD 0 | |
6187 .RSs | |
6188 .IPs <mode> | |
6189 0: Leave fields unchanged (will jump/\:flicker). | |
6190 .br | |
6191 1: Interpolate missing lines. (The algorithm used might not be so good.) | |
6192 .br | |
6193 2: Translate fields by 1/4 pixel with linear interpolation (no jump). | |
6194 .br | |
6195 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default). | |
6196 .IPs <field_dominance> | |
6197 -1: auto (default) | |
6198 Only works if the decoder exports the appropriate information and | |
6199 no other filters which discard that information come before tfields | |
6200 in the filter chain, otherwise it falls back to 0 (top field first). | |
6201 .br | |
6202 0: top field first | |
6203 .br | |
6204 1: bottom field first | |
6205 .RE | |
6206 .PD 1 | |
6207 . | |
6208 .TP | |
6209 .B yadif=[mode[:field_dominance]] | |
6210 Yet another deinterlacing filter | |
6211 .PD 0 | |
6212 .RSs | |
6213 .IPs <mode> | |
6214 0: Output 1 frame for each frame. | |
6215 .br | |
6216 1: Output 1 frame for each field. | |
6217 .br | |
6218 2: Like 0 but skips spatial interlacing check. | |
6219 .br | |
6220 3: Like 1 but skips spatial interlacing check. | |
6221 .IPs <field_dominance> | |
6222 Operates like tfields. | |
6223 .RE | |
6224 .PD 1 | |
6225 . | |
6226 .TP | |
6227 .B mcdeint=[mode[:parity[:qp]]] | |
6228 Motion compensating deinterlacer. | |
6229 It needs one field per frame as input and must thus be used together | |
6230 with tfields=1 or yadif=1/3 or equivalent. | |
6231 .PD 0 | |
6232 .RSs | |
6233 .IPs <mode> | |
6234 0: fast | |
6235 .br | |
6236 1: medium | |
6237 .br | |
6238 2: slow, iterative motion estimation | |
6239 .br | |
6240 3: extra slow, like 2 plus multiple reference frames | |
6241 .IPs <parity> | |
6242 0 or 1 selects which field to use (note: no autodetection yet!). | |
6243 .IPs "<qp>\ " | |
6244 Higher values should result in a smoother motion vector | |
6245 field but less optimal individual vectors. | |
6246 .RE | |
6247 .PD 1 | |
6248 . | |
6249 .TP | |
6250 .B boxblur=radius:power[:radius:power] | |
6251 box blur | |
6252 .PD 0 | |
6253 .RSs | |
6254 .IPs <radius> | |
6255 blur filter strength | |
6256 .IPs <power> | |
6257 number of filter applications | |
6258 .RE | |
6259 .PD 1 | |
6260 . | |
6261 .TP | |
6262 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff] | |
6263 shape adaptive blur | |
6264 .PD 0 | |
6265 .RSs | |
6266 .IPs <radius> | |
6267 blur filter strength (~0.1\-4.0) (slower if larger) | |
6268 .IPs "<pf>\ " | |
6269 prefilter strength (~0.1\-2.0) | |
6270 .IPs <colorDiff> | |
6271 maximum difference between pixels to still be considered (~0.1\-100.0) | |
6272 .RE | |
6273 .PD 1 | |
6274 . | |
6275 .TP | |
6276 .B smartblur=radius:strength:threshold[:radius:strength:threshold] | |
6277 smart blur | |
6278 .PD 0 | |
6279 .RSs | |
6280 .IPs <radius> | |
6281 blur filter strength (~0.1\-5.0) (slower if larger) | |
6282 .IPs <strength> | |
6283 blur (0.0\-1.0) or sharpen (-1.0\-0.0) | |
6284 .IPs <threshold> | |
6285 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) | |
6286 .RE | |
6287 .PD 1 | |
6288 . | |
6289 .TP | |
6290 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t | |
6291 Correct the perspective of movies not filmed perpendicular to the screen. | |
6292 .PD 0 | |
6293 .RSs | |
6294 .IPs <x0>,<y0>,... | |
6295 coordinates of the top left, top right, bottom left, bottom right corners | |
6296 .IPs "<t>\ \ " | |
6297 linear (0) or cubic resampling (1) | |
6298 .RE | |
6299 .PD 1 | |
6300 . | |
6301 .TP | |
6302 .B "2xsai\ \ " | |
6303 Scale and smooth the image with the 2x scale and interpolate algorithm. | |
6304 . | |
6305 .TP | |
6306 .B "1bpp\ \ \ " | |
6307 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion | |
6308 . | |
6309 .TP | |
6310 .B down3dright[=lines] | |
6311 Reposition and resize stereoscopic images. | |
6312 Extracts both stereo fields and places them side by side, resizing | |
6313 them to maintain the original movie aspect. | |
6314 .PD 0 | |
6315 .RSs | |
6316 .IPs <lines> | |
6317 number of lines to select from the middle of the image (default: 12) | |
6318 .RE | |
6319 .PD 1 | |
6320 . | |
6321 .TP | |
6322 .B bmovl=hidden:opaque:fifo | |
6323 The bitmap overlay filter reads bitmaps from a FIFO and displays them | |
6324 on top of the movie, allowing some transformations on the image. | |
6325 Also see TOOLS/bmovl-test.c for a small bmovl test program. | |
6326 .PD 0 | |
6327 .RSs | |
6328 .IPs <hidden> | |
6329 Set the default value of the 'hidden' flag (0=visible, 1=hidden). | |
6330 .IPs <opaque> | |
6331 Set the default value of the 'opaque' flag (0=transparent, 1=opaque). | |
6332 .IPs <fifo> | |
6333 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the | |
6334 controlling application) | |
6335 .RE | |
6336 .PD 1 | |
6337 .sp 1 | |
6338 .RS | |
6339 FIFO commands are: | |
6340 .RE | |
6341 .PD 0 | |
6342 .RSs | |
6343 .IPs "RGBA32 width height xpos ypos alpha clear" | |
6344 followed by width*height*4 Bytes of raw RGBA32 data. | |
6345 .IPs "ABGR32 width height xpos ypos alpha clear" | |
6346 followed by width*height*4 Bytes of raw ABGR32 data. | |
6347 .IPs "RGB24 width height xpos ypos alpha clear" | |
6348 followed by width*height*3 Bytes of raw RGB24 data. | |
6349 .IPs "BGR24 width height xpos ypos alpha clear" | |
6350 followed by width*height*3 Bytes of raw BGR24 data. | |
6351 .IPs "ALPHA width height xpos ypos alpha" | |
6352 Change alpha transparency of the specified area. | |
6353 .IPs "CLEAR width height xpos ypos" | |
6354 Clear area. | |
6355 .IPs OPAQUE | |
6356 Disable all alpha transparency. | |
6357 Send "ALPHA 0 0 0 0 0" to enable it again. | |
6358 .IPs "HIDE\ " | |
6359 Hide bitmap. | |
6360 .IPs "SHOW\ " | |
6361 Show bitmap. | |
6362 .RE | |
6363 .PD 1 | |
6364 .sp 1 | |
6365 .RS | |
6366 Arguments are: | |
6367 .RE | |
6368 .PD 0 | |
6369 .RSs | |
6370 .IPs "<width>, <height>" | |
6371 image/area size | |
6372 .IPs "<xpos>, <ypos>" | |
6373 Start blitting at position x/y. | |
6374 .IPs <alpha> | |
6375 Set alpha difference. | |
6376 If you set this to -255 you can then send a sequence of ALPHA-commands to set | |
6377 the area to -225, -200, -175 etc for a nice fade-in-effect! ;) | |
6378 .RSss | |
6379 0: same as original | |
6380 .br | |
6381 255: Make everything opaque. | |
6382 .br | |
6383 -255: Make everything transparent. | |
6384 .REss | |
6385 .IPs <clear> | |
6386 Clear the framebuffer before blitting. | |
6387 .RSss | |
6388 0: The image will just be blitted on top of the old one, so you do not need to | |
6389 send 1.8MB of RGBA32 data every time a small part of the screen is updated. | |
6390 .br | |
6391 1: clear | |
6392 .REss | |
6393 .RE | |
6394 .PD 1 | |
6395 . | |
6396 .TP | |
6397 .B framestep=I|[i]step | |
6398 Renders only every nth frame or every intra frame (keyframe). | |
6399 .sp 1 | |
6400 If you call the filter with I (uppercase) as the parameter, then | |
6401 .B only | |
6402 keyframes are rendered. | |
6403 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB), | |
6404 for AVI it means every scene change or every keyint value (see \-lavcopts | |
6405 keyint= value if you use MEncoder to encode the video). | |
6406 .sp 1 | |
6407 When a keyframe is found, an 'I!' string followed by a newline character is | |
6408 printed, leaving the current line of MPlayer/\:MEncoder output on the screen, | |
6409 because it contains the time (in seconds) and frame number of the keyframe | |
6410 (You can use this information to split the AVI.). | |
6411 .sp 1 | |
6412 If you call the filter with a numeric parameter 'step' then only one in | |
6413 every 'step' frames is rendered. | |
6414 .sp 1 | |
6415 If you put an 'i' (lowercase) before the number then an 'I!' is printed | |
6416 (like the I parameter). | |
6417 .sp 1 | |
6418 If you give only the i then nothing is done to the frames, only I! is | |
6419 printed. | |
6420 . | |
6421 .TP | |
6422 .B tile=xtiles:ytiles:output:start:delta | |
6423 Tile a series of images into a single, bigger image. | |
6424 If you omit a parameter or use a value less than 0, then the default | |
6425 value is used. | |
6426 You can also stop when you are satisfied (... \-vf tile=10:5 ...). | |
6427 It is probably a good idea to put the scale filter before the tile :-) | |
6428 .sp 1 | |
6429 The parameters are: | |
6430 .sp 1 | |
6431 .PD 0 | |
6432 .RSs | |
6433 .IPs <xtiles> | |
6434 number of tiles on the x axis (default: 5) | |
6435 .IPs <ytiles> | |
6436 number of tiles on the y axis (default: 5) | |
6437 .IPs <output> | |
6438 Render the tile when 'output' number of frames are reached, where 'output' | |
6439 should be a number less than xtile * ytile. | |
6440 Missing tiles are left blank. | |
6441 You could, for example, write an 8 * 7 tile every 50 frames to have one | |
6442 image every 2 seconds @ 25 fps. | |
6443 .IPs <start> | |
6444 outer border thickness in pixels (default: 2) | |
6445 .IPs <delta> | |
6446 inner border thickness in pixels (default: 4) | |
6447 .RE | |
6448 .PD 1 | |
6449 . | |
6450 .TP | |
6451 .B delogo[=x:y:w:h:t] | |
6452 Suppresses a TV station logo by a simple interpolation of the | |
6453 surrounding pixels. | |
6454 Just set a rectangle covering the logo and watch it disappear (and | |
6455 sometimes something even uglier appear \- your mileage may vary). | |
6456 .PD 0 | |
6457 .RSs | |
6458 .IPs <x>,<y> | |
6459 top left corner of the logo | |
6460 .IPs <w>,<h> | |
6461 width and height of the cleared rectangle | |
6462 .IPs <t> | |
6463 Thickness of the fuzzy edge of the rectangle (added to w and h). | |
6464 When set to -1, a green rectangle is drawn on the screen to | |
6465 simplify finding the right x,y,w,h parameters. | |
6466 .RE | |
6467 .PD 1 | |
6468 . | |
6469 .TP | |
6470 .B remove-logo=/path/to/logo_bitmap_file_name.pgm | |
6471 Suppresses a TV station logo, using a PGM or PPM image | |
6472 file to determine which pixels comprise the logo. | |
6473 The width and height of the image file must match | |
6474 those of the video stream being processed. | |
6475 Uses the filter image and a circular blur | |
6476 algorithm to remove the logo. | |
6477 .RSs | |
6478 .IPs /path/to/logo_bitmap_file_name.pgm | |
6479 [path] + filename of the filter image. | |
6480 .RE | |
6481 . | |
6482 .TP | |
6483 .B zrmjpeg[=options] | |
6484 Software YV12 to MJPEG encoder for use with the zr2 video | |
6485 output device. | |
6486 .RSs | |
6487 .IPs maxheight=<h>|maxwidth=<w> | |
6488 These options set the maximum width and height the zr card | |
6489 can handle (the MPlayer filter layer currently cannot query those). | |
6490 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC} | |
6491 Use these options to set maxwidth and maxheight automatically to the | |
6492 values known for card/\:mode combo. | |
6493 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL) | |
6494 .IPs color|bw | |
6495 Select color or black and white encoding. | |
6496 Black and white encoding is faster. | |
6497 Color is the default. | |
6498 .IPs hdec={1,2,4} | |
6499 Horizontal decimation 1, 2 or 4. | |
6500 .IPs vdec={1,2,4} | |
6501 Vertical decimation 1, 2 or 4. | |
6502 .IPs quality=1\-20 | |
6503 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD]. | |
6504 .IPs fd|nofd | |
6505 By default, decimation is only performed if the Zoran hardware | |
6506 can upscale the resulting MJPEG images to the original size. | |
6507 The option fd instructs the filter to always perform the requested | |
6508 decimation (ugly). | |
6509 .RE | |
6510 . | |
6511 .TP | |
6512 .B screenshot | |
6513 Allows acquiring screenshots of the movie using slave mode | |
6514 commands that can be bound to keypresses. | |
6515 See the slave mode documentation and the INTERACTIVE CONTROL | |
6516 section for details. | |
6517 Files named 'shotNNNN.png' will be saved in the working directory, | |
6518 using the first available number - no files will be overwritten. | |
6519 The filter has no overhead when not used and accepts an arbitrary | |
6520 colorspace, so it is safe to add it to the configuration file. | |
6521 .RE | |
6522 . | |
6523 .TP | |
6524 .B "ass\ \ \ \ " | |
6525 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain. | |
6526 Only useful with the \-ass option. | |
6527 .sp 1 | |
6528 .I EXAMPLE: | |
6529 .PD 0 | |
6530 .RSs | |
6531 .IPs "\-vf ass,screenshot" | |
6532 Moves SSA/ASS rendering before the screenshot filter. | |
6533 Screenshots taken this way will contain subtitles. | |
6534 .RE | |
6535 .PD 1 | |
6536 . | |
6537 .TP | |
6538 .B blackframe[=amount:threshold] | |
6539 Detect frames that are (almost) completely black. | |
6540 Can be useful to detect chapter transitions or commercials. | |
6541 Output lines consist of the frame number of the detected frame, the | |
6542 percentage of blackness, the frame type and the frame number of the last | |
6543 encountered keyframe. | |
6544 .RSs | |
6545 .IPs <amount> | |
6546 Percentage of the pixels that have to be below the threshold (default: 98). | |
6547 .IPs <threshold> | |
6548 Threshold below which a pixel value is considered black (default: 32). | |
6549 .RE | |
6550 . | |
6551 . | |
6552 . | |
6553 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)" | |
6554 . | |
6555 .TP | |
6556 .B \-audio-delay <any floating-point number> | |
6557 Delays either audio or video by setting a delay field in the header | |
6558 (default: 0.0). | |
6559 This does not delay either stream while encoding, but the player will | |
6560 see the delay field and compensate accordingly. | |
6561 Positive values delay the audio, and negative values delay the video. | |
6562 Note that this is the exact opposite of the \-delay option. | |
6563 For example, if a video plays correctly with \-delay 0.2, you can | |
6564 fix the video with MEncoder by using \-audio-delay -0.2. | |
6565 .sp 1 | |
6566 Currently, this option only works with the default muxer (\-of avi). | |
6567 If you are using a different muxer, then you must use \-delay instead. | |
6568 . | |
6569 .TP | |
6570 .B \-audio-density <1\-50> | |
6571 Number of audio chunks per second (default is 2 for 0.5s long audio chunks). | |
6572 .br | |
6573 .I NOTE: | |
6574 CBR only, VBR ignores this as it puts each packet in a new chunk. | |
6575 . | |
6576 .TP | |
6577 .B \-audio-preload <0.0\-2.0> | |
6578 Sets up the audio buffering time interval (default: 0.5s). | |
6579 . | |
6580 .TP | |
6581 .B \-fafmttag <format> | |
6582 Can be used to override the audio format tag of the output file. | |
6583 .sp 1 | |
6584 .I EXAMPLE: | |
6585 .PD 0 | |
6586 .RSs | |
6587 .IPs "\-fafmttag 0x55" | |
6588 Will have the output file contain 0x55 (mp3) as audio format tag. | |
6589 .RE | |
6590 .PD 1 | |
6591 . | |
6592 .TP | |
6593 .B \-ffourcc <fourcc> | |
6594 Can be used to override the video fourcc of the output file. | |
6595 .sp 1 | |
6596 .I EXAMPLE: | |
6597 .PD 0 | |
6598 .RSs | |
6599 .IPs "\-ffourcc div3" | |
6600 Will have the output file contain 'div3' as video fourcc. | |
6601 .RE | |
6602 .PD 1 | |
6603 . | |
6604 .TP | |
6605 .B \-force-avi-aspect <0.2\-3.0> | |
6606 Override the aspect stored in the AVI OpenDML vprp header. | |
6607 This can be used to change the aspect ratio with '\-ovc copy'. | |
6608 . | |
6609 .TP | |
6610 .B \-frameno-file <filename> (DEPRECATED) | |
6611 Specify the name of the audio file with framenumber mappings created in | |
6612 the first (audio only) pass of a special three pass encoding mode. | |
6613 .br | |
6614 .I NOTE: | |
6615 Using this mode will most likely give you A-V desync. | |
6616 Do not use it. | |
6617 It is kept for backwards compatibility only and will possibly | |
6618 be removed in a future version. | |
6619 . | |
6620 .TP | |
6621 .B \-hr-edl-seek | |
6622 Use a more precise, but much slower method for skipping areas. | |
6623 Areas marked for skipping are not seeked over, instead all | |
6624 frames are decoded, but only the necessary frames are encoded. | |
6625 This allows starting at non-keyframe boundaries. | |
6626 .br | |
6627 .I NOTE: | |
6628 Not guaranteed to work right with '\-ovc copy'. | |
6629 . | |
6630 .TP | |
6631 .B \-info <option1:option2:...> (AVI only) | |
6632 Specify the info header of the resulting AVI file. | |
6633 .sp 1 | |
6634 Available options are: | |
6635 .RSs | |
6636 .IPs "help\ " | |
6637 Show this description. | |
6638 .IPs name=<value> | |
6639 title of the work | |
6640 .IPs artist=<value> | |
6641 artist or author of the work | |
6642 .IPs genre=<value> | |
6643 original work category | |
6644 .IPs subject=<value> | |
6645 contents of the work | |
6646 .IPs copyright=<value> | |
6647 copyright information | |
6648 .IPs srcform=<value> | |
6649 original format of the digitized material | |
6650 .IPs comment=<value> | |
6651 general comments about the work | |
6652 .RE | |
6653 . | |
6654 .TP | |
6655 .B \-noautoexpand | |
6656 Do not automatically insert the expand filter into the MEncoder filter chain. | |
6657 Useful to control at which point of the filter chain subtitles are rendered | |
6658 when hardcoding subtitles onto a movie. | |
6659 . | |
6660 .TP | |
6661 .B \-noencodedups | |
6662 Do not attempt to encode duplicate frames in duplicate; always output | |
6663 zero-byte frames to indicate duplicates. | |
6664 Zero-byte frames will be written anyway unless a filter or encoder | |
6665 capable of doing duplicate encoding is loaded. | |
6666 Currently the only such filter is harddup. | |
6667 . | |
6668 .TP | |
6669 .B \-noodml (\-of avi only) | |
6670 Do not write OpenDML index for AVI files >1GB. | |
6671 . | |
6672 .TP | |
6673 .B \-noskip | |
6674 Do not skip frames. | |
6675 . | |
6676 .TP | |
6677 .B \-o <filename> | |
6678 Outputs to the given filename. | |
6679 .br | |
6680 If you want a default output filename, you can put this option in the | |
6681 MEncoder config file. | |
6682 . | |
6683 .TP | |
6684 .B \-oac <codec name> | |
6685 Encode with the given audio codec (no default set). | |
6686 .br | |
6687 .I NOTE: | |
6688 Use \-oac help to get a list of available audio codecs. | |
6689 .sp 1 | |
6690 .I EXAMPLE: | |
6691 .PD 0 | |
6692 .RSs | |
6693 .IPs "\-oac copy" | |
6694 no encoding, just streamcopy | |
6695 .IPs "\-oac pcm" | |
6696 Encode to uncompressed PCM. | |
6697 .IPs "\-oac mp3lame" | |
6698 Encode to MP3 (using LAME). | |
6699 .IPs "\-oac lavc" | |
6700 Encode with a libavcodec codec. | |
6701 .RE | |
6702 .PD 1 | |
6703 . | |
6704 .TP | |
6705 .B \-of <format> (BETA CODE!) | |
6706 Encode to the specified container format (default: AVI). | |
6707 .br | |
6708 .I NOTE: | |
6709 Use \-of help to get a list of available container formats. | |
6710 .sp 1 | |
6711 .I EXAMPLE: | |
6712 .PD 0 | |
6713 .RSs | |
6714 .IPs "\-of avi" | |
6715 Encode to AVI. | |
6716 .IPs "\-of mpeg" | |
6717 Encode to MPEG (also see \-mpegopts). | |
6718 .IPs "\-of lavf" | |
6719 Encode with libavformat muxers (also see \-lavfopts). | |
6720 .IPs "\-of rawvideo" | |
6721 raw video stream (no muxing \- one video stream only) | |
6722 .IPs "\-of rawaudio" | |
6723 raw audio stream (no muxing \- one audio stream only) | |
6724 .RE | |
6725 .PD 1 | |
6726 . | |
6727 .TP | |
6728 .B \-ofps <fps> | |
6729 Specify a frames per second (fps) value for the output file, | |
6730 which can be different from that of the source material. | |
6731 Must be set for variable fps (ASF, some MOV) and progressive | |
6732 (30000/1001 fps telecined MPEG) files. | |
6733 . | |
6734 .TP | |
6735 .B \-ovc <codec name> | |
6736 Encode with the given video codec (no default set). | |
6737 .br | |
6738 .I NOTE: | |
6739 Use \-ovc help to get a list of available video codecs. | |
6740 .sp 1 | |
6741 .I EXAMPLE: | |
6742 .PD 0 | |
6743 .RSs | |
6744 .IPs "\-ovc copy" | |
6745 no encoding, just streamcopy | |
6746 .IPs "\-ovc raw" | |
6747 Encode to an arbitrary uncompressed format (use '\-vf format' to select). | |
6748 .IPs "\-ovc lavc" | |
6749 Encode with a libavcodec codec. | |
6750 .RE | |
6751 .PD 1 | |
6752 . | |
6753 .TP | |
6754 .B \-passlogfile <filename> | |
6755 Dump first pass information to <filename> instead of the default divx2pass.log | |
6756 in two pass encoding mode. | |
6757 . | |
6758 .TP | |
6759 .B \-skiplimit <value> | |
6760 Specify the maximum number of frames that may be skipped after | |
6761 encoding one frame (\-noskiplimit for unlimited). | |
6762 . | |
6763 .TP | |
6764 .B \-vobsubout <basename> | |
6765 Specify the basename for the output .idx and .sub files. | |
6766 This turns off subtitle rendering in the encoded movie and diverts it to | |
6767 VOBsub subtitle files. | |
6768 . | |
6769 .TP | |
6770 .B \-vobsuboutid <langid> | |
6771 Specify the language two letter code for the subtitles. | |
6772 This overrides what is read from the DVD or the .ifo file. | |
6773 . | |
6774 .TP | |
6775 .B \-vobsuboutindex <index> | |
6776 Specify the index of the subtitles in the output files (default: 0). | |
6777 . | |
6778 . | |
6779 . | |
6780 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)" | |
6781 You can specify codec specific encoding parameters using the following | |
6782 syntax: | |
6783 . | |
6784 .TP | |
6785 .B \-<codec>opts <option1[=value],option2,...> | |
6786 . | |
6787 .PP | |
6788 Where <codec> may be: lavc, xvidenc, lame, toolame, twolame, | |
6789 nuv, xvfw, faac, x264enc, mpeg, lavf. | |
6790 . | |
6791 . | |
6792 .SS lame (\-lameopts) | |
6793 . | |
6794 .TP | |
6795 .B "help\ \ \ " | |
6796 get help | |
6797 . | |
6798 .TP | |
6799 .B vbr=<0\-4> | |
6800 variable bitrate method | |
6801 .PD 0 | |
6802 .RSs | |
6803 .IPs 0 | |
6804 cbr | |
6805 .IPs 1 | |
6806 mt | |
6807 .IPs 2 | |
6808 rh (default) | |
6809 .IPs 3 | |
6810 abr | |
6811 .IPs 4 | |
6812 mtrh | |
6813 .RE | |
6814 .PD 1 | |
6815 . | |
6816 .TP | |
6817 .B "abr\ \ \ \ " | |
6818 average bitrate | |
6819 . | |
6820 .TP | |
6821 .B "cbr\ \ \ \ " | |
6822 constant bitrate | |
6823 Also forces CBR mode encoding on subsequent ABR presets modes. | |
6824 . | |
6825 .TP | |
6826 .B br=<0\-1024> | |
6827 bitrate in kbps (CBR and ABR only) | |
6828 . | |
6829 .TP | |
6830 .B q=<0\-9> | |
6831 quality (0 \- highest, 9 \- lowest) (VBR only) | |
6832 . | |
6833 .TP | |
6834 .B aq=<0\-9> | |
6835 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest) | |
6836 . | |
6837 .TP | |
6838 .B ratio=<1\-100> | |
6839 compression ratio | |
6840 . | |
6841 .TP | |
6842 .B vol=<0\-10> | |
6843 audio input gain | |
6844 . | |
6845 .TP | |
6846 .B mode=<0\-3> | |
6847 (default: auto) | |
6848 .PD 0 | |
6849 .RSs | |
6850 .IPs 0 | |
6851 stereo | |
6852 .IPs 1 | |
6853 joint-stereo | |
6854 .IPs 2 | |
6855 dualchannel | |
6856 .IPs 3 | |
6857 mono | |
6858 .RE | |
6859 .PD 1 | |
6860 . | |
6861 .TP | |
6862 .B padding=<0\-2> | |
6863 .PD 0 | |
6864 .RSs | |
6865 .IPs 0 | |
6866 none | |
6867 .IPs 1 | |
6868 all | |
6869 .IPs 2 | |
6870 adjust | |
6871 .RE | |
6872 .PD 1 | |
6873 . | |
6874 .TP | |
6875 .B "fast\ \ \ " | |
6876 Switch on faster encoding on subsequent VBR presets modes. | |
6877 This results in slightly lower quality and higher bitrates. | |
6878 . | |
6879 .TP | |
6880 .B highpassfreq=<freq> | |
6881 Set a highpass filtering frequency in Hz. | |
6882 Frequencies below the specified one will be cut off. | |
6883 A value of -1 will disable filtering, a value of 0 | |
6884 will let LAME choose values automatically. | |
6885 . | |
6886 .TP | |
6887 .B lowpassfreq=<freq> | |
6888 Set a lowpass filtering frequency in Hz. | |
6889 Frequencies above the specified one will be cut off. | |
6890 A value of -1 will disable filtering, a value of 0 | |
6891 will let LAME choose values automatically. | |
6892 . | |
6893 .TP | |
6894 .B preset=<value> | |
6895 preset values | |
6896 .RSs | |
6897 .IPs "help\ " | |
6898 Print additional options and information about presets settings. | |
6899 .IPs medium | |
6900 VBR encoding, good quality, 150\-180 kbps bitrate range | |
6901 .IPs standard | |
6902 VBR encoding, high quality, 170\-210 kbps bitrate range | |
6903 .IPs extreme | |
6904 VBR encoding, very high quality, 200\-240 kbps bitrate range | |
6905 .IPs insane | |
6906 CBR encoding, highest preset quality, 320 kbps bitrate | |
6907 .IPs <8\-320> | |
6908 ABR encoding at average given kbps bitrate | |
6909 .RE | |
6910 .sp 1 | |
6911 .RS | |
6912 .I EXAMPLES: | |
6913 .RE | |
6914 .PD 0 | |
6915 .RSs | |
6916 .IPs fast:preset=standard | |
6917 suitable for most people and most music types and already quite high quality | |
6918 .IPs cbr:preset=192 | |
6919 Encode with ABR presets at a 192 kbps forced constant bitrate. | |
6920 .IPs preset=172 | |
6921 Encode with ABR presets at a 172 kbps average bitrate. | |
6922 .IPs preset=extreme | |
6923 for people with extremely good hearing and similar equipment | |
6924 .RE | |
6925 .PD 1 | |
6926 . | |
6927 . | |
6928 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively) | |
6929 . | |
6930 .TP | |
6931 .B br=<32\-384> | |
6932 In CBR mode this parameter indicates the bitrate in kbps, | |
6933 when in VBR mode it is the minimum bitrate allowed per frame. | |
6934 VBR mode will not work with a value below 112. | |
6935 . | |
6936 .TP | |
6937 .B vbr=<-50\-50> (VBR only) | |
6938 variability range; if negative the encoder shifts the average bitrate | |
6939 towards the lower limit, if positive towards the higher. | |
6940 When set to 0 CBR is used (default). | |
6941 . | |
6942 .TP | |
6943 .B maxvbr=<32\-384> (VBR only) | |
6944 maximum bitrate allowed per frame, in kbps | |
6945 . | |
6946 .TP | |
6947 .B mode=<stereo | jstereo | mono | dual> | |
6948 (default: mono for 1-channel audio, stereo otherwise) | |
6949 . | |
6950 .TP | |
6951 .B psy=<-1\-4> | |
6952 psychoacoustic model (default: 2) | |
6953 . | |
6954 .TP | |
6955 .B errprot=<0 | 1> | |
6956 Include error protection. | |
6957 . | |
6958 .TP | |
6959 .B debug=<0\-10> | |
6960 debug level | |
6961 .RE | |
6962 .PD 1 | |
6963 . | |
6964 . | |
6965 .SS faac (\-faacopts) | |
6966 . | |
6967 .TP | |
6968 .B br=<bitrate> | |
6969 average bitrate in kbps (mutually exclusive with quality) | |
6970 . | |
6971 .TP | |
6972 .B quality=<1\-1000> | |
6973 quality mode, the higher the better (mutually exclusive with br) | |
6974 . | |
6975 .TP | |
6976 .B object=<1\-4> | |
6977 object type complexity | |
6978 .PD 0 | |
6979 .RSs | |
6980 .IPs 1 | |
6981 MAIN (default) | |
6982 .IPs 2 | |
6983 LOW | |
6984 .IPs 3 | |
6985 SSR | |
6986 .IPs 4 | |
6987 LTP (extremely slow) | |
6988 .RE | |
6989 .PD 1 | |
6990 . | |
6991 .TP | |
6992 .B mpeg=<2|4> | |
6993 MPEG version (default: 4) | |
6994 . | |
6995 .TP | |
6996 .B "tns\ \ \ \ " | |
6997 Enables temporal noise shaping. | |
6998 . | |
6999 .TP | |
7000 .B cutoff=<0\-sampling_rate/2> | |
7001 cutoff frequency (default: sampling_rate/2) | |
7002 . | |
7003 .TP | |
7004 .B "raw\ \ \ \ " | |
7005 Stores the bitstream as raw payload with extradata in the container header | |
7006 (default: 0, corresponds to ADTS). | |
7007 Do not set this flag if not explicitly required or you will not be able to | |
7008 remux the audio stream later on. | |
7009 .RE | |
7010 .PD 1 | |
7011 . | |
7012 . | |
7013 .SS lavc (\-lavcopts) | |
7014 . | |
7015 Many libavcodec (lavc for short) options are tersely documented. | |
7016 Read the source for full details. | |
7017 .PP | |
7018 .I EXAMPLE: | |
7019 .PD 0 | |
7020 .RSs | |
7021 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 | |
7022 .RE | |
7023 .PD 1 | |
7024 . | |
7025 .TP | |
7026 .B acodec=<value> | |
7027 audio codec (default: mp2) | |
7028 .PD 0 | |
7029 .RSs | |
7030 .IPs "mp2\ \ " | |
7031 MPEG Layer 2 | |
7032 .IPs "mp3\ \ " | |
7033 MPEG Layer 3 | |
7034 .IPs "ac3\ \ " | |
7035 AC3 | |
7036 .IPs adpcm_ima_wav | |
7037 IMA Adaptive PCM (4bits per sample, 4:1 compression) | |
7038 .IPs "sonic\ " | |
7039 Experimental lossy/lossless codec | |
7040 .RE | |
7041 .PD 1 | |
7042 . | |
7043 .TP | |
7044 .B abitrate=<value> | |
7045 audio bitrate in kbps (default: 224) | |
7046 . | |
7047 .TP | |
7048 .B atag=<value> | |
7049 Use the specified Windows audio format tag (e.g.\& atag=0x55). | |
7050 . | |
7051 .TP | |
7052 .B bit_exact | |
7053 Use only bit exact algorithms (except (I)DCT). | |
7054 Additionally bit_exact disables several optimizations and thus | |
7055 should only be used for regression tests, which need binary | |
7056 identical files even if the encoder version changes. | |
7057 This also suppresses the user_data header in MPEG-4 streams. | |
7058 Do not use this option unless you know exactly what you are doing. | |
7059 . | |
7060 .TP | |
7061 .B threads=<1\-8> | |
7062 Maximum number of threads to use (default: 1). | |
7063 May have a slight negative effect on motion estimation. | |
7064 .RE | |
7065 . | |
7066 .TP | |
7067 .B vcodec=<value> | |
7068 Employ the specified codec (default: mpeg4). | |
7069 .PD 0 | |
7070 .RSs | |
7071 .IPs mjpeg | |
7072 Motion JPEG | |
7073 .IPs ljpeg | |
7074 Lossless JPEG | |
7075 .IPs "h261\ " | |
7076 H.261 | |
7077 .IPs "h263\ " | |
7078 H.263 | |
7079 .IPs h263p | |
7080 H.263+ | |
7081 .IPs mpeg4 | |
7082 MPEG-4 (DivX 4/5) | |
7083 .IPs msmpeg4 | |
7084 DivX 3 | |
7085 .IPs msmpeg4v2 | |
7086 MS MPEG4v2 | |
7087 .IPs "wmv1\ " | |
7088 Windows Media Video, version 1 (AKA WMV7) | |
7089 .IPs "wmv2\ " | |
7090 Windows Media Video, version 2 (AKA WMV8) | |
7091 .IPs "rv10\ " | |
7092 an old RealVideo codec | |
7093 .IPs mpeg1video | |
7094 MPEG-1 video | |
7095 .IPs mpeg2video | |
7096 MPEG-2 video | |
7097 .IPs huffyuv | |
7098 HuffYUV | |
7099 .IPs ffvhuff (also see: vstrict) | |
7100 nonstandard 20% smaller HuffYUV using YV12 | |
7101 .IPs "asv1\ " | |
7102 ASUS Video v1 | |
7103 .IPs "asv2\ " | |
7104 ASUS Video v2 | |
7105 .IPs "ffv1 (also see: vstrict)" | |
7106 FFmpeg's lossless video codec | |
7107 .IPs "flv\ \ " | |
7108 Sorenson H.263 used in Flash Video | |
7109 .IPs dvvideo | |
7110 Sony Digital Video | |
7111 .IPs "svq1\ " | |
7112 Apple Sorenson Video 1 | |
7113 .IPs "snow (also see: vstrict)" | |
7114 FFmpeg's experimental wavelet-based codec | |
7115 .RE | |
7116 .PD 1 | |
7117 . | |
7118 .TP | |
7119 .B vqmin=<1\-31> | |
7120 minimum quantizer (pass 1/2) | |
7121 .RSs | |
7122 .IPs 1 | |
7123 Not recommended (much larger file, little quality difference and weird side | |
7124 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused | |
7125 resulting in lower quality and some decoders will not be able to decode it). | |
7126 .IPs 2 | |
7127 Recommended for normal mpeg4/\:mpeg1video encoding (default). | |
7128 .IPs 3 | |
7129 Recommended for h263(p)/\:msmpeg4. | |
7130 The reason for preferring 3 over 2 is that 2 could lead to overflows. | |
7131 (This will be fixed for h263(p) by changing the quantizer per MB in | |
7132 the future, msmpeg4 cannot be fixed as it does not support that.) | |
7133 .RE | |
7134 . | |
7135 .TP | |
7136 .B lmin=<0.01\-255.0> | |
20768 | 7137 Minimum frame-level Lagrange multiplier for ratecontrol (default: 2.0). |
7138 Lavc will rarely use quantizers below the value of lmin. | |
7139 Lowering lmin will make lavc more likely to choose lower quantizers for | |
7140 some frames, but not lower than the value of vqmin. | |
7141 Likewise, raising lmin will make lavc less likely to choose low | |
7142 quantizers, even if vqmin would have allowed them. | |
7143 You probably want to set lmin approximately equal to vqmin. | |
7144 When adaptive quantization is in use, changing lmin/lmax may have less | |
7145 of an effect; see mblmin/mblmax. | |
20707 | 7146 .RE |
7147 . | |
7148 .TP | |
7149 .B lmax=<0.01\-255.0> | |
7150 maximum Lagrange multiplier for ratecontrol (default: 31.0) | |
7151 .RE | |
7152 . | |
7153 .TP | |
20768 | 7154 .B mblmin=<0.01\-255.0> |
7155 Minimum macroblock-level Lagrange multiplier for ratecontrol | |
7156 (default:2.0). | |
7157 This parameter affects adaptive quantization options like qprd, | |
7158 lumi_mask, etc.. | |
7159 .RE | |
7160 . | |
7161 .TP | |
7162 .B mblmax=<0.01\-255.0> | |
7163 Maximum macroblock-level Lagrange multiplier for ratecontrol | |
7164 (default: 31.0). | |
7165 .RE | |
7166 . | |
7167 .TP | |
20707 | 7168 .B vqscale=<0\-31> |
7169 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode). | |
7170 A lower value means better quality but larger files (default: 0). | |
7171 In case of snow codec, value 0 means lossless encoding. | |
7172 Since the other codecs do not support this, vqscale=0 will be ignored and | |
7173 variable quantizers are used, which is the default. | |
7174 1 is not recommended (see vqmin for details). | |
7175 . | |
7176 .TP | |
7177 .B vqmax=<1\-31> | |
7178 Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31). | |
7179 . | |
7180 .TP | |
7181 .B mbqmin=<1\-31> | |
7182 obsolete, use vqmin | |
7183 . | |
7184 .TP | |
7185 .B mbqmax=<1\-31> | |
7186 obsolete, use vqmax | |
7187 . | |
7188 .TP | |
7189 .B vqdiff=<1\-31> | |
7190 maximum quantizer difference between consecutive I- or P-frames | |
7191 (pass 1/2) (default: 3) | |
7192 . | |
7193 .TP | |
7194 .B vmax_b_frames=<0\-4> | |
7195 maximum number of B-frames between non-B-frames: | |
7196 .PD 0 | |
7197 .RSs | |
7198 .IPs 0 | |
7199 no B-frames (default) | |
7200 .IPs 0\-2 | |
7201 sane range for MPEG-4 | |
7202 .RE | |
7203 .PD 1 | |
7204 . | |
7205 .TP | |
7206 .B vme=<0\-5> | |
7207 motion estimation method. | |
7208 Available methods are: | |
7209 .PD 0 | |
7210 .RSs | |
7211 .IPs 0 | |
7212 none (very low quality) | |
7213 .IPs 1 | |
7214 full (slow, currently unmaintained and disabled) | |
7215 .IPs 2 | |
7216 log (low quality, currently unmaintained and disabled) | |
7217 .IPs 3 | |
7218 phods (low quality, currently unmaintained and disabled) | |
7219 .IPs 4 | |
7220 EPZS: size=1 diamond, size can be adjusted with the *dia options | |
7221 (default) | |
7222 .IPs 5 | |
7223 X1 (experimental, currently aliased to EPZS) | |
7224 .IPs 8 | |
7225 iter (iterative overlapped block, only used in snow) | |
7226 .RE | |
7227 .PD 1 | |
7228 .sp 1 | |
7229 .RS | |
7230 .br | |
7231 .I NOTE: | |
7232 0\-3 currently ignores the amount of bits spent, | |
7233 so quality may be low. | |
7234 .RE | |
7235 . | |
7236 .TP | |
7237 .B me_range=<0\-9999> | |
7238 motion estimation search range (default: 0 (unlimited)) | |
7239 . | |
7240 .TP | |
7241 .B mbd=<0\-2> | |
7242 Macroblock decision algorithm (high quality mode), encode each macro | |
7243 block in all modes and choose the best. | |
7244 This is slow but results in better quality and file size. | |
7245 .PD 0 | |
7246 .RSs | |
7247 .IPs 0 | |
7248 Use mbcmp (default). | |
7249 .IPs 1 | |
7250 Select the MB mode which needs the fewest bits (=vhq). | |
7251 .IPs 2 | |
7252 Select the MB mode which has the best rate distortion. | |
7253 .RE | |
7254 .PD 1 | |
7255 . | |
7256 .TP | |
7257 .B "vhq\ \ \ \ " | |
7258 Same as mbd=1, kept for compatibility reasons. | |
7259 . | |
7260 .TP | |
7261 .B "v4mv\ \ \ " | |
7262 Allow 4 motion vectors per macroblock (slightly better quality). | |
7263 Works better if used with mbd>0. | |
7264 . | |
7265 .TP | |
7266 .B "obmc\ \ \ " | |
7267 overlapped block motion compensation (H.263+) | |
7268 . | |
7269 .TP | |
7270 .B "loop\ \ \ " | |
7271 loop filter (H.263+) | |
7272 note, this is broken | |
7273 . | |
7274 .TP | |
7275 .B inter_threshold <-1000\-1000> | |
7276 Does absolutely nothing at the moment. | |
7277 . | |
7278 .TP | |
7279 .B keyint=<0\-300> | |
7280 maximum interval between keyframes in frames (default: 250 or one | |
7281 keyframe every ten seconds in a 25fps movie. | |
7282 This is the recommended default for MPEG-4). | |
7283 Most codecs require regular keyframes in order to limit the accumulation of mismatch error. | |
7284 Keyframes are also needed for seeking, as seeking is only possible to a keyframe - but | |
7285 keyframes need more space than other frames, so larger numbers here mean | |
7286 slightly smaller files but less precise seeking. | |
7287 0 is equivalent to 1, which makes every frame a keyframe. | |
7288 Values >300 are not recommended as the quality might be bad depending upon | |
7289 decoder, encoder and luck. | |
7290 It is a common for MPEG-1/2 to use values <=30. | |
7291 . | |
7292 .TP | |
7293 .B sc_threshold=<-1000000000\-1000000000> | |
7294 Threshold for scene change detection. | |
7295 A keyframe is inserted by libavcodec when it detects a scene change. | |
7296 You can specify the sensitivity of the detection with this option. | |
7297 -1000000000 means there is a scene change detected at every frame, | |
7298 1000000000 means no scene changes are detected (default: 0). | |
7299 . | |
7300 .TP | |
7301 .B sc_factor=<any positive integer> | |
7302 Causes frames with higher quantizers to be more likely to trigger a | |
7303 scene change detection and make libavcodec use an I-frame (default: 1). | |
7304 1\-16 is a sane range. | |
7305 Values between 2 and 6 may yield increasing PSNR (up to approximately | |
7306 0.04 dB) and better placement of I-frames in high-motion scenes. | |
7307 Higher values than 6 may give very slightly better PSNR (approximately | |
7308 0.01 dB more than sc_factor=6), but noticably worse visual quality. | |
7309 . | |
7310 .TP | |
7311 .B vb_strategy=<0\-2> (pass one only) | |
7312 strategy to choose between I/P/B-frames: | |
7313 .PD 0 | |
7314 .RSs | |
7315 .IPs 0 | |
7316 Always use the maximum number of B-frames (default). | |
7317 .IPs 1 | |
7318 Avoid B-frames in high motion scenes. | |
7319 See the b_sensitivity option to tune this strategy. | |
7320 .IPs 2 | |
7321 Places B-frames more or less optimally to yield maximum quality (slower). | |
7322 You may want to reduce the speed impact of this option by tuning the | |
7323 option brd_scale. | |
7324 .RE | |
7325 .PD 1 | |
7326 . | |
7327 .TP | |
7328 .B b_sensitivity=<any integer greater than 0> | |
7329 Adjusts how sensitively vb_strategy=1 detects motion and avoids using | |
7330 B-frames (default: 40). | |
7331 Lower sensitivities will result in more B-frames. | |
7332 Using more B-frames usually improves PSNR, but too many B-frames can | |
7333 hurt quality in high-motion scenes. | |
7334 Unless there is an extremely high amount of motion, b_sensitivity can | |
7335 safely be lowered below the default; 10 is a reasonable value in most | |
7336 cases. | |
7337 . | |
7338 .TP | |
7339 .B brd_scale=<0\-10> | |
7340 Downscales frames for dynamic B-frame decision (default: 0). | |
7341 Each time brd_scale is increased by one, the frame dimensions are | |
7342 divided by two, which improves speed by a factor of four. | |
7343 Both dimensions of the fully downscaled frame must be even numbers, so | |
7344 brd_scale=1 requires the original dimensions to be multiples of four, | |
7345 brd_scale=2 requires multiples of eight, etc. | |
7346 In other words, the dimensions of the original frame must both be | |
7347 divisible by 2^(brd_scale+1) with no remainder. | |
7348 . | |
7349 .TP | |
7350 .B bidir_refine=<0\-4> | |
7351 Refine the two motion vectors used in bidirectional macroblocks, | |
7352 rather than re-using vectors from the forward and backward searches. | |
7353 This option has no effect without B-frames. | |
7354 .PD 0 | |
7355 .RSs | |
7356 .IPs 0 | |
7357 Disabled (default). | |
7358 .IPs 1\-4 | |
7359 Use a wider search (larger values are slower). | |
7360 .RE | |
7361 .PD 1 | |
7362 . | |
7363 .TP | |
7364 .B vpass=<1\-3> | |
7365 Activates internal two (or more) pass mode, only specify if you wish to | |
7366 use two (or more) pass encoding. | |
7367 .PD 0 | |
7368 .RSs | |
7369 .IPs 1 | |
7370 first pass (also see turbo) | |
7371 .IPs 2 | |
7372 second pass | |
7373 .IPs 3 | |
7374 Nth pass (second and subsequent passes of N-pass encoding) | |
7375 .RE | |
7376 .RS | |
7377 Here is how it works, and how to use it: | |
7378 .br | |
7379 The first pass (vpass=1) writes the statistics file. | |
7380 You might want to deactivate some CPU-hungry options, like "turbo" | |
7381 mode does. | |
7382 .br | |
7383 In two pass mode, the second pass (vpass=2) reads the statistics file and | |
7384 bases ratecontrol decisions on it. | |
7385 .br | |
7386 In N-pass mode, the second pass (vpass=3, that is not a typo) | |
7387 does both: It first reads the statistics, then overwrites them. | |
7388 You might want to backup divx2pass.log before doing this if there is | |
7389 any possibility that you will have to cancel MEncoder. | |
7390 You can use all encoding options, except very CPU-hungry options like "qns". | |
7391 .br | |
7392 You can run this same pass over and over to refine the encode. | |
7393 Each subsequent pass will use the statistics from the previous pass to improve. | |
7394 The final pass can include any CPU-hungry encoding options. | |
7395 .br | |
7396 If you want a 2 pass encode, use first vpass=1, and then vpass=2. | |
7397 .br | |
7398 If you want a 3 or more pass encode, use vpass=1 for the first pass | |
7399 and then vpass=3 and then vpass=3 again and again until you are | |
7400 satisfied with the encode. | |
7401 .RE | |
7402 .PD 1 | |
7403 .sp 1 | |
7404 .RS | |
7405 huffyuv: | |
7406 .RE | |
7407 .PD 0 | |
7408 .RSs | |
7409 .IPs "pass 1" | |
7410 Saves statistics. | |
7411 .IPs "pass 2" | |
7412 Encodes with an optimal Huffman table based upon statistics | |
7413 from the first pass. | |
7414 .RE | |
7415 .PD 1 | |
7416 . | |
7417 .TP | |
7418 .B turbo (two pass only) | |
7419 Dramatically speeds up pass one using faster algorithms and disabling | |
7420 CPU-intensive options. | |
7421 This will probably reduce global PSNR a little bit (around 0.01dB) and | |
7422 change individual frame type and PSNR a little bit more (up to 0.03dB). | |
7423 . | |
7424 .TP | |
7425 .B aspect=<x/y> | |
7426 Store movie aspect internally, just like with MPEG files. | |
7427 Much nicer than rescaling, because quality is not decreased. | |
7428 Only MPlayer will play these files correctly, other players will display | |
7429 them with wrong aspect. | |
7430 The aspect parameter can be given as a ratio or a floating point number. | |
7431 .sp 1 | |
7432 .RS | |
7433 .I EXAMPLE: | |
7434 .RE | |
7435 .RSs | |
7436 .PD 0 | |
7437 .IPs "aspect=16/9 or aspect=1.78" | |
7438 .PD 1 | |
7439 .RE | |
7440 . | |
7441 .TP | |
7442 .B autoaspect | |
7443 Same as the aspect option, but automatically computes aspect, taking | |
7444 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
7445 filter chain. | |
7446 Does not incur a performance penalty, so you can safely leave it | |
7447 always on. | |
7448 . | |
7449 .TP | |
7450 .B vbitrate=<value> | |
7451 Specify bitrate (pass 1/2) (default: 800). | |
7452 .br | |
7453 .I WARNING: | |
7454 1kbit = 1000 bits | |
7455 .PD 0 | |
7456 .RSs | |
7457 .IPs 4\-16000 | |
7458 (in kbit) | |
7459 .IPs 16001\-24000000 | |
7460 (in bit) | |
7461 .RE | |
7462 .PD 1 | |
7463 . | |
7464 .TP | |
7465 .B vratetol=<value> | |
7466 approximated file size tolerance in kbit. | |
7467 1000\-100000 is a sane range. | |
7468 (warning: 1kbit = 1000 bits) | |
7469 (default: 8000) | |
7470 .br | |
7471 .I NOTE: | |
7472 vratetol should not be too large during the second pass or there might | |
7473 be problems if vrc_(min|max)rate is used. | |
7474 . | |
7475 .TP | |
7476 .B vrc_maxrate=<value> | |
7477 maximum bitrate in kbit/\:sec (pass 1/2) | |
7478 (default: 0, unlimited) | |
7479 . | |
7480 .TP | |
7481 .B vrc_minrate=<value> | |
7482 minimum bitrate in kbit/\:sec (pass 1/2) | |
7483 (default: 0, unlimited) | |
7484 . | |
7485 .TP | |
7486 .B vrc_buf_size=<value> | |
7487 buffer size in kbit (pass 1/2). | |
7488 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD, | |
7489 917 for SVCD and 1835 for DVD. | |
7490 . | |
7491 .TP | |
7492 .B vrc_buf_aggressivity | |
7493 currently useless | |
7494 . | |
7495 .TP | |
7496 .B vrc_strategy | |
7497 Ratecontrol method. | |
7498 Note that some of the ratecontrol-affecting options will have no effect | |
7499 if vrc_strategy is not set to 0. | |
7500 .PD 0 | |
7501 .RSs | |
7502 .IPs 0 | |
7503 Use internal lavc ratecontrol (default). | |
7504 .IPs 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
7505 Use Xvid ratecontrol (experimental; requires MEncoder to be compiled |
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
7506 with support for Xvid 1.1 or higher). |
20707 | 7507 .RE |
7508 .PD 1 | |
7509 . | |
7510 .TP | |
7511 .B vb_qfactor=<-31.0\-31.0> | |
7512 quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7513 . | |
7514 .TP | |
7515 .B vi_qfactor=<-31.0\-31.0> | |
7516 quantizer factor between I- and non-I-frames (pass 1/2) (default: 0.8) | |
7517 . | |
7518 .TP | |
7519 .B vb_qoffset=<-31.0\-31.0> | |
7520 quantizer offset between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7521 . | |
7522 .TP | |
7523 .B vi_qoffset=<-31.0\-31.0> | |
7524 (pass 1/2) (default: 0.0) | |
7525 .br | |
7526 if v{b|i}_qfactor > 0 | |
7527 .br | |
7528 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset | |
7529 .br | |
7530 else | |
7531 .br | |
7532 do normal ratecontrol (do not lock to next P-frame quantizer) and | |
7533 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset | |
7534 .br | |
7535 .I HINT: | |
7536 To do constant quantizer encoding with different quantizers for | |
7537 I/P- and B-frames you can use: | |
7538 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>. | |
7539 . | |
7540 .TP | |
7541 .B vqblur=<0.0\-1.0> (pass one) | |
7542 Quantizer blur (default: 0.5), larger values will average the | |
7543 quantizer more over time (slower change). | |
7544 .PD 0 | |
7545 .RSs | |
7546 .IPs 0.0 | |
7547 Quantizer blur disabled. | |
7548 .IPs 1.0 | |
7549 Average the quantizer over all previous frames. | |
7550 .RE | |
7551 .PD 1 | |
7552 . | |
7553 .TP | |
7554 .B vqblur=<0.0\-99.0> (pass two) | |
7555 Quantizer gaussian blur (default: 0.5), larger values will average | |
7556 the quantizer more over time (slower change). | |
7557 . | |
7558 .TP | |
7559 .B vqcomp=<0.0\-1.0> | |
7560 Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5). | |
7561 For instance, assuming the default rate control equation is used, | |
7562 if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits | |
7563 needed to encode them all at the same QP. | |
7564 If vqcomp=0.0, the ratecontrol allocates the same number of bits to each | |
7565 frame, i.e. strict CBR. | |
7566 .I NOTE: | |
7567 Those are extreme settings and should never be used. | |
7568 Perceptual quality will be optimal somewhere in between these two extremes. | |
7569 . | |
7570 .TP | |
7571 .B vrc_eq=<equation> | |
7572 main ratecontrol equation (pass 1/2) | |
7573 .RE | |
7574 .RSs | |
7575 .IPs "1\ \ \ \ " | |
7576 constant bitrate | |
7577 .IPs "tex\ \ " | |
7578 constant quality | |
7579 .IPs 1+(tex/\:avgTex-1)*qComp | |
7580 approximately the equation of the old ratecontrol code | |
7581 .IPs tex^qComp | |
7582 with qcomp 0.5 or something like that (default) | |
7583 .RE | |
7584 .PP | |
7585 .RS | |
7586 infix operators: | |
7587 .RE | |
7588 .RSs | |
7589 .IPs +,-,*,/,^ | |
7590 .RE | |
7591 .PP | |
7592 .RS | |
7593 variables: | |
7594 .RE | |
7595 .RSs | |
7596 .IPs "tex\ \ " | |
7597 texture complexity | |
7598 .IPs iTex,pTex | |
7599 intra, non-intra texture complexity | |
7600 .IPs avgTex | |
7601 average texture complexity | |
7602 .IPs avgIITex | |
7603 average intra texture complexity in I-frames | |
7604 .IPs avgPITex | |
7605 average intra texture complexity in P-frames | |
7606 .IPs avgPPTex | |
7607 average non-intra texture complexity in P-frames | |
7608 .IPs avgBPTex | |
7609 average non-intra texture complexity in B-frames | |
7610 .IPs "mv\ \ \ " | |
7611 bits used for motion vectors | |
7612 .IPs fCode | |
7613 maximum length of motion vector in log2 scale | |
7614 .IPs iCount | |
7615 number of intra macroblocks / number of macroblocks | |
7616 .IPs "var\ \ " | |
7617 spatial complexity | |
7618 .IPs mcVar | |
7619 temporal complexity | |
7620 .IPs qComp | |
7621 qcomp from the command line | |
7622 .IPs "isI, isP, isB" | |
7623 Is 1 if picture type is I/P/B else 0. | |
7624 .IPs "Pi,E\ " | |
7625 See your favorite math book. | |
7626 .RE | |
7627 .PP | |
7628 .RS | |
7629 functions: | |
7630 .RE | |
7631 .RSs | |
7632 .IPs max(a,b),min(a,b) | |
7633 maximum / minimum | |
7634 .IPs gt(a,b) | |
7635 is 1 if a>b, 0 otherwise | |
7636 .IPs lt(a,b) | |
7637 is 1 if a<b, 0 otherwise | |
7638 .IPs eq(a,b) | |
7639 is 1 if a==b, 0 otherwise | |
7640 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs" | |
7641 .RE | |
7642 . | |
7643 .TP | |
7644 .B vrc_override=<options> | |
7645 User specified quality for specific parts (ending, credits, ...) (pass 1/2). | |
7646 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>, | |
7647 <end-frame>, <quality>[/...]]: | |
7648 .PD 0 | |
7649 .RSs | |
7650 .IPs "quality (2\-31)" | |
7651 quantizer | |
7652 .IPs "quality (-500\-0)" | |
7653 quality correction in % | |
7654 .RE | |
7655 .PD 1 | |
7656 . | |
7657 .TP | |
7658 .B vrc_init_cplx=<0\-1000> | |
7659 initial complexity (pass 1) | |
7660 . | |
7661 .TP | |
7662 .B vrc_init_occupancy=<0.0\-1.0> | |
7663 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9) | |
7664 . | |
7665 .TP | |
7666 .B vqsquish=<0|1> | |
7667 Specify how to keep the quantizer between qmin and qmax (pass 1/2). | |
7668 .PD 0 | |
7669 .RSs | |
7670 .IPs 0 | |
7671 Use clipping. | |
7672 .IPs 1 | |
7673 Use a nice differentiable function (default). | |
7674 .RE | |
7675 .PD 1 | |
7676 . | |
7677 .TP | |
7678 .B vlelim=<-1000\-1000> | |
7679 Sets single coefficient elimination threshold for luminance. | |
7680 Negative values will also consider the DC coefficient (should be at least -4 | |
7681 or lower for encoding at quant=1): | |
7682 .PD 0 | |
7683 .RSs | |
7684 .IPs 0 | |
7685 disabled (default) | |
7686 .IPs -4 | |
7687 JVT recommendation | |
7688 .RE | |
7689 .PD 1 | |
7690 . | |
7691 .TP | |
7692 .B vcelim=<-1000\-1000> | |
7693 Sets single coefficient elimination threshold for chrominance. | |
7694 Negative values will also consider the DC coefficient (should be at least -4 | |
7695 or lower for encoding at quant=1): | |
7696 .PD 0 | |
7697 .RSs | |
7698 .IPs 0 | |
7699 disabled (default) | |
7700 .IPs 7 | |
7701 JVT recommendation | |
7702 .RE | |
7703 .PD 1 | |
7704 . | |
7705 .TP | |
7706 .B vstrict=<-2|-1|0|1> | |
7707 strict standard compliance | |
7708 .PD 0 | |
7709 .RSs | |
7710 .IPs 0 | |
7711 disabled | |
7712 .IPs 1 | |
7713 Only recommended if you want to feed the output into the | |
7714 MPEG-4 reference decoder. | |
7715 .IPs -1 | |
7716 Allow libavcodec specific extensions (default). | |
7717 .IPs -2 | |
7718 Enables experimental codecs and features which may not be playable | |
7719 with future MPlayer versions (snow, ffvhuff, ffv1). | |
7720 .RE | |
7721 .PD 1 | |
7722 . | |
7723 .TP | |
7724 .B "vdpart\ " | |
7725 Data partitioning. | |
7726 Adds 2 Bytes per video packet, improves error-resistance when transferring over | |
7727 unreliable channels (e.g.\& streaming over the internet). | |
7728 Each video packet will be encoded in 3 separate partitions: | |
7729 .PD 0 | |
7730 .RSs | |
7731 .IPs "1. MVs" | |
7732 movement | |
7733 .IPs "2. DC coefficients" | |
7734 low res picture | |
7735 .IPs "3. AC coefficients" | |
7736 details | |
7737 .RE | |
7738 .PD 1 | |
7739 .RS | |
7740 MV & DC are most important, loosing them looks far worse than loosing | |
7741 the AC and the 1. & 2. partition. | |
7742 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors | |
7743 will hit the AC partition much more often than the MV & DC partitions. | |
7744 Thus, the picture will look better with partitioning than without, | |
7745 as without partitioning an error will trash AC/\:DC/\:MV equally. | |
7746 .RE | |
7747 . | |
7748 .TP | |
7749 .B vpsize=<0\-10000> (also see vdpart) | |
7750 Video packet size, improves error-resistance. | |
7751 .PD 0 | |
7752 .RSs | |
7753 .IPs "0\ \ \ \ " | |
7754 disabled (default) | |
7755 .IPs 100\-1000 | |
7756 good choice | |
7757 .RE | |
7758 .PD 1 | |
7759 . | |
7760 .TP | |
7761 .B "ss\ \ \ \ \ " | |
7762 slice structured mode for H.263+ | |
7763 . | |
7764 .TP | |
7765 .B "gray\ \ \ " | |
7766 grayscale only encoding (faster) | |
7767 . | |
7768 .TP | |
7769 .B vfdct=<0\-10> | |
7770 DCT algorithm | |
7771 .PD 0 | |
7772 .RSs | |
7773 .IPs 0 | |
7774 Automatically select a good one (default). | |
7775 .IPs 1 | |
7776 fast integer | |
7777 .IPs 2 | |
7778 accurate integer | |
7779 .IPs 3 | |
7780 MMX | |
7781 .IPs 4 | |
7782 mlib | |
7783 .IPs 5 | |
7784 AltiVec | |
7785 .IPs 6 | |
7786 floating point AAN | |
7787 .RE | |
7788 .PD 1 | |
7789 . | |
7790 .TP | |
7791 .B idct=<0\-99> | |
7792 IDCT algorithm | |
7793 .br | |
7794 .I NOTE: | |
7795 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests. | |
7796 .PD 0 | |
7797 .RSs | |
7798 .IPs 0 | |
7799 Automatically select a good one (default). | |
7800 .IPs 1 | |
7801 JPEG reference integer | |
7802 .IPs 2 | |
7803 simple | |
7804 .IPs 3 | |
7805 simplemmx | |
7806 .IPs 4 | |
7807 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100) | |
7808 .IPs 5 | |
7809 ps2 | |
7810 .IPs 6 | |
7811 mlib | |
7812 .IPs 7 | |
7813 arm | |
7814 .IPs 8 | |
7815 AltiVec | |
7816 .IPs 9 | |
7817 sh4 | |
7818 .RE | |
7819 .PD 1 | |
7820 . | |
7821 .TP | |
7822 .B lumi_mask=<0.0\-1.0> | |
7823 Luminance masking is a 'psychosensory' setting that is supposed to | |
7824 make use of the fact that the human eye tends to notice fewer details | |
7825 in very bright parts of the picture. | |
7826 Luminance masking compresses bright areas stronger than medium ones, | |
7827 so it will save bits that can be spent again on other frames, raising | |
7828 overall subjective quality, while possibly reducing PSNR. | |
7829 .br | |
7830 .I WARNING: | |
7831 Be careful, overly large values can cause disastrous things. | |
7832 .br | |
7833 .I WARNING: | |
7834 Large values might look good on some monitors but may look horrible | |
7835 on other monitors. | |
7836 .PD 0 | |
7837 .RSs | |
7838 .IPs "0.0\ \ " | |
7839 disabled (default) | |
7840 .IPs 0.0\-0.3 | |
7841 sane range | |
7842 .RE | |
7843 .PD 1 | |
7844 . | |
7845 .TP | |
7846 .B dark_mask=<0.0\-1.0> | |
7847 Darkness masking is a 'psychosensory' setting that is supposed to | |
7848 make use of the fact that the human eye tends to notice fewer details | |
7849 in very dark parts of the picture. | |
7850 Darkness masking compresses dark areas stronger than medium ones, | |
7851 so it will save bits that can be spent again on other frames, raising | |
7852 overall subjective quality, while possibly reducing PSNR. | |
7853 .br | |
7854 .I WARNING: | |
7855 Be careful, overly large values can cause disastrous things. | |
7856 .br | |
7857 .I WARNING: | |
7858 Large values might look good on some monitors but may look horrible | |
7859 on other monitors / TV / TFT. | |
7860 .PD 0 | |
7861 .RSs | |
7862 .IPs "0.0\ \ " | |
7863 disabled (default) | |
7864 .IPs 0.0\-0.3 | |
7865 sane range | |
7866 .RE | |
7867 .PD 1 | |
7868 . | |
7869 .TP | |
7870 .B tcplx_mask=<0.0\-1.0> | |
7871 Temporal complexity masking (default: 0.0 (disabled)). | |
7872 Imagine a scene with a bird flying across the whole scene; tcplx_mask | |
7873 will raise the quantizers of the bird's macroblocks (thus decreasing their | |
7874 quality), as the human eye usually does not have time to see all the bird's | |
7875 details. | |
7876 Be warned that if the masked object stops (e.g.\& the bird lands) it is | |
7877 likely to look horrible for a short period of time, until the encoder | |
7878 figures out that the object is not moving and needs refined blocks. | |
7879 The saved bits will be spent on other parts of the video, which may increase | |
7880 subjective quality, provided that tcplx_mask is carefully chosen. | |
7881 . | |
7882 .TP | |
7883 .B scplx_mask=<0.0\-1.0> | |
7884 Spatial complexity masking. | |
7885 Larger values help against blockiness, if no deblocking filter is used for | |
7886 decoding, which is maybe not a good idea. | |
7887 .br | |
7888 Imagine a scene with grass (which usually has great spatial complexity), | |
7889 a blue sky and a house; scplx_mask will raise the quantizers of the grass' | |
7890 macroblocks, thus decreasing its quality, in order to spend more bits on | |
7891 the sky and the house. | |
7892 .br | |
7893 .I HINT: | |
7894 Crop any black borders completely as they will reduce the quality | |
7895 of the macroblocks (also applies without scplx_mask). | |
7896 .PD 0 | |
7897 .RSs | |
7898 .IPs "0.0\ \ " | |
7899 disabled (default) | |
7900 .IPs 0.0\-0.5 | |
7901 sane range | |
7902 .RE | |
7903 .PD 1 | |
7904 .sp 1 | |
7905 .RS | |
7906 .I NOTE: | |
7907 This setting does not have the same effect as using a custom matrix that | |
7908 would compress high frequencies harder, as scplx_mask will reduce the | |
7909 quality of P blocks even if only DC is changing. | |
7910 The result of scplx_mask will probably not look as good. | |
7911 .RE | |
7912 . | |
7913 .TP | |
7914 .B p_mask=<0.0\-1.0> (also see vi_qfactor) | |
7915 Reduces the quality of inter blocks. | |
7916 This is equivalent to increasing the quality of intra blocks, because the | |
7917 same average bitrate will be distributed by the rate controller to the | |
7918 whole video sequence (default: 0.0 (disabled)). | |
7919 p_mask=1.0 doubles the bits allocated to each intra block. | |
7920 . | |
7921 .TP | |
7922 .B border_mask=<0.0\-1.0> | |
7923 border-processing for MPEG-style encoders. | |
7924 Border processing increases the quantizer for macroblocks which are less | |
7925 than 1/5th of the frame width/height away from the frame border, | |
7926 since they are often visually less important. | |
7927 . | |
7928 .TP | |
7929 .B "naq\ \ \ \ " | |
7930 Normalize adaptive quantization (experimental). | |
7931 When using adaptive quantization (*_mask), the average per-MB quantizer may no | |
7932 longer match the requested frame-level quantizer. | |
7933 Naq will attempt to adjust the per-MB quantizers to maintain the proper | |
7934 average. | |
7935 . | |
7936 .TP | |
7937 .B "ildct\ \ " | |
7938 Use interlaced DCT. | |
7939 . | |
7940 .TP | |
7941 .B "ilme\ \ \ " | |
7942 Use interlaced motion estimation (mutually exclusive with qpel). | |
7943 . | |
7944 .TP | |
7945 .B "alt\ \ \ \ " | |
7946 Use alternative scantable. | |
7947 . | |
7948 .TP | |
7949 .B "top=<-1\-1>\ \ \ " | |
7950 .PD 0 | |
7951 .RSs | |
7952 .IPs -1 | |
7953 automatic | |
7954 .IPs 0 | |
7955 bottom field first | |
7956 .IPs 1 | |
7957 top field first | |
7958 .RE | |
7959 .PD 1 | |
7960 . | |
7961 .TP | |
7962 .B format=<value> | |
7963 .PD 0 | |
7964 .RSs | |
7965 .IPs "YV12\ " | |
7966 default | |
7967 .IPs "444P\ " | |
7968 for ffv1 | |
7969 .IPs "422P\ " | |
7970 for HuffYUV, lossless JPEG and ffv1 | |
7971 .IPs 411P,YVU9 | |
7972 for lossless JPEG and ffv1 | |
7973 .IPs BGR32 | |
7974 for lossless JPEG and ffv1 | |
7975 .RE | |
7976 .PD 1 | |
7977 . | |
7978 .TP | |
7979 .B "pred\ \ \ " | |
7980 (for HuffYUV) | |
7981 .PD 0 | |
7982 .RSs | |
7983 .IPs 0 | |
7984 left prediction | |
7985 .IPs 1 | |
7986 plane/\:gradient prediction | |
7987 .IPs 2 | |
7988 median prediction | |
7989 .RE | |
7990 .PD 1 | |
7991 . | |
7992 .TP | |
7993 .B "pred\ \ \ " | |
7994 (for lossless JPEG) | |
7995 .PD 0 | |
7996 .RSs | |
7997 .IPs 0 | |
7998 left prediction | |
7999 .IPs 1 | |
8000 top prediction | |
8001 .IPs 2 | |
8002 topleft prediction | |
8003 .IPs 3 | |
8004 plane/\:gradient prediction | |
8005 .IPs 6 | |
8006 mean prediction | |
8007 .RE | |
8008 .PD 1 | |
8009 . | |
8010 .TP | |
8011 .B "coder\ \ " | |
8012 (for ffv1) | |
8013 .PD 0 | |
8014 .RSs | |
8015 .IPs 0 | |
8016 vlc coding (Golomb-Rice) | |
8017 .IPs 1 | |
8018 arithmetic coding (CABAC) | |
8019 .RE | |
8020 .PD 1 | |
8021 . | |
8022 .TP | |
8023 .B context | |
8024 (for ffv1) | |
8025 .PD 0 | |
8026 .RSs | |
8027 .IPs 0 | |
8028 small context model | |
8029 .IPs 1 | |
8030 large context model | |
8031 .RE | |
8032 .PD 1 | |
8033 .sp 1 | |
8034 .RS | |
8035 (for ffvhuff) | |
8036 .RE | |
8037 .PD 0 | |
8038 .RSs | |
8039 .IPs 0 | |
8040 predetermined Huffman tables (builtin or two pass) | |
8041 .IPs 1 | |
8042 adaptive Huffman tables | |
8043 .RE | |
8044 .PD 1 | |
8045 . | |
8046 .TP | |
8047 .B "qpel\ \ \ " | |
8048 Use quarter pel motion compensation (mutually exclusive with ilme). | |
8049 .br | |
8050 .I HINT: | |
8051 This seems only useful for high bitrate encodings. | |
8052 . | |
8053 .TP | |
8054 .B mbcmp=<0\-2000> | |
8055 Sets the comparison function for the macroblock decision, only used if mbd=0. | |
8056 .PD 0 | |
8057 .RSs | |
8058 .IPs "0 (SAD)" | |
8059 sum of absolute differences, fast (default) | |
8060 .IPs "1 (SSE)" | |
8061 sum of squared errors | |
8062 .IPs "2 (SATD)" | |
8063 sum of absolute Hadamard transformed differences | |
8064 .IPs "3 (DCT)" | |
8065 sum of absolute DCT transformed differences | |
8066 .IPs "4 (PSNR)" | |
8067 sum of squared quantization errors (avoid, low quality) | |
8068 .IPs "5 (BIT)" | |
8069 number of bits needed for the block | |
8070 .IPs "6 (RD)" | |
8071 rate distortion optimal, slow | |
8072 .IPs "7 (ZERO)" | |
8073 0 | |
8074 .IPs "8 (VSAD)" | |
8075 sum of absolute vertical differences | |
8076 .IPs "9 (VSSE)" | |
8077 sum of squared vertical differences | |
8078 .IPs "10 (NSSE)" | |
8079 noise preserving sum of squared differences | |
8080 .IPs "11 (W53)" | |
8081 5/3 wavelet, only used in snow | |
8082 .IPs "12 (W97)" | |
8083 9/7 wavelet, only used in snow | |
8084 .IPs "+256\ " | |
8085 Also use chroma, currently does not work (correctly) with B-frames. | |
8086 .RE | |
8087 .PD 1 | |
8088 . | |
8089 .TP | |
8090 .B ildctcmp=<0\-2000> | |
8091 Sets the comparison function for interlaced DCT decision | |
8092 (see mbcmp for available comparison functions). | |
8093 . | |
8094 .TP | |
8095 .B precmp=<0\-2000> | |
8096 Sets the comparison function for motion estimation pre pass | |
8097 (see mbcmp for available comparison functions) (default: 0). | |
8098 . | |
8099 .TP | |
8100 .B cmp=<0\-2000> | |
8101 Sets the comparison function for full pel motion estimation | |
8102 (see mbcmp for available comparison functions) (default: 0). | |
8103 . | |
8104 .TP | |
8105 .B subcmp=<0\-2000> | |
8106 Sets the comparison function for sub pel motion estimation | |
8107 (see mbcmp for available comparison functions) (default: 0). | |
8108 . | |
8109 .TP | |
8110 .B nssew=<0\-1000000> | |
8111 This setting controls NSSE weight, where larger weights will result in | |
8112 more noise. | |
8113 0 NSSE is identical to SSE | |
8114 You may find this useful if you prefer to keep some noise in your encoded | |
8115 video rather than filtering it away before encoding (default: 8). | |
8116 . | |
8117 .TP | |
8118 .B predia=<-99\-6> | |
8119 diamond type and size for motion estimation pre-pass | |
8120 . | |
8121 .TP | |
8122 .B dia=<-99\-6> | |
8123 Diamond type & size for motion estimation. | |
8124 Motion search is an iterative process. | |
8125 Using a small diamond does not limit the search to finding only small | |
8126 motion vectors. | |
8127 It is just somewhat more likely to stop before finding the very best motion | |
8128 vector, especially when noise is involved. | |
8129 Bigger diamonds allow a wider search for the best motion vector, thus are | |
8130 slower but result in better quality. | |
8131 .br | |
8132 Big normal diamonds are better quality than shape-adaptive diamonds. | |
8133 .br | |
8134 Shape-adaptive diamonds are a good tradeoff between speed and quality. | |
8135 .br | |
8136 .I NOTE: | |
8137 The sizes of the normal diamonds and shape adaptive ones do not have | |
8138 the same meaning. | |
8139 .RSs | |
8140 .IPs -3 | |
8141 shape adaptive (fast) diamond with size 3 | |
8142 .IPs -2 | |
8143 shape adaptive (fast) diamond with size 2 | |
8144 .IPs -1 | |
8145 slightly special: Can be slower and/or better than dia=-2. | |
8146 .IPs 1 | |
8147 normal size=1 diamond (default) =EPZS type diamond | |
8148 .nf | |
8149 .ne | |
8150 0 | |
8151 000 | |
8152 0 | |
8153 .fi | |
8154 .IPs 2 | |
8155 normal size=2 diamond | |
8156 .nf | |
8157 .ne | |
8158 0 | |
8159 000 | |
8160 00000 | |
8161 000 | |
8162 0 | |
8163 .fi | |
8164 .RE | |
8165 . | |
8166 .TP | |
8167 .B "trell\ \ " | |
8168 Trellis searched quantization. | |
8169 This will find the optimal encoding for each 8x8 block. | |
8170 Trellis searched quantization is quite simply an optimal quantization in | |
8171 the PSNR versus bitrate sense (Assuming that there would be no rounding | |
8172 errors introduced by the IDCT, which is obviously not the case.). | |
8173 It simply finds a block for the minimum of error and lambda*bits. | |
8174 .PD 0 | |
8175 .RSs | |
8176 .IPs lambda | |
8177 quantization parameter (QP) dependent constant | |
8178 .IPs "bits\ " | |
8179 amount of bits needed to encode the block | |
8180 .IPs error | |
8181 sum of squared errors of the quantization | |
8182 .RE | |
8183 .PD 1 | |
8184 . | |
8185 .TP | |
8186 .B "cbp\ \ \ \ " | |
8187 Rate distorted optimal coded block pattern. | |
8188 Will select the coded block pattern which minimizes distortion + lambda*rate. | |
8189 This can only be used together with trellis quantization. | |
8190 . | |
8191 .TP | |
8192 .B "mv0\ \ \ \ " | |
8193 Try to encode each MB with MV=<0,0> and choose the better one. | |
8194 This has no effect if mbd=0. | |
8195 . | |
8196 .TP | |
8197 .B mv0_threshold=<any non-negative integer> | |
8198 When surrounding motion vectors are <0,0> and the motion estimation | |
8199 score of the current block is less than mv0_threshold, <0,0> is used for | |
8200 the motion vector and further motion estimation is skipped (default: | |
8201 256). | |
8202 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and | |
8203 possibly make the encoded video look slightly better; raising | |
8204 mv0_threshold past 320 results in diminished PSNR and visual quality. | |
8205 Higher values speed up encoding very slightly (usually less than 1%, | |
8206 depending on the other options used). | |
8207 .br | |
8208 .I NOTE: | |
8209 This option does not require mv0 to be enabled. | |
8210 . | |
8211 .TP | |
8212 .B qprd (mbd=2 only) | |
8213 rate distorted optimal quantization parameter (QP) for the given | |
8214 lambda of each macroblock | |
8215 . | |
8216 .TP | |
8217 .B last_pred=<0\-99> | |
8218 amount of motion predictors from the previous frame | |
8219 .PD 0 | |
8220 .RSs | |
8221 .IPs 0 | |
8222 (default) | |
8223 .IPs a | |
8224 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the | |
8225 previous frame. | |
8226 .RE | |
8227 .PD 1 | |
8228 . | |
8229 .TP | |
8230 .B preme=<0\-2> | |
8231 motion estimation pre-pass | |
8232 .PD 0 | |
8233 .RSs | |
8234 .IPs 0 | |
8235 disabled | |
8236 .IPs 1 | |
8237 only after I-frames (default) | |
8238 .IPs 2 | |
8239 always | |
8240 .RE | |
8241 .PD 1 | |
8242 . | |
8243 .TP | |
8244 .B subq=<1\-8> | |
8245 subpel refinement quality (for qpel) (default: 8 (high quality)) | |
8246 .br | |
8247 .I NOTE: | |
8248 This has a significant effect on speed. | |
8249 . | |
8250 .TP | |
8251 .B refs=<1\-8> | |
8252 number of reference frames to consider for motion compensation | |
8253 (Snow only) (default: 1) | |
8254 . | |
8255 .TP | |
8256 .B "psnr\ \ \ " | |
8257 print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8258 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'. | |
8259 Returned values are in dB (decibel), the higher the better. | |
8260 . | |
8261 .TP | |
8262 .B mpeg_quant | |
8263 Use MPEG quantizers instead of H.263. | |
8264 . | |
8265 .TP | |
8266 .B "aic\ \ \ \ " | |
8267 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+. | |
8268 This will improve quality very slightly (around 0.02 dB PSNR) and slow | |
8269 down encoding very slightly (about 1%). | |
8270 .br | |
8271 .I NOTE: | |
8272 vqmin should be 8 or larger for H.263+ AIC. | |
8273 . | |
8274 .TP | |
8275 .B "aiv\ \ \ \ " | |
8276 alternative inter vlc for H.263+ | |
8277 . | |
8278 .TP | |
8279 .B "umv\ \ \ \ " | |
8280 unlimited MVs (H.263+ only) | |
8281 Allows encoding of arbitrarily long MVs. | |
8282 . | |
8283 .TP | |
8284 .B ibias=<-256\-256> | |
8285 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96, | |
8286 H.263 style quantizer default: 0) | |
8287 .br | |
8288 .I NOTE: | |
8289 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8290 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8291 . | |
8292 .TP | |
8293 .B pbias=<-256\-256> | |
8294 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0, | |
8295 H.263 style quantizer default: -64) | |
8296 .br | |
8297 .I NOTE: | |
8298 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8299 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8300 .br | |
8301 .I HINT: | |
8302 A more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR. | |
8303 . | |
8304 .TP | |
8305 .B nr=<0\-100000> | |
8306 Noise reduction, 0 means disabled. | |
8307 0\-600 is a useful range for typical content, but you may want to turn it | |
8308 up a bit more for very noisy content (default: 0). | |
8309 Given its small impact on speed, you might want to prefer to use this over | |
8310 filtering noise away with video filters like denoise3d or hqdn3d. | |
8311 . | |
8312 .TP | |
8313 .B qns=<0\-3> | |
8314 Quantizer noise shaping. | |
8315 Rather than choosing quantization to most closely match the source video | |
8316 in the PSNR sense, it chooses quantization such that noise (usually ringing) | |
8317 will be masked by similar-frequency content in the image. | |
8318 Larger values are slower but may not result in better quality. | |
8319 This can and should be used together with trellis quantization, in which case | |
8320 the trellis quantization (optimal for constant weight) will be used as | |
8321 startpoint for the iterative search. | |
8322 .PD 0 | |
8323 .RSs | |
8324 .IPs 0 | |
8325 disabled (default) | |
8326 .IPs 1 | |
8327 Only lower the absolute value of coefficients. | |
8328 .IPs 2 | |
8329 Only change coefficients before the last non-zero coefficient + 1. | |
8330 .IPs 3 | |
8331 Try all. | |
8332 .RE | |
8333 .PD 1 | |
8334 . | |
8335 .TP | |
8336 .B inter_matrix=<comma separated matrix> | |
8337 Use custom inter matrix. | |
8338 It needs a comma separated string of 64 integers. | |
8339 . | |
8340 .TP | |
8341 .B intra_matrix=<comma separated matrix> | |
8342 Use custom intra matrix. | |
8343 It needs a comma separated string of 64 integers. | |
8344 . | |
8345 .TP | |
8346 .B vqmod_amp | |
8347 experimental quantizer modulation | |
8348 . | |
8349 .TP | |
8350 .B vqmod_freq | |
8351 experimental quantizer modulation | |
8352 . | |
8353 .TP | |
8354 .B "dc\ \ \ \ \ " | |
8355 intra DC precision in bits (default: 8). | |
8356 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11. | |
8357 . | |
8358 .TP | |
8359 .B cgop (also see sc_threshold) | |
8360 Close all GOPs. | |
8361 Currently it only works if scene change detection is disabled | |
8362 (sc_threshold=1000000000). | |
8363 . | |
8364 .TP | |
8365 .B vglobal=<0\-3> | |
8366 Control writing global video headers. | |
8367 .PD 0 | |
8368 .RSs | |
8369 .IPs 0 | |
8370 Codec decides where to write global headers (default). | |
8371 .IPs 1 | |
8372 Write global headers only in extradata (needed for .mp4/MOV/NUT). | |
8373 .IPs 2 | |
8374 Write global headers only in front of keyframes. | |
8375 .IPs 3 | |
8376 Combine 1 and 2. | |
8377 .RE | |
8378 .PD 1 | |
8379 . | |
8380 .TP | |
8381 .B aglobal=<0\-3> | |
8382 Same as vglobal for audio headers. | |
8383 . | |
8384 . | |
8385 .SS nuv (\-nuvopts) | |
8386 . | |
8387 Nuppel video is based on RTJPEG and LZO. | |
8388 By default frames are first encoded with RTJPEG and then compressed with LZO, | |
8389 but it is possible to disable either or both of the two passes. | |
8390 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG, | |
8391 or the default LZO compressed RTJPEG. | |
8392 .br | |
8393 .I NOTE: | |
8394 The nuvrec documentation contains some advice and examples about the | |
8395 settings to use for the most common TV encodings. | |
8396 . | |
8397 .TP | |
8398 .B c=<0\-20> | |
8399 chrominance threshold (default: 1) | |
8400 . | |
8401 .TP | |
8402 .B l=<0\-20> | |
8403 luminance threshold (default: 1) | |
8404 . | |
8405 .TP | |
8406 .B "lzo\ \ \ \ " | |
8407 Enable LZO compression (default). | |
8408 . | |
8409 .TP | |
8410 .B "nolzo\ \ " | |
8411 Disable LZO compression. | |
8412 . | |
8413 .TP | |
8414 .B q=<3\-255> | |
8415 quality level (default: 255) | |
8416 . | |
8417 .TP | |
8418 .B "raw \ \ \ " | |
8419 Disable RTJPEG encoding. | |
8420 . | |
8421 .TP | |
8422 .B "rtjpeg\ " | |
8423 Enable RTJPEG encoding (default). | |
8424 . | |
8425 . | |
8426 .SS xvidenc (\-xvidencopts) | |
8427 . | |
8428 There are three modes available: constant bitrate (CBR), fixed quantizer and | |
8429 two pass. | |
8430 . | |
8431 .TP | |
8432 .B pass=<1|2> | |
8433 Specify the pass in two pass mode. | |
8434 . | |
8435 .TP | |
8436 .B turbo (two pass only) | |
8437 Dramatically speeds up pass one using faster algorithms and disabling | |
8438 CPU-intensive options. | |
8439 This will probably reduce global PSNR a little bit and change individual | |
8440 frame type and PSNR a little bit more. | |
8441 . | |
8442 .TP | |
8443 .B bitrate=<value> (CBR or two pass mode) | |
8444 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second | |
8445 if >16000. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8446 If <value> is negative, Xvid will use its absolute value as the target size |
20707 | 8447 (in kBytes) of the video and compute the associated bitrate automagically |
8448 (default: 687 kbits/s). | |
8449 . | |
8450 .TP | |
8451 .B fixed_quant=<1\-31> | |
8452 Switch to fixed quantizer mode and specify the quantizer to be used. | |
8453 . | |
8454 .TP | |
8455 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode) | |
8456 User specified quality for specific parts (ending, credits, ...). | |
8457 Each zone is <start-frame>,<mode>,<value> where <mode> may be | |
8458 .PD 0 | |
8459 .RSs | |
8460 .IPs "q" | |
8461 Constant quantizer override, where value=<2.0\-31.0> | |
8462 represents the quantizer value. | |
8463 .IPs "w" | |
8464 Ratecontrol weight override, where value=<0.01\-2.00> | |
8465 represents the quality correction in %. | |
8466 .RE | |
8467 .PD 1 | |
8468 .sp 1 | |
8469 .RS | |
8470 .I EXAMPLE: | |
8471 .RE | |
8472 .PD 0 | |
8473 .RSs | |
8474 .IPs zones=90000,q,20 | |
8475 Encodes all frames starting with frame 90000 at constant quantizer 20. | |
8476 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20 | |
8477 Encode frames 0\-10000 at 10% bitrate, encode frames 90000 | |
8478 up to the end at constant quantizer 20. | |
8479 Note that the second zone is needed to delimit the first zone, as | |
8480 without it everything up until frame 89999 would be encoded at 10% | |
8481 bitrate. | |
8482 .RE | |
8483 .PD 1 | |
8484 . | |
8485 .TP | |
8486 .B me_quality=<0\-6> | |
8487 This option controls the motion estimation subsystem. | |
8488 The higher the value, the more precise the estimation should be (default: 6). | |
8489 The more precise the motion estimation is, the more bits can be saved. | |
8490 Precision is gained at the expense of CPU time so decrease this setting if | |
8491 you need realtime encoding. | |
8492 . | |
8493 .TP | |
8494 .B (no)qpel | |
8495 MPEG-4 uses a half pixel precision for its motion search by default. | |
8496 The standard proposes a mode where encoders are allowed to use quarter | |
8497 pixel precision. | |
8498 This option usually results in a sharper image. | |
8499 Unfortunately it has a great impact on bitrate and sometimes the | |
8500 higher bitrate use will prevent it from giving a better image | |
8501 quality at a fixed bitrate. | |
8502 It is better to test with and without this option and see whether it | |
8503 is worth activating. | |
8504 . | |
8505 .TP | |
8506 .B (no)gmc | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8507 Enable Global Motion Compensation, which makes Xvid generate special |
20707 | 8508 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images. |
8509 Whether or not the use of this option will save bits is highly | |
8510 dependent on the source material. | |
8511 . | |
8512 .TP | |
8513 .B (no)trellis | |
8514 Trellis Quantization is a kind of adaptive quantization method that | |
8515 saves bits by modifying quantized coefficients to make them more | |
8516 compressible by the entropy encoder. | |
8517 Its impact on quality is good, and if VHQ uses too much CPU for you, | |
8518 this setting can be a good alternative to save a few bits (and gain | |
8519 quality at fixed bitrate) at a lesser cost than with VHQ (default: on). | |
8520 . | |
8521 .TP | |
8522 .B (no)cartoon | |
8523 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
|
8524 It modifies some Xvid internal thresholds so Xvid takes better decisions on |
20707 | 8525 frame types and motion vectors for flat looking cartoons. |
8526 . | |
8527 .TP | |
8528 .B (no)chroma_me | |
8529 The usual motion estimation algorithm uses only the luminance information to | |
8530 find the best motion vector. | |
8531 However for some video material, using the chroma planes can help find | |
8532 better vectors. | |
8533 This setting toggles the use of chroma planes for motion estimation | |
8534 (default: on). | |
8535 . | |
8536 .TP | |
8537 .B (no)chroma_opt | |
8538 Enable a chroma optimizer prefilter. | |
8539 It will do some extra magic on color information to minimize the | |
8540 stepped-stairs effect on edges. | |
8541 It will improve quality at the cost of encoding speed. | |
8542 It reduces PSNR by nature, as the mathematical deviation to the original | |
8543 picture will get bigger, but the subjective image quality will raise. | |
8544 Since it works with color information, you might want to turn it off when | |
8545 encoding in grayscale. | |
8546 . | |
8547 .TP | |
8548 .B (no)hq_ac | |
8549 Activates high-quality prediction of AC coefficients for intra frames from | |
8550 neighbor blocks (default: on). | |
8551 . | |
8552 .TP | |
8553 .B vhq=<0\-4> | |
8554 The motion search algorithm is based on a search in the usual color domain | |
8555 and tries to find a motion vector that minimizes the difference between the | |
8556 reference frame and the encoded frame. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8557 With this setting activated, Xvid will also use the frequency domain (DCT) |
20707 | 8558 to search for a motion vector that minimizes not only the spatial |
8559 difference but also the encoding length of the block. | |
8560 Fastest to slowest: | |
8561 .PD 0 | |
8562 .RSs | |
8563 .IPs 0 | |
8564 off | |
8565 .IPs 1 | |
8566 mode decision (inter/\:intra MB) (default) | |
8567 .IPs 2 | |
8568 limited search | |
8569 .IPs 3 | |
8570 medium search | |
8571 .IPs 4 | |
8572 wide search | |
8573 .RE | |
8574 .PD 1 | |
8575 . | |
8576 .TP | |
8577 .B (no)lumi_mask | |
8578 Adaptive quantization allows the macroblock quantizers to vary inside | |
8579 each frame. | |
8580 This is a 'psychosensory' setting that is supposed to make use of the | |
8581 fact that the human eye tends to notice fewer details in very bright | |
8582 and very dark parts of the picture. | |
8583 It compresses those areas more strongly than medium ones, which will | |
8584 save bits that can be spent again on other frames, raising overall | |
8585 subjective quality and possibly reducing PSNR. | |
8586 . | |
8587 .TP | |
21021 | 8588 .B (no)grayscale |
8589 Make Xvid discard chroma planes so the encoded video is grayscale only. | |
8590 Note that this does not speed up encoding, it just prevents chroma data | |
8591 from being written in the last stage of encoding. | |
8592 . | |
8593 .TP | |
8594 .B (no)interlacing | |
8595 Encode the fields of interlaced video material. | |
8596 Turn this option on for interlaced content. | |
8597 .br | |
8598 .I NOTE: | |
8599 Should you rescale the video, you would need an interlace-aware resizer, | |
8600 which you can activate with \-vf scale=<width>:<height>:1. | |
8601 . | |
8602 .TP | |
20707 | 8603 .B min_iquant=<0\-31> |
8604 minimum I-frame quantizer (default: 2) | |
8605 . | |
8606 .TP | |
8607 .B max_iquant=<0\-31> | |
8608 maximum I-frame quantizer (default: 31) | |
8609 . | |
8610 .TP | |
8611 .B min_pquant=<0\-31> | |
8612 minimum P-frame quantizer (default: 2) | |
8613 . | |
8614 .TP | |
8615 .B max_pquant=<0\-31> | |
8616 maximum P-frame quantizer (default: 31) | |
8617 . | |
8618 .TP | |
8619 .B min_bquant=<0\-31> | |
8620 minimum B-frame quantizer (default: 2) | |
8621 . | |
8622 .TP | |
8623 .B max_bquant=<0\-31> | |
8624 maximum B-frame quantizer (default: 31) | |
8625 . | |
8626 .TP | |
21021 | 8627 .B min_key_interval=<value> (two pass only) |
8628 minimum interval between keyframes (default: 0) | |
8629 . | |
8630 .TP | |
8631 .B max_key_interval=<value> | |
8632 maximum interval between keyframes (default: 10*fps) | |
8633 . | |
8634 .TP | |
8635 .B quant_type=<h263|mpeg> | |
8636 Sets the type of quantizer to use. | |
8637 For high bitrates, you will find that MPEG quantization preserves more detail. | |
8638 For low bitrates, the smoothing of H.263 will give you less block noise. | |
8639 When using custom matrices, MPEG quantization | |
8640 .B must | |
8641 be used. | |
8642 . | |
8643 .TP | |
20707 | 8644 .B quant_intra_matrix=<filename> |
8645 Load a custom intra matrix file. | |
8646 You can build such a file with xvid4conf's matrix editor. | |
8647 . | |
8648 .TP | |
8649 .B quant_inter_matrix=<filename> | |
8650 Load a custom inter matrix file. | |
8651 You can build such a file with xvid4conf's matrix editor. | |
8652 . | |
8653 .TP | |
21021 | 8654 .B keyframe_boost=<0\-1000> (two pass mode only) |
8655 Shift some bits from the pool for other frame types to intra frames, | |
8656 thus improving keyframe quality. | |
8657 This amount is an extra percentage, so a value of 10 will give | |
8658 your keyframes 10% more bits than normal | |
8659 (default: 0). | |
8660 . | |
8661 .TP | |
8662 .B kfthreshold=<value> (two pass mode only) | |
8663 Works together with kfreduction. | |
8664 Determines the minimum distance below which you consider that | |
8665 two frames are considered consecutive and treated differently | |
8666 according to kfreduction | |
8667 (default: 10). | |
8668 . | |
8669 .TP | |
8670 .B kfreduction=<0\-100> (two pass mode only) | |
8671 The above two settings can be used to adjust the size of keyframes that | |
8672 you consider too close to the first (in a row). | |
8673 kfthreshold sets the range in which keyframes are reduced, and | |
8674 kfreduction determines the bitrate reduction they get. | |
8675 The last I-frame will get treated normally | |
8676 (default: 30). | |
8677 . | |
8678 .TP | |
8679 .B max_bframes=<0\-4> | |
8680 Maximum number of B-frames to put between I/P-frames (default: 2). | |
8681 . | |
8682 .TP | |
8683 .B bquant_ratio=<0\-1000> | |
8684 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150) | |
8685 . | |
8686 .TP | |
8687 .B bquant_offset=<-1000\-1000> | |
8688 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100) | |
8689 . | |
8690 .TP | |
8691 .B bf_threshold=<-255\-255> | |
8692 This setting allows you to specify what priority to place on the use of | |
8693 B-frames. | |
8694 The higher the value, the higher the probability of B-frames being used | |
8695 (default: 0). | |
8696 Do not forget that B-frames usually have a higher quantizer, and therefore | |
8697 aggressive production of B-frames may cause worse visual quality. | |
8698 . | |
8699 .TP | |
8700 .B (no)closed_gop | |
8701 This option tells Xvid to close every GOP (Group Of Pictures bounded | |
8702 by two I-frames), which makes GOPs independent from each other. | |
8703 This just implies that the last frame of the GOP is either a P-frame or a | |
8704 N-frame but not a B-frame. | |
8705 It is usually a good idea to turn this option on (default: on). | |
8706 . | |
8707 .TP | |
8708 .B (no)packed | |
8709 This option is meant to solve frame-order issues when encoding to | |
8710 container formats like AVI that cannot cope with out-of-order frames. | |
8711 In practice, most decoders (both software and hardware) are able to deal | |
8712 with frame-order themselves, and may get confused when this option is | |
8713 turned on, so you can safely leave if off, unless you really know what | |
8714 you are doing. | |
8715 .br | |
8716 .I WARNING: | |
8717 This will generate an illegal bitstream, and will not be | |
8718 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:Xvid. | |
8719 .br | |
8720 .I WARNING: | |
8721 This will also store a fake DivX version in the file so the bug | |
8722 autodetection of some decoders might be confused. | |
8723 . | |
8724 .TP | |
8725 .B frame_drop_ratio=<0\-100> (max_bframes=0 only) | |
8726 This setting allows the creation of variable framerate video streams. | |
8727 The value of the setting specifies a threshold under which, if the | |
8728 difference of the following frame to the previous frame is below or equal | |
8729 to this threshold, a frame gets not coded (a so called n-vop is placed | |
8730 in the stream). | |
8731 On playback, when reaching an n-vop the previous frame will be displayed. | |
8732 .br | |
8733 .I WARNING: | |
8734 Playing with this setting may result in a jerky video, so use it at your | |
8735 own risks! | |
8736 . | |
8737 .TP | |
8738 .B rc_reaction_delay_factor=<value> | |
8739 This parameter controls the number of frames the CBR rate controller | |
8740 will wait before reacting to bitrate changes and compensating for them | |
8741 to obtain a constant bitrate over an averaging range of frames. | |
8742 . | |
8743 .TP | |
8744 .B rc_averaging_period=<value> | |
8745 Real CBR is hard to achieve. | |
8746 Depending on the video material, bitrate can be variable, and hard to predict. | |
8747 Therefore Xvid uses an averaging period for which it guarantees a given | |
8748 amount of bits (minus a small variation). | |
8749 This settings expresses the "number of frames" for which Xvid averages | |
8750 bitrate and tries to achieve CBR. | |
8751 . | |
8752 .TP | |
8753 .B rc_buffer=<value> | |
8754 size of the rate control buffer | |
8755 . | |
8756 .TP | |
20707 | 8757 .B curve_compression_high=<0\-100> |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8758 This setting allows Xvid to take a certain percentage of bits away from |
20707 | 8759 high bitrate scenes and give them back to the bit reservoir. |
8760 You could also use this if you have a clip with so many bits allocated | |
8761 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad | |
8762 (default: 0). | |
8763 . | |
8764 .TP | |
8765 .B curve_compression_low=<0\-100> | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8766 This setting allows Xvid to give a certain percentage of extra bits to the |
20707 | 8767 low bitrate scenes, taking a few bits from the entire clip. |
8768 This might come in handy if you have a few low-bitrate scenes that are | |
8769 still blocky (default: 0). | |
8770 . | |
8771 .TP | |
8772 .B overflow_control_strength=<0\-100> | |
8773 During pass one of two pass encoding, a scaled bitrate curve is computed. | |
8774 The difference between that expected curve and the result obtained during | |
8775 encoding is called overflow. | |
8776 Obviously, the two pass rate controller tries to compensate for that overflow, | |
8777 distributing it over the next frames. | |
8778 This setting controls how much of the overflow is distributed every time | |
8779 there is a new frame. | |
8780 Low values allow lazy overflow control, big rate bursts are compensated for | |
8781 more slowly (could lead to lack of precision for small clips). | |
8782 Higher values will make changes in bit redistribution more abrupt, possibly | |
8783 too abrupt if you set it too high, creating artifacts (default: 5). | |
8784 .br | |
8785 .I NOTE: | |
8786 This setting impacts quality a lot, play with it carefully! | |
8787 . | |
8788 .TP | |
8789 .B max_overflow_improvement=<0\-100> | |
8790 During the frame bit allocation, overflow control may increase the frame | |
8791 size. | |
8792 This parameter specifies the maximum percentage by which the overflow | |
8793 control is allowed to increase the frame size, compared to the ideal curve | |
8794 allocation | |
8795 (default: 5). | |
8796 . | |
8797 .TP | |
8798 .B max_overflow_degradation=<0\-100> | |
8799 During the frame bit allocation, overflow control may decrease the frame | |
8800 size. | |
8801 This parameter specifies the maximum percentage by which the overflow | |
8802 control is allowed to decrease the frame size, compared to the ideal curve | |
8803 allocation | |
8804 (default: 5). | |
8805 . | |
8806 .TP | |
8807 .B container_frame_overhead=<0...> | |
8808 Specifies a frame average overhead per frame, in bytes. | |
8809 Most of the time users express their target bitrate for video w/o taking | |
8810 care of the video container overhead. | |
8811 This small but (mostly) constant overhead can cause the target file size | |
8812 to be exceeded. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8813 Xvid allows users to set the amount of overhead per frame the |
20707 | 8814 container generates (give only an average per frame). |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8815 0 has a special meaning, it lets Xvid use its own default values |
20707 | 8816 (default: 24 \- AVI average overhead). |
8817 . | |
8818 .TP | |
8819 .B profile=<profile_name> | |
8820 Restricts options and VBV (peak bitrate over a short period) according to | |
8821 the Simple, Advanced Simple and DivX profiles. | |
8822 The resulting videos should be playable on standalone players adhering to these | |
8823 profile specifications. | |
8824 .PD 0 | |
8825 .RSs | |
8826 .IPs unrestricted | |
8827 no restrictions (default) | |
8828 .IPs "sp0\ \ " | |
8829 simple profile at level 0 | |
8830 .IPs "sp1\ \ " | |
8831 simple profile at level 1 | |
8832 .IPs "sp2\ \ " | |
8833 simple profile at level 2 | |
8834 .IPs "sp3\ \ " | |
8835 simple profile at level 3 | |
8836 .IPs "asp0\ " | |
8837 advanced simple profile at level 0 | |
8838 .IPs "asp1\ " | |
8839 advanced simple profile at level 1 | |
8840 .IPs "asp2\ " | |
8841 advanced simple profile at level 2 | |
8842 .IPs "asp3\ " | |
8843 advanced simple profile at level 3 | |
8844 .IPs "asp4\ " | |
8845 advanced simple profile at level 4 | |
8846 .IPs "asp5\ " | |
8847 advanced simple profile at level 5 | |
8848 .IPs dxnhandheld | |
8849 DXN handheld profile | |
8850 .IPs dxnportntsc | |
8851 DXN portable NTSC profile | |
8852 .IPs dxnportpal | |
8853 DXN portable PAL profile | |
8854 .IPs dxnhtntsc | |
8855 DXN home theater NTSC profile | |
8856 .IPs dxnhtpal | |
8857 DXN home theater PAL profile | |
8858 .IPs dxnhdtv | |
8859 DXN HDTV profile | |
8860 .RE | |
8861 .PD 1 | |
8862 .RS | |
8863 .I NOTE: | |
8864 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
|
8865 Generally DX50 is applicable, as some players do not recognize Xvid but |
20707 | 8866 most recognize DivX. |
8867 .RE | |
8868 . | |
8869 .TP | |
8870 .B par=<mode> | |
8871 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR, | |
8872 the Display Aspect Ratio). | |
8873 PAR is the ratio of the width and height of a single pixel. | |
8874 So both are related like this: DAR = PAR * (width/height). | |
8875 .br | |
8876 MPEG-4 defines 5 pixel aspect ratios and one extended | |
8877 one, giving the opportunity to specify a specific pixel aspect | |
8878 ratio. | |
8879 5 standard modes can be specified: | |
8880 .PD 0 | |
8881 .RSs | |
8882 .IPs vga11 | |
8883 It is the usual PAR for PC content. | |
8884 Pixels are a square unit. | |
8885 .IPs pal43 | |
8886 PAL standard 4:3 PAR. | |
8887 Pixels are rectangles. | |
8888 .IPs pal169 | |
8889 same as above | |
8890 .IPs ntsc43 | |
8891 same as above | |
8892 .IPs ntsc169 | |
8893 same as above (Do not forget to give the exact ratio.) | |
8894 .IPs "ext\ \ " | |
8895 Allows you to specify your own pixel aspect ratio with par_width and | |
8896 par_height. | |
8897 .RE | |
8898 .PD 1 | |
8899 .RS | |
8900 .I NOTE: | |
8901 In general, setting aspect and autoaspect options is enough. | |
8902 .RE | |
8903 . | |
8904 .TP | |
8905 .B par_width=<1\-255> (par=ext only) | |
8906 Specifies the width of the custom pixel aspect ratio. | |
8907 . | |
8908 .TP | |
8909 .B par_height=<1\-255> (par=ext only) | |
8910 Specifies the height of the custom pixel aspect ratio. | |
8911 . | |
8912 .TP | |
8913 .B aspect=<x/y | f (float value)> | |
8914 Store movie aspect internally, just like MPEG files. | |
8915 Much nicer solution than rescaling, because quality is not decreased. | |
8916 MPlayer and a few others players will play these files correctly, others | |
8917 will display them with the wrong aspect. | |
8918 The aspect parameter can be given as a ratio or a floating point number. | |
8919 . | |
8920 .TP | |
8921 .B (no)autoaspect | |
8922 Same as the aspect option, but automatically computes aspect, taking | |
8923 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
8924 filter chain. | |
8925 . | |
8926 .TP | |
8927 .B "psnr\ \ \ " | |
8928 Print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8929 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in | |
8930 the current directory. | |
8931 Returned values are in dB (decibel), the higher the better. | |
8932 . | |
21021 | 8933 .TP |
8934 .B "debug\ \ " | |
8935 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control | |
8936 file.) | |
8937 .RE | |
8938 . | |
20707 | 8939 .PP |
8940 .sp 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8941 The following option is only available in Xvid 1.1.x. |
20707 | 8942 . |
8943 .TP | |
8944 .B bvhq=<0|1> | |
8945 This setting allows vector candidates for B-frames to be used for | |
8946 the encoding chosen using a rate distortion optimized operator, | |
8947 which is what is done for P-frames by the vhq option. | |
8948 This produces nicer-looking B-frames while incurring almost no | |
8949 performance penalty (default: 1). | |
8950 . | |
8951 .PP | |
8952 .sp 1 | |
21021 | 8953 The following option is only available in the 1.2.x version of Xvid. |
20707 | 8954 . |
8955 .TP | |
8956 .B threads=<0\-n> | |
8957 Create n threads to run the motion estimation (default: 0). | |
8958 The maximum number of threads that can be used is the picture height | |
8959 divided by 16. | |
8960 . | |
8961 . | |
8962 .SS x264enc (\-x264encopts) | |
8963 . | |
8964 .TP | |
8965 .B bitrate=<value> | |
8966 Sets the average bitrate to be used in kbits/\:second (default: off). | |
8967 Since local bitrate may vary, this average may be inaccurate for | |
8968 very short videos (see ratetol). | |
8969 Constant bitrate can be achieved by combining this with vbv_maxrate, | |
8970 at significant reduction in quality. | |
8971 . | |
8972 .TP | |
8973 .B qp=<0\-51> | |
8974 This selects the quantizer to use for P-frames. | |
8975 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively. | |
8976 20\-40 is a useful range (default: 26). | |
8977 Lower values result in better fidelity, but higher bitrates. | |
8978 0 is lossless. | |
8979 Note that quantization in H.264 works differently from MPEG-1/2/4: | |
8980 H.264's quantization parameter (QP) is on a logarithmic scale. | |
8981 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP). | |
8982 For example, MPEG at QP=2 is equivalent to H.264 at QP=18. | |
8983 . | |
8984 .TP | |
8985 .B crf=<1\-50> | |
8986 Enables constant quality mode, and selects the quality. | |
8987 The scale is similar to QP. | |
8988 Like the bitrate-based modes, this allows each frame to use a | |
8989 different QP based on the frame's complexity. | |
8990 . | |
8991 .TP | |
8992 .B pass=<1\-3> | |
8993 Enable 2 or 3-pass mode. | |
8994 It is recommended to always encode in 2 or 3-pass mode as it leads to a | |
8995 better bit distribution and improves overall quality. | |
8996 .PD 0 | |
8997 .RSs | |
8998 .IPs 1 | |
8999 first pass | |
9000 .IPs 2 | |
9001 second pass (of two pass encoding) | |
9002 .IPs 3 | |
9003 Nth pass (second and third passes of three pass encoding) | |
9004 .RE | |
9005 .RS | |
9006 Here is how it works, and how to use it: | |
9007 .br | |
9008 The first pass (pass=1) collects statistics on the video and writes them | |
9009 to a file. | |
9010 You might want to deactivate some CPU-hungry options, apart from the ones | |
9011 that are on by default. | |
9012 .br | |
9013 In two pass mode, the second pass (pass=2) reads the statistics file and | |
9014 bases ratecontrol decisions on it. | |
9015 .br | |
9016 In three pass mode, the second pass (pass=3, that is not a typo) | |
9017 does both: It first reads the statistics, then overwrites them. | |
9018 You can use all encoding options, except very CPU-hungry options. | |
9019 .br | |
9020 The third pass (pass=3) is the same as the second pass, except that it has | |
9021 the second pass' statistics to work from. | |
9022 You can use all encoding options, including CPU-hungry ones. | |
9023 .br | |
9024 The first pass may use either average bitrate or constant quantizer. | |
9025 ABR is recommended, since it does not require guessing a quantizer. | |
9026 Subsequent passes are ABR, and must specify bitrate. | |
9027 .REss | |
9028 . | |
9029 .TP | |
9030 .B turbo=<0\-2> | |
9031 Fast first pass mode. | |
9032 During the first pass of a two or more pass encode it is possible to gain | |
9033 speed by disabling some options with negligible or even no impact on the | |
9034 final pass output quality. | |
9035 .PD 0 | |
9036 .RSs | |
9037 .IPs 0 | |
9038 disabled (default) | |
9039 .IPs 1 | |
9040 Reduce subq, frameref and disable some inter-macroblock partition analysis | |
9041 modes. | |
9042 .IPs 2 | |
9043 Reduce subq and frameref to 1, use a diamond ME search and disable all | |
9044 partition analysis modes. | |
9045 .RE | |
9046 .RS | |
9047 Level 1 can increase first pass speed up to 2x with no change in the global | |
9048 PSNR of the final pass compared to a full quality first pass. | |
9049 .br | |
9050 Level 2 can increase first pass speed up to 4x with about +/- 0.05dB change | |
9051 in the global PSNR of the final pass compared to a full quality first pass. | |
9052 .REss | |
9053 . | |
9054 .TP | |
9055 .B keyint=<value> | |
9056 Sets maximum interval between IDR-frames (default: 250). | |
9057 Larger values save bits, thus improve quality, at the cost of seeking | |
9058 precision. | |
9059 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large | |
9060 values of keyint. | |
9061 . | |
9062 .TP | |
9063 .B keyint_min=<1\-keyint/2> | |
9064 Sets minimum interval between IDR-frames (default: 25). | |
9065 If scenecuts appear within this interval, they are still encoded as | |
9066 I-frames, but do not start a new GOP. | |
9067 In H.264, I-frames do not necessarily bound a closed GOP because it is | |
9068 allowable for a P-frame to be predicted from more frames than just the one | |
9069 frame before it (also see frameref). | |
9070 Therefore, I-frames are not necessarily seekable. | |
9071 IDR-frames restrict subsequent P-frames from referring to any frame | |
9072 prior to the IDR-frame. | |
9073 . | |
9074 .TP | |
9075 .B scenecut=<-1\-100> | |
9076 Controls how aggressively to insert extra I-frames (default: 40). | |
9077 With small values of scenecut, the codec often has to force an I-frame | |
9078 when it would exceed keyint. | |
9079 Good values of scenecut may find a better location for the I-frame. | |
9080 Large values use more I-frames than necessary, thus wasting bits. | |
9081 -1 disables scene-cut detection, so I-frames are inserted only once | |
9082 every other keyint frames, even if a scene-cut occurs earlier. | |
9083 This is not recommended and wastes bitrate as scenecuts encoded as P-frames | |
9084 are just as big as I-frames, but do not reset the "keyint counter". | |
9085 . | |
9086 .TP | |
9087 .B frameref=<1\-16> | |
9088 Number of previous frames used as predictors in B- and P-frames (default: 1). | |
9089 This is effective in anime, but in live-action material the improvements | |
9090 usually drop off very rapidly above 6 or so reference frames. | |
9091 This has no effect on decoding speed, but does increase the memory needed for | |
9092 decoding. | |
9093 Some decoders can only handle a maximum of 15 reference frames. | |
9094 . | |
9095 .TP | |
9096 .B bframes=<0\-16> | |
9097 maximum number of consecutive B-frames between I- and P-frames (default: 0) | |
9098 . | |
9099 .TP | |
9100 .B (no)b_adapt | |
9101 Automatically decides when to use B-frames and how many, up to the maximum | |
9102 specified above (default: on). | |
9103 If this option is disabled, then the maximum number of B-frames is used. | |
9104 . | |
9105 .TP | |
9106 .B b_bias=<-100\-100> | |
9107 Controls the decision performed by b_adapt. | |
9108 A higher b_bias produces more B-frames (default: 0). | |
9109 . | |
9110 .TP | |
9111 .B (no)b_pyramid | |
9112 Allows B-frames to be used as references for predicting other frames. | |
9113 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4. | |
9114 Without this option, B-frames follow the same pattern as MPEG-[124]. | |
9115 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames | |
9116 are predicted from I0 and P4. | |
9117 With this option, they are coded as I0 P4 B2 B1 B3. | |
9118 B2 is the same as above, but B1 is predicted from I0 and B2, and | |
9119 B3 is predicted from B2 and P4. | |
9120 This usually results in slightly improved compression, at almost no | |
9121 speed cost. | |
9122 However, this is an experimental option: it is not fully tuned and | |
9123 may not always help. | |
9124 Requires bframes >= 2. | |
9125 Disadvantage: increases decoding delay to 2 frames. | |
9126 . | |
9127 .TP | |
9128 .B (no)deblock | |
9129 Use deblocking filter (default: on). | |
9130 As it takes very little time compared to its quality gain, it is not | |
9131 recommended to disable it. | |
9132 . | |
9133 .TP | |
9134 .B deblock=<-6\-6>,<-6\-6> | |
9135 The first parameter is AlphaC0 (default: 0). | |
9136 This adjusts thresholds for the H.264 in-loop deblocking filter. | |
9137 First, this parameter adjusts the maximum amount of change that the filter is | |
9138 allowed to cause on any one pixel. | |
9139 Secondly, this parameter affects the threshold for difference across the | |
9140 edge being filtered. | |
9141 A positive value reduces blocking artifacts more, but will also smear details. | |
9142 .br | |
9143 The second parameter is Beta (default: 0). | |
9144 This affects the detail threshold. | |
9145 Very detailed blocks are not filtered, since the smoothing caused by the | |
9146 filter would be more noticeable than the original blocking. | |
9147 .br | |
9148 The default behavior of the filter almost always achieves optimal quality, | |
9149 so it is best to either leave it alone, or make only small adjustments. | |
9150 However, if your source material already has some blocking or noise which | |
9151 you would like to remove, it may be a good idea to turn it up a little bit. | |
9152 . | |
9153 .TP | |
9154 .B (no)cabac | |
9155 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on). | |
9156 Slightly slows down encoding and decoding, but should save 10-15% bitrate. | |
9157 Unless you are looking for decoding speed, you should not disable it. | |
9158 . | |
9159 .TP | |
9160 .B qp_min=<1\-51> (ABR or two pass) | |
9161 Minimum quantizer, 10\-30 seems to be a useful range (default: 10). | |
9162 . | |
9163 .TP | |
9164 .B qp_max=<1\-51> (ABR or two pass) | |
9165 maximum quantizer (default: 51) | |
9166 . | |
9167 .TP | |
9168 .B qp_step=<1\-50> (ABR or two pass) | |
9169 maximum value by which the quantizer may be incremented/decremented between | |
9170 frames (default: 4) | |
9171 . | |
9172 .TP | |
9173 .B ratetol=<0.1\-100.0> (ABR or two pass) | |
9174 allowed variance in average bitrate (no particular units) (default: 1.0) | |
9175 . | |
9176 .TP | |
9177 .B vbv_maxrate=<value> (ABR or two pass) | |
9178 maximum local bitrate, in kbits/\:second (default: disabled) | |
9179 . | |
9180 .TP | |
9181 .B vbv_bufsize=<value> (ABR or two pass) | |
9182 averaging period for vbv_maxrate, in kbits | |
9183 (default: none, must be specified if vbv_maxrate is enabled) | |
9184 . | |
9185 .TP | |
9186 .B vbv_init=<0.0\-1.0> (ABR or two pass) | |
9187 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9) | |
9188 . | |
9189 .TP | |
9190 .B ip_factor=<value> | |
9191 quantizer factor between I- and P-frames (default: 1.4) | |
9192 . | |
9193 .TP | |
9194 .B pb_factor=<value> | |
9195 quantizer factor between P- and B-frames (default: 1.3) | |
9196 . | |
9197 .TP | |
9198 .B qcomp=<0\-1> (ABR or two pass) | |
9199 quantizer compression (default: 0.6). | |
9200 A lower value makes the bitrate more constant, | |
9201 while a higher value makes the quantization parameter more constant. | |
9202 . | |
9203 .TP | |
9204 .B cplx_blur=<0\-999> (two pass only) | |
9205 Temporal blur of the estimated frame complexity, before curve compression | |
9206 (default: 20). | |
9207 Lower values allow the quantizer value to jump around more, | |
9208 higher values force it to vary more smoothly. | |
9209 cplx_blur ensures that each I-frame has quality comparable to the following | |
9210 P-frames, and ensures that alternating high and low complexity frames | |
9211 (e.g. low fps animation) do not waste bits on fluctuating quantizer. | |
9212 . | |
9213 .TP | |
9214 .B qblur=<0\-99> (two pass only) | |
9215 Temporal blur of the quantization parameter, after curve compression | |
9216 (default: 0.5). | |
9217 Lower values allow the quantizer value to jump around more, | |
9218 higher values force it to vary more smoothly. | |
9219 . | |
9220 .TP | |
9221 .B zones=<zone0>[/<zone1>[/...]] | |
9222 User specified quality for specific parts (ending, credits, ...). | |
9223 Each zone is <start-frame>,<end-frame>,<option> where option may be | |
9224 .PD 0 | |
9225 .RSs | |
9226 .IPs "q=<0\-51>" | |
9227 quantizer | |
9228 .IPs "b=<0.01\-100.0>" | |
9229 bitrate multiplier | |
9230 .RE | |
9231 .PD 1 | |
9232 .RS | |
9233 .I NOTE: | |
9234 The quantizer option is not strictly enforced. | |
9235 It affects only the planning stage of ratecontrol, and is still subject | |
9236 to overflow compensation and qp_min/qp_max. | |
9237 .RE | |
9238 . | |
9239 .TP | |
9240 .B direct_pred=<name> | |
9241 Determines the type of motion prediction used for direct macroblocks | |
9242 in B-frames. | |
9243 .PD 0 | |
9244 .RSs | |
9245 .IPs none | |
9246 Direct macroblocks are not used. | |
9247 .IPs spatial | |
9248 Motion vectors are extrapolated from neighboring blocks. | |
9249 (default) | |
9250 .IPs temporal | |
9251 Motion vectors are interpolated from the following P-frame. | |
9252 .IPs auto | |
9253 The codec selects between spatial and temporal for each frame. | |
9254 .RE | |
9255 .PD 1 | |
9256 .RS | |
9257 Spatial and temporal are approximately the same speed and PSNR, | |
9258 the choice between them depends on the video content. | |
9259 Auto is slightly better, but slower. | |
9260 Auto is most effective when combined with multipass. | |
9261 direct_pred=none is both slower and lower quality. | |
9262 .RE | |
9263 . | |
9264 .TP | |
9265 .B (no)weight_b | |
9266 Use weighted prediction in B-frames. | |
9267 Without this option, bidirectionally predicted macroblocks give | |
9268 equal weight to each reference frame. | |
9269 With this option, the weights are determined by the temporal position | |
9270 of the B-frame relative to the references. | |
9271 Requires bframes > 1. | |
9272 . | |
9273 .TP | |
9274 .B partitions=<list> | |
9275 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4). | |
9276 .PD 0 | |
9277 .RSs | |
9278 .IPs p8x8 | |
9279 Enable types p16x8, p8x16, p8x8. | |
9280 .IPs p4x4 | |
9281 Enable types p8x4, p4x8, p4x4. | |
9282 p4x4 is recommended only with subq >= 5, and only at low resolutions. | |
9283 .IPs b8x8 | |
9284 Enable types b16x8, b8x16, b8x8. | |
9285 .IPs i8x8 | |
9286 Enable type i8x8. | |
9287 i8x8 has no effect unless 8x8dct is enabled. | |
9288 .IPs i4x4 | |
9289 Enable type i4x4. | |
9290 .IPs all | |
9291 Enable all of the above types. | |
9292 .IPs none | |
9293 Disable all of the above types. | |
9294 .RE | |
9295 .PD 1 | |
9296 .RS | |
9297 Regardless of this option, macroblock types p16x16, b16x16, and i16x16 | |
9298 are always enabled. | |
9299 .br | |
9300 The idea is to find the type and size that best describe a certain area | |
9301 of the picture. | |
9302 For example, a global pan is better represented by 16x16 blocks, while | |
9303 small moving objects are better represented by smaller blocks. | |
9304 .RE | |
9305 . | |
9306 .TP | |
9307 .B (no)8x8dct | |
9308 Adaptive spatial transform size: allows macroblocks to choose between | |
9309 4x4 and 8x8 DCT. | |
9310 Also allows the i8x8 macroblock type. | |
9311 Without this option, only 4x4 DCT is used. | |
9312 . | |
9313 .TP | |
9314 .B me=<name> | |
9315 Select fullpixel motion estimation algorithm. | |
9316 .PD 0 | |
9317 .RSs | |
9318 .IPs dia | |
9319 diamond search, radius 1 (fast) | |
9320 .IPs hex | |
9321 hexagon search, radius 2 (default) | |
9322 .IPs umh | |
9323 uneven multi-hexagon search (slow) | |
9324 .IPs esa | |
9325 exhaustive search (very slow, and no better than umh) | |
9326 .RE | |
9327 .PD 1 | |
9328 . | |
9329 .TP | |
9330 .B me_range=<4\-64> | |
9331 radius of exhaustive or multi-hexagon motion search (default: 16) | |
9332 . | |
9333 .TP | |
9334 .B subq=<1\-7> | |
9335 Adjust subpel refinement quality. | |
9336 This parameter controls quality versus speed tradeoffs involved in the motion | |
9337 estimation decision process. | |
9338 subq=5 can compress up to 10% better than subq=1. | |
9339 .PD 0 | |
9340 .RSs | |
9341 .IPs 1 | |
9342 Runs fullpixel precision motion estimation on all candidate | |
9343 macroblock types. | |
9344 Then selects the best type. | |
9345 Then refines the motion of that type to fast quarterpixel precision (fastest). | |
9346 .IPs 2 | |
9347 Runs halfpixel precision motion estimation on all candidate macroblock types. | |
9348 Then selects the best type. | |
9349 Then refines the motion of that type to fast quarterpixel precision. | |
9350 .IPs 3 | |
9351 As 2, but uses a slower quarterpixel refinement. | |
9352 .IPs 4 | |
9353 Runs fast quarterpixel precision motion estimation on all candidate | |
9354 macroblock types. | |
9355 Then selects the best type. | |
9356 Then finishes the quarterpixel refinement for that type. | |
9357 .IPs 5 | |
9358 Runs best quality quarterpixel precision motion estimation on all | |
9359 candidate macroblock types, before selecting the best type (default). | |
9360 .IPs 6 | |
9361 Enables rate-distortion optimization of macroblock types in | |
9362 I- and P-frames. | |
9363 .IPs 7 | |
9364 Enables rate-distortion optimization of motion vectors and intra modes. (best) | |
9365 .RE | |
9366 .PD 1 | |
9367 .RS | |
9368 In the above, "all candidates" does not exactly mean all enabled types: | |
9369 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16. | |
9370 .RE | |
9371 . | |
9372 .TP | |
9373 .B (no)chroma_me | |
9374 Takes into account chroma information during subpixel motion search | |
9375 (default: enabled). | |
9376 Requires subq>=5. | |
9377 . | |
9378 .TP | |
9379 .B (no)mixed_refs | |
9380 Allows each 8x8 or 16x8 motion partition to independently select a | |
9381 reference frame. | |
9382 Without this option, a whole macroblock must use the same reference. | |
9383 Requires frameref>1. | |
9384 . | |
9385 .TP | |
9386 .B (no)brdo | |
9387 Enables rate-distortion optimization of macroblock types in B-frames. | |
9388 Requires subq>=6. | |
9389 . | |
9390 .TP | |
9391 .B (no)bime | |
9392 Refine the two motion vectors used in bidirectional macroblocks, | |
9393 rather than re-using vectors from the forward and backward searches. | |
9394 This option has no effect without B-frames. | |
9395 . | |
9396 .TP | |
9397 .B trellis=<0\-2> | |
9398 rate-distortion optimal quantization | |
9399 .PD 0 | |
9400 .RSs | |
9401 .IPs 0 | |
9402 disabled (default) | |
9403 .IPs 1 | |
9404 enabled only for the final encode | |
9405 .IPs 2 | |
9406 enabled during all mode decisions (slow, requires subq>=6) | |
9407 .RE | |
9408 .PD 1 | |
9409 . | |
9410 .TP | |
9411 .B deadzone_inter=<0\-32> | |
9412 Set the size of the inter luma quantization deadzone for non-trellis | |
9413 quantization (default: 21). | |
9414 . | |
9415 .TP | |
9416 .B deadzone_intra=<0\-32> | |
9417 Set the size of the intra luma quantization deadzone for non-trellis | |
9418 quantization (default: 11). | |
9419 . | |
9420 .TP | |
9421 .B (no)fast_pskip | |
9422 Performs early skip detection in P-frames (default: enabled). | |
9423 This usually improves speed at no cost, but it can sometimes produce | |
9424 artifacts in areas with no details, like sky. | |
9425 . | |
9426 .TP | |
9427 .B (no)dct_decimate | |
9428 Eliminate dct blocks in P-frames containing only a small single coefficient | |
9429 (default: enabled). | |
9430 This will remove some details, so it will save bits that can be spent | |
9431 again on other frames, hopefully raising overall subjective quality. | |
9432 If you are compressing non-anime content with a high target bitrate, you | |
9433 may want to disable this to preserve as much detail as possible. | |
9434 . | |
9435 .TP | |
9436 .B nr=<0\-100000> | |
9437 Noise reduction, 0 means disabled. | |
9438 100\-1000 is a useful range for typical content, but you may want to turn it | |
9439 up a bit more for very noisy content (default: 0). | |
9440 Given its small impact on speed, you might want to prefer to use this over | |
9441 filtering noise away with video filters like denoise3d or hqdn3d. | |
9442 . | |
9443 .TP | |
9444 .B chroma_qp_offset=<-12\-12> | |
9445 Use a different quantizer for chroma as compared to luma. | |
9446 Useful values are in the range <-2\-2> (default: 0). | |
9447 . | |
9448 .TP | |
9449 .B cqm=<flat|jvt|<filename>> | |
9450 Either uses a predefined custom quantization matrix or loads a JM format | |
9451 matrix file. | |
9452 .PD 0 | |
9453 .RSs | |
9454 .IPs "flat\ " | |
9455 Use the predefined flat 16 matrix (default). | |
9456 .IPs "jvt\ \ " | |
9457 Use the predefined JVT matrix. | |
9458 .IPs <filename> | |
9459 Use the provided JM format matrix file. | |
9460 .PD 1 | |
9461 .RE | |
9462 .RS | |
9463 .I NOTE: | |
9464 Windows CMD.EXE users may experience problems with parsing the command line | |
9465 if they attempt to use all the CQM lists. | |
9466 This is due to a command line length limitation. | |
9467 In this case it is recommended the lists be put into a JM format CQM | |
9468 file and loaded as specified above. | |
9469 .RE | |
9470 . | |
9471 .TP | |
9472 .B cqm4iy=<list> (also see cqm) | |
9473 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated | |
9474 values in the 1\-255 range. | |
9475 . | |
9476 .TP | |
9477 .B cqm4ic=<list> (also see cqm) | |
9478 Custom 4x4 intra chrominance matrix, given as a list of 16 comma | |
9479 separated values in the 1\-255 range. | |
9480 . | |
9481 .TP | |
9482 .B cqm4py=<list> (also see cqm) | |
9483 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated | |
9484 values in the 1\-255 range. | |
9485 . | |
9486 .TP | |
9487 .B cqm4pc=<list> (also see cqm) | |
9488 Custom 4x4 inter chrominance matrix, given as a list of 16 comma | |
9489 separated values in the 1\-255 range. | |
9490 . | |
9491 .TP | |
9492 .B cqm8iy=<list> (also see cqm) | |
9493 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated | |
9494 values in the 1\-255 range. | |
9495 . | |
9496 .TP | |
9497 .B cqm8py=<list> (also see cqm) | |
9498 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated | |
9499 values in the 1\-255 range. | |
9500 . | |
9501 .TP | |
9502 .B level_idc=<10\-51> | |
9503 Set the bitstream's level as defined by annex A of the H.264 standard | |
9504 (default: 51 - Level 5.1). | |
9505 This is used for telling the decoder what capabilities it needs to support. | |
9506 Use this parameter only if you know what it means, | |
9507 and you have a need to set it. | |
9508 . | |
9509 .TP | |
9510 .B threads=<1\-4> | |
9511 Split each frame into slices and encode them in parallel (default: 1). | |
9512 Also allows multithreaded decoding if the decoder supports it (lavc does not). | |
9513 This has a slight penalty to compression. | |
9514 Requires that libx264 was compiled with pthread support; if not, this | |
9515 option will produce a warning and enables slices but not multithreading. | |
9516 . | |
9517 .TP | |
9518 .B (no)global_header | |
9519 Causes SPS and PPS to appear only once, at the beginning of the bitstream | |
9520 (default: disabled). | |
9521 Some players, such as the Sony PSP, require the use of this option. | |
9522 The default behavior causes SPS and PPS to repeat prior to each IDR frame. | |
9523 . | |
9524 .TP | |
9525 .B (no)interlaced | |
9526 Treat the video content as interlaced. | |
9527 . | |
9528 .TP | |
9529 .B log=<-1\-3> | |
9530 Adjust the amount of logging info printed to the screen. | |
9531 .PD 0 | |
9532 .RSs | |
9533 .IPs "-1" | |
9534 none | |
9535 .IPs " 0" | |
9536 Print errors only. | |
9537 .IPs " 1" | |
9538 warnings | |
9539 .IPs " 2" | |
9540 PSNR and other analysis statistics when the encode finishes (default) | |
9541 .IPs " 3" | |
9542 PSNR, QP, frametype, size, and other statistics for every frame | |
9543 .RE | |
9544 .PD 1 | |
9545 . | |
9546 .TP | |
9547 .B (no)psnr | |
9548 Print signal-to-noise ratio statistics. | |
9549 .br | |
9550 .I NOTE: | |
9551 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not | |
9552 mathematically sound (they are simply the average of per-frame PSNRs). | |
9553 They are kept only for comparison to the JM reference codec. | |
9554 For all other purposes, please use either the 'Global' PSNR, or the per-frame | |
9555 PSNRs printed by log=3. | |
9556 . | |
9557 .TP | |
9558 .B (no)ssim | |
9559 Print the Structural Similarity Metric results. | |
9560 This is an alternative to PSNR, and may be better correlated with the | |
9561 perceived quality of the compressed video. | |
9562 . | |
9563 .TP | |
9564 .B (no)visualize | |
9565 Enable x264 visualizations during encoding. | |
9566 If the x264 on your system supports it, a new window will be opened during | |
9567 the encoding process, in which x264 will attempt to present an overview of | |
9568 how each frame gets encoded. | |
9569 Each block type on the visualized movie will be colored as follows: | |
9570 .PD 0 | |
9571 .RSs | |
9572 .IPs red/pink | |
9573 intra block | |
9574 .IPs "blue\ " | |
9575 inter block | |
9576 .IPs green | |
9577 skip block | |
9578 .IPs yellow | |
9579 B-block | |
9580 .RE | |
9581 .PD 1 | |
9582 .RS | |
9583 This feature can be considered experimental and subject to change. | |
9584 In particular, it depends on x264 being compiled with visualizations enabled. | |
9585 Note that as of writing this, x264 pauses after encoding and visualizing | |
9586 each frame, waiting for the user to press a key, at which point the next | |
9587 frame will be encoded. | |
9588 .RE | |
9589 . | |
9590 . | |
9591 .SS xvfw (\-xvfwopts) | |
9592 . | |
9593 Encoding with Video for Windows codecs is mostly obsolete unless you wish | |
9594 to encode to some obscure fringe codec. | |
9595 . | |
9596 .TP | |
9597 .B codec=<name> | |
9598 The name of the binary codec file with which to encode. | |
9599 . | |
9600 . | |
9601 .SS MPEG muxer (\-mpegopts) | |
9602 . | |
9603 The MPEG muxer can generate 5 types of streams, each of which has reasonable | |
9604 default parameters that the user can override. | |
9605 Generally, when generating MPEG files, it is advisable to disable | |
9606 MEncoder's frame-skip code (see \-noskip, \-mc as well as the | |
9607 harddup and softskip video filters). | |
9608 .PP | |
9609 .I EXAMPLE: | |
9610 .PD 0 | |
9611 .RSs | |
9612 .IPs format=mpeg2:tsaf:vbitrate=8000 | |
9613 .RE | |
9614 .PD 1 | |
9615 . | |
9616 .TP | |
9617 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd> | |
9618 stream format (default: mpeg2) | |
9619 . | |
9620 .TP | |
9621 .B size=<up to 65535> | |
9622 Pack size in bytes, do not change unless you know exactly what | |
9623 you are doing (default: 2048). | |
9624 . | |
9625 .TP | |
9626 .B muxrate=<int> | |
9627 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s). | |
9628 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'. | |
9629 . | |
9630 .TP | |
9631 .B "tsaf\ \ \ " | |
9632 Sets timestamps on all frames, if possible; recommended when format=dvd. | |
9633 If dvdauthor complains with a message like "..audio sector out of range...", | |
9634 you probably did not enable this option. | |
9635 . | |
9636 .TP | |
9637 .B init_vpts=<100\-700> | |
9638 initial video pts, in milliseconds (default: 200) | |
9639 . | |
9640 .TP | |
9641 .B init_apts=<100\-700> | |
9642 initial audio pts, in milliseconds (default: 200) | |
9643 . | |
9644 .TP | |
9645 .B vdelay=<1\-32760> | |
9646 Initial video delay time, in milliseconds (default: 0), | |
9647 use it if you want to delay video with respect to audio. | |
9648 . | |
9649 .TP | |
9650 .B "drop\ \ \ " | |
9651 When used with init_adelay the muxer drops the part of audio that was | |
9652 anticipated. | |
9653 . | |
9654 .TP | |
9655 .B vwidth, vheight=<1\-4095> | |
9656 Set the video width and height when video is MPEG-1/2. | |
9657 . | |
9658 .TP | |
9659 .B vpswidth, vpsheight=<1\-4095> | |
9660 Set pan and scan video width and height when video is MPEG-2. | |
9661 . | |
9662 .TP | |
9663 .B vaspect=<1 | 4/3 | 16/9 | 221/100> | |
9664 Sets the display aspect ratio for MPEG-2 video. | |
9665 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong. | |
9666 . | |
9667 .TP | |
9668 .B vbitrate=<int> | |
9669 Sets the video bitrate in kbit/s for MPEG-1/2 video. | |
9670 . | |
9671 .TP | |
9672 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 > | |
9673 Sets the framerate for MPEG-1/2 video. | |
9674 This option will be ignored if used with the telecine option. | |
9675 . | |
9676 .TP | |
9677 .B telecine | |
9678 Enables 3:2 pulldown soft telecine mode: The muxer will make the | |
9679 video stream look like it was encoded at 30000/1001 or 30 fps. | |
9680 It only works with MPEG-2 video when the output framerate, | |
9681 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9682 Any other framerate is incompatible with this option. | |
9683 . | |
9684 .TP | |
9685 .B film2pal | |
9686 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer | |
9687 will make the video stream look like it was encoded at 25 fps. | |
9688 It only works with MPEG-2 video when the output framerate, | |
9689 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9690 Any other framerate is incompatible with this option. | |
9691 . | |
9692 . | |
9693 .SS FFmpeg libavformat demuxers (\-lavfdopts) | |
9694 . | |
9695 .TP | |
9696 .B probesize=<value> | |
9697 Maximum amount of data to probe during the detection phase. | |
9698 In the case of MPEG-TS this value identifies the maximum number | |
9699 of TS packets to scan. | |
9700 . | |
9701 . | |
9702 . | |
9703 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf) | |
9704 . | |
9705 .TP | |
9706 .B delay=<value> | |
9707 Currently only meaningful for MPEG[12]: Maximum allowed distance, | |
9708 in seconds, between the reference timer of the output stream (SCR) | |
9709 and the decoding timestamp (DTS) for any stream present | |
9710 (demux to decode delay). | |
9711 Default is 0.7 (as mandated by the standards defined by MPEG). | |
9712 Higher values require larger buffers and must not be used. | |
9713 . | |
9714 .TP | |
9715 .B format=<container_format> | |
9716 Override which container format to mux into | |
9717 (default: autodetect from output file extension). | |
9718 .PD 0 | |
9719 .RSs | |
9720 .IPs "mpg\ \ " | |
9721 MPEG-1 systems and MPEG-2 PS | |
9722 .IPs "asf\ \ " | |
9723 Advanced Streaming Format | |
9724 .IPs "avi\ \ " | |
9725 Audio Video Interleave file | |
9726 .IPs "wav\ \ " | |
9727 Waveform Audio | |
9728 .IPs "swf\ \ " | |
9729 Macromedia Flash | |
9730 .IPs "flv\ \ " | |
9731 Macromedia Flash video files | |
9732 .IPs "rm\ \ \ " | |
9733 RealAudio and RealVideo | |
9734 .IPs "au\ \ \ " | |
9735 SUN AU format | |
9736 .IPs "nut\ \ " | |
9737 NUT open container format (experimental) | |
9738 .IPs "mov\ \ " | |
9739 QuickTime | |
9740 .IPs "mp4\ \ " | |
9741 MPEG-4 format | |
9742 .IPs "dv\ \ \ " | |
9743 Sony Digital Video container | |
9744 .RE | |
9745 .PD 1 | |
9746 .TP | |
9747 .B i_certify_that_my_video_stream_does_not_use_b_frames | |
9748 MEncoder cannot assign correct timestamps when there are | |
9749 B-frames in the video stream, resulting in broken encodes. | |
9750 . | |
9751 .TP | |
9752 .B muxrate=<rate> | |
9753 Минимальный битовый поток мультиплексирования, в бит/с; | |
9754 в данный момент имеет смысл только для MPEG[12]. | |
9755 Иногда уго указание необходимо для избавления от "buffer underflows". | |
9756 . | |
9757 .TP | |
9758 .B packetsize=<size> | |
9759 .\" FIXME better translation | |
9760 Размер, выраженный в байтах, атомарного[unitary] пакета для выбранного формата. | |
9761 При сжатии в MPEG[12] используются следующие значения по-умолчанию: | |
9762 2324 для [S]VCD, 2048 для всех остальных форматов. | |
9763 . | |
9764 .TP | |
9765 .B preload=<distance> | |
9766 На текущий момент имеет смысл только для MPEG[12]: Начальное разница, | |
9767 в секундах, между значением таймера потока вывода (SCR) и временной меткой | |
9768 .\" FIXME better translation | |
9769 декодирования (DTS) для любого существующего потока (задержка декодирования | |
9770 [demux to decode delay]). | |
9771 . | |
9772 . | |
9773 . | |
9774 .\" -------------------------------------------------------------------------- | |
9775 .\" переменные окружения | |
9776 .\" -------------------------------------------------------------------------- | |
9777 . | |
9778 .SH ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ | |
9779 . | |
9780 Существуют некоторые переменные окружения, которые могут использоваться для управления | |
9781 поведением MPlayer И MEncoder. | |
9782 . | |
9783 .TP | |
9784 .B MPLAYER_CHARSET (также смотрите \-msgcharset) | |
9785 Преодразовывать сообщения консоли в указанную кодировку (по-умолчанию: автоопределение). | |
9786 Значение "noconv" означает отсутствие перекодировки. | |
9787 . | |
9788 .TP | |
9789 .B MPLAYER_HOME | |
9790 Каталог, в котором MPlayer ищет настройки пользователя. | |
9791 . | |
9792 .TP | |
9793 .B MPLAYER_VERBOSE (также смотрите \-v и \-msglevel) | |
9794 Указывает начальный уровень подробности сообщений для всех | |
9795 модулей (пл-умолчанию: 0). | |
9796 Отрицательные значения приведет к меньшему количеству сообщений, положительное - | |
9797 к большему. | |
9798 . | |
9799 .SS libaf: | |
9800 . | |
9801 .TP | |
9802 .B LADSPA_PATH | |
9803 Если LADSPA_PATH установлена, производится поиск указанного файла. Если не | |
9804 установлена, вам придется указать полный путь. | |
9805 FIXME: Ою этом также упоминается в разделе ladspa. | |
9806 . | |
9807 .SS libdvdcss: | |
9808 . | |
9809 .TP | |
9810 .B DVDCSS_CACHE | |
9811 Указывает каталог, хранящий ключи роликов. | |
9812 Это ускоряет расшифровку[descrambling] DVD? находящихся в кеше. | |
9813 Каталог DVDCSS_CACHE будет создан, если не существовал, | |
9814 а ткаже подкаталог с названием DVD ролика или даты изготовления. | |
9815 Если DVDCSS_CACHE не установлена или пуста, libdvdcss будет использовать | |
9816 значение по-умолчания, равное "${HOME}/.dvdcss/" под Unix и | |
9817 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" под Win32. | |
9818 Спецальное значение "off" отключает кеширование. | |
9819 . | |
9820 .TP | |
9821 .B DVDCSS_METHOD | |
9822 Устанавливает методы аутентикации и дешифровки, которые | |
9823 libdvdcss будет использовать для чтения шифрованных[scrambled] дисков. | |
9824 Может принимать значения title, key or disc. | |
9825 .PD 0 | |
9826 .RSs | |
9827 .IPs "key\ \ " | |
9828 это метод по-умолчанию. | |
9829 libdvdcss будет использовать набор рассчитанных ключей проигрывателей, | |
9830 чтобы попробовать и получить ключ диска. | |
9831 Это модет не сработать, если устройство не распознает ни один из ключей | |
9832 проигрывателей. | |
9833 .IPs "disc\ " | |
9834 это аварийный метод, когда предыдущий не справился. | |
9835 Вместо использования ключей проигрывателей, libdvdcss взломает ключ | |
9836 диска используя грубый метод взлома. Этот процесс требователен к CPU | |
9837 и требцет 64Мб памяти для хранения временных данных. | |
9838 .IPs title | |
9839 это аварийный метод, если ни один из предыдцщих не сработал. | |
9840 Он никак не связан с обменом клчами с устройством DVD, но вместо этого | |
9841 используеткрипто атаку, для угадыванию ключа ролика. | |
9842 В исключительных случаях и он может завершиться неудачно, по причине | |
9843 нехватки шифрованных данных для осуществления статистической атаки, | |
9844 но, с другой стороны, это единственный способ расшифровать DVD, | |
9845 сохраненный на жестский диск, или с неправильным регионом на RPC2 устройстве. | |
9846 .RE | |
9847 .PD 1 | |
9848 . | |
9849 .TP | |
9850 .B DVDCSS_RAW_DEVICE | |
9851 Указывает "сырое"[raw] устройство для использования. | |
9852 Конкретное использование будет зависеть от вашей оперционной системы, | |
9853 в Linux утилитой для настройки "сырых" устройств является raw(8). | |
9854 Заметьте, что на большинстве операционных систем, использование | |
9855 "сырого" устройства требует хорошо выровненных[highly aligned] буферов: | |
9856 Linux требует выравнивания на 2048 байт (что равняется размеру сектора DVD). | |
9857 . | |
9858 .TP | |
9859 .B DVDCSS_VERBOSE | |
9860 Устанавливает уровень подробности сообщений libdvdcss. | |
9861 .PD 0 | |
9862 .RSs | |
9863 .IPs 0 | |
9864 Вообще не выводить сообщения. | |
9865 .IPs 1 | |
9866 Выводить ошибки в stderr. | |
9867 .IPs 2 | |
9868 Выводить ошибки и сообщения отладки в stderr. | |
9869 .RE | |
9870 .PD 1 | |
9871 . | |
9872 .TP | |
9873 .B DVDREAD_NOKEYS | |
9874 Пропустить получение всех ключей при запуске. | |
9875 В данный момент отключено. | |
9876 . | |
9877 .TP | |
9878 .B HOME | |
9879 FIXME: Описать это. | |
9880 . | |
9881 .SS libao2: | |
9882 . | |
9883 .TP | |
9884 .B AO_SUN_DISABLE_SAMPLE_TIMING | |
9885 FIXME: Описать это. | |
9886 . | |
9887 .TP | |
9888 .B AUDIODEV | |
9889 FIXME: Описать это. | |
9890 . | |
9891 .TP | |
9892 .B AUDIOSERVER | |
9893 Указывает Network Audio System сервер к которому драйвер вывода nat | |
9894 должен присоединиться и транспорт,кторый должен быть использован. | |
9895 Если не установлена, вместо нее используется DISPLAY. | |
9896 Транспорт может быть tcp или unix. | |
9897 Синтаксис: tcp/<некий_хост>:<некий_порт>, <некий_хост>:<номер_экземпляра> | |
9898 или [unix]:<номер_экземпляра>. | |
9899 Основной порт NAS - 8000 и <номер_экземпляра> добавляется к нему. | |
9900 .sp 1 | |
9901 .RS | |
9902 .I EXAMPLES: | |
9903 .RE | |
9904 .PD 0 | |
9905 .RSs | |
9906 .IPs AUDIOSERVER=somehost:0 | |
9907 Присоединение к NAS серверу на somehost, используя опрт и транспорт по-умолчанию. | |
9908 .IPs AUDIOSERVER=tcp/somehost:8000 | |
9909 Присоединение к NAS серверу на somehost, слушающему TCP порт 8000. | |
9910 .IPs AUDIOSERVER=(unix)?:0 | |
9911 Присоединения к NAS серверу, экземпляр 0 на localhost используя unix сокеты. | |
9912 .RE | |
9913 .PD 1 | |
9914 . | |
9915 .TP | |
9916 .B DISPLAY | |
9917 FIXME: Описать это. | |
9918 . | |
9919 .SS vidix: | |
9920 . | |
9921 .TP | |
9922 .B VIDIX_CRT | |
9923 FIXME: Описать это. | |
9924 . | |
9925 .SS osdep: | |
9926 . | |
9927 .TP | |
9928 .B TERM | |
9929 FIXME: Описать это. | |
9930 . | |
9931 .SS libvo: | |
9932 . | |
9933 .TP | |
9934 .B DISPLAY | |
9935 FIXME: Описать это. | |
9936 . | |
9937 .TP | |
9938 .B FRAMEBUFFER | |
9939 FIXME: Описать это. | |
9940 . | |
9941 .TP | |
9942 .B HOME | |
9943 FIXME: Описать это. | |
9944 . | |
9945 .SS libmpdemux: | |
9946 . | |
9947 .TP | |
9948 .B HOME | |
9949 FIXME: Описать это. | |
9950 . | |
9951 .TP | |
9952 .B HOMEPATH | |
9953 FIXME: Описать это. | |
9954 . | |
9955 .TP | |
9956 .B http_proxy | |
9957 FIXME: Описать это. | |
9958 . | |
9959 .TP | |
9960 .B LOGNAME | |
9961 FIXME: Описать это. | |
9962 . | |
9963 .TP | |
9964 .B USERPROFILE | |
9965 FIXME: Описать это. | |
9966 . | |
9967 .SS libmpcodecs: | |
9968 . | |
9969 .TP | |
9970 .B XANIM_MOD_DIR | |
9971 FIXME: Описать это. | |
9972 . | |
9973 .SS GUI: | |
9974 . | |
9975 .TP | |
9976 .B CHARSET | |
9977 FIXME: Описать это. | |
9978 . | |
9979 .TP | |
9980 .B DISPLAY | |
9981 FIXME: Описать это. | |
9982 . | |
9983 .TP | |
9984 .B HOME | |
9985 FIXME: Описать это. | |
9986 . | |
9987 .SS libavformat: | |
9988 . | |
9989 .TP | |
9990 .B AUDIO_FLIP_LEFT | |
9991 FIXME: Описать это. | |
9992 . | |
9993 .TP | |
9994 .B BKTR_DEV | |
9995 FIXME: Описать это. | |
9996 . | |
9997 .TP | |
9998 .B BKTR_FORMAT | |
9999 FIXME: Описать это. | |
10000 . | |
10001 .TP | |
10002 .B BKTR_FREQUENCY | |
10003 FIXME: Описать это. | |
10004 . | |
10005 .TP | |
10006 .B http_proxy | |
10007 FIXME: Описать это. | |
10008 . | |
10009 .TP | |
10010 .B no_proxy | |
10011 FIXME: Описать это. | |
10012 . | |
10013 . | |
10014 . | |
10015 .\" -------------------------------------------------------------------------- | |
10016 .\" Файлы | |
10017 .\" -------------------------------------------------------------------------- | |
10018 . | |
10019 .SH ФАЙЛЫ | |
10020 . | |
10021 .TP | |
10022 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf | |
10023 Общесистемные настройки MPlayer | |
10024 . | |
10025 .TP | |
10026 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf | |
10027 Общесистемные настройки MEncoder | |
10028 . | |
10029 .TP | |
10030 ~/.mplayer/\:config | |
10031 Пользовательские настройки MPlayer | |
10032 . | |
10033 .TP | |
10034 ~/.mplayer/\:mencoder.conf | |
10035 Пользовательские настройки MEncoder | |
10036 . | |
10037 .TP | |
10038 ~/.mplayer/\:input.conf | |
10039 Привязки клавиш (смотрите '\-input keylist' для полного списка) | |
10040 . | |
10041 .TP | |
10042 ~/.mplayer/\:gui.conf | |
10043 Файл настройки GUI | |
10044 . | |
10045 .TP | |
10046 ~/.mplayer/\:gui.pl | |
10047 Список воспроизведения GUI | |
10048 . | |
10049 .TP | |
10050 ~/.mplayer/\:font/ | |
10051 Каталог шрифтов (В нем должен находиться файл font.desc и файлы с расширением .RAW) | |
10052 . | |
10053 .TP | |
10054 ~/.mplayer/\:DVDkeys/ | |
10055 Кэшированные ключи CSS | |
10056 . | |
10057 .TP | |
10058 Предполагая, что проигрывается файл /path/\:to/\:movie.avi, MPlayer ищет | |
10059 файлы с субтитрами в следующем порядке: | |
10060 .RS | |
10061 /path/\:to/\:movie.sub | |
10062 .br | |
10063 ~/.mplayer/\:sub/\:movie.sub | |
10064 .RE | |
10065 .PD 1 | |
10066 . | |
10067 . | |
10068 .\" -------------------------------------------------------------------------- | |
10069 .\" Примеры | |
10070 .\" -------------------------------------------------------------------------- | |
10071 . | |
10072 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MPLAYER | |
10073 . | |
10074 .PP | |
10075 .B Быстрый старт проигрывания DVD: | |
10076 .nf | |
10077 mplayer dvd://1 | |
10078 .fi | |
10079 . | |
10080 .PP | |
10081 .B Проиграть DVD на Японском с Английскими субтитрами: | |
10082 .nf | |
10083 mplayer dvd://1 \-alang ja \-slang en | |
10084 .fi | |
10085 . | |
10086 .PP | |
10087 .B Проиграть только эпизоды 5, 6, 7: | |
10088 .nf | |
10089 mplayer dvd://1 \-chapter 5-7 | |
10090 .fi | |
10091 . | |
10092 .PP | |
10093 .B Проиграть только заголовки 5, 6, 7: | |
10094 .nf | |
10095 mplayer dvd://5-7 | |
10096 .fi | |
10097 . | |
10098 .PP | |
10099 .B Проиграть multiangle DVD: | |
10100 .nf | |
10101 mplayer dvd://1 \-dvdangle 2 | |
10102 .fi | |
10103 . | |
10104 .PP | |
10105 .B Проиграть с другого DVD устройства: | |
10106 .nf | |
10107 mplayer dvd://1 \-dvd-device /dev/\:dvd2 | |
10108 .fi | |
10109 . | |
10110 .PP | |
10111 .B Проиграть DVD видео из папки, содержащей VOB файлы: | |
10112 .nf | |
10113 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/ | |
10114 .fi | |
10115 . | |
10116 .PP | |
10117 .B Копировать DVD заголовок на жесткий диск, сохраняя в файл "title1.vob": | |
10118 .nf | |
10119 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob | |
10120 .fi | |
10121 . | |
10122 .PP | |
10123 .B Поток по HTTP: | |
10124 .nf | |
10125 mplayer http://mplayer.hq/example.avi | |
10126 .fi | |
10127 . | |
10128 .PP | |
10129 .B Поток, используя RTSP: | |
10130 .nf | |
10131 mplayer rtsp://server.example.com/streamName | |
10132 .fi | |
10133 . | |
10134 .PP | |
10135 .B Преобразовать субтитры в формат MPsub: | |
10136 .nf | |
10137 mplayer dummy.avi \-sub source.sub \-dumpmpsub | |
10138 .fi | |
10139 . | |
10140 .PP | |
10141 .B Преобразовать субтитры в формат MPsub без просмотра фильма: | |
10142 .nf | |
10143 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub | |
10144 .fi | |
10145 . | |
10146 .PP | |
10147 .B со входа стандартного V4L: | |
10148 .nf | |
10149 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv | |
10150 .fi | |
10151 . | |
10152 .PP | |
10153 .B Проигрывание на картах Zoran (старый способ, устарел): | |
10154 .nf | |
10155 mplayer \-vo zr \-vf scale=352:288 file.avi | |
10156 .fi | |
10157 . | |
10158 .PP | |
10159 .B Проигрывание на картах Zoran (новый способ): | |
10160 .nf | |
10161 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi | |
10162 .fi | |
10163 . | |
10164 .PP | |
10165 .B Проиграть 6-ти канальный AAC файл на двух колонках: | |
10166 .nf | |
10167 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 | |
10168 .fi | |
10169 .br | |
10170 .\" FIXME correct translation? | |
10171 You might want to play a bit with the pan values (e.g multiply with a value) to | |
10172 increase volume or avoid clipping. | |
10173 . | |
10174 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MENCODER | |
10175 . | |
10176 .PP | |
10177 .B Кодировать DVD заголовок #2, только указанные эпизоды: | |
10178 .nf | |
10179 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10180 .fi | |
10181 . | |
10182 .PP | |
10183 .B Кодировать DVD заголовок #2, масштабируя до 640x480: | |
10184 .nf | |
10185 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10186 .fi | |
10187 . | |
10188 .PP | |
10189 .B кодировать DVD заголовок #2, масштабируя до 512xHHH (сохраняя пропорции): | |
10190 .nf | |
10191 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10192 .fi | |
10193 . | |
10194 .PP | |
10195 .B То же, но с битрейтом установленным в 1800kbit и оптимизированными макроблоками: | |
10196 .nf | |
10197 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800 | |
10198 .fi | |
10199 . | |
10200 .PP | |
10201 .B То же, но с MJPEG сжатием: | |
10202 .nf | |
10203 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 | |
10204 .fi | |
10205 . | |
10206 .PP | |
10207 .B Кодировать все *.jpg файлы в текущем каталоге: | |
10208 .nf | |
10209 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10210 .fi | |
10211 . | |
10212 .PP | |
10213 .B Кодировать с тюнера (указывайте формат при помощи \-vf формат): | |
10214 .nf | |
10215 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw | |
10216 .fi | |
10217 . | |
10218 .PP | |
10219 .B Кодировать из канала (pipe): | |
10220 .nf | |
10221 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \- | |
10222 .fi | |
10223 . | |
10224 . | |
10225 .\" -------------------------------------------------------------------------- | |
10226 .\" Ошибки, авторы, стандартное уведомление | |
10227 .\" -------------------------------------------------------------------------- | |
10228 . | |
10229 .SH ОШИБКИ | |
10230 Не паникуйте. | |
10231 Если вы нашли их, сообщите об этом нам, но предварительно убедитесь, что прочли всю документацию. | |
10232 Также ображайте внимание на смайлики. :) | |
10233 Многие ошибки - результат некорректной настройки программы и использования параметров. | |
10234 Раздел документации, посвященный отправке сообщений об ошибках | |
10235 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:bugreports.html) | |
10236 описывает как создать полезный отчет. | |
10237 . | |
10238 . | |
10239 . | |
10240 .SH АВТОРЫ | |
10241 .\" FIXME contributor!=разработчик | |
10242 MPlayer изначально был написан Arpad Gereoffy. | |
10243 Смотрите файл AUTHORS, чтобы получить список некоторых из множества других разработчиков. | |
10244 .PP | |
10245 MPlayer is (C) 2000\-2006 The MPlayer Team | |
10246 .PP | |
10247 Оригинальная английская версия этого руководства в основном была написана Gabucino, | |
10248 Jonas Jermann и Diego Biurrun. Сейчас она поддерживается Diego Biurrun. | |
10249 Первоначальный перевод осуществлен Владимиром Ворошиловым. | |
10250 Пожалуйста, отсылайте электронные письма об оригинальной странице в список рассылки MPlayer-DOCS. | |
10251 Письма, относящиеся к переводу, отсылайте в MPlayer-translations. | |
10252 .\" end of file |