</ul>
</li>
<li><a href="#SEE_ALSO">SEE ALSO</a></li>
-<li><a href="#AUTHOR">AUTHOR</a></li>
+<li><a href="#AUTHORS">AUTHORS</a></li>
<li><a href="#COPYRIGHT">COPYRIGHT</a>
</li>
</ul><hr />
<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(
- -width => 640,
- -height => 480,
- -depth => 16,
+ my $app = SDLx::App->new(
+ width => 640,
+ height => 480,
+ depth => 16,
);
</pre>
-<p>You can get more creative, especially if you use the <code>-title</code> and <code>-icon</code>
+<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(
- -height => 640,
- -width => 480,
- -depth => 16,
- -title => 'My SDL Program',
+ my $app = SDLx::App->new(
+ height => 640,
+ width => 480,
+ depth => 16,
+ title => 'My SDL Program',
);
</pre>
<p>Setting an icon is a little more involved -- you have to load an image onto a
-surface. That's a bit more complicated, but see the <code>-name</code> parameter to
+surface. That's a bit more complicated, but see the <code>name</code> parameter to
<code>SDL::Surface-</code>new()> if you want to skip ahead.</p>
</div>
<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>Written for and maintained by the Perl SDL project, <a href="http://sdl.perl.org/">http://sdl.perl.org/</a>.</p>
+<h1 id="AUTHORS">AUTHORS</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="AUTHORS_CONTENT">
+<p>chromatic, <chromatic@wgz.org>. </p>
+<p>Written for and maintained by the Perl SDL project, <a href="http://sdl.perl.org/">http://sdl.perl.org/</a>. See <b>AUTHORS</b> in <cite>SDL</cite> for details.</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>
projects / sdlgit/SDL-Site.git / blobdiff