source: multimedia/libdriv/gstreamer10.xml@ 794a5d8

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 794a5d8 was 794a5d8, checked in by Douglas R. Reno <renodr@…>, 15 months ago

Update the gstreamer stack to 1.18.0

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

  • Property mode set to 100644
File size: 11.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 gstreamer10-download-http "&gstreamer-dl;/gstreamer/gstreamer-&gstreamer10-version;.tar.xz">
8 <!ENTITY gstreamer10-download-ftp " ">
9 <!ENTITY gstreamer10-md5sum "25d683630ff8b82b2c878aa3edd3c491">
10 <!ENTITY gstreamer10-size "2.6 MB">
11 <!ENTITY gstreamer10-buildsize "60 MB (with tests)">
12 <!ENTITY gstreamer10-time "0.6 SBU (Using parallelism=4; with tests)">
13]>
14
15<sect1 id="gstreamer10" xreflabel="gstreamer-&gstreamer10-version;">
16 <?dbhtml filename="gstreamer10.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>gstreamer-&gstreamer10-version;</title>
24
25 <indexterm zone="gstreamer10">
26 <primary sortas="a-gstreamer">gstreamer</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to gstreamer</title>
31
32 <para>
33 <application>gstreamer</application> is a streaming media framework that
34 enables applications to share a common set of plugins for tasks such as
35 video encoding and decoding, audio encoding and decoding, audio and video
36 filters, audio visualisation, web streaming and anything else that
37 streams in real-time or otherwise. This package only provides base
38 functionality and libraries. You may need at least <xref
39 linkend="gst10-plugins-base"/> and one of Good, Bad, Ugly or Libav
40 plugins.
41 </para>
42
43 &lfs10_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>
49 Download (HTTP): <ulink url="&gstreamer10-download-http;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download (FTP): <ulink url="&gstreamer10-download-ftp;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download MD5 sum: &gstreamer10-md5sum;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download size: &gstreamer10-size;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated disk space required: &gstreamer10-buildsize;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated build time: &gstreamer10-time;
75 </para>
76 </listitem>
77 </itemizedlist>
78<!--
79 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>
83 Required patch: <ulink
84 url="&patch-root;/gstreamer-&gstreamer10-version;-buffer_size_reset_fix-1.patch"/>
85 </para>
86 </listitem>
87 </itemizedlist>
88-->
89 <bridgehead renderas="sect3">gstreamer Dependencies</bridgehead>
90
91 <bridgehead renderas="sect4">Required</bridgehead>
92 <para role="required">
93 <xref linkend="glib2"/>
94 </para>
95
96 <!-- Required for GNOME -->
97 <bridgehead renderas="sect4">Recommended</bridgehead>
98 <para role="recommended">
99 <xref linkend="gobject-introspection"/>
100 </para>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <xref linkend="gtk3"/> (for examples),
105 <xref linkend="gsl"/>,
106 <xref linkend="valgrind"/>,
107 <ulink url="https://github.com/scop/bash-completion/">bash-completion</ulink>,
108 <ulink url="https://pypi.org/project/hotdoc/">hotdoc</ulink>,
109 <ulink url="https://sourceware.org/elfutils/">libdw</ulink>, and
110 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>
111 </para>
112
113 <para condition="html" role="usernotes">
114 User Notes: <ulink url="&blfs-wiki;/gstreamer10"/>
115 </para>
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of gstreamer</title>
120
121 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
122 href="../../xincludes/gst10-objc-error.xml"/>
123<!--
124 <para>
125 At first, fix a problem causing memory leaking and spurious warnings:
126 </para>
127
128<screen><userinput>patch -Np1 -i ../gstreamer-&gstreamer10-version;-buffer_size_reset_fix-1.patch</userinput></screen>
129-->
130 <para>
131 First, fix a regression in the test suite:
132 </para>
133
134<screen><userinput remap="pre">sed -i "s/leaks.c'/&amp;, not tracer_hooks or not gst_debug/" -i tests/check/meson.build</userinput></screen>
135
136 <para>
137 Install <application>gstreamer</application> by running the following
138 commands:
139 </para>
140
141<screen><userinput>mkdir build &amp;&amp;
142cd build &amp;&amp;
143
144meson --prefix=/usr \
145 -Dbuildtype=release \
146 -Dgst_debug=false \
147 -Dpackage-origin=http://www.linuxfromscratch.org/blfs/view/svn/ \
148 -Dpackage-name="GStreamer &gstreamer10-version; BLFS" &amp;&amp;
149ninja</userinput></screen>
150
151 <para>
152 To test the results, issue: <command>ninja test</command>.
153 </para>
154
155 <caution>
156 <para>
157 If you are reinstalling <application>gstreamer</application> from a
158 previous version, it is best if you remove the prior version, including
159 plugins, before installing the new version. If there is a mixture of
160 versions installed, using processes may hang or not work properly. As
161 the <systemitem class="username">root</systemitem> user:
162 </para>
163
164<screen role="nodump"><userinput>rm -rf /usr/bin/gst-* /usr/{lib,libexec}/gstreamer-1.0</userinput></screen>
165 </caution>
166
167 <para>
168 Now, as the <systemitem class="username">root</systemitem> user:
169 </para>
170
171<screen role="root"><userinput>ninja install</userinput></screen>
172
173 </sect2>
174
175 <sect2 role="content">
176 <title>Contents</title>
177
178 <segmentedlist>
179 <segtitle>Installed Programs</segtitle>
180 <segtitle>Installed Libraries</segtitle>
181 <segtitle>Installed Directories</segtitle>
182
183 <seglistitem>
184 <seg>
185 gst-inspect-1.0, gst-launch-1.0, gst-stats-1.0, gst-tester-1.0,
186 and gst-typefind-1.0
187 </seg>
188 <seg>
189 libgstbase-1.0.so, libgstcheck-1.0.so, libgstcontroller-1.0.so,
190 libgstnet-1.0.so, and libgstreamer-1.0.so
191 </seg>
192 <seg>
193 /usr/{include,lib,libexec,share}/gstreamer-1.0
194 </seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <varlistentry id="gst-inspect-1.0">
204 <term><command>gst-inspect-1.0</command></term>
205 <listitem>
206 <para>
207 is a tool that prints out information on available
208 <application>gstreamer</application> plugins,
209 information about a particular plugin, or information
210 about a particular element.
211 </para>
212 <indexterm zone="gstreamer10 gst-inspect-1.0">
213 <primary sortas="b-gst-inspect-1.0">gst-inspect-1.0</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="gst-launch-1.0">
219 <term><command>gst-launch-1.0</command></term>
220 <listitem>
221 <para>
222 is a tool that builds and runs basic
223 <application>gstreamer</application> pipelines.
224 </para>
225 <indexterm zone="gstreamer10 gst-launch-1.0">
226 <primary sortas="b-gst-launch-1.0">gst-launch-1.0</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="gst-stats-1.0">
232 <term><command>gst-stats-1.0</command></term>
233 <listitem>
234 <para>
235 is a tool used to gather statistics about
236 <application>gstreamer</application> operations.
237 </para>
238 <indexterm zone="gstreamer10 gst-stats-1.0">
239 <primary sortas="b-gst-stats-1.0">gst-stats-1.0</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="gst-tester-1.0">
245 <term><command>gst-tester-1.0</command></term>
246 <listitem>
247 <para>
248 runs a test plan in TAP compatible format while integrating with
249 the meson test harness.
250 </para>
251 <indexterm zone="gstreamer10 gst-tester-1.0">
252 <primary sortas="b-gst-tester-1.0">gst-tester-1.0</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="gst-typefind-1.0">
258 <term><command>gst-typefind-1.0</command></term>
259 <listitem>
260 <para>
261 uses the <application>gstreamer</application> type finding system
262 to determine the relevant <application>gstreamer</application>
263 plugin to parse or decode files, and the corresponding MIME type.
264 </para>
265 <indexterm zone="gstreamer10 gst-typefind-1.0">
266 <primary sortas="b-gst-typefind-1.0">gst-typefind-1.0</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="libgstbase-1.0">
272 <term><filename class="libraryfile">libgstbase-1.0.so</filename></term>
273 <listitem>
274 <para>
275 provides some base classes to be extended by elements and utillity
276 classes that are most useful for plugin developers.
277 </para>
278 <indexterm zone="gstreamer10 libgstbase-1.0">
279 <primary sortas="c-libgstbase-1.0">libgstbase-1.0.so</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="libgstcheck-1.0">
285 <term><filename class="libraryfile">libgstcheck-1.0.so</filename></term>
286 <listitem>
287 <para>
288 provides functionality for writing unit tests that use the check
289 framework.
290 </para>
291 <indexterm zone="gstreamer10 libgstcheck-1.0">
292 <primary sortas="c-libgstcheck-1.0">libgstcheck-1.0.so</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="libgstcontroller-1.0">
298 <term><filename class="libraryfile">libgstcontroller-1.0.so</filename></term>
299 <listitem>
300 <para>
301 provides functionality to animate element properties over time.
302 </para>
303 <indexterm zone="gstreamer10 libgstcontroller-1.0">
304 <primary sortas="c-libgstcontroller-1.0">libgstcontroller-1.0.so</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="libgstnet-1.0">
310 <term><filename class="libraryfile">libgstnet-1.0.so</filename></term>
311 <listitem>
312 <para>
313 provides network elements and objects.
314 </para>
315 <indexterm zone="gstreamer10 libgstnet-1.0">
316 <primary sortas="c-libgstnet-1.0">libgstnet-1.0.so</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="libgstreamer-1.0">
322 <term><filename class="libraryfile">libgstreamer-1.0.so</filename></term>
323 <listitem>
324 <para>
325 provides all of the core <application>gstreamer</application>
326 services, including initialization, plugin management and types,
327 as well as the object hierarchy that defines elements and bins,
328 along with some more specialized elements.
329 </para>
330 <indexterm zone="gstreamer10 libgstreamer-1.0">
331 <primary sortas="c-libgstreamer-1.0">libgstreamer-1.0.so</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 </variablelist>
337
338 </sect2>
339
340</sect1>
Note: See TracBrowser for help on using the repository browser.