[Gnash-commit] gnash ChangeLog backend/render_handler.h server...

[Sandro Santilli]

CVSROOT:        /sources/gnash
Module name:    gnash
Changes by:     Sandro Santilli <strk>  06/12/01 15:52:17

Modified files:
        .              : ChangeLog 
        backend        : render_handler.h 
        server         : render.h 

Log message:
                * backend/render_handler.h, server/render.h:
                  some doxygen notes for bounds_in_clipping_area.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/ChangeLog?cvsroot=gnash&r1=1.1840&r2=1.1841
http://cvs.savannah.gnu.org/viewcvs/gnash/backend/render_handler.h?cvsroot=gnash&r1=1.22&r2=1.23
http://cvs.savannah.gnu.org/viewcvs/gnash/server/render.h?cvsroot=gnash&r1=1.10&r2=1.11

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/gnash/gnash/ChangeLog,v
retrieving revision 1.1840
retrieving revision 1.1841
diff -u -b -r1.1840 -r1.1841
--- ChangeLog   1 Dec 2006 15:38:18 -0000       1.1840
+++ ChangeLog   1 Dec 2006 15:52:17 -0000       1.1841
@@ -1,5 +1,10 @@
 2006-12-01 Sandro Santilli <address@hidden>
 
+       * backend/render_handler.h, server/render.h:
+         some doxygen notes for bounds_in_clipping_area.
+
+2006-12-01 Sandro Santilli <address@hidden>
+
        * configure.ac, libgeometry/Makefile.am, libgeometry/Range2d.h,
          testsuite/Makefile.am, testsuite/libgeometry/Makefile.am,
          testsuite/libgeometry/Range2dTest.cpp, testsuite/server/Makefile.am:

Index: backend/render_handler.h
===================================================================
RCS file: /sources/gnash/gnash/backend/render_handler.h,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -b -r1.22 -r1.23
--- backend/render_handler.h    25 Nov 2006 16:00:21 -0000      1.22
+++ backend/render_handler.h    1 Dec 2006 15:52:17 -0000       1.23
@@ -17,7 +17,7 @@
 // 
 //
 
-/* $Id: render_handler.h,v 1.22 2006/11/25 16:00:21 udog Exp $ */
+/* $Id: render_handler.h,v 1.23 2006/12/01 15:52:17 strk Exp $ */
 
 #ifndef RENDER_HANDLER_H
 #define RENDER_HANDLER_H
@@ -368,13 +368,22 @@
 
   }
   
+  /// \brief
   /// Checks if the given bounds are (partially) in the current drawing 
clipping
-  /// area. A render handler implementing invalidated bounds should implement
+  /// area.
+  //
+  /// A render handler implementing invalidated bounds should implement
   /// this method to avoid rendering of characters that are not visible anyway.
   /// By default this method always returns true, which will ensure correct
   /// rendering. If possible, it should be re-implemented by the renderer 
   /// handler for better performance.
   /// 'bounds' contains TWIPS coordinates.
+  ///
+  /// TODO: Take a Range2d<T> rather then a gnash::rect ?
+  ///       Would T==int be good ? TWIPS as integer types ?
+  ///
+  /// See also gnash::renderer::bounds_in_clipping_area
+  ///
   virtual bool bounds_in_clipping_area(const rect& bounds) {
     return true;
   }

Index: server/render.h
===================================================================
RCS file: /sources/gnash/gnash/server/render.h,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- server/render.h     25 Nov 2006 16:20:45 -0000      1.10
+++ server/render.h     1 Dec 2006 15:52:17 -0000       1.11
@@ -101,6 +101,12 @@
 
     bool allow_glyph_textures();                               
                                
+    /// \brief
+    /// Proxies call to the registered render_handler, or
+    /// return true if no renderer is registered.
+    //
+    /// See render_handler::bounds_in_clipping_area
+    ///
     bool bounds_in_clipping_area(const rect& bounds);