comparison DOCS/man/en/mplayer.1 @ 14741:c29a660e8bd7

man page review part XVI
author diego
date Sun, 20 Feb 2005 18:34:06 +0000
parents d5ec03284ccf
children 09b0883f5f0e
comparison
equal deleted inserted replaced
14740:fa2103220331 14741:c29a660e8bd7
3493 Changes the sample rate of the audio stream to an integer srate in Hz. 3493 Changes the sample rate of the audio stream to an integer srate in Hz.
3494 It only supports the 16-bit little-endian format. 3494 It only supports the 16-bit little-endian format.
3495 With MEncoder, you need to also use \-srate <srate>. 3495 With MEncoder, you need to also use \-srate <srate>.
3496 .PD 0 3496 .PD 0
3497 .RSs 3497 .RSs
3498 .IPs srate 3498 .IPs <srate>
3499 the output sample rate 3499 the output sample rate
3500 .IPs length 3500 .IPs <length>
3501 length of the filter with respect to the lower sampling rate (default: 16) 3501 length of the filter with respect to the lower sampling rate (default: 16)
3502 .IPs linear 3502 .IPs <linear>
3503 if 1 then filters will be linearly interpolated between polyphase entries 3503 if 1 then filters will be linearly interpolated between polyphase entries
3504 .IPs count 3504 .IPs <count>
3505 log2 of the number of polyphase entries 3505 log2 of the number of polyphase entries
3506 (..., 10->1024, 11->2048, 12->4096, ...) 3506 (..., 10->1024, 11->2048, 12->4096, ...)
3507 (default: 10->1024) 3507 (default: 10->1024)
3508 .IPs cutoff 3508 .IPs <cutoff>
3509 cutoff frequency (0.0-1.0), default set depending upon filter length 3509 cutoff frequency (0.0-1.0), default set depending upon filter length
3510 .RE 3510 .RE
3511 .PD 1 3511 .PD 1
3512 . 3512 .
3513 .TP 3513 .TP
3519 Head-related transfer function: Converts multichannel audio to 3519 Head-related transfer function: Converts multichannel audio to
3520 2 channel output for headphones, preserving the spatiality of the sound. 3520 2 channel output for headphones, preserving the spatiality of the sound.
3521 . 3521 .
3522 .TP 3522 .TP
3523 .B channels[=nch] 3523 .B channels[=nch]
3524 Change the number of channels to nch output channels. 3524 Change the number of channels to <nch> output channels.
3525 If the number of output channels is bigger than the number of input channels 3525 If the number of output channels is bigger than the number of input channels
3526 empty channels are inserted (except when mixing from mono to stereo, then 3526 empty channels are inserted (except when mixing from mono to stereo, then
3527 the mono channel is repeated in both of the output channels). 3527 the mono channel is repeated in both of the output channels).
3528 If the number of output channels is smaller than the number of input channels 3528 If the number of output channels is smaller than the number of input channels
3529 the exceeding channels are truncated. 3529 the exceeding channels are truncated.
3531 .TP 3531 .TP
3532 .B format[=format] 3532 .B format[=format]
3533 Change the current sample format. 3533 Change the current sample format.
3534 .PD 0 3534 .PD 0
3535 .RSs 3535 .RSs
3536 .IPs format 3536 .IPs <format>
3537 Sets the desired format. 3537 Sets the desired format.
3538 The general form is 'sbe', where s denotes the sign (either s for signed or u 3538 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
3539 for unsigned), b denotes the number of bits per sample (16, 24 or 32) and e 3539 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
3540 denotes the endianness (le equals to little-endian, be to big-endian and ne to 3540 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
3541 the endianness that's native to the computer MPlayer is running on). 3541 and 'ne' the endianness of the computer MPlayer is running on).
3542 Valid values (amongst others) are: s16le, u32be and u24ne. 3542 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
3543 Exceptions to this rule are: u8, s8, floatle, floatbe, floatne, mulaw, alaw, 3543 Exceptions to this rule are: u8, s8, floatle, floatbe, floatne, mulaw, alaw,
3544 mpeg2, ac3 and imaadpcm. 3544 mpeg2, ac3 and imaadpcm.
3545 .RE 3545 .RE
3546 .PD 1 3546 .PD 1
3547 .br 3547 .br
3551 Select the output volume level. 3551 Select the output volume level.
3552 This filter is not reentrant and can therefore only be enabled once for every 3552 This filter is not reentrant and can therefore only be enabled once for every
3553 audio stream. 3553 audio stream.
3554 .PD 0 3554 .PD 0
3555 .RSs 3555 .RSs
3556 .IPs v 3556 .IPs <v>\ \
3557 Sets the desired gain in dB for all channels in the stream 3557 Sets the desired gain in dB for all channels in the stream
3558 from -200dB to +60dB (where -200dB mutes the sound 3558 from -200dB to +60dB (where -200dB mutes the sound
3559 completely and +60dB equals a gain of 1000). 3559 completely and +60dB equals a gain of 1000).
3560 .IPs sc 3560 .IPs <sc>\
3561 Enable soft clipping. 3561 Enable soft clipping.
3562 .RE 3562 .RE
3563 .PD 1 3563 .PD 1
3564 . 3564 .
3565 .TP 3565 .TP
3566 .B pan[=n:l01:l02:...l10:l11:l12:...ln0:ln1:ln2:...] 3566 .B pan[=n:l01:l02:...l10:l11:l12:...ln0:ln1:ln2:...]
3567 Mixes channels arbitrarily, see DOCS/\:HTML/\:en/\:audio.html for details. 3567 Mixes channels arbitrarily, see DOCS/\:HTML/\:en/\:audio.html for details.
3568 An example how to downmix a six-channel file to two channels with this 3568 An example how to downmix a six-channel file to two channels with this
3569 filter can be found in the examples section near the end of the manpage. 3569 filter can be found in the examples section near the end of the man page.
3570 .PD 0 3570 .PD 0
3571 .RSs 3571 .RSs
3572 .IPs n 3572 .IPs <n>\ \
3573 number of input channels (1\-6) 3573 number of input channels (1\-6)
3574 .IPs lij 3574 .IPs <lij>
3575 How much of input channel j is mixed into output channel i. 3575 How much of input channel j is mixed into output channel i.
3576 .RE 3576 .RE
3577 .PD 1 3577 .PD 1
3578 . 3578 .
3579 .TP 3579 .TP
3580 .B sub[=fc:ch] 3580 .B sub[=fc:ch]
3581 Add subwoofer channel. 3581 Add subwoofer channel.
3582 .PD 0 3582 .PD 0
3583 .RSs 3583 .RSs
3584 .IPs fc 3584 .IPs <fc>\
3585 cutoff frequency for low-pass filter (20Hz to 300Hz) (default: 60Hz) 3585 cutoff frequency for low-pass filter (20Hz to 300Hz) (default: 60Hz)
3586 .IPs ch 3586 .IPs <ch>\
3587 channel number for the sub-channel 3587 channel number for the sub-channel
3588 .RE 3588 .RE
3589 .PD 1 3589 .PD 1
3590 . 3590 .
3591 .TP 3591 .TP
3592 .B surround[=d] 3592 .B surround[=delay]
3593 Decoder for matrix encoded surround sound, works on many 2 channel files. 3593 Decoder for matrix encoded surround sound, works on many 2 channel files.
3594 .PD 0 3594 .PD 0
3595 .RSs 3595 .RSs
3596 .IPs d 3596 .IPs <delay>
3597 delay time in ms for the rear speakers (0ms to 1000ms) (default: 15ms) 3597 delay time in ms for the rear speakers (0ms to 1000ms) (default: 15ms)
3598 .RE 3598 .RE
3599 .PD 1 3599 .PD 1
3600 . 3600 .
3601 .TP 3601 .TP
3607 .TP 3607 .TP
3608 .B export[=mmapped_file[:nsamples]] 3608 .B export[=mmapped_file[:nsamples]]
3609 Exports the incoming signal to other processes using memory mapping (mmap()). 3609 Exports the incoming signal to other processes using memory mapping (mmap()).
3610 .PD 0 3610 .PD 0
3611 .RSs 3611 .RSs
3612 .IPs mmapped_file 3612 .IPs <mmapped_file>
3613 file to map data to (default: ~/.mplayer/\:mplayer-af_export) 3613 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
3614 .IPs nsamples 3614 .IPs <nsamples>
3615 number of samples per channel (default: 512) 3615 number of samples per channel (default: 512)
3616 .RE 3616 .RE
3617 .PD 1 3617 .PD 1
3618 . 3618 .
3619 .TP 3619 .TP
3620 .B extrastereo[=mul] 3620 .B extrastereo[=mul]
3621 Increases the difference between left and right channels to add some 3621 Increases the difference between left and right channels to add some
3622 sort of "live" effect to playback. 3622 sort of "live" effect to playback.
3623 .PD 0 3623 .PD 0
3624 .RSs 3624 .RSs
3625 .IPs mul\ \ 3625 .IPs <mul>
3626 difference coefficient (default: 2.5) 3626 difference coefficient (default: 2.5)
3627 .RE 3627 .RE
3628 .PD 1 3628 .PD 1
3629 . 3629 .
3630 .TP 3630 .TP
3635 .B ladspa=file:label[:controls...] 3635 .B ladspa=file:label[:controls...]
3636 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin. 3636 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
3637 This filter is reentrant, so multiple LADSPA plugins can be used at once. 3637 This filter is reentrant, so multiple LADSPA plugins can be used at once.
3638 .PD 0 3638 .PD 0
3639 .RSs 3639 .RSs
3640 .IPs file\ 3640 .IPs <file>
3641 Specifies the LADSPA plugin library file. 3641 Specifies the LADSPA plugin library file.
3642 If LADSPA_PATH is set, it searches for the specified file. 3642 If LADSPA_PATH is set, it searches for the specified file.
3643 If it is not set, you must supply a fully specified pathname. 3643 If it is not set, you must supply a fully specified pathname.
3644 .IPs label 3644 .IPs <label>
3645 Specifies the filter within the library. 3645 Specifies the filter within the library.
3646 Some libraries contain only one filter, but others contain many of them. 3646 Some libraries contain only one filter, but others contain many of them.
3647 Entering 'help' here, will list all available filters within the specified 3647 Entering 'help' here, will list all available filters within the specified
3648 library, which eliminates the use of 'listplugins' from the LADSPA SDK. 3648 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
3649 .IPs controls 3649 .IPs <controls>
3650 Controls are zero or more floating point values that determine the 3650 Controls are zero or more floating point values that determine the
3651 behaviour of the loaded plugin (for example delay, threshold or gain). 3651 behaviour of the loaded plugin (for example delay, threshold or gain).
3652 In verbose mode (add \-v to the MPlayer command line), all available controls 3652 In verbose mode (add \-v to the MPlayer command line), all available controls
3653 and their valid ranges are printed. 3653 and their valid ranges are printed.
3654 This eliminates the use of 'analyseplugin' from the LADSPA SDK. 3654 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
7524 In the above, "all candidates" doesn't exactly mean all enabled types: 7524 In the above, "all candidates" doesn't exactly mean all enabled types:
7525 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16. 7525 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16.
7526 . 7526 .
7527 .TP 7527 .TP
7528 .B level_idc=<10\-51> 7528 .B level_idc=<10\-51>
7529 Set the bitstream's Level as defined by Annex A of the H.264 standard. 7529 Set the bitstream's Level as defined by Annex A of the H.264 standard
7530 (default: 40 - Level 4.0).
7530 This is used for telling the decoder what capabilities it needs to 7531 This is used for telling the decoder what capabilities it needs to
7531 support. Use this parameter only if you know what it means, and you 7532 support. Use this parameter only if you know what it means, and you
7532 have a need to set it. 7533 have a need to set it.
7533 Default: 40 (Level 4.0)
7534 . 7534 .
7535 .TP 7535 .TP
7536 .B log=<-1\-3> 7536 .B log=<-1\-3>
7537 Adjust the amount of logging info printed to the screen. 7537 Adjust the amount of logging info printed to the screen.
7538 .RSs 7538 .RSs