From e2090db4b9df7bab5e6bb774b842679516b13252 Mon Sep 17 00:00:00 2001 From: gferg <> Date: Mon, 10 Feb 2003 15:00:53 +0000 Subject: [PATCH] new --- .../VLC-User-Guide/VLC-User-Guide.sgml | 103 +++ LDP/ref/docbook/VLC-User-Guide/cmdline.sgml | 336 ++++++++ LDP/ref/docbook/VLC-User-Guide/fdl.sgml | 431 ++++++++++ LDP/ref/docbook/VLC-User-Guide/gui.sgml | 277 +++++++ .../docbook/VLC-User-Guide/install-vlc.sgml | 240 ++++++ .../docbook/VLC-User-Guide/install-vls.sgml | 226 ++++++ LDP/ref/docbook/VLC-User-Guide/install.sgml | 13 + LDP/ref/docbook/VLC-User-Guide/intro.sgml | 261 ++++++ LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml | 1 + LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml | 1 + LDP/ref/docbook/VLC-User-Guide/magic.sgml | 1 + LDP/ref/docbook/VLC-User-Guide/modules.sgml | 740 ++++++++++++++++++ .../VLC-User-Guide/streamable-mpeg-file.sgml | 46 ++ .../docbook/VLC-User-Guide/uninstall-vlc.sgml | 54 ++ 14 files changed, 2730 insertions(+) create mode 100644 LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/cmdline.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/fdl.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/gui.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/install-vls.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/install.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/intro.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/magic.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/modules.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml create mode 100644 LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml diff --git a/LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml b/LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml new file mode 100644 index 00000000..bd5c5fc9 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml @@ -0,0 +1,103 @@ + + %magic-entities; + + + + + + + + + + + +]> + + + + + +VLC User Guide + + + + Henri + Fallon + + + Alexis + de Lattre + + + Johan + Bilien + + + Anil + Daoud + + + Mathieu + Gautier + + + Clément + Stenac + + + + + 2002, 2003 + the VideoLAN project + + + + + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation ; with no +Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +Texts. The text of the license can be found in the appendix +. + + + + + VideoLAN + Client + vlc + vls + vod + vlcs + stream + multicast + MPEG 1 + MPEG 2 + MPEG 4 + DVD + DivX + + + + +This document is the complete user guide of VLC, the VideoLAN Client. + + + + + + + + + +&intro; +&modules; +&install; +&gui; +&cmdline; +&fdl; + + diff --git a/LDP/ref/docbook/VLC-User-Guide/cmdline.sgml b/LDP/ref/docbook/VLC-User-Guide/cmdline.sgml new file mode 100644 index 00000000..d2e52153 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/cmdline.sgml @@ -0,0 +1,336 @@ +The Command Line Interface + +Introduction + +Many options are only available through command line. They are +detailed here. + + + +Opening streams + +The following commands start VLC and add the first element to the +playlist. + +Opening a file + +Start VLC with : + + +% vlc my_file.mpg + + +Although VLC should be able to recognize the file +type, you may tell VLC what codec to use with the +--codec option. For example to play +my_file.mpg using ffmpeg audo/video decoder do : + + +% vlc --codec ffmpeg my_file.mpg + + +A list of all video and audio codecs supported by VLC is available +on the VLC +features list + + + +Opening a DVD or VCD + +Start VLC with : + + +% vlc dvd:[device][@raw_device][@[title][,[chapter][,angle]]] + + +or + + +% vlc vcd:[device][@[title][,[chapter] + + +where device is the complete path to your DVD or CD-ROM drive. + +Start a network stream + +To receive an unicast UDP stream (sent by VLS or VLC's stream +output), start VLC with : + + +% vlc udp:[@:server_port] + + +To receive a multicast UDP stream (sent by VLS or VLC's +stream output), start VLC with : + + +% vlc udp:@multicast_address[:server_port] + + +To receive a HTTP stream, start VLC with : + + +% vlc http://www.example.org/your_file.mpg + + + + + +Modules selection + +VLC tries to select the most appropriate interface, input and +output modules, among the ones available on the system, according to the +stream it is given to read. However, you may wish to force the use of a +specific module with the following options (for the complete list of +modules, see the section) : + + + +--intf <module> +allows you to select the interface module. +--aout <module> +allows you to select the audio output module. +--vout <module> +allows you to select the video output module. +--filter <module> +allows you to add a video filter module. +--memcpy <module> +allows you to choose a memory copy module. +--access <module> +allows you to force the access module. +--demux <module> +allows you to force the demux module. + + + + +Stream Output + +Stream output is a new feature of VLC, which allows you to save +the video that you are watching to a file, or to stream it in UDP. + + + +--sout <string> +enables stream output to string +(string can be either a file name or a ip +adress). + +--no-sout-audio disables audio +stream output. + +--no-sout-video disables video +stream output. + +--sout-acodec +[|mpeg1|mpeg2|mpeg4|vorbis] allows you to force audio +encoding. + +--sout-vcodec [|mpeg1|mpeg2|mpeg4] +allows you to force video encoding. + +--packetizer <string> allows +you to select the order in which VLC will select its packetizers. + +--mux <string> lets you +configure mux modules. + +--access_output <string> lets +you configure access output modules. + + + + + +Other Options + +Audio options + + +--noaudio disables audio +output. +--mono forces VLC to treat the +stream in mono audio. +--volume <integer> sets the +level of audio output. +--aout-rate <integer> sets +the audio output frequency (Hz). +--desync <integer> +compensates desynchronization of audio (ms). +--headphone activates headphone +virtual spatialization effect. +--headphone-dim sets headphone +characteristic dimension. + + + + +Video options + + + +--novideo disables video +output. + +--greyscale turns video output into +greyscale mode. + +--fullscreen sets fullscreen +video. + +--nooverlay disables hardware +acceleration for the video output. + +--width, --height <integer> +sets the video window dimensions. + +--zoom <float> adds a zoom +factor. + +--aspect-ratio <mode> forces +source aspect ratio. + +--spumargin <integer> forces +SPU subtitles postion. + + + + + +Playlist options + + + +--playlist launches playlist on +startup. + +--random plays files randomly +forever. + +--enqueue enqueues items in +playlist. + +--loop loops playlist on end. + + + + + +Network options + + + +--server-port <integer> sets +server port. + +--network-channel enables network +channel mode. + +--channel-server <string> +specifies the channel server address. + +--channel-port <integer> +specifies the channel server port. + +--iface <string> specifies +the network interface to use. + +--iface-addr <string> +specifies your network interface IP address. + +--mtu <integer> specifies +the MTU of the network interface. + +--ipv6 forces IPv6. + +--ipv4 forces IPv4. + + + + + +CPU options + + + +--nommx disables the use of MMX CPU +extensions. + +--no3dn disables the use of 3D Now! +CPU extensions. + +--nommxext disables the use of MMX +ext CPU extensions. + +--nosse disables the use of SSE +CPU extensions. + + + + + +Miscellaneous options + + + +--quiet be quiet. + +--color displays color messages. + +--search-path <string> +specifies interface default search path. + +--plugin-path <string> +specifies plugin search path. + +--dvd <string> +specifies the default dvd device. + +--vcd <string> +specifies the default vcd device. + +--program <integer> specifies +program (SID) (for streams with several programs, like satellite ones). + +--audio-type <integer> +specifies the default audio type to use with dvds. + +--audio-channel <integer> +specifies the default audio channel to use with dvds. + +--spu-channel <integer> +specifies the default subtitle channel to use with dvds. + + + + + +Help options + + + +--verbose <verbosity> +specifies verbosity level. + +--help gives you all available +options. + +--longhelp gives you a detailled +version of the available options. + +--version gives you information +about the current VLC version. + +--list displays a list of available +plugins. + +--module <module> displays +help about specified module. + + + + + + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/fdl.sgml b/LDP/ref/docbook/VLC-User-Guide/fdl.sgml new file mode 100644 index 00000000..811aa1ee --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/fdl.sgml @@ -0,0 +1,431 @@ + +GNU Free Documentation License +Version 1.2, November 2002 + + + +PREAMBLE + +The purpose of this License is to make a manual, textbook, or +other functional and useful document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, with +or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible for +modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft license +designed for free software. + +We have designed this License in order to use it for manuals for +free software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; it +can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work, in +any medium, that contains a notice placed by the copyright holder saying +it can be distributed under the terms of this License. Such a notice +grants a world-wide, royalty-free license, unlimited in duration, to use +that work under the conditions stated herein. The "Document", below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as "you". You accept the license if you +copy, modify or distribute the work in a way requiring permission under +copyright law. + +A "Modified Version" of the Document means any +work containing the Document or a portion of it, either copied verbatim, +or with modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or +a front-matter section of the Document that deals exclusively with the +relationship of the publishers or authors of the Document to the +Document's overall subject (or to related matters) and contains nothing +that could fall directly within that overall subject. (Thus, if the +Document is in part a textbook of mathematics, a Secondary Section may +not explain any mathematics.) The relationship could be a matter of +historical connection with the subject or with related matters, or of +legal, commercial, philosophical, ethical or political position +regarding them. + +The "Invariant Sections" are certain Secondary +Sections whose titles are designated, as being those of Invariant +Sections, in the notice that says that the Document is released under +this License. If a section does not fit the above definition of +Secondary then it is not allowed to be designated as Invariant. The +Document may contain zero Invariant Sections. If the Document does not +identify any Invariant Sections then there are none. + +The "Cover Texts" are certain short passages of +text that are listed, as Front-Cover Texts or Back-Cover Texts, in the +notice that says that the Document is released under this License. A +Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at +most 25 words. + +A "Transparent" copy of the Document means a +machine-readable copy, represented in a format whose specification is +available to the general public, that is suitable for revising the +document straightforwardly with generic text editors or (for images +composed of pixels) generic paint programs or (for drawings) some widely +available drawing editor, and that is suitable for input to text +formatters or for automatic translation to a variety of formats suitable +for input to text formatters. A copy made in an otherwise Transparent +file format whose markup, or absence of markup, has been arranged to +thwart or discourage subsequent modification by readers is not +Transparent. An image format is not Transparent if used for any +substantial amount of text. A copy that is not "Transparent" is called +"Opaque". + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, SGML or +XML using a publicly available DTD, and standard-conforming simple HTML, +PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the machine-generated +HTML, PostScript or PDF produced by some word processors for output +purposes only. + +The "Title Page" means, for a printed book, +the title page itself, plus such following pages as are needed to hold, +legibly, the material this License requires to appear in the title page. +For works in formats which do not have any title page as such, "Title +Page" means the text near the most prominent appearance of the work's +title, preceding the beginning of the body of the text. + +A section "Entitled XYZ" means a named subunit +of the Document whose title either is precisely XYZ or contains XYZ in +parentheses following text that translates XYZ in another language. +(Here XYZ stands for a specific section name mentioned below, such as +"Acknowledgements", "Dedications", "Endorsements", or "History".) To +"Preserve the Title" of such a section when you modify the Document +means that it remains a section "Entitled XYZ" according to this +definition. + +The Document may include Warranty Disclaimers next to the notice +which states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this License, +but only as regards disclaiming warranties: any other implication that +these Warranty Disclaimers may have is void and has no effect on the +meaning of this License. + + +VERBATIM COPYING + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies to +the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further copying +of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + + +You may also lend copies, under the same conditions stated above, +and you may publicly display copies. + + +COPYING IN QUANTITY + +If you publish printed copies (or copies in media that commonly +have printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover Texts: +Front-Cover Texts on the front cover, and Back-Cover Texts on the back +cover. Both covers must also clearly and legibly identify you as the +publisher of these copies. The front cover must present the full title +with all words of the title equally prominent and visible. You may add +other material on the covers in addition. Copying with changes limited +to the covers, as long as they preserve the title of the Document and +satisfy these conditions, can be treated as verbatim copying in other +respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document +numbering more than 100, you must either include a machine-readable +Transparent copy along with each Opaque copy, or state in or with each +Opaque copy a computer-network location from which the general +network-using public has access to download using public-standard +network protocols a complete Transparent copy of the Document, free of +added material. If you use the latter option, you must take reasonably +prudent steps, when you begin distribution of Opaque copies in quantity, +to ensure that this Transparent copy will remain thus accessible at the +stated location until at least one year after the last time you +distribute an Opaque copy (directly or through your agents or retailers) +of that edition to the public. + +It is requested, but not required, that you contact the authors of +the Document well before redistributing any large number of copies, to +give them a chance to provide you with an updated version of the +Document. + + +MODIFICATIONS + +You may copy and distribute a Modified Version of the Document +under the conditions of sections 2 and 3 above, provided that you +release the Modified Version under precisely this License, with the +Modified Version filling the role of the Document, thus licensing +distribution and modification of the Modified Version to whoever +possesses a copy of it. In addition, you must do these things in the +Modified Version: + + +Use in the Title Page (and on the covers, if any) a + title distinct from that of the Document, and from those of previous + versions (which should, if there were any, be listed in the History + section of the Document). You may use the same title as a previous + version if the original publisher of that version gives permission. + +List on the Title Page, as authors, one or more + persons or entities responsible for authorship of the modifications in + the Modified Version, together with at least five of the principal + authors of the Document (all of its principal authors, if it has fewer + than five), unless they release you from this requirement. + +State on the Title page the name of the publisher of + the Modified Version, as the publisher. +Preserve all the copyright notices of the Document. + +Add an appropriate copyright notice for your + modifications adjacent to the other copyright notices. + +Include, immediately after the copyright notices, a + license notice giving the public permission to use the Modified + Version under the terms of this License, in the form shown in the + Addendum below. + +Preserve in that license notice the full lists of + Invariant Sections and required Cover Texts given in the Document's + license notice. +Include an unaltered copy of this License. + +Preserve the section Entitled "History", Preserve its + Title, and add to it an item stating at least the title, year, new + authors, and publisher of the Modified Version as given on the Title + Page. If there is no section Entitled "History" in the Document, + create one stating the title, year, authors, and publisher of the + Document as given on its Title Page, then add an item describing the + Modified Version as stated in the previous sentence. + +Preserve the network location, if any, given in the + Document for public access to a Transparent copy of the Document, and + likewise the network locations given in the Document for previous + versions it was based on. These may be placed in the "History" + section. You may omit a network location for a work that was + published at least four years before the Document itself, or if the + original publisher of the version it refers to gives permission. + +For any section Entitled "Acknowledgements" or + "Dedications", Preserve the Title of the section, and preserve in the + section all the substance and tone of each of the contributor + acknowledgements and/or dedications given therein. + +Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers or the + equivalent are not considered part of the section titles. + +Delete any section Entitled "Endorsements". + Such a section may not be included in the Modified Version. + +Do not retitle any existing section to be Entitled + "Endorsements" or to conflict in title with any Invariant Section. + +Preserve any Warranty Disclaimers. + + + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it +contains nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, +and a passage of up to 25 words as a Back-Cover Text, to the end of the +list of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or through +arrangements made by) any one entity. If the Document already includes +a cover text for the same cover, previously added by you or by +arrangement made by the same entity you are acting on behalf of, you may +not add another; but you may replace the old one, on explicit permission +from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this +License give permission to use their names for publicity for or to +assert or imply endorsement of any Modified Version. + + +COMBINING DOCUMENTS + +You may combine the Document with other documents released under +this License, under the terms defined in section +4 above for modified versions, provided that you include in the +combination all of the Invariant Sections of all of the original +documents, unmodified, and list them all as Invariant Sections of your +combined work in its license notice, and that you preserve all their +Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by adding +at the end of it, in parentheses, the name of the original author or +publisher of that section if known, or else a unique number. Make the +same adjustment to the section titles in the list of Invariant Sections +in the license notice of the combined work. + +In the combination, you must combine any sections Entitled +"History" in the various original documents, forming one section +Entitled "History"; likewise combine any sections Entitled +"Acknowledgements", and any sections Entitled "Dedications". You must +delete all sections Entitled "Endorsements". + + +COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other +documents released under this License, and replace the individual copies +of this License in the various documents with a single copy that is +included in the collection, provided that you follow the rules of this +License for verbatim copying of each of the documents in all other +respects. + +You may extract a single document from such a collection, and +distribute it individually under this License, provided you insert a +copy of this License into the extracted document, and follow this +License in all other respects regarding verbatim copying of that +document. + + +AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other +separate and independent documents or works, in or on a volume of a +storage or distribution medium, is called an "aggregate" if the +copyright resulting from the compilation is not used to limit the legal +rights of the compilation's users beyond what the individual works +permit. When the Document is included an aggregate, this License does +not apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on covers +that bracket the Document within the aggregate, or the electronic +equivalent of covers if the Document is in electronic form. Otherwise +they must appear on printed covers that bracket the whole +aggregate. + + +TRANSLATION + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warrany Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between the +translation and the original version of this License or a notice or +disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve its +Title (section 1) will typically require changing the actual +title. + + +TERMINATION + +You may not copy, modify, sublicense, or distribute the Document +except as expressly provided for under this License. Any other attempt +to copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, +parties who have received copies, or rights, from you under this License +will not have their licenses terminated so long as such parties remain +in full compliance. + + +FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions of +the GNU Free Documentation License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in +detail to address new problems or concerns. See +http://www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing version +number. If the Document specifies that a particular numbered version of +this License "or any later version" applies to it, you have the option +of following the terms and conditions either of that specified version +or of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + + +ADDENDUM: How to use this License for + your documents + +To use this License in a document you have written, include a copy +of the License in the document and put the following copyright and +license notices just after the title page: + + + +If you have Invariant Sections, Front-Cover Texts and Back-Cover +Texts, replace the "with...Texts." line with this: + +
+ with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. +
+ +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of free +software license, such as the GNU General Public License, to permit +their use in free software. + + diff --git a/LDP/ref/docbook/VLC-User-Guide/gui.sgml b/LDP/ref/docbook/VLC-User-Guide/gui.sgml new file mode 100644 index 00000000..96ec64f9 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/gui.sgml @@ -0,0 +1,277 @@ +The Graphical User Interface + +Opening a stream + +To open a stream using the graphical interface, click on either +: + + + +"File" to open a file stored on your hard +drive. + +"Disc" to read a DVD or a VCD. + +"Network" to read a network UDP stream +or an HTTP stream. + +"Satellite" to read directly from a satellite +card. + + + +These four buttons, as well as the ones located in the "File" +menu, actually open the same dialog box, but on different tabs. + +The "open a stream" dialog box + +You can specify directly the Media Resource Locator MRL, if you +know the syntax that you have to use, but you may also use the different +tabs, that will fill it automatically. + + + +For a File, this is very simple, you +only have to fill the path to the file. + +For a Disc, you select +the type of the disk, the path to the drive (looks like +/dev/dvd on Unix, or D: on +Windows), and the starting title and chapter. + +For a Network stream : + + + + if you use unicast mode, select UDP + and the port used, + + if you use multicast, select UDP + multicast, enter the multicast address and the port ; + + if you have a channel information service with + mini-VLCS, select Channel server, and give its + address ; + + if you use HTTP streaming + to do Video On Demand, select HTTP and give the + address of your stream. + + + +For a Satellite stream, you have to +give the frequency, the rate, the polarization, and the FEC of your +stream. + + + + + +Basic stream control + +You have at your disposal all the classical control of a video +player. For example when playing local streams or HTTP streams, you can +pause, speed up or slow down the stream, go forth and back... Just use +the corresponding buttons. + +To go fullscreen, you can select the right options in the +view menu, or press f. To go +back to the normal mode, press f. + + + +DVD and VCD navigation + +When reading a DVD or a VCD, you can change chapter and titles as +you wish either by using the right-click menu or by using the options in +the "Parameters" menu. These options are enabled only when you play a +disk, or a disk through the network. + + + +Programs, languages and subtitles + +When reading a multiprogram stream, you can change the current +program by selecting it in the "View/Programs" submenu on the bar, or by +using the "right click" menu from the video output window. You can also +change the title and the chapter by the same way. + +In DVDs, if different angles are availables, they will be treated as +different programs. + +At any time you can change the audio/subtitles channel using either the +"setting" menu from the interface or using the "right click" menu from +the video output window. + + + + +Preferences window + +By choosing "Preferences" in the "Settings" menu, you will open +the preferences window. This window is generated dynamically according +to the modules that were compiled. + +In every tab, you may click on "Save" to store your +settings in your configuration file. (you can find it in +~/.vlc/vlcrc on Unix/Linux systems, or in +Application Data\vlc\vlcrc + +Interface tab + +In that tab, you can select which interface you would like +to use on next start. Click on the choosen interface, click on +Select then on Save. + +There can be some configuration options available by clicking +Configure. This depends on the interface +chosen. + +There are also a few generic settings, like color message or +setting the verbosity level of the logs. You can also specify the +path to the interface or to the plugin if they are not in the default +directory. [FIX : compare with settings on other OS, where is the +default file?] + + + +Audio tab + + In this tab, you can select and configure the audio output +you would like to use on next start (this works juste like for the +interface). You may also specify other settings such as enabling +or disabling the audio output, the output volume level, the audio +frequency, the number of channels on output, add desynchronization, or +set audio output format and headphone spazialization effect. + + + +Video tab + +In this tab, you can select which video output will be used on +next start, and add a video filter module, which means a filter that +will alter the rendered image. For more information on modules, please +look the Modules section. You may also specify some video settings, such +as the window size, if you would like fullscreen display or the video +zoom. + +By using the adjust video filter module, you +will be able to modify the Brightness, Contrast, Saturation and Hue of +the video output. + +There are also specific modules as wall which cut the output in +many windows to make a video wall, transform module to rotate the image +or invert module to invert the colors (who said it's useless?) + + + +Input tab + +In this tab, you can enter the input method with options by +default that will be used on next start. + +Note that these are only default options, +which means that they will be written in the appropriate field, but, you +can of course change them. + +You can configure the default addresses and port for network +streaming : + + +the server port for UDP streaming, +the server port for UDP multicast streaming +the channel server adress and the channel server if you have a channel information service based on mini-VLCS. + + +Here you also can choose which network interface the videolan +client will use to get the stream and the address of this interface. + +The other options allow you to choose audio, channel, subtitles, +the device of the DVD, the device of the VCD and the IP protocol of the +stream (IPv6 or IPv4). + + + +Decoders tab + +In this tab, you can select which decoder (codec) you want to use +for audio or video decoders. VLC normally automatically detects the +right codec to use, so be sure to know what you are doing. + + + +Stream ouput + +In this tab you can configure the stream output capabilities. + +Stream output is a new feature of VLC which allow you to save +the stream that you are watching to a file, or to stream it in unicast or multicast. + +This tab allows you to set up some options for this. You will +be able to select the muxer used for the stream, ie PS, TS or AVI. PS +and TS are parts of the MPEG norm. PS stands for Program Stream, it is +usually used for files, whereas TS stands for Transport Stream, which +is rather used for network streams. AVI means output to an AVI file or +stream. + +You may also select the access output, +i.e. what the strem will be output to. You can choose +beetween UDP (network stream) or +file. + +The Packetizer is the format of the output. + +You can also enable or disable audio or video. + + + +CPU tab + +This tab is dedicated to enabling or disabling support for +CPU extensions: MMX support (every processors since Pentium MMX), +3D! Now Support (for AMD K6-2, K6-3, Athlon and Duron processors), +MMX EXT support, and SSE support (for Pentium III and Pentium IV +processors). + + + +Playlist tab + +In this tab, you can select some playlist options, such as looping +the playlist, automatically launching the playlist on VLC's start, enqueue +items in it or randomly read the files. + + + +Miscellanous tab + + In this tab, you can select which memcpy version you want to use. +Some of them uses MMX or 3Dnow! extensions. You can also select the +access module (module used to get the stream) and the the demux module +(used to ... demux the stream). + + + + +Miscellaneous + +The Messages Window + +This window is available by clicking on +Messages in the View menu. It +shows all the debug messages of VLC. If you have a problem with VLC, +don't hesitate to open this window, as it may contain an interesting +error message. + + + +The Playlist + +VLC includes a simple playlist management system. By using the +buttons which are in the playlist window, you can easily add or remove +streams (whether these are files, disks, network streams, or satellites +streams). + + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml b/LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml new file mode 100644 index 00000000..00b195f4 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml @@ -0,0 +1,240 @@ +There are VLC binaries available for the many OSes, but not for +all supported OSes. If there are no binaries for your OS or if you want +to change the default settings, you can compile VLC from sources. + + +Under Windows + +VLC works under Windows 95/98/ME/2000/XP. +Download the Zipip file from the VLC Windows +download page. Unzip the file in a directory to install +VLC. + + + +Under BeOS + + +Download the Zip file from the VLC BeOS download +page. Unzip the file in a directory to install VLC. + + + + +Under Mac OS X + + + +Download the Mac OS X package from the VLC +MacOS X download page . Double-click on the icon of the +package : an icon will appear on your Desktop, right beside your +drive(s). Open it and drag the VLC application from the resulting +window to the place where you want to install it (it should be +/Applications). + + + + + +Under Linux Debian + +Edit as root /etc/apt/sources.list and add +the following lines : + + +deb http://www.videolan.org/pub/videolan/debian $(ARCH)/ +deb-src http://www.videolan.org/pub/videolan/debian sources/ + + +Then install the packages : + + +# apt-get update +# apt-get install gnome-vlc vlc-plugin-a52 vlc-plugin-mad vlc-plugin-ogg libdvdcss2 + + + +Under Linux Redhat, Mandrake and SuSE + +For these distributions, use the RPM packages. + +First, install the packages liba52 and +libmad0 that should be packaged in your +distribution. If they are not, try to find the RPMs on RPMfind.net or search +the Internet. + + + +Download the RPM packages of libdvdcss2, +libdvdpsi1, vlc +gnome-vlc, vlc-plugin-mad, vlc-plugin-ogg, vlc-plugin-a52 from the +VLC Linux +download page. + + + + +Then install the RPM packages you have downloaded: + + + +# rpm -Uhv vlc-version.i586.rpm gnome-vlc-version.i586.rpm vlc-plugin-mad-version.i586.rpm +vlc-plugin-ogg-version.i586.rpm vlc-plugin-a52-version.i586.rpm libdvdcss2-version.i586.rpm libdvdpsi1-version.i586.rpm + + + + +Compile the sources by yourself (for every other OS) + +The method below is for any Unix system supported by VLC, for +which there is no packages available. It explains how to compile and +install VLC and the needed librairies from their source code. + +You can also compile the VLC under Linux this way if you want to +modify the default supported modules + +Install the libraries + +Many libraries are needed for particular uses : + + + + +libdvdcss if you want to be able to +read encrypted DVDs, + +libdvdplay if you want to have DVD +menu navigation, + +libdvbpsi if you want to be able to +read from the network, + +a52dec if you want to be +able to decode the AC3 (i.e. A52) sound format often used in +DVDs, + +ffmpeg, libmad +and faad2 if you want to read MPEG 4 / DivX +files, + +libogg and +libvorbis if you want to read Ogg Vorbis +files. + + + +Download the libraries from VLC sources +download page. + +For each library : + + + +uncompress : + + +% tar xvzf library.tar.gz + +or + +% tar xvjf library.tar.bz2 + + +configure : + + +% cd library +% ./configure --enable-shared + + +compile and install : + + +% make +# make install + + + + + +Check that the configuration file /etc/ld.so.conf +contains the following line : + + + +/usr/local/lib + + +If the line is not present, add-it and then run (as root): + + +# ldconfig + + + + +Install VLC + +Download the sources of the lastest release : get the +file vlc-version.tar.gz from the VLC sources +download page. Uncompress-it : + + +% tar xvzf vlc-version.tar.gz +% cd vlc-version + + + + +To get the list of configuration options, do : + +% ./configure --help + + +Please note that all the modules are described in +the Modules section of the VLC User +Guide. + + +Examples of very simple configurations: + + +if you want a basic VLC, do : + +% ./configure + + + +if you want the Gnome interface instead of the GTK +interface (you will need the developement packages of Gnome) : + +% ./configure --enable-gnome + + + + + + +Then, compile and install : + + + +% make +% su +Password: [Root Password] +# make install + + +Please note that the installation (make install +command) is not mandatory. You can execute VLC from where you compiled +it. + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/install-vls.sgml b/LDP/ref/docbook/VLC-User-Guide/install-vls.sgml new file mode 100644 index 00000000..e688cb62 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/install-vls.sgml @@ -0,0 +1,226 @@ + + +Under Linux or Unix + +The method below is for any Unix or Linux supported by the +Videolan Server. It explains how to compile and install vls and the +needed librairies from sources. + +Install the librairies + + +Many librairies are needed for particular uses : + + + +libdvbpsi (always needed) +libdvdcss if you want to be able to access encrypted DVDs, +libdvdread if you want to be able to stream DVDs. + + + + +Download the libraries from in the directory +version/contrib. + + + + +For each librairie, uncompress, configure, compile and install : + + + + +% tar xvzf library.tar.gz +% cd library +% ./configure --enable-shared +% make +# make install + + + + + +Check that the configuration file /etc/ld.so.conf +contains the following line : + + + + +/usr/local/lib + + +If the line is not present, add-it and then run : + + +# ldconfig + + + + +Install the VideoLAN Server + + + + + +Get the most recent version of the VideoLAN Server from the public CVS : + + + + +% cvs -d:pserver:anonymous@cvs.videolan.org:/cvs/videolan login + + + +There is no password. Type enter, then : + + + +% cvs -d:pserver:anonymous@cvs.videolan.org:/cvs/videolan checkout -P -r v0_4_5 vls + + + +To get the list of configuration options, do : + + + +% ./configure --help + + + +Then configure vls : + + + + +if you want a basic vls without DVD support, do : + + + +% ./configure --disable-dvd + + + + +if you want a full vls with DVD support, do : + + + +% ./configure + + + + + + + +Then, compile and install : + + + +% make +# make install + + + + +You can also do a make uninstall, make +clean or make distclean as needed. + + + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/install.sgml b/LDP/ref/docbook/VLC-User-Guide/install.sgml new file mode 100644 index 00000000..6977aea6 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/install.sgml @@ -0,0 +1,13 @@ +Installing VLC + + +Installing VLC +&install-vlc; + + +Uninstalling VLC +&uninstall-vlc; + + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/intro.sgml b/LDP/ref/docbook/VLC-User-Guide/intro.sgml new file mode 100644 index 00000000..5f00e06a --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/intro.sgml @@ -0,0 +1,261 @@ +Introduction + +What is the VideoLAN project ? + +Overview + + + +VideoLAN is a complete software solution for video streaming, developed +by students of the Ecole Centrale +Paris and developers from all over the world, under the +GNU General Public +License (GPL). VideoLAN is designed to stream MPEG videos on high +bandwidth networks. + + + + + +The VideoLAN solution includes : + + + + + +the VideoLAN Server (VLS), which can stream MPEG 1 and 2 +files, DVDs, digital satellite channels, digital terrestial television +channels and live videos on the network in unicast or multicast, + +the VideoLAN Client (VLC), which can be used as a server +to stream MPEG 1, 2 and 4 files and DVDs on the network in unicast or +multicast ; or used as a client to receive, decode and display MPEG streams +under multiple operating systems. + + + + + +Here is an illustration of the complete VideoLAN solution : + + + +
Global VideoLAN solution + + + + + +
+ + + +More details about the project can be found on the +VideoLAN Web site. + + + +VideoLAN software + +VideoLAN Client + + + +The VideoLAN Client (VLC) works on many platforms : Linux, Windows, Mac +OS X, BeOS, *BSD, Solaris, Familiar Linux and QNX. It can read : + + + + + +MPEG 1, MPEG 2 and MPEG 4 / DivX files from a hard disk +or a CD-ROM drive, + +DVDs and VCDs, + +from a satellite card, + +MPEG 1, MPEG 2 and MPEG 4 streams from the +network sent by VLS or VLC's stream output. + + + +VLC can also be used as a server to stream : + + + +MPEG 1, MPEG 2 and MPEG 4 / DivX files, + +and DVDs, + + + +to : + + + +one machine (i.e. to one IP address) : this is called +unicast ; + +a dynamic group of machines that the clients can join or leave +(i.e. to a multicast IP address) : this is called +multicast. + + + +VLC doesn't work on Mac OS 9, and will +probably never do. + +VideoLAN Server + + + +The VideoLAN Server (VLS) can stream : + + + + + +an MPEG 1 or MPEG 2 file stored on a hard drive or on a +CD, + +a DVD located in a local DVD drive or copied on a hard +disk, + +a satellite card or a digital terrestial television card, + +an MPEG encoding card ; + + + +to : + + + +one machine (i.e. to one IP address) : this is called +unicast ; + +a dynamic group of machines that the clients can join or leave +(i.e. to a multicast IP address) : this is called +multicast. + + + + + +A Pentium 100 MHz with 32 MB of memory should be enough to send one +stream on the network. When streaming a lot of videos stored on a +hard drive, the actual limitation is not the processor but the hard +drive and the network connection. + + + + + +VLS works under Linux and Windows, but only the Linux version +have all the functionalities. The Windows port of vls can +only stream a video from a file. + + + +How can I use VideoLAN ? + +The documentation + + + +The user documentation of the VideoLAN project is composed of four documents : + + + + + +the VideoLAN +Quickstart. This document will give you a quick overview of +of VLC, VLS, and the Video On Demand +solution. + +the VideoLAN +HOWTO. This document is the complete guide of the VideoLAN +streaming solution. + +the VLC user +guide. This document is the complete guide for VLC. + +the VLC FAQ. This +document contains Frequently Asked Questions of VLC users. + + + + + + +The latest version of these documents can be found on the VideoLAN Web site. + + + +User support + + + +If you have problems using VideoLAN, and if you don't find the +answer to your problems in the documentation, please look at the +online archive of the +mailing-lists. There are two English-speaking mailing-lists for +the users : + + + + + +vlc@videolan.org for the questions +on VLC, + +streaming@videolan.org for the questions +on VLS, mini-VLCS and the network. + + + + + +If you want to subscribe or unsubscribe to the mailing-lists, +please go to the +mailing-list page. + + + +You can also talk with VideoLAN users and developers on IRC : +server irc.freenode.net, channel +#videolan. + +If you find a bug, please follow the instructions on the bug reporting +page. + +Convention + +In this document, we adopt the following conventions for the Unix +commands : + + + +commands that should be typed as +root have a # prompt : + + +# command_to_be_typed_as_root + + +commands that should be typed as a regular user have a +% prompt : + + +% command_to_be_typed_as_regular_user + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml b/LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml new file mode 100644 index 00000000..a75462ae --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml @@ -0,0 +1 @@ + diff --git a/LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml b/LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml new file mode 100644 index 00000000..058e7a06 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml @@ -0,0 +1 @@ + diff --git a/LDP/ref/docbook/VLC-User-Guide/magic.sgml b/LDP/ref/docbook/VLC-User-Guide/magic.sgml new file mode 100644 index 00000000..058e7a06 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/magic.sgml @@ -0,0 +1 @@ + diff --git a/LDP/ref/docbook/VLC-User-Guide/modules.sgml b/LDP/ref/docbook/VLC-User-Guide/modules.sgml new file mode 100644 index 00000000..523a4d86 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/modules.sgml @@ -0,0 +1,740 @@ +Modules and options for VLC + +The modules + +VLC uses a modular system, which allows to add easily new fonctions +and formats. Here is a description of nearly all the VLC +modules. If you installed VLC through a binary file, you will get +the default modules. If, however, you want to customize VLC to your +needs, you will have to compile the VLC from sources. + +If you don't intend to compile the VLC and +want only the regular functions, reading this part is not very +useful. + + The compilation itself is explained in the next chapter. + +If you wish to compile a module which is stated disabled +by default, you have to launch the configure script with : + + + +% ./configure --enable-module_name + + +On the other hand, if you would like to disable a module that is +enabled by default, you would have to use : + + +% ./configure --disable-module_name + + + + + +Video outputs + +Video outputs are the modules that enable the support of some +systems to display the video on your screen. + +x11 + +default: enabled + +For Unix with X11 servers only + +This is the basic x11 video output. It only requires a +working X11 server. You will need xlibs headers to compile it +(xlibs-dev package on Debian systems). + + +xvideo + +default: enabled + +For Linux only + +It requires an xvideo compliant graphic card (it is the case for +nearly all modern cards). It uses hardware acceleration for YUV +transformation and rescaling. + + +sdl + +default: enabled + +This video output uses sdl libraries. You need at least version +1.1.6 of this libraries. + + You may indicate the path to the sdl-config +program with the --with-sdl-config-path=PATH +switch, when running the configre script. + + +directx + +default: enabled on win32 + +For Windows only + +This video output uses Microsoft Direct X libraries. It is +recommended for the win32 port. + +You may indicate the path to directX libraries and headers with +the --with-directx=PATH switch, when running the +configure script. + + +wingdi + +default: enabled on win32 + +For Windows only + +This video output uses GDI. It is designed for users who don't +have Direct X, but the perfs are very low. If you have DirectX, do not +use it. + + + +fb + +default: enabled on Linux + +For Linux only + +This is the frame buffer video output. It requires that your +kernel was compiled with frame buffer support. + + +glide + +default: disabled + +This video output uses Glide libraries (hardware acceleration for +3Dfx cards). + +You may indicate the path to the library with the +--with-glide=PATH configure option. /para> + +mga + +default: disabled + +For Linux only + +This module provides hardware acceleration for Matrox cards under +Linux. + +ggi + +default: disabled + + +aa + +default: disabled + +This is the ASCII Art Video Output. This video output uses the +aalib library to display video through ASCII art. It requires aalib +headers (aalib1-dev package under Debian) to +compile. + + +svgalib + +default: disabled + +For Linux only + +This is a video output for the SVGAlib library. + + +qte + +default: disabled + +For iPaq only + +This is a video output for QT Embedded, an iPaq-specifiq graphical +library. + + + + +Video filters modules + +These modules allow you to perform modifications on the rendered +image. + +deinterlace + +default: enabled + +This filter deinterlaces video. It is useful with streams coming +from a digital satellite channel or digital terrestial television +channels. + + +wall + +default: enabled + +This filter allows you to have the video cut in pieces in several +windows, which you can order as you wish. It can be used to generate +image walls with several sources. Start it with : + + +% vlc --filter wall:XxY .... + + +in order to have the video cut in X rows and +Y columns + + +distort + +default: enabled + +This filter adds a distortion effect to the video. Who said it was +useless ? :-) + + +transform + +default: enable + +This filter rotates the video window of 90 degrees. + + +invert + +default: enabled + +This filter inverses colors. + + + + + +Sound outputs + +These modules allow you to choose the way the sound will be output +to your audio system. + +oss + +default: enabled on Linux + +For Unix/Linux only + +This is the audio output for OSS (Open Sound System) output +(/dev/dsp, for exemple, under Linux). It requires +that your kernel was compiled with support for your sound card. + + +alsa + +default: disabled + +For Linux only + +This is the sound output for ALSA (Advanced Linux Sound +Architecture). It only works under Linux, and it requires that you +installed the ALSA drivers and libraries. + + +esd + +default: disabled + +For Unix/Linux only + +This sound output has ESD (Enlightened Sound Daemon) support +(usually used with Gnome). You must have the daemon and its libraries +installed. + + +arts + +default: disabled + +For Unix/Linux only + +This sound output has aRts (KDE's sound server) support. You must +have the daemon and its libraries installed. + + +waveout + +default: enabled on win32 + +This is the Wave output, which is used by the win32 port. + + + + + +Input modules + +These modules allow VLC to read its streams from different +sources. + +dvdplay + +default: enabled + +This is the regular DVD input module. It will need +libdvdcss for DVD decryption (see the libdvdcss page) +and libdvdplay for DVD navigation (see the libdvdplay +page). + + + +dvdold + +default: enabled + +This is the old DVD input module. It uses +libdvdcss for DVD decryption (see the +libdvdcss +page). + + + +dvdread + +default: disabled + +This is an alternative to the previous ones. It uses +libdvdread for DVD reading (see the Ogle +download page) and libdvdcss +for DVD decryption (see the libdvdcss +page). + + + +vcd + +default: enabled + +This is the VideoCD input. + + +http + +default: enabled + +This is the HTTP input. You can use it for Video On Demand. + + +satellite + +default: disabled + +This is an input module that allows to read +directly from a Hauppauge WinTV Nova card under Linux. +It requires drivers 0.9.4 available from linuxtv.org. + + + +v4l + +default: disabled + +For Linux only + +This module allows to get Video4Linux streams. + + + + + +Demuxers + +Demuxers or demultiplexers allow VLC to extract the stream(s) +from the file or source where they are into. + +For example, an AVI file can contain a MPEG-4 video, or an +uncompressed video. AVI is only a storing format, not a compression +format. + +avi + +default: enabled + +This module allows you to read .avi files. + + +asf + +default: enabled + +This module allows you to read .asf files. + + +aac + +default: enabled + +This module allows to you read AAC files. + + +ogg + +default: enabled + +This module allows to you read OGG files. + + +rawdv + +default: enabled + +This module allows to you read DV files. + + +dvbpsi + +default: enabled + +This module allows to demux streams from a satellite card. + + +mp4 + +default: enabled + +This module is the MPEG-4 demuxer. + + + + + + +Interface modules + +These modules allow you to choose the interface you want to use. + +gtk + +default: enabled + +This is the GTK+ interface. It needs gtk libraries +(libgtk1.2 package on Debian) and headers files +if you are compiling it (libgtk1.2-dev package on +Debian). Note that it can also be used under Windows. + + +gnome + +default: disabled + +For Linux only + +This is the Gnome interface. It needs gnome libraries +(libgnome32 package under Debian) and headers +(libgnome-dev package under Debian) if you wish to +compile it. + +intfwin + +default: enabled on win32 + +For Windows only + +This is the Windows native interface. It requires +Borland C++ builder to compile. You may use the +--with-bc-builder=PATH option to specify the path to +this application. + + +qt + +default: disabled + +This is the QT interface module. You will need the libraries +(libqt2 package on Debian) and headers +(libqt-dev package under Debian) if you wish to +compile it. + + +kde + +default: disabled + +This is the KDE interface module. You will need the libraries +(kdelibs3 package on Debian) and headers +(kde-devel package under Debian) if you wish to +compile it. + + +rc + +default: enabled + +This is the Remote Control interface module. It allows you +to control VLC via commands, such as play, +stop, etc... or via a script. + + +ncurses + +default: disabled + +This is a text interface, using ncurses library. +You will need ncurses headers if you want to compile it +(libncurses5-dev package on Debian). + + +lirc + +default: disabled + +This interface module allows you to control VLC through a remote. +A lircrc example is provided to help you configure it to your remote +(see doc/lirc/example.lircrc). + + +wxwindows + +default: enabled + +The wxWindows interface is a portable interface meant to +replace win32, gnome and Gtk interface, but it is not completely +finished. + + +opie + +default: disabled + +This is an interface plugin for the Qt Embedded library (iPaq +graphical library). + + + + + + +Codec modules + +The following modules add codec (ie, compression formats) +support. + +a52 + +default: disabled + +This is a better AC3/A52 decoder than the built-in one, based on +liba52 (see the liba52 web +site. + + + +ffmpeg + +default: disabled + +This is a free MPEG-4/DivX/OpenDivX codec : ffmpeg (see the ffmpeg web site. + + + +vorbis + +default: enabled + +This codec allows you to read the OGG/Vorbis files. + + +dv + +default: disabled + +This codec allows you to read DV-encoded files. + + +xvid + +default: disabled + +This codec allows you to read files encoded with Xvid (see Xvid web site). + + +mad + +default: disabled + +This codec is a very smart MP3 decoder, that only uses integers. +This allows its use for CPU which don't handle floating point numbers +(on PDA, for exemple). + + +faad + +default: disabled + +Faad is an MPEG-4 audio decoder (see the FAAC web site). + + + +tarkin + +default: disabled + +tarkin is a new codec (experimental) by the Ogg Project (see the +Ogg Vorbis web site). + + + + +theora + +default: disabled + +theora is an experimental video codec by the Ogg Project (see the +Ogg Vorbis web site). + + + +cinepak + +default: enabled + +This is the codec for the Cinepak format. + + +tremor + +default: disabled + +This is an Ogg/Vorbis codec that only makes integer calculus, +which allow its use on CPU which don't have floating point support +(see the Ogg Vorbis web +site). + + + + + + +OS support modules + +The following modules add support for different OSs. + +macosx + +default: enabled on MacOS X + +For MacOS X only + +This is the MacOS X support module, including a native +interface. + + + +qnx + +default: enabled on qnx + +For QNX only + +This is the QNX RTOS support module. + + + + + + + +Miscellaneous + +This section describes a few more modules that don't belong to any +of the categories described before. + +sout + +default: enabled + +Stream Output is a new feature of VLC that allows +it to stream an MPEG-1, MPEG-2 or MPEG-4/DivX file or a DVD. + +For more details, please have a look at the or +sections. + + + +test-suite + +default: disabled + +This builds a special VLC, for testing purposes only. + + + + +mozilla + +default: disabled + +This is not really a module. When enabled, a VLC-based Mozilla +plugin is built. + + + +slp + +default: enabled + +This enables the SLP service discovery protocol. + + +xosd + +default: disabled + +For Unix only + +This plugin outputs the current stream to an "OSD" (On Screen +Display). + + + + + +Compilation Options + +There are a few options that you can set when running the +configure script, which are not related to modules. + +You can have a look at these options by typing : + + +% ./configure --help + + +You can for example control all the installation directories, +the system for which you want to build VLC for (if not guessed +correctly),... + +You can also choose to enable or disable some optimizations. + +--disable-plugins + +If you select this option, no plugins will be enabled. This is +definitely not recommended, as you would get a very poor VLC, and should +only be used for testing purposes. + + + + + + diff --git a/LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml b/LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml new file mode 100644 index 00000000..cf305a1f --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml @@ -0,0 +1,46 @@ + +Vls can stream MPEG 1 or MPEG 2 files that meet two +critera : + + + + +the file must be MPEG PS +(Program Stream) or MPEG TS (Transport Stream), +that contain video and audio multiplexed. Vls cannot stream MPEG +ES (Elementary Stream), i.e. a file with only audio +or video. + +In order to know if an MPEG file is MPEG PS, +MPEG TS or MPEG ES, read the +file with vlc and look at the messages (select in the menu +View / Messages, or use the command line +vlc -v) and look for a +line : + + +module: locking demux module `mpeg_XX' + + +If XX = ps or XX = +ts, then your file is MPEG PS and +MPEG TS respectively, and you may be able to +stream it. If XX = es, then your file is MPEG +ES and is not streamable. + +the sequence header of the video must repeat itself regularly, +which is often the case with MPEG 2, but very rare with MPEG 1. There is +no easy way to know if the sequence header is repeated regularly. Files +with a .vob extension are normally MPEG +2 files and files with .mpg or +.mpeg extension or +usually +MPEG 1 files. + + + +You can download this streamable +MPEG 2 PS file for your tests : presentation_short.vob. + diff --git a/LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml b/LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml new file mode 100644 index 00000000..69aa3514 --- /dev/null +++ b/LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml @@ -0,0 +1,54 @@ +Under Windows + +Click on the Uninstall VLC icon that was +created during installation. + + + +Under BeOS + +Delete the vlc-version +directory. You can also remove the configuration file +/boot/home/config/settings/vlcrc. + + + +Under Mac OS X + +Drag the VLC application to your trash can. + + + +Under Linux Debian + +Remove the packages that you installed : + + +# apt-get remove --purge vlc-gnome vlc-mad libdvdcss2 libdvbpsi1 + + + +Under Linux Redhat, Mandrake and SuSE + + +Uninstall the RPM packages that you installed : + + + +# rpm -e vlc-version vlc-mad-version vlc-gnome-version +libdvdcss2-version libdvdpsi1-version + + + + +If you compiled VLC from sources + + +Go to the directory containing VLC sources and execute : + + +# make uninstall + + +Then you can remove the VLC sources. +