INTEGRATION: CWS canvas02 (1.1.2); FILE ADDED

2005/10/11 15:40:43 thb 1.1.2.6: #i54170# Corrected license headers
2005/09/02 15:10:17 mbu 1.1.2.5: XIntegerBitmap implementation for bitmaps
2005/08/05 02:31:19 thb 1.1.2.4: #i48939# Added fillB2DPolyPolygon method to bitmap and image
2005/08/04 21:42:06 thb 1.1.2.3: #i48939# Added clear() method to Bitmap; moved buffer format to IColorBuffer
2005/08/04 10:14:31 thb 1.1.2.2: #i48939# Added hasAlpha and getSize to Bitmap and Image
2005/08/02 13:59:22 thb 1.1.2.1: Initial revision

1 files changed, 345 insertions, 0 deletions

diff --git a/canvas/inc/canvas/rendering/bitmap.hxx b/canvas/inc/canvas/rendering/bitmap.hxx
new file mode 100644
index 000000000000..a9112a3c3d61
--- /dev/null
+++ b/canvas/inc/canvas/rendering/bitmap.hxx
@@ -0,0 +1,345 @@
+/*************************************************************************
+ *
+ *  OpenOffice.org - a multi-platform office productivity suite
+ *
+ *  $RCSfile: bitmap.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: kz $ $Date: 2005-11-02 12:44:45 $
+ *
+ *  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_BITMAP_HXX
+#define INCLUDED_CANVAS_BITMAP_HXX
+
+#ifndef _COM_SUN_STAR_UNO_REFERENCE_HXX_
+#include <com/sun/star/uno/Reference.hxx>
+#endif
+#ifndef _COM_SUN_STAR_RENDERING_XCANVAS_HPP_
+#include <com/sun/star/rendering/XCanvas.hpp>
+#endif
+#ifndef _COM_SUN_STAR_RENDERING_INTEGERBITMAPLAYOUT_HPP_
+#include <com/sun/star/rendering/IntegerBitmapLayout.hpp>
+#endif
+#ifndef _COM_SUN_STAR_GEOMETRY_INTEGERRECTANGLE2D_HPP_
+#include <com/sun/star/geometry/IntegerRectangle2D.hpp>
+#endif
+#ifndef _COM_SUN_STAR_GEOMETRY_INTEGERPOINT2D_HPP_
+#include <com/sun/star/geometry/IntegerPoint2D.hpp>
+#endif
+
+#ifndef INCLUDED_CANVAS_ICOLORBUFFER_HXX
+#include <canvas/rendering/icolorbuffer.hxx>
+#endif
+#ifndef INCLUDED_CANVAS_ICACHEDPRIMITIVE_HXX
+#include <canvas/rendering/icachedprimitive.hxx>
+#endif
+#ifndef INCLUDED_CANVAS_ISURFACEPROXYMANAGER_HXX
+#include <canvas/rendering/isurfaceproxymanager.hxx>
+#endif
+
+#include <boost/shared_ptr.hpp>
+#include <boost/scoped_ptr.hpp>
+#include <vector>
+
+namespace basegfx
+{
+    class B2IVector;
+    class B2DPoint;
+    class B2DHomMatrix;
+    class B2DPolyPolygon;
+}
+
+namespace canvas
+{
+    class ImplBitmap;
+
+    /** Bitmap class, with XCanvas-like render interface.
+
+        This class provides a bitmap, that can be rendered into,
+        with an interface compatible to XCanvas. Furthermore, the
+        bitmaps held here can optionally be backed by (possibly
+        hw-accelerated) textures.
+    */
+    class Bitmap
+    {
+    public:
+        /** Create bitmap with given size
+
+            @param rSize
+            Size of the bitmap, in pixel
+
+            @param rMgr
+            SurfaceProxyManager, to use for HW acceleration
+
+            @param bWithAlpha
+            When true, the created bitmap will have an alpha channel,
+            false otherwise
+         */
+        Bitmap( const ::basegfx::B2IVector&          rSize,
+                const ISurfaceProxyManagerSharedPtr& rMgr,
+                bool                                 bWithAlpha );
+        ~Bitmap();
+
+        /// Query whether this bitmap contains alpha channel information
+        bool hasAlpha() const;
+
+        /// Query size of the bitmap in pixel
+        ::basegfx::B2IVector getSize() const;
+
+        ::com::sun::star::uno::Sequence< sal_Int8 > getData(
+            ::com::sun::star::rendering::IntegerBitmapLayout&       bitmapLayout,
+            const ::com::sun::star::geometry::IntegerRectangle2D&   rect );
+
+        void setData(
+            const ::com::sun::star::uno::Sequence< sal_Int8 >&      data,
+            const ::com::sun::star::rendering::IntegerBitmapLayout& bitmapLayout,
+            const ::com::sun::star::geometry::IntegerRectangle2D&   rect );
+
+        void setPixel(
+            const ::com::sun::star::uno::Sequence< sal_Int8 >&      color,
+            const ::com::sun::star::rendering::IntegerBitmapLayout& bitmapLayout,
+            const ::com::sun::star::geometry::IntegerPoint2D&       pos );
+
+        ::com::sun::star::uno::Sequence< sal_Int8 > getPixel(
+            ::com::sun::star::rendering::IntegerBitmapLayout&       bitmapLayout,
+            const ::com::sun::star::geometry::IntegerPoint2D&       pos );
+
+        /** Render the bitmap content to associated
+            SurfaceProxyManager's screen.
+
+            @param fAlpha
+            Overall alpha for content
+
+            @param rPos
+            Output position
+
+            @param rTransform
+            Output transformation (does not affect output position)
+         */
+        bool draw( double                         fAlpha,
+                   const ::basegfx::B2DPoint&     rPos,
+                   const ::basegfx::B2DHomMatrix& rTransform );
+
+        /** Render the bitmap content to associated
+            SurfaceProxyManager's screen.
+
+            @param fAlpha
+            Overall alpha for content
+
+            @param rPos
+            Output position
+
+            @param rArea
+            Subset of the surface to render. Coordinate system are
+            surface area pixel, given area will be clipped to the
+            surface bounds.
+
+            @param rTransform
+            Output transformation (does not affect output position)
+         */
+        bool draw( double                         fAlpha,
+                   const ::basegfx::B2DPoint&     rPos,
+                   const ::basegfx::B2DRange&     rArea,
+                   const ::basegfx::B2DHomMatrix& rTransform );
+
+        /** Render the bitmap content to associated
+            SurfaceProxyManager's screen.
+
+            @param fAlpha
+            Overall alpha for content
+
+            @param rPos
+            Output position
+
+            @param rClipPoly
+            Clip polygon for the surface. The clip polygon is also
+            subject to the output transformation.
+
+            @param rTransform
+            Output transformation (does not affect output position)
+         */
+        bool draw( double                           fAlpha,
+                   const ::basegfx::B2DPoint&       rPos,
+                   const ::basegfx::B2DPolyPolygon& rClipPoly,
+                   const ::basegfx::B2DHomMatrix&   rTransform );
+
+        /** Clear whole bitmap with given color.
+
+            This method sets every single pixel of the bitmap to the
+            specified color value.
+         */
+        void clear( const ::com::sun::star::uno::Sequence< double >& color );
+
+        void fillB2DPolyPolygon(
+            const ::basegfx::B2DPolyPolygon&                    rPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&       viewState,
+            const ::com::sun::star::rendering::RenderState&     renderState );
+
+
+        // High-level drawing operations (from the XCanvas interface)
+        // ==========================================================
+
+        /// See XCanvas interface
+        void drawPoint( const ::com::sun::star::geometry::RealPoint2D&      aPoint,
+                        const ::com::sun::star::rendering::ViewState&       viewState,
+                        const ::com::sun::star::rendering::RenderState&     renderState );
+        /// See XCanvas interface
+        void drawLine( const ::com::sun::star::geometry::RealPoint2D&   aStartPoint,
+                       const ::com::sun::star::geometry::RealPoint2D&   aEndPoint,
+                       const ::com::sun::star::rendering::ViewState&    viewState,
+                       const ::com::sun::star::rendering::RenderState&  renderState );
+        /// See XCanvas interface
+        void drawBezier( const ::com::sun::star::geometry::RealBezierSegment2D& aBezierSegment,
+                         const ::com::sun::star::geometry::RealPoint2D&         aEndPoint,
+                         const ::com::sun::star::rendering::ViewState&          viewState,
+                         const ::com::sun::star::rendering::RenderState&        renderState );
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr drawPolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState );
+
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr strokePolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState,
+            const ::com::sun::star::rendering::StrokeAttributes&    strokeAttributes );
+        /** See XCanvas interface
+
+            @param textureAnnotations
+            Vector of shared pointers to bitmap textures,
+            <em>corresponding</em> in indices to the textures
+            sequence. This is to decouple this interface from the
+            client's XBitmap-implementation class.
+         */
+        ICachedPrimitiveSharedPtr strokeTexturedPolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState,
+            const ::com::sun::star::uno::Sequence<
+                  ::com::sun::star::rendering::Texture >&           textures,
+            const ::std::vector< ::boost::shared_ptr<Bitmap> >&     textureAnnotations,
+            const ::com::sun::star::rendering::StrokeAttributes&    strokeAttributes );
+        /** See XCanvas interface
+
+            @param textureAnnotations
+            Vector of shared pointers to bitmap textures,
+            <em>corresponding</em> in indices to the textures
+            sequence. This is to decouple this interface from the
+            client's XBitmap-implementation class.
+         */
+        ICachedPrimitiveSharedPtr strokeTextureMappedPolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState,
+            const ::com::sun::star::uno::Sequence<
+                  ::com::sun::star::rendering::Texture >&           textures,
+            const ::std::vector< ::boost::shared_ptr<Bitmap> >&     textureAnnotations,
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::geometry::XMapping2D >&         xMapping,
+            const ::com::sun::star::rendering::StrokeAttributes&    strokeAttributes );
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr fillPolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState );
+        /** See XCanvas interface
+
+            @param textureAnnotations
+            Vector of shared pointers to bitmap textures,
+            <em>corresponding</em> in indices to the textures
+            sequence. This is to decouple this interface from the
+            client's XBitmap-implementation class.
+         */
+        ICachedPrimitiveSharedPtr fillTexturedPolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState,
+            const ::com::sun::star::uno::Sequence<
+                  ::com::sun::star::rendering::Texture >&           textures,
+            const ::std::vector< ::boost::shared_ptr<Bitmap> >&     textureAnnotations );
+        /** See XCanvas interface
+
+            @param textureAnnotations
+            Vector of shared pointers to bitmap textures,
+            <em>corresponding</em> in indices to the textures
+            sequence. This is to decouple this interface from the
+            client's XBitmap-implementation class.
+         */
+        ICachedPrimitiveSharedPtr fillTextureMappedPolyPolygon(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XPolyPolygon2D >&    xPolyPolygon,
+            const ::com::sun::star::rendering::ViewState&           viewState,
+            const ::com::sun::star::rendering::RenderState&         renderState,
+            const ::com::sun::star::uno::Sequence<
+                  ::com::sun::star::rendering::Texture >&           textures,
+            const ::std::vector< ::boost::shared_ptr<Bitmap> >&     textureAnnotations,
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::geometry::XMapping2D >&         xMapping );
+
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr drawBitmap(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XBitmap >&   xBitmap,
+            const ::com::sun::star::rendering::ViewState&   viewState,
+            const ::com::sun::star::rendering::RenderState& renderState );
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr drawBitmap(
+            const ::boost::shared_ptr<Bitmap>&              rImage,
+            const ::com::sun::star::rendering::ViewState&   viewState,
+            const ::com::sun::star::rendering::RenderState& renderState );
+
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr drawBitmapModulated(
+            const ::com::sun::star::uno::Reference<
+                  ::com::sun::star::rendering::XBitmap >&       xBitmap,
+            const ::com::sun::star::rendering::ViewState&       viewState,
+            const ::com::sun::star::rendering::RenderState&     renderState );
+        /// See XCanvas interface
+        ICachedPrimitiveSharedPtr drawBitmapModulated(
+            const ::boost::shared_ptr<Bitmap>&                  rImage,
+            const ::com::sun::star::rendering::ViewState&       viewState,
+            const ::com::sun::star::rendering::RenderState&     renderState );
+
+    private:
+        friend class ImplBitmap;
+
+        const ::boost::scoped_ptr< ImplBitmap > mpImpl;
+    };
+
+    typedef ::boost::shared_ptr< Bitmap > BitmapSharedPtr;
+}
+
+#endif /* INCLUDED_CANVAS_BITMAP_HXX */