fixed docs for callbacks
[sdlgit/SDL-Site.git] / pages / blog-0019.html-inc
index 464b658..06aca75 100644 (file)
@@ -1,6 +1,40 @@
 <div class="blog">
 <h1 id="NAME">
-Can someone please point me to good XS documentation!
+Design of SDL::Rect
 </h1>
 <div class="CONTENT">
-<i style="float:right;">A poor man begs,<br />A troubled man prays,<br />who shall answer? </i><br /><br /><br /><br /><p>This is the first time perldoc has disappointed me. The example on perlxs is wrong and fails. I do not wish to flame writers of perlxs but please check that your examples work! Ironically I know that broken tutorials is a problem with SDL perl too. </p><p>If anyone can point me to the simplest working exaple of XS with a c struct, it would be greatly appreciated.</p><div class="blogger-post-footer"><img width='1' height='1' src='https://blogger.googleusercontent.com/tracker/3102167581424744259-9063382931575650771?l=yapgh.blogspot.com' alt='' /></div></div></div>
\ No newline at end of file
+<div style="text-align: right;"><i><br />
+you say things,<br />
+I hear,<br />
+but don't listen,<br />
+<br />
+you show things,<br />
+I see,<br />
+but don't understand,<br />
+<br />
+you write things,<br />
+I read,<br />
+but don't know.<br />
+</i></div><br />
+Lately we have been working on cleaning up the XS name spaces of SDL perl. After some bumps and falls we came up with a separated Rect module. Rect is one of the most simple C struct as shown below. <br />
+<br />
+<script src="http://gist.github.com/185940.js">
+</script><br />
+<br />
+Using the awesome <a href="http://cpansearch.perl.org/src/DMR/CookBookB-19960430/perlobject.map">perlobject.map</a> as a reference I was able to create a <a href="http://github.com/kthakore/SDL_perl/blob/a1b835c168ec184abc01edbc01862ffa15624c26/lib/SDL/Rect.pm">blessed perl</a> object in <a href="http://github.com/kthakore/SDL_perl/blob/a1b835c168ec184abc01edbc01862ffa15624c26/src/Rect.xs">XS</a>. So now SDL::Rect-&gt;new(...) gave us a blessed reference ready to go. And as an icing it would destroy itself properly no matter where it was used. But once I brought it into our existing code base, garu pointed out the extending it was a little bit of a mess. So far to extend Rect we have to something like below. Any comment or advice would be much appreciated.<br />
+<br />
+<br />
+<script src="http://gist.github.com/185938.js">
+</script><br />
+<br />
+<br />
+Have at it I am a big boy. You can grab the code like this.<br />
+Only If you don't already have a local git repo:<br />
+<br />
+<blockquote>mkdir SDL<br />
+cd SDL<br />
+git init .</blockquote><br />
+Then do this or skip to this if you already have a local git repo<br />
+<blockquote>git pull git://github.com/kthakore/SDL_perl.git experimental</blockquote><div class="blogger-post-footer"><img width='1' height='1' src='https://blogger.googleusercontent.com/tracker/3102167581424744259-3340771783563950133?l=yapgh.blogspot.com' alt='' /></div>
+<p><a href="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/0/da"><img src="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/0/di" border="0" ismap="true"></img></a><br/>
+<a href="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/1/da"><img src="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/1/di" border="0" ismap="true"></img></a></p><img src="http://feeds.feedburner.com/~r/YetAnotherPerlGameHackeryapgh/~4/6i-HmfODM5o" height="1" width="1"/></div></div>
\ No newline at end of file