Mercurial > mplayer.hg

comparison DOCS/documentation.html @ 7792:a1465b7f3221

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Keyboard controls and options are described in the man page, removed the redundant description here, plus small fixes.
author diego
date Sat, 19 Oct 2002 04:22:50 +0000
parents 05e518badc1b
children 76940a39405a
comparison
equal deleted inserted replaced
7791:2c7d87662ea5 7792:a1465b7f3221
195 </UL> 195 </UL>
196 </LI> 196 </LI>
197 <LI><A HREF="#tv">2.5 TV input</A> 197 <LI><A HREF="#tv">2.5 TV input</A>
198 <UL> 198 <UL>
199 <LI><A HREF="#tv_compilation">2.5.1 Compilation</A></LI> 199 <LI><A HREF="#tv_compilation">2.5.1 Compilation</A></LI>
200 <LI><A HREF="#tv_options">2.5.2 Available options</A></LI> 200 <LI><A HREF="#tv_examples">2.5.2 Examples</A></LI>
201 <LI><A HREF="#tv_keyboard">2.5.3 Keyboard control</A></LI>
202 <LI><A HREF="#tv_examples">2.5.4 Examples</A></LI>
203 </UL> 201 </UL>
204 </LI> 202 </LI>
205 </UL> 203 </UL>
206 </LI> 204 </LI>
207 <LI><A HREF="#usage">3. Usage</A> 205 <LI><A HREF="#usage">3. Usage</A>
208 <UL> 206 <UL>
209 <LI><A HREF="#command_line">3.1 Command line</A></LI> 207 <LI><A HREF="#command_line">3.1 Command line</A></LI>
210 <LI><A HREF="#control">3.2 Control</A> 208 <LI><A HREF="#control">3.2 Control</A>
211 <UL> 209 <UL>
212 <LI><A HREF="#default_controls">3.2.1 Default controls</A></LI> 210 <LI><A HREF="#controls_configuration">3.2.1 Controls configuration</A>
213 <LI><A HREF="#controls_configuration">3.2.2 Controls configuration</A>
214 <UL> 211 <UL>
215 <LI><A HREF="#key_names">3.2.2.1 Key names</A></LI> 212 <LI><A HREF="#key_names">3.2.1.1 Key names</A></LI>
216 <LI><A HREF="#commands">3.2.2.2 Commands</A></LI> 213 <LI><A HREF="#commands">3.2.1.2 Commands</A></LI>
217 </UL> 214 </UL>
218 </LI> 215 </LI>
219 <LI><A HREF="#lirc">3.2.3 Control from LIRC</A></LI> 216 <LI><A HREF="#lirc">3.2.2 Control from LIRC</A></LI>
220 <LI><A HREF="#slave">3.2.4 Slave mode</A></LI> 217 <LI><A HREF="#slave">3.2.3 Slave mode</A></LI>
221 </UL> 218 </UL>
222 </LI> 219 </LI>
223 <LI><A HREF="#streaming">3.3 Streaming from network or pipes</A></LI> 220 <LI><A HREF="#streaming">3.3 Streaming from network or pipes</A></LI>
224 </UL> 221 </UL>
225 </LI> 222 </LI>
691 688
692 <PRE> 689 <PRE>
693 mkdir ~/.mplayer 690 mkdir ~/.mplayer
694 cd ~/.mplayer 691 cd ~/.mplayer
695 unzip mp-arial-iso-8859-1.zip 692 unzip mp-arial-iso-8859-1.zip
696 ln -s ~/.mplayer/arial-24 font 693 ln -s ~/.mplayer/iso-8859-1/arial-24 font
697 </PRE> 694 </PRE>
698 695
699 696
700 <H2><A NAME="gui">1.3 What about the GUI?</A></H2> 697 <H2><A NAME="gui">1.3 What about the GUI?</A></H2>
701 698
934 931
935 932
936 <H2><A NAME="tv"><B>2.5 TV input</B></A></H2> 933 <H2><A NAME="tv"><B>2.5 TV input</B></A></H2>
937 934
938 <P>This section is about how to enable <B>watching/grabbing from V4L compatible 935 <P>This section is about how to enable <B>watching/grabbing from V4L compatible
939 TV tuner</B>.</P> 936 TV tuner</B>. See the man page for a description of TV options and keyboard
937 controls.</P>
940 938
941 <P><B>THIS CODE IS CURRENTLY NOT BEING WORKED ON! Do not expect it to work 939 <P><B>THIS CODE IS CURRENTLY NOT BEING WORKED ON! Do not expect it to work
942 without tweaking/experimenting!</B></P> 940 without tweaking/experimenting!</B></P>
943 941
944 942
960 (<CODE>-vo sdl</CODE>) colorspaces. 958 (<CODE>-vo sdl</CODE>) colorspaces.
961 You can specify these with the <CODE>outfmt=YV12</CODE> option, see below. 959 You can specify these with the <CODE>outfmt=YV12</CODE> option, see below.
962 </BLOCKQUOTE> 960 </BLOCKQUOTE>
963 961
964 962
965 <H3><A NAME="tv_options">2.5.2 Available options</A></H3> 963 <H3><A NAME="tv_examples">2.5.2 Examples</A></H3>
966
967 <DL>
968 <DT><CODE>on</CODE></DT>
969 <DD>Use TV input.</DD>
970
971 <DT><CODE>noaudio</CODE></DT>
972 <DD>No sound, thanks.</DD>
973
974 <DT><CODE>driver</CODE></DT>
975 <DD><B>dummy</B> - NULL TV input :) Used for testing only, generates dummy
976 input.<BR>
977 <B>v4l</B> - Captures images from standard V4L interface (default
978 <CODE>/dev/video0</CODE>).</DD>
979
980 <DT><CODE>device</CODE></DT>
981 <DD>Specify a device other than the default <CODE>/dev/video0</CODE>.</DD>
982
983 <DT><CODE>input</CODE></DT>
984 <DD>Specify from which input of the TV tuner you wish to grab
985 (e.g. <B>television</B>, <B>s-video</B>, <B>composite</B>, ...)<BR>
986 Prints the available ones during init.</DD>
987
988 <DT><CODE>freq</CODE></DT>
989 <DD>Specify the frequency to set the tuner to (e.g. <B>511.250</B>).</DD>
990
991 <DT><CODE>outfmt</CODE></DT>
992 <DD>Specify the output format the tuner should use to transport images to us
993 (<B>rgb32</B>, <B>rgb24</B>, <B>yv12</B>, <B>uyvy</B>, <B>i420</B> (for i420
994 you have to pass the <CODE>-vc rawi420</CODE> option, because of a fourcc
995 conflict)).</DD>
996
997 <DT><CODE>width</CODE></DT>
998 <DD>width of the output window in pixels</DD>
999
1000 <DT><CODE>height</CODE></DT>
1001 <DD>height of the output window in pixels</DD>
1002
1003 <DT><CODE>norm</CODE></DT>
1004 <DD>available: PAL, SECAM, NTSC</DD>
1005
1006 <DT><CODE>channel</CODE></DT>
1007 <DD>Set the tuner to the given channel.</DD>
1008
1009 <DT><CODE>chanlist</CODE></DT>
1010 <DD>available: <CODE>us-bcast, us-cable, europe-west, europe-east, etc</CODE></DD>
1011 </DL>
1012
1013
1014 <H3><A NAME="tv_keyboard">2.5.3 Keyboard control</A></H3>
1015
1016 <TABLE BORDER=0>
1017 <TR><TD>&nbsp;&nbsp;</TD><TD>h / k</TD><TD>&nbsp;&nbsp;</TD><TD>select previous/next channel</TD></TR>
1018 <TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR>
1019 <TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR>
1020 </TABLE>
1021
1022
1023 <H3><A NAME="tv_examples">2.5.4 Examples</A></H3>
1024 964
1025 <P>Dummy output, to AAlib :)<BR> 965 <P>Dummy output, to AAlib :)<BR>
1026 <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR> 966 <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR>
1027 <BR> 967 <BR>
1028 Input from standard V4L<BR> 968 Input from standard V4L<BR>
1073 1013
1074 <H2><A NAME="control">3.2 Control</A></H2> 1014 <H2><A NAME="control">3.2 Control</A></H2>
1075 1015
1076 <P><B>MPlayer</B> has a fully configurable, command driven, control layer which 1016 <P><B>MPlayer</B> has a fully configurable, command driven, control layer which
1077 lets you control <B>MPlayer</B> with keyboard, mouse, joystick or remote 1017 lets you control <B>MPlayer</B> with keyboard, mouse, joystick or remote
1078 control (using LIRC).</P> 1018 control (using LIRC). See the man page for the complete list of keyboard
1079 1019 controls.</P>
1080 1020
1081 <H3><A NAME="default_controls">3.2.1 Default controls</A></H3> 1021
1082 1022 <H3><A NAME="controls_configuration">3.2.1 Controls configuration</A></H3>
1083 <H4>Keyboard controls from terminal:</H4>
1084
1085 <TABLE BORDER=0>
1086 <TR><TD>&nbsp;&nbsp;</TD><TD>&lt;- or -&gt;</TD><TD>&nbsp;&nbsp;</TD><TD>seek backward/forward 10 seconds</TD></TR>
1087 <TR><TD></TD><TD>up or down</TD><TD></TD><TD>seek backward/forward 1 minute</TD></TR>
1088 <TR><TD></TD><TD>pgup/pgdown</TD><TD></TD><TD>seek backward/forward 10 minutes</TD></TR>
1089 <TR><TD></TD><TD>&lt; or &gt;</TD><TD></TD><TD>seek backward/forward in playlist</TD></TR>
1090 <TR><TD></TD><TD>p or SPACE</TD><TD></TD><TD>pause movie (press any key)</TD></TR>
1091 <TR><TD></TD><TD>q or ESC</TD><TD></TD><TD>stop playing and quit program</TD></TR>
1092 <TR><TD></TD><TD>+ or -</TD><TD></TD><TD>adjust audio delay by +/- 0.1 second</TD></TR>
1093 <TR><TD></TD><TD>/ or *</TD><TD></TD><TD>decrease/increase volume</TD></TR>
1094 <TR><TD></TD><TD>9 or 0</TD><TD></TD><TD>decrease/increase volume</TD></TR>
1095 <TR><TD></TD><TD>m</TD><TD></TD><TD>mute sound</TD></TR>
1096 <TR><TD></TD><TD>f</TD><TD></TD><TD>toggle fullscreen</TD></TR>
1097 <TR><TD></TD><TD>w or e</TD><TD></TD><TD>decrease/increase panscan range</TD></TR>
1098 <TR><TD></TD><TD>o</TD><TD></TD><TD>toggle OSD: none / seek / seek+timer</TD></TR>
1099 <TR><TD></TD><TD>d</TD><TD></TD><TD>toggle frame dropping</TD></TR>
1100 <TR><TD></TD><TD>v</TD><TD></TD><TD>toggle subtitle visibility</TD></TR>
1101 <TR><TD></TD><TD>z or x</TD><TD></TD><TD>adjust subtitle delay by +/- 0.1 second</TD></TR>
1102 <TR><TD></TD><TD>r or t</TD><TD></TD><TD>adjust subtitle position</TD></TR>
1103 <TR><TD></TD><TD>HOME or END</TD><TD></TD><TD>go to next/previous playtree entry in the parent list</TD></TR>
1104 <TR><TD></TD><TD>INSERT or DELETE</TD><TD></TD><TD>go to next/previous alternative source (only available in asx playlist)</TD></TR>
1105 <TR><TD COLSPAN=4><P><I>(the following keys are valid only when using -vo xv or -vo [vesa|fbdev]:vidix or -vo xvidix -vo (x)mga or -vc divxds (slow).)</I></P></TD></TR>
1106 <TR><TD></TD><TD>1 or 2</TD><TD></TD><TD>adjust contrast</TD></TR>
1107 <TR><TD></TD><TD>3 or 4</TD><TD></TD><TD>adjust brightness</TD></TR>
1108 <TR><TD></TD><TD>5 or 6</TD><TD></TD><TD>adjust hue</TD></TR>
1109 <TR><TD></TD><TD>7 or 8</TD><TD></TD><TD>adjust saturation</TD></TR>
1110 </TABLE>
1111
1112 <H4>GUI keyboard controls:</H4>
1113
1114 <TABLE BORDER=0>
1115 <TR><TD>&nbsp;&nbsp;</TD><TD>, and .</TD><TD>&nbsp;&nbsp;</TD><TD>previous / next file</TD></TR>
1116 <TR><TD></TD><TD>gray - or +</TD><TD></TD><TD>decrease / increase volume</TD></TR>
1117 <TR><TD></TD><TD>enter</TD><TD></TD><TD>start playing</TD></TR>
1118 <TR><TD></TD><TD>space</TD><TD></TD><TD>pause</TD></TR>
1119 <TR><TD></TD><TD>s</TD><TD></TD><TD>stop</TD></TR>
1120 <TR><TD></TD><TD>a</TD><TD></TD><TD>about</TD></TR>
1121 <TR><TD></TD><TD>l</TD><TD></TD><TD>load file</TD></TR>
1122 <TR><TD></TD><TD>b</TD><TD></TD><TD>skin browser</TD></TR>
1123 <TR><TD></TD><TD>e</TD><TD></TD><TD>toggle equalizer</TD></TR>
1124 <TR><TD></TD><TD>p</TD><TD></TD><TD>toggle playlist</TD></TR>
1125 <TR><TD></TD><TD>f</TD><TD></TD><TD>toggle fullscreen</TD></TR>
1126 <TR><TD></TD><TD>m</TD><TD></TD><TD>toggle mute</TD></TR>
1127 </TABLE>
1128
1129 <H4>Keyboard controls for TV input:</H4>
1130
1131 <TABLE BORDER=0>
1132 <TR><TD>&nbsp;&nbsp;</TD><TD>h or l</TD><TD>&nbsp;&nbsp;</TD><TD>select previous/next channel</TD></TR>
1133 <TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR>
1134 <TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR>
1135 </TABLE>
1136
1137
1138 <H3><A NAME="controls_configuration">3.2.2 Controls configuration</A></H3>
1139 1023
1140 <P><B>MPlayer</B> allows you bind any key/button to any <B>MPlayer</B> command 1024 <P><B>MPlayer</B> allows you bind any key/button to any <B>MPlayer</B> command
1141 using a simple config file. The syntax consist of a key name followed by a 1025 using a simple config file. The syntax consist of a key name followed by a
1142 command. The default config file location is 1026 command. The default config file location is
1143 <CODE>$HOME/.mplayer/input.conf</CODE> but it can be overridden using the 1027 <CODE>$HOME/.mplayer/input.conf</CODE> but it can be overridden using the
1160 &lt; pt_step -1 1044 &lt; pt_step -1
1161 ENTER pt_step 1 1 1045 ENTER pt_step 1 1
1162 </PRE> 1046 </PRE>
1163 1047
1164 1048
1165 <H4><A NAME="key_names">3.2.2.1 Key names</A></H4> 1049 <H4><A NAME="key_names">3.2.1.1 Key names</A></H4>
1166 1050
1167 <P>You can have a full list by running <CODE>mplayer -input keylist</CODE></P> 1051 <P>You can have a full list by running <CODE>mplayer -input keylist</CODE></P>
1168 1052
1169 <H4>Keyboard:</H4> 1053 <H4>Keyboard:</H4>
1170 1054
1213 <LI>JOY_AXIS9_PLUS</LI> 1097 <LI>JOY_AXIS9_PLUS</LI>
1214 <LI>JOY_AXIS9_MINUS</LI> 1098 <LI>JOY_AXIS9_MINUS</LI>
1215 </UL> 1099 </UL>
1216 1100
1217 1101
1218 <H4><A NAME="commands">3.2.2.2 Commands</A></H4> 1102 <H4><A NAME="commands">3.2.1.2 Commands</A></H4>
1219 1103
1220 <P>You can have a full list of known commands by running "mplayer -input cmdlist"</P> 1104 <P>You can have a full list of known commands by running "mplayer -input cmdlist"</P>
1221 1105
1222 <UL> 1106 <UL>
1223 <LI><B>seek</B> (int) val [(int) type=0] 1107 <LI><B>seek</B> (int) val [(int) type=0]
1278 <LI><B>gui_skinbrowser</B> 1162 <LI><B>gui_skinbrowser</B>
1279 <P>GUI actions</P></LI> 1163 <P>GUI actions</P></LI>
1280 </UL> 1164 </UL>
1281 1165
1282 1166
1283 <H3><A NAME="lirc">3.2.3 Control from LIRC</A></H3> 1167 <H3><A NAME="lirc">3.2.2 Control from LIRC</A></H3>
1284 1168
1285 <P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, 1169 <P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver,
1286 an (almost) arbitrary remote control and control your Linux box with it! 1170 an (almost) arbitrary remote control and control your Linux box with it!
1287 More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P> 1171 More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P>
1288 1172
1328 1212
1329 <P>If you don't like the standard location for the lirc-config file (~/.lircrc) 1213 <P>If you don't like the standard location for the lirc-config file (~/.lircrc)
1330 use the -lircconf &lt;filename&gt; switch to specify another file.</P> 1214 use the -lircconf &lt;filename&gt; switch to specify another file.</P>
1331 1215
1332 1216
1333 <H3><A NAME="slave">3.2.4 Slave mode</A></H3> 1217 <H3><A NAME="slave">3.2.3 Slave mode</A></H3>
1334 1218
1335 <P>The slave mode allow you to build simple frontend to <B>MPlayer</B>. When 1219 <P>The slave mode allow you to build simple frontend to <B>MPlayer</B>. When
1336 enabled (with the <CODE>-slave</CODE> switch) <B>MPlayer</B> will read 1220 enabled (with the <CODE>-slave</CODE> switch) <B>MPlayer</B> will read
1337 commands separated by new line (\n) from stdin.</P> 1221 commands separated by new line (\n) from stdin.</P>
1338 1222
1573 <P>There are some public mailing lists on <B>MPlayer</B>. Unless explicitly 1457 <P>There are some public mailing lists on <B>MPlayer</B>. Unless explicitly
1574 stated otherwise the language of these lists is <B>English</B>. Please do 1458 stated otherwise the language of these lists is <B>English</B>. Please do
1575 not send messages in other languages or HTML mail! Message size limit is 80k. 1459 not send messages in other languages or HTML mail! Message size limit is 80k.
1576 If you have something bigger put it up for download somewhere. Click the 1460 If you have something bigger put it up for download somewhere. Click the
1577 links to subscribe. On the mailing lists, the same rules about writing 1461 links to subscribe. On the mailing lists, the same rules about writing
1578 and quoting aply as on usenet. Please follow them, it makes the life of 1462 and quoting apply as on usenet. Please follow them, it makes the life of
1579 those who read your mails a lot easier. If you dont know them please 1463 those who read your mails a lot easier. If you do not know them please
1580 read <A HREF="http://learn.to/edit_messages">HOWTO edit messages</A> or 1464 read <A HREF="http://learn.to/edit_messages">HOWTO edit messages</A> or
1581 (if you are in a hurry) 1465 (if you are in a hurry)
1582 <A HREF="http://www.xs4all.nl/~hanb/documents/quotingguide.html"> 1466 <A HREF="http://www.xs4all.nl/~hanb/documents/quotingguide.html">
1583 Quoting HOWTO</A>.</P> 1467 Quoting HOWTO</A>.</P>
1584 1468