Mercurial > mplayer.hg
annotate DOCS/man/ru/mplayer.1 @ 21398:8234884ed8a7
r21410: document new meaning of dia=1 introduced by lavc r7192
r21413: mark lavc's uneven multi-hexagon search as slow, remove stray '.'
author | voroshil |
---|---|
date | Fri, 01 Dec 2006 17:30:49 +0000 |
parents | 3c20bb1ac789 |
children | 0379d13178ef |
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 | |
21398
8234884ed8a7
r21410: document new meaning of dia=1 introduced by lavc r7192
voroshil
parents:
21386
diff
changeset
|
5 .\" synced with r21413 |
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 Выключает звук. | |
21343
9efa61654dcc
r21298: "D" interactive key also works with yadif now
voroshil
parents:
21245
diff
changeset
|
244 .IPs "_ (только MPEG-TS и libavformat)" |
20970 | 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 Перейти к началу предыдущего/следующего эпизода. | |
21343
9efa61654dcc
r21298: "D" interactive key also works with yadif now
voroshil
parents:
21245
diff
changeset
|
283 .IPs "D (только \-vo xvmc, \-vf yadif)" |
21021 | 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 тайминг субтитров, как правило, будет отключен некоторыми кадрами. | |
21157 | 708 С некоторыми демультиплексорами и кодеками эта опция работает некоректно. |
20707 | 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). | |
21157 | 801 .IPs file=<имя_файла> |
20707 | 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 . | |
21157 | 958 .SH "ОПЦИИ ДЕМУЛЬТИПЛЕКСОРА/ПОТОКА" |
20707 | 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 | |
21157 | 999 .B \-audio-demuxer <[+]название> (только \-audiofile) |
1000 Принудительно устанавливает тип демультиплексора для \-audiofile. | |
20707 | 1001 Используйте '+' перед именем для принудительного выбора, это пропустит некоторые проверки! |
21157 | 1002 Передайте название демультиплексора таким, каким оно выводится опцией \-audio-demuxer help. |
1003 Для обратной совместимости эта опция также принимает ID демультиплексора, указанный в | |
20707 | 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 | |
21157 | 1150 .B \-demuxer <[+]название> |
1151 Устанавливает тип демультиплексора. | |
20707 | 1152 Используйте '+' перед названием для принудительной установки, это пропустит некоторые проверки! |
21157 | 1153 Передайте название демультиплексора как оно выводится пр помощи \-demuxer help. |
1154 Для обратной совместимости она также принимает ID демультиплексора, определенного в | |
20707 | 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 | |
21157 | 1334 Отключает выбор демультиплексора на основе расширения файла. |
1335 По-умолчанию, когда тип файла (демультиплексор) не может быть достоверно определен | |
20707 | 1336 (файл не имеет заголовка, или он недостаточно достоверен), для выбора |
21157 | 1337 демультиплексора будет использовано расширение файла. |
1338 Опция указывает всегда использовать содержимое файла для определения демультплексора. | |
20707 | 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). | |
21157 | 1401 .IPs fmt=<значение> |
20707 | 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) | |
21157 | 1447 .IPs channels=<частота>\-<название>,<частота>\-<название>,... |
20707 | 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 ширина изоражения в пикселах | |
21157 | 1513 .IPs h=<значение> |
20707 | 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 <под-опции> (КОД ОТЛАДКИ) | |
21157 | 1760 Принудительно устанавливает параметры звука для VIVO демультиплексора (для отладочных целей). |
20707 | 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 | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
1870 .B \-ffactor <число> |
20707 | 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 | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
1898 .B \-font <путь к файлу font.desc> |
20707 | 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 | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
1991 .B \-spuaa <режим> |
20707 | 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 | |
21050 | 2008 используется гауссово размытие программного модуля масштабирования (выглядит очень хорошо) |
20707 | 2009 .RE |
2010 .PD 1 | |
2011 . | |
2012 .TP | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
2013 .B \-spualign <-1\-2> |
20707 | 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 | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
2029 .B \-spugauss <0.0\-3.0> |
20707 | 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 | |
21157 | 2052 .B \-sub-demuxer <[+]название> (только \-subfile) (БЕТА КОД) |
2053 Принудительно устанвливает тип демультиплексора субтитров для \-subfile. | |
20707 | 2054 Используйте '+' перед названием для принудительного использования, это |
2055 пропустит некоторые проверки! | |
21157 | 2056 Указывайте название демультплексора таким, как оно выводится опцией \-sub-demuxer help. |
2057 Для обратной совместимости также допускается ID демультплексора, определенный в | |
20707 | 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 | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
2081 .B \-subalign <0\-2> |
20707 | 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 | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
2202 .B \-subpos <0\-100> (имеет смысл только с \-vf expand) |
20707 | 2203 Указывает позицию субтитров на экране. |
2204 Указывается вертикальная позиция субтитров в % от высоты экрана. | |
2205 . | |
2206 .TP | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
2207 .B \-subwidth <10\-100> |
20707 | 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 | |
21050 | 2892 и \-zrvdec, применяется, только если аппаратный модуль масштабирования может растянуть |
20707 | 2893 изображение до его исходного размера. |
2894 Используйте эту опцию, чтобы форсировать прореживание. | |
2895 . | |
2896 .TP | |
2897 .B \-zrhdec <1|2|4> (только \-vo zr) | |
2898 Горизонтальное прореживание: Запрашивает драйвер отправлять только | |
2899 каждый 2-ю или 4-ю строку/\:пиксел исходного изображения MJPEG карте и | |
21050 | 2900 использовать модуль масштабирования MJPEG карты для растягивания изображения до |
20707 | 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 карте и | |
21050 | 2922 использовать модуль масштабирования MJPEG карты для растягивания изображения до |
20707 | 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 | |
21157 | 2966 .B xv (только X11) |
20832 | 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 Указывает использовать аппаратно ускоренное масштабирование (по-умолчанию: hwaccel). |
20707 | 3072 .RE |
3073 .PD 1 | |
3074 . | |
3075 .TP | |
3076 .B "vidix\ \ " | |
20832 | 3077 VIDIX (VIDeo Interface for *niX, видео интерфейс для *nix) - это интерфейс |
3078 к возможностям ускорения видео различных графических карт. | |
3079 Очень быстрый драйвер вывода видео для карт, его поддерживающих. | |
3080 .PD 0 | |
3081 .RSs | |
3082 .IPs <подустройство> | |
3083 .\" FIXME "подустройства" | |
3084 Явно выбирает используемый драйвер подустройства VIDIX. | |
3085 Доступные драйверы подустройств: cyberblade_vid.so, mach64_vid.so, | |
20707 | 3086 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so, |
20832 | 3087 radeon_vid.so, rage128_vid.so, sis_vid.so и unichrome_vid.so. |
3088 .RE | |
3089 .PD 1 | |
3090 . | |
3091 .TP | |
21157 | 3092 .B xvidix (только X11) |
20832 | 3093 X11 фронтенд для VIDIX |
3094 .PD 0 | |
3095 .RSs | |
3096 .IPs <подустройство> | |
3097 То же, что и для vidix | |
20707 | 3098 .RE |
3099 .PD 1 | |
3100 . | |
3101 .TP | |
3102 .B "cvidix\ " | |
20832 | 3103 Универсальный и платформенно-независимый VIDIX фронтенд, с картами nVidia может работать |
3104 даже в текстовой консоли. | |
3105 .PD 0 | |
3106 .RSs | |
3107 .IPs <подустройство> | |
3108 То же, что и для vidix | |
3109 .RE | |
3110 .PD 1 | |
3111 . | |
3112 .TP | |
3113 .B winvidix (только Windows) | |
3114 Windows фронтенд для VIDIX | |
3115 .PD 0 | |
3116 .RSs | |
3117 .IPs <подустройство> | |
3118 То же, что и для vidix | |
20707 | 3119 .RE |
3120 .PD 1 | |
3121 . | |
3122 .TP | |
21157 | 3123 .B directx (только Windows) |
20832 | 3124 Драйвер вывода видео, использующий DirectX интерфейс. |
20707 | 3125 .PD 0 |
3126 .RSs | |
3127 .IPs noaccel | |
20832 | 3128 Отключает аппаратное ускорение. |
3129 Попробуйте эту опцию, если у вас проблемы с отображением. | |
3130 .RE | |
3131 .PD 1 | |
3132 . | |
3133 .TP | |
3134 .B quartz (только Mac OS X) | |
3135 Драйвер вывода видео Mac OS X Quartz. | |
3136 В некоторых случаях, форсирование пакованного выходного формата YUV с, | |
3137 например, \-vf format=yuy2, может быть более эффективным. | |
3138 .PD 0 | |
3139 .RSs | |
3140 .IPs device_id=<число> | |
3141 Выбирает устройство отображения для использования в полноэкранном режиме. | |
3142 .IPs fs_res=<ширина>:<высота> | |
3143 Указывает полноэкранное разрешение (полезно на медленных системах). | |
3144 .RE | |
3145 .PD 1 | |
3146 . | |
3147 .TP | |
3148 .B macosx (Mac OS X 10.4 или 10.3.9 с QuickTime 7) | |
3149 Драйвер вывода видео Mac OS X CoreVideo. | |
3150 .PD 0 | |
3151 .RSs | |
3152 .IPs device_id=<число> | |
3153 Выбирает устройство отображения для использования в полноэкранном режиме. | |
3154 .RE | |
3155 .PD 1 | |
3156 . | |
3157 .TP | |
3158 .B fbdev (только Linux) | |
3159 Использует фреймбуфер ядра для воспроизведения видео. | |
3160 .PD 0 | |
3161 .RSs | |
3162 .IPs <устройство> | |
3163 Явно указывает имя используемого fbdev устройства (например /dev/\:fb0) или | |
3164 имя подустройства VIDIX, если имя устройства начинается с 'vidix' | |
3165 (например 'vidixsis_vid для драйвера sis). | |
3166 .RE | |
3167 .PD 1 | |
3168 . | |
3169 .TP | |
3170 .B fbdev2 (только Linux) | |
3171 Использует фреймбуфер ядра для воспроизведения видео, альтернативная | |
3172 реализация. | |
3173 .PD 0 | |
3174 .RSs | |
3175 .IPs <устройство> | |
3176 Явно указывает имя используемого fbdev устройства (по-умолчанию: /dev/\:fb0). | |
20707 | 3177 .RE |
3178 .PD 1 | |
3179 . | |
3180 .TP | |
3181 .B "vesa\ \ \ " | |
20832 | 3182 Весьма универсальный драйвер, который должен работать на любой VESA VBE 2.0 |
3183 совместимой карте. | |
20707 | 3184 .PD 0 |
3185 .RSs | |
3186 .IPs "dga\ \ " | |
20832 | 3187 Включает режим DGA. |
20707 | 3188 .IPs nodga |
20832 | 3189 Выключает режим DGA. |
20707 | 3190 .IPs neotv_pal |
20832 | 3191 Активирует NeoMagic TV выход и устанавливает стандарт в PAL. |
20707 | 3192 .IPs neotv_ntsc |
20832 | 3193 Активирует NeoMagic TV выход и устанавливает стандарт в NTSC. |
20707 | 3194 .IPs vidix |
20832 | 3195 Указывает использовать VIDIX драйвер. |
20707 | 3196 .IPs "lvo:\ \ \ " |
20832 | 3197 Активирует видео оверлей Linux поверх VESA режима. |
20707 | 3198 .RE |
3199 .PD 1 | |
3200 . | |
3201 .TP | |
3202 .B "svga\ \ \ " | |
20832 | 3203 Воспроизводит видео, используя библиотеку SVGA. |
3204 .PD 0 | |
3205 .RSs | |
3206 .IPs "<видео режим>" | |
3207 Указывает используемый видео режим. | |
3208 Режим может быть задан в форме <ширина>x<высота>x<цветов>, | |
3209 например 640x480x16M или номером графического режима, например 84. | |
20707 | 3210 .IPs bbosd |
20832 | 3211 Выводит OSD на черных полях под изображением (медленнее). |
20707 | 3212 .IPs native |
20832 | 3213 Указывает использовать только 'нативные' функции. |
3214 Это отключает прямой рендеринг, OSD и аппаратное ускорение. | |
20707 | 3215 .IPs retrace |
20832 | 3216 .\" FIXME как коротко перевести vertical retrace? Существующий перевод |
3217 .\" не совсем верный (и звучит ужасно). | |
3218 Форсирует переключение кадров между циклами | |
3219 вертикальной развертки. | |
3220 Может использоваться только с \-double. | |
3221 Имеет тот же эффект, что и опция \-vsync. | |
20707 | 3222 .IPs "sq\ \ \ " |
20832 | 3223 Пытается выбрать видео режим с квадратными пикселами. |
20707 | 3224 .IPs vidix |
20832 | 3225 Указывает использовать svga с VIDIX. |
20707 | 3226 .RE |
3227 .PD 1 | |
3228 . | |
3229 .TP | |
3230 .B "gl\ \ \ \ \ " | |
20832 | 3231 OpenGL драйвер вывода видео, простая версия. |
3232 Размер видео должен быть меньше максимального размера | |
3233 текстуры в вашей реализации OpenGL. | |
3234 Предполагается, что будет работать даже с самыми простыми | |
3235 реализациями OpenGL, но также может использовать новые | |
3236 расширения, позволяющие поддерживать большее количество | |
3237 цветовых пространств и прямой рендеринг. | |
3238 Пожалуйста, используйте \-dr, если это работает с вашей | |
3239 реализацией OpenGL, поскольку для больших разрешений | |
3240 это | |
3241 .B значительно | |
3242 увеличивает скорость. | |
3243 Код выполняет очень малое количество проверок, так что, если что-то не | |
3244 работает, это может быть вызвано отсутствием поддержки в вашей | |
3245 карте/OpenGL реализации, даже если вы не получаете никаких сообщений об | |
3246 ошибках. Используйте glxinfo или аналогичный инструмент, чтобы увидеть | |
3247 поддерживаемые расширения OpenGL. | |
20707 | 3248 .PD 0 |
3249 .RSs | |
3250 .IPs (no)manyfmts | |
20832 | 3251 Включает поддержку большего количества форматов цветов (RGB и BGR) (по-умолчанию: включено). |
3252 Требует OpenGL версии >= 1.2. | |
20707 | 3253 .IPs slice-height=<0\-...> |
20832 | 3254 Количество строк, копируемых в текстуру одним целым (по-умолчанию: 4). |
3255 0 для всего изображения. | |
3256 .br | |
3257 .I ЗАМЕЧАНИЕ: | |
3258 Если используется пространство цветов YUV (смотрите подопцию yuv), применяются | |
3259 особые правила: | |
20707 | 3260 .RSss |
20832 | 3261 Если декодер использует рендеринг по слоям (смотрите \-noslices), эта опция не |
3262 имеет эффекта, размеры слоев указываются используемым декодером. | |
3263 .br | |
3264 Если декодер не использует рендеринг по слоям, то значением по-умолчанию | |
3265 является 16. | |
20707 | 3266 .RE |
3267 .IPs (no)osd | |
20832 | 3268 Включает или выключает поддержку рендеринга OSD при помощи OpenGL |
3269 (по-умолчанию: включено). Эта опция используется для тестирования; | |
3270 для отключения OSD используйте вместо нее \-osdlevel 0. | |
20707 | 3271 .IPs (no)scaled-osd |
20832 | 3272 Изменяет реакцию OSD на изменение размера окна (по-умолчанию: отключено). |
3273 .\" FIXME is translation correct ? | |
3274 .\" When enabled behaves more like the other video output drivers, | |
3275 .\" which is better for fixed-size fonts. | |
3276 .\" Disabled looks much better with FreeType fonts and uses the | |
3277 .\" borders in fullscreen mode. | |
3278 Когда включено, поведение такое же как и с остальными драйверами вывода | |
3279 видео, что лучше для шрифтов фиксированного размера. | |
3280 Когда отключено, то выглядит намного лучше со шрифтами TrueType и | |
3281 использует границы в полноэкранном режиме. | |
3282 С ass субтитрами (смотрите \-ass) работает некорректно. | |
20707 | 3283 .IPs osdcolor=<0xRRGGBB> |
20832 | 3284 Цвет для OSD (по-умолчанию: 0xffffff, соответствует белому цвету). |
20707 | 3285 .IPs (no)aspect |
20832 | 3286 Включает или выключает масштабирование с сохранением пропорций и поддержку |
3287 pan-and-scan (по-умолчанию: включено). | |
3288 Отключение может немного увеличить скорость. | |
20707 | 3289 .IPs rectangle=<0,1,2> |
20832 | 3290 Выбирает использование прямоугольныйх текстур, что экономит видеопамять, но |
3291 зачастую работает медленнее (по-умолчанию: 0). | |
20707 | 3292 .RSss |
20832 | 3293 0: Указывает использовать текстуры power-of-two (по-умолчанию). |
3294 .br | |
3295 1: Указывает использовать расширение GL_ARB_texture_rectangle. | |
3296 .br | |
3297 2: Указывает использовать расширение GL_ARB_texture_non_power_of_two. | |
3298 В некоторых случаях поддерживается только программно и, поэтому, очень медленно. | |
20707 | 3299 .RE |
3300 .IPs (no)glfinish | |
20832 | 3301 Вызывает glFinish() перед сменой буферов. |
3302 Медленнее, но в некоторых случаях дает более правильный результат (по-умолчанию: отключено). | |
20707 | 3303 .IPs swapinterval=<n> |
20832 | 3304 Минимальный интервал между сменами буферов, посчитанный в отображаемых |
3305 кадрах (по-умолчанию: 1). | |
3306 1 эквивалентно включению VSYNC, 0 - отключению VSYNC. | |
3307 Значения меньше 0 оставят его равным системному значению по-умолчанию. | |
3308 Это ограничивает частоту кадров значением (частота горизонтальной развертки / n). | |
3309 Для работы требуется поддержка GLX_SGI_swap_control. | |
3310 С некоторыми (многими/всеми?) реализациями работает только в полноэкранном режиме. | |
20707 | 3311 .IPs yuv=<n> |
20832 | 3312 Указывает тип преобразования YUV в RGB. |
20707 | 3313 .RSss |
20832 | 3314 0: Используется программное преобразование (по-умолчанию). |
3315 Совместимо со всеми версиями OpenGL. | |
3316 Предоставляет возможность управления яркостью, контрастностью и насыщенностью. | |
3317 .br | |
3318 .\" FIXME register combiners - блоки объединения регистров | |
3319 1: Используются блоки объединения регистров | |
3320 Используется nVidia-специфичное расширение (GL_NV_register_combiners). | |
3321 Требуются, как минимум, три текстуры. | |
3322 Предоставляет возможность управления насыщенностью и цветностью. | |
3323 Это быстрый, но не точный метод. | |
3324 .br | |
3325 .\" FIXME fragment program - программа фрагментации | |
3326 2: Используется программа фрагментации. | |
3327 Требуется расширение GL_ARB_fragment_program и, как минимум, три текстуры. | |
3328 Предоставляет возможность управления яркостью, контрастностью, | |
3329 насыщенностью и цветностью. | |
3330 .br | |
3331 .\" FIXME fragment program - программа фрагментации | |
3332 3: Используется программа фрагментации, используя POW инструкции. | |
3333 Требуется расширение GL_ARB_fragment_program и, как минимум, три текстуры. | |
3334 Предоставляет возможность управления яркостью, контрастностью, | |
3335 насыщенностью, цветностью и гаммой. | |
3336 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3337 Метод 4, как правило, быстрее. | |
3338 .br | |
3339 .\" FIXME fragment program - программа фрагментации | |
3340 4: Используется программа фрагментации с дополнительный поиском. | |
3341 Требуется расширение GL_ARB_fragment_program и, как минимум, | |
3342 четыре текстуры. | |
3343 Предоставляет возможность управления яркостью, контрастностью, насыщенностью, | |
3344 цветностью, и гаммой. | |
3345 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3346 .br | |
3347 5: Используется ATI-специфичный метод (для старых карт). | |
3348 при этом используется ATI-специфичное расширение | |
3349 (GL_ATI_fragment_shader - не GL_ARB_fragment_shader!). | |
3350 Необходимы, как минимум, три текстуры. | |
3351 Предоставляет возможность управления насыщенностью и цветностью. | |
3352 Это быстрый, но не точный метод. | |
3353 .br | |
3354 6: Используется 3D текстура для преобразования через поиск. | |
3355 Требуется расширение GL_ARB_fragment_program и, как минимум, четыре тестуры. | |
3356 Ужасно медленный (программная эмуляция) на некоторых (всех?) картах ATI, | |
3357 поскольку использует текстуру с пограничными пикселами. | |
3358 Предоставляет возможность управления яркостью, контрастностью, насыщенностью, | |
3359 цветностью, и гаммой. | |
3360 Гамма может быть независимо установлена для красного, зеленого и синего цветов. | |
3361 Скорость зависит от пропускной способности памяти GPU значительно сильнее, чем | |
3362 в остальных методах. | |
20707 | 3363 .RE |
3364 .IPs lscale=<n> | |
20832 | 3365 Выбирает функцию для масштабирования яркостность составляющей. |
3366 Допустимо только для 2, 3, 4 и 6 режимов yuv. | |
20707 | 3367 .RSss |
20832 | 3368 0: Используется простая линейная фильтрация (по-умолчанию). |
3369 .br | |
3370 1: Используется бикубическая фильтрация (повышенное качество). | |
3371 Требует одну дополнительную текстуру. | |
3372 Старые карты не смогут обработать с ее помощью цветовую составляющую, как минимум, | |
3373 в полноэкранном режиме. | |
20707 | 3374 .RE |
3375 .IPs cscale=<n> | |
20832 | 3376 Выбирает функцию для масштабирования цветовой составляющей. |
3377 Подробности смотрите в lscale. | |
3378 .IPs customprog=<файл> | |
3379 .\" FIXME fragment program - программа фрагментации | |
3380 Загружает нестандартную программу фрагментации из файла <файл>. | |
3381 пример смотрите в TOOLS/edgedect.fp. | |
3382 .IPs customtex=<файл> | |
3383 Загружает нестандартную "gamma ramp" текстуру из файла <файл>. | |
3384 Может использоваться совместно с yuv=4 или с опцией customprog. | |
20707 | 3385 .IPs (no)customtlin |
20832 | 3386 Если включено (по-умолчанию), для customtex текстуры используется GL_LINEAR |
3387 интерполяция, иначе - GL_NEAREST. | |
20707 | 3388 .IPs (no)customtrect |
20832 | 3389 Если включено, используется texture_rectangle для customtex текстуры. |
3390 По-умолчанию отключено. | |
20707 | 3391 .REss |
3392 .RE | |
3393 .PD 1 | |
3394 . | |
3395 .TP | |
3396 .B "gl2\ \ \ \ " | |
20832 | 3397 OpenGL драйвер вывода, второе поколение. |
3398 Поддерживает OSD и видео с размером больше допустимого для текстуры. | |
20707 | 3399 .PD 0 |
3400 .RSs | |
3401 .IPs (no)glfinish | |
20832 | 3402 То же, что и для gl (по-умолчанию: включено) |
20707 | 3403 .IPs yuv=<n> |
20832 | 3404 Указывает тип преобразования YUV в RGB. |
3405 Если установлено во что-либо, отличное от 0, то OSD выводиться не будет и | |
3406 регулировки яркости, контрастности и гаммы будут доступны только через | |
3407 глобальные настройки X сервера. | |
3408 В остальном значения те же, что и для \-vo gl. | |
20707 | 3409 .REss |
3410 . | |
3411 .TP | |
3412 .B "null\ \ \ " | |
20832 | 3413 Вы выводит никакого видео, |
3414 полезен для тестов производительности. | |
20707 | 3415 . |
3416 .TP | |
3417 .B "aa\ \ \ \ \ " | |
20832 | 3418 Драйвер вывода ASCII art, работающий в текстовой консоли. |
3419 Вы можете получить список и описание доступных подопций запустив | |
20707 | 3420 .I mplayer \-vo aa:help |
3421 . | |
3422 .TP | |
3423 .B "caca\ \ \ " | |
20832 | 3424 Драйвер вывода видео Color ASCII art, выботающий в текстовой консоли. |
20707 | 3425 . |
3426 .TP | |
3427 .B "bl\ \ \ \ \ " | |
20832 | 3428 Воспроизведение видео с использованием Blinkenlights UDP протокола. |
3429 Драйвер очень сильно аппаратно зависим. | |
3430 .PD 0 | |
3431 .RSs | |
3432 .IPs <подустройство> | |
3433 Явно указывает драйвер используемого подустройства Blinkenlights. | |
3434 Он выглядит как arcade:host=localhost:2323 или | |
20707 | 3435 hdl:file=name1,file=name2. |
20832 | 3436 Вы обязательно должны указать подустройство. |
20707 | 3437 .RE |
3438 .PD 1 | |
3439 . | |
3440 .TP | |
3441 .B "ggi\ \ \ \ " | |
20832 | 3442 Драйвер вывода видео графической системы GGI |
3443 .PD 0 | |
3444 .RSs | |
3445 .IPs <драйвер> | |
3446 Явно указывает используемый GGI драйвер. | |
3447 Замените любые ',', которые могут появиться в строке драйвера, на '.'. | |
20707 | 3448 .RE |
3449 .PD 1 | |
3450 . | |
3451 .TP | |
3452 .B directfb | |
20832 | 3453 Воспроизводит видео, используя библиотеку DirectFB. |
20707 | 3454 .PD 0 |
3455 .RSs | |
3456 .IPs (no)input | |
20832 | 3457 Указывает использовать коды клавиш DirectFB вместо кодов MPlayer (по-умолчанию: включено). |
20707 | 3458 .IPs buffermode=single|double|triple |
20832 | 3459 Двойная и тройная буферизация дает лучшие результаты, если вы хотите |
3460 .\" FIXME tearing - мерцание | |
3461 избежать мерцания. Тройная буферизация эффективнее двойной, поскольку | |
3462 .\" FIXME: vertical retrace | |
3463 она не блокирует MPlayer во время ожидания цикла обновления экрана монитора. | |
3464 Одиночной буферизации стоит избегать (по-умолчанию: single). | |
20707 | 3465 .IPs fieldparity=top|bottom |
20832 | 3466 Управляет порядком вывода чередующихся полей (по-умолчанию: отключено). |
3467 Допустимые значения: top = верхнее поле первое, bottom = нижнее поле первое. | |
3468 Это опция никак не влияет на прогрессивное видео, каковым являются большинство | |
3469 .\" FIXME tearing - мерцание | |
3470 MPEG фильмов, потребуется ее установить, если во время просмотра черезстрочного | |
3471 материала появляется мерцание или эффект гребенки при движении. | |
20707 | 3472 .IPs layer=N |
20832 | 3473 Форсирует для отображения слой с ID N (по-умолчанию: -1 - авто). |
3474 .IPs dfbopts=<список> | |
3475 Указывает список параметров для DirectFB. | |
20707 | 3476 .RE |
3477 .PD 1 | |
3478 . | |
3479 .TP | |
3480 .B "dfbmga\ " | |
20832 | 3481 Драйвер вывода видео для Matrox G400/\:G450/\:G550, использующий |
3482 библиотеку DirectFB для задействования особых возможностей оборудования. | |
3483 Задействует CRTC2 (вторую "голову"), отображая видео независимо от первой "головы". | |
20707 | 3484 .PD 0 |
3485 .RSs | |
3486 .IPs (no)input | |
20832 | 3487 То же, что и для directfb (по-умолчанию: отключено) |
20707 | 3488 .IPs buffermode=single|double|triple |
20832 | 3489 То же, что и для directfb (по-умолчанию: triple) |
20707 | 3490 .IPs fieldparity=top|bottom |
20832 | 3491 То же, что и для directfb |
20707 | 3492 .IPs (no)bes |
20832 | 3493 Задействует использование Matrox BES (модуля масштабирования) (по-умолчанию: отключено). |
3494 Дает отличный результат по скорости и качеству изображения, поскольку | |
3495 интерполяция производится аппаратно. Работает только на главной "голове". | |
20707 | 3496 .IPs (no)spic |
20832 | 3497 .\" FIXME correct translation of sub picture layer |
3498 Задействует использование специального слоя [sub picture layer] для отображения | |
3499 OSD (по-умолчанию: отключено). | |
20707 | 3500 .IPs (no)crtc2 |
20832 | 3501 Включает TV-выход на второй "голове" (по-умолчанию: включено). |
3502 Качество вывода удивительное, т.к. это полностью черезстрочное | |
3503 изображение с правильной синхронизацией каждого четнымого/\:нечетного поля. | |
20707 | 3504 .IPs tvnorm=pal|ntsc|auto |
20832 | 3505 Установит TV стандарт Matrox карты без необходимости |
3506 изменения /etc/\:directfbrc (по-умолчанию: отключено). | |
3507 Допустимые стандарты: pal = PAL, ntsc = NTSC. | |
3508 auto - особый стандарт (автоопределение использования PAL/\:NTSC), потому что | |
3509 он определяет используемый стандарт по частоте кадров фильма. | |
3510 .RE | |
3511 .PD 1 | |
3512 . | |
3513 .TP | |
3514 .B mga (только Linux) | |
3515 Драйвер вывода видео для Matrox, использующий модуль YUV масштабирования | |
3516 на Gxxx картах через драйвер ядра. | |
3517 Если у вас карта Matrox, то это самый быстрый вариант. | |
3518 .PD 0 | |
3519 .RSs | |
3520 .IPs <устройство> | |
3521 Явно указывает имя используемого Matrox устройства (по-цмолчанию: /dev/\:mga_vid). | |
3522 .RE | |
3523 .PD 1 | |
3524 . | |
3525 .TP | |
3526 .B xmga (только Linux, X11) | |
3527 Драйвер вывода видео mga, работающий в окне X11. | |
3528 .PD 0 | |
3529 .RSs | |
3530 .IPs <устройство> | |
3531 Явно указывает имя используемого Matrox устройства (по-цмолчанию: /dev/\:mga_vid). | |
20707 | 3532 .RE |
3533 .PD 1 | |
3534 . | |
3535 .TP | |
3536 .B "syncfb\ " | |
20832 | 3537 Драйвер вывода видео для SyncFB модуля ядра, предоставляющего |
3538 особые возможности Matrox Gxxx Карт, такие как аппаратные деинтерлейс, | |
3539 масштабирование и синхронизация видео с частотой вертикальной развертки | |
3540 вашего монитора. | |
3541 . | |
3542 .TP | |
3543 .B 3dfx (только Linux) | |
3544 Драйвер вывода для 3dfx. | |
3545 Этот драйвер работает напрямую c 3dfx оборудованием поверх X11. | |
3546 Поддерживается только 16 bpp. | |
3547 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
20707 | 3548 . |
3549 .TP | |
21157 | 3550 .B tdfxfb (только Linux) |
20832 | 3551 Этот драйвер работает с tdfx драйвером фреймбуфера для воспроизведения |
3552 фильмов с YUV ускорением на 3dfx картах. | |
3553 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
3554 .PD 0 | |
3555 .RSs | |
3556 .IPs <устройство> | |
3557 Явно указывает используемое fbdev устройство (по-умолчанию: /dev/\:fb0). | |
3558 .RE | |
3559 .PD 1 | |
3560 . | |
3561 .TP | |
3562 .B tdfx_vid (только Linux) | |
3563 Драйвер вывода видео для 3dfx. | |
3564 Этот драйвер напрямую использует драйвер ядра tdfx_vid. | |
3565 FIXME: Правильно ли указаны отличия 3dfx, tdfxfb и tdfx_vid? | |
20707 | 3566 .PD 0 |
3567 .RSs | |
3568 .IPs <device> | |
20832 | 3569 Явно указывает имя используемого устройства (по-умолчанию: /dev/\:tdfx_vid). |
3570 .RE | |
3571 .PD 1 | |
3572 . | |
3573 .TP | |
3574 .B dxr2 (смотрите также \-dxr2) (только DXR2) | |
3575 Драйвер вывода видео Creative DXR2. | |
20707 | 3576 .PD 0 |
3577 .RSs | |
3578 .IPs <vo_driver> | |
20832 | 3579 Поддрайвер вывода видео, для использования в качестве оверлея (x11, xv). |
3580 .RE | |
3581 .PD 1 | |
3582 . | |
3583 .TP | |
3584 .B dxr3 (только DXR3) | |
3585 Драйвер выода видео чипов MPEG декодирования | |
3586 Sigma Designs em8300 (Creative DXR3, Sigma Designs | |
3587 Hollywood Plus). | |
3588 Смотрите также видео фильтр lavc. | |
20707 | 3589 .PD 0 |
3590 .RSs | |
3591 .IPs overlay | |
20832 | 3592 Активирует оверлей вместо TV вывода. |
20707 | 3593 .IPs prebuf |
20832 | 3594 Включает пребуферинг. |
20707 | 3595 .IPs "sync\ " |
20832 | 3596 Задействует новую систему синхронизации. |
3597 .IPs norm=<стандарт> | |
3598 Указывает TV стандарт. | |
20707 | 3599 .RSss |
20832 | 3600 0: Не изменяет текущий стандарт (по-умолчанию). |
3601 .br | |
3602 1: Автоопределение использования PAL/\:NTSC. | |
3603 .br | |
3604 2: Автоопределение использования PAL/\:PAL-60. | |
20707 | 3605 .br |
3606 3: PAL | |
3607 .br | |
3608 4: PAL-60 | |
3609 .br | |
3610 5: NTSC | |
3611 .REss | |
3612 .IPs <0\-3> | |
20832 | 3613 Указывает номер используемого устройства, если у вас установлено более одной |
3614 em8300 карты. | |
3615 .RE | |
3616 .PD 1 | |
3617 . | |
3618 .TP | |
3619 .B ivtv (только IVTV) | |
3620 Драйвер вывода через TV-Выход карт MPEG декодирования, основанных на для чипах | |
3621 Conexant CX23415 (iCompression iTVC15) или Conexant CX23416 (iCompression | |
3622 iTVC16), (Hauppauge WinTV PVR-150/250/350/500). | |
3623 Смотрите также видео фильтр lavc. | |
20707 | 3624 .PD 0 |
3625 .RSs | |
3626 .IPs device | |
20832 | 3627 Явно указывает имя устройства используемого MPEG декодера (по-умолчанию: /dev/video16). |
20707 | 3628 .IPs output |
20832 | 3629 Увно указывает используемый для видеосигнала TV-Выход. |
3630 .RE | |
3631 .PD 1 | |
3632 . | |
3633 .TP | |
3634 .B mpegpes (только DVB) | |
3635 Драйвер вывода видео DVB карт, записывающий вывод в MPEG-PES файл, если | |
3636 нет установленных DVB карт. | |
20707 | 3637 .PD 0 |
3638 .RSs | |
3639 .IPs card=<1\-4> | |
20832 | 3640 Указывает номер используемого устройства, если у вас более одной карты |
3641 (поддерживается только V3 API, такое как в драйверах 1.x.y серии). | |
3642 .IPs <файл> | |
3643 Файл для вывода (по-умолчанию: ./grab.mpg) | |
3644 .RE | |
3645 .PD 1 | |
3646 . | |
3647 .TP | |
3648 .B zr (смотрите также \-zr* и \-zrhelp) | |
3649 Драйвер вывода видео для некоторых MJPEG карт завата/\:воспроизведения. | |
3650 . | |
3651 .TP | |
3652 .B zr2 (смотрите также видео фильтр zrmjpeg) | |
3653 Драйвер вывода видео для некоторых MJPEG карт завата/\:воспроизведения, | |
3654 второе поколение. | |
3655 .PD 0 | |
3656 .RSs | |
3657 .IPs dev=<устройство> | |
3658 Указывает используемое устройство. | |
20707 | 3659 .IPs norm=<PAL|NTSC|SECAM|auto> |
20832 | 3660 Указывает используемый видео стандарт (по-умолчанию: авто). |
20707 | 3661 .IPs (no)prebuf |
20832 | 3662 (Де)Активирует пребуферинг, пока не поддерживается. |
20707 | 3663 .RE |
3664 .PD 1 | |
3665 . | |
3666 .TP | |
3667 .B "md5sum\ " | |
20832 | 3668 Рассчитывает MD5 сумму каждого кадра и записывает ее в файл. |
3669 Поддерживаются цветовые пространства RGB24 и YV12. | |
3670 Полезно для отладки. | |
3671 .PD 0 | |
3672 .RSs | |
3673 .IPs outfile=<значение> | |
3674 Указывает имя файла для вывода (по-умолчанию: ./md5sums). | |
20707 | 3675 .RE |
3676 .PD 1 | |
3677 . | |
3678 .TP | |
3679 .B yuv4mpeg | |
20832 | 3680 Преобразует видео поток в последовательность несжатых YUV 4:2:0 |
3681 изображений и сохраняет ее в файл (по-умолчанию: ./stream.yuv). | |
3682 Формат такой же, как и в mjpegtools, так что это полезно для | |
3683 обработки видео комплектом mjpegtools. | |
3684 Поддерживаются YV12, RGB (24 bpp) и BGR (24 bpp) форматы. | |
3685 Вы можете указывать ее совместно с опцией \-fixed-vo для | |
3686 объединения файлов с одинаковыми разрешениями и частотой кадров. | |
20707 | 3687 .PD 0 |
3688 .RSs | |
3689 .IPs interlaced | |
20832 | 3690 Зыписывает кадры в файл как черезстрочные с первым верхним полем. |
20707 | 3691 .IPs interlaced_bf |
20832 | 3692 Зыписывает кадры в файл как черезстрочные с первым нижним полем. |
3693 .IPs file=<файл> | |
3694 Записывает вывод в <файл> вместо стандартного stream.yuv. | |
20707 | 3695 .REss |
3696 .PD 1 | |
3697 .RS | |
3698 .sp 1 | |
20832 | 3699 .I ЗАМЕЧАНИЕ: |
3700 Если вы не указываете никаких опций, то вывод будет прогрессивным | |
3701 (т.е. нечерезстрочным). | |
20707 | 3702 .RE |
3703 . | |
3704 .TP | |
3705 .B "gif89a\ " | |
20832 | 3706 Выводит кадры в один анимированный GIF в текущем каталоге. |
3707 Поддерживается только формат RGB с глубиной цвета 24 бит, результат также | |
3708 будет преобразован в 256 цветный. | |
20707 | 3709 .PD 0 |
3710 .RSs | |
3711 .IPs <fps> | |
20832 | 3712 Вещественное число, указывающее частоту кадров (по-умолчанию: 5.0). |
3713 .IPs <файл> | |
3714 Указывает имя файла для вывода (по-умолчанию: ./out.gif). | |
20707 | 3715 .REss |
3716 .PD 1 | |
3717 .RS | |
3718 .sp 1 | |
20832 | 3719 .I ЗАМЕЧАНИЕ: |
3720 Вы должны указать частоту кадров до имени, иначе это значение будет | |
3721 частью имени файла. | |
3722 .sp 1 | |
3723 .I ПРИМЕР: | |
20707 | 3724 .RE |
3725 .PD 0 | |
3726 .RSs | |
3727 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif | |
3728 .RE | |
3729 .PD 1 | |
3730 . | |
3731 .TP | |
3732 .B "jpeg\ \ \ " | |
20832 | 3733 Выводит каждый кадр в JPEG файл в текущем каталоге. |
3734 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
20707 | 3735 .PD 0 |
3736 .RSs | |
3737 .IPs [no]progressive | |
20832 | 3738 Указывает создавать обычный или прогрессивный JPEG (по-умолчанию: обычный). |
20707 | 3739 .IPs [no]baseline |
20832 | 3740 Указывает использовать базовую линию [baseline] или нет (по-умолчанию: использовать). |
20707 | 3741 .IPs optimize=<0\-100> |
20832 | 3742 Степень оптимизации (по-умолчанию: 100) |
20707 | 3743 .IPs smooth=<0\-100> |
20832 | 3744 Степень размытия (по-умолчанию: 0) |
20707 | 3745 .IPs quality=<0\-100> |
20832 | 3746 Уровень качества (default: 75) |
3747 .IPs outdir=<каталог> | |
3748 Указывает каталог для вывода JPEG файлов (по-умолчанию: ./). | |
3749 .IPs subdirs=<префикс> | |
3750 Вместо использования текущего каталога создает нумерованные подкаталоги | |
3751 с указанным префиксом для сохранения файлов. | |
21157 | 3752 .IPs maxfiles=<значение> (тольео subdirs) |
20832 | 3753 Максимальное количество файлов, сохраняемых в подкаталоге. |
3754 Должно быть больше или равно 1 (по-умолчанию: 1000). | |
20707 | 3755 .RE |
3756 .PD 1 | |
3757 . | |
3758 .TP | |
3759 .B "pnm\ \ \ \ " | |
20832 | 3760 Выводит каждый кадр в PNM файл в текущем каталоге. |
3761 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
3762 Поддерживаются файлы PPM, PGM и PGMYUV, как в raw, так и в ASCII режиме. | |
3763 Смотрите также pnm(5), ppm(5) и pgm(5). | |
20707 | 3764 .PD 0 |
3765 .RSs | |
3766 .IPs "ppm\ \ " | |
20832 | 3767 Записывает PPM файлы (по-умолчанию). |
20707 | 3768 .IPs "pgm\ \ " |
20832 | 3769 Записывает PGM файлы. |
20707 | 3770 .IPs pgmyuv |
20832 | 3771 Выводит PGMYUV файлы. |
3772 PGMYUV похож на PGM, но дополнительно содержит U и V компоненты, | |
3773 присоединенные к нижней части картинки. | |
3774 . | |
20707 | 3775 .IPs "raw\ \ " |
20832 | 3776 Записывает PNM файлы в raw режиме (по-умолчанию). |
20707 | 3777 .IPs ascii |
20832 | 3778 Записывает PNM файлы в ASCII режиме. |
3779 .IPs outdir=<каталог> | |
3780 Указывает каталог для сохранения PNM файлов (по-умолчанию: ./). | |
3781 .IPs subdirs=<префикс> | |
3782 Вместо использования текущего каталога создает нумерованные подкаталоги | |
3783 с указанным префиксом для сохранения файлов. | |
3784 .IPs maxfiles=<число> (только subdirs) | |
3785 Максимальное количество файлов, сохраняемых в подкаталоге. | |
3786 Должно быть больше или равно 1 (по-умолчанию: 1000). | |
20707 | 3787 .RE |
3788 .PD 1 | |
3789 . | |
3790 .TP | |
3791 .B "png\ \ \ \ " | |
20832 | 3792 Выводит каждый кадр в PNG файл в текущем каталоге. |
3793 Название файла формируется из номера кадра, дополненного слева нолями. | |
3794 Поддерживаются 24bpp RGB и BGR форматы. | |
20707 | 3795 .PD 0 |
3796 .RSs | |
3797 .IPs z=<0-9> | |
20832 | 3798 Указываеть степень сжатия. |
3799 0 - без сжатия, 9 - максимальное сжатие. | |
20707 | 3800 .RE |
3801 .PD 1 | |
3802 . | |
3803 .TP | |
3804 .B "tga\ \ \ \ " | |
20832 | 3805 Выводит каждый кадр в файл Targa в текущем каталоге. |
3806 В качестве имени файла выступает номер кадра с лидирующими нулями. | |
3807 Назначение этого драйвера - сохранить кадры без потери качества, | |
3808 не используя сторонних библиотек. | |
3809 Он поддерживает BGR[A] формат с глубиной цвета 15, 24 или 32. | |
3810 Вы можете выбрать специфичный формат с помощью видео фильтра format. | |
3811 .sp 1 | |
3812 .I ПРИМЕР: | |
20707 | 3813 .RE |
3814 .PD 0 | |
3815 .RSs | |
3816 mplayer video.nut \-vf format=bgr15 \-vo tga | |
3817 .RE | |
3818 .PD 1 | |
3819 . | |
3820 . | |
3821 . | |
21050 | 3822 .SH "ОПЦИИ ДЕКОДИРОВАНИЯ/ФИЛЬТРАЦИИ" |
3823 . | |
3824 .TP | |
3825 .B \-ac <[-|+]кодек1,[-|+]кодек2,...[,]> | |
3826 Указывает список используемых аудио кодеков в порядке приоритета, кодек | |
3827 указывается по его наименованию из codecs.conf. | |
3828 Для пропуска кодека указывайте '-' перед его именем. | |
3829 Для форсирования кодека указывайтее '+' перед его именем, | |
3830 но скорее всего это приведет к краху! | |
3831 Если список содержит ',' в конце, то MPlayer в случае проблем будет использовать | |
3832 кодек не из списка. | |
3833 .br | |
3834 .I ЗАМЕЧАНИЕ: | |
3835 Полный список доступных кодеков выводится опцией \-ac help. | |
3836 .sp 1 | |
3837 .I ПРИМЕР: | |
20707 | 3838 .PD 0 |
3839 .RSs | |
3840 .IPs "\-ac mp3acm" | |
21050 | 3841 Форсирует использование MP3 кодека l3codeca.acm. |
20707 | 3842 .IPs "\-ac mad," |
21050 | 3843 Сначала пробуется libmad, если не получилось - остальные. |
20707 | 3844 .IPs "\-ac hwac3,a52," |
21050 | 3845 Пробуется AC3 транзит, программный AC4, затем - остальные. |
20707 | 3846 .IPs "\-ac hwdts," |
21050 | 3847 Пробуется аппаратный DTS транзит, если не получилось - остальные. |
20707 | 3848 .IPs "\-ac -ffmp3," |
21050 | 3849 Пропускает использование FFmpeg MP3 декодера. |
3850 .RE | |
3851 .PD 1 | |
3852 . | |
3853 .TP | |
3854 .B \-af-adv <force=(0\-7):list=(фильтры)> (смотрите также \-af) | |
3855 Указывает дополнительные опции аудио фильтра: | |
20707 | 3856 .RSs |
3857 .IPs force=<0\-7> | |
21050 | 3858 Форсирует алгоритм вставки аудио фильтров в соответствии с одним из инжемеречисленного: |
20707 | 3859 .RSss |
21050 | 3860 0: Используется полностью автоматическая вставка. |
3861 .br | |
3862 1: Оптимизируется по точности (по-умолчанию). | |
3863 .br | |
3864 2: Оптимизируется по скорости. | |
3865 .I Внимание: | |
3866 Некоторые возможности аудио фильтров могут молча отказать, | |
3867 и качество звука ухудшится. | |
3868 .br | |
3869 3: Не использовать ни автоматическую вставку фильтров, ни оптимизацию. | |
3870 .I внимание: | |
3871 Использование этой опции может привести к краху MPlayer. | |
3872 .br | |
3873 4: Использовать автоматическую вставку как в 0, но | |
3874 по возможности использовать операции с плавающей точкой. | |
3875 .br | |
3876 5: Использовать автоматическую вставку как в 1, но | |
3877 по возможности использовать операции с плавающей точкой. | |
3878 .br | |
3879 6: Использовать автоматическую вставку как в 2, но | |
3880 по возможности использовать операции с плавающей точкой. | |
3881 .br | |
3882 7: Не использовать автоматическую вставку фильтров как и в 3, | |
3883 и по возможности использовать операции с плавающей точкой. | |
20707 | 3884 .REss |
21050 | 3885 .IPs list=<фильтры> |
3886 То же, что и \-af. | |
3887 .RE | |
3888 . | |
3889 .TP | |
3890 .B \-afm <драйвер1,драйвер2,...> | |
3891 Указывает список используемых семейств аудио кодеков в порядке приоритета, | |
3892 имена указываются из codecs.conf. | |
3893 Возвращается к использованию кодеков по-умолчанию, если не работает ни одно | |
3894 семейство из указанных. | |
3895 .br | |
3896 .I ЗАМЕЧАНИЕ: | |
3897 Список доступных семейств кодеков можно посмотреть при помощи \-afm help. | |
3898 .sp 1 | |
3899 .I ПРИМЕР: | |
20707 | 3900 .PD 0 |
3901 .RSs | |
3902 .IPs "\-afm ffmpeg" | |
21050 | 3903 Сначала попытаться использовать libavcodec кодеки FFmpeg. |
20707 | 3904 .IPs "\-afm acm,dshow" |
21050 | 3905 Сначала попытаться использовать Win32 кодеки. |
3906 .RE | |
3907 .PD 1 | |
3908 . | |
3909 .TP | |
3910 .B \-aspect <коэффициент> (смотрите также \-zoom) | |
3911 Переопределяет коэффициент пропорции фильма для случая, когда информация о | |
3912 пропорциях неверна или отсутствует в воспроизводимом файле. | |
3913 .sp 1 | |
3914 .I ПРИМЕР: | |
20707 | 3915 .PD 0 |
3916 .RSs | |
3917 \-aspect 4:3 or \-aspect 1.3333 | |
3918 .br | |
3919 \-aspect 16:9 or \-aspect 1.7777 | |
3920 .RE | |
3921 .PD 1 | |
3922 . | |
3923 .TP | |
3924 .B \-noaspect | |
21050 | 3925 Отключает автоматическую компенсацию коэффициента пропорций фильма. |
20707 | 3926 . |
3927 .TP | |
3928 .B "\-flip \ " | |
21050 | 3929 Зеркально отражает изображение сверху-вниз. |
3930 . | |
3931 .TP | |
3932 .B \-lavdopts <опция1:опция2:...> (КОД ОТЛАДКИ) | |
3933 Указывает параметры декодирования libavcodec. | |
3934 Опции друг от друга отделяйте двоеточиями. | |
3935 .sp 1 | |
3936 .I ПРИМЕР: | |
20707 | 3937 .PD 0 |
3938 .RSs | |
3939 \-lavdopts gray:skiploopfilter=all:skipframe=nonref | |
3940 .RE | |
3941 .PD 1 | |
3942 .sp 1 | |
3943 .RS | |
21050 | 3944 Доступные опции: |
20707 | 3945 .RE |
3946 .RSs | |
3947 .IPs bitexact | |
21050 | 3948 Указывает использовать только побитово точные алгоритмы на всех этапах |
3949 декодирования (для тестирования кодека). | |
3950 .IPs bug=<значение> | |
3951 Указывает самостоятельно обходить ошибки кодера. | |
20707 | 3952 .RSss |
21050 | 3953 0: ничего |
3954 .br | |
3955 1: автоматически определять баги(ошибки) (по-умолчанию) | |
3956 .br | |
3957 2 (msmpeg4v3): некоторые старые msmpeg4v3 файлы, созданные lavc (не определяются автоматически) | |
3958 .br | |
3959 4 (mpeg4): баг интерлейсинга Xvid (определяется автоматически, если fourcc==XVIX) | |
3960 .br | |
3961 8 (mpeg4): UMP4 (определяется автоматически, если fourcc==UMP4) | |
3962 .br | |
3963 .\" FIXME padding - заполнение | |
3964 16 (mpeg4): баг заполнения (определяется автоматически) | |
3965 .br | |
3966 .\" FIXME is translation corrent? "illegal vlc bug" | |
3967 32 (mpeg4): баг нелегального vlc (определяется автоматически по fourcc) | |
3968 .br | |
3969 64 (mpeg4): баг qpel у Xvid и DivX (определяется автоматически по fourcc/\:версии) | |
3970 .br | |
3971 128 (mpeg4): старый стандарт qpel (определяется по fourcc/\:версии) | |
3972 .br | |
3973 256 (mpeg4): еще один баг qpel (определяется автоматически по fourcc/\:верси) | |
3974 .br | |
3975 512 (mpeg4): баг direct-qpel-blocksize (определяется автоматически по fourcc/\:версии) | |
3976 .br | |
3977 1024 (mpeg4): баг заполнения кромки (определяется автоматически по fourcc/\:версии) | |
20707 | 3978 .REss |
21050 | 3979 .IPs debug=<значение> |
3980 Отображать отладочную информацию. | |
20707 | 3981 .RSss |
3982 .br | |
21050 | 3983 0: отключено |
3984 .br | |
3985 1: информация об изображении | |
3986 .br | |
3987 2: управление скоростью | |
3988 .br | |
3989 4: битпоток | |
3990 .br | |
3991 8: тип макроблока (MB) | |
3992 .br | |
3993 16: поблочный[per-block] параметр квантизации (QP) | |
3994 .br | |
3995 32: вектор движения | |
3996 .br | |
3997 0x0040: визуализация вектора движения (используйте \-noslices) | |
3998 .br | |
3999 0x0080: пропуск макроблока (MB) | |
4000 .br | |
4001 0x0100: стартовый код | |
20707 | 4002 .br |
4003 0x0200: PTS | |
4004 .br | |
21050 | 4005 .\" FIXME is translation correct? "error resilience" |
4006 0x0400: упругость ошибки[error resilience] | |
4007 .br | |
4008 .\" FIXME is translation correct? "memory management control operations" | |
4009 0x0800: операции контроля над управлением памятью (H.264) | |
4010 .br | |
4011 0x1000: ошибки | |
4012 .br | |
4013 0x2000: Визуализировать параметр квантизации (QP), меньший QP - более светлый зеленый. | |
4014 .br | |
4015 0x4000: визуализировать типы блоков. | |
20707 | 4016 .REss |
21050 | 4017 .IPs ec=<значение> |
4018 Устанавливает стратегию маскировки ошибок. | |
20707 | 4019 .RSss |
21050 | 4020 1: Используется сильный deblock фильтр для поврежденных MB. |
4021 .br | |
4022 2: Итеративный поиск вектора движения (MV) (медленно) | |
4023 .br | |
4024 3: Все (по-умолчанию) | |
20707 | 4025 .REss |
21050 | 4026 .IPs er=<значение> |
4027 .\" FIXME is translation correct? "error resilience" | |
4028 Устанавливает стратегию упругости[error resilience] ошибки. | |
20707 | 4029 .RSss |
4030 .br | |
21050 | 4031 0: отключено |
4032 .br | |
4033 1: аккуратная (Должно работать с испорченными кодерами.) | |
4034 .br | |
4035 2: обычная (по-умолчанию) (Работает с совместимыми кодерами.) | |
4036 .br | |
4037 3: агрессивная (Больше проверок, но могут быть проблемы даже с правильными битовыми потоками.) | |
4038 .br | |
4039 4: очень агрессивная | |
20707 | 4040 .REss |
21050 | 4041 .IPs "fast (только MPEG-2)" |
4042 .\" FIXME is translation correct? | |
4043 .\" Enable optimizations which do not comply to the specification and might | |
4044 .\" potentially cause problems, like simpler dequantization, assuming use | |
4045 .\" of the default quantization matrix, assuming YUV 4:2:0 and skipping a few | |
4046 .\" checks to detect damaged bitstreams. | |
4047 Включает оптимизации, которые не подчиняются спецификации и, потенциально, | |
4048 могут быть причиной проблем, такие как упрощенная деквантизация[dequantization], | |
4049 предполагающая использование стандартной матрицы квантизации, YUV 4:2:0 и | |
4050 пропускающая некоторые проверки поврежденности витового потока. | |
20707 | 4051 .IPs "gray\ " |
21050 | 4052 декодирование только в оттенках серого (немного быстрее, чем с цветом) |
4053 .IPs "idct=<0\-99> (смотрите \-lavcopts)" | |
4054 Для лучшего качества декодирования используйте один и тот же IDCT алгоритм для | |
4055 кодирования и декодирования. Хотя это может даться ценой точности. | |
4056 .IPs lowres=<число>[,<w>] | |
4057 Декодирование с меньшим разрешением. Это поддерживаетя не всеми кодеками, и | |
4058 часто приводит к ужасным артефактам. | |
4059 Это не баг, а побочный эффект декодирования не в полном разрешении. | |
20707 | 4060 .RSss |
4061 .br | |
21050 | 4062 0: отключено |
4063 .br | |
4064 1: 1/2 оригинала | |
4065 .br | |
4066 2: 1/4 оригинала | |
4067 .br | |
4068 3: 1/8 оригинала | |
20707 | 4069 .REss |
4070 .RS | |
21050 | 4071 Если указано <w>, кодирование в меньшем разрешении будет использоваться только в том случаем, |
4072 если ширина видео больше или равна <w>. | |
4073 .RE | |
4074 .IPs "sb=<количество> (только MPEG-2)" | |
4075 Пропускает указанное количество строк макроблоков в нижней части. | |
21157 | 4076 .IPs "st=<количество> (только MPEG-2)" |
21050 | 4077 Пропускает указанное количество строк макроблоков в верхней части. |
4078 .IPs skiploopfilter=<skipvalue> (только H.264) | |
4079 Пропускает фильтр loop (он же deblocking) во время декодирования H.264. | |
4080 Поскольку фильтрованный кадр предполагается использовать в качестве ссылки | |
4081 для декодирования зависимых кадров, то качество, например у MPEG-2, будет хуже, чем если бы | |
4082 deblocking не производился вовсе. Но, как минимум для HDTV с высоким битпотоком, это дает | |
4083 значительное повышение производительности без видимой потери качества. | |
4084 .sp 1 | |
4085 <skipvalue> может быть одним из нижеперечисленных: | |
20707 | 4086 .RSss |
4087 .br | |
21050 | 4088 none: Никогда не пропускать. |
4089 .br | |
4090 default: Пропускать бесполезные этапы обработки (например пакеты нулевого размера в AVI). | |
4091 .br | |
4092 nonref: пропускать кадры, на которые нет ссылок (т.е.\& не использующиеся для декодирования | |
4093 .\" FIXME is translation correct? the error cannot "build up" | |
4094 других кадров, ошибка просто невозножна). | |
4095 .br | |
4096 bidir: Пропускать B-кадры. | |
4097 .br | |
4098 nonkey: Пропускать все кадры, кроме ключевых. | |
4099 .br | |
4100 all: Пропускать все кадры. | |
20707 | 4101 .REss |
21050 | 4102 .IPs skipidct=<skipvalue> (только MPEG1/2) |
4103 Пропускает этап IDCT. | |
4104 Это значительно ухудшает качество практически во всех случаях | |
4105 (допустимые значения skipvalue смотрите в описании опции skiploopfilter). | |
20707 | 4106 .IPs skipframe=<skipvalue> |
21050 | 4107 Полностью пропускает декодирование кадров. |
4108 Дает большой прирост скорости, но прерывистое изображение и иногда артефакты. | |
4109 (допустимые значения skipvalue смотрите в описании опции skiploopfilter). | |
20707 | 4110 .IPs threads=<1\-8> |
21050 | 4111 количество потоков, использующихся для декодирования (по-умолчанию: 1) |
4112 .IPs vismv=<значение> | |
4113 Указывает визуализировать векторы движения. | |
20707 | 4114 .RSss |
4115 .br | |
21050 | 4116 0: Отключено. |
4117 .br | |
4118 1: Визуализировать векторы P-кадров, предсказанные вперед. | |
4119 .br | |
4120 2: Визуализировать векторы B-кадров, предсказанные вперед. | |
4121 .br | |
4122 4: Визуализировать аекторы B-кадров, предсказанные назад. | |
20707 | 4123 .REss |
4124 .IPs vstats | |
21050 | 4125 Выводит некоторую статистику и сохраняет ее в ./vstats_*.log. |
20707 | 4126 .RE |
4127 . | |
4128 .TP | |
4129 .B \-noslices | |
21050 | 4130 Отключает отрисовку видео слоями/\:полосами по 16-пикселов высотой, вместо отрисовки |
4131 целого кадра за один проход. | |
4132 Может быть быстрее или медленне, в зависимости от видео карты и доступного кэша. | |
4133 Полезно только с кодеками libmpeg2 и libavcodec. | |
20707 | 4134 . |
4135 .TP | |
4136 .B \-nosound | |
21050 | 4137 Указывает не воспроизводить/\:кодировать звук. |
4138 Полезно для определения производительности. | |
20707 | 4139 . |
4140 .TP | |
4141 .B \-novideo | |
21050 | 4142 Указывает не воспроизводить/\:кодиовать видео. |
4143 Во многих случаях это не работает, вместо нее используйте \-vc null \-vo null. | |
4144 . | |
4145 .TP | |
4146 .B \-pp <качество> (смотрите также \-vf pp) | |
4147 Устанавливает уровень построцессинга DLL. | |
4148 Эта опция больше не пригодна для работы с \-vf pp. | |
4149 Она работает только с Win32 DirectShow DLL, имеющими встроенные процедуры построцессинга. | |
4150 Допустимый диапазон значений \-pp зависит от кодека, как правило это 0\-6, где 0=отключено, | |
4151 6=наимедленный/\:лучший. | |
4152 . | |
4153 .TP | |
4154 .B \-pphelp (смотрите также \-vf pp) | |
4155 Показывает краткую помощь по доступным фильтрам построцессинга и их испольованию. | |
4156 . | |
4157 .TP | |
4158 .B \-ssf <режим> | |
4159 Указывает параметры программного модуля масштабирования. | |
4160 .sp 1 | |
4161 .I ПРИМЕР: | |
20707 | 4162 .PD 0 |
4163 .RSs | |
4164 \-vf scale \-ssf lgb=3.0 | |
4165 .RE | |
4166 .PD 1 | |
4167 .PD 0 | |
4168 .RSs | |
4169 .IPs lgb=<0\-100> | |
21050 | 4170 фильтр гауссового размытия (яркостная составляющая[luma]) |
20707 | 4171 .IPs cgb=<0\-100> |
21050 | 4172 фильтр гауссового размытия (хроматическая составляющая[chroma]) |
20707 | 4173 .IPs ls=<-100\-100> |
21050 | 4174 sharpen фильтр (яркостная составляющая[luma]) |
20707 | 4175 .IPs cs=<-100\-100> |
21050 | 4176 sharpen фильтр (хроматическая составляющая[chroma]) |
20707 | 4177 .IPs chs=<h> |
21050 | 4178 горизонтальный сдвиг хроматической составляющей[chroma]. |
20707 | 4179 .IPs cvs=<v> |
21050 | 4180 вертикальный сдвиг хроматической составляющей[chroma]. |
4181 .RE | |
4182 .PD 1 | |
4183 . | |
4184 .TP | |
4185 .B \-stereo <режим> | |
4186 Выбирает тип стерео вывода MP2/\:MP3. | |
20707 | 4187 .PD 0 |
4188 .RSs | |
4189 .IPs 0 | |
21050 | 4190 стерео |
20707 | 4191 .IPs 1 |
21050 | 4192 левый канал |
20707 | 4193 .IPs 2 |
21050 | 4194 правый канал |
4195 .RE | |
4196 .PD 1 | |
4197 . | |
4198 .TP | |
4199 .B \-sws <тип программного модуля масштабирования> (смотрите также \-vf scale и \-zoom) | |
4200 Указывает используемый опцией \-zoom алгоритм программного масштабирования. | |
4201 Она влияет на драйвера вывода видео, не способные аппаратно масштабировать, например x11. | |
4202 .sp 1 | |
4203 Доступные типы: | |
20707 | 4204 .sp 1 |
4205 .PD 0 | |
4206 .RSs | |
4207 .IPs 0 | |
21050 | 4208 быстрый билинейный |
20707 | 4209 .IPs 1 |
21050 | 4210 билинейный |
20707 | 4211 .IPs 2 |
21050 | 4212 бикубический (хорошее качество) (по-умолчанию) |
20707 | 4213 .IPs 3 |
21050 | 4214 экспериментальный |
20707 | 4215 .IPs 4 |
21050 | 4216 ближайший сосед (плохое качество) |
20707 | 4217 .IPs 5 |
4218 area | |
4219 .IPs 6 | |
21050 | 4220 бикубичекий для яркостной[luma] / билинейный для хроматической[chroma] составляющей |
20707 | 4221 .IPs 7 |
21050 | 4222 гауссовый |
20707 | 4223 .IPs 8 |
4224 sincR | |
4225 .IPs 9 | |
4226 lanczos | |
4227 .IPs 10 | |
21050 | 4228 натуральный бикубический сплайн[natural bicubic spline] |
20707 | 4229 .RE |
4230 .PD 1 | |
4231 .sp 1 | |
4232 .RS | |
21050 | 4233 .I ЗАМЕЧАНИЕ: |
4234 Некоторые \-sws опции можно настраивать. | |
4235 Подробная информация есть в описании видео фильтра scale. | |
4236 .RE | |
4237 . | |
4238 .TP | |
4239 .B \-vc <[-|+]кодек1,[-|+]кодек2,...[,]> | |
4240 Указывает список используемых кодеков в порядке приоритета, кодек указывается по его | |
4241 наименованию из codecs.conf. | |
4242 Для пропуска кодека указывайте '-' перед его именем. | |
4243 Для форсирования использования кодека указывайтее '+' перед его именем, | |
4244 скорее всего это приведет к краху! | |
4245 Если список содержит ',' в конце, то MPlayer в случае проблем будет использовать | |
4246 кодек не из списка. | |
4247 .br | |
4248 .I ЗАМЕЧАНИЕ: | |
4249 Полный список доступных кодеков выводится опцией \-vc help. | |
4250 .sp 1 | |
4251 .I ПРИМЕР: | |
20707 | 4252 .PD 0 |
4253 .RSs | |
4254 .IPs "\-vc divx" | |
21050 | 4255 Попытаться использовать только кодек Win32/\:VfW DivX, без запасного варианта. |
20707 | 4256 .IPs "\-vc -divxds,-divx," |
21050 | 4257 Пропустить Win32 DivX кодеки. |
20707 | 4258 .IPs "\-vc ffmpeg12,mpeg12," |
21050 | 4259 Попытаться использовать MPEG-1/2 из libavcodec, затем libmpeg2, затем остальные. |
4260 .RE | |
4261 .PD 1 | |
4262 . | |
4263 .TP | |
4264 .B \-vfm <драйвер1,драйвер2,...> | |
4265 Указывает список используемый семейств аудио кодеков в порядке приоритета, | |
4266 имена указываются из codecs.conf. | |
4267 Возвращается к использованию кодеков по-умолчанию, если не работает ни одно | |
4268 семейство из указанных. | |
4269 .br | |
4270 .I ЗАМЕЧАНИЕ: | |
4271 Список доступных семейств кодеков можно посмотреть при помощи \-vfm help. | |
4272 .sp 1 | |
4273 .I ПРИМЕР: | |
20707 | 4274 .PD 0 |
4275 .RSs | |
4276 .IPs "\-vfm ffmpeg,dshow,vfw" | |
21050 | 4277 Попытаться использовать libavcodec, затем Directshow, затем VfW кодеки, затем остальные, |
4278 если ни один не работает. | |
20707 | 4279 .IPs "\-vfm xanim" |
21050 | 4280 Попытаться использовать сначала XAnim кодеки. |
4281 .RE | |
4282 .PD 1 | |
4283 . | |
4284 .TP | |
4285 .B \-x <x> (смотрите также \-zoom) (только MPlayer) | |
4286 Масштабирует изображение до ширины <x> (если доступно | |
4287 программное/\:аппаратное масштабирование). | |
4288 Отключает расчет пропорций. | |
4289 . | |
4290 .TP | |
4291 .B \-xvidopts <опция1:опция2:...> | |
4292 Указывает дополнительные параметры при декодировании с Xvid. | |
4293 .br | |
4294 .I ЗАМЕЧАНИЕ: | |
4295 Поскольку libavcodec быстрее, чем Xvid, вы, возможно, захотите использовать вместо него | |
4296 фильтр постпроцессинга (\-vf pp) и декодер (\-vfm ffmpeg) из libavcodec. | |
4297 .sp 1 | |
4298 Встроенные фильтры построцессинга Xvid: | |
4299 .PD 0 | |
4300 .RSs | |
4301 .IPs deblock-chroma (смотрите также \-vf pp) | |
4302 deblock фильтр хроматической[chroma] составляющей | |
4303 .IPs deblock-luma (смотрите также \-vf pp) | |
4304 deblock фильтр яркостной[luma] составляющей | |
4305 .IPs dering-luma (смотрите также \-vf pp) | |
4306 deringing фильтр яркостной[luma] составляющей | |
4307 .IPs dering-chroma (смотрите также \-vf pp) | |
4308 deringing фильтр хроматической[chroma] составляющей | |
4309 .IPs filmeffect (смотрите также \-vf noise) | |
4310 Добавляет эффект старинного фильма. | |
4311 Может увеличить воспринимаемое качество, на самом деле ухудшая настоящее. | |
20707 | 4312 .RE |
4313 .sp 1 | |
4314 .RS | |
21050 | 4315 методы рендеринга: |
20707 | 4316 .RE |
4317 .PD 0 | |
4318 .RSs | |
4319 .IPs "dr2\ \ " | |
21050 | 4320 Активирует метод 2 прямого рендеринга. |
20707 | 4321 .IPs nodr2 |
21050 | 4322 Деактивирует метод 2 прямого рендеринга. |
4323 .RE | |
4324 .PD 1 | |
4325 . | |
4326 .TP | |
4327 .B \-xy <значение> (смотрите также \-zoom) | |
4328 .PD 0 | |
4329 .RSs | |
4330 .IPs значение<=8 | |
4331 Масштабировать изображение в <значение> раз. | |
4332 .IPs значение>8 | |
4333 Установить ширину, равную значению и рассчитать высоту для сохранения | |
4334 правильного коэффициента пропорций. | |
4335 .RE | |
4336 .PD 1 | |
4337 . | |
4338 .TP | |
4339 .B \-y <y> (смотрите также \-zoom) (только MPlayer) | |
4340 Масштабирует изображение до высоты <y> (если доступно | |
4341 программное/\:аппаратное масштабирование). | |
4342 Отключает расчет пропорций. | |
20707 | 4343 . |
4344 .TP | |
4345 .B "\-zoom\ \ " | |
21050 | 4346 Разрешает использовать программное масштабирование, где это возможно. |
4347 Это позволит выполнять его с драйверами вывода, | |
4348 не поддерживающими аппаратное масштабирование (такими как x11, fbdev), | |
4349 там, где по-умолчанию MPlayer отключает масштабирование для | |
4350 увеличения производительности. | |
20707 | 4351 . |
4352 . | |
4353 . | |
4354 .SH "AUDIO FILTERS" | |
4355 Audio filters allow you to modify the audio stream and its properties. | |
4356 The syntax is: | |
4357 . | |
4358 .TP | |
4359 .B \-af <filter1[=parameter1:parameter2:...],filter2,...> | |
4360 Setup a chain of audio filters. | |
4361 .PP | |
4362 .I NOTE: | |
4363 To get a full list of available audio filters, see \-af help. | |
4364 .PP | |
4365 Available filters are: | |
4366 . | |
4367 .TP | |
4368 .B resample[=srate[:sloppy[:type]]] | |
4369 Changes the sample rate of the audio stream. | |
4370 Can be used if you have a fixed frequency sound card or if you are | |
4371 stuck with an old sound card that is only capable of max 44.1kHz. | |
4372 This filter is automatically enabled if necessary. | |
4373 It only supports 16-bit integer and float in native-endian format as input. | |
4374 .br | |
4375 .I NOTE: | |
4376 With MEncoder, you need to also use \-srate <srate>. | |
4377 .PD 0 | |
4378 .RSs | |
4379 .IPs <srate> | |
4380 output sample frequency in Hz. | |
4381 The valid range for this parameter is 8000 to 192000. | |
4382 If the input and output sample frequency are the same or if this | |
4383 parameter is omitted the filter is automatically unloaded. | |
4384 A high sample frequency normally improves the audio quality, | |
4385 especially when used in combination with other filters. | |
4386 .IPs <sloppy> | |
4387 Allow (1) or disallow (0) the output frequency to differ slightly | |
4388 from the frequency given by <srate> (default: 1). | |
4389 Can be used if the startup of the playback is extremely slow. | |
4390 .IPs <type> | |
4391 Selects which resampling method to use. | |
4392 .RSss | |
4393 0: linear interpolation (fast, poor quality especially when upsampling) | |
4394 .br | |
4395 1: polyphase filterbank and integer processing | |
4396 .br | |
4397 2: polyphase filterbank and floating point processing (slow, best quality) | |
4398 .REss | |
4399 .PD 1 | |
4400 .RE | |
4401 .sp 1 | |
4402 .RS | |
4403 .I EXAMPLE: | |
4404 .RE | |
4405 .PD 0 | |
4406 .RSs | |
4407 .IPs "mplayer \-af resample=44100:0:0" | |
4408 would set the output frequency of the resample filter to 44100Hz using | |
4409 exact output frequency scaling and linear interpolation. | |
4410 .RE | |
4411 .PD 1 | |
4412 . | |
4413 .TP | |
4414 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]] | |
4415 Changes the sample rate of the audio stream to an integer <srate> in Hz. | |
4416 It only supports the 16-bit native-endian format. | |
4417 .br | |
4418 .I NOTE: | |
4419 With MEncoder, you need to also use \-srate <srate>. | |
4420 .PD 0 | |
4421 .RSs | |
4422 .IPs <srate> | |
4423 the output sample rate | |
4424 .IPs <length> | |
4425 length of the filter with respect to the lower sampling rate (default: 16) | |
4426 .IPs <linear> | |
4427 if 1 then filters will be linearly interpolated between polyphase entries | |
4428 .IPs <count> | |
4429 log2 of the number of polyphase entries | |
4430 (..., 10->1024, 11->2048, 12->4096, ...) | |
4431 (default: 10->1024) | |
4432 .IPs <cutoff> | |
4433 cutoff frequency (0.0-1.0), default set depending upon filter length | |
4434 .RE | |
4435 .PD 1 | |
4436 . | |
4437 .TP | |
4438 .B sweep[=speed] | |
4439 Produces a sine sweep. | |
4440 .PD 0 | |
4441 .RSs | |
4442 .IPs <0.0\-1.0> | |
4443 Sine function delta, use very low values to hear the sweep. | |
4444 .RE | |
4445 .PD 1 | |
4446 . | |
4447 .TP | |
4448 .B sinesuppress[=freq:decay] | |
4449 Remove a sine at the specified frequency. | |
4450 Useful to get rid of the 50/60Hz noise on low quality audio equipment. | |
4451 It probably only works on mono input. | |
4452 .PD 0 | |
4453 .RSs | |
4454 .IPs <freq> | |
4455 The frequency of the sine which should be removed (in Hz) (default: 50) | |
4456 .IPs <decay> | |
4457 Controls the adaptivity (a larger value will make the filter adapt to | |
4458 amplitude and phase changes quicker, a smaller value will make the | |
4459 adaptation slower) (default: 0.0001). | |
4460 Reasonable values are around 0.001. | |
4461 .RE | |
4462 .PD 1 | |
4463 . | |
4464 .TP | |
4465 .B hrtf[=flag] | |
4466 Head-related transfer function: Converts multichannel audio to | |
4467 2 channel output for headphones, preserving the spatiality of the sound. | |
4468 .sp 1 | |
4469 .PD 0 | |
4470 .RS | |
4471 .IPs "Flag Meaning" | |
4472 .IPs "m matrix decoding of the rear channel" | |
4473 .IPs "s 2-channel matrix decoding" | |
4474 .IPs "0 no matrix decoding (default)" | |
4475 .RE | |
4476 .PD 1 | |
4477 . | |
4478 .TP | |
4479 .B equalizer=[g1:g2:g3:...:g10] | |
4480 10 octave band graphic equalizer, implemented using 10 IIR band pass filters. | |
4481 This means that it works regardless of what type of audio is being played back. | |
4482 The center frequencies for the 10 bands are: | |
4483 .sp 1 | |
4484 .PD 0 | |
4485 .RS | |
4486 .IPs "No. frequency" | |
4487 .IPs "0 31.25 Hz" | |
4488 .IPs "1 62.50 Hz" | |
4489 .IPs "2 125.00 Hz" | |
4490 .IPs "3 250.00 Hz" | |
4491 .IPs "4 500.00 Hz" | |
4492 .IPs "5 1.00 kHz" | |
4493 .IPs "6 2.00 kHz" | |
4494 .IPs "7 4.00 kHz" | |
4495 .IPs "8 8.00 kHz" | |
4496 .IPs "9 16.00 kHz" | |
4497 .RE | |
4498 .PD 1 | |
4499 .sp 1 | |
4500 .RS | |
4501 If the sample rate of the sound being played is lower than the center | |
4502 frequency for a frequency band, then that band will be disabled. | |
4503 A known bug with this filter is that the characteristics for the | |
4504 uppermost band are not completely symmetric if the sample | |
4505 rate is close to the center frequency of that band. | |
4506 This problem can be worked around by upsampling the sound | |
4507 using the resample filter before it reaches this filter. | |
4508 .RE | |
4509 .PD 0 | |
4510 .RSs | |
4511 .IPs <g1>:<g2>:<g3>:...:<g10> | |
4512 floating point numbers representing the gain in dB | |
4513 for each frequency band (-12\-12) | |
4514 .RE | |
4515 .sp 1 | |
4516 .RS | |
4517 .I EXAMPLE: | |
4518 .RE | |
4519 .RSs | |
4520 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi" | |
4521 Would amplify the sound in the upper and lower frequency region | |
4522 while canceling it almost completely around 1kHz. | |
4523 .RE | |
4524 .PD 1 | |
4525 . | |
4526 .TP | |
4527 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...] | |
4528 Can be used for adding, removing, routing and copying audio channels. | |
4529 If only <nch> is given the default routing is used, it works as | |
4530 follows: If the number of output channels is bigger than the number of | |
4531 input channels empty channels are inserted (except mixing from mono to | |
4532 stereo, then the mono channel is repeated in both of the output | |
4533 channels). | |
4534 If the number of output channels is smaller than the number | |
4535 of input channels the exceeding channels are truncated. | |
4536 .PD 0 | |
4537 .RSs | |
4538 .IPs <nch> | |
4539 number of output channels (1\-6) | |
4540 .IPs "<nr>\ " | |
4541 number of routes (1\-6) | |
4542 .IPs <from1:to1:from2:to2:from3:to3:...> | |
4543 Pairs of numbers between 0 and 5 that define where to route each channel. | |
4544 .RE | |
4545 .sp 1 | |
4546 .RS | |
4547 .I EXAMPLE: | |
4548 .RE | |
4549 .RSs | |
4550 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi" | |
4551 Would change the number of channels to 4 and set up 4 routes that | |
4552 swap channel 0 and channel 1 and leave channel 2 and 3 intact. | |
4553 Observe that if media containing two channels was played back, channels | |
4554 2 and 3 would contain silence but 0 and 1 would still be swapped. | |
4555 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi" | |
4556 Would change the number of channels to 6 and set up 4 routes | |
4557 that copy channel 0 to channels 0 to 3. | |
4558 Channel 4 and 5 will contain silence. | |
4559 .RE | |
4560 .PD 1 | |
4561 . | |
4562 .TP | |
4563 .B format[=format] (also see \-format) | |
4564 Convert between different sample formats. | |
4565 Automatically enabled when needed by the sound card or another filter. | |
4566 .PD 0 | |
4567 .RSs | |
4568 .IPs <format> | |
4569 Sets the desired format. | |
4570 The general form is 'sbe', where 's' denotes the sign (either 's' for signed | |
4571 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32) | |
4572 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian | |
4573 and 'ne' the endianness of the computer MPlayer is running on). | |
4574 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'. | |
4575 Exceptions to this rule that are also valid format specifiers: u8, s8, | |
4576 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm. | |
4577 .RE | |
4578 .PD 1 | |
4579 . | |
4580 .TP | |
4581 .B volume[=v[:sc]] | |
4582 Implements software volume control. | |
4583 Use this filter with caution since it can reduce the signal | |
4584 to noise ratio of the sound. | |
4585 In most cases it is best to set the level for the PCM sound to max, | |
4586 leave this filter out and control the output level to your | |
4587 speakers with the master volume control of the mixer. | |
4588 In case your sound card has a digital PCM mixer instead of an analog | |
4589 one, and you hear distortion, use the MASTER mixer instead. | |
4590 If there is an external amplifier connected to the computer (this | |
4591 is almost always the case), the noise level can be minimized by | |
4592 adjusting the master level and the volume knob on the amplifier | |
4593 until the hissing noise in the background is gone. | |
4594 .br | |
4595 This filter has a second feature: It measures the overall maximum | |
4596 sound level and prints out that level when MPlayer exits. | |
4597 This volume estimate can be used for setting the sound level in | |
4598 MEncoder such that the maximum dynamic range is utilized. | |
4599 .br | |
4600 .I NOTE: | |
4601 This filter is not reentrant and can therefore only be enabled | |
4602 once for every audio stream. | |
4603 .PD 0 | |
4604 .RSs | |
4605 .IPs "<v>\ \ " | |
4606 Sets the desired gain in dB for all channels in the stream | |
4607 from -200dB to +60dB, where -200dB mutes the sound | |
4608 completely and +60dB equals a gain of 1000 (default: 0). | |
4609 .IPs "<sc>\ " | |
4610 Turns soft clipping on (1) or off (0). | |
4611 Soft-clipping can make the sound more smooth if very | |
4612 high volume levels are used. | |
4613 Enable this option if the dynamic range of the | |
4614 loudspeakers is very low. | |
4615 .br | |
4616 .I WARNING: | |
4617 This feature creates distortion and should be considered a last resort. | |
4618 .RE | |
4619 .sp 1 | |
4620 .RS | |
4621 .I EXAMPLE: | |
4622 .RE | |
4623 .RSs | |
4624 .IPs "mplayer \-af volume=10.1:0 media.avi" | |
4625 Would amplify the sound by 10.1dB and hard-clip if the | |
4626 sound level is too high. | |
4627 .RE | |
4628 .PD 1 | |
4629 . | |
4630 .TP | |
4631 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...] | |
4632 Mixes channels arbitrarily. | |
4633 Basically a combination of the volume and the channels filter | |
4634 that can be used to down-mix many channels to only a few, | |
4635 e.g.\& stereo to mono or vary the "width" of the center | |
4636 speaker in a surround sound system. | |
4637 This filter is hard to use, and will require some tinkering | |
4638 before the desired result is obtained. | |
4639 The number of options for this filter depends on | |
4640 the number of output channels. | |
4641 An example how to downmix a six-channel file to two channels with | |
4642 this filter can be found in the examples section near the end. | |
4643 .PD 0 | |
4644 .RSs | |
4645 .IPs "<n>\ \ " | |
4646 number of output channels (1\-6) | |
4647 .IPs <Lij> | |
4648 How much of input channel i is mixed into output channel j (0\-1). | |
4649 So in principle you first have n numbers saying what to do with the | |
4650 first input channel, then n numbers that act on the second input channel | |
4651 etc. | |
4652 If you do not specify any numbers for some input channels, 0 is assumed. | |
4653 .RE | |
4654 .sp 1 | |
4655 .RS | |
4656 .I EXAMPLE: | |
4657 .RE | |
4658 .RSs | |
4659 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi" | |
4660 Would down-mix from stereo to mono. | |
4661 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi" | |
4662 Would give 3 channel output leaving channels 0 and 1 intact, | |
4663 and mix channels 0 and 1 into output channel 2 (which could | |
4664 be sent to a subwoofer for example). | |
4665 .RE | |
4666 .PD 1 | |
4667 . | |
4668 .TP | |
4669 .B sub[=fc:ch] | |
4670 Adds a subwoofer channel to the audio stream. | |
4671 The audio data used for creating the subwoofer channel is | |
4672 an average of the sound in channel 0 and channel 1. | |
4673 The resulting sound is then low-pass filtered by a 4th order | |
4674 Butterworth filter with a default cutoff frequency of 60Hz | |
4675 and added to a separate channel in the audio stream. | |
4676 .br | |
4677 .I Warning: | |
4678 Disable this filter when you are playing DVDs with Dolby | |
4679 Digital 5.1 sound, otherwise this filter will disrupt | |
4680 the sound to the subwoofer. | |
4681 .PD 0 | |
4682 .RSs | |
4683 .IPs "<fc>\ " | |
4684 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz) | |
4685 For the best result try setting the cutoff frequency as low as possible. | |
4686 This will improve the stereo or surround sound experience. | |
4687 .IPs "<ch>\ " | |
4688 Determines the channel number in which to insert the sub-channel audio. | |
4689 Channel number can be between 0 and 5 (default: 5). | |
4690 Observe that the number of channels will automatically | |
4691 be increased to <ch> if necessary. | |
4692 .RE | |
4693 .sp 1 | |
4694 .RS | |
4695 .I EXAMPLE: | |
4696 .RE | |
4697 .RSs | |
4698 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi" | |
4699 Would add a sub-woofer channel with a cutoff frequency of | |
4700 100Hz to output channel 4. | |
4701 .RE | |
4702 .PD 1 | |
4703 . | |
4704 .TP | |
4705 .B "center\ " | |
4706 Creates a center channel from the front channels. | |
4707 May currently be low quality as it does not implement a | |
4708 high-pass filter for proper extraction yet, but averages and | |
4709 halves the channels instead. | |
4710 .PD 0 | |
4711 .RSs | |
4712 .IPs "<ch>\ " | |
4713 Determines the channel number in which to insert the center channel. | |
4714 Channel number can be between 0 and 5 (default: 5). | |
4715 Observe that the number of channels will automatically | |
4716 be increased to <ch> if necessary. | |
4717 .RE | |
4718 .PD 1 | |
4719 . | |
4720 .TP | |
4721 .B surround[=delay] | |
4722 Decoder for matrix encoded surround sound like Dolby Surround. | |
4723 Many files with 2 channel audio actually contain matrixed surround sound. | |
4724 Requires a sound card supporting at least 4 channels. | |
4725 .PD 0 | |
4726 .RSs | |
4727 .IPs <delay> | |
4728 delay time in ms for the rear speakers (0 to 1000) (default: 20) | |
4729 This delay should be set as follows: If d1 is the distance | |
4730 from the listening position to the front speakers and d2 is the distance | |
4731 from the listening position to the rear speakers, then the delay should | |
4732 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2. | |
4733 .RE | |
4734 .sp 1 | |
4735 .RS | |
4736 .I EXAMPLE: | |
4737 .RE | |
4738 .RSs | |
4739 .IPs "mplayer \-af surround=15 \-channels 4 media.avi" | |
4740 Would add surround sound decoding with 15ms delay for the sound to the | |
4741 rear speakers. | |
4742 .RE | |
4743 .PD 1 | |
4744 . | |
4745 .TP | |
4746 .B delay[=ch1:ch2:...] | |
4747 Delays the sound to the loudspeakers such that the sound from the | |
4748 different channels arrives at the listening position simultaneously. | |
4749 It is only useful if you have more than 2 loudspeakers. | |
4750 .PD 0 | |
4751 .RSs | |
4752 .IPs ch1,ch2,... | |
4753 The delay in ms that should be imposed on each channel | |
4754 (floating point number between 0 and 1000). | |
4755 .RE | |
4756 .PD 1 | |
4757 .sp 1 | |
4758 .RS | |
4759 To calculate the required delay for the different channels do as follows: | |
4760 .IP 1. 3 | |
4761 Measure the distance to the loudspeakers in meters in relation | |
4762 to your listening position, giving you the distances s1 to s5 | |
4763 (for a 5.1 system). | |
4764 There is no point in compensating for the subwoofer (you will not hear the | |
4765 difference anyway). | |
4766 .IP 2. 3 | |
4767 Subtract the distances s1 to s5 from the maximum distance, | |
4768 i.e.\& s[i] = max(s) - s[i]; i = 1...5. | |
4769 .IP 3. | |
4770 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5. | |
4771 .RE | |
4772 .PD 0 | |
4773 .sp 1 | |
4774 .RS | |
4775 .I EXAMPLE: | |
4776 .RE | |
4777 .RSs | |
4778 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi" | |
4779 Would delay front left and right by 10.5ms, the two rear channels | |
4780 and the sub by 0ms and the center channel by 7ms. | |
4781 .RE | |
4782 .PD 1 | |
4783 . | |
4784 .TP | |
4785 .B export[=mmapped_file[:nsamples]] | |
4786 Exports the incoming signal to other processes using memory mapping (mmap()). | |
4787 Memory mapped areas contain a header: | |
4788 .sp 1 | |
4789 .nf | |
4790 int nch /*number of channels*/ | |
4791 int size /*buffer size*/ | |
4792 unsigned long long counter /*Used to keep sync, updated every | |
4793 time new data is exported.*/ | |
4794 .fi | |
4795 .sp 1 | |
4796 The rest is payload (non-interleaved) 16 bit data. | |
4797 .PD 0 | |
4798 .RSs | |
4799 .IPs <mmapped_file> | |
4800 file to map data to (default: ~/.mplayer/\:mplayer-af_export) | |
4801 .IPs <nsamples> | |
4802 number of samples per channel (default: 512) | |
4803 .RE | |
4804 .sp 1 | |
4805 .RS | |
4806 .I EXAMPLE: | |
4807 .RE | |
4808 .RSs | |
4809 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi" | |
4810 Would export 1024 samples per channel to '/tmp/mplayer-af_export'. | |
4811 .RE | |
4812 .PD 1 | |
4813 . | |
4814 .TP | |
4815 .B extrastereo[=mul] | |
4816 (Linearly) increases the difference between left and right channels | |
4817 which adds some sort of "live" effect to playback. | |
4818 .PD 0 | |
4819 .RSs | |
4820 .IPs <mul> | |
4821 Sets the difference coefficient (default: 2.5). | |
4822 0.0 means mono sound (average of both channels), with 1.0 sound will be | |
4823 unchanged, with -1.0 left and right channels will be swapped. | |
4824 .RE | |
4825 .PD 1 | |
4826 . | |
4827 .TP | |
4828 .B volnorm[=method:target] | |
4829 Maximizes the volume without distorting the sound. | |
4830 .PD 0 | |
4831 .RSs | |
4832 .IPs <method> | |
4833 Sets the used method. | |
4834 .RSss | |
4835 1: Use a single sample to smooth the variations via the standard | |
4836 weighted mean over past samples (default). | |
4837 .br | |
4838 2: Use several samples to smooth the variations via the standard | |
4839 weighted mean over past samples. | |
4840 .REss | |
4841 .IPs <target> | |
4842 Sets the target amplitude as a fraction of the maximum for the | |
4843 sample type (default: 0.25). | |
4844 .RE | |
4845 .PD 1 | |
4846 . | |
4847 .TP | |
4848 .B ladspa=file:label[:controls...] | |
4849 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin. | |
4850 This filter is reentrant, so multiple LADSPA plugins can be used at once. | |
4851 .PD 0 | |
4852 .RSs | |
4853 .IPs <file> | |
4854 Specifies the LADSPA plugin library file. | |
4855 If LADSPA_PATH is set, it searches for the specified file. | |
4856 If it is not set, you must supply a fully specified pathname. | |
4857 .IPs <label> | |
4858 Specifies the filter within the library. | |
4859 Some libraries contain only one filter, but others contain many of them. | |
4860 Entering 'help' here, will list all available filters within the specified | |
4861 library, which eliminates the use of 'listplugins' from the LADSPA SDK. | |
4862 .IPs <controls> | |
4863 Controls are zero or more floating point values that determine the | |
4864 behavior of the loaded plugin (for example delay, threshold or gain). | |
4865 In verbose mode (add \-v to the MPlayer command line), all available controls | |
4866 and their valid ranges are printed. | |
4867 This eliminates the use of 'analyseplugin' from the LADSPA SDK. | |
4868 .RE | |
4869 .PD 1 | |
4870 . | |
4871 .TP | |
4872 .B "comp\ \ \ " | |
4873 Compressor/expander filter usable for microphone input. | |
4874 Prevents artifacts on very loud sound and raises the volume on | |
4875 very low sound. | |
4876 This filter is untested, maybe even unusable. | |
4877 . | |
4878 .TP | |
4879 .B "gate\ \ \ " | |
4880 Noise gate filter similar to the comp audio filter. | |
4881 This filter is untested, maybe even unusable. | |
4882 . | |
4883 .TP | |
4884 .B karaoke | |
4885 Simple voice removal filter exploiting the fact that voice is | |
4886 usually recorded with mono gear and later 'center' mixed onto | |
4887 the final audio stream. | |
4888 Beware that this filter will turn your signal into mono. | |
4889 Works well for 2 channel tracks; do not bother trying it | |
4890 on anything but 2 channel stereo. | |
4891 . | |
4892 . | |
4893 . | |
4894 .SH "VIDEO FILTERS" | |
4895 Video filters allow you to modify the video stream and its properties. | |
4896 The syntax is: | |
4897 . | |
4898 .TP | |
4899 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...> | |
4900 Setup a chain of video filters. | |
4901 . | |
4902 .TP | |
4903 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE) | |
4904 Setup a chain of video filters, to be applied in | |
4905 .B reverse | |
4906 order. | |
4907 Deprecated in favor of \-vf. | |
4908 .PP | |
4909 Many parameters are optional and set to default values if omitted. | |
4910 To explicitly use a default value set a parameter to '-1'. | |
4911 Parameters w:h means width x height in pixels, x:y means x;y position counted | |
4912 from the upper left corner of the bigger image. | |
4913 .br | |
4914 .I NOTE: | |
4915 To get a full list of available video filters, see \-vf help. | |
4916 .sp 1 | |
4917 Video filters are managed in lists. | |
4918 There are a few commands to manage the filter list. | |
4919 . | |
4920 .TP | |
4921 .B \-vf-add <filter1[,filter2,...]> | |
4922 Appends the filters given as arguments to the filter list. | |
4923 . | |
4924 .TP | |
4925 .B \-vf-pre <filter1[,filter2,...]> | |
4926 Prepends the filters given as arguments to the filter list. | |
4927 . | |
4928 .TP | |
4929 .B \-vf-del <index1[,index2,...]> | |
4930 Deletes the filters at the given indexes. | |
4931 Index numbers start at 0, negative numbers address the end of the | |
4932 list (-1 is the last). | |
4933 . | |
4934 .TP | |
4935 .B \-vf-clr | |
4936 Completely empties the filter list. | |
4937 .PP | |
4938 With filters that support it, you can access parameters by their name. | |
4939 . | |
4940 .TP | |
4941 .B \-vf <filter>=help | |
4942 Prints the parameter names and parameter value ranges for a particular | |
4943 filter. | |
4944 . | |
4945 .TP | |
4946 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]> | |
4947 Sets a named parameter to the given value. | |
4948 Use on and off or yes and no to set flag parameters. | |
4949 .PP | |
4950 Available filters are: | |
4951 . | |
4952 .TP | |
4953 .B crop[=w:h:x:y] | |
4954 Crops the given part of the image and discards the rest. | |
4955 Useful to remove black bands from widescreen movies. | |
4956 .PD 0 | |
4957 .RSs | |
4958 .IPs <w>,<h> | |
4959 Cropped width and height, defaults to original width and height. | |
4960 .IPs <x>,<y> | |
4961 Position of the cropped picture, defaults to center. | |
4962 .RE | |
4963 .PD 1 | |
4964 . | |
4965 .TP | |
4966 .B cropdetect[=limit:round] | |
4967 Calculates necessary cropping parameters and prints the recommended parameters | |
4968 to stdout. | |
4969 .PD 0 | |
4970 .RSs | |
4971 .IPs <limit> | |
4972 Threshold, which can be optionally specified from nothing (0) to | |
4973 everything (255) (default: 24). | |
4974 .br | |
4975 .IPs <round> | |
4976 Value which the width/\:height should be divisible by (default: 16). | |
4977 The offset is automatically adjusted to center the video. | |
4978 Use 2 to get only even dimensions (needed for 4:2:2 video). | |
4979 16 is best when encoding to most video codecs. | |
4980 .RE | |
4981 .PD 1 | |
4982 . | |
4983 .TP | |
4984 .B rectangle[=w:h:x:y] | |
4985 The plugin responds to the input.conf directive 'change_rectangle' | |
4986 that takes two parameters. | |
4987 .PD 0 | |
4988 .RSs | |
4989 .IPs <w>,<h> | |
4990 width and height (default: -1, maximum possible width where boundaries | |
4991 are still visible.) | |
4992 .IPs <x>,<y> | |
4993 top left corner position (default: -1, uppermost leftmost) | |
4994 .RE | |
4995 .PD 1 | |
4996 . | |
4997 .TP | |
4998 .B expand[=w:h:x:y:o:a:r] | |
4999 Expands (not scales) movie resolution to the given value and places the | |
5000 unscaled original at coordinates x, y. | |
5001 Can be used for placing subtitles/\:OSD in the resulting black bands. | |
5002 .RSs | |
5003 .IPs <w>,<h> | |
5004 Expanded width,height (default: original width,height). | |
5005 Negative values for w and h are treated as offsets to the original size. | |
5006 .sp 1 | |
5007 .I EXAMPLE: | |
5008 .PD 0 | |
5009 .RSs | |
5010 .IP expand=0:-50:0:0 | |
5011 Adds a 50 pixel border to the bottom of the picture. | |
5012 .RE | |
5013 .PD 1 | |
5014 .IPs <x>,<y> | |
5015 position of original image on the expanded image (default: center) | |
5016 .IPs "<o>\ \ " | |
5017 OSD/\:subtitle rendering | |
5018 .RSss | |
5019 0: disable (default) | |
5020 .br | |
5021 1: enable | |
5022 .REss | |
5023 .IPs "<a>\ \ " | |
5024 Expands to fit an aspect instead of a resolution (default: 0). | |
5025 .sp 1 | |
5026 .I EXAMPLE: | |
5027 .PD 0 | |
5028 .RSs | |
20913 | 5029 .IP expand=800:::::4/3 |
20707 | 5030 Expands to 800x600, unless the source is higher resolution, in which |
5031 case it expands to fill a 4/3 aspect. | |
5032 .RE | |
5033 .PD 1 | |
5034 .IPs "<r>\ \ " | |
5035 Rounds up to make both width and height divisible by <r> (default: 1). | |
5036 .RE | |
5037 . | |
5038 .TP | |
5039 .B flip (also see \-flip) | |
5040 Flips the image upside down. | |
5041 . | |
5042 .TP | |
5043 .B "mirror\ " | |
5044 Mirrors the image on the Y axis. | |
5045 . | |
5046 .TP | |
5047 .B rotate[=<0\-7>] | |
5048 Rotates the image by 90 degrees and optionally flips it. | |
5049 For values between 4\-7 rotation is only done if the movie geometry is | |
5050 portrait and not landscape. | |
5051 .RSs | |
5052 .IPs 0 | |
5053 Rotate by 90 degrees clockwise and flip (default). | |
5054 .IPs 1 | |
5055 Rotate by 90 degrees clockwise. | |
5056 .IPs 2 | |
5057 Rotate by 90 degrees counterclockwise. | |
5058 .IPs 3 | |
5059 Rotate by 90 degrees counterclockwise and flip. | |
5060 .RE | |
5061 . | |
5062 .TP | |
5063 .B scale[=w:h[:ilaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]] | |
5064 Scales the image with the software scaler (slow) and performs a YUV<\->RGB | |
5065 colorspace conversion (also see \-sws). | |
5066 .RSs | |
5067 .IPs <w>,<h> | |
5068 scaled width/\:height (default: original width/\:height) | |
5069 .br | |
5070 .I NOTE: | |
5071 If \-zoom is used, and underlying filters (including libvo) are | |
5072 incapable of scaling, it defaults to d_width/\:d_height! | |
5073 .RSss | |
5074 0: scaled d_width/\:d_height | |
5075 .br | |
5076 -1: original width/\:height | |
5077 .br | |
5078 -2: Calculate w/h using the other dimension and the prescaled aspect ratio. | |
5079 .br | |
5080 -3: Calculate w/h using the other dimension and the original aspect ratio. | |
5081 .br | |
5082 -(n+8): Like -n above, but rounding the dimension to the closest multiple of 16. | |
5083 .REss | |
5084 .IPs <ilaced> | |
5085 Toggle interlaced scaling. | |
5086 .RSss | |
5087 0: off (default) | |
5088 .br | |
5089 1: on | |
5090 .REss | |
5091 .IPs <chr_drop> | |
5092 chroma skipping | |
5093 .RSss | |
5094 0: Use all available input lines for chroma. | |
5095 .br | |
5096 1: Use only every 2. input line for chroma. | |
5097 .br | |
5098 2: Use only every 4. input line for chroma. | |
5099 .br | |
5100 3: Use only every 8. input line for chroma. | |
5101 .REss | |
5102 .IPs "<par>[:<par2>] (also see \-sws)" | |
5103 Set some scaling parameters depending on the type of scaler selected | |
5104 with \-sws. | |
5105 .RSss | |
5106 \-sws 2 (bicubic): B (blurring) and C (ringing) | |
5107 .br | |
5108 0.00:0.60 default | |
5109 .br | |
5110 0.00:0.75 VirtualDub's "precise bicubic" | |
5111 .br | |
5112 0.00:0.50 Catmull-Rom spline | |
5113 .br | |
5114 0.33:0.33 Mitchell-Netravali spline | |
5115 .br | |
5116 1.00:0.00 cubic B-spline | |
5117 .br | |
5118 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp)) | |
5119 .br | |
5120 \-sws 9 (lanczos): filter length (1\-10) | |
5121 .REss | |
5122 .IPs <presize> | |
5123 Scale to preset sizes. | |
5124 .RSss | |
5125 qntsc: 352x240 (NTSC quarter screen) | |
5126 .br | |
5127 qpal: 352x288 (PAL quarter screen) | |
5128 .br | |
5129 ntsc: 720x480 (standard NTSC) | |
5130 .br | |
5131 pal: 720x576 (standard PAL) | |
5132 .br | |
5133 sntsc: 640x480 (square pixel NTSC) | |
5134 .br | |
5135 spal: 768x576 (square pixel PAL) | |
5136 .REss | |
5137 .IPs <noup> | |
5138 Disallow upscaling past the original dimensions. | |
5139 .RSss | |
5140 0: Allow upscaling (default). | |
5141 .br | |
5142 1: Disallow upscaling if one dimension exceeds its original value. | |
5143 .br | |
5144 2: Disallow upscaling if both dimensions exceed their original values. | |
5145 .REss | |
5146 .IPs <arnd> | |
5147 Accurate rounding for the vertical scaler, which may be faster | |
5148 or slower than the default rounding. | |
5149 .RSss | |
5150 0: Disable accurate rounding (default). | |
5151 .br | |
5152 1: Enable accurate rounding. | |
5153 .REss | |
5154 .RE | |
5155 . | |
5156 .TP | |
5157 .B dsize[=aspect|w:h:aspect-method:r] | |
5158 Changes the intended display size/\:aspect at an arbitrary point in the | |
5159 filter chain. | |
5160 Aspect can be given as a fraction (4/3) or floating point number | |
5161 (1.33). | |
5162 Alternatively, you may specify the exact display width and height | |
5163 desired. | |
5164 Note that this filter does | |
5165 .B not | |
5166 do any scaling itself; it just affects | |
5167 what later scalers (software or hardware) will do when auto-scaling to | |
5168 correct aspect. | |
5169 .RSs | |
5170 .IPs <w>,<h> | |
5171 New display width and height. | |
5172 Can also be these special values: | |
5173 .RSss | |
5174 0: original display width and height | |
5175 .br | |
5176 -1: original video width and height (default) | |
5177 .br | |
5178 -2: Calculate w/h using the other dimension and the original display | |
5179 aspect ratio. | |
5180 .br | |
5181 -3: Calculate w/h using the other dimension and the original video | |
5182 aspect ratio. | |
5183 .REss | |
5184 .sp 1 | |
5185 .I EXAMPLE: | |
5186 .PD 0 | |
5187 .RSs | |
5188 .IP dsize=800:-2 | |
5189 Specifies a display resolution of 800x600 for a 4/3 aspect video, or | |
5190 800x450 for a 16/9 aspect video. | |
5191 .RE | |
5192 .IPs <aspect-method> | |
5193 Modifies width and height according to original aspect ratios. | |
5194 .RSss | |
5195 -1: Ignore original aspect ratio (default). | |
5196 .br | |
5197 0: Keep display aspect ratio by using <w> and <h> as maximum | |
5198 resolution. | |
5199 .br | |
5200 1: Keep display aspect ratio by using <w> and <h> as minimum | |
5201 resolution. | |
5202 .br | |
5203 2: Keep video aspect ratio by using <w> and <h> as maximum | |
5204 resolution. | |
5205 .br | |
5206 3: Keep video aspect ratio by using <w> and <h> as minimum | |
5207 resolution. | |
5208 .REss | |
5209 .sp 1 | |
5210 .I EXAMPLE: | |
5211 .PD 0 | |
5212 .RSs | |
5213 .IP dsize=800:600:0 | |
5214 Specifies a display resolution of at most 800x600, or smaller, in order | |
5215 to keep aspect. | |
5216 .RE | |
5217 .PD 1 | |
5218 .IPs "<r>\ \ " | |
5219 Rounds up to make both width and height divisible by <r> (default: 1). | |
5220 .RE | |
5221 . | |
5222 .TP | |
5223 .B "yuy2\ \ \ " | |
5224 Forces software YV12/\:I420/\:422P to YUY2 conversion. | |
5225 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support. | |
5226 . | |
5227 .TP | |
5228 .B "yvu9\ \ \ " | |
5229 Forces software YVU9 to YV12 colorspace conversion. | |
5230 Deprecated in favor of the software scaler. | |
5231 . | |
5232 .TP | |
5233 .B "yuvcsp\ " | |
5234 Clamps YUV color values to the CCIR 601 range without doing real conversion. | |
5235 . | |
5236 .TP | |
5237 .B rgb2bgr[=swap] | |
5238 RGB 24/32 <\-> BGR 24/32 colorspace conversion. | |
5239 .PD 0 | |
5240 .RSs | |
5241 .IPs "swap\ " | |
5242 Also perform R <-> B swapping. | |
5243 .RE | |
5244 .PD 1 | |
5245 . | |
5246 .TP | |
5247 .B palette | |
5248 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette. | |
5249 . | |
5250 .TP | |
5251 .B format[=fourcc] | |
5252 Restricts the colorspace for the next filter without doing any conversion. | |
5253 Use together with the scale filter for a real conversion. | |
5254 .br | |
5255 .I NOTE: | |
5256 For a list of available formats see format=fmt=help. | |
5257 .PD 0 | |
5258 .RSs | |
5259 .IPs <fourcc> | |
5260 format name like rgb15, bgr24, yv12, etc (default: yuy2) | |
5261 .RE | |
5262 .PD 1 | |
5263 . | |
5264 .TP | |
5265 .B noformat[=fourcc] | |
5266 Restricts the colorspace for the next filter without doing any conversion. | |
5267 Unlike the format filter, this will allow any colorspace | |
5268 .B except | |
5269 the one you specify. | |
5270 .br | |
5271 .I NOTE: | |
5272 For a list of available formats see noformat=fmt=help. | |
5273 .PD 0 | |
5274 .RSs | |
5275 .IPs <fourcc> | |
5276 format name like rgb15, bgr24, yv12, etc (default: yv12) | |
5277 .RE | |
5278 .PD 1 | |
5279 . | |
5280 .TP | |
5281 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (also see \-pphelp) | |
5282 Enables the specified chain of postprocessing subfilters. | |
5283 Subfilters must be separated by '/' and can be disabled by | |
5284 prepending a '\-'. | |
5285 Each subfilter and some options have a short and a long name that can be | |
5286 used interchangeably, i.e.\& dr/dering are the same. | |
5287 All subfilters share common options to determine their scope: | |
5288 .PD 0 | |
5289 .RSs | |
5290 .IPs a/autoq | |
5291 Automatically switch the subfilter off if the CPU is too slow. | |
5292 .IPs c/chrom | |
5293 Do chrominance filtering, too (default). | |
5294 .IPs y/nochrom | |
5295 Do luminance filtering only (no chrominance). | |
5296 .IPs n/noluma | |
5297 Do chrominance filtering only (no luminance). | |
5298 .RE | |
5299 .PD 1 | |
5300 .sp 1 | |
5301 .RS | |
5302 .br | |
5303 .I NOTE: | |
5304 \-pphelp shows a list of available subfilters. | |
5305 .sp 1 | |
5306 Available subfilters are | |
5307 .RE | |
5308 .RSs | |
5309 .IPs hb/hdeblock[:difference[:flatness]] | |
5310 horizontal deblocking filter | |
5311 .RSss | |
5312 <difference>: Difference factor where higher values mean | |
5313 more deblocking (default: 32). | |
5314 .br | |
5315 <flatness>: Flatness threshold where lower values mean | |
5316 more deblocking (default: 39). | |
5317 .REss | |
5318 .IPs vb/vdeblock[:difference[:flatness]] | |
5319 vertical deblocking filter | |
5320 .RSss | |
5321 <difference>: Difference factor where higher values mean | |
5322 more deblocking (default: 32). | |
5323 .br | |
5324 <flatness>: Flatness threshold where lower values mean | |
5325 more deblocking (default: 39). | |
5326 .REss | |
5327 .IPs ha/hadeblock[:difference[:flatness]] | |
5328 accurate horizontal deblocking filter | |
5329 .RSss | |
5330 <difference>: Difference factor where higher values mean | |
5331 more deblocking (default: 32). | |
5332 .br | |
5333 <flatness>: Flatness threshold where lower values mean | |
5334 more deblocking (default: 39). | |
5335 .REss | |
5336 .IPs va/vadeblock[:difference[:flatness]] | |
5337 accurate vertical deblocking filter | |
5338 .RSss | |
5339 <difference>: Difference factor where higher values mean | |
5340 more deblocking (default: 32). | |
5341 .br | |
5342 <flatness>: Flatness threshold where lower values mean | |
5343 more deblocking (default: 39). | |
5344 .REss | |
5345 .sp 1 | |
5346 The horizontal and vertical deblocking filters share the | |
5347 difference and flatness values so you cannot set | |
5348 different horizontal and vertical thresholds. | |
5349 .sp 1 | |
5350 .IPs h1/x1hdeblock | |
5351 experimental horizontal deblocking filter | |
5352 .IPs v1/x1vdeblock | |
5353 experimental vertical deblocking filter | |
5354 .IPs dr/dering | |
5355 deringing filter | |
5356 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]] | |
5357 temporal noise reducer | |
5358 .RSss | |
5359 <threshold1>: larger -> stronger filtering | |
5360 .br | |
5361 <threshold2>: larger -> stronger filtering | |
5362 .br | |
5363 <threshold3>: larger -> stronger filtering | |
5364 .REss | |
5365 .IPs al/autolevels[:f/fullyrange] | |
5366 automatic brightness / contrast correction | |
5367 .RSss | |
5368 f/fullyrange: Stretch luminance to (0\-255). | |
5369 .REss | |
5370 .IPs lb/linblenddeint | |
5371 Linear blend deinterlacing filter that deinterlaces the given block | |
5372 by filtering all lines with a (1 2 1) filter. | |
5373 .IPs li/linipoldeint | |
5374 Linear interpolating deinterlacing filter that deinterlaces the given block | |
5375 by linearly interpolating every second line. | |
5376 .IPs ci/cubicipoldeint | |
5377 Cubic interpolating deinterlacing filter deinterlaces the given block | |
5378 by cubically interpolating every second line. | |
5379 .IPs md/mediandeint | |
5380 Median deinterlacing filter that deinterlaces the given block | |
5381 by applying a median filter to every second line. | |
5382 .IPs fd/ffmpegdeint | |
5383 FFmpeg deinterlacing filter that deinterlaces the given block | |
5384 by filtering every second line with a (-1 4 2 4 -1) filter. | |
5385 .IPs l5/lowpass5 | |
5386 Vertically applied FIR lowpass deinterlacing filter that deinterlaces | |
5387 the given block by filtering all lines with a (-1 2 6 2 -1) filter. | |
5388 .IPs fq/forceQuant[:quantizer] | |
5389 Overrides the quantizer table from the input with the constant | |
5390 quantizer you specify. | |
5391 .RSss | |
5392 <quantizer>: quantizer to use | |
5393 .REss | |
5394 .IPs de/default | |
5395 default pp filter combination (hb:a,vb:a,dr:a) | |
5396 .IPs fa/fast | |
5397 fast pp filter combination (h1:a,v1:a,dr:a) | |
5398 .IPs "ac\ \ \ " | |
5399 high quality pp filter combination (ha:a:128:7,va:a,dr:a) | |
5400 .RE | |
5401 .RS | |
5402 .sp 1 | |
5403 .I EXAMPLE: | |
5404 .RE | |
5405 .PD 0 | |
5406 .RSs | |
5407 .IPs "\-vf pp=hb/vb/dr/al" | |
5408 horizontal and vertical deblocking, deringing and automatic | |
5409 brightness/\:contrast | |
5410 .IPs "\-vf pp=de/-al" | |
5411 default filters without brightness/\:contrast correction | |
5412 .IPs "\-vf pp=default/tmpnoise:1:2:3" | |
5413 Enable default filters & temporal denoiser. | |
5414 .IPs "\-vf pp=hb:y/vb:a" | |
5415 Horizontal deblocking on luminance only, and switch vertical deblocking | |
5416 on or off automatically depending on available CPU time. | |
5417 .RE | |
5418 .PD 1 | |
5419 . | |
5420 .TP | |
5421 .B spp[=quality[:qp[:mode]]] | |
5422 Simple postprocessing filter that compresses and decompresses the | |
5423 image at several (or \- in the case of quality level 6 \- all) | |
5424 shifts and averages the results. | |
5425 .RSs | |
5426 .IPs <quality> | |
5427 0\-6 (default: 3) | |
5428 .IPs "<qp>\ " | |
5429 Force quantization parameter (default: 0, use QP from video). | |
5430 .IPs <mode> | |
5431 0: hard thresholding (default) | |
5432 .br | |
5433 1: soft thresholding (better deringing, but blurrier) | |
5434 .br | |
5435 4: like 0, but also use B-frames' QP (may cause flicker) | |
5436 .br | |
5437 5: like 1, but also use B-frames' QP (may cause flicker) | |
5438 .RE | |
5439 . | |
5440 .TP | |
5441 .B uspp[=quality[:qp]] | |
5442 Ultra simple & slow postprocessing filter that compresses and | |
5443 decompresses the image at several (or \- in the case of quality | |
5444 level 8 \- all) shifts and averages the results. | |
5445 The way this differs from the behavior of spp is that uspp actually | |
5446 encodes & decodes each case with libavcodec Snow, whereas spp uses | |
5447 a simplified intra only 8x8 DCT similar to MJPEG. | |
5448 .RSs | |
5449 .IPs <quality> | |
5450 0\-8 (default: 3) | |
5451 .IPs "<qp>\ " | |
5452 Force quantization parameter (default: 0, use QP from video). | |
5453 .RE | |
5454 . | |
5455 .TP | |
5456 .B fspp[=quality[:qp[:strength[:bframes]]]] | |
5457 faster version of the simple postprocessing filter | |
5458 .RSs | |
5459 .IPs <quality> | |
5460 4\-5 (equivalent to spp; default: 4) | |
5461 .IPs "<qp>\ " | |
5462 Force quantization parameter (default: 0, use QP from video). | |
5463 .IPs <-15\-32> | |
5464 Filter strength, lower values mean more details but also more artifacts, | |
5465 while higher values make the image smoother but also blurrier (default: | |
5466 0 \- PSNR optimal). | |
5467 .IPs <bframes> | |
5468 0: do not use QP from B-frames (default) | |
5469 .br | |
5470 1: use QP from B-frames too (may cause flicker) | |
5471 .RE | |
5472 . | |
5473 .TP | |
5474 .B pp7[=qp[:mode]] | |
5475 Variant of the spp filter, similar to spp=6 with 7 point DCT where | |
5476 only the center sample is used after IDCT. | |
5477 .RSs | |
5478 .IPs <qp> | |
5479 Force quantization parameter (default: 0, use QP from video). | |
5480 .IPs <mode> | |
5481 0: hard thresholding | |
5482 .br | |
5483 1: soft thresholding (better deringing, but blurrier) | |
5484 .br | |
5485 2: medium thresholding (default, good results) | |
5486 .RE | |
5487 . | |
5488 .TP | |
5489 .B qp=equation | |
5490 quantization parameter (QP) change filter | |
5491 .RSs | |
5492 .IPs <equation> | |
5493 some equation like "2+2*sin(PI*qp)" | |
5494 .RE | |
5495 . | |
5496 .TP | |
5497 .B "test\ \ \ " | |
5498 Generate various test patterns. | |
5499 . | |
5500 .TP | |
5501 .B rgbtest | |
5502 Generate an RGB test pattern useful for detecting RGB vs BGR issues. | |
5503 You should see a red, green and blue stripe from top to bottom. | |
5504 . | |
5505 .TP | |
5506 .B lavc[=quality:fps] | |
5507 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV. | |
5508 .RSs | |
5509 .IPs <quality> | |
5510 .RSss | |
5511 1\-31: fixed qscale | |
5512 .br | |
5513 32\-: fixed bitrate in kbits | |
5514 .REss | |
5515 .IPs <fps> | |
5516 force output fps (float value) (default: 0, autodetect based on height) | |
5517 .RE | |
5518 . | |
5519 .TP | |
5520 .B dvbscale[=aspect] | |
5521 Set up optimal scaling for DVB cards, scaling the x axis in hardware and | |
5522 calculating the y axis scaling in software to keep aspect. | |
5523 Only useful together with expand and scale. | |
5524 .RSs | |
5525 .IPs <aspect> | |
5526 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default: | |
5527 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV. | |
5528 .RE | |
5529 .sp 1 | |
5530 .RS | |
5531 .I EXAMPLE: | |
5532 .RE | |
5533 .PD 0 | |
5534 .RSs | |
5535 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc" | |
5536 FIXME: Explain what this does. | |
5537 .RE | |
5538 .PD 1 | |
5539 . | |
5540 .TP | |
5541 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]] | |
5542 Adds noise. | |
5543 .PD 0 | |
5544 .RSs | |
5545 .IPs <0\-100> | |
5546 luma noise | |
5547 .IPs <0\-100> | |
5548 chroma noise | |
5549 .IPs u | |
5550 uniform noise (gaussian otherwise) | |
5551 .IPs t | |
5552 temporal noise (noise pattern changes between frames) | |
5553 .IPs a | |
5554 averaged temporal noise (smoother, but a lot slower) | |
5555 .IPs h | |
5556 high quality (slightly better looking, slightly slower) | |
5557 .IPs p | |
5558 mix random noise with a (semi)regular pattern | |
5559 .RE | |
5560 .PD 1 | |
5561 . | |
5562 .TP | |
5563 .B denoise3d[=luma:chroma:time] | |
5564 This filter aims to reduce image noise producing smooth images and making still | |
5565 images really still (This should enhance compressibility.). | |
5566 .PD 0 | |
5567 .RSs | |
5568 .IPs <luma> | |
5569 spatial luma strength (default: 4) | |
5570 .IPs <chroma> | |
5571 spatial chroma strength (default: 3) | |
5572 .IPs <time> | |
5573 temporal strength (default: 6) | |
5574 .RE | |
5575 .PD 1 | |
5576 . | |
5577 .TP | |
5578 .B hqdn3d[=luma:chroma:time] | |
5579 High precision/\:quality version of the denoise3d filter. | |
5580 Parameters and usage are the same. | |
5581 . | |
5582 .TP | |
5583 .B eq[=brightness:contrast] (OBSOLETE) | |
5584 Software equalizer with interactive controls just like the hardware | |
5585 equalizer, for cards/\:drivers that do not support brightness and | |
5586 contrast controls in hardware. | |
5587 Might also be useful with MEncoder, either for fixing poorly captured | |
5588 movies, or for slightly reducing contrast to mask artifacts and get by | |
5589 with lower bitrates. | |
5590 .PD 0 | |
5591 .RSs | |
5592 .IPs <-100\-100> | |
5593 initial brightness | |
5594 .IPs <-100\-100> | |
5595 initial contrast | |
5596 .RE | |
5597 .PD 1 | |
5598 . | |
5599 .TP | |
5600 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight] | |
5601 Alternative software equalizer that uses lookup tables (very slow), | |
5602 allowing gamma correction in addition to simple brightness | |
5603 and contrast adjustment. | |
5604 Note that it uses the same MMX optimized code as \-vf eq if all | |
5605 gamma values are 1.0. | |
5606 The parameters are given as floating point values. | |
5607 .PD 0 | |
5608 .RSs | |
5609 .IPs <0.1\-10> | |
5610 initial gamma value (default: 1.0) | |
5611 .IPs <-2\-2> | |
5612 initial contrast, where negative values result in a | |
5613 negative image (default: 1.0) | |
5614 .IPs <-1\-1> | |
5615 initial brightness (default: 0.0) | |
5616 .IPs <0\-3> | |
5617 initial saturation (default: 1.0) | |
5618 .IPs <0.1\-10> | |
5619 gamma value for the red component (default: 1.0) | |
5620 .IPs <0.1\-10> | |
5621 gamma value for the green component (default: 1.0) | |
5622 .IPs <0.1\-10> | |
5623 gamma value for the blue component (default: 1.0) | |
5624 .IPs <0\-1> | |
5625 The weight parameter can be used to reduce the effect of a high gamma value on | |
5626 bright image areas, e.g.\& keep them from getting overamplified and just plain | |
5627 white. | |
5628 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it | |
5629 at its full strength (default: 1.0). | |
5630 .RE | |
5631 .PD 1 | |
5632 . | |
5633 .TP | |
5634 .B hue[=hue:saturation] | |
5635 Software equalizer with interactive controls just like the hardware | |
5636 equalizer, for cards/\:drivers that do not support hue and | |
5637 saturation controls in hardware. | |
5638 .PD 0 | |
5639 .RSs | |
5640 .IPs <-180\-180> | |
5641 initial hue (default: 0.0) | |
5642 .IPs <-100\-100> | |
5643 initial saturation, where negative values result | |
5644 in a negative chroma (default: 1.0) | |
5645 .RE | |
5646 .PD 1 | |
5647 . | |
5648 .TP | |
5649 .B halfpack[=f] | |
5650 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but | |
5651 keeping all chroma samples. | |
5652 Useful for output to low-resolution display devices when hardware downscaling | |
5653 is poor quality or is not available. | |
5654 Can also be used as a primitive luma-only deinterlacer with very low CPU | |
5655 usage. | |
5656 .PD 0 | |
5657 .RSs | |
5658 .IPs "<f>\ \ " | |
5659 By default, halfpack averages pairs of lines when downsampling. | |
5660 Any value different from 0 or 1 gives the default (averaging) behavior. | |
5661 .RSss | |
5662 0: Only use even lines when downsampling. | |
5663 .br | |
5664 1: Only use odd lines when downsampling. | |
5665 .REss | |
5666 .RE | |
5667 .PD 1 | |
5668 . | |
5669 .TP | |
5670 .B ilpack[=mode] | |
5671 When interlaced video is stored in YUV 4:2:0 formats, chroma | |
5672 interlacing does not line up properly due to vertical downsampling of | |
5673 the chroma channels. | |
5674 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with | |
5675 the chroma lines in their proper locations, so that in any given | |
5676 scanline, the luma and chroma data both come from the same field. | |
5677 .PD 0 | |
5678 .RSs | |
5679 .IPs <mode> | |
5680 Select the sampling mode. | |
5681 .RSss | |
5682 0: nearest-neighbor sampling, fast but incorrect | |
5683 .br | |
5684 1: linear interpolation (default) | |
5685 .REss | |
5686 .RE | |
5687 .PD 1 | |
5688 . | |
5689 .TP | |
5690 .B harddup | |
5691 Only useful with MEncoder. | |
5692 If harddup is used when encoding, it will force duplicate frames to be | |
5693 encoded in the output. | |
5694 This uses slightly more space, but is necessary for output to MPEG | |
5695 files or if you plan to demux and remux the video stream after | |
5696 encoding. | |
5697 Should be placed at or near the end of the filter chain unless you | |
5698 have a good reason to do otherwise. | |
5699 . | |
5700 .TP | |
5701 .B softskip | |
5702 Only useful with MEncoder. | |
5703 Softskip moves the frame skipping (dropping) step of encoding from | |
5704 before the filter chain to some point during the filter chain. | |
5705 This allows filters which need to see all frames (inverse telecine, | |
5706 temporal denoising, etc.) to function properly. | |
5707 Should be placed after the filters which need to see all frames and | |
5708 before any subsequent filters that are CPU-intensive. | |
5709 . | |
5710 .TP | |
5711 .B decimate[=max:hi:lo:frac] | |
5712 Drops frames that do not differ greatly from the previous frame in | |
5713 order to reduce framerate. | |
5714 The main use of this filter is for very-low-bitrate encoding (e.g.\& | |
5715 streaming over dialup modem), but it could in theory be used for | |
5716 fixing movies that were inverse-telecined incorrectly. | |
5717 .PD 0 | |
5718 .RSs | |
5719 .IPs <max> | |
5720 Sets the maximum number of consecutive frames which can be | |
5721 dropped (if positive), or the minimum interval between | |
5722 dropped frames (if negative). | |
5723 .IPs <hi>,<lo>,<frac> | |
5724 A frame is a candidate for dropping if no 8x8 region differs by more | |
5725 than a threshold of <hi>, and if not more than <frac> portion (1 | |
5726 meaning the whole image) differs by more than a threshold of <lo>. | |
5727 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual | |
5728 pixel value differences, so a threshold of 64 corresponds to 1 unit of | |
5729 difference for each pixel, or the same spread out differently over the | |
5730 block. | |
5731 .RE | |
5732 .PD 1 | |
5733 . | |
5734 .TP | |
5735 .B dint[=sense:level] | |
5736 The drop-deinterlace (dint) filter detects and drops the first from a set | |
5737 of interlaced video frames. | |
5738 .PD 0 | |
5739 .RSs | |
5740 .IPs <0.0\-1.0> | |
5741 relative difference between neighboring pixels (default: 0.1) | |
5742 .IPs <0.0\-1.0> | |
5743 What part of the image has to be detected as interlaced to | |
5744 drop the frame (default: 0.15). | |
5745 .RE | |
5746 .PD 1 | |
5747 . | |
5748 .TP | |
5749 .B lavcdeint (OBSOLETE) | |
5750 FFmpeg deinterlacing filter, same as \-vf pp=fd | |
5751 . | |
5752 .TP | |
5753 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]] | |
5754 Donald Graft's adaptive kernel deinterlacer. | |
5755 Deinterlaces parts of a video if a configurable threshold is exceeded. | |
5756 .PD 0 | |
5757 .RSs | |
5758 .IPs <0\-255> | |
5759 threshold (default: 10) | |
5760 .IPs <map> | |
5761 .RSss | |
5762 0: Ignore pixels exceeding the threshold (default). | |
5763 .br | |
5764 1: Paint pixels exceeding the threshold white. | |
5765 .REss | |
5766 .IPs <order> | |
5767 .RSss | |
5768 0: Leave fields alone (default). | |
5769 .br | |
5770 1: Swap fields. | |
5771 .REss | |
5772 .IPs <sharp> | |
5773 .RSss | |
5774 0: Disable additional sharpening (default). | |
5775 .br | |
5776 1: Enable additional sharpening. | |
5777 .REss | |
5778 .IPs <twoway> | |
5779 .RSss | |
5780 0: Disable twoway sharpening (default). | |
5781 .br | |
5782 1: Enable twoway sharpening. | |
5783 .REss | |
5784 .RE | |
5785 .PD 1 | |
5786 . | |
5787 .TP | |
5788 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]] | |
5789 unsharp mask / gaussian blur | |
5790 .RSs | |
5791 .IPs "l\ \ \ \ " | |
5792 Apply effect on luma component. | |
5793 .IPs "c\ \ \ \ " | |
5794 Apply effect on chroma components. | |
5795 .IPs <width>x<height> | |
5796 width and height of the matrix, odd sized in both directions | |
5797 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7) | |
5798 .IPs amount | |
5799 Relative amount of sharpness/\:blur to add to the image | |
5800 (a sane range should be -1.5\-1.5). | |
5801 .RSss | |
5802 <0: blur | |
5803 .br | |
5804 >0: sharpen | |
5805 .REss | |
5806 .RE | |
5807 . | |
5808 .TP | |
5809 .B "swapuv\ " | |
5810 Swap U & V plane. | |
5811 . | |
5812 .TP | |
5813 .B il[=d|i][s][:[d|i][s]] | |
5814 (De)interleaves lines. | |
5815 The goal of this filter is to add the ability to process interlaced images | |
5816 pre-field without deinterlacing them. | |
5817 You can filter your interlaced DVD and play it on a TV without breaking the | |
5818 interlacing. | |
5819 While deinterlacing (with the postprocessing filter) removes interlacing | |
5820 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into | |
5821 2 fields (so called half pictures), so you can process (filter) them | |
5822 independently and then re-interleave them. | |
5823 .PD 0 | |
5824 .RSs | |
5825 .IPs d | |
5826 deinterleave (placing one above the other) | |
5827 .IPs i | |
5828 interleave | |
5829 .IPs s | |
5830 swap fields (exchange even & odd lines) | |
5831 .RE | |
5832 .PD 1 | |
5833 . | |
5834 .TP | |
5835 .B fil[=i|d] | |
5836 (De)interleaves lines. | |
5837 This filter is very similar to the il filter but much faster, the main | |
5838 disadvantage is that it does not always work. | |
5839 Especially if combined with other filters it may produce randomly messed | |
5840 up images, so be happy if it works but do not complain if it does not for | |
5841 your combination of filters. | |
5842 .PD 0 | |
5843 .RSs | |
5844 .IPs d | |
5845 Deinterleave fields, placing them side by side. | |
5846 .IPs i | |
5847 Interleave fields again (reversing the effect of fil=d). | |
5848 .RE | |
5849 .PD 1 | |
5850 . | |
5851 .TP | |
5852 .B field[=n] | |
5853 Extracts a single field from an interlaced image using stride arithmetic | |
5854 to avoid wasting CPU time. | |
5855 The optional argument n specifies whether to extract the even or the odd | |
5856 field (depending on whether n is even or odd). | |
5857 . | |
5858 .TP | |
5859 .B detc[=var1=value1:var2=value2:...] | |
5860 Attempts to reverse the 'telecine' process to recover a clean, | |
5861 non-interlaced stream at film framerate. | |
5862 This was the first and most primitive inverse telecine filter to be | |
5863 added to MPlayer/\:MEncoder. | |
5864 It works by latching onto the telecine 3:2 pattern and following it as | |
5865 long as possible. | |
5866 This makes it suitable for perfectly-telecined material, even in the | |
5867 presence of a fair degree of noise, but it will fail in the presence | |
5868 of complex post-telecine edits. | |
5869 Development on this filter is no longer taking place, as ivtc, pullup, | |
5870 and filmdint are better for most applications. | |
5871 The following arguments (see syntax above) may be used to control | |
5872 detc's behavior: | |
5873 .RSs | |
5874 .IPs "<dr>\ " | |
5875 Set the frame dropping mode. | |
5876 .RSss | |
5877 0: Do not drop frames to maintain fixed output framerate (default). | |
5878 .br | |
5879 1: Always drop a frame when there have been no drops or telecine | |
5880 merges in the past 5 frames. | |
5881 .br | |
5882 2: Always maintain exact 5:4 input to output frame ratio. | |
5883 .br | |
5884 .I NOTE: | |
5885 Use mode 1 or 2 with MEncoder. | |
5886 .REss | |
5887 .IPs "<am>\ " | |
5888 Analysis mode. | |
5889 .RSss | |
5890 0: Fixed pattern with initial frame number specified by <fr>. | |
5891 .br | |
5892 1: aggressive search for telecine pattern (default) | |
5893 .REss | |
5894 .IPs "<fr>\ " | |
5895 Set initial frame number in sequence. | |
5896 0\-2 are the three clean progressive frames; 3 and 4 are the two | |
5897 interlaced frames. | |
5898 The default, -1, means 'not in telecine sequence'. | |
5899 The number specified here is the type for the imaginary previous | |
5900 frame before the movie starts. | |
5901 .IPs "<t0>, <t1>, <t2>, <t3>" | |
5902 Threshold values to be used in certain modes. | |
5903 .RE | |
5904 . | |
5905 .TP | |
5906 .B ivtc[=1] | |
5907 Experimental 'stateless' inverse telecine filter. | |
5908 Rather than trying to lock on to a pattern like the detc filter does, | |
5909 ivtc makes its decisions independently for each frame. | |
5910 This will give much better results for material that has undergone | |
5911 heavy editing after telecine was applied, but as a result it is not as | |
5912 forgiving of noisy input, for example TV capture. | |
5913 The optional parameter (ivtc=1) corresponds to the dr=1 option for the | |
5914 detc filter, and should be used with MEncoder but not with MPlayer. | |
5915 As with detc, you must specify the correct output framerate (\-ofps | |
5916 24000/1001) when using MEncoder. | |
5917 Further development on ivtc has stopped, as the pullup and filmdint | |
5918 filters appear to be much more accurate. | |
5919 . | |
5920 .TP | |
5921 .B pullup[=jl:jr:jt:jb:sb:mp] | |
5922 Third-generation pulldown reversal (inverse telecine) filter, | |
5923 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001 | |
5924 fps progressive content. | |
5925 The pullup filter is designed to be much more robust than detc or | |
5926 ivtc, by taking advantage of future context in making its decisions. | |
5927 Like ivtc, pullup is stateless in the sense that it does not lock onto | |
5928 a pattern to follow, but it instead looks forward to the following | |
5929 fields in order to identify matches and rebuild progressive frames. | |
5930 It is still under development, but believed to be quite accurate. | |
5931 The jl, jr, jt, and jb options set the amount of "junk" to ignore at | |
5932 the left, right, top, and bottom of the image, respectively. | |
5933 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of | |
5934 2 lines. | |
5935 The default is 8 pixels on each side. | |
5936 Setting the sb (strict breaks) option to 1 will reduce the chances of | |
5937 pullup generating an occasional mismatched frame, but it may also | |
5938 cause an excessive number of frames to be dropped during high motion | |
5939 sequences. | |
5940 Conversely, setting it to -1 will make pullup match fields more | |
5941 easily. | |
5942 This may help processing of video where there is slight blurring | |
5943 between the fields, but may also cause there to be interlaced frames | |
5944 in the output. | |
5945 The mp (metric plane) option may be set to 1 or 2 to use a chroma | |
5946 plane instead of the luma plane for doing pullup's computations. | |
5947 This may improve accuracy on very clean source material, but more | |
5948 likely will decrease accuracy, especially if there is chroma noise | |
5949 (rainbow effect) or any grayscale video. | |
5950 The main purpose of setting mp to a chroma plane is to reduce CPU load | |
5951 and make pullup usable in realtime on slow machines. | |
5952 .br | |
5953 .I NOTE: | |
5954 Always follow pullup with the softskip filter when encoding to ensure | |
5955 that pullup is able to see each frame. | |
5956 Failure to do so will lead to incorrect output and will usually crash, | |
5957 due to design limitations in the codec/\:filter layer. | |
5958 . | |
5959 .TP | |
5960 .B filmdint[=options] | |
5961 Inverse telecine filter, similar to the pullup filter above. | |
5962 It is designed to handle any pulldown pattern, including mixed soft and | |
5963 hard telecine and limited support for movies that are slowed down or sped | |
5964 up from their original framerate for TV. | |
5965 Only the luma plane is used to find the frame breaks. | |
5966 If a field has no match, it is deinterlaced with simple linear | |
5967 approximation. | |
5968 If the source is MPEG-2, this must be the first filter to allow | |
5969 access to the field-flags set by the MPEG-2 decoder. | |
5970 Depending on the source MPEG, you may be fine ignoring this advice, as | |
5971 long as you do not see lots of "Bottom-first field" warnings. | |
5972 With no options it does normal inverse telecine, and should be used | |
5973 together with mencoder \-fps 30000/1001 \-ofps 24000/1001. | |
5974 When this filter is used with mplayer, it will result in an uneven | |
5975 framerate during playback, but it is still generally better than using | |
5976 pp=lb or no deinterlacing at all. | |
5977 Multiple options can be specified separated by /. | |
5978 .RSs | |
5979 .IPs crop=<w>:<h>:<x>:<y> | |
5980 Just like the crop filter, but faster, and works on mixed hard and soft | |
5981 telecined content as well as when y is not a multiple of 4. | |
5982 If x or y would require cropping fractional pixels from the chroma | |
5983 planes, the crop area is extended. | |
5984 This usually means that x and y must be even. | |
5985 .IPs io=<ifps>:<ofps> | |
5986 For each ifps input frames the filter will output ofps frames. | |
5987 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio. | |
5988 This could be used to filter movies that are broadcast on TV at a frame | |
5989 rate different from their original framerate. | |
5990 .IPs luma_only=<n> | |
5991 If n is nonzero, the chroma plane is copied unchanged. | |
5992 This is useful for YV12 sampled TV, which discards one of the chroma | |
5993 fields. | |
5994 .IPs mmx2=<n> | |
5995 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow! | |
5996 optimized functions, otherwise, use plain C. | |
5997 If this option is not specified, MMX2 and 3DNow! are auto-detected, use | |
5998 this option to override auto-detection. | |
5999 .IPs fast=<n> | |
6000 The larger n will speed up the filter at the expense of accuracy. | |
6001 The default value is n=3. | |
6002 If n is odd, a frame immediately following a frame marked with the | |
6003 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter | |
6004 will not spend any time on soft-telecined MPEG-2 content. | |
6005 This is the only effect of this flag if MMX2 or 3DNow! is available. | |
6006 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used | |
6007 as with n=2 or 3. | |
6008 If n=2 or 3, the number of luma levels used to find the frame breaks is | |
6009 reduced from 256 to 128, which results in a faster filter without losing | |
6010 much accuracy. | |
6011 If n=4 or 5, a faster, but much less accurate metric will be used to | |
6012 find the frame breaks, which is more likely to misdetect high vertical | |
6013 detail as interlaced content. | |
6014 .IPs verbose=<n> | |
6015 If n is nonzero, print the detailed metrics for each frame. | |
6016 Useful for debugging. | |
6017 .IPs dint_thres=<n> | |
6018 Deinterlace threshold. | |
6019 Used during de-interlacing of unmatched frames. | |
6020 Larger value means less deinterlacing, use n=256 to completely turn off | |
6021 deinterlacing. | |
6022 Default is n=8. | |
6023 .IPs comb_thres=<n> | |
6024 Threshold for comparing a top and bottom fields. | |
6025 Defaults to 128. | |
6026 .IPs diff_thres=<n> | |
6027 Threshold to detect temporal change of a field. | |
6028 Default is 128. | |
6029 .IPs sad_thres=<n> | |
6030 Sum of Absolute Difference threshold, default is 64. | |
6031 .RE | |
6032 . | |
6033 .TP | |
6034 .B softpulldown | |
6035 This filter works only correct with MEncoder and acts on the MPEG-2 flags | |
6036 used for soft 3:2 pulldown (soft telecine). | |
6037 If you want to use the ivtc or detc filter on movies that are partly soft | |
6038 telecined, inserting this filter before them should make them more reliable. | |
6039 . | |
6040 .TP | |
6041 .B divtc[=options] | |
6042 Inverse telecine for deinterlaced video. | |
6043 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced | |
6044 using a method that keeps one field and interpolates the other, the result is | |
6045 a juddering video that has every fourth frame duplicated. | |
6046 This filter is intended to find and drop those duplicates and restore the | |
6047 original film framerate. | |
6048 When using this filter, you must specify \-ofps that is 4/5 of | |
6049 the fps of the input file and place the softskip later in the | |
6050 filter chain to make sure that divtc sees all the frames. | |
6051 Two different modes are available: | |
6052 One pass mode is the default and is straightforward to use, | |
6053 but has the disadvantage that any changes in the telecine | |
6054 phase (lost frames or bad edits) cause momentary judder | |
6055 until the filter can resync again. | |
6056 Two pass mode avoids this by analyzing the whole video | |
6057 beforehand so it will have forward knowledge about the | |
6058 phase changes and can resync at the exact spot. | |
6059 These passes do | |
6060 .B not | |
6061 correspond to pass one and two of the encoding process. | |
6062 You must run an extra pass using divtc pass one before the | |
6063 actual encoding throwing the resulting video away. | |
6064 Use \-nosound \-ovc raw \-o /dev/null to avoid | |
6065 wasting CPU power for this pass. | |
6066 You may add something like crop=2:2:0:0 after divtc | |
6067 to speed things up even more. | |
6068 Then use divtc pass two for the actual encoding. | |
6069 If you use multiple encoder passes, use divtc | |
6070 pass two for all of them. | |
6071 The options are: | |
6072 .RSs | |
6073 .IPs pass=1|2 | |
6074 Use two pass mode. | |
6075 .IPs file=<filename> | |
6076 Set the two pass log filename (default: "framediff.log"). | |
6077 .IPs threshold=<value> | |
6078 Set the minimum strength the telecine pattern must have for the filter to | |
6079 believe in it (default: 0.5). | |
6080 This is used to avoid recognizing false pattern from the parts of the video | |
6081 that are very dark or very still. | |
6082 .IPs window=<numframes> | |
6083 Set the number of past frames to look at when searching for pattern | |
6084 (default: 30). | |
6085 Longer window improves the reliability of the pattern search, but shorter | |
6086 window improves the reaction time to the changes in the telecine phase. | |
6087 This only affects the one pass mode. | |
6088 The two pass mode currently uses fixed window that extends to both future | |
6089 and past. | |
6090 .IPs phase=0|1|2|3|4 | |
6091 Sets the initial telecine phase for one pass mode (default: 0). | |
6092 The two pass mode can see the future, so it is able to use the correct | |
6093 phase from the beginning, but one pass mode can only guess. | |
6094 It catches the correct phase when it finds it, but this option can be used | |
6095 to fix the possible juddering at the beginning. | |
6096 The first pass of the two pass mode also uses this, so if you save the output | |
6097 from the first pass, you get constant phase result. | |
6098 .IPs deghost=<value> | |
6099 Set the deghosting threshold (0\-255 for one pass mode, -255\-255 for two pass | |
6100 mode, default 0). | |
6101 If nonzero, deghosting mode is used. | |
6102 This is for video that has been deinterlaced by blending the fields | |
6103 together instead of dropping one of the fields. | |
6104 Deghosting amplifies any compression artifacts in the blended frames, so the | |
6105 parameter value is used as a threshold to exclude those pixels from | |
6106 deghosting that differ from the previous frame less than specified value. | |
6107 If two pass mode is used, then negative value can be used to make the | |
6108 filter analyze the whole video in the beginning of pass-2 to determine | |
6109 whether it needs deghosting or not and then select either zero or the | |
6110 absolute value of the parameter. | |
6111 Specify this option for pass-2, it makes no difference on pass-1. | |
6112 .RE | |
6113 . | |
6114 .TP | |
6115 .B phase[=t|b|p|a|u|T|B|A|U][:v] | |
6116 Delay interlaced video by one field time so that the field order | |
6117 changes. | |
6118 The intended use is to fix PAL movies that have been captured with the | |
6119 opposite field order to the film-to-video transfer. | |
6120 The options are: | |
6121 .RSs | |
6122 .IPs t | |
6123 Capture field order top-first, transfer bottom-first. | |
6124 Filter will delay the bottom field. | |
6125 .IPs b | |
6126 Capture bottom-first, transfer top-first. | |
6127 Filter will delay the top field. | |
6128 .IPs p | |
6129 Capture and transfer with the same field order. | |
6130 This mode only exists for the documentation of the other options to refer to, | |
6131 but if you actually select it, the filter will faithfully do nothing ;-) | |
6132 .IPs a | |
6133 Capture field order determined automatically by field flags, transfer opposite. | |
6134 Filter selects among t and b modes on a frame by frame basis using field flags. | |
6135 If no field information is available, then this works just like u. | |
6136 .IPs u | |
6137 Capture unknown or varying, transfer opposite. | |
6138 Filter selects among t and b on a frame by frame basis by analyzing the | |
6139 images and selecting the alternative that produces best match between the | |
6140 fields. | |
6141 .IPs T | |
6142 Capture top-first, transfer unknown or varying. | |
6143 Filter selects among t and p using image analysis. | |
6144 .IPs B | |
6145 Capture bottom-first, transfer unknown or varying. | |
6146 Filter selects among b and p using image analysis. | |
6147 .IPs A | |
6148 Capture determined by field flags, transfer unknown or varying. | |
6149 Filter selects among t, b and p using field flags and image analysis. | |
6150 If no field information is available, then this works just like U. | |
6151 This is the default mode. | |
6152 .IPs U | |
6153 Both capture and transfer unknown or varying. | |
6154 Filter selects among t, b and p using image analysis only. | |
6155 .IPs v | |
6156 Verbose operation. | |
6157 Prints the selected mode for each frame and the average squared difference | |
6158 between fields for t, b, and p alternatives. | |
6159 .RE | |
6160 . | |
6161 .TP | |
6162 .B telecine[=start] | |
6163 Apply 3:2 'telecine' process to increase framerate by 20%. | |
6164 This most likely will not work correctly with MPlayer, but it can | |
6165 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'. | |
6166 Both fps options are essential! | |
6167 (A/V sync will break if they are wrong.) | |
6168 The optional start parameter tells the filter where in the telecine | |
6169 pattern to start (0\-3). | |
6170 . | |
6171 .TP | |
6172 .B tinterlace[=mode] | |
6173 Temporal field interlacing \- merge pairs of frames into an interlaced | |
6174 frame, halving the framerate. | |
6175 Even frames are moved into the upper field, odd frames to the lower field. | |
6176 This can be used to fully reverse the effect of the tfields filter (in mode 0). | |
6177 Available modes are: | |
6178 .PD 0 | |
6179 .RSs | |
6180 .IPs 0 | |
6181 Move odd frames into the upper field, even into the lower field, generating | |
6182 a full-height frame at half framerate. | |
6183 .IPs 1 | |
6184 Only output odd frames, even frames are dropped; height unchanged. | |
6185 .IPs 2 | |
6186 Only output even frames, odd frames are dropped; height unchanged. | |
6187 .IPs 3 | |
6188 Expand each frame to full height, but pad alternate lines with black; | |
6189 framerate unchanged. | |
6190 .IPs 4 | |
6191 Interleave even lines from even frames with odd lines from odd frames. | |
6192 Generates full-height frame at half framerate. | |
6193 .RE | |
6194 .PD 1 | |
6195 . | |
6196 .TP | |
6197 .B tfields[=mode[:field_dominance]] | |
6198 Temporal field separation \- split fields into frames, doubling the | |
6199 output framerate. | |
6200 Like the telecine filter, tfields will only work properly with | |
6201 MEncoder, and only if both \-fps and \-ofps are set to the | |
6202 desired (double) framerate! | |
6203 .PD 0 | |
6204 .RSs | |
6205 .IPs <mode> | |
6206 0: Leave fields unchanged (will jump/\:flicker). | |
6207 .br | |
6208 1: Interpolate missing lines. (The algorithm used might not be so good.) | |
6209 .br | |
6210 2: Translate fields by 1/4 pixel with linear interpolation (no jump). | |
6211 .br | |
6212 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default). | |
6213 .IPs <field_dominance> | |
6214 -1: auto (default) | |
6215 Only works if the decoder exports the appropriate information and | |
6216 no other filters which discard that information come before tfields | |
6217 in the filter chain, otherwise it falls back to 0 (top field first). | |
6218 .br | |
6219 0: top field first | |
6220 .br | |
6221 1: bottom field first | |
6222 .RE | |
6223 .PD 1 | |
6224 . | |
6225 .TP | |
6226 .B yadif=[mode[:field_dominance]] | |
6227 Yet another deinterlacing filter | |
6228 .PD 0 | |
6229 .RSs | |
6230 .IPs <mode> | |
6231 0: Output 1 frame for each frame. | |
6232 .br | |
6233 1: Output 1 frame for each field. | |
6234 .br | |
6235 2: Like 0 but skips spatial interlacing check. | |
6236 .br | |
6237 3: Like 1 but skips spatial interlacing check. | |
6238 .IPs <field_dominance> | |
6239 Operates like tfields. | |
6240 .RE | |
6241 .PD 1 | |
6242 . | |
6243 .TP | |
6244 .B mcdeint=[mode[:parity[:qp]]] | |
6245 Motion compensating deinterlacer. | |
6246 It needs one field per frame as input and must thus be used together | |
6247 with tfields=1 or yadif=1/3 or equivalent. | |
6248 .PD 0 | |
6249 .RSs | |
6250 .IPs <mode> | |
6251 0: fast | |
6252 .br | |
6253 1: medium | |
6254 .br | |
6255 2: slow, iterative motion estimation | |
6256 .br | |
6257 3: extra slow, like 2 plus multiple reference frames | |
6258 .IPs <parity> | |
6259 0 or 1 selects which field to use (note: no autodetection yet!). | |
6260 .IPs "<qp>\ " | |
6261 Higher values should result in a smoother motion vector | |
6262 field but less optimal individual vectors. | |
6263 .RE | |
6264 .PD 1 | |
6265 . | |
6266 .TP | |
6267 .B boxblur=radius:power[:radius:power] | |
6268 box blur | |
6269 .PD 0 | |
6270 .RSs | |
6271 .IPs <radius> | |
6272 blur filter strength | |
6273 .IPs <power> | |
6274 number of filter applications | |
6275 .RE | |
6276 .PD 1 | |
6277 . | |
6278 .TP | |
6279 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff] | |
6280 shape adaptive blur | |
6281 .PD 0 | |
6282 .RSs | |
6283 .IPs <radius> | |
6284 blur filter strength (~0.1\-4.0) (slower if larger) | |
6285 .IPs "<pf>\ " | |
6286 prefilter strength (~0.1\-2.0) | |
6287 .IPs <colorDiff> | |
6288 maximum difference between pixels to still be considered (~0.1\-100.0) | |
6289 .RE | |
6290 .PD 1 | |
6291 . | |
6292 .TP | |
6293 .B smartblur=radius:strength:threshold[:radius:strength:threshold] | |
6294 smart blur | |
6295 .PD 0 | |
6296 .RSs | |
6297 .IPs <radius> | |
6298 blur filter strength (~0.1\-5.0) (slower if larger) | |
6299 .IPs <strength> | |
6300 blur (0.0\-1.0) or sharpen (-1.0\-0.0) | |
6301 .IPs <threshold> | |
6302 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) | |
6303 .RE | |
6304 .PD 1 | |
6305 . | |
6306 .TP | |
6307 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t | |
6308 Correct the perspective of movies not filmed perpendicular to the screen. | |
6309 .PD 0 | |
6310 .RSs | |
6311 .IPs <x0>,<y0>,... | |
6312 coordinates of the top left, top right, bottom left, bottom right corners | |
6313 .IPs "<t>\ \ " | |
6314 linear (0) or cubic resampling (1) | |
6315 .RE | |
6316 .PD 1 | |
6317 . | |
6318 .TP | |
6319 .B "2xsai\ \ " | |
6320 Scale and smooth the image with the 2x scale and interpolate algorithm. | |
6321 . | |
6322 .TP | |
6323 .B "1bpp\ \ \ " | |
6324 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion | |
6325 . | |
6326 .TP | |
6327 .B down3dright[=lines] | |
6328 Reposition and resize stereoscopic images. | |
6329 Extracts both stereo fields and places them side by side, resizing | |
6330 them to maintain the original movie aspect. | |
6331 .PD 0 | |
6332 .RSs | |
6333 .IPs <lines> | |
6334 number of lines to select from the middle of the image (default: 12) | |
6335 .RE | |
6336 .PD 1 | |
6337 . | |
6338 .TP | |
6339 .B bmovl=hidden:opaque:fifo | |
6340 The bitmap overlay filter reads bitmaps from a FIFO and displays them | |
6341 on top of the movie, allowing some transformations on the image. | |
6342 Also see TOOLS/bmovl-test.c for a small bmovl test program. | |
6343 .PD 0 | |
6344 .RSs | |
6345 .IPs <hidden> | |
6346 Set the default value of the 'hidden' flag (0=visible, 1=hidden). | |
6347 .IPs <opaque> | |
6348 Set the default value of the 'opaque' flag (0=transparent, 1=opaque). | |
6349 .IPs <fifo> | |
6350 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the | |
6351 controlling application) | |
6352 .RE | |
6353 .PD 1 | |
6354 .sp 1 | |
6355 .RS | |
6356 FIFO commands are: | |
6357 .RE | |
6358 .PD 0 | |
6359 .RSs | |
6360 .IPs "RGBA32 width height xpos ypos alpha clear" | |
6361 followed by width*height*4 Bytes of raw RGBA32 data. | |
6362 .IPs "ABGR32 width height xpos ypos alpha clear" | |
6363 followed by width*height*4 Bytes of raw ABGR32 data. | |
6364 .IPs "RGB24 width height xpos ypos alpha clear" | |
6365 followed by width*height*3 Bytes of raw RGB24 data. | |
6366 .IPs "BGR24 width height xpos ypos alpha clear" | |
6367 followed by width*height*3 Bytes of raw BGR24 data. | |
6368 .IPs "ALPHA width height xpos ypos alpha" | |
6369 Change alpha transparency of the specified area. | |
6370 .IPs "CLEAR width height xpos ypos" | |
6371 Clear area. | |
6372 .IPs OPAQUE | |
6373 Disable all alpha transparency. | |
6374 Send "ALPHA 0 0 0 0 0" to enable it again. | |
6375 .IPs "HIDE\ " | |
6376 Hide bitmap. | |
6377 .IPs "SHOW\ " | |
6378 Show bitmap. | |
6379 .RE | |
6380 .PD 1 | |
6381 .sp 1 | |
6382 .RS | |
6383 Arguments are: | |
6384 .RE | |
6385 .PD 0 | |
6386 .RSs | |
6387 .IPs "<width>, <height>" | |
6388 image/area size | |
6389 .IPs "<xpos>, <ypos>" | |
6390 Start blitting at position x/y. | |
6391 .IPs <alpha> | |
6392 Set alpha difference. | |
6393 If you set this to -255 you can then send a sequence of ALPHA-commands to set | |
6394 the area to -225, -200, -175 etc for a nice fade-in-effect! ;) | |
6395 .RSss | |
6396 0: same as original | |
6397 .br | |
6398 255: Make everything opaque. | |
6399 .br | |
6400 -255: Make everything transparent. | |
6401 .REss | |
6402 .IPs <clear> | |
6403 Clear the framebuffer before blitting. | |
6404 .RSss | |
6405 0: The image will just be blitted on top of the old one, so you do not need to | |
6406 send 1.8MB of RGBA32 data every time a small part of the screen is updated. | |
6407 .br | |
6408 1: clear | |
6409 .REss | |
6410 .RE | |
6411 .PD 1 | |
6412 . | |
6413 .TP | |
6414 .B framestep=I|[i]step | |
6415 Renders only every nth frame or every intra frame (keyframe). | |
6416 .sp 1 | |
6417 If you call the filter with I (uppercase) as the parameter, then | |
6418 .B only | |
6419 keyframes are rendered. | |
6420 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB), | |
6421 for AVI it means every scene change or every keyint value (see \-lavcopts | |
6422 keyint= value if you use MEncoder to encode the video). | |
6423 .sp 1 | |
6424 When a keyframe is found, an 'I!' string followed by a newline character is | |
6425 printed, leaving the current line of MPlayer/\:MEncoder output on the screen, | |
6426 because it contains the time (in seconds) and frame number of the keyframe | |
6427 (You can use this information to split the AVI.). | |
6428 .sp 1 | |
6429 If you call the filter with a numeric parameter 'step' then only one in | |
6430 every 'step' frames is rendered. | |
6431 .sp 1 | |
6432 If you put an 'i' (lowercase) before the number then an 'I!' is printed | |
6433 (like the I parameter). | |
6434 .sp 1 | |
6435 If you give only the i then nothing is done to the frames, only I! is | |
6436 printed. | |
6437 . | |
6438 .TP | |
6439 .B tile=xtiles:ytiles:output:start:delta | |
6440 Tile a series of images into a single, bigger image. | |
6441 If you omit a parameter or use a value less than 0, then the default | |
6442 value is used. | |
6443 You can also stop when you are satisfied (... \-vf tile=10:5 ...). | |
6444 It is probably a good idea to put the scale filter before the tile :-) | |
6445 .sp 1 | |
6446 The parameters are: | |
6447 .sp 1 | |
6448 .PD 0 | |
6449 .RSs | |
6450 .IPs <xtiles> | |
6451 number of tiles on the x axis (default: 5) | |
6452 .IPs <ytiles> | |
6453 number of tiles on the y axis (default: 5) | |
6454 .IPs <output> | |
6455 Render the tile when 'output' number of frames are reached, where 'output' | |
6456 should be a number less than xtile * ytile. | |
6457 Missing tiles are left blank. | |
6458 You could, for example, write an 8 * 7 tile every 50 frames to have one | |
6459 image every 2 seconds @ 25 fps. | |
6460 .IPs <start> | |
6461 outer border thickness in pixels (default: 2) | |
6462 .IPs <delta> | |
6463 inner border thickness in pixels (default: 4) | |
6464 .RE | |
6465 .PD 1 | |
6466 . | |
6467 .TP | |
6468 .B delogo[=x:y:w:h:t] | |
6469 Suppresses a TV station logo by a simple interpolation of the | |
6470 surrounding pixels. | |
6471 Just set a rectangle covering the logo and watch it disappear (and | |
6472 sometimes something even uglier appear \- your mileage may vary). | |
6473 .PD 0 | |
6474 .RSs | |
6475 .IPs <x>,<y> | |
6476 top left corner of the logo | |
6477 .IPs <w>,<h> | |
6478 width and height of the cleared rectangle | |
6479 .IPs <t> | |
6480 Thickness of the fuzzy edge of the rectangle (added to w and h). | |
6481 When set to -1, a green rectangle is drawn on the screen to | |
6482 simplify finding the right x,y,w,h parameters. | |
6483 .RE | |
6484 .PD 1 | |
6485 . | |
6486 .TP | |
6487 .B remove-logo=/path/to/logo_bitmap_file_name.pgm | |
6488 Suppresses a TV station logo, using a PGM or PPM image | |
6489 file to determine which pixels comprise the logo. | |
6490 The width and height of the image file must match | |
6491 those of the video stream being processed. | |
6492 Uses the filter image and a circular blur | |
6493 algorithm to remove the logo. | |
6494 .RSs | |
6495 .IPs /path/to/logo_bitmap_file_name.pgm | |
6496 [path] + filename of the filter image. | |
6497 .RE | |
6498 . | |
6499 .TP | |
6500 .B zrmjpeg[=options] | |
6501 Software YV12 to MJPEG encoder for use with the zr2 video | |
6502 output device. | |
6503 .RSs | |
6504 .IPs maxheight=<h>|maxwidth=<w> | |
6505 These options set the maximum width and height the zr card | |
6506 can handle (the MPlayer filter layer currently cannot query those). | |
6507 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC} | |
6508 Use these options to set maxwidth and maxheight automatically to the | |
6509 values known for card/\:mode combo. | |
6510 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL) | |
6511 .IPs color|bw | |
6512 Select color or black and white encoding. | |
6513 Black and white encoding is faster. | |
6514 Color is the default. | |
6515 .IPs hdec={1,2,4} | |
6516 Horizontal decimation 1, 2 or 4. | |
6517 .IPs vdec={1,2,4} | |
6518 Vertical decimation 1, 2 or 4. | |
6519 .IPs quality=1\-20 | |
6520 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD]. | |
6521 .IPs fd|nofd | |
6522 By default, decimation is only performed if the Zoran hardware | |
6523 can upscale the resulting MJPEG images to the original size. | |
6524 The option fd instructs the filter to always perform the requested | |
6525 decimation (ugly). | |
6526 .RE | |
6527 . | |
6528 .TP | |
6529 .B screenshot | |
6530 Allows acquiring screenshots of the movie using slave mode | |
6531 commands that can be bound to keypresses. | |
6532 See the slave mode documentation and the INTERACTIVE CONTROL | |
6533 section for details. | |
6534 Files named 'shotNNNN.png' will be saved in the working directory, | |
6535 using the first available number - no files will be overwritten. | |
6536 The filter has no overhead when not used and accepts an arbitrary | |
6537 colorspace, so it is safe to add it to the configuration file. | |
6538 .RE | |
6539 . | |
6540 .TP | |
6541 .B "ass\ \ \ \ " | |
6542 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain. | |
6543 Only useful with the \-ass option. | |
6544 .sp 1 | |
6545 .I EXAMPLE: | |
6546 .PD 0 | |
6547 .RSs | |
6548 .IPs "\-vf ass,screenshot" | |
6549 Moves SSA/ASS rendering before the screenshot filter. | |
6550 Screenshots taken this way will contain subtitles. | |
6551 .RE | |
6552 .PD 1 | |
6553 . | |
6554 .TP | |
6555 .B blackframe[=amount:threshold] | |
6556 Detect frames that are (almost) completely black. | |
6557 Can be useful to detect chapter transitions or commercials. | |
6558 Output lines consist of the frame number of the detected frame, the | |
6559 percentage of blackness, the frame type and the frame number of the last | |
6560 encountered keyframe. | |
6561 .RSs | |
6562 .IPs <amount> | |
6563 Percentage of the pixels that have to be below the threshold (default: 98). | |
6564 .IPs <threshold> | |
6565 Threshold below which a pixel value is considered black (default: 32). | |
6566 .RE | |
6567 . | |
6568 . | |
6569 . | |
6570 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)" | |
6571 . | |
6572 .TP | |
6573 .B \-audio-delay <any floating-point number> | |
6574 Delays either audio or video by setting a delay field in the header | |
6575 (default: 0.0). | |
6576 This does not delay either stream while encoding, but the player will | |
6577 see the delay field and compensate accordingly. | |
6578 Positive values delay the audio, and negative values delay the video. | |
6579 Note that this is the exact opposite of the \-delay option. | |
6580 For example, if a video plays correctly with \-delay 0.2, you can | |
6581 fix the video with MEncoder by using \-audio-delay -0.2. | |
6582 .sp 1 | |
6583 Currently, this option only works with the default muxer (\-of avi). | |
6584 If you are using a different muxer, then you must use \-delay instead. | |
6585 . | |
6586 .TP | |
6587 .B \-audio-density <1\-50> | |
6588 Number of audio chunks per second (default is 2 for 0.5s long audio chunks). | |
6589 .br | |
6590 .I NOTE: | |
6591 CBR only, VBR ignores this as it puts each packet in a new chunk. | |
6592 . | |
6593 .TP | |
6594 .B \-audio-preload <0.0\-2.0> | |
6595 Sets up the audio buffering time interval (default: 0.5s). | |
6596 . | |
6597 .TP | |
6598 .B \-fafmttag <format> | |
6599 Can be used to override the audio format tag of the output file. | |
6600 .sp 1 | |
6601 .I EXAMPLE: | |
6602 .PD 0 | |
6603 .RSs | |
6604 .IPs "\-fafmttag 0x55" | |
6605 Will have the output file contain 0x55 (mp3) as audio format tag. | |
6606 .RE | |
6607 .PD 1 | |
6608 . | |
6609 .TP | |
6610 .B \-ffourcc <fourcc> | |
6611 Can be used to override the video fourcc of the output file. | |
6612 .sp 1 | |
6613 .I EXAMPLE: | |
6614 .PD 0 | |
6615 .RSs | |
6616 .IPs "\-ffourcc div3" | |
6617 Will have the output file contain 'div3' as video fourcc. | |
6618 .RE | |
6619 .PD 1 | |
6620 . | |
6621 .TP | |
6622 .B \-force-avi-aspect <0.2\-3.0> | |
6623 Override the aspect stored in the AVI OpenDML vprp header. | |
6624 This can be used to change the aspect ratio with '\-ovc copy'. | |
6625 . | |
6626 .TP | |
6627 .B \-frameno-file <filename> (DEPRECATED) | |
6628 Specify the name of the audio file with framenumber mappings created in | |
6629 the first (audio only) pass of a special three pass encoding mode. | |
6630 .br | |
6631 .I NOTE: | |
6632 Using this mode will most likely give you A-V desync. | |
6633 Do not use it. | |
6634 It is kept for backwards compatibility only and will possibly | |
6635 be removed in a future version. | |
6636 . | |
6637 .TP | |
6638 .B \-hr-edl-seek | |
6639 Use a more precise, but much slower method for skipping areas. | |
6640 Areas marked for skipping are not seeked over, instead all | |
6641 frames are decoded, but only the necessary frames are encoded. | |
6642 This allows starting at non-keyframe boundaries. | |
6643 .br | |
6644 .I NOTE: | |
6645 Not guaranteed to work right with '\-ovc copy'. | |
6646 . | |
6647 .TP | |
6648 .B \-info <option1:option2:...> (AVI only) | |
6649 Specify the info header of the resulting AVI file. | |
6650 .sp 1 | |
6651 Available options are: | |
6652 .RSs | |
6653 .IPs "help\ " | |
6654 Show this description. | |
6655 .IPs name=<value> | |
6656 title of the work | |
6657 .IPs artist=<value> | |
6658 artist or author of the work | |
6659 .IPs genre=<value> | |
6660 original work category | |
6661 .IPs subject=<value> | |
6662 contents of the work | |
6663 .IPs copyright=<value> | |
6664 copyright information | |
6665 .IPs srcform=<value> | |
6666 original format of the digitized material | |
6667 .IPs comment=<value> | |
6668 general comments about the work | |
6669 .RE | |
6670 . | |
6671 .TP | |
6672 .B \-noautoexpand | |
6673 Do not automatically insert the expand filter into the MEncoder filter chain. | |
6674 Useful to control at which point of the filter chain subtitles are rendered | |
6675 when hardcoding subtitles onto a movie. | |
6676 . | |
6677 .TP | |
6678 .B \-noencodedups | |
6679 Do not attempt to encode duplicate frames in duplicate; always output | |
6680 zero-byte frames to indicate duplicates. | |
6681 Zero-byte frames will be written anyway unless a filter or encoder | |
6682 capable of doing duplicate encoding is loaded. | |
6683 Currently the only such filter is harddup. | |
6684 . | |
6685 .TP | |
6686 .B \-noodml (\-of avi only) | |
6687 Do not write OpenDML index for AVI files >1GB. | |
6688 . | |
6689 .TP | |
6690 .B \-noskip | |
6691 Do not skip frames. | |
6692 . | |
6693 .TP | |
6694 .B \-o <filename> | |
6695 Outputs to the given filename. | |
6696 .br | |
6697 If you want a default output filename, you can put this option in the | |
6698 MEncoder config file. | |
6699 . | |
6700 .TP | |
6701 .B \-oac <codec name> | |
6702 Encode with the given audio codec (no default set). | |
6703 .br | |
6704 .I NOTE: | |
6705 Use \-oac help to get a list of available audio codecs. | |
6706 .sp 1 | |
6707 .I EXAMPLE: | |
6708 .PD 0 | |
6709 .RSs | |
6710 .IPs "\-oac copy" | |
6711 no encoding, just streamcopy | |
6712 .IPs "\-oac pcm" | |
6713 Encode to uncompressed PCM. | |
6714 .IPs "\-oac mp3lame" | |
6715 Encode to MP3 (using LAME). | |
6716 .IPs "\-oac lavc" | |
6717 Encode with a libavcodec codec. | |
6718 .RE | |
6719 .PD 1 | |
6720 . | |
6721 .TP | |
6722 .B \-of <format> (BETA CODE!) | |
6723 Encode to the specified container format (default: AVI). | |
6724 .br | |
6725 .I NOTE: | |
6726 Use \-of help to get a list of available container formats. | |
6727 .sp 1 | |
6728 .I EXAMPLE: | |
6729 .PD 0 | |
6730 .RSs | |
6731 .IPs "\-of avi" | |
6732 Encode to AVI. | |
6733 .IPs "\-of mpeg" | |
6734 Encode to MPEG (also see \-mpegopts). | |
6735 .IPs "\-of lavf" | |
6736 Encode with libavformat muxers (also see \-lavfopts). | |
6737 .IPs "\-of rawvideo" | |
6738 raw video stream (no muxing \- one video stream only) | |
6739 .IPs "\-of rawaudio" | |
6740 raw audio stream (no muxing \- one audio stream only) | |
6741 .RE | |
6742 .PD 1 | |
6743 . | |
6744 .TP | |
6745 .B \-ofps <fps> | |
6746 Specify a frames per second (fps) value for the output file, | |
6747 which can be different from that of the source material. | |
6748 Must be set for variable fps (ASF, some MOV) and progressive | |
6749 (30000/1001 fps telecined MPEG) files. | |
6750 . | |
6751 .TP | |
6752 .B \-ovc <codec name> | |
6753 Encode with the given video codec (no default set). | |
6754 .br | |
6755 .I NOTE: | |
6756 Use \-ovc help to get a list of available video codecs. | |
6757 .sp 1 | |
6758 .I EXAMPLE: | |
6759 .PD 0 | |
6760 .RSs | |
6761 .IPs "\-ovc copy" | |
6762 no encoding, just streamcopy | |
6763 .IPs "\-ovc raw" | |
6764 Encode to an arbitrary uncompressed format (use '\-vf format' to select). | |
6765 .IPs "\-ovc lavc" | |
6766 Encode with a libavcodec codec. | |
6767 .RE | |
6768 .PD 1 | |
6769 . | |
6770 .TP | |
6771 .B \-passlogfile <filename> | |
6772 Dump first pass information to <filename> instead of the default divx2pass.log | |
6773 in two pass encoding mode. | |
6774 . | |
6775 .TP | |
6776 .B \-skiplimit <value> | |
6777 Specify the maximum number of frames that may be skipped after | |
6778 encoding one frame (\-noskiplimit for unlimited). | |
6779 . | |
6780 .TP | |
6781 .B \-vobsubout <basename> | |
6782 Specify the basename for the output .idx and .sub files. | |
6783 This turns off subtitle rendering in the encoded movie and diverts it to | |
6784 VOBsub subtitle files. | |
6785 . | |
6786 .TP | |
6787 .B \-vobsuboutid <langid> | |
6788 Specify the language two letter code for the subtitles. | |
6789 This overrides what is read from the DVD or the .ifo file. | |
6790 . | |
6791 .TP | |
6792 .B \-vobsuboutindex <index> | |
6793 Specify the index of the subtitles in the output files (default: 0). | |
6794 . | |
6795 . | |
6796 . | |
6797 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)" | |
6798 You can specify codec specific encoding parameters using the following | |
6799 syntax: | |
6800 . | |
6801 .TP | |
6802 .B \-<codec>opts <option1[=value],option2,...> | |
6803 . | |
6804 .PP | |
6805 Where <codec> may be: lavc, xvidenc, lame, toolame, twolame, | |
6806 nuv, xvfw, faac, x264enc, mpeg, lavf. | |
6807 . | |
6808 . | |
6809 .SS lame (\-lameopts) | |
6810 . | |
6811 .TP | |
6812 .B "help\ \ \ " | |
6813 get help | |
6814 . | |
6815 .TP | |
6816 .B vbr=<0\-4> | |
6817 variable bitrate method | |
6818 .PD 0 | |
6819 .RSs | |
6820 .IPs 0 | |
6821 cbr | |
6822 .IPs 1 | |
6823 mt | |
6824 .IPs 2 | |
6825 rh (default) | |
6826 .IPs 3 | |
6827 abr | |
6828 .IPs 4 | |
6829 mtrh | |
6830 .RE | |
6831 .PD 1 | |
6832 . | |
6833 .TP | |
6834 .B "abr\ \ \ \ " | |
6835 average bitrate | |
6836 . | |
6837 .TP | |
6838 .B "cbr\ \ \ \ " | |
6839 constant bitrate | |
6840 Also forces CBR mode encoding on subsequent ABR presets modes. | |
6841 . | |
6842 .TP | |
6843 .B br=<0\-1024> | |
6844 bitrate in kbps (CBR and ABR only) | |
6845 . | |
6846 .TP | |
6847 .B q=<0\-9> | |
6848 quality (0 \- highest, 9 \- lowest) (VBR only) | |
6849 . | |
6850 .TP | |
6851 .B aq=<0\-9> | |
6852 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest) | |
6853 . | |
6854 .TP | |
6855 .B ratio=<1\-100> | |
6856 compression ratio | |
6857 . | |
6858 .TP | |
6859 .B vol=<0\-10> | |
6860 audio input gain | |
6861 . | |
6862 .TP | |
6863 .B mode=<0\-3> | |
6864 (default: auto) | |
6865 .PD 0 | |
6866 .RSs | |
6867 .IPs 0 | |
6868 stereo | |
6869 .IPs 1 | |
6870 joint-stereo | |
6871 .IPs 2 | |
6872 dualchannel | |
6873 .IPs 3 | |
6874 mono | |
6875 .RE | |
6876 .PD 1 | |
6877 . | |
6878 .TP | |
6879 .B padding=<0\-2> | |
6880 .PD 0 | |
6881 .RSs | |
6882 .IPs 0 | |
6883 none | |
6884 .IPs 1 | |
6885 all | |
6886 .IPs 2 | |
6887 adjust | |
6888 .RE | |
6889 .PD 1 | |
6890 . | |
6891 .TP | |
6892 .B "fast\ \ \ " | |
6893 Switch on faster encoding on subsequent VBR presets modes. | |
6894 This results in slightly lower quality and higher bitrates. | |
6895 . | |
6896 .TP | |
6897 .B highpassfreq=<freq> | |
6898 Set a highpass filtering frequency in Hz. | |
6899 Frequencies below the specified one will be cut off. | |
6900 A value of -1 will disable filtering, a value of 0 | |
6901 will let LAME choose values automatically. | |
6902 . | |
6903 .TP | |
6904 .B lowpassfreq=<freq> | |
6905 Set a lowpass filtering frequency in Hz. | |
6906 Frequencies above the specified one will be cut off. | |
6907 A value of -1 will disable filtering, a value of 0 | |
6908 will let LAME choose values automatically. | |
6909 . | |
6910 .TP | |
6911 .B preset=<value> | |
6912 preset values | |
6913 .RSs | |
6914 .IPs "help\ " | |
6915 Print additional options and information about presets settings. | |
6916 .IPs medium | |
6917 VBR encoding, good quality, 150\-180 kbps bitrate range | |
6918 .IPs standard | |
6919 VBR encoding, high quality, 170\-210 kbps bitrate range | |
6920 .IPs extreme | |
6921 VBR encoding, very high quality, 200\-240 kbps bitrate range | |
6922 .IPs insane | |
6923 CBR encoding, highest preset quality, 320 kbps bitrate | |
6924 .IPs <8\-320> | |
6925 ABR encoding at average given kbps bitrate | |
6926 .RE | |
6927 .sp 1 | |
6928 .RS | |
6929 .I EXAMPLES: | |
6930 .RE | |
6931 .PD 0 | |
6932 .RSs | |
6933 .IPs fast:preset=standard | |
6934 suitable for most people and most music types and already quite high quality | |
6935 .IPs cbr:preset=192 | |
6936 Encode with ABR presets at a 192 kbps forced constant bitrate. | |
6937 .IPs preset=172 | |
6938 Encode with ABR presets at a 172 kbps average bitrate. | |
6939 .IPs preset=extreme | |
6940 for people with extremely good hearing and similar equipment | |
6941 .RE | |
6942 .PD 1 | |
6943 . | |
6944 . | |
6945 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively) | |
6946 . | |
6947 .TP | |
6948 .B br=<32\-384> | |
6949 In CBR mode this parameter indicates the bitrate in kbps, | |
6950 when in VBR mode it is the minimum bitrate allowed per frame. | |
6951 VBR mode will not work with a value below 112. | |
6952 . | |
6953 .TP | |
6954 .B vbr=<-50\-50> (VBR only) | |
6955 variability range; if negative the encoder shifts the average bitrate | |
6956 towards the lower limit, if positive towards the higher. | |
6957 When set to 0 CBR is used (default). | |
6958 . | |
6959 .TP | |
6960 .B maxvbr=<32\-384> (VBR only) | |
6961 maximum bitrate allowed per frame, in kbps | |
6962 . | |
6963 .TP | |
6964 .B mode=<stereo | jstereo | mono | dual> | |
6965 (default: mono for 1-channel audio, stereo otherwise) | |
6966 . | |
6967 .TP | |
6968 .B psy=<-1\-4> | |
6969 psychoacoustic model (default: 2) | |
6970 . | |
6971 .TP | |
6972 .B errprot=<0 | 1> | |
6973 Include error protection. | |
6974 . | |
6975 .TP | |
6976 .B debug=<0\-10> | |
6977 debug level | |
6978 .RE | |
6979 .PD 1 | |
6980 . | |
6981 . | |
6982 .SS faac (\-faacopts) | |
6983 . | |
6984 .TP | |
6985 .B br=<bitrate> | |
6986 average bitrate in kbps (mutually exclusive with quality) | |
6987 . | |
6988 .TP | |
6989 .B quality=<1\-1000> | |
6990 quality mode, the higher the better (mutually exclusive with br) | |
6991 . | |
6992 .TP | |
6993 .B object=<1\-4> | |
6994 object type complexity | |
6995 .PD 0 | |
6996 .RSs | |
6997 .IPs 1 | |
6998 MAIN (default) | |
6999 .IPs 2 | |
7000 LOW | |
7001 .IPs 3 | |
7002 SSR | |
7003 .IPs 4 | |
7004 LTP (extremely slow) | |
7005 .RE | |
7006 .PD 1 | |
7007 . | |
7008 .TP | |
7009 .B mpeg=<2|4> | |
7010 MPEG version (default: 4) | |
7011 . | |
7012 .TP | |
7013 .B "tns\ \ \ \ " | |
7014 Enables temporal noise shaping. | |
7015 . | |
7016 .TP | |
7017 .B cutoff=<0\-sampling_rate/2> | |
7018 cutoff frequency (default: sampling_rate/2) | |
7019 . | |
7020 .TP | |
7021 .B "raw\ \ \ \ " | |
7022 Stores the bitstream as raw payload with extradata in the container header | |
7023 (default: 0, corresponds to ADTS). | |
7024 Do not set this flag if not explicitly required or you will not be able to | |
7025 remux the audio stream later on. | |
7026 .RE | |
7027 .PD 1 | |
7028 . | |
7029 . | |
7030 .SS lavc (\-lavcopts) | |
7031 . | |
7032 Many libavcodec (lavc for short) options are tersely documented. | |
7033 Read the source for full details. | |
7034 .PP | |
7035 .I EXAMPLE: | |
7036 .PD 0 | |
7037 .RSs | |
7038 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 | |
7039 .RE | |
7040 .PD 1 | |
7041 . | |
7042 .TP | |
7043 .B acodec=<value> | |
7044 audio codec (default: mp2) | |
7045 .PD 0 | |
7046 .RSs | |
7047 .IPs "mp2\ \ " | |
7048 MPEG Layer 2 | |
7049 .IPs "mp3\ \ " | |
7050 MPEG Layer 3 | |
7051 .IPs "ac3\ \ " | |
7052 AC3 | |
7053 .IPs adpcm_ima_wav | |
7054 IMA Adaptive PCM (4bits per sample, 4:1 compression) | |
7055 .IPs "sonic\ " | |
7056 Experimental lossy/lossless codec | |
7057 .RE | |
7058 .PD 1 | |
7059 . | |
7060 .TP | |
7061 .B abitrate=<value> | |
7062 audio bitrate in kbps (default: 224) | |
7063 . | |
7064 .TP | |
7065 .B atag=<value> | |
7066 Use the specified Windows audio format tag (e.g.\& atag=0x55). | |
7067 . | |
7068 .TP | |
7069 .B bit_exact | |
7070 Use only bit exact algorithms (except (I)DCT). | |
7071 Additionally bit_exact disables several optimizations and thus | |
7072 should only be used for regression tests, which need binary | |
7073 identical files even if the encoder version changes. | |
7074 This also suppresses the user_data header in MPEG-4 streams. | |
7075 Do not use this option unless you know exactly what you are doing. | |
7076 . | |
7077 .TP | |
7078 .B threads=<1\-8> | |
7079 Maximum number of threads to use (default: 1). | |
7080 May have a slight negative effect on motion estimation. | |
7081 .RE | |
7082 . | |
7083 .TP | |
7084 .B vcodec=<value> | |
7085 Employ the specified codec (default: mpeg4). | |
7086 .PD 0 | |
7087 .RSs | |
7088 .IPs mjpeg | |
7089 Motion JPEG | |
7090 .IPs ljpeg | |
7091 Lossless JPEG | |
7092 .IPs "h261\ " | |
7093 H.261 | |
7094 .IPs "h263\ " | |
7095 H.263 | |
7096 .IPs h263p | |
7097 H.263+ | |
7098 .IPs mpeg4 | |
7099 MPEG-4 (DivX 4/5) | |
7100 .IPs msmpeg4 | |
7101 DivX 3 | |
7102 .IPs msmpeg4v2 | |
7103 MS MPEG4v2 | |
7104 .IPs "wmv1\ " | |
7105 Windows Media Video, version 1 (AKA WMV7) | |
7106 .IPs "wmv2\ " | |
7107 Windows Media Video, version 2 (AKA WMV8) | |
7108 .IPs "rv10\ " | |
7109 an old RealVideo codec | |
7110 .IPs mpeg1video | |
7111 MPEG-1 video | |
7112 .IPs mpeg2video | |
7113 MPEG-2 video | |
7114 .IPs huffyuv | |
7115 HuffYUV | |
7116 .IPs ffvhuff (also see: vstrict) | |
7117 nonstandard 20% smaller HuffYUV using YV12 | |
7118 .IPs "asv1\ " | |
7119 ASUS Video v1 | |
7120 .IPs "asv2\ " | |
7121 ASUS Video v2 | |
7122 .IPs "ffv1 (also see: vstrict)" | |
7123 FFmpeg's lossless video codec | |
7124 .IPs "flv\ \ " | |
7125 Sorenson H.263 used in Flash Video | |
7126 .IPs dvvideo | |
7127 Sony Digital Video | |
7128 .IPs "svq1\ " | |
7129 Apple Sorenson Video 1 | |
7130 .IPs "snow (also see: vstrict)" | |
7131 FFmpeg's experimental wavelet-based codec | |
7132 .RE | |
7133 .PD 1 | |
7134 . | |
7135 .TP | |
7136 .B vqmin=<1\-31> | |
7137 minimum quantizer (pass 1/2) | |
7138 .RSs | |
7139 .IPs 1 | |
7140 Not recommended (much larger file, little quality difference and weird side | |
7141 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused | |
7142 resulting in lower quality and some decoders will not be able to decode it). | |
7143 .IPs 2 | |
7144 Recommended for normal mpeg4/\:mpeg1video encoding (default). | |
7145 .IPs 3 | |
7146 Recommended for h263(p)/\:msmpeg4. | |
7147 The reason for preferring 3 over 2 is that 2 could lead to overflows. | |
7148 (This will be fixed for h263(p) by changing the quantizer per MB in | |
7149 the future, msmpeg4 cannot be fixed as it does not support that.) | |
7150 .RE | |
7151 . | |
7152 .TP | |
7153 .B lmin=<0.01\-255.0> | |
20768 | 7154 Minimum frame-level Lagrange multiplier for ratecontrol (default: 2.0). |
7155 Lavc will rarely use quantizers below the value of lmin. | |
7156 Lowering lmin will make lavc more likely to choose lower quantizers for | |
7157 some frames, but not lower than the value of vqmin. | |
7158 Likewise, raising lmin will make lavc less likely to choose low | |
7159 quantizers, even if vqmin would have allowed them. | |
7160 You probably want to set lmin approximately equal to vqmin. | |
7161 When adaptive quantization is in use, changing lmin/lmax may have less | |
7162 of an effect; see mblmin/mblmax. | |
20707 | 7163 .RE |
7164 . | |
7165 .TP | |
7166 .B lmax=<0.01\-255.0> | |
7167 maximum Lagrange multiplier for ratecontrol (default: 31.0) | |
7168 .RE | |
7169 . | |
7170 .TP | |
20768 | 7171 .B mblmin=<0.01\-255.0> |
7172 Minimum macroblock-level Lagrange multiplier for ratecontrol | |
7173 (default:2.0). | |
7174 This parameter affects adaptive quantization options like qprd, | |
7175 lumi_mask, etc.. | |
7176 .RE | |
7177 . | |
7178 .TP | |
7179 .B mblmax=<0.01\-255.0> | |
7180 Maximum macroblock-level Lagrange multiplier for ratecontrol | |
7181 (default: 31.0). | |
7182 .RE | |
7183 . | |
7184 .TP | |
20707 | 7185 .B vqscale=<0\-31> |
7186 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode). | |
7187 A lower value means better quality but larger files (default: 0). | |
7188 In case of snow codec, value 0 means lossless encoding. | |
7189 Since the other codecs do not support this, vqscale=0 will be ignored and | |
7190 variable quantizers are used, which is the default. | |
7191 1 is not recommended (see vqmin for details). | |
7192 . | |
7193 .TP | |
7194 .B vqmax=<1\-31> | |
7195 Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31). | |
7196 . | |
7197 .TP | |
7198 .B mbqmin=<1\-31> | |
7199 obsolete, use vqmin | |
7200 . | |
7201 .TP | |
7202 .B mbqmax=<1\-31> | |
7203 obsolete, use vqmax | |
7204 . | |
7205 .TP | |
7206 .B vqdiff=<1\-31> | |
7207 maximum quantizer difference between consecutive I- or P-frames | |
7208 (pass 1/2) (default: 3) | |
7209 . | |
7210 .TP | |
7211 .B vmax_b_frames=<0\-4> | |
7212 maximum number of B-frames between non-B-frames: | |
7213 .PD 0 | |
7214 .RSs | |
7215 .IPs 0 | |
7216 no B-frames (default) | |
7217 .IPs 0\-2 | |
7218 sane range for MPEG-4 | |
7219 .RE | |
7220 .PD 1 | |
7221 . | |
7222 .TP | |
7223 .B vme=<0\-5> | |
7224 motion estimation method. | |
7225 Available methods are: | |
7226 .PD 0 | |
7227 .RSs | |
7228 .IPs 0 | |
7229 none (very low quality) | |
7230 .IPs 1 | |
7231 full (slow, currently unmaintained and disabled) | |
7232 .IPs 2 | |
7233 log (low quality, currently unmaintained and disabled) | |
7234 .IPs 3 | |
7235 phods (low quality, currently unmaintained and disabled) | |
7236 .IPs 4 | |
7237 EPZS: size=1 diamond, size can be adjusted with the *dia options | |
7238 (default) | |
7239 .IPs 5 | |
7240 X1 (experimental, currently aliased to EPZS) | |
7241 .IPs 8 | |
7242 iter (iterative overlapped block, only used in snow) | |
7243 .RE | |
7244 .PD 1 | |
7245 .sp 1 | |
7246 .RS | |
7247 .br | |
7248 .I NOTE: | |
7249 0\-3 currently ignores the amount of bits spent, | |
7250 so quality may be low. | |
7251 .RE | |
7252 . | |
7253 .TP | |
7254 .B me_range=<0\-9999> | |
7255 motion estimation search range (default: 0 (unlimited)) | |
7256 . | |
7257 .TP | |
7258 .B mbd=<0\-2> | |
7259 Macroblock decision algorithm (high quality mode), encode each macro | |
7260 block in all modes and choose the best. | |
7261 This is slow but results in better quality and file size. | |
7262 .PD 0 | |
7263 .RSs | |
7264 .IPs 0 | |
7265 Use mbcmp (default). | |
7266 .IPs 1 | |
7267 Select the MB mode which needs the fewest bits (=vhq). | |
7268 .IPs 2 | |
7269 Select the MB mode which has the best rate distortion. | |
7270 .RE | |
7271 .PD 1 | |
7272 . | |
7273 .TP | |
7274 .B "vhq\ \ \ \ " | |
7275 Same as mbd=1, kept for compatibility reasons. | |
7276 . | |
7277 .TP | |
7278 .B "v4mv\ \ \ " | |
7279 Allow 4 motion vectors per macroblock (slightly better quality). | |
7280 Works better if used with mbd>0. | |
7281 . | |
7282 .TP | |
7283 .B "obmc\ \ \ " | |
7284 overlapped block motion compensation (H.263+) | |
7285 . | |
7286 .TP | |
7287 .B "loop\ \ \ " | |
7288 loop filter (H.263+) | |
7289 note, this is broken | |
7290 . | |
7291 .TP | |
7292 .B inter_threshold <-1000\-1000> | |
7293 Does absolutely nothing at the moment. | |
7294 . | |
7295 .TP | |
7296 .B keyint=<0\-300> | |
7297 maximum interval between keyframes in frames (default: 250 or one | |
7298 keyframe every ten seconds in a 25fps movie. | |
7299 This is the recommended default for MPEG-4). | |
7300 Most codecs require regular keyframes in order to limit the accumulation of mismatch error. | |
7301 Keyframes are also needed for seeking, as seeking is only possible to a keyframe - but | |
7302 keyframes need more space than other frames, so larger numbers here mean | |
7303 slightly smaller files but less precise seeking. | |
7304 0 is equivalent to 1, which makes every frame a keyframe. | |
7305 Values >300 are not recommended as the quality might be bad depending upon | |
7306 decoder, encoder and luck. | |
7307 It is a common for MPEG-1/2 to use values <=30. | |
7308 . | |
7309 .TP | |
7310 .B sc_threshold=<-1000000000\-1000000000> | |
7311 Threshold for scene change detection. | |
7312 A keyframe is inserted by libavcodec when it detects a scene change. | |
7313 You can specify the sensitivity of the detection with this option. | |
7314 -1000000000 means there is a scene change detected at every frame, | |
7315 1000000000 means no scene changes are detected (default: 0). | |
7316 . | |
7317 .TP | |
7318 .B sc_factor=<any positive integer> | |
7319 Causes frames with higher quantizers to be more likely to trigger a | |
7320 scene change detection and make libavcodec use an I-frame (default: 1). | |
7321 1\-16 is a sane range. | |
7322 Values between 2 and 6 may yield increasing PSNR (up to approximately | |
7323 0.04 dB) and better placement of I-frames in high-motion scenes. | |
7324 Higher values than 6 may give very slightly better PSNR (approximately | |
7325 0.01 dB more than sc_factor=6), but noticably worse visual quality. | |
7326 . | |
7327 .TP | |
7328 .B vb_strategy=<0\-2> (pass one only) | |
7329 strategy to choose between I/P/B-frames: | |
7330 .PD 0 | |
7331 .RSs | |
7332 .IPs 0 | |
7333 Always use the maximum number of B-frames (default). | |
7334 .IPs 1 | |
7335 Avoid B-frames in high motion scenes. | |
7336 See the b_sensitivity option to tune this strategy. | |
7337 .IPs 2 | |
7338 Places B-frames more or less optimally to yield maximum quality (slower). | |
7339 You may want to reduce the speed impact of this option by tuning the | |
7340 option brd_scale. | |
7341 .RE | |
7342 .PD 1 | |
7343 . | |
7344 .TP | |
7345 .B b_sensitivity=<any integer greater than 0> | |
7346 Adjusts how sensitively vb_strategy=1 detects motion and avoids using | |
7347 B-frames (default: 40). | |
7348 Lower sensitivities will result in more B-frames. | |
7349 Using more B-frames usually improves PSNR, but too many B-frames can | |
7350 hurt quality in high-motion scenes. | |
7351 Unless there is an extremely high amount of motion, b_sensitivity can | |
7352 safely be lowered below the default; 10 is a reasonable value in most | |
7353 cases. | |
7354 . | |
7355 .TP | |
7356 .B brd_scale=<0\-10> | |
7357 Downscales frames for dynamic B-frame decision (default: 0). | |
7358 Each time brd_scale is increased by one, the frame dimensions are | |
7359 divided by two, which improves speed by a factor of four. | |
7360 Both dimensions of the fully downscaled frame must be even numbers, so | |
7361 brd_scale=1 requires the original dimensions to be multiples of four, | |
7362 brd_scale=2 requires multiples of eight, etc. | |
7363 In other words, the dimensions of the original frame must both be | |
7364 divisible by 2^(brd_scale+1) with no remainder. | |
7365 . | |
7366 .TP | |
7367 .B bidir_refine=<0\-4> | |
7368 Refine the two motion vectors used in bidirectional macroblocks, | |
7369 rather than re-using vectors from the forward and backward searches. | |
7370 This option has no effect without B-frames. | |
7371 .PD 0 | |
7372 .RSs | |
7373 .IPs 0 | |
7374 Disabled (default). | |
7375 .IPs 1\-4 | |
7376 Use a wider search (larger values are slower). | |
7377 .RE | |
7378 .PD 1 | |
7379 . | |
7380 .TP | |
7381 .B vpass=<1\-3> | |
7382 Activates internal two (or more) pass mode, only specify if you wish to | |
7383 use two (or more) pass encoding. | |
7384 .PD 0 | |
7385 .RSs | |
7386 .IPs 1 | |
7387 first pass (also see turbo) | |
7388 .IPs 2 | |
7389 second pass | |
7390 .IPs 3 | |
7391 Nth pass (second and subsequent passes of N-pass encoding) | |
7392 .RE | |
7393 .RS | |
7394 Here is how it works, and how to use it: | |
7395 .br | |
7396 The first pass (vpass=1) writes the statistics file. | |
7397 You might want to deactivate some CPU-hungry options, like "turbo" | |
7398 mode does. | |
7399 .br | |
7400 In two pass mode, the second pass (vpass=2) reads the statistics file and | |
7401 bases ratecontrol decisions on it. | |
7402 .br | |
7403 In N-pass mode, the second pass (vpass=3, that is not a typo) | |
7404 does both: It first reads the statistics, then overwrites them. | |
7405 You might want to backup divx2pass.log before doing this if there is | |
7406 any possibility that you will have to cancel MEncoder. | |
7407 You can use all encoding options, except very CPU-hungry options like "qns". | |
7408 .br | |
7409 You can run this same pass over and over to refine the encode. | |
7410 Each subsequent pass will use the statistics from the previous pass to improve. | |
7411 The final pass can include any CPU-hungry encoding options. | |
7412 .br | |
7413 If you want a 2 pass encode, use first vpass=1, and then vpass=2. | |
7414 .br | |
7415 If you want a 3 or more pass encode, use vpass=1 for the first pass | |
7416 and then vpass=3 and then vpass=3 again and again until you are | |
7417 satisfied with the encode. | |
7418 .RE | |
7419 .PD 1 | |
7420 .sp 1 | |
7421 .RS | |
7422 huffyuv: | |
7423 .RE | |
7424 .PD 0 | |
7425 .RSs | |
7426 .IPs "pass 1" | |
7427 Saves statistics. | |
7428 .IPs "pass 2" | |
7429 Encodes with an optimal Huffman table based upon statistics | |
7430 from the first pass. | |
7431 .RE | |
7432 .PD 1 | |
7433 . | |
7434 .TP | |
7435 .B turbo (two pass only) | |
7436 Dramatically speeds up pass one using faster algorithms and disabling | |
7437 CPU-intensive options. | |
7438 This will probably reduce global PSNR a little bit (around 0.01dB) and | |
7439 change individual frame type and PSNR a little bit more (up to 0.03dB). | |
7440 . | |
7441 .TP | |
7442 .B aspect=<x/y> | |
7443 Store movie aspect internally, just like with MPEG files. | |
7444 Much nicer than rescaling, because quality is not decreased. | |
7445 Only MPlayer will play these files correctly, other players will display | |
7446 them with wrong aspect. | |
7447 The aspect parameter can be given as a ratio or a floating point number. | |
7448 .sp 1 | |
7449 .RS | |
7450 .I EXAMPLE: | |
7451 .RE | |
7452 .RSs | |
7453 .PD 0 | |
7454 .IPs "aspect=16/9 or aspect=1.78" | |
7455 .PD 1 | |
7456 .RE | |
7457 . | |
7458 .TP | |
7459 .B autoaspect | |
7460 Same as the aspect option, but automatically computes aspect, taking | |
7461 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
7462 filter chain. | |
7463 Does not incur a performance penalty, so you can safely leave it | |
7464 always on. | |
7465 . | |
7466 .TP | |
7467 .B vbitrate=<value> | |
7468 Specify bitrate (pass 1/2) (default: 800). | |
7469 .br | |
7470 .I WARNING: | |
7471 1kbit = 1000 bits | |
7472 .PD 0 | |
7473 .RSs | |
7474 .IPs 4\-16000 | |
7475 (in kbit) | |
7476 .IPs 16001\-24000000 | |
7477 (in bit) | |
7478 .RE | |
7479 .PD 1 | |
7480 . | |
7481 .TP | |
7482 .B vratetol=<value> | |
7483 approximated file size tolerance in kbit. | |
7484 1000\-100000 is a sane range. | |
7485 (warning: 1kbit = 1000 bits) | |
7486 (default: 8000) | |
7487 .br | |
7488 .I NOTE: | |
7489 vratetol should not be too large during the second pass or there might | |
7490 be problems if vrc_(min|max)rate is used. | |
7491 . | |
7492 .TP | |
7493 .B vrc_maxrate=<value> | |
7494 maximum bitrate in kbit/\:sec (pass 1/2) | |
7495 (default: 0, unlimited) | |
7496 . | |
7497 .TP | |
7498 .B vrc_minrate=<value> | |
7499 minimum bitrate in kbit/\:sec (pass 1/2) | |
7500 (default: 0, unlimited) | |
7501 . | |
7502 .TP | |
7503 .B vrc_buf_size=<value> | |
7504 buffer size in kbit (pass 1/2). | |
7505 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD, | |
7506 917 for SVCD and 1835 for DVD. | |
7507 . | |
7508 .TP | |
7509 .B vrc_buf_aggressivity | |
7510 currently useless | |
7511 . | |
7512 .TP | |
7513 .B vrc_strategy | |
7514 Ratecontrol method. | |
7515 Note that some of the ratecontrol-affecting options will have no effect | |
7516 if vrc_strategy is not set to 0. | |
7517 .PD 0 | |
7518 .RSs | |
7519 .IPs 0 | |
7520 Use internal lavc ratecontrol (default). | |
7521 .IPs 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
7522 Use Xvid ratecontrol (experimental; requires MEncoder to be compiled |
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
7523 with support for Xvid 1.1 or higher). |
20707 | 7524 .RE |
7525 .PD 1 | |
7526 . | |
7527 .TP | |
7528 .B vb_qfactor=<-31.0\-31.0> | |
7529 quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7530 . | |
7531 .TP | |
7532 .B vi_qfactor=<-31.0\-31.0> | |
7533 quantizer factor between I- and non-I-frames (pass 1/2) (default: 0.8) | |
7534 . | |
7535 .TP | |
7536 .B vb_qoffset=<-31.0\-31.0> | |
7537 quantizer offset between B- and non-B-frames (pass 1/2) (default: 1.25) | |
7538 . | |
7539 .TP | |
7540 .B vi_qoffset=<-31.0\-31.0> | |
7541 (pass 1/2) (default: 0.0) | |
7542 .br | |
7543 if v{b|i}_qfactor > 0 | |
7544 .br | |
7545 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset | |
7546 .br | |
7547 else | |
7548 .br | |
7549 do normal ratecontrol (do not lock to next P-frame quantizer) and | |
7550 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset | |
7551 .br | |
7552 .I HINT: | |
7553 To do constant quantizer encoding with different quantizers for | |
7554 I/P- and B-frames you can use: | |
7555 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>. | |
7556 . | |
7557 .TP | |
7558 .B vqblur=<0.0\-1.0> (pass one) | |
7559 Quantizer blur (default: 0.5), larger values will average the | |
7560 quantizer more over time (slower change). | |
7561 .PD 0 | |
7562 .RSs | |
7563 .IPs 0.0 | |
7564 Quantizer blur disabled. | |
7565 .IPs 1.0 | |
7566 Average the quantizer over all previous frames. | |
7567 .RE | |
7568 .PD 1 | |
7569 . | |
7570 .TP | |
7571 .B vqblur=<0.0\-99.0> (pass two) | |
7572 Quantizer gaussian blur (default: 0.5), larger values will average | |
7573 the quantizer more over time (slower change). | |
7574 . | |
7575 .TP | |
7576 .B vqcomp=<0.0\-1.0> | |
7577 Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5). | |
7578 For instance, assuming the default rate control equation is used, | |
7579 if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits | |
7580 needed to encode them all at the same QP. | |
7581 If vqcomp=0.0, the ratecontrol allocates the same number of bits to each | |
7582 frame, i.e. strict CBR. | |
7583 .I NOTE: | |
7584 Those are extreme settings and should never be used. | |
7585 Perceptual quality will be optimal somewhere in between these two extremes. | |
7586 . | |
7587 .TP | |
7588 .B vrc_eq=<equation> | |
7589 main ratecontrol equation (pass 1/2) | |
7590 .RE | |
7591 .RSs | |
7592 .IPs "1\ \ \ \ " | |
7593 constant bitrate | |
7594 .IPs "tex\ \ " | |
7595 constant quality | |
7596 .IPs 1+(tex/\:avgTex-1)*qComp | |
7597 approximately the equation of the old ratecontrol code | |
7598 .IPs tex^qComp | |
7599 with qcomp 0.5 or something like that (default) | |
7600 .RE | |
7601 .PP | |
7602 .RS | |
7603 infix operators: | |
7604 .RE | |
7605 .RSs | |
7606 .IPs +,-,*,/,^ | |
7607 .RE | |
7608 .PP | |
7609 .RS | |
7610 variables: | |
7611 .RE | |
7612 .RSs | |
7613 .IPs "tex\ \ " | |
7614 texture complexity | |
7615 .IPs iTex,pTex | |
7616 intra, non-intra texture complexity | |
7617 .IPs avgTex | |
7618 average texture complexity | |
7619 .IPs avgIITex | |
7620 average intra texture complexity in I-frames | |
7621 .IPs avgPITex | |
7622 average intra texture complexity in P-frames | |
7623 .IPs avgPPTex | |
7624 average non-intra texture complexity in P-frames | |
7625 .IPs avgBPTex | |
7626 average non-intra texture complexity in B-frames | |
7627 .IPs "mv\ \ \ " | |
7628 bits used for motion vectors | |
7629 .IPs fCode | |
7630 maximum length of motion vector in log2 scale | |
7631 .IPs iCount | |
7632 number of intra macroblocks / number of macroblocks | |
7633 .IPs "var\ \ " | |
7634 spatial complexity | |
7635 .IPs mcVar | |
7636 temporal complexity | |
7637 .IPs qComp | |
7638 qcomp from the command line | |
7639 .IPs "isI, isP, isB" | |
7640 Is 1 if picture type is I/P/B else 0. | |
7641 .IPs "Pi,E\ " | |
7642 See your favorite math book. | |
7643 .RE | |
7644 .PP | |
7645 .RS | |
7646 functions: | |
7647 .RE | |
7648 .RSs | |
7649 .IPs max(a,b),min(a,b) | |
7650 maximum / minimum | |
7651 .IPs gt(a,b) | |
7652 is 1 if a>b, 0 otherwise | |
7653 .IPs lt(a,b) | |
7654 is 1 if a<b, 0 otherwise | |
7655 .IPs eq(a,b) | |
7656 is 1 if a==b, 0 otherwise | |
7657 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs" | |
7658 .RE | |
7659 . | |
7660 .TP | |
7661 .B vrc_override=<options> | |
7662 User specified quality for specific parts (ending, credits, ...) (pass 1/2). | |
7663 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>, | |
7664 <end-frame>, <quality>[/...]]: | |
7665 .PD 0 | |
7666 .RSs | |
7667 .IPs "quality (2\-31)" | |
7668 quantizer | |
7669 .IPs "quality (-500\-0)" | |
7670 quality correction in % | |
7671 .RE | |
7672 .PD 1 | |
7673 . | |
7674 .TP | |
7675 .B vrc_init_cplx=<0\-1000> | |
7676 initial complexity (pass 1) | |
7677 . | |
7678 .TP | |
7679 .B vrc_init_occupancy=<0.0\-1.0> | |
7680 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9) | |
7681 . | |
7682 .TP | |
7683 .B vqsquish=<0|1> | |
7684 Specify how to keep the quantizer between qmin and qmax (pass 1/2). | |
7685 .PD 0 | |
7686 .RSs | |
7687 .IPs 0 | |
7688 Use clipping. | |
7689 .IPs 1 | |
7690 Use a nice differentiable function (default). | |
7691 .RE | |
7692 .PD 1 | |
7693 . | |
7694 .TP | |
7695 .B vlelim=<-1000\-1000> | |
7696 Sets single coefficient elimination threshold for luminance. | |
7697 Negative values will also consider the DC coefficient (should be at least -4 | |
7698 or lower for encoding at quant=1): | |
7699 .PD 0 | |
7700 .RSs | |
7701 .IPs 0 | |
7702 disabled (default) | |
7703 .IPs -4 | |
7704 JVT recommendation | |
7705 .RE | |
7706 .PD 1 | |
7707 . | |
7708 .TP | |
7709 .B vcelim=<-1000\-1000> | |
7710 Sets single coefficient elimination threshold for chrominance. | |
7711 Negative values will also consider the DC coefficient (should be at least -4 | |
7712 or lower for encoding at quant=1): | |
7713 .PD 0 | |
7714 .RSs | |
7715 .IPs 0 | |
7716 disabled (default) | |
7717 .IPs 7 | |
7718 JVT recommendation | |
7719 .RE | |
7720 .PD 1 | |
7721 . | |
7722 .TP | |
7723 .B vstrict=<-2|-1|0|1> | |
7724 strict standard compliance | |
7725 .PD 0 | |
7726 .RSs | |
7727 .IPs 0 | |
7728 disabled | |
7729 .IPs 1 | |
7730 Only recommended if you want to feed the output into the | |
7731 MPEG-4 reference decoder. | |
7732 .IPs -1 | |
7733 Allow libavcodec specific extensions (default). | |
7734 .IPs -2 | |
7735 Enables experimental codecs and features which may not be playable | |
7736 with future MPlayer versions (snow, ffvhuff, ffv1). | |
7737 .RE | |
7738 .PD 1 | |
7739 . | |
7740 .TP | |
7741 .B "vdpart\ " | |
7742 Data partitioning. | |
7743 Adds 2 Bytes per video packet, improves error-resistance when transferring over | |
7744 unreliable channels (e.g.\& streaming over the internet). | |
7745 Each video packet will be encoded in 3 separate partitions: | |
7746 .PD 0 | |
7747 .RSs | |
7748 .IPs "1. MVs" | |
7749 movement | |
7750 .IPs "2. DC coefficients" | |
7751 low res picture | |
7752 .IPs "3. AC coefficients" | |
7753 details | |
7754 .RE | |
7755 .PD 1 | |
7756 .RS | |
7757 MV & DC are most important, loosing them looks far worse than loosing | |
7758 the AC and the 1. & 2. partition. | |
7759 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors | |
7760 will hit the AC partition much more often than the MV & DC partitions. | |
7761 Thus, the picture will look better with partitioning than without, | |
7762 as without partitioning an error will trash AC/\:DC/\:MV equally. | |
7763 .RE | |
7764 . | |
7765 .TP | |
7766 .B vpsize=<0\-10000> (also see vdpart) | |
7767 Video packet size, improves error-resistance. | |
7768 .PD 0 | |
7769 .RSs | |
7770 .IPs "0\ \ \ \ " | |
7771 disabled (default) | |
7772 .IPs 100\-1000 | |
7773 good choice | |
7774 .RE | |
7775 .PD 1 | |
7776 . | |
7777 .TP | |
7778 .B "ss\ \ \ \ \ " | |
7779 slice structured mode for H.263+ | |
7780 . | |
7781 .TP | |
7782 .B "gray\ \ \ " | |
7783 grayscale only encoding (faster) | |
7784 . | |
7785 .TP | |
7786 .B vfdct=<0\-10> | |
7787 DCT algorithm | |
7788 .PD 0 | |
7789 .RSs | |
7790 .IPs 0 | |
7791 Automatically select a good one (default). | |
7792 .IPs 1 | |
7793 fast integer | |
7794 .IPs 2 | |
7795 accurate integer | |
7796 .IPs 3 | |
7797 MMX | |
7798 .IPs 4 | |
7799 mlib | |
7800 .IPs 5 | |
7801 AltiVec | |
7802 .IPs 6 | |
7803 floating point AAN | |
7804 .RE | |
7805 .PD 1 | |
7806 . | |
7807 .TP | |
7808 .B idct=<0\-99> | |
7809 IDCT algorithm | |
7810 .br | |
7811 .I NOTE: | |
7812 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests. | |
7813 .PD 0 | |
7814 .RSs | |
7815 .IPs 0 | |
7816 Automatically select a good one (default). | |
7817 .IPs 1 | |
7818 JPEG reference integer | |
7819 .IPs 2 | |
7820 simple | |
7821 .IPs 3 | |
7822 simplemmx | |
7823 .IPs 4 | |
7824 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100) | |
7825 .IPs 5 | |
7826 ps2 | |
7827 .IPs 6 | |
7828 mlib | |
7829 .IPs 7 | |
7830 arm | |
7831 .IPs 8 | |
7832 AltiVec | |
7833 .IPs 9 | |
7834 sh4 | |
7835 .RE | |
7836 .PD 1 | |
7837 . | |
7838 .TP | |
7839 .B lumi_mask=<0.0\-1.0> | |
7840 Luminance masking is a 'psychosensory' setting that is supposed to | |
7841 make use of the fact that the human eye tends to notice fewer details | |
7842 in very bright parts of the picture. | |
7843 Luminance masking compresses bright areas stronger than medium ones, | |
7844 so it will save bits that can be spent again on other frames, raising | |
7845 overall subjective quality, while possibly reducing PSNR. | |
7846 .br | |
7847 .I WARNING: | |
7848 Be careful, overly large values can cause disastrous things. | |
7849 .br | |
7850 .I WARNING: | |
7851 Large values might look good on some monitors but may look horrible | |
7852 on other monitors. | |
7853 .PD 0 | |
7854 .RSs | |
7855 .IPs "0.0\ \ " | |
7856 disabled (default) | |
7857 .IPs 0.0\-0.3 | |
7858 sane range | |
7859 .RE | |
7860 .PD 1 | |
7861 . | |
7862 .TP | |
7863 .B dark_mask=<0.0\-1.0> | |
7864 Darkness masking is a 'psychosensory' setting that is supposed to | |
7865 make use of the fact that the human eye tends to notice fewer details | |
7866 in very dark parts of the picture. | |
7867 Darkness masking compresses dark areas stronger than medium ones, | |
7868 so it will save bits that can be spent again on other frames, raising | |
7869 overall subjective quality, while possibly reducing PSNR. | |
7870 .br | |
7871 .I WARNING: | |
7872 Be careful, overly large values can cause disastrous things. | |
7873 .br | |
7874 .I WARNING: | |
7875 Large values might look good on some monitors but may look horrible | |
7876 on other monitors / TV / TFT. | |
7877 .PD 0 | |
7878 .RSs | |
7879 .IPs "0.0\ \ " | |
7880 disabled (default) | |
7881 .IPs 0.0\-0.3 | |
7882 sane range | |
7883 .RE | |
7884 .PD 1 | |
7885 . | |
7886 .TP | |
7887 .B tcplx_mask=<0.0\-1.0> | |
7888 Temporal complexity masking (default: 0.0 (disabled)). | |
7889 Imagine a scene with a bird flying across the whole scene; tcplx_mask | |
7890 will raise the quantizers of the bird's macroblocks (thus decreasing their | |
7891 quality), as the human eye usually does not have time to see all the bird's | |
7892 details. | |
7893 Be warned that if the masked object stops (e.g.\& the bird lands) it is | |
7894 likely to look horrible for a short period of time, until the encoder | |
7895 figures out that the object is not moving and needs refined blocks. | |
7896 The saved bits will be spent on other parts of the video, which may increase | |
7897 subjective quality, provided that tcplx_mask is carefully chosen. | |
7898 . | |
7899 .TP | |
7900 .B scplx_mask=<0.0\-1.0> | |
7901 Spatial complexity masking. | |
7902 Larger values help against blockiness, if no deblocking filter is used for | |
7903 decoding, which is maybe not a good idea. | |
7904 .br | |
7905 Imagine a scene with grass (which usually has great spatial complexity), | |
7906 a blue sky and a house; scplx_mask will raise the quantizers of the grass' | |
7907 macroblocks, thus decreasing its quality, in order to spend more bits on | |
7908 the sky and the house. | |
7909 .br | |
7910 .I HINT: | |
7911 Crop any black borders completely as they will reduce the quality | |
7912 of the macroblocks (also applies without scplx_mask). | |
7913 .PD 0 | |
7914 .RSs | |
7915 .IPs "0.0\ \ " | |
7916 disabled (default) | |
7917 .IPs 0.0\-0.5 | |
7918 sane range | |
7919 .RE | |
7920 .PD 1 | |
7921 .sp 1 | |
7922 .RS | |
7923 .I NOTE: | |
7924 This setting does not have the same effect as using a custom matrix that | |
7925 would compress high frequencies harder, as scplx_mask will reduce the | |
7926 quality of P blocks even if only DC is changing. | |
7927 The result of scplx_mask will probably not look as good. | |
7928 .RE | |
7929 . | |
7930 .TP | |
7931 .B p_mask=<0.0\-1.0> (also see vi_qfactor) | |
7932 Reduces the quality of inter blocks. | |
7933 This is equivalent to increasing the quality of intra blocks, because the | |
7934 same average bitrate will be distributed by the rate controller to the | |
7935 whole video sequence (default: 0.0 (disabled)). | |
7936 p_mask=1.0 doubles the bits allocated to each intra block. | |
7937 . | |
7938 .TP | |
7939 .B border_mask=<0.0\-1.0> | |
7940 border-processing for MPEG-style encoders. | |
7941 Border processing increases the quantizer for macroblocks which are less | |
7942 than 1/5th of the frame width/height away from the frame border, | |
7943 since they are often visually less important. | |
7944 . | |
7945 .TP | |
7946 .B "naq\ \ \ \ " | |
7947 Normalize adaptive quantization (experimental). | |
7948 When using adaptive quantization (*_mask), the average per-MB quantizer may no | |
7949 longer match the requested frame-level quantizer. | |
7950 Naq will attempt to adjust the per-MB quantizers to maintain the proper | |
7951 average. | |
7952 . | |
7953 .TP | |
7954 .B "ildct\ \ " | |
7955 Use interlaced DCT. | |
7956 . | |
7957 .TP | |
7958 .B "ilme\ \ \ " | |
7959 Use interlaced motion estimation (mutually exclusive with qpel). | |
7960 . | |
7961 .TP | |
7962 .B "alt\ \ \ \ " | |
7963 Use alternative scantable. | |
7964 . | |
7965 .TP | |
7966 .B "top=<-1\-1>\ \ \ " | |
7967 .PD 0 | |
7968 .RSs | |
7969 .IPs -1 | |
7970 automatic | |
7971 .IPs 0 | |
7972 bottom field first | |
7973 .IPs 1 | |
7974 top field first | |
7975 .RE | |
7976 .PD 1 | |
7977 . | |
7978 .TP | |
7979 .B format=<value> | |
7980 .PD 0 | |
7981 .RSs | |
7982 .IPs "YV12\ " | |
7983 default | |
7984 .IPs "444P\ " | |
7985 for ffv1 | |
7986 .IPs "422P\ " | |
7987 for HuffYUV, lossless JPEG and ffv1 | |
7988 .IPs 411P,YVU9 | |
7989 for lossless JPEG and ffv1 | |
7990 .IPs BGR32 | |
7991 for lossless JPEG and ffv1 | |
7992 .RE | |
7993 .PD 1 | |
7994 . | |
7995 .TP | |
7996 .B "pred\ \ \ " | |
7997 (for HuffYUV) | |
7998 .PD 0 | |
7999 .RSs | |
8000 .IPs 0 | |
8001 left prediction | |
8002 .IPs 1 | |
8003 plane/\:gradient prediction | |
8004 .IPs 2 | |
8005 median prediction | |
8006 .RE | |
8007 .PD 1 | |
8008 . | |
8009 .TP | |
8010 .B "pred\ \ \ " | |
8011 (for lossless JPEG) | |
8012 .PD 0 | |
8013 .RSs | |
8014 .IPs 0 | |
8015 left prediction | |
8016 .IPs 1 | |
8017 top prediction | |
8018 .IPs 2 | |
8019 topleft prediction | |
8020 .IPs 3 | |
8021 plane/\:gradient prediction | |
8022 .IPs 6 | |
8023 mean prediction | |
8024 .RE | |
8025 .PD 1 | |
8026 . | |
8027 .TP | |
8028 .B "coder\ \ " | |
8029 (for ffv1) | |
8030 .PD 0 | |
8031 .RSs | |
8032 .IPs 0 | |
8033 vlc coding (Golomb-Rice) | |
8034 .IPs 1 | |
8035 arithmetic coding (CABAC) | |
8036 .RE | |
8037 .PD 1 | |
8038 . | |
8039 .TP | |
8040 .B context | |
8041 (for ffv1) | |
8042 .PD 0 | |
8043 .RSs | |
8044 .IPs 0 | |
8045 small context model | |
8046 .IPs 1 | |
8047 large context model | |
8048 .RE | |
8049 .PD 1 | |
8050 .sp 1 | |
8051 .RS | |
8052 (for ffvhuff) | |
8053 .RE | |
8054 .PD 0 | |
8055 .RSs | |
8056 .IPs 0 | |
8057 predetermined Huffman tables (builtin or two pass) | |
8058 .IPs 1 | |
8059 adaptive Huffman tables | |
8060 .RE | |
8061 .PD 1 | |
8062 . | |
8063 .TP | |
8064 .B "qpel\ \ \ " | |
8065 Use quarter pel motion compensation (mutually exclusive with ilme). | |
8066 .br | |
8067 .I HINT: | |
8068 This seems only useful for high bitrate encodings. | |
8069 . | |
8070 .TP | |
8071 .B mbcmp=<0\-2000> | |
8072 Sets the comparison function for the macroblock decision, only used if mbd=0. | |
8073 .PD 0 | |
8074 .RSs | |
8075 .IPs "0 (SAD)" | |
8076 sum of absolute differences, fast (default) | |
8077 .IPs "1 (SSE)" | |
8078 sum of squared errors | |
8079 .IPs "2 (SATD)" | |
8080 sum of absolute Hadamard transformed differences | |
8081 .IPs "3 (DCT)" | |
8082 sum of absolute DCT transformed differences | |
8083 .IPs "4 (PSNR)" | |
8084 sum of squared quantization errors (avoid, low quality) | |
8085 .IPs "5 (BIT)" | |
8086 number of bits needed for the block | |
8087 .IPs "6 (RD)" | |
8088 rate distortion optimal, slow | |
8089 .IPs "7 (ZERO)" | |
8090 0 | |
8091 .IPs "8 (VSAD)" | |
8092 sum of absolute vertical differences | |
8093 .IPs "9 (VSSE)" | |
8094 sum of squared vertical differences | |
8095 .IPs "10 (NSSE)" | |
8096 noise preserving sum of squared differences | |
8097 .IPs "11 (W53)" | |
8098 5/3 wavelet, only used in snow | |
8099 .IPs "12 (W97)" | |
8100 9/7 wavelet, only used in snow | |
8101 .IPs "+256\ " | |
8102 Also use chroma, currently does not work (correctly) with B-frames. | |
8103 .RE | |
8104 .PD 1 | |
8105 . | |
8106 .TP | |
8107 .B ildctcmp=<0\-2000> | |
8108 Sets the comparison function for interlaced DCT decision | |
8109 (see mbcmp for available comparison functions). | |
8110 . | |
8111 .TP | |
8112 .B precmp=<0\-2000> | |
8113 Sets the comparison function for motion estimation pre pass | |
8114 (see mbcmp for available comparison functions) (default: 0). | |
8115 . | |
8116 .TP | |
8117 .B cmp=<0\-2000> | |
8118 Sets the comparison function for full pel motion estimation | |
8119 (see mbcmp for available comparison functions) (default: 0). | |
8120 . | |
8121 .TP | |
8122 .B subcmp=<0\-2000> | |
8123 Sets the comparison function for sub pel motion estimation | |
8124 (see mbcmp for available comparison functions) (default: 0). | |
8125 . | |
8126 .TP | |
8127 .B nssew=<0\-1000000> | |
8128 This setting controls NSSE weight, where larger weights will result in | |
8129 more noise. | |
8130 0 NSSE is identical to SSE | |
8131 You may find this useful if you prefer to keep some noise in your encoded | |
8132 video rather than filtering it away before encoding (default: 8). | |
8133 . | |
8134 .TP | |
8135 .B predia=<-99\-6> | |
8136 diamond type and size for motion estimation pre-pass | |
8137 . | |
8138 .TP | |
8139 .B dia=<-99\-6> | |
8140 Diamond type & size for motion estimation. | |
8141 Motion search is an iterative process. | |
8142 Using a small diamond does not limit the search to finding only small | |
8143 motion vectors. | |
8144 It is just somewhat more likely to stop before finding the very best motion | |
8145 vector, especially when noise is involved. | |
8146 Bigger diamonds allow a wider search for the best motion vector, thus are | |
8147 slower but result in better quality. | |
8148 .br | |
8149 Big normal diamonds are better quality than shape-adaptive diamonds. | |
8150 .br | |
8151 Shape-adaptive diamonds are a good tradeoff between speed and quality. | |
8152 .br | |
8153 .I NOTE: | |
8154 The sizes of the normal diamonds and shape adaptive ones do not have | |
8155 the same meaning. | |
8156 .RSs | |
8157 .IPs -3 | |
8158 shape adaptive (fast) diamond with size 3 | |
8159 .IPs -2 | |
8160 shape adaptive (fast) diamond with size 2 | |
8161 .IPs -1 | |
21398
8234884ed8a7
r21410: document new meaning of dia=1 introduced by lavc r7192
voroshil
parents:
21386
diff
changeset
|
8162 uneven multi-hexagon search (slow) |
20707 | 8163 .IPs 1 |
8164 normal size=1 diamond (default) =EPZS type diamond | |
8165 .nf | |
8166 .ne | |
8167 0 | |
8168 000 | |
8169 0 | |
8170 .fi | |
8171 .IPs 2 | |
8172 normal size=2 diamond | |
8173 .nf | |
8174 .ne | |
8175 0 | |
8176 000 | |
8177 00000 | |
8178 000 | |
8179 0 | |
8180 .fi | |
8181 .RE | |
8182 . | |
8183 .TP | |
8184 .B "trell\ \ " | |
8185 Trellis searched quantization. | |
8186 This will find the optimal encoding for each 8x8 block. | |
8187 Trellis searched quantization is quite simply an optimal quantization in | |
8188 the PSNR versus bitrate sense (Assuming that there would be no rounding | |
8189 errors introduced by the IDCT, which is obviously not the case.). | |
8190 It simply finds a block for the minimum of error and lambda*bits. | |
8191 .PD 0 | |
8192 .RSs | |
8193 .IPs lambda | |
8194 quantization parameter (QP) dependent constant | |
8195 .IPs "bits\ " | |
8196 amount of bits needed to encode the block | |
8197 .IPs error | |
8198 sum of squared errors of the quantization | |
8199 .RE | |
8200 .PD 1 | |
8201 . | |
8202 .TP | |
8203 .B "cbp\ \ \ \ " | |
8204 Rate distorted optimal coded block pattern. | |
8205 Will select the coded block pattern which minimizes distortion + lambda*rate. | |
8206 This can only be used together with trellis quantization. | |
8207 . | |
8208 .TP | |
8209 .B "mv0\ \ \ \ " | |
8210 Try to encode each MB with MV=<0,0> and choose the better one. | |
8211 This has no effect if mbd=0. | |
8212 . | |
8213 .TP | |
8214 .B mv0_threshold=<any non-negative integer> | |
8215 When surrounding motion vectors are <0,0> and the motion estimation | |
8216 score of the current block is less than mv0_threshold, <0,0> is used for | |
8217 the motion vector and further motion estimation is skipped (default: | |
8218 256). | |
8219 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and | |
8220 possibly make the encoded video look slightly better; raising | |
8221 mv0_threshold past 320 results in diminished PSNR and visual quality. | |
8222 Higher values speed up encoding very slightly (usually less than 1%, | |
8223 depending on the other options used). | |
8224 .br | |
8225 .I NOTE: | |
8226 This option does not require mv0 to be enabled. | |
8227 . | |
8228 .TP | |
8229 .B qprd (mbd=2 only) | |
8230 rate distorted optimal quantization parameter (QP) for the given | |
8231 lambda of each macroblock | |
8232 . | |
8233 .TP | |
8234 .B last_pred=<0\-99> | |
8235 amount of motion predictors from the previous frame | |
8236 .PD 0 | |
8237 .RSs | |
8238 .IPs 0 | |
8239 (default) | |
8240 .IPs a | |
8241 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the | |
8242 previous frame. | |
8243 .RE | |
8244 .PD 1 | |
8245 . | |
8246 .TP | |
8247 .B preme=<0\-2> | |
8248 motion estimation pre-pass | |
8249 .PD 0 | |
8250 .RSs | |
8251 .IPs 0 | |
8252 disabled | |
8253 .IPs 1 | |
8254 only after I-frames (default) | |
8255 .IPs 2 | |
8256 always | |
8257 .RE | |
8258 .PD 1 | |
8259 . | |
8260 .TP | |
8261 .B subq=<1\-8> | |
8262 subpel refinement quality (for qpel) (default: 8 (high quality)) | |
8263 .br | |
8264 .I NOTE: | |
8265 This has a significant effect on speed. | |
8266 . | |
8267 .TP | |
8268 .B refs=<1\-8> | |
8269 number of reference frames to consider for motion compensation | |
8270 (Snow only) (default: 1) | |
8271 . | |
8272 .TP | |
8273 .B "psnr\ \ \ " | |
8274 print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8275 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'. | |
8276 Returned values are in dB (decibel), the higher the better. | |
8277 . | |
8278 .TP | |
8279 .B mpeg_quant | |
8280 Use MPEG quantizers instead of H.263. | |
8281 . | |
8282 .TP | |
8283 .B "aic\ \ \ \ " | |
8284 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+. | |
8285 This will improve quality very slightly (around 0.02 dB PSNR) and slow | |
8286 down encoding very slightly (about 1%). | |
8287 .br | |
8288 .I NOTE: | |
8289 vqmin should be 8 or larger for H.263+ AIC. | |
8290 . | |
8291 .TP | |
8292 .B "aiv\ \ \ \ " | |
8293 alternative inter vlc for H.263+ | |
8294 . | |
8295 .TP | |
8296 .B "umv\ \ \ \ " | |
8297 unlimited MVs (H.263+ only) | |
8298 Allows encoding of arbitrarily long MVs. | |
8299 . | |
8300 .TP | |
8301 .B ibias=<-256\-256> | |
8302 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96, | |
8303 H.263 style quantizer default: 0) | |
8304 .br | |
8305 .I NOTE: | |
8306 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8307 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8308 . | |
8309 .TP | |
8310 .B pbias=<-256\-256> | |
8311 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0, | |
8312 H.263 style quantizer default: -64) | |
8313 .br | |
8314 .I NOTE: | |
8315 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2), | |
8316 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2). | |
8317 .br | |
8318 .I HINT: | |
8319 A more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR. | |
8320 . | |
8321 .TP | |
8322 .B nr=<0\-100000> | |
8323 Noise reduction, 0 means disabled. | |
8324 0\-600 is a useful range for typical content, but you may want to turn it | |
8325 up a bit more for very noisy content (default: 0). | |
8326 Given its small impact on speed, you might want to prefer to use this over | |
8327 filtering noise away with video filters like denoise3d or hqdn3d. | |
8328 . | |
8329 .TP | |
8330 .B qns=<0\-3> | |
8331 Quantizer noise shaping. | |
8332 Rather than choosing quantization to most closely match the source video | |
8333 in the PSNR sense, it chooses quantization such that noise (usually ringing) | |
8334 will be masked by similar-frequency content in the image. | |
8335 Larger values are slower but may not result in better quality. | |
8336 This can and should be used together with trellis quantization, in which case | |
8337 the trellis quantization (optimal for constant weight) will be used as | |
8338 startpoint for the iterative search. | |
8339 .PD 0 | |
8340 .RSs | |
8341 .IPs 0 | |
8342 disabled (default) | |
8343 .IPs 1 | |
8344 Only lower the absolute value of coefficients. | |
8345 .IPs 2 | |
8346 Only change coefficients before the last non-zero coefficient + 1. | |
8347 .IPs 3 | |
8348 Try all. | |
8349 .RE | |
8350 .PD 1 | |
8351 . | |
8352 .TP | |
8353 .B inter_matrix=<comma separated matrix> | |
8354 Use custom inter matrix. | |
8355 It needs a comma separated string of 64 integers. | |
8356 . | |
8357 .TP | |
8358 .B intra_matrix=<comma separated matrix> | |
8359 Use custom intra matrix. | |
8360 It needs a comma separated string of 64 integers. | |
8361 . | |
8362 .TP | |
8363 .B vqmod_amp | |
8364 experimental quantizer modulation | |
8365 . | |
8366 .TP | |
8367 .B vqmod_freq | |
8368 experimental quantizer modulation | |
8369 . | |
8370 .TP | |
8371 .B "dc\ \ \ \ \ " | |
8372 intra DC precision in bits (default: 8). | |
8373 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11. | |
8374 . | |
8375 .TP | |
8376 .B cgop (also see sc_threshold) | |
8377 Close all GOPs. | |
8378 Currently it only works if scene change detection is disabled | |
8379 (sc_threshold=1000000000). | |
8380 . | |
8381 .TP | |
8382 .B vglobal=<0\-3> | |
8383 Control writing global video headers. | |
8384 .PD 0 | |
8385 .RSs | |
8386 .IPs 0 | |
8387 Codec decides where to write global headers (default). | |
8388 .IPs 1 | |
8389 Write global headers only in extradata (needed for .mp4/MOV/NUT). | |
8390 .IPs 2 | |
8391 Write global headers only in front of keyframes. | |
8392 .IPs 3 | |
8393 Combine 1 and 2. | |
8394 .RE | |
8395 .PD 1 | |
8396 . | |
8397 .TP | |
8398 .B aglobal=<0\-3> | |
8399 Same as vglobal for audio headers. | |
8400 . | |
8401 . | |
8402 .SS nuv (\-nuvopts) | |
8403 . | |
8404 Nuppel video is based on RTJPEG and LZO. | |
8405 By default frames are first encoded with RTJPEG and then compressed with LZO, | |
8406 but it is possible to disable either or both of the two passes. | |
8407 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG, | |
8408 or the default LZO compressed RTJPEG. | |
8409 .br | |
8410 .I NOTE: | |
8411 The nuvrec documentation contains some advice and examples about the | |
8412 settings to use for the most common TV encodings. | |
8413 . | |
8414 .TP | |
8415 .B c=<0\-20> | |
8416 chrominance threshold (default: 1) | |
8417 . | |
8418 .TP | |
8419 .B l=<0\-20> | |
8420 luminance threshold (default: 1) | |
8421 . | |
8422 .TP | |
8423 .B "lzo\ \ \ \ " | |
8424 Enable LZO compression (default). | |
8425 . | |
8426 .TP | |
8427 .B "nolzo\ \ " | |
8428 Disable LZO compression. | |
8429 . | |
8430 .TP | |
8431 .B q=<3\-255> | |
8432 quality level (default: 255) | |
8433 . | |
8434 .TP | |
8435 .B "raw \ \ \ " | |
8436 Disable RTJPEG encoding. | |
8437 . | |
8438 .TP | |
8439 .B "rtjpeg\ " | |
8440 Enable RTJPEG encoding (default). | |
8441 . | |
8442 . | |
8443 .SS xvidenc (\-xvidencopts) | |
8444 . | |
8445 There are three modes available: constant bitrate (CBR), fixed quantizer and | |
8446 two pass. | |
8447 . | |
8448 .TP | |
8449 .B pass=<1|2> | |
8450 Specify the pass in two pass mode. | |
8451 . | |
8452 .TP | |
8453 .B turbo (two pass only) | |
8454 Dramatically speeds up pass one using faster algorithms and disabling | |
8455 CPU-intensive options. | |
8456 This will probably reduce global PSNR a little bit and change individual | |
8457 frame type and PSNR a little bit more. | |
8458 . | |
8459 .TP | |
8460 .B bitrate=<value> (CBR or two pass mode) | |
8461 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second | |
8462 if >16000. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8463 If <value> is negative, Xvid will use its absolute value as the target size |
20707 | 8464 (in kBytes) of the video and compute the associated bitrate automagically |
8465 (default: 687 kbits/s). | |
8466 . | |
8467 .TP | |
8468 .B fixed_quant=<1\-31> | |
8469 Switch to fixed quantizer mode and specify the quantizer to be used. | |
8470 . | |
8471 .TP | |
8472 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode) | |
8473 User specified quality for specific parts (ending, credits, ...). | |
8474 Each zone is <start-frame>,<mode>,<value> where <mode> may be | |
8475 .PD 0 | |
8476 .RSs | |
8477 .IPs "q" | |
8478 Constant quantizer override, where value=<2.0\-31.0> | |
8479 represents the quantizer value. | |
8480 .IPs "w" | |
8481 Ratecontrol weight override, where value=<0.01\-2.00> | |
8482 represents the quality correction in %. | |
8483 .RE | |
8484 .PD 1 | |
8485 .sp 1 | |
8486 .RS | |
8487 .I EXAMPLE: | |
8488 .RE | |
8489 .PD 0 | |
8490 .RSs | |
8491 .IPs zones=90000,q,20 | |
8492 Encodes all frames starting with frame 90000 at constant quantizer 20. | |
8493 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20 | |
8494 Encode frames 0\-10000 at 10% bitrate, encode frames 90000 | |
8495 up to the end at constant quantizer 20. | |
8496 Note that the second zone is needed to delimit the first zone, as | |
8497 without it everything up until frame 89999 would be encoded at 10% | |
8498 bitrate. | |
8499 .RE | |
8500 .PD 1 | |
8501 . | |
8502 .TP | |
8503 .B me_quality=<0\-6> | |
8504 This option controls the motion estimation subsystem. | |
8505 The higher the value, the more precise the estimation should be (default: 6). | |
8506 The more precise the motion estimation is, the more bits can be saved. | |
8507 Precision is gained at the expense of CPU time so decrease this setting if | |
8508 you need realtime encoding. | |
8509 . | |
8510 .TP | |
8511 .B (no)qpel | |
8512 MPEG-4 uses a half pixel precision for its motion search by default. | |
8513 The standard proposes a mode where encoders are allowed to use quarter | |
8514 pixel precision. | |
8515 This option usually results in a sharper image. | |
8516 Unfortunately it has a great impact on bitrate and sometimes the | |
8517 higher bitrate use will prevent it from giving a better image | |
8518 quality at a fixed bitrate. | |
8519 It is better to test with and without this option and see whether it | |
8520 is worth activating. | |
8521 . | |
8522 .TP | |
8523 .B (no)gmc | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8524 Enable Global Motion Compensation, which makes Xvid generate special |
20707 | 8525 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images. |
8526 Whether or not the use of this option will save bits is highly | |
8527 dependent on the source material. | |
8528 . | |
8529 .TP | |
8530 .B (no)trellis | |
8531 Trellis Quantization is a kind of adaptive quantization method that | |
8532 saves bits by modifying quantized coefficients to make them more | |
8533 compressible by the entropy encoder. | |
8534 Its impact on quality is good, and if VHQ uses too much CPU for you, | |
8535 this setting can be a good alternative to save a few bits (and gain | |
8536 quality at fixed bitrate) at a lesser cost than with VHQ (default: on). | |
8537 . | |
8538 .TP | |
8539 .B (no)cartoon | |
8540 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
|
8541 It modifies some Xvid internal thresholds so Xvid takes better decisions on |
20707 | 8542 frame types and motion vectors for flat looking cartoons. |
8543 . | |
8544 .TP | |
8545 .B (no)chroma_me | |
8546 The usual motion estimation algorithm uses only the luminance information to | |
8547 find the best motion vector. | |
8548 However for some video material, using the chroma planes can help find | |
8549 better vectors. | |
8550 This setting toggles the use of chroma planes for motion estimation | |
8551 (default: on). | |
8552 . | |
8553 .TP | |
8554 .B (no)chroma_opt | |
8555 Enable a chroma optimizer prefilter. | |
8556 It will do some extra magic on color information to minimize the | |
8557 stepped-stairs effect on edges. | |
8558 It will improve quality at the cost of encoding speed. | |
8559 It reduces PSNR by nature, as the mathematical deviation to the original | |
8560 picture will get bigger, but the subjective image quality will raise. | |
8561 Since it works with color information, you might want to turn it off when | |
8562 encoding in grayscale. | |
8563 . | |
8564 .TP | |
8565 .B (no)hq_ac | |
8566 Activates high-quality prediction of AC coefficients for intra frames from | |
8567 neighbor blocks (default: on). | |
8568 . | |
8569 .TP | |
8570 .B vhq=<0\-4> | |
8571 The motion search algorithm is based on a search in the usual color domain | |
8572 and tries to find a motion vector that minimizes the difference between the | |
8573 reference frame and the encoded frame. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8574 With this setting activated, Xvid will also use the frequency domain (DCT) |
20707 | 8575 to search for a motion vector that minimizes not only the spatial |
8576 difference but also the encoding length of the block. | |
8577 Fastest to slowest: | |
8578 .PD 0 | |
8579 .RSs | |
8580 .IPs 0 | |
8581 off | |
8582 .IPs 1 | |
8583 mode decision (inter/\:intra MB) (default) | |
8584 .IPs 2 | |
8585 limited search | |
8586 .IPs 3 | |
8587 medium search | |
8588 .IPs 4 | |
8589 wide search | |
8590 .RE | |
8591 .PD 1 | |
8592 . | |
8593 .TP | |
8594 .B (no)lumi_mask | |
8595 Adaptive quantization allows the macroblock quantizers to vary inside | |
8596 each frame. | |
8597 This is a 'psychosensory' setting that is supposed to make use of the | |
8598 fact that the human eye tends to notice fewer details in very bright | |
8599 and very dark parts of the picture. | |
8600 It compresses those areas more strongly than medium ones, which will | |
8601 save bits that can be spent again on other frames, raising overall | |
8602 subjective quality and possibly reducing PSNR. | |
8603 . | |
8604 .TP | |
21021 | 8605 .B (no)grayscale |
8606 Make Xvid discard chroma planes so the encoded video is grayscale only. | |
8607 Note that this does not speed up encoding, it just prevents chroma data | |
8608 from being written in the last stage of encoding. | |
8609 . | |
8610 .TP | |
8611 .B (no)interlacing | |
8612 Encode the fields of interlaced video material. | |
8613 Turn this option on for interlaced content. | |
8614 .br | |
8615 .I NOTE: | |
8616 Should you rescale the video, you would need an interlace-aware resizer, | |
8617 which you can activate with \-vf scale=<width>:<height>:1. | |
8618 . | |
8619 .TP | |
20707 | 8620 .B min_iquant=<0\-31> |
8621 minimum I-frame quantizer (default: 2) | |
8622 . | |
8623 .TP | |
8624 .B max_iquant=<0\-31> | |
8625 maximum I-frame quantizer (default: 31) | |
8626 . | |
8627 .TP | |
8628 .B min_pquant=<0\-31> | |
8629 minimum P-frame quantizer (default: 2) | |
8630 . | |
8631 .TP | |
8632 .B max_pquant=<0\-31> | |
8633 maximum P-frame quantizer (default: 31) | |
8634 . | |
8635 .TP | |
8636 .B min_bquant=<0\-31> | |
8637 minimum B-frame quantizer (default: 2) | |
8638 . | |
8639 .TP | |
8640 .B max_bquant=<0\-31> | |
8641 maximum B-frame quantizer (default: 31) | |
8642 . | |
8643 .TP | |
21021 | 8644 .B min_key_interval=<value> (two pass only) |
8645 minimum interval between keyframes (default: 0) | |
8646 . | |
8647 .TP | |
8648 .B max_key_interval=<value> | |
8649 maximum interval between keyframes (default: 10*fps) | |
8650 . | |
8651 .TP | |
8652 .B quant_type=<h263|mpeg> | |
8653 Sets the type of quantizer to use. | |
8654 For high bitrates, you will find that MPEG quantization preserves more detail. | |
8655 For low bitrates, the smoothing of H.263 will give you less block noise. | |
8656 When using custom matrices, MPEG quantization | |
8657 .B must | |
8658 be used. | |
8659 . | |
8660 .TP | |
20707 | 8661 .B quant_intra_matrix=<filename> |
8662 Load a custom intra matrix file. | |
8663 You can build such a file with xvid4conf's matrix editor. | |
8664 . | |
8665 .TP | |
8666 .B quant_inter_matrix=<filename> | |
8667 Load a custom inter matrix file. | |
8668 You can build such a file with xvid4conf's matrix editor. | |
8669 . | |
8670 .TP | |
21021 | 8671 .B keyframe_boost=<0\-1000> (two pass mode only) |
8672 Shift some bits from the pool for other frame types to intra frames, | |
8673 thus improving keyframe quality. | |
8674 This amount is an extra percentage, so a value of 10 will give | |
8675 your keyframes 10% more bits than normal | |
8676 (default: 0). | |
8677 . | |
8678 .TP | |
8679 .B kfthreshold=<value> (two pass mode only) | |
8680 Works together with kfreduction. | |
8681 Determines the minimum distance below which you consider that | |
8682 two frames are considered consecutive and treated differently | |
8683 according to kfreduction | |
8684 (default: 10). | |
8685 . | |
8686 .TP | |
8687 .B kfreduction=<0\-100> (two pass mode only) | |
8688 The above two settings can be used to adjust the size of keyframes that | |
8689 you consider too close to the first (in a row). | |
8690 kfthreshold sets the range in which keyframes are reduced, and | |
8691 kfreduction determines the bitrate reduction they get. | |
8692 The last I-frame will get treated normally | |
8693 (default: 30). | |
8694 . | |
8695 .TP | |
8696 .B max_bframes=<0\-4> | |
8697 Maximum number of B-frames to put between I/P-frames (default: 2). | |
8698 . | |
8699 .TP | |
8700 .B bquant_ratio=<0\-1000> | |
8701 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150) | |
8702 . | |
8703 .TP | |
8704 .B bquant_offset=<-1000\-1000> | |
8705 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100) | |
8706 . | |
8707 .TP | |
8708 .B bf_threshold=<-255\-255> | |
8709 This setting allows you to specify what priority to place on the use of | |
8710 B-frames. | |
8711 The higher the value, the higher the probability of B-frames being used | |
8712 (default: 0). | |
8713 Do not forget that B-frames usually have a higher quantizer, and therefore | |
8714 aggressive production of B-frames may cause worse visual quality. | |
8715 . | |
8716 .TP | |
8717 .B (no)closed_gop | |
8718 This option tells Xvid to close every GOP (Group Of Pictures bounded | |
8719 by two I-frames), which makes GOPs independent from each other. | |
8720 This just implies that the last frame of the GOP is either a P-frame or a | |
8721 N-frame but not a B-frame. | |
8722 It is usually a good idea to turn this option on (default: on). | |
8723 . | |
8724 .TP | |
8725 .B (no)packed | |
8726 This option is meant to solve frame-order issues when encoding to | |
8727 container formats like AVI that cannot cope with out-of-order frames. | |
8728 In practice, most decoders (both software and hardware) are able to deal | |
8729 with frame-order themselves, and may get confused when this option is | |
8730 turned on, so you can safely leave if off, unless you really know what | |
8731 you are doing. | |
8732 .br | |
8733 .I WARNING: | |
8734 This will generate an illegal bitstream, and will not be | |
8735 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:Xvid. | |
8736 .br | |
8737 .I WARNING: | |
8738 This will also store a fake DivX version in the file so the bug | |
8739 autodetection of some decoders might be confused. | |
8740 . | |
8741 .TP | |
8742 .B frame_drop_ratio=<0\-100> (max_bframes=0 only) | |
8743 This setting allows the creation of variable framerate video streams. | |
8744 The value of the setting specifies a threshold under which, if the | |
8745 difference of the following frame to the previous frame is below or equal | |
8746 to this threshold, a frame gets not coded (a so called n-vop is placed | |
8747 in the stream). | |
8748 On playback, when reaching an n-vop the previous frame will be displayed. | |
8749 .br | |
8750 .I WARNING: | |
8751 Playing with this setting may result in a jerky video, so use it at your | |
8752 own risks! | |
8753 . | |
8754 .TP | |
8755 .B rc_reaction_delay_factor=<value> | |
8756 This parameter controls the number of frames the CBR rate controller | |
8757 will wait before reacting to bitrate changes and compensating for them | |
8758 to obtain a constant bitrate over an averaging range of frames. | |
8759 . | |
8760 .TP | |
8761 .B rc_averaging_period=<value> | |
8762 Real CBR is hard to achieve. | |
8763 Depending on the video material, bitrate can be variable, and hard to predict. | |
8764 Therefore Xvid uses an averaging period for which it guarantees a given | |
8765 amount of bits (minus a small variation). | |
8766 This settings expresses the "number of frames" for which Xvid averages | |
8767 bitrate and tries to achieve CBR. | |
8768 . | |
8769 .TP | |
8770 .B rc_buffer=<value> | |
8771 size of the rate control buffer | |
8772 . | |
8773 .TP | |
20707 | 8774 .B curve_compression_high=<0\-100> |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8775 This setting allows Xvid to take a certain percentage of bits away from |
20707 | 8776 high bitrate scenes and give them back to the bit reservoir. |
8777 You could also use this if you have a clip with so many bits allocated | |
8778 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad | |
8779 (default: 0). | |
8780 . | |
8781 .TP | |
8782 .B curve_compression_low=<0\-100> | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8783 This setting allows Xvid to give a certain percentage of extra bits to the |
20707 | 8784 low bitrate scenes, taking a few bits from the entire clip. |
8785 This might come in handy if you have a few low-bitrate scenes that are | |
8786 still blocky (default: 0). | |
8787 . | |
8788 .TP | |
8789 .B overflow_control_strength=<0\-100> | |
8790 During pass one of two pass encoding, a scaled bitrate curve is computed. | |
8791 The difference between that expected curve and the result obtained during | |
8792 encoding is called overflow. | |
8793 Obviously, the two pass rate controller tries to compensate for that overflow, | |
8794 distributing it over the next frames. | |
8795 This setting controls how much of the overflow is distributed every time | |
8796 there is a new frame. | |
8797 Low values allow lazy overflow control, big rate bursts are compensated for | |
8798 more slowly (could lead to lack of precision for small clips). | |
8799 Higher values will make changes in bit redistribution more abrupt, possibly | |
8800 too abrupt if you set it too high, creating artifacts (default: 5). | |
8801 .br | |
8802 .I NOTE: | |
8803 This setting impacts quality a lot, play with it carefully! | |
8804 . | |
8805 .TP | |
8806 .B max_overflow_improvement=<0\-100> | |
8807 During the frame bit allocation, overflow control may increase the frame | |
8808 size. | |
8809 This parameter specifies the maximum percentage by which the overflow | |
8810 control is allowed to increase the frame size, compared to the ideal curve | |
8811 allocation | |
8812 (default: 5). | |
8813 . | |
8814 .TP | |
8815 .B max_overflow_degradation=<0\-100> | |
8816 During the frame bit allocation, overflow control may decrease the frame | |
8817 size. | |
8818 This parameter specifies the maximum percentage by which the overflow | |
8819 control is allowed to decrease the frame size, compared to the ideal curve | |
8820 allocation | |
8821 (default: 5). | |
8822 . | |
8823 .TP | |
8824 .B container_frame_overhead=<0...> | |
8825 Specifies a frame average overhead per frame, in bytes. | |
8826 Most of the time users express their target bitrate for video w/o taking | |
8827 care of the video container overhead. | |
8828 This small but (mostly) constant overhead can cause the target file size | |
8829 to be exceeded. | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8830 Xvid allows users to set the amount of overhead per frame the |
20707 | 8831 container generates (give only an average per frame). |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8832 0 has a special meaning, it lets Xvid use its own default values |
20707 | 8833 (default: 24 \- AVI average overhead). |
8834 . | |
8835 .TP | |
8836 .B profile=<profile_name> | |
8837 Restricts options and VBV (peak bitrate over a short period) according to | |
8838 the Simple, Advanced Simple and DivX profiles. | |
8839 The resulting videos should be playable on standalone players adhering to these | |
8840 profile specifications. | |
8841 .PD 0 | |
8842 .RSs | |
8843 .IPs unrestricted | |
8844 no restrictions (default) | |
8845 .IPs "sp0\ \ " | |
8846 simple profile at level 0 | |
8847 .IPs "sp1\ \ " | |
8848 simple profile at level 1 | |
8849 .IPs "sp2\ \ " | |
8850 simple profile at level 2 | |
8851 .IPs "sp3\ \ " | |
8852 simple profile at level 3 | |
8853 .IPs "asp0\ " | |
8854 advanced simple profile at level 0 | |
8855 .IPs "asp1\ " | |
8856 advanced simple profile at level 1 | |
8857 .IPs "asp2\ " | |
8858 advanced simple profile at level 2 | |
8859 .IPs "asp3\ " | |
8860 advanced simple profile at level 3 | |
8861 .IPs "asp4\ " | |
8862 advanced simple profile at level 4 | |
8863 .IPs "asp5\ " | |
8864 advanced simple profile at level 5 | |
8865 .IPs dxnhandheld | |
8866 DXN handheld profile | |
8867 .IPs dxnportntsc | |
8868 DXN portable NTSC profile | |
8869 .IPs dxnportpal | |
8870 DXN portable PAL profile | |
8871 .IPs dxnhtntsc | |
8872 DXN home theater NTSC profile | |
8873 .IPs dxnhtpal | |
8874 DXN home theater PAL profile | |
8875 .IPs dxnhdtv | |
8876 DXN HDTV profile | |
8877 .RE | |
8878 .PD 1 | |
8879 .RS | |
8880 .I NOTE: | |
8881 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
|
8882 Generally DX50 is applicable, as some players do not recognize Xvid but |
20707 | 8883 most recognize DivX. |
8884 .RE | |
8885 . | |
8886 .TP | |
8887 .B par=<mode> | |
8888 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR, | |
8889 the Display Aspect Ratio). | |
8890 PAR is the ratio of the width and height of a single pixel. | |
8891 So both are related like this: DAR = PAR * (width/height). | |
8892 .br | |
8893 MPEG-4 defines 5 pixel aspect ratios and one extended | |
8894 one, giving the opportunity to specify a specific pixel aspect | |
8895 ratio. | |
8896 5 standard modes can be specified: | |
8897 .PD 0 | |
8898 .RSs | |
8899 .IPs vga11 | |
8900 It is the usual PAR for PC content. | |
8901 Pixels are a square unit. | |
8902 .IPs pal43 | |
8903 PAL standard 4:3 PAR. | |
8904 Pixels are rectangles. | |
8905 .IPs pal169 | |
8906 same as above | |
8907 .IPs ntsc43 | |
8908 same as above | |
8909 .IPs ntsc169 | |
8910 same as above (Do not forget to give the exact ratio.) | |
8911 .IPs "ext\ \ " | |
8912 Allows you to specify your own pixel aspect ratio with par_width and | |
8913 par_height. | |
8914 .RE | |
8915 .PD 1 | |
8916 .RS | |
8917 .I NOTE: | |
8918 In general, setting aspect and autoaspect options is enough. | |
8919 .RE | |
8920 . | |
8921 .TP | |
8922 .B par_width=<1\-255> (par=ext only) | |
8923 Specifies the width of the custom pixel aspect ratio. | |
8924 . | |
8925 .TP | |
8926 .B par_height=<1\-255> (par=ext only) | |
8927 Specifies the height of the custom pixel aspect ratio. | |
8928 . | |
8929 .TP | |
8930 .B aspect=<x/y | f (float value)> | |
8931 Store movie aspect internally, just like MPEG files. | |
8932 Much nicer solution than rescaling, because quality is not decreased. | |
8933 MPlayer and a few others players will play these files correctly, others | |
8934 will display them with the wrong aspect. | |
8935 The aspect parameter can be given as a ratio or a floating point number. | |
8936 . | |
8937 .TP | |
8938 .B (no)autoaspect | |
8939 Same as the aspect option, but automatically computes aspect, taking | |
8940 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the | |
8941 filter chain. | |
8942 . | |
8943 .TP | |
8944 .B "psnr\ \ \ " | |
8945 Print the PSNR (peak signal to noise ratio) for the whole video after encoding | |
8946 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in | |
8947 the current directory. | |
8948 Returned values are in dB (decibel), the higher the better. | |
8949 . | |
21021 | 8950 .TP |
8951 .B "debug\ \ " | |
8952 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control | |
8953 file.) | |
8954 .RE | |
8955 . | |
20707 | 8956 .PP |
8957 .sp 1 | |
20881
ae265b1dbecd
r20872: Clarify -dumpaudio, it is not useful normally
voroshil
parents:
20832
diff
changeset
|
8958 The following option is only available in Xvid 1.1.x. |
20707 | 8959 . |
8960 .TP | |
8961 .B bvhq=<0|1> | |
8962 This setting allows vector candidates for B-frames to be used for | |
8963 the encoding chosen using a rate distortion optimized operator, | |
8964 which is what is done for P-frames by the vhq option. | |
8965 This produces nicer-looking B-frames while incurring almost no | |
8966 performance penalty (default: 1). | |
8967 . | |
8968 .PP | |
8969 .sp 1 | |
21021 | 8970 The following option is only available in the 1.2.x version of Xvid. |
20707 | 8971 . |
8972 .TP | |
8973 .B threads=<0\-n> | |
8974 Create n threads to run the motion estimation (default: 0). | |
8975 The maximum number of threads that can be used is the picture height | |
8976 divided by 16. | |
8977 . | |
8978 . | |
8979 .SS x264enc (\-x264encopts) | |
8980 . | |
8981 .TP | |
8982 .B bitrate=<value> | |
8983 Sets the average bitrate to be used in kbits/\:second (default: off). | |
8984 Since local bitrate may vary, this average may be inaccurate for | |
8985 very short videos (see ratetol). | |
8986 Constant bitrate can be achieved by combining this with vbv_maxrate, | |
8987 at significant reduction in quality. | |
8988 . | |
8989 .TP | |
8990 .B qp=<0\-51> | |
8991 This selects the quantizer to use for P-frames. | |
8992 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively. | |
8993 20\-40 is a useful range (default: 26). | |
8994 Lower values result in better fidelity, but higher bitrates. | |
8995 0 is lossless. | |
8996 Note that quantization in H.264 works differently from MPEG-1/2/4: | |
8997 H.264's quantization parameter (QP) is on a logarithmic scale. | |
8998 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP). | |
8999 For example, MPEG at QP=2 is equivalent to H.264 at QP=18. | |
9000 . | |
9001 .TP | |
9002 .B crf=<1\-50> | |
9003 Enables constant quality mode, and selects the quality. | |
9004 The scale is similar to QP. | |
9005 Like the bitrate-based modes, this allows each frame to use a | |
9006 different QP based on the frame's complexity. | |
9007 . | |
9008 .TP | |
9009 .B pass=<1\-3> | |
9010 Enable 2 or 3-pass mode. | |
9011 It is recommended to always encode in 2 or 3-pass mode as it leads to a | |
9012 better bit distribution and improves overall quality. | |
9013 .PD 0 | |
9014 .RSs | |
9015 .IPs 1 | |
9016 first pass | |
9017 .IPs 2 | |
9018 second pass (of two pass encoding) | |
9019 .IPs 3 | |
9020 Nth pass (second and third passes of three pass encoding) | |
9021 .RE | |
9022 .RS | |
9023 Here is how it works, and how to use it: | |
9024 .br | |
9025 The first pass (pass=1) collects statistics on the video and writes them | |
9026 to a file. | |
9027 You might want to deactivate some CPU-hungry options, apart from the ones | |
9028 that are on by default. | |
9029 .br | |
9030 In two pass mode, the second pass (pass=2) reads the statistics file and | |
9031 bases ratecontrol decisions on it. | |
9032 .br | |
9033 In three pass mode, the second pass (pass=3, that is not a typo) | |
9034 does both: It first reads the statistics, then overwrites them. | |
9035 You can use all encoding options, except very CPU-hungry options. | |
9036 .br | |
9037 The third pass (pass=3) is the same as the second pass, except that it has | |
9038 the second pass' statistics to work from. | |
9039 You can use all encoding options, including CPU-hungry ones. | |
9040 .br | |
9041 The first pass may use either average bitrate or constant quantizer. | |
9042 ABR is recommended, since it does not require guessing a quantizer. | |
9043 Subsequent passes are ABR, and must specify bitrate. | |
9044 .REss | |
9045 . | |
9046 .TP | |
9047 .B turbo=<0\-2> | |
9048 Fast first pass mode. | |
9049 During the first pass of a two or more pass encode it is possible to gain | |
9050 speed by disabling some options with negligible or even no impact on the | |
9051 final pass output quality. | |
9052 .PD 0 | |
9053 .RSs | |
9054 .IPs 0 | |
9055 disabled (default) | |
9056 .IPs 1 | |
9057 Reduce subq, frameref and disable some inter-macroblock partition analysis | |
9058 modes. | |
9059 .IPs 2 | |
9060 Reduce subq and frameref to 1, use a diamond ME search and disable all | |
9061 partition analysis modes. | |
9062 .RE | |
9063 .RS | |
9064 Level 1 can increase first pass speed up to 2x with no change in the global | |
9065 PSNR of the final pass compared to a full quality first pass. | |
9066 .br | |
9067 Level 2 can increase first pass speed up to 4x with about +/- 0.05dB change | |
9068 in the global PSNR of the final pass compared to a full quality first pass. | |
9069 .REss | |
9070 . | |
9071 .TP | |
9072 .B keyint=<value> | |
9073 Sets maximum interval between IDR-frames (default: 250). | |
9074 Larger values save bits, thus improve quality, at the cost of seeking | |
9075 precision. | |
9076 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large | |
9077 values of keyint. | |
9078 . | |
9079 .TP | |
9080 .B keyint_min=<1\-keyint/2> | |
9081 Sets minimum interval between IDR-frames (default: 25). | |
9082 If scenecuts appear within this interval, they are still encoded as | |
9083 I-frames, but do not start a new GOP. | |
9084 In H.264, I-frames do not necessarily bound a closed GOP because it is | |
9085 allowable for a P-frame to be predicted from more frames than just the one | |
9086 frame before it (also see frameref). | |
9087 Therefore, I-frames are not necessarily seekable. | |
9088 IDR-frames restrict subsequent P-frames from referring to any frame | |
9089 prior to the IDR-frame. | |
9090 . | |
9091 .TP | |
9092 .B scenecut=<-1\-100> | |
9093 Controls how aggressively to insert extra I-frames (default: 40). | |
9094 With small values of scenecut, the codec often has to force an I-frame | |
9095 when it would exceed keyint. | |
9096 Good values of scenecut may find a better location for the I-frame. | |
9097 Large values use more I-frames than necessary, thus wasting bits. | |
9098 -1 disables scene-cut detection, so I-frames are inserted only once | |
9099 every other keyint frames, even if a scene-cut occurs earlier. | |
9100 This is not recommended and wastes bitrate as scenecuts encoded as P-frames | |
9101 are just as big as I-frames, but do not reset the "keyint counter". | |
9102 . | |
9103 .TP | |
9104 .B frameref=<1\-16> | |
9105 Number of previous frames used as predictors in B- and P-frames (default: 1). | |
9106 This is effective in anime, but in live-action material the improvements | |
9107 usually drop off very rapidly above 6 or so reference frames. | |
9108 This has no effect on decoding speed, but does increase the memory needed for | |
9109 decoding. | |
9110 Some decoders can only handle a maximum of 15 reference frames. | |
9111 . | |
9112 .TP | |
9113 .B bframes=<0\-16> | |
9114 maximum number of consecutive B-frames between I- and P-frames (default: 0) | |
9115 . | |
9116 .TP | |
9117 .B (no)b_adapt | |
9118 Automatically decides when to use B-frames and how many, up to the maximum | |
9119 specified above (default: on). | |
9120 If this option is disabled, then the maximum number of B-frames is used. | |
9121 . | |
9122 .TP | |
9123 .B b_bias=<-100\-100> | |
9124 Controls the decision performed by b_adapt. | |
9125 A higher b_bias produces more B-frames (default: 0). | |
9126 . | |
9127 .TP | |
9128 .B (no)b_pyramid | |
9129 Allows B-frames to be used as references for predicting other frames. | |
9130 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4. | |
9131 Without this option, B-frames follow the same pattern as MPEG-[124]. | |
9132 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames | |
9133 are predicted from I0 and P4. | |
9134 With this option, they are coded as I0 P4 B2 B1 B3. | |
9135 B2 is the same as above, but B1 is predicted from I0 and B2, and | |
9136 B3 is predicted from B2 and P4. | |
9137 This usually results in slightly improved compression, at almost no | |
9138 speed cost. | |
9139 However, this is an experimental option: it is not fully tuned and | |
9140 may not always help. | |
9141 Requires bframes >= 2. | |
9142 Disadvantage: increases decoding delay to 2 frames. | |
9143 . | |
9144 .TP | |
9145 .B (no)deblock | |
9146 Use deblocking filter (default: on). | |
9147 As it takes very little time compared to its quality gain, it is not | |
9148 recommended to disable it. | |
9149 . | |
9150 .TP | |
9151 .B deblock=<-6\-6>,<-6\-6> | |
9152 The first parameter is AlphaC0 (default: 0). | |
9153 This adjusts thresholds for the H.264 in-loop deblocking filter. | |
9154 First, this parameter adjusts the maximum amount of change that the filter is | |
9155 allowed to cause on any one pixel. | |
9156 Secondly, this parameter affects the threshold for difference across the | |
9157 edge being filtered. | |
9158 A positive value reduces blocking artifacts more, but will also smear details. | |
9159 .br | |
9160 The second parameter is Beta (default: 0). | |
9161 This affects the detail threshold. | |
9162 Very detailed blocks are not filtered, since the smoothing caused by the | |
9163 filter would be more noticeable than the original blocking. | |
9164 .br | |
9165 The default behavior of the filter almost always achieves optimal quality, | |
9166 so it is best to either leave it alone, or make only small adjustments. | |
9167 However, if your source material already has some blocking or noise which | |
9168 you would like to remove, it may be a good idea to turn it up a little bit. | |
9169 . | |
9170 .TP | |
9171 .B (no)cabac | |
9172 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on). | |
9173 Slightly slows down encoding and decoding, but should save 10-15% bitrate. | |
9174 Unless you are looking for decoding speed, you should not disable it. | |
9175 . | |
9176 .TP | |
9177 .B qp_min=<1\-51> (ABR or two pass) | |
9178 Minimum quantizer, 10\-30 seems to be a useful range (default: 10). | |
9179 . | |
9180 .TP | |
9181 .B qp_max=<1\-51> (ABR or two pass) | |
9182 maximum quantizer (default: 51) | |
9183 . | |
9184 .TP | |
9185 .B qp_step=<1\-50> (ABR or two pass) | |
9186 maximum value by which the quantizer may be incremented/decremented between | |
9187 frames (default: 4) | |
9188 . | |
9189 .TP | |
9190 .B ratetol=<0.1\-100.0> (ABR or two pass) | |
9191 allowed variance in average bitrate (no particular units) (default: 1.0) | |
9192 . | |
9193 .TP | |
9194 .B vbv_maxrate=<value> (ABR or two pass) | |
9195 maximum local bitrate, in kbits/\:second (default: disabled) | |
9196 . | |
9197 .TP | |
9198 .B vbv_bufsize=<value> (ABR or two pass) | |
9199 averaging period for vbv_maxrate, in kbits | |
9200 (default: none, must be specified if vbv_maxrate is enabled) | |
9201 . | |
9202 .TP | |
9203 .B vbv_init=<0.0\-1.0> (ABR or two pass) | |
9204 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9) | |
9205 . | |
9206 .TP | |
9207 .B ip_factor=<value> | |
9208 quantizer factor between I- and P-frames (default: 1.4) | |
9209 . | |
9210 .TP | |
9211 .B pb_factor=<value> | |
9212 quantizer factor between P- and B-frames (default: 1.3) | |
9213 . | |
9214 .TP | |
9215 .B qcomp=<0\-1> (ABR or two pass) | |
9216 quantizer compression (default: 0.6). | |
9217 A lower value makes the bitrate more constant, | |
9218 while a higher value makes the quantization parameter more constant. | |
9219 . | |
9220 .TP | |
9221 .B cplx_blur=<0\-999> (two pass only) | |
9222 Temporal blur of the estimated frame complexity, before curve compression | |
9223 (default: 20). | |
9224 Lower values allow the quantizer value to jump around more, | |
9225 higher values force it to vary more smoothly. | |
9226 cplx_blur ensures that each I-frame has quality comparable to the following | |
9227 P-frames, and ensures that alternating high and low complexity frames | |
9228 (e.g. low fps animation) do not waste bits on fluctuating quantizer. | |
9229 . | |
9230 .TP | |
9231 .B qblur=<0\-99> (two pass only) | |
9232 Temporal blur of the quantization parameter, after curve compression | |
9233 (default: 0.5). | |
9234 Lower values allow the quantizer value to jump around more, | |
9235 higher values force it to vary more smoothly. | |
9236 . | |
9237 .TP | |
9238 .B zones=<zone0>[/<zone1>[/...]] | |
9239 User specified quality for specific parts (ending, credits, ...). | |
9240 Each zone is <start-frame>,<end-frame>,<option> where option may be | |
9241 .PD 0 | |
9242 .RSs | |
9243 .IPs "q=<0\-51>" | |
9244 quantizer | |
9245 .IPs "b=<0.01\-100.0>" | |
9246 bitrate multiplier | |
9247 .RE | |
9248 .PD 1 | |
9249 .RS | |
9250 .I NOTE: | |
9251 The quantizer option is not strictly enforced. | |
9252 It affects only the planning stage of ratecontrol, and is still subject | |
9253 to overflow compensation and qp_min/qp_max. | |
9254 .RE | |
9255 . | |
9256 .TP | |
9257 .B direct_pred=<name> | |
9258 Determines the type of motion prediction used for direct macroblocks | |
9259 in B-frames. | |
9260 .PD 0 | |
9261 .RSs | |
9262 .IPs none | |
9263 Direct macroblocks are not used. | |
9264 .IPs spatial | |
9265 Motion vectors are extrapolated from neighboring blocks. | |
9266 (default) | |
9267 .IPs temporal | |
9268 Motion vectors are interpolated from the following P-frame. | |
9269 .IPs auto | |
9270 The codec selects between spatial and temporal for each frame. | |
9271 .RE | |
9272 .PD 1 | |
9273 .RS | |
9274 Spatial and temporal are approximately the same speed and PSNR, | |
9275 the choice between them depends on the video content. | |
9276 Auto is slightly better, but slower. | |
9277 Auto is most effective when combined with multipass. | |
9278 direct_pred=none is both slower and lower quality. | |
9279 .RE | |
9280 . | |
9281 .TP | |
9282 .B (no)weight_b | |
9283 Use weighted prediction in B-frames. | |
9284 Without this option, bidirectionally predicted macroblocks give | |
9285 equal weight to each reference frame. | |
9286 With this option, the weights are determined by the temporal position | |
9287 of the B-frame relative to the references. | |
9288 Requires bframes > 1. | |
9289 . | |
9290 .TP | |
9291 .B partitions=<list> | |
9292 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4). | |
9293 .PD 0 | |
9294 .RSs | |
9295 .IPs p8x8 | |
9296 Enable types p16x8, p8x16, p8x8. | |
9297 .IPs p4x4 | |
9298 Enable types p8x4, p4x8, p4x4. | |
9299 p4x4 is recommended only with subq >= 5, and only at low resolutions. | |
9300 .IPs b8x8 | |
9301 Enable types b16x8, b8x16, b8x8. | |
9302 .IPs i8x8 | |
9303 Enable type i8x8. | |
9304 i8x8 has no effect unless 8x8dct is enabled. | |
9305 .IPs i4x4 | |
9306 Enable type i4x4. | |
9307 .IPs all | |
9308 Enable all of the above types. | |
9309 .IPs none | |
9310 Disable all of the above types. | |
9311 .RE | |
9312 .PD 1 | |
9313 .RS | |
9314 Regardless of this option, macroblock types p16x16, b16x16, and i16x16 | |
9315 are always enabled. | |
9316 .br | |
9317 The idea is to find the type and size that best describe a certain area | |
9318 of the picture. | |
9319 For example, a global pan is better represented by 16x16 blocks, while | |
9320 small moving objects are better represented by smaller blocks. | |
9321 .RE | |
9322 . | |
9323 .TP | |
9324 .B (no)8x8dct | |
9325 Adaptive spatial transform size: allows macroblocks to choose between | |
9326 4x4 and 8x8 DCT. | |
9327 Also allows the i8x8 macroblock type. | |
9328 Without this option, only 4x4 DCT is used. | |
9329 . | |
9330 .TP | |
9331 .B me=<name> | |
9332 Select fullpixel motion estimation algorithm. | |
9333 .PD 0 | |
9334 .RSs | |
9335 .IPs dia | |
9336 diamond search, radius 1 (fast) | |
9337 .IPs hex | |
9338 hexagon search, radius 2 (default) | |
9339 .IPs umh | |
9340 uneven multi-hexagon search (slow) | |
9341 .IPs esa | |
9342 exhaustive search (very slow, and no better than umh) | |
9343 .RE | |
9344 .PD 1 | |
9345 . | |
9346 .TP | |
9347 .B me_range=<4\-64> | |
9348 radius of exhaustive or multi-hexagon motion search (default: 16) | |
9349 . | |
9350 .TP | |
9351 .B subq=<1\-7> | |
9352 Adjust subpel refinement quality. | |
9353 This parameter controls quality versus speed tradeoffs involved in the motion | |
9354 estimation decision process. | |
9355 subq=5 can compress up to 10% better than subq=1. | |
9356 .PD 0 | |
9357 .RSs | |
9358 .IPs 1 | |
9359 Runs fullpixel precision motion estimation on all candidate | |
9360 macroblock types. | |
9361 Then selects the best type. | |
9362 Then refines the motion of that type to fast quarterpixel precision (fastest). | |
9363 .IPs 2 | |
9364 Runs halfpixel precision motion estimation on all candidate macroblock types. | |
9365 Then selects the best type. | |
9366 Then refines the motion of that type to fast quarterpixel precision. | |
9367 .IPs 3 | |
9368 As 2, but uses a slower quarterpixel refinement. | |
9369 .IPs 4 | |
9370 Runs fast quarterpixel precision motion estimation on all candidate | |
9371 macroblock types. | |
9372 Then selects the best type. | |
9373 Then finishes the quarterpixel refinement for that type. | |
9374 .IPs 5 | |
9375 Runs best quality quarterpixel precision motion estimation on all | |
9376 candidate macroblock types, before selecting the best type (default). | |
9377 .IPs 6 | |
9378 Enables rate-distortion optimization of macroblock types in | |
9379 I- and P-frames. | |
9380 .IPs 7 | |
9381 Enables rate-distortion optimization of motion vectors and intra modes. (best) | |
9382 .RE | |
9383 .PD 1 | |
9384 .RS | |
9385 In the above, "all candidates" does not exactly mean all enabled types: | |
9386 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16. | |
9387 .RE | |
9388 . | |
9389 .TP | |
9390 .B (no)chroma_me | |
9391 Takes into account chroma information during subpixel motion search | |
9392 (default: enabled). | |
9393 Requires subq>=5. | |
9394 . | |
9395 .TP | |
9396 .B (no)mixed_refs | |
9397 Allows each 8x8 or 16x8 motion partition to independently select a | |
9398 reference frame. | |
9399 Without this option, a whole macroblock must use the same reference. | |
9400 Requires frameref>1. | |
9401 . | |
9402 .TP | |
9403 .B (no)brdo | |
9404 Enables rate-distortion optimization of macroblock types in B-frames. | |
9405 Requires subq>=6. | |
9406 . | |
9407 .TP | |
9408 .B (no)bime | |
9409 Refine the two motion vectors used in bidirectional macroblocks, | |
9410 rather than re-using vectors from the forward and backward searches. | |
9411 This option has no effect without B-frames. | |
9412 . | |
9413 .TP | |
9414 .B trellis=<0\-2> | |
9415 rate-distortion optimal quantization | |
9416 .PD 0 | |
9417 .RSs | |
9418 .IPs 0 | |
9419 disabled (default) | |
9420 .IPs 1 | |
9421 enabled only for the final encode | |
9422 .IPs 2 | |
9423 enabled during all mode decisions (slow, requires subq>=6) | |
9424 .RE | |
9425 .PD 1 | |
9426 . | |
9427 .TP | |
9428 .B deadzone_inter=<0\-32> | |
9429 Set the size of the inter luma quantization deadzone for non-trellis | |
9430 quantization (default: 21). | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9431 Lower values help to preserve fine details and film grain (typically useful |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9432 for high bitrate/quality encode), while higher values help filter out |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9433 these details to save bits that can be spent again on other macroblocks |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9434 and frames (typically useful for bitrate-starved encodes). |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9435 It is recommended that you start by tweaking deadzone_intra before changing |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9436 this parameter. |
20707 | 9437 . |
9438 .TP | |
9439 .B deadzone_intra=<0\-32> | |
9440 Set the size of the intra luma quantization deadzone for non-trellis | |
9441 quantization (default: 11). | |
21245
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9442 This option has the same effect as deadzone_inter except that it affects |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9443 intra frames. |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9444 It is recommended that you start by tweaking this parameter before changing |
89cf78cf2620
r21186: Remove "OSD only" tags; those options always exist.
voroshil
parents:
21157
diff
changeset
|
9445 deadzone_inter. |
20707 | 9446 . |
9447 .TP | |
9448 .B (no)fast_pskip | |
9449 Performs early skip detection in P-frames (default: enabled). | |
9450 This usually improves speed at no cost, but it can sometimes produce | |
9451 artifacts in areas with no details, like sky. | |
9452 . | |
9453 .TP | |
9454 .B (no)dct_decimate | |
9455 Eliminate dct blocks in P-frames containing only a small single coefficient | |
9456 (default: enabled). | |
9457 This will remove some details, so it will save bits that can be spent | |
9458 again on other frames, hopefully raising overall subjective quality. | |
9459 If you are compressing non-anime content with a high target bitrate, you | |
9460 may want to disable this to preserve as much detail as possible. | |
9461 . | |
9462 .TP | |
9463 .B nr=<0\-100000> | |
9464 Noise reduction, 0 means disabled. | |
9465 100\-1000 is a useful range for typical content, but you may want to turn it | |
9466 up a bit more for very noisy content (default: 0). | |
9467 Given its small impact on speed, you might want to prefer to use this over | |
9468 filtering noise away with video filters like denoise3d or hqdn3d. | |
9469 . | |
9470 .TP | |
9471 .B chroma_qp_offset=<-12\-12> | |
9472 Use a different quantizer for chroma as compared to luma. | |
9473 Useful values are in the range <-2\-2> (default: 0). | |
9474 . | |
9475 .TP | |
9476 .B cqm=<flat|jvt|<filename>> | |
9477 Either uses a predefined custom quantization matrix or loads a JM format | |
9478 matrix file. | |
9479 .PD 0 | |
9480 .RSs | |
9481 .IPs "flat\ " | |
9482 Use the predefined flat 16 matrix (default). | |
9483 .IPs "jvt\ \ " | |
9484 Use the predefined JVT matrix. | |
9485 .IPs <filename> | |
9486 Use the provided JM format matrix file. | |
9487 .PD 1 | |
9488 .RE | |
9489 .RS | |
9490 .I NOTE: | |
9491 Windows CMD.EXE users may experience problems with parsing the command line | |
9492 if they attempt to use all the CQM lists. | |
9493 This is due to a command line length limitation. | |
9494 In this case it is recommended the lists be put into a JM format CQM | |
9495 file and loaded as specified above. | |
9496 .RE | |
9497 . | |
9498 .TP | |
9499 .B cqm4iy=<list> (also see cqm) | |
9500 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated | |
9501 values in the 1\-255 range. | |
9502 . | |
9503 .TP | |
9504 .B cqm4ic=<list> (also see cqm) | |
9505 Custom 4x4 intra chrominance matrix, given as a list of 16 comma | |
9506 separated values in the 1\-255 range. | |
9507 . | |
9508 .TP | |
9509 .B cqm4py=<list> (also see cqm) | |
9510 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated | |
9511 values in the 1\-255 range. | |
9512 . | |
9513 .TP | |
9514 .B cqm4pc=<list> (also see cqm) | |
9515 Custom 4x4 inter chrominance matrix, given as a list of 16 comma | |
9516 separated values in the 1\-255 range. | |
9517 . | |
9518 .TP | |
9519 .B cqm8iy=<list> (also see cqm) | |
9520 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated | |
9521 values in the 1\-255 range. | |
9522 . | |
9523 .TP | |
9524 .B cqm8py=<list> (also see cqm) | |
9525 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated | |
9526 values in the 1\-255 range. | |
9527 . | |
9528 .TP | |
9529 .B level_idc=<10\-51> | |
9530 Set the bitstream's level as defined by annex A of the H.264 standard | |
9531 (default: 51 - Level 5.1). | |
9532 This is used for telling the decoder what capabilities it needs to support. | |
9533 Use this parameter only if you know what it means, | |
9534 and you have a need to set it. | |
9535 . | |
9536 .TP | |
9537 .B threads=<1\-4> | |
9538 Split each frame into slices and encode them in parallel (default: 1). | |
9539 Also allows multithreaded decoding if the decoder supports it (lavc does not). | |
9540 This has a slight penalty to compression. | |
9541 Requires that libx264 was compiled with pthread support; if not, this | |
9542 option will produce a warning and enables slices but not multithreading. | |
9543 . | |
9544 .TP | |
9545 .B (no)global_header | |
9546 Causes SPS and PPS to appear only once, at the beginning of the bitstream | |
9547 (default: disabled). | |
9548 Some players, such as the Sony PSP, require the use of this option. | |
9549 The default behavior causes SPS and PPS to repeat prior to each IDR frame. | |
9550 . | |
9551 .TP | |
9552 .B (no)interlaced | |
9553 Treat the video content as interlaced. | |
9554 . | |
9555 .TP | |
9556 .B log=<-1\-3> | |
9557 Adjust the amount of logging info printed to the screen. | |
9558 .PD 0 | |
9559 .RSs | |
9560 .IPs "-1" | |
9561 none | |
9562 .IPs " 0" | |
9563 Print errors only. | |
9564 .IPs " 1" | |
9565 warnings | |
9566 .IPs " 2" | |
9567 PSNR and other analysis statistics when the encode finishes (default) | |
9568 .IPs " 3" | |
9569 PSNR, QP, frametype, size, and other statistics for every frame | |
9570 .RE | |
9571 .PD 1 | |
9572 . | |
9573 .TP | |
9574 .B (no)psnr | |
9575 Print signal-to-noise ratio statistics. | |
9576 .br | |
9577 .I NOTE: | |
9578 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not | |
9579 mathematically sound (they are simply the average of per-frame PSNRs). | |
9580 They are kept only for comparison to the JM reference codec. | |
9581 For all other purposes, please use either the 'Global' PSNR, or the per-frame | |
9582 PSNRs printed by log=3. | |
9583 . | |
9584 .TP | |
9585 .B (no)ssim | |
9586 Print the Structural Similarity Metric results. | |
9587 This is an alternative to PSNR, and may be better correlated with the | |
9588 perceived quality of the compressed video. | |
9589 . | |
9590 .TP | |
9591 .B (no)visualize | |
9592 Enable x264 visualizations during encoding. | |
9593 If the x264 on your system supports it, a new window will be opened during | |
9594 the encoding process, in which x264 will attempt to present an overview of | |
9595 how each frame gets encoded. | |
9596 Each block type on the visualized movie will be colored as follows: | |
9597 .PD 0 | |
9598 .RSs | |
9599 .IPs red/pink | |
9600 intra block | |
9601 .IPs "blue\ " | |
9602 inter block | |
9603 .IPs green | |
9604 skip block | |
9605 .IPs yellow | |
9606 B-block | |
9607 .RE | |
9608 .PD 1 | |
9609 .RS | |
9610 This feature can be considered experimental and subject to change. | |
9611 In particular, it depends on x264 being compiled with visualizations enabled. | |
9612 Note that as of writing this, x264 pauses after encoding and visualizing | |
9613 each frame, waiting for the user to press a key, at which point the next | |
9614 frame will be encoded. | |
9615 .RE | |
9616 . | |
9617 . | |
9618 .SS xvfw (\-xvfwopts) | |
9619 . | |
9620 Encoding with Video for Windows codecs is mostly obsolete unless you wish | |
9621 to encode to some obscure fringe codec. | |
9622 . | |
9623 .TP | |
9624 .B codec=<name> | |
9625 The name of the binary codec file with which to encode. | |
9626 . | |
9627 . | |
9628 .SS MPEG muxer (\-mpegopts) | |
9629 . | |
9630 The MPEG muxer can generate 5 types of streams, each of which has reasonable | |
9631 default parameters that the user can override. | |
9632 Generally, when generating MPEG files, it is advisable to disable | |
9633 MEncoder's frame-skip code (see \-noskip, \-mc as well as the | |
9634 harddup and softskip video filters). | |
9635 .PP | |
9636 .I EXAMPLE: | |
9637 .PD 0 | |
9638 .RSs | |
9639 .IPs format=mpeg2:tsaf:vbitrate=8000 | |
9640 .RE | |
9641 .PD 1 | |
9642 . | |
9643 .TP | |
21155
e0a600f0bcaf
r21152: typo: Bitrate is printed in kb/s, not Mb/s on the status line.
voroshil
parents:
21050
diff
changeset
|
9644 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd | pes1 | pes2> |
e0a600f0bcaf
r21152: typo: Bitrate is printed in kb/s, not Mb/s on the status line.
voroshil
parents:
21050
diff
changeset
|
9645 stream format (default: mpeg2). |
e0a600f0bcaf
r21152: typo: Bitrate is printed in kb/s, not Mb/s on the status line.
voroshil
parents:
21050
diff
changeset
|
9646 pes1 and pes2 are very broken formats (no pack header and no padding), |
e0a600f0bcaf
r21152: typo: Bitrate is printed in kb/s, not Mb/s on the status line.
voroshil
parents:
21050
diff
changeset
|
9647 but VDR uses them; don't choose them unless you know exactly what you |
e0a600f0bcaf
r21152: typo: Bitrate is printed in kb/s, not Mb/s on the status line.
voroshil
parents:
21050
diff
changeset
|
9648 are doing. |
20707 | 9649 . |
9650 .TP | |
9651 .B size=<up to 65535> | |
9652 Pack size in bytes, do not change unless you know exactly what | |
9653 you are doing (default: 2048). | |
9654 . | |
9655 .TP | |
9656 .B muxrate=<int> | |
9657 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s). | |
9658 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'. | |
9659 . | |
9660 .TP | |
9661 .B "tsaf\ \ \ " | |
9662 Sets timestamps on all frames, if possible; recommended when format=dvd. | |
9663 If dvdauthor complains with a message like "..audio sector out of range...", | |
9664 you probably did not enable this option. | |
9665 . | |
9666 .TP | |
9667 .B init_vpts=<100\-700> | |
9668 initial video pts, in milliseconds (default: 200) | |
9669 . | |
9670 .TP | |
9671 .B init_apts=<100\-700> | |
9672 initial audio pts, in milliseconds (default: 200) | |
9673 . | |
9674 .TP | |
9675 .B vdelay=<1\-32760> | |
9676 Initial video delay time, in milliseconds (default: 0), | |
9677 use it if you want to delay video with respect to audio. | |
9678 . | |
9679 .TP | |
9680 .B "drop\ \ \ " | |
9681 When used with init_adelay the muxer drops the part of audio that was | |
9682 anticipated. | |
9683 . | |
9684 .TP | |
9685 .B vwidth, vheight=<1\-4095> | |
9686 Set the video width and height when video is MPEG-1/2. | |
9687 . | |
9688 .TP | |
9689 .B vpswidth, vpsheight=<1\-4095> | |
9690 Set pan and scan video width and height when video is MPEG-2. | |
9691 . | |
9692 .TP | |
9693 .B vaspect=<1 | 4/3 | 16/9 | 221/100> | |
9694 Sets the display aspect ratio for MPEG-2 video. | |
9695 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong. | |
9696 . | |
9697 .TP | |
9698 .B vbitrate=<int> | |
9699 Sets the video bitrate in kbit/s for MPEG-1/2 video. | |
9700 . | |
9701 .TP | |
9702 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 > | |
9703 Sets the framerate for MPEG-1/2 video. | |
9704 This option will be ignored if used with the telecine option. | |
9705 . | |
9706 .TP | |
9707 .B telecine | |
9708 Enables 3:2 pulldown soft telecine mode: The muxer will make the | |
9709 video stream look like it was encoded at 30000/1001 or 30 fps. | |
9710 It only works with MPEG-2 video when the output framerate, | |
9711 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9712 Any other framerate is incompatible with this option. | |
9713 . | |
9714 .TP | |
9715 .B film2pal | |
9716 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer | |
9717 will make the video stream look like it was encoded at 25 fps. | |
9718 It only works with MPEG-2 video when the output framerate, | |
9719 converted with \-ofps, is either 24000/1001 or 24 fps. | |
9720 Any other framerate is incompatible with this option. | |
9721 . | |
9722 . | |
9723 .SS FFmpeg libavformat demuxers (\-lavfdopts) | |
9724 . | |
9725 .TP | |
9726 .B probesize=<value> | |
9727 Maximum amount of data to probe during the detection phase. | |
9728 In the case of MPEG-TS this value identifies the maximum number | |
9729 of TS packets to scan. | |
9730 . | |
9731 . | |
9732 . | |
9733 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf) | |
9734 . | |
9735 .TP | |
9736 .B delay=<value> | |
9737 Currently only meaningful for MPEG[12]: Maximum allowed distance, | |
9738 in seconds, between the reference timer of the output stream (SCR) | |
9739 and the decoding timestamp (DTS) for any stream present | |
9740 (demux to decode delay). | |
9741 Default is 0.7 (as mandated by the standards defined by MPEG). | |
9742 Higher values require larger buffers and must not be used. | |
9743 . | |
9744 .TP | |
9745 .B format=<container_format> | |
9746 Override which container format to mux into | |
9747 (default: autodetect from output file extension). | |
9748 .PD 0 | |
9749 .RSs | |
9750 .IPs "mpg\ \ " | |
9751 MPEG-1 systems and MPEG-2 PS | |
9752 .IPs "asf\ \ " | |
9753 Advanced Streaming Format | |
9754 .IPs "avi\ \ " | |
9755 Audio Video Interleave file | |
9756 .IPs "wav\ \ " | |
9757 Waveform Audio | |
9758 .IPs "swf\ \ " | |
9759 Macromedia Flash | |
9760 .IPs "flv\ \ " | |
9761 Macromedia Flash video files | |
9762 .IPs "rm\ \ \ " | |
9763 RealAudio and RealVideo | |
9764 .IPs "au\ \ \ " | |
9765 SUN AU format | |
9766 .IPs "nut\ \ " | |
9767 NUT open container format (experimental) | |
9768 .IPs "mov\ \ " | |
9769 QuickTime | |
9770 .IPs "mp4\ \ " | |
9771 MPEG-4 format | |
9772 .IPs "dv\ \ \ " | |
9773 Sony Digital Video container | |
9774 .RE | |
9775 .PD 1 | |
9776 .TP | |
9777 .B i_certify_that_my_video_stream_does_not_use_b_frames | |
9778 MEncoder cannot assign correct timestamps when there are | |
9779 B-frames in the video stream, resulting in broken encodes. | |
21386
3c20bb1ac789
r21398: improve description of lavf's i_certify_that_my_video_stream_does_not_use_b_frames
voroshil
parents:
21343
diff
changeset
|
9780 If you wish to use the lavf muxer, you must not let the video codec use |
3c20bb1ac789
r21398: improve description of lavf's i_certify_that_my_video_stream_does_not_use_b_frames
voroshil
parents:
21343
diff
changeset
|
9781 B-frames (see the relevant documentation of each codec) and you also |
3c20bb1ac789
r21398: improve description of lavf's i_certify_that_my_video_stream_does_not_use_b_frames
voroshil
parents:
21343
diff
changeset
|
9782 must specify this option. |
20707 | 9783 . |
9784 .TP | |
9785 .B muxrate=<rate> | |
9786 Минимальный битовый поток мультиплексирования, в бит/с; | |
9787 в данный момент имеет смысл только для MPEG[12]. | |
9788 Иногда уго указание необходимо для избавления от "buffer underflows". | |
9789 . | |
9790 .TP | |
9791 .B packetsize=<size> | |
9792 .\" FIXME better translation | |
9793 Размер, выраженный в байтах, атомарного[unitary] пакета для выбранного формата. | |
9794 При сжатии в MPEG[12] используются следующие значения по-умолчанию: | |
9795 2324 для [S]VCD, 2048 для всех остальных форматов. | |
9796 . | |
9797 .TP | |
9798 .B preload=<distance> | |
9799 На текущий момент имеет смысл только для MPEG[12]: Начальное разница, | |
9800 в секундах, между значением таймера потока вывода (SCR) и временной меткой | |
9801 .\" FIXME better translation | |
9802 декодирования (DTS) для любого существующего потока (задержка декодирования | |
9803 [demux to decode delay]). | |
9804 . | |
9805 . | |
9806 . | |
9807 .\" -------------------------------------------------------------------------- | |
9808 .\" переменные окружения | |
9809 .\" -------------------------------------------------------------------------- | |
9810 . | |
9811 .SH ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ | |
9812 . | |
9813 Существуют некоторые переменные окружения, которые могут использоваться для управления | |
9814 поведением MPlayer И MEncoder. | |
9815 . | |
9816 .TP | |
9817 .B MPLAYER_CHARSET (также смотрите \-msgcharset) | |
9818 Преодразовывать сообщения консоли в указанную кодировку (по-умолчанию: автоопределение). | |
9819 Значение "noconv" означает отсутствие перекодировки. | |
9820 . | |
9821 .TP | |
9822 .B MPLAYER_HOME | |
9823 Каталог, в котором MPlayer ищет настройки пользователя. | |
9824 . | |
9825 .TP | |
9826 .B MPLAYER_VERBOSE (также смотрите \-v и \-msglevel) | |
9827 Указывает начальный уровень подробности сообщений для всех | |
9828 модулей (пл-умолчанию: 0). | |
9829 Отрицательные значения приведет к меньшему количеству сообщений, положительное - | |
9830 к большему. | |
9831 . | |
9832 .SS libaf: | |
9833 . | |
9834 .TP | |
9835 .B LADSPA_PATH | |
9836 Если LADSPA_PATH установлена, производится поиск указанного файла. Если не | |
9837 установлена, вам придется указать полный путь. | |
9838 FIXME: Ою этом также упоминается в разделе ladspa. | |
9839 . | |
9840 .SS libdvdcss: | |
9841 . | |
9842 .TP | |
9843 .B DVDCSS_CACHE | |
9844 Указывает каталог, хранящий ключи роликов. | |
9845 Это ускоряет расшифровку[descrambling] DVD? находящихся в кеше. | |
9846 Каталог DVDCSS_CACHE будет создан, если не существовал, | |
9847 а ткаже подкаталог с названием DVD ролика или даты изготовления. | |
9848 Если DVDCSS_CACHE не установлена или пуста, libdvdcss будет использовать | |
9849 значение по-умолчания, равное "${HOME}/.dvdcss/" под Unix и | |
9850 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" под Win32. | |
9851 Спецальное значение "off" отключает кеширование. | |
9852 . | |
9853 .TP | |
9854 .B DVDCSS_METHOD | |
9855 Устанавливает методы аутентикации и дешифровки, которые | |
9856 libdvdcss будет использовать для чтения шифрованных[scrambled] дисков. | |
9857 Может принимать значения title, key or disc. | |
9858 .PD 0 | |
9859 .RSs | |
9860 .IPs "key\ \ " | |
9861 это метод по-умолчанию. | |
9862 libdvdcss будет использовать набор рассчитанных ключей проигрывателей, | |
9863 чтобы попробовать и получить ключ диска. | |
9864 Это модет не сработать, если устройство не распознает ни один из ключей | |
9865 проигрывателей. | |
9866 .IPs "disc\ " | |
9867 это аварийный метод, когда предыдущий не справился. | |
9868 Вместо использования ключей проигрывателей, libdvdcss взломает ключ | |
9869 диска используя грубый метод взлома. Этот процесс требователен к CPU | |
9870 и требцет 64Мб памяти для хранения временных данных. | |
9871 .IPs title | |
9872 это аварийный метод, если ни один из предыдцщих не сработал. | |
9873 Он никак не связан с обменом клчами с устройством DVD, но вместо этого | |
9874 используеткрипто атаку, для угадыванию ключа ролика. | |
9875 В исключительных случаях и он может завершиться неудачно, по причине | |
9876 нехватки шифрованных данных для осуществления статистической атаки, | |
9877 но, с другой стороны, это единственный способ расшифровать DVD, | |
9878 сохраненный на жестский диск, или с неправильным регионом на RPC2 устройстве. | |
9879 .RE | |
9880 .PD 1 | |
9881 . | |
9882 .TP | |
9883 .B DVDCSS_RAW_DEVICE | |
9884 Указывает "сырое"[raw] устройство для использования. | |
9885 Конкретное использование будет зависеть от вашей оперционной системы, | |
9886 в Linux утилитой для настройки "сырых" устройств является raw(8). | |
9887 Заметьте, что на большинстве операционных систем, использование | |
9888 "сырого" устройства требует хорошо выровненных[highly aligned] буферов: | |
9889 Linux требует выравнивания на 2048 байт (что равняется размеру сектора DVD). | |
9890 . | |
9891 .TP | |
9892 .B DVDCSS_VERBOSE | |
9893 Устанавливает уровень подробности сообщений libdvdcss. | |
9894 .PD 0 | |
9895 .RSs | |
9896 .IPs 0 | |
9897 Вообще не выводить сообщения. | |
9898 .IPs 1 | |
9899 Выводить ошибки в stderr. | |
9900 .IPs 2 | |
9901 Выводить ошибки и сообщения отладки в stderr. | |
9902 .RE | |
9903 .PD 1 | |
9904 . | |
9905 .TP | |
9906 .B DVDREAD_NOKEYS | |
9907 Пропустить получение всех ключей при запуске. | |
9908 В данный момент отключено. | |
9909 . | |
9910 .TP | |
9911 .B HOME | |
9912 FIXME: Описать это. | |
9913 . | |
9914 .SS libao2: | |
9915 . | |
9916 .TP | |
9917 .B AO_SUN_DISABLE_SAMPLE_TIMING | |
9918 FIXME: Описать это. | |
9919 . | |
9920 .TP | |
9921 .B AUDIODEV | |
9922 FIXME: Описать это. | |
9923 . | |
9924 .TP | |
9925 .B AUDIOSERVER | |
9926 Указывает Network Audio System сервер к которому драйвер вывода nat | |
9927 должен присоединиться и транспорт,кторый должен быть использован. | |
9928 Если не установлена, вместо нее используется DISPLAY. | |
9929 Транспорт может быть tcp или unix. | |
9930 Синтаксис: tcp/<некий_хост>:<некий_порт>, <некий_хост>:<номер_экземпляра> | |
9931 или [unix]:<номер_экземпляра>. | |
9932 Основной порт NAS - 8000 и <номер_экземпляра> добавляется к нему. | |
9933 .sp 1 | |
9934 .RS | |
9935 .I EXAMPLES: | |
9936 .RE | |
9937 .PD 0 | |
9938 .RSs | |
9939 .IPs AUDIOSERVER=somehost:0 | |
9940 Присоединение к NAS серверу на somehost, используя опрт и транспорт по-умолчанию. | |
9941 .IPs AUDIOSERVER=tcp/somehost:8000 | |
9942 Присоединение к NAS серверу на somehost, слушающему TCP порт 8000. | |
9943 .IPs AUDIOSERVER=(unix)?:0 | |
9944 Присоединения к NAS серверу, экземпляр 0 на localhost используя unix сокеты. | |
9945 .RE | |
9946 .PD 1 | |
9947 . | |
9948 .TP | |
9949 .B DISPLAY | |
9950 FIXME: Описать это. | |
9951 . | |
9952 .SS vidix: | |
9953 . | |
9954 .TP | |
9955 .B VIDIX_CRT | |
9956 FIXME: Описать это. | |
9957 . | |
9958 .SS osdep: | |
9959 . | |
9960 .TP | |
9961 .B TERM | |
9962 FIXME: Описать это. | |
9963 . | |
9964 .SS libvo: | |
9965 . | |
9966 .TP | |
9967 .B DISPLAY | |
9968 FIXME: Описать это. | |
9969 . | |
9970 .TP | |
9971 .B FRAMEBUFFER | |
9972 FIXME: Описать это. | |
9973 . | |
9974 .TP | |
9975 .B HOME | |
9976 FIXME: Описать это. | |
9977 . | |
9978 .SS libmpdemux: | |
9979 . | |
9980 .TP | |
9981 .B HOME | |
9982 FIXME: Описать это. | |
9983 . | |
9984 .TP | |
9985 .B HOMEPATH | |
9986 FIXME: Описать это. | |
9987 . | |
9988 .TP | |
9989 .B http_proxy | |
9990 FIXME: Описать это. | |
9991 . | |
9992 .TP | |
9993 .B LOGNAME | |
9994 FIXME: Описать это. | |
9995 . | |
9996 .TP | |
9997 .B USERPROFILE | |
9998 FIXME: Описать это. | |
9999 . | |
10000 .SS libmpcodecs: | |
10001 . | |
10002 .TP | |
10003 .B XANIM_MOD_DIR | |
10004 FIXME: Описать это. | |
10005 . | |
10006 .SS GUI: | |
10007 . | |
10008 .TP | |
10009 .B CHARSET | |
10010 FIXME: Описать это. | |
10011 . | |
10012 .TP | |
10013 .B DISPLAY | |
10014 FIXME: Описать это. | |
10015 . | |
10016 .TP | |
10017 .B HOME | |
10018 FIXME: Описать это. | |
10019 . | |
10020 .SS libavformat: | |
10021 . | |
10022 .TP | |
10023 .B AUDIO_FLIP_LEFT | |
10024 FIXME: Описать это. | |
10025 . | |
10026 .TP | |
10027 .B BKTR_DEV | |
10028 FIXME: Описать это. | |
10029 . | |
10030 .TP | |
10031 .B BKTR_FORMAT | |
10032 FIXME: Описать это. | |
10033 . | |
10034 .TP | |
10035 .B BKTR_FREQUENCY | |
10036 FIXME: Описать это. | |
10037 . | |
10038 .TP | |
10039 .B http_proxy | |
10040 FIXME: Описать это. | |
10041 . | |
10042 .TP | |
10043 .B no_proxy | |
10044 FIXME: Описать это. | |
10045 . | |
10046 . | |
10047 . | |
10048 .\" -------------------------------------------------------------------------- | |
10049 .\" Файлы | |
10050 .\" -------------------------------------------------------------------------- | |
10051 . | |
10052 .SH ФАЙЛЫ | |
10053 . | |
10054 .TP | |
10055 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf | |
10056 Общесистемные настройки MPlayer | |
10057 . | |
10058 .TP | |
10059 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf | |
10060 Общесистемные настройки MEncoder | |
10061 . | |
10062 .TP | |
10063 ~/.mplayer/\:config | |
10064 Пользовательские настройки MPlayer | |
10065 . | |
10066 .TP | |
10067 ~/.mplayer/\:mencoder.conf | |
10068 Пользовательские настройки MEncoder | |
10069 . | |
10070 .TP | |
10071 ~/.mplayer/\:input.conf | |
10072 Привязки клавиш (смотрите '\-input keylist' для полного списка) | |
10073 . | |
10074 .TP | |
10075 ~/.mplayer/\:gui.conf | |
10076 Файл настройки GUI | |
10077 . | |
10078 .TP | |
10079 ~/.mplayer/\:gui.pl | |
10080 Список воспроизведения GUI | |
10081 . | |
10082 .TP | |
10083 ~/.mplayer/\:font/ | |
10084 Каталог шрифтов (В нем должен находиться файл font.desc и файлы с расширением .RAW) | |
10085 . | |
10086 .TP | |
10087 ~/.mplayer/\:DVDkeys/ | |
10088 Кэшированные ключи CSS | |
10089 . | |
10090 .TP | |
10091 Предполагая, что проигрывается файл /path/\:to/\:movie.avi, MPlayer ищет | |
10092 файлы с субтитрами в следующем порядке: | |
10093 .RS | |
10094 /path/\:to/\:movie.sub | |
10095 .br | |
10096 ~/.mplayer/\:sub/\:movie.sub | |
10097 .RE | |
10098 .PD 1 | |
10099 . | |
10100 . | |
10101 .\" -------------------------------------------------------------------------- | |
10102 .\" Примеры | |
10103 .\" -------------------------------------------------------------------------- | |
10104 . | |
10105 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MPLAYER | |
10106 . | |
10107 .PP | |
10108 .B Быстрый старт проигрывания DVD: | |
10109 .nf | |
10110 mplayer dvd://1 | |
10111 .fi | |
10112 . | |
10113 .PP | |
10114 .B Проиграть DVD на Японском с Английскими субтитрами: | |
10115 .nf | |
10116 mplayer dvd://1 \-alang ja \-slang en | |
10117 .fi | |
10118 . | |
10119 .PP | |
10120 .B Проиграть только эпизоды 5, 6, 7: | |
10121 .nf | |
10122 mplayer dvd://1 \-chapter 5-7 | |
10123 .fi | |
10124 . | |
10125 .PP | |
10126 .B Проиграть только заголовки 5, 6, 7: | |
10127 .nf | |
10128 mplayer dvd://5-7 | |
10129 .fi | |
10130 . | |
10131 .PP | |
10132 .B Проиграть multiangle DVD: | |
10133 .nf | |
10134 mplayer dvd://1 \-dvdangle 2 | |
10135 .fi | |
10136 . | |
10137 .PP | |
10138 .B Проиграть с другого DVD устройства: | |
10139 .nf | |
10140 mplayer dvd://1 \-dvd-device /dev/\:dvd2 | |
10141 .fi | |
10142 . | |
10143 .PP | |
10144 .B Проиграть DVD видео из папки, содержащей VOB файлы: | |
10145 .nf | |
10146 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/ | |
10147 .fi | |
10148 . | |
10149 .PP | |
10150 .B Копировать DVD заголовок на жесткий диск, сохраняя в файл "title1.vob": | |
10151 .nf | |
10152 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob | |
10153 .fi | |
10154 . | |
10155 .PP | |
10156 .B Поток по HTTP: | |
10157 .nf | |
10158 mplayer http://mplayer.hq/example.avi | |
10159 .fi | |
10160 . | |
10161 .PP | |
10162 .B Поток, используя RTSP: | |
10163 .nf | |
10164 mplayer rtsp://server.example.com/streamName | |
10165 .fi | |
10166 . | |
10167 .PP | |
10168 .B Преобразовать субтитры в формат MPsub: | |
10169 .nf | |
10170 mplayer dummy.avi \-sub source.sub \-dumpmpsub | |
10171 .fi | |
10172 . | |
10173 .PP | |
10174 .B Преобразовать субтитры в формат MPsub без просмотра фильма: | |
10175 .nf | |
10176 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub | |
10177 .fi | |
10178 . | |
10179 .PP | |
10180 .B со входа стандартного V4L: | |
10181 .nf | |
10182 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv | |
10183 .fi | |
10184 . | |
10185 .PP | |
10186 .B Проигрывание на картах Zoran (старый способ, устарел): | |
10187 .nf | |
10188 mplayer \-vo zr \-vf scale=352:288 file.avi | |
10189 .fi | |
10190 . | |
10191 .PP | |
10192 .B Проигрывание на картах Zoran (новый способ): | |
10193 .nf | |
10194 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi | |
10195 .fi | |
10196 . | |
10197 .PP | |
10198 .B Проиграть 6-ти канальный AAC файл на двух колонках: | |
10199 .nf | |
10200 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 | |
10201 .fi | |
10202 .br | |
10203 .\" FIXME correct translation? | |
10204 You might want to play a bit with the pan values (e.g multiply with a value) to | |
10205 increase volume or avoid clipping. | |
10206 . | |
10207 .SH ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ MENCODER | |
10208 . | |
10209 .PP | |
10210 .B Кодировать DVD заголовок #2, только указанные эпизоды: | |
10211 .nf | |
10212 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10213 .fi | |
10214 . | |
10215 .PP | |
10216 .B Кодировать DVD заголовок #2, масштабируя до 640x480: | |
10217 .nf | |
10218 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10219 .fi | |
10220 . | |
10221 .PP | |
10222 .B кодировать DVD заголовок #2, масштабируя до 512xHHH (сохраняя пропорции): | |
10223 .nf | |
10224 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10225 .fi | |
10226 . | |
10227 .PP | |
10228 .B То же, но с битрейтом установленным в 1800kbit и оптимизированными макроблоками: | |
10229 .nf | |
10230 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800 | |
10231 .fi | |
10232 . | |
10233 .PP | |
10234 .B То же, но с MJPEG сжатием: | |
10235 .nf | |
10236 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 | |
10237 .fi | |
10238 . | |
10239 .PP | |
10240 .B Кодировать все *.jpg файлы в текущем каталоге: | |
10241 .nf | |
10242 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4 | |
10243 .fi | |
10244 . | |
10245 .PP | |
10246 .B Кодировать с тюнера (указывайте формат при помощи \-vf формат): | |
10247 .nf | |
10248 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw | |
10249 .fi | |
10250 . | |
10251 .PP | |
10252 .B Кодировать из канала (pipe): | |
10253 .nf | |
10254 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \- | |
10255 .fi | |
10256 . | |
10257 . | |
10258 .\" -------------------------------------------------------------------------- | |
10259 .\" Ошибки, авторы, стандартное уведомление | |
10260 .\" -------------------------------------------------------------------------- | |
10261 . | |
10262 .SH ОШИБКИ | |
10263 Не паникуйте. | |
10264 Если вы нашли их, сообщите об этом нам, но предварительно убедитесь, что прочли всю документацию. | |
10265 Также ображайте внимание на смайлики. :) | |
10266 Многие ошибки - результат некорректной настройки программы и использования параметров. | |
10267 Раздел документации, посвященный отправке сообщений об ошибках | |
10268 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:ru/\:bugreports.html) | |
10269 описывает как создать полезный отчет. | |
10270 . | |
10271 . | |
10272 . | |
10273 .SH АВТОРЫ | |
10274 .\" FIXME contributor!=разработчик | |
10275 MPlayer изначально был написан Arpad Gereoffy. | |
10276 Смотрите файл AUTHORS, чтобы получить список некоторых из множества других разработчиков. | |
10277 .PP | |
10278 MPlayer is (C) 2000\-2006 The MPlayer Team | |
10279 .PP | |
10280 Оригинальная английская версия этого руководства в основном была написана Gabucino, | |
10281 Jonas Jermann и Diego Biurrun. Сейчас она поддерживается Diego Biurrun. | |
10282 Первоначальный перевод осуществлен Владимиром Ворошиловым. | |
10283 Пожалуйста, отсылайте электронные письма об оригинальной странице в список рассылки MPlayer-DOCS. | |
10284 Письма, относящиеся к переводу, отсылайте в MPlayer-translations. | |
10285 .\" end of file |