X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pages%2FSDL-Tutorial.html-inc;h=444f72088a2d5a129de05e3fd3c96647c4289474;hb=505f308d8b092747da8b2f5e9781475a1f06dfe8;hp=fd8d3ecf93cbe0a93ae5dd2158cc1ebf07707bb7;hpb=46beffd8f76fe150d946bf61c780e61de2affbdf;p=sdlgit%2FSDL-Site.git diff --git a/pages/SDL-Tutorial.html-inc b/pages/SDL-Tutorial.html-inc index fd8d3ec..444f720 100644 --- a/pages/SDL-Tutorial.html-inc +++ b/pages/SDL-Tutorial.html-inc @@ -35,7 +35,7 @@
	# 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
 
 
@@ -45,7 +45,7 @@

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 -http://www.libsdl.org/.

+http://www.libsdl.org/. You can find out more about SDL perl at http://sdl.perl.org.

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.

@@ -53,7 +53,7 @@ though. Here's how to get up and running as quickly as possible.

Surfaces

All graphics in SDL live on a surface. You'll need at least one. That's what -SDL::App provides.

+SDLx::App provides.

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 @@ -63,40 +63,40 @@ something really simple.

Initialization

-

SDL::App makes it easy to initialize video and create a surface. Here's how to +

SDLx::App makes it easy to initialize video and create a surface. Here's how to ask for a windowed surface with 640x480x16 resolution:

-
	use SDL::App;
+
	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,
 	);
 
 
-

You can get more creative, especially if you use the -title and -icon +

You can get more creative, especially if you use the title and icon attributes in a windowed application. Here's how to set the window title of the application to My SDL Program:

-
	use SDL::App;
+
	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',
 	);
 
 

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 -name parameter to +surface. That's a bit more complicated, but see the name parameter to SDL::Surface-new()> if you want to skip ahead.

Working With The App

Since $app from the code above is just an SDL surface with some extra sugar, -it behaves much like SDL::Surface. In particular, the all-important blit -and update methods work. You'll need to create SDL::Rect objects +it behaves much like SDL::Surface. In particular, the all-important blit +and update methods work. You'll need to create SDL::Rect objects representing sources of graphics to draw onto the $app's surface, blit them there, then update the $app.

Note: "blitting" is copying a chunk of memory from one place to another.

@@ -106,30 +106,28 @@ them there, then update the $app.

SEE ALSO

Top

-
SDL::Tutorial::Drawing
+
SDL::Animation
-

basic drawing with rectangles

+

basic rectangle drawing and animation

-
SDL::Tutorial::Animation
+
SDL::Tutorial::LunarLander
-

basic rectangle animation

-
-
SDL::Tutorial::Images
-
-

image loading and animation

+

basic image loading and animation

AUTHOR

Top

-

chromatic, <chromatic@wgz.org>.

+

chromatic, <chromatic@wgz.org>.

+

nelson ferraz, <nferraz@cpan.org>.

+

Updated by kthakore and garu.

Written for and maintained by the Perl SDL project, http://sdl.perl.org/.

COPYRIGHT

Top