updated docs
[sdlgit/SDL-Site.git] / pages / SDL-Tutorial-Animation.html-inc
index c5c526c..2f15476 100644 (file)
@@ -59,19 +59,41 @@ frame and saving and restoring the background for every object drawn.</p>
 <div id="Redrawing_the_Screen_CONTENT">
 <p>Since you have to draw the screen in the right order once to start with it's
 pretty easy to make this into a loop and redraw things in the right order for
-every frame.  Given a <a href="/SDL-App.html">SDL::App</a> object <code>$app</code>, a <a href="/SDL-Rect.html">SDL::Rect</a> <code>$rect</code>, and
-a <a href="/SDL-Color.html">SDL::Color</a> <code>$color</code>, you only have to create a new SDL::Rect <code>$bg</code>,
-representing the whole of the background surface and a new SDL::Color
-<code>$bg_color</code>, representing the background color.  You can write a
-<code>draw_frame()</code> function as follows:</p>
+every frame.  Given a <a href="http://search.cpan.org/perldoc?SDLx::App">SDLx::App</a> object <code>$app</code>, a <a href="SDL-Rect.html">SDL::Rect</a> <code>$rect</code>, and
+a <a href="SDL-Color.html">SDL::Color</a> <code>$color</code>, you only have to create a new SDL::Rect <code>$bg</code>,
+representing the whole of the background surface and a new mapped color 
+<code>$bg_color</code>, representing the background color.  The colors need to be mapped 
+to the format of the current display. This is done by <a href="/SDL-Video.html#map_RGB">SDL::Video::map_RGB</a>.</p>
+<p>&nbsp;</p>
+<p>my $color = SDL::Video::map_RGB (
+        $app-&gt;format,
+        $rect_r,
+        $rect_g,
+        $rect_b,
+);</p>
+<p>my $bg_color = SDL::Video::map_RGB (
+        $app-&gt;format,
+        $bg_r,
+        $bg_g,
+        $bg_b,
+);</p>
+<p>&nbsp;</p>
+
+
+
+
+
+
+
+<p>You can write a <code>draw_frame()</code> function as follows:</p>
 <p>&nbsp;</p>
 <pre>  sub draw_frame
        {
                my ($app, %args) = @_;
 
-               $app-&gt;fill( $args{ bg }, $args{ bg_color } );
-               $app-&gt;fill( $args{rect}, $args{rect_color} );
-               $app-&gt;update( $args{bg} );
+               SDL::Video::fill_rect($app,  $args{bg},   $args{bg_color}   );
+               SDL::Video::fill_rect($app, $args{rect}, $args{rect_color} );
+               SDL::Video::update_rects($app, $args{bg} );
        }
 
 </pre>
@@ -118,9 +140,10 @@ figure out the rectangle of the correct size to <code>update()</code>.  No thank
        {
                my ($app, %args) = @_;
 
-               $app-&gt;fill(   $args{old_rect}, $args{bg_color}   );
-               $app-&gt;fill(   $args{rect],     $args{rect_color} );
-               $app-&gt;update( $args{old_rect}, $args{rect}       );
+               SDL::Video::fill_rect($app, $args{old_rect}, $args{bg_color}   );
+               SDL::Video::fill_rect($app,  $args{rect},     $args{rect_color} );
+               SDL::Video::update_rects($app, $args{old_rect} );
+               SDL::Video::update_rects($app, $args{rect} );
        }
 
 </pre>
@@ -155,11 +178,11 @@ them soon.</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-Tutorial-Drawing.html">SDL::Tutorial::Drawing</a></dt>
        <dd>
                <p>basic drawing with SDL Perl</p>
        </dd>
-       <dt><a href="/SDL-Tutorial::Images.html">SDL::Tutorial::Images</a></dt>
+       <dt><a href="SDL-Tutorial-Images.html">SDL::Tutorial::Images</a></dt>
        <dd>
                <p>animating images</p>
        </dd>
@@ -169,7 +192,8 @@ them soon.</p>
 <h1 id="AUTHOR">AUTHOR</h1><p><a href="#TOP" class="toplink">Top</a></p>
 <div id="AUTHOR_CONTENT">
 <p>chromatic, &lt;chromatic@wgz.org&gt;</p>
-<p>Written for and maintained by the Perl SDL project, <a href="http://sdl.perl.org/">http://sdl.perl.org/</a>.</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>.</p>
 
 </div>
 <h1 id="BUGS">BUGS</h1><p><a href="#TOP" class="toplink">Top</a></p>