source: multimedia/libdriv/xine-lib.xml@ d8fcdce

10.0 10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since d8fcdce was d8fcdce, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Add libdvdcss as an optional dependency of xine-lib

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23524 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY xine-lib-download-http
8 "&sourceforge-dl;/xine/xine-lib-&xine-lib-version;.tar.xz">
9 <!ENTITY xine-lib-download-ftp "&gentoo-ftp-repo;/xine-lib-&xine-lib-version;.tar.xz">
10 <!ENTITY xine-lib-md5sum "f4ac0fc08d74e1b8f3c389617ee9cfdc">
11 <!ENTITY xine-lib-size "5.0 MB">
12 <!ENTITY xine-lib-buildsize "102 MB (wtih API documentation)">
13 <!ENTITY xine-lib-time "0.6 SBU (Using parallelism=4; with API documentation)">
14]>
15
16<sect1 id="xine-lib" xreflabel="xine-lib-&xine-lib-version;">
17 <?dbhtml filename="xine-lib.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>xine-lib-&xine-lib-version;</title>
25
26 <indexterm zone="xine-lib">
27 <primary sortas="a-Xine-Libraries">Xine Libraries</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Xine Libraries</title>
32
33 <para>
34 The <application>Xine Libraries</application> package contains xine
35 libraries. These are useful for interfacing with external plug-ins that
36 allow the flow of information from the source to the audio and video
37 hardware.
38 </para>
39
40 &lfs91_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&xine-lib-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&xine-lib-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &xine-lib-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &xine-lib-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &xine-lib-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &xine-lib-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Xine Libraries Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="x-window-system"/>,
81 <xref linkend="ffmpeg"/>, and at least one of:
82 <xref linkend="alsa"/>,
83 <xref linkend='pulseaudio'/>, or
84 <ulink url="http://jackaudio.org/">JACK</ulink>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="libdvdnav"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="aalib"/>,
95 <xref linkend="faad2"/>,
96 <xref linkend="flac"/>,
97 <xref linkend="gdk-pixbuf"/>,
98 <xref linkend="glu"/>,
99 <xref linkend="imagemagick"/>,
100 <xref linkend="liba52"/>,
101 <xref linkend="libdvdcss"/>,
102 <xref linkend="libmad"/>,
103 <xref linkend="libmng"/>,
104 <xref linkend="libtheora"/>,
105 <xref linkend="libva"/> (requires <xref role="nodep" linkend="glu"/>),
106 <xref linkend="libvdpau"/>,
107 <xref linkend="libvorbis"/>,
108 <xref linkend="libvpx"/>,
109 <xref linkend="mesa"/>,
110 <xref linkend="samba"/>,
111 <xref linkend="sdl"/>,
112 <xref linkend="speex"/>,
113 <xref linkend="doxygen"/> (to create the API documentation),
114 <xref linkend="v4l-utils"/>
115 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
116 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
117 <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
118 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
119 <ulink url="http://fame.sourceforge.net">libFAME</ulink>,
120 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
121 <ulink url="http://www.musepack.net/">musepack</ulink>,
122 <ulink url="&gnu-http;/vcdimager/">VCDImager</ulink>, and
123 <ulink url="http://www.wavpack.com/">WavPack</ulink>,
124 </para>
125
126 <para condition="html" role="usernotes">
127 User Notes: <ulink url="&blfs-wiki;/xine-lib"/>
128 </para>
129 </sect2>
130
131 <sect2 role="installation">
132 <title>Installation of Xine Libraries</title>
133
134 <para>
135 First fix an issue introduced by GCC-10 and later:
136 </para>
137
138<screen><userinput>sed -e 's/^const/extern &amp;/' \
139 -i src/libreal/real_common.h</userinput></screen>
140
141 <para>
142 Install <application>Xine Libraries</application> by running the following
143 commands:
144 </para>
145
146<screen><userinput>./configure --prefix=/usr \
147 --disable-vcd \
148 --with-external-dvdnav \
149 --docdir=/usr/share/doc/xine-lib-&xine-lib-version; &amp;&amp;
150make</userinput></screen>
151
152 <para>
153 To create the API documentation, <application>Doxygen</application>
154 must be installed and issue the following command:
155 </para>
156
157<screen remap="doc"><userinput>doxygen doc/Doxyfile</userinput></screen>
158
159 <para>
160 This package does not come with a test suite.
161 </para>
162
163 <para>
164 Now, as the <systemitem class="username">root</systemitem> user:
165 </para>
166
167<screen role="root"><userinput>make install</userinput></screen>
168
169 <note>
170 <para>
171 When installing, the Makefile does some additional
172 linking. If you do not have Xorg in /usr, the LIBRARY_PATH
173 variable needs to be defined for the root user. If
174 using sudo to assume root, use the -E option to pass
175 your current environment variables for the install process.
176 </para>
177 </note>
178
179 <para>
180 If you built the API documentation, issue the following commands as
181 the <systemitem class="username">root</systemitem> user to install it:
182 </para>
183
184<screen role="root"
185 remap="doc"><userinput>install -v -m755 -d /usr/share/doc/xine-lib-&xine-lib-version;/api &amp;&amp;
186install -v -m644 doc/api/* \
187 /usr/share/doc/xine-lib-&xine-lib-version;/api</userinput></screen>
188 </sect2>
189
190 <sect2 role="commands">
191 <title>Command Explanations</title>
192
193 <para>
194 <parameter>--disable-vcd</parameter>: This switch is required to compile
195 <application>Xine Lib</application> without <ulink
196 url="&gnu-http;/vcdimager/">VCDImager</ulink> installed.
197 Remove this option if you have installed VCDImager.
198 </para>
199
200 <para>
201 <parameter>--with-external-dvdnav</parameter>: This switch is required,
202 because internal libraries cannot decrypt DVD.
203 </para>
204
205 <para>
206 <parameter>--docdir=/usr/share/doc/xine-lib-&xine-lib-version;</parameter>:
207 This switch causes the documentation to be installed into a versioned
208 directory instead of the default <filename
209 class="directory">/usr/share/doc/xine-lib</filename>.
210 </para>
211
212 <para>
213 <option>--disable-vaapi</option>: use this switch if <xref
214 linkend="libva"/> is installed and <xref linkend="glu"/>
215 is not, to prevent a build failure.
216 </para>
217
218 </sect2>
219
220 <sect2 role="content">
221 <title>Contents</title>
222
223 <segmentedlist>
224 <segtitle>Installed Programs</segtitle>
225 <segtitle>Installed Libraries</segtitle>
226 <segtitle>Installed Fonts</segtitle>
227 <segtitle>Installed Directories</segtitle>
228<!-- When updating, check plugins subdir -->
229 <seglistitem>
230 <seg>xine-config and xine-list-1.2</seg>
231 <seg>libxine.so and numerous plugin modules and video extensions under
232 /usr/lib/xine/plugins/2.8</seg>
233 <seg>
234 Output display engine fonts located in /usr/share/xine-lib/fonts
235 </seg>
236 <seg>
237 /usr/include/xine,
238 /usr/lib/xine,
239 /usr/share/xine-lib, and
240 /usr/share/doc/xine-lib-&xine-lib-version;
241 </seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="xine-config">
251 <term><command>xine-config</command></term>
252 <listitem>
253 <para>
254 provides information to programs trying to link with the
255 <application>xine</application> libraries.
256 </para>
257 <indexterm zone="xine-lib xine-config">
258 <primary sortas="b-xine-config">xine-config</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="xine-list-1.2">
264 <term><command>xine-list-1.2</command></term>
265 <listitem>
266 <para>
267 is used to get supported filetype information from
268 <application>xine-lib</application>.
269 </para>
270 <indexterm zone="xine-lib xine-list-1.2">
271 <primary sortas="b-xine-list-1.2">xine-list-1.2</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="libxine">
277 <term><filename class='libraryfile'>libxine.so</filename></term>
278 <listitem>
279 <para>
280 provides the API for processing audio/video files.
281 </para>
282 <indexterm zone="xine-lib libxine">
283 <primary sortas="c-libxine">libxine.so</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287 </variablelist>
288 </sect2>
289</sect1>
Note: See TracBrowser for help on using the repository browser.