README.config_en
1 ------------------
2 xine configuration
3 ------------------
4
5These settings may be found on ~/.xine/config.
6
7Since xine 0.9.6 they may also be changed using the xine setup dialog.
8
9Some settings on setup dialog will require xine to be restarted to take effect.
10
11Only the xine-ui config entries are described here. You can find the general
12xine-lib config entries explained in README.config_en from xine-lib.
13
14
15
16xine-ui specific values:
17-----------------------
18
19gui.tips_visible gui tips visibility
20
21gui.tips_timeout tips timeout (ms), default: 500
22
23gui.skin skin to use, see <prefix>/share/xine/skins
24 for installed skins
25 (e.g. default, lcd, pitt, xinetic)
26
27gui.layer_above Boolean value of WM layer property using.
28
29gui.use_xvidext xine can switch to a different screen resolution which
30 fits your video material best when toggling fullscreen
31 mode by using the XF86VidMode Extension.
32 (0) off [default]
33 (1) on
34
35gui.stream_resize_window this setting control xine-ui resizing behaviour.
36 there are two possible policies:
37 (0) off: never resize window to match stream size.
38 user should manually change the video window
39 to the desired size. all streams will be fitted
40 inside the window.
41 (1) on: always resize window when stream size changes.
42 user may still manually resize a playing video
43 but if the stream size changes (eg. next MRL,
44 dvd menus, etc) the window will be automatically
45 resized.
46
47gui.zoom_small_stream automatically double window size when playing small
48 videos.
49 (this setting requires stream_resize_window enabled)
50
51gui.warn_unhandled_codec Display popup window on unhandled codecs
52 { never, video only, audio only, always }
53
54gui.skip_by_chapter If set and plugin supports it (currently only
55 dvdnav), play next|previous button will skip
56 by chapter.
57
58 A value of 0 will revert to the original xine
59 behavior of always skipping to the next|previous
60 mrl.
61
62
63*** NOTE: following values shouldn't be changed by user:
64gui.panel_x X coords of panel window in root window.
65
66gui.panel_y Y coords of panel window in root window.
67
68gui.panel_visible Visibility boolean value of panel window.
69
70gui.control_x X coords of control window in root window.
71
72gui.control_y Y coords of control window in root window.
73
74gui.playlist_x X coords of playlist window in root window.
75
76gui.playlist_y Y coords of playlist window in root window.
77
78gui.x_mrl_browser X coords of mrl browser window in root window.
79
80gui.y_mrl_browser Y coords of mrl browser window in root window.
81***
82
README.cs.0.Introduction
1++++++++++++++++++++++ +++++++++++++++++++++++
2 XINE: Svobodný video přehrávač
3++++++++++++++++++++++ +++++++++++++++++++++++
4
5
6xine je svobodný přehrávač multimédií licencovaný pod GPL navržený k přehrávání
7všech typů multimediálních souborů.
8(Ještě jsme nemohli dosáhnout tohoto cíle, ale už jsme docela blízko.)
9
10Toto je dokumentace pro koncové uživatele xine. Více informací můžete nalézt
11v adresářích s dokumentací balíčků xine-lib a xine-ui, obvykle budou
12nainstalovány v /usr/share/doc nebo /usr/share/doc/packeges nebo, pokud jste
13kompilovali xine sami, v /usr/local/share/doc nebo
14/usr/local/share/doc/packages.
15
16Další informace jako seznam vlastností, software dalších projektů, které
17používáme, nebo přání vývojářů v případě, že chcete darem podpořit projekt
18xine, můžete nalézt na webové stránce xine http://www.xine-project.org/.
19
20Jestliže se při používání xine setkáte s jakýmikoliv problémy, vězte, že
21většinu problémů i jejich řešení najdete ve FAQ, které jsou součástí xine-lib.
22Aktuální verzi lze vždy nalézt na webové stránce
23http://www.xine-project.org/faq.
24
25K dispozici je také vývojářská dokumentace nazvaná "Hackerský průvodce xine"
26(xine hacker's guide). Jestliže se chystáte pomoci s rozšířením možností a
27funkcí xine nebo chcete prostě vědět, jak pracuje xine uvnitř, podívejte se do
28ní. Vývojářská dokumentace je na vašem systému nainstalována ve formě HTML,
29kromě toho můžete získat aktuální verzi na
30http://www.xine-project.org/hackersguide.
31
32Jestliže odpověď na vaši otázku nebo řešení vašeho problému nenajdete ve výše
33uvedených zdrojích, poraďte se na mailing listu xine-user@lists.sourceforge.net
34v případě problémů s používáním xine nebo na mailing listu
35xine-devel@lists.sourceforge.net v případě dotazů týkajících se vývoje xine.
36
37Přejeme příjemné používání xine.
38
README.cs.10.Remote_control
1xine může být dálkově ovládáno infračerveným ovladačem. Abyste mohli tuto
2vlastnost používat, musíte mít nainstalováno LIRC. Podrobnosti najdete na
3http://www.lirc.org/.
4
5Do vašeho souboru ~/.lircrc přidejte některé položky, např.:
6
7 begin
8 remote = SAMSUNG
9 button = Button_Play
10 prog = xine
11 repeat = 0
12 config = Play
13 end
14 begin
15 remote = SAMSUNG
16 button = Button_1
17 prog = xine
18 repeat = 0
19 config = SetPosition10%
20 end
21
22xine dokáže samo vytvořit návrh lirc položek použitím 'xine --keymap=lirc'.
23Výstup přesměrujte do souboru a dolaďte tam nastavení.
24
25Každá položka pak bude vypadat asi takto:
26
27 # Reduce the output window size.
28 begin
29 remote = xxxxx
30 button = xxxxx
31 prog = xine
32 repeat = 0
33 config = WindowReduce
34 end
35
36Je na vás uvést jméno v remote a přiřadit button.
37
38
39K získání automaticky načteného playlistu z daného vstupního modulu můžete
40použít speciální klíčové slovo 'PlaylistFrom:' následované jménem modulu
41(stejné jako popisek tlačítka na panelu xine):
42
43 # Retrieve playlist from DVD plugin.
44 begin
45 remote = xxxxx
46 button = xxxxx
47 prog = xine
48 repeat = 0
49 config = PlaylistFrom:DVD
50 end
51
README.cs.15.MRLs
1Pro výběr multimédií, které chcete přehrát, používá xine systém zvaný MRL
2(Media Resource Locator). Jak již napovídá název, MRL jsou si velmi podobné
3URL, které znáte z vašich webových prohlížečů. Ve skutečnosti je zde zobecnění
4pro obojí: URI (Uniform Resource Identifier) definované v RFC2396.
5
6MRL xine se dělí na dvě hlavní části: zdroj vstupu a nastavení dat. Nastavení
7dat je volitelné. Jestliže se uvede, musí se oddělit od zdroje vstupu znakem
8'#'.
9
10
11zdroj vstupu
12------------
13
14Zdroj vstupu říká xine, kde získat data k přehrání. Abychom začali něčím dobře
15známým, většina UNIXovských cest a jmen souborů jsou platné. Jsou zde některé
16znaky, které vyžadují zvláštní zacházení, ale i trochu nesprávné MRL xine zkouší
17zpracovávat elegantně.
18
19U zdrojů dat jiných než jsou jména souborů musíte začít třídou vstupu
20následovanou dvojtečkou ':'. Co má přijít za dvojtečkou závisí na použitém
21vstupu. Některé důležité příklady by měly být vysvětleny:
22
23 file:/cesta/k/souboru přehraje zadaný soubor
24 stdin:/ získá data ze standardního vstupu
25 fifo:/cesta/k/souboru získá data z dané fronty (fifo)
26
27 cdda:/ přehraje zvukové CD
28 cdda:/5 přehraje stopu 5 ze zvukového CD
29
30 dvd:/ přehraje DVD
31 dvd:/2 přehraje DVD od titulu 2
32 dvd:/2.4 přehraje DVD od titulu 2, část 4
33
34 http://server/umístění/soubor přehraje soubor z webu
35 mms://server/umístění/soubor přehraje soubor přes protokol MMS
36 pnm://server/umístění/soubor přehraje soubor přes protokol PNM
37 rtsp://server/umístění/soubor přehraje soubor přes protokol RTSP
38
39 tcp://host:port přijímá data přes soket TCP
40 slave://host:port přijímá data vysílaná pomocí xine
41
42 udp://host:port přijímá vícesměrová data přes UDP
43 udp://host:port?iface=eth0 přijímá vícesměrová data přes UDP z eth0
44 rtp://host:port přijímá vícesměrová data RTP
45 rtp://host:port?iface=eth0 přijímá vícesměrová data RTP
46
47 dvb:/ ukáže digitální vysílání videa (Digital
48 Video Broadcast)
49 dvb:/7 ukáže DVB stanici 7
50
51 v4l:/tuner/frekvence přijme data ze zařízení Video4Linux
52
53
54nastavení dat
55-------------
56
57Část nastavení dat vám dovoluje předat speciální volby pro přehrávání přímo
58v MRL. Jednotlivé volby se oddělují středníkem ';'.
59Možné volby jsou:
60
61 novideo ignorovat v datech video
62 noaudio ignorovat v datech zvuk
63 nospu ignorovat v datech titulky
64
65 volume:hodnota nastavit hlasitost na zadanou hodnotu
66 compression:hodnota nastavit úroveň komprese na zadanou hodnotu
67
68 subtitle:soubor zobrazit titulky z odděleného souboru
69
70 save:jméno_souboru uložit data do určeného souboru
71
72 config_entry:hodnota změnit položku konfigurace na zadanou
73 hodnotu
74
75 demux:demuxer_plugin použít zadaný demultiplexor "demuxer_plugin"
76 lastdemuxprobe:demuxer_plugin použito k debugování
77
78
79příklady
80--------
81
82Následující příklady ukazují možnosti MRL:
83
84 váš_film.avi#subtitle:vaše_titulky.srt
85
86 přehraje uvedené avi se zobrazováním
87 titulků z daného souboru
88
89 http://nějaký.server.org/stream.mpg#save:savedstream.mpg
90
91 bude stahovat soubor přes HTTP a bude ho
92 ukládat na disk během přehrávání
93
94 dvd:/1.1#novideo
95
96 přehraje první část prvního titulu DVD,
97 ale pouze zvuk
98
99 stdin:/#demux:rawdv
100
101 přehraje DV data ze standardního vstupu,
102 může se použít pro live DV data
103
README.cs.5.xine-ui
1To, co vidíte jako "xine", se ve skutečnosti skládá ze dvou hlavních částí:
2* xine-lib nebo libxine je takzvaný engine zahrnující všechnu základní
3 funkčnost xine jako získávání médií z různých podporovaných zdrojů vstupů,
4 dekódování videa a zvuku, synchronizace přehrávání a dodatečné zpracování.
5 Tato část xine je jen pouze akumulace funkčnosti, programátoři toto nazývají
6 knihovna. Koncoví uživatelé nemohou xine-lib použít přímo, jelikož zde není
7 rozhraní k interakci se xine-lib.
8* Druhá část je takzvaný "frontend". Obaluje uživatelské rozhraní kolem
9 xine-lib, činí xine-lib použitelným pro všechny.
10
11Výhodou tohoto oddělení je, že si můžete vybrat mezi různými odlišnými
12"frontendy". Ten, který používáte teď, je známý jako "xine-ui". Některé
13zajímavé vlastnosti xine-ui jsou v krátkosti uvedeny níže:
14
15
16Menu
17----
18
19Všechny klíčové funkce xine jsou přístupné z hlavního menu xine-ui, které
20získáte klepnutím pravým tlačítkem myši buď na okno s videem nebo na panel.
21Většina položek je samovysvětlující.
22
23
24Prohlížeč MRL
25-------------
26
27Způsob, jakým xine popisuje média k přehrání, jsou MRL. Více o tomto zajímavém
28pojetí si můžete přečíst v sekci MRL. Z důvodu schopností MRL není běžný dialog
29pro výběr souborů dostatečný pro sdělení xine, jaká data přehrát. Prohlížeč
30MRL tudíž dovoluje nejen procházet vašimi soubory, nechá vás také vybrat jiný
31typ vstupu z média, které nabízí svůj vlastní výběr možných dat k přehrání.
32Můžete otevřít prohlížeč MRL pomocí odpovídající ikony vašeho oblíbeného skinu
33nebo vybráním Otevřít->Umístění z menu.
34
35Běžný souborový dialog je rovněž k dispozici, můžete ho získat na
36Otevřít->Soubor v menu.
37
38
39Playlisty
40---------
41
42xine-ui také samozřejmě pracuje s playlisty. Editor playlistu umístěný
43na Playlist->Editor nebo reprezentovaný tlačítkem ve vašem skinu vám dovoluje
44načíst, uložit a editovat playlisty. Editor záložek vám dovoluje detailně
45editovat aktuální položku playlistu a přidělit další volby přehrávání, např.
46oddělený soubor s titulky. Editor záložek standardně otevřete stiskem Ctrl-e.
47
48
49Autoscan tlačítka
50-----------------
51
52Autoscan tlačítka najdete v panelu xine nebo v editoru playlistu. Jsou to
53zástupci pro vytvoření playlistu z určitých dobře známých zdrojových médií. Při
54výchozím nastavení se začne playlist hned přehrávat. Např. stisk autoscan
55tlačítka popsaného "DVD" začne, jak název napovídá, přehrávat DVD ve vaší
56mechanice pomocí vytvořeného playlistu.
57
58
59Přídavné efekty
60---------------
61
62xine poskytuje sadu efektů dodatečného zpracování, které můžete použít na vaše
63video. V menu vyberte Video->Dodatečné zpracování->Zřetězená reakce. Otevře se
64okno "Zřetězená reakce", kde můžete vytvořit sadu přídavných efektů, které se
65použijí na video. Vyberte si přídavný filtr, vyberte a přizpůsobte si volby,
66které jsou k dispozici, abyste si filtr vylepšili podle potřeby. Chcete-li
67přidat ještě další efekt do řetězce, klikněte na "Nový filtr".
68
69
70Navigace v menu média
71---------------------
72
73Některé typy médií jsou interaktivní, nejběžnější příklad jsou dnes DVD, kde si
74můžete vybrat všechny druhy voleb z podrobných menu. xine poskytuje vícero
75způsobů, jak se pohybovat v takovém interaktivním obsahu.
76* 1) Můžete klikat vaší myší přímo na položky v okně videa.
77* 2) Můžete použít panel na posílání událostí, který lze otevřít z menu
78 položkou Volby->Navigace.
79* 3) Můžete použít položky v menu, abyste se dostali přímo na různá podmenu
80 vašeho interaktivního média. Toto bude mít efekt pouze tehdy, poskytuje-li
81 dané menu zdroj, který přehráváte.
82* 4) Můžete použít klávesnici. Přednastaveno je, že šipkami na numerické
83 klávesnici budete přesunovat zvýraznění v menu a Enter vybere zvýrazněné
84 tlačítko.
85 Přes numerickou klávesnici jsou k dispozici také další zajímavé funkce:
86 (Uvedené klávesy jsou z přednastaveného mapování kláves.)
87 S PgUp a PgDown se budete pohybovat zpět a vpřed mezi kapitolami.
88 Home a End vybere úhel, který přehrát, je-li k dispozici více úhlů.
89
README.en.0.Introduction
1+++++++++++++++++++++++++ +++++++++++++++++++++++++
2 XINE: A Free Video Player
3+++++++++++++++++++++++++ +++++++++++++++++++++++++
4
5
6xine is a free, GPL licensed media player designed to play everything you want.
7(We might not have reached that goal yet, but we are pretty close.)
8
9This is the end-user documentation for xine. You can find more documentation in
10the documentation directories of the xine-lib and xine-ui packages, usually
11these will be installed in /usr/share/doc/ or /usr/share/doc/packages, or, if
12you compiled xine yourself in /usr/local/share/doc/ or
13/usr/local/share/doc/packages.
14
15Further information like a feature list, the software of other projects we use
16and the developer's wishlists in case you want to support xine by donation can
17be found on the xine website at http://www.xine-project.org/.
18
19If you experience any problems with xine, be sure to first have a look at the
20FAQ, which should come together with xine-lib. Additionally, the latest version
21can always be found on the website http://www.xine-project.org/faq.
22
23There is also a developer's document available, called the xine hacker's guide.
24If you are going to help in extending xine or simply want to know, how xine
25works inside, have a look at this. You should find it installed on your system
26in HTML form, but you can also browse the latest version at
27http://www.xine-project.org/hackersguide.
28
29If all else fails and you still have questions, consult the xine-user mailing
30list at sourceforge for usage problems or the xine-devel list for questions on
31xine development.
32
33Have fun with xine.
34
README.en.10.Remote_control
1xine can be remotely controlled with an infrared control. For this, you should
2have LIRC installed. See http://www.lirc.org/ for details.
3
4You should add some entries in your ~/.lircrc file, like this:
5
6 begin
7 remote = SAMSUNG
8 button = Button_Play
9 prog = xine
10 repeat = 0
11 config = Play
12 end
13 begin
14 remote = SAMSUNG
15 button = Button_1
16 prog = xine
17 repeat = 0
18 config = SetPosition10%
19 end
20
21xine can self generate a lirc entries draft, using 'xine --keymap=lirc',
22then you can redirect the output to a file and polish the settings there.
23
24Each entry will look like this:
25
26 # Reduce the output window size.
27 begin
28 remote = xxxxx
29 button = xxxxx
30 prog = xine
31 repeat = 0
32 config = WindowReduce
33 end
34
35It's yours to specify the remote name, and assign the button.
36
37
38To Retrieve an autoscan playlist from a given input plugin, you can use the
39special 'PlaylistFrom:' keyword, followed by the plugin name (the same as the
40button label in the xine panel):
41
42 # Retrieve playlist from DVD plugin.
43 begin
44 remote = xxxxx
45 button = xxxxx
46 prog = xine
47 repeat = 0
48 config = PlaylistFrom:DVD
49 end
50
README.en.15.MRLs
1To specify what you want xine to play, we use a system called MRL, Media
2Resource Locator. As the name suggests, MRLs are very similar to the URLs you
3know from your webbrowser. In fact, there is a common superset of both, the URIs
4(Uniform Resource Identifier) as defined in RFC2396.
5
6xine's MRLs are divided into two major parts, the input source and the stream
7setup. The latter is optional. If it exists, it is separated from the input
8source by a crosshatch '#' character.
9
10
11input source
12------------
13
14The input source part tells xine, where to get the data to play. To start with
15something well known, almost all UNIX-like paths and filenames are valid here.
16There are some characters which require special treatment, but xine tries to
17handle even slightly invalid MRLs gracefully.
18
19For input sources other than filenames, you must start with the class of input
20followed by a colon ':'. What comes after that depends on the actual input.
21Some prominent examples should clarify:
22
23 file:/path/to/file plays the given file
24 stdin:/ receives a stream from standard input
25 fifo:/path/to/file receives a stream from the given fifo
26
27 cdda:/ plays a CD audio
28 cdda:/5 plays track 5 from a CD audio
29
30 dvd:/ plays a DVD
31 dvd:/2 plays a DVD starting at title 2
32 dvd:/2.4 plays a DVD starting at title 2, part 4
33
34 http://server/location/file plays a file from the web
35 mms://server/location/file plays a file via MMS streaming
36 pnm://server/location/file plays a file via PNM streaming
37 rtsp://server/location/file plays a file via RTSP streaming
38
39 tcp://host:port receives a stream through a TCP socket
40 slave://host:port receives a stream from a xine broadcast
41
42 udp://host:port receives a multicast stream through UDP
43 udp://host:port?iface=eth0 receives a multicast stream through UDP from eth0
44 rtp://host:port receives a RTP multicast stream
45 rtp://host:port?iface=eth0 receives a RTP multicast stream from eth0
46
47 dvb:/ shows a Digital Video Broadcast
48 dvb:/7 shows DVB station 7
49
50 v4l:/tuner/frequency receives a stream from a Video4Linux device
51
52
53stream setup
54------------
55
56The stream setup part allows you to pass special options for playback directly
57in the MRL. The various options are separated by a semicolon ';'.
58Possible options are:
59
60 novideo ignore the stream's video data
61 noaudio ignore the stream's audio data
62 nospu ignore the stream's subtitle data
63
64 volume:value set the volume to the given value
65 compression:value set the compression level to the given value
66
67 subtitle:file show subtitles from a separate file
68
69 save:filename save the stream in the designated file
70
71 config_entry:config_value change the config entry to the given value
72
73 demux:demuxer_plugin use the given demuxer "demuxer_plugin"
74 lastdemuxprobe:demuxer_plugin used for debugging
75
76
77examples
78--------
79
80Some examples should show you, how powerful the MRLs are:
81
82 yourmovie.avi#subtitle:yoursubtitles.srt
83
84 plays the specified avi overlayed with the
85 subtitles from the given file
86
87 http://some.server.org/stream.mpg#save:savedstream.mpg
88
89 streams the file over HTTP and saves it
90 to disk while playing it
91
92 dvd:/1.1#novideo
93
94 plays the first part in the first title
95 of the DVD, but audio only
96
97 stdin:/#demux:rawdv
98
99 plays a DV stream from standard input,
100 can be used for live DV streams
101
README.en.20.DVD
1In theory, DVD playback with xine should work out of the box. If it does for
2you, consider yourself lucky and skip over to the next section. There is nothing
3interesting for you in here.
4
5But in a lot of cases, it does not work that easily. This can have various
6reasons. At first, make sure xine can find your DVD drive. There should be a
7symbolic link called /dev/dvd pointing to the device node of your DVD drive.
8When your drive is connected as the first IDE device on the second IDE channel,
9this would usually be /dev/hdc. You need to have read and write access to that
10device. If your xine installation was prepared for you by the distributor of
11your Linux setup, this should all have been taken care of for you, but it is
12never a bad idea to double check.
13If you do not want to have the symbolic link, you can alternatively change the
14config option media.dvd.device accordingly.
15
16The next set of problems you should be aware of comes with the various
17restrictions the DVD officials try to enforce on us.
18
19
20CSS
21---
22
23Almost all commercial DVDs are encrypted with a system called CSS, Content
24Scrambling System. This is a quite weak cryptographic mechanism that was meant
25as a way of copy control. Since circumventing copy protection mechanisms is
26illegal in some countries, xine does not come with any means to break CSS.
27Because of that, you will be unable to play commercial DVDs with an out-of-the-
28box version of xine. You should inform yourself about the legal situation of
29copy protection and bypassing it in the country you live in. If it is allowed
30to you, install libdvdcss and xine will play those DVDs.
31
32
33The region code
34---------------
35
36From a DVDs point of view, the world is divided into eight regions. The idea is
37that drives bought in one region shall only play discs made for that region.
38To ensure that, every DVD carries information, in which regions it wants to be
39played.
40
41Older drives are so called RPC-I drives and do not check this region code at
42all. If you have such a drive, treat it well and be happy. xine will be able to
43play any disc on this planet for you without any trouble.
44
45Newer drives fall in the RPC-II category. They have an internal region setting,
46which is checked against the region code of the DVD you insert. If they match,
47everything will work just fine. If they don't it is up to the drive's firmware,
48what exactly will happen. Some nicer drives just don't allow you to read the
49parts of the disc where the cryptographic keys for CSS are stored. Most likely,
50you will still be able to play the disc in that case. But there are more
51restrictive drives, which deny any access to the disc. In that case you will be
52out of luck.
53
54With RPC-II drives, it therefore seems to be a good idea to have the drives
55internal region setting match that of the DVDs you intend to buy. There is a
56Linux command line tool to modify this setting in the drive and the drive even
57allows you to change this setting for a limited amount of times, usually five.
58
59But if you just bought a fresh RPC-II drive, do not be too hasty setting the
60region. The factory default might be worth a look. Some drives already come
61preset to a specific region. Bad luck, go ahead and set the right code, if the
62preset does not fit your needs. But some drives come with a default setting of
63region 0. This region does not exist on the globe, it generally means "region
64code free". And with some drives you are really lucky, because with the
65factory setting of 0, they will behave like RPC-I drives. You should do
66everything to keep it that way. Be extremely careful, when using commercial
67operating systems on the same machine. Some change the region code without
68asking you. But unfortunately, other drives will simply not play any DVD when
69set to region 0. This leaves you with no choice but to set the region code to
70a setting you see fit.
71
72
73Authentication
74--------------
75
76Most DVD drives need a step called "authentication" before they grant you access
77to a DVD. This is a process, where the software tells the drive what it wants
78and the drive decides whether to allow that or not. Unfortunately, this special
79negotiation can in rare cases confuse the Linux kernel. Some drives cannot be
80authenticated, when they are running in ide-scsi emulation. Others work only in
81this mode, while a third group has no problems with either. It seems that USB
82drives currently are not supported at all.
83
84
85If you still have questions to these points or experience any problems not
86mentioned here, have a look at the xine FAQ. If that still does not help you,
87post your question on the xine-user mailinglist.
88
README.en.25.VideoCD
1VCD stands for "Video Compact Disc" and basically it is a CD that contains
2moving pictures and sound. xine can handle these and the higher quality
3SVCDs, XVCDs and XSVCDs. Playback is possible both from a physical disk or
4from an image on your harddisk.
5
6Some terminology needs to be clarified first:
7
8"Tracks" correspond to contiguous non-overlapping regions of the CD disk, and
9the sum of the tracks forms the entire CD. The CD specifications standarads say
10that between tracks there is to be a 150-sector gap.
11
12We generally don't use the first track which we would call call "Track 0", but
13other tools like VCDimager, cdinfo, and the CD-reading world in the general call
14this "Track 1". This first track usually contains an ISO 9660-format filesystem
15with metadata describing what's on the CD. It may also contain "segments" or
16small MPEGs that generally make up still frames and menus. Aside from the
17segments which are merely only parts of track 0, it doesn't make sense to try to
18"play" track 0 (or track 1 depending on how you want to count).
19It seems natural to call the first thing you would want to play "track
201" (which in fact is track 2 to everyone else).
21
22There are two other units that this plugin uses. One we call an "entry". This is
23a starting point of a track which can include the beginning of the track, and
24when an entry points to the beginning of a track, it is equivalent to listing
25the track. However Video CD's often have multiple entry points into a track.
26Logically this corresponds to a "Chapter" or "Scene" of a larger uninterruptable
27unit. One might think a CD "track" could serve this purpose with a collection of
28tracks making up a work or movie. Alas, there is "track pregap" space between
29tracks which appear as a time gaps when hardware players go between tracks -
30something that doesn't have to happen switching between entries because there in
31fact is no gap.
32
33Another unit we use is a called a "segment." These are used in menus and still
34frames. A menu doesn't have to have a still-frame associated with it; A menu
35might be implimented as a short looped movie clip. However Video CD
36specifications allow still frames to have higher resolution than motion clips.
37And several segments can reside in track 0.
38
39A "playback list item" (also called a "list id or LID) combines "entries" and
40"segments" and "tracks" together with some navigation logic. "Playback Control"
41is simply starting playback at a particular playback list item, and unless
42otherwise specified you'd start with the first playback item which we call P1.
43
44When playing a VideoCD, xine understands numeric input and this can be used to
45select entries, tracks, segments or play list selections. You can change to such
46a logical item by typing the number you want and hitting the numeric pad "Enter"
47key. (This is with the default keymapping.)
48
49To go to the next or previous item, the keypad PgUp (keypad 9) and PgDn
50(keypad 3) keys can be used. You can prefix these by a number and it will have
51the same effect as hitting the function that many times. For example, entering
52"2 PgDn" (that's the keyboard 2 key followed by the keypad PgDn key) will go
53forward 2 items.
54
55Two keys that Video CD players use for navigation and selection that don't
56appear in xine are "return" and "default selection". Since the keys Menu1 and
57Menu2 don't mean any thing in a Video CD player, Menu1 is bound to mean "return"
58and "Menu2" to mean "default selection".
59
60Menu3 with a numeric entry can be used for setting a debug value.
61
README.en.30.Advanced
1The more advanced uses of xine will be discussed in separate documents to which
2we will point you from here:
3
4For using xine from command line or controlling it over a network, read the
5manpages of xine and xine-remote.
6
7For watching DVB (Digital Video Broadcast) television with xine, follow the
8instructions written in README.dvb in the documentation directory of xine-lib.
9
10To use your DXR3 or Hollywood+ MPEG decoder card with xine, consult the file
11README.dxr3 in the documentation directory of xine-lib.
12
13To play audio CDs or DVDs over a network, see the file README.network_dvd in the
14documentation directory of xine-lib.
15
README.en.32.Window_managers
1xine-ui's windows in general are designed to have no decoration (border and
2title) attached by the window manager, and some are intended to be placed at
3a position given by xine-ui instead of being placed automatically.
4
5For that to work, window managers must accept the MWM (motif window manager)
6decoration hint as well as program supplied window positions, either globally
7or at least for the xine-ui windows.
8
9Some window managers may need appropriate entries in their configuration file
10as noted below:
11
12
13fvwm2:
14
15 Put following lines into your .fvwm2rc configuration file:
16
17 Style "xine" MwmDecor,UsePPosition
18 Style "Xitk" MwmDecor,UsePPosition
19
20 ("xine" and "Xitk" are the class names of the several xine-ui windows).
21 These commands are only necessary if they are not covered or inverted by other
22 'Style "*" ...' commands. However, it's no mistake to include them anyway.
23
README.en.35.Legal_issues
1xine is free software. "free software" is somewhat related to being
2"open-source". However, the meaning of "free software" goes further than just
3that: it is about the freedom of users of software. If you have the time, please
4read what the free software foundation says about the topics of freedom and
5software at http://www.gnu.org/philosophy/free-sw.html.
6
7There is a very special threat to freedom when it comes to DVDs: the movie
8industry is making huge efforts to restrict playback of DVDs to controlled
9devices. Most DVDs that are currently sold are encrypted in a proprietary way -
10and in some countries (most notably the USA, but most EU countries will most
11likely enter the circle as well), it is possibly illegal to decrypt them -
12even for private viewing. Hopefully most people will agree that this is a very
13questionable way to treat customers. The xine project team condemns these
14efforts of the movie industry - trying to prevent loss of sales in such a way
15surely shows a lot of disrespect towards all their honest customers. On the
16other hand, the xine project team is against breaking existing law. No one knows
17exactly if it is actually illegal anywhere in the world to write, own and use
18software for viewing encrypted DVDs. But as this is an unclear topic (that seems
19potentially very dangerous), xine does not contain any specific code for
20decrypting DVDs. It seems, however, that third parties are working on such
21extensions. Possibly in some places it is legal to use these. Whichever way -
22you will not be able to play encrypted DVDs with xine out-of-the-box.
23
24Please note that this is not a bug or 'missing feature', but a genuine legal
25problem. It would be great to solve the problem (i.e. convincing America and/or
26the movie industry that they are really annoying and unnecessarily unfair to
27customers as well as users and developers of free software), but including code
28to decrypt DVDs in xine won't solve this problem. We therefore invite all xine
29users to fight decisions of their governments regarding the criminalization of
30DVD playback and fair use of information in general with all available means
31your legal system provides you with.
32
README.en.5.xine-ui
1What you see as "xine" really consists of two major parts:
2* xine-lib or libxine is the so called engine, it contains all of xine's core
3 functionality like retrieving media from the various input sources supported,
4 video and audio decoding, synchronized playback and post processing.
5 This part of xine is only a mere accumulation of functionality, programmers
6 call this a library. End users cannot use this directly, since there is no
7 interface to interact with xine-lib.
8* The second part is the so called frontend. This wraps a user interface around
9 xine-lib, making it usable for everyone.
10
11The benefit of this division is that you can choose between a variety of
12different frontends. The one you are using now is known as "xine-ui". Some
13interesting features of xine-ui are briefly noted below:
14
15
16The menu
17--------
18
19All key functions of xine can be accessed through the main xine-ui menu which
20you get by right-clicking in either the video window or the panel.
21Most of the entries should be self explaining.
22
23
24MRL browser
25-----------
26
27xine's way of describing the media to play are MRLs. You can read more about
28this interesting concept in the MRLs section. Due to their power, an ordinary
29file selection dialog is not enough to tell xine, what stream to play. The
30MRL browser therefore not only allows you to browse through your files, it also
31lets you select other types of media input, which offer their own choice of
32possible streams to play. You can open the MRL browser with the related icon in
33your favourite skin or by selecting Open->Location from the menu.
34
35An ordinary file dialog is available as well, you can get it at Open->File in
36the menu.
37
38
39Playlists
40---------
41
42xine-ui also handles playlists, of course. The playlist editor, located at
43Playlist->Editor or represented by a button in your current skin, allows you to
44load, save and edit playlists. The mediamark editor allows you to edit the
45current playlist entry in detail and attach further playback options, like a
46separate subtitle file. By default, the mediamark editor can be opened by
47pressing Ctrl-e.
48
49
50Autoscan buttons
51----------------
52
53You find the autoscan buttons within the xine panel or in the playlist editor.
54They are a shortcut to create a playlist for a certain, well-known media source
55and, with the default settings, also starts to play it. For example, pressing
56the autoscan button labeled "DVD" will do, what the name suggests: It starts
57playing the DVD in your drive by creating a playlist best suited for this job.
58
59
60Post effects
61------------
62
63xine also offers a growing set of post processing effects you can apply to your
64video. From the menu, open Video->Postprocess->Chain reaction to open the Chain
65reaction window, where you can create a stack of post effects to be applied to
66the video. Choose from the drop down box to select a post filter and select and
67modify the available options to tweak it to your liking. Click on "New filter"
68to add another effect to the chain.
69
70
71Media menu navigation
72---------------------
73
74Some types of media are interactive, the most common example today being DVDs,
75where you can choose all sorts of options from sometimes quite elaborate menus.
76xine offers multiple means to navigate within such interactive content.
77* First, you can directly click with your mouse on items in the video window.
78* Second, you can use the so called event sender panel, which you can open from
79 the menu under Menus->Naviagation.
80* Third, you can use the menu entries under Menus to jump directly to various
81 submenus of your interactive medium. This will only have an effect, if the
82 source you play offers the designated menu.
83* And last but not least, you can use the keyboard. By default, the arrow keys
84 on the numeric keypad will let you move the menu highlight and Enter will
85 select the highlighted button.
86 Some other interesting features are also available via the numeric keypad:
87 (The keys listed are those of the default key mapping.)
88 PgUp and PgDown will let you jump back and forth between chapters.
89 Home and End will select the angle to play in multiangle features.
90
README_cs
1 +++++++++++++++++++++++++ +++++++++++++++++++++++++
2 XINE: Volný přehrávač videa
3 +++++++++++++++++++++++++ +++++++++++++++++++++++++
4
5
6 OBSAH
7 -===-
8
9 1 DOKUMENTACE
10 1.1 Účel tohoto dokumentu
11
12 2 O XINE
13 2.1 Podporované platformy a požadavky
14 2.2 Použitý software
15 2.3 Vývojáři xine
16 2.4 Použití
17 2.4.1 Klávesové zkratky
18 2.4.2 Výběr zvukových kanálů
19 2.4.3 Výběr titulků
20 2.4.4 LIRC
21 2.4.5 Nastavení konfiguračních voleb xine na příkazové řádce
22
23 3 CO JEŠTĚ NEBYLO ŘEČENO
24 3.1 Svoboda a DVD...
25
26 4 Kontakt na projekt xine
27
28 5 Český překlad xine
29
30
311 DOKUMENTACE
32
331.1 Účel tohoto dokumentu
34
35 Toto je dokumentace xine-lib a xine-ui pro koncové uživatele. Více
36 informací naleznete v adresáři doc/ u obou programů.
37
38 Také se prosím na závěr podívejte na FAQ obsažený v balíčku xine-ui,
39 který již může obsahovat odpovědi na vaše dotazy.
40
412 O XINE
42
43 xine je svobodný videopřehrávač pod GPL licencí pro unixovské systémy.
44 Podporuje data ve formátu mpeg-2 a mpeg-1 (společně zvuk + video),
45 jednoduchá data mpeg (samotný zvuk/video, např. soubory mp3), soubory
46 AVI s nejrůznějšími formáty videa (některé z nich za použití win32
47 knihoven) a data Vorbis a OGG. Je zde i jistá podpora pro sekvence
48 quicktime (ale většina video a zvukových kodeků quicktime je
49 patentována, tudíž nepodporována).
50
51 xine přehrává obrazová a zvuková data a při přehrávání je synchronizuje.
52 V závislosti na vlastnostech formátu dat potřebuje přehrávání více či
53 méně výkonu procesoru, plná kvalita bez ztráty snímků byla pro mpeg-2
54 dosažena na systému s procesorem P II 400 MHz.
55
56 xine může přehrávat video přímo z CD, SVCD nebo DVD. Naneštěstí legální
57 status přehrávání zašifrovaných/zablokovaných DVD je v některých zemích
58 nejasný, a tak xine neobsahuje žádný kód na odblokování/dešifrování DVD.
59 K přehrávání takových DVD budete potřebovat další programy nebo něco
60 jako xine_dvd_plugin, který může zajistit autentifikaci/dekódování DVD.
61
62 Tým projektu xine odmítá jakoukoliv zodpovědnost za takovéto uživatele
63 xine.
64
65 Architektura xine, jaká je od verze 0.5, dovoluje přizpůsobitelné
66 moduly, a tak mohou být v budoucnu podporovány různé další typy formátů
67 a výstupních zařízení.
68
692.1 Podporované platformy a požadavky
70
71 - xine vyžaduje na výstup videa server X11
72 (8, 15, 16, 24 nebo 32 bitů barevné hloubky)
73
74 - xine může detekovat a používat pro lepší výkon přehrávání rozšíření
75 MIT X video nebo X shared memory
76
77 - jestliže nemůžete přimět běžet Xv na vaší platformě, měli byste kvůli
78 rychlosti používat barevnou hloubku 16 bitů/bod.
79 Xv, zdá se, pracuje výborně se všemi barevnými hloubkami.
80
81 - jestliže máte grafický adaptér Matrox G200/G400/G450, můžete případně
82 použít výstupní video ovladač syncfb/teletux. Více detailů viz.
83 README.syncfb.
84
85 - je podporováno přehrávání zvuku pomocí OSS, ALSA, ESD a ARTSD.
86 - aaxine používá na výstup knihovnu aalib a může běžet téměř na všech
87 terminálech
88 - k bezproblémovému zkompilování xine jsou vyžadovány novější verze GNU
89 make, gcc a binutils
90
91 xine by měl běžet na všech novějších počítačích kompatibilních s i386
92 (pentium a vyšší) používajících GNU/Linux nebo FreeBSD. V závislosti na
93 typu formátu videa, které chcete přehrávat, budete pro plynulé
94 přehrávání potřebovat více či méně výkonu procesoru. DVD se budou dobře
95 přehrávat zpravidla už na systému s Pentiem II 400 MHz (nebo
96 srovnatelným). V tomto odhadu je mnoho faktorů, takže vaše požadavky by
97 se mohly lišit.
98
99 K úspěšně testovaným grafickým kartám (používajících Xv) pro PC patří:
100 nVidia Riva TNT (closed-source ovladače od nvidie), nVidia Riva TNT 2,
101 Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo3 2000 PCI 16Mb
102
103 U následujících karet bylo hlášeno že fungují, ale není jasné zda
104 fungují s Xv nebo jen s XShm (prosím oznamujte na mailing list
105 xine-user):
106
107 Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.
108
109 xine by měl být schopen zobrazit video na všech typech pracujících
110 X serverů s jakýmikoliv grafickými kartami, ale s mnohem horším výkonem
111 než s Xv.
112
113 Dále xine běží na počítačích i386-solaris a sparc s linuxem nebo
114 solarisem (o framebufferu Creator-3D je známo, že funguje), více
115 informací viz. README.solaris. Také jsou podporovány: systémy založené
116 na powerpc (s běžícím linuxem) a IRIX na MIPS.
117
118 V neposlední řadě bylo oznámeno, že xine funguje na počítačích Alpha,
119 IA-64 a S/390.
120
1212.2 Použitý software
122
123 xine používá kód z následujících projektů volného softwaru:
124
125 - liba52 od Aarona Holtzmana a Michela Lespinasse
126 - libmpeg2 od Aarona Holtzmana a Michela Lespinasse
127 - libmad od Roberta Leslieho
128 - libffmpeg od Fabrice Bellarda
129
130 Bez těchto znamenitých kousků softwaru by samozřejmě xine nebyl tam, kde
131 je teď.
132
133 Také velký dík projektu Linux Video a DVD "LiVid", odkud pochází původní
134 myšlenky pro videopřehrávač xine.
135
136 => http://www.linuxvideo.org/
137
1382.3 Vývojáři xine
139
140 hlavní programování xine
141
142 Guenter Bartsch <guenter@users.sourceforge.net>
143
144 nejrůznější návrhy, opravy chyb a kompilace, modul alsa, grafické
145 rozhraní
146
147 Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
148
149 mnoho oprav chyb a uvíznutí, detekce rychlosti toku dat, softwarová
150 korekce prokládání, mohutné aktualizace libwin32
151
152 Miguel Freitas <miguel@cetuc.puc-rio.br>
153
154 modul pro videovýstup teletux/syncfb, různé opravy chyb/revize, alsa
155
156 Joachim Koenig <Joachim.Koenig@gmx.net>
157
158 vývoj liba52/libmpeg2
159
160 Michel Lespinasse <walken@zoy.org>
161
162 balíček pro Debian, uživatelská podpora
163
164 Siegfried Langauf <siggi@users.sourceforge.net>
165
166 Plus mnoho dalších přispěvovatelů, viz. soubor xine-lib/AUTHORS
167
1682.4 Použití
169
170 xine můžete spustit bez jakýchkoliv parametrů na příkazové řádce nebo
171 můžete přímo specifikovat jeden nebo více vstupních dat. xine zkusí
172 detekovat, jestli lze použít rozšíření Xv a při neúspěchu se vrátí
173 k XShm. Tato detekce by ale mohla selhat. Můžete tedy specifikovat
174 výstupní ovladač videa použitím volby "-V", např.
175
176 xine -V XShm
177
178 přiměje xine použít XShm nebo prosté X11.
179
180 Jestliže chcete posílat zvuk přes síť pomocí ESD, nastavte proměnnou
181 prostředí ESPEAKER před spuštěním xine.
182
183 Jako vstupní data můžete specifikovat jméno souboru nebo něco, co
184 nazýváme "MediaResourceLocator" (MRL), který vypadá podobně jako URL.
185 Napřed uvedete zdroj vstupu, za kterým následuje "://", a pak
186 identifikátor specifický pro zadaný zdroj dat. Jaké zdroje dat můžete
187 použít závisí na vstupních modulech, které máte (pro obyčejné soubory
188 můžete vynechat identifikátor zdroje vstupu "file://").
189
190 Zkuste:
191
192 xine --help
193
194 získáte ucelenější informace o použití.
195
196 xine podporuje protokol xdnd (verze 3), a proto, jestli máte aplikaci
197 pro práci se soubory podporující tento protokol (např. gmc), můžete
198 soubory s videem, které chcete přehrávat, přesunout myší na xine.
199
200 Přehrání třetí stopy z VCD:
201
202 xine vcd://3
203
204 Příklad přímého přístupu na DVD:
205
206 xine dvd://VTS_01_1.VOB
207
2082.4.1 Klávesové zkratky
209
210 Klávesa Akce
211
212 [RETURN] přehrát
213 [MEZERNÍK] pozastavit
214 [Nahoru]/[Dolů] rychle vpřed / pomalý pohyb
215
216 0-9 zadání odpovídajícího čísla
217 / posuv na zadaný počet procent
218 [Vlevo]/[Vpravo] skočit o -+ 15 sekund (+CTRL: 60 sekund)
219 [PgUp]/[Prior] skočit na předcházející položku playlistu
220 [PgDown]/[Next] skočit na další položku playlistu
221
222 f přepnout mezi celoobrazovkovým a okenním režimem
223 a přepnout poměr výška/šířka (AUTO/16:9/4:3/DVB)
224 i přepnout režim prokládání
225
226 z / Shift-Z zvětšit / zmenšit video
227 přidejte Ctrl ke změně velikosti horizontálně nebo
228 Meta (Alt) ke změně vertikálně
229
230 "<", ">" upravit velikost výstupního okna
231 + - změnit zvukový kanál
232 , . změnit kanál s titulky
233 n m přizpůsobit synchronizaci zvuku a videa
234 [HOME] reset synchronizace zvuku a videa
235
236 [INSERT] zobrazit kurzor myši ve výstupním okně videa
237
238 q ukončit
239
240 h skrýt okno s videem (užitečné pro přehrávání mp3)
241
242
243 Další přijdou. :-)
244
245 Levé tlačítko myši (nebo stisk 'g') v okně videa zapíná nebo vypíná
246 ovládací panel.
247
248 Změna klávesových zkratek:
249 Všechny z těchto klávesových zkratek můžete měnit. Za tímto účelem
250 byste měli mít mapu klávesnice ve vašem adresáři $HOME/.xine.
251 Syntaxe každé položky je:
252
253 WindowReduce {
254 key = less
255 modifier = none
256 }
257
258 Jméno klávesy by mělo souhlasit s klávesovými řetězci X11 (viz.
259 níže). Modifikátor by měl být:
260 - 'none' pro žádný modifikátor,
261 - 'control' (nebo 'ctrl') pro klávesu Ctrl,
262 - 'meta' (nebo 'alt' na PC) pro klávesu Meta (Alt),
263 - 'mod3', 'mod4' nebo 'mod5' k dispozici jen na některých
264 platformách
265
266 Modifikátory se mohou kombinovat, oddělují se čárkami:
267
268 WindowReduce {
269 key = less
270 modifier = control, alt
271 }
272
273 Jestliže nespecifikujete řádku s modifikátorem, je to stejné jako
274 specifikování 'none'.
275
276 Můžete také přidat zástupce klávesových zkratek, jako např.:
277
278 Alias {
279 entry = Pause
280 key = p
281 }
282
283 znamená, že přidáváte další klávesu do položky 'Pause' - stisk 'p'.
284 Můžete také přidat řádku s modifikátorem (viz. nahoře). Jestliže ho
285 nespecifikujete, modifikátor bude stejný jako v původní sekci
286 (v tomto případě 'Pause').
287
288 Zjištění názvů kláves v X11:
289 Ke zjištění názvu klávesy v X11 lze použít program 'xev', který je
290 dodáván s vaším programovým balíkem X11. Spusťte 'xev' z xtermu,
291 přepněte se do zobrazeného malého okna a stiskněte klávesu, kterou
292 chcete specifikovat.
293
294 Uvidíte něco jako:
295
296 ...
297 KeyRelease event, serial 27, synthetic NO, window 0x3200001,
298 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
299 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
300 ^^^^^^^^
301 Toto je, co hledáte.
302
303 U tlačítek myši, použití např. kolečka vaší myši, musíte
304 sledovat, které tlačítko je přiřazeno dané činnosti, použití xev:
305
306 ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
307 root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
308 state 0x1000, button 5, same_screen YES
309 ^^^^^^^^
310 Toto je to tlačítko
311
312 V tomto případě musíte nastavit "key = XButton_5". Modifikátor kláves
313 je s tlačítky myši také podporován.
314
315 Zobrazení aktuálních/změněných klávesových zkratek:
316 K zobrazení předvolených klávesových zkratek lze použít
317 'xine --keymap' nebo 'xine --keymap=default'. Výsledek můžete
318 přesměrovat do souboru, který pak sám může být ~/.xine/keymap.
319
320 Abyste zobrazili výsledek přemapování klávesnice, prostě použijte
321 'xine --keymap=remapped'.
322
3232.4.2 Výběr zvukových kanálů
324
325 Abyste vybrali požadovaný zvukový kanál, přidejte volbu -a:
326
327 xine -a 3 test.mpg
328
329 Přehraje třetí zvukový kanál, který je k dispozici (s videem,
330 samozřejmě).
331
332 Eventuálně může být k výběru zvukového kanálu použito grafické
333 uživatelské rozhraní.
334
3352.4.3 Výběr titulků
336
337 Titulky jsou vloženy v jiných stopách než je zvuk. Předvolené jazykové
338 titulky jsou obvykle na stopě 0. K výběru požadované stopy s titulky
339 použijte volbu -u:
340
341 xine -u 0 test.vob
342
343 Zobrazí se titulky z kanálu 0.
344
345 Eventuálně může být k výběru kanálu s titulky použito grafické
346 uživatelské rozhraní.
347
348 Titulky v odděleném textovém souboru lze také použít. Volba pro soubor
349 s titulky se uvede za znakem '#':
350
351 xine test.avi#subtitle:test.sub
352
353 Pro správné zobrazení českých znaků zkontrolujte nastavené kódování
354 souboru s titulky, přednastaveno je windows-1250.
355 Ve verzi xine-lib <= beta12 bylo třeba změnit i font titulků ze
356 "sans" na "sanshu". Nyní už přednastavený font "sans" obsahuje všechny
357 české znaky s diakritikou.
358
359 Úpravy lze provést buď v konfiguračním dialogu nebo editací
360 konfiguračního souboru ~/.xine/config2. Ten by měl obsahovat tyto údaje:
361
362 # string, default: sans
363 codec.spu_font:sans
364
365 # string, default: windows-1250
366 codec.spu_src_encoding:windows-1250
367
3682.4.4 LIRC
369
370 xine může být dálkově ovládán pomocí IR. Za tímto účelem byste
371 měli mít nainstalovaný LIRC (http://www.lirc.org).
372
373 Do vašeho souboru ~/.lircrc byste měli přidat některé položky, jako
374 např.:
375
376 begin
377 remote = SAMSUNG
378 button = Button_Play
379 prog = xine
380 repeat = 0
381 config = Play
382 end
383 begin
384 remote = SAMSUNG
385 button = Button_1
386 prog = xine
387 repeat = 0
388 config = SetPosition10%
389 end
390
391 xine sám může vytvořit návrh lirc položek použitím
392 'xine --keymap=lirc', výstup můžete přesměrovat do souboru a doladit
393 nastavení.
394
395 Každá položka bude vypadat nějak takto:
396
397 # Reduce the output window size.
398 begin
399 remote = xxxxx
400 button = xxxxx
401 prog = xine
402 repeat = 0
403 config = WindowReduce
404 end
405
406 Je na vás specifikovat jméno v remote a přiřadit tlačítko.
407
408 Playlist:
409 ---------
410 K získání playlistu z daného vstupního modulu můžete použít speciální
411 klíčové slovo 'PlaylistFrom:' následované jménem modulu (stejné jako
412 na tlačítku na okně panelu):
413
414 # Retrieve playlist from NAV plugin.
415 begin
416 remote = xxxxx
417 button = xxxxx
418 prog = xine
419 repeat = 0
420 config = PlaylistFrom:NAV
421 end
422
4232.4.5 Nastavení konfiguračních voleb xine na příkazové řádce
424
425 Jakoukoliv volbu můžete nastavit z příkazové řádky (viz.
426 README.config_en) a potlačit tak nastavené hodnoty
427 v $HOME/.xine/config.
428
429 Ke změně zařízení VCD mezi přehráním dvěma MRL můžete například
430 udělat:
431
432 xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1
433
434 Tato nastavení nebudou uložena v konfiguračním souboru, jsou pouze
435 dočasná.
436
4373 CO JEŠTĚ NEBYLO ŘEČENO
438
4393.1 Svoboda a DVD...
440
441 xine je svobodný software. "svobodný software" je cosi příbuzné
442 "open-source". Avšak význam svobodného softwaru jde dál než jen otevřené
443 zdrojové kódy: je to o svobodě uživatelů softwaru. Jestliže máte čas,
444 prosím přečtěte si, co říká free software foundation na téma svoboda a
445 software:
446
447 => http://www.gnu.org/philosophy/free-sw.html
448
449 Je zde velmi zvláštní stať o svobodě a DVD:
450 filmový průmysl vytváří obrovské úsilí na omezení přehrávání DVD do
451 kontrolovaných zařízení. Nejvíce DVD, které se v současné době
452 prodávají, jsou zašifrována - a v některých zemích (zvláště v USA), je
453 zřejmě nelegální je dešifrovat - dokonce i pro soukromé přehrávání.
454
455 Snad bude nejvíce lidí souhlasit, že toto je velmi pochybný způsob
456 zacházení se zákazníky. Tým projektu xine odsuzuje tato úsilí filmového
457 průmyslu - zkouší předejít ztrátě odbytu takovým způsobem, že je
458 rozhodně vidět mnoho neúcty ke všem jejich čestným zákazníkům.
459 Na druhou stranu, tým projektu xine je proti porušování existujících
460 zákonů. Nikdo přesně neví jestli je někde ve světě skutečně nelegální
461 psát, vlastnit a používat software na sledování zašifrovaných DVD. Ale
462 protože je toto nejasné téma (a zdá se potenciálně velmi nebezpečné),
463 xine neobsahuje žádný specifický kód na dešifrování DVD. Zdá se ale, že
464 další programátoři pracují na takovýchto rozšířeních. Možná je na
465 některých místech jejich používání legální. Ať tak nebo tak - nebudete
466 moci přehrávat zašifrovaná DVD se samotným xine tak, jak je. Prosím
467 všimněte si, že toto není chyba nebo chybějící funkce, ale skutečný
468 legální problém. Bylo by ohromné vyřešit tento problém (např.
469 přesvědčováním ameriky a/nebo filmového průmyslu, že jsou skutečně
470 nepříjemní a zbytečně nepoctiví k zákazníkům stejně jako k uživatelům
471 a vývojářům volného softwaru), ale zahrnutí kódu na dešifrování DVD ve
472 xine tento problém nevyřeší.
473
4744 Kontakt na projekt xine
475
476 webová stránka projektu xine je
477
478 => http://xine.sourceforge.net
479
480 reakce nebo nabídky pomoci jsou velmi ceněny, prosím kontaktujte:
481
482 mailový diskusní list uživatelů xine <xine-user@lists.sourceforge.net>
483
4845 Český překlad
485
486František Dvořák <valtri@atlas.cz>.
487
README_de
1
2
3 xine
4
5
6 Ein freier Video-Player
7
8
9______________________________________________________________2003/04/10 (1.9)
10INHALT
11
121 DOKUMENTATION
131.1 Ziel dieses Dokuments
14
152 WAS IST XINE?
162.1 Unterstützte Systeme und Voraussetzungen
172.2 Von xine verwendete Software
182.3 Entwickler
192.4 Benutzung
202.4.1 Bedienung mit der Tastatur
212.4.2 Audio-Kanäle (Sprachen)
222.4.3 Untertitel
232.4.4 LIRC
242.4.5 xine-Konfiguration über die Kommandozeile setzen
25
263 SONSTIGES
273.1 Was DVDs mit Freiheit zu tun haben
28
294 KONTAKT ZUM XINE PROJEKT TEAM
30
31_____________________________________________________________________________
321 DOKUMENTATION
33
341.1 Ziel dieses Dokuments
35
36 Dieser Text (README_de) ist an die Endbenutzer von xine gerichtet.
37 Weitere Information finden Sie im Verzeichnis doc/ in den xine-lib
38 und xine-ui Paketen.
39
40 Bitte nehmen Sie sich auch Zeit, die FAQs (Frequently Asked
41 Questions = häufig gestellte Fragen) zu lesen. Die Datei FAQ befindet
42 sich im xine-ui-x.x.x Paket.
43
44
45_____________________________________________________________________________
462 WAS IST XINE?
47
48 xine (gesprochen "ksin") ist ein GPL-lizenzierter Video-Player für
49 Unix, Linux und andere Systeme. Es werden u.a. folgende Formate
50 unterstützt:
51
52 - MPEG-1 Audio und Video
53 - MPEG-2 Audio und Video
54 - MP3
55 - AVI (verschiedene Formate, auch DivX)
56 - Ogg Vorbis
57 - QuickTime (eingeschränkt, da diese Formate proprietär sind)
58
59 xine spielt sowohl Audio- und Videodaten eines Streams. Die dazu
60 benötigte Hardware-Leistung ist abhängig vom Format des Streams.
61 Die untere Grenze für MPEG-2 bei voller Bildrate ist ein Pentium II
62 mit 400MHz.
63
64 "Von Haus aus" kann xine Video CDs, SVCDs und DVDs abspielen.
65 Leider ist in vielen Ländern das Abspielen verschlüsselter DVDs
66 durch "nichtauthorisierte" Software verboten oder rechtlich unklar.
67 Aus diesem Grund besitzt xine keine Funktion zum Abspielen
68 verschlüsselter DVDs. Um solche DVDs abzuspielen, benötigen Sie
69 zusätzliche Software, wie z.B. "libdvdread" und das "dvdnav"-Plugin.
70
71 Die Entwickler von xine lehnen jede Verantwortung für Folgen einer
72 solchartigen Benutzung von xine ab.
73
74 Durch die Möglichkeit, Plug-Ins zu laden, kann xine weitere Stream-
75 Formate und Ausgabegeräte unterstützen.
76
77
782.1 Unterstützte Systeme und Voraussetzungen
79
80 Software-Voraussetzungen (werden von allen aktuellen Distributionen
81 erfüllt):
82
83 - Linux oder FreeBSD. xine sollte aber auch auf Solaris, IRIX und
84 Apple PPC laufen.
85 - X-Server X11
86 empfehlenswert: MIT-Xv oder MIT-Shm
87 - aktuelle GNU-Versionen von make, gcc und binutils
88 - OSS, ALSA, ESD oder artsd (KDE) für Sound-Wiedergabe
89 - optional: aalib für ASCII-Art Video :-)
90
91 Hardware-Voraussetzungen:
92
93 - von X11 unterstützte Grafikkarte mit 8, 15, 16, 24 oder 32 Bit
94 Farbtiefe. Dringend empfohlen: Xv- oder XShm-Unterstützung.
95 Folgende Karten wurden erfolgreich mit Xv oder XShm getestet:
96 nVidia Riva TNT und Riva TNT2
97 Matrox G400
98 ATI Rage128, M64 und Rage II
99 3dfx Voodoo 3
100 Trident 9660
101 Wenn Ihre Karte Xv nicht unterstützt, sollten Sie 16 Bit Farbtiefe
102 verwenden, da sonst die Performance drastisch sinkt. Xv läuft mit
103 jeder Farbtiefe okay.
104 - mind. Pentium II 400MHz für DVD-Wiedergabe, schnellerer Prozessor
105 dringend empfohlen.
106 - empfohlen: DMA-Unterstützung für Festplatten und DVD-Laufwerke
107
108
1092.2 Von xine verwendete Software
110
111 xine verwendet folgende, unter der GPL veröffentlichte Software:
112
113 - liba52 (von Aaron Holtzman und Michel Lespinasse)
114 - libmpeg2 (von Aaron Holtzman und Michel Lespinasse)
115 - libmad (von Robert Leslie)
116 - libffmpeg (von Fabrice Bellard)
117
118 Ohne diese Programme wäre xine nicht das, was es heute ist!
119
120 Ein grosser Dank gebürt auch dem "Linux Video and DVD Project"
121 (LiViD).
122
123 => http://www.linuxvideo.org
124
125
1262.3 Entwickler
127
128 Hauptentwickler:
129 Günter Bartsch
130
131 viele Ideen und Fehlerbehebung, ALSA Plugin, Bedienoberfläche (GUI):
132 Daniel Caujolle-Bert
133
134 Audio Programmierung
135 Siegfried "Siggi" Langauf
136
137 libmpeg2 und libac3 "Hacks":
138 Michael Lespinasse
139
140 ... u.v.a.m., siehe Datei xine-lib-x.x.x/AUTHORS
141
142
1432.4 Benutzung
144
145 Sie können xine ohne Optionen starten. Geben Sie dazu einfach
146
147 xine
148
149 in einem X-Terminal ein. xine überprüft, ob Ihr System Xv unterstützt
150 und wenn nicht, benutzt es XShm. Sollte diese Überprüfung nicht
151 funktionieren, können Sie mit der "-V" Option das Output-Plugin
152 auswählen, z.B:
153
154 xine -V XShm
155
156 So verwendet xine das XShm Plugin.
157
158
159 Sie können als Option eine Datei oder ein sog. "Media Resource
160 Locator" angeben. Ein Media Resource Locator (MRL) ist dem von
161 Internet her bekannten URL ähnlich. Er hat folgendes Format: Zuerst
162 müssen Sie eine Eingabequelle angeben, gefolgt von "://" und der
163 Angabe, welchen Ausschnitt/Kapitel der Quelle Sie sehen möchten.
164
165 Beispiel: Kapitel 3 einer VCD abspielen
166
167 xine vcd://3
168
169 Beispiel: Direktzugriff auf eine DVD
170
171 xine dvd://VTS_01_1.VOB
172
173
174 Das Standard-Plugin zum Abspielen von DVDs (wie im oberen Beispiel)
175 unterstützt weder Menüs noch verschlüsselte DVDs. Bessere DVD-Plugins
176 sind "xine-dvdnav", "xine-dmd" und "xine-d5d".
177
178 Die möglichen Eingabeformate sind abhängig von den Input-Plugins.
179
180 Geben Sie folgendes ein, um einen Überblick über die Benutzung von
181 xine zu erhalten:
182
183 xine --help
184
185
186 xine unterstützt "Drag'n'Drop" (xdnd Protokoll Version 3). Sie
187 können Dateien mit der Maus auf xine ziehen, um diese abzuspielen.
188
189 Wenn Sie den Sound per ESD über ein Netzwerk senden wollen, müssen
190 Sie die Umgebungsvariable ESPEAKER setzen, bevor Sie xine starten.
191
192
1932.4.1 Bedienung mit der Tastatur
194
195 Taste Funktion
196
197 ENTER abspielen
198 LEERTASTE Pause
199 AUF / AB schnell vorspulen / Zeitlupe
200
201 0 - 9 zugehörige Ziffer eingeben
202 / Zur vorher angegebenen % Position im Strom gehen
203 LINKS / RECHTS +/- 15 Sekunden (mit STRG: +/- 60 Sekunden)
204
205 BILD-AUF gehe zum vorherigen Eintrag in der Liste
206 BILD-AB gehe zum nächsten Eintrag in der Liste
207
208 f Vollbild an/aus
209 a Seitenverhältnis (AUTO/16:9/4:3/DVB)
210 i Interlace-Modus an/aus
211 z Z hinein-/herauszoomen
212 (+STRG: Zoom horizontal, +ALT: Zoom vertikal)
213 EINFG Mauscursor "gefangenhalten"
214 (nützlich für Virtual Screen)
215 < > Fenstergrösse verändern
216
217 + - (nicht auf dem Ziffernblock)
218 Audiokanal (Sprache) wechseln
219 , . Sprache der Untertitel wechseln
220
221 n m Audio und Video synchronisieren
222 POS1 Audio- und Video-Synchronisation auf
223 Standardwert setzen
224
225 q xine beenden
226 h Video-Fenster deaktivieren
227 (nur Ton-Wiedergabe)
228 g (oder rechte Maustaste)
229 Player-Fenster deaktivieren
230
231
232 Tastenfunktionen ändern:
233
234 Sie können die Tastenzuordnungen ändern, indem Sie die Datei
235 ~/.xine/keymap bearbeiten. Die Syntax lautet wie folgt:
236
237 WindowReduce {
238 key = less
239 modifier = none
240 }
241
242 Vor der Klammer "{" steht die auszuführende Funktion. Nach "key = "
243 kommt die Bezeichnung der Taste. Um die Bezeichnung einer bestimmten
244 Taste zu erfahren, verwenden Sie das Programm "xev". Starten Sie es
245 in einem X-Terminal und drücken Sie die Taste. Im Terminalfenster
246 erscheint ungefähr folgendes:
247
248 KeyPress event, serial 27, synthetic NO, window 0x1a00001,
249 root 0x53, subw 0x0, time 3574935687, (-204,707), root:(544,731),
250 state 0x10, keycode 99 (keysym 0xff55, Prior), same_screen YES,
251 ^^^^^
252 Bezeichnung der Taste
253
254 Das selbe gilt auch für Maustasten/-Räder. Rufen Sie ebenfalls "xev"
255 auf und betätigen Sie die Tasten bzw. das Mausrad:
256
257 ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
258 root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
259 state 0x1000, button 5, same_screen YES
260 ^^^^^^^^
261 Bezeichnung der Taste
262
263 In diesem Fall müsstem Sie "key = XButton_5" setzen. "Modifier"-Tasen
264 werden ebenfalls bei der Verwendung der Maus unterstützt.
265
266 Die "modifier"-Taste (Zusatztaste) kann eine der folgenden sein:
267
268 "none" keine Zusatztaste
269 "control" oder "ctrl" Strg-Taste
270 "meta" oder "alt" Alt-Taste
271 "mod3", "mod4" oder "mod5" Spezialtasten auf einigen Systemen
272
273 Es können mehrere Zusatztasten angegeben werden (durch Kommas
274 getrennt). Wenn Sie die Zeile "modifier" weglassen, wird keine
275 Zusatztaste verwendet.
276
277 Um ein sog. "Alias" (zweite Taste für dieselbe Funktion) festzulegen,
278 geben Sie folgendes ein:
279
280 Alias {
281 entry = Pause
282 key = p
283 modifier = meta
284 }
285
286
287 Die aktuellen Tastenzuordnungen anzeigen:
288
289 xine --keymap (Standard-Zuordnung)
290
291 oder
292
293 xine --keymap=default (Standard-Zuordnung)
294
295 oder
296
297 xine --keymap=remapped (von Ihnen definierte Zuordnung)
298
299 Sie können die Ausgabe in die Datei ~/.xine/keymap umlenken und diese
300 Datei dann bearbeiten.
301
302
3032.4.2 Audio-Kanäle (Sprachen)
304
305 Mit der "-a" Option können Sie einen Audio-Kanal wählen. Vor allem
306 bei DVDs werden die Kanäle für die verschiedenen Sprachen benutzt.
307
308 xine -a 3 test.mpg
309
310 spielt das Video test.mpg und dessen dritte Tonspur.
311
312 Der Audio-Kanal kann auch mit der Bedienoberfläche ausgewählt werden.
313
314
3152.4.3 Untertitel
316
317 Die verschiedenen Untertitel (-sprachen) können Sie mit der Option
318 "-u" auswählen.
319
320 xine -u 0 test.vob
321
322 Zeigt die Standard-Untertitel (Nr. 0) an. Auch die Untertitel können
323 mit der Bedienoberfläche gewählt werden.
324
325
3262.4.4 LIRC
327
328 Sie können xine mit einer herkömmlichen Fernbedienung steuern. Dazu
329 benötigen Sie LIRC
330
331 => http://www.lirc.org
332
333 Sie sollten Folgendes in die Datei ~/.lircrc schreiben (natürlich
334 angepasst an Ihre IR-Hardware):
335
336 begin
337 remote = SAMSUNG
338 button = Button_Play
339 prog = xine
340 repeat = 0
341 config = Play
342 end
343 begin
344 remote = SAMSUNG
345 button = Button_1
346 prog = xine
347 repeat = 0
348 config = SetPosition10%
349 end
350
351 xine kann die nötigen Eintrage erzeugen, wenn Sie es mit der Option
352 "--keymap=lirc" starten und die Ausgabe in eine Datei lenken. Die
353 Datei müssen Sie aber noch nachbearbeiten und die Namen der
354 Fernbedienung und der zuzuweisenden Knöpfe eingeben.
355
356 Titellisten:
357 ------------
358 Um automatisch Titellisten für ein Input-Plugin zu erstellen, können
359 Sie das spezielle Schlüsselwort 'PlaylistFrom:' gefolgt vom Namen des
360 Plugins angeben. (Der Name entspricht der Bezeichnung des Knopfes im
361 Bedienfenster):
362
363 # Titelliste für NAV-Plugin erstellen
364 begin
365 remote = xxx
366 button = xxx
367 prog = xine
368 repeat = 0
369 config = PlaylistFrom:NAV
370 end
371
372
3732.4.5 xine-Konfiguration über die Kommandozeile setzen
374
375 Sie können jede Optionen (siehe README.config_en) von der Kommando-
376 zeile aus benutzen, um die Standardwerte aus der Konfigurationsdatei
377 $HOME/.xine/config zu überschreiben.
378
379 Zum Beispiel können Sie folgendes tun
380
381 xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1
382
383 um zwischen dem Abspielen zweier MRLs das Laufwerk zu wechseln.
384
385 Solche opt:-Optionen werden nicht in der Konfigurationsdatei
386 abgespeichert, sondern gelten nur temporär.
387
388_____________________________________________________________________________
3893 SONSTIGES
390
3913.1 Was DVDs mit Freiheit zu tun haben
392
393 xine ist freie Software. "Freie Software" hat mit "Open Source" zu
394 tun, doch es ist mehr: es bedeutet Freiheit für die Anwender der
395 Software. Wenn Sie etwas Zeit und Englischkenntnisse haben, sollten
396 Sie diesen Text der Free Software Foundation (FSF) über Freiheit und
397 Software lesen:
398
399 => http://www.gnu.org/philosophy/free-sw.html
400
401
402 Dieser Freiheit geht es an den Kragen, wenn Sie DVDs abspielen
403 wollen: Die Filmindustrie scheut keine noch so grossen Bemühungen,
404 das Abspielen von DVDs auf "authorisierte" und kontrollierte Geräte
405 zu beschränken. Die meiste heutzutage verkauften DVDs sind deshalb
406 mit einem proprietären Verfahren verschlüsselt, und es ist vielen
407 Ländern (u.a. in den USA) verboten, sie zu entschlüsseln, auch für
408 den privaten Gebrauch.
409
410 Es werden hoffentlich möglichst viele Leute einsehen, dass dies eine
411 sehr fragwürdige Art ist, Kunden zu "behandeln". Das xine Projekt
412 Team verurteilt diese Praktiken der Filmindustrie. Diese Versuche,
413 Umsatzverluste einzudämmen, sind ein Zeichen mangelnden Respekts
414 gegenüber ehrlichen Kunden. Das xine Projekt Team will aber nicht
415 dazu aufrufen, bestehende Gesetze zu brechen. Es ist nicht genau
416 bekannt, ob das Schreiben, Besitzen, Verteilen und Benutzen von
417 Software zum Abspielen verschlüsselter DVDs verboten ist, in welchem
418 Staat auch immer.
419
420 Da hier also rechtlich alles andere als Klarheit herrscht, verfügt
421 xine nicht über eine Funktion, um verschlüsselte DVDs abzuspielen.
422 Allerdings haben andere Programmierer Erweiterungen für xine
423 entwickelt, um das zu ermöglichen.
424
425 So oder so: xine allein spielt keine verschlüsselten DVDs ab. Es
426 handelt sich hier also nicht um einen "Bug", sondern um ein rein
427 rechtliches Problem.
428
429 Die einzige Lösung für dieses Problem wäre, Staatsbehörden (allen
430 voran die der Vereinigten Staaten) und/oder die Filmindustrie davon
431 zu überzeugen, dass der heutige Weg ein unnötiger und ungerechter
432 ist.
433
434
435_____________________________________________________________________________
4364 KONTAKT ZUM XINE PROJEKT TEAM
437
438 Sie finden die Internetseite des xine Projekts unter folgender
439 Adresse:
440
441 => http://xine.sourceforge.net
442
443 Brauchen Sie Hilfe? Möchten Sie beim xine Projekt mithelfen?
444 Dann abonnieren Sie eine der Mailing-Listen:
445
446 xine-user@lists.sourceforge.net englisch, für Anwender
447 xine-user.de@lists.sourceforge.net deutsch, für Anwender
448 xine-devel@lists.sourceforge.net englisch, für Entwickler
449
450
451 Übersetzung dieses Textes ins Deutsche:
452 Stephan Walter <stephan.walter@gmx.ch>
453
README_en
1 +++++++++++++++++++++++++ +++++++++++++++++++++++++
2 XINE: A Free Video Player
3 +++++++++++++++++++++++++ +++++++++++++++++++++++++
4
5
6 INDEX
7 -===-
8
9 1 THE DOCUMENTATION
10 1.1 Scope of this document
11
12 2 ABOUT XINE
13 2.1 Supported platforms and requirements
14 2.2 Used software
15 2.3 Developers of xine
16 2.4 Usage
17 2.4.1 Keyboard shortcuts
18 2.4.2 Selecting audio channels
19 2.4.3 Selecting subtitles
20 2.4.4 LIRC
21 2.4.5 Setting xine config-options on the commandline
22
23 3 WHAT'S LEFT TO SAY
24 3.1 Freedom, DVDs and stuff...
25
26 4 Contacting the xine project
27
28
29
30
31
32
33
341 THE DOCUMENATION
35
361.1 Scope of this document
37
38 This is the end-user documentation for xine-lib and xine-ui. You'll
39 find more documentation in the doc/ directory of both packages.
40
41 Please also take a closer look at the FAQ included with the xine-ui
42 package which may already have the answers to your questions.
43
44
452 ABOUT XINE
46
47 xine is a free GPL-licensed video player for unix-like systems. It
48 supports mpeg-2 and mpeg-1 system (audio + video multiplexed) streams,
49 mpeg elementary streams (audio/video only, e.g. mp3 files), AVI files
50 with various video formats (some of them by using win32 dlls) and Vorbis
51 OGG streams. There is some support for quicktime streams (but most
52 quicktime video and audio codecs are highly proprietary and thus not
53 supported).
54
55 xine plays the video and audio data of the stream and synchronizes
56 the playback of both. Depending on the properties of the stream,
57 playback will need more or less processor power, full frame rate
58 for mpeg-2 has been seen on a 400 MHz P II system.
59
60 xine can play Video CDs, SVCDs and DVDs directly. Unfortunately the
61 legal status of encrypted/locked DVD playback is uncertain in some
62 countries so xine does not include any DVD unlock/decrypt code. To
63 play back such DVDs you'll need external programs or something like a
64 xine_dvd_plugin that can handle DVD authentification/descrambling.
65
66 The xine project team denies all responsibility for such uses of xine.
67
68 As of xine 0.5 xine's architecture allows for flexible plugins, so
69 various other stream types and output devices might be supported in
70 the future.
71
722.1 Supported platforms and requirements
73
74 - xine needs a X11 server for video output
75 (8, 15, 16, 24 or 32 bit color depth)
76
77 - xine can detect and use the MIT X video and X shared memory extension
78 for better playback performance
79
80 - if you can't get Xv to run on your platform you should use 16bpp
81 colordepth for speed. Xv seems to work nicely for any color-depth.
82
83 - if you have a Matrox G200/G400/G450 graphics adaptor you can optionally
84 use the sybcfb/teletux video ouput driver. See README.syncfb for more
85 details.
86
87 - for audio playback OSS, ALSA, ESD and ARTSD are supported.
88 - aaxine uses aalib for output and can run on nearly any terminal
89 - to build xine fairly recent GNU make, gcc and binutils are required
90
91 xine should run on any more recent i386-compatible machine (pentium
92 and higher) using GNU/linux or FreeBSD. Depending on the type of video
93 stream you want to play you will need more or less cpu-power for fluid
94 playback. As a rule of thumb, DVDs will typically begin to run nicely
95 on a Pentium II 400 system (or equivalent). There are many factors in
96 this equation, so your mileage may vary.
97
98 Successfully tested graphic cards (using Xv) for PCs include:
99 nVidia Riva TNT (closed-sources nvidia drivers), nVidia Riva TNT 2,
100 Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo3 2000 PCI 16Mb
101
102 The following cards have been reported to work, but it's unclear
103 whether they work with Xv or only with XShm (please report on
104 xine-user mailing list):
105
106 Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.
107
108 xine should be able to show video on any type of working xserver with
109 any graphics card, but with much worse performance than with Xv.
110
111 Additionally, xine runs on i386-solaris, sparc machines running linux
112 or solaris (Creator-3D framebuffer is known to work), see README.solaris
113 for more information. Also supported: some powerpc based systems (running
114 linux) and IRIX on MIPS.
115
116 Last but not least, xine has also been reported to work on Alpha, IA-64
117 and S/390 machines.
118
1192.2 Used software
120
121 xine uses code from the following external free software projects:
122
123 - liba52 by Aaron Holtzman and Michel Lespinasse
124 - libmpeg2 by Aaron Holtzman and Michel Lespinasse
125 - libmad by Robert Leslie
126 - libffmpeg by Fabrice Bellard
127
128 Without these great pieces of software xine would of course not be
129 where it is now.
130
131 Also many thanks to the Linux Video and DVD Project "LiViD", where the
132 original ideas for the xine video player came from.
133
134 => http://www.linuxvideo.org/
135
1362.3 Developers of xine
137
138 main xine programming
139
140 Guenter Bartsch <guenter@users.sourceforge.net>
141
142 various suggestions, bug and build fixes, alsa plugin, gui
143
144 Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
145
146 many bug and deadlock fixes, bitrate detection, soft deinterlacer,
147 massive libwin32 updates
148
149 Miguel Freitas <miguel@cetuc.puc-rio.br>
150
151 teletux/syncfb video output module, various bugfixes/reviews, alsa
152
153 Joachim Koenig <Joachim.Koenig@gmx.net>
154
155 liba52/libmpeg2 developement
156
157 Michel Lespinasse <walken@zoy.org>
158
159 Debian package, user support
160
161 Siegfried Langauf <siggi@users.sourceforge.net>
162
163 Plus various other contributors, see the xine-lib/AUTHORS file
164
1652.4 Usage
166
167 You can start xine without any command line parameters or you can
168 specify one or more input streams directly. xine tries to detect
169 whether it can use the Xv extension and will fall back to XShm, but
170 that detection might fail. You can specify the video output plugin by
171 using the "-V" option, e.g.
172
173 xine -V XShm
174
175 will force xine to use XShm or plain X11.
176
177 If you want to send the sound over a network with ESD, set the ESPEAKER
178 environment variable before starting xine.
179
180 The input stream can be a filename or something we call
181 "MediaResourceLocator" (or MRL), which looks similar to a URL. First
182 you specify an input source which is followed by "://" and an
183 input-source specific identifier. What input sources you can use
184 depends on the input plugins you have (for plain files you can omit
185 the input-source identifier).
186
187 Try:
188
189 xine --help
190
191 to get more complete information about usage.
192
193 xine supports the xdnd protocol (Version 3) so if you have a file browser
194 application supporting that protocol (e.g. gmc) you can drop video files
195 on xine for playback.
196
197 Playing track 3 from a VCD:
198
199 xine vcd://3
200
201 Example for direct DVD access:
202
203 xine dvd://VTS_01_1.VOB
204
205
2062.4.1 Keyboard shortcuts
207
208 Key Action
209
210 [RETURN] play
211 [SPACE] pause
212 [Up]/[Down] fast forward / slow motion
213
214 0-9 enter the corresponding digit
215 / Seek the % relative to the number previously entered
216 [Left]/[Right] seek -+ 15 sec (+CTRL: 60 sec)
217 [PgUp]/[Prior] jump to previous playlist entry
218 [PgDown]/[Next] jump to next playlist entry
219
220 f toggle fullscreen mode
221 a toggle aspect ratio (AUTO/16:9/4:3/DVB)
222 i toggle interlaced mode
223
224 z / Shift-Z zoom into / out of video
225 add Ctrl to zoom horizontally or Meta to zoom vertically
226
227 "<", ">" modify output window size
228 + - change audio channel
229 , . change subtitle channel
230 n m adjust a/v sync
231 [HOME] reset a/v sync
232
233 [INSERT] toggle mouse cursor grabbing in the video output window
234
235 q quit
236
237 h hide video window (useful for mp3 playback)
238
239
240 More to come. :-)
241
242 Right click (or press 'g') on the video window to toggle panel
243 visibility.
244
245 Changing shortcuts:
246 You can also change one/many/all of the shortcuts. For this, you
247 should have a keymap in your $HOME/.xine/ directory. The key entry
248 syntax is:
249
250 WindowReduce {
251 key = less
252 modifier = none
253 }
254
255 The key should match with X11 key strings (see below). The modifier
256 could be:
257 - 'none' for no modifier,
258 - 'control' (or 'ctrl') for the control key,
259 - 'meta' (or 'alt' on PC) for meta key,
260 - 'mod3' or 'mod4' or 'mod5' only available on some platforms.
261
262 Modifiers can be mixed, separated with comma:
263
264 WindowReduce {
265 key = less
266 modifier = control, alt
267 }
268
269 If you don't specify a modifier line that's equal to specifying 'none'.
270
271 You can also add alias keystrokes, like:
272
273 Alias {
274 entry = Pause
275 key = p
276 }
277
278 Meaning you add another key stroke to 'Pause' entry, by pressing 'p',
279 you can also add a modifier section (see above). If you don't specify
280 it, the modifier will be the same as in the original section ('Pause'
281 in this case).
282
283 Tracking X11 key names:
284 To know a X11 key string, you could use 'xev', which it's provided
285 with your X11 package. Start 'xev' from a xterm, give focus to the
286 small displayed window, and hit the key you want to specify.
287
288 Then you will see something like:
289
290 ...
291 KeyRelease event, serial 27, synthetic NO, window 0x3200001,
292 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
293 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
294 ^^^^^^^^
295 This is what you're looking for.
296
297
298 About mouse button, to use your mouse wheel by example, you have
299 to track which button will be assigned to a function, using xev:
300
301 ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
302 root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
303 state 0x1000, button 5, same_screen YES
304 ^^^^^^^^
305 This is the button
306
307 In this case, you have to set a "key = XButton_5". Modifier key
308 is also supported with mouse button handling.
309
310
311 Displaying current/remapped shortcuts:
312 You could use 'xine --keymap' or 'xine --keymap=default' to display
313 default shortcuts. You can redirect the result to a file, which can
314 become a ~/.xine/keymap itself.
315
316 To see the result of a remapping, just use 'xine --keymap=remapped'.
317
3182.4.2 Selecting audio channels
319
320 Supply the -a option to select the desired audio track:
321
322 xine -a 3 test.mpg
323
324 Plays the third available audio track (and the video, of course).
325
326 Alternatively the gui can be used to select an audio channel.
327
3282.4.3 Selecting subtitles
329
330 Subtitles are embedded in different tracks like audio. In general,
331 track 0 is the default language subtitle. Use the -u option to select
332 the desired subtitle track:
333
334 xine -u 0 test.vob
335
336 Displays the subtitles from stream 0.
337
338 Alternatively the gui can be used to select a subtitle channel.
339
3402.4.4 LIRC
341
342 xine can be remotely controlled with IR. For this, you should have
343 LIRC installed (http://www.lirc.org).
344
345 You should add some entries in your ~/.lircrc, like this:
346
347 begin
348 remote = SAMSUNG
349 button = Button_Play
350 prog = xine
351 repeat = 0
352 config = Play
353 end
354 begin
355 remote = SAMSUNG
356 button = Button_1
357 prog = xine
358 repeat = 0
359 config = SetPosition10%
360 end
361
362 xine can self generate a lirc entries draft, using 'xine --keymap=lirc',
363 then you can redirect the output to a file to polish the settings.
364
365 Each entry will look like this:
366
367 # Reduce the output window size.
368 begin
369 remote = xxxxx
370 button = xxxxx
371 prog = xine
372 repeat = 0
373 config = WindowReduce
374 end
375
376 It's yours to specify the remote name, and assign the button.
377
378 Playlist:
379 ---------
380 To Retrieve a playlist from a given input plugin, you can use the
381 special 'PlaylistFrom:' keyword, followed by the plugin name (the same
382 in the button in the panel window):
383
384 # Retrieve playlist from NAV plugin.
385 begin
386 remote = xxxxx
387 button = xxxxx
388 prog = xine
389 repeat = 0
390 config = PlaylistFrom:NAV
391 end
392
3932.4.5 Setting xine config-options on the commandline
394
395 You can set any option (see README.config_en) from the commandline
396 to override the default value in $HOME/.xine/config.
397
398 For example you can do something like
399
400 xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1
401
402 to change the vcd_device between playing two mrls.
403
404 These opt: settings will not be saved in the configuration file, they
405 are only temporary.
406
407
4083 WHAT'S LEFT TO SAY
409
4103.1 Freedom, DVDs and stuff...
411
412 xine is free software. "free software" is somewhat related to being
413 "open-source". However, the meaning of "free software" goes further
414 than just that: it is about the freedom of users of software. If you
415 have the time, please read what the free software foundation says
416 about the topics of freedom and software:
417
418 => http://www.gnu.org/philosophy/free-sw.html
419
420 There is a very special threat to freedom when it comes to DVDs: the
421 movie industry is making huge efforts to restrict playback of DVDs to
422 controlled devices. Most DVDs that are currently sold are encrypted in
423 a proprietary way - and in some countries (most notably the USA), it
424 is possibly illegal to decrypt them - even for private viewing.
425 Hopefully most people will agree that this is a very questionable way
426 to treat customers. The xine project team condemns these efforts of
427 the movie industry - trying to prevent loss of sales in such a way
428 surely shows a lot of disrespect towards all their honest customers.
429 On the other hand, the xine project team is against breaking existing
430 law. No one knows exactly if it is actually illegal anywhere in the
431 world to write, own and use software for viewing encrypted DVDs. But
432 as this is an unclear topic (that seems potentially very dangerous),
433 xine does not contain any specific code for decrypting DVDs. It seems,
434 however, that third parties are working on such extensions. Possibly
435 in some places it is legal to use these. Whichever way - you will not
436 be able to play encrypted DVDs with xine out-of-the-box. Please note
437 that this is not a bug or 'missing feature', but a genuine legal
438 problem. It would be great to solve the problem (i.e. convincing
439 america and/or the movie industry that they are really annoying and
440 unnecessarily unfair to customers as well as users and developers of
441 free software), but including code to decrypt DVDs in xine won't solve
442 this problem.
443
444
4454 Contacting the xine project
446
447 the xine project website is
448
449 => http://xine.sourceforge.net
450
451 Feedback or offers for help are greatly appreciated, please contact:
452
453 the xine user mailing list <xine-user@lists.sourceforge.net>
454
README_es
1 *************************************
2 XINE: Un reproductor libre de vídeo
3 *************************************
4
5
6Traducción:
7 Alfredo J. Delaiti (2002-05),
8 Carlos E. Robinson (2008-02)
9
10
11
12Índice general
13
14 1 LA DOCUMENTACIÓN
15 1.1 Alcance de este documento
16 2 ACERCA DE XINE
17 2.1 Plataformas soportadas y requisitos
18 2.2 Software usado
19 2.3 Desarrolladores de xine
20 2.4 Uso
21 2.4.1 Atajos de teclado
22 Cambiando atajos:
23 Siguiendo la pista a nombres de teclas en X11:
24 Mostrando los atajos activos/remapeados:
25 2.4.2 Seleccionando los canales de sonido
26 2.4.3 Seleccionando los subtítulos
27 2.4.4 LIRC
28 Lista de reproducción
29 2.4.5 Ajustando opciones de configuración en la línea de órdenes
30 3 Lo que queda por decir
31 3.1 Libertad, DVDs y cosas...
32 4 Contactando con el proyecto xine
33
34
35
361 LA DOCUMENTACIÓN
37
38 1.1 Alcance de este documento
39
40Este es el documento para el usuario final de xine-lib y xine-ui.
41Encontrará más documentación en el directorio doc/ de ambos paquetes. Mire
42también el FAQ (preguntas frecuentes) incluido con el paquete xine-ui que
43pudiera tener las respuestas a sus preguntas.
44
452 ACERCA DE XINE
46
47xine es un reproductor de vídeo para sistemas tipo unix con licencia libre
48GPL. Soporta secuencias de vídeo mpeg-2 y mpeg-1 (sonido + vídeo
49multiplexado), secuencias elementales mpeg (sólo sonido/imagen, ej.
50archivos mp3), archivos AVI con varios formatos (algunos de ellos usando
51los codec en dlls de win32) y secuencias Vorbis OGG. Hay algún soporte para
52secuencias quictime (pero la mayoría de los códecs quicktime de audio y
53vídeo son altamente propietarios y por tanto no soportados).
54
55xine reproduce secuencias de imágenes y sonidos y sincroniza la
56reproducción de ambos. Dependiendo de las propiedades de la secuencia a
57reproducir, se necesitará más o menos potencia de procesador; se ha visto
58reprodución con frecuencia de cuadro completa en sistemas con un P II a 400
59MHz.
60
61xine puede reproducir directamente Vídeo CDs, SVCDs y DVDs.
62Desgraciadamente el estado legal en la reproducción de DVD bloqueados /
63encriptados en algunos países es incierta, por lo tanto no podemos incluir
64ningún código de desencriptación/desbloqueo con xine. Para reproducir este
65tipo de DVDs necesitará programas externos o algo como un xine_dvd_plugin
66que pueda manejar autentificación / descodificación (descrambling) del DVD.
67
68El projecto xine niega cualquier responsabilidad en tales usos de xine.
69
70A partir de xine 0.5 hemos introducido un nueva arquitectura ofreciendo
71complementos (plugins) flexibles para varias tareas, así varios otros tipos
72de secuencias y dispositivos de salida pueden ser soportados en un futuro.
73
742.1 Plataformas soportadas y requisitos
75
76• xine necesita un servidor X11 para la salida de vídeo
77 (de 8, 15, 16, 24 o 32 bit de profundidad de color)
78
79• xine puede detectar y usar X vídeo del MIT y la extensión de memoria
80 compartida de X para un mejor rendimiento
81
82• si no puede conseguir que Xv corra en su plataforma debería usar una
83 profundidad de color de 16bpp para tener mejor velocidad. Xv parece
84 funcionar muy bien para cualquier profundidad de color.
85
86• si usted tiene un adaptador gráfico Matrox G200/G400/G450 puede
87 opcionalmente usar el controlador de salida de vídeo sybcfb/teletux. Vea
88 README.syncfb para más detalles.
89
90• para la reproducción de sonido se soportan OSS, ALSA, ESD y ARTSD.
91
92• aaxine usa aalib para la salida y puede correr en casi cualquier
93 terminal.
94
95• para construir xine se requieren GNU make, gcc y binutils bastante
96 recientes.
97
98xine debería correr en cualquier máquina reciente compatible i386 (pentium
99y más) que use GNU/linux o FreeBSD. Dependiendo del tipo de flujo de vídeo
100que quiera reproducir necesitará más o menos potencia de procesador para
101una reproducción fluída. Por regla general, los DVDs funcionarán bien en un
102Pentium II a 400 (o equivalente). Hay muchos factores en esta ecuación, así
103que sus resultados pueden variar.
104
105Tarjetas gráficas comprobadas con éxito (usando Xv) para PCs incluyen:
106nVidia Riva TNT (con manejador de código cerrado nvidia), nVidia Riva TNT
1072, Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo3 2000 PCI 16Mb.
108
109Las siguientes tarjetas han sido reportadas como que funcionan, pero no
110está claro si funcionarán con Xv o sólo con XShm (por favor, repórtelo en
111la lista de correo xine-user):
112
113Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.
114
115xine debería ser capaz de mostrar vídeo en cualquier tipo de servidor X que
116funcione, con cualquier tipo de tarjeta gráfica, pero con mucho peor
117rendimiento que con Xv.
118
119Adicionalmente, xine funciona en plataformas i386-solaris, maquinas sparc
120ccorriendo linux o solaris (se sabe que Creator-3D framebuffer funciona),
121vea README.solaris por más información. También están soportados: algunos
122sistemas basados en powerpc (con linux) e IRIX en MIPS.
123
124Por último pero no menos importante, xine ha sido reportado que funciona en
125máquinas Alpha, IA-64 y S/390.
126
1272.2 Software usado
128
129xine usa código de los siguientes projectos de software libre externos:
130
131• liba52 por Aaron Holtzman y Michel Lespinasse
132
133• libmpeg2 por Aaron Holtzman y Michel Lespinasse
134
135• libmad por Robert Leslie
136
137• libffmpeg por Fabrice Bellard
138
139Sin esas magníficas obras de software, por supuesto que xine no estaría
140donde está ahora.
141
142También muchas gracias al proyecto de vídeo linux y DVD “LiViD”, de donde
143vinieron las ideas originales para el reproductor xine.
144
145==> [http://www.linuxvideo.org/]
146
1472.3 Desarrolladores de xine
148
149Programación principal de xine
150
151 Guenter Bartsch <guenter@users.sourceforge.net>
152
153Varias sugerencias, corrección de gazapos y construcciones, complemento
154alsa, igu (gui )
155
156 Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
157
158Muchas correciones de gazapos y bloqueos muertos, detección de ritmo bit,
159desentrelazador en software, actualizaciones masivas de libwin32
160
161 Miguel Freitas <miguel@cetuc.puc-rio.br>
162
163Módulo de salida de vídeo teletux/syncfb, varias correcciones de gazapos /
164revisiones, alsa
165
166 Joachim Koenig <Joachim.Koenig@gmx.net>
167
168Desarrollo liba52/libmpeg2
169
170 Michel Lespinasse <walken@zoy.org>
171
172Paquete Debian, soporte de usuario
173
174 Siegfried Langauf <siggi@users.sourceforge.net>
175
176Y varios contribuidores más, vea el fichero xine-lib/AUTHORS
177
1782.4 Uso
179
180Puede iniciar xine sin especificar ningún parámetro en la línea de órdenes
181o directamente especificando una o más secuencias de entrada. xine trata de
182detectar si puede usar la extensión Xv y si no pasará a XShm, pero esa
183detección podría fallar. Puede especificar el complemento para la salida de
184vídeo usando la opción "-V". ej.
185
186xine -V Xshm
187
188
189
190obliga a xine a usar XShm o X11 simple.
191
192Si quiere enviar el sonido por una red con ESD, defina la variable de
193entorno ESPEAKER antes de iniciar xine.
194
195El flujo de entrada puede ser un nombre de archivo o algo que llamamos
196"MediaResourceLocator" MRL (localizador de medios) que es similar similar a
197un URL. Primero especifique una fuente de entrada la cual es seguida por
198"://" y un identificador específico de la fuente de entrada. Qué fuentes de
199entrada pueda usar, depende los complemento de entrada que tenga (para
200ficheros simples puede omitir la identificación de la fuente de entrada).
201
202Pruebe:
203
204$ xine --help
205
206para tener información más completa de su forma de uso.
207
208xine soporta el protocolo xdnd (Versión 3) así que si tiene una aplicación
209navegador de ficheros que soporte ese protocolo (ej. gmc) puede dejar caer
210ficheros de vídeo sobre xine para su reproducción.
211
212Reproducir la pista 3 de un VCD:
213
214$ xine vcd://3
215
216Ejemplo para acceso directo a un DVD:
217
218$ xine dvd://VTS_01_1.VOB
219
2202.4.1 Atajos de teclado
221
222
223
224
225 Tecla Acción
226 [Intro] reproducción
227 [Espacio] pausa
228 [Arriba]/[Abajo] avance rápido / lento
229 0-9 introduzca el dígito correspondiente
230 / se desplaza el % relativo al dígito previamente introducido
231 [Izq][Der] se desplaza ±15 segs (+CTRL: 60 segs)
232 f conmuta pantalla completa
233 a conmuta la razón de aspecto (AUTO/16:9/4:3/DVB)
234 i conmuta modo entrelazado
235 z / ^Z acercar zoom / alejar
236 con Ctrl hace zoom horizontal y con Meta lo hace vertical
237 "<", ">" modificar el tamaño de la ventana de salida
238 + - cambiar el canal de audio
239 , . cambiar el canal de subtítulos
240 n m ajustar sincronismo audio / vídeo
241 [HOME] reiniciar sincronismo a / v
242 [INSERT] conmutar la captura de ratón en la ventana de salida de vídeo
243 q salir
244 h esconder la ventana de vídeo (util para reproducir mp3)
245 Y más que vendrán :-)
246
247
248Haga clic derecho del ratón (o pulse 'g') en la ventana vídeo para
249(des)activar la visualización del panel.
250
251 Cambiando atajos:
252
253 Puede tambien cambiar uno/muchos/todos los atajos. Para esto, debe tener
254un mapa de teclado en su directorio $HOME/.xine/. La sintaxis de las teclas
255es:
256
257WindowReduce {
258 key = less
259 modifier = none
260}
261
262La tecla debería encajar con los nombres de teclas X11 (ver abajo). El
263modificador puede ser:
264
265• 'none' para no modificador,
266
267• 'control' (o 'ctrl') para la tecla de control,
268
269• 'meta' (o 'alt' en los PC) para la tecla meta,
270
271• 'mod3' o 'mod4' o 'mod5' sólo está disponible en algunas plataformas.
272
273Los modificadores pueden mezclarse, separandolos con comas:
274
275WindowReduce {
276 key = less
277 modifier = control, alt
278}
279
280Si no especifica una línea modificadora eso equivale a especificar 'none'
281(ninguno).
282
283Puede también añadir alias de teclas, como:
284
285Alias {
286 entry = Pause
287 key = p
288}
289
290Lo que significa que añade otra pulsación de tecla a la entrada 'Pause',
291pulsando 'p', también puede añadir una sección modificadora (ver arriba).
292Si no la especifica, el modificador será el mismo que en la sección
293original ('Pause' en este caso).
294
295 Siguiendo la pista a nombres de teclas en X11:
296
297 Para saber el nombre de una tecla en X11, podría usar 'xev', que se
298suministra con su paquete X11. Arranque 'xev' desde un xterm, déle el foco
299a la ventanita, y pulse la tecla que quiera especificar.
300
301Entonces verá algo como esto:
302
303KeyRelease event, serial 27, synthetic NO, window 0x3200001,
304 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
305 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
306 ^^^^^^^^
307 Esto es lo que busca
308
309Sobre el botón del ratón, por ejemplo para usar la rueda del ratón, tiene
310que seguir la pista a qué botón se le asignará a una función, usando xev:
311
312ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
313 root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
314 state 0x1000, button 5, same_screen YES
315 ^^^^^^^^
316 Este es el botón
317
318En este caso, tiene que poner "key = XButton_5". Las teclas modificadoras
319también se soportan con el manejo de botón de ratón.
320
321 Mostrando los atajos activos/remapeados:
322
323Podría usar 'xine --keymap' o 'xine --keymap=default' para mostrar los
324atajos por omisión. Puede redirigir el resultado a un fichero, que puede
325convertirse en el propio ~/.xine/keymap
326
327Para ver el resultado de un remapeado simplemente use 'xine
328--keymap=remapped'.
329
3302.4.2 Seleccionando los canales de sonido
331
332Proporcione la opción -a para seleccionar la pista de sonido deseada:
333
334xine --a 3 test.mpg
335
336reproduce la tercera pista de sonido disponible (y por supuesto, la
337imagen).
338
339Alternativamente el igu (gui) puede ser usado para seleccionar un canal de
340audio.
341
3422.4.3 Seleccionando los subtítulos
343
344Los subtítulos son incluidos en pistas diferentes como el sonido. En
345general, la pista 0 es el subtítulo del idioma por omisión. Use la opción
346-u para seleccionar la pista de subtítulo deseada:
347
348xine --u 0 test.vob
349
350muestra los subtítulos de la secuencia o flujo 0.
351
352Alternativamente el igu (gui) puede ser usado para seleccionar un canal de
353subtítulos.
354
3552.4.4 LIRC
356
357xine puede ser controlado remotamente via infrarojos (IR). Para esto
358debería tener instalado LIRC ([http://www.lirc.org]).
359
360Debería añadir algunas entradas en su ~/.lircrc, tales como
361
362begin
363 remote = SAMSUNG
364 button = Button_Play
365 prog = xine
366 repeat = 0
367 config = Play
368end
369
370begin
371 remote = SAMSUNG
372 button = Button_1
373 prog = xine
374 repeat = 0
375 config = SetPosition10%
376end
377
378xine puede autogenerar un borrador de configuración para lirc, usando 'xine
379--keymap=lirc', y entonces puede redirigir la salida a un fichero para
380afinar la configuración.
381
382Cada entrada tendrá este aspecto:
383
384# Reduce the output window size.
385
386begin
387 remote = xxxxx
388 button = xxxxx
389 prog = xine
390 repeat = 0
391 config = WindowReduce
392end
393
394Es todo suyo para especificar el nombre remoto y asignar el botón.
395
396 Lista de reproducción
397
398Para recuperar una lista de reproducción de un complemento de entrada dado,
399puede usar la plabra clave 'PlaylistFrom:', seguida del nombre del
400complemento (el mismo que en el botón de la ventana del panel[Nota al pie:
401N. del T.: Observación: es posible que algunos de estos nombres estén
402traducidos. Si esto supone un problema, me (nos) gustaría saberlo para
403corregirlo.
404]):
405
406# Retrieve playlist from NAV plugin.
407
408begin
409 remote = xxxxx
410 button = xxxxx
411 prog = xine
412 repeat = 0
413 config = PlaylistFrom:NAV
414end
415
4162.4.5 Ajustando opciones de configuración en la línea de órdenes
417
418Puede cambiar cualquier opción (vea README.config_en) desde la línea de
419órdenes para anular el valor por omisión en $HOME/.xine/config.
420
421Por ejemplo, puede hacer algo como:
422
423xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1
424
425para cambiar el vcd_device entre la mitad de la repoducción de dos mrls.
426
427Estos ajustes opcionales no se grabarán en el fichero de configuración, son
428solo temporales.
429
4303 Lo que queda por decir
431
4323.1 Libertad, DVDs y cosas...
433
434xine es software libre. “Software libre” tiene que ver con ser “código
435abierto”. Sin embargo, el significado de “software libre” va más allá de
436simplemente eso: es sobre la libertade de los usuarios de software
437(programas). Si tiene tiempo, por favor lea lo que la fundación del
438software libre dice acerca de las cuestiones de libertad y software
439
440 => [http://www.gnu.org/philosophy/free-sw.html]
441
442Hay una amenaza especial a la libertad cuando hablamos de DVDs: la
443industria del cine está haciendo enormes esfuerzos para restringir la
444reproducción de DVDs a dispositivos controlados. La mayoría de los DVDs que
445se venden actualmente están encriptados de una manera propietaria - y en
446algunos paises (especialmente E.E.U.U.), es posiblemente ilegal
447descifrarlos - incluso para reproducción privada. Esperanzadoramente, la
448mayoría de la gente estará de acuerdo de que es una manera muy questionable
449de tratar a los clientes. El proyecto xine condena estos esfuerzos de la
450industria del cine - intentar prevenir pérdida de beneficios de ventas de
451esa manera demuestra falta de respeto hacia todos sus clientes honestos.
452Por otra parte, el proyecto xine está en contra de violar la ley existente.
453Nadie sabe exactamente si es realmente ilegal en cualquier parte del mundo
454escribir, poseer y usar software para ver DVDs cifrados. Pero como esto es
455un tema no claro (que parece potencialmente muy peligroso), xine no
456contiene nigún código específico para descifrar DVDs. Parece, sin embargo,
457que terceras partes están trabajando en tales complementos. Posiblemente en
458algunas partes es legal usarlos. De cualquier forma - no podrá reproducir
459DVDs con xine tal cual. Por favor, observe que esto no es un gazapo o una
460“funcionalidad que falte”, sino un problema genuinamente legal. Sería muy
461bueno solucionar el problema (p.e., convenciendo a E.E.U.U. y/o la
462industria del cine que están realmente molestando y siendo innecesariamente
463injustos con sus clientes y también usuarios y desarrolladores de software
464libre), pero incluir código para descifrar DVDs en xine no solucionará este
465problema.
466
4674 Contactando con el proyecto xine
468
469El sitio web del proyecto xine es
470
471 => [http://xine.sourceforge.net]
472
473Reacciones u ofertas de ayuda serán muy apreciadas, por favor contacte:
474
475 => [mailto://xine-user@lists.sourceforge.net||la lista de usuarios de xine]
476
477
README_fi
1 ++++++++++++++++++++++ +++++++++++++++++++++
2 XINE: Ilmainen/vapaa videosoitin
3 ++++++++++++++++++++++ +++++++++++++++++++++
4
5
6 INDEX
7 -===-
8
9 1 Käyttöohje
10 1.1 Esikatselmus
11
12 2 Xine:stä
13 2.1 Tuetut käyttöjärjestelmät ja vaatimukset
14 2.2 Käytetyt ohjelmat
15 2.3 Xine:n kehittäjät
16 2.4 Käyttö
17 2.4.1 Pikänäppäimet
18 2.4.2 Audio-kanavien valinta
19 2.4.3 Tekstityksen valinta
20
21 3 Vielä sanottavaa
22 3.1 Vapaus, dvd:t ja muuta...
23
24 4 Yhteyden ottaminen
25
26
27
28
29
30
31
321 Käyttöohje
33
341.1 Esikatselmus
35
36 Tämä on loppukäyttäjän käyttöhje xine-lib:lle ja xine-ui:lle. Löydät
37 lisää dokumentaatiota molempien pakettien doc/ hakemistosta.
38
39 Katso myös tarkemmin FAQ (Useimmiten Kysytyt Kysymykset/UKK) tiedostoa
40 xine-ui paketissa, jossa voi olla jo vastaus kysymykseesi.
41
42
432 Xine:stä
44
45 Xine on ilmainen/vapaa GPL-lisensoitu videosoitin unix-tyylisille käyttö-
46 järjestelmille. Xine tukee mpeg-2 ja mpeg-1 (audio + video) tiedostoita,
47 mpeg päävirtoja (audio/video ainostaan, esim. mp3 tiedostoja), AVI
48 tiedostoja useilla video-formaateilla (joitakin käyttäen win32 dll:ä)
49 ja Vorbis OGG virtoja. Sekä hieman quicktime virtoja (mutta useimmat
50 quicktime video ja audio koodekit ovat patentoituja ja siksi ei tuettuja).
51
52 Xine toistaa video ja audio dataa virrasta ja synkronoi niiden toiston.
53 Riippuen virran ominaisuuksista, toistaminen vaatii enemmän tai vähemmän
54 tehoa, täydellä toistolla mpeg-2 on nähty toimivan 400 MHz P II järjes-
55 telmällä.
56
57 Xine voi toistaa Vdeo CD:tä, SVCD:tä ja DVD:tä suoraan. Ikävä kyllä
58 salatun/lukitun DVD:n toistamisen laillisuus joissakin maissa on
59 epävarmaa, joten Xine ei sisällä DVD koodin purkamista. Sellaisen
60 DVD:n toistamiseen tarvitset erillisen ohjelman tai kuten
61 xine_dvd_plugin:n joka osaa hoitaa DVD:n purkamisen.
62
63 Xine:n projekti tiimi kieltää kaiken vastuun xine:n käyttämisen ko.
64 tarkoituksiin.
65
66 Xine 0.5 versiosta lähtien Xine:n arkkitehtuuri sallii joustavat
67 "pluginit", joten monenlaiset muut virta-tyypit ja ulostulo-laitteet
68 voisivat olla tuettuja tulevaisuudessa.
69
702.1 Tuetut käyttöjärjestelmät ja vaatimukset
71
72 - Xine vaatii X11 serverin video-ulostulolle
73 (8, 15, 16, 24 or 32 bitin värisyvyydellä)
74
75 - Xine voi tunnistaa ja käyttää MIT X videota ja X:n jaetun muistin
76 laajennusta parempaan toistoon suoritukseen.
77
78 - Jos et saa Xv:tä toimimaan käyttöjärjestelmässäsi, täytyisi sinun
79 käyttää 16 bitin värisyvyyttä nopeuden takia. Xv näyttää toimivan
80 hyvin millä tahansa värisyvyydellä.
81
82 - Jos omistat Matrox G200/G400/G450 näytönohjaimen voit myös käyttää
83 sybcfb/teletux video-ulostulo ajuria. Katso README.syncfb :stä
84 lisätietoa.
85
86 - äänen toistamiseen OSS, ALSA, ESD ja ARTSD ovat tuettuja.
87 - aaxine käyttää aalib :iä ulostuloon ja toimii lähes kaikilla
88 terminaaleilla.
89 - Xine:n kääntämiseen vaaditaan melko uusi GNU make, gcc ja binutils.
90
91 Xine:n pitäisi toimia i386-yhteensopivilla koneilla (pentium tai
92 uudempi) joka käyttää GNU/linux:ia tai FreeBSD:tä. Riippuen toista-
93 mastasi video-virrasta, tarvitset enemmän tai vähemmän prosessori-
94 tehoa. Perussääntönä on, että DVD:t yleensä pyörivät hyvin
95 Pentium II 400 järjestelmällä (tai vastaavalla). Tähän vaikuttaa
96 useita tekijöitä, joten vaatimukset voivat vaihdella.
97
98 Onnistuneesti testatut näytönohjaimet (käyttäen Xv:tä) Pc:lle ovat:
99 nVidia Riva TNT (suljetuille nvidia ajureilla), nVidia Riva TNT 2,
100 Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo 2000 PCI 16Mb.
101
102 Seuraavien korttien on raportoitu toimivan, mutta on epäselvää toimi-
103 vatko ne Xv:n vaiko vain XShm:n kanssa (raportoikaa asiasta xine-user
104 postituslistalle):
105
106 Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.
107
108 Xine:n pitäisi pystyä näyttämään videota millä tahansa toimivalla
109 xserver:llä millä tahansa näytönohjaimella, mutta huonommalla tuloksella
110 kuin Xv:n kanssa.
111
112 Vaihtoehtoisesti, Xine pyörii myös i386-solariksella, sparc koneilla
113 jotka käyttävät linuxia ja solarista (Creator-3d framebufferin tiedetään
114 toimivan), katso README.solaris :sta lisätietoa.
115
116 Viimeisinpänä, muttei vähimmäisenä, Xine:n on kuultu toimivan Alphalla,
117 IA-64 ja S/390 koneilla.
118
1192.2 Käytetetyt ohjelmat
120
121 Xine käyttää koodia seuraavista ulkoisista projekteista:
122
123 - liba52 - Aaron Holtzman ja Michel Lespinasse
124 - libmpeg2 - Aaron Holtzman ja Michel Lespinasse
125 - libmad - Robert Leslie
126 - libffmpeg - Fabrice Bellard
127
128 Ilman näitä mahtavia ohjelman palasia Xine ei tietenkään olisi
129 nykyisessä pisteessään.
130
131 Sekä lisäksi paljon kiitoksia Linux Video ja DVD Projektille "LiViD",
132 josta alkuperäiset Xine videosoittimen ideat tuli.
133
134 => http://www.linuxvideo.org/
135
1362.3 Xine:n kehittäjät
137
138 pää-xine-kehittäjä
139 Guenter Bartsch
140
141 useita ehdotuksia, bugi ja kääntämisen korjauksia, alsa plugini, gui
142 Daniel Caujolle-Bert
143
144 audio ohjelmointi
145 Siegfried Langauf
146
147 mahtavat libmpeg2 ja libac3 hakkeroinnit:
148 Michael Lespinasse
149
150 Plus useita muita kehittäjiä, katso xine-lib/AUTHORS tiedosto
151
1522.4 Käyttö
153
154 Voit käynnistää Xine:n ilman komentorivin parametrejä tai voit valita
155 yhden tai useamman virran suoraan. Xine yrittää tunnistaa voiko se käyttää
156 Xv laajennusta ja palaa takaisin XShm:n, mutta tämä tunnistus voi epä-
157 onnistua. Voit määritellä video-ulostulo pluginin käyttämällä "-V"
158 parametriä. Esim.
159
160 xine -V XShm
161
162 pakottaa Xine:n käyttämään XShm:ää tai pelkkää X11:ta.
163
164 Jos haluat lähettää äänen verkon yli ESD:llä, aseta ESPEAKER
165 ympäristömuuttuja (enviroment variable) ennen Xine:n käynnistystä.
166
167 Käytettävä virta voi olla tiedostonimi tai joko käyttämämme
168 "MediaResourceLocator" (tai MRL), joka näyttää samanlaiselta kuin URL.
169 Ensimmäiseksi määritellään käytettävä lähde jota seuraa "://" ja
170 lähteen tarkennustunniste. Käyttämäsi lähteen muoto riippuu
171 asennetuista plugineista (pelkille tiedostoille voit laittaa lähteen
172 tunnisteen).
173
174 Kokeile:
175
176 xine --help
177
178 saadaksesi enemmän tietoa käytöstä.
179
180 Xine tukee xdnd protokollaa (versio 3) joten voit jos sinulla on
181 tiedostojen hallintaohjelma joka tukee tätä protokollaa (esim gmc),
182 voit laittaa ne toistamaan Xine:llä.
183
184 3. raidan toistaminen VCD:ltä:
185
186 xine vcd://3
187
188 Esimerkki suoraan DVD toistoon:
189
190 xine dvd://VTS_01_1.VOB
191
192
1932.4.1 Pikanäppäimet
194
195 Näppäin Toiminto
196
197 <Entteri> toista
198 <välilyönti> tauko
199 <Ylös>/<Alas> pikakelaus / hidastus
200
201 0 selaa virran alkuun
202 1-9 selaa 10-90% :n
203 <Vasen>/<Oikea> selaa -+ 15 sekunttia (+CTRL: 60 sek.)
204 <PgUp>/<Edell.> edellinen soittolistan kohta
205 <PgDown>/<Seur.> seuraava soittolistan kohta
206
207 f kokonäyttö / ikkuna
208 a kuvasuhde (AUTO/16:9/4:3/DVB)
209 i "interlaced" tila
210
211 z / Shift-Z zoomaa lähemmäksi / kauemmaksi
212 lisättynä Ctrl näppäimellä horisontaalisesti tai
213 Alt näppäimellä vertikaalisesti
214
215 "<", ">" muokkaa videoikkunan kokoa
216 + - vaihda audio-kanava
217 , . vaihda tekstitys-kanava
218 n m säädä a/v sync:iä
219 <HOME> resetoi a/v sync
220
221 <INSERT> hiiren "grabbaus" videokuvaan (päälle/pois)
222
223 q lopetus
224
225 h piilota video ikkuna (käytännölllinen mp3 toistoon)
226
227
228 Lisää tulossa :-)
229
230 Klikkaa oikeanpuoleisella napilla (tai paina 'g') video ikkunaa
231 vaihtaaksesi paneelin näkyvyyttä.
232
233 Pikanäppäinten vaihtaminen:
234 Voit myös vaihtaa yhtä/useita/kaikkia pikänäppäimiä. Sinulla pitäisi
235 olla keymap tiedosto $HOME/.xine/ hakemistossa. Perussyntaksi:
236
237 WindowReduce {
238 key = less
239 modifier = none
240 }
241
242 Näppäimen pitäisi täsmätä X11 key stringiin (alla). Vaihtamis-
243 näppäin voisi olla:
244 - 'none' ei vaihtamisnäppäintä,
245 - 'control' (tai 'ctrl') control näppäimelle,
246 - 'meta' (tai 'alt' PC:llä) alt näppäimelle,
247 - 'mod3' tai 'mod4' tai 'mod5' joissakin järjestelmissä.
248
249 Vaihtajia voi olla useita. Ne erotetaan pilkulla:
250
251 WindowReduce {
252 key = less
253 modifier = control, alt
254 }
255
256 Jos et määritä vaihtaja riviä se vastaa samaa kuin 'none'.
257
258 Voit myös määrittää aliaksia näppäimille:
259
260 Alias {
261 entry = Pause
262 key = p
263 }
264
265 Jos lisäät toisen näppäimen 'Pause' komennolle, painamalla 'p'
266 voit myös lisätä vaihtajanäppäimen (katso yllä). Jos et määritä
267 sitä, niin vaihtajanäppäin tulee olemaan sama kuin alkuperäisessä
268 ('Pause' tässä tapauksessa).
269
270 X11 key name:
271 Tietääksesi X11 key stringin, voit käyttää 'xev':ä, joka tulee X11
272 paketin mukana. Käynnistä 'xev' xterm:stä, klikkaa ilmestyvää pientä
273 ikkunaa (ts. anna focus ikkunalle) ja paina haluamaasi näppäintä.
274
275 Sitten näet seuraavanlaista:
276
277 ...
278 KeyRelease event, serial 27, synthetic NO, window 0x3200001,
279 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
280 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
281 ^^^^^^^^
282 Tätä kohtaa etsit.
283
284 Muutettujen/oletus pikanäppäinten katsominen:
285 Voit käyttää 'xine --keymap' tai 'xine--keymap=default' komentoa
286 katsoaksesi pikanäppäimet. Voit ohjata tuloksen tiedostoon, josta
287 voi tulla ~/.xine/keymap itsessään.
288
289 Katsoaksesi muutokset, käytä komentoa 'xine --keymap=remapped'
290
2912.4.2 Audio kanavien valinta
292
293 Käytä -a parametriä audio raidan valintaan:
294
295 xine -a 3 test.mpg
296
297 Toistaa kolmannen audio raidan (ja videon, tietysti)
298
299 Myös gui:ta (graafista käyttöliittymää) voidaan käyttää audio
300 kanavan valintaan.
301
3022.4.3 Tekstityksen valitseminen
303
304 Tekstitykset ovat sisällytettyjä raitoja kuten audiokin. Yleisesti
305 raita 0 on oletuskielinen tekstitys. Käytä -u parametriä tekstitys-
306 raidan valintaan:
307
308 xine -u 0 test.vob
309
310 Näyttää tekstityksen 0 raidalta.
311
312 Myös gui:ta (graafista käyttöliittymää) voidaan käyttää audio
313 kanavan valintaan.
314
3152.4.4 LIRC
316
317 Xine:ä voidaan myös ohjata infrapunakaukosäätimellä. Tätä varten,
318 sinulla pitäisi olla LIRC asennettuna (http://www.lirc.org).
319
320 Lisää muutamia kohtia ~/.lircrc tiedostoon seuraavasti:
321
322 begin
323 remote = SAMSUNG
324 button = Button_Play
325 prog = xine
326 repeat = 0
327 config = Play
328 end
329 begin
330 remote = SAMSUNG
331 button = Button_1
332 prog = xine
333 repeat = 0
334 config = SetPosition10%
335 end
336
337 Xine voi itsessään luoda lirc kohtien oletuslistan komennolla
338 'xine --keymap=lirc', jonka voit ohjata tiedostoon asetusten
339 hiomiseksi.
340
341 Jokainen kohta näytää suurinpiirtein seuraavalta:
342
343 # Reduce the output window size.
344 begin
345 remote = xxxxx
346 button = xxxxx
347 prog = xine
348 repeat = 0
349 config = WindowReduce
350 end
351
352 Tehtäväksesi jää kaukosäätimen nimen ja näppäinten asettaminen.
353
354
3553 Vielä sanottavaa
356
3573.1 Vapaus, DVD:t ja muuta...
358
359 Xine on vapaata ohjelmistoa ('free software'). Vapaa ohjelmisto liittyy
360 avoimeen lähdekoodiin ('open-source'). Kuitenkin, vapaan ohjelmiston
361 käsite menee pitemmälle: se on ohjelmiston käyttäjien vapautta. Voit
362 käydä katsomassa mitä 'free software foundation' sanoo vapaudesta ja
363 ohjelmistoista:
364
365 => http://www.gnu.org/philosophy/free-sw.html
366
367 On olemassa uhka mitä tulee DVD:siin: elokuvateollisuus on tekemässä
368 suuria ponnistuksia DVD:n toiston estämiseksi ohjatuilla laitteistoilla.
369 Useimmat DVD:t myydään koodattuina - ja joissakin maissa (ainakin
370 USA:ssa) on laitonta purkaa tämä koodi yksityiseenkin käyttöön.
371 Toivottavasti useimmat ihmiset ovat samaa mieltä, että tämä on erittäin
372 kyseenalainen tapa kohdella kuluttujia. Xine projekti tuomitsee nämä
373 elokuvateollisuuden ponnistukset - yrittäen samalla estää myyntien laskua
374 sillä tavalla joka osoittaa paljon epäkunnioitusta kaikkia rehellisiä
375 asiakkaita kohtaan. Toisaalta Xine projektin tiimi on olemassa olevien
376 lakien rikkomista vastaan. Kukaan ei oikeastaan tiedä, onko missään maassa
377 laillista kirjoittaa, omistaa tai käyttää ohjelmaa salatun DVD:n
378 katseluun. Mutta, koska tämä on epäselvää (ja ilmeisesti vaarallista),
379 xine ei sisällä suoranaista koodia DVD salauksen purkamaseksi. Näyttää
380 siltä, että kolmannet osapuolet tekevät tällaisia laajennuksia.
381 Mahdollisesti joissakin paikoissa on laitonta käyttää näitä. Oli miten
382 oli - niin xine:llä ilman erillisiä laajennuksia ei voi toistaa
383 salattuja DVD:tä. Huomioikaa, ettei tämä ole mikään bugi tai puuttuva
384 ominaisuus, mutta aidosti laillisuus ongelma. Olisi mahtavaa ratkaista
385 tämä ongelma (esim. vakuuttumalla amerikalle/elokuvateollisuudelle,
386 että he ärsyttävät ja ovat turhaan epäreiluja asiakkaita sekä käyttäjiä
387 ja vapaan ohjelmistojen kehittäjiä kohtaan), mutta sisällyttämällä
388 DVD:n purkukoodi xine:n ei ratkaise tätä ongelmaa.
389
390
3914 Yhteyden ottaminen
392
393 Xine projektin kotisivu:
394
395 => http://xine.sourceforge.net
396
397 Palaute ja avustusehdotukset ovat erittäin arvostettuja, ota yhtettä:
398
399 xine-user postituslista (englanniksi) <xine-user@lists.sourceforge.net>
400
README_fr
1 +++++++++++++++++++++++++ +++++++++++++++++++++++++
2 XINE: Un lecteur video libre
3 +++++++++++++++++++++++++ +++++++++++++++++++++++++
4
5
6 INDEX
7 -===-
8
9 1 LA DOCUMENTATION
10 1.1 But de ce document
11
12 2 A PROPOS DE XINE
13 2.1 Plateformes supportées et pré requis
14 2.2 Logiciels utilisés
15 2.3 Les développeurs de Xine
16 2.4 Utilisation
17 2.4.1 Raccourcis clavier
18 2.4.2 Selection des canaux audio
19 2.4.3 Sélection des sous titres
20
21 3 QUE RESTE T'IL A DIRE ?
22 3.1 Liberté, DVD et autres choses...
23
24 4 Contacter le projet Xine
25
26
27
28
29
30
31
321 LA DOCUMENTATION
33
341.1 But de ce document
35
36 Il s'agit de la documentation destinée à l'utilisateur final de xine-lib
37 et xine-ui. Vous pourrez trouver plus de documentation dans le répertoire
38 doc/ de chacun des packages.
39
40 Merci également de regarder de plus près les questions fréquentes (le FAQ),
41 inclus dans le package xine-ui, qui pourrais également contenir des
42 réponses à vos questions.
43
442 A PROPOS DE XINE
45
46 xine est un lecteur vidéo libre, pour systèmes de type UNIX, fonctionnant
47 sous licence GPL.
48 Il supporte les systèmes (vidéo et son multiplexés) de flux MPEG-2 & MPEG-1,
49 des flux MPEG élémentaires (audio/vidéo seulement, c.f. fichiers MP3), les
50 fichiers AVI avec de nombreux formats vidéo (certain utilisant des DLLs
51 win32) et les flux OGG Vorbis. Il existe un support pour certains flux
52 Quicktime (mais la plupart des codecs vidéo et audio de Quicktime sont
53 hautement propriétaires, et de ce fait non supportés).
54
55 Xine lit les données vidéo et audio dans les flux et synchronise leur
56 lecture. En fonction des propriétés des flux, la lecture necessitera plus
57 ou moins de charge processeur, la taux de rafraichissement maximal pour du
58 MPEG-2 a été signalé sur un P-II 400.
59
60 Xine peut lire des Video CDs, SVCDs, et des DVDs directement. Malheureu-
61 sement, le statut légal des DVD encryptés/bloqués est incertain dans
62 plusieurs pays, ainsi Xine ne contient pas le code de décryptage/débloquage.
63 Pour lire de tels DVDs, vous aurez besoin de programmes externes tels que
64 un xine_dvd_plugin qui peut controler l'authentification/décryptage.
65
66 L'équipe du projet Xine dénigre toute responsabilité pour un tel usage de
67 Xine.
68
69 Puisque l'architecture 0.5 de xine permet l'utilisation de plugins
70 flexibles, des formats de flux divers et variés, ainsi que des nouveaux
71 périphériques de sortie pourront être supportés dans le futur.
72
732.1 Plate-formes supportées et pré-requis
74
75 - Xine a besoin d'un serveur X11 pour la sortie vidéo
76 (8, 15, 16, 24 ou 32 bits de profondeur de couleur)
77
78 - Xine peut détecter et utiliser les extensions 'MIT X video' et la mémoire
79 partagée X ('X shared memory') pour de meilleures performance de lecture.
80
81 - Si vous ne pouvez pas utiliser Xv pour fonctionner sur votre plate forme,
82 vous devriez utiliser du 16 bit de profondeur de couleur pour la vitesse.
83 Xv semble fonctionner correctement pour tout les modes de couleur.
84
85 - Si vous possédez une carte vidéo Matrox G200/G400/G450, vous pouvez
86 optionnellement utiliser le driver de sortie vidéo sybcfb/teletux.
87 Reportez vous au fichier README.syncfb pour les détails.
88
89 - Pour la lecture audio, OSS, ALSA, ESD, ARTSD son supportés.
90 - aaxine utilises aalib pour la sortie vidéo, et peut être lancé sur
91 presque tout les terminaux.
92 - Pour compiler Xine, des versions de make, gcc et binutils assez récentes
93 sont requises.
94
95 Xine devrait fonctionner sur n'importe quel compatible PC récent (Pentium
96 et plus) utilisant GNU/Linux ou FreeBSD.
97 Dépendant directement du type de flux que vous voulez visionner, vous aurez
98 besoin de plus ou moins de puissance processeur pour une lecture fluide.
99 A titre de comparaison, les DVDs commenceront a être lu correctement à
100 partir d'un système Pentium II 400 (ou équivalent). Il y a plusieurs
101 facteurs dans l'équation, votre résultat peut donc varier.
102
103 Les cartes vidéo testées avec succès (utilisant Xv) pour les PCs sont :
104 nVidia Riva TNT (Drivers nvidia protégés), nVidia Riva TNT 2, Matrox G400,
105 ATI AIW Rage 128-16 MB, 3dfx Voodoo 3 2000 PCI 16 MB
106
107 Les cartes suivantes ont étés rapportées comme fonctionnelles, cependant il
108 n'est pas clair de savoir si elles fonctionnent avec Xv ou seulement avec
109 XShl (Merci de consulter la mailing list 'xine-user') :
110
111 Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.
112
113 Xine devrait être capable de montrer de la vidéo sur n'importe quel type de
114 serveur X fonctionnant avec n'importe quelle carte graphique, cependant
115 avec de plus mauvaise performance comparativement à Xv.
116
117 De plus, Xine fonctionne sur Solaris pour i386, machines SPARC sous Linux
118 ou Solaris (le framebuffer CREATOR-3D est connu pour fonctionner), voir
119 README.solaris pour plus d'information. Egalement supportés : certains
120 systèmes basés sur le powerpc (sous Linux), et IRIX sur les MIPS.
121
122 Et le dernier mais non le moindre, Xine est également rapporté comme
123 fonctionnant sur Alpha, IA-64 et S/390.
124
1252.2 Logiciel utilisés
126
127 Xine utilises du code des projets libres suivant :
128
129 - liba52 par Aaron Holtzman et Michel Lespinasse
130 - libmpeg2 par Aaron Holtzman et Michel Lespinasse
131 - libmad par Robert Leslie
132 - libffmpeg par Gerard Lantau
133
134 Sans ces grandes parties de code, Xine ne serait évidemment par ou il en
135 est maintenant.
136
137 De nouveau, de nombreux remerciements au projet Linux Video et DVD "LiViD",
138 d'ou sont venus les idées originelles pour le lecteur vidéo Xine.
139
140 => http://www.linuxvideo.org/
141
1422.3 Les développeurs de Xine
143
144 Programmation principale de Xine
145
146 Guenter Bartsch <guenter@users.sourceforge.net>
147
148 Suggestions diverses, correctifs de compilation et de programmation,
149 plugin Alsa, interface utilisateur
150
151 Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
152
153 Plusieurs correctifs de bugs et de crash, détection du taux d'échantillo-
154 nage, désentrelacement logiciel, mises à jour massives de libwin32
155
156 Miguel Freitas <miguel@cetuc.puc-rio.br>
157
158 Routine de sortie vidéo teletux/syncfb, corrections de bugs/tests variés,
159 Alsa
160
161 Joachim Koenig <Joachim.Koenig@gmx.net>
162
163 Développement liba52/libmpeg2
164
165 Michel Lespinasse <walken@zoy.org>
166
167 Package Debian, support utilisateur
168
169 Siegfried Langauf <siggi@users.sourceforge.net>
170
171 Ajoutons à cela diverses autres contributions, voir le fichier
172 xine-lib/AUTHORS
173
1742.4 Utilisation
175
176 Vous pouvez faire fonctionner Xine sans paramètre de ligne de commande,
177 ou vous pouvez spécifier, un ou plus, flux d'entrée directement. Xine
178 tentera de détecter si il peut utiliser l'extension Xv, ou retourner à XShm,
179 mais cette détection peut échouer.
180 Vous pouvez spécifier la sortie vidéo en utilisant l'option "-V", par
181 exemple :
182
183 xine -V XShm
184
185 forcera Xine à utiliser XShm ou seulement X11.
186
187 Si vous voulez envoyer le son sur un réseau avec ESD, placer la variable
188 ESPEAKER avant de démarrer Xine.
189
190 Le flux d'entrée peut être un nom de fichier ou quelque chose que nous
191 appelons "MediaResourceLocator" (ou MRL), qui ressemble à une URL. Tout
192 d'abord, vous spécifiez une source suivie de "://" et un identificateur
193 spécifique de source d'entrée. Les sources utilisables dépendent des
194 plugins d'entrée possédés (pour de simples fichiers, vous pouvez omettre
195 l'identificateur de source d'entrée).
196
197 Essayez :
198
199 xine --help
200
201 pour obtenir une information plus complète sur les options..
202
203 Xine supporte le protocol xdnd (Version 3), donc si vous avez un
204 gestionnaire de fichiers supportant ce protocole (par ex. gmc) vous pouvez
205 déplacer des fichiers vidéo dans Xine pour lecture.
206
207 Lecture de la piste 3 d'un VCD :
208
209 xine vcd://3
210
211 Exemple pour un accès direct au DVD :
212
213 xine dvd://VTS_01_1.VOB
214
215
2162.4.1 Raccourcis claviers
217
218 Touche Action
219
220 [ENTREE] Lecture
221 [ESPACE] Pause
222 [Haut]/[Bas] Avance rapide / ralenti
223
224 0 Cherche le début du flux courant
225 1-9 Cherche 10-90 % du flux courant
226 [Gauche]/[Droite] Cherche +/- 15 sec(+CTRL : 60 sec)
227 [PgUp]/[Précedent] Saut à l'entrée de playlist précédente
228 [PgDown]/[Suivant] Saut à l'entrée de playlist suivante
229
230 f Passage en plein écran
231 a Changement du ratio d'aspect (AUTO/16:9/4:3/DVB)
232 i Changement du mode d'entrelacement
233
234 z / Shift-Z Zoom in / out de la vidéo
235 Ajouter CTRL pour zoomer horizontalement ou meta pour
236 zoomer verticalement
237
238 "<", ">" Modification de la taille de la sortie vidéo
239 + - Changement du canal audio
240 , . Changement du canal de sous-titrage
241 n m Ajustement de la synchronisation audio/vidéo
242 [HOME] Remise à zéro de la synchro audio/vidéo
243
244 [INSERT] Activation de l'affichage du curseur de la souris dans
245 la fenetre de sortie video
246
247 q Quitter
248
249 h Cacher la fenetre video (utile pour la lecture MP3)
250
251
252 Plus a venir. :-)
253
254 Clic droit (ou touche 'g') dans la fenetre de sortie video pour activer
255 l'affichage du panneau de controle.
256
257 Changement des raccourcis :
258 Vous pouvez également changer un/plusieurs/tout les raccourcis. Pour
259 cela, vous devrez avoir un fichier .xine_keymap dans votre répertoire
260 $HOME. La syntaxe d'entrée d'un raccourci est :
261
262 WindowReduce {
263 key = less
264 modifier = none
265 }
266
267 La touche doit correspondre avec les codes de touche X11. Le modifica-
268 teur peut être :
269 - 'none' quand il n'y a aucun modificateur,
270 - 'control' (ou 'ctrl') pour la touche control,
271 - 'meta' (ou 'alt' sur PC) pour la touche meta,
272 - 'mod3' ou 'mod4' ou 'mod5' disponible seulement sur certaines
273 plate-formes.
274
275 Les modidicateurs peuvent être mixés, séparés par des virgules :
276
277 WindowReduce {
278 key = less
279 modifier = control, alt
280 }
281
282 Si vous ne spécifiez pas de ligne de modificateur, alors ce dernier est
283 équivalent à 'none'.
284
285 Vous pouvez également ajouter des alias de raccourcis, tels que :
286
287 Alias {
288 entry = Pause
289 key = p
290 }
291
292 Ce qui signifie que vous avez ajouté un autre raccourci à l'entrée
293 'Pause', en appuyant sur 'p', vous pouvez également ajouter une section
294 modificateur (voir ci-dessus). Si vous ne le spécifiez pas, le modifi-
295 cateur sera le même que dans la section originale ('Pause' dans le cas
296 présent).
297
298 Recherche de nom de touches sous X11 :
299 Pour connaitre la chaine d'une touche X11, vous pouvez utiliser 'xev',
300 qui est fourni avec votre package X11.
301 Démarrez 'xev' d'un terminal (comme 'xterm'), donnez la main à la
302 petite fenêtre affichée, et appuyez sur la touche que vous désirez
303 spécifier.
304
305 A ce moment, vous verrez quelque chose comme :
306 ...
307 KeyRelease event, serial 27, synthetic NO, window 0x3200001,
308 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
309 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
310 ^^^^^^^^
311 C'est ce que vous cherchez.
312
313 Afficher les raccourcis courants ou créés :
314 Vous pouvez utiliser 'xine --keymap' ou 'xine --keymap=default' pour
315 afficher les raccourcis par défaut.
316 Vous pouvez rediriger les résultats vers un fichier, qui peut devenir
317 un .xine_keymap.
318
319 Pour voir les résultats du remappage, utiliser simplement
320 'xine --keymap=remapped'
321
3222.4.2 Sélection des canaux audio
323
324 Ajouter l'option -a pour sélectionner la piste audio désirée :
325
326 xine -a 3 test.mpg
327
328 Lit la troisième piste audio disponible (et la vidéo, bien sur).
329
330 L'interface utilisateur permet également pour sélectionner une piste
331 audio.
332
3332.4.3 Selection des sous-titres
334
335 Les sous-titres sont stockés dans des pistes différentes comme l'audio.
336 En général, la piste 0 est le sous-titre de la langue par défaut.
337 Utilisez l'option -u pour sélectionner la piste de sous-titrage désirée :
338
339 xine -u 0 test.vob
340
341 Affiche les sous-titre du flux 0.
342
343 Il est également possible de changer le sous-titrage via l'interface
344 utilisateur.
345
3462.4.4 LIRC
347
348 Xine peut être controlé à distance par infrarouges. Pour cela, vous
349 devrez avoir LIRC d'installé (http://www.lirc.org).
350
351 Vous pouvez ajouter des entrées dans votre fichier ~/.lircrc, comme :
352
353 begin
354 remote = SAMSUNG
355 button = Button_Play
356 prog = xine
357 repeat = 0
358 config = Play
359 end
360 begin
361 remote = SAMSUNG
362 button = Button_1
363 prog = xine
364 repeat = 0
365 config = SetPosition10%
366 end
367
368 xine peut auto-générer un modèle d'entrées lirc, en utilisant
369 'xine --keymap=lirc', il est alors possible de rediriger la sortie vers
370 un fichier pour affiner les réglages.
371
372 Toute entrée ressemblera à ça :
373
374 # Reduce the output window size.
375 begin
376 remote = xxxxx
377 button = xxxxx
378 prog = xine
379 repeat = 0
380 config = WindowReduce
381 end
382
383 C'est à vous de spécifier le nom de la télécommande, et à assigner le
384 bouton.
385
386
3873 QUE RESTE T'IL A DIRE ?
388
3893.1 Liberté, DVDs et autre choses
390
391 Xine est un logiciel libre. "Logiciel libre" est relatif au fait d'être
392 "open-source".
393 Cependant, la signification de "logiciel libre" dépasse ce cadre : cela
394 exprime la liberté des utilisateurs des logiciels. Si vous avez le temps,
395 merci de lire ce que la Free software foundation écrit à propos de la
396 liberté et des logiciels :
397
398 => http://www.gnu.org/philosophy/free-sw.html
399
400 Il y a une réelle menace à la liberté quant on en vient aux DVDs :
401 l'industrie cinématographique fait d'immenses efforts pour restreindre la
402 lecture des DVDs dans des machines controllées. La plupart des DVDs
403 actuellement vendus le sont de manière propriétaire - et dans certains pays
404 (notamment aux USA), il peut être illégal de les décrypter - même dans le
405 cadre d'une lecture privée.
406 Heureusement une majorité de gens conviendront que c'est une manière
407 très discutable de traiter les consommateurs. L'équipe du projet Xine
408 condamne ces efforts de l'industrie du cinéma, dans leur essai d'enrayement
409 de la perte de ventes par le démonstration d'un manque de respect vis à vis
410 de tous les clients honnêtes.
411 Cependant, l'équipe du projet Xine est contre le fait de briser les lois
412 existantes.
413 Personne ne sait exactement si il est effectivement illegal quelque part
414 d'écrire, de posséder et d'utiliser des logiciels pour la lecture de DVDs
415 encryptés. Mais comme c'est un point obscur (qui semble potentiellement
416 très dangereux), Xine ne contient aucun code susceptible de décrypter les
417 DVDs. Il semble, cependant, que des parties tierces travaillent sur de
418 telles extensions. Peut-être dans des endroits ou il est légal d'utiliser
419 ces programmes. Quoi qu'il en soit, vous serez incapable de lire des DVDs
420 encryptés avec Xine tel-quel. Merci de noter que ce n'est ni un bug, ni
421 une fonctionnalité manquante, mais bien un problème légal original. Il
422 serait bienvenue de résoudre le problème (par exemple en convaincant
423 l'Amérique et/ou l'industrie cinématographique qu'ils sont vraiment gênants
424 et injustes envers les clients, aussi bien qu'envers les utilisateurs et
425 les développeurs de logiciels libres, mais l'inclusion du code de
426 décryptage de DVDs dans Xine ne résoudra pas le problème.
427
428
4294 Contacter le projet Xine
430
431 Le site web du projet Xine est :
432
433 => http://xine.sourceforge.net
434
435 Les retours ou offres d'aide sont grandement appréciés, merci de contacter :
436
437 La mailing list des utilisateurs Xine <xine-user@lists.sourceforge.net>
438
439
README_it
1
2 ----------------------
3 xine
4 ----------------------
5
6un riproduttore video 'free'
7
8
9
10scopo di questo documento:
11--------------------------
12
13questa è la documentazione utente finale per xine-lib e xine-ui. Troverai
14ulteriore documentazione nella cartella doc/ di entrambi i pacchetti.
15
16a proposito di xine:
17--------------------
18
19xine è un riproduttotre video gratuito con licenza GPL per sistemi tipo-unix.
20Supportiamo flussi mpeg elementari (solo audio/video, per esempio files mp3) e
21files AVI (usando dll codec win32).
22
23xine riproduce i dati video ed audio del flusso e sincronizza la riproduzione
24d'entrambi. In base alle proprietà del flusso, la riproduzione necessiterà di
25più o meno potenza di calcolo; si è verificata una riproduzione perfetta per
26l'mpeg-2 su un sistema 400 MHz P II.
27
28xine può riprodurre Video CD, SVCD e DVD direttamente. Sfortunatamente
29lo status legale della riproduzione di DVD crittati/bloccati è incerto in certi
30paesi, sicchè non possiamo includere codice di sblocco/decrittazione DVD in
31xine. Per riprodurre tali DVD avrai bisogno di programmi esterni o qualcosa come
32uno xine_dvd_plugin che possa gestire l'autenticazione/derimescolamento del DVD.
33
34In xine 0.5 abbiamo introdotto una nuova architettura che supporta plugin
35flessibili per vari compiti, sicchè in futuro potremo supportare vari altri
36tipi di flussi e dispositivi d'uscita.
37
38
39piattaforme supportate / prerequisiti:
40--------------------------------------
41
42- a xine occorre un server X11 di 15, 16, 24 o 32 bit di profondità per
43 l'uscita video.
44- aaxine usa aalib per l'uscita e può funzionare su quasi tutti i terminali.
45- xine può rilevare ed utilizzare le estensioni MIT X video ed X shared memory
46 per una miglior resa in riproduzione.
47- se non riesci ad eseguire Xv sulla tua piattaforma, dovresti usare una
48 profondità di colore di 16 bpp per una miglior velocità. Xv sembra funzionare
49 bene a 16 e 24 bpp.
50- se hai un adattatore grafico mga 200 / 400 puoi usare opzionalmente il driver
51 di uscita video sybcfb/teletux. Vedi README.syncfb per i dettagli.
52- per la riproduzione audio sono supportati SS, ALSA, ESD ed ARTSD.
53- per costruire xine sono richieste versioni abbastanza recenti di
54 gmake, gcc e binutils.
55- xine-ui richiede libpng e zlib
56
57xine è stato finora usato con successo sui seguenti sistemi:
58
59- Linux su un Pentium III 667
60 con XFree86 4.01 su una nVidia Riva TNT 2
61- Linux su un Pentium II 400
62 con XFree86 3.3.6, 4.0, 4.01 e 4.02 su una nVidia Riva TNT
63- FreeBSD 4.1-Release su un Celeron 400
64 con XFree86 3.3.6 e 4.0.1 su una Matrox G400
65- Linux su un Pentium 120 (no MMX)
66 con XFree86 3.3.5 su una Trident 9660
67- Linux su un AMD K6-266
68 con XFree86 3.3.5 su una ATI AIW M64-8Mb PCI
69- Linux su un AMD K6-III 450
70 con XFree86 3.3.6 su una ATI RageII 8MB
71- Linux su un Celeron 633
72 con XFree86 4.0.1 su una ATI AIW Rage128-16MB
73- Linux su un Amd K7@550
74 con Xfree 4.0.1 su una Ati Rage 128 16 Mb
75 (Xv funziona su questa configurazione con drivers dal progetto GATOS)
76- Linux su un Celeron 667
77 con XFree86 4.0.2 su una Riva TNT 16Mb
78 (Xv funziona su questa configurazione con drivers proprietari
79 NVidia versione 0.9.5).
80- Linux su un Amd K6-2@475
81 con XFree86 4.1.0 su una 3dfx voodoo3 2000 PCI 16Mb
82- Solaris 8 on Intel
83 con Xsun su una ATI Xpert@Work & Xpert98 (3D RAGE PRO)
84 vedi README.solaris per ulteriori informazioni
85
86non-intel platforms:
87- Solaris 8 su uno SPARC
88 con Xsun su un Creator-3D framebuffer
89 vedi README.solaris per ulteriori informazioni
90- IRIX su MIPS
91 il supporto audio support non è ancora disponibile per questa configurazione
92
93uso:
94------
95
96Puoi eseguire xine senza alcun parametro su riga comando, o puoi specificare
97uno o più flussi di input direttamente. xine prova a rilevare se può usare
98l'estensione Xv e ricadere su XShm, ma questa rilevazione può fallire.
99Specifichi il plugin di output video usando l'opzione "-V", per esempio:
100
101xine -V XShm
102
103forzerà xine ad usare XShm o puro X11.
104
105Se vuoi mandare il suono su una rete con ESD, imposta la variabile d'ambiente
106ESPEAKER prima di avviare xine.
107
108Il flusso di input può essere un nome di file o qualcosa che chiamiamo un
109"MediaResourceLocator" MRL, che è simile ad un'URL. Per prima cosa
110occorre specificare una sorgente di input seguita da "://" e da un
111identificatore di una sorgente di input specifica.
112Quali sorgenti di input puoi usare dipende dai plugin di input che hai
113(per file semplici puoi omettere l'identificatore della sorgente di input).
114Prova
115
116$ xine --help
117
118per ottenere le note di utilizzo complete.
119
120xine supporta il protocollo xdnd (Versione 3), sichhè se hai un'applicazione
121di navigazione file che supporti quel protocollo (ad esempio gmc), puoi
122'droppare' files video su xine per la riproduzione.
123
124Esempio di riproduzione della traccia 3 da un VCD:
125
126$ xine vcd://3
127
128Esempio di accesso diretto al DVD:
129
130$ xine dvd://VTS_01_1.VOB
131
132Acceleratori tastiera:
133----------------------
134
135Tasto Azione
136
137INVIO riproduce
138Spazio, P pausa
139Sù/Giù avanti veloce / avanti piano
140
1410 va all'inizio del flusso corrente
1421-9 va al 10-90% del flusso corrente
143Sinistra/Destra va -+ 15 secondi (+CTRL: 60 secondi)
144PgUp/Prior salta all'elemento precedente della lista di riproduzione
145PgDown/Next salta all'elemento successivo della lista di riproduzione
146
147F cambia da/a modalità a schermo pieno
148A cambia il rapporto dell'aspetto (AUTO/16:9/4:3/DVB)
149I cambia da/a modalità interlacciata
150< > modifica l'ampiezza della finestra di output
151+ - cambia il canale audio
152, . cambia il canale dei sottotitoli
153n m aggiusta il sync a/v
154Home resetta del sync a/v
155
156Q esce
157
158altri verranno.
159
160Clicca con il tasto destro sulla finestra video per rendere il pannello
161(in)visibile.
162
163selezione dei canali audio:
164---------------------------
165
166Specifica l'opzione -a per selezionare la traccia audio scelta:
167
168xine -a 3 test.mpg
169
170riproduce la terza traccia audio disponibile (e il video, ovviamente).
171
172selezione dei sottotitoli:
173--------------------------
174
175I sottotitoli sono integrati in tracce differenti, come l'audio. In generale,
176la traccia 0 è il linguaggio di default dei sottotitoli. Usa l'opzione -u
177per selezionare la traccia dei sottotitoli desiderata:
178
179xine -u 0 test.vob
180
181visualizza i sottotitoli dal flusso 0.
182
183controllare xine attraverso CORBA:
184----------------------------------
185
186[ FIXME: non si sa se il supporto corba funzioni fino a xine 0.5 ]
187
188xine implementa un'interfaccia CORBA server per abilitare il controllo remoto e
189lo scripting. Per questo occorre ORBit, che dovrebbe già essere installato,
190se usi GNOME. Altrimenti lo si può ottenere da:
191
192 http://orbit-resource.sourceforge.net/
193
194Qualsiasi versione di ORBit >= 0.4.0 dovrebbe funzionare bene.
195
196Per abilitare l'interfaccia CORBA, devi fornire l'argomento "--enable-corba"
197allo script ./configure e ricompilare xine.
198
199La definizione dell'interfaccia xine server si può trovare in "corba/xine.idl"
200che viene installato in "/usr/share/idl/xine.idl" per default.
201
202Per comunicare con xine attraverso CORBA, ti serve il suo IOR (Interoperable
203Object Reference). All'avvio, xine lo scrive nel file ~/.xine.ior
204da dove lo puoi leggere. Se il name service ORBit è in funzione, anche xine
205si registra sotto il nome "Xine". Sfortunatamente, il name server ORBit non è
206attivato di default. Devi lanciarlo manualmente in questo modo:
207
208 orbit-name-server >/tmp/name-service-ior &
209
210Vedi la documentazione di ORBit per ulteriori informazioni.
211
212Sono forniti due programmi client d'esempio:
213 1. "xine-remote" è un client d'esempio scritto in C che può essere usato per
214 mandare comandi di riproduzione/stop/pausa ad una istanza attiva di xine
215 2. "example.py" è un piccolo script Python che dimostra come controllare
216 semplicemente xine da un linguaggio di scripting
217
218usare LIRC con xine:
219---------------------
220
221xine può essere controllato da remoto con un ricevitore a infrarossi.
222Per questo, dovresti avere installato LIRC (http://www.lirc.org),
223dovresti ottenere l'immagine CVS più recente se usi i kernel Linux più recenti
224(delle serie 2.2 o 2.4).
225
226Dovresti aggiungere alcuni ingressi nel tuo file ~/.lircrc, per esempio così:
227begin
228 remote = SAMSUNG
229 button = Button_Play
230 prog = xine
231 repeat = 0
232 config = PLAY
233end
234begin
235 remote = SAMSUNG
236 button = Button_Src
237 prog = xine
238 repeat = 0
239 config = DVD
240end
241begin
242 remote = SAMSUNG
243 button = Button_1
244 prog = xine
245 repeat = 0
246 config = 10%
247end
248...
249
250Le stringhe di comandi validi sono:
251
252 - per uscire:
253 quit
254 - per impostare la posizione corrente nel flusso di riproduzione attuale:
255 0%, 10%, 20%, 30%, 40%, 50%, 60%, 70%, 80%, 90%
256 - per riprodurre o interrompere:
257 play
258 - per sospendere:
259 pause
260 - per espellere:
261 eject
262 - per il MRL successivo/precedente nella lista di riproduzione:
263 next, prev
264 - per la selezione della traccia audio successiva/precedente:
265 audio+, audio-
266 - per la selezione del sottotitolo successivo/precedente:
267 spu+, spu-
268 - per ottenere la lista di riproduzione da un DVD/VCD:
269 dvd, vcd
270 - per nascondere/mostrare la GUI, la finestra di uscita video:
271 hidegui, hideoutput
272 - per invertire fra l'uscita video in finestra <-> a schermo pieno
273 fullscr
274
275Tutti i comandi non sono sensibili al maiuscolo/minuscolo.
276
277software utilizzato:
278--------------------
279
280xine usa software dai seguenti progetti software free:
281
282- liba52 di Aaron Holtzman / Michel Lespinasse
283- libmpeg2 di Aaron Holtzman / Michel Lespinasse
284- libmpg123 del progetto mpg123 di Michael Hipp
285 (vedi http://www.mpg123.de/)
286- libmad di Robert Leslie
287- varii decoders dal progetto ffmpeg di Fabrice Bellard
288
289... senza questi grandi pezzi di software naturalmente xine non sarebbe dove
290è adesso.
291
292anche grandi ringraziamenti al Progetto Linux Video e DVD "LiViD"
293(http://www.linuxvideo.org/), da dove sono venute le idee originali per ili
294riproduttore video xine.
295
296sviluppatori attivi di xine:
297----------------------------
298
299 maggior sviluppatore xine:
300 Guenter Bartsch
301
302 varii suggerimenti, bachi e correzioni di costruzione, il plugin alsa, la gui
303 Daniel Caujolle-Bert
304
305 contribuzione di grandi modifiche per libmpeg2 e liba52:
306 Michael Lespinasse
307
308 port verso solaris e tantissime correzioni di bachi
309 Juergen Keil
310
311 ... più vari altri contributori, vedi il file AUTHORS
312
313
314contattare il progetto xine:
315----------------------------
316
317 il sito web del progetto xine è
318
319 http://xine.sourceforge.net
320
321 Rreazioni od offerte d'aiuto sono grandemente apprezzate, contatta
322 per piacere
323
324 la mailing list utente di xine
325
326---
327Translator: Marco Solari <marcosolari@libero.it>
328
README_pl
1 ++++++++++++++++++++ ++++++++++++++++++++++++
2 XINE: wolny odtwarzacz wideo
3 ++++++++++++++++++++ ++++++++++++++++++++++++
4
5
6 SPIS TREŚCI
7 -=========-
8
9 1 DOKUMENTACJA
10 1.1 Zakres tego dokumentu
11
12 2 O XINE
13 2.1 Wymagania i wspierane platformy
14 2.2 Użyte oprogramowanie
15 2.3 Programiści xine
16 2.4 Użytkowanie
17 2.4.1 Skróty klawiaturowe
18 2.4.2 Wybieranie ścieżki dźwiękowej
19 2.4.3 Wybieranie napisów
20 2.4.4 LIRC
21 2.4.5 Ustawianie opcji konfiguracyjnych xine z linii poleceń
22
23 3 CO NIE ZOSTAŁO JESZCZE POWIEDZIANE
24 3.1 Wolność, DVD i te sprawy...
25
26 4 Kontakt z projektem xine
27
28
29
30
31
32
33
341 DOKUMENTACJA
35
361.1 Zakres tego dokumentu
37
38 To jest dokumentacja użytkownika końcowego xine-lib i xine-ui.
39 Więcej informacji znajdziesz w katalogu doc/ obydwu pakietów.
40
41 Proszę również rzucić okiem na FAQ dołączany do pakietu xine-ui
42 który może już zawierać odpowiedzi na Twoje pytania.
43
44
452 O XINE
46
47 xine to wolny, na licncji GPL, odtwarzacz wideo dla systemów
48 unixowych. Obsługuje strumienie mpeg-2 i mpeg-1 (zawierające dźwięk
49 + obraz), elementarne strumienie mpeg (tylko dźwięk/obraz, np.
50 pliki mp3) jak i pliki typu AVI (używając kodeków dll win32) oraz
51 strumienie typu Vorbis OGG. Jest pewne wsparcie dla sekwencji
52 quicktime (ale większość kodeków audio i wideo jest chronionych
53 przez prawo własności intelektualnej i te nie są wspierane).
54
55 xine odtwarza z sekwencji obraz i dźwięk i synchronizuje je.
56 Zależnie od właściwości sekwencji odtwarzanie będzie wymagało
57 więcej lub mniej czasu procesora, pełna częstotliwość wyświetlania
58 ramek sekwencji mpeg-2 udała się już przy procesorze
59 Pentium II 400 MHz.
60
61 xine może odtwarzać VideoCD, CD, SVCD i bezpośrednio DVD. Niestety
62 status prawny zaszyfrowanych/zablokowanych dysków DVD nie jest
63 jasny w niektórych państwach, więc nie możemy dodać do xine żadnego
64 kodu odszyfrowującego DVD. Aby odtwarzać takie DVD będziesz
65 potrzebować zewnętrznych programów lub czegoś na kształt wtyczki do
66 xine 'xine_dvd_plugin', który może obsłużyć uwierzytelnianie/
67 odszyfrowanie DVD.
68
69 Grupa autorów projektu xine odmawia jakiejkolwiek odpowiedzialności
70 za używanie programu xine w ten sposób.
71
72 Poczynając od wersji xine 5.0, zaimplementowana została architektura
73 pozwalająca na elastyczne używanie wtyczek, dzięki którym możliwe
74 będzie w przyszłości wsparcie wielu innych typów sekwencji i
75 urządzeń wyjściowych.
76
772.1 Wymagania i wspierane platformy
78
79 - xine wymaga serwera X11 dla wyjścia obrazu (z 8, 15, 16, 24 lub 32
80 - bitową głębią kolorów).
81 - xine wykrywa i używa rozszerzeń MIT X video i X shared memory dla
82 lepszej wydajności.
83 - jeśli nie możesz uruchomić Xv na twojej platformie, powinieneś
84 użyć 16bpp głębi kolorów dla uzyskania lepszej wydajności.
85 Xv wydaje się całkiem dobrze pracować z każdą głębią kolorów.
86 - jeżeli masz kartę graficzną mga 200/400 możesz użyć jako opcji
87 wyjścia - wtyczki syncfb/teletux. Szczegóły zobacz w README.syncfb
88 - odtwarzanie audio jest wspomagane przez OSS, ALSA, ESD i ARTSD.
89 - aaxine używa bibliotek aalib i może pracować na prawie każdym
90 terminalu.
91 - żeby skompilować xine potrzebujesz w miarę nowych wersji gmake, gcc
92 i binutils.
93
94 xine powinien pracować na każdym nowszym komputerze kompatybilnym
95 z architekturą i386 (pentium i lepsze) używając GNU/Linux lub FreeBSD.
96 Zależnie od typu odtwarzanej sekwencji wideo, będziesz potrzebować
97 więcej lub mniej mocy procesora, dla płynnago odtwarzania. Odtwarzanie
98 DVD może dobrze działać już na systemach opartych o Pentium II 400Mhz
99 (lub równoważnych). W tym równaniu jest jednak zbyt wiele niewiadomych
100 więc ta granica może się wahać.
101
102 Pomyślnie przetestowane karty graficzne (używające Xv) dla PC to:
103 nVidia Riva TNT (oryginalne sterowniki NVidii "closed-source"),
104 nVidia Riva TNT 2, Matrox G400, ATI AIW Rage128-16MB,
105 3dfx voodoo3 2000 PCI 16Mb
106
107 Następujące karty zostały zgłoszone jako działające, ale nie jest
108 jasne czy używają Xv czy nie (proszę zwrócić się na listę
109 dyskusyjną użytkowników xine):
110 Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.
111
112 xine powinien dać sobię radę z odtwarzaniem obrazu na każdym
113 działającym x-serwerze z każdą kartą graficzną, ale z dużo gorszą
114 wydajnością niż z rozszerzeniem Xv.
115
116 Dodatkowo, xine pracuje na i386-solaris, na maszynach sparc
117 używających linuxa lub solarisa (Creator-3D działa), zobacz
118 README.solaris dla dodatkowych informacji. Również wspierane:
119 niektóre systemy powerpc używające linuxa oraz IRIX na procesorach
120 MIPS.
121
122 I ostatnie, lecz nie mniej ważne: zgłoszono również poprawnie
123 działający xine na procesorach Alpha, IA-64 i S/390.
124
1252.2 Użyte oprogramowanie
126
127 xine używa oprogramowania z następujących zewnętrznych projektów
128 wolnego oprogramowania:
129
130 - liba52 Aarona Holtzmana i Michaela Lespinasse
131 - libmpeg2 Aarona Holtzmana i Michaela Lespinasse
132 - libmad Roberta Lesliego
133 - libffmpeg Fabrice Bellard'a
134
135 Bez tych świetnych programów xine nie byłoby oczywiście tym
136 czym jest teraz.
137
138 Również wielkie podziękowania dla Linux Video and DVD Project
139 "LiViD" skąd oryginalny pomysł wolnego i darmowego
140 odtwarzacza DVD.
141
142 => http://www.linuxvideo.org/
143
1442.3 Programiści xine
145
146 główny programista xine
147 Guenter Bartsch <guenter@users.sourceforge.net>
148
149 różne sugestie, poprawki błędów i kompilacji, alsa plugin,
150 interfejs użytkownika
151 Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
152
153 wiele poprawek, wykrywanie prędkości transferu, programowa eliminacja
154 przeplotu, masa uaktualnień libwin32
155 Miguel Freitas <miguel@cetuc.puc-rio.br>
156
157 moduł wyświetlania obrazu teletux/syncfb, różne poprawki, sterowniki alsa
158 Joachim Koenig <Joachim.Koenig@gmx.net>
159
160 programowanie liba52/libmpeg2
161 Michael Lespinasse <walken@zoy.org>
162
163 pakiety dla Debiana, wsparcie dla użytkowników
164 Siegfried Langauf <siggi@users.sourceforge.net>
165
166 Oraz wielu innych, zobacz plik xine-lib/AUTHORS
167
1682.4 Użytkowanie
169
170 Możesz uruchomić xine bez żadncyh opcji lub podając jedną lub
171 więcej sekwencji wejściowych bezpośrednio. xine testuje możliwość
172 użycia rozszerzenia Xv i jeśli nie - sam użyje XShm, test ten może
173 jednak zawieść. Możesz określić wyjście wideo używając opcji
174 "-V", np:
175
176 xine -V XShm
177
178 zmusi xine do użycia XShm albo zwykłego X11.
179
180 Jeśli chcesz wysłać dźwięk przez sieć za pomocą ESD, ustaw zmienną
181 środowiskową ESPEAKER przed uruchomieniem xine.
182
183 Sekwencją wejścia może być nazwa pliku lub coś co nazywamy
184 "MediaResourceLocator" MRL, który wygląda podobnie do URLa.
185 Najpierw podaj źródło wejścia przed "://" następnie specyficzny
186 identyfikator źródła wejścia. Jakich źródeł wejścia możesz użyć,
187 zależy od tego jakie wtyczki wejścia zainstalowałeś (dla zwykłych
188 plików możesz pominąć identyfikator źródła wejścia).
189
190 Spróbuj
191
192 $ xine --help
193
194 by otrzymać pełną informację o użytkowaniu.
195
196 xine używa protokołu xdnd (wersja 3) więc jeśli masz wyszukiwarkę
197 plików z nim współpracującą (np gmc) możesz po prostu "przeciągnąć"
198 pliki wideo na xine by je odtworzyć.
199
200 Odtwarzanie scieżki 3 z VCD:
201
202 $ xine vcd://3
203
204 Przykład bezpośredniego dostępu do DVD:
205
206 $ xine dvd://VTS_01_1.VOB
207
2082.4.1 Skróty klawiaturowe
209
210 Klawisz Akcja
211
212 [RETURN] odtwórz
213 [SPACJA] stop klatka
214 [Góra]/[Dół] szybki podgląd / zwolnienie
215
216 0 znajdź początek aktualnej sekwencji
217 1-9 przejdź do 10-90% aktualnej sekwencji
218 [Lewo]/[Prawo] przeskocz -+ 15 sec (+CTRL: 60 sec)
219 [PgUp]/[Wstecz] przeskocz do poprzedniej pozycji na liście
220 [PgDown]/[Naprzód] przeskocz do następnej pozycji na liście
221
222 f Przełącz do trybu pełnoekranowego/okna
223 a przełącz proporcje ekranu (AUTO/16:9/4:3/DVB)
224 i włącz tryb przeplotu
225
226 z / Shift-Z ZOOM powiększanie / pomiejszanie obrazu.
227 dodaj Ctrl aby powiększyć w pionie lub Meta aby
228 powiększyć w poziomie
229
230 "<",">" zmodyfikuj rozmiar okna wyjświetlania
231 + - zmień kanał audio
232 , . zmień kanał napisów
233 n m wyreguluj synchronizację a/v
234 [HOME] zresetuj synchronizację a/v
235
236 [INSERT] przełącz widzialność kursora myszki w oknie obrazu
237
238 q zakończ
239
240 h ukryj okno obrazu (użyteczne przy odtwarzaniu mp3)
241
242 więcej wkrótce ;-)
243
244 Kliknij prawym przyciskiem na okno wyjścia wideo (lub naciśnij "G")
245 aby ukryć panel.
246
247 Zmienianie skrótów:
248 Możesz również zmienić jeden/kilka/wszystkie skróty. Do tego musisz
249 mieć plik keymap w swoim katalogu $HOME/.xine/. Składnia wpisów do
250 tego pliku wygląda tak:
251
252 WindowReduce {
253 key = less
254 modifier = none
255 }
256
257 Wartość "key" powinna odpowiadać opisowi klawiszy X11 (zobacz poniżej).
258 Modyfikator może być:
259 - 'none' brak modyfikatora,
260 - 'control' (lub 'ctrl') klawisz "Control",
261 - 'meta' (or 'alt' on PC) dla klawisza "meta",
262 - 'mod3' lub 'mod4' lub 'mod5' dostępne tylko na niektórych
263 platformach.
264
265 Modyfikatory mogą być mieszane, oddzielone przecinkiem:
266
267 WindowReduce {
268 key = less
269 modifier = control, alt
270 }
271
272 Nie wpisanie lini z modyfikatorem, będzie równoznaczne z wybraniem
273 modyfikatora 'none'.
274
275 Możesz dodać również aliasy dla skrótów, taki:
276
277 Alias {
278 entry = Pause
279 key = p
280 }
281
282 będzie oznaczał dodanie innego skrótu do wpisu 'Pause' przez
283 naciśnięcie 'p'. Możesz również dodać sekcję modyfikatora
284 (zobacz poniżej). Jeśli nie - modyfikator pozostanie taki
285 jak dla oryginalnego klawisza. ('Pause' w tym przypadku).
286
287 Skanowanie nazw klawiszy X11:
288 Aby poznać nazwę klawisza X11, możesz użyć polecenia 'xev', który jest
289 dostarczany wraz z pakietami X11. Uruchomienie 'xev' z xterm'a
290 uaktywnia małe okno, wtedy naciśnij klawisz którego nazwę chcesz poznać.
291
292 Wtedy w oknie xterm'a otrzymasz coś takiego:
293
294 ...
295 KeyRelease event, serial 27, synthetic NO, window 0x3200001,
296 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
297 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
298 ^^^^^^^^
299 To jest właśnie poszukiwana nazwa.
300 Jeśli chodzi o przyciski myszy, aby używać na przykład kółko myszy,
301 musisz wyśledzić który przycisk będzie asygnowany do funkcji, używając xev:
302
303 ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
304 root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
305 state 0x1000, button 5, same_screen YES
306 ^^^^^^^^
307 To jest ten przycisk
308
309 W tym przypadku musisz ustawić "key = XButton_5". Przycisk modyfikacyjny
310 jest również wspierany z przyciskami myszy.
311
312 Wyświetlanie obecnych/przemapowanych skrótów.
313 Możesz użyć 'xine --keymap' lub 'xine --keymap=default' aby wyświetlić
314 domyślne skróty. Możesz przekierować rezultat do pliku, który może już
315 zostać plikiem ~/.xine/keymap.
316
317 Aby zobaczyć rezultaty zmiam w mapowaniu klawiszy, wpisz po prostu:
318
319 xine --keymap=remapped
320
3212.4.2 Wybieranie ścieżki dźwiękowej
322
323 Podaj opcję "-a" aby wybrać wymaganą ścieżkę audio:
324
325 xine -a 3 test.mpg
326
327 odtworzy 3-cią dostępną ścieżkę audio (wraz z obrazem, oczywiście).
328
329 Alternatywnie możesz użyć interfejsu użytkownika do selekcji
330 ścieżki audio.
331
3322.4.3 Wybieranie napisów
333
334 Napisy są dołączane w oddzielnych ścieżkach, tak jak dźwięk.
335 Zazwyczaj ścieżka 0 to napisy w domyślnym języku. Użyj
336 opcji "-u" aby wybrać potrzebną ścieżkę napisów:
337
338 xine -u 0 test.vob
339
340 wyświetli napisy ze ścieżki 0.
341
342 Alternatywnie możesz użyć interfejsu użytkownika do selekcji
343 ścieżki napisów.
344
3452.4.4 LIRC
346
347 xine może być sterowany zdalnie przez podczerwień. Do tego potrzebujesz
348 zainstalowanego LIRC'a (http://www.lirc.org).
349
350 Musisz dodać kilka linii do twojego ~/.lircrc:
351 begin
352 remote = SAMSUNG
353 button = Button_Play
354 prog = xine
355 repeat = 0
356 config = PLAY
357 end
358 begin
359 remote = SAMSUNG
360 button = Button_Src
361 prog = xine
362 repeat = 0
363 config = DVD
364 end
365
366 xine może samo wygenerować szablon wpisów, jeśli użyjesz
367 'xine --keymap=lirc'. Możesz przekierować wyjście komendy do
368 pliku aby dopolerować ustawienia.
369
370 Każdy wpis będzie wyglądał tak:
371
372 # Reduce the output window size.
373 begin
374 remote = xxxxx
375 button = xxxxx
376 prog = xine
377 repeat = 0
378 config = WindowReduce
379 end
380
381 Do Ciebie należy wybór pilota i przypisanie przycisków.
382
383 Playlist:
384 ---------
385 Aby odnaleźć listę odtwarzania z danej wtyczki wejścia, możesz użyć
386 specjalnego klucza 'PlaylistFrom:', i następującej po nim nazwy
387 wtyczki (takiej samej jak na przycisku panela):
388
389 # Odnajdywanie listy odtwarzania z wtyczki NAV
390 begin
391 remote = xxxxx
392 button = xxxxx
393 prog = xine
394 repeat = 0
395 config = PlaylistFrom:NAV
396 end
397
3982.4.5 Ustawianie opcji konfiguracyjnych xine z linii poleceń
399
400 Możesz ustawić każdą opcję (zobacz README.config_en) z linii
401 poleceń aby obejść wartości ustawione w $HOME/.xine/config.
402
403 Na przykład możesz zrobić coś takiego
404
405 xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1
406
407 aby zmienić vcd_device między odtworzeniem dwóch mrls.
408
409 Te ustawienia opt: nie będą zachowane w pliku konfiguracyjnym,
410 gdyż są traktowane jako tymczasowe.
411
412
4133 CO NIE ZOSTAŁO JESZCZE POWIEDZIANE
414
4153.1 Wolność, DVD i te sprawy...
416
417 xine jest wolnym oprogramowaniem. "wolne oprogramowanie"
418 jest w pewnym stopniu związane z "otwatymi źródłami". Ale
419 znaczenie "wolnego oprogramowania" idzie dużo dalej: jest
420 ono związane z wolnością jego użytkowników.
421 Jeśli masz czas, proszę przeczytaj, co "Free Software Foundation"
422 pisze na ten temat:
423 http://www.gnu.org/philosophy/free-sw.pl.html
424
425 Bardzo specyficznym problemem jest wolność oprogramowania DVD:
426 przemysł filmowy dopełnia wszelkich możliwych wysiłków aby ograniczyć
427 odtwarzanie płyt DVD do kontrolowanych urządzeń. Większość obecnie
428 sprzedawanych płyt DVD jest zaszyfrowana (zablokowana) i w niektórych
429 krajach (zwłaszcza w USA), nielegalnym jest odszyfrowywanie
430 (odblokowywanie) ich, nawet do celów prywatnego użytku (oglądnięcia).
431 Mamy nadzieję że większość ludzi zgodzi się z faktem, że jest to
432 problematyczny sposób traktowania klientów. Grupa Projektu xine potępia
433 te wysiłki przemysłu filmowego - próbując tą drogą zapobiegać stratom
434 w sprzedaży, z pewnością okazuje brak szacunku do wszystkich swoich
435 uczciwych klientów. Z drugiej jednak strony, Grupa Projektu xine jest
436 przeciwna łamaniu istniejącego prawa. Nikt aktualnie nie wie dokładnie
437 czy gdziekolwiek na świecie jest legalne pisanie, posiadanie i używanie
438 oprogramowania do OGLĄDANIA zaszyfrowanych płyt DVD. Dopóki ten temat
439 pozostaje niejasny (i wydaje się potencjalnie bardzo niebezpieczny),
440 xine nie będzie zawierać żadnego specyficznego kodu do odblokowywania DVD.
441 Wydaje się jednak, że osoby trzecie pracują nad takimi rozszerzeniami.
442 Możliwe że są miejsca gdzie jest to legalne. Którekolwiek z powyższych
443 dotyczy Ciebie - nie będziesz w stanie odtwarzać zaszyfrowanych DVD
444 za pomocą "czystego" programu xine. Proszę zauważyć że nie jest to
445 "błąd" albo braki w funkcjonalności, ale czysto prawny problem.
446 Byłoby wspaniale rozwiązać go (np. przez przekonanie ameryki i/lub
447 przemysłu filmowego, że są naprawdę nudni i niepotrzebnie nie w porządku
448 wobec klientów jak i użytkowników i programistów wolnego
449 oprogramowania), ale dodawanie kodu odszyfrowującego DVD do xine
450 nie rozwiąże tego problemu.
451
4524 Kontakt z projektem xine
453
454 Strona domowa projektu xine:
455
456 http://xine.sourceforge.net
457
458 Informacja zwrotna, lub chęć pomocy mile widziana, kontakt:
459
460 lista dyskusyjna użytkowników xine: xine-user@lists.sourceforge.net
461
462
463 ################################
464 # Tłumaczenie: Barłomiej Muryn #
465 # mailto: _4ever_@irc.pl #
466 ################################
467
468
README_uk
1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 XINE: Вільно розповсюджуваний відео плейєр.
3 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
4
5
6Терміни:
7
8 ГІК - графічний інтерфейс користувача (GUI).
9 ЧАП - часті питання.
10 ALSA - advanced Linux sound architecture (покращена звукова система для Linux).
11 CSS - content scrambling system (система шифрування змісту).
12 CVS - concurent version system (система конкурентних файлів).
13 dll - dynamic link library (модулі бібліотек динамічного завантаження (Win32)).
14 DMA - direct memory access (режим прямого доступу до пам'яті; дозволяє
15 суттєво прискорити обмін інформ. для визнач. пристрою без участі процесора).
16 DVD - digital video disc (формат компакт дисків для різноманітної інформації).
17 gcc - GNU C compiler (компілятор мови програмування C).
18 MPEG - moution picture encoding group (стандарт по кодуванню відео,
19 який розробляє однойменна група по стандартизації).
20 MRL - media resource locator (локатор (адреса) медіа ресурсу).
21 MTRR - memory type range registers (регістри для встановлення діапозону пам'яті).
22 PID - process identifier (ідентифікатор (номер) процесу).
23 VCD - Video CD (старий формат цифрового відео на компакт-дисках).
24 URL - universal resource locator (універсальний локатор (адреса) ресурсу).
25 Xv - eXtension video (модуль розширення Xwindow для прискорення графіки).
26 Xshm - Xwindows shared memory (графічний режим з пам'яттю спільного доступу).
27
28
29
30 Індекс
31 -===-
32
33 1 ДОКУМЕНТАЦІЯ
34 1.1 Мета цього документу
35
36 2 О XINE
37 2.1 Підтримувані платформи і системні вимоги
38 2.2 Вжите програмне забезпечення
39 2.3 Розробники Xine
40 2.4 Використання.
41 2.4.1 Ключові клавіші.
42 2.4.2 Вибір аудіо каналів
43 2.4.3 Вибір субтитрів
44
45 3 Ситуація навколо DVD
46 3.1 Свобода, DVD та інше ...
47
48 4 Контакти з проектом Xine
49
50
51
52
53-------
54
551 ДОКУМЕНТАЦІЯ
56
571.1 Мета цього документу
58
59 Це документація для кінцевого користувача по пакунках xine-lib та xine-ui.
60 Ви знайдете більше документації в директорії /doc цих пакунків.
61
62 Будь-ласка уважно прочитайте ЧАП, що інтегрований в xine-ui (ГІК),
63 який вже може мати відповідь на Ваші питання.
64
652 Про XINE
66
67 Xine - це відео плейєр для Unix систем (є також порт для Windows), який
68 вільно розповсюджується під ліцензією GPL. Він підтримує MPEG-2 і MPEG-1
69 (аудіо + відео мультіплексія) потоки, елементарні MPEG потоки
70 (аудіо/відео тільки, тобто mp3 файли), AVI файли з різними відео форматами
71 (для деяких з них використовуя win32 dll модулі) і Vorbis OGG потоки.
72 Також є підтримка для quicktime потоків (але треба зауважити що
73 quicktime відео і аудіо кодеки є власністю Apple і підтримуються ще не повністю).
74
75 Хine програє відео і аудіо дані потоку і синхронізує їх в режимі реального часу.
76 Залежно від властивостів потоку, програвання буде вимагати більше чи менше
77 ресурсів процесора, повнокадровий MPEG-2 потік можна побачити
78 на сиcтемах з процесором K6-2 / P-II 400 МГц.
79
80 Xine може безпосередньо показувати Video CD, SVCD і DVD. Нажаль
81 правовий статус перегляду зашифрованих / заблокованих DVD невизначений
82 в деяких країнах, тому xine не містить ніякого DVD дешифруючого / розблоковуючого
83 коду. Щоб подивитися такі DVD, Вам потрібні зовнішні програми або щось подібне
84 на модуль xine_dvd_plugin, який здатний обробляти аутентифікацію / дешифрування DVD.
85
86 Учасники проекту Xine не несуть відповідальності за подібне використання Xine.
87
88 З версії 0.5 архітектура Xine дозволяє гнучко підключати різні модулі так, що
89 різні типи потоків і вихідних пристроїв можуть бути підтримані у майбутньому.
90
912.1 Підтримувані платформи і системні вимоги
92
93 - Xine потрібен X11 сервер для відео виходу
94 (8, 15, 16, 24 або 32 бітна кольорова глибина)
95
96 - Xine може знайти і використати MIT X відео і Xshm розширення
97 для кращого показу відео.
98
99 - якщо Ви не можете запустити розширенняt Xv на Вашій платформі, Ви повинні
100 використовувати 16 бітну кольорову глибину для збільшення швидкості.
101 Xv, здається, може працювати нормально при будь-якій кольоровій глибині.
102
103 - якщо Ви маєте графічний адаптер Matrox G200/G400/G450 , Ви можете опціально
104 використати драйвер відео виходу syncfb/teletux. Дивіться файл README.syncfb
105 для подробиць.
106
107 - для програвання аудіо підтримуються драйвера OSS, ALSA, ESD і ARTSD.
108 - aaxine використовує aalib для виходу і може бути запущеним на будь-якому терміналі
109 - щоб зкомпілювати xine потрібні стабільні програми GNU make, gcc і binutils .
110
111 Xine повинен запускатися на машинах класу Pentium і вище
112 (K5, K6, K6-2, K6-3, Duron, Athlon, Pentium II/III/IV, Celeron)
113 з системою GNU/Linux або FreeBSD. Залежно від типу відео
114 потоку Вам необхідно буде мати більше чи менше процесорних ресурсів
115 для якісного програвання. Як правило, DVD типово запускаються без проблем
116 на машинах класу Pentium II 400 МГц (або еквівалентних). На перегляд відео
117 впливає багато факторів, тому Ваші результати можуть відрізнятися.
118
119 Успішно протестовані наступні відео адаптери (в режимі Xv) для ПК:
120 nVidia Riva TNT (бінарні драйвера nvidia), nVidia Riva TNT 2, nVidia GeForce,
121 Matrox G400, ATI AIW Rage128-16МБ, ATI Radeon, 3DFX Voodoo3 2000 PCI 16МБ
122
123 Наступні карти, як було повідомлено, працюють, але не відомо
124 чи працюють вони з Xv, або тільки з XShm (будь-ласка надішліть звіт
125 до поштової розсилки xine-user@sourceforge.net):
126
127 Trident 9660, ATI AIW M64-8МБ PCI, ATI RageII 8МБ.
128
129 Xine повинен показувати відео на любому працюючому X сервері
130 з будь-яким графічним адаптером в режимі Xshm, але з гіршою якістю
131 ніж за допомогою розширення Xv.
132
133 Додатково, Xine запускається на платформі i386-solaris, sparc машинах з
134 Linux або Solaris (кадровий буфер Creator-3D має працювати), дивиться
135 README.solaris для докладної інформації. Також підтримуються: деякі
136 системі на базі PowerPC (з Linux) і IRIX на MIPS.
137
138 Xine, як було повідомлено, працює на платформі Alpha, IA-64 і S/390 машинах.
139
1402.2 Вжите програмне забезпечення.
141
142 Xine використовує код з наступних зовнішніх проектів з відкритим кодом:
143
144 - liba52, автори Аарон Хольцман (Aaron Holtzman) і Мішель Леспіназі (Michel Lespinasse)
145 - libmpeg2, автори Аарон Хольцман (Aaron Holtzman) і Мішель Леспіназі (Michel Lespinasse)
146 - libmad, автор Роберт Леслі (Robert Leslie)
147 - libffmpeg, автор Джерард Лантау (Fabrice Bellard)
148
149 Без цих чудових частин програмного забезпечення Xine звісно не став би
150 тим, чим він є сьогодні.
151
152 Також велика подяка розробникам проектів "Linux Video" і DVD Project "LiViD", звідки
153 прийшли оригінальні ідеї для реалізації Xine відео плейєра.
154
155 => http://www.linuxvideo.org/
156
1572.3 Розробники Xine
158
159 Головний розробник Xine: Гюнтер Бартщ (Guenter Bartsch)
160
161 Різні пропозиції, усунення вад і фіксація коду,
162 а також модуль alsa і ГІК: Даніель Коуджоль-Берт (Daniel Caujolle-Bert)
163
164 Програмування аудіо: Сігфрід Лангауф (Siegfried Langauf)
165
166 Співпраця при вдосконаленні бібліотек
167 libmpeg2 і libac3 з: Мішель Леспіназі (Michael Lespinasse)
168
169 Плюс інші розробники, дивиться файл xine-lib/AUTHORS
170
1712.4 Використання
172
173 Ви можете запустити Xine без будь-якого параметру з командного рядка,
174 або Ви можете безпосередньо вказати один або декілька вхідних потоків.
175 Xine спробує визначити, чи використовувати розширення Xv і якщо ні,
176 то переключиться на використання XShm, але ця проба може привести
177 до збою. Ви можете вказати модуль відео виходу за допомогою
178 опції "-V", наприклад:
179
180 xine -V XShm
181
182 примусить Xine вживати XShm режим або примітивний X11.
183
184 Якщо Ви бажаєте посилати звук через мережу з ESD, встановить
185 змінну оточення ESPEAKER перед запуском xine.
186
187 Вхідним потоком може бути ім'я файлу, або щось, що ми називаємо
188 "MediaResourceLocator" (або MRL), який подібний на URL. Спочатку
189 вкажіть вхідне джерело потоку за якім слідує "://" і далі
190 специфічний ідентифікатор вхідного джерела. Які вхідні джерела
191 Ви можете використовувати залежить від тих вхідних модулів,
192 що Ви маєте (для простих файлів Ви можете пропустити
193 ідентифікатор вхідного джерела).
194
195 Спробуйте:
196
197 xine --help
198
199 щоб отримати повну інформацію по використанню.
200
201 xine підтримує xdnd протокол (версію 3) тому, якщо Ви маєте файловий менеджер,
202 що підтримує цей протокол (наприклад gmc), Ви можете перетягувати візуально
203 файли на пиктограму Xine для перегляду.
204
205 Перегляд треку 3 з VCD:
206
207 xine vcd://3
208
209 Приклад прямого доступу до DVD:
210
211 xine dvd://VTS_01_1.VOB
212
213
2142.4.1 Клавіатурні комбінації управління
215
216 Комбінація клавіш Дія
217
218 <ENTER> грати
219 <SPACE> пауза
220 <Up>/<Down> швидка промотка вперед / назад
221
222 0 шукати початок потоку
223 1-9 шукати позицію в 10 .. 90 % від загального розміру потоку
224 <Left>/<Right> шукати -/+ 15 сек (+ CTRL: 60 сек)
225 <PgUp>/<Prior> перестрибнути до попереднього елементу списку програвання
226 <PgDown>/<Next> перестрибнути до наступного елементу списку програвання
227
228 f переключити повноекранний режим
229 a переключити розмір сторін відео (АВТО/16:9/4:3/DVB)
230 i переключити черезрядковий режим
231
232 z / Shift-Z збільшити / зменшити масштаб відео
233 + Ctrl масштабування по горизонталі
234 + Meta масштабування по вертикалі
235
236 "<", ">" модифікувати розмір вікна
237 + - змінити аудіо канал
238 , . змінити канал субтитрів
239 n m відрегульовати синхронізацію аудіо / відео
240 <HOME> встановити типову синхронизацію аудіо / відео
241
242 <INSERT> переключити відображення курсору миши у вікні відео
243
244 q вихід
245
246 h сховати відео вікно (корисно для прослуховування mp3)
247
248
249 Далі буде. :-)
250
251 Правий щовчок (або натиснення на 'g') на вікні відео виходу переключає
252 присутність панелі ГІК.
253
254 Зміна клавіатурних комбінацій:
255
256 Ви можете змінити будь-яку клавіатурну комбінацію. для цього Ви повинні мати
257 файл keymap у Вашій домашній директорії ($HOME)/.xine/. Синтаксів ключів наступний:
258
259 WindowReduce {
260 key = less
261 modifier = none
262 }
263
264 Клавіатурний ключ повинен відповідати рядку ключів X11 (дивиться нижче).
265 Модифікатори можуть бути:
266 - 'none' при відсутності модифікатора ,
267 - 'control' (або 'ctrl') для клавіши "ctrl" ,
268 - 'meta' (або 'alt' для ПК) для мета ключа,
269 - 'mod3' або 'mod4' або 'mod5' доступні тількі на деяких платформах.
270
271 Модифікатори можуть бути змішані, розділені комою:
272
273 WindowReduce {
274 key = less
275 modifier = control, alt
276 }
277
278 Якщо Ви не вказали рядок модифікаторів це рівнозначно 'none' (немає).
279
280 Ви також можете додати псевдоними до клав. комбінацій, наприклад:
281
282 Alias {
283 entry = Pause
284 key = p
285 }
286
287 Мається на увазі що Ви додаєте іншу клав. комбінацію до елементу 'Pause' , натиснув на 'p',
288 Ви можете також додати секцію модифікатора (див. вище). Якщо Ви не вкажите це,
289 модифікатор буде таким, як і в оригінальній секції ('Pause' в цьому випадку).
290
291 Знаходження значень клавіатурних ключів X11:
292
293 Щоб дізнатися значення ключа (клав. комбінації) X11, Ви можете використовувати утиліту
294 'xev', яка постачається у складі Вашого пакунку X11. Запустить 'xev' в терміналі
295 (наприклад xterm), акцентуйте увагу на маленькому вікні, і натиснить на клавішу,
296 яку Ви хочете вжити.
297
298 Далі Ви побачите щось подібне до:
299
300 ...
301 KeyRelease event, serial 27, synthetic NO, window 0x3200001,
302 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
303 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
304 ^^^^^^^^
305 Це те що Ви шукаєте.
306
307 Перегляд поточно встановлених / переприв'язаних клавіатурних ключів:
308
309 Ви можете запустити 'xine --keymap' або 'xine --keymap=default', щоб
310 побачити типові ключі. Звісно, Ви можете перенаправити результат до
311 файлу, який може сам по собі стати конфігураційним файлом ~/.xine/keymap.
312
313 Щоб побачити результат переприв'язки, запустить 'xine --keymap=remapped'.
314
3152.4.2 Вибір аудіо каналів
316
317 Задайте опцію -a щоб вибрати бажаємий аудіо трек:
318
319 xine -a 3 test.mpg
320
321 Грає 3 -ий доступний аудіо трек ( і звісно відео).
322
323 Альтернативно Ви можете це зробити через ГІК.
324
3252.4.3 Вибір субтитрів
326
327 Субтитри вбудовані в різні трекі, наприклад аудіо. Зазвичай,
328 трек 0 є субтитром мови по умовчанню. Використовуйте опцію -u
329 для вибору бажаємого треку субтитрів:
330
331 xine -u 0 test.vob
332
333 Показує субтитри з потоку (треку) 0.
334
335 Альтернативно Ви можете це зробити через ГІК.
336
3372.4.4 Дістанційне управління в Linux
338
339 Xine може управлятися дістанційно за допомогою інфра-червоних пультів.
340 Для цього, Ви повинні мати встановлений пакунок LIRC (http://www.lirc.org).
341
342 Ви можете додати деякі елементи до Вашого конф. файлу ~/.lircrc, наприклад:
343
344 begin
345 remote = SAMSUNG
346 button = Button_Play
347 prog = xine
348 repeat = 0
349 config = Play
350 end
351 begin
352 remote = SAMSUNG
353 button = Button_1
354 prog = xine
355 repeat = 0
356 config = SetPosition10%
357 end
358
359 Xine може самостійно генерувати типові елементи конфігурації для lirc,
360 вживая команду 'xine --keymap=lirc', вивід текстової інформації з Xine
361 Ви можете перенаправити до файлу ~/.lircrc.
362
363 Кожний елемент подібно до:
364
365 # Зменьшити розмір вихідного вікна.
366 begin
367 remote = xxxxx
368 button = xxxxx
369 prog = xine
370 repeat = 0
371 config = WindowReduce
372 end
373
374 Вам залишається вказати ім'я віддаленого об'єкту (remote name), і призначити клавішу.
375
376
3773 ЩО ЩЕ ЗАЛИШИЛОСЯ СКАЗАТИ
378
3793.1 СВОБОДА, DVD і проблеми ...
380
381 Xine це вільно доступне програмне забезпечення. "Вільне" означає з
382 "відкритим кодом". Більш того, значення терміну "вільна програма" має
383 розширений сенс: абсолютно необмежене використання програми.
384 Якщо Ви маєте час, будь-ласка прочитайте що про це (свободу і програми)
385 говорить асоціація вільного програмного забезпечення:
386
387 => http://www.gnu.org/philosophy/free-sw.html
388
389 У випадку, коли інформація розташована на DVD, поняття свободи трактується
390 інакше: кіноіндустрія наполегливо робить спроби обмежити перегляд DVD за
391 допомогою апаратного контролю. Більшість DVD, що зараз продаються, зашифровані
392 особливим чином - в деяких країнах (наприклад в США), можливо дешифрування відео
393 буде нелегальним, навіть для приватного перегляду.
394
395 Нащастя, багато людей погоджуються, що це дуже суперечливий підхід для
396 користувачів. Розробники проекту xine осуджують такі спроби кіноіндустрії, яка,
397 намагаючись запобігти втрат при продажі, таким способом насправді демонструє
398 велику неповагу до честних споживачів.
399
400 З іншого боку, розробники xine проти порушення існуючого законодавства.
401 Ніхто точно не знає, чи є насправді нелегальним будь де у світі розробляти,
402 володіти і використовувати програмне забезпечення для перегляду зашифрованих
403 DVD. Так як, це є досі невизначеною темою (що здається потенційно дуже
404 небезпечно), xine не містить ніякого специфічного коду для дешифрування DVD.
405
406 Здається що інші колективи програмістів працюють над такими розширеннямі.
407 Можливо в деяких країнах можна легально використовувати такі програми.
408
409 Так чи інакше Ви не зможете дивитися зашифровані DVD за допомогою стандартного
410 дистрибутиву xine. Майте на увазі, що це не вада типу "відсутня функція" а легальна
411 проблема. Було б непогано розв'язати цю проблему (наприклад переконати
412 Америку і/або кіноіндустрію, що вони іх роздратування і недовіра до користувачів
413 і розробників вільного програмного забезпечення нічим не обгрунтована),
414 але включення коду в xine для дешифрування DVD не вирішить проблему.
415
4164 Контакти з проектом Xine
417
418 Сторінка проекту xine :
419
420 => http://xine.sourceforge.net
421
422 Відгуки або пропозиції з допомоги щіро вітаються, будь ласка зв'яжиться з нами:
423
424 поштова розсилка xine - <xine-user@lists.sourceforge.net>
425
426 -----------------------------------------
427
428 переклад українською Кудрика Сергія
429 mailto: linux_ua@yahoo.com
430
431 Можете звертатися до мене за допомогою,
432 якщо маєте проблеми з Xine.
433
434
435
436
437
438
439