annotate DOCS/mplayer.1 @ 344:9f66a83f31e6

yeah, cvs/DOCS is back! some minor corrections

申鐃緒申     1 .\" MPlayer (C) 2000-2001 Arpad Gereoffy <[e-mail]>
申鐃緒申     2 .\" This manpage was/is done by Gabucino
申鐃緒申     3 .\" Manpage v1.1
申鐃緒申     4 .\"
申鐃緒申     5 .TH MPlayer 0.11
申鐃緒申     6 .SH NAME
申鐃緒申     7 mplayer \- Movie Player for Linux
申鐃緒申     8 .SH SYNOPSIS
申鐃緒申     9 .B mplayer
申鐃緒申    10 .RB [ \-vo\ output\ driver ]
申鐃緒申    11 .RB [ \-vcd\ track\ number ]
申鐃緒申    12 .RB [ \-sb\ byte\ position ]
申鐃緒申    13 .RB [ \-nosound\ ]
申鐃緒申    14 .RB [ \-abs\ seconds ]
申鐃緒申    15 .RB [ \-delay\ secs ]
申鐃緒申    16 .RB [ \-bps\ value ]
申鐃緒申    17 .RB [ \-noalsa\ ]
申鐃緒申    18 .RB [ \-aid\ id ]
申鐃緒申    19 .RB [ \-vid\ id ]
申鐃緒申    20 .RB [ \-fps\ rate ]
申鐃緒申    21 .RB [ \-mc\ seconds/5f ]
申鐃緒申    22 .RB [ \-afm\ audio\ decoder ]
申鐃緒申    23 .RB [ \-fs\ ]
申鐃緒申    24 .RB [ \-x\ x ]
申鐃緒申    25 .RB [ \-y\ y ]
申鐃緒申    26 .RB [ \-xy\ factor ]
申鐃緒申    27 .RB [ \-dsp\ device ]
申鐃緒申    28 .RB [ \-pp\ quality ]
申鐃緒申    29 .RB [ \-include\ configfile ]
申鐃緒申    30 .RB [ \-ffactor\ number ]
申鐃緒申    31 .I file
申鐃緒申    32 .PP
申鐃緒申    33 .SH DESCRIPTION
申鐃緒申    34 .I mplayer
申鐃緒申    35 Yes. Yet another movie player for linux.
申鐃緒申    36 What is the special with this? It works, at least for me :)
申鐃緒申    37 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN,
申鐃緒申    38 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with
申鐃緒申    39 special files or with audio/video sync. Most of them is unable to play
申鐃緒申    40 both mpeg1, mpeg2 and avi (DivX) files. Many players have image quality
申鐃緒申    41 or speed problems too. So I've decided to write/modify one...
申鐃緒申    42 .LP
申鐃緒申    43 .SH "GENERAL OPTIONS"
申鐃緒申    44 .TP
申鐃緒申    45 .I NOTE
申鐃緒申    46 MPlayer works out-of-the-box, so you generally don't have to mess with
申鐃緒申    47 any options.
申鐃緒申    48 .TP
申鐃緒申    49 .BI \-vo\ output\ driver
申鐃緒申    50 select output driver
申鐃緒申    51 
申鐃緒申    52 you can get the list of available drivers executing
申鐃緒申    53 .I mplayer -vo help
申鐃緒申    54 
申鐃緒申    55 .TP
申鐃緒申    56 .BI \-vcd\ track
申鐃緒申    57 play video cd track from device instead of plain file
申鐃緒申    58 .TP
申鐃緒申    59 .BI \-nosound
申鐃緒申    60 don't play sound
申鐃緒申    61 .TP
申鐃緒申    62 .B \-fs
申鐃緒申    63 fullscreen playing (only gl, xmga and xv drivers)
申鐃緒申    64 
申鐃緒申    65 .I NOTE
申鐃緒申    66 The X11 driver doesn't support fullscreen and scaling.
申鐃緒申    67 However, you can do it yourself, just press ALT,CTRL,-
申鐃緒申    68 or ALT,CTRL,+ simultaneously, see X-server docs for details.
申鐃緒申    69 .TP
申鐃緒申    70 .B \-x\ x
申鐃緒申    71 scale image to x width [if driver suppports!]
申鐃緒申    72 .TP
申鐃緒申    73 .B \-y\ y
申鐃緒申    74 scale image to y height
申鐃緒申    75 .TP
申鐃緒申    76 .B \-xy\ factor
申鐃緒申    77 scale image by <factor>
申鐃緒申    78 .TP
申鐃緒申    79 .B \-dsp\ device
申鐃緒申    80 select another DSP output device
申鐃緒申    81 .TP
申鐃緒申    82 .B \-pp\ quality
申鐃緒申    83 apply postprocess filter on decoded image.
申鐃緒申    84 You need a STRONG CPU in order to use this!
申鐃緒申    85 The supported formats and settings are:
申鐃緒申    86 
申鐃緒申    87         MPEG 1/2   0 (none), 1, 3, 7, 15, 31, 63
申鐃緒申    88         OpenDivX   0 (none), 1, 3, 7, 15, 31, 63
申鐃緒申    89         DivX       0 (none), 1, 2, 3, 4
申鐃緒申    90 
申鐃緒申    91 .I NOTE
申鐃緒申    92 Maybe less/more.
申鐃緒申    93 
申鐃緒申    94 .I NOTE
申鐃緒申    95 You can use this with OpenDivX encoding too! See ALPHA/BETA CODE section.
申鐃緒申    96 .TP
申鐃緒申    97 .B \-ffactor\ number
申鐃緒申    98 resample alphamap of the font. Can be:
申鐃緒申    99 
申鐃緒申   100         0    plain white fonts
申鐃緒申   101         0.75 very narrow black outline [default]
申鐃緒申   102         1    narrow black outline
申鐃緒申   103         10   bold black outline
申鐃緒申   104 .IP
申鐃緒申   105 .SH "ADVANCED OPTIONS"
申鐃緒申   106 .TP
申鐃緒申   107 .I NOTE
申鐃緒申   108 These options can help you solve your particular problem.. Also, see the DOCS!
申鐃緒申   109 .TP
申鐃緒申   110 .B \-afm <1-5>
申鐃緒申   111 force audio format  1:MPEG 2:PCM 3:AC3 4:Win32 5:aLaw
申鐃緒申   112 
申鐃緒申   113 .I NOTE
申鐃緒申   114 With DivX AVIs with MP3 audio, you can choose whether to use MP3LIB (option 1),
申鐃緒申   115 or Win32 DLL l3codeca.acm (option 4) (default). On CPUs with the 3DNow!
申鐃緒申   116 instruction set, the first gives more performance. Your mileage may vary.
申鐃緒申   117 .TP
申鐃緒申   118 .BI \-sb\ position
申鐃緒申   119 seek to byte position
申鐃緒申   120 .TP
申鐃緒申   121 .BI \-abs\ bytes
申鐃緒申   122 audio buffer size (in bytes, default: measuring)
申鐃緒申   123 .TP
申鐃緒申   124 .B \-delay\ secs
申鐃緒申   125 audio delay in seconds (may be +/- float value)
申鐃緒申   126 .TP
申鐃緒申   127 .B \-bps
申鐃緒申   128 use avg. byte/sec value for A-V sync (AVI)
申鐃緒申   129 .TP
申鐃緒申   130 .B \-noalsa
申鐃緒申   131 disable timing code
申鐃緒申   132 .TP
申鐃緒申   133 .B \-aid\ id
申鐃緒申   134 select audio channel [MPG: 0-31  AVI: 1-99]
申鐃緒申   135 .TP
申鐃緒申   136 .B \-vid\ id
申鐃緒申   137 select video channel [MPG: 0-15  AVI:  -- ]
申鐃緒申   138 .TP
申鐃緒申   139 .B \-fps\ value
申鐃緒申   140 force frame rate (if value is wrong in the header)
申鐃緒申   141 .TP
申鐃緒申   142 .B \-mc\ seconds/5frame
申鐃緒申   143 maximum sync correction per 5 frames (in seconds)
申鐃緒申   144 .TP
申鐃緒申   145 .B \-ni
申鐃緒申   146 force usage of non-interleaved AVI parser
申鐃緒申   147 .TP
申鐃緒申   148 .B \-include
申鐃緒申   149 specify config file to be parsed after the default
申鐃緒申   150 .IP
申鐃緒申   151 .SH "ALPHA/BETA CODE"
申鐃緒申   152 .TP
申鐃緒申   153 .I NOTE
申鐃緒申   154 These are included in this manpage just for completeness! If you don't
申鐃緒申   155 know what are these, you DON'T need these! In either case, double-check DOCS!
申鐃緒申   156 .TP
申鐃緒申   157 .B \-br\ rate
申鐃緒申   158 used with '-vo odivx' .
申鐃緒申   159 Specifies the bitrate to encode OpenDivx at
申鐃緒申   160 (in bits! e.g: 780000).
申鐃緒申   161 .TP
申鐃緒申   162 .B \-encode\ file
申鐃緒申   163 used with '-vo odivx' .
申鐃緒申   164 Specifies the output OpenDivX file. Won't overwrite.
申鐃緒申   165 .IP
申鐃緒申   166 .SH KEYBOARD CONTROL
申鐃緒申   167 .TP
申鐃緒申   168 .I NOTE
申鐃緒申   169 These keys may/may not work, depending on your video output driver.
申鐃緒申   170 .TP
申鐃緒申   171 	  <-  or  ->      seek backward/forward  10 seconds
申鐃緒申   172 
申鐃緒申   173 up or down      seek backward/forward   1 minute
申鐃緒申   174 
申鐃緒申   175 p or SPACE      pause movie (press any key)
申鐃緒申   176 
申鐃緒申   177 q or ESC        stop playing and quit program
申鐃緒申   178 
申鐃緒申   179 + or -          adjust audio delay by +/- 0.1 second
申鐃緒申   180 .IP
申鐃緒申   181 .SH FILES AND DIRECTORIES
申鐃緒申   182 .TP
申鐃緒申   183 .I CONFIG FILES
申鐃緒申   184 Settings are stored system-wide in the /etc/mplayer.conf file,
申鐃緒申   185 and per-user in $HOME/.mplayer/config. The directory
申鐃緒申   186 $HOME/.mplayer and the 'config' are created if doesn't exist.
申鐃緒申   187 .TP
申鐃緒申   188 .I FONTS
申鐃緒申   189 Fonts are searched in $HOME/.mplayer/font. There must be a font.desc
申鐃緒申   190 file, and files with .RAW extension.
申鐃緒申   191 .TP
申鐃緒申   192 .I SUBTITLE FILES
申鐃緒申   193 Sub files are searched in $HOME/.mplayer/sub, and in the directory
申鐃緒申   194 of the movie.
申鐃緒申   195 .IP
申鐃緒申   196 .SH "EXAMPLES"
申鐃緒申   197 Just launch it! :)
申鐃緒申   198 .LP
申鐃緒申   199 .SH BUGS
申鐃緒申   200 Probably. Check DOCS.
申鐃緒申   201 
申鐃緒申   202 Bugreports should be addressed to the MPlayer-users mailing list
申鐃緒申   203 ([e-mail]) ! If you want to submit a bugreport
申鐃緒申   204 (which we love to receive!), please double-check the README, and
申鐃緒申   205 tell us all that we need to know to identify your problem.
申鐃緒申   206 
申鐃緒申   207 .LP
申鐃緒申   208 .SH AUTHORS
申鐃緒申   209 Check DOCS/AUTHORS !
申鐃緒申   210 
申鐃緒申   211 MPlayer is (C) 2000-2001
申鐃緒申   212 .I Arpad Gereoffy <[e-mail]>
申鐃緒申   213 
申鐃緒申   214 This manpage is maintained by
申鐃緒申   215 .I Gabucino.
申鐃緒申   216 .LP
申鐃緒申   217 .SH STANDARD DISCLAIMER
申鐃緒申   218 Use only at your own risk! There may be errors and inaccuracies that could 
申鐃緒申   219 be damaging to your system or your eye. Proceed with caution, and although
申鐃緒申   220 this is highly unlikely, the author doesn't take any responsibility for that!
申鐃緒申   221 .\" end of file