source: multimedia/libdriv/sdl.xml@ da30dbc

7.6-blfs 7.6-systemd kde5-14686 systemd-13485
Last change on this file since da30dbc was da30dbc, checked in by Christopher Gregory <cjg@…>, 7 years ago

Corrected download link for svgalib on sdl page.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@14103 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.2 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 sdl-download-http "http://www.libsdl.org/release/SDL-&sdl-version;.tar.gz">
8 <!ENTITY sdl-download-ftp " ">
9 <!ENTITY sdl-md5sum "9d96df8417572a2afb781a7c4c811a85">
10 <!ENTITY sdl-size "3.8 MB">
11 <!ENTITY sdl-buildsize "40 MB">
12 <!ENTITY sdl-time "0.6 SBU">
13]>
14
15<sect1 id="sdl" xreflabel="SDL-&sdl-version;">
16 <?dbhtml filename="sdl.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>SDL-&sdl-version;</title>
24
25 <indexterm zone="sdl">
26 <primary sortas="a-SDL">SDL</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to SDL</title>
31
32 <para>The Simple DirectMedia Layer (<application>SDL</application>
33 for short) is a cross-platform library designed to make it easy to write
34 multimedia software, such as games and emulators.</para>
35
36 &lfs76_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&sdl-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&sdl-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &sdl-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &sdl-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &sdl-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &sdl-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">SDL Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Optional</bridgehead>
63 <para role="optional">
64 <xref linkend="alsa"/>,
65 <xref linkend='pulseaudio'/>
66 <xref linkend="nasm"/>,
67 <xref linkend="x-window-system"/>,
68 <xref linkend="glu"/>,
69 <xref linkend="aalib"/>,
70 <xref linkend="pth"/>,
71 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
72 <ulink url="http://www.ggi-project.org/">GGI</ulink>,
73 <ulink url="http://mail.arava.co.il/~matan/svgalib/">SVGAlib-1.9.5</ulink>
74 (<ulink url="&patch-root;/svgalib-1.9.25-megafixes-1.patch">patched</ulink>),
75 <ulink url="http://caca.zoy.org/wiki/libcaca">libcaca</ulink> and
76 <ulink url="http://picogui.org/">PicoGUI</ulink>
77 </para>
78
79 <para condition="html" role="usernotes">User Notes:
80 <ulink url="&blfs-wiki;/sdl"/></para>
81
82 </sect2>
83
84 <sect2 role="installation">
85 <title>Installation of SDL</title>
86
87 <para>Install <application>SDL</application> by running the
88 following commands:</para>
89
90<screen><userinput>sed -i '/_XData32/s:register long:register _Xconst long:' src/video/x11/SDL_x11sym.h &amp;&amp;
91
92./configure --prefix=/usr --disable-static &amp;&amp;
93make</userinput></screen>
94
95 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
96
97<screen role="root"><userinput>make install &amp;&amp;
98
99install -v -m755 -d /usr/share/doc/SDL-&sdl-version;/html &amp;&amp;
100install -v -m644 docs/html/*.html \
101 /usr/share/doc/SDL-&sdl-version;/html</userinput></screen>
102
103 </sect2>
104
105 <sect2 role="testing">
106 <title>Testing SDL</title>
107
108 <para>If you wish to, test the installation of
109 <application>SDL</application> using the included
110 test programs. It is not required to install any of the resulting binaries
111 to validate the installation. Issue the following commands to build the
112 test programs:</para>
113
114<screen><userinput>cd test &amp;&amp;
115./configure &amp;&amp;
116make</userinput></screen>
117
118 <para>You'll need to manually run all the test programs (they are listed in
119 the <filename>README</filename> file in this directory). Many of them will
120 need to be manually killed, and you'll need to turn your speakers on with the
121 volume at a suitable level.</para>
122
123 </sect2>
124
125 <sect2 role="commands">
126 <title>Command Explanations</title>
127
128 <para><command>sed -i ...</command>: This command fixes compilation with libX11-1.6.0</para>
129
130 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
131 href="../../xincludes/static-libraries.xml"/>
132
133 </sect2>
134
135 <sect2 role="configuration">
136 <title>Configuring SDL</title>
137
138 <sect3>
139 <title>Configuration Information</title>
140
141 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
142 href="../../xincludes/lib-config.xml"/>
143
144 </sect3>
145
146 </sect2>
147
148 <sect2 role="content">
149 <title>Contents</title>
150
151 <segmentedlist>
152 <segtitle>Installed Program</segtitle>
153 <segtitle>Installed Libraries</segtitle>
154 <segtitle>Installed Directories</segtitle>
155
156 <seglistitem>
157 <seg>sdl-config</seg>
158 <seg>libSDL.so and libSDLmain.a</seg>
159 <seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
160 </seglistitem>
161 </segmentedlist>
162
163 <variablelist>
164 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
165 <?dbfo list-presentation="list"?>
166 <?dbhtml list-presentation="table"?>
167
168 <varlistentry id="sdl-config">
169 <term><command>sdl-config</command></term>
170 <listitem>
171 <para>determines the compile and linker flags that should be used to
172 compile and link programs that use
173 <filename class='libraryfile'>libSDL</filename>.</para>
174 <indexterm zone="sdl sdl-config">
175 <primary sortas="b-sdl-config">sdl-config</primary>
176 </indexterm>
177 </listitem>
178 </varlistentry>
179
180 <varlistentry id="libsdl">
181 <term><filename class='libraryfile'>libSDL.so</filename></term>
182 <listitem>
183 <para> library provides low level access to audio, keyboard, mouse,
184 joystick, 3D hardware via OpenGL, and
185 2D frame buffer across multiple platforms.</para>
186 <indexterm zone="sdl libsdl">
187 <primary sortas="c-libsdl">libSDL.so</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 </variablelist>
193
194 </sect2>
195
196</sect1>
Note: See TracBrowser for help on using the repository browser.