X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pages%2Fblog-0001.html-inc;h=bc1ede2a2121a8f61406c42ed94777a82e4b5b94;hb=6830c16eaa7a62997ee073de17a60c5046b4b712;hp=fcd393b50330e87bf986d7e9b9e5557d505eaecd;hpb=350668cfb612b30b27493abedcd1464b764a9b02;p=sdlgit%2FSDL-Site.git diff --git a/pages/blog-0001.html-inc b/pages/blog-0001.html-inc index fcd393b..bc1ede2 100644 --- a/pages/blog-0001.html-inc +++ b/pages/blog-0001.html-inc @@ -1,6 +1,6 @@ -
-

-The beginnings of modular design for SDL Perl -

-
-
“Do or do not... there is no try.”
--yoda

The design before


The bindings before were all in one huge XS file. This was then exported into the SDL module. This means that the XS file has to handle with macros if any component (e.x SDL_Mixer) is not compiled. Moreover having ever binding in one XS file prevents use to treat C structs as object with only one point of free and malloc. This would be BEGIN and DESTROY in Perl. Also the monolithic design introduces a lot of bugs because we have to use free and malloc all over the place. Lastly SDL monolithic design has the constructor for all structs in both Perl and in XS.

The design we are aiming for

Simple one XS per Module. This would also simplify the Build code.

First Step


We have began with SDL Rect. It is in github master branch now. We are in the progress of making it back compatible. Originally SDL::Rect took named variables as parameters for new(). Now since the constructor is in XS we have only unnamed parameters.


Before


SDL::Rect->new( -x => 0, -y => 0, -width => 0, -height => 0);

After


SDL::Rect->new(0, 0, 0, 0);

Ideally we would like both ways of constructing Rect.
\ No newline at end of file +
+

+Migrating Sol's Tutorial of SDL to SDL_Perl +

+
+
If I have seen further it is only by standing on the shoulders of giants. --Newton



Sol's Tutorials


When I was struggling with SDL C a while ago, someone recommended Sol's Tutorial to me. It had not only help me understand video in SDL, but I believe my code has improved using Sol's code style. I would like to pass these along to fellow SDL_Perl users too. So here is the Ch 02 code of Sol's Tutorial in SDL_Perl. It will be getting more and more Perly as our team hacks on it. There is more to come!


To use this code you need the new Redesigned SDL_Perl Library


Getting SDL Dependencies


Only If you are on Linux (debian/ubuntu) you need the following dependencies:

$ sudo apt-get install libsdl-net1.2-dev libsdl-mixer1.2-dev libsmpeg-dev libsdl1.2-dev libsdl-image1.2-dev libsdl-ttf2.0-dev

On Windows we recommend using Strawberry Perl. It comes with SDL-1.2.13 header files and libs included.

Both Windows and Linux needs to install Alien::SDL

$ cpan Alien::SDL
** Add sudo to this for Linux

Getting Bleeding SDL


The bleeding SDL is on github. Click download on this site .

Extract it and cd into the folder run 
$ cpan .
** The dot is needed
** in Linux you may need to do sudo

Then you can run this script by doing

$ perl examples/sols/ch02.pl
\ No newline at end of file