INTEGRATION: CWS canvas02 (1.1.2); FILE ADDED

2005/10/11 15:40:29 thb 1.1.2.2: #i54170# Corrected license headers
2005/06/17 23:36:51 thb 1.1.2.1: #i48939# Refactored canvas, these are base classes that encapsulate common functionality (like input checking, locking, and general behaviour common to all canvas implementations)

1 files changed, 168 insertions, 0 deletions

diff --git a/canvas/inc/canvas/base/floatbitmapbase.hxx b/canvas/inc/canvas/base/floatbitmapbase.hxx
new file mode 100644
index 000000000000..4a4d90faa6ea
--- /dev/null
+++ b/canvas/inc/canvas/base/floatbitmapbase.hxx
@@ -0,0 +1,168 @@
+/*************************************************************************
+ *
+ *  OpenOffice.org - a multi-platform office productivity suite
+ *
+ *  $RCSfile: floatbitmapbase.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: kz $ $Date: 2005-11-02 12:43:04 $
+ *
+ *  The Contents of this file are made available subject to
+ *  the terms of GNU Lesser General Public License Version 2.1.
+ *
+ *
+ *    GNU Lesser General Public License Version 2.1
+ *    =============================================
+ *    Copyright 2005 by Sun Microsystems, Inc.
+ *    901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *    This library is free software; you can redistribute it and/or
+ *    modify it under the terms of the GNU Lesser General Public
+ *    License version 2.1, as published by the Free Software Foundation.
+ *
+ *    This library is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *    Lesser General Public License for more details.
+ *
+ *    You should have received a copy of the GNU Lesser General Public
+ *    License along with this library; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *    MA  02111-1307  USA
+ *
+ ************************************************************************/
+
+#ifndef INCLUDED_CANVAS_FLOATBITMAPBASE_HXX
+#define INCLUDED_CANVAS_FLOATBITMAPBASE_HXX
+
+#ifndef _COM_SUN_STAR_RENDERING_XIEEEFLOATBITMAP_HPP_
+#include <com/sun/star/rendering/XIeeeFloatBitmap.hpp>
+#endif
+
+#ifndef INCLUDED_CANVAS_BITMAPCANVASBASE_HXX
+#include <canvas/bitmapcanvasbase.hxx>
+#endif
+
+
+namespace canvas
+{
+    /** Helper template to handle XIeeeFloatBitmap method forwarding to
+        BitmapCanvasHelper
+
+        Use this helper to handle the XIeeeFloatBitmap part of your
+        implementation.
+
+        @tpl Base
+        Base class to use, most probably one of the
+        WeakComponentImplHelperN templates with the appropriate
+        interfaces. At least XIeeeFloatBitmap should be among them (why
+        else would you use this template, then?). Base class must have
+        an Base( const Mutex& ) constructor (like the
+        WeakComponentImplHelperN templates have).
+
+        @tpl CanvasHelper
+        Canvas helper implementation for the backend in question
+
+        @tpl Mutex
+        Lock strategy to use. Defaults to using the
+        OBaseMutex-provided lock.  Everytime one of the methods is
+        entered, an object of type Mutex is created with m_aMutex as
+        the sole parameter, and destroyed again when the method scope
+        is left.
+
+        @tpl UnambiguousBase
+        Optional unambiguous base class for XInterface of Base. It's
+        sometimes necessary to specify this parameter, e.g. if Base
+        derives from multiple UNO interface (were each provides its
+        own version of XInterface, making the conversion ambiguous)
+
+        @see CanvasBase for further contractual requirements towards
+        the CanvasHelper type, and some examples.
+     */
+    template< class Base,
+              class CanvasHelper,
+              class Mutex=::osl::MutexGuard,
+              class UnambiguousBase=::com::sun::star::uno::XInterface > class FloatBitmapBase :
+        public BitmapCanvasBase< Base, CanvasHelper, Mutex, UnambiguousBase >
+    {
+    public:
+        typedef BitmapCanvasBase< Base, CanvasHelper, Mutex, UnambiguousBase >  BaseType;
+
+        // XIeeeFloatBitmap
+        virtual ::com::sun::star::uno::Sequence< float > SAL_CALL getData( ::com::sun::star::rendering::FloatingPointBitmapLayout&  bitmapLayout,
+                                                                           const ::com::sun::star::geometry::IntegerRectangle2D&    rect ) throw (::com::sun::star::lang::IndexOutOfBoundsException,
+                                                                                                                                               ::com::sun::star::rendering::VolatileContentDestroyedException,
+                                                                                                                                               ::com::sun::star::uno::RuntimeException)
+        {
+            verifyInput(rect,
+                        static_cast< typename BaseType::UnambiguousBaseType* >(this));
+            verifyIndexRange(rect, getSize() );
+
+            typename BaseType::MutexType aGuard( BaseType::m_aMutex );
+
+            return BaseType::maCanvasHelper.getData( bitmapLayout,
+                                                     rect );
+        }
+
+        virtual void SAL_CALL setData( const ::com::sun::star::uno::Sequence< float >&               data,
+                                       const ::com::sun::star::rendering::FloatingPointBitmapLayout& bitmapLayout,
+                                       const ::com::sun::star::geometry::IntegerRectangle2D&         rect ) throw (::com::sun::star::lang::IllegalArgumentException,
+                                                                                                                   ::com::sun::star::lang::IndexOutOfBoundsException,
+                                                                                                                   ::com::sun::star::uno::RuntimeException)
+        {
+            verifyInput(bitmapLayout, rect,
+                        static_cast< typename BaseType::UnambiguousBaseType* >(this));
+            verifyIndexRange(rect, getSize() );
+
+            typename BaseType::MutexType aGuard( BaseType::m_aMutex );
+
+            BaseType::mbSurfaceDirty = true;
+            BaseType::maCanvasHelper.modifying();
+
+            BaseType::maCanvasHelper.setData( data, bitmapLayout, rect );
+        }
+
+        virtual void SAL_CALL setPixel( const ::com::sun::star::uno::Sequence< float >&                 color,
+                                        const ::com::sun::star::rendering::FloatingPointBitmapLayout&   bitmapLayout,
+                                        const ::com::sun::star::geometry::IntegerPoint2D&               pos ) throw (::com::sun::star::lang::IllegalArgumentException,
+                                                                                                                     ::com::sun::star::lang::IndexOutOfBoundsException,
+                                                                                                                     ::com::sun::star::uno::RuntimeException)
+        {
+            verifyInput(bitmapLayout, pos,
+                        static_cast< typename BaseType::UnambiguousBaseType* >(this));
+            verifyIndexRange(pos, getSize() );
+
+            typename BaseType::MutexType aGuard( BaseType::m_aMutex );
+
+            BaseType::mbSurfaceDirty = true;
+            BaseType::maCanvasHelper.modifying();
+
+            BaseType::maCanvasHelper.setPixel( color, bitmapLayout, pos );
+        }
+
+        virtual ::com::sun::star::uno::Sequence< float > SAL_CALL getPixel( ::com::sun::star::rendering::FloatingPointBitmapLayout& bitmapLayout,
+                                                                            const ::com::sun::star::geometry::IntegerPoint2D&       pos ) throw (::com::sun::star::lang::IndexOutOfBoundsException,
+                                                                                                                                                 ::com::sun::star::rendering::VolatileContentDestroyedException,
+                                                                                                                                                 ::com::sun::star::uno::RuntimeException)
+        {
+            verifyInput(pos,
+                        static_cast< typename BaseType::UnambiguousBaseType* >(this));
+            verifyIndexRange(pos, getSize() );
+
+            typename BaseType::MutexType aGuard( BaseType::m_aMutex );
+
+            return BaseType::maCanvasHelper.getPixel( bitmapLayout,
+                                                      pos );
+        }
+
+        virtual ::com::sun::star::rendering::FloatingPointBitmapLayout SAL_CALL getMemoryLayout(  ) throw (::com::sun::star::uno::RuntimeException)
+        {
+            typename BaseType::MutexType aGuard( BaseType::m_aMutex );
+
+            return BaseType::maCanvasHelper.getMemoryLayout();
+        }
+    };
+}
+
+#endif /* INCLUDED_CANVAS_FLOATBITMAPBASE_HXX */