<pre> # to read this tutorial
$ perldoc SDL::Tutorial
- # to create a bare-bones SDL app based on this tutorial
+ # to run this tutorial
$ perl -MSDL::Tutorial -e 1
</pre>
<div id="SDL_BASICS_CONTENT">
<p>SDL, the Simple DirectMedia Layer, is a cross-platform multimedia library.
These are the Perl 5 bindings. You can find out more about SDL at
-<a href="http://www.libsdl.org/">http://www.libsdl.org/</a>.</p>
+<a href="http://www.libsdl.org/">http://www.libsdl.org/</a>. You can find out more about SDL perl at <a href="http://sdl.perl.org">http://sdl.perl.org</a>.</p>
<p>Creating an SDL application with Perl is easy. You have to know a few basics,
though. Here's how to get up and running as quickly as possible.</p>
<h2 id="Surfaces">Surfaces</h2>
<div id="Surfaces_CONTENT">
<p>All graphics in SDL live on a surface. You'll need at least one. That's what
-<a href="/SDL-App.html">SDL::App</a> provides.</p>
+<a href="http://search.cpan.org/perldoc?SDLx::App">SDLx::App</a> provides.</p>
<p>Of course, before you can get a surface, you need to initialize your video
mode. SDL gives you several options, including whether to run in a window or
take over the full screen, the size of the window, the bit depth of your
</div>
<h2 id="Initialization">Initialization</h2>
<div id="Initialization_CONTENT">
-<p>SDL::App makes it easy to initialize video and create a surface. Here's how to
+<p>SDLx::App makes it easy to initialize video and create a surface. Here's how to
ask for a windowed surface with 640x480x16 resolution:</p>
-<pre> use SDL::App;
+<pre> use SDLx::App;
- my $app = SDL::App->new(
+ my $app = SDLx::App->new(
-width => 640,
-height => 480,
-depth => 16,
<p>You can get more creative, especially if you use the <code>-title</code> and <code>-icon</code>
attributes in a windowed application. Here's how to set the window title of
the application to <code>My SDL Program</code>:</p>
-<pre> use SDL::App;
+<pre> use SDLx::App;
- my $app = SDL::App->new(
+ my $app = SDLx::App->new(
-height => 640,
-width => 480,
-depth => 16,
<h2 id="Working_With_The_App">Working With The App</h2>
<div id="Working_With_The_App_CONTENT">
<p>Since <code>$app</code> from the code above is just an SDL surface with some extra sugar,
-it behaves much like <a href="/SDL-Surface.html">SDL::Surface</a>. In particular, the all-important <code>blit</code>
-and <code>update</code> methods work. You'll need to create <a href="/SDL-Rect.html">SDL::Rect</a> objects
+it behaves much like <a href="SDL-Surface.html">SDL::Surface</a>. In particular, the all-important <code>blit</code>
+and <code>update</code> methods work. You'll need to create <a href="SDL-Rect.html">SDL::Rect</a> objects
representing sources of graphics to draw onto the <code>$app</code>'s surface, <code>blit</code>
them there, then <code>update</code> the <code>$app</code>.</p>
<p><strong>Note:</strong> "blitting" is copying a chunk of memory from one place to another.</p>
<h1 id="SEE_ALSO">SEE ALSO</h1><p><a href="#TOP" class="toplink">Top</a></p>
<div id="SEE_ALSO_CONTENT">
<dl>
- <dt><a href="/SDL-Tutorial::Drawing.html">SDL::Tutorial::Drawing</a></dt>
+ <dt><a href="SDL-Animation.html">SDL::Animation</a></dt>
<dd>
- <p>basic drawing with rectangles</p>
+ <p>basic rectangle drawing and animation</p>
</dd>
- <dt><a href="/SDL-Tutorial::Animation.html">SDL::Tutorial::Animation</a></dt>
+ <dt><a href="SDL-Tutorial-LunarLander.html">SDL::Tutorial::LunarLander</a></dt>
<dd>
- <p>basic rectangle animation</p>
- </dd>
- <dt><a href="/SDL-Tutorial::Images.html">SDL::Tutorial::Images</a></dt>
- <dd>
- <p>image loading and animation</p>
+ <p>basic image loading and animation</p>
</dd>
</dl>
</div>
<h1 id="AUTHOR">AUTHOR</h1><p><a href="#TOP" class="toplink">Top</a></p>
<div id="AUTHOR_CONTENT">
-<p>chromatic, <chromatic@wgz.org>. </p>
+<p>chromatic, <chromatic@wgz.org>. </p>
+<p>nelson ferraz, <nferraz@cpan.org>. </p>
+<p>Updated by kthakore and garu.</p>
<p>Written for and maintained by the Perl SDL project, <a href="http://sdl.perl.org/">http://sdl.perl.org/</a>.</p>
</div>
<h1 id="COPYRIGHT">COPYRIGHT</h1><p><a href="#TOP" class="toplink">Top</a></p>
<div id="COPYRIGHT_CONTENT">
-<p>Copyright (c) 2003 - 2004, chromatic. All rights reserved. This module is
+<p>Copyright (c) 2003 - 2004, chromatic. 2009 - 2010, kthakore. All rights reserved. This module is
distributed under the same terms as Perl itself, in the hope that it is useful
but certainly under no guarantee.
</p>