source: multimedia/libdriv/sdl.xml@ ebabf24

10.0 10.1 11.0 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since ebabf24 was ebabf24, checked in by Randy McMurchy <randy@…>, 15 years ago

Moved the last two xinclude files in the root of the book's sources to the global xinclude directory

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

  • Property mode set to 100644
File size: 6.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 "80919ef556425ff82a8555ff40a579a0">
10 <!ENTITY sdl-size "2.6 MB">
11 <!ENTITY sdl-buildsize "36 MB">
12 <!ENTITY sdl-time "0.8 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 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&sdl-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&sdl-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &sdl-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &sdl-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &sdl-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &sdl-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>Required patch: <ulink
62 url="&patch-root;/SDL-&sdl-version;-gcc4-1.patch"/></para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">SDL Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Optional</bridgehead>
69 <para role="optional"><xref linkend="alsa"/>,
70 <xref linkend="esound"/>,
71 <xref linkend="arts"/>,
72 <xref linkend="nas"/>,
73 <xref linkend="NASM"/>,
74 <xref linkend="x-window-system"/>,
75 <xref linkend="aalib"/>,
76 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
77 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
78 <ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>, and
79 <!-- Dead link,
80 <ulink url="http://www.trolltech.com/download/qtopia/">Qtopia</ulink>
81 -->
82 <ulink url="http://picogui.org/">PicoGUI</ulink></para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/sdl"/></para>
86
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of SDL</title>
91
92 <para>Install <application>SDL</application> by running the
93 following commands:</para>
94
95<screen><userinput>patch -Np1 -i ../SDL-&sdl-version;-gcc4-1.patch &amp;&amp;
96./configure --prefix=/usr --disable-debug &amp;&amp;
97make</userinput></screen>
98
99 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
100
101<screen role="root"><userinput>make install &amp;&amp;
102install -v -m755 -d /usr/share/doc/SDL-&sdl-version;/html &amp;&amp;
103install -v -m644 docs/html/*.html /usr/share/doc/SDL-&sdl-version;/html</userinput></screen>
104
105 </sect2>
106
107 <sect2 role="commands">
108 <title>Command Explanations</title>
109
110 <para><parameter>--disable-debug</parameter>: This switch configures
111 <application>SDL</application> to build with aggressive
112 optimizations.</para>
113
114 <para><option>--enable-video-aalib</option>: This switch
115 is required to build <application>SDL</application>
116 with AAlib video support.</para>
117
118 </sect2>
119
120 <sect2 role="testing">
121 <title>Testing SDL</title>
122
123 <para>It is advisable to test the installation of
124 <application>SDL</application> using the included
125 test programs. It is not required to install any of the resulting binaries
126 to validate the installation. Issue the following commands to build the
127 test programs:</para>
128
129<screen><userinput>cd test &amp;&amp;
130./configure &amp;&amp;
131make</userinput></screen>
132
133 <para>You'll need to manually run all the test programs.</para>
134
135 </sect2>
136
137 <sect2 role="configuration">
138 <title>Configuring SDL</title>
139
140 <sect3>
141 <title>Configuration Information</title>
142
143 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
144 href="../../xincludes/lib-config.xml"/>
145
146 </sect3>
147
148 </sect2>
149
150 <sect2 role="content">
151 <title>Contents</title>
152
153 <segmentedlist>
154 <segtitle>Installed Program</segtitle>
155 <segtitle>Installed Libraries</segtitle>
156 <segtitle>Installed Directories</segtitle>
157
158 <seglistitem>
159 <seg>sdl-config</seg>
160 <seg>libSDL*.{so,a}</seg>
161 <seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
162 </seglistitem>
163 </segmentedlist>
164
165 <variablelist>
166 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
167 <?dbfo list-presentation="list"?>
168 <?dbhtml list-presentation="table"?>
169
170 <varlistentry id="sdl-config">
171 <term><command>sdl-config</command></term>
172 <listitem>
173 <para>determines the compile and linker flags that should be used to
174 compile and link programs that use
175 <filename class='libraryfile'>libSDL</filename>.</para>
176 <indexterm zone="sdl sdl-config">
177 <primary sortas="b-sdl-config">sdl-config</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="libsdl">
183 <term><filename class='libraryfile'>libSDL*.{so,a}</filename></term>
184 <listitem>
185 <para> libraries provide low level access to audio, keyboard, mouse,
186 joystick, 3D hardware via OpenGL, and
187 2D frame buffer across multiple platforms.</para>
188 <indexterm zone="sdl libsdl">
189 <primary sortas="c-libsdl">libSDL*.{so,a}</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 </variablelist>
195
196 </sect2>
197
198</sect1>
Note: See TracBrowser for help on using the repository browser.