source: multimedia/libdriv/gstreamer10.xml

trunk
Last change on this file was 17c4d8d, checked in by Bruce Dubbs <bdubbs@…>, 5 days ago

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